@tangle-network/agent-runtime 0.53.0 → 0.54.0

package/dist/mcp/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * @experimental\n *\n * `agent-runtime-mcp` — stdio MCP server entry point.\n *\n * Spins up a server with the default coder delegate (wired against the\n * real `@tangle-network/sandbox` client) and, when the optional\n * `@tangle-network/agent-knowledge` peer is installed, a researcher\n * delegate against `multiHarnessResearcherFanout`.\n *\n * Environment variables:\n *   TANGLE_API_KEY                   required — passed to `new Sandbox({ apiKey })`\n *   SANDBOX_BASE_URL                 optional — sandbox-SDK base URL override\n *   TANGLE_FLEET_ID                  optional — when set, delegations dispatch\n *                                    INTO this fleet's shared workspace instead\n *                                    of creating sibling sandboxes. Set by the\n *                                    parent sandbox when launching this MCP\n *                                    server so worker diffs land on the caller's\n *                                    filesystem with no cross-sandbox boundary.\n *   TANGLE_FLEET_EXCLUDE_MACHINES    optional — comma-separated machine ids to\n *                                    skip during fleet-mode round-robin\n *                                    (typically the coordinator machine this\n *                                    MCP server is running on).\n *   MCP_MAX_CONCURRENT_SANDBOXES     default 4 — kernel maxConcurrency cap\n *   MCP_CODER_FANOUT_HARNESSES       comma-separated harness ids to use for variants > 1\n *   MCP_DISABLE_CODER                set to `1` to omit `delegate_code`\n *   MCP_DISABLE_RESEARCHER           set to `1` to omit `delegate_research` even when peer is present\n *   AGENT_RUNTIME_DELEGATION_STATE_FILE\n *                                    optional — absolute path of a JSON state\n *                                    file. When set, delegation records persist\n *                                    across MCP restarts (FileDelegationStore):\n *                                    status/history survive and idempotency keys\n *                                    dedupe across processes. Single-variant\n *                                    coder/researcher delegations additionally\n *                                    dispatch DETACHED (driveTurn ticks against a\n *                                    deterministic session id) on session-backed\n *                                    placements, so restored in-flight records\n *                                    resume against their still-running sandbox\n *                                    sessions; non-detached in-flight records\n *                                    settle as failed with a truthful\n *                                    driver-restart error.\n *   AGENT_RUNTIME_DELEGATION_DETACHED\n *                                    set to `0` to keep every delegation on the\n *                                    streaming path even when the state file is\n *                                    configured (disables detached dispatch +\n *                                    resume).\n *   AGENT_RUNTIME_DELEGATION_STATE_RECOVER\n *                                    set to `1` to archive a corrupt state file\n *                                    (`<file>.corrupt-<ts>`) and start empty\n *                                    instead of refusing to boot.\n *   AGENT_RUNTIME_DELEGATION_RETAIN_TERMINAL\n *                                    optional — positive integer cap on retained\n *                                    terminal records. Unset = keep forever.\n */\n\nimport type { SandboxInstance } from '@tangle-network/sandbox'\nimport { coderProfile } from '../profiles/coder'\nimport type { AgentRunSpec, LoopTraceEmitter, SandboxClient } from '../runtime'\nimport { runLoop } from '../runtime'\nimport { detectExecutor } from './bin-helpers'\nimport {\n  coderTaskFromArgs,\n  createDefaultCoderDelegate,\n  type ResearcherDelegate,\n  settleDetachedCoderTurn,\n} from './delegates'\nimport { FileDelegationStore } from './delegation-store'\nimport { composeLoopTraceEmitters } from './delegation-trace'\nimport {\n  createDriveTurnResumeDriver,\n  type DetachedTurn,\n  type DriveTurnCapableBox,\n  detachedTurnEvents,\n  formatDetachedSessionRef,\n  parseDetachedSessionRef,\n  runDetachedTurn,\n} from './detached-turn'\nimport type { DelegationExecutor } from './executor'\nimport { createMcpServer } from './server'\nimport { type DelegationResumeDriver, DelegationTaskQueue } from './task-queue'\nimport {\n  createPropagatingTraceEmitter,\n  readTraceContextFromEnv,\n  type TraceContext,\n} from './trace-propagation'\nimport type { DelegateCodeArgs, DelegateResearchArgs, ResearchOutputShape } from './types'\n\nasync function main(): Promise<void> {\n  const fanoutHarnesses = parseHarnesses(process.env.MCP_CODER_FANOUT_HARNESSES)\n  const maxConcurrency = parseConcurrency(process.env.MCP_MAX_CONCURRENT_SANDBOXES)\n  const wantCoder = !process.env.MCP_DISABLE_CODER\n  const wantResearcher = !process.env.MCP_DISABLE_RESEARCHER\n  const fleetId = parseFleetId(process.env.TANGLE_FLEET_ID)\n\n  // Skip the sandbox client load entirely when no profile delegate needs it —\n  // the feedback + status + history tools are queue-bound and require no\n  // sandbox. Useful for tooling that mounts the MCP server purely for\n  // self-introspection.\n  const needsSandbox = wantCoder || wantResearcher\n  let sandboxClient: SandboxClient | undefined\n  let executor: DelegationExecutor | undefined\n  if (needsSandbox) {\n    const apiKey = process.env.TANGLE_API_KEY\n    if (!apiKey && !process.env.AGENT_RUNTIME_MCP_ALLOW_NO_KEY) {\n      process.stderr.write(\n        'agent-runtime-mcp: TANGLE_API_KEY is required. Set AGENT_RUNTIME_MCP_ALLOW_NO_KEY=1 to run without it for diagnostics, or MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to run the queue-only subset.\\n',\n      )\n      process.exit(2)\n    }\n    // Fleet mode against a diagnostic stub is meaningless — the stub can't\n    // resolve a real fleet handle. Refuse rather than silently degrading,\n    // otherwise a fleet-mounted MCP would behave differently than configured.\n    if (fleetId && !apiKey) {\n      process.stderr.write(\n        'agent-runtime-mcp: TANGLE_FLEET_ID was set but TANGLE_API_KEY is missing; cannot resolve fleet handle. Provide an api key or unset TANGLE_FLEET_ID.\\n',\n      )\n      process.exit(2)\n    }\n    sandboxClient = await loadSandboxClient(apiKey)\n    executor = await detectExecutor({ sandboxClient })\n    if (fleetId) {\n      process.stderr.write(`agent-runtime-mcp: fleet-aware delegation: fleetId=${fleetId}\\n`)\n    }\n    process.stderr.write(`agent-runtime-mcp: delegation placement → ${executor.describe()}\\n`)\n  }\n\n  // Export delegated-loop topology spans to the OTLP / Tangle Intelligence sink\n  // when OTEL_EXPORTER_OTLP_ENDPOINT is set (+ TRACE_ID / PARENT_SPAN_ID for\n  // correlation with the caller's trace). A cheap no-op when the endpoint is\n  // unset — the fleet forwards the env into this MCP's process to turn it on.\n  // The same context is stamped onto every delegation record (traceId /\n  // parentSpanId) so journal consumers join records into the caller's trace.\n  const traceContext = readTraceContextFromEnv()\n  const { emitter: traceEmitter, exporter: traceExporter } =\n    createPropagatingTraceEmitter(traceContext)\n  if (process.env.OTEL_EXPORTER_OTLP_ENDPOINT) {\n    process.stderr.write(\n      `agent-runtime-mcp: exporting loop topology → ${process.env.OTEL_EXPORTER_OTLP_ENDPOINT}\\n`,\n    )\n  }\n\n  const coderDelegate =\n    wantCoder && executor\n      ? createDefaultCoderDelegate({\n          executor,\n          fanoutHarnesses,\n          maxConcurrency,\n          traceEmitter,\n        })\n      : undefined\n\n  const researcherSupport =\n    wantResearcher && executor\n      ? await loadResearcherSupport(executor, maxConcurrency, traceEmitter)\n      : undefined\n\n  // Detached dispatch + resume turn on together with the durable store, and\n  // only for session-backed placements with real credentials: in-process\n  // placement has no sandbox session to detach, and the diagnostic no-key stub\n  // cannot resolve boxes. AGENT_RUNTIME_DELEGATION_DETACHED=0 keeps everything\n  // on the streaming path.\n  const detachedDispatch =\n    Boolean(process.env.AGENT_RUNTIME_DELEGATION_STATE_FILE?.trim()) &&\n    process.env.AGENT_RUNTIME_DELEGATION_DETACHED !== '0' &&\n    Boolean(process.env.TANGLE_API_KEY) &&\n    (executor?.placement === 'sibling' || executor?.placement === 'fleet')\n  if (detachedDispatch) {\n    process.stderr.write(\n      'agent-runtime-mcp: detached dispatch enabled — single-variant delegations resume across restarts\\n',\n    )\n  }\n  const resumeDriver =\n    detachedDispatch && sandboxClient\n      ? buildResumeDriver({ sandboxClient, researcherResume: researcherSupport?.resume })\n      : undefined\n\n  const durableQueue = await buildDurableQueueFromEnv(resumeDriver, traceContext)\n  const server = createMcpServer({\n    coderDelegate,\n    researcherDelegate: researcherSupport?.delegate,\n    detachedDispatch,\n    traceContext,\n    ...(durableQueue ? { queue: durableQueue } : {}),\n  })\n\n  const shutdown = () => {\n    server.stop()\n    const pending: Promise<unknown>[] = []\n    if (traceExporter) pending.push(traceExporter.shutdown())\n    // Drain journal writes so the state file reflects the final record\n    // states before the process exits. A persist failure already routed\n    // through onPersistError; swallow the duplicate rejection here.\n    if (durableQueue) pending.push(durableQueue.flush().catch(() => {}))\n    if (pending.length === 0) {\n      process.exit(0)\n      return\n    }\n    void Promise.allSettled(pending).finally(() => process.exit(0))\n  }\n  process.on('SIGINT', shutdown)\n  process.on('SIGTERM', shutdown)\n\n  await server.serve()\n}\n\nasync function buildDurableQueueFromEnv(\n  resumeDriver: DelegationResumeDriver | undefined,\n  traceContext: TraceContext,\n): Promise<DelegationTaskQueue | undefined> {\n  const stateFile = process.env.AGENT_RUNTIME_DELEGATION_STATE_FILE?.trim()\n  if (!stateFile) return undefined\n  const store = new FileDelegationStore({\n    filePath: stateFile,\n    recoverCorrupt: process.env.AGENT_RUNTIME_DELEGATION_STATE_RECOVER === '1',\n  })\n  const maxTerminalRecords = parseRetention(process.env.AGENT_RUNTIME_DELEGATION_RETAIN_TERMINAL)\n  // With a resume driver, restored in-flight records that carry a\n  // detachedSessionRef re-attach to their still-running sandbox sessions;\n  // without one (detached dispatch disabled / no credentials) they settle as\n  // failed with a truthful driver-restart error.\n  const queue = await DelegationTaskQueue.restore({\n    store,\n    traceContext,\n    ...(resumeDriver ? { resumeDelegate: resumeDriver } : {}),\n    ...(maxTerminalRecords !== undefined ? { maxTerminalRecords } : {}),\n    onPersistError: (error) => {\n      // Durable mode that can no longer write is a broken contract: crash\n      // loud instead of degrading to memory-only behind the caller's back.\n      process.stderr.write(`agent-runtime-mcp: ${error.message}\\n`)\n      process.exit(1)\n    },\n  })\n  process.stderr.write(`agent-runtime-mcp: durable delegation state → ${stateFile}\\n`)\n  return queue\n}\n\ninterface ResearcherResumeSupport {\n  message(args: DelegateResearchArgs): string\n  settle(\n    turn: DetachedTurn,\n    args: DelegateResearchArgs,\n    signal: AbortSignal,\n  ): Promise<ResearchOutputShape>\n}\n\n/**\n * Compose the `driveTurn`-backed resume driver over the real sandbox client.\n * Profile dispatch: coder records settle through the same parse + validate\n * gate the delegate applies; researcher records settle through the\n * agent-knowledge preset when the peer is installed. Profiles without resume\n * support (ui-auditor, researcher-without-peer) fail loud — the record settles\n * as failed with the reason instead of fabricating an output.\n */\nfunction buildResumeDriver(args: {\n  sandboxClient: SandboxClient\n  researcherResume: ResearcherResumeSupport | undefined\n}): DelegationResumeDriver {\n  const client = args.sandboxClient as SandboxClient & {\n    get?: (id: string) => Promise<SandboxInstance | null>\n  }\n  return createDriveTurnResumeDriver({\n    async resolveSandbox(sandboxId) {\n      if (typeof client.get !== 'function') {\n        throw new Error(\n          'agent-runtime-mcp: the sandbox client exposes no get(sandboxId); upgrade @tangle-network/sandbox to >= 0.6 to resume detached delegations',\n        )\n      }\n      const box = await client.get(sandboxId)\n      if (!box) {\n        throw new Error(\n          `agent-runtime-mcp: sandbox ${sandboxId} no longer exists — the detached run cannot be resumed`,\n        )\n      }\n      return box as unknown as DriveTurnCapableBox\n    },\n    buildMessage(record) {\n      if (record.profile === 'coder') {\n        const task = coderTaskFromArgs(record.args as DelegateCodeArgs)\n        return coderProfile({ task }).taskToPrompt(task)\n      }\n      if (record.profile === 'researcher' && args.researcherResume) {\n        return args.researcherResume.message(record.args as DelegateResearchArgs)\n      }\n      throw new Error(\n        `agent-runtime-mcp: no detached resume support for profile \"${record.profile}\"`,\n      )\n    },\n    async settleOutput(turn, record, ctx) {\n      if (record.profile === 'coder') {\n        if (!record.detachedSessionRef) {\n          throw new Error(\n            `agent-runtime-mcp: record ${record.taskId} reached the resume settle without a detachedSessionRef`,\n          )\n        }\n        return settleDetachedCoderTurn(turn, {\n          task: coderTaskFromArgs(record.args as DelegateCodeArgs),\n          sessionId: parseDetachedSessionRef(record.detachedSessionRef).sessionId,\n          signal: ctx.signal,\n        })\n      }\n      if (record.profile === 'researcher' && args.researcherResume) {\n        return args.researcherResume.settle(turn, record.args as DelegateResearchArgs, ctx.signal)\n      }\n      throw new Error(\n        `agent-runtime-mcp: no detached resume support for profile \"${record.profile}\"`,\n      )\n    },\n  })\n}\n\nfunction parseRetention(raw: string | undefined): number | undefined {\n  if (raw === undefined || raw.trim() === '') return undefined\n  const n = Number(raw)\n  if (!Number.isInteger(n) || n < 1) {\n    process.stderr.write(\n      `agent-runtime-mcp: AGENT_RUNTIME_DELEGATION_RETAIN_TERMINAL must be a positive integer, got \"${raw}\"\\n`,\n    )\n    process.exit(2)\n  }\n  return n\n}\n\nasync function loadSandboxClient(apiKey: string | undefined): Promise<SandboxClient> {\n  // Diagnostic mode: AGENT_RUNTIME_MCP_ALLOW_NO_KEY=1 enables tools/list + the\n  // queue-bound tools (status / history / feedback) without sandbox creds.\n  // Coder + researcher delegations require a real client; the stub fails loud\n  // at create() so the agent observes the cause instead of silent success.\n  if (!apiKey) {\n    return {\n      async create() {\n        throw new Error(\n          'agent-runtime-mcp: TANGLE_API_KEY is unset; coder/researcher delegations are disabled in diagnostic mode. Set TANGLE_API_KEY or use MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to remove the unsupported tools from the tool list.',\n        )\n      },\n    } satisfies SandboxClient\n  }\n  // Dynamic import keeps the bin importable in environments that haven't\n  // installed `@tangle-network/sandbox` yet (the runtime package lists it\n  // as a peer dep, not a hard dep).\n  const mod = await import('@tangle-network/sandbox').catch((err) => {\n    process.stderr.write(\n      `agent-runtime-mcp: failed to load @tangle-network/sandbox (${err.message}); install the peer dependency\\n`,\n    )\n    process.exit(2)\n  })\n  const SandboxCtor = (mod as { Sandbox?: new (config: unknown) => SandboxClient }).Sandbox\n  if (!SandboxCtor) {\n    process.stderr.write(\n      'agent-runtime-mcp: @tangle-network/sandbox does not export Sandbox; cannot construct client\\n',\n    )\n    process.exit(2)\n  }\n  const baseUrl = process.env.SANDBOX_BASE_URL\n  return new SandboxCtor({\n    apiKey,\n    ...(baseUrl ? { baseUrl } : {}),\n  })\n}\n\ninterface ResearcherProfilePreset {\n  agentRunSpec: Parameters<typeof runLoop>[0]['agentRun'] extends infer T ? NonNullable<T> : never\n  output: Parameters<typeof runLoop>[0]['output']\n  validator: Parameters<typeof runLoop>[0]['validator']\n}\n\ninterface ResearcherFanoutPreset {\n  agentRuns: NonNullable<Parameters<typeof runLoop>[0]['agentRuns']>\n  output: Parameters<typeof runLoop>[0]['output']\n  validator: Parameters<typeof runLoop>[0]['validator']\n  driver: Parameters<typeof runLoop>[0]['driver']\n}\n\ninterface ResearcherSupport {\n  delegate: ResearcherDelegate\n  resume: ResearcherResumeSupport\n}\n\nasync function loadResearcherSupport(\n  executor: DelegationExecutor,\n  maxConcurrency: number,\n  traceEmitter?: LoopTraceEmitter,\n): Promise<ResearcherSupport | undefined> {\n  const sandboxClient = executor.client\n  // Optional peer — when `@tangle-network/agent-knowledge` isn't installed,\n  // we silently omit the researcher tool from the advertisement. The\n  // dynamic-import path is resolved at runtime; TypeScript cannot see the\n  // peer, so we type the module structurally rather than via its own\n  // declaration file.\n  const profilesSpecifier = '@tangle-network/agent-knowledge/profiles'\n  const mod = await import(profilesSpecifier).catch(() => undefined)\n  if (!mod) return undefined\n  type SingleFactory = (opts: { task: unknown }) => ResearcherProfilePreset\n  type FanoutFactory = (opts: { task: unknown }) => ResearcherFanoutPreset\n  const fanoutFactory = (mod as { multiHarnessResearcherFanout?: FanoutFactory })\n    .multiHarnessResearcherFanout\n  const singleFactory = (mod as { researcherProfile?: SingleFactory }).researcherProfile\n  if (!fanoutFactory || !singleFactory) return undefined\n\n  const settleSingle = async (\n    turn: DetachedTurn,\n    args: DelegateResearchArgs,\n    sessionId: string,\n    signal: AbortSignal,\n  ): Promise<ResearchOutputShape> => {\n    const task = buildResearchTask(args)\n    const preset = singleFactory({ task })\n    if (!preset.validator) {\n      throw new Error('agent-runtime-mcp: researcher preset exposes no validator; cannot settle')\n    }\n    const parsed = preset.output.parse(detachedTurnEvents(sessionId, turn))\n    const verdict = await preset.validator.validate(parsed, { iteration: 0, signal })\n    if ((verdict as { valid?: boolean }).valid !== true) {\n      throw new Error('researcher delegate produced no winner')\n    }\n    return parsed as ResearchOutputShape\n  }\n\n  const delegate: ResearcherDelegate = async (args, ctx) => {\n    const task = buildResearchTask(args)\n    const variants = Math.max(1, Math.trunc(args.variants ?? 1))\n    const loopEmitter = composeLoopTraceEmitters(traceEmitter, ctx.traceEmitter)\n    ctx.report({ iteration: 0, phase: 'starting' })\n    if (variants <= 1) {\n      const preset = singleFactory({ task })\n      // Detached dispatch — same contract as the coder delegate: one session\n      // on one box, driveTurn ticks, resume key bound to the sandbox id.\n      if (ctx.detachedSessionRef !== undefined && ctx.updateDetachedSessionRef) {\n        const { sessionId } = parseDetachedSessionRef(ctx.detachedSessionRef)\n        const rebind = ctx.updateDetachedSessionRef\n        const spec = preset.agentRunSpec as AgentRunSpec<unknown>\n        const turn = await runDetachedTurn({\n          client: sandboxClient,\n          spec,\n          prompt: spec.taskToPrompt(task),\n          sessionId,\n          bindSandbox: (sandboxId) => rebind(formatDetachedSessionRef({ sandboxId, sessionId })),\n          signal: ctx.signal,\n          report: ctx.report,\n          ...(loopEmitter ? { traceEmitter: loopEmitter } : {}),\n          ...(executor.placement === 'fleet' ? { placement: 'fleet' as const } : {}),\n        })\n        const output = await settleSingle(turn, args, sessionId, ctx.signal)\n        ctx.report({ iteration: 1, phase: 'completed' })\n        return output\n      }\n      const result = await runLoop({\n        driver: {\n          name: 'mcp-researcher-single',\n          async plan(t, history) {\n            return history.length === 0 ? [t] : []\n          },\n          decide(history) {\n            return history.length > 0 ? 'pick-winner' : 'fail'\n          },\n        },\n        agentRun: preset.agentRunSpec,\n        output: preset.output,\n        validator: preset.validator,\n        task,\n        ctx: {\n          sandboxClient,\n          signal: ctx.signal,\n          ...(loopEmitter ? { traceEmitter: loopEmitter } : {}),\n        },\n        maxIterations: 1,\n        maxConcurrency,\n      })\n      const output = result.winner?.output\n      if (!output) throw new Error('researcher delegate produced no winner')\n      ctx.report({ iteration: 1, phase: 'completed' })\n      return output as ResearchOutputShape\n    }\n    const fanout = fanoutFactory({ task })\n    const result = await runLoop({\n      driver: fanout.driver,\n      agentRuns: fanout.agentRuns.slice(0, variants),\n      output: fanout.output,\n      validator: fanout.validator,\n      task,\n      ctx: {\n        sandboxClient,\n        signal: ctx.signal,\n        ...(loopEmitter ? { traceEmitter: loopEmitter } : {}),\n      },\n      maxIterations: variants,\n      maxConcurrency: Math.min(maxConcurrency, variants),\n    })\n    const output = result.winner?.output\n    if (!output) throw new Error('researcher delegate fanout produced no winner')\n    ctx.report({ iteration: result.iterations.length, phase: 'completed' })\n    return output as ResearchOutputShape\n  }\n\n  return {\n    delegate,\n    resume: {\n      message(args) {\n        const task = buildResearchTask(args)\n        const spec = singleFactory({ task }).agentRunSpec as AgentRunSpec<unknown>\n        return spec.taskToPrompt(task)\n      },\n      async settle(turn, args, signal) {\n        // The session id is only the synthesized event's id — the parser reads\n        // data.result / data.text, never the id.\n        return settleSingle(turn, args, 'resumed-detached-turn', signal)\n      },\n    },\n  }\n}\n\nfunction buildResearchTask(args: DelegateResearchArgs): unknown {\n  return {\n    question: args.question,\n    knowledgeNamespace: args.namespace,\n    scope: args.scope,\n    sources: args.sources,\n    recencyWindow: args.config?.recencyWindow\n      ? {\n          since: args.config.recencyWindow.since\n            ? new Date(args.config.recencyWindow.since)\n            : undefined,\n          until: args.config.recencyWindow.until\n            ? new Date(args.config.recencyWindow.until)\n            : undefined,\n        }\n      : undefined,\n    maxItems: args.config?.maxItems,\n    minConfidence: args.config?.minConfidence,\n  }\n}\n\nfunction parseHarnesses(raw: string | undefined): string[] | undefined {\n  if (!raw) return undefined\n  const list = raw\n    .split(',')\n    .map((entry) => entry.trim())\n    .filter(Boolean)\n  return list.length > 0 ? list : undefined\n}\n\nfunction parseFleetId(raw: string | undefined): string | undefined {\n  if (typeof raw !== 'string') return undefined\n  const trimmed = raw.trim()\n  return trimmed.length > 0 ? trimmed : undefined\n}\n\nfunction parseConcurrency(raw: string | undefined): number {\n  if (!raw) return 4\n  const n = Number(raw)\n  if (!Number.isFinite(n) || n < 1) return 4\n  return Math.min(Math.trunc(n), 32)\n}\n\nmain().catch((err) => {\n  process.stderr.write(`agent-runtime-mcp: ${err instanceof Error ? err.stack : String(err)}\\n`)\n  process.exit(1)\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFA,eAAe,OAAsB;AACnC,QAAM,kBAAkB,eAAe,QAAQ,IAAI,0BAA0B;AAC7E,QAAM,iBAAiB,iBAAiB,QAAQ,IAAI,4BAA4B;AAChF,QAAM,YAAY,CAAC,QAAQ,IAAI;AAC/B,QAAM,iBAAiB,CAAC,QAAQ,IAAI;AACpC,QAAM,UAAU,aAAa,QAAQ,IAAI,eAAe;AAMxD,QAAM,eAAe,aAAa;AAClC,MAAI;AACJ,MAAI;AACJ,MAAI,cAAc;AAChB,UAAM,SAAS,QAAQ,IAAI;AAC3B,QAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,gCAAgC;AAC1D,cAAQ,OAAO;AAAA,QACb;AAAA,MACF;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB;AAIA,QAAI,WAAW,CAAC,QAAQ;AACtB,cAAQ,OAAO;AAAA,QACb;AAAA,MACF;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,oBAAgB,MAAM,kBAAkB,MAAM;AAC9C,eAAW,MAAM,eAAe,EAAE,cAAc,CAAC;AACjD,QAAI,SAAS;AACX,cAAQ,OAAO,MAAM,sDAAsD,OAAO;AAAA,CAAI;AAAA,IACxF;AACA,YAAQ,OAAO,MAAM,kDAA6C,SAAS,SAAS,CAAC;AAAA,CAAI;AAAA,EAC3F;AAQA,QAAM,eAAe,wBAAwB;AAC7C,QAAM,EAAE,SAAS,cAAc,UAAU,cAAc,IACrD,8BAA8B,YAAY;AAC5C,MAAI,QAAQ,IAAI,6BAA6B;AAC3C,YAAQ,OAAO;AAAA,MACb,qDAAgD,QAAQ,IAAI,2BAA2B;AAAA;AAAA,IACzF;AAAA,EACF;AAEA,QAAM,gBACJ,aAAa,WACT,2BAA2B;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,IACD;AAEN,QAAM,oBACJ,kBAAkB,WACd,MAAM,sBAAsB,UAAU,gBAAgB,YAAY,IAClE;AAON,QAAM,mBACJ,QAAQ,QAAQ,IAAI,qCAAqC,KAAK,CAAC,KAC/D,QAAQ,IAAI,sCAAsC,OAClD,QAAQ,QAAQ,IAAI,cAAc,MACjC,UAAU,cAAc,aAAa,UAAU,cAAc;AAChE,MAAI,kBAAkB;AACpB,YAAQ,OAAO;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACA,QAAM,eACJ,oBAAoB,gBAChB,kBAAkB,EAAE,eAAe,kBAAkB,mBAAmB,OAAO,CAAC,IAChF;AAEN,QAAM,eAAe,MAAM,yBAAyB,cAAc,YAAY;AAC9E,QAAM,SAAS,gBAAgB;AAAA,IAC7B;AAAA,IACA,oBAAoB,mBAAmB;AAAA,IACvC;AAAA,IACA;AAAA,IACA,GAAI,eAAe,EAAE,OAAO,aAAa,IAAI,CAAC;AAAA,EAChD,CAAC;AAED,QAAM,WAAW,MAAM;AACrB,WAAO,KAAK;AACZ,UAAM,UAA8B,CAAC;AACrC,QAAI,cAAe,SAAQ,KAAK,cAAc,SAAS,CAAC;AAIxD,QAAI,aAAc,SAAQ,KAAK,aAAa,MAAM,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC,CAAC;AACnE,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,KAAK,CAAC;AACd;AAAA,IACF;AACA,SAAK,QAAQ,WAAW,OAAO,EAAE,QAAQ,MAAM,QAAQ,KAAK,CAAC,CAAC;AAAA,EAChE;AACA,UAAQ,GAAG,UAAU,QAAQ;AAC7B,UAAQ,GAAG,WAAW,QAAQ;AAE9B,QAAM,OAAO,MAAM;AACrB;AAEA,eAAe,yBACb,cACA,cAC0C;AAC1C,QAAM,YAAY,QAAQ,IAAI,qCAAqC,KAAK;AACxE,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,QAAQ,IAAI,oBAAoB;AAAA,IACpC,UAAU;AAAA,IACV,gBAAgB,QAAQ,IAAI,2CAA2C;AAAA,EACzE,CAAC;AACD,QAAM,qBAAqB,eAAe,QAAQ,IAAI,wCAAwC;AAK9F,QAAM,QAAQ,MAAM,oBAAoB,QAAQ;AAAA,IAC9C;AAAA,IACA;AAAA,IACA,GAAI,eAAe,EAAE,gBAAgB,aAAa,IAAI,CAAC;AAAA,IACvD,GAAI,uBAAuB,SAAY,EAAE,mBAAmB,IAAI,CAAC;AAAA,IACjE,gBAAgB,CAAC,UAAU;AAGzB,cAAQ,OAAO,MAAM,sBAAsB,MAAM,OAAO;AAAA,CAAI;AAC5D,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AACD,UAAQ,OAAO,MAAM,sDAAiD,SAAS;AAAA,CAAI;AACnF,SAAO;AACT;AAmBA,SAAS,kBAAkB,MAGA;AACzB,QAAM,SAAS,KAAK;AAGpB,SAAO,4BAA4B;AAAA,IACjC,MAAM,eAAe,WAAW;AAC9B,UAAI,OAAO,OAAO,QAAQ,YAAY;AACpC,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,YAAM,MAAM,MAAM,OAAO,IAAI,SAAS;AACtC,UAAI,CAAC,KAAK;AACR,cAAM,IAAI;AAAA,UACR,8BAA8B,SAAS;AAAA,QACzC;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,IACA,aAAa,QAAQ;AACnB,UAAI,OAAO,YAAY,SAAS;AAC9B,cAAM,OAAO,kBAAkB,OAAO,IAAwB;AAC9D,eAAO,aAAa,EAAE,KAAK,CAAC,EAAE,aAAa,IAAI;AAAA,MACjD;AACA,UAAI,OAAO,YAAY,gBAAgB,KAAK,kBAAkB;AAC5D,eAAO,KAAK,iBAAiB,QAAQ,OAAO,IAA4B;AAAA,MAC1E;AACA,YAAM,IAAI;AAAA,QACR,8DAA8D,OAAO,OAAO;AAAA,MAC9E;AAAA,IACF;AAAA,IACA,MAAM,aAAa,MAAM,QAAQ,KAAK;AACpC,UAAI,OAAO,YAAY,SAAS;AAC9B,YAAI,CAAC,OAAO,oBAAoB;AAC9B,gBAAM,IAAI;AAAA,YACR,6BAA6B,OAAO,MAAM;AAAA,UAC5C;AAAA,QACF;AACA,eAAO,wBAAwB,MAAM;AAAA,UACnC,MAAM,kBAAkB,OAAO,IAAwB;AAAA,UACvD,WAAW,wBAAwB,OAAO,kBAAkB,EAAE;AAAA,UAC9D,QAAQ,IAAI;AAAA,QACd,CAAC;AAAA,MACH;AACA,UAAI,OAAO,YAAY,gBAAgB,KAAK,kBAAkB;AAC5D,eAAO,KAAK,iBAAiB,OAAO,MAAM,OAAO,MAA8B,IAAI,MAAM;AAAA,MAC3F;AACA,YAAM,IAAI;AAAA,QACR,8DAA8D,OAAO,OAAO;AAAA,MAC9E;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,SAAS,eAAe,KAA6C;AACnE,MAAI,QAAQ,UAAa,IAAI,KAAK,MAAM,GAAI,QAAO;AACnD,QAAM,IAAI,OAAO,GAAG;AACpB,MAAI,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,GAAG;AACjC,YAAQ,OAAO;AAAA,MACb,gGAAgG,GAAG;AAAA;AAAA,IACrG;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,SAAO;AACT;AAEA,eAAe,kBAAkB,QAAoD;AAKnF,MAAI,CAAC,QAAQ;AACX,WAAO;AAAA,MACL,MAAM,SAAS;AACb,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAIA,QAAM,MAAM,MAAM,OAAO,yBAAyB,EAAE,MAAM,CAAC,QAAQ;AACjE,YAAQ,OAAO;AAAA,MACb,8DAA8D,IAAI,OAAO;AAAA;AAAA,IAC3E;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AACD,QAAM,cAAe,IAA6D;AAClF,MAAI,CAAC,aAAa;AAChB,YAAQ,OAAO;AAAA,MACb;AAAA,IACF;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,QAAM,UAAU,QAAQ,IAAI;AAC5B,SAAO,IAAI,YAAY;AAAA,IACrB;AAAA,IACA,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B,CAAC;AACH;AAoBA,eAAe,sBACb,UACA,gBACA,cACwC;AACxC,QAAM,gBAAgB,SAAS;AAM/B,QAAM,oBAAoB;AAC1B,QAAM,MAAM,MAAM,OAAO,mBAAmB,MAAM,MAAM,MAAS;AACjE,MAAI,CAAC,IAAK,QAAO;AAGjB,QAAM,gBAAiB,IACpB;AACH,QAAM,gBAAiB,IAA8C;AACrE,MAAI,CAAC,iBAAiB,CAAC,cAAe,QAAO;AAE7C,QAAM,eAAe,OACnB,MACA,MACA,WACA,WACiC;AACjC,UAAM,OAAO,kBAAkB,IAAI;AACnC,UAAM,SAAS,cAAc,EAAE,KAAK,CAAC;AACrC,QAAI,CAAC,OAAO,WAAW;AACrB,YAAM,IAAI,MAAM,0EAA0E;AAAA,IAC5F;AACA,UAAM,SAAS,OAAO,OAAO,MAAM,mBAAmB,WAAW,IAAI,CAAC;AACtE,UAAM,UAAU,MAAM,OAAO,UAAU,SAAS,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC;AAChF,QAAK,QAAgC,UAAU,MAAM;AACnD,YAAM,IAAI,MAAM,wCAAwC;AAAA,IAC1D;AACA,WAAO;AAAA,EACT;AAEA,QAAM,WAA+B,OAAO,MAAM,QAAQ;AACxD,UAAM,OAAO,kBAAkB,IAAI;AACnC,UAAM,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,YAAY,CAAC,CAAC;AAC3D,UAAM,cAAc,yBAAyB,cAAc,IAAI,YAAY;AAC3E,QAAI,OAAO,EAAE,WAAW,GAAG,OAAO,WAAW,CAAC;AAC9C,QAAI,YAAY,GAAG;AACjB,YAAM,SAAS,cAAc,EAAE,KAAK,CAAC;AAGrC,UAAI,IAAI,uBAAuB,UAAa,IAAI,0BAA0B;AACxE,cAAM,EAAE,UAAU,IAAI,wBAAwB,IAAI,kBAAkB;AACpE,cAAM,SAAS,IAAI;AACnB,cAAM,OAAO,OAAO;AACpB,cAAM,OAAO,MAAM,gBAAgB;AAAA,UACjC,QAAQ;AAAA,UACR;AAAA,UACA,QAAQ,KAAK,aAAa,IAAI;AAAA,UAC9B;AAAA,UACA,aAAa,CAAC,cAAc,OAAO,yBAAyB,EAAE,WAAW,UAAU,CAAC,CAAC;AAAA,UACrF,QAAQ,IAAI;AAAA,UACZ,QAAQ,IAAI;AAAA,UACZ,GAAI,cAAc,EAAE,cAAc,YAAY,IAAI,CAAC;AAAA,UACnD,GAAI,SAAS,cAAc,UAAU,EAAE,WAAW,QAAiB,IAAI,CAAC;AAAA,QAC1E,CAAC;AACD,cAAMA,UAAS,MAAM,aAAa,MAAM,MAAM,WAAW,IAAI,MAAM;AACnE,YAAI,OAAO,EAAE,WAAW,GAAG,OAAO,YAAY,CAAC;AAC/C,eAAOA;AAAA,MACT;AACA,YAAMC,UAAS,MAAM,QAAQ;AAAA,QAC3B,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,MAAM,KAAK,GAAG,SAAS;AACrB,mBAAO,QAAQ,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC;AAAA,UACvC;AAAA,UACA,OAAO,SAAS;AACd,mBAAO,QAAQ,SAAS,IAAI,gBAAgB;AAAA,UAC9C;AAAA,QACF;AAAA,QACA,UAAU,OAAO;AAAA,QACjB,QAAQ,OAAO;AAAA,QACf,WAAW,OAAO;AAAA,QAClB;AAAA,QACA,KAAK;AAAA,UACH;AAAA,UACA,QAAQ,IAAI;AAAA,UACZ,GAAI,cAAc,EAAE,cAAc,YAAY,IAAI,CAAC;AAAA,QACrD;AAAA,QACA,eAAe;AAAA,QACf;AAAA,MACF,CAAC;AACD,YAAMD,UAASC,QAAO,QAAQ;AAC9B,UAAI,CAACD,QAAQ,OAAM,IAAI,MAAM,wCAAwC;AACrE,UAAI,OAAO,EAAE,WAAW,GAAG,OAAO,YAAY,CAAC;AAC/C,aAAOA;AAAA,IACT;AACA,UAAM,SAAS,cAAc,EAAE,KAAK,CAAC;AACrC,UAAM,SAAS,MAAM,QAAQ;AAAA,MAC3B,QAAQ,OAAO;AAAA,MACf,WAAW,OAAO,UAAU,MAAM,GAAG,QAAQ;AAAA,MAC7C,QAAQ,OAAO;AAAA,MACf,WAAW,OAAO;AAAA,MAClB;AAAA,MACA,KAAK;AAAA,QACH;AAAA,QACA,QAAQ,IAAI;AAAA,QACZ,GAAI,cAAc,EAAE,cAAc,YAAY,IAAI,CAAC;AAAA,MACrD;AAAA,MACA,eAAe;AAAA,MACf,gBAAgB,KAAK,IAAI,gBAAgB,QAAQ;AAAA,IACnD,CAAC;AACD,UAAM,SAAS,OAAO,QAAQ;AAC9B,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,+CAA+C;AAC5E,QAAI,OAAO,EAAE,WAAW,OAAO,WAAW,QAAQ,OAAO,YAAY,CAAC;AACtE,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,MACN,QAAQ,MAAM;AACZ,cAAM,OAAO,kBAAkB,IAAI;AACnC,cAAM,OAAO,cAAc,EAAE,KAAK,CAAC,EAAE;AACrC,eAAO,KAAK,aAAa,IAAI;AAAA,MAC/B;AAAA,MACA,MAAM,OAAO,MAAM,MAAM,QAAQ;AAG/B,eAAO,aAAa,MAAM,MAAM,yBAAyB,MAAM;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,kBAAkB,MAAqC;AAC9D,SAAO;AAAA,IACL,UAAU,KAAK;AAAA,IACf,oBAAoB,KAAK;AAAA,IACzB,OAAO,KAAK;AAAA,IACZ,SAAS,KAAK;AAAA,IACd,eAAe,KAAK,QAAQ,gBACxB;AAAA,MACE,OAAO,KAAK,OAAO,cAAc,QAC7B,IAAI,KAAK,KAAK,OAAO,cAAc,KAAK,IACxC;AAAA,MACJ,OAAO,KAAK,OAAO,cAAc,QAC7B,IAAI,KAAK,KAAK,OAAO,cAAc,KAAK,IACxC;AAAA,IACN,IACA;AAAA,IACJ,UAAU,KAAK,QAAQ;AAAA,IACvB,eAAe,KAAK,QAAQ;AAAA,EAC9B;AACF;AAEA,SAAS,eAAe,KAA+C;AACrE,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,OAAO,IACV,MAAM,GAAG,EACT,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;AACjB,SAAO,KAAK,SAAS,IAAI,OAAO;AAClC;AAEA,SAAS,aAAa,KAA6C;AACjE,MAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,QAAM,UAAU,IAAI,KAAK;AACzB,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEA,SAAS,iBAAiB,KAAiC;AACzD,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,IAAI,OAAO,GAAG;AACpB,MAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,EAAG,QAAO;AACzC,SAAO,KAAK,IAAI,KAAK,MAAM,CAAC,GAAG,EAAE;AACnC;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,OAAO,MAAM,sBAAsB,eAAe,QAAQ,IAAI,QAAQ,OAAO,GAAG,CAAC;AAAA,CAAI;AAC7F,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":["output","result"]}
+{"version":3,"sources":["../../src/mcp/researcher-provisioning.ts","../../src/mcp/bin.ts"],"sourcesContent":["/**\n * Researcher delegate provisioning — resolves the worker harness, model, and router\n * credentials for `delegate_research`, and injects the OpenAI-compatible router creds\n * into a sandbox agent-run spec.\n *\n * Why this exists: the agent-knowledge researcher profile defaults to a harness\n * (`opencode/zai-coding-plan/glm-5.1`) that isn't broadly provisionable, and the sandbox\n * SDK does not wire `backend.model.apiKey` into the in-box agent's OpenAI-compatible\n * provider. So the MCP server picks a provisionable harness + model and passes the router\n * creds as box env. Everything is env-overridable and reuses the repo's router resolution.\n */\nimport { type RouterEnv, resolveRouterBaseUrl } from '../model-resolution.js'\n\nexport interface ResearcherProvisioning {\n  harness: string\n  /** Worker model id (router-served). */\n  model: string\n  /** OpenAI-compatible router key for the in-box provider; undefined disables injection. */\n  routerKey?: string\n  /** OpenAI-compatible router base, always ending in a `/vN` segment. */\n  routerBaseUrl: string\n  /** Explicit fanout harness list (MCP_RESEARCHER_FANOUT_HARNESSES); undefined ⇒ caller defaults. */\n  fanoutHarnesses?: string[]\n  /** Per-harness fanout model overrides (MCP_RESEARCHER_FANOUT_MODELS), index-aligned. */\n  fanoutModels?: string[]\n}\n\n/** A sandbox agent-run spec whose box env can be overridden. */\nexport interface ProvisionableSpec {\n  sandboxOverrides?: { env?: Record<string, string> } & Record<string, unknown>\n}\n\nconst DEFAULT_HARNESS = 'opencode'\nconst DEFAULT_MODEL = 'moonshotai/kimi-k2.6'\n\nfunction trimmed(value: string | undefined): string | undefined {\n  const t = value?.trim()\n  return t ? t : undefined\n}\n\nfunction csv(value: string | undefined): string[] | undefined {\n  const list = value\n    ?.split(',')\n    .map((v) => v.trim())\n    .filter(Boolean)\n  return list && list.length > 0 ? list : undefined\n}\n\n/**\n * Resolve harness/model/router from env. Model falls back through the repo's\n * `WORKER_MODEL` convention; router base reuses `resolveRouterBaseUrl` (TANGLE_ROUTER_URL\n * / TANGLE_ROUTER_BASE_URL) and is normalized to an OpenAI-compatible `/v1` endpoint.\n */\nexport function resolveResearcherProvisioning(\n  env: NodeJS.ProcessEnv = process.env,\n): ResearcherProvisioning {\n  const harness = trimmed(env.MCP_RESEARCHER_HARNESS) ?? DEFAULT_HARNESS\n  const model =\n    trimmed(env.MCP_RESEARCHER_MODEL) ??\n    trimmed(env.MCP_WORKER_MODEL) ??\n    trimmed(env.WORKER_MODEL) ??\n    DEFAULT_MODEL\n  const routerKey = trimmed(env.MCP_RESEARCHER_ROUTER_KEY) ?? trimmed(env.TANGLE_API_KEY)\n  const base = trimmed(env.MCP_RESEARCHER_ROUTER_BASE_URL) ?? resolveRouterBaseUrl(env as RouterEnv)\n  const routerBaseUrl = /\\/v\\d+\\/?$/.test(base)\n    ? base.replace(/\\/$/, '')\n    : `${base.replace(/\\/$/, '')}/v1`\n  const fanoutHarnesses = csv(env.MCP_RESEARCHER_FANOUT_HARNESSES)\n  const fanoutModels = csv(env.MCP_RESEARCHER_FANOUT_MODELS)\n  return {\n    harness,\n    model,\n    ...(routerKey ? { routerKey } : {}),\n    routerBaseUrl,\n    ...(fanoutHarnesses ? { fanoutHarnesses } : {}),\n    ...(fanoutModels ? { fanoutModels } : {}),\n  }\n}\n\n/**\n * Overlay the router creds onto a spec's box env (in place): preserve every env var the\n * preset already supplied and set OPENAI_API_KEY / OPENAI_BASE_URL on top (these two are\n * intentionally authoritative — they point the in-box provider at the router). No-op when\n * there is no router key.\n */\nexport function applyRouterEnv(\n  spec: ProvisionableSpec,\n  routerKey: string | undefined,\n  routerBaseUrl: string,\n): void {\n  if (!routerKey) return\n  spec.sandboxOverrides = {\n    ...(spec.sandboxOverrides ?? {}),\n    env: {\n      ...(spec.sandboxOverrides?.env ?? {}),\n      OPENAI_API_KEY: routerKey,\n      OPENAI_BASE_URL: routerBaseUrl,\n    },\n  }\n}\n","#!/usr/bin/env node\n\n/**\n * @experimental\n *\n * `agent-runtime-mcp` — stdio MCP server entry point.\n *\n * Spins up a server with the default coder delegate (wired against the\n * real `@tangle-network/sandbox` client) and, when the optional\n * `@tangle-network/agent-knowledge` peer is installed, a researcher\n * delegate against `multiHarnessResearcherFanout`.\n *\n * Environment variables:\n *   TANGLE_API_KEY                   required — passed to `new Sandbox({ apiKey })`\n *   SANDBOX_BASE_URL                 optional — sandbox-SDK base URL override\n *   TANGLE_FLEET_ID                  optional — when set, delegations dispatch\n *                                    INTO this fleet's shared workspace instead\n *                                    of creating sibling sandboxes. Set by the\n *                                    parent sandbox when launching this MCP\n *                                    server so worker diffs land on the caller's\n *                                    filesystem with no cross-sandbox boundary.\n *   TANGLE_FLEET_EXCLUDE_MACHINES    optional — comma-separated machine ids to\n *                                    skip during fleet-mode round-robin\n *                                    (typically the coordinator machine this\n *                                    MCP server is running on).\n *   MCP_MAX_CONCURRENT_SANDBOXES     default 4 — kernel maxConcurrency cap\n *   MCP_CODER_FANOUT_HARNESSES       comma-separated harness ids to use for variants > 1\n *   MCP_DISABLE_CODER                set to `1` to omit `delegate_code`\n *   MCP_DISABLE_RESEARCHER           set to `1` to omit `delegate_research` even when peer is present\n *   MCP_RESEARCHER_HARNESS           researcher worker harness (default `opencode`)\n *   MCP_RESEARCHER_MODEL             researcher worker model id (falls back to\n *                                    MCP_WORKER_MODEL, then WORKER_MODEL, then a default)\n *   MCP_RESEARCHER_FANOUT_HARNESSES  comma-separated harnesses for researcher variants > 1\n *   MCP_RESEARCHER_FANOUT_MODELS     comma-separated per-harness models, index-aligned\n *   MCP_RESEARCHER_ROUTER_KEY        OpenAI-compatible router key for the in-box agent\n *                                    (defaults to TANGLE_API_KEY)\n *   MCP_RESEARCHER_ROUTER_BASE_URL   router base for the in-box agent (defaults to the\n *                                    repo's resolveRouterBaseUrl, normalized to `/v1`)\n *   AGENT_RUNTIME_DELEGATION_STATE_FILE\n *                                    optional — absolute path of a JSON state\n *                                    file. When set, delegation records persist\n *                                    across MCP restarts (FileDelegationStore):\n *                                    status/history survive and idempotency keys\n *                                    dedupe across processes. Single-variant\n *                                    coder/researcher delegations additionally\n *                                    dispatch DETACHED (driveTurn ticks against a\n *                                    deterministic session id) on session-backed\n *                                    placements, so restored in-flight records\n *                                    resume against their still-running sandbox\n *                                    sessions; non-detached in-flight records\n *                                    settle as failed with a truthful\n *                                    driver-restart error.\n *   AGENT_RUNTIME_DELEGATION_DETACHED\n *                                    set to `0` to keep every delegation on the\n *                                    streaming path even when the state file is\n *                                    configured (disables detached dispatch +\n *                                    resume).\n *   AGENT_RUNTIME_DELEGATION_STATE_RECOVER\n *                                    set to `1` to archive a corrupt state file\n *                                    (`<file>.corrupt-<ts>`) and start empty\n *                                    instead of refusing to boot.\n *   AGENT_RUNTIME_DELEGATION_RETAIN_TERMINAL\n *                                    optional — positive integer cap on retained\n *                                    terminal records. Unset = keep forever.\n */\n\nimport type { SandboxInstance } from '@tangle-network/sandbox'\nimport { coderProfile } from '../profiles/coder'\nimport type { AgentRunSpec, LoopTraceEmitter, SandboxClient } from '../runtime'\nimport { runLoop } from '../runtime'\nimport { detectExecutor } from './bin-helpers'\nimport {\n  coderTaskFromArgs,\n  createDefaultCoderDelegate,\n  type ResearcherDelegate,\n  settleDetachedCoderTurn,\n} from './delegates'\nimport { DEFAULT_SANDBOX_BASE_URL } from './delegation-profile'\nimport { FileDelegationStore } from './delegation-store'\nimport { composeLoopTraceEmitters } from './delegation-trace'\nimport {\n  createDriveTurnResumeDriver,\n  type DetachedTurn,\n  type DriveTurnCapableBox,\n  detachedTurnEvents,\n  formatDetachedSessionRef,\n  parseDetachedSessionRef,\n  runDetachedTurn,\n} from './detached-turn'\nimport type { DelegationExecutor } from './executor'\nimport {\n  applyRouterEnv,\n  type ProvisionableSpec,\n  resolveResearcherProvisioning,\n} from './researcher-provisioning'\nimport { createMcpServer } from './server'\nimport { type DelegationResumeDriver, DelegationTaskQueue } from './task-queue'\nimport {\n  createPropagatingTraceEmitter,\n  readTraceContextFromEnv,\n  type TraceContext,\n} from './trace-propagation'\nimport type { DelegateCodeArgs, DelegateResearchArgs, ResearchOutputShape } from './types'\n\nasync function main(): Promise<void> {\n  const fanoutHarnesses = parseHarnesses(process.env.MCP_CODER_FANOUT_HARNESSES)\n  const maxConcurrency = parseConcurrency(process.env.MCP_MAX_CONCURRENT_SANDBOXES)\n  const wantCoder = !process.env.MCP_DISABLE_CODER\n  const wantResearcher = !process.env.MCP_DISABLE_RESEARCHER\n  const fleetId = parseFleetId(process.env.TANGLE_FLEET_ID)\n\n  // Skip the sandbox client load entirely when no profile delegate needs it —\n  // the feedback + status + history tools are queue-bound and require no\n  // sandbox. Useful for tooling that mounts the MCP server purely for\n  // self-introspection.\n  const needsSandbox = wantCoder || wantResearcher\n  let sandboxClient: SandboxClient | undefined\n  let executor: DelegationExecutor | undefined\n  if (needsSandbox) {\n    const apiKey = process.env.TANGLE_API_KEY\n    if (!apiKey && !process.env.AGENT_RUNTIME_MCP_ALLOW_NO_KEY) {\n      process.stderr.write(\n        'agent-runtime-mcp: TANGLE_API_KEY is required. Set AGENT_RUNTIME_MCP_ALLOW_NO_KEY=1 to run without it for diagnostics, or MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to run the queue-only subset.\\n',\n      )\n      process.exit(2)\n    }\n    // Fleet mode against a diagnostic stub is meaningless — the stub can't\n    // resolve a real fleet handle. Refuse rather than silently degrading,\n    // otherwise a fleet-mounted MCP would behave differently than configured.\n    if (fleetId && !apiKey) {\n      process.stderr.write(\n        'agent-runtime-mcp: TANGLE_FLEET_ID was set but TANGLE_API_KEY is missing; cannot resolve fleet handle. Provide an api key or unset TANGLE_FLEET_ID.\\n',\n      )\n      process.exit(2)\n    }\n    sandboxClient = await loadSandboxClient(apiKey)\n    executor = await detectExecutor({ sandboxClient })\n    if (fleetId) {\n      process.stderr.write(`agent-runtime-mcp: fleet-aware delegation: fleetId=${fleetId}\\n`)\n    }\n    process.stderr.write(`agent-runtime-mcp: delegation placement → ${executor.describe()}\\n`)\n  }\n\n  // Export delegated-loop topology spans to the OTLP / Tangle Intelligence sink\n  // when OTEL_EXPORTER_OTLP_ENDPOINT is set (+ TRACE_ID / PARENT_SPAN_ID for\n  // correlation with the caller's trace). A cheap no-op when the endpoint is\n  // unset — the fleet forwards the env into this MCP's process to turn it on.\n  // The same context is stamped onto every delegation record (traceId /\n  // parentSpanId) so journal consumers join records into the caller's trace.\n  const traceContext = readTraceContextFromEnv()\n  const { emitter: traceEmitter, exporter: traceExporter } =\n    createPropagatingTraceEmitter(traceContext)\n  if (process.env.OTEL_EXPORTER_OTLP_ENDPOINT) {\n    process.stderr.write(\n      `agent-runtime-mcp: exporting loop topology → ${process.env.OTEL_EXPORTER_OTLP_ENDPOINT}\\n`,\n    )\n  }\n\n  const coderDelegate =\n    wantCoder && executor\n      ? createDefaultCoderDelegate({\n          executor,\n          fanoutHarnesses,\n          maxConcurrency,\n          traceEmitter,\n        })\n      : undefined\n\n  const researcherSupport =\n    wantResearcher && executor\n      ? await loadResearcherSupport(executor, maxConcurrency, traceEmitter)\n      : undefined\n\n  // Detached dispatch + resume turn on together with the durable store, and\n  // only for session-backed placements with real credentials: in-process\n  // placement has no sandbox session to detach, and the diagnostic no-key stub\n  // cannot resolve boxes. AGENT_RUNTIME_DELEGATION_DETACHED=0 keeps everything\n  // on the streaming path.\n  const detachedDispatch =\n    Boolean(process.env.AGENT_RUNTIME_DELEGATION_STATE_FILE?.trim()) &&\n    process.env.AGENT_RUNTIME_DELEGATION_DETACHED !== '0' &&\n    Boolean(process.env.TANGLE_API_KEY) &&\n    (executor?.placement === 'sibling' || executor?.placement === 'fleet')\n  if (detachedDispatch) {\n    process.stderr.write(\n      'agent-runtime-mcp: detached dispatch enabled — single-variant delegations resume across restarts\\n',\n    )\n  }\n  const resumeDriver =\n    detachedDispatch && sandboxClient\n      ? buildResumeDriver({ sandboxClient, researcherResume: researcherSupport?.resume })\n      : undefined\n\n  const durableQueue = await buildDurableQueueFromEnv(resumeDriver, traceContext)\n  const server = createMcpServer({\n    coderDelegate,\n    researcherDelegate: researcherSupport?.delegate,\n    detachedDispatch,\n    traceContext,\n    ...(durableQueue ? { queue: durableQueue } : {}),\n  })\n\n  const shutdown = () => {\n    server.stop()\n    const pending: Promise<unknown>[] = []\n    if (traceExporter) pending.push(traceExporter.shutdown())\n    // Drain journal writes so the state file reflects the final record\n    // states before the process exits. A persist failure already routed\n    // through onPersistError; swallow the duplicate rejection here.\n    if (durableQueue) pending.push(durableQueue.flush().catch(() => {}))\n    if (pending.length === 0) {\n      process.exit(0)\n      return\n    }\n    void Promise.allSettled(pending).finally(() => process.exit(0))\n  }\n  process.on('SIGINT', shutdown)\n  process.on('SIGTERM', shutdown)\n\n  await server.serve()\n}\n\nasync function buildDurableQueueFromEnv(\n  resumeDriver: DelegationResumeDriver | undefined,\n  traceContext: TraceContext,\n): Promise<DelegationTaskQueue | undefined> {\n  const stateFile = process.env.AGENT_RUNTIME_DELEGATION_STATE_FILE?.trim()\n  if (!stateFile) return undefined\n  const store = new FileDelegationStore({\n    filePath: stateFile,\n    recoverCorrupt: process.env.AGENT_RUNTIME_DELEGATION_STATE_RECOVER === '1',\n  })\n  const maxTerminalRecords = parseRetention(process.env.AGENT_RUNTIME_DELEGATION_RETAIN_TERMINAL)\n  // With a resume driver, restored in-flight records that carry a\n  // detachedSessionRef re-attach to their still-running sandbox sessions;\n  // without one (detached dispatch disabled / no credentials) they settle as\n  // failed with a truthful driver-restart error.\n  const queue = await DelegationTaskQueue.restore({\n    store,\n    traceContext,\n    ...(resumeDriver ? { resumeDelegate: resumeDriver } : {}),\n    ...(maxTerminalRecords !== undefined ? { maxTerminalRecords } : {}),\n    onPersistError: (error) => {\n      // Durable mode that can no longer write is a broken contract: crash\n      // loud instead of degrading to memory-only behind the caller's back.\n      process.stderr.write(`agent-runtime-mcp: ${error.message}\\n`)\n      process.exit(1)\n    },\n  })\n  process.stderr.write(`agent-runtime-mcp: durable delegation state → ${stateFile}\\n`)\n  return queue\n}\n\ninterface ResearcherResumeSupport {\n  message(args: DelegateResearchArgs): string\n  settle(\n    turn: DetachedTurn,\n    args: DelegateResearchArgs,\n    signal: AbortSignal,\n  ): Promise<ResearchOutputShape>\n}\n\n/**\n * Compose the `driveTurn`-backed resume driver over the real sandbox client.\n * Profile dispatch: coder records settle through the same parse + validate\n * gate the delegate applies; researcher records settle through the\n * agent-knowledge preset when the peer is installed. Profiles without resume\n * support (ui-auditor, researcher-without-peer) fail loud — the record settles\n * as failed with the reason instead of fabricating an output.\n */\nfunction buildResumeDriver(args: {\n  sandboxClient: SandboxClient\n  researcherResume: ResearcherResumeSupport | undefined\n}): DelegationResumeDriver {\n  const client = args.sandboxClient as SandboxClient & {\n    get?: (id: string) => Promise<SandboxInstance | null>\n  }\n  return createDriveTurnResumeDriver({\n    async resolveSandbox(sandboxId) {\n      if (typeof client.get !== 'function') {\n        throw new Error(\n          'agent-runtime-mcp: the sandbox client exposes no get(sandboxId); upgrade @tangle-network/sandbox to >= 0.6 to resume detached delegations',\n        )\n      }\n      const box = await client.get(sandboxId)\n      if (!box) {\n        throw new Error(\n          `agent-runtime-mcp: sandbox ${sandboxId} no longer exists — the detached run cannot be resumed`,\n        )\n      }\n      return box as unknown as DriveTurnCapableBox\n    },\n    buildMessage(record) {\n      if (record.profile === 'coder') {\n        const task = coderTaskFromArgs(record.args as DelegateCodeArgs)\n        return coderProfile({ task }).taskToPrompt(task)\n      }\n      if (record.profile === 'researcher' && args.researcherResume) {\n        return args.researcherResume.message(record.args as DelegateResearchArgs)\n      }\n      throw new Error(\n        `agent-runtime-mcp: no detached resume support for profile \"${record.profile}\"`,\n      )\n    },\n    async settleOutput(turn, record, ctx) {\n      if (record.profile === 'coder') {\n        if (!record.detachedSessionRef) {\n          throw new Error(\n            `agent-runtime-mcp: record ${record.taskId} reached the resume settle without a detachedSessionRef`,\n          )\n        }\n        return settleDetachedCoderTurn(turn, {\n          task: coderTaskFromArgs(record.args as DelegateCodeArgs),\n          sessionId: parseDetachedSessionRef(record.detachedSessionRef).sessionId,\n          signal: ctx.signal,\n        })\n      }\n      if (record.profile === 'researcher' && args.researcherResume) {\n        return args.researcherResume.settle(turn, record.args as DelegateResearchArgs, ctx.signal)\n      }\n      throw new Error(\n        `agent-runtime-mcp: no detached resume support for profile \"${record.profile}\"`,\n      )\n    },\n  })\n}\n\nfunction parseRetention(raw: string | undefined): number | undefined {\n  if (raw === undefined || raw.trim() === '') return undefined\n  const n = Number(raw)\n  if (!Number.isInteger(n) || n < 1) {\n    process.stderr.write(\n      `agent-runtime-mcp: AGENT_RUNTIME_DELEGATION_RETAIN_TERMINAL must be a positive integer, got \"${raw}\"\\n`,\n    )\n    process.exit(2)\n  }\n  return n\n}\n\nasync function loadSandboxClient(apiKey: string | undefined): Promise<SandboxClient> {\n  // Diagnostic mode: AGENT_RUNTIME_MCP_ALLOW_NO_KEY=1 enables tools/list + the\n  // queue-bound tools (status / history / feedback) without sandbox creds.\n  // Coder + researcher delegations require a real client; the stub fails loud\n  // at create() so the agent observes the cause instead of silent success.\n  if (!apiKey) {\n    return {\n      async create() {\n        throw new Error(\n          'agent-runtime-mcp: TANGLE_API_KEY is unset; coder/researcher delegations are disabled in diagnostic mode. Set TANGLE_API_KEY or use MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to remove the unsupported tools from the tool list.',\n        )\n      },\n    } satisfies SandboxClient\n  }\n  // Dynamic import keeps the bin importable in environments that haven't\n  // installed `@tangle-network/sandbox` yet (the runtime package lists it\n  // as a peer dep, not a hard dep).\n  const mod = await import('@tangle-network/sandbox').catch((err) => {\n    process.stderr.write(\n      `agent-runtime-mcp: failed to load @tangle-network/sandbox (${err.message}); install the peer dependency\\n`,\n    )\n    process.exit(2)\n  })\n  const SandboxCtor = (mod as { Sandbox?: new (config: unknown) => SandboxClient }).Sandbox\n  if (!SandboxCtor) {\n    process.stderr.write(\n      'agent-runtime-mcp: @tangle-network/sandbox does not export Sandbox; cannot construct client\\n',\n    )\n    process.exit(2)\n  }\n  // @tangle-network/sandbox ≥0.6 makes baseUrl required; default it so the MCP server\n  // starts without forcing every caller to set SANDBOX_BASE_URL. Treat empty/whitespace as\n  // unset (|| not ??) so `SANDBOX_BASE_URL=` still resolves to the default.\n  const baseUrl = process.env.SANDBOX_BASE_URL?.trim() || DEFAULT_SANDBOX_BASE_URL\n  return new SandboxCtor({ apiKey, baseUrl })\n}\n\ninterface ResearcherProfilePreset {\n  agentRunSpec: Parameters<typeof runLoop>[0]['agentRun'] extends infer T ? NonNullable<T> : never\n  output: Parameters<typeof runLoop>[0]['output']\n  validator: Parameters<typeof runLoop>[0]['validator']\n}\n\ninterface ResearcherFanoutPreset {\n  agentRuns: NonNullable<Parameters<typeof runLoop>[0]['agentRuns']>\n  output: Parameters<typeof runLoop>[0]['output']\n  validator: Parameters<typeof runLoop>[0]['validator']\n  driver: Parameters<typeof runLoop>[0]['driver']\n}\n\ninterface ResearcherSupport {\n  delegate: ResearcherDelegate\n  resume: ResearcherResumeSupport\n}\n\nasync function loadResearcherSupport(\n  executor: DelegationExecutor,\n  maxConcurrency: number,\n  traceEmitter?: LoopTraceEmitter,\n): Promise<ResearcherSupport | undefined> {\n  const sandboxClient = executor.client\n  // Optional peer — when `@tangle-network/agent-knowledge` isn't installed,\n  // we silently omit the researcher tool from the advertisement. The\n  // dynamic-import path is resolved at runtime; TypeScript cannot see the\n  // peer, so we type the module structurally rather than via its own\n  // declaration file.\n  const profilesSpecifier = '@tangle-network/agent-knowledge/profiles'\n  const mod = await import(profilesSpecifier).catch(() => undefined)\n  if (!mod) return undefined\n  type SingleFactory = (opts: {\n    task: unknown\n    harness?: string\n    model?: string\n  }) => ResearcherProfilePreset\n  type FanoutFactory = (opts: {\n    task: unknown\n    harnesses?: string[]\n    models?: (string | undefined)[]\n  }) => ResearcherFanoutPreset\n  const fanoutFactory = (mod as { multiHarnessResearcherFanout?: FanoutFactory })\n    .multiHarnessResearcherFanout\n  const singleFactory = (mod as { researcherProfile?: SingleFactory }).researcherProfile\n  if (!fanoutFactory || !singleFactory) return undefined\n\n  // Worker harness + model + provider auth. Two reasons a researcher run otherwise makes\n  // zero LLM calls and \"produces no winner\" on a successful box: (1) the profile's default\n  // harness (opencode/zai-coding-plan/glm-5.1) is not broadly provisionable; (2) the\n  // sandbox SDK does not wire backend.model.apiKey into the in-box agent's OpenAI-compatible\n  // provider. resolveResearcherProvisioning picks a provisionable harness + model and the\n  // router creds (all env-overridable); applyRouterEnv injects them as box env. Applied to\n  // BOTH the single-variant path and every fanout agent-run so variants > 1 work too.\n  const {\n    harness,\n    model,\n    routerKey,\n    routerBaseUrl,\n    fanoutHarnesses: cfgFanoutHarnesses,\n    fanoutModels,\n  } = resolveResearcherProvisioning()\n  const buildPreset = (task: unknown): ResearcherProfilePreset => {\n    const preset = singleFactory({ task, harness, model })\n    applyRouterEnv(preset.agentRunSpec as ProvisionableSpec, routerKey, routerBaseUrl)\n    return preset\n  }\n\n  const settleSingle = async (\n    turn: DetachedTurn,\n    args: DelegateResearchArgs,\n    sessionId: string,\n    signal: AbortSignal,\n  ): Promise<ResearchOutputShape> => {\n    const task = buildResearchTask(args)\n    const preset = buildPreset(task)\n    if (!preset.validator) {\n      throw new Error('agent-runtime-mcp: researcher preset exposes no validator; cannot settle')\n    }\n    const parsed = preset.output.parse(detachedTurnEvents(sessionId, turn))\n    const verdict = await preset.validator.validate(parsed, { iteration: 0, signal })\n    if ((verdict as { valid?: boolean }).valid !== true) {\n      throw new Error('researcher delegate produced no winner')\n    }\n    return parsed as ResearchOutputShape\n  }\n\n  const delegate: ResearcherDelegate = async (args, ctx) => {\n    const task = buildResearchTask(args)\n    const variants = Math.max(1, Math.trunc(args.variants ?? 1))\n    const loopEmitter = composeLoopTraceEmitters(traceEmitter, ctx.traceEmitter)\n    ctx.report({ iteration: 0, phase: 'starting' })\n    if (variants <= 1) {\n      const preset = buildPreset(task)\n      // Detached dispatch — same contract as the coder delegate: one session\n      // on one box, driveTurn ticks, resume key bound to the sandbox id.\n      if (ctx.detachedSessionRef !== undefined && ctx.updateDetachedSessionRef) {\n        const { sessionId } = parseDetachedSessionRef(ctx.detachedSessionRef)\n        const rebind = ctx.updateDetachedSessionRef\n        const spec = preset.agentRunSpec as AgentRunSpec<unknown>\n        const turn = await runDetachedTurn({\n          client: sandboxClient,\n          spec,\n          prompt: spec.taskToPrompt(task),\n          sessionId,\n          bindSandbox: (sandboxId) => rebind(formatDetachedSessionRef({ sandboxId, sessionId })),\n          signal: ctx.signal,\n          report: ctx.report,\n          ...(loopEmitter ? { traceEmitter: loopEmitter } : {}),\n          ...(executor.placement === 'fleet' ? { placement: 'fleet' as const } : {}),\n        })\n        const output = await settleSingle(turn, args, sessionId, ctx.signal)\n        ctx.report({ iteration: 1, phase: 'completed' })\n        return output\n      }\n      const result = await runLoop({\n        driver: {\n          name: 'mcp-researcher-single',\n          async plan(t, history) {\n            return history.length === 0 ? [t] : []\n          },\n          decide(history) {\n            return history.length > 0 ? 'pick-winner' : 'fail'\n          },\n        },\n        agentRun: preset.agentRunSpec,\n        output: preset.output,\n        validator: preset.validator,\n        task,\n        ctx: {\n          sandboxClient,\n          signal: ctx.signal,\n          ...(loopEmitter ? { traceEmitter: loopEmitter } : {}),\n        },\n        maxIterations: 1,\n        maxConcurrency,\n      })\n      const output = result.winner?.output\n      if (!output) throw new Error('researcher delegate produced no winner')\n      ctx.report({ iteration: 1, phase: 'completed' })\n      return output as ResearchOutputShape\n    }\n    // Match the single-variant fix: use a provisionable harness/model and inject router\n    // creds into every fanout agent-run, else variants > 1 makes zero LLM calls. Default to\n    // `variants` copies of the working harness; MCP_RESEARCHER_FANOUT_HARNESSES overrides for\n    // diversity (with optional per-harness MCP_RESEARCHER_FANOUT_MODELS).\n    const fanoutHarnesses = cfgFanoutHarnesses ?? Array.from({ length: variants }, () => harness)\n    const fanout = fanoutFactory({\n      task,\n      harnesses: fanoutHarnesses,\n      models: fanoutHarnesses.map((_, i) => fanoutModels?.[i] ?? model),\n    })\n    for (const spec of fanout.agentRuns) {\n      applyRouterEnv(spec as ProvisionableSpec, routerKey, routerBaseUrl)\n    }\n    // The harness list may be shorter than `variants` (misconfig) — never claim more\n    // iterations than there are runs.\n    const runs = fanout.agentRuns.slice(0, variants)\n    const effectiveVariants = Math.max(1, runs.length)\n    const result = await runLoop({\n      driver: fanout.driver,\n      agentRuns: runs,\n      output: fanout.output,\n      validator: fanout.validator,\n      task,\n      ctx: {\n        sandboxClient,\n        signal: ctx.signal,\n        ...(loopEmitter ? { traceEmitter: loopEmitter } : {}),\n      },\n      maxIterations: effectiveVariants,\n      maxConcurrency: Math.min(maxConcurrency, effectiveVariants),\n    })\n    const output = result.winner?.output\n    if (!output) throw new Error('researcher delegate fanout produced no winner')\n    ctx.report({ iteration: result.iterations.length, phase: 'completed' })\n    return output as ResearchOutputShape\n  }\n\n  return {\n    delegate,\n    resume: {\n      message(args) {\n        const task = buildResearchTask(args)\n        // Use the same preset construction as dispatch so the displayed prompt can't drift.\n        const spec = buildPreset(task).agentRunSpec as AgentRunSpec<unknown>\n        return spec.taskToPrompt(task)\n      },\n      async settle(turn, args, signal) {\n        // The session id is only the synthesized event's id — the parser reads\n        // data.result / data.text, never the id.\n        return settleSingle(turn, args, 'resumed-detached-turn', signal)\n      },\n    },\n  }\n}\n\nfunction buildResearchTask(args: DelegateResearchArgs): unknown {\n  return {\n    question: args.question,\n    knowledgeNamespace: args.namespace,\n    scope: args.scope,\n    sources: args.sources,\n    recencyWindow: args.config?.recencyWindow\n      ? {\n          since: args.config.recencyWindow.since\n            ? new Date(args.config.recencyWindow.since)\n            : undefined,\n          until: args.config.recencyWindow.until\n            ? new Date(args.config.recencyWindow.until)\n            : undefined,\n        }\n      : undefined,\n    maxItems: args.config?.maxItems,\n    minConfidence: args.config?.minConfidence,\n  }\n}\n\nfunction parseHarnesses(raw: string | undefined): string[] | undefined {\n  if (!raw) return undefined\n  const list = raw\n    .split(',')\n    .map((entry) => entry.trim())\n    .filter(Boolean)\n  return list.length > 0 ? list : undefined\n}\n\nfunction parseFleetId(raw: string | undefined): string | undefined {\n  if (typeof raw !== 'string') return undefined\n  const trimmed = raw.trim()\n  return trimmed.length > 0 ? trimmed : undefined\n}\n\nfunction parseConcurrency(raw: string | undefined): number {\n  if (!raw) return 4\n  const n = Number(raw)\n  if (!Number.isFinite(n) || n < 1) return 4\n  return Math.min(Math.trunc(n), 32)\n}\n\nmain().catch((err) => {\n  process.stderr.write(`agent-runtime-mcp: ${err instanceof Error ? err.stack : String(err)}\\n`)\n  process.exit(1)\n})\n"],"mappings":"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","names":["output","result","trimmed"]}

package/dist/mcp/index.d.ts

@@ -1,16 +1,18 @@
-import { S as SandboxClient, f as LoopSandboxPlacement } from '../types-CklkW4Eh.js';
-import { c as FleetHandle, d as DelegationExecutor, e as DelegateFeedbackArgs, f as DelegationFeedbackSnapshot, g as DelegationTaskQueue, h as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, T as TraceContext, D as DelegateCodeArgs, i as DelegateCodeResult, j as DelegateFeedbackResult, k as ResearchSource, l as DelegateResearchArgs, m as DelegateResearchResult, n as DelegateUiAuditArgs, o as DelegateUiAuditResult, p as DelegationHistoryResult, q as DelegationHistoryArgs, r as DelegationStatusResult, s as DelegationStatusArgs } from '../kb-gate-CKfykcYQ.js';
-export { t as CappedDelegationTrace, u as CoderReview, C as CoderReviewer, a as CoderWinnerSelection, v as CreateDefaultCoderDelegateOptions, b as CreateKbGateOptions, w as DELEGATION_TRACE_MAX_BYTES, x as DELEGATION_TRACE_MAX_SPANS, y as DelegateCodeConfig, z as DelegateResearchConfig, A as DelegateRunCtx, B as DelegateUiAuditConfig, E as DelegateUiAuditRoute, G as DelegationError, H as DelegationHistoryEntry, I as DelegationPersistenceError, J as DelegationProfile, K as DelegationProgress, L as DelegationRecord, M as DelegationResultPayload, N as DelegationResumeContext, O as DelegationResumeDriver, P as DelegationResumeTick, Q as DelegationRunContext, S as DelegationStateCorruptError, V as DelegationStatus, W as DelegationStore, X as DelegationTaskQueueOptions, Y as DelegationTraceCaps, Z as DelegationTraceCollector, _ as DelegationTraceSpan, $ as DetachedSessionRefParts, a0 as DetachedTurn, a1 as DriveTurnCapableBox, a2 as DriveTurnResumeDriverOptions, a3 as DriveTurnTick, F as FactCandidate, a4 as FactJudge, a5 as FactJudgeVerdict, a6 as FeedbackRating, a7 as FeedbackRefersTo, a8 as FileDelegationStore, a9 as FileDelegationStoreOptions, aa as FleetWorkspaceExecutorOptions, ab as InMemoryDelegationStore, ac as KbGateResult, ad as ResearchOutputShape, ae as RunDetachedTurnOptions, af as SettleDetachedCoderTurnOptions, ag as SiblingSandboxExecutorOptions, ah as SubmitInput, ai as SubmitOutput, aj as UiAuditorDelegationOutput, ak as buildDelegationTraceSpans, al as capDelegationTrace, am as coderTaskFromArgs, an as composeLoopTraceEmitters, ao as createDefaultCoderDelegate, ap as createDelegationTraceCollector, aq as createDriveTurnResumeDriver, ar as createFleetWorkspaceExecutor, as as createKbGate, at as createPropagatingTraceEmitter, au as createSiblingSandboxExecutor, av as detachedTurnEvents, aw as formatDetachedSessionRef, ax as hashIdempotencyInput, ay as parseDetachedSessionRef, az as readTraceContextFromEnv, aA as runDetachedTurn, aB as settleDetachedCoderTurn, aC as traceContextToEnv } from '../kb-gate-CKfykcYQ.js';
+import { S as SandboxClient, f as LoopSandboxPlacement } from '../types-C8rNlxfV.js';
+import { F as FleetHandle, f as DelegationExecutor, d as DelegationTaskQueue, e as CoderDelegate, D as DelegateCodeArgs, g as DelegateCodeResult, h as DelegateFeedbackResult, b as DelegateFeedbackArgs, i as ResearchSource, R as ResearcherDelegate, j as DelegateResearchArgs, k as DelegateResearchResult, U as UiAuditorDelegate, l as DelegateUiAuditArgs, m as DelegateUiAuditResult, n as DelegationHistoryResult, o as DelegationHistoryArgs, p as DelegationStatusResult, q as DelegationStatusArgs } from '../delegates-BPLIl8EC.js';
+export { r as CappedDelegationTrace, s as CoderReview, C as CoderReviewer, a as CoderWinnerSelection, t as CreateDefaultCoderDelegateOptions, u as DELEGATION_TRACE_MAX_BYTES, v as DELEGATION_TRACE_MAX_SPANS, w as DelegateCodeConfig, x as DelegateResearchConfig, y as DelegateRunCtx, z as DelegateUiAuditConfig, A as DelegateUiAuditRoute, B as DelegationError, c as DelegationFeedbackSnapshot, E as DelegationHistoryEntry, G as DelegationPersistenceError, H as DelegationProfile, I as DelegationProgress, J as DelegationRecord, K as DelegationResultPayload, L as DelegationResumeContext, M as DelegationResumeDriver, N as DelegationResumeTick, O as DelegationRunContext, P as DelegationStateCorruptError, Q as DelegationStatus, S as DelegationStore, V as DelegationTaskQueueOptions, W as DelegationTraceCaps, X as DelegationTraceCollector, Y as DelegationTraceSpan, Z as DetachedSessionRefParts, _ as DetachedTurn, $ as DriveTurnCapableBox, a0 as DriveTurnResumeDriverOptions, a1 as DriveTurnTick, a2 as FeedbackRating, a3 as FeedbackRefersTo, a4 as FileDelegationStore, a5 as FileDelegationStoreOptions, a6 as FleetWorkspaceExecutorOptions, a7 as InMemoryDelegationStore, a8 as ResearchOutputShape, a9 as RunDetachedTurnOptions, aa as SettleDetachedCoderTurnOptions, ab as SiblingSandboxExecutorOptions, ac as SubmitInput, ad as SubmitOutput, T as TraceContext, ae as UiAuditorDelegationOutput, af as buildDelegationTraceSpans, ag as capDelegationTrace, ah as coderTaskFromArgs, ai as composeLoopTraceEmitters, aj as createDefaultCoderDelegate, ak as createDelegationTraceCollector, al as createDriveTurnResumeDriver, am as createFleetWorkspaceExecutor, an as createPropagatingTraceEmitter, ao as createSiblingSandboxExecutor, ap as detachedTurnEvents, aq as formatDetachedSessionRef, ar as hashIdempotencyInput, as as parseDetachedSessionRef, at as readTraceContextFromEnv, au as runDetachedTurn, av as settleDetachedCoderTurn, aw as traceContextToEnv } from '../delegates-BPLIl8EC.js';
 export { B as BuildDelegationMcpServerOptions, C as ComposeProductionAgentProfileOptions, D as DELEGATION_MCP_SERVER_KEY, b as buildDelegationMcpServer, c as composeProductionAgentProfile } from '../delegation-profile-Bvfro2m1.js';
+import { F as FeedbackStore } from '../coordination-BMzskrUR.js';
+export { A as AnalystRegistry, C as CoordinationEvent, a as CoordinationTools, b as CoordinationToolsOptions, c as FeedbackEvent, I as InMemoryFeedbackStore, J as JsonRpcMessage, d as JsonRpcResponse, M as MakeWorkerAgent, e as McpServer, f as McpServerOptions, g as McpToolDescriptor, h as McpTransport, Q as Question, i as QuestionDecision, j as QuestionPolicy, k as QuestionRecord, S as SettledWorker, l as createCoordinationTools, m as createInProcessTransport, n as createMcpServer, o as eventToSnapshot } from '../coordination-BMzskrUR.js';
 import { L as LocalHarness, r as runLocalHarness } from '../local-harness-KrdFTY5R.js';
 export { a as LocalHarnessResult, R as RunLocalHarnessOptions } from '../local-harness-KrdFTY5R.js';
-export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-CKfR3EMh.js';
+export { C as CreateKbGateOptions, F as FactCandidate, a as FactJudge, b as FactJudgeVerdict, K as KbGateResult, c as createKbGate } from '../kb-gate-CuzMYGYM.js';
+export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-CoeLQ7Uo.js';
 import { AnalystFinding } from '@tangle-network/agent-eval';
-import { S as Scope, R as ResultBlobStore, A as Agent, B as Budget } from '../types-CNDJCL_0.js';
 import { a as UiLens } from '../substrate-CUgk7F7s.js';
 import '@tangle-network/sandbox';
 import '../runtime-hooks-C7JwKb9E.js';
-import '../coder-LKm3Mczw.js';
+import '../coder-CEkUFv8h.js';
 import 'node:child_process';
 
 /**
@@ -49,61 +51,6 @@ interface DetectExecutorArgs {
  */
 declare function detectExecutor(args: DetectExecutorArgs): Promise<DelegationExecutor>;
 
-/**
- * @experimental
- *
- * Feedback persistence surface for the MCP layer.
- *
- * The substrate cannot import `@tangle-network/agent-knowledge` (it would
- * induce a dependency cycle), so the store is an abstract interface. The
- * default implementation is in-memory; consumers wire their own adapter
- * (a real KbStore-backed sink, an HTTP relay to gtm-agent's knowledge
- * service, etc.) via `createMcpServer({ feedbackStore })`.
- *
- * Feedback events are append-only: every rating is a new event with a
- * fresh id, even when the same delegation is rated multiple times. The
- * caller decides how to roll up scores downstream.
- */
-
-/** @experimental */
-interface FeedbackEvent {
-    id: string;
-    refersTo: DelegateFeedbackArgs['refersTo'];
-    rating: DelegateFeedbackArgs['rating'];
-    by: DelegateFeedbackArgs['by'];
-    capturedAt: string;
-    namespace?: string;
-}
-/** @experimental */
-interface FeedbackStore {
-    /** Append a new event. Never dedupes — every rating is its own event. */
-    put(event: FeedbackEvent): Promise<void>;
-    /**
-     * List events filtered by `namespace`. When `namespace` is omitted, list
-     * across all namespaces. Returns events in insertion order.
-     */
-    list(filter?: {
-        namespace?: string;
-        refersToRef?: string;
-    }): Promise<FeedbackEvent[]>;
-}
-/** @experimental */
-declare class InMemoryFeedbackStore implements FeedbackStore {
-    private readonly events;
-    put(event: FeedbackEvent): Promise<void>;
-    list(filter?: {
-        namespace?: string;
-        refersToRef?: string;
-    }): Promise<FeedbackEvent[]>;
-}
-/**
- * Project a `FeedbackEvent` down to the snapshot shape carried on
- * `delegation_history` entries.
- *
- * @experimental
- */
-declare function eventToSnapshot(event: FeedbackEvent): DelegationFeedbackSnapshot;
-
 /**
  * @experimental
  *
@@ -289,133 +236,6 @@ interface InProcessExecutorDescribePlacement extends LoopSandboxPlacement {
  */
 declare function createInProcessExecutor(options: InProcessExecutorOptions): DelegationExecutor;
 
-/**
- * @experimental
- *
- * Stdio JSON-RPC MCP server exposing the 5 delegation tools to sandbox
- * coding-harness agents (claude-code, codex, opencode, ...).
- *
- * The server is transport-bound but topology-free: tool execution is
- * delegated to handler functions composed from a queue, a feedback
- * store, and per-profile run delegates. Consumers wire those at
- * construction time. The `agent-runtime-mcp` bin spins up a default
- * configuration for the common case (real sandbox client + coder).
- *
- * Wire protocol: line-delimited JSON-RPC 2.0 over stdio. Each line is
- * one request; each response is one line. `tools/list` and `tools/call`
- * mirror the MCP 2024-11-05 spec; we do not pull in
- * `@modelcontextprotocol/sdk` to keep the dependency footprint zero.
- */
-
-/** @experimental */
-interface McpServerOptions {
-    /** Required to enable delegate_code. */
-    coderDelegate?: CoderDelegate;
-    /**
-     * Required to enable delegate_research. The substrate cannot ship a
-     * default — wire one that closes over your `runLoop` + a
-     * researcher profile (typically `@tangle-network/agent-knowledge`'s
-     * `researcherProfile` / `multiHarnessResearcherFanout`).
-     */
-    researcherDelegate?: ResearcherDelegate;
-    /**
-     * Required to enable delegate_ui_audit. Wire one that closes over your
-     * `runLoop` + `uiAuditorProfile` + a `SandboxClient` (the
-     * canonical in-process choice is `createInProcessUiAuditClient` from
-     * `@tangle-network/agent-runtime/profiles`) + your vision judge.
-     */
-    uiAuditorDelegate?: UiAuditorDelegate;
-    /** Override the default in-memory feedback store. */
-    feedbackStore?: FeedbackStore;
-    /** Override the default in-memory task queue. */
-    queue?: DelegationTaskQueue;
-    /**
-     * Record deterministic detached-session resume keys on single-variant
-     * coder/researcher submissions so a durable queue can resume them after a
-     * restart. Enable only when the wired delegates dispatch via sandbox
-     * sessions (`driveTurn`) AND `queue` persists records — the keys are inert
-     * otherwise. The bin turns this on alongside the durable store for
-     * session-backed (sibling/fleet) placements.
-     */
-    detachedDispatch?: boolean;
-    /**
-     * Extra tools to serve alongside the delegation tools, for example
-     * `createCoordinationTools(...).tools`. Registered after the built-ins; a
-     * duplicate name throws so delegation tools cannot be shadowed silently.
-     */
-    extraTools?: McpToolDescriptor[];
-    /**
-     * Inherited trace identity (`readTraceContextFromEnv()`) stamped on every
-     * record the DEFAULT queue creates. Ignored when `queue` is supplied —
-     * pass `traceContext` to that queue's constructor instead.
-     */
-    traceContext?: TraceContext;
-    /** Server display name surfaced via `initialize`. Default `'agent-runtime-mcp'`. */
-    serverName?: string;
-    /** Server version surfaced via `initialize`. Default = the package version baked at build time. */
-    serverVersion?: string;
-}
-/** @experimental */
-interface McpToolDescriptor {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-    handler: (raw: unknown) => Promise<unknown>;
-}
-/** @experimental */
-interface McpServer {
-    /** Tools currently registered (depend on which delegates were wired). */
-    readonly tools: ReadonlyMap<string, McpToolDescriptor>;
-    /** The underlying queue — exposed so tests can introspect it. */
-    readonly queue: DelegationTaskQueue;
-    /** The feedback store — exposed for the same reason. */
-    readonly feedbackStore: FeedbackStore;
-    /** Handle a single parsed JSON-RPC message. Returns the response object (or `null` for notifications). */
-    handle(message: JsonRpcMessage): Promise<JsonRpcResponse | null>;
-    /** Drive the server on a stdio-shaped transport until `stop()` is called. */
-    serve(transport?: McpTransport): Promise<void>;
-    /** Stop a `serve` call. Subsequent requests are rejected. */
-    stop(): void;
-}
-/** @experimental */
-interface McpTransport {
-    input: NodeJS.ReadableStream;
-    output: NodeJS.WritableStream;
-}
-/** @experimental */
-interface JsonRpcMessage {
-    jsonrpc: '2.0';
-    id?: number | string | null;
-    method: string;
-    params?: unknown;
-}
-/** @experimental */
-interface JsonRpcResponse {
-    jsonrpc: '2.0';
-    id: number | string | null;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-/** @experimental */
-declare function createMcpServer(options?: McpServerOptions): McpServer;
-/**
- * In-process pair of `Readable` + `Writable` streams suitable for driving
- * `server.serve(...)` from a test. Returns the agent-side stream (the
- * client writes to it) and the server-side stream (the test reads from it).
- *
- * @experimental
- */
-declare function createInProcessTransport(): {
-    transport: McpTransport;
-    clientWrite(line: string): void;
-    clientClose(): void;
-    readServer(): Promise<JsonRpcResponse[]>;
-};
-
 /**
  * @experimental
  *
@@ -471,89 +291,6 @@ declare function makeCheckRunner(kinds: Record<string, Check>, opts: CheckRunner
     error: string;
 }>;
 
-/**
- * @experimental
- *
- * MCP binding for a live `Scope`. A sandbox driver gets the same small verbs
- * the in-process driver has: spawn, observe, await, steer, ask/answer, analyze,
- * and stop. Settled outputs remain Scope artifacts; product code can project
- * them into any UI/report envelope it needs.
- */
-
-/** A worker the driver has drained via `await_next`. */
-interface SettledWorker {
-    readonly id: string;
-    readonly status: 'done' | 'down';
-    readonly score?: number;
-    readonly valid?: boolean;
-    readonly outRef?: string;
-    readonly reason?: string;
-}
-type QuestionLevel = 'worker' | 'driver' | 'loop';
-type QuestionUrgency = 'continue-without' | 'blocks-step' | 'blocks-run';
-interface QuestionOption {
-    readonly label: string;
-    readonly tradeoff: string;
-}
-interface Question {
-    readonly id: string;
-    readonly from: string;
-    readonly level: QuestionLevel;
-    readonly question: string;
-    readonly reason: string;
-    readonly urgency: QuestionUrgency;
-    readonly options?: ReadonlyArray<QuestionOption>;
-}
-type QuestionDecision = {
-    readonly kind: 'answer';
-    readonly answer: string;
-    readonly by: string;
-} | {
-    readonly kind: 'defer';
-    readonly reason: string;
-} | {
-    readonly kind: 'escalate';
-    readonly to: 'parent' | 'user' | string;
-    readonly reason: string;
-};
-interface QuestionRecord extends Question {
-    readonly status: 'open' | 'answered' | 'deferred' | 'escalated';
-    readonly decision?: QuestionDecision;
-    readonly openedAt: number;
-}
-type QuestionPolicy = 'auto' | 'mustDecide' | 'bubble' | 'failClosed';
-interface AnalystRegistry {
-    readonly kinds: ReadonlyArray<{
-        id: string;
-        description: string;
-        area: string;
-    }>;
-    readonly run: (kindId: string, trace: unknown) => Promise<unknown>;
-}
-type CoordinationEvent = {
-    readonly type: 'question';
-    readonly question: QuestionRecord;
-};
-type MakeWorkerAgent = (profile: unknown) => Agent<unknown, unknown>;
-interface CoordinationToolsOptions {
-    readonly scope: Scope<unknown>;
-    readonly blobs: ResultBlobStore;
-    readonly makeWorkerAgent: MakeWorkerAgent;
-    readonly perWorker: Budget;
-    readonly analysts?: AnalystRegistry;
-    readonly onEvent?: (event: CoordinationEvent) => void | Promise<void>;
-    readonly questionPolicy?: QuestionPolicy;
-}
-interface CoordinationTools {
-    readonly tools: McpToolDescriptor[];
-    isStopped(): boolean;
-    stopReason(): string | undefined;
-    settled(): ReadonlyArray<SettledWorker>;
-    questions(): ReadonlyArray<QuestionRecord>;
-}
-/** Build the driver's MCP tools over a live scope. */
-declare function createCoordinationTools(opts: CoordinationToolsOptions): CoordinationTools;
-
 /**
  * @experimental
  *
@@ -1012,4 +749,4 @@ interface DelegationStatusHandlerOptions {
 /** @experimental */
 declare function createDelegationStatusHandler(options: DelegationStatusHandlerOptions): (raw: unknown) => Promise<DelegationStatusResult>;
 
-export { type AnalystRegistry, type Check, type CheckRunnerOptions, CoderDelegate, type CoordinationEvent, type CoordinationTools, type CoordinationToolsOptions, type CreateWorktreeOptions, DELEGATE_CODE_DESCRIPTION, DELEGATE_CODE_INPUT_SCHEMA, DELEGATE_CODE_TOOL_NAME, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_RESEARCH_DESCRIPTION, DELEGATE_RESEARCH_INPUT_SCHEMA, DELEGATE_RESEARCH_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DelegateCodeArgs, DelegateCodeResult, DelegateFeedbackArgs, DelegateFeedbackResult, DelegateResearchArgs, DelegateResearchResult, DelegateUiAuditArgs, DelegateUiAuditResult, DelegationExecutor, DelegationFeedbackSnapshot, DelegationHistoryArgs, DelegationHistoryResult, DelegationStatusArgs, DelegationStatusResult, DelegationTaskQueue, type DetectExecutorArgs, type DiffOptions, type DiffResult, type FeedbackEvent, type FeedbackStore, FleetHandle, type GitRunner, InMemoryFeedbackStore, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, type JsonRpcMessage, type JsonRpcResponse, LocalHarness, type MakeWorkerAgent, type McpServer, type McpServerOptions, type McpToolDescriptor, type McpTransport, type Question, type QuestionDecision, type QuestionPolicy, type QuestionRecord, type RemoveWorktreeOptions, ResearchSource, ResearcherDelegate, type SettledWorker, TraceContext, UiAuditorDelegate, type WorktreeHandle, captureWorktreeDiff, createCoordinationTools, createDelegateCodeHandler, createDelegateFeedbackHandler, createDelegateResearchHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createInProcessExecutor, createInProcessTransport, createMcpServer, createWorktree, defaultChecks, detectExecutor, eventToSnapshot, liftFindings, makeCheckRunner, removeWorktree, renderTrace, runCheck, runLocalHarness, validateDelegateCodeArgs, validateDelegateFeedbackArgs, validateDelegateResearchArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };
+export { type Check, type CheckRunnerOptions, CoderDelegate, type CreateWorktreeOptions, DELEGATE_CODE_DESCRIPTION, DELEGATE_CODE_INPUT_SCHEMA, DELEGATE_CODE_TOOL_NAME, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_RESEARCH_DESCRIPTION, DELEGATE_RESEARCH_INPUT_SCHEMA, DELEGATE_RESEARCH_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DelegateCodeArgs, DelegateCodeResult, DelegateFeedbackArgs, DelegateFeedbackResult, DelegateResearchArgs, DelegateResearchResult, DelegateUiAuditArgs, DelegateUiAuditResult, DelegationExecutor, DelegationHistoryArgs, DelegationHistoryResult, DelegationStatusArgs, DelegationStatusResult, DelegationTaskQueue, type DetectExecutorArgs, type DiffOptions, type DiffResult, FeedbackStore, FleetHandle, type GitRunner, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, LocalHarness, type RemoveWorktreeOptions, ResearchSource, ResearcherDelegate, UiAuditorDelegate, type WorktreeHandle, captureWorktreeDiff, createDelegateCodeHandler, createDelegateFeedbackHandler, createDelegateResearchHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createInProcessExecutor, createWorktree, defaultChecks, detectExecutor, liftFindings, makeCheckRunner, removeWorktree, renderTrace, runCheck, runLocalHarness, validateDelegateCodeArgs, validateDelegateFeedbackArgs, validateDelegateResearchArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };