docs(examples): coder-loop + researcher-loop + mcp-delegation + fleet-delegation#51
Merged
Conversation
…-delegation Add four runnable examples covering the driven-loop kernel, the canonical profile presets, the MCP delegation server, and fleet vs sibling placement. - examples/coder-loop — `coderProfile` + `runLoop` + `FanoutVote`; two parallel coder iterations through a synthetic sandbox client; the validator scores test + typecheck + diff cap; kernel picks the winner. - examples/researcher-loop — same shape via `researcherProfile` from `@tangle-network/agent-knowledge/profiles`; the second iteration leaks into a foreign namespace and the validator hard-fails it. - examples/mcp-delegation — the literal `AgentProfile.mcp` entry a product passes to `sandboxClient.create`, plus a stdio JSON-RPC smoke that spawns the locally-built `agent-runtime-mcp` bin and asserts the five canonical tools surface (`delegate_code`, `delegate_research`, `delegate_feedback`, `delegation_status`, `delegation_history`). - examples/fleet-delegation — `TANGLE_FLEET_ID` env flip; runs both `createSiblingSandboxExecutor` and `createFleetWorkspaceExecutor` against structural stubs; ASCII topology diagram. examples/README.md grows a "Trace derivation" section with the diagram showing how `loop.iteration.ended` events flow into `RuntimeRunHandle`, the ingestion ndjson, analyst loops, and the production-loop CI gate. Top-level README adds the four entries to the example list. Bump server version constant in `src/mcp/server.ts` to match the package version so the `initialize` smoke reflects the actual build. 0.21.1 — examples + docs + minor server-version sync. No production API changes.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add four runnable examples covering the driven-loop kernel (0.19+), the
canonical profile presets, the MCP delegation server, and fleet vs sibling
placement. Existing examples covered basic primitives but nothing post-0.18.
coder-loop/— `coderProfile` + `runLoop` + `FanoutVote`; twoparallel coder iterations through a synthetic sandbox client; validator
scores test + typecheck + diff cap; kernel picks the winner.
researcher-loop/— same shape via `researcherProfile` from`@tangle-network/agent-knowledge/profiles`; second iteration leaks into
a foreign namespace and the validator hard-fails it.
mcp-delegation/— the literal `AgentProfile.mcp` entry a productpasses to `sandboxClient.create`, plus a stdio JSON-RPC smoke that
spawns the locally-built `agent-runtime-mcp` bin and asserts the five
canonical tools surface (`delegate_code`, `delegate_research`,
`delegate_feedback`, `delegation_status`, `delegation_history`).
fleet-delegation/— `TANGLE_FLEET_ID` env flip; runs both`createSiblingSandboxExecutor` and `createFleetWorkspaceExecutor`
against structural stubs; ASCII topology diagram.
`examples/README.md` gains a "Trace derivation" section with the diagram
showing how `loop.iteration.ended` events flow into `RuntimeRunHandle`,
the ingestion ndjson, analyst loops, and the production-loop CI gate.
Top-level README adds the four entries to the example list.
Bumps `DEFAULT_SERVER_VERSION` in `src/mcp/server.ts` to match the
package version so the `initialize` smoke reflects the actual build.
Version bump: 0.21.0 → 0.21.1 (examples + docs + minor server-version sync).
Test plan