@tangle-network/agent-runtime 0.22.0 → 0.23.0

package/README.md

@@ -213,6 +213,33 @@ Or run the ready-made bin:
 TANGLE_API_KEY=sk_sandbox_... agent-runtime-mcp
 ```
 
+### Surfacing the tools through `createOpenAICompatibleBackend`
+
+Sandbox callers discover MCP tools through the runtime mount. Callers that
+route through the OpenAI-compat backend (tcloud, OpenRouter, cli-bridge,
+OpenAI direct) must hand the model an explicit `tools[]` array — the
+backend does not auto-discover. `mcpToolsForRuntimeMcp()` returns the
+canonical projection so the model can call any of the 5 delegation tools
+through the OpenAI-compat path:
+
+```ts
+import {
+  createOpenAICompatibleBackend,
+  mcpToolsForRuntimeMcp,
+} from '@tangle-network/agent-runtime'
+
+const backend = createOpenAICompatibleBackend({
+  apiKey,
+  baseUrl,
+  model,
+  tools: mcpToolsForRuntimeMcp(),
+})
+```
+
+Use `mcpToolsForRuntimeMcpSubset(['delegate_research', 'delegation_status'])`
+when you want a curated subset (e.g. read-only research without the coder
+queue).
+
 The bin auto-wires the coder delegate and, when
 `@tangle-network/agent-knowledge` is installed as a peer, the researcher
 delegate. Environment knobs:

package/dist/chunk-7HN72MF3.js

@@ -0,0 +1,200 @@
+import {
+  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,
+  DELEGATION_HISTORY_DESCRIPTION,
+  DELEGATION_HISTORY_INPUT_SCHEMA,
+  DELEGATION_HISTORY_TOOL_NAME,
+  DELEGATION_STATUS_DESCRIPTION,
+  DELEGATION_STATUS_INPUT_SCHEMA,
+  DELEGATION_STATUS_TOOL_NAME
+} from "./chunk-UNQM6XQO.js";
+
+// src/mcp/openai-tools.ts
+function buildTool(name, description, parameters) {
+  return {
+    type: "function",
+    function: { name, description, parameters: { ...parameters } }
+  };
+}
+function mcpToolsForRuntimeMcp() {
+  return [
+    buildTool(
+      DELEGATE_CODE_TOOL_NAME,
+      DELEGATE_CODE_DESCRIPTION,
+      DELEGATE_CODE_INPUT_SCHEMA
+    ),
+    buildTool(
+      DELEGATE_RESEARCH_TOOL_NAME,
+      DELEGATE_RESEARCH_DESCRIPTION,
+      DELEGATE_RESEARCH_INPUT_SCHEMA
+    ),
+    buildTool(
+      DELEGATE_FEEDBACK_TOOL_NAME,
+      DELEGATE_FEEDBACK_DESCRIPTION,
+      DELEGATE_FEEDBACK_INPUT_SCHEMA
+    ),
+    buildTool(
+      DELEGATION_STATUS_TOOL_NAME,
+      DELEGATION_STATUS_DESCRIPTION,
+      DELEGATION_STATUS_INPUT_SCHEMA
+    ),
+    buildTool(
+      DELEGATION_HISTORY_TOOL_NAME,
+      DELEGATION_HISTORY_DESCRIPTION,
+      DELEGATION_HISTORY_INPUT_SCHEMA
+    )
+  ];
+}
+function mcpToolsForRuntimeMcpSubset(names) {
+  const allowed = new Set(names);
+  return mcpToolsForRuntimeMcp().filter((tool) => allowed.has(tool.function.name));
+}
+
+// src/otel-export.ts
+var SCOPE = { name: "@tangle-network/agent-runtime", version: "0.23.0" };
+function createOtelExporter(config) {
+  const resolvedEndpoint = config?.endpoint ?? (typeof process !== "undefined" ? process.env.OTEL_EXPORTER_OTLP_ENDPOINT : void 0);
+  if (!resolvedEndpoint) return void 0;
+  const endpoint = resolvedEndpoint;
+  const headers = config?.headers ?? parseHeadersFromEnv();
+  const batchSize = config?.batchSize ?? 64;
+  const flushIntervalMs = config?.flushIntervalMs ?? 5e3;
+  const serviceName = config?.serviceName ?? "agent-runtime";
+  const resourceAttrs = config?.resourceAttributes ?? {};
+  const pending = [];
+  let timer;
+  let stopped = false;
+  const exporter = {
+    exportSpan(span) {
+      if (stopped) return;
+      pending.push(span);
+      if (pending.length >= batchSize) {
+        void doFlush();
+      }
+    },
+    async flush() {
+      await doFlush();
+    },
+    async shutdown() {
+      stopped = true;
+      if (timer !== void 0) {
+        clearInterval(timer);
+        timer = void 0;
+      }
+      await doFlush();
+    }
+  };
+  timer = setInterval(() => {
+    if (pending.length > 0) void doFlush();
+  }, flushIntervalMs);
+  if (typeof timer === "object" && "unref" in timer) {
+    ;
+    timer.unref();
+  }
+  async function doFlush() {
+    if (pending.length === 0) return;
+    const batch = pending.splice(0);
+    const body = {
+      resourceSpans: [
+        {
+          resource: {
+            attributes: toAttributes({
+              "service.name": serviceName,
+              ...resourceAttrs
+            })
+          },
+          scopeSpans: [{ scope: SCOPE, spans: batch }]
+        }
+      ]
+    };
+    const url = endpoint.replace(/\/+$/, "") + "/v1/traces";
+    try {
+      await fetch(url, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...headers },
+        body: JSON.stringify(body)
+      });
+    } catch {
+    }
+  }
+  return exporter;
+}
+function loopEventToOtelSpan(event, traceId, parentSpanId) {
+  const spanId = generateSpanId();
+  const attrs = {
+    "loop.event_kind": event.kind,
+    "loop.run_id": event.runId
+  };
+  for (const [k, v] of Object.entries(event.payload)) {
+    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+      attrs[`loop.${k}`] = v;
+    }
+  }
+  const ts = msToNs(event.timestamp);
+  return {
+    traceId: padTraceId(traceId),
+    spanId,
+    parentSpanId: parentSpanId ? padSpanId(parentSpanId) : void 0,
+    name: event.kind,
+    kind: 1,
+    startTimeUnixNano: ts,
+    endTimeUnixNano: ts,
+    attributes: toAttributes(attrs),
+    status: { code: 1 }
+  };
+}
+function parseHeadersFromEnv() {
+  if (typeof process === "undefined") return {};
+  const raw = process.env.OTEL_EXPORTER_OTLP_HEADERS;
+  if (!raw) return {};
+  const out = {};
+  for (const pair of raw.split(",")) {
+    const eq = pair.indexOf("=");
+    if (eq < 0) continue;
+    const key = pair.slice(0, eq).trim();
+    const value = pair.slice(eq + 1).trim();
+    if (key) out[key] = value;
+  }
+  return out;
+}
+function toAttributes(record) {
+  return Object.entries(record).map(([key, value]) => ({
+    key,
+    value: typeof value === "number" ? Number.isInteger(value) ? { intValue: value.toString() } : { doubleValue: value } : typeof value === "boolean" ? { boolValue: value } : { stringValue: value }
+  }));
+}
+function msToNs(ms) {
+  return (BigInt(Math.floor(ms)) * 1000000n).toString();
+}
+function padSpanId(id) {
+  const cleaned = id.replace(/-/g, "");
+  return cleaned.slice(0, 16).padEnd(16, "0");
+}
+function padTraceId(id) {
+  const cleaned = id.replace(/-/g, "");
+  return cleaned.slice(0, 32).padEnd(32, "0");
+}
+function generateSpanId() {
+  const bytes = new Uint8Array(8);
+  if (typeof globalThis.crypto?.getRandomValues === "function") {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < 8; i++) bytes[i] = Math.floor(Math.random() * 256);
+  }
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+export {
+  mcpToolsForRuntimeMcp,
+  mcpToolsForRuntimeMcpSubset,
+  createOtelExporter,
+  loopEventToOtelSpan
+};
+//# sourceMappingURL=chunk-7HN72MF3.js.map

package/dist/chunk-7HN72MF3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/openai-tools.ts","../src/otel-export.ts"],"sourcesContent":["/**\n * @experimental\n *\n * OpenAI Chat Completions `tools[]` projection of the 5 agent-runtime MCP\n * delegation tools.\n *\n * Use when configuring `createOpenAICompatibleBackend({ tools: ... })` so the\n * model can call `delegate_code`, `delegate_research`, `delegate_feedback`,\n * `delegation_status`, and `delegation_history` through the OpenAI-compat\n * transport (tcloud, OpenRouter, OpenAI direct, cli-bridge). The runtime\n * surfaces tool calls as `tool_call` stream events — execution is the\n * caller's responsibility (typically the parent sandbox runtime's MCP\n * mount).\n *\n * Sandbox-SDK callers do NOT need this helper: the sandbox runtime mounts\n * MCP servers natively and the in-sandbox harness discovers tools via the\n * runtime, not via an OpenAI tools array.\n *\n * Tool name + description + JSON-schema are pulled from the canonical\n * `DELEGATE_*` constants exported by `./tools/*` so the projection cannot\n * drift from the server's own validators.\n */\n\nimport type { OpenAIChatTool } from '../types'\nimport {\n  DELEGATE_CODE_DESCRIPTION,\n  DELEGATE_CODE_INPUT_SCHEMA,\n  DELEGATE_CODE_TOOL_NAME,\n} from './tools/delegate-code'\nimport {\n  DELEGATE_FEEDBACK_DESCRIPTION,\n  DELEGATE_FEEDBACK_INPUT_SCHEMA,\n  DELEGATE_FEEDBACK_TOOL_NAME,\n} from './tools/delegate-feedback'\nimport {\n  DELEGATE_RESEARCH_DESCRIPTION,\n  DELEGATE_RESEARCH_INPUT_SCHEMA,\n  DELEGATE_RESEARCH_TOOL_NAME,\n} from './tools/delegate-research'\nimport {\n  DELEGATION_HISTORY_DESCRIPTION,\n  DELEGATION_HISTORY_INPUT_SCHEMA,\n  DELEGATION_HISTORY_TOOL_NAME,\n} from './tools/delegation-history'\nimport {\n  DELEGATION_STATUS_DESCRIPTION,\n  DELEGATION_STATUS_INPUT_SCHEMA,\n  DELEGATION_STATUS_TOOL_NAME,\n} from './tools/delegation-status'\n\nfunction buildTool(\n  name: string,\n  description: string,\n  parameters: Readonly<Record<string, unknown>>,\n): OpenAIChatTool {\n  // `parameters` arrives as a deeply-readonly `as const` literal. The\n  // OpenAI-compat backend JSON-serializes the body so a shallow copy\n  // into a plain object is sufficient — and shields callers that mutate\n  // the returned descriptor from corrupting the source constant.\n  return {\n    type: 'function',\n    function: { name, description, parameters: { ...parameters } },\n  }\n}\n\n/**\n * @experimental\n *\n * Returns the 5 delegation tools projected into OpenAI Chat Completions\n * `tools[]` shape. The order is stable: `delegate_code`,\n * `delegate_research`, `delegate_feedback`, `delegation_status`,\n * `delegation_history`.\n */\nexport function mcpToolsForRuntimeMcp(): OpenAIChatTool[] {\n  return [\n    buildTool(\n      DELEGATE_CODE_TOOL_NAME,\n      DELEGATE_CODE_DESCRIPTION,\n      DELEGATE_CODE_INPUT_SCHEMA as Readonly<Record<string, unknown>>,\n    ),\n    buildTool(\n      DELEGATE_RESEARCH_TOOL_NAME,\n      DELEGATE_RESEARCH_DESCRIPTION,\n      DELEGATE_RESEARCH_INPUT_SCHEMA as Readonly<Record<string, unknown>>,\n    ),\n    buildTool(\n      DELEGATE_FEEDBACK_TOOL_NAME,\n      DELEGATE_FEEDBACK_DESCRIPTION,\n      DELEGATE_FEEDBACK_INPUT_SCHEMA as Readonly<Record<string, unknown>>,\n    ),\n    buildTool(\n      DELEGATION_STATUS_TOOL_NAME,\n      DELEGATION_STATUS_DESCRIPTION,\n      DELEGATION_STATUS_INPUT_SCHEMA as Readonly<Record<string, unknown>>,\n    ),\n    buildTool(\n      DELEGATION_HISTORY_TOOL_NAME,\n      DELEGATION_HISTORY_DESCRIPTION,\n      DELEGATION_HISTORY_INPUT_SCHEMA as Readonly<Record<string, unknown>>,\n    ),\n  ]\n}\n\n/**\n * @experimental\n *\n * Subset filter — return only the projected tools whose `function.name`\n * appears in `names`. Useful for curated mounts (e.g. only the queue-bound\n * delegation tools, omitting `delegate_feedback`). Unknown names are\n * silently ignored; pass an empty array to get an empty result.\n */\nexport function mcpToolsForRuntimeMcpSubset(names: ReadonlyArray<string>): OpenAIChatTool[] {\n  const allowed = new Set(names)\n  return mcpToolsForRuntimeMcp().filter((tool) => allowed.has(tool.function.name))\n}\n","/**\n * OTEL span exporter — streams LoopTraceEvents to an OTLP/HTTP collector.\n *\n * Reads OTEL_EXPORTER_OTLP_ENDPOINT + OTEL_EXPORTER_OTLP_HEADERS from env\n * when no explicit config is given. Keeps the runtime dep-free from\n * @opentelemetry/sdk-trace-base — minimal OTLP/JSON serializer.\n *\n * The exporter accepts both raw OtelSpan objects and LoopTraceEvents\n * (which get converted to OTLP spans automatically).\n */\n\nexport interface OtelExportConfig {\n  /** OTLP endpoint. Reads OTEL_EXPORTER_OTLP_ENDPOINT env by default. */\n  endpoint?: string\n  /** OTLP headers. Reads OTEL_EXPORTER_OTLP_HEADERS env by default. */\n  headers?: Record<string, string>\n  /** Batch size before flush. Default 64. */\n  batchSize?: number\n  /** Flush interval ms. Default 5000. */\n  flushIntervalMs?: number\n  /** Resource attributes stamped on every export. */\n  resourceAttributes?: Record<string, string | number | boolean>\n  /** Service name. Default 'agent-runtime'. */\n  serviceName?: string\n}\n\nexport interface OtelExporter {\n  /** Export a span. */\n  exportSpan(span: OtelSpan): void\n  /** Force flush pending spans. */\n  flush(): Promise<void>\n  /** Shutdown cleanly. */\n  shutdown(): Promise<void>\n}\n\nexport interface OtelSpan {\n  traceId: string\n  spanId: string\n  parentSpanId?: string\n  name: string\n  kind?: number\n  startTimeUnixNano: string\n  endTimeUnixNano: string\n  attributes?: OtelAttribute[]\n  status?: { code: number; message?: string }\n}\n\nexport interface OtelAttribute {\n  key: string\n  value: { stringValue?: string; intValue?: string; doubleValue?: number; boolValue?: boolean }\n}\n\ninterface OtlpResourceSpans {\n  resource: { attributes: OtelAttribute[] }\n  scopeSpans: Array<{ scope: { name: string; version: string }; spans: OtelSpan[] }>\n}\n\ninterface OtlpExport {\n  resourceSpans: OtlpResourceSpans[]\n}\n\nconst SCOPE = { name: '@tangle-network/agent-runtime', version: '0.23.0' }\n\n/**\n * Create an OTEL exporter. Returns undefined when no endpoint is configured.\n */\nexport function createOtelExporter(config?: OtelExportConfig): OtelExporter | undefined {\n  const resolvedEndpoint =\n    config?.endpoint ?? (typeof process !== 'undefined' ? process.env.OTEL_EXPORTER_OTLP_ENDPOINT : undefined)\n  if (!resolvedEndpoint) return undefined\n  const endpoint: string = resolvedEndpoint\n\n  const headers = config?.headers ?? parseHeadersFromEnv()\n  const batchSize = config?.batchSize ?? 64\n  const flushIntervalMs = config?.flushIntervalMs ?? 5000\n  const serviceName = config?.serviceName ?? 'agent-runtime'\n  const resourceAttrs = config?.resourceAttributes ?? {}\n\n  const pending: OtelSpan[] = []\n  let timer: ReturnType<typeof setInterval> | undefined\n  let stopped = false\n\n  const exporter: OtelExporter = {\n    exportSpan(span: OtelSpan): void {\n      if (stopped) return\n      pending.push(span)\n      if (pending.length >= batchSize) {\n        void doFlush()\n      }\n    },\n\n    async flush(): Promise<void> {\n      await doFlush()\n    },\n\n    async shutdown(): Promise<void> {\n      stopped = true\n      if (timer !== undefined) {\n        clearInterval(timer)\n        timer = undefined\n      }\n      await doFlush()\n    },\n  }\n\n  timer = setInterval(() => {\n    if (pending.length > 0) void doFlush()\n  }, flushIntervalMs)\n  if (typeof timer === 'object' && 'unref' in timer) {\n    ;(timer as NodeJS.Timeout).unref()\n  }\n\n  async function doFlush(): Promise<void> {\n    if (pending.length === 0) return\n    const batch = pending.splice(0)\n    const body: OtlpExport = {\n      resourceSpans: [\n        {\n          resource: {\n            attributes: toAttributes({\n              'service.name': serviceName,\n              ...resourceAttrs,\n            }),\n          },\n          scopeSpans: [{ scope: SCOPE, spans: batch }],\n        },\n      ],\n    }\n    const url = endpoint.replace(/\\/+$/, '') + '/v1/traces'\n    try {\n      await fetch(url, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json', ...headers },\n        body: JSON.stringify(body),\n      })\n    } catch {\n      // Best-effort — telemetry export must not crash the runtime.\n    }\n  }\n\n  return exporter\n}\n\n/**\n * Convert a LoopTraceEvent into an OtelSpan for export.\n */\nexport function loopEventToOtelSpan(\n  event: {\n    kind: string\n    runId: string\n    timestamp: number\n    payload: object\n  },\n  traceId: string,\n  parentSpanId?: string,\n): OtelSpan {\n  const spanId = generateSpanId()\n  const attrs: Record<string, string | number | boolean> = {\n    'loop.event_kind': event.kind,\n    'loop.run_id': event.runId,\n  }\n  for (const [k, v] of Object.entries(event.payload)) {\n    if (typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean') {\n      attrs[`loop.${k}`] = v\n    }\n  }\n  const ts = msToNs(event.timestamp)\n  return {\n    traceId: padTraceId(traceId),\n    spanId,\n    parentSpanId: parentSpanId ? padSpanId(parentSpanId) : undefined,\n    name: event.kind,\n    kind: 1,\n    startTimeUnixNano: ts,\n    endTimeUnixNano: ts,\n    attributes: toAttributes(attrs),\n    status: { code: 1 },\n  }\n}\n\nfunction parseHeadersFromEnv(): Record<string, string> {\n  if (typeof process === 'undefined') return {}\n  const raw = process.env.OTEL_EXPORTER_OTLP_HEADERS\n  if (!raw) return {}\n  const out: Record<string, string> = {}\n  for (const pair of raw.split(',')) {\n    const eq = pair.indexOf('=')\n    if (eq < 0) continue\n    const key = pair.slice(0, eq).trim()\n    const value = pair.slice(eq + 1).trim()\n    if (key) out[key] = value\n  }\n  return out\n}\n\nfunction toAttributes(record: Record<string, string | number | boolean>): OtelAttribute[] {\n  return Object.entries(record).map(([key, value]) => ({\n    key,\n    value:\n      typeof value === 'number'\n        ? Number.isInteger(value)\n          ? { intValue: value.toString() }\n          : { doubleValue: value }\n        : typeof value === 'boolean'\n          ? { boolValue: value }\n          : { stringValue: value },\n  }))\n}\n\nfunction msToNs(ms: number): string {\n  return (BigInt(Math.floor(ms)) * 1_000_000n).toString()\n}\n\nfunction padSpanId(id: string): string {\n  const cleaned = id.replace(/-/g, '')\n  return cleaned.slice(0, 16).padEnd(16, '0')\n}\n\nfunction padTraceId(id: string): string {\n  const cleaned = id.replace(/-/g, '')\n  return cleaned.slice(0, 32).padEnd(32, '0')\n}\n\nfunction generateSpanId(): string {\n  const bytes = new Uint8Array(8)\n  if (typeof globalThis.crypto?.getRandomValues === 'function') {\n    globalThis.crypto.getRandomValues(bytes)\n  } else {\n    for (let i = 0; i < 8; i++) bytes[i] = Math.floor(Math.random() * 256)\n  }\n  return Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join('')\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-IQHYOJU3.js

@@ -0,0 +1,427 @@
+import {
+  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,
+  DELEGATION_HISTORY_DESCRIPTION,
+  DELEGATION_HISTORY_INPUT_SCHEMA,
+  DELEGATION_HISTORY_TOOL_NAME,
+  DELEGATION_STATUS_DESCRIPTION,
+  DELEGATION_STATUS_INPUT_SCHEMA,
+  DELEGATION_STATUS_TOOL_NAME,
+  DelegationTaskQueue,
+  InMemoryFeedbackStore,
+  createDelegateCodeHandler,
+  createDelegateFeedbackHandler,
+  createDelegateResearchHandler,
+  createDelegationHistoryHandler,
+  createDelegationStatusHandler
+} from "./chunk-UNQM6XQO.js";
+import {
+  runLoop
+} from "./chunk-TZ53F7M7.js";
+import {
+  coderProfile,
+  multiHarnessCoderFanout
+} from "./chunk-CBQVID7G.js";
+
+// src/mcp/executor.ts
+function createSiblingSandboxExecutor(options) {
+  const underlying = options.client;
+  const client = {
+    create(opts) {
+      return underlying.create(opts);
+    },
+    describePlacement(box) {
+      return { kind: "sibling", sandboxId: readId(box) };
+    }
+  };
+  return {
+    client,
+    describe() {
+      return "sibling-sandbox (each delegation = fresh sandbox via client.create)";
+    }
+  };
+}
+function createFleetWorkspaceExecutor(options) {
+  const fleet = options.fleet;
+  const exclude = new Set(options.excludeMachineIds ?? []);
+  let callIndex = 0;
+  const placementBySandboxId = /* @__PURE__ */ new Map();
+  const client = {
+    async create() {
+      const ids = fleet.ids.filter((id) => !exclude.has(id));
+      if (ids.length === 0) {
+        throw new Error(
+          `agent-runtime: fleet ${fleet.fleetId} has no eligible worker machines (ids=[${fleet.ids.join(",")}], excluded=[${[...exclude].join(",")}])`
+        );
+      }
+      const selector = options.selectMachine;
+      const machineId = selector ? selector({ callIndex, ids }) : ids[callIndex % ids.length];
+      callIndex += 1;
+      if (typeof machineId !== "string" || machineId.length === 0) {
+        throw new Error("agent-runtime: fleet executor selectMachine returned an empty machine id");
+      }
+      const box = await fleet.sandbox(machineId);
+      const sandboxId = readId(box);
+      if (sandboxId) placementBySandboxId.set(sandboxId, { machineId });
+      return box;
+    },
+    describePlacement(box) {
+      const sandboxId = readId(box);
+      const recorded = sandboxId ? placementBySandboxId.get(sandboxId) : void 0;
+      return {
+        kind: "fleet",
+        sandboxId,
+        fleetId: fleet.fleetId,
+        machineId: recorded?.machineId
+      };
+    }
+  };
+  return {
+    client,
+    describe() {
+      const excluded = exclude.size > 0 ? ` (excluded=[${[...exclude].join(",")}])` : "";
+      return `fleet-workspace (fleetId=${fleet.fleetId}, machines=[${fleet.ids.join(",")}]${excluded})`;
+    }
+  };
+}
+function readId(box) {
+  const raw = box.id;
+  return typeof raw === "string" && raw.length > 0 ? raw : void 0;
+}
+
+// src/mcp/bin-helpers.ts
+async function detectExecutor(args) {
+  const env = args.env ?? process.env;
+  const fleetId = parseFleetId(env.TANGLE_FLEET_ID);
+  if (!fleetId) {
+    return createSiblingSandboxExecutor({ client: args.sandboxClient });
+  }
+  const resolveFleet = args.resolveFleet ?? defaultResolveFleet;
+  const fleet = await resolveFleet(args.sandboxClient, fleetId);
+  const excludeMachineIds = parseList(env.TANGLE_FLEET_EXCLUDE_MACHINES);
+  return createFleetWorkspaceExecutor({
+    fleet,
+    excludeMachineIds
+  });
+}
+async function defaultResolveFleet(sandboxClient, fleetId) {
+  const fleets = sandboxClient.fleets;
+  if (!fleets || typeof fleets.get !== "function") {
+    throw new Error(
+      "agent-runtime-mcp: the configured sandbox client does not expose `.fleets.get`; upgrade @tangle-network/sandbox to >= 0.2.1 or unset TANGLE_FLEET_ID."
+    );
+  }
+  const raw = await fleets.get(fleetId);
+  if (!raw || typeof raw !== "object") {
+    throw new Error(`agent-runtime-mcp: fleets.get(${fleetId}) returned no handle`);
+  }
+  const handle = raw;
+  if (typeof handle.fleetId !== "string" || !Array.isArray(handle.ids)) {
+    throw new Error(
+      `agent-runtime-mcp: fleet handle for ${fleetId} is missing fleetId/ids \u2014 incompatible sandbox SDK shape`
+    );
+  }
+  if (typeof handle.sandbox !== "function") {
+    throw new Error(
+      `agent-runtime-mcp: fleet handle for ${fleetId} is missing sandbox(machineId) \u2014 incompatible sandbox SDK shape`
+    );
+  }
+  return handle;
+}
+function parseFleetId(raw) {
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function parseList(raw) {
+  if (!raw) return void 0;
+  const list = raw.split(",").map((entry) => entry.trim()).filter(Boolean);
+  return list.length > 0 ? list : void 0;
+}
+
+// src/mcp/delegates.ts
+function createDefaultCoderDelegate(options) {
+  const executor = resolveExecutor(options);
+  const sandboxClient = executor.client;
+  const fanoutHarnesses = options.fanoutHarnesses;
+  const maxConcurrency = options.maxConcurrency ?? 4;
+  return async (args, ctx) => {
+    const task = {
+      goal: buildCoderGoal(args),
+      repoRoot: args.repoRoot,
+      testCmd: args.config?.testCmd,
+      typecheckCmd: args.config?.typecheckCmd,
+      forbiddenPaths: args.config?.forbiddenPaths,
+      maxDiffLines: args.config?.maxDiffLines
+    };
+    const variants = Math.max(1, Math.trunc(args.variants ?? 1));
+    ctx.report({ iteration: 0, phase: "starting" });
+    if (variants <= 1) {
+      const { agentRunSpec, output, validator } = coderProfile({ task });
+      const result2 = await runLoop({
+        driver: singleShotDriver,
+        agentRun: agentRunSpec,
+        output,
+        validator,
+        task,
+        ctx: { sandboxClient, signal: ctx.signal },
+        maxIterations: 1,
+        maxConcurrency
+      });
+      const winner2 = result2.winner;
+      if (!winner2) {
+        throw new Error("coder delegate produced no winner");
+      }
+      ctx.report({ iteration: 1, phase: "completed" });
+      return winner2.output;
+    }
+    const fanout = multiHarnessCoderFanout(
+      fanoutHarnesses && fanoutHarnesses.length > 0 ? { harnesses: fanoutHarnesses.slice(0, variants) } : { harnesses: void 0 }
+    );
+    const agentRuns = fanout.agentRuns.slice(0, variants);
+    const result = await runLoop({
+      driver: fanout.driver,
+      agentRuns,
+      output: fanout.output,
+      validator: fanout.validator,
+      task,
+      ctx: { sandboxClient, signal: ctx.signal },
+      maxIterations: variants,
+      maxConcurrency: Math.min(maxConcurrency, variants)
+    });
+    const winner = result.winner;
+    if (!winner) {
+      throw new Error("coder delegate fanout produced no winner");
+    }
+    ctx.report({ iteration: agentRuns.length, phase: "completed" });
+    return winner.output;
+  };
+}
+function buildCoderGoal(args) {
+  if (!args.contextHint) return args.goal;
+  return [args.goal, "", "## Context", args.contextHint].join("\n");
+}
+function resolveExecutor(options) {
+  if (options.executor && options.sandboxClient) {
+    throw new Error("createDefaultCoderDelegate: pass exactly one of `executor` or `sandboxClient`");
+  }
+  if (options.executor) return options.executor;
+  if (options.sandboxClient) {
+    return createSiblingSandboxExecutor({ client: options.sandboxClient });
+  }
+  throw new Error("createDefaultCoderDelegate: `executor` or `sandboxClient` is required");
+}
+var singleShotDriver = {
+  name: "mcp-single-shot",
+  async plan(task, history) {
+    return history.length === 0 ? [task] : [];
+  },
+  decide(history) {
+    return history.length > 0 ? "pick-winner" : "fail";
+  }
+};
+
+// src/mcp/server.ts
+import { createInterface } from "readline";
+import { Readable, Writable } from "stream";
+var PROTOCOL_VERSION = "2024-11-05";
+var DEFAULT_SERVER_NAME = "agent-runtime-mcp";
+var DEFAULT_SERVER_VERSION = "0.22.0";
+function createMcpServer(options = {}) {
+  const queue = options.queue ?? new DelegationTaskQueue();
+  const feedbackStore = options.feedbackStore ?? new InMemoryFeedbackStore();
+  const serverName = options.serverName ?? DEFAULT_SERVER_NAME;
+  const serverVersion = options.serverVersion ?? DEFAULT_SERVER_VERSION;
+  const tools = /* @__PURE__ */ new Map();
+  if (options.coderDelegate) {
+    tools.set(DELEGATE_CODE_TOOL_NAME, {
+      name: DELEGATE_CODE_TOOL_NAME,
+      description: DELEGATE_CODE_DESCRIPTION,
+      inputSchema: DELEGATE_CODE_INPUT_SCHEMA,
+      handler: createDelegateCodeHandler({ queue, delegate: options.coderDelegate })
+    });
+  }
+  if (options.researcherDelegate) {
+    tools.set(DELEGATE_RESEARCH_TOOL_NAME, {
+      name: DELEGATE_RESEARCH_TOOL_NAME,
+      description: DELEGATE_RESEARCH_DESCRIPTION,
+      inputSchema: DELEGATE_RESEARCH_INPUT_SCHEMA,
+      handler: createDelegateResearchHandler({ queue, delegate: options.researcherDelegate })
+    });
+  }
+  tools.set(DELEGATE_FEEDBACK_TOOL_NAME, {
+    name: DELEGATE_FEEDBACK_TOOL_NAME,
+    description: DELEGATE_FEEDBACK_DESCRIPTION,
+    inputSchema: DELEGATE_FEEDBACK_INPUT_SCHEMA,
+    handler: createDelegateFeedbackHandler({ queue, store: feedbackStore })
+  });
+  tools.set(DELEGATION_STATUS_TOOL_NAME, {
+    name: DELEGATION_STATUS_TOOL_NAME,
+    description: DELEGATION_STATUS_DESCRIPTION,
+    inputSchema: DELEGATION_STATUS_INPUT_SCHEMA,
+    handler: createDelegationStatusHandler({ queue })
+  });
+  tools.set(DELEGATION_HISTORY_TOOL_NAME, {
+    name: DELEGATION_HISTORY_TOOL_NAME,
+    description: DELEGATION_HISTORY_DESCRIPTION,
+    inputSchema: DELEGATION_HISTORY_INPUT_SCHEMA,
+    handler: createDelegationHistoryHandler({ queue })
+  });
+  let stopped = false;
+  let activeReadline;
+  async function handle(message) {
+    if (stopped) {
+      return rpcError(message.id ?? null, -32099, "server stopped");
+    }
+    if (message.method === "initialize") {
+      return rpcResult(message.id ?? null, {
+        protocolVersion: PROTOCOL_VERSION,
+        capabilities: { tools: {} },
+        serverInfo: { name: serverName, version: serverVersion }
+      });
+    }
+    if (message.method === "notifications/initialized") {
+      return null;
+    }
+    if (message.method === "tools/list") {
+      return rpcResult(message.id ?? null, {
+        tools: [...tools.values()].map((tool) => ({
+          name: tool.name,
+          description: tool.description,
+          inputSchema: tool.inputSchema
+        }))
+      });
+    }
+    if (message.method === "tools/call") {
+      const params = message.params ?? {};
+      const name = typeof params.name === "string" ? params.name : "";
+      const tool = tools.get(name);
+      if (!tool) {
+        return rpcError(message.id ?? null, -32601, `unknown tool: ${name}`);
+      }
+      try {
+        const output = await tool.handler(params.arguments ?? {});
+        return rpcResult(message.id ?? null, {
+          content: [{ type: "text", text: JSON.stringify(output) }],
+          structuredContent: output,
+          isError: false
+        });
+      } catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        const code = err instanceof TypeError || err instanceof RangeError ? -32602 : -32e3;
+        return rpcError(message.id ?? null, code, reason);
+      }
+    }
+    if (message.id === void 0 || message.id === null) return null;
+    return rpcError(message.id, -32601, `unknown method: ${message.method}`);
+  }
+  async function serve(transport) {
+    const input = transport?.input ?? process.stdin;
+    const output = transport?.output ?? process.stdout;
+    const rl = createInterface({ input, crlfDelay: Number.POSITIVE_INFINITY });
+    activeReadline = rl;
+    return new Promise((resolve, reject) => {
+      rl.on("line", (line) => {
+        const trimmed = line.trim();
+        if (!trimmed) return;
+        let parsed;
+        try {
+          parsed = JSON.parse(trimmed);
+        } catch (err) {
+          writeResponse(output, rpcError(null, -32700, `parse error: ${err.message}`));
+          return;
+        }
+        if (!parsed || parsed.jsonrpc !== "2.0" || typeof parsed.method !== "string") {
+          writeResponse(output, rpcError(parsed?.id ?? null, -32600, "invalid request"));
+          return;
+        }
+        void handle(parsed).then((response) => {
+          if (response) writeResponse(output, response);
+        });
+      });
+      rl.on("close", () => resolve());
+      rl.on("error", (err) => reject(err));
+      if (stopped) {
+        rl.close();
+        resolve();
+      }
+    });
+  }
+  function stop() {
+    stopped = true;
+    activeReadline?.close();
+    activeReadline = void 0;
+  }
+  return {
+    tools,
+    queue,
+    feedbackStore,
+    handle,
+    serve,
+    stop
+  };
+}
+function rpcResult(id, result) {
+  return { jsonrpc: "2.0", id, result };
+}
+function rpcError(id, code, message, data) {
+  return {
+    jsonrpc: "2.0",
+    id,
+    error: data === void 0 ? { code, message } : { code, message, data }
+  };
+}
+function writeResponse(output, response) {
+  output.write(`${JSON.stringify(response)}
+`);
+}
+function createInProcessTransport() {
+  const responses = [];
+  const input = new Readable({ read() {
+  } });
+  const output = new Writable({
+    write(chunk, _enc, cb) {
+      const text = chunk.toString("utf8");
+      for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed) continue;
+        try {
+          responses.push(JSON.parse(trimmed));
+        } catch {
+        }
+      }
+      cb();
+    }
+  });
+  return {
+    transport: { input, output },
+    clientWrite(line) {
+      input.push(`${line}
+`);
+    },
+    clientClose() {
+      input.push(null);
+    },
+    async readServer() {
+      for (let i = 0; i < 5; i += 1) await new Promise((r) => setImmediate(r));
+      return [...responses];
+    }
+  };
+}
+
+export {
+  createSiblingSandboxExecutor,
+  createFleetWorkspaceExecutor,
+  detectExecutor,
+  createDefaultCoderDelegate,
+  createMcpServer,
+  createInProcessTransport
+};
+//# sourceMappingURL=chunk-IQHYOJU3.js.map