@agentproto/harness 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeremy André and agentproto contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# @agentproto/harness
+
+Typed presets for spinning up agentproto agent sessions in one call.
+
+## Install
+
+```sh
+pnpm add @agentproto/harness
+```
+
+## Quick-starts
+
+### Coder (claude-code / opus)
+
+```ts
+import { connectHarness, createCoderHarness } from "@agentproto/harness"
+
+const dx = await connectHarness()
+const coder = await createCoderHarness(dx, {
+  workspace: "/path/to/repo",
+  context: { stack: "TypeScript, pnpm", gateCmds: ["pnpm check-types"] },
+})
+
+const result = await coder.ask("Implement the Widget component")
+console.log(result)
+await coder.kill()
+```
+
+### Coder (hermes + deepseek-v4-pro, cheaper)
+
+```ts
+const coder = await createCoderHarness(dx, {
+  workspace: "/path/to/repo",
+  engine: "hermes",   // → deepseek/deepseek-v4-pro via OpenRouter
+  context: { gateCmds: ["pnpm test"] },
+})
+```
+
+### Researcher (hermes + GLM-5.2, large context)
+
+```ts
+import { createResearcherHarness } from "@agentproto/harness"
+
+const researcher = await createResearcherHarness(dx, {
+  // default model: z-ai/glm-5.2 via OpenRouter (1M+ context)
+})
+
+const report = await researcher.ask("Research the top 5 vector DB options in 2025")
+```
+
+### Supervisor (claude-code opus, orchestrates sub-agents)
+
+```ts
+import { createSupervisorHarness } from "@agentproto/harness"
+
+const supervisor = await createSupervisorHarness(dx, {
+  workspace: "/path/to/repo",
+  workPackages: [
+    { id: "WP1", title: "Add auth middleware", description: "...", gate: "pnpm test" },
+    { id: "WP2", title: "Write tests", description: "...", gate: "pnpm test" },
+  ],
+})
+
+await supervisor.waitForTurn({ timeoutMs: 120_000 })
+const tree = await supervisor.subtree()
+```
+
+## Prerequisites
+
+- agentproto daemon running (`agentproto serve`) on port 18790
+- For hermes models: `OPENROUTER_API_KEY` set in the daemon's environment

package/dist/index.d.ts

@@ -0,0 +1,259 @@
+import { ConnectHarnessOptions, StartAgentArgs, SessionDescriptor, TurnEvent, TurnResult, AgentHandle, CoderContext, McpServerMount, OrchestratorOption } from './types.js';
+
+/**
+ * @agentproto/harness — transport client (WP1).
+ *
+ * The single place that touches the MCP SDK + JSON-payload parsing. Connects to
+ * the daemon's `/mcp` endpoint over `StreamableHTTPClientTransport` and exposes
+ * typed wrappers over the session tools. Mirrors the proven pattern in
+ * `packages/cli/src/commands/mcp-bridge.ts:30-58`.
+ *
+ * Tool results come back as `content: [{ type: "text", text: <JSON> }]`; the
+ * `#call` helper unwraps + parses that text payload.
+ */
+
+/** Default daemon MCP endpoint (port 18790; `serve.ts:186,865`). */
+declare const DEFAULT_MCP_URL = "http://127.0.0.1:18790/mcp";
+/**
+ * Resolve the daemon URL: explicit option → `AGENTPROTO_MCP_URL` → default.
+ */
+declare function resolveMcpUrl(opts?: ConnectHarnessOptions): string;
+/**
+ * Thin typed facade over the daemon's session MCP tools. One instance is shared
+ * by all harnesses created against the same daemon.
+ */
+declare class HarnessClient {
+    #private;
+    readonly url: string;
+    private constructor();
+    /**
+     * Connect an MCP client over HTTP to the daemon's `/mcp` endpoint.
+     */
+    static connect(opts?: ConnectHarnessOptions): Promise<HarnessClient>;
+    /** Spawn a session via `start_agent_session`. */
+    start(args: StartAgentArgs): Promise<SessionDescriptor>;
+    /** Send a follow-up turn via `prompt_agent_session` (fire-and-forget). */
+    prompt(sessionId: string, prompt: string): Promise<void>;
+    /** Tail the ring buffer via `get_agent_session_output`. */
+    output(sessionId: string, lastN?: number): Promise<string>;
+    /** SIGTERM via `kill_agent_session`. */
+    kill(sessionId: string): Promise<void>;
+    /**
+     * Multiplexed long-poll via `wait_for_any`. `timeoutMs` is clamped to the
+     * tool's 1 000–49 000 window; a clean timeout surfaces as
+     * `{ event: "timeout" }`.
+     */
+    waitForAny(sessionIds: string[], opts?: {
+        timeoutMs?: number;
+        event?: TurnEvent;
+    }): Promise<TurnResult>;
+    /**
+     * Snapshot the session hierarchy via `session_tree`. When called from a
+     * scoped orchestrator token only the caller's subtree is returned.
+     */
+    sessionTree(sessionId: string, onlyAlive?: boolean): Promise<unknown>;
+    /** Disconnect the underlying transport. */
+    close(): Promise<void>;
+}
+
+/**
+ * @agentproto/harness — AgentHandle factory (WP2, STUB).
+ *
+ * `makeHandle` adapts a `HarnessClient` + a live session into the uniform
+ * `AgentHandle` contract that every preset returns.
+ */
+
+interface MakeHandleMeta {
+    sessionId: string;
+    adapter: string;
+    model?: string;
+}
+/**
+ * Build an `AgentHandle` over a started session.
+ *
+ * WP2: implement `send` (→ client.prompt), `waitForTurn` (→ client.waitForAny
+ * with `event: "any"` to catch `turn-end`, `awaiting-input`, and `exited`),
+ * timeout → `{ event: "timeout" }`), `ask` (send + waitForTurn + output),
+ * `output` (→ client.output), `kill` (→ client.kill).
+ */
+declare function makeHandle(client: HarnessClient, meta: MakeHandleMeta): AgentHandle;
+
+/**
+ * @agentproto/harness — coding context types + rendering.
+ *
+ * Extract of the coder preset's `CoderContext` shape and its prompt renderer,
+ * so both the harness and the supervisor can reference them without a circular
+ * import through the harness file.
+ */
+
+/**
+ * Renders a `CoderContext` into an agent-facing instruction block.
+ *
+ * Produces a short markdown block with stack, conventions, and gate commands
+ * the agent should verify before declaring a task done.
+ */
+declare function renderCoderPrompt(ctx: CoderContext): string;
+
+/**
+ * @agentproto/harness — coder preset (WP3, STUB).
+ *
+ * Spawns a coding agent: `claude-code` (default) or `hermes` routed to a coding
+ * model via OpenRouter. Sets cwd to the workspace and injects a coding context
+ * (stack, conventions, gate commands) as the initial prompt.
+ */
+
+interface CoderHarnessOptions {
+    /** Absolute workspace path (wins over `workspaceSlug`). */
+    workspace?: string;
+    workspaceSlug?: string;
+    /** Engine selector. Default `claude-code`. */
+    engine?: "claude-code" | "hermes";
+    /** Model override. Defaults: claude-code → `claude-opus-4-8`;
+     *  hermes → `deepseek/deepseek-v4-pro` (confirmed live, WP6). */
+    model?: string;
+    /** Reasoning effort. Default `high`. */
+    effort?: string;
+    /** Coding context rendered into the spawn prompt. */
+    context?: CoderContext;
+    label?: string;
+    mcpServers?: McpServerMount[];
+}
+/**
+ * Build the `start_agent_session` args for the coder preset. Exported so WP3's
+ * unit test can snapshot the args for both engines without a live daemon.
+ *
+ * For hermes: `model` and `effort` are NOT included — hermes does not declare
+ * them as manifest options so the daemon rejects them at compose time. Instead,
+ * `createCoderHarness` sends `/model <slug>` as a first prompt turn after spawn.
+ */
+declare function buildCoderArgs(opts: CoderHarnessOptions): StartAgentArgs;
+/** Create a coder session and return its handle. */
+declare function createCoderHarness(client: HarnessClient, opts?: CoderHarnessOptions): Promise<AgentHandle>;
+
+/**
+ * @agentproto/harness — researcher preset (WP4).
+ *
+ * Spawns a big-context research agent: `hermes` routed to GLM-5.2 via
+ * OpenRouter. Mounts a web-search MCP server and injects a structured-output
+ * instruction so replies are parseable.
+ */
+
+interface ResearcherHarnessOptions {
+    /** Model override. Default `z-ai/glm-5.2` (big context, WP6). */
+    model?: string;
+    cwd?: string;
+    workspaceSlug?: string;
+    /** MCP server to mount for web search (e.g. a bureau/search MCP ref). */
+    searchMcp?: McpServerMount;
+    /** JSON schema hint injected into the spawn prompt for structured output. */
+    outputSchema?: Record<string, unknown>;
+    effort?: string;
+    label?: string;
+    mcpServers?: McpServerMount[];
+}
+/** Default output-schema hint the researcher is asked to return. */
+declare const DEFAULT_RESEARCH_SCHEMA: {
+    readonly findings: "string[]";
+    readonly sources: "string[]";
+    readonly confidence: "low | medium | high";
+};
+/**
+ * Render the researcher spawn prompt — an instruction block telling the agent:
+ * 1. It is a researcher agent.
+ * 2. It MUST structure its final answer as JSON matching the outputSchema.
+ * 3. Brief format hint: { findings: [...], sources: [...], confidence: "..." }
+ *
+ * Exported for unit tests.
+ */
+declare function renderResearcherPrompt(opts: ResearcherHarnessOptions): string;
+/**
+ * Build the `start_agent_session` args for the researcher preset.
+ * Exported so WP4's unit test can assert `mcpServers` + schema are present.
+ *
+ * `model`, `effort`, and the system `prompt` are NOT included here —
+ * `createResearcherHarness` delivers them as controlled turns after spawn
+ * so each step has exactly one turn-end to drain:
+ *   1. `/model <slug>` → model switch turn-end (fast)
+ *   2. system prompt turn → LLM response turn-end (may be slow)
+ * This avoids the race where a spawn-time prompt fires a turn-end that
+ * interferes with the caller's first `ask()`.
+ */
+declare function buildResearcherArgs(opts: ResearcherHarnessOptions): StartAgentArgs;
+/** Create a researcher session and return its handle. */
+declare function createResearcherHarness(client: HarnessClient, opts?: ResearcherHarnessOptions): Promise<AgentHandle>;
+
+/**
+ * @agentproto/harness — WorkPackage type + supervisor prompt renderer (WP5).
+ *
+ * A WorkPackage describes a unit of work the supervisor assigns to a sub-agent.
+ * `renderSupervisorPrompt` turns a list into a markdown orchestration brief.
+ */
+/** A unit of work the supervisor harness assigns to a sub-agent. */
+interface WorkPackage {
+    id: string;
+    title: string;
+    description: string;
+    files?: string[];
+    gate?: string;
+}
+/** Renders a WP list into a supervisor orchestration brief. */
+declare function renderSupervisorPrompt(workPackages: WorkPackage[]): string;
+
+/**
+ * @agentproto/harness — supervisor preset (WP5).
+ *
+ * Spawns a `claude-code` opus orchestrator with `orchestrator: true` so it can
+ * spawn + supervise its OWN sub-agents via the daemon's scoped sub-gateway.
+ * Accepts a Work-Package list and renders it into an orchestration brief, and
+ * adds fan-in helpers (`subtree`, `waitForAnyChild`) on top of `AgentHandle`.
+ */
+
+interface SupervisorHarnessOptions {
+    workspace?: string;
+    workspaceSlug?: string;
+    /** Model override. Default `claude-opus-4-8`. */
+    model?: string;
+    effort?: string;
+    /** Scoped-orchestrator config. Default `true` (curated subset). */
+    orchestrator?: OrchestratorOption;
+    /** Work packages to render into the orchestration brief. */
+    workPackages?: WorkPackage[];
+    label?: string;
+}
+/** Supervisor handle adds fan-in helpers over the base contract. */
+interface SupervisorHandle extends AgentHandle {
+    /** Snapshot this session's child subtree (→ `session_tree`). */
+    subtree(): Promise<unknown>;
+    /** Block until ANY child session ends a turn (→ `wait_for_any`). */
+    waitForAnyChild(opts?: {
+        timeoutMs?: number;
+    }): Promise<TurnResult>;
+}
+/**
+ * Build the `start_agent_session` args for the supervisor preset. Exported so
+ * WP5's unit test can assert `orchestrator` + the rendered WP brief.
+ */
+declare function buildSupervisorArgs(opts: SupervisorHarnessOptions): StartAgentArgs;
+/** Create a supervisor session and return its (extended) handle. */
+declare function createSupervisorHarness(client: HarnessClient, opts?: SupervisorHarnessOptions): Promise<SupervisorHandle>;
+
+/**
+ * @agentproto/harness — public barrel.
+ *
+ * Typed, one-call agent-session presets over the agentproto daemon's session
+ * tools. Connect once, then spin up `coder` / `researcher` / `supervisor`
+ * sessions that all resolve to the uniform `AgentHandle` contract.
+ *
+ *   import { connectHarness, createCoderHarness } from "@agentproto/harness"
+ *   const dx = await connectHarness()
+ *   const coder = await createCoderHarness(dx, { workspace: process.cwd() })
+ *   const reply = await coder.ask("Add a health-check route")
+ */
+
+/**
+ * Connect the shared transport to the daemon's `/mcp` endpoint. Returns a
+ * `HarnessClient` to hand to the `create*Harness` factories.
+ */
+declare function connectHarness(opts?: ConnectHarnessOptions): Promise<HarnessClient>;
+
+export { AgentHandle, CoderContext, type CoderHarnessOptions, ConnectHarnessOptions, DEFAULT_MCP_URL, DEFAULT_RESEARCH_SCHEMA, HarnessClient, McpServerMount, OrchestratorOption, type ResearcherHarnessOptions, SessionDescriptor, StartAgentArgs, type SupervisorHandle, type SupervisorHarnessOptions, TurnEvent, TurnResult, type WorkPackage, buildCoderArgs, buildResearcherArgs, buildSupervisorArgs, connectHarness, createCoderHarness, createResearcherHarness, createSupervisorHarness, makeHandle, renderCoderPrompt, renderResearcherPrompt, renderSupervisorPrompt, resolveMcpUrl };

package/dist/index.mjs

@@ -0,0 +1,322 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+
+/**
+ * @agentproto/harness v0.1.0-alpha
+ * Typed one-call agent-session presets over the agentproto daemon.
+ */
+
+var DEFAULT_MCP_URL = "http://127.0.0.1:18790/mcp";
+function resolveMcpUrl(opts) {
+  return opts?.url ?? process.env.AGENTPROTO_MCP_URL ?? DEFAULT_MCP_URL;
+}
+var HarnessClient = class _HarnessClient {
+  url;
+  #client;
+  constructor(url, client) {
+    this.url = url;
+    this.#client = client;
+  }
+  /**
+   * Connect an MCP client over HTTP to the daemon's `/mcp` endpoint.
+   */
+  static async connect(opts) {
+    const url = resolveMcpUrl(opts);
+    const client = new Client(
+      { name: "harness", version: "0.1.0" },
+      { capabilities: {} }
+    );
+    const transport = new StreamableHTTPClientTransport(new URL(url));
+    await client.connect(transport);
+    return new _HarnessClient(url, client);
+  }
+  /** Spawn a session via `start_agent_session`. */
+  async start(args) {
+    return this.#call("start_agent_session", args);
+  }
+  /** Send a follow-up turn via `prompt_agent_session` (fire-and-forget). */
+  async prompt(sessionId, prompt) {
+    await this.#call("prompt_agent_session", { sessionId, prompt });
+  }
+  /** Tail the ring buffer via `get_agent_session_output`. */
+  async output(sessionId, lastN) {
+    const res = await this.#call(
+      "get_agent_session_output",
+      { sessionId, lastN }
+    );
+    return (res.lines ?? []).join("\n");
+  }
+  /** SIGTERM via `kill_agent_session`. */
+  async kill(sessionId) {
+    await this.#call("kill_agent_session", { sessionId });
+  }
+  /**
+   * Multiplexed long-poll via `wait_for_any`. `timeoutMs` is clamped to the
+   * tool's 1 000–49 000 window; a clean timeout surfaces as
+   * `{ event: "timeout" }`.
+   */
+  async waitForAny(sessionIds, opts) {
+    return this.#call("wait_for_any", {
+      sessionIds,
+      ...opts?.timeoutMs !== void 0 ? { timeoutMs: opts.timeoutMs } : {},
+      ...opts?.event !== void 0 ? { event: opts.event } : {}
+    });
+  }
+  /**
+   * Snapshot the session hierarchy via `session_tree`. When called from a
+   * scoped orchestrator token only the caller's subtree is returned.
+   */
+  async sessionTree(sessionId, onlyAlive) {
+    return this.#call("session_tree", {
+      sessionId,
+      ...onlyAlive !== void 0 ? { onlyAlive } : {}
+    });
+  }
+  /** Disconnect the underlying transport. */
+  async close() {
+    await this.#client.close();
+  }
+  // ── private helpers ────────────────────────────────────────────────
+  /** Call a daemon MCP tool and unwrap its JSON response. */
+  async #call(name, args) {
+    const res = await this.#client.callTool({ name, arguments: args });
+    const text = res.content[0]?.text;
+    if (!text) {
+      throw new Error(`No content from tool \`${name}\``);
+    }
+    if (res.isError) {
+      throw new Error(`Tool \`${name}\` returned error: ${text}`);
+    }
+    return JSON.parse(text);
+  }
+};
+
+// src/handle.ts
+function makeHandle(client, meta) {
+  return {
+    sessionId: meta.sessionId,
+    adapter: meta.adapter,
+    model: meta.model,
+    async send(prompt) {
+      await client.prompt(meta.sessionId, prompt);
+    },
+    async waitForTurn(opts) {
+      return client.waitForAny([meta.sessionId], {
+        event: "any",
+        ...opts?.timeoutMs !== void 0 ? { timeoutMs: opts.timeoutMs } : {}
+      });
+    },
+    async ask(prompt, opts) {
+      const waitPromise = client.waitForAny([meta.sessionId], {
+        event: "any",
+        timeoutMs: opts?.timeoutMs !== void 0 ? opts.timeoutMs : 45e3
+      });
+      await client.prompt(meta.sessionId, prompt);
+      const result = await waitPromise;
+      if (result.event === "timeout") return "[timeout]";
+      return client.output(meta.sessionId);
+    },
+    async output(opts) {
+      return client.output(meta.sessionId, opts?.lastN);
+    },
+    async kill() {
+      await client.kill(meta.sessionId);
+    }
+  };
+}
+
+// src/context.ts
+function renderCoderPrompt(ctx) {
+  const parts = ["## Coding context"];
+  if (ctx.stack) parts.push(`**Stack:** ${ctx.stack}`);
+  if (ctx.conventions) parts.push(`**Conventions:** ${ctx.conventions}`);
+  if (ctx.gateCmds?.length) {
+    parts.push(
+      `**Gate:** ${ctx.gateCmds.map((c) => `\`${c}\``).join(" \xB7 ")}`
+    );
+  }
+  if (ctx.extra) parts.push(ctx.extra);
+  return parts.join("\n");
+}
+
+// src/harnesses/coder.ts
+var DEFAULTS = {
+  claudeCodeModel: "claude-opus-4-8",
+  hermesModel: "deepseek/deepseek-v4-pro",
+  effort: "high"
+};
+function buildCoderArgs(opts) {
+  const engine = opts.engine ?? "claude-code";
+  const isHermes = engine === "hermes";
+  const model = opts.model ?? (isHermes ? DEFAULTS.hermesModel : DEFAULTS.claudeCodeModel);
+  return {
+    adapter: engine,
+    ...isHermes ? {} : { model, effort: opts.effort ?? DEFAULTS.effort },
+    ...opts.workspace ? { cwd: opts.workspace } : {},
+    ...opts.workspaceSlug ? { workspaceSlug: opts.workspaceSlug } : {},
+    ...opts.context ? { prompt: renderCoderPrompt(opts.context) } : {},
+    ...opts.label ? { label: opts.label } : {},
+    ...opts.mcpServers ? { mcpServers: opts.mcpServers } : {}
+  };
+}
+async function createCoderHarness(client, opts = {}) {
+  const engine = opts.engine ?? "claude-code";
+  const isHermes = engine === "hermes";
+  const modelSlug = isHermes ? opts.model ?? DEFAULTS.hermesModel : opts.model ?? DEFAULTS.claudeCodeModel;
+  const args = buildCoderArgs(opts);
+  const desc = await client.start(args);
+  if (isHermes && modelSlug) {
+    await client.prompt(desc.id, `/model ${modelSlug}`);
+    await client.waitForAny([desc.id], { event: "turn-end", timeoutMs: 15e3 });
+  }
+  return makeHandle(client, {
+    sessionId: desc.id,
+    adapter: args.adapter,
+    model: modelSlug
+  });
+}
+
+// src/harnesses/researcher.ts
+var DEFAULTS2 = {
+  model: "z-ai/glm-5.2"
+};
+var DEFAULT_RESEARCH_SCHEMA = {
+  findings: "string[]",
+  sources: "string[]",
+  confidence: "low | medium | high"
+};
+function renderResearcherPrompt(opts) {
+  const schema = opts.outputSchema ?? DEFAULT_RESEARCH_SCHEMA;
+  return [
+    "You are a researcher agent. Use the available web-search tools to gather",
+    "evidence and synthesize findings.",
+    "Always reply in English regardless of the query language.",
+    "",
+    "You MUST structure your final answer as JSON matching this schema:",
+    JSON.stringify(schema, null, 2),
+    "",
+    "Format hint:",
+    "  {",
+    '    "findings": ["key finding 1", "key finding 2", ...],',
+    '    "sources": ["url or citation", ...],',
+    '    "confidence": "low | medium | high"',
+    "  }"
+  ].join("\n");
+}
+function buildResearcherArgs(opts) {
+  const mcpServers = [
+    ...opts.mcpServers ?? [],
+    ...opts.searchMcp ? [opts.searchMcp] : []
+  ];
+  return {
+    adapter: "hermes",
+    ...opts.cwd ? { cwd: opts.cwd } : {},
+    ...opts.workspaceSlug ? { workspaceSlug: opts.workspaceSlug } : {},
+    ...mcpServers.length ? { mcpServers } : {},
+    ...opts.label ? { label: opts.label } : {}
+  };
+}
+async function createResearcherHarness(client, opts = {}) {
+  const modelSlug = opts.model ?? DEFAULTS2.model;
+  const args = buildResearcherArgs(opts);
+  const desc = await client.start(args);
+  if (modelSlug) {
+    await client.prompt(desc.id, `/model ${modelSlug}`);
+    await client.waitForAny([desc.id], { event: "turn-end", timeoutMs: 15e3 });
+  }
+  await client.prompt(desc.id, renderResearcherPrompt(opts));
+  await client.waitForAny([desc.id], { event: "turn-end", timeoutMs: 3e4 });
+  return makeHandle(client, {
+    sessionId: desc.id,
+    adapter: args.adapter,
+    model: modelSlug
+  });
+}
+
+// src/wp.ts
+function renderSupervisorPrompt(workPackages) {
+  const header = "You are a supervisor agent. Execute the following work packages in order, assigning each to a sub-agent. Gate each WP before proceeding to the next.";
+  const body = workPackages.map((wp) => {
+    let s = `## ${wp.id} \u2014 ${wp.title}
+${wp.description}`;
+    if (wp.files?.length) s += `
+Files: ${wp.files.join(", ")}`;
+    if (wp.gate) s += `
+Gate: ${wp.gate}`;
+    return s;
+  }).join("\n\n");
+  return `${header}
+
+${body}`;
+}
+
+// src/harnesses/supervisor.ts
+var DEFAULTS3 = {
+  model: "claude-opus-4-8",
+  effort: "high"
+};
+function buildSupervisorArgs(opts) {
+  return {
+    adapter: "claude-code",
+    model: opts.model ?? DEFAULTS3.model,
+    effort: opts.effort ?? DEFAULTS3.effort,
+    orchestrator: opts.orchestrator ?? true,
+    ...opts.workspace ? { cwd: opts.workspace } : {},
+    ...opts.workspaceSlug ? { workspaceSlug: opts.workspaceSlug } : {},
+    ...opts.workPackages?.length ? { prompt: renderSupervisorPrompt(opts.workPackages) } : {},
+    ...opts.label ? { label: opts.label } : {}
+  };
+}
+async function createSupervisorHarness(client, opts = {}) {
+  const args = buildSupervisorArgs(opts);
+  const desc = await client.start(args);
+  const base = makeHandle(client, {
+    sessionId: desc.id,
+    adapter: args.adapter,
+    ...args.model ? { model: args.model } : {}
+  });
+  return {
+    ...base,
+    async subtree() {
+      return client.sessionTree(desc.id);
+    },
+    async waitForAnyChild(opts2) {
+      const data = await client.sessionTree(desc.id);
+      const childIds = collectChildIds(data.tree ?? []);
+      if (childIds.length === 0) {
+        return {
+          sessionId: desc.id,
+          event: "timeout"
+        };
+      }
+      const CHUNK = 20;
+      if (childIds.length <= CHUNK) {
+        return client.waitForAny(childIds, opts2);
+      }
+      const chunks = [];
+      for (let i = 0; i < childIds.length; i += CHUNK) {
+        chunks.push(childIds.slice(i, i + CHUNK));
+      }
+      return Promise.race(chunks.map((chunk) => client.waitForAny(chunk, opts2)));
+    }
+  };
+}
+function collectChildIds(nodes) {
+  const ids = [];
+  for (const node of nodes) {
+    ids.push(node.id);
+    if (node.children?.length) {
+      ids.push(...collectChildIds(node.children));
+    }
+  }
+  return ids;
+}
+
+// src/index.ts
+async function connectHarness(opts) {
+  return HarnessClient.connect(opts);
+}
+
+export { DEFAULT_MCP_URL, DEFAULT_RESEARCH_SCHEMA, HarnessClient, buildCoderArgs, buildResearcherArgs, buildSupervisorArgs, connectHarness, createCoderHarness, createResearcherHarness, createSupervisorHarness, makeHandle, renderCoderPrompt, renderResearcherPrompt, renderSupervisorPrompt, resolveMcpUrl };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/handle.ts","../src/context.ts","../src/harnesses/coder.ts","../src/harnesses/researcher.ts","../src/wp.ts","../src/harnesses/supervisor.ts","../src/index.ts"],"names":["DEFAULTS","opts"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @agentproto/harness — transport client (WP1).\n *\n * The single place that touches the MCP SDK + JSON-payload parsing. Connects to\n * the daemon's `/mcp` endpoint over `StreamableHTTPClientTransport` and exposes\n * typed wrappers over the session tools. Mirrors the proven pattern in\n * `packages/cli/src/commands/mcp-bridge.ts:30-58`.\n *\n * Tool results come back as `content: [{ type: \"text\", text: <JSON> }]`; the\n * `#call` helper unwraps + parses that text payload.\n */\n\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\"\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\"\nimport type {\n  ConnectHarnessOptions,\n  SessionDescriptor,\n  StartAgentArgs,\n  TurnEvent,\n  TurnResult,\n} from \"./types.js\"\n\n/** Default daemon MCP endpoint (port 18790; `serve.ts:186,865`). */\nexport const DEFAULT_MCP_URL = \"http://127.0.0.1:18790/mcp\"\n\n/**\n * Resolve the daemon URL: explicit option → `AGENTPROTO_MCP_URL` → default.\n */\nexport function resolveMcpUrl(opts?: ConnectHarnessOptions): string {\n  return (\n    opts?.url ?? process.env.AGENTPROTO_MCP_URL ?? DEFAULT_MCP_URL\n  )\n}\n\n/**\n * Thin typed facade over the daemon's session MCP tools. One instance is shared\n * by all harnesses created against the same daemon.\n */\nexport class HarnessClient {\n  readonly url: string\n  #client: Client\n\n  private constructor(url: string, client: Client) {\n    this.url = url\n    this.#client = client\n  }\n\n  /**\n   * Connect an MCP client over HTTP to the daemon's `/mcp` endpoint.\n   */\n  static async connect(opts?: ConnectHarnessOptions): Promise<HarnessClient> {\n    const url = resolveMcpUrl(opts)\n    const client = new Client(\n      { name: \"harness\", version: \"0.1.0\" },\n      { capabilities: {} },\n    )\n    const transport = new StreamableHTTPClientTransport(new URL(url))\n    await client.connect(transport)\n    return new HarnessClient(url, client)\n  }\n\n  /** Spawn a session via `start_agent_session`. */\n  async start(args: StartAgentArgs): Promise<SessionDescriptor> {\n    return this.#call(\"start_agent_session\", args as unknown as Record<string, unknown>)\n  }\n\n  /** Send a follow-up turn via `prompt_agent_session` (fire-and-forget). */\n  async prompt(sessionId: string, prompt: string): Promise<void> {\n    await this.#call(\"prompt_agent_session\", { sessionId, prompt })\n  }\n\n  /** Tail the ring buffer via `get_agent_session_output`. */\n  async output(sessionId: string, lastN?: number): Promise<string> {\n    const res = await this.#call<{ lines?: string[] }>(\n      \"get_agent_session_output\",\n      { sessionId, lastN },\n    )\n    return (res.lines ?? []).join(\"\\n\")\n  }\n\n  /** SIGTERM via `kill_agent_session`. */\n  async kill(sessionId: string): Promise<void> {\n    await this.#call(\"kill_agent_session\", { sessionId })\n  }\n\n  /**\n   * Multiplexed long-poll via `wait_for_any`. `timeoutMs` is clamped to the\n   * tool's 1 000–49 000 window; a clean timeout surfaces as\n   * `{ event: \"timeout\" }`.\n   */\n  async waitForAny(\n    sessionIds: string[],\n    opts?: { timeoutMs?: number; event?: TurnEvent },\n  ): Promise<TurnResult> {\n    return this.#call(\"wait_for_any\", {\n      sessionIds,\n      ...(opts?.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),\n      ...(opts?.event !== undefined ? { event: opts.event } : {}),\n    })\n  }\n\n  /**\n   * Snapshot the session hierarchy via `session_tree`. When called from a\n   * scoped orchestrator token only the caller's subtree is returned.\n   */\n  async sessionTree(sessionId: string, onlyAlive?: boolean): Promise<unknown> {\n    return this.#call(\"session_tree\", {\n      sessionId,\n      ...(onlyAlive !== undefined ? { onlyAlive } : {}),\n    })\n  }\n\n  /** Disconnect the underlying transport. */\n  async close(): Promise<void> {\n    await this.#client.close()\n  }\n\n  // ── private helpers ────────────────────────────────────────────────\n\n  /** Call a daemon MCP tool and unwrap its JSON response. */\n  async #call<T = unknown>(\n    name: string,\n    args: Record<string, unknown>,\n  ): Promise<T> {\n    const res = await this.#client.callTool({ name, arguments: args })\n    const text = (\n      res.content as Array<{ type: string; text?: string }>\n    )[0]?.text\n    if (!text) {\n      throw new Error(`No content from tool \\`${name}\\``)\n    }\n    // TODO: remove cast once SDK types are stable — CallToolResult already\n    // carries isError?: boolean in newer SDK versions.\n    if ((res as { isError?: boolean }).isError) {\n      throw new Error(`Tool \\`${name}\\` returned error: ${text}`)\n    }\n    return JSON.parse(text) as T\n  }\n}\n","/**\n * @agentproto/harness — AgentHandle factory (WP2, STUB).\n *\n * `makeHandle` adapts a `HarnessClient` + a live session into the uniform\n * `AgentHandle` contract that every preset returns.\n */\n\nimport type { HarnessClient } from \"./client.js\"\nimport type { AgentHandle, TurnResult } from \"./types.js\"\n\nexport type { AgentHandle } from \"./types.js\"\n\nexport interface MakeHandleMeta {\n  sessionId: string\n  adapter: string\n  model?: string\n}\n\n/**\n * Build an `AgentHandle` over a started session.\n *\n * WP2: implement `send` (→ client.prompt), `waitForTurn` (→ client.waitForAny\n * with `event: \"any\"` to catch `turn-end`, `awaiting-input`, and `exited`),\n * timeout → `{ event: \"timeout\" }`), `ask` (send + waitForTurn + output),\n * `output` (→ client.output), `kill` (→ client.kill).\n */\nexport function makeHandle(\n  client: HarnessClient,\n  meta: MakeHandleMeta,\n): AgentHandle {\n  return {\n    sessionId: meta.sessionId,\n    adapter: meta.adapter,\n    model: meta.model,\n\n    async send(prompt: string): Promise<void> {\n      await client.prompt(meta.sessionId, prompt)\n    },\n\n    async waitForTurn(opts?: { timeoutMs?: number }): Promise<TurnResult> {\n      return client.waitForAny([meta.sessionId], {\n        event: \"any\",\n        ...(opts?.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),\n      })\n    },\n\n    async ask(prompt: string, opts?: { timeoutMs?: number }): Promise<string> {\n      // Start the wait BEFORE sending to avoid a race window: if the agent\n      // turns around extremely fast the prompt could produce a turn-end before\n      // waitForAny subscribes.\n      const waitPromise = client.waitForAny([meta.sessionId], {\n        event: \"any\",\n        timeoutMs: opts?.timeoutMs !== undefined ? opts.timeoutMs : 45000,\n      })\n      await client.prompt(meta.sessionId, prompt)\n      const result = await waitPromise\n      if (result.event === \"timeout\") return \"[timeout]\"\n      return client.output(meta.sessionId)\n    },\n\n    async output(opts?: { lastN?: number }): Promise<string> {\n      return client.output(meta.sessionId, opts?.lastN)\n    },\n\n    async kill(): Promise<void> {\n      await client.kill(meta.sessionId)\n    },\n  }\n}\n","/**\n * @agentproto/harness — coding context types + rendering.\n *\n * Extract of the coder preset's `CoderContext` shape and its prompt renderer,\n * so both the harness and the supervisor can reference them without a circular\n * import through the harness file.\n */\n\nimport type { CoderContext } from \"./types.js\"\n\nexport type { CoderContext }\n\n/**\n * Renders a `CoderContext` into an agent-facing instruction block.\n *\n * Produces a short markdown block with stack, conventions, and gate commands\n * the agent should verify before declaring a task done.\n */\nexport function renderCoderPrompt(ctx: CoderContext): string {\n  const parts: string[] = [\"## Coding context\"]\n  if (ctx.stack) parts.push(`**Stack:** ${ctx.stack}`)\n  if (ctx.conventions) parts.push(`**Conventions:** ${ctx.conventions}`)\n  if (ctx.gateCmds?.length) {\n    parts.push(\n      `**Gate:** ${ctx.gateCmds.map((c) => `\\`${c}\\``).join(\" · \")}`,\n    )\n  }\n  if (ctx.extra) parts.push(ctx.extra)\n  return parts.join(\"\\n\")\n}","/**\n * @agentproto/harness — coder preset (WP3, STUB).\n *\n * Spawns a coding agent: `claude-code` (default) or `hermes` routed to a coding\n * model via OpenRouter. Sets cwd to the workspace and injects a coding context\n * (stack, conventions, gate commands) as the initial prompt.\n */\n\nimport type { HarnessClient } from \"../client.js\"\nimport { renderCoderPrompt } from \"../context.js\"\nexport { renderCoderPrompt }\nimport type { CoderContext } from \"../context.js\"\nimport { makeHandle } from \"../handle.js\"\nimport type {\n  AgentHandle,\n  McpServerMount,\n  StartAgentArgs,\n} from \"../types.js\"\n\nexport interface CoderHarnessOptions {\n  /** Absolute workspace path (wins over `workspaceSlug`). */\n  workspace?: string\n  workspaceSlug?: string\n  /** Engine selector. Default `claude-code`. */\n  engine?: \"claude-code\" | \"hermes\"\n  /** Model override. Defaults: claude-code → `claude-opus-4-8`;\n   *  hermes → `deepseek/deepseek-v4-pro` (confirmed live, WP6). */\n  model?: string\n  /** Reasoning effort. Default `high`. */\n  effort?: string\n  /** Coding context rendered into the spawn prompt. */\n  context?: CoderContext\n  label?: string\n  mcpServers?: McpServerMount[]\n}\n\nconst DEFAULTS = {\n  claudeCodeModel: \"claude-opus-4-8\",\n  hermesModel: \"deepseek/deepseek-v4-pro\",\n  effort: \"high\",\n} as const\n\n/**\n * Build the `start_agent_session` args for the coder preset. Exported so WP3's\n * unit test can snapshot the args for both engines without a live daemon.\n *\n * For hermes: `model` and `effort` are NOT included — hermes does not declare\n * them as manifest options so the daemon rejects them at compose time. Instead,\n * `createCoderHarness` sends `/model <slug>` as a first prompt turn after spawn.\n */\nexport function buildCoderArgs(opts: CoderHarnessOptions): StartAgentArgs {\n  const engine = opts.engine ?? \"claude-code\"\n  const isHermes = engine === \"hermes\"\n  const model =\n    opts.model ??\n    (isHermes ? DEFAULTS.hermesModel : DEFAULTS.claudeCodeModel)\n  return {\n    adapter: engine,\n    ...(isHermes ? {} : { model, effort: opts.effort ?? DEFAULTS.effort }),\n    ...(opts.workspace ? { cwd: opts.workspace } : {}),\n    ...(opts.workspaceSlug ? { workspaceSlug: opts.workspaceSlug } : {}),\n    ...(opts.context ? { prompt: renderCoderPrompt(opts.context) } : {}),\n    ...(opts.label ? { label: opts.label } : {}),\n    ...(opts.mcpServers ? { mcpServers: opts.mcpServers } : {}),\n  }\n}\n\n/** Create a coder session and return its handle. */\nexport async function createCoderHarness(\n  client: HarnessClient,\n  opts: CoderHarnessOptions = {},\n): Promise<AgentHandle> {\n  const engine = opts.engine ?? \"claude-code\"\n  const isHermes = engine === \"hermes\"\n  const modelSlug = isHermes\n    ? (opts.model ?? DEFAULTS.hermesModel)\n    : (opts.model ?? DEFAULTS.claudeCodeModel)\n  const args = buildCoderArgs(opts)\n  const desc = await client.start(args)\n  if (isHermes && modelSlug) {\n    await client.prompt(desc.id, `/model ${modelSlug}`)\n    // wait for the model-switch turn to complete before caller uses the handle,\n    // otherwise waitForTurn() on the first ask() triggers on this event instead\n    await client.waitForAny([desc.id], { event: \"turn-end\", timeoutMs: 15_000 })\n  }\n  return makeHandle(client, {\n    sessionId: desc.id,\n    adapter: args.adapter,\n    model: modelSlug,\n  })\n}\n","/**\n * @agentproto/harness — researcher preset (WP4).\n *\n * Spawns a big-context research agent: `hermes` routed to GLM-5.2 via\n * OpenRouter. Mounts a web-search MCP server and injects a structured-output\n * instruction so replies are parseable.\n */\n\nimport type { HarnessClient } from \"../client.js\"\nimport { makeHandle } from \"../handle.js\"\nimport type {\n  AgentHandle,\n  McpServerMount,\n  StartAgentArgs,\n} from \"../types.js\"\n\nexport interface ResearcherHarnessOptions {\n  /** Model override. Default `z-ai/glm-5.2` (big context, WP6). */\n  model?: string\n  cwd?: string\n  workspaceSlug?: string\n  /** MCP server to mount for web search (e.g. a bureau/search MCP ref). */\n  searchMcp?: McpServerMount\n  /** JSON schema hint injected into the spawn prompt for structured output. */\n  outputSchema?: Record<string, unknown>\n  effort?: string\n  label?: string\n  mcpServers?: McpServerMount[]\n}\n\nconst DEFAULTS = {\n  model: \"z-ai/glm-5.2\",\n} as const\n\n/** Default output-schema hint the researcher is asked to return. */\nexport const DEFAULT_RESEARCH_SCHEMA = {\n  findings: \"string[]\",\n  sources: \"string[]\",\n  confidence: \"low | medium | high\",\n} as const\n\n/**\n * Render the researcher spawn prompt — an instruction block telling the agent:\n * 1. It is a researcher agent.\n * 2. It MUST structure its final answer as JSON matching the outputSchema.\n * 3. Brief format hint: { findings: [...], sources: [...], confidence: \"...\" }\n *\n * Exported for unit tests.\n */\nexport function renderResearcherPrompt(\n  opts: ResearcherHarnessOptions,\n): string {\n  const schema = opts.outputSchema ?? DEFAULT_RESEARCH_SCHEMA\n  return [\n    \"You are a researcher agent. Use the available web-search tools to gather\",\n    \"evidence and synthesize findings.\",\n    \"Always reply in English regardless of the query language.\",\n    \"\",\n    \"You MUST structure your final answer as JSON matching this schema:\",\n    JSON.stringify(schema, null, 2),\n    \"\",\n    \"Format hint:\",\n    \"  {\",\n    '    \"findings\": [\"key finding 1\", \"key finding 2\", ...],',\n    '    \"sources\": [\"url or citation\", ...],',\n    '    \"confidence\": \"low | medium | high\"',\n    \"  }\",\n  ].join(\"\\n\")\n}\n\n/**\n * Build the `start_agent_session` args for the researcher preset.\n * Exported so WP4's unit test can assert `mcpServers` + schema are present.\n *\n * `model`, `effort`, and the system `prompt` are NOT included here —\n * `createResearcherHarness` delivers them as controlled turns after spawn\n * so each step has exactly one turn-end to drain:\n *   1. `/model <slug>` → model switch turn-end (fast)\n *   2. system prompt turn → LLM response turn-end (may be slow)\n * This avoids the race where a spawn-time prompt fires a turn-end that\n * interferes with the caller's first `ask()`.\n */\nexport function buildResearcherArgs(\n  opts: ResearcherHarnessOptions,\n): StartAgentArgs {\n  // effort is not supported for hermes engine (not declared as a manifest option)\n  const mcpServers: McpServerMount[] = [\n    ...(opts.mcpServers ?? []),\n    ...(opts.searchMcp ? [opts.searchMcp] : []),\n  ]\n  return {\n    adapter: \"hermes\",\n    ...(opts.cwd ? { cwd: opts.cwd } : {}),\n    ...(opts.workspaceSlug ? { workspaceSlug: opts.workspaceSlug } : {}),\n    ...(mcpServers.length ? { mcpServers } : {}),\n    ...(opts.label ? { label: opts.label } : {}),\n  }\n}\n\n/** Create a researcher session and return its handle. */\nexport async function createResearcherHarness(\n  client: HarnessClient,\n  opts: ResearcherHarnessOptions = {},\n): Promise<AgentHandle> {\n  const modelSlug = opts.model ?? DEFAULTS.model\n  const args = buildResearcherArgs(opts)\n  const desc = await client.start(args)\n  if (modelSlug) {\n    // Step 1: switch model, drain its fast turn-end\n    await client.prompt(desc.id, `/model ${modelSlug}`)\n    await client.waitForAny([desc.id], { event: \"turn-end\", timeoutMs: 15_000 })\n  }\n  // Step 2: inject system prompt as an explicit turn, drain LLM response\n  await client.prompt(desc.id, renderResearcherPrompt(opts))\n  await client.waitForAny([desc.id], { event: \"turn-end\", timeoutMs: 30_000 })\n  return makeHandle(client, {\n    sessionId: desc.id,\n    adapter: args.adapter,\n    model: modelSlug,\n  })\n}","/**\n * @agentproto/harness — WorkPackage type + supervisor prompt renderer (WP5).\n *\n * A WorkPackage describes a unit of work the supervisor assigns to a sub-agent.\n * `renderSupervisorPrompt` turns a list into a markdown orchestration brief.\n */\n\n/** A unit of work the supervisor harness assigns to a sub-agent. */\nexport interface WorkPackage {\n  id: string          // e.g. \"WP1\"\n  title: string\n  description: string\n  files?: string[]    // file scope\n  gate?: string       // gate command\n}\n\n/** Renders a WP list into a supervisor orchestration brief. */\nexport function renderSupervisorPrompt(workPackages: WorkPackage[]): string {\n  const header =\n    \"You are a supervisor agent. Execute the following work packages in order, \" +\n    \"assigning each to a sub-agent. Gate each WP before proceeding to the next.\"\n\n  const body = workPackages\n    .map(wp => {\n      let s = `## ${wp.id} — ${wp.title}\\n${wp.description}`\n      if (wp.files?.length) s += `\\nFiles: ${wp.files.join(\", \")}`\n      if (wp.gate) s += `\\nGate: ${wp.gate}`\n      return s\n    })\n    .join(\"\\n\\n\")\n\n  return `${header}\\n\\n${body}`\n}","/**\n * @agentproto/harness — supervisor preset (WP5).\n *\n * Spawns a `claude-code` opus orchestrator with `orchestrator: true` so it can\n * spawn + supervise its OWN sub-agents via the daemon's scoped sub-gateway.\n * Accepts a Work-Package list and renders it into an orchestration brief, and\n * adds fan-in helpers (`subtree`, `waitForAnyChild`) on top of `AgentHandle`.\n */\n\nimport type { HarnessClient } from \"../client.js\"\nimport { makeHandle } from \"../handle.js\"\nimport type {\n  AgentHandle,\n  OrchestratorOption,\n  StartAgentArgs,\n  TurnResult,\n} from \"../types.js\"\nimport type { WorkPackage } from \"../wp.js\"\nimport { renderSupervisorPrompt } from \"../wp.js\"\nexport { renderSupervisorPrompt }\n\nexport interface SupervisorHarnessOptions {\n  workspace?: string\n  workspaceSlug?: string\n  /** Model override. Default `claude-opus-4-8`. */\n  model?: string\n  effort?: string\n  /** Scoped-orchestrator config. Default `true` (curated subset). */\n  orchestrator?: OrchestratorOption\n  /** Work packages to render into the orchestration brief. */\n  workPackages?: WorkPackage[]\n  label?: string\n}\n\n/** Supervisor handle adds fan-in helpers over the base contract. */\nexport interface SupervisorHandle extends AgentHandle {\n  /** Snapshot this session's child subtree (→ `session_tree`). */\n  subtree(): Promise<unknown>\n  /** Block until ANY child session ends a turn (→ `wait_for_any`). */\n  waitForAnyChild(opts?: { timeoutMs?: number }): Promise<TurnResult>\n}\n\nconst DEFAULTS = {\n  model: \"claude-opus-4-8\",\n  effort: \"high\",\n} as const\n\n/**\n * Build the `start_agent_session` args for the supervisor preset. Exported so\n * WP5's unit test can assert `orchestrator` + the rendered WP brief.\n */\nexport function buildSupervisorArgs(\n  opts: SupervisorHarnessOptions,\n): StartAgentArgs {\n  return {\n    adapter: \"claude-code\",\n    model: opts.model ?? DEFAULTS.model,\n    effort: opts.effort ?? DEFAULTS.effort,\n    orchestrator: opts.orchestrator ?? true,\n    ...(opts.workspace ? { cwd: opts.workspace } : {}),\n    ...(opts.workspaceSlug ? { workspaceSlug: opts.workspaceSlug } : {}),\n    ...(opts.workPackages?.length\n      ? { prompt: renderSupervisorPrompt(opts.workPackages!) }\n      : {}),\n    ...(opts.label ? { label: opts.label } : {}),\n  }\n}\n\n/** Create a supervisor session and return its (extended) handle. */\nexport async function createSupervisorHarness(\n  client: HarnessClient,\n  opts: SupervisorHarnessOptions = {},\n): Promise<SupervisorHandle> {\n  const args = buildSupervisorArgs(opts)\n  const desc = await client.start(args)\n  const base = makeHandle(client, {\n    sessionId: desc.id,\n    adapter: args.adapter,\n    ...(args.model ? { model: args.model } : {}),\n  })\n  return {\n    ...base,\n    async subtree(): Promise<unknown> {\n      return client.sessionTree(desc.id)\n    },\n    async waitForAnyChild(opts?: { timeoutMs?: number }): Promise<TurnResult> {\n      const data = (await client.sessionTree(desc.id)) as {\n        tree?: TreeNode[]\n      }\n      const childIds = collectChildIds(data.tree ?? [])\n      if (childIds.length === 0) {\n        return {\n          sessionId: desc.id,\n          event: \"timeout\",\n        }\n      }\n      // wait_for_any accepts max 20 session IDs — chunk & race\n      const CHUNK = 20\n      if (childIds.length <= CHUNK) {\n        return client.waitForAny(childIds, opts)\n      }\n      const chunks: string[][] = []\n      for (let i = 0; i < childIds.length; i += CHUNK) {\n        chunks.push(childIds.slice(i, i + CHUNK))\n      }\n      // NOTE: losing chunks are not cancellable — they poll until their own timeoutMs\n      // expires. This is a known limitation of the wait_for_any tool (no cancel API).\n      // Impact: at most (Math.ceil(n/20) - 1) extra open long-polls until timeout.\n      return Promise.race(chunks.map((chunk) => client.waitForAny(chunk, opts)))\n    },\n  }\n}\n\n/** Recursively collect all child session ids from a session_tree result. */\nfunction collectChildIds(nodes: readonly TreeNode[]): string[] {\n  const ids: string[] = []\n  for (const node of nodes) {\n    ids.push(node.id)\n    if (node.children?.length) {\n      ids.push(...collectChildIds(node.children as TreeNode[]))\n    }\n  }\n  return ids\n}\n\ninterface TreeNode {\n  id: string\n  children?: unknown[]\n}","/**\n * @agentproto/harness — public barrel.\n *\n * Typed, one-call agent-session presets over the agentproto daemon's session\n * tools. Connect once, then spin up `coder` / `researcher` / `supervisor`\n * sessions that all resolve to the uniform `AgentHandle` contract.\n *\n *   import { connectHarness, createCoderHarness } from \"@agentproto/harness\"\n *   const dx = await connectHarness()\n *   const coder = await createCoderHarness(dx, { workspace: process.cwd() })\n *   const reply = await coder.ask(\"Add a health-check route\")\n */\n\nimport { HarnessClient } from \"./client.js\"\nimport type { ConnectHarnessOptions } from \"./types.js\"\n\n/**\n * Connect the shared transport to the daemon's `/mcp` endpoint. Returns a\n * `HarnessClient` to hand to the `create*Harness` factories.\n */\nexport async function connectHarness(\n  opts?: ConnectHarnessOptions,\n): Promise<HarnessClient> {\n  return HarnessClient.connect(opts)\n}\n\nexport { HarnessClient, DEFAULT_MCP_URL, resolveMcpUrl } from \"./client.js\"\nexport { makeHandle } from \"./handle.js\"\n\nexport {\n  createCoderHarness,\n  buildCoderArgs,\n  renderCoderPrompt,\n  type CoderHarnessOptions,\n} from \"./harnesses/coder.js\"\nexport {\n  createResearcherHarness,\n  buildResearcherArgs,\n  renderResearcherPrompt,\n  DEFAULT_RESEARCH_SCHEMA,\n  type ResearcherHarnessOptions,\n} from \"./harnesses/researcher.js\"\nexport {\n  createSupervisorHarness,\n  buildSupervisorArgs,\n  renderSupervisorPrompt,\n  type SupervisorHarnessOptions,\n  type SupervisorHandle,\n} from \"./harnesses/supervisor.js\"\n\nexport type {\n  AgentHandle,\n  TurnResult,\n  TurnEvent,\n  McpServerMount,\n  OrchestratorOption,\n  StartAgentArgs,\n  SessionDescriptor,\n  ConnectHarnessOptions,\n  CoderContext,\n} from \"./types.js\"\nexport type { WorkPackage } from \"./wp.js\"\n"]}

package/dist/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @agentproto/harness — shared types.
+ *
+ * The harness wraps the daemon's session tools (`start_agent_session`,
+ * `prompt_agent_session`, `get_agent_session_output`, `kill_agent_session`,
+ * `wait_for_any`) exposed over the `/mcp` endpoint. These types describe the
+ * client-side contract; the wire shapes mirror the tool schemas in
+ * `@agentproto/runtime` (`session-tools.ts`, `orchestration-tools.ts`).
+ */
+/** Lifecycle event a turn can settle on. `timeout` is harness-side only. */
+type TurnEvent = "turn-end" | "awaiting-input" | "exited" | "any" | "timeout";
+/** Result of `AgentHandle.waitForTurn` / `wait_for_any`. */
+interface TurnResult {
+    sessionId: string;
+    event: TurnEvent;
+    status?: string;
+    awaitingInput?: boolean;
+}
+/**
+ * MCP-server mount forwarded verbatim to `start_agent_session.mcpServers`
+ * (→ `session/new.mcpServers` on the ACP arm).
+ */
+interface McpServerMount {
+    name: string;
+    transport: "stdio" | "http" | "sse";
+    ref?: string;
+    [k: string]: unknown;
+}
+/**
+ * Scoped-orchestrator request — forwarded to `start_agent_session.orchestrator`.
+ * `true` = the default curated subset; the object form narrows it.
+ */
+type OrchestratorOption = boolean | {
+    tools?: string[];
+    maxDepth?: number;
+    maxChildren?: number;
+};
+/**
+ * Args handed to `start_agent_session`. 1:1 with the tool schema
+ * (`session-tools.ts:241-374`).
+ */
+interface StartAgentArgs {
+    adapter: string;
+    cwd?: string;
+    workspaceSlug?: string;
+    prompt?: string;
+    label?: string;
+    model?: string;
+    effort?: string;
+    mcpServers?: McpServerMount[];
+    orchestrator?: OrchestratorOption;
+    notifyUrl?: string;
+}
+/** Session descriptor as returned by `start_agent_session` (subset). */
+interface SessionDescriptor {
+    id: string;
+    label?: string;
+    status: string;
+    adapterSlug?: string;
+    cwd?: string;
+    parentSessionId?: string;
+    depth?: number;
+    startedAt: string;
+}
+/** Connection options for the shared MCP transport. */
+interface ConnectHarnessOptions {
+    /** Daemon MCP endpoint. Default `http://127.0.0.1:18790/mcp`
+     *  (or `AGENTPROTO_MCP_URL`). */
+    url?: string;
+}
+/**
+ * The uniform contract every harness resolves to. A typed wrapper over a
+ * single live daemon session.
+ */
+interface AgentHandle {
+    readonly sessionId: string;
+    readonly adapter: string;
+    readonly model?: string;
+    /** Send a follow-up turn (fire-and-forget at the daemon). */
+    send(prompt: string): Promise<void>;
+    /** Block until this session ends its current turn (`wait_for_any`). */
+    waitForTurn(opts?: {
+        timeoutMs?: number;
+    }): Promise<TurnResult>;
+    /** Convenience: `send` + `waitForTurn` + return the new output tail. */
+    ask(prompt: string, opts?: {
+        timeoutMs?: number;
+    }): Promise<string>;
+    /** Tail the ring buffer (`get_agent_session_output`). */
+    output(opts?: {
+        lastN?: number;
+    }): Promise<string>;
+    /** SIGTERM the session (`kill_agent_session`). */
+    kill(): Promise<void>;
+}
+/** Coding context injected by the coder harness into its spawn prompt. */
+interface CoderContext {
+    /** Short stack description, e.g. "TypeScript monorepo, pnpm, tsup" */
+    stack?: string;
+    /** Coding conventions, e.g. "ESM-only, no default exports except React" */
+    conventions?: string;
+    /** Gate commands that must stay green before declaring done. */
+    gateCmds?: string[];
+    /** Extra context injected verbatim. */
+    extra?: string;
+}
+/** Alias for the spec-facing name. */
+type StartArgs = StartAgentArgs;
+
+export type { AgentHandle, CoderContext, ConnectHarnessOptions, McpServerMount, OrchestratorOption, SessionDescriptor, StartAgentArgs, StartArgs, TurnEvent, TurnResult };

package/dist/types.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.mjs.map
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.mjs"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@agentproto/harness",
+  "version": "0.1.0",
+  "description": "@agentproto/harness — typed, one-call agent-session presets (coder, researcher, supervisor) over the agentproto daemon's start/prompt/output session tools. A client-side recipe layer; adds no new daemon surface.",
+  "keywords": [
+    "agentproto",
+    "harness",
+    "agent",
+    "session",
+    "orchestration",
+    "mcp",
+    "preset"
+  ],
+  "homepage": "https://agentproto.sh",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/harness"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.mjs",
+      "default": "./dist/types.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": ">=1.0.0",
+    "zod": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "zod": "^4.4.3",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}