@tangle-network/agent-runtime 0.70.1 → 0.71.0

package/dist/agent.d.ts

@@ -1,6 +1,6 @@
 import * as _tangle_network_agent_eval from '@tangle-network/agent-eval';
 import { TraceAnalystKindSpec, AnalystFinding } from '@tangle-network/agent-eval';
-import { R as RuntimeStreamEvent, S as SandboxClient, a as OutputAdapter, A as AgentRunSpec } from './types-BYa2ZOAx.js';
+import { R as RuntimeStreamEvent, S as SandboxClient, a as OutputAdapter, A as AgentRunSpec } from './types-CdnEAE3U.js';
 import { A as AgentSurfaces } from './improvement-adapter-CioiEE2z.js';
 export { C as CreateSurfaceImprovementAdapterOpts, D as DraftPatchInput, a as DraftPatchOutput, R as ResolvedSurface, S as SurfaceImprovementEdit, b as SurfaceValidationIssue, c as createSurfaceImprovementAdapter, r as renderSurfaceIssues, d as resolveSubjectPath, v as validateSurfaces } from './improvement-adapter-CioiEE2z.js';
 import { K as KnowledgeAdapter, a as RunAnalystLoopResult } from './types-BC3bZpH0.js';

package/dist/agent.js

@@ -3,8 +3,8 @@ import {
 } from "./chunk-XRYEZPR6.js";
 import {
   createSandboxForSpec
-} from "./chunk-YFOPWG74.js";
-import "./chunk-G3RGMA7C.js";
+} from "./chunk-5ISW5JUF.js";
+import "./chunk-VMNEQHJR.js";
 import {
   mapSandboxEvent
 } from "./chunk-VLF5RHEQ.js";

package/dist/analyst-loop.d.ts

@@ -1,5 +1,5 @@
 import { TraceAnalystByteBudgets, TraceAnalysisStore } from '@tangle-network/agent-eval';
-import { I as Iteration } from './types-BYa2ZOAx.js';
+import { I as Iteration } from './types-CdnEAE3U.js';
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-BC3bZpH0.js';
 export { A as AnalystLoopEvent, b as AnalystRegistryLike, c as AnalystRegistryStreamingLike, d as AutoApplyPolicy, F as FindingsStoreLike, I as ImprovementAdapter, e as ImprovementEditBatch, f as ImprovementReport, K as KnowledgeAdapter, g as KnowledgeProposalBatch, h as KnowledgeReport } from './types-BC3bZpH0.js';
 import '@tangle-network/sandbox';

package/dist/{chunk-CRAH5EY2.js → chunk-4KGQHS7U.js}

@@ -14,7 +14,7 @@ import {
   DELEGATION_STATUS_DESCRIPTION,
   DELEGATION_STATUS_INPUT_SCHEMA,
   DELEGATION_STATUS_TOOL_NAME
-} from "./chunk-YFOPWG74.js";
+} from "./chunk-5ISW5JUF.js";
 
 // src/mcp/openai-tools.ts
 function buildTool(name, description, parameters) {
@@ -61,4 +61,4 @@ export {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
 };
-//# sourceMappingURL=chunk-CRAH5EY2.js.map
+//# sourceMappingURL=chunk-4KGQHS7U.js.map

package/dist/{chunk-YFOPWG74.js → chunk-5ISW5JUF.js}

@@ -1,6 +1,6 @@
 import {
   buildLoopSpanNodes
-} from "./chunk-G3RGMA7C.js";
+} from "./chunk-VMNEQHJR.js";
 import {
   AgentEvalError,
   AnalystError,
@@ -4641,19 +4641,19 @@ function createSupervisor() {
           ...isNonEmptySpend(driverInference) ? { spentBreakdown: { driverInference, childWork } } : {}
         };
       }
+      return noWinner();
+    }
+    return noWinner();
+    async function noWinner() {
+      const { childWork, driverInference } = await spentFromJournal(journal, opts.runId);
       return {
         kind: "no-winner",
         reason: classifyNoWinner(controller, pool2, opts, breaker),
         tree,
-        downCount: breaker.downCount()
+        downCount: breaker.downCount(),
+        spentTotal: addSpend(childWork, driverInference)
       };
     }
-    return {
-      kind: "no-winner",
-      reason: classifyNoWinner(controller, pool2, opts, breaker),
-      tree,
-      downCount: breaker.downCount()
-    };
   }
   function attach(h) {
     const control = rootControls.get(h);
@@ -8359,6 +8359,253 @@ function canonicalize(value) {
   return out;
 }
 
+// src/runtime/supervise/model-policy.ts
+function assertModelAllowed(model, allowed) {
+  if (!allowed || model === void 0) return;
+  if (!allowed.includes(model)) {
+    throw new ConfigError(
+      `model ${JSON.stringify(model)} is not in the allowed set ${JSON.stringify([...allowed])}`
+    );
+  }
+}
+
+// src/runtime/supervise/run-context.ts
+function createInMemoryRunContext(opts = {}) {
+  const base = createExecutorRegistry();
+  return {
+    journal: new InMemorySpawnJournal(),
+    blobs: new InMemoryResultBlobStore(),
+    executors: opts.withDriver ? withDriverExecutor(base) : base
+  };
+}
+
+// src/runtime/supervise/supervisor-agent.ts
+function supervisorAgent(profile, deps) {
+  const name = profile.name ?? "supervisor";
+  const systemPrompt = profile.systemPrompt ?? "";
+  const harness = profile.harness ?? null;
+  if (harness === null) {
+    const brain = deps.brain ?? routerBrainFromProfile(profile, deps);
+    return driverAgent({
+      name,
+      brain,
+      blobs: deps.blobs,
+      makeWorkerAgent: deps.makeWorkerAgent,
+      perWorker: deps.perWorker,
+      systemPrompt,
+      ...deps.extraTools ? { extraTools: deps.extraTools } : {},
+      ...deps.executeExtraTool ? { executeExtraTool: deps.executeExtraTool } : {},
+      ...deps.maxTurns !== void 0 ? { maxTurns: deps.maxTurns } : {}
+    });
+  }
+  const driveHarness = deps.driveHarness;
+  if (!driveHarness) {
+    throw new ValidationError(
+      `supervisorAgent: profile.harness="${harness}" needs deps.driveHarness (how to run the harness with the coordination MCP mounted)`
+    );
+  }
+  return {
+    name,
+    async act(task, scope) {
+      const mcp = await serveCoordinationMcp({
+        scope,
+        blobs: deps.blobs,
+        makeWorkerAgent: deps.makeWorkerAgent,
+        perWorker: deps.perWorker
+      });
+      try {
+        await driveHarness({ profile, task, scope, coordinationMcpUrl: mcp.url });
+        return await finalizeBestDelivered(mcp.settled(), deps.blobs);
+      } finally {
+        await mcp.close();
+      }
+    }
+  };
+}
+function routerBrainFromProfile(profile, deps) {
+  if (!deps.router) {
+    throw new ValidationError(
+      "supervisorAgent: a router-brained supervisor (harness null) needs deps.router (or deps.brain)"
+    );
+  }
+  return routerBrain({ ...deps.router, model: profile.model ?? deps.router.model });
+}
+
+// src/runtime/supervise/supervise.ts
+function workerFromBackend(backend, deliverable) {
+  return (rawProfile) => {
+    const p = rawProfile ?? {};
+    const name = typeof p.name === "string" && p.name.length > 0 ? p.name : "worker";
+    const spec = { profile: rawProfile, harness: null };
+    const ctx = { signal: new AbortController().signal, seams: {} };
+    const built = createExecutor(backend)(spec, ctx);
+    const executor = deliverable ? gateOnDeliverable(built, deliverable) : built;
+    return { name, act: async () => "", executorSpec: { ...spec, executor } };
+  };
+}
+function defaultPerWorker(budget) {
+  return {
+    maxIterations: budget.maxIterations,
+    maxTokens: Math.max(1, Math.floor(budget.maxTokens / 4))
+  };
+}
+function supervise(profile, task, opts) {
+  const backendModel = opts.backend?.model;
+  assertModelAllowed(opts.router?.model, opts.allowedModels);
+  assertModelAllowed(profile.model, opts.allowedModels);
+  assertModelAllowed(
+    typeof backendModel === "string" ? backendModel : void 0,
+    opts.allowedModels
+  );
+  const ctx = createInMemoryRunContext({ withDriver: true });
+  const blobs = opts.blobs ?? ctx.blobs;
+  const perWorker = opts.perWorker ?? defaultPerWorker(opts.budget);
+  let makeWorkerAgent = opts.makeWorkerAgent;
+  if (!makeWorkerAgent) {
+    if (!opts.backend) {
+      throw new ValidationError(
+        "supervise: provide opts.backend (where workers run) or opts.makeWorkerAgent"
+      );
+    }
+    makeWorkerAgent = workerFromBackend(opts.backend, opts.deliverable);
+  }
+  const agent = supervisorAgent(profile, {
+    blobs,
+    makeWorkerAgent,
+    perWorker,
+    ...opts.router ? { router: opts.router } : {},
+    ...opts.brain ? { brain: opts.brain } : {},
+    ...opts.driveHarness ? { driveHarness: opts.driveHarness } : {},
+    ...opts.extraTools ? { extraTools: opts.extraTools } : {},
+    ...opts.executeExtraTool ? { executeExtraTool: opts.executeExtraTool } : {},
+    ...opts.maxTurns !== void 0 ? { maxTurns: opts.maxTurns } : {}
+  });
+  return createSupervisor().run(agent, task, {
+    budget: opts.budget,
+    runId: opts.runId ?? "supervise",
+    journal: ctx.journal,
+    blobs,
+    executors: ctx.executors,
+    maxDepth: opts.maxDepth ?? 8,
+    ...opts.now ? { now: opts.now } : {}
+  });
+}
+
+// src/runtime/supervise/delegate.ts
+var defaultDelegateBudget = { maxIterations: 50, maxTokens: 2e5 };
+function authoringSupervisorProfile(model, override) {
+  return {
+    name: override?.name ?? "delegate-supervisor",
+    harness: null,
+    ...model ? { model } : {},
+    systemPrompt: override?.systemPrompt ?? supervisorInstructions()
+  };
+}
+async function delegate(intent, opts = {}) {
+  if (typeof intent !== "string" || intent.trim().length === 0) {
+    throw new ConfigError("delegate: `intent` must be a non-empty string");
+  }
+  if (!opts.brain && !opts.router) {
+    throw new ConfigError(
+      "delegate: provide opts.router (the supervisor brain substrate) or opts.brain (tests)"
+    );
+  }
+  const profile = authoringSupervisorProfile(opts.model, opts.supervisor);
+  return supervise(profile, intent, {
+    budget: opts.budget ?? defaultDelegateBudget,
+    ...opts.backend ? { backend: opts.backend } : {},
+    ...opts.deliverable ? { deliverable: opts.deliverable } : {},
+    ...opts.router ? { router: opts.router } : {},
+    ...opts.brain ? { brain: opts.brain } : {},
+    ...opts.allowedModels ? { allowedModels: opts.allowedModels } : {},
+    ...opts.runId ? { runId: opts.runId } : {}
+  });
+}
+
+// src/mcp/tools/delegate.ts
+var DELEGATE_TOOL_NAME = "delegate";
+var DELEGATE_DESCRIPTION = [
+  "Delegate an INTENT to a supervisor that AUTHORS and drives whatever worker the intent needs.",
+  "",
+  'Use when: you want a task done but do not want to specify HOW. State the outcome \u2014 "fix the',
+  'failing auth test", "research competitor pricing with citations", "refactor the parser for',
+  'clarity" \u2014 and the supervisor decomposes it, writes a tailored worker profile per sub-task, runs',
+  "the workers over a conserved compute budget, and settles only when a deployable check passes.",
+  "",
+  "There is no fixed worker type: this ONE verb replaces separate code / research delegation. The",
+  "supervisor picks the worker shape from your intent.",
+  "",
+  "Returns synchronously with the delivered result AND the real cost of the whole delegation",
+  "(spentTotal: iterations, input/output tokens, usd, ms) \u2014 so you always know what it spent. A run",
+  'that produced no delivered worker returns status "no-winner" with the reason; it never fabricates',
+  "a success."
+].join("\n");
+var DELEGATE_INPUT_SCHEMA = {
+  type: "object",
+  properties: {
+    intent: {
+      type: "string",
+      description: "What you want accomplished, as an outcome. The supervisor authors the worker."
+    },
+    model: {
+      type: "string",
+      description: "Optional per-call override for the supervisor brain model."
+    },
+    runId: {
+      type: "string",
+      description: "Optional trace-correlation id for this delegation."
+    }
+  },
+  required: ["intent"],
+  additionalProperties: false
+};
+function validateDelegateArgs(raw) {
+  if (raw === null || typeof raw !== "object") {
+    throw new TypeError("delegate: arguments must be an object");
+  }
+  const value = raw;
+  const intent = value.intent;
+  if (typeof intent !== "string" || intent.trim().length === 0) {
+    throw new TypeError("delegate: `intent` must be a non-empty string");
+  }
+  const args = { intent: intent.trim() };
+  if (value.model !== void 0) {
+    if (typeof value.model !== "string") throw new TypeError("delegate: `model` must be a string");
+    args.model = value.model;
+  }
+  if (value.runId !== void 0) {
+    if (typeof value.runId !== "string") throw new TypeError("delegate: `runId` must be a string");
+    args.runId = value.runId;
+  }
+  return args;
+}
+function toDelegateResult(result) {
+  if (result.kind === "no-winner") {
+    return { status: "no-winner", reason: result.reason, spentTotal: result.spentTotal };
+  }
+  return {
+    status: "winner",
+    out: result.out,
+    outRef: result.outRef,
+    spentTotal: result.spentTotal
+  };
+}
+function createDelegateHandler(options) {
+  return async (raw) => {
+    const args = validateDelegateArgs(raw);
+    const opts = {
+      backend: options.backend,
+      router: options.router,
+      model: args.model ?? options.model,
+      ...options.deliverable ? { deliverable: options.deliverable } : {},
+      ...options.allowedModels ? { allowedModels: options.allowedModels } : {},
+      ...args.runId ? { runId: args.runId } : {}
+    };
+    const result = await delegate(args.intent, opts);
+    return toDelegateResult(result);
+  };
+}
+
 // src/mcp/detached-turn.ts
 var DEFAULT_TICK_INTERVAL_MS = 5e3;
 function formatDetachedSessionRef(parts) {
@@ -9513,6 +9760,14 @@ function createMcpServer(options = {}) {
   const serverName = options.serverName ?? DEFAULT_SERVER_NAME;
   const serverVersion = options.serverVersion ?? DEFAULT_SERVER_VERSION;
   const tools = /* @__PURE__ */ new Map();
+  if (options.delegateSupervisor) {
+    tools.set(DELEGATE_TOOL_NAME, {
+      name: DELEGATE_TOOL_NAME,
+      description: DELEGATE_DESCRIPTION,
+      inputSchema: DELEGATE_INPUT_SCHEMA,
+      handler: createDelegateHandler(options.delegateSupervisor)
+    });
+  }
   if (options.coderDelegate) {
     tools.set(DELEGATE_CODE_TOOL_NAME, {
       name: DELEGATE_CODE_TOOL_NAME,
@@ -9810,16 +10065,6 @@ function watchTrace(source, opts = {}) {
   });
 }
 
-// src/runtime/supervise/model-policy.ts
-function assertModelAllowed(model, allowed) {
-  if (!allowed || model === void 0) return;
-  if (!allowed.includes(model)) {
-    throw new ConfigError(
-      `model ${JSON.stringify(model)} is not in the allowed set ${JSON.stringify([...allowed])}`
-    );
-  }
-}
-
 // src/runtime/supervise/patch-checks.ts
 var DEFAULT_MAX_DIFF_LINES = 400;
 var secretPathPattern = /(^|\/)(\.env(\.|$)|.*\.(pem|key|p12|pfx|keystore|wallet)|id_rsa|id_ed25519|secrets?\.json|credentials?\.json)$/i;
@@ -9930,128 +10175,6 @@ function signalPass(value, required) {
   return !required;
 }
 
-// src/runtime/supervise/run-context.ts
-function createInMemoryRunContext(opts = {}) {
-  const base = createExecutorRegistry();
-  return {
-    journal: new InMemorySpawnJournal(),
-    blobs: new InMemoryResultBlobStore(),
-    executors: opts.withDriver ? withDriverExecutor(base) : base
-  };
-}
-
-// src/runtime/supervise/supervisor-agent.ts
-function supervisorAgent(profile, deps) {
-  const name = profile.name ?? "supervisor";
-  const systemPrompt = profile.systemPrompt ?? "";
-  const harness = profile.harness ?? null;
-  if (harness === null) {
-    const brain = deps.brain ?? routerBrainFromProfile(profile, deps);
-    return driverAgent({
-      name,
-      brain,
-      blobs: deps.blobs,
-      makeWorkerAgent: deps.makeWorkerAgent,
-      perWorker: deps.perWorker,
-      systemPrompt,
-      ...deps.extraTools ? { extraTools: deps.extraTools } : {},
-      ...deps.executeExtraTool ? { executeExtraTool: deps.executeExtraTool } : {},
-      ...deps.maxTurns !== void 0 ? { maxTurns: deps.maxTurns } : {}
-    });
-  }
-  const driveHarness = deps.driveHarness;
-  if (!driveHarness) {
-    throw new ValidationError(
-      `supervisorAgent: profile.harness="${harness}" needs deps.driveHarness (how to run the harness with the coordination MCP mounted)`
-    );
-  }
-  return {
-    name,
-    async act(task, scope) {
-      const mcp = await serveCoordinationMcp({
-        scope,
-        blobs: deps.blobs,
-        makeWorkerAgent: deps.makeWorkerAgent,
-        perWorker: deps.perWorker
-      });
-      try {
-        await driveHarness({ profile, task, scope, coordinationMcpUrl: mcp.url });
-        return await finalizeBestDelivered(mcp.settled(), deps.blobs);
-      } finally {
-        await mcp.close();
-      }
-    }
-  };
-}
-function routerBrainFromProfile(profile, deps) {
-  if (!deps.router) {
-    throw new ValidationError(
-      "supervisorAgent: a router-brained supervisor (harness null) needs deps.router (or deps.brain)"
-    );
-  }
-  return routerBrain({ ...deps.router, model: profile.model ?? deps.router.model });
-}
-
-// src/runtime/supervise/supervise.ts
-function workerFromBackend(backend, deliverable) {
-  return (rawProfile) => {
-    const p = rawProfile ?? {};
-    const name = typeof p.name === "string" && p.name.length > 0 ? p.name : "worker";
-    const spec = { profile: rawProfile, harness: null };
-    const ctx = { signal: new AbortController().signal, seams: {} };
-    const built = createExecutor(backend)(spec, ctx);
-    const executor = deliverable ? gateOnDeliverable(built, deliverable) : built;
-    return { name, act: async () => "", executorSpec: { ...spec, executor } };
-  };
-}
-function defaultPerWorker(budget) {
-  return {
-    maxIterations: budget.maxIterations,
-    maxTokens: Math.max(1, Math.floor(budget.maxTokens / 4))
-  };
-}
-function supervise(profile, task, opts) {
-  const backendModel = opts.backend?.model;
-  assertModelAllowed(opts.router?.model, opts.allowedModels);
-  assertModelAllowed(profile.model, opts.allowedModels);
-  assertModelAllowed(
-    typeof backendModel === "string" ? backendModel : void 0,
-    opts.allowedModels
-  );
-  const ctx = createInMemoryRunContext({ withDriver: true });
-  const blobs = opts.blobs ?? ctx.blobs;
-  const perWorker = opts.perWorker ?? defaultPerWorker(opts.budget);
-  let makeWorkerAgent = opts.makeWorkerAgent;
-  if (!makeWorkerAgent) {
-    if (!opts.backend) {
-      throw new ValidationError(
-        "supervise: provide opts.backend (where workers run) or opts.makeWorkerAgent"
-      );
-    }
-    makeWorkerAgent = workerFromBackend(opts.backend, opts.deliverable);
-  }
-  const agent = supervisorAgent(profile, {
-    blobs,
-    makeWorkerAgent,
-    perWorker,
-    ...opts.router ? { router: opts.router } : {},
-    ...opts.brain ? { brain: opts.brain } : {},
-    ...opts.driveHarness ? { driveHarness: opts.driveHarness } : {},
-    ...opts.extraTools ? { extraTools: opts.extraTools } : {},
-    ...opts.executeExtraTool ? { executeExtraTool: opts.executeExtraTool } : {},
-    ...opts.maxTurns !== void 0 ? { maxTurns: opts.maxTurns } : {}
-  });
-  return createSupervisor().run(agent, task, {
-    budget: opts.budget,
-    runId: opts.runId ?? "supervise",
-    journal: ctx.journal,
-    blobs,
-    executors: ctx.executors,
-    maxDepth: opts.maxDepth ?? 8,
-    ...opts.now ? { now: opts.now } : {}
-  });
-}
-
 // src/runtime/supervise/trace-source.ts
 function toToolSpan(input, runId, seq, at) {
   const startedAt = typeof input.startedAt === "number" ? input.startedAt : at;
@@ -10690,6 +10813,17 @@ export {
   composeLoopTraceEmitters,
   DelegationTaskQueue,
   hashIdempotencyInput,
+  createInMemoryRunContext,
+  supervisorAgent,
+  workerFromBackend,
+  supervise,
+  defaultDelegateBudget,
+  delegate,
+  DELEGATE_TOOL_NAME,
+  DELEGATE_DESCRIPTION,
+  DELEGATE_INPUT_SCHEMA,
+  validateDelegateArgs,
+  createDelegateHandler,
   formatDetachedSessionRef,
   parseDetachedSessionRef,
   detachedTurnEvents,
@@ -10732,10 +10866,6 @@ export {
   watchTrace,
   runCoderChecks,
   patchDelivered,
-  createInMemoryRunContext,
-  supervisorAgent,
-  workerFromBackend,
-  supervise,
   decodeToolPart,
   createPushTraceSource,
   sandboxSessionTraceSource,
@@ -10750,4 +10880,4 @@ export {
   computeFindingId2 as computeFindingId,
   makeFinding3 as makeFinding
 };
-//# sourceMappingURL=chunk-YFOPWG74.js.map
+//# sourceMappingURL=chunk-5ISW5JUF.js.map