@tangle-network/agent-runtime 0.104.0 → 0.106.0

package/dist/sandbox-events-DeI5xX8P.js

@@ -0,0 +1,316 @@
+//#region src/runtime/sandbox-events.ts
+/**
+* Forward a sandbox event to an optional observer without letting observer
+* behavior affect the run. The observer receives a defensive copy, synchronous
+* throws are swallowed, and returned promises are deliberately not awaited.
+*/
+function notifySandboxEventObserver(event, observer, meta) {
+	if (!observer) return;
+	try {
+		const result = observer(cloneEventForObserver(event), meta);
+		if (result && typeof result.then === "function") result.then(void 0, () => {});
+	} catch {}
+}
+function cloneEventForObserver(event) {
+	try {
+		return structuredClone(event);
+	} catch {
+		return copyPlainSpine(event, /* @__PURE__ */ new WeakMap());
+	}
+}
+function copyPlainSpine(value, seen) {
+	if (value === null || typeof value !== "object") return value;
+	const existing = seen.get(value);
+	if (existing !== void 0) return existing;
+	if (Array.isArray(value)) {
+		const copy = [];
+		seen.set(value, copy);
+		for (const item of value) copy.push(copyPlainSpine(item, seen));
+		return copy;
+	}
+	const proto = Object.getPrototypeOf(value);
+	if (proto !== Object.prototype && proto !== null) return {};
+	const copy = {};
+	seen.set(value, copy);
+	for (const [key, child] of Object.entries(value)) copy[key] = copyPlainSpine(child, seen);
+	return copy;
+}
+/**
+* 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.
+*/
+function extractLlmCallEvent(event, agentRunName) {
+	if (!event || typeof event !== "object") return void 0;
+	const type = String(event.type ?? "");
+	const data = event.data && typeof event.data === "object" ? event.data : {};
+	if (type === "llm_call" || type === "cost.usage" || type === "usage") return buildLlmCall(data, agentRunName);
+	if (type === "message.completed" || type === "result" || type === "final") {
+		const usage = data.usage;
+		if (!usage || typeof usage !== "object") return void 0;
+		return buildLlmCall({
+			...usage,
+			model: data.model ?? usage.model
+		}, agentRunName);
+	}
+	if (type === "done") {
+		const usage = data.tokenUsage;
+		if (!usage || typeof usage !== "object") return void 0;
+		const out = pickFiniteNumber(usage, [
+			"outputTokens",
+			"completion_tokens",
+			"tokensOut"
+		]);
+		const reasoning = pickFiniteNumber(usage, ["reasoningTokens"]);
+		const mergedOut = out !== void 0 || reasoning !== void 0 ? (out ?? 0) + (reasoning ?? 0) : void 0;
+		return buildLlmCall({
+			inputTokens: usage.inputTokens,
+			outputTokens: mergedOut,
+			totalCostUsd: data.totalCostUsd,
+			model: data.model ?? usage.model
+		}, agentRunName);
+	}
+}
+/**
+* Sum the token usage + USD cost of a sandbox turn's events — the one honest way to meter an
+* `openSandboxRun` cell. Folds `extractLlmCallEvent` over the stream (which reads usage off EVERY backend
+* event shape), so a `runProfileMatrix` dispatch can report it to `ctx.cost`:
+*
+*     receipt: (turn) => {
+*       const u = sumSandboxUsage(turn.events)
+*       return { model, inputTokens: u.input, outputTokens: u.output,
+*         ...(u.costUsd > 0 ? { actualCostUsd: u.costUsd } : {}) }
+*     }
+*
+* Without this a cell reads `{tokens:0, cost:0}` and the backend-integrity guard correctly aborts the
+* matrix as a stub. `agentRunName` is the fallback model label for cost-only events (default `'agent'`).
+*/
+function sumSandboxUsage(events, agentRunName = "agent") {
+	let input = 0;
+	let output = 0;
+	let costUsd = 0;
+	for (const ev of events) {
+		const call = extractLlmCallEvent(ev, agentRunName);
+		if (!call) continue;
+		input += call.tokensIn ?? 0;
+		output += call.tokensOut ?? 0;
+		costUsd += call.costUsd ?? 0;
+	}
+	return {
+		input,
+		output,
+		costUsd
+	};
+}
+function buildLlmCall(data, agentRunName) {
+	const tokensIn = pickFiniteNumber(data, [
+		"tokensIn",
+		"inputTokens",
+		"prompt_tokens"
+	]);
+	const tokensOut = pickFiniteNumber(data, [
+		"tokensOut",
+		"outputTokens",
+		"completion_tokens"
+	]);
+	const costUsd = pickFiniteNumber(data, [
+		"costUsd",
+		"totalCostUsd",
+		"cost_usd",
+		"cost"
+	]);
+	if (tokensIn === void 0 && tokensOut === void 0 && costUsd === void 0) return;
+	const event = {
+		type: "llm_call",
+		model: typeof data.model === "string" && data.model.length > 0 ? data.model : agentRunName
+	};
+	if (tokensIn !== void 0) event.tokensIn = tokensIn;
+	if (tokensOut !== void 0) event.tokensOut = tokensOut;
+	if (costUsd !== void 0) event.costUsd = costUsd;
+	return event;
+}
+function pickFiniteNumber(data, keys) {
+	for (const key of keys) {
+		const value = data[key];
+		if (typeof value === "number" && Number.isFinite(value)) return value;
+	}
+}
+/**
+* Fresh per-turn {@link SandboxToolPartState} for {@link mapSandboxToolEvent} — an
+* empty call-status map so each turn projects tool frames independently.
+*
+* @experimental
+*/
+function createSandboxToolPartState() {
+	return {
+		statusByCall: /* @__PURE__ */ new Map(),
+		seq: 0
+	};
+}
+/** Terminal tool statuses that are failures (everything here settles the call). */
+const TERMINAL_TOOL_FAILURE = /^(error|errored|failed|failure|cancelled|canceled|timeout|timed_out)$/i;
+/**
+* Project one `SandboxEvent` onto the `tool_call` / `tool_result` variants of
+* `RuntimeStreamEvent` — the tool-part projection `mapSandboxEvent`
+* deliberately does NOT perform. Opt-in and additive: `mapSandboxEvent`'s
+* default vocabulary (text/reasoning deltas + `llm_call`) is unchanged;
+* consumers that need the tool surface (chat UIs rendering tool activity)
+* compose this projector alongside it — `streamAgentTurn` does exactly that
+* under its `preserveToolParts` option.
+*
+* Handled shapes (observed on the opencode / claude-code sandbox backends):
+*   - `message.part.updated` with `part.type === 'tool'` — stateful: a
+*     `tool_call` on the call id's first frame (args from `state.input` or
+*     `state.metadata.input`), a `tool_result` when the status transitions to
+*     `completed` (result from `state.output` / `metadata.output`) or to a
+*     terminal failure (result is `{ error, status, output? }` — the error
+*     surfaced in-band, never dropped).
+*   - bare `tool*` event types (`tool.call`, `tool_result`, …) — stateless:
+*     `*result*` types project to `tool_result`, the rest to `tool_call`.
+*
+* Returns `[]` for every non-tool event.
+*
+* @experimental
+*/
+function mapSandboxToolEvent(event, state) {
+	if (!event || typeof event !== "object") return [];
+	const type = String(event.type ?? "");
+	const data = event.data && typeof event.data === "object" ? event.data : {};
+	if (type === "message.part.updated") {
+		const part = data.part && typeof data.part === "object" ? data.part : {};
+		if (String(part.type ?? "") !== "tool") return [];
+		return projectToolPart(part, state, typeof event.id === "string" ? event.id : void 0);
+	}
+	if (type.includes("tool")) {
+		const callId = pickString(data, [
+			"toolCallId",
+			"tool_use_id",
+			"id"
+		]) ?? (typeof event.id === "string" ? event.id : void 0) ?? `sandbox-tool-${++state.seq}`;
+		const toolName = pickString(data, [
+			"name",
+			"toolName",
+			"tool"
+		]) ?? "sandbox_tool";
+		if (type.includes("result")) return [{
+			type: "tool_result",
+			toolName,
+			toolCallId: callId,
+			result: data.output ?? data.result ?? data.content ?? data
+		}];
+		return [{
+			type: "tool_call",
+			toolName,
+			toolCallId: callId,
+			args: data.input ?? data.args ?? {}
+		}];
+	}
+	return [];
+}
+function projectToolPart(part, state, eventId) {
+	const callId = pickString(part, [
+		"callID",
+		"callId",
+		"toolCallId",
+		"id"
+	]) ?? eventId ?? `sandbox-tool-${++state.seq}`;
+	const toolName = pickString(part, [
+		"tool",
+		"toolName",
+		"name"
+	]) ?? "sandbox_tool";
+	const toolState = part.state && typeof part.state === "object" ? part.state : {};
+	const metadata = toolState.metadata && typeof toolState.metadata === "object" ? toolState.metadata : {};
+	const status = pickString(toolState, ["status"]) ?? "updated";
+	const previous = state.statusByCall.get(callId);
+	if (previous === "completed" || previous !== void 0 && TERMINAL_TOOL_FAILURE.test(previous)) return [];
+	const out = [];
+	if (previous === void 0) out.push({
+		type: "tool_call",
+		toolName,
+		toolCallId: callId,
+		args: toolState.input ?? metadata.input ?? {}
+	});
+	state.statusByCall.set(callId, status);
+	if (status === "completed") out.push({
+		type: "tool_result",
+		toolName,
+		toolCallId: callId,
+		result: toolState.output ?? metadata.output ?? ""
+	});
+	else if (TERMINAL_TOOL_FAILURE.test(status)) {
+		const message = pickString(toolState, ["error", "message"]) ?? pickString(metadata, ["error", "message"]) ?? `sandbox tool ended with status ${status}`;
+		const output = toolState.output ?? metadata.output;
+		out.push({
+			type: "tool_result",
+			toolName,
+			toolCallId: callId,
+			result: {
+				error: message,
+				status,
+				...output !== void 0 ? { output } : {}
+			}
+		});
+	}
+	return out;
+}
+function pickString(data, keys) {
+	for (const key of keys) {
+		const value = data[key];
+		if (typeof value === "string" && value.length > 0) return value;
+	}
+}
+/**
+* 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)
+*
+* Tool parts are deliberately NOT mapped here (unchanged default) — compose
+* {@link mapSandboxToolEvent} alongside when a consumer needs them.
+*
+* 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.
+*/
+function mapSandboxEvent(event, opts = {}) {
+	if (!event || typeof event !== "object") return void 0;
+	const type = String(event.type ?? "");
+	const data = event.data && typeof event.data === "object" ? event.data : {};
+	if (type === "message.part.updated") {
+		const part = data.part && typeof data.part === "object" ? data.part : {};
+		const partType = String(part.type ?? "");
+		const text = (typeof data.delta === "string" ? data.delta : void 0) ?? (typeof part.text === "string" ? part.text : void 0);
+		if (text === void 0) return void 0;
+		if (partType === "text") return {
+			type: "text_delta",
+			text
+		};
+		if (partType === "reasoning" || partType === "thinking") return {
+			type: "reasoning_delta",
+			text
+		};
+		return;
+	}
+	return extractLlmCallEvent(event, opts.agentRunName ?? "agent");
+}
+//#endregion
+export { notifySandboxEventObserver as a, mapSandboxToolEvent as i, extractLlmCallEvent as n, sumSandboxUsage as o, mapSandboxEvent as r, createSandboxToolPartState as t };
+
+//# sourceMappingURL=sandbox-events-DeI5xX8P.js.map

package/dist/sandbox-events-DeI5xX8P.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-events-DeI5xX8P.js","names":[],"sources":["../src/runtime/sandbox-events.ts"],"sourcesContent":["/**\n * Sandbox-event → runtime-event mapping.\n *\n * The sandbox SDK emits a polymorphic `SandboxEvent = { type, data, id? }`\n * whose `type` vocabulary is backend-determined (opencode, etc.) rather than\n * enumerated by the SDK. Two consumers project it:\n *   - the loop kernel's cost ledger (`extractLlmCallEvent`) — sums usage off\n *     every cost-bearing event, regardless of stream shape;\n *   - the `AgentRuntime.act` streaming contract (`mapSandboxEvent`) — projects\n *     incremental events to the `RuntimeStreamEvent` chat-UX vocabulary.\n *\n * Both live here so the empirically-observed `type` vocabulary has one home.\n */\n\nimport type { SandboxEvent } from '@tangle-network/sandbox'\nimport type { RuntimeStreamEvent } from '../types'\n\n/**\n * Forward a sandbox event to an optional observer without letting observer\n * behavior affect the run. The observer receives a defensive copy, synchronous\n * throws are swallowed, and returned promises are deliberately not awaited.\n */\nexport function notifySandboxEventObserver<Meta>(\n  event: SandboxEvent,\n  observer: ((event: SandboxEvent, meta: Meta) => void | PromiseLike<void>) | undefined,\n  meta: Meta,\n): void {\n  if (!observer) return\n  try {\n    const result = observer(cloneEventForObserver(event), meta)\n    if (result && typeof result.then === 'function') {\n      void result.then(undefined, () => {})\n    }\n  } catch {\n    // Live observation is optional and must never interrupt the event stream.\n  }\n}\n\nfunction cloneEventForObserver(event: SandboxEvent): SandboxEvent {\n  try {\n    return structuredClone(event)\n  } catch {\n    return copyPlainSpine(event, new WeakMap()) as SandboxEvent\n  }\n}\n\nfunction copyPlainSpine(value: unknown, seen: WeakMap<object, unknown>): unknown {\n  if (value === null || typeof value !== 'object') return value\n  const existing = seen.get(value)\n  if (existing !== undefined) return existing\n  if (Array.isArray(value)) {\n    const copy: unknown[] = []\n    seen.set(value, copy)\n    for (const item of value) copy.push(copyPlainSpine(item, seen))\n    return copy\n  }\n  const proto = Object.getPrototypeOf(value)\n  if (proto !== Object.prototype && proto !== null) return {}\n  const copy: Record<string, unknown> = {}\n  seen.set(value, copy)\n  for (const [key, child] of Object.entries(value)) {\n    copy[key] = copyPlainSpine(child, seen)\n  }\n  return copy\n}\n\n/**\n * Extract a `RuntimeStreamEvent`-shaped `llm_call` from a sandbox event when\n * the event carries usage/cost data. Returns `undefined` for non-cost events\n * so the kernel can iterate the full stream without branching.\n *\n * Canonical cost-carrying types observed in the wild:\n *   - `llm_call` — `data: { model, tokensIn, tokensOut, costUsd, ... }`\n *   - `message.completed` / `result` — `data: { usage: { inputTokens,\n *      outputTokens, totalCostUsd? } }`\n *   - `cost.usage` / `usage` — same shape under a dedicated type\n *\n * Numeric coercion is strict: `Number.isFinite` gates every accumulator write\n * so a sentinel `NaN` from a misbehaving backend cannot poison the ledger.\n */\nexport function extractLlmCallEvent(\n  event: SandboxEvent,\n  agentRunName: string,\n): (RuntimeStreamEvent & { type: 'llm_call' }) | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const type = String(event.type ?? '')\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n\n  if (type === 'llm_call' || type === 'cost.usage' || type === 'usage') {\n    return buildLlmCall(data, agentRunName)\n  }\n  if (type === 'message.completed' || type === 'result' || type === 'final') {\n    const usage = data.usage as Record<string, unknown> | undefined\n    if (!usage || typeof usage !== 'object') return undefined\n    return buildLlmCall({ ...usage, model: data.model ?? usage.model }, agentRunName)\n  }\n  // sandbox 0.4.0 terminal event: `data = { tokenUsage: { inputTokens, outputTokens,\n  // reasoningTokens, cacheReadInputTokens }, totalCostUsd }`. Usage lives under\n  // `tokenUsage` (not `usage`) and the cost is top-level — neither matched the\n  // branches above, so an in-process loopDispatch run reported {0,0} and the\n  // backend-integrity guard misread a real run as a stub. Reasoning tokens are\n  // billed output (reasoning models), so they fold into the output count.\n  if (type === 'done') {\n    const usage = data.tokenUsage as Record<string, unknown> | undefined\n    if (!usage || typeof usage !== 'object') return undefined\n    const out = pickFiniteNumber(usage, ['outputTokens', 'completion_tokens', 'tokensOut'])\n    const reasoning = pickFiniteNumber(usage, ['reasoningTokens'])\n    const mergedOut =\n      out !== undefined || reasoning !== undefined ? (out ?? 0) + (reasoning ?? 0) : undefined\n    return buildLlmCall(\n      {\n        inputTokens: usage.inputTokens,\n        outputTokens: mergedOut,\n        totalCostUsd: data.totalCostUsd,\n        model: data.model ?? usage.model,\n      },\n      agentRunName,\n    )\n  }\n  return undefined\n}\n\n/**\n * Sum the token usage + USD cost of a sandbox turn's events — the one honest way to meter an\n * `openSandboxRun` cell. Folds `extractLlmCallEvent` over the stream (which reads usage off EVERY backend\n * event shape), so a `runProfileMatrix` dispatch can report it to `ctx.cost`:\n *\n *     receipt: (turn) => {\n *       const u = sumSandboxUsage(turn.events)\n *       return { model, inputTokens: u.input, outputTokens: u.output,\n *         ...(u.costUsd > 0 ? { actualCostUsd: u.costUsd } : {}) }\n *     }\n *\n * Without this a cell reads `{tokens:0, cost:0}` and the backend-integrity guard correctly aborts the\n * matrix as a stub. `agentRunName` is the fallback model label for cost-only events (default `'agent'`).\n */\nexport function sumSandboxUsage(\n  events: readonly SandboxEvent[],\n  agentRunName = 'agent',\n): { input: number; output: number; costUsd: number } {\n  let input = 0\n  let output = 0\n  let costUsd = 0\n  for (const ev of events) {\n    const call = extractLlmCallEvent(ev, agentRunName)\n    if (!call) continue\n    input += call.tokensIn ?? 0\n    output += call.tokensOut ?? 0\n    costUsd += call.costUsd ?? 0\n  }\n  return { input, output, costUsd }\n}\n\nfunction buildLlmCall(\n  data: Record<string, unknown>,\n  agentRunName: string,\n): (RuntimeStreamEvent & { type: 'llm_call' }) | undefined {\n  const tokensIn = pickFiniteNumber(data, ['tokensIn', 'inputTokens', 'prompt_tokens'])\n  const tokensOut = pickFiniteNumber(data, ['tokensOut', 'outputTokens', 'completion_tokens'])\n  const costUsd = pickFiniteNumber(data, ['costUsd', 'totalCostUsd', 'cost_usd', 'cost'])\n  if (tokensIn === undefined && tokensOut === undefined && costUsd === undefined) {\n    return undefined\n  }\n  const model = typeof data.model === 'string' && data.model.length > 0 ? data.model : agentRunName\n  const event: RuntimeStreamEvent & { type: 'llm_call' } = {\n    type: 'llm_call',\n    model,\n  }\n  if (tokensIn !== undefined) event.tokensIn = tokensIn\n  if (tokensOut !== undefined) event.tokensOut = tokensOut\n  if (costUsd !== undefined) event.costUsd = costUsd\n  return event\n}\n\nfunction pickFiniteNumber(data: Record<string, unknown>, keys: string[]): number | undefined {\n  for (const key of keys) {\n    const value = data[key]\n    if (typeof value === 'number' && Number.isFinite(value)) return value\n  }\n  return undefined\n}\n\n/**\n * Cross-event state for {@link mapSandboxToolEvent}. Sandbox backends emit a\n * tool invocation as MANY `message.part.updated` frames on the same call id\n * (pending → running → completed), so faithful projection needs per-call\n * status memory: one `tool_call` on first sighting, at most one `tool_result`\n * on the terminal transition, nothing on intermediate re-frames. Create one\n * state per turn via {@link createSandboxToolPartState}.\n *\n * @experimental\n */\nexport interface SandboxToolPartState {\n  /** Last seen status per tool call id. A terminal status is sticky — later\n   *  frames on a settled call project to nothing. */\n  statusByCall: Map<string, string>\n  /** Sequence for synthesized call ids when an event carries none. */\n  seq: number\n}\n\n/**\n * Fresh per-turn {@link SandboxToolPartState} for {@link mapSandboxToolEvent} — an\n * empty call-status map so each turn projects tool frames independently.\n *\n * @experimental\n */\nexport function createSandboxToolPartState(): SandboxToolPartState {\n  return { statusByCall: new Map(), seq: 0 }\n}\n\n/** Terminal tool statuses that are failures (everything here settles the call). */\nconst TERMINAL_TOOL_FAILURE =\n  /^(error|errored|failed|failure|cancelled|canceled|timeout|timed_out)$/i\n\n/**\n * Project one `SandboxEvent` onto the `tool_call` / `tool_result` variants of\n * `RuntimeStreamEvent` — the tool-part projection `mapSandboxEvent`\n * deliberately does NOT perform. Opt-in and additive: `mapSandboxEvent`'s\n * default vocabulary (text/reasoning deltas + `llm_call`) is unchanged;\n * consumers that need the tool surface (chat UIs rendering tool activity)\n * compose this projector alongside it — `streamAgentTurn` does exactly that\n * under its `preserveToolParts` option.\n *\n * Handled shapes (observed on the opencode / claude-code sandbox backends):\n *   - `message.part.updated` with `part.type === 'tool'` — stateful: a\n *     `tool_call` on the call id's first frame (args from `state.input` or\n *     `state.metadata.input`), a `tool_result` when the status transitions to\n *     `completed` (result from `state.output` / `metadata.output`) or to a\n *     terminal failure (result is `{ error, status, output? }` — the error\n *     surfaced in-band, never dropped).\n *   - bare `tool*` event types (`tool.call`, `tool_result`, …) — stateless:\n *     `*result*` types project to `tool_result`, the rest to `tool_call`.\n *\n * Returns `[]` for every non-tool event.\n *\n * @experimental\n */\nexport function mapSandboxToolEvent(\n  event: SandboxEvent,\n  state: SandboxToolPartState,\n): (RuntimeStreamEvent & { type: 'tool_call' | 'tool_result' })[] {\n  if (!event || typeof event !== 'object') return []\n  const type = String(event.type ?? '')\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n\n  if (type === 'message.part.updated') {\n    const part =\n      data.part && typeof data.part === 'object' ? (data.part as Record<string, unknown>) : {}\n    if (String(part.type ?? '') !== 'tool') return []\n    return projectToolPart(part, state, typeof event.id === 'string' ? event.id : undefined)\n  }\n\n  if (type.includes('tool')) {\n    const callId =\n      pickString(data, ['toolCallId', 'tool_use_id', 'id']) ??\n      (typeof event.id === 'string' ? event.id : undefined) ??\n      `sandbox-tool-${++state.seq}`\n    const toolName = pickString(data, ['name', 'toolName', 'tool']) ?? 'sandbox_tool'\n    if (type.includes('result')) {\n      return [\n        {\n          type: 'tool_result',\n          toolName,\n          toolCallId: callId,\n          result: data.output ?? data.result ?? data.content ?? data,\n        },\n      ]\n    }\n    return [\n      { type: 'tool_call', toolName, toolCallId: callId, args: data.input ?? data.args ?? {} },\n    ]\n  }\n\n  return []\n}\n\nfunction projectToolPart(\n  part: Record<string, unknown>,\n  state: SandboxToolPartState,\n  eventId: string | undefined,\n): (RuntimeStreamEvent & { type: 'tool_call' | 'tool_result' })[] {\n  const callId =\n    pickString(part, ['callID', 'callId', 'toolCallId', 'id']) ??\n    eventId ??\n    `sandbox-tool-${++state.seq}`\n  const toolName = pickString(part, ['tool', 'toolName', 'name']) ?? 'sandbox_tool'\n  const toolState =\n    part.state && typeof part.state === 'object' ? (part.state as Record<string, unknown>) : {}\n  const metadata =\n    toolState.metadata && typeof toolState.metadata === 'object'\n      ? (toolState.metadata as Record<string, unknown>)\n      : {}\n  const status = pickString(toolState, ['status']) ?? 'updated'\n\n  const previous = state.statusByCall.get(callId)\n  const settled =\n    previous === 'completed' || (previous !== undefined && TERMINAL_TOOL_FAILURE.test(previous))\n  if (settled) return []\n\n  const out: (RuntimeStreamEvent & { type: 'tool_call' | 'tool_result' })[] = []\n  if (previous === undefined) {\n    out.push({\n      type: 'tool_call',\n      toolName,\n      toolCallId: callId,\n      args: toolState.input ?? metadata.input ?? {},\n    })\n  }\n  state.statusByCall.set(callId, status)\n\n  if (status === 'completed') {\n    out.push({\n      type: 'tool_result',\n      toolName,\n      toolCallId: callId,\n      result: toolState.output ?? metadata.output ?? '',\n    })\n  } else if (TERMINAL_TOOL_FAILURE.test(status)) {\n    const message =\n      pickString(toolState, ['error', 'message']) ??\n      pickString(metadata, ['error', 'message']) ??\n      `sandbox tool ended with status ${status}`\n    const output = toolState.output ?? metadata.output\n    out.push({\n      type: 'tool_result',\n      toolName,\n      toolCallId: callId,\n      result: { error: message, status, ...(output !== undefined ? { output } : {}) },\n    })\n  }\n  return out\n}\n\nfunction pickString(data: Record<string, unknown>, keys: string[]): string | undefined {\n  for (const key of keys) {\n    const value = data[key]\n    if (typeof value === 'string' && value.length > 0) return value\n  }\n  return undefined\n}\n\n/**\n * Project one `SandboxEvent` onto the `RuntimeStreamEvent` chat-UX vocabulary,\n * for runtimes that bridge a sandbox `streamPrompt` into the\n * `AgentRuntime.act` streaming contract. Returns `undefined` for events that\n * have no faithful projection — the raw stream is preserved separately for the\n * `OutputAdapter`, so an unmapped event never loses data.\n *\n * Mapped (the task-optional incremental variants — no synthesized task\n * lifecycle, no guessed tool-part shapes):\n *   - `message.part.updated` text part → `text_delta`\n *   - `message.part.updated` reasoning/thinking part → `reasoning_delta`\n *   - cost-bearing events → `llm_call` (shared with the ledger extractor)\n *\n * Tool parts are deliberately NOT mapped here (unchanged default) — compose\n * {@link mapSandboxToolEvent} alongside when a consumer needs them.\n *\n * The opencode backend emits incremental text as\n * `{ type: 'message.part.updated', data: { part: { type, text }, delta } }`;\n * `delta` is the increment, `part.text` the running accumulation.\n */\nexport function mapSandboxEvent(\n  event: SandboxEvent,\n  opts: { agentRunName?: string } = {},\n): RuntimeStreamEvent | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const type = String(event.type ?? '')\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n\n  if (type === 'message.part.updated') {\n    const part =\n      data.part && typeof data.part === 'object' ? (data.part as Record<string, unknown>) : {}\n    const partType = String(part.type ?? '')\n    const delta = typeof data.delta === 'string' ? data.delta : undefined\n    const text = delta ?? (typeof part.text === 'string' ? part.text : undefined)\n    if (text === undefined) return undefined\n    if (partType === 'text') return { type: 'text_delta', text }\n    if (partType === 'reasoning' || partType === 'thinking')\n      return { type: 'reasoning_delta', text }\n    return undefined\n  }\n\n  return extractLlmCallEvent(event, opts.agentRunName ?? 'agent')\n}\n"],"mappings":"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"}