@tangle-network/agent-runtime 0.41.0 → 0.42.1

package/dist/{loop-runner-bin-DYRzk2cT.d.ts → loop-runner-bin-CVoCBmYk.d.ts}

@@ -1,9 +1,9 @@
 import { Scenario } from '@tangle-network/agent-eval/campaign';
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-p8dWBIXL.js';
 import { O as OptimizePromptOptions, a as OptimizePromptResult } from './optimize-prompt-D-urF2wW.js';
-import { T as TopologyPlanner, D as DynamicDecision } from './dynamic-CazTl_Zp.js';
-import { L as LoopSandboxClient, O as OutputAdapter, V as Validator, A as AgentRunSpec, a as LoopResult } from './types-BrJKXXI8.js';
-import { D as DelegateCodeArgs, C as CoderReviewer, a as CoderWinnerSelection, F as FactCandidate, b as CreateKbGateOptions } from './kb-gate-NzOJSnOk.js';
+import { T as TopologyPlanner, D as DynamicDecision } from './dynamic-B_7GgCwu.js';
+import { L as LoopSandboxClient, a as OutputAdapter, V as Validator, A as AgentRunSpec, b as LoopResult } from './types-Bcp071Jg.js';
+import { D as DelegateCodeArgs, C as CoderReviewer, a as CoderWinnerSelection, F as FactCandidate, b as CreateKbGateOptions } from './kb-gate-DTBum3vH.js';
 import { CoderOutput } from './profiles.js';
 
 /**

package/dist/loop-runner-bin.d.ts

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
-export { L as LoopRunnerCliArgs, f as LoopRunnerCliResult, p as parseLoopRunnerArgv, o as runLoopRunnerCli } from './loop-runner-bin-DYRzk2cT.js';
+export { L as LoopRunnerCliArgs, f as LoopRunnerCliResult, p as parseLoopRunnerArgv, o as runLoopRunnerCli } from './loop-runner-bin-CVoCBmYk.js';
 import '@tangle-network/agent-eval/campaign';
 import './types-p8dWBIXL.js';
 import '@tangle-network/agent-eval';
 import './optimize-prompt-D-urF2wW.js';
-import './dynamic-CazTl_Zp.js';
-import './types-BrJKXXI8.js';
+import './dynamic-B_7GgCwu.js';
+import './types-Bcp071Jg.js';
 import '@tangle-network/sandbox';
-import './types-CsCCryln.js';
-import './kb-gate-NzOJSnOk.js';
+import './kb-gate-DTBum3vH.js';
 import './profiles.js';

package/dist/loop-runner-bin.js

@@ -2,12 +2,12 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-4GI7C36B.js";
+} from "./chunk-PSGD6OIJ.js";
 import "./chunk-XBUG326M.js";
 import "./chunk-VOX6Z3II.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-FJ4GDNVN.js";
-import "./chunk-OISRXLWI.js";
+import "./chunk-WMBYQPYM.js";
+import "./chunk-IFG6GX6A.js";
 import "./chunk-3HMHSN22.js";
 import "./chunk-PY6NMZYX.js";
 import "./chunk-SQSCRJ7U.js";

package/dist/loops.d.ts

@@ -1,13 +1,12 @@
-import { AgentProfile, SandboxEvent } from '@tangle-network/sandbox';
+import { AgentProfile, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-import { P as PlannerContext, T as TopologyPlanner } from './dynamic-CazTl_Zp.js';
-export { C as CreateDynamicDriverOptions, D as DynamicDecision, a as TopologyMove, c as createDynamicDriver, s as summarizeHistory } from './dynamic-CazTl_Zp.js';
-import { D as Driver, I as Iteration, L as LoopSandboxClient, A as AgentRunSpec, O as OutputAdapter, V as Validator, E as ExecCtx, c as LoopWinner, a as LoopResult } from './types-BrJKXXI8.js';
-export { d as LoopDecisionPayload, e as LoopEndedPayload, f as LoopIterationDispatchPayload, g as LoopIterationEndedPayload, h as LoopIterationStartedPayload, i as LoopPlanDescription, j as LoopPlanPayload, k as LoopSandboxPlacement, l as LoopStartedPayload, m as LoopTokenUsage, b as LoopTraceEmitter, n as LoopTraceEvent, o as ValidationCtx } from './types-BrJKXXI8.js';
+import { P as PlannerContext, T as TopologyPlanner } from './dynamic-B_7GgCwu.js';
+export { C as CreateDynamicDriverOptions, D as DynamicDecision, a as TopologyMove, c as createDynamicDriver, s as summarizeHistory } from './dynamic-B_7GgCwu.js';
+import { D as Driver, I as Iteration, L as LoopSandboxClient, A as AgentRunSpec, a as OutputAdapter, V as Validator, E as ExecCtx, d as LoopWinner, b as LoopResult, R as RuntimeStreamEvent } from './types-Bcp071Jg.js';
+export { e as LoopDecisionPayload, f as LoopEndedPayload, g as LoopIterationDispatchPayload, h as LoopIterationEndedPayload, i as LoopIterationStartedPayload, j as LoopPlanDescription, k as LoopPlanPayload, l as LoopSandboxPlacement, m as LoopStartedPayload, n as LoopTokenUsage, c as LoopTraceEmitter, o as LoopTraceEvent, p as ValidationCtx } from './types-Bcp071Jg.js';
 import { DefaultVerdict, AgentProfile as AgentProfile$1 } from '@tangle-network/agent-eval';
 export { DefaultVerdict } from '@tangle-network/agent-eval';
 import { Scenario, DispatchFn, ProfileDispatchFn } from '@tangle-network/agent-eval/campaign';
-import './types-CsCCryln.js';
 
 /**
  * @experimental
@@ -213,6 +212,13 @@ interface RunLoopOptions<Task, Output, Decision> {
 }
 /** @experimental */
 declare function runLoop<Task, Output, Decision>(options: RunLoopOptions<Task, Output, Decision>): Promise<LoopResult<Task, Output, Decision>>;
+/**
+ * Instantiate a sandbox for an `AgentRunSpec`: sets `backend.profile` to the
+ * spec's profile (inferring the backend type when the spec doesn't override
+ * it) and merges `sandboxOverrides`. Shared by the loop kernel and the
+ * `AgentRuntime.act` sandbox bridge so both boot the sandbox identically.
+ */
+declare function createSandboxForSpec<Task>(client: LoopSandboxClient, spec: AgentRunSpec<Task>, signal: AbortSignal): Promise<SandboxInstance>;
 
 /**
  * `loopDispatch` — turn `runLoop` into an agent-eval campaign dispatch.
@@ -312,4 +318,56 @@ interface UsageSink {
  */
 declare function reportLoopUsage<Task, Output, Decision>(cost: UsageSink, result: Pick<LoopResult<Task, Output, Decision>, 'costUsd' | 'tokenUsage'>, source?: string): void;
 
-export { AgentRunSpec, type CreateFanoutVoteDriverOptions, type CreateRefineDriverOptions, type CreateSandboxPlannerOptions, Driver, ExecCtx, type FanoutVoteDecision, type FanoutVoteScored, Iteration, type LoopDispatchOptions, type LoopOptionsForDispatch, LoopResult, LoopSandboxClient, LoopWinner, OutputAdapter, PlannerContext, type RefineDecision, type RunLoopOptions, type TopologyMoveEnvelope, TopologyPlanner, type UsageSink, Validator, createFanoutVoteDriver, createRefineDriver, createSandboxPlanner, loopCampaignDispatch, loopDispatch, refineWinnerIndex, reportLoopUsage, runLoop, scoreFanoutVoteIterations };
+/**
+ * Sandbox-event → runtime-event mapping.
+ *
+ * The sandbox SDK emits a polymorphic `SandboxEvent = { type, data, id? }`
+ * whose `type` vocabulary is backend-determined (opencode, etc.) rather than
+ * enumerated by the SDK. Two consumers project it:
+ *   - the loop kernel's cost ledger (`extractLlmCallEvent`) — sums usage off
+ *     every cost-bearing event, regardless of stream shape;
+ *   - the `AgentRuntime.act` streaming contract (`mapSandboxEvent`) — projects
+ *     incremental events to the `RuntimeStreamEvent` chat-UX vocabulary.
+ *
+ * Both live here so the empirically-observed `type` vocabulary has one home.
+ */
+
+/**
+ * Extract a `RuntimeStreamEvent`-shaped `llm_call` from a sandbox event when
+ * the event carries usage/cost data. Returns `undefined` for non-cost events
+ * so the kernel can iterate the full stream without branching.
+ *
+ * Canonical cost-carrying types observed in the wild:
+ *   - `llm_call` — `data: { model, tokensIn, tokensOut, costUsd, ... }`
+ *   - `message.completed` / `result` — `data: { usage: { inputTokens,
+ *      outputTokens, totalCostUsd? } }`
+ *   - `cost.usage` / `usage` — same shape under a dedicated type
+ *
+ * Numeric coercion is strict: `Number.isFinite` gates every accumulator write
+ * so a sentinel `NaN` from a misbehaving backend cannot poison the ledger.
+ */
+declare function extractLlmCallEvent(event: SandboxEvent, agentRunName: string): (RuntimeStreamEvent & {
+    type: 'llm_call';
+}) | undefined;
+/**
+ * Project one `SandboxEvent` onto the `RuntimeStreamEvent` chat-UX vocabulary,
+ * for runtimes that bridge a sandbox `streamPrompt` into the
+ * `AgentRuntime.act` streaming contract. Returns `undefined` for events that
+ * have no faithful projection — the raw stream is preserved separately for the
+ * `OutputAdapter`, so an unmapped event never loses data.
+ *
+ * Mapped (the task-optional incremental variants — no synthesized task
+ * lifecycle, no guessed tool-part shapes):
+ *   - `message.part.updated` text part → `text_delta`
+ *   - `message.part.updated` reasoning/thinking part → `reasoning_delta`
+ *   - cost-bearing events → `llm_call` (shared with the ledger extractor)
+ *
+ * The opencode backend emits incremental text as
+ * `{ type: 'message.part.updated', data: { part: { type, text }, delta } }`;
+ * `delta` is the increment, `part.text` the running accumulation.
+ */
+declare function mapSandboxEvent(event: SandboxEvent, opts?: {
+    agentRunName?: string;
+}): RuntimeStreamEvent | undefined;
+
+export { AgentRunSpec, type CreateFanoutVoteDriverOptions, type CreateRefineDriverOptions, type CreateSandboxPlannerOptions, Driver, ExecCtx, type FanoutVoteDecision, type FanoutVoteScored, Iteration, type LoopDispatchOptions, type LoopOptionsForDispatch, LoopResult, LoopSandboxClient, LoopWinner, OutputAdapter, PlannerContext, type RefineDecision, type RunLoopOptions, type TopologyMoveEnvelope, TopologyPlanner, type UsageSink, Validator, createFanoutVoteDriver, createRefineDriver, createSandboxForSpec, createSandboxPlanner, extractLlmCallEvent, loopCampaignDispatch, loopDispatch, mapSandboxEvent, refineWinnerIndex, reportLoopUsage, runLoop, scoreFanoutVoteIterations };

package/dist/loops.js

@@ -1,14 +1,17 @@
 import {
   createDynamicDriver,
   createRefineDriver,
+  createSandboxForSpec,
   createSandboxPlanner,
+  extractLlmCallEvent,
   loopCampaignDispatch,
   loopDispatch,
+  mapSandboxEvent,
   refineWinnerIndex,
   reportLoopUsage,
   runLoop,
   summarizeHistory
-} from "./chunk-OISRXLWI.js";
+} from "./chunk-IFG6GX6A.js";
 import {
   createFanoutVoteDriver,
   scoreFanoutVoteIterations
@@ -19,9 +22,12 @@ export {
   createDynamicDriver,
   createFanoutVoteDriver,
   createRefineDriver,
+  createSandboxForSpec,
   createSandboxPlanner,
+  extractLlmCallEvent,
   loopCampaignDispatch,
   loopDispatch,
+  mapSandboxEvent,
   refineWinnerIndex,
   reportLoopUsage,
   runLoop,

package/dist/mcp/bin.js

@@ -4,15 +4,15 @@ import {
   createPropagatingTraceEmitter,
   detectExecutor,
   readTraceContextFromEnv
-} from "../chunk-WSJJGSD3.js";
+} from "../chunk-HCL2ZG5L.js";
 import "../chunk-HVYOHJHK.js";
 import {
   createDefaultCoderDelegate
-} from "../chunk-FJ4GDNVN.js";
+} from "../chunk-WMBYQPYM.js";
 import "../chunk-GLR25NG7.js";
 import {
   runLoop
-} from "../chunk-OISRXLWI.js";
+} from "../chunk-IFG6GX6A.js";
 import "../chunk-3HMHSN22.js";
 import "../chunk-PY6NMZYX.js";
 import "../chunk-SQSCRJ7U.js";

package/dist/mcp/index.d.ts

@@ -1,13 +1,13 @@
-import { L as LoopSandboxClient, k as LoopSandboxPlacement, b as LoopTraceEmitter } from '../types-BrJKXXI8.js';
-import { c as FleetHandle, d as DelegationExecutor, e as DelegateFeedbackArgs, f as DelegationFeedbackSnapshot, g as DelegationProfile, D as DelegateCodeArgs, h as DelegateResearchArgs, i as DelegationStatus, j as DelegationProgress, k as DelegationResultPayload, l as DelegationError, m as DelegationStatusResult, n as DelegationHistoryArgs, o as DelegationHistoryEntry, p as CoderDelegate, R as ResearcherDelegate, q as DelegateCodeResult, r as DelegateFeedbackResult, s as ResearchSource, t as DelegateResearchResult, u as DelegationHistoryResult, v as DelegationStatusArgs } from '../kb-gate-NzOJSnOk.js';
-export { w as CoderReview, C as CoderReviewer, a as CoderWinnerSelection, x as CreateDefaultCoderDelegateOptions, b as CreateKbGateOptions, y as DelegateCodeConfig, z as DelegateResearchConfig, A as DelegateRunCtx, F as FactCandidate, B as FactJudge, E as FactJudgeVerdict, G as FeedbackRating, H as FeedbackRefersTo, I as FleetWorkspaceExecutorOptions, K as KbGateResult, J as ResearchOutputShape, S as SiblingSandboxExecutorOptions, L as createDefaultCoderDelegate, M as createFleetWorkspaceExecutor, N as createKbGate, O as createSiblingSandboxExecutor } from '../kb-gate-NzOJSnOk.js';
+import { L as LoopSandboxClient, l as LoopSandboxPlacement, c as LoopTraceEmitter } from '../types-Bcp071Jg.js';
+import { c as FleetHandle, d as DelegationExecutor, e as DelegateFeedbackArgs, f as DelegationFeedbackSnapshot, g as DelegationProfile, D as DelegateCodeArgs, h as DelegateResearchArgs, i as DelegationStatus, j as DelegationProgress, k as DelegationResultPayload, l as DelegationError, m as DelegationStatusResult, n as DelegationHistoryArgs, o as DelegationHistoryEntry, p as CoderDelegate, R as ResearcherDelegate, q as DelegateCodeResult, r as DelegateFeedbackResult, s as ResearchSource, t as DelegateResearchResult, u as DelegationHistoryResult, v as DelegationStatusArgs } from '../kb-gate-DTBum3vH.js';
+export { w as CoderReview, C as CoderReviewer, a as CoderWinnerSelection, x as CreateDefaultCoderDelegateOptions, b as CreateKbGateOptions, y as DelegateCodeConfig, z as DelegateResearchConfig, A as DelegateRunCtx, F as FactCandidate, B as FactJudge, E as FactJudgeVerdict, G as FeedbackRating, H as FeedbackRefersTo, I as FleetWorkspaceExecutorOptions, K as KbGateResult, J as ResearchOutputShape, S as SiblingSandboxExecutorOptions, L as createDefaultCoderDelegate, M as createFleetWorkspaceExecutor, N as createKbGate, O as createSiblingSandboxExecutor } from '../kb-gate-DTBum3vH.js';
+export { B as BuildDelegationMcpServerOptions, C as ComposeProductionAgentProfileOptions, D as DELEGATION_MCP_SERVER_KEY, b as buildDelegationMcpServer, c as composeProductionAgentProfile } from '../delegation-profile-1GbW5yA3.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';
-import { O as OtelExporter } from '../otel-export-xgf4J6bo.js';
-export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../otel-export-xgf4J6bo.js';
+import { O as OtelExporter } from '../otel-export-BzvF1Ela.js';
+export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../otel-export-BzvF1Ela.js';
 import '@tangle-network/agent-eval';
 import '@tangle-network/sandbox';
-import '../types-CsCCryln.js';
 import '../profiles.js';
 import 'node:child_process';
 

package/dist/mcp/index.js

@@ -9,7 +9,7 @@ import {
   readTraceContextFromEnv,
   removeWorktree,
   traceContextToEnv
-} from "../chunk-WSJJGSD3.js";
+} from "../chunk-HCL2ZG5L.js";
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
@@ -52,11 +52,16 @@ import {
   createDefaultCoderDelegate,
   createFleetWorkspaceExecutor,
   createSiblingSandboxExecutor
-} from "../chunk-FJ4GDNVN.js";
+} from "../chunk-WMBYQPYM.js";
 import {
   runLocalHarness
 } from "../chunk-GLR25NG7.js";
-import "../chunk-OISRXLWI.js";
+import {
+  DELEGATION_MCP_SERVER_KEY,
+  buildDelegationMcpServer,
+  composeProductionAgentProfile
+} from "../chunk-7JITYN6T.js";
+import "../chunk-IFG6GX6A.js";
 import "../chunk-3HMHSN22.js";
 import "../chunk-PY6NMZYX.js";
 import "../chunk-SQSCRJ7U.js";
@@ -74,12 +79,15 @@ export {
   DELEGATION_HISTORY_DESCRIPTION,
   DELEGATION_HISTORY_INPUT_SCHEMA,
   DELEGATION_HISTORY_TOOL_NAME,
+  DELEGATION_MCP_SERVER_KEY,
   DELEGATION_STATUS_DESCRIPTION,
   DELEGATION_STATUS_INPUT_SCHEMA,
   DELEGATION_STATUS_TOOL_NAME,
   DelegationTaskQueue,
   InMemoryFeedbackStore,
+  buildDelegationMcpServer,
   captureWorktreeDiff,
+  composeProductionAgentProfile,
   createDefaultCoderDelegate,
   createDelegateCodeHandler,
   createDelegateFeedbackHandler,

package/dist/{otel-export-xgf4J6bo.d.ts → otel-export-BzvF1Ela.d.ts}

@@ -1,4 +1,4 @@
-import { O as OpenAIChatTool } from './types-CsCCryln.js';
+import { O as OpenAIChatTool } from './types-Bcp071Jg.js';
 
 /**
  * @experimental

package/dist/profiles.d.ts

@@ -1,7 +1,6 @@
 import { AgentProfile } from '@tangle-network/sandbox';
-import { O as OutputAdapter, V as Validator, A as AgentRunSpec, D as Driver } from './types-BrJKXXI8.js';
+import { a as OutputAdapter, V as Validator, A as AgentRunSpec, D as Driver } from './types-Bcp071Jg.js';
 import '@tangle-network/agent-eval';
-import './types-CsCCryln.js';
 
 /**
  * @experimental