@tangle-network/agent-runtime 0.51.0 → 0.53.0

package/dist/agent.d.ts

@@ -1,11 +1,11 @@
 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, O as OutputAdapter, A as AgentRunSpec } from './types-BEQsBhOE.js';
+import { R as RuntimeStreamEvent, S as SandboxClient, O as OutputAdapter, A as AgentRunSpec } from './types-CklkW4Eh.js';
 import { A as AgentSurfaces } from './improvement-adapter-BC4HhuAR.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-BC4HhuAR.js';
 import { K as KnowledgeAdapter, a as RunAnalystLoopResult } from './types-p8dWBIXL.js';
 import { AgentProfile, SandboxEvent } from '@tangle-network/sandbox';
-import { C as ComposeProductionAgentProfileOptions } from './delegation-profile-1GbW5yA3.js';
+import { C as ComposeProductionAgentProfileOptions } from './delegation-profile-Bvfro2m1.js';
 import './runtime-hooks-C7JwKb9E.js';
 
 /**

package/dist/agent.js

@@ -1,9 +1,9 @@
 import {
   composeProductionAgentProfile
-} from "./chunk-7JITYN6T.js";
+} from "./chunk-JFIYKDXF.js";
 import {
   createSandboxForSpec
-} from "./chunk-FQH33M5N.js";
+} from "./chunk-K6WP7PYW.js";
 import {
   mapSandboxEvent
 } from "./chunk-GSUO5QS6.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-BEQsBhOE.js';
+import { I as Iteration } from './types-CklkW4Eh.js';
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-p8dWBIXL.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-p8dWBIXL.js';
 import '@tangle-network/sandbox';

package/dist/{chunk-HAA4KZUD.js → chunk-5M2WDWBI.js}

@@ -25,11 +25,11 @@ import {
   createDelegationHistoryHandler,
   createDelegationStatusHandler,
   hashIdempotencyInput
-} from "./chunk-47SWANFA.js";
+} from "./chunk-FO4DCM7R.js";
 import {
   createFleetWorkspaceExecutor,
   createSiblingSandboxExecutor
-} from "./chunk-HYG4ISNS.js";
+} from "./chunk-AYRQZRDV.js";
 import {
   runLocalHarness
 } from "./chunk-GLR25NG7.js";
@@ -905,4 +905,4 @@ export {
   createPropagatingTraceEmitter,
   traceContextToEnv
 };
-//# sourceMappingURL=chunk-HAA4KZUD.js.map
+//# sourceMappingURL=chunk-5M2WDWBI.js.map

package/dist/{chunk-HYG4ISNS.js → chunk-AYRQZRDV.js}

@@ -12,7 +12,7 @@ import {
   sleep,
   throwAbort,
   throwIfAborted
-} from "./chunk-FQH33M5N.js";
+} from "./chunk-K6WP7PYW.js";
 import {
   ValidationError
 } from "./chunk-GSUO5QS6.js";
@@ -620,4 +620,4 @@ export {
   coderTaskFromArgs,
   settleDetachedCoderTurn
 };
-//# sourceMappingURL=chunk-HYG4ISNS.js.map
+//# sourceMappingURL=chunk-AYRQZRDV.js.map

package/dist/{chunk-47SWANFA.js → chunk-FO4DCM7R.js}

@@ -3,7 +3,7 @@ import {
   createDelegationTraceCollector,
   formatDetachedSessionRef,
   generateDelegationSpanId
-} from "./chunk-HYG4ISNS.js";
+} from "./chunk-AYRQZRDV.js";
 import {
   AgentEvalError,
   NotFoundError,
@@ -1353,4 +1353,4 @@ export {
   validateDelegationStatusArgs,
   createDelegationStatusHandler
 };
-//# sourceMappingURL=chunk-47SWANFA.js.map
+//# sourceMappingURL=chunk-FO4DCM7R.js.map

package/dist/{chunk-7JITYN6T.js → chunk-JFIYKDXF.js}

@@ -48,14 +48,21 @@ function composeProductionAgentProfile(baseProfile, options = {}) {
     env: options.env
   });
   const baseMcp = baseProfile.mcp ?? {};
-  const mergedMcp = delegationMcp ? { ...baseMcp, ...delegationMcp } : { ...baseMcp };
+  const withInjected = options.mcpConnections ? { ...baseMcp, ...options.mcpConnections } : { ...baseMcp };
+  const mergedMcp = delegationMcp ? { ...withInjected, ...delegationMcp } : withInjected;
   const baseFiles = baseProfile.resources?.files ?? [];
   const mergedFiles = options.extraFiles?.length ? [...baseFiles, ...options.extraFiles] : [...baseFiles];
   const prompt = options.systemPrompt ? { ...baseProfile.prompt, systemPrompt: options.systemPrompt } : baseProfile.prompt;
+  const mergedTools = options.tools ? { ...baseProfile.tools ?? {}, ...options.tools } : baseProfile.tools;
+  const mergedHooks = mergeHooks(baseProfile.hooks, options.hooks);
+  const mergedSubagents = options.subagents ? { ...baseProfile.subagents ?? {}, ...options.subagents } : baseProfile.subagents;
   return {
     ...baseProfile,
     name: options.name ?? baseProfile.name,
     prompt,
+    ...mergedTools ? { tools: mergedTools } : {},
+    ...mergedHooks ? { hooks: mergedHooks } : {},
+    ...mergedSubagents ? { subagents: mergedSubagents } : {},
     mcp: mergedMcp,
     resources: {
       ...baseProfile.resources,
@@ -63,10 +70,18 @@ function composeProductionAgentProfile(baseProfile, options = {}) {
     }
   };
 }
+function mergeHooks(base, overlay) {
+  if (!overlay) return base;
+  const merged = { ...base ?? {} };
+  for (const [event, commands] of Object.entries(overlay)) {
+    merged[event] = [...merged[event] ?? [], ...commands];
+  }
+  return merged;
+}
 
 export {
   DELEGATION_MCP_SERVER_KEY,
   buildDelegationMcpServer,
   composeProductionAgentProfile
 };
-//# sourceMappingURL=chunk-7JITYN6T.js.map
+//# sourceMappingURL=chunk-JFIYKDXF.js.map

package/dist/chunk-JFIYKDXF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/delegation-profile.ts"],"sourcesContent":["/**\n * Production-profile composition for the agent-runtime delegation MCP.\n *\n * A product agent's sandbox loads the delegation tools (`delegate_code`,\n * `delegate_research`, `delegate_feedback`, `delegation_status`,\n * `delegation_history`) by mounting the `agent-runtime-mcp` stdio server as\n * an MCP entry in its `AgentProfile`. This module is the single composer for\n * that wiring, so every consumer — the fleet agents and agent-builder's\n * generated agents — shares one implementation instead of copying it.\n *\n * The load-bearing invariant: the delegation MCP entry is only ever emitted\n * when a sandbox API key is present. Without the key the kernel's\n * coder/researcher delegate cannot construct an authenticated sandbox client,\n * so we omit the entry rather than ship an MCP child that fails to\n * authenticate on startup. No static profile entry, ever.\n */\n\nimport type {\n  AgentProfile,\n  AgentProfileFileMount,\n  AgentProfileMcpServer,\n  AgentSubagentProfile,\n} from '@tangle-network/sandbox'\n\n/** One hook command entry. The SDK declares `AgentProfile.hooks` as\n *  `Record<string, AgentProfileHookCommand[]>` but does not re-export the element\n *  type from the package entry, so derive it from `AgentProfile` by indexed\n *  access — the single source of truth, no drift from the SDK shape. */\ntype AgentProfileHookCommand = NonNullable<AgentProfile['hooks']>[string][number]\n\n/** MCP server key under which the agent-runtime delegation tools mount. */\nexport const DELEGATION_MCP_SERVER_KEY = 'agent-runtime-delegation'\n\n/**\n * Env vars forwarded into the delegation MCP child so its delegated\n * build/research loops export topology spans to the configured OTLP /\n * Tangle Intelligence sink. Each is forwarded only when present, so the\n * child is a no-op exporter until `OTEL_EXPORTER_OTLP_ENDPOINT` is set in the\n * parent env — never a hardcoded endpoint.\n */\nconst OTEL_FORWARD_KEYS = [\n  'OTEL_EXPORTER_OTLP_ENDPOINT',\n  'OTEL_EXPORTER_OTLP_HEADERS',\n  'TRACE_ID',\n  'PARENT_SPAN_ID',\n] as const\n\nconst DEFAULT_SANDBOX_BASE_URL = 'https://sandbox.tangle.tools'\n\nexport interface BuildDelegationMcpServerOptions {\n  /** Sandbox API key forwarded as `TANGLE_API_KEY` to the MCP child. The\n   *  agent-runtime MCP bin reads `TANGLE_API_KEY` and passes it straight to\n   *  `new Sandbox({ apiKey })`. Defaults to `env.TANGLE_API_KEY`. */\n  sandboxApiKey?: string\n  /** Sandbox base URL forwarded as `SANDBOX_BASE_URL`. Defaults to\n   *  `env.SANDBOX_BASE_URL`, then `env.SANDBOX_API_URL`, then the public\n   *  sandbox endpoint. */\n  sandboxBaseUrl?: string\n  /** Environment source for key + OTEL resolution. Defaults to `process.env`;\n   *  injectable for tests and non-process callers. */\n  env?: Record<string, string | undefined>\n}\n\n/**\n * Build the delegation MCP entry the sandbox-side agent loads on startup.\n * Returns `undefined` when no sandbox API key is resolvable — callers merge\n * the result into a profile's `mcp` map only when defined.\n */\nexport function buildDelegationMcpServer(\n  options: BuildDelegationMcpServerOptions = {},\n): Record<string, AgentProfileMcpServer> | undefined {\n  const env = options.env ?? process.env\n  const sandboxApiKey = options.sandboxApiKey ?? env.TANGLE_API_KEY\n  if (!sandboxApiKey) return undefined\n  const baseUrl =\n    options.sandboxBaseUrl ??\n    env.SANDBOX_BASE_URL ??\n    env.SANDBOX_API_URL ??\n    DEFAULT_SANDBOX_BASE_URL\n\n  const otelEnv: Record<string, string> = {}\n  for (const key of OTEL_FORWARD_KEYS) {\n    const value = env[key]\n    if (value) otelEnv[key] = value\n  }\n\n  return {\n    [DELEGATION_MCP_SERVER_KEY]: {\n      transport: 'stdio',\n      command: 'npx',\n      args: ['-y', '@tangle-network/agent-runtime', 'mcp'],\n      env: {\n        TANGLE_API_KEY: sandboxApiKey,\n        SANDBOX_BASE_URL: baseUrl,\n        ...otelEnv,\n      },\n      enabled: true,\n      metadata: {\n        surface: 'delegation:dispatch',\n        tools: [\n          'delegate_code',\n          'delegate_research',\n          'delegate_feedback',\n          'delegation_status',\n          'delegation_history',\n        ],\n      },\n    },\n  }\n}\n\nexport interface ComposeProductionAgentProfileOptions {\n  /** Sandbox API key forwarded to the delegation MCP child. Defaults to\n   *  `env.TANGLE_API_KEY`. When unset, the delegation MCP entry is omitted. */\n  sandboxApiKey?: string\n  /** Sandbox base URL forwarded as `SANDBOX_BASE_URL` to the MCP child. */\n  sandboxBaseUrl?: string\n  /** Replace the base profile's system prompt. Used by per-turn calls that\n   *  swap in workspace-augmented prompts (board summary, learned style). */\n  systemPrompt?: string\n  /** Extra file mounts layered after the base profile's `resources.files`. */\n  extraFiles?: AgentProfileFileMount[]\n  /** Override the profile `name`. Defaults to the base profile's name. */\n  name?: string\n  /** Environment source for key + OTEL resolution. Defaults to `process.env`. */\n  env?: Record<string, string | undefined>\n  /** Box built-in tool ON/OFF flags merged over the base profile's `tools`\n   *  (overlay wins per key). The sandbox-seam mapping of a certified surface's\n   *  tool grants — `AgentProfile.tools` is `Record<string, boolean>` box flags,\n   *  so it carries grants, not arbitrary tool defs. */\n  tools?: Record<string, boolean>\n  /** Per-event hook commands merged over the base profile's `hooks`. An event\n   *  present in both has the extra commands appended after the base ones. */\n  hooks?: Record<string, AgentProfileHookCommand[]>\n  /** Subagent definitions merged over the base profile's `subagents` (overlay\n   *  wins per key). */\n  subagents?: Record<string, AgentSubagentProfile>\n  /** Resolved certified MCP connections injected into `AgentProfile.mcp` — the\n   *  sandbox-seam delivery of a `ResolvedSurface.mcpConnections`. Merged after\n   *  the base map and before the delegation entry, so a base/delegation key is\n   *  never silently shadowed by an injected one. */\n  mcpConnections?: Record<string, AgentProfileMcpServer>\n}\n\n/**\n * Compose the production `AgentProfile`: the canonical base profile with the\n * delegation MCP merged into `mcp`. Used by every call site that boots a\n * sandbox or runs a chat turn through the sandbox path, and by eval wiring so\n * the scorecard profile hash reflects the actual production profile.\n *\n * Merge rules:\n *   - `mcp`: base map preserved; `options.mcpConnections` (resolved certified\n *     servers) merged over it; the delegation entry is appended last under\n *     {@link DELEGATION_MCP_SERVER_KEY}, and omitted entirely when no sandbox\n *     API key resolves.\n *   - `tools`: base box-flags map preserved; `options.tools` overlaid per key.\n *   - `hooks`: per event, base commands preserved; `options.hooks[event]`\n *     appended after the base ones.\n *   - `subagents`: base map preserved; `options.subagents` overlaid per key.\n *   - `prompt.systemPrompt`: replaced when `options.systemPrompt` is set.\n *   - `resources.files`: `options.extraFiles` concatenated after base files.\n *   - `name`: replaced when `options.name` is set.\n */\nexport function composeProductionAgentProfile(\n  baseProfile: AgentProfile,\n  options: ComposeProductionAgentProfileOptions = {},\n): AgentProfile {\n  const delegationMcp = buildDelegationMcpServer({\n    sandboxApiKey: options.sandboxApiKey,\n    sandboxBaseUrl: options.sandboxBaseUrl,\n    env: options.env,\n  })\n\n  const baseMcp = baseProfile.mcp ?? {}\n  const withInjected: Record<string, AgentProfileMcpServer> = options.mcpConnections\n    ? { ...baseMcp, ...options.mcpConnections }\n    : { ...baseMcp }\n  const mergedMcp: Record<string, AgentProfileMcpServer> = delegationMcp\n    ? { ...withInjected, ...delegationMcp }\n    : withInjected\n\n  const baseFiles = baseProfile.resources?.files ?? []\n  const mergedFiles: AgentProfileFileMount[] = options.extraFiles?.length\n    ? [...baseFiles, ...options.extraFiles]\n    : [...baseFiles]\n\n  const prompt = options.systemPrompt\n    ? { ...baseProfile.prompt, systemPrompt: options.systemPrompt }\n    : baseProfile.prompt\n\n  const mergedTools = options.tools\n    ? { ...(baseProfile.tools ?? {}), ...options.tools }\n    : baseProfile.tools\n\n  const mergedHooks = mergeHooks(baseProfile.hooks, options.hooks)\n\n  const mergedSubagents = options.subagents\n    ? { ...(baseProfile.subagents ?? {}), ...options.subagents }\n    : baseProfile.subagents\n\n  return {\n    ...baseProfile,\n    name: options.name ?? baseProfile.name,\n    prompt,\n    ...(mergedTools ? { tools: mergedTools } : {}),\n    ...(mergedHooks ? { hooks: mergedHooks } : {}),\n    ...(mergedSubagents ? { subagents: mergedSubagents } : {}),\n    mcp: mergedMcp,\n    resources: {\n      ...baseProfile.resources,\n      files: mergedFiles,\n    },\n  }\n}\n\n/** Merge per-event hook command lists: base commands first, overlay commands\n *  appended after. Returns the base map unchanged when no overlay is given. */\nfunction mergeHooks(\n  base: Record<string, AgentProfileHookCommand[]> | undefined,\n  overlay: Record<string, AgentProfileHookCommand[]> | undefined,\n): Record<string, AgentProfileHookCommand[]> | undefined {\n  if (!overlay) return base\n  const merged: Record<string, AgentProfileHookCommand[]> = { ...(base ?? {}) }\n  for (const [event, commands] of Object.entries(overlay)) {\n    merged[event] = [...(merged[event] ?? []), ...commands]\n  }\n  return merged\n}\n"],"mappings":";AA+BO,IAAM,4BAA4B;AASzC,IAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,2BAA2B;AAqB1B,SAAS,yBACd,UAA2C,CAAC,GACO;AACnD,QAAM,MAAM,QAAQ,OAAO,QAAQ;AACnC,QAAM,gBAAgB,QAAQ,iBAAiB,IAAI;AACnD,MAAI,CAAC,cAAe,QAAO;AAC3B,QAAM,UACJ,QAAQ,kBACR,IAAI,oBACJ,IAAI,mBACJ;AAEF,QAAM,UAAkC,CAAC;AACzC,aAAW,OAAO,mBAAmB;AACnC,UAAM,QAAQ,IAAI,GAAG;AACrB,QAAI,MAAO,SAAQ,GAAG,IAAI;AAAA,EAC5B;AAEA,SAAO;AAAA,IACL,CAAC,yBAAyB,GAAG;AAAA,MAC3B,WAAW;AAAA,MACX,SAAS;AAAA,MACT,MAAM,CAAC,MAAM,iCAAiC,KAAK;AAAA,MACnD,KAAK;AAAA,QACH,gBAAgB;AAAA,QAChB,kBAAkB;AAAA,QAClB,GAAG;AAAA,MACL;AAAA,MACA,SAAS;AAAA,MACT,UAAU;AAAA,QACR,SAAS;AAAA,QACT,OAAO;AAAA,UACL;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAsDO,SAAS,8BACd,aACA,UAAgD,CAAC,GACnC;AACd,QAAM,gBAAgB,yBAAyB;AAAA,IAC7C,eAAe,QAAQ;AAAA,IACvB,gBAAgB,QAAQ;AAAA,IACxB,KAAK,QAAQ;AAAA,EACf,CAAC;AAED,QAAM,UAAU,YAAY,OAAO,CAAC;AACpC,QAAM,eAAsD,QAAQ,iBAChE,EAAE,GAAG,SAAS,GAAG,QAAQ,eAAe,IACxC,EAAE,GAAG,QAAQ;AACjB,QAAM,YAAmD,gBACrD,EAAE,GAAG,cAAc,GAAG,cAAc,IACpC;AAEJ,QAAM,YAAY,YAAY,WAAW,SAAS,CAAC;AACnD,QAAM,cAAuC,QAAQ,YAAY,SAC7D,CAAC,GAAG,WAAW,GAAG,QAAQ,UAAU,IACpC,CAAC,GAAG,SAAS;AAEjB,QAAM,SAAS,QAAQ,eACnB,EAAE,GAAG,YAAY,QAAQ,cAAc,QAAQ,aAAa,IAC5D,YAAY;AAEhB,QAAM,cAAc,QAAQ,QACxB,EAAE,GAAI,YAAY,SAAS,CAAC,GAAI,GAAG,QAAQ,MAAM,IACjD,YAAY;AAEhB,QAAM,cAAc,WAAW,YAAY,OAAO,QAAQ,KAAK;AAE/D,QAAM,kBAAkB,QAAQ,YAC5B,EAAE,GAAI,YAAY,aAAa,CAAC,GAAI,GAAG,QAAQ,UAAU,IACzD,YAAY;AAEhB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM,QAAQ,QAAQ,YAAY;AAAA,IAClC;AAAA,IACA,GAAI,cAAc,EAAE,OAAO,YAAY,IAAI,CAAC;AAAA,IAC5C,GAAI,cAAc,EAAE,OAAO,YAAY,IAAI,CAAC;AAAA,IAC5C,GAAI,kBAAkB,EAAE,WAAW,gBAAgB,IAAI,CAAC;AAAA,IACxD,KAAK;AAAA,IACL,WAAW;AAAA,MACT,GAAG,YAAY;AAAA,MACf,OAAO;AAAA,IACT;AAAA,EACF;AACF;AAIA,SAAS,WACP,MACA,SACuD;AACvD,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAAoD,EAAE,GAAI,QAAQ,CAAC,EAAG;AAC5E,aAAW,CAAC,OAAO,QAAQ,KAAK,OAAO,QAAQ,OAAO,GAAG;AACvD,WAAO,KAAK,IAAI,CAAC,GAAI,OAAO,KAAK,KAAK,CAAC,GAAI,GAAG,QAAQ;AAAA,EACxD;AACA,SAAO;AACT;","names":[]}

package/dist/{chunk-XEI7AIHU.js → chunk-K5M3SHEU.js}

@@ -3,14 +3,14 @@ import {
 } from "./chunk-FNMGYYSS.js";
 import {
   createDefaultCoderDelegate
-} from "./chunk-HYG4ISNS.js";
+} from "./chunk-AYRQZRDV.js";
 import {
   runAnalystLoop
 } from "./chunk-HNUXAZIJ.js";
 import {
   createDriver,
   runLoop
-} from "./chunk-FQH33M5N.js";
+} from "./chunk-K6WP7PYW.js";
 import {
   ConfigError
 } from "./chunk-GSUO5QS6.js";
@@ -200,4 +200,4 @@ export {
   runLoopRunnerCli,
   parseLoopRunnerArgv
 };
-//# sourceMappingURL=chunk-XEI7AIHU.js.map
+//# sourceMappingURL=chunk-K5M3SHEU.js.map

package/dist/{chunk-FQH33M5N.js → chunk-K6WP7PYW.js}

@@ -710,6 +710,17 @@ function readAnalystFindings(settled) {
   }
   return out;
 }
+function registryScopeAnalyst(registry, buildInputs) {
+  return {
+    async analyze(input) {
+      const projection = buildInputs(input);
+      const result = await registry.run(projection.runId, projection.inputs, projection.opts);
+      const findings = result.findings;
+      assertTraceDerivedFindings(findings);
+      return findings;
+    }
+  };
+}
 function buildSteerContext(findings, settledSoFar) {
   assertTraceDerivedFindings(findings);
   const lastValidScore = observedBestScore(settledSoFar);
@@ -2691,6 +2702,7 @@ function loopUntil(seed, spec) {
     async act(task, scope) {
       let state = { round: 0, value: seed };
       const blockers = [];
+      const settledSoFar = [];
       for (; ; ) {
         const label = spec.label ? spec.label(state.round) : `step:${state.round}`;
         const child = ctx.spawnChild(label, ctx.persona.root);
@@ -2704,8 +2716,10 @@ function loopUntil(seed, spec) {
         }
         const settled = await drainOne(scope, label);
         if (settled.kind === "down") blockers.push(blockerFromDown(settled));
+        settledSoFar.push(settled);
         state = spec.fold(state, settled);
-        const reached = spec.until(state, []);
+        const findings = ctx.analyst ? await ctx.analyst.analyze({ task, settledSoFar, nodeId: scope.view.root }) : [];
+        const reached = spec.until(state, findings);
         if (reached) return reached;
         state = { round: state.round + 1, value: state.value };
       }
@@ -2817,7 +2831,12 @@ function widen(spec) {
       let widenIndex = 0;
       for (let s = await scope.next(); s !== null; s = await scope.next()) {
         gathered.push(s);
-        const decision = spec.gate.decide(s, [], scope.budget);
+        const findings = ctx.analyst ? await ctx.analyst.analyze({
+          task: _task,
+          settledSoFar: gathered,
+          nodeId: scope.view.root
+        }) : [];
+        const decision = spec.gate.decide(s, findings, scope.budget);
         if (decision.kind !== "widen") continue;
         const label = `widen:${widenIndex}`;
         widenIndex += 1;
@@ -3175,7 +3194,8 @@ async function routerChatWithTools(cfg, messages, tools, opts) {
       messages,
       tools,
       tool_choice: opts?.toolChoice ?? "auto",
-      temperature: opts?.temperature ?? 0.3
+      temperature: opts?.temperature ?? 0.3,
+      ...opts?.maxTokens ? { max_tokens: opts.maxTokens } : {}
     }),
     ...opts?.signal ? { signal: opts.signal } : {}
   });
@@ -3199,7 +3219,7 @@ async function routerChatWithTools(cfg, messages, tools, opts) {
 }
 async function routerToolLoop(cfg, system, user, tools, execute, opts) {
   const maxTurns = opts?.maxTurns ?? 4;
-  const messages = [
+  const messages = opts?.initialMessages ? [...opts.initialMessages] : [
     { role: "system", content: system },
     { role: "user", content: user }
   ];
@@ -3210,6 +3230,7 @@ async function routerToolLoop(cfg, system, user, tools, execute, opts) {
   for (let turn = 1; turn <= maxTurns; turn += 1) {
     const r = await routerChatWithTools(cfg, messages, tools, {
       ...opts?.temperature !== void 0 ? { temperature: opts.temperature } : {},
+      ...opts?.maxTokens ? { maxTokens: opts.maxTokens } : {},
       ...opts?.signal ? { signal: opts.signal } : {}
     });
     if (r.usage) {
@@ -3218,7 +3239,7 @@ async function routerToolLoop(cfg, system, user, tools, execute, opts) {
     }
     if (r.content) lastText = r.content;
     if (r.toolCalls.length === 0)
-      return { final: lastText, turns: turn, toolCalls, toolTrace, usage };
+      return { final: lastText, turns: turn, toolCalls, toolTrace, usage, messages };
     messages.push({
       role: "assistant",
       content: r.content ?? "",
@@ -3246,7 +3267,7 @@ async function routerToolLoop(cfg, system, user, tools, execute, opts) {
       toolTrace.push({ name: tc.name, args: tc.arguments, result: out });
     }
   }
-  return { final: lastText, turns: maxTurns, toolCalls, toolTrace, usage };
+  return { final: lastText, turns: maxTurns, toolCalls, toolTrace, usage, messages };
 }
 
 // src/runtime/supervise/runtime.ts
@@ -4215,10 +4236,11 @@ function definePersona(input) {
     ...input.extensions ? { extensions: input.extensions } : {}
   });
 }
-function createShapeContext(persona, budget) {
+function createShapeContext(persona, budget, analyst) {
   return {
     persona,
     budget,
+    ...analyst ? { analyst } : {},
     spawnChild(name, spec) {
       const agent = {
         name,
@@ -4244,7 +4266,7 @@ async function runPersonified(options) {
   const { persona } = options;
   const shape = resolveShape(options.shape);
   const shapeBudget = resolveShapeBudget(options.budget, options.shapeBudget);
-  const ctx = createShapeContext(persona, shapeBudget);
+  const ctx = createShapeContext(persona, shapeBudget, options.analyst);
   const rootAgent = shape(ctx);
   const executors = personaRegistry(persona);
   const supervisor = createSupervisor();
@@ -4259,7 +4281,8 @@ async function runPersonified(options) {
     ...options.maxRestarts !== void 0 ? { maxRestarts: options.maxRestarts } : {},
     ...options.withinMs !== void 0 ? { withinMs: options.withinMs } : {},
     ...options.now ? { now: options.now } : {},
-    ...options.signal ? { signal: options.signal } : {}
+    ...options.signal ? { signal: options.signal } : {},
+    ...options.hooks ? { hooks: options.hooks } : {}
   };
   return supervisor.run(rootAgent, options.task, supervisorOpts);
 }
@@ -4662,59 +4685,41 @@ import { pairedBootstrap, paretoFrontier } from "@tangle-network/agent-eval";
 import { createChatClient, estimateCost as estimateCost3, isModelPriced as isModelPriced3 } from "@tangle-network/agent-eval";
 var taskNudge = "Use the available tools to bring the artifact to the required final state. Address EVERY distinct change the request implies. After each tool result, check what remains and continue. Re-read the values you set to confirm they took. Reply DONE only once every required change is made and verified.";
 async function runShot(surface, _task, handle, tools, messages, opts, modelOverride) {
-  const innerTurns = opts.innerTurns ?? 4;
-  let completions = 0;
-  let toolCalls = 0;
   let toolErrors = 0;
-  const tokens = { input: 0, output: 0 };
-  for (let t = 0; t < innerTurns; t += 1) {
-    const res = await fetch(`${opts.routerBaseUrl.replace(/\/$/, "")}/chat/completions`, {
-      method: "POST",
-      headers: { "content-type": "application/json", authorization: `Bearer ${opts.routerKey}` },
-      body: JSON.stringify({
-        model: modelOverride ?? opts.model,
-        messages,
-        tools,
-        tool_choice: "auto",
-        temperature: opts.temperature ?? 0.7,
-        ...opts.maxTokens ? { max_tokens: opts.maxTokens } : {}
-      })
-    });
-    if (!res.ok) throw new Error(`router ${res.status}: ${(await res.text()).slice(0, 200)}`);
-    completions += 1;
-    const data = await res.json();
-    if (typeof data.usage?.prompt_tokens === "number") tokens.input += data.usage.prompt_tokens;
-    if (typeof data.usage?.completion_tokens === "number")
-      tokens.output += data.usage.completion_tokens;
-    const msg = data.choices?.[0]?.message;
-    if (!msg) break;
-    const calls = msg.tool_calls ?? [];
-    messages.push({
-      role: "assistant",
-      content: msg.content ?? "",
-      ...calls.length ? { tool_calls: calls } : {}
-    });
-    if (calls.length === 0) break;
-    for (const call of calls) {
-      toolCalls += 1;
-      let args = {};
-      try {
-        args = JSON.parse(call.function.arguments || "{}");
-      } catch {
-        toolErrors += 1;
-      }
-      let out;
-      try {
-        out = await surface.call(handle, call.function.name, args);
-        if (out.startsWith("ERROR:")) toolErrors += 1;
-      } catch (e) {
-        toolErrors += 1;
-        out = `ERROR: ${e instanceof Error ? e.message : String(e)}`;
-      }
-      messages.push({ role: "tool", tool_call_id: call.id, content: out });
+  const execute = async (name, args) => {
+    try {
+      const out = await surface.call(handle, name, args);
+      if (out.startsWith("ERROR:")) toolErrors += 1;
+      return out;
+    } catch (e) {
+      toolErrors += 1;
+      return `ERROR: ${e instanceof Error ? e.message : String(e)}`;
     }
-  }
-  return { messages, completions, toolCalls, toolErrors, tokens };
+  };
+  const r = await routerToolLoop(
+    {
+      routerBaseUrl: opts.routerBaseUrl,
+      routerKey: opts.routerKey,
+      model: modelOverride ?? opts.model
+    },
+    "",
+    "",
+    tools,
+    execute,
+    {
+      maxTurns: opts.innerTurns ?? 4,
+      temperature: opts.temperature ?? 0.7,
+      initialMessages: messages,
+      ...opts.maxTokens ? { maxTokens: opts.maxTokens } : {}
+    }
+  );
+  return {
+    messages: r.messages,
+    completions: r.turns,
+    toolCalls: r.toolCalls,
+    toolErrors,
+    tokens: r.usage
+  };
 }
 function compactTrajectory(messages) {
   return messages.filter((m) => m.role === "assistant" || m.role === "tool").map((m) => {
@@ -6453,6 +6458,7 @@ export {
   deterministicCompletion,
   assertTraceDerivedFindings,
   createScopeAnalyst,
+  registryScopeAnalyst,
   buildSteerContext,
   createDriver,
   renderAnalyses,
@@ -6528,4 +6534,4 @@ export {
   gitWorkspace,
   jjWorkspace
 };
-//# sourceMappingURL=chunk-FQH33M5N.js.map
+//# sourceMappingURL=chunk-K6WP7PYW.js.map