Skip to content

chore(examples): add vesseld-multi-vessel walkthrough#65

Merged
lIang70 merged 2 commits into
mainfrom
feat/vesseld-examples
May 7, 2026
Merged

chore(examples): add vesseld-multi-vessel walkthrough#65
lIang70 merged 2 commits into
mainfrom
feat/vesseld-examples

Conversation

@lIang70

@lIang70 lIang70 commented May 7, 2026

Copy link
Copy Markdown
Collaborator

Summary

PR-4 (final) of the vessel/vesseld v0.1 series. Documentation-only — no code, no go.mod changes, no CI changes.

Worked example demonstrating the YAML schema and HTTP control plane of vesseld v0.1.

What's in here

`examples/vesseld-multi-vessel/` — two independently-configured vessels sharing one OpenAI `LLMProfile` inside one daemon process:

File Concept
`daemon.yaml` Daemon-wide config: control socket, drain timeout, LLM rate-limit bucket.
`shared/openai.yaml` One `LLMProfile` referenced by every vessel — the daemon shares the underlying client + limiter across them.
`vessels/triage/vessel.yaml` A multi-agent vessel with dispatcher + worker + `Kanban` agent-as-tool delegation.
`vessels/support/vessel.yaml` A simple single-agent vessel for plain Q&A.

Runnable via

```bash
go build -o ./vesseld ./cmd/vesseld
./vesseld validate --config examples/vesseld-multi-vessel -R
./vesseld start --config examples/vesseld-multi-vessel -R
```

The README walks through validate / plan / synchronous call / async submit + SSE log tail / drain.

Test plan

  • YAMLs are byte-identical to `tests/e2e/vesseld/testdata/multi-vessel/` (PR test(vessel,vesseld): quality + e2e black-box suites #64) — same fixtures, same expectations.
  • `vesseld validate --config examples/vesseld-multi-vessel -R` exits 0 against tip-of-main `cmd/vesseld`.
  • CI green

Made with Cursor

lIang70 and others added 2 commits May 7, 2026 15:58
Worked example demonstrating the YAML schema and HTTP control
plane of vesseld v0.1: two independently-configured vessels
(triage with kanban delegation, support for plain Q&A) sharing
one OpenAI LLMProfile inside one daemon process. Runnable via:

  go build -o ./vesseld ./cmd/vesseld
  ./vesseld validate --config examples/vesseld-multi-vessel -R
  ./vesseld start    --config examples/vesseld-multi-vessel -R

The README walks through validate / plan / synchronous call /
async submit + SSE log tail / drain. Pairs with the e2e test
fixtures under tests/e2e/vesseld/testdata/multi-vessel/ which
mirror this layout.

Co-authored-by: Cursor <cursoragent@cursor.com>
@lIang70
lIang70 merged commit 18e6464 into main May 7, 2026
10 checks passed
@lIang70
lIang70 deleted the feat/vesseld-examples branch May 7, 2026 08:00
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