@tangle-network/agent-app 2.0.6 → 2.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/dist/agent-profiles/d1.js +3 -3
  2. package/dist/agent-profiles/index.js +3 -3
  3. package/dist/chat-routes/completed-sandbox-turn.d.ts +1 -1
  4. package/dist/chat-routes/index.js +11 -21
  5. package/dist/chat-routes/index.js.map +1 -1
  6. package/dist/chat-routes/sandbox-turn-usage.d.ts +4 -0
  7. package/dist/chat-routes/turn-route-contracts.d.ts +3 -0
  8. package/dist/chat-store/core.d.ts +2 -0
  9. package/dist/chat-store/index.js +24 -28
  10. package/dist/chat-store/index.js.map +1 -1
  11. package/dist/chat-store/schema.d.ts +9 -0
  12. package/dist/{chunk-JGPSBTUH.js → chunk-5DAEU3CP.js} +42 -31
  13. package/dist/chunk-5DAEU3CP.js.map +1 -0
  14. package/dist/{chunk-WQZCX4IJ.js → chunk-6GN2E5KT.js} +2 -2
  15. package/dist/{chunk-532GILWC.js → chunk-CVOEGD3Y.js} +2 -2
  16. package/dist/{chunk-N425HGJW.js → chunk-EI27JMS6.js} +1 -1
  17. package/dist/chunk-EI27JMS6.js.map +1 -0
  18. package/dist/{chunk-IDRATMRZ.js → chunk-MVTLHM74.js} +5 -5
  19. package/dist/{chunk-IDRATMRZ.js.map → chunk-MVTLHM74.js.map} +1 -1
  20. package/dist/{chunk-C3JXGK3R.js → chunk-NHOQ5TMH.js} +2 -2
  21. package/dist/{chunk-7BRFM73D.js → chunk-PABZALSD.js} +2 -2
  22. package/dist/{chunk-2WYGR3S5.js → chunk-PO23GWVQ.js} +11 -15
  23. package/dist/chunk-PO23GWVQ.js.map +1 -0
  24. package/dist/{chunk-TJA5ERCP.js → chunk-STGV7DXB.js} +3 -3
  25. package/dist/{chunk-ORBPOLBM.js → chunk-X2NXWJ6P.js} +27 -7
  26. package/dist/chunk-X2NXWJ6P.js.map +1 -0
  27. package/dist/conformance/cli.js +2 -2
  28. package/dist/conformance/index.js +2 -2
  29. package/dist/operator/chat-adapter.d.ts +1 -0
  30. package/dist/operator/contract.d.ts +2 -0
  31. package/dist/operator/index.js +2 -1
  32. package/dist/operator/index.js.map +1 -1
  33. package/dist/preset-cloudflare/index.js +4 -4
  34. package/dist/public-consultation/index.js +6 -6
  35. package/dist/sandbox/index.js +4 -4
  36. package/dist/tools/index.js +4 -4
  37. package/dist/work-product/index.js +2 -2
  38. package/package.json +33 -33
  39. package/dist/chunk-2WYGR3S5.js.map +0 -1
  40. package/dist/chunk-JGPSBTUH.js.map +0 -1
  41. package/dist/chunk-N425HGJW.js.map +0 -1
  42. package/dist/chunk-ORBPOLBM.js.map +0 -1
  43. /package/dist/{chunk-WQZCX4IJ.js.map → chunk-6GN2E5KT.js.map} +0 -0
  44. /package/dist/{chunk-532GILWC.js.map → chunk-CVOEGD3Y.js.map} +0 -0
  45. /package/dist/{chunk-C3JXGK3R.js.map → chunk-NHOQ5TMH.js.map} +0 -0
  46. /package/dist/{chunk-7BRFM73D.js.map → chunk-PABZALSD.js.map} +0 -0
  47. /package/dist/{chunk-TJA5ERCP.js.map → chunk-STGV7DXB.js.map} +0 -0
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/chat-routes/draft-persistence.ts","../src/chat-routes/sandbox-turn-usage.ts"],"sourcesContent":["/**\n * Incremental (\"draft\") persistence of the assistant row WHILE a turn streams.\n *\n * Why this exists — the scale argument, not a convenience:\n *\n * A live turn is readable from two places. The hot path is the session\n * gateway's in-memory/Redis event buffer, which exists so a viewer survives a\n * network blip: it is keyed one sorted set per session, refreshed on every\n * push, and expires on a TTL. Its memory cost is `arrival_rate x TTL x\n * bytes_per_session` — strictly LINEAR in the TTL. Stretching that TTL to\n * cover \"a viewer who opens the tab later\" is a category error: it buys memory\n * proportional to the increase and still serves nothing to a viewer who\n * arrives past the new horizon.\n *\n * So the hot buffer must stay SHORT (live delivery + reconnect only), and\n * durable storage must serve history. That only works if durable storage\n * actually HAS the in-flight turn — which, before this module, it did not: the\n * assistant row was written once, after the stream drained. A viewer arriving\n * mid-turn past the hot window read an empty transcript.\n *\n * This module closes that gap: the assistant row is inserted early and patched\n * on a coalesced cadence, so the durable transcript is at most one interval\n * (default 2 s) behind the live stream and the hot buffer never has to be the\n * history tier.\n *\n * Mechanism only. It owns no vocabulary: the caller supplies the snapshot\n * function, the store, and the deterministic row id.\n *\n * Four properties the cadence guarantees:\n * - **Time-floored.** At most one write per `intervalMs`, never one per token.\n * - **Dirty-gated.** Only content-bearing events arm a write; heartbeats,\n * status pings, and lifecycle envelopes never do.\n * - **Single-flight.** A write already in flight suppresses the next trigger\n * instead of queueing; the final write is authoritative regardless of how\n * many drafts landed.\n * - **Best-effort.** A store failure is logged and swallowed — a durability\n * optimization must never kill a healthy stream (the same rule\n * `withDurableChatProjection` already states).\n */\n\nimport type { ChatMessageValues } from '../chat-store/core'\nimport { toChatMessageParts, type ChatMessagePart } from '../chat-store/parts'\nimport type { ChatTurnUsage } from './turn-routes'\n\n/** Message row shape the writer reads back when re-entering a turn. */\nexport interface DraftStoredMessage extends Pick<AssistantRowValues, keyof ChatTurnUsage> {\n id: string\n role: 'user' | 'assistant' | 'system' | 'tool'\n content: string\n parts?: ChatMessagePart[] | null\n model?: string | null\n requestedModel?: string | null\n servedModel?: string | null\n servedProvider?: string | null\n servedSource?: string | null\n}\n\n/** Values written to the assistant row — the intersection of the append and\n * patch shapes, so one snapshot serves both. */\nexport interface AssistantRowValues extends ChatMessageValues {}\n\n/** The store capability incremental persistence needs on top of\n * `appendMessage`. A store without `updateMessage` cannot patch a row, so it\n * cannot draft at all — the caller keeps today's single-write behavior. */\nexport interface AssistantDraftStore {\n listMessages(threadId: string): Promise<DraftStoredMessage[]>\n appendMessage(input: AssistantRowValues & {\n id?: string\n threadId: string\n role: 'user' | 'assistant'\n }): Promise<unknown>\n updateMessage?(id: string, patch: AssistantRowValues): Promise<unknown>\n deleteMessage?(id: string): Promise<unknown>\n}\n\n/** Live snapshot of the assistant body, taken from the producer's own\n * accumulators. `parts` is the DRAFT projection (`draftParts()`), never the\n * finalized one — see `draftAssistantParts`. */\nexport interface AssistantDraftSnapshot {\n content: string\n parts?: Array<Record<string, unknown>>\n usage?: ChatTurnUsage\n model?: string\n}\n\n/** Product-tunable cadence. Defaults are stated on each field; a product with\n * a chattier or heavier workload moves them without forking the writer. */\nexport interface DraftPersistenceTuning {\n /** Minimum wall-clock gap between draft writes, in ms. Default 2000.\n *\n * Justification for 2 s, from a measured tool-heavy production run (517\n * stream events over ~90 s wall = ~5.7 events/s): a 2 s floor with the\n * dirty gate turns 517 candidate writes into <= 45, while leaving the\n * durable row at most 2 s stale — an order of magnitude below the time it\n * takes a viewer to open a tab and render, so a late viewer never perceives\n * the lag. Fleet arithmetic at 10k concurrent 60 s runs: <= 30 updates per\n * run x 167 run-starts/s = ~334 row-updates/s spread over per-tenant\n * shards. Lower it and write amplification grows with no perceptible\n * freshness gain; raise it past ~5 s and a late viewer starts seeing a\n * visibly truncated answer. */\n intervalMs?: number\n /** Serialized-parts size (bytes) past which the interval backs off, so a\n * turn accumulating a megabyte-scale `parts` blob does not rewrite it every\n * interval. Default 262144 (256 KiB) -> interval x 2.5; ten times that ->\n * interval x 5. The final write is never throttled. */\n backoffBytes?: number\n /** Per-tool-part output cap applied to DRAFTS ONLY (bytes). A tool returning\n * a large blob would otherwise be rewritten in full on every draft. The\n * final write always carries the untruncated value. Default 32768 (32 KiB);\n * 0 disables truncation. */\n maxDraftToolOutputBytes?: number\n}\n\n/** Define the inputs required to construct an assistant draft writer */\nexport interface AssistantDraftWriterOptions extends DraftPersistenceTuning {\n store: AssistantDraftStore\n threadId: string\n /** DETERMINISTIC row id for this turn's assistant message — the whole\n * idempotency mechanism. Derived from the turn's existing identity\n * (`deriveExecutionId` in the interactive lane, the turn id in the detached\n * lane), so a re-entered turn addresses the SAME row: the writer looks the\n * id up before its first insert and patches what it finds. */\n messageId: string\n /** Read the producer's live accumulators. Returns null before the producer\n * is resolved (the assembly defers box resolution into the first pull). */\n snapshot(): AssistantDraftSnapshot | null\n /** Pre-persist text transform (`/redact`'s `redactPII`). Applied to the\n * draft's scalar content AND every draft text part — parity with the final\n * write, or incremental persistence would re-open the at-rest PII leak that\n * transform closed, just seconds earlier and on every turn. */\n transformText?(text: string): string | Promise<string>\n log?: (message: string, meta?: Record<string, unknown>) => void\n}\n\n/** Coalescing writer that keeps one durable assistant row in step with a\n * streaming turn. Created per turn; not reusable. */\nexport interface AssistantDraftWriter {\n /** Arm/trigger a draft write from one engine event. Synchronous by design —\n * the write itself is fire-and-forget so the stream is never blocked on\n * store latency. */\n notify(event: { type?: unknown }): void\n /** Stop drafting and settle any in-flight write. Called before the final\n * write so a late draft can never clobber the authoritative row. */\n close(): Promise<void>\n /** Write the AUTHORITATIVE completion values onto this turn's row —\n * insert-or-patch under the same deterministic id, un-throttled and\n * un-truncated. Errors propagate: the final write is the one that must not\n * fail silently. Implies {@link close}. */\n finalize(values: AssistantRowValues): Promise<void>\n /** The durable row this turn is writing, once one exists. */\n rowId(): string | undefined\n /** Retract the row for a turn that produced nothing (mirrors the final\n * write's empty-turn skip, which leaves no row at all today). Also retracts\n * a row a PREVIOUS attempt left behind, so a re-entered turn that ends\n * empty converges on \"no row\" rather than a stale partial. */\n discard(): Promise<void>\n /** Diagnostics: how many draft writes actually reached the store. */\n writeCount(): number\n}\n\n/** Event types that carry assistant content and therefore arm a draft write.\n * An allowlist on purpose: an unknown type (a product heartbeat, a bespoke\n * passthrough) must NEVER arm a write, or a silent producer would rewrite the\n * same row forever. */\nconst CONTENT_EVENT_TYPES: ReadonlySet<string> = new Set([\n 'text',\n 'reasoning',\n 'tool_call',\n 'tool_result',\n 'usage',\n 'notice',\n 'error',\n 'file',\n 'interaction',\n 'interaction.cancel',\n 'plan.submitted',\n 'message.part.updated',\n])\n\nconst DEFAULT_INTERVAL_MS = 2000\nconst DEFAULT_BACKOFF_BYTES = 262144\nconst DEFAULT_MAX_DRAFT_TOOL_OUTPUT_BYTES = 32768\n\n/** True when this event should arm a draft write. */\nexport function isDraftContentEvent(event: { type?: unknown }): boolean {\n return typeof event?.type === 'string' && CONTENT_EVENT_TYPES.has(event.type)\n}\n\n/** Caps one tool part's `output` for a DRAFT write. The value is replaced by a\n * truncated string plus a marker, so a reader can tell a clipped draft from a\n * real short output; the final write restores the untruncated value. */\nfunction capDraftToolOutput(part: Record<string, unknown>, maxBytes: number): Record<string, unknown> {\n if (maxBytes <= 0) return part\n if (String(part.type ?? '') !== 'tool') return part\n const state = part.state\n if (!state || typeof state !== 'object') return part\n const record = state as Record<string, unknown>\n const output = record.output\n if (output === undefined || output === null) return part\n const serialized = typeof output === 'string' ? output : safeStringify(output)\n if (serialized.length <= maxBytes) return part\n const metadata = (record.metadata && typeof record.metadata === 'object' ? record.metadata : {}) as Record<string, unknown>\n return {\n ...part,\n state: {\n ...record,\n output: `${serialized.slice(0, maxBytes)}…[draft-truncated ${serialized.length - maxBytes} chars]`,\n metadata: { ...metadata, draftTruncated: true },\n },\n }\n}\n\nfunction safeStringify(value: unknown): string {\n try {\n return JSON.stringify(value) ?? ''\n } catch {\n return String(value)\n }\n}\n\n/** Build the coalescing draft writer for one turn. */\nexport function createAssistantDraftWriter(options: AssistantDraftWriterOptions): AssistantDraftWriter {\n const log = options.log ?? (() => {})\n const baseIntervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS\n const backoffBytes = options.backoffBytes ?? DEFAULT_BACKOFF_BYTES\n const maxToolOutput = options.maxDraftToolOutputBytes ?? DEFAULT_MAX_DRAFT_TOOL_OUTPUT_BYTES\n\n let dirty = false\n let closed = false\n let inFlight: Promise<void> | undefined\n let lastWriteAt = 0\n let lastBlobBytes = 0\n let rowId: string | undefined\n let writes = 0\n\n /** Interval for the NEXT write, backed off by the size of the last blob\n * written — a turn accumulating a huge parts array rewrites it less often. */\n function currentIntervalMs(): number {\n if (lastBlobBytes >= backoffBytes * 10) return baseIntervalMs * 5\n if (lastBlobBytes >= backoffBytes) return Math.round(baseIntervalMs * 2.5)\n return baseIntervalMs\n }\n\n async function projectValues(snapshot: AssistantDraftSnapshot): Promise<AssistantRowValues> {\n const transform = options.transformText\n const content = transform ? await transform(snapshot.content) : snapshot.content\n let parts: ChatMessagePart[] | undefined\n if (snapshot.parts) {\n const capped = snapshot.parts.map((part) => capDraftToolOutput(part, maxToolOutput))\n const redacted = transform\n ? await Promise.all(\n capped.map(async (part) =>\n String((part as { type?: unknown }).type ?? '') === 'text'\n ? { ...part, text: await transform(String((part as { text?: unknown }).text ?? '')) }\n : part,\n ),\n )\n : capped\n parts = toChatMessageParts(redacted)\n }\n const usage = snapshot.usage ?? {}\n return {\n content,\n ...(parts && parts.length > 0 ? { parts } : {}),\n ...(snapshot.model ? { model: snapshot.model } : {}),\n ...(usage.inputTokens !== undefined ? { inputTokens: usage.inputTokens } : {}),\n ...(usage.outputTokens !== undefined ? { outputTokens: usage.outputTokens } : {}),\n ...(usage.reasoningTokens !== undefined ? { reasoningTokens: usage.reasoningTokens } : {}),\n ...(usage.cacheReadTokens !== undefined ? { cacheReadTokens: usage.cacheReadTokens } : {}),\n ...(usage.cacheWriteTokens !== undefined ? { cacheWriteTokens: usage.cacheWriteTokens } : {}),\n ...(usage.costUsd !== undefined ? { costUsd: usage.costUsd } : {}),\n }\n }\n\n /** Adopt the row a PREVIOUS attempt at this turn already inserted, if any.\n * This lookup — by the deterministic id, through the store's ordinary read\n * — is the whole crash-safety mechanism: no new state, no extra column, no\n * second index. */\n async function adoptRow(): Promise<string | undefined> {\n if (rowId) return rowId\n const existing = (await options.store.listMessages(options.threadId)).find(\n (message) => message.id === options.messageId,\n )\n if (existing) rowId = existing.id\n return rowId\n }\n\n /** Insert-or-patch one set of values onto this turn's single row. */\n async function writeOnce(values: AssistantRowValues): Promise<void> {\n if (await adoptRow()) {\n await options.store.updateMessage!(rowId!, values)\n writes += 1\n return\n }\n const inserted = await options.store.appendMessage({\n id: options.messageId,\n threadId: options.threadId,\n role: 'assistant',\n ...values,\n })\n // The `?? options.messageId` tail is valid HERE and only here: this writer\n // supplied the id, so a store that returns nothing still wrote that row.\n // A caller that did not assign an id has no such fallback — which is why\n // `rowIdOf` deliberately stops at the honest read.\n rowId = rowIdOf(inserted) ?? options.messageId\n writes += 1\n }\n\n function trigger(): void {\n if (closed) return\n if (!dirty) return\n // Single-flight: a write already in flight SUPPRESSES this trigger rather\n // than queueing behind it. `dirty` stays armed, so the next event after it\n // lands writes the newer snapshot — one write is never spent on state a\n // later one supersedes.\n if (inFlight) return\n const now = Date.now()\n // The first content event writes immediately (a late viewer sees a row at\n // once); the time floor governs every write after it.\n if (lastWriteAt !== 0 && now - lastWriteAt < currentIntervalMs()) return\n const snapshot = options.snapshot()\n if (!snapshot) return\n // Nothing to persist yet: an armed-but-empty snapshot (first event is a\n // tool call with no text and no parts) would insert a blank row.\n if (!snapshot.content && (!snapshot.parts || snapshot.parts.length === 0)) return\n dirty = false\n lastWriteAt = now\n inFlight = (async () => {\n try {\n const values = await projectValues(snapshot)\n lastBlobBytes = values.parts ? safeStringify(values.parts).length : 0\n await writeOnce(values)\n } catch (err) {\n // Best-effort by contract: a store outage degrades freshness for late\n // viewers, it does not fail a healthy turn.\n log('[chat-routes] incremental assistant persistence failed', {\n messageId: options.messageId,\n error: err instanceof Error ? err.message : String(err),\n })\n } finally {\n inFlight = undefined\n // A trigger that arrived while this write was in flight left `dirty`\n // armed with a NEWER snapshot. Re-run it here or that state would sit\n // unwritten until the next content event — and if this was the last\n // event of a quiet stretch, until the final write.\n if (dirty && !closed) trigger()\n }\n })()\n }\n\n return {\n notify(event) {\n if (closed) return\n if (isDraftContentEvent(event)) dirty = true\n trigger()\n },\n async close() {\n closed = true\n if (inFlight) await inFlight\n },\n async finalize(values) {\n closed = true\n if (inFlight) await inFlight\n await writeOnce(values)\n },\n rowId: () => rowId,\n async discard() {\n closed = true\n if (inFlight) await inFlight\n if (!options.store.deleteMessage) return\n try {\n if (!(await adoptRow())) return\n await options.store.deleteMessage(rowId!)\n rowId = undefined\n } catch (err) {\n log('[chat-routes] draft assistant row discard failed', {\n messageId: options.messageId,\n error: err instanceof Error ? err.message : String(err),\n })\n }\n },\n writeCount: () => writes,\n }\n}\n\n/** True when a store can support incremental persistence at all. Without\n * `updateMessage` a draft row could never be patched, so the caller keeps\n * today's exact single-write behavior. */\nexport function storeSupportsDraftPersistence(store: AssistantDraftStore): boolean {\n return typeof store.updateMessage === 'function'\n}\n\n/** The row id an `appendMessage` actually returned, or `null` when the store\n * returned nothing usable. `ChatTurnMessageStore.appendMessage` is typed\n * `Promise<unknown>` so a product adapter is free to resolve `void`; every\n * caller that wants to NAME the row it just wrote has to read defensively.\n *\n * Deliberately no fallback to a caller-assigned id — see `writeOnce`, which\n * adds its own. A caller that let the store mint the id has nothing to fall\n * back TO, and guessing one would report a row that may not exist. */\nexport function rowIdOf(inserted: unknown): string | null {\n const id = (inserted as { id?: unknown } | null | undefined)?.id\n return typeof id === 'string' && id ? id : null\n}\n\n/** The default deterministic assistant-row id for a turn. Readable on purpose\n * (an operator grepping a transcript row id finds the run), and stable across\n * re-entries because every input already is. */\nexport function assistantRowIdForTurn(turnKey: string): string {\n return `assistant:${turnKey}`\n}\n","import { asRecord, type JsonRecord } from '../stream/index'\nimport type { ChatTurnUsage } from './turn-routes'\n\n/** Add one canonical Sandbox `step-finish` receipt to a turn total. */\nexport function addStepFinishUsage(part: JsonRecord, usage: ChatTurnUsage): void {\n const tokens = asRecord(part.tokens)\n if (tokens) {\n const cache = asRecord(tokens.cache)\n const add = (current: number | undefined, value: unknown): number | undefined => {\n const n = Number(value)\n if (!Number.isFinite(n)) return current\n return (current ?? 0) + n\n }\n usage.inputTokens = add(usage.inputTokens, tokens.input)\n usage.outputTokens = add(usage.outputTokens, tokens.output)\n usage.reasoningTokens = add(usage.reasoningTokens, tokens.reasoning)\n if (cache) {\n usage.cacheReadTokens = add(usage.cacheReadTokens, cache.read)\n usage.cacheWriteTokens = add(usage.cacheWriteTokens, cache.write)\n }\n }\n const cost = Number(part.cost)\n if (Number.isFinite(cost)) usage.costUsd = (usage.costUsd ?? 0) + cost\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/operator/contract.ts","../src/operator/client.ts"],"sourcesContent":["/**\n * The standard operator API contract every agent app mounts at\n * `/api/operator/v1`. An outside agent (a Claude Code or Codex session, or\n * another app's agent) holds one scoped key per app and drives workspaces\n * through these routes; the app supplies only storage and execution.\n */\n\nimport type { ChatAttachmentInput } from '../chat-routes/wire.js'\n\nexport const OPERATOR_API_VERSION = 'v1'\nexport const OPERATOR_API_BASE_PATH = '/api/operator/v1'\n\n/** Key permissions, with the labels an app's API access page shows. */\nexport const OPERATOR_ACCESS = [\n {\n scope: 'operator:read',\n label: 'Read workspaces',\n description: 'Read workspaces, conversations, files, approvals, scorecards, and run status.',\n },\n {\n scope: 'operator:write',\n label: 'Create and edit',\n description: 'Create workspaces and conversations, and write files.',\n },\n {\n scope: 'operator:run',\n requires: ['operator:read'],\n label: 'Run agents',\n description: 'Requires read access. Start, continue, and interrupt agent turns, and answer their questions and tool-permission requests. Agents can modify workspace files. Uses your plan and budget.',\n },\n] as const\n\nexport type OperatorScope = typeof OPERATOR_ACCESS[number]['scope']\n\nexport const OPERATOR_API_SCOPES: readonly OperatorScope[] = OPERATOR_ACCESS.map(({ scope }) => scope)\n\nexport const OPERATOR_SCOPE_DEPENDENCIES: Readonly<Record<string, readonly string[]>> = Object.fromEntries(\n OPERATOR_ACCESS.flatMap((option) => 'requires' in option ? [[option.scope, option.requires]] : []),\n)\n\n/**\n * A key carrying one or more of these scopes reaches only the named\n * workspaces and cannot create workspaces. Keys without one keep the owner's\n * ordinary workspace access.\n */\nexport const OPERATOR_WORKSPACE_SCOPE_PREFIX = 'operator:workspace:'\n\nconst WORKSPACE_ID = /^[A-Za-z0-9_-]{1,128}$/\n\nexport function operatorWorkspaceScope(workspaceId: string): string {\n if (!WORKSPACE_ID.test(workspaceId)) throw new TypeError('Workspace ids contain only letters, digits, - and _')\n return `${OPERATOR_WORKSPACE_SCOPE_PREFIX}${workspaceId}`\n}\n\n/** The workspaces a key is restricted to, or null when it is unrestricted. A malformed restriction restricts to nothing. */\nexport function operatorKeyWorkspaces(scopes: readonly string[]): readonly string[] | null {\n const restricted = scopes.filter((scope) => scope.startsWith(OPERATOR_WORKSPACE_SCOPE_PREFIX))\n if (restricted.length === 0) return null\n return restricted\n .map((scope) => scope.slice(OPERATOR_WORKSPACE_SCOPE_PREFIX.length))\n .filter((id) => WORKSPACE_ID.test(id))\n}\n\nexport type OperatorRole = 'owner' | 'admin' | 'editor' | 'viewer'\n\nexport interface OperatorAppInfo {\n /** Stable app identifier, such as `gtm` or `tax`. */\n app: string\n name: string\n apiVersion: typeof OPERATOR_API_VERSION\n /** Optional operations this app implements; absent ones answer 501. */\n capabilities: OperatorCapability[]\n}\n\nexport type OperatorCapability =\n | 'turns.attachments'\n | 'turns.cancel'\n | 'workspaces.create'\n | 'threads.read'\n | 'files.read'\n | 'journal.read'\n | 'assets.read'\n | 'scorecard.read'\n\nexport interface OperatorPrincipalInfo {\n keyId: string\n scopes: string[]\n /** Workspaces the key is restricted to, or null for the owner's ordinary access. */\n workspaces: string[] | null\n}\n\nexport interface OperatorWorkspace {\n id: string\n name: string\n role?: OperatorRole\n /** Browser link for a person to open the workspace. */\n url?: string\n createdAt?: string\n}\n\nexport interface OperatorThread {\n id: string\n title: string\n updatedAt?: string\n url?: string\n}\n\n/**\n * `succeeded` and `failed` are settled. `input-required` waits on a person or\n * an operator decision listed in `approvals`. `unknown` means the app cannot\n * establish the state; it is never evidence of success.\n */\nexport type OperatorTurnState = 'queued' | 'working' | 'input-required' | 'succeeded' | 'failed' | 'unknown'\n\nexport const OPERATOR_SETTLED_STATES: readonly OperatorTurnState[] = ['succeeded', 'failed']\n\n/** `failure.code` of a turn that settled because it was cancelled before it finished. */\nexport const OPERATOR_TURN_CANCELLED_CODE = 'turn.cancelled'\n\nexport interface OperatorAssetRef {\n id: string\n /** Root-relative operator route that returns the bytes. */\n path: string\n mediaType?: string\n name?: string\n}\n\nexport interface OperatorFileChange {\n path: string\n action: 'created' | 'updated' | 'deleted' | 'changed'\n}\n\nexport type OperatorApprovalKind = 'question' | 'permission' | 'plan' | 'hub' | 'asset' | 'review'\n\nexport interface OperatorApproval {\n id: string\n kind: OperatorApprovalKind\n title: string\n detail?: string\n threadId?: string\n /** Browser link where an authorized person decides it. */\n url?: string\n createdAt?: string\n expiresAt?: string\n /** Who can decide: an operator key with run access, an editor, or the workspace owner. */\n decidedBy: 'operator' | 'editor' | 'owner'\n}\n\nexport interface OperatorTurn {\n workspaceId: string\n threadId: string\n turnId: string\n state: OperatorTurnState\n url?: string\n executionId?: string\n model?: string\n costUsd?: number\n /** Producer-recorded basis for costUsd; catalog is an estimate, ledger is settlement evidence. */\n costSource?: 'ledger' | 'catalog' | 'reported' | 'unreported' | 'subscription'\n /** Producer-recorded billing path, not the identity of a payer. */\n billingOwner?: 'router' | 'sandbox-router' | 'subscription'\n /** Producer-recorded credential path; never inferred from costUsd or billingOwner. */\n credentialSource?: 'router' | 'subscription'\n /** Opaque producer settlement reference; its presence alone does not prove a charge or zero provider cost. */\n settlementRecord?: string\n /**\n * Token usage the app stored on the turn's reply; `operatorTurnUsage` maps\n * a chat-store row to it.\n * - `inputTokens`: prompt tokens NOT read from the provider's cache. Unlike\n * the turn trace's summary, it never includes cache reads; it is omitted\n * when the row's split is ambiguous, including when the row records no\n * cache count (see `operatorTurnUsage`).\n * - `cachedInputTokens`: prompt tokens read from the provider's cache (the\n * row's `cacheReadTokens`); with both present the whole prompt is\n * `inputTokens + cachedInputTokens`. When absent the cache share is unknown.\n * - `outputTokens`: completion tokens.\n * Each field is present only when known; never a guessed zero.\n */\n usage?: { inputTokens?: number; cachedInputTokens?: number; outputTokens?: number }\n completedAt?: string\n /** The settled answer; null until the turn settles. */\n reply: { content: string; mediaType: string } | null\n failure: { code?: string; message: string } | null\n assets: OperatorAssetRef[]\n files: OperatorFileChange[]\n /** Decisions open on this turn's conversation. */\n approvals: OperatorApproval[]\n}\n\nexport interface OperatorJournalEntry {\n path: string\n /** `YYYY-MM-DD` the entry belongs to. */\n date: string\n title?: string\n updatedAt?: string\n}\n\nexport interface OperatorFileEntry {\n path: string\n updatedAt?: string\n bytes?: number\n}\n\nexport interface OperatorFile {\n path: string\n content: string\n mediaType: string\n revision?: string\n}\n\nexport interface OperatorMetric {\n key: string\n label: string\n /** Null when the app has no measurement; never a guessed zero. */\n value: number | null\n unit: 'count' | 'usd' | 'ratio' | 'ms'\n note?: string\n}\n\nexport interface OperatorScorecard {\n workspaceId: string\n generatedAt: string\n window: { start: string; end: string; days: number }\n /** Work the agent did in the window. */\n metrics: OperatorMetric[]\n /** Business results recorded in the window, such as clicks, signups, or replies. */\n outcomes: OperatorMetric[]\n /** How the numbers are measured and what they exclude. */\n measurement: string\n}\n\nexport interface OperatorErrorBody {\n error: string\n code: string\n retryable?: boolean\n}\n\nexport interface StartTurnInput {\n /** Client-generated UUID. Reuse it to retry the same turn; it never starts twice. */\n turnId: string\n content: string\n /** Continue this conversation; omitted starts a new one. */\n threadId?: string\n /** Title for a new conversation. */\n title?: string\n model?: string\n /**\n * Files uploaded to this workspace ahead of the turn, as the app's\n * attachment upload route returned them in `{ files }`. They reach the\n * agent exactly as browser-composer attachments do; the app re-checks each\n * path against the workspace's own store. At most the app's\n * `maxAttachments` entries, `ATTACHMENT_MAX_COUNT` (`/chat-routes`) unless\n * the app sets one. Apps without the `turns.attachments` capability refuse\n * them.\n */\n attachments?: ChatAttachmentInput[]\n}\n\n/** Route table: method, path pattern under the base path, and required scopes. */\nexport const OPERATOR_ROUTES = [\n { id: 'describe', method: 'GET', path: '', scopes: ['operator:read'] },\n { id: 'workspaces.list', method: 'GET', path: '/workspaces', scopes: ['operator:read'] },\n { id: 'workspaces.create', method: 'POST', path: '/workspaces', scopes: ['operator:write'] },\n { id: 'workspaces.get', method: 'GET', path: '/workspaces/:workspaceId', scopes: ['operator:read'] },\n { id: 'turns.start', method: 'POST', path: '/workspaces/:workspaceId/turns', scopes: ['operator:read', 'operator:run'] },\n { id: 'threads.list', method: 'GET', path: '/workspaces/:workspaceId/threads', scopes: ['operator:read'] },\n { id: 'threads.get', method: 'GET', path: '/workspaces/:workspaceId/threads/:threadId', scopes: ['operator:read'] },\n { id: 'turns.get', method: 'GET', path: '/workspaces/:workspaceId/threads/:threadId/turns/:turnId', scopes: ['operator:read'] },\n { id: 'turns.cancel', method: 'POST', path: '/workspaces/:workspaceId/threads/:threadId/turns/:turnId/cancel', scopes: ['operator:read', 'operator:run'] },\n { id: 'approvals.list', method: 'GET', path: '/workspaces/:workspaceId/approvals', scopes: ['operator:read'] },\n { id: 'journal.list', method: 'GET', path: '/workspaces/:workspaceId/journal', scopes: ['operator:read'] },\n { id: 'files.list', method: 'GET', path: '/workspaces/:workspaceId/files', scopes: ['operator:read'] },\n { id: 'files.read', method: 'GET', path: '/workspaces/:workspaceId/file', scopes: ['operator:read'] },\n { id: 'assets.read', method: 'GET', path: '/workspaces/:workspaceId/assets/:assetId', scopes: ['operator:read'] },\n { id: 'scorecard.get', method: 'GET', path: '/workspaces/:workspaceId/scorecard', scopes: ['operator:read'] },\n] as const satisfies ReadonlyArray<{ id: string; method: 'GET' | 'POST'; path: string; scopes: readonly OperatorScope[] }>\n\nexport type OperatorRouteId = typeof OPERATOR_ROUTES[number]['id']\n\nconst SEGMENT = /^[A-Za-z0-9_:.%-]{1,256}$/\n\n/** Match a pathname under the base path to its route and decoded parameters. */\nexport function matchOperatorRoute(\n method: string,\n pathname: string,\n basePath: string = OPERATOR_API_BASE_PATH,\n): { route: typeof OPERATOR_ROUTES[number]; params: Record<string, string> } | null {\n if (pathname !== basePath && !pathname.startsWith(`${basePath}/`)) return null\n const rest = pathname.slice(basePath.length).replace(/\\/$/, '')\n const actual = rest ? rest.split('/').slice(1) : []\n for (const route of OPERATOR_ROUTES) {\n if (route.method !== method) continue\n const pattern = route.path ? route.path.split('/').slice(1) : []\n if (pattern.length !== actual.length) continue\n const params: Record<string, string> = {}\n let matched = true\n for (let index = 0; index < pattern.length; index++) {\n const expected = pattern[index]!\n const segment = actual[index]!\n if (expected.startsWith(':')) {\n if (!SEGMENT.test(segment)) { matched = false; break }\n let decoded: string\n try { decoded = decodeURIComponent(segment) } catch { matched = false; break }\n if (!decoded || decoded.includes('/')) { matched = false; break }\n params[expected.slice(1)] = decoded\n } else if (expected !== segment) {\n matched = false\n break\n }\n }\n if (matched) return { route, params }\n }\n return null\n}\n","import { createApiKeyFetch } from '../web/api-key-fetch.js'\nimport {\n OPERATOR_API_BASE_PATH,\n type OperatorApproval,\n type OperatorAppInfo,\n type OperatorErrorBody,\n type OperatorFile,\n type OperatorFileEntry,\n type OperatorJournalEntry,\n type OperatorPrincipalInfo,\n type OperatorScorecard,\n type OperatorThread,\n type OperatorTurn,\n type OperatorWorkspace,\n type StartTurnInput,\n} from './contract.js'\n\nexport type OperatorResult<T> =\n | { succeeded: true; value: T }\n | { succeeded: false; status: number; code: string; error: string; retryable: boolean }\n\nexport interface OperatorClientOptions {\n /** The app's origin, such as `https://gtm.tangle.tools`. */\n origin: string\n /** Resolve the key from trusted secret storage on each request; never from model output. */\n getApiKey(): string | Promise<string>\n fetchImpl?: typeof fetch\n allowHttpLoopback?: boolean\n basePath?: string\n}\n\nexport interface WaitForTurnOptions {\n /** Total time to follow the turn. */\n timeoutMs: number\n /** Server hold per request, in seconds; the server caps it. */\n waitSeconds?: number\n signal?: AbortSignal\n}\n\nexport interface OperatorClient {\n describe(): Promise<OperatorResult<{ app: OperatorAppInfo; principal: OperatorPrincipalInfo }>>\n listWorkspaces(): Promise<OperatorResult<OperatorWorkspace[]>>\n createWorkspace(input: { name: string }): Promise<OperatorResult<OperatorWorkspace>>\n getWorkspace(workspaceId: string): Promise<OperatorResult<OperatorWorkspace>>\n /** Omitting turnId generates one; retry with the returned turn's id. */\n startTurn(workspaceId: string, input: Omit<StartTurnInput, 'turnId'> & { turnId?: string }): Promise<OperatorResult<OperatorTurn>>\n getTurn(workspaceId: string, threadId: string, turnId: string, options?: { waitSeconds?: number; signal?: AbortSignal }): Promise<OperatorResult<OperatorTurn>>\n /**\n * Stop a turn. A settled turn comes back as it settled; otherwise the app\n * has been asked to stop it, and the server holds up to `waitSeconds` for\n * the turn to settle `failed` with `OPERATOR_TURN_CANCELLED_CODE`. Read it\n * with `getTurn` or `waitForTurn` until it settles.\n */\n cancelTurn(workspaceId: string, threadId: string, turnId: string, options?: { waitSeconds?: number; signal?: AbortSignal }): Promise<OperatorResult<OperatorTurn>>\n /** Follow until the turn settles, waits on a decision, or the timeout passes; the last read is returned. */\n waitForTurn(workspaceId: string, threadId: string, turnId: string, options: WaitForTurnOptions): Promise<OperatorResult<OperatorTurn>>\n listThreads(workspaceId: string, query?: { cursor?: string; limit?: number }): Promise<OperatorResult<{ threads: OperatorThread[]; nextCursor: string | null }>>\n getThread(workspaceId: string, threadId: string): Promise<OperatorResult<{ thread: OperatorThread; latestTurn: OperatorTurn | null }>>\n listApprovals(workspaceId: string): Promise<OperatorResult<OperatorApproval[]>>\n listJournal(workspaceId: string, query?: { days?: number }): Promise<OperatorResult<OperatorJournalEntry[]>>\n listFiles(workspaceId: string, query?: { prefix?: string }): Promise<OperatorResult<OperatorFileEntry[]>>\n readFile(workspaceId: string, path: string): Promise<OperatorResult<OperatorFile>>\n /** The raw asset response; the caller reads and bounds its body. */\n readAsset(workspaceId: string, assetId: string, init?: { signal?: AbortSignal }): Promise<OperatorResult<Response>>\n getScorecard(workspaceId: string, query?: { days?: number }): Promise<OperatorResult<OperatorScorecard>>\n}\n\nfunction segment(value: string): string {\n return encodeURIComponent(value)\n}\n\nasync function failure(response: Response): Promise<OperatorResult<never>> {\n let body: Partial<OperatorErrorBody> = {}\n try { body = await response.json() as Partial<OperatorErrorBody> } catch { /* A non-JSON refusal keeps its status. */ }\n return {\n succeeded: false,\n status: response.status,\n code: typeof body.code === 'string' ? body.code : `http_${response.status}`,\n error: typeof body.error === 'string' ? body.error : `HTTP ${response.status}`,\n retryable: body.retryable === true || response.status === 429 || response.status >= 500,\n }\n}\n\nfunction transportFailure(error: unknown): OperatorResult<never> {\n const aborted = error instanceof Error && error.name === 'AbortError'\n return {\n succeeded: false,\n status: 0,\n code: aborted ? 'operator.aborted' : 'operator.transport_failed',\n // createApiKeyFetch never forwards transport diagnostics, which could carry the key.\n error: error instanceof Error ? error.message : 'Operator transport failed',\n retryable: !aborted,\n }\n}\n\nconst SETTLED = new Set(['succeeded', 'failed', 'input-required'])\n\n/** A typed client for one app's operator API. */\nexport function createOperatorClient(options: OperatorClientOptions): OperatorClient {\n const basePath = (options.basePath ?? OPERATOR_API_BASE_PATH).replace(/\\/$/, '')\n const request = createApiKeyFetch({\n origin: options.origin,\n getApiKey: options.getApiKey,\n ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),\n ...(options.allowHttpLoopback ? { allowHttpLoopback: true } : {}),\n })\n\n async function call<T>(\n path: string,\n pick: (body: Record<string, unknown>) => T,\n init: RequestInit = {},\n ): Promise<OperatorResult<T>> {\n let response: Response\n try {\n response = await request(`${basePath}${path}`, {\n ...init,\n headers: { accept: 'application/json', ...(init.body ? { 'content-type': 'application/json' } : {}) },\n })\n } catch (error) {\n return transportFailure(error)\n }\n if (!response.ok) return failure(response)\n try {\n return { succeeded: true, value: pick(await response.json() as Record<string, unknown>) }\n } catch {\n return { succeeded: false, status: response.status, code: 'operator.invalid_response', error: 'The response was not the expected JSON', retryable: true }\n }\n }\n\n const query = (params: Record<string, string | number | undefined>) => {\n const search = new URLSearchParams()\n for (const [name, value] of Object.entries(params)) if (value !== undefined && value !== '') search.set(name, String(value))\n const text = search.toString()\n return text ? `?${text}` : ''\n }\n\n const client: OperatorClient = {\n describe: () => call('', (body) => body as unknown as { app: OperatorAppInfo; principal: OperatorPrincipalInfo }),\n listWorkspaces: () => call('/workspaces', (body) => body.workspaces as OperatorWorkspace[]),\n createWorkspace: (input) => call('/workspaces', (body) => body.workspace as OperatorWorkspace, {\n method: 'POST', body: JSON.stringify({ name: input.name }),\n }),\n getWorkspace: (workspaceId) => call(`/workspaces/${segment(workspaceId)}`, (body) => body.workspace as OperatorWorkspace),\n startTurn: (workspaceId, input) => call(`/workspaces/${segment(workspaceId)}/turns`, (body) => body.turn as OperatorTurn, {\n method: 'POST', body: JSON.stringify({ ...input, turnId: input.turnId ?? crypto.randomUUID() }),\n }),\n getTurn: (workspaceId, threadId, turnId, opts = {}) => call(\n `/workspaces/${segment(workspaceId)}/threads/${segment(threadId)}/turns/${segment(turnId)}${query({ wait: opts.waitSeconds })}`,\n (body) => body.turn as OperatorTurn,\n opts.signal ? { signal: opts.signal } : {},\n ),\n cancelTurn: (workspaceId, threadId, turnId, opts = {}) => call(\n `/workspaces/${segment(workspaceId)}/threads/${segment(threadId)}/turns/${segment(turnId)}/cancel${query({ wait: opts.waitSeconds })}`,\n (body) => body.turn as OperatorTurn,\n { method: 'POST', ...(opts.signal ? { signal: opts.signal } : {}) },\n ),\n async waitForTurn(workspaceId, threadId, turnId, opts) {\n const deadline = Date.now() + opts.timeoutMs\n const waitSeconds = opts.waitSeconds ?? 25\n let last: OperatorResult<OperatorTurn> | null = null\n while (true) {\n const remaining = Math.floor((deadline - Date.now()) / 1000)\n const started = Date.now()\n last = await client.getTurn(workspaceId, threadId, turnId, {\n waitSeconds: Math.max(0, Math.min(waitSeconds, remaining)),\n ...(opts.signal ? { signal: opts.signal } : {}),\n })\n if (!last.succeeded) {\n if (!last.retryable || Date.now() >= deadline || opts.signal?.aborted) return last\n await new Promise((resolve) => setTimeout(resolve, Math.min(5_000, Math.max(0, deadline - Date.now()))))\n continue\n }\n if (SETTLED.has(last.value.state) || last.value.approvals.length > 0) return last\n if (Date.now() >= deadline || opts.signal?.aborted) return last\n // A server that does not hold the read still gets a bounded request rate.\n if (Date.now() - started < 1_000) {\n await new Promise((resolve) => setTimeout(resolve, Math.min(2_000, Math.max(0, deadline - Date.now()))))\n }\n }\n },\n listThreads: (workspaceId, q = {}) => call(\n `/workspaces/${segment(workspaceId)}/threads${query({ cursor: q.cursor, limit: q.limit })}`,\n (body) => ({ threads: body.threads as OperatorThread[], nextCursor: (body.nextCursor as string | null) ?? null }),\n ),\n getThread: (workspaceId, threadId) => call(\n `/workspaces/${segment(workspaceId)}/threads/${segment(threadId)}`,\n (body) => ({ thread: body.thread as OperatorThread, latestTurn: (body.latestTurn as OperatorTurn | null) ?? null }),\n ),\n listApprovals: (workspaceId) => call(`/workspaces/${segment(workspaceId)}/approvals`, (body) => body.approvals as OperatorApproval[]),\n listJournal: (workspaceId, q = {}) => call(\n `/workspaces/${segment(workspaceId)}/journal${query({ days: q.days })}`,\n (body) => body.entries as OperatorJournalEntry[],\n ),\n listFiles: (workspaceId, q = {}) => call(\n `/workspaces/${segment(workspaceId)}/files${query({ prefix: q.prefix })}`,\n (body) => body.files as OperatorFileEntry[],\n ),\n readFile: (workspaceId, path) => call(\n `/workspaces/${segment(workspaceId)}/file${query({ path })}`,\n (body) => body.file as OperatorFile,\n ),\n async readAsset(workspaceId, assetId, init = {}) {\n let response: Response\n try {\n response = await request(`${basePath}/workspaces/${segment(workspaceId)}/assets/${segment(assetId)}`, init.signal ? { signal: init.signal } : {})\n } catch (error) {\n return transportFailure(error)\n }\n if (!response.ok) return failure(response)\n return { succeeded: true, value: response }\n },\n getScorecard: (workspaceId, q = {}) => call(\n `/workspaces/${segment(workspaceId)}/scorecard${query({ days: q.days })}`,\n (body) => body.scorecard as OperatorScorecard,\n ),\n }\n return client\n}\n"],"mappings":"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","names":["segment"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/chat-routes/completed-sandbox-turn.ts","../src/chat-routes/native-completion.ts"],"sourcesContent":["/**\n * Recover a detached Sandbox turn from its durable completed records.\n *\n * A fast detached run can finish before the live event subscriber receives\n * every message-part event. The Sandbox still retains two exact records: a\n * turn-id keyed result cache and the completed assistant message on the\n * session. This adapter joins them without guessing across turns, then returns\n * the same `DetachedTurnFinal` shape `runDetachedTurn` already consumes.\n */\n\nimport type { SandboxInstance, SessionMessage } from '@tangle-network/sandbox'\nimport {\n asRecord,\n asString,\n collapseRedundantTextParts,\n finalizeAssistantParts,\n getPartKey,\n mergePersistedPart,\n normalizePersistedPart,\n type JsonRecord,\n} from '../stream/index'\nimport { addStepFinishUsage } from './sandbox-turn-usage'\nimport type { DetachedTurnFinal } from './detached-turn'\nimport type { ChatTurnModelAttribution, ChatTurnUsage } from './turn-routes'\n\n/** The official Sandbox methods needed for completed-turn recovery. */\nexport type CompletedSandboxTurnSource = Pick<\n SandboxInstance,\n 'findCompletedTurn' | 'session'\n>\n\n/** Options for resolving one exact detached turn. */\nexport interface ReadCompletedSandboxTurnOptions {\n turnId: string\n sessionId: string\n /** Read only session messages newer than this Unix-ms time. A long session\n * holds more than one page of messages, oldest first, so an unbounded read\n * both grows with the session and can miss the newest turn. */\n since?: number\n log?: (message: string, meta?: Record<string, unknown>) => void\n}\n\nfunction finiteNumber(value: unknown): number | undefined {\n if (typeof value === 'number') return Number.isFinite(value) ? value : undefined\n if (typeof value !== 'string' || !value.trim()) return undefined\n const parsed = Number(value)\n return Number.isFinite(parsed) ? parsed : undefined\n}\n\nfunction firstNumber(record: JsonRecord | undefined, keys: string[]): number | undefined {\n for (const key of keys) {\n const value = finiteNumber(record?.[key])\n if (value !== undefined) return value\n }\n return undefined\n}\n\n/** @internal Shared terminal-result decoder; callers must establish exact turn identity. */\nexport function usageFromResult(result: JsonRecord | undefined): ChatTurnUsage {\n const raw = asRecord(result?.usage) ?? asRecord(result?.tokenUsage)\n const inputTokens = firstNumber(raw, ['inputTokens', 'promptTokens', 'input'])\n const outputTokens = firstNumber(raw, ['outputTokens', 'completionTokens', 'output'])\n const reasoningTokens = firstNumber(raw, ['reasoningTokens', 'reasoning'])\n const cacheReadTokens = firstNumber(raw, [\n 'cacheReadTokens',\n 'cacheReadInputTokens',\n 'cacheRead',\n ])\n const cacheWriteTokens = firstNumber(raw, [\n 'cacheWriteTokens',\n 'cacheCreationInputTokens',\n 'cacheWrite',\n ])\n const costUsd = firstNumber(result, ['costUsd', 'totalCostUsd', 'cost'])\n ?? firstNumber(raw, ['costUsd', 'cost'])\n\n return {\n ...(inputTokens !== undefined ? { inputTokens } : {}),\n ...(outputTokens !== undefined ? { outputTokens } : {}),\n ...(reasoningTokens !== undefined ? { reasoningTokens } : {}),\n ...(cacheReadTokens !== undefined ? { cacheReadTokens } : {}),\n ...(cacheWriteTokens !== undefined ? { cacheWriteTokens } : {}),\n ...(costUsd !== undefined ? { costUsd } : {}),\n }\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n return typeof value === 'string' && value.trim() ? value : undefined\n}\n\n/** @internal Attribution travels with the same validated result as content and usage. */\nexport function attributionFromResult(result: Record<string, unknown> | undefined): Pick<\n ChatTurnModelAttribution,\n 'servedModel' | 'servedProvider' | 'servedSource'\n> {\n const metadata = asRecord(result?.metadata)\n const modelAttribution = asRecord(result?.modelAttribution) ?? asRecord(metadata?.modelAttribution)\n const backend = asRecord(result?.effectiveBackend) ?? asRecord(metadata?.effectiveBackend)\n const source = nonEmptyString(result?.servedSource)\n ?? nonEmptyString(modelAttribution?.servedSource)\n ?? nonEmptyString(backend?.source)\n const servedSource = source === 'request' || source === 'environment' || source === 'profile'\n ? source\n : undefined\n const servedModel = nonEmptyString(result?.servedModel)\n ?? nonEmptyString(modelAttribution?.servedModel)\n ?? nonEmptyString(backend?.model)\n const servedProvider = nonEmptyString(result?.servedProvider)\n ?? nonEmptyString(modelAttribution?.servedProvider)\n ?? nonEmptyString(backend?.provider)\n return {\n ...(servedModel ? { servedModel } : {}),\n ...(servedProvider ? { servedProvider } : {}),\n ...(servedSource ? { servedSource } : {}),\n }\n}\n\nfunction textFromResult(result: JsonRecord | undefined): string | undefined {\n return asString(result?.response)\n ?? asString(result?.finalText)\n ?? asString(result?.text)\n ?? asString(result?.output)\n}\n\nfunction completedMessagesForTurn(\n messages: SessionMessage[],\n turnId: string,\n): SessionMessage[] {\n return messages.filter((message) =>\n message.role === 'assistant'\n && message.metadata?.turnId === turnId\n && message.metadata?.interrupted !== true\n && (\n message.metadata?.completed === true\n || message.metadata?.status === 'completed'\n ),\n )\n}\n\nfunction normalizedMessageParts(\n message: SessionMessage,\n): { parts: JsonRecord[]; usage: ChatTurnUsage; derivedText: string } {\n const normalized: JsonRecord[] = []\n const usage: ChatTurnUsage = {}\n for (const raw of message.parts) {\n const record = asRecord(raw)\n if (!record) continue\n const part = normalizePersistedPart(record)\n if (!part) continue\n normalized.push(part)\n if (part.type === 'step-finish') addStepFinishUsage(part, usage)\n }\n\n const collapsed = collapseRedundantTextParts(normalized)\n const derivedText = collapsed\n .filter((part) => part.type === 'text')\n .map((part) => String(part.text ?? ''))\n .join('')\n return { parts: normalized, usage, derivedText }\n}\n\nfunction projectMessageParts(parts: JsonRecord[], finalText: string): JsonRecord[] {\n const order: string[] = []\n const map = new Map<string, JsonRecord>()\n for (let index = 0; index < parts.length; index += 1) {\n const part = parts[index]!\n const type = String(part.type ?? '')\n // A session's aggregate message contains every step receipt. Preserve each\n // occurrence just as the live producer does; other kinds merge by their\n // canonical identity.\n const key = type === 'step-start' || type === 'step-finish'\n ? `${type}:#${index}`\n : getPartKey(part)\n if (!map.has(key)) order.push(key)\n map.set(key, mergePersistedPart(map.get(key), part))\n }\n return finalizeAssistantParts(order, map, finalText)\n}\n\n/**\n * Recover the durable content a Sandbox recorder attached to one assistant\n * message. The caller is responsible for proving that the message belongs to\n * the exact terminal turn; this projection deliberately makes no conclusion\n * about whether that terminal state was completed or interrupted.\n */\nexport function recoverSandboxAssistantMessage(message: SessionMessage): DetachedTurnFinal {\n const recovered = normalizedMessageParts(message)\n return {\n ...(recovered.derivedText ? { text: recovered.derivedText } : {}),\n ...(hasUsage(recovered.usage) ? { usage: recovered.usage } : {}),\n parts: projectMessageParts(recovered.parts, recovered.derivedText),\n }\n}\n\nfunction hasUsage(usage: ChatTurnUsage): boolean {\n return Object.values(usage).some((value) =>\n typeof value === 'number' && Number.isFinite(value),\n )\n}\n\n/**\n * Read the exact completed turn from its keyed cache and completed message.\n * Never borrow a session-wide aggregate from a concurrently advancing session.\n * Observation failure is retryable and distinct from successful absent reads.\n * Model attribution comes from that same identity-checked cache record, never\n * from a second unchecked lookup that could belong to a different turn.\n */\nexport async function readCompletedSandboxTurn(\n box: CompletedSandboxTurnSource,\n options: ReadCompletedSandboxTurnOptions,\n): Promise<(DetachedTurnFinal & Pick<ChatTurnModelAttribution, 'servedModel' | 'servedProvider' | 'servedSource'>) | null> {\n const { turnId, sessionId, log } = options\n const session = box.session(sessionId)\n const [cacheOutcome, messagesOutcome] = await Promise.allSettled([\n box.findCompletedTurn(turnId, { sessionId }),\n session.messages({ limit: 1_000, ...(options.since !== undefined ? { since: options.since } : {}) }),\n ])\n\n if (cacheOutcome.status === 'rejected') {\n log?.('[chat-routes] completed Sandbox turn cache lookup failed', {\n turnId,\n sessionId,\n error: String(cacheOutcome.reason),\n })\n }\n if (messagesOutcome.status === 'rejected') {\n log?.('[chat-routes] completed Sandbox session message lookup failed', {\n turnId,\n sessionId,\n error: String(messagesOutcome.reason),\n })\n }\n\n const rawCached = cacheOutcome.status === 'fulfilled' ? cacheOutcome.value : null\n const cached = rawCached\n && rawCached.turnId === turnId\n && rawCached.sessionId === sessionId\n ? rawCached\n : null\n if (rawCached && !cached) {\n log?.('[chat-routes] ignored mismatched completed Sandbox turn cache record', {\n turnId,\n sessionId,\n })\n }\n\n const messages = messagesOutcome.status === 'fulfilled'\n ? messagesOutcome.value\n : []\n const matchingMessages = completedMessagesForTurn(messages, turnId)\n const matchingCount = matchingMessages.length\n const message = matchingCount === 1 ? matchingMessages[0]! : null\n if (matchingCount > 1) {\n log?.('[chat-routes] ignored ambiguous completed Sandbox session messages', {\n turnId,\n sessionId,\n matchingCount,\n })\n }\n\n if (!cached && !message) {\n // A failed read is unknown, not proof that the turn is absent. The durable\n // owner must retry observation rather than admit another execution.\n if (cacheOutcome.status === 'rejected' || messagesOutcome.status === 'rejected') {\n throw new Error('Completed Sandbox turn could not be verified; retry the exact read')\n }\n if (rawCached || matchingCount > 1) {\n throw new Error('Completed Sandbox turn identity is inconsistent; reconciliation is required')\n }\n return null\n }\n\n // Only turn-addressed evidence is safe. A newer turn can complete between\n // reading the message list and reading a session-wide aggregate result.\n const result = cached ? asRecord(cached.result) : undefined\n\n const recovered = message ? normalizedMessageParts(message) : null\n const text = textFromResult(result) ?? recovered?.derivedText\n const resultUsage = usageFromResult(result)\n const usage = { ...(recovered?.usage ?? {}), ...resultUsage }\n const resultParts = Array.isArray(result?.parts)\n ? result.parts\n .map((part) => asRecord(part))\n .filter((part): part is JsonRecord => Boolean(part))\n .map((part) => normalizePersistedPart(part))\n .filter((part): part is JsonRecord => Boolean(part))\n : null\n const sourceParts = recovered?.parts ?? resultParts\n const parts = sourceParts\n ? projectMessageParts(sourceParts, text ?? recovered?.derivedText ?? '')\n : undefined\n\n return {\n ...(text !== undefined ? { text } : {}),\n ...(hasUsage(usage) ? { usage } : {}),\n ...(parts ? { parts } : {}),\n ...attributionFromResult(result),\n }\n}\n","/**\n * Exact terminal observation for a native Sandbox execution that another\n * request already admitted. This module never sends a prompt, calls\n * `driveTurn`, or cancels a run.\n */\n\nimport type { SandboxInstance, SessionInfo, SessionMessage } from '@tangle-network/sandbox'\nimport type { ChatTurnUsage } from './turn-routes'\nimport type { SessionExecutionInfo } from '@tangle-network/sandbox'\nimport {\n attributionFromResult,\n readCompletedSandboxTurn,\n recoverSandboxAssistantMessage,\n usageFromResult,\n} from './completed-sandbox-turn'\n\nexport interface NativeCompletionReceipt {\n state: 'completed' | 'failed'\n text: string\n parts: Array<Record<string, unknown>>\n /** An empty object is an unknown usage receipt, never a measured zero. */\n usage: ChatTurnUsage\n servedModel?: string\n servedProvider?: string\n servedSource?: 'request' | 'environment' | 'profile'\n error?: string\n completedTurnIds: string[]\n}\n\nexport interface NativeCompletionAdmission {\n executionId: string\n state: 'open' | 'closed'\n admittedTurnIds: readonly string[]\n ownerLeaseUntil: Date | number\n updatedAt?: Date | number\n closedAt?: Date | number | null\n}\n\n/** Product persistence for the one admission that authorizes this observer. */\nexport interface NativeCompletionAdmissionStore {\n read(executionId: string): Promise<NativeCompletionAdmission | null>\n renew(executionId: string, now: Date): Promise<NativeCompletionAdmission | null>\n closeExpired(executionId: string, now: Date): Promise<NativeCompletionAdmission | null>\n}\n\n/** The official Sandbox reads needed for exact native completion observation. */\nexport type NativeCompletionSessionSource = Pick<SandboxInstance, 'findCompletedTurn' | 'session'>\n\nexport interface NativeCompletionObservationOptions {\n /** Null when the product cannot currently resolve the admitted Sandbox. */\n source: NativeCompletionSessionSource | null\n admissionStore: NativeCompletionAdmissionStore\n executionId: string\n sessionId: string\n turnId: string\n registeredAt: number\n absentDispatchDeadlineMs?: number\n receiptDeadlineMs?: number\n now?: number\n}\n\nexport type NativeCompletionObservation =\n | { state: 'running' }\n | { state: 'completed'; receipt: NativeCompletionReceipt }\n | { state: 'failed'; receipt: NativeCompletionReceipt }\n\n/** One exact turn receipt before an admission's ordered aggregate. */\nexport interface NativeCompletionTurnReceipt {\n turnId: string\n state: 'completed' | 'failed'\n text: string\n parts: Array<Record<string, unknown>>\n usage: ChatTurnUsage\n servedModel?: string\n servedProvider?: string\n servedSource?: 'request' | 'environment' | 'profile'\n error?: string\n}\n\nconst DEFAULT_ABSENT_DISPATCH_DEADLINE_MS = 10 * 60_000\nconst DEFAULT_RECEIPT_DEADLINE_MS = 10 * 60_000\n/** Session messages are read from this long before registration, so clock\n * skew between the product Worker and the Sandbox cannot hide the turn. */\nconst MESSAGE_READ_SKEW_MS = 10 * 60_000\n\n/**\n * Largest interrupted execution whose event stream is replayed for its\n * terminal result. The replay parses every event and re-compares the growing\n * response text on each token, so its CPU grows faster than the run; a longer\n * run takes its receipt from the recorded message and failure reason alone.\n */\nconst INTERRUPTED_RESULT_REPLAY_MAX_EVENTS = 2_000\n/**\n * The fixed id of the terminal the sidecar appends when it fails an execution\n * whose runtime restarted before the run ended.\n */\nconst RUNTIME_RESTART_TERMINAL_EVENT_ID = 'interrupted-done'\n/** The sidecar's reason for that terminal, used when the replay is not read. */\nexport const RUNTIME_RESTARTED_ERROR = 'Execution interrupted: the agent runtime restarted before the run produced a terminal event. The run cannot be resumed; retry it.'\n\nfunction replayableExecution(run: Pick<SessionExecutionInfo, 'eventCount'>): boolean {\n return typeof run.eventCount === 'number' && run.eventCount <= INTERRUPTED_RESULT_REPLAY_MAX_EVENTS\n}\n\n/**\n * Serialized UTF-8 budget for one terminal receipt. A Cloudflare Workflow\n * refuses a step result over 1 MiB and D1 refuses a row over 2 MB, and a\n * receipt approaches both as tool payloads accumulate over a long turn.\n */\nexport const NATIVE_COMPLETION_RECEIPT_MAX_BYTES = 900 * 1024\n\n/** Per-string caps tried in order until a receipt fits its budget. */\n// Status, ids and paths stay well under the smallest cap.\nconst RECEIPT_STRING_CAPS = [16_384, 4_096, 1_024, 256] as const\n\nconst encoder = new TextEncoder()\n\nfunction serializedBytes(value: unknown): number {\n return encoder.encode(JSON.stringify(value)).length\n}\n\nfunction capString(value: string, cap: number): string {\n if (value.length <= cap) return value\n return `${value.slice(0, cap)}…[truncated ${value.length - cap} characters; the Sandbox session keeps the full value]`\n}\n\nfunction capStrings(value: unknown, cap: number): unknown {\n if (typeof value === 'string') return capString(value, cap)\n if (Array.isArray(value)) return value.map((item) => capStrings(item, cap))\n const object = record(value)\n if (!object) return value\n return Object.fromEntries(Object.entries(object).map(([key, item]) => [key, capStrings(item, cap)]))\n}\n\n/** Tool payloads and reasoning shrink; the answer text, files and interactions do not. */\nfunction capReceiptPart(part: Record<string, unknown>, cap: number): Record<string, unknown> {\n const type = String(part.type ?? '')\n if (type === 'tool') {\n const state = record(part.state)\n if (!state) return part\n const capped = capStrings(state, cap) as Record<string, unknown>\n if (serializedBytes(capped) === serializedBytes(state)) return part\n return { ...part, state: { ...capped, metadata: { ...record(capped.metadata), receiptTruncated: true } } }\n }\n if (type === 'reasoning' && typeof part.text === 'string' && part.text.length > cap) {\n return { ...part, text: capString(part.text, cap), receiptTruncated: true }\n }\n return part\n}\n\n/** Last resort for a receipt whose part count alone exceeds the budget. */\nfunction skeletonPart(part: Record<string, unknown>): Record<string, unknown> | null {\n const type = String(part.type ?? '')\n if (type === 'reasoning') return null\n if (type !== 'tool') return part\n const state = record(part.state)\n return {\n type: 'tool',\n ...(part.id !== undefined ? { id: part.id } : {}),\n ...(part.tool !== undefined ? { tool: part.tool } : {}),\n state: { status: state?.status ?? 'completed', metadata: { receiptTruncated: true } },\n }\n}\n\n/**\n * Fit a terminal receipt inside {@link NATIVE_COMPLETION_RECEIPT_MAX_BYTES}.\n * A receipt under the budget is returned unchanged. Over it, the longest\n * strings in tool payloads and reasoning are clipped with a marker, at\n * successively smaller caps, so a long turn's answer is always persistable.\n */\nexport function boundNativeCompletionReceipt(\n receipt: NativeCompletionReceipt,\n maxBytes: number = NATIVE_COMPLETION_RECEIPT_MAX_BYTES,\n): NativeCompletionReceipt {\n if (serializedBytes(receipt) <= maxBytes) return receipt\n for (const cap of RECEIPT_STRING_CAPS) {\n const bounded = { ...receipt, parts: receipt.parts.map((part) => capReceiptPart(part, cap)) }\n if (serializedBytes(bounded) <= maxBytes) return bounded\n }\n const skeleton = {\n ...receipt,\n parts: receipt.parts.map(skeletonPart).filter((part): part is Record<string, unknown> => part !== null),\n }\n if (serializedBytes(skeleton) <= maxBytes) return skeleton\n // Only the answer text is left to shrink.\n const textBudget = Math.max(0, Math.floor(maxBytes / 4))\n return {\n ...skeleton,\n text: capString(skeleton.text, textBudget),\n parts: skeleton.parts.map((part) => (part.type === 'text' && typeof part.text === 'string'\n ? { ...part, text: capString(part.text, textBudget) }\n : part)),\n }\n}\n\nfunction terminal(receipt: NativeCompletionReceipt): NativeCompletionObservation {\n const bounded = boundNativeCompletionReceipt(receipt)\n return bounded.state === 'completed'\n ? { state: 'completed', receipt: bounded }\n : { state: 'failed', receipt: bounded }\n}\n\nfunction timestamp(value: Date | number | null | undefined): number | undefined {\n if (value instanceof Date) return value.getTime()\n return typeof value === 'number' && Number.isFinite(value) ? value : undefined\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === 'object' && !Array.isArray(value)\n ? value as Record<string, unknown>\n : undefined\n}\n\nfunction isSandboxNotFoundError(value: unknown): boolean {\n const error = record(value)\n return error?.name === 'NotFoundError' || error?.code === 'NOT_FOUND' || error?.status === 404\n}\n\nfunction isCanonicalUserStop(error: unknown): boolean {\n return error === 'Execution cancelled by user' || error === 'Execution cancelled by the user'\n}\n\n/** A terminal receipt is public; runtime stderr stays in the native record. */\nfunction terminalFailureMessage(error: string, provenUserStop: boolean): string {\n if (provenUserStop) return 'Execution cancelled by the user'\n if (/\\bENOSPC\\b|no space left on device/i.test(error)) {\n return 'The Sandbox ran out of disk space before the execution finished.'\n }\n if (error === RUNTIME_RESTARTED_ERROR) return RUNTIME_RESTARTED_ERROR\n if (/\\bcancelled\\b|\\bcanceled\\b/i.test(error)) return 'Native Sandbox execution was cancelled.'\n if (/MCP.*(?:did not become ready|bootstrap)|(?:MCP|runtime) bootstrap failed/i.test(error)) {\n return 'The Sandbox could not start the agent runtime.'\n }\n return 'Native Sandbox execution failed before producing an answer.'\n}\n\n/** The SDK reads this execution's replay; reject contradictory terminal identity. */\nfunction exactFailedResult(value: unknown, turnId: string, sessionId: string): Record<string, unknown> | undefined {\n const result = record(value)\n if (result?.executionId !== turnId || (result.sessionId !== undefined && result.sessionId !== sessionId)) return undefined\n if (result.success !== false || !['error', 'failed', 'cancelled'].includes(String(result.status))) return undefined\n return typeof result.error === 'string' && result.error.trim() ? result : undefined\n}\n\nfunction interruptedMessages(messages: SessionMessage[], turnId: string): SessionMessage[] {\n return messages.filter((message) =>\n message.role === 'assistant'\n && message.metadata?.turnId === turnId\n && (message.metadata.interrupted === true || message.metadata.status === 'interrupted'),\n )\n}\n\nfunction turnAssistantMessages(messages: SessionMessage[], turnId: string): SessionMessage[] {\n return messages.filter((message) => message.role === 'assistant' && message.metadata?.turnId === turnId)\n}\n\nfunction consistent<T>(values: Array<T | undefined>): T | undefined {\n if (values.length === 0 || values.some((value) => value === undefined)) return undefined\n const first = values[0] as T\n return values.every((value) => value === first) ? first : undefined\n}\n\nfunction sum(values: Array<number | undefined>): number | undefined {\n if (values.some((value) => value === undefined)) return undefined\n return (values as number[]).reduce((total, value) => total + value, 0)\n}\n\n/** Assemble admitted exact receipts in dispatch order. Missing usage stays unknown. */\nexport function aggregateNativeCompletionReceipts(turns: readonly NativeCompletionTurnReceipt[]): NativeCompletionReceipt {\n const failed = turns.some((turn) => turn.state === 'failed')\n const usage: ChatTurnUsage = {}\n for (const key of ['inputTokens', 'outputTokens', 'reasoningTokens', 'cacheReadTokens', 'cacheWriteTokens', 'costUsd'] as const) {\n const total = sum(turns.map((turn) => turn.usage[key]))\n if (total !== undefined) usage[key] = total\n }\n // A missing exact receipt is the terminal observer failure even when an\n // earlier execution also failed. Preserve that earlier partial transcript,\n // but surface why this aggregate could not be fully reconciled.\n const error = turns.find((turn) =>\n turn.error?.startsWith('Admitted native execution did not produce')\n || turn.error?.startsWith('Native Sandbox execution ledger is missing'),\n )?.error ?? turns.find((turn) => turn.error)?.error\n return {\n state: failed ? 'failed' : 'completed',\n text: turns.map((turn) => turn.text).join(''),\n parts: turns.flatMap((turn) => turn.parts),\n usage,\n ...(consistent(turns.map((turn) => turn.servedModel)) ? { servedModel: consistent(turns.map((turn) => turn.servedModel)) } : {}),\n ...(consistent(turns.map((turn) => turn.servedProvider)) ? { servedProvider: consistent(turns.map((turn) => turn.servedProvider)) } : {}),\n ...(consistent(turns.map((turn) => turn.servedSource)) ? { servedSource: consistent(turns.map((turn) => turn.servedSource)) } : {}),\n ...(error ? { error } : {}),\n completedTurnIds: turns.map((turn) => turn.turnId),\n }\n}\n\n/** The failure a completed run with an aborted tool call settles with. */\nexport const TOOL_ABORTED_ERROR = 'The Sandbox aborted a tool call before the turn finished, as when its runtime restarts mid-turn'\n\n/**\n * The name of a tool whose call the Sandbox aborted, or undefined. OpenCode\n * marks a tool interrupted by a runtime restart with \"Tool execution aborted\";\n * an ordinary tool error (a missing file, an HTTP 403) does not end the turn.\n */\nfunction abortedToolCall(parts: ReadonlyArray<Record<string, unknown>>): string | undefined {\n for (const part of parts) {\n if (part.type !== 'tool') continue\n const state = part.state as { status?: unknown; error?: unknown } | undefined\n if (state?.status === 'error' && /tool execution aborted/i.test(String(state.error ?? ''))) {\n return typeof part.tool === 'string' ? part.tool : 'tool'\n }\n }\n return undefined\n}\n\n/**\n * Whether the session still runs this admission's work, so its lease should be\n * renewed. The session's own status is not enough: it keeps a persisted\n * `running` status when the runtime restarts under it (the sidecar may report\n * that as recovery state `stale`, or not at all), while its execution ledger\n * has already failed the interrupted run. Renewing on status alone observed\n * GTM b81b's restarted completions forever. Live means an\n * admitted turn's execution is active, or not yet recorded while its dispatch\n * can still be on the way.\n */\nfunction admittedWorkIsLive(\n status: SessionInfo,\n runsByTurnId: ReadonlyMap<string, SessionExecutionInfo>,\n admittedTurnIds: readonly string[],\n dispatchMayBePending: boolean,\n): boolean {\n if (status.status !== 'queued' && status.status !== 'running') return false\n if (status.raw?.state === 'stale') return false\n return admittedTurnIds.some((turnId) => {\n const run = runsByTurnId.get(turnId)\n return run ? run.status === 'active' : dispatchMayBePending\n })\n}\n\nfunction missingTurnReceipt(turnId: string, error: string): NativeCompletionTurnReceipt {\n // An execution ledger entry proves this turn reached a terminal state, but\n // not that its terminal transcript was retained. Keep any earlier exact\n // evidence when the bounded wait expires; `{}` means aggregate usage is\n // unknown because this turn has no usage receipt.\n return { turnId, state: 'failed', text: '', parts: [], usage: {}, error }\n}\n\n/**\n * Observe only the turns admitted under `executionId`. Transport failures throw\n * so the durable owner retries. A missing or partial terminal record remains\n * `running` until the configured deadline; it never starts another run.\n */\nexport async function observeNativeCompletion(\n options: NativeCompletionObservationOptions,\n): Promise<NativeCompletionObservation> {\n const now = options.now ?? Date.now()\n let admission = await options.admissionStore.read(options.executionId)\n if (!admission) throw new Error('Native completion admission is missing')\n if (admission.executionId !== options.executionId) throw new Error('Native completion admission identity conflict')\n const leaseUntil = timestamp(admission.ownerLeaseUntil) ?? 0\n const source = options.source\n const session = source?.session(options.sessionId)\n let status: SessionInfo | null\n if (!session) {\n status = null\n } else {\n try {\n status = await session.status()\n } catch (error) {\n if (!isSandboxNotFoundError(error)) throw error\n status = null\n }\n }\n\n if (!status || !session || !source) {\n if (admission.state === 'open' && leaseUntil <= now) {\n admission = await options.admissionStore.closeExpired(options.executionId, new Date(now)) ?? admission\n }\n if (admission.state === 'open' || now - options.registeredAt < (options.absentDispatchDeadlineMs ?? DEFAULT_ABSENT_DISPATCH_DEADLINE_MS)) {\n return { state: 'running' }\n }\n return terminal(aggregateNativeCompletionReceipts([\n missingTurnReceipt(options.turnId, 'Native Sandbox dispatch was not observed before the admission deadline'),\n ]))\n }\n const exactSession = session\n const dispatchMayBePending = now - options.registeredAt < (options.absentDispatchDeadlineMs ?? DEFAULT_ABSENT_DISPATCH_DEADLINE_MS)\n let runsByTurnId: Map<string, SessionExecutionInfo> | undefined\n const readRuns = async () => runsByTurnId ??= new Map((await exactSession.runs()).map((run) => [run.executionId, run]))\n\n if (admission.state === 'open') {\n if (admittedWorkIsLive(status, await readRuns(), admission.admittedTurnIds, dispatchMayBePending)) {\n admission = await options.admissionStore.renew(options.executionId, new Date(now)) ?? admission\n } else if (leaseUntil <= now) {\n admission = await options.admissionStore.closeExpired(options.executionId, new Date(now)) ?? admission\n }\n if (admission.state === 'open') return { state: 'running' }\n }\n // `closeExpired` may return the current row after another owner appended a\n // continuation. Read its full ordered ledger rather than observing the\n // earlier snapshot from before the close attempt.\n const admittedTurnIds = [...admission.admittedTurnIds]\n if (admittedTurnIds.length === 0 || admittedTurnIds[0] !== options.turnId) {\n throw new Error('Native completion admission has an invalid turn sequence')\n }\n\n const ledger = await readRuns()\n const missingExecution = admittedTurnIds.find((turnId) => !ledger.has(turnId))\n if (missingExecution && dispatchMayBePending) return { state: 'running' }\n if (admittedTurnIds.some((turnId) => ledger.get(turnId)?.status === 'active')) return { state: 'running' }\n\n // Completed recovery owns its message read. Load interrupted history only\n // when it is needed, and share that one read across failed continuations.\n // Both reads start shortly before registration, so their size follows this\n // turn rather than the whole session.\n const since = Math.max(0, options.registeredAt - MESSAGE_READ_SKEW_MS)\n let messages: SessionMessage[] | undefined\n const recovered: NativeCompletionTurnReceipt[] = []\n for (const turnId of admittedTurnIds) {\n const run = ledger.get(turnId)\n if (!run) {\n recovered.push(missingTurnReceipt(turnId, 'Native Sandbox execution ledger is missing the admitted turn'))\n continue\n }\n const completed = run.status === 'completed'\n ? await readCompletedSandboxTurn(source, { turnId, sessionId: options.sessionId, since })\n : null\n if (run.status === 'completed' && completed) {\n const aborted = abortedToolCall(completed.parts ?? [])\n recovered.push({\n ...completed,\n turnId,\n // A run the runtime ended while a tool was still running reports\n // completed, but its reply stops mid-work. It is a failed turn.\n state: aborted ? 'failed' : 'completed',\n text: completed.text ?? '',\n parts: completed.parts ?? [],\n usage: completed.usage ?? {},\n ...(aborted ? { error: `${TOOL_ABORTED_ERROR} (${aborted})` } : {}),\n })\n continue\n }\n // The process that would stamp a turn interrupted is gone when its runtime\n // restarts; the sidecar fails the execution on restart, and the turn's own\n // assistant message holds whatever reply it had streamed.\n const restarted = run.status === 'failed' && run.lastEventId === RUNTIME_RESTART_TERMINAL_EVENT_ID\n let interrupted = run.status === 'failed' || run.status === 'cancelled'\n ? interruptedMessages(messages ??= await exactSession.messages({ limit: 1_000, since }), turnId)\n : []\n if (restarted && interrupted.length === 0) interrupted = turnAssistantMessages(messages ?? [], turnId)\n if (restarted && interrupted.length !== 1) {\n recovered.push({ turnId, state: 'failed', text: '', parts: [], usage: {}, error: RUNTIME_RESTARTED_ERROR })\n continue\n }\n // Bootstrap can fail before the runtime creates an assistant message. The\n // terminal execution replay is independent of that transcript projection.\n if ((run.status === 'failed' || run.status === 'cancelled') && interrupted.length === 0\n && turnAssistantMessages(messages ?? [], turnId).length === 0\n && run.sessionId === options.sessionId && replayableExecution(run)) {\n const result = exactFailedResult(await exactSession.result({ executionId: turnId }), turnId, options.sessionId)\n if (result) {\n recovered.push({\n turnId, state: 'failed', text: '', parts: [], usage: usageFromResult(result),\n ...attributionFromResult(result), error: terminalFailureMessage(result.error as string, run.status === 'cancelled' && isCanonicalUserStop(result.error)),\n })\n continue\n }\n }\n if ((run.status === 'failed' || run.status === 'cancelled') && interrupted.length === 1) {\n const message = recoverSandboxAssistantMessage(interrupted[0]!)\n const result = replayableExecution(run)\n ? await exactSession.result({ executionId: turnId }) as unknown as Record<string, unknown>\n : undefined\n const provenUserStop = run.status === 'cancelled'\n && (isCanonicalUserStop(interrupted[0]!.metadata?.interruptReason)\n || isCanonicalUserStop(exactFailedResult(result, turnId, options.sessionId)?.error))\n recovered.push({\n turnId,\n state: 'failed',\n text: message.text ?? (typeof result?.response === 'string' ? result.response : undefined) ?? '',\n parts: message.parts ?? [],\n usage: { ...message.usage, ...usageFromResult(result) },\n ...attributionFromResult(result),\n error: terminalFailureMessage((typeof result?.error === 'string' ? result.error : undefined)\n ?? interrupted[0]!.metadata?.interruptReason\n ?? (restarted ? RUNTIME_RESTARTED_ERROR : undefined)\n ?? status.failureReason?.message\n ?? 'Native Sandbox execution failed.', provenUserStop),\n })\n continue\n }\n const closedAt = timestamp(admission.closedAt)\n ?? timestamp(admission.updatedAt)\n ?? options.registeredAt\n if (now - closedAt < (options.receiptDeadlineMs ?? DEFAULT_RECEIPT_DEADLINE_MS)) return { state: 'running' }\n recovered.push(missingTurnReceipt(\n turnId,\n `Admitted native execution did not produce an exact completion: ${turnId}`,\n ))\n }\n return terminal(aggregateNativeCompletionReceipts(recovered))\n}\n"],"mappings":"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","names":["record"]}