Skip to content

docs: prep vesseld v0.1.0 GA (Status, TCP quickstart, vesseld-with-history demo)#92

Merged
lIang70 merged 2 commits into
mainfrom
chore/vesseld-v0.1.0-ga-prep
May 11, 2026
Merged

docs: prep vesseld v0.1.0 GA (Status, TCP quickstart, vesseld-with-history demo)#92
lIang70 merged 2 commits into
mainfrom
chore/vesseld-v0.1.0-ga-prep

Conversation

@lIang70

@lIang70 lIang70 commented May 11, 2026

Copy link
Copy Markdown
Collaborator

Summary

Three doc-only changes to clear the runway for cutting vessel/v0.1.0 and vesseld/v0.1.0 GA tags. No Go code touched.

  • README.md — rewrite Status section against shipped reality (Postgres/SQLite checkpointers, OTel, Prometheus /metrics, seven-suite eval/ harness all in place); refresh the v0.2 / v0.3 milestone descriptions; add a TCP + bearer-token snippet to the Quickstart so remote access is documented before users hit it.
  • examples/vesseld-multi-vessel/README.md — add a "Remote access via TCP + bearer token" section with the tokenFile YAML and a curl -H "Authorization: Bearer …" example; mTLS explicitly tagged as v0.2 scope.
  • examples/vesseld-with-history/ (new) — single-vessel demo that wires a shared HistoryStore (ref: buffer) so the agent remembers earlier turns of the same context_id conversation. README is explicit that v0.1.0 only ships in-memory buffer history; cross-restart persistence is deferred to v0.2's Compacted flavor + SessionStore.
  • CHANGELOG.md — add vessel/v0.1.0, vesseld/v0.1.0-rc.2 (vessel rc.2 dep bump + supervisor race fix), and vesseld/v0.1.0 GA entries with known-limitations callouts.

Test plan

  • make vet — clean across all modules
  • make test-e2etests/e2e/vesseld (29.5s) + tests/e2e/retrieval (0.5s) both green
  • tests/quality/vessel — 1.3s green
  • vesseld validate -R on both vesseld-multi-vessel and vesseld-with-historyok
  • vesseld plan -R on vesseld-with-history confirms HistoryStore ref resolution
  • Wait for required CI status check to pass on the PR

Note: make test locally trips a known live-LLM hang in tests/conformance/llm after 601s (HTTP/2 TLS read stuck) because a populated .env defeats the suite's self-skip path. Not a regression — this PR touches zero Go.

Follow-up

Once this merges, the planned tag sequence is:

git tag -a vessel/v0.1.0       -m "vessel v0.1.0 — runtime GA"
git tag -a vesseld/v0.1.0-rc.2 -m "vesseld v0.1.0-rc.2 — vessel rc.2 dep bump"
git tag -a vesseld/v0.1.0      -m "vesseld v0.1.0 — daemon GA"
git push origin vessel/v0.1.0 vesseld/v0.1.0-rc.2 vesseld/v0.1.0

release-vesseld.yml then auto-builds the 5-arch matrix + SHA-256s. auto-tag.yml is a no-op for this PR (filters on sdk|sdkx|voice|vessel/** paths, none of which we touched).

Made with Cursor

lIang70 and others added 2 commits May 11, 2026 17:10
- README.md: rewrite Status section against shipped reality
  (durable Postgres/SQLite checkpoints, OTel, Prometheus /metrics
  and the seven-suite eval/ harness are all in place); update the
  v0.2/v0.3 milestone descriptions to align with the refreshed
  roadmap. Add a TCP + bearer-token Quickstart snippet so remote
  access is documented before users hit it.
- examples/vesseld-multi-vessel/README.md: add a "Remote access via
  TCP + bearer token" section with the tokenFile YAML and a curl
  example, and an mTLS-tracked-for-v0.2 caveat.
- CHANGELOG.md: add vesseld/v0.1.0 GA, vesseld/v0.1.0-rc.2 (vessel
  rc.2 dep bump + supervisor races fix), and vessel/v0.1.0 GA
  entries with known-limitations callouts deferred to v0.2.

Co-authored-by: Cursor <cursoragent@cursor.com>
Companion to examples/vesseld-multi-vessel/ (which shows multi-agent
+ Kanban delegation); this one demonstrates how a Vessel preserves
conversation transcripts across turns via a shared HistoryStore
keyed by request context_id.

The README is explicit that v0.1.0 only ships ref: buffer
(in-memory) — cross-restart persistence requires the Compacted
flavor + SessionStore wiring on the v0.2 track, with a pointer to
examples/chatbot-with-recall/ for the in-process pattern callers
can use today.

Validated with `vesseld validate -R` and `vesseld plan -R`.

Co-authored-by: Cursor <cursoragent@cursor.com>
@lIang70
lIang70 merged commit f7fa207 into main May 11, 2026
12 checks passed
@lIang70
lIang70 deleted the chore/vesseld-v0.1.0-ga-prep branch May 11, 2026 09:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant