@tangle-network/agent-app 4.0.2 → 4.0.3

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.
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/turn-health/lifecycle.ts","../../src/turn-health/sweep.ts"],"sourcesContent":["/**\n * The LIVE half: judge each turn the moment it settles.\n *\n * This adds no control flow. `createChatTurnRoutes` already exposes a\n * `lifecycle` seam that fires exactly one of `onTurnComplete`/`onTurnError`\n * after a turn settles, and already swallows hook errors so telemetry cannot\n * fail a turn. That seam was shipped and then wired by nobody, which is a fair\n * description of why the outage lasted 17 days. This function fills it.\n *\n * The shape is declared structurally rather than imported from\n * `/chat-routes`, so `/turn-health` stays free of the server chat vertical and\n * can be used by any turn driver that reports the same three moments.\n */\n\nimport { classifyTurnOutcome } from './classify.js'\nimport { type AlertSink, createGuardedAlertSink, turnAlert } from './sink.js'\n\n/** Structural mirror of `/chat-routes`' `ChatTurnLifecycle` complete payload. */\nexport interface TurnHealthCompleteInfo {\n finalText: string\n usage?: { outputTokens?: number | null } | null\n durationMs: number\n threadId?: string\n turnStreamId?: string\n executionId?: string\n /** `/chat-routes` sets this when a `contextGate` short-circuited the turn and\n * the producer never ran. */\n gated?: boolean\n}\n\n/** Structural mirror of the lifecycle error payload. */\nexport interface TurnHealthErrorInfo {\n error: unknown\n durationMs: number\n threadId?: string\n turnStreamId?: string\n executionId?: string\n}\n\n/** What {@link createTurnHealthLifecycle} returns — assignable to\n * `createChatTurnRoutes`' `lifecycle` option. */\nexport interface TurnHealthLifecycle {\n onTurnComplete(info: TurnHealthCompleteInfo): Promise<void>\n onTurnError(info: TurnHealthErrorInfo): Promise<void>\n}\n\nexport interface TurnHealthLifecycleOptions {\n /** Names the product in every alert. */\n product: string\n sink: AlertSink\n /** Called for every verdict, healthy or not — the hook for a counter or a\n * metrics push. Alerts are for humans; this is for graphs. */\n onVerdict?(verdict: {\n product: string\n healthy: boolean\n kinds: string[]\n durationMs: number\n }): void\n /** Page when a turn was answered by a gate instead of the model.\n *\n * Default `false`, and the default is the honest one: gating is a legitimate\n * design and a product that gates its intake would otherwise page on every\n * healthy turn. Whether the rate is pathological is domain knowledge, so it\n * stays a product decision — the verdict is ALWAYS reported through\n * {@link TurnHealthLifecycleOptions.onVerdict} so a counter can watch the\n * rate even when nobody is paged. */\n alertOnGatedTurn?: boolean\n}\n\nfunction errorText(error: unknown): string {\n if (error instanceof Error) return error.message\n if (typeof error === 'string') return error\n return String(error)\n}\n\n/**\n * Build the lifecycle hooks that page on a turn which succeeded at nothing.\n *\n * The live lane sees `finalText` and usage but not the persisted parts, so it\n * catches the blank-completion and hard-failure shapes immediately. The\n * parts-dependent shapes (a tool call whose arguments never parsed, a tool\n * call that left no effect) are caught by {@link sweepSilentFailures}, which\n * reads what was actually written to the store — the honest place to ask\n * whether an effect persisted.\n */\nexport function createTurnHealthLifecycle(\n options: TurnHealthLifecycleOptions,\n): TurnHealthLifecycle {\n // Guarded: a paging failure must never take down a customer's turn.\n const sink = createGuardedAlertSink(options.sink)\n\n return {\n async onTurnComplete(info) {\n const verdict = classifyTurnOutcome({\n finalText: info.finalText,\n outputTokens: info.usage?.outputTokens ?? null,\n durationMs: info.durationMs,\n ...(info.gated ? { gated: true } : {}),\n })\n options.onVerdict?.({\n product: options.product,\n healthy: verdict.healthy,\n kinds: verdict.reasons.map((r) => r.kind),\n durationMs: info.durationMs,\n })\n if (verdict.healthy || verdict.severity === null) return\n // Counted above, paged only on request — see `alertOnGatedTurn`.\n if (!options.alertOnGatedTurn && verdict.reasons.every((r) => r.kind === 'answered_without_model')) {\n return\n }\n await sink.deliver(\n turnAlert({\n product: options.product,\n severity: verdict.severity,\n reasons: verdict.reasons,\n ...(info.threadId ? { threadId: info.threadId } : {}),\n ...(info.executionId ? { turnId: info.executionId } : {}),\n }),\n )\n },\n\n async onTurnError(info) {\n const verdict = classifyTurnOutcome({\n failed: true,\n failureReason: errorText(info.error),\n durationMs: info.durationMs,\n })\n options.onVerdict?.({\n product: options.product,\n healthy: false,\n kinds: verdict.reasons.map((r) => r.kind),\n durationMs: info.durationMs,\n })\n await sink.deliver(\n turnAlert({\n product: options.product,\n severity: 'critical',\n reasons: verdict.reasons,\n ...(info.threadId ? { threadId: info.threadId } : {}),\n ...(info.executionId ? { turnId: info.executionId } : {}),\n }),\n )\n },\n }\n}\n","/**\n * The SWEEP half: ask the store what it has been quietly accumulating.\n *\n * A live per-turn hook cannot see the failure that matters most, because the\n * worst outage produced NO turns at all to hook: gtm-agent took 9–21 user\n * messages a day for sixteen straight days and wrote zero real assistant\n * replies. Nothing crashed on a schedule; the product simply stopped\n * answering. The only thing that could have noticed is something that\n * periodically counts what arrived against what was answered.\n *\n * That is this. It runs on a cron, reads the shared `/chat-store` schema, and\n * pages when the ratio breaks.\n *\n * The queries live HERE and not in each product because all four products\n * (gtm, tax, legal, workcomp) persist to the same `message`/`thread` tables —\n * four copies of this cron is exactly the duplication the repo's engine/shell\n * rule exists to prevent.\n */\n\nimport { classifyTurnOutcome, describeReason, type TurnHealthReason } from './classify.js'\nimport type { AlertSink, TurnHealthAlert } from './sink.js'\nimport { SIZED_READ_BYTES, sizedBatches } from '../launch-invariants/sized-reads.js'\n\n/** A thread that has taken user messages with no reply since. */\nexport interface UnansweredThread {\n threadId: string\n /** User messages newer than the newest real assistant reply. */\n pendingMessages: number\n /** Age of the OLDEST unanswered user message, in ms. */\n oldestAgeMs: number\n /** The newest of these messages was followed by a row that showed the person\n * something (a failure notice or error prose), so they know it failed. False\n * or absent: nothing came back at all. */\n notified?: boolean\n}\n\n/** A persisted assistant row, as the sweep needs to judge it. */\nexport interface PersistedTurnRow {\n id: string\n threadId: string\n content: string\n /** Raw `parts` column. A JSON string or an already-parsed array; the sweep\n * accepts both because D1 drivers differ. Left undefined by a source that\n * lists rows by {@link partsSize} and serves parts through\n * {@link TurnHealthSource.readParts}. */\n parts: unknown\n /** Stored length of `parts` (SQLite `length()`), set when the row was listed\n * without them. The sweep batches {@link TurnHealthSource.readParts} by it. */\n partsSize?: number | null\n outputTokens?: number | null\n model?: string | null\n createdAt: number\n}\n\n/** What the sweep needs from a store. A product on a non-standard schema\n * implements these two reads; everything else is shared. */\nexport interface TurnHealthSource {\n findUnansweredThreads(input: {\n minAgeMs: number\n /** Ignore user messages older than this. See {@link SweepOptions.maxAgeMs}. */\n maxAgeMs: number\n now: number\n }): Promise<UnansweredThread[]>\n listRecentAssistantTurns(input: { sinceMs: number; now: number; limit: number }): Promise<\n PersistedTurnRow[]\n >\n /**\n * The stored `parts` of these rows, by id, for a source that lists rows\n * without them. The sweep asks for at most {@link TURN_HEALTH_PARTS_BATCH_SIZE}\n * of parts at a time and judges each batch before it reads the next, so memory\n * holds one batch rather than the whole window.\n *\n * On 2026-10-10 gtm-agent's 500 newest assistant rows carried 122 MB of\n * parts (the largest 2.8 MB). Read in one query they exceeded the Worker's\n * 128 MB, which stopped the hourly cron and every sweep queued after this one.\n */\n readParts?(ids: readonly string[]): Promise<Map<string, unknown>>\n}\n\n/**\n * The part fields classifyTurnOutcome reads, as SQL over one `json_each` row.\n * Each string field is taken only when its JSON type is text, so a non-string\n * value reads exactly as the classifier would see it in the full part.\n */\n/** `expr` evaluated only on an object part: json_type and json_extract raise on a bare string element. */\nconst onObject = (expr: string) => `CASE WHEN p.type = 'object' THEN ${expr} END`\n/** The value at `path` when it is a JSON string, else NULL. */\nconst textAt = (path: string, take = `json_extract(p.value, '${path}')`) => onObject(`CASE WHEN json_type(p.value, '${path}') = 'text' THEN ${take} END`)\nconst PART_PROJECTION = [\n `p.type AS partKind`,\n `${textAt('$.type')} AS type`,\n `coalesce(${onObject(`CASE WHEN json_type(p.value, '$.text') = 'text' AND length(trim(json_extract(p.value, '$.text'), char(32, 9, 10, 13))) > 0 THEN 1 ELSE 0 END`)}, 0) AS hasText`,\n `${textAt('$.tool')} AS tool`,\n `${onObject(`json_type(p.value, '$.state')`)} AS stateKind`,\n `${textAt('$.state.status')} AS status`,\n `${textAt('$.state.error', `substr(json_extract(p.value, '$.state.error'), 1, 200)`)} AS stateError`,\n `${onObject(`json_type(p.value, '$.state.input')`)} AS inputKind`,\n `${textAt('$.state.input.error', `substr(json_extract(p.value, '$.state.input.error'), 1, 200)`)} AS inputError`,\n `${textAt('$.state.input.tool')} AS inputTool`,\n `${textAt('$.state.input', `json_valid(json_extract(p.value, '$.state.input'))`)} AS inputValid`,\n `${textAt('$.state.input', `substr(json_extract(p.value, '$.state.input'), 1, 120)`)} AS inputSample`,\n].join(',\\n ')\n\ninterface ProjectedPart {\n partKind: string | null\n type: string | null\n hasText: number\n tool: string | null\n stateKind: string | null\n status: string | null\n stateError: string | null\n inputKind: string | null\n inputError: string | null\n inputTool: string | null\n inputValid: number | null\n inputSample: string | null\n}\n\n/** A part rebuilt from its projection, judged by classifyTurnOutcome as the stored part would be. */\nfunction slimPart(row: ProjectedPart): unknown {\n // classifyTurnOutcome treats an array part as a record with no type (an opaque part) and skips any other non-object.\n if (row.partKind === 'array') return []\n if (row.partKind !== 'object') return null\n const part: Record<string, unknown> = {}\n if (row.type !== null) part.type = row.type\n if (row.hasText) part.text = 'x'\n if (row.tool !== null) part.tool = row.tool\n if (row.stateKind === 'object') {\n const state: Record<string, unknown> = {}\n if (row.status !== null) state.status = row.status\n if (row.stateError !== null) state.error = row.stateError\n if (row.inputKind === 'object') {\n const input: Record<string, unknown> = {}\n if (row.inputError !== null) input.error = row.inputError\n if (row.inputTool !== null) input.tool = row.inputTool\n state.input = input\n } else if (row.inputKind === 'text') {\n // A parseable string reads as parseable; an unparseable one keeps its sample and a NUL after it, so its prefix\n // can never parse by accident.\n state.input = row.inputValid ? '{}' : `${row.inputSample ?? ''}\\u0000`\n } else if (row.inputKind !== null) {\n state.input = null\n }\n part.state = state\n }\n return part\n}\n\n/** Most stored parts the sweep reads in one batch; a larger row is read alone. */\nexport const TURN_HEALTH_PARTS_BATCH_SIZE = SIZED_READ_BYTES\n\n/** Consecutive rows whose listed parts size fits one read. */\nfunction partsBatches(rows: readonly PersistedTurnRow[]): PersistedTurnRow[][] {\n return sizedBatches(rows.map((row) => ({ key: row, size: row.partsSize })), { bytes: TURN_HEALTH_PARTS_BATCH_SIZE })\n}\n\n/** The listed rows with their parts, read one batch at a time when the source listed them without. */\nasync function* withParts(rows: readonly PersistedTurnRow[], source: TurnHealthSource): AsyncGenerator<PersistedTurnRow> {\n for (const batch of partsBatches(rows)) {\n const unread = batch.filter((row) => row.parts === undefined && (row.partsSize ?? 0) > 0).map((row) => row.id)\n // A read failure propagates, like the listing's, so the caller retries the sweep.\n const read = unread.length > 0 && source.readParts ? await source.readParts(unread) : null\n for (const row of batch) yield read?.has(row.id) ? { ...row, parts: read.get(row.id) } : row\n }\n}\n\nexport interface SweepOptions {\n product: string\n source: TurnHealthSource\n sink: AlertSink\n /** A user message must go unanswered this long before it counts. Guards\n * against alerting on a turn that is simply still streaming. Default 15 min. */\n minAgeMs?: number\n /**\n * A user message OLDER than this is abandoned, not unanswered — it stops\n * counting. Default 7 days.\n *\n * Without this bound the sweep is worse than useless. gtm-agent's table\n * holds 384 unanswered messages whose oldest is 1,676 h (70 days) old;\n * paging hourly on a backlog nobody will ever reply to is exactly how an\n * alert channel gets muted, and a muted channel is the state this module\n * exists to escape. The alert has to mean \"something broke recently\".\n */\n maxAgeMs?: number\n /** How far back to judge settled turns. Default 24 h. */\n lookbackMs?: number\n /** Cap on rows judged per sweep. Default 500. */\n limit?: number\n /** Fraction of recent turns allowed to be silently broken before paging.\n * Default 0.05 — the measured blank-completion rate on the tax tool surface\n * was 12.2%, so 5% separates a real regression from noise. */\n emptyRateThreshold?: number\n /** Absolute floor: never page on a rate computed from fewer turns than this. */\n minTurnsForRate?: number\n /** Declare that this product's deliverable comes from TOOL calls, which\n * switches on the dead-tool-surface detector.\n *\n * Opt-in because only the product knows: a copilot that answers from context\n * is perfectly healthy with zero tool calls, while an agent whose entire job\n * is to file, draft, or submit something is broken the moment its tool\n * surface goes quiet — and broken INVISIBLY, because every turn still\n * returns fluent prose and HTTP 200.\n *\n * This is the fourth failure shape, and the only one no per-turn rule can\n * see.\n *\n * The verdict is drawn ONLY over turns whose parts were present and\n * readable. An earlier revision counted rows that stored no parts, and the\n * production example this comment used to cite was that bug rather than a\n * finding: tax-agent's 97 parts-less rows all predate its parts persistence\n * (they stop at 2026-07-17T02:20Z, the encrypted rows start 02:58Z), while\n * the same database's `turn_events` table holds 243 `tool_call` frames over\n * 15 turns. The tool surface was never dead; the rows were empty. */\n expectsToolCalls?: boolean\n /** Turns needed before a dead tool surface is called. Default 10. */\n minTurnsForToolSurface?: number\n /**\n * Make an at-rest parts encoding readable, so this sweep can judge a product\n * that does not store parts in the clear.\n *\n * Without it, a product that encrypts `parts` (tax-agent wraps the whole\n * array in one `__encrypted_parts__` part) is permanently UNMEASURABLE by the\n * tool-surface rule: every row is opaque, so the honest verdict is \"cannot\n * certify\" forever. This seam is how such a product gets a real verdict\n * instead of permanent blindness — the sweep stays domain-free and the\n * product supplies the decoder.\n *\n * Return the decoded parts value (it is parsed exactly like a stored one).\n * Returning `null`/`undefined` or THROWING leaves the row's stored value in\n * place, so a decoder that fails reports the row as opaque. It must never\n * report success as an empty array: that manufactures the exact absent-parts\n * blindness this module now refuses to draw conclusions from.\n */\n decodeParts?: (raw: unknown, row: PersistedTurnRow) => Promise<unknown> | unknown\n /**\n * Which threads that got no reply at all should page (a `critical` alert);\n * the rest are reported as a `warning`. A product passes its own rule, such\n * as only its customers' and operators' threads, so internal and evaluation\n * traffic stops paging. Default: threads silent for 24 hours or more.\n */\n pageSilentThreads?: (threads: UnansweredThread[]) => Promise<UnansweredThread[]> | UnansweredThread[]\n /**\n * Where a product already reports threads that ended on a failure the person\n * saw, such as its reliability report. When set, those threads are counted\n * but not alerted here. Unset, they are a `warning`, so a product whose every\n * reply is an error message still shows up.\n */\n failureNoticesReportedBy?: string\n now?: number\n}\n\nconst defaultPageSilentThreads = (threads: UnansweredThread[]) => threads.filter((thread) => thread.oldestAgeMs >= 24 * HOUR_MS)\n\n/** Apply the optional decoder, falling back to the stored value on any failure\n * so a broken decoder degrades to blindness (reported) rather than to a fake\n * empty parts array (silent). */\nasync function decodeRowParts(\n decode: SweepOptions['decodeParts'],\n row: PersistedTurnRow,\n): Promise<unknown> {\n if (!decode) return row.parts\n try {\n const decoded = await decode(row.parts, row)\n return decoded ?? row.parts\n } catch {\n return row.parts\n }\n}\n\n/** What the sweep found. Returned as well as alerted, so a cron can log it and\n * a test can assert on it. */\nexport interface SweepResult {\n product: string\n /** Threads whose user messages have no real answer: {@link silentThreads}\n * plus {@link notifiedThreads}. */\n unansweredThreads: number\n pendingUserMessages: number\n oldestUnansweredMs: number\n /** Threads where nothing came back after the newest message. */\n silentThreads: number\n /** Of {@link silentThreads}, the ones `pageSilentThreads` selected. */\n pagedSilentThreads: number\n /** Threads that ended on a failure the person saw. */\n notifiedThreads: number\n turnsJudged: number\n unhealthyTurns: number\n emptyCompletions: number\n malformedToolCalls: number\n toolCallsWithoutEffect: number\n /** Tool calls the harness rejected while settling them as `completed`. */\n rejectedToolCalls: number\n /** Turns carrying at least one tool part. */\n turnsWithToolCalls: number\n /** Total tool parts across the window. */\n toolCalls: number\n /** Turns the classifier could not interpret at all (encrypted at rest, or a\n * part vocabulary this module does not know). These are EXCLUDED from\n * `turnsJudged`-based rates — a rate computed over rows nobody could read is\n * a fabricated number. */\n unreadableTurns: number\n /** Turns whose PARTS could not be interpreted. A superset of\n * {@link unreadableTurns} (a row can have readable text and opaque parts).\n * No tool verdict is drawn over these. */\n opaquePartsTurns: number\n /** Turns that persisted NO parts at all. Distinct from\n * {@link opaquePartsTurns}: nothing failed to parse, there was simply\n * nothing there. Also excluded from every tool verdict. */\n noPartsTurns: number\n /** Turns a tool verdict may actually be drawn from — parts present AND\n * interpretable. The denominator behind `dead_tool_surface`. */\n toolReadableTurns: number\n alerts: TurnHealthAlert[]\n}\n\nfunction parseParts(raw: unknown): unknown[] {\n if (Array.isArray(raw)) return raw\n if (typeof raw !== 'string' || raw.trim().length === 0) return []\n try {\n const parsed = JSON.parse(raw)\n return Array.isArray(parsed) ? parsed : []\n } catch {\n // A parts column that is not JSON is itself a corruption worth seeing, but\n // it is not this detector's job — treat as no parts rather than throwing.\n return []\n }\n}\n\nconst HOUR_MS = 3_600_000\n\n/**\n * Assistant-row openers agent-app writes ITSELF when a sandbox turn fails.\n *\n * Kept byte-identical to the strings `createSandboxChatProducer` composes\n * (`src/chat-routes/sandbox-producer.ts`). They are shell vocabulary, not\n * product domain, so recognising them is this package's job — a product on\n * the shared producer gets a correct sweep with no configuration.\n *\n * `tests/turn-health/turn-health.test.ts` pins these against the producer, so\n * changing the producer's wording without changing this list fails CI rather\n * than silently making dead threads look answered.\n */\n/** D1's maximum LIKE pattern length, including the trailing `%`. Measured, not\n * documented: 50 succeeds, 51 raises `SQLITE_ERROR: LIKE or GLOB pattern too\n * complex`. */\nexport const D1_MAX_LIKE_PATTERN_LENGTH = 50\n\nexport const SHELL_ERROR_REPLY_PREFIXES: readonly string[] = [\n 'The sandbox model stream stopped before a clean completion.',\n 'The sandbox agent returned an error before producing a visible answer.',\n \"The assistant's model refused its access key, so this message was not answered.\",\n]\n\n/**\n * Run one sweep and deliver whatever it finds.\n *\n * Errors from the sink are NOT swallowed here (unlike the live lane): a sweep\n * that could not deliver has accomplished nothing, and its cron invocation\n * should go red rather than report a clean run.\n */\nexport async function sweepSilentFailures(options: SweepOptions): Promise<SweepResult> {\n const now = options.now ?? Date.now()\n const minAgeMs = options.minAgeMs ?? 15 * 60_000\n const maxAgeMs = options.maxAgeMs ?? 7 * 24 * HOUR_MS\n const lookbackMs = options.lookbackMs ?? 24 * HOUR_MS\n const limit = options.limit ?? 500\n const emptyRateThreshold = options.emptyRateThreshold ?? 0.05\n const minTurnsForRate = options.minTurnsForRate ?? 10\n const minTurnsForToolSurface = options.minTurnsForToolSurface ?? 10\n // Half the window opaque means the sweep is guessing. Fixed rather than\n // configurable: a product must not be able to tune its own blindness report\n // into silence.\n const blindThreshold = 0.5\n\n const [unanswered, turns] = await Promise.all([\n options.source.findUnansweredThreads({ minAgeMs, maxAgeMs, now }),\n options.source.listRecentAssistantTurns({ sinceMs: now - lookbackMs, now, limit }),\n ])\n\n const alerts: TurnHealthAlert[] = []\n\n // ── silence: messages in, nothing out ──────────────────────────────────\n const pendingUserMessages = unanswered.reduce((sum, t) => sum + t.pendingMessages, 0)\n const oldestUnansweredMs = unanswered.reduce((max, t) => Math.max(max, t.oldestAgeMs), 0)\n const silent = unanswered.filter((t) => !t.notified)\n const notified = unanswered.filter((t) => t.notified)\n const paged = new Set(\n (await (options.pageSilentThreads ?? defaultPageSilentThreads)(silent)).map((t) => t.threadId),\n )\n const describeThread = (t: UnansweredThread) =>\n `thread ${t.threadId}: ${t.pendingMessages} pending, oldest ${(t.oldestAgeMs / HOUR_MS).toFixed(1)}h`\n\n if (silent.length > 0) {\n const silentMessages = silent.reduce((sum, t) => sum + t.pendingMessages, 0)\n const oldest = silent.reduce((max, t) => Math.max(max, t.oldestAgeMs), 0)\n alerts.push({\n product: options.product,\n severity: paged.size > 0 ? 'critical' : 'warning',\n key: `sweep:${options.product}:unanswered_threads`,\n title: `${options.product}: ${silentMessages} user message(s) unanswered across ${silent.length} thread(s), with no reply at all`,\n details: [\n `oldest unanswered message: ${(oldest / HOUR_MS).toFixed(1)}h; ${paged.size} of these thread(s) page`,\n // The threads that page come first, so the alert names what to open.\n ...[...silent.filter((t) => paged.has(t.threadId)), ...silent.filter((t) => !paged.has(t.threadId))]\n .slice(0, 5)\n .map((t) => `${describeThread(t)}${paged.has(t.threadId) ? ' (pages)' : ''}`),\n ],\n data: { silentThreads: silent.length, pagedSilentThreads: paged.size, pendingUserMessages: silentMessages, oldestUnansweredMs: oldest },\n at: now,\n })\n }\n if (notified.length > 0 && !options.failureNoticesReportedBy) {\n const notifiedMessages = notified.reduce((sum, t) => sum + t.pendingMessages, 0)\n alerts.push({\n product: options.product,\n severity: 'warning',\n key: `sweep:${options.product}:failed_threads`,\n title: `${options.product}: ${notifiedMessages} user message(s) across ${notified.length} thread(s) ended on a failure the person saw`,\n details: notified.slice(0, 5).map(describeThread),\n data: { notifiedThreads: notified.length, pendingUserMessages: notifiedMessages },\n at: now,\n })\n }\n\n // ── success that delivered nothing ─────────────────────────────────────\n let emptyCompletions = 0\n let malformedToolCalls = 0\n let toolCallsWithoutEffect = 0\n let rejectedToolCalls = 0\n let unhealthyTurns = 0\n let turnsWithToolCalls = 0\n let toolCalls = 0\n let unreadableTurns = 0\n // Turns whose PARTS were interpretable — the only rows a tool verdict may be\n // drawn from. Distinct from `unreadableTurns`, which is the harder blindness\n // (nothing judgeable at all).\n let toolReadableTurns = 0\n let opaquePartsTurns = 0\n // Rows that persisted NO parts at all. Not opaque (nothing failed to parse)\n // and not evidence either — counted separately so the coverage line can say\n // which of the two blindnesses applies.\n let noPartsTurns = 0\n const opaqueTypes = new Set<string>()\n const malformedSamples: TurnHealthReason[] = []\n const rejectedSamples: TurnHealthReason[] = []\n\n for await (const row of withParts(turns, options.source)) {\n const verdict = classifyTurnOutcome({\n finalText: row.content,\n parts: parseParts(await decodeRowParts(options.decodeParts, row)),\n outputTokens: row.outputTokens ?? null,\n })\n toolCalls += verdict.toolCalls\n if (verdict.toolCalls > 0) turnsWithToolCalls += 1\n // A tool verdict needs evidence that was READ. `partsReadable` alone is\n // satisfied vacuously by a row that persisted no parts, which is how a\n // product with 243 real tool calls was paged as having a dead tool surface.\n if (verdict.partsReadable && verdict.interpretedParts > 0) toolReadableTurns += 1\n else if (verdict.partsReadable) noPartsTurns += 1\n else {\n opaquePartsTurns += 1\n for (const t of verdict.opaquePartTypes) opaqueTypes.add(t)\n }\n if (verdict.unreadable) {\n unreadableTurns += 1\n continue\n }\n if (verdict.healthy) continue\n unhealthyTurns += 1\n for (const reason of verdict.reasons) {\n if (reason.kind === 'empty_completion') emptyCompletions += 1\n if (reason.kind === 'malformed_tool_call') {\n malformedToolCalls += 1\n if (malformedSamples.length < 3) malformedSamples.push(reason)\n }\n if (reason.kind === 'tool_call_no_effect') toolCallsWithoutEffect += 1\n if (reason.kind === 'tool_call_rejected') {\n rejectedToolCalls += 1\n if (rejectedSamples.length < 3) rejectedSamples.push(reason)\n }\n }\n }\n\n // Turns this sweep could actually judge. Every rate below divides by THIS,\n // never by the raw row count.\n const readableTurns = turns.length - unreadableTurns\n\n // A malformed tool call is never acceptable at any rate — it means a\n // deliverable was requested and silently discarded. Page on the first one.\n if (malformedToolCalls > 0) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:malformed_tool_call`,\n title: `${options.product}: ${malformedToolCalls} tool call(s) had unparseable arguments — deliverables silently dropped`,\n details: malformedSamples.map(describeReason),\n data: { malformedToolCalls, turnsJudged: turns.length },\n at: now,\n })\n }\n\n // A rejected call means a deliverable was requested and thrown away while the\n // turn reported success. Never acceptable at any rate.\n if (rejectedToolCalls > 0) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:tool_call_rejected`,\n title: `${options.product}: ${rejectedToolCalls} tool call(s) were REJECTED but settled as completed — deliverables silently dropped`,\n details: rejectedSamples.map(describeReason),\n data: { rejectedToolCalls, turnsJudged: readableTurns },\n at: now,\n })\n }\n\n if (readableTurns >= minTurnsForRate) {\n const rate = emptyCompletions / readableTurns\n if (rate > emptyRateThreshold) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:empty_completion_rate`,\n title: `${options.product}: ${(rate * 100).toFixed(1)}% of turns completed with no output`,\n details: [\n `${emptyCompletions} of ${readableTurns} readable settled turns delivered nothing`,\n `threshold ${(emptyRateThreshold * 100).toFixed(1)}%`,\n ],\n data: { emptyCompletions, turnsJudged: readableTurns, rate },\n at: now,\n })\n }\n }\n\n // ── the fourth shape: a tool surface that has gone quiet ───────────────\n //\n // Nothing errors, every turn answers fluently, and the product stops DOING\n // anything. Only visible across a window, which is why it needs its own pass\n // rather than a rule inside the per-turn classifier.\n // Judged ONLY over turns whose parts could be interpreted, and the count of\n // rows that could not is stated in the alert — a verdict that names its own\n // coverage can be trusted; one that hides it cannot.\n if (options.expectsToolCalls && toolReadableTurns >= minTurnsForToolSurface && toolCalls === 0) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:dead_tool_surface`,\n title: `${options.product}: ZERO tool calls across ${toolReadableTurns} turns — the tool surface is dead`,\n details: [\n `${toolReadableTurns} assistant turns with readable parts in the lookback, none of which called a tool`,\n 'the product declares its deliverable comes from tool calls, so it has answered without doing anything',\n ...(opaquePartsTurns > 0\n ? [`${opaquePartsTurns} further turn(s) had unreadable parts and were not judged`]\n : []),\n ...(noPartsTurns > 0\n ? [`${noPartsTurns} further turn(s) persisted no parts at all and were not judged`]\n : []),\n ],\n data: {\n turnsJudged: toolReadableTurns,\n toolCalls: 0,\n turnsWithToolCalls: 0,\n turnsNotJudged: opaquePartsTurns + noPartsTurns,\n opaquePartsTurns,\n noPartsTurns,\n },\n at: now,\n })\n }\n\n // A product that ASKED for a tool-surface verdict and did not get one must be\n // told that, or the absence of a page reads as a pass. This is the honest\n // form of the alert above: same question, and the answer is \"I could not\n // see\", which is a real finding about the product's observability rather than\n // a fabricated finding about its behaviour.\n if (\n options.expectsToolCalls &&\n toolReadableTurns < minTurnsForToolSurface &&\n opaquePartsTurns + noPartsTurns > 0\n ) {\n alerts.push({\n product: options.product,\n severity: 'warning',\n key: `sweep:${options.product}:tool_surface_unmeasurable`,\n title: `${options.product}: tool surface could not be certified — only ${toolReadableTurns} of ${turns.length} turns carried readable parts`,\n details: [\n ...(noPartsTurns > 0\n ? [`${noPartsTurns} turn(s) persisted no parts at all — nothing to read a tool call from`]\n : []),\n ...(opaquePartsTurns > 0\n ? [\n `${opaquePartsTurns} turn(s) stored parts this sweep cannot interpret (${\n [...opaqueTypes].join(', ') || 'unnamed'\n }) — supply \\`decodeParts\\` to make them readable`,\n ]\n : []),\n 'this is NOT a dead tool surface finding; it is the absence of evidence either way',\n ],\n data: {\n toolReadableTurns,\n noPartsTurns,\n opaquePartsTurns,\n turnsSeen: turns.length,\n opaqueTypes: [...opaqueTypes],\n },\n at: now,\n })\n }\n\n // ── the detector reporting on ITSELF ───────────────────────────────────\n //\n // The one verdict this module must never give is \"healthy\" derived from rows\n // it could not read. If most of the window was opaque, that fact is the\n // alert — silence here would be the module committing the exact failure it\n // was built to catch.\n if (opaquePartsTurns > 0 && opaquePartsTurns >= turns.length * blindThreshold) {\n alerts.push({\n product: options.product,\n severity: 'warning',\n key: `sweep:${options.product}:detector_blind`,\n title: `${options.product}: ${opaquePartsTurns} of ${turns.length} turns have unreadable parts — this sweep cannot certify them`,\n details: [\n `uninterpretable part types: ${[...opaqueTypes].join(', ') || '(none named)'}`,\n 'these rows are excluded from every verdict above; treat them as UNMEASURED, not healthy',\n ],\n data: {\n opaquePartsTurns,\n unreadableTurns,\n turnsSeen: turns.length,\n opaqueTypes: [...opaqueTypes],\n },\n at: now,\n })\n }\n\n for (const alert of alerts) await options.sink.deliver(alert)\n\n return {\n product: options.product,\n unansweredThreads: unanswered.length,\n pendingUserMessages,\n oldestUnansweredMs,\n silentThreads: silent.length,\n pagedSilentThreads: paged.size,\n notifiedThreads: notified.length,\n turnsJudged: turns.length,\n unhealthyTurns,\n emptyCompletions,\n malformedToolCalls,\n toolCallsWithoutEffect,\n rejectedToolCalls,\n turnsWithToolCalls,\n toolCalls,\n unreadableTurns,\n opaquePartsTurns,\n noPartsTurns,\n toolReadableTurns,\n alerts,\n }\n}\n\n// ── D1 source for the shared chat-store schema ────────────────────────────\n\n/** Minimal structural D1 contract (Cloudflare's `D1Database` satisfies it). */\nexport interface D1LikeForHealth {\n prepare(sql: string): {\n bind(...values: unknown[]): {\n all<T = Record<string, unknown>>(): Promise<{ results: T[] }>\n }\n }\n}\n\n/**\n * The sweep source for products on the canonical `/chat-store` tables.\n *\n * \"Answered\" deliberately means an assistant row with NON-EMPTY content. A\n * blank assistant row is what a broken turn writes, so counting it as an\n * answer would let the exact failure being hunted mark itself resolved. That\n * single predicate is the difference between this catching the gtm outage and\n * sleeping through it — during those sixteen days the table was NOT empty.\n *\n * The query deliberately does NOT join the thread table. Products do not all\n * keep one: tax-agent's `thread` table holds zero rows because it groups by\n * its own `tax_sessions`, and an inner join against it silently reported \"0\n * unanswered threads, healthy\" while 18 real messages sat unanswered. A\n * detector that reports healthy because its join found nothing is the same\n * bug class it was built to catch.\n */\nexport function createD1TurnHealthSource(\n db: D1LikeForHealth,\n options: {\n messageTable?: string\n threadTable?: string\n /**\n * Content prefixes that mark an assistant row as an ERROR SURFACE rather\n * than an answer. A row matching one of these stops counting as a reply,\n * so the thread keeps reporting as unanswered.\n *\n * This exists because the obvious rule — \"an assistant row with non-empty\n * content is an answer\" — is wrong in the exact case that matters. On\n * 2026-07-27 gtm-agent's newest assistant row read:\n *\n * \"The sandbox model stream stopped before a clean completion.\n * Error: All 2 model(s) failed. gpt-5-mini: TANGLE_HUB_URL is required …\"\n *\n * 246 characters of well-formed prose that answers nothing. Counting it\n * marks a dead product healthy — the same failure-returning-success shape\n * this module exists to catch, recursing into the detector itself.\n *\n * There is no schema-level way to recognise it: `output_tokens IS NULL`\n * looked promising until legal-agent showed 22 of 25 GENUINE replies with\n * null usage — it would have reported a working product broken.\n *\n * Defaults to {@link SHELL_ERROR_REPLY_PREFIXES}, the openers agent-app\n * ITSELF writes in `createSandboxChatProducer`. Those are not domain —\n * this package composed them, so this package is what must recognise\n * them, and every product on the shared producer is correct with no\n * configuration. Pass your own list to ADD product-specific error prose;\n * pass `[]` to disable the rule.\n *\n * Prefixes are bound as query parameters, never interpolated.\n */\n errorReplyPrefixes?: readonly string[]\n /**\n * Read each row's whole `parts` instead of the fields the classifier reads.\n * Only a product whose `decodeParts` needs the stored bytes (an encrypted\n * parts envelope) sets this; the default reads a small projection.\n */\n fullParts?: boolean\n } = {},\n): TurnHealthSource {\n // Table names are identifiers and cannot be bound as parameters. They come\n // from deploy-time product config, never from a request, and are validated\n // here so this can never become an injection point.\n const message = safeIdentifier(options.messageTable ?? 'message')\n const thread = safeIdentifier(options.threadTable ?? 'thread')\n // D1 rejects a LIKE pattern longer than 50 characters with\n // `SQLITE_ERROR: LIKE or GLOB pattern too complex`, and the pattern is the\n // prefix PLUS the trailing `%`. Measured against production D1 on\n // 2026-07-27: a 49-char prefix (50-char pattern) succeeds, 50 fails.\n //\n // Both shipped defaults are longer than that (55 and 70 characters), so\n // before this clamp `findUnansweredThreads` threw on every product database\n // — the detector could not run at all against the only store the fleet uses.\n //\n // Truncating is safe in the one direction that matters: a shorter prefix\n // matches MORE rows as non-answers, so a thread is reported unanswered\n // rather than silently marked healthy. The first 49 characters of each\n // default are still unambiguous.\n const errorPrefixes = [...(options.errorReplyPrefixes ?? SHELL_ERROR_REPLY_PREFIXES)].map((p) =>\n p.slice(0, D1_MAX_LIKE_PATTERN_LENGTH - 1),\n )\n\n return {\n async findUnansweredThreads({ minAgeMs, maxAgeMs, now }) {\n const cutoffSeconds = Math.floor((now - minAgeMs) / 1000)\n const floorSeconds = Math.floor((now - maxAgeMs) / 1000)\n // Each prefix becomes one bound `NOT LIKE ?||'%'` term. Parameters, not\n // interpolation — a product-supplied string never reaches the SQL text.\n const errorClause = errorPrefixes\n .map((_, i) => ` AND a.content NOT LIKE ?${i + 3} || '%'`)\n .join('')\n // A row after the newest pending message that showed something (error\n // prose, or a notice part) means the person saw the failure. A blank row\n // with no notice showed nothing, so its thread stays silent.\n const { results } = await db\n .prepare(\n `WITH pending AS (\n SELECT m.thread_id AS threadId,\n COUNT(*) AS pendingMessages,\n MIN(m.created_at) AS oldestCreatedAt,\n MAX(m.created_at) AS newestCreatedAt\n FROM ${message} m\n WHERE m.role = 'user'\n AND m.created_at <= ?1\n AND m.created_at >= ?2\n AND m.created_at > COALESCE(\n (SELECT MAX(a.created_at)\n FROM ${message} a\n WHERE a.thread_id = m.thread_id\n AND a.role = 'assistant'\n AND length(trim(a.content)) > 0${errorClause}), 0)\n GROUP BY m.thread_id\n )\n SELECT p.threadId, p.pendingMessages, p.oldestCreatedAt,\n EXISTS (\n SELECT 1 FROM ${message} a\n WHERE a.thread_id = p.threadId AND a.role = 'assistant' AND a.created_at >= p.newestCreatedAt\n AND (length(trim(coalesce(a.content, ''))) > 0 OR EXISTS (\n SELECT 1 FROM json_each(CASE WHEN json_valid(a.parts) THEN CASE WHEN json_type(a.parts) = 'array' THEN a.parts ELSE '[]' END ELSE '[]' END) n\n WHERE CASE WHEN n.type = 'object' THEN json_extract(n.value, '$.type') END = 'notice'))\n ) AS notified\n FROM pending p\n ORDER BY p.oldestCreatedAt ASC`,\n )\n .bind(cutoffSeconds, floorSeconds, ...errorPrefixes)\n .all<{ threadId: string; pendingMessages: number; oldestCreatedAt: number; notified: number }>()\n\n return results.map((row) => ({\n threadId: row.threadId,\n pendingMessages: Number(row.pendingMessages),\n oldestAgeMs: now - Number(row.oldestCreatedAt) * 1000,\n notified: Number(row.notified) === 1,\n }))\n },\n\n async listRecentAssistantTurns({ sinceMs, limit }) {\n const sinceSeconds = Math.floor(sinceMs / 1000)\n const { results } = await db\n .prepare(\n `SELECT id, thread_id AS threadId, content, length(parts) AS partsSize,\n output_tokens AS outputTokens, model, created_at AS createdAt\n FROM ${message}\n WHERE role = 'assistant' AND created_at >= ?1\n ORDER BY created_at DESC\n LIMIT ?2`,\n )\n .bind(sinceSeconds, limit)\n .all<Record<string, unknown>>()\n\n return results.map((row) => ({\n id: String(row.id),\n threadId: String(row.threadId),\n content: typeof row.content === 'string' ? row.content : '',\n parts: undefined,\n partsSize: row.partsSize === null ? null : Number(row.partsSize),\n outputTokens: row.outputTokens === null ? null : Number(row.outputTokens),\n model: (row.model as string | null) ?? null,\n createdAt: Number(row.createdAt) * 1000,\n }))\n },\n\n async readParts(ids) {\n if (ids.length === 0) return new Map()\n const placeholders = ids.map((_, i) => `?${i + 1}`).join(', ')\n if (options.fullParts) {\n const { results } = await db\n .prepare(`SELECT id, parts FROM ${message} WHERE id IN (${placeholders})`)\n .bind(...ids)\n .all<{ id: string; parts: unknown }>()\n return new Map(results.map((row) => [String(row.id), row.parts]))\n }\n // One row per part with only what classifyTurnOutcome reads, so a day of\n // tool output never leaves the database: the full read\n // returned 141.9 MB per run for 500 turns.\n const { results } = await db\n .prepare(`SELECT m.id AS id, CAST(p.key AS INTEGER) AS idx, ${PART_PROJECTION}\n FROM ${message} m, json_each(CASE WHEN json_valid(m.parts) THEN CASE WHEN json_type(m.parts) = 'array' THEN m.parts ELSE '[]' END ELSE '[]' END) p\n WHERE m.id IN (${placeholders})\n ORDER BY m.id, idx`)\n .bind(...ids)\n .all<ProjectedPart & { id: string }>()\n const parts = new Map<string, unknown[]>(ids.map((id) => [id, []]))\n for (const row of results) parts.get(String(row.id))?.push(slimPart(row))\n return parts\n },\n }\n\n function safeIdentifier(name: string): string {\n if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {\n throw new Error(`unsafe table identifier: ${name}`)\n }\n return name\n }\n}\n"],"mappings":"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","names":["results"]}
1
+ {"version":3,"sources":["../../src/turn-health/lifecycle.ts","../../src/turn-health/sweep.ts"],"sourcesContent":["/**\n * The LIVE half: judge each turn the moment it settles.\n *\n * This adds no control flow. `createChatTurnRoutes` already exposes a\n * `lifecycle` seam that fires exactly one of `onTurnComplete`/`onTurnError`\n * after a turn settles, and already swallows hook errors so telemetry cannot\n * fail a turn. That seam was shipped and then wired by nobody, which is a fair\n * description of why the outage lasted 17 days. This function fills it.\n *\n * The shape is declared structurally rather than imported from\n * `/chat-routes`, so `/turn-health` stays free of the server chat vertical and\n * can be used by any turn driver that reports the same three moments.\n */\n\nimport { classifyTurnOutcome } from './classify.js'\nimport { type AlertSink, createGuardedAlertSink, turnAlert } from './sink.js'\n\n/** Structural mirror of `/chat-routes`' `ChatTurnLifecycle` complete payload. */\nexport interface TurnHealthCompleteInfo {\n finalText: string\n usage?: { outputTokens?: number | null } | null\n durationMs: number\n threadId?: string\n turnStreamId?: string\n executionId?: string\n /** `/chat-routes` sets this when a `contextGate` short-circuited the turn and\n * the producer never ran. */\n gated?: boolean\n}\n\n/** Structural mirror of the lifecycle error payload. */\nexport interface TurnHealthErrorInfo {\n error: unknown\n durationMs: number\n threadId?: string\n turnStreamId?: string\n executionId?: string\n}\n\n/** What {@link createTurnHealthLifecycle} returns — assignable to\n * `createChatTurnRoutes`' `lifecycle` option. */\nexport interface TurnHealthLifecycle {\n onTurnComplete(info: TurnHealthCompleteInfo): Promise<void>\n onTurnError(info: TurnHealthErrorInfo): Promise<void>\n}\n\nexport interface TurnHealthLifecycleOptions {\n /** Names the product in every alert. */\n product: string\n sink: AlertSink\n /** Called for every verdict, healthy or not — the hook for a counter or a\n * metrics push. Alerts are for humans; this is for graphs. */\n onVerdict?(verdict: {\n product: string\n healthy: boolean\n kinds: string[]\n durationMs: number\n }): void\n /** Page when a turn was answered by a gate instead of the model.\n *\n * Default `false`, and the default is the honest one: gating is a legitimate\n * design and a product that gates its intake would otherwise page on every\n * healthy turn. Whether the rate is pathological is domain knowledge, so it\n * stays a product decision — the verdict is ALWAYS reported through\n * {@link TurnHealthLifecycleOptions.onVerdict} so a counter can watch the\n * rate even when nobody is paged. */\n alertOnGatedTurn?: boolean\n}\n\nfunction errorText(error: unknown): string {\n if (error instanceof Error) return error.message\n if (typeof error === 'string') return error\n return String(error)\n}\n\n/**\n * Build the lifecycle hooks that page on a turn which succeeded at nothing.\n *\n * The live lane sees `finalText` and usage but not the persisted parts, so it\n * catches the blank-completion and hard-failure shapes immediately. The\n * parts-dependent shapes (a tool call whose arguments never parsed, a tool\n * call that left no effect) are caught by {@link sweepSilentFailures}, which\n * reads what was actually written to the store — the honest place to ask\n * whether an effect persisted.\n */\nexport function createTurnHealthLifecycle(\n options: TurnHealthLifecycleOptions,\n): TurnHealthLifecycle {\n // Guarded: a paging failure must never take down a customer's turn.\n const sink = createGuardedAlertSink(options.sink)\n\n return {\n async onTurnComplete(info) {\n const verdict = classifyTurnOutcome({\n finalText: info.finalText,\n outputTokens: info.usage?.outputTokens ?? null,\n durationMs: info.durationMs,\n ...(info.gated ? { gated: true } : {}),\n })\n options.onVerdict?.({\n product: options.product,\n healthy: verdict.healthy,\n kinds: verdict.reasons.map((r) => r.kind),\n durationMs: info.durationMs,\n })\n if (verdict.healthy || verdict.severity === null) return\n // Counted above, paged only on request — see `alertOnGatedTurn`.\n if (!options.alertOnGatedTurn && verdict.reasons.every((r) => r.kind === 'answered_without_model')) {\n return\n }\n await sink.deliver(\n turnAlert({\n product: options.product,\n severity: verdict.severity,\n reasons: verdict.reasons,\n ...(info.threadId ? { threadId: info.threadId } : {}),\n ...(info.executionId ? { turnId: info.executionId } : {}),\n }),\n )\n },\n\n async onTurnError(info) {\n const verdict = classifyTurnOutcome({\n failed: true,\n failureReason: errorText(info.error),\n durationMs: info.durationMs,\n })\n options.onVerdict?.({\n product: options.product,\n healthy: false,\n kinds: verdict.reasons.map((r) => r.kind),\n durationMs: info.durationMs,\n })\n await sink.deliver(\n turnAlert({\n product: options.product,\n severity: 'critical',\n reasons: verdict.reasons,\n ...(info.threadId ? { threadId: info.threadId } : {}),\n ...(info.executionId ? { turnId: info.executionId } : {}),\n }),\n )\n },\n }\n}\n","/**\n * The SWEEP half: ask the store what it has been quietly accumulating.\n *\n * A live per-turn hook cannot see the failure that matters most, because the\n * worst outage produced NO turns at all to hook: gtm-agent took 9–21 user\n * messages a day for sixteen straight days and wrote zero real assistant\n * replies. Nothing crashed on a schedule; the product simply stopped\n * answering. The only thing that could have noticed is something that\n * periodically counts what arrived against what was answered.\n *\n * That is this. It runs on a cron, reads the shared `/chat-store` schema, and\n * pages when the ratio breaks.\n *\n * The queries live HERE and not in each product because all four products\n * (gtm, tax, legal, workcomp) persist to the same `message`/`thread` tables —\n * four copies of this cron is exactly the duplication the repo's engine/shell\n * rule exists to prevent.\n */\n\nimport { classifyTurnOutcome, describeReason, type TurnHealthReason } from './classify.js'\nimport type { AlertSink, TurnHealthAlert } from './sink.js'\nimport { SIZED_READ_BYTES, sizedBatches } from '../launch-invariants/sized-reads.js'\n\n/** A thread that has taken user messages with no reply since. */\nexport interface UnansweredThread {\n threadId: string\n /** User messages newer than the newest real assistant reply. */\n pendingMessages: number\n /** Age of the OLDEST unanswered user message, in ms. */\n oldestAgeMs: number\n /** The newest of these messages was followed by a row that showed the person\n * something (a failure notice or error prose), so they know it failed. False\n * or absent: nothing came back at all. */\n notified?: boolean\n}\n\n/** A persisted assistant row, as the sweep needs to judge it. */\nexport interface PersistedTurnRow {\n id: string\n threadId: string\n content: string\n /** Raw `parts` column. A JSON string or an already-parsed array; the sweep\n * accepts both because D1 drivers differ. Left undefined by a source that\n * lists rows by {@link partsSize} and serves parts through\n * {@link TurnHealthSource.readParts}. */\n parts: unknown\n /** Stored length of `parts` (SQLite `length()`), set when the row was listed\n * without them. The sweep batches {@link TurnHealthSource.readParts} by it. */\n partsSize?: number | null\n outputTokens?: number | null\n model?: string | null\n createdAt: number\n}\n\n/** What the sweep needs from a store. A product on a non-standard schema\n * implements these two reads; everything else is shared. */\nexport interface TurnHealthSource {\n findUnansweredThreads(input: {\n minAgeMs: number\n /** Ignore user messages older than this. See {@link SweepOptions.maxAgeMs}. */\n maxAgeMs: number\n now: number\n }): Promise<UnansweredThread[]>\n listRecentAssistantTurns(input: { sinceMs: number; now: number; limit: number }): Promise<\n PersistedTurnRow[]\n >\n /**\n * The stored `parts` of these rows, by id, for a source that lists rows\n * without them. The sweep asks for at most {@link TURN_HEALTH_PARTS_BATCH_SIZE}\n * of parts at a time and judges each batch before it reads the next, so memory\n * holds one batch rather than the whole window.\n *\n * On 2026-10-10 gtm-agent's 500 newest assistant rows carried 122 MB of\n * parts (the largest 2.8 MB). Read in one query they exceeded the Worker's\n * 128 MB, which stopped the hourly cron and every sweep queued after this one.\n */\n readParts?(ids: readonly string[]): Promise<Map<string, unknown>>\n}\n\n/**\n * The part fields classifyTurnOutcome reads, as SQL over one `json_each` row.\n * Each string field is taken only when its JSON type is text, so a non-string\n * value reads exactly as the classifier would see it in the full part.\n */\n/** `expr` evaluated only on an object part: json_type and json_extract raise on a bare string element. */\nconst onObject = (expr: string) => `CASE WHEN p.type = 'object' THEN ${expr} END`\n/** The value at `path` when it is a JSON string, else NULL. */\nconst textAt = (path: string, take = `json_extract(p.value, '${path}')`) => onObject(`CASE WHEN json_type(p.value, '${path}') = 'text' THEN ${take} END`)\nconst PART_PROJECTION = [\n `p.type AS partKind`,\n `${textAt('$.type')} AS type`,\n `coalesce(${onObject(`CASE WHEN json_type(p.value, '$.text') = 'text' AND length(trim(json_extract(p.value, '$.text'), char(32, 9, 10, 13))) > 0 THEN 1 ELSE 0 END`)}, 0) AS hasText`,\n `${textAt('$.tool')} AS tool`,\n `${onObject(`json_type(p.value, '$.state')`)} AS stateKind`,\n `${textAt('$.state.status')} AS status`,\n `${textAt('$.state.error', `substr(json_extract(p.value, '$.state.error'), 1, 200)`)} AS stateError`,\n `${onObject(`json_type(p.value, '$.state.input')`)} AS inputKind`,\n `${textAt('$.state.input.error', `substr(json_extract(p.value, '$.state.input.error'), 1, 200)`)} AS inputError`,\n `${textAt('$.state.input.tool')} AS inputTool`,\n `${textAt('$.state.input', `json_valid(json_extract(p.value, '$.state.input'))`)} AS inputValid`,\n `${textAt('$.state.input', `substr(json_extract(p.value, '$.state.input'), 1, 120)`)} AS inputSample`,\n].join(',\\n ')\n\ninterface ProjectedPart {\n partKind: string | null\n type: string | null\n hasText: number\n tool: string | null\n stateKind: string | null\n status: string | null\n stateError: string | null\n inputKind: string | null\n inputError: string | null\n inputTool: string | null\n inputValid: number | null\n inputSample: string | null\n}\n\n/** A part rebuilt from its projection, judged by classifyTurnOutcome as the stored part would be. */\nfunction slimPart(row: ProjectedPart): unknown {\n // classifyTurnOutcome treats an array part as a record with no type (an opaque part) and skips any other non-object.\n if (row.partKind === 'array') return []\n if (row.partKind !== 'object') return null\n const part: Record<string, unknown> = {}\n if (row.type !== null) part.type = row.type\n if (row.hasText) part.text = 'x'\n if (row.tool !== null) part.tool = row.tool\n if (row.stateKind === 'object') {\n const state: Record<string, unknown> = {}\n if (row.status !== null) state.status = row.status\n if (row.stateError !== null) state.error = row.stateError\n if (row.inputKind === 'object') {\n const input: Record<string, unknown> = {}\n if (row.inputError !== null) input.error = row.inputError\n if (row.inputTool !== null) input.tool = row.inputTool\n state.input = input\n } else if (row.inputKind === 'text') {\n // A parseable string reads as parseable; an unparseable one keeps its sample and a NUL after it, so its prefix\n // can never parse by accident.\n state.input = row.inputValid ? '{}' : `${row.inputSample ?? ''}\\u0000`\n } else if (row.inputKind !== null) {\n state.input = null\n }\n part.state = state\n }\n return part\n}\n\n/** Most stored parts the sweep reads in one batch; a larger row is read alone. */\nexport const TURN_HEALTH_PARTS_BATCH_SIZE = SIZED_READ_BYTES\n\n/** Consecutive rows whose listed parts size fits one read. */\nfunction partsBatches(rows: readonly PersistedTurnRow[]): PersistedTurnRow[][] {\n return sizedBatches(rows.map((row) => ({ key: row, size: row.partsSize })), { bytes: TURN_HEALTH_PARTS_BATCH_SIZE })\n}\n\n/** The listed rows with their parts, read one batch at a time when the source listed them without. */\nasync function* withParts(rows: readonly PersistedTurnRow[], source: TurnHealthSource): AsyncGenerator<PersistedTurnRow> {\n for (const batch of partsBatches(rows)) {\n const unread = batch.filter((row) => row.parts === undefined && (row.partsSize ?? 0) > 0).map((row) => row.id)\n // A read failure propagates, like the listing's, so the caller retries the sweep.\n const read = unread.length > 0 && source.readParts ? await source.readParts(unread) : null\n for (const row of batch) yield read?.has(row.id) ? { ...row, parts: read.get(row.id) } : row\n }\n}\n\nexport interface SweepOptions {\n product: string\n source: TurnHealthSource\n sink: AlertSink\n /** A user message must go unanswered this long before it counts. Guards\n * against alerting on a turn that is simply still streaming. Default 15 min. */\n minAgeMs?: number\n /**\n * A user message OLDER than this is abandoned, not unanswered — it stops\n * counting. Default 7 days.\n *\n * Without this bound the sweep is worse than useless. gtm-agent's table\n * holds 384 unanswered messages whose oldest is 1,676 h (70 days) old;\n * paging hourly on a backlog nobody will ever reply to is exactly how an\n * alert channel gets muted, and a muted channel is the state this module\n * exists to escape. The alert has to mean \"something broke recently\".\n */\n maxAgeMs?: number\n /** How far back to judge settled turns. Default 24 h. */\n lookbackMs?: number\n /** Cap on rows judged per sweep. Default 500. */\n limit?: number\n /** Fraction of recent turns allowed to be silently broken before paging.\n * Default 0.05 — the measured blank-completion rate on the tax tool surface\n * was 12.2%, so 5% separates a real regression from noise. */\n emptyRateThreshold?: number\n /** Absolute floor: never page on a rate computed from fewer turns than this. */\n minTurnsForRate?: number\n /** Declare that this product's deliverable comes from TOOL calls, which\n * switches on the dead-tool-surface detector.\n *\n * Opt-in because only the product knows: a copilot that answers from context\n * is perfectly healthy with zero tool calls, while an agent whose entire job\n * is to file, draft, or submit something is broken the moment its tool\n * surface goes quiet — and broken INVISIBLY, because every turn still\n * returns fluent prose and HTTP 200.\n *\n * This is the fourth failure shape, and the only one no per-turn rule can\n * see.\n *\n * The verdict is drawn ONLY over turns whose parts were present and\n * readable. An earlier revision counted rows that stored no parts, and the\n * production example this comment used to cite was that bug rather than a\n * finding: tax-agent's 97 parts-less rows all predate its parts persistence\n * (they stop at 2026-07-17T02:20Z, the encrypted rows start 02:58Z), while\n * the same database's `turn_events` table holds 243 `tool_call` frames over\n * 15 turns. The tool surface was never dead; the rows were empty. */\n expectsToolCalls?: boolean\n /** Turns needed before a dead tool surface is called. Default 10. */\n minTurnsForToolSurface?: number\n /**\n * Make an at-rest parts encoding readable, so this sweep can judge a product\n * that does not store parts in the clear.\n *\n * Without it, a product that encrypts `parts` (tax-agent wraps the whole\n * array in one `__encrypted_parts__` part) is permanently UNMEASURABLE by the\n * tool-surface rule: every row is opaque, so the honest verdict is \"cannot\n * certify\" forever. This seam is how such a product gets a real verdict\n * instead of permanent blindness — the sweep stays domain-free and the\n * product supplies the decoder.\n *\n * Return the decoded parts value (it is parsed exactly like a stored one).\n * Returning `null`/`undefined` or THROWING leaves the row's stored value in\n * place, so a decoder that fails reports the row as opaque. It must never\n * report success as an empty array: that manufactures the exact absent-parts\n * blindness this module now refuses to draw conclusions from.\n */\n decodeParts?: (raw: unknown, row: PersistedTurnRow) => Promise<unknown> | unknown\n /**\n * Which threads that got no reply at all should page (a `critical` alert);\n * the rest are reported as a `warning`. A product passes its own rule, such\n * as only its customers' and operators' threads, so internal and evaluation\n * traffic stops paging. Default: threads silent for 24 hours or more.\n */\n pageSilentThreads?: (threads: UnansweredThread[]) => Promise<UnansweredThread[]> | UnansweredThread[]\n /**\n * Where a product already reports threads that ended on a failure the person\n * saw, such as its reliability report. When set, those threads are counted\n * but not alerted here. Unset, they are a `warning`, so a product whose every\n * reply is an error message still shows up.\n */\n failureNoticesReportedBy?: string\n now?: number\n}\n\nconst defaultPageSilentThreads = (threads: UnansweredThread[]) => threads.filter((thread) => thread.oldestAgeMs >= 24 * HOUR_MS)\n\n/** Apply the optional decoder, falling back to the stored value on any failure\n * so a broken decoder degrades to blindness (reported) rather than to a fake\n * empty parts array (silent). */\nasync function decodeRowParts(\n decode: SweepOptions['decodeParts'],\n row: PersistedTurnRow,\n): Promise<unknown> {\n if (!decode) return row.parts\n try {\n const decoded = await decode(row.parts, row)\n return decoded ?? row.parts\n } catch {\n return row.parts\n }\n}\n\n/** What the sweep found. Returned as well as alerted, so a cron can log it and\n * a test can assert on it. */\nexport interface SweepResult {\n product: string\n /** Threads whose user messages have no real answer: {@link silentThreads}\n * plus {@link notifiedThreads}. */\n unansweredThreads: number\n pendingUserMessages: number\n oldestUnansweredMs: number\n /** Threads where nothing came back after the newest message. */\n silentThreads: number\n /** Of {@link silentThreads}, the ones `pageSilentThreads` selected. */\n pagedSilentThreads: number\n /** Threads that ended on a failure the person saw. */\n notifiedThreads: number\n turnsJudged: number\n unhealthyTurns: number\n emptyCompletions: number\n malformedToolCalls: number\n toolCallsWithoutEffect: number\n /** Tool calls the harness rejected while settling them as `completed`. */\n rejectedToolCalls: number\n /** Turns carrying at least one tool part. */\n turnsWithToolCalls: number\n /** Total tool parts across the window. */\n toolCalls: number\n /** Turns the classifier could not interpret at all (encrypted at rest, or a\n * part vocabulary this module does not know). These are EXCLUDED from\n * `turnsJudged`-based rates — a rate computed over rows nobody could read is\n * a fabricated number. */\n unreadableTurns: number\n /** Turns whose PARTS could not be interpreted. A superset of\n * {@link unreadableTurns} (a row can have readable text and opaque parts).\n * No tool verdict is drawn over these. */\n opaquePartsTurns: number\n /** Turns that persisted NO parts at all. Distinct from\n * {@link opaquePartsTurns}: nothing failed to parse, there was simply\n * nothing there. Also excluded from every tool verdict. */\n noPartsTurns: number\n /** Turns a tool verdict may actually be drawn from — parts present AND\n * interpretable. The denominator behind `dead_tool_surface`. */\n toolReadableTurns: number\n alerts: TurnHealthAlert[]\n}\n\nfunction parseParts(raw: unknown): unknown[] {\n if (Array.isArray(raw)) return raw\n if (typeof raw !== 'string' || raw.trim().length === 0) return []\n try {\n const parsed = JSON.parse(raw)\n return Array.isArray(parsed) ? parsed : []\n } catch {\n // A parts column that is not JSON is itself a corruption worth seeing, but\n // it is not this detector's job — treat as no parts rather than throwing.\n return []\n }\n}\n\nconst HOUR_MS = 3_600_000\n\n/**\n * Assistant-row openers agent-app writes ITSELF when a sandbox turn fails.\n *\n * Kept byte-identical to the strings `createSandboxChatProducer` composes\n * (`src/chat-routes/sandbox-producer.ts`). They are shell vocabulary, not\n * product domain, so recognising them is this package's job — a product on\n * the shared producer gets a correct sweep with no configuration.\n *\n * `tests/turn-health/turn-health.test.ts` pins these against the producer, so\n * changing the producer's wording without changing this list fails CI rather\n * than silently making dead threads look answered.\n */\n/** D1's maximum LIKE pattern length, including the trailing `%`. Measured, not\n * documented: 50 succeeds, 51 raises `SQLITE_ERROR: LIKE or GLOB pattern too\n * complex`. */\nexport const D1_MAX_LIKE_PATTERN_LENGTH = 50\n\nexport const SHELL_ERROR_REPLY_PREFIXES: readonly string[] = [\n 'The sandbox model stream stopped before a clean completion.',\n 'The sandbox agent returned an error before producing a visible answer.',\n \"The assistant's model refused its access key, so this message was not answered.\",\n]\n\n/**\n * Run one sweep and deliver whatever it finds.\n *\n * Errors from the sink are NOT swallowed here (unlike the live lane): a sweep\n * that could not deliver has accomplished nothing, and its cron invocation\n * should go red rather than report a clean run.\n */\nexport async function sweepSilentFailures(options: SweepOptions): Promise<SweepResult> {\n const now = options.now ?? Date.now()\n const minAgeMs = options.minAgeMs ?? 15 * 60_000\n const maxAgeMs = options.maxAgeMs ?? 7 * 24 * HOUR_MS\n const lookbackMs = options.lookbackMs ?? 24 * HOUR_MS\n const limit = options.limit ?? 500\n const emptyRateThreshold = options.emptyRateThreshold ?? 0.05\n const minTurnsForRate = options.minTurnsForRate ?? 10\n const minTurnsForToolSurface = options.minTurnsForToolSurface ?? 10\n // Half the window opaque means the sweep is guessing. Fixed rather than\n // configurable: a product must not be able to tune its own blindness report\n // into silence.\n const blindThreshold = 0.5\n\n const [unanswered, turns] = await Promise.all([\n options.source.findUnansweredThreads({ minAgeMs, maxAgeMs, now }),\n options.source.listRecentAssistantTurns({ sinceMs: now - lookbackMs, now, limit }),\n ])\n\n const alerts: TurnHealthAlert[] = []\n\n // ── silence: messages in, nothing out ──────────────────────────────────\n const pendingUserMessages = unanswered.reduce((sum, t) => sum + t.pendingMessages, 0)\n const oldestUnansweredMs = unanswered.reduce((max, t) => Math.max(max, t.oldestAgeMs), 0)\n const silent = unanswered.filter((t) => !t.notified)\n const notified = unanswered.filter((t) => t.notified)\n const paged = new Set(\n (await (options.pageSilentThreads ?? defaultPageSilentThreads)(silent)).map((t) => t.threadId),\n )\n const describeThread = (t: UnansweredThread) =>\n `thread ${t.threadId}: ${t.pendingMessages} pending, oldest ${(t.oldestAgeMs / HOUR_MS).toFixed(1)}h`\n\n if (silent.length > 0) {\n const silentMessages = silent.reduce((sum, t) => sum + t.pendingMessages, 0)\n const oldest = silent.reduce((max, t) => Math.max(max, t.oldestAgeMs), 0)\n alerts.push({\n product: options.product,\n severity: paged.size > 0 ? 'critical' : 'warning',\n key: `sweep:${options.product}:unanswered_threads`,\n title: `${options.product}: ${silentMessages} user message(s) unanswered across ${silent.length} thread(s), with no reply at all`,\n details: [\n `oldest unanswered message: ${(oldest / HOUR_MS).toFixed(1)}h; ${paged.size} of these thread(s) page`,\n // The threads that page come first, so the alert names what to open.\n ...[...silent.filter((t) => paged.has(t.threadId)), ...silent.filter((t) => !paged.has(t.threadId))]\n .slice(0, 5)\n .map((t) => `${describeThread(t)}${paged.has(t.threadId) ? ' (pages)' : ''}`),\n ],\n data: { silentThreads: silent.length, pagedSilentThreads: paged.size, pendingUserMessages: silentMessages, oldestUnansweredMs: oldest },\n at: now,\n })\n }\n if (notified.length > 0 && !options.failureNoticesReportedBy) {\n const notifiedMessages = notified.reduce((sum, t) => sum + t.pendingMessages, 0)\n alerts.push({\n product: options.product,\n severity: 'warning',\n key: `sweep:${options.product}:failed_threads`,\n title: `${options.product}: ${notifiedMessages} user message(s) across ${notified.length} thread(s) ended on a failure the person saw`,\n details: notified.slice(0, 5).map(describeThread),\n data: { notifiedThreads: notified.length, pendingUserMessages: notifiedMessages },\n at: now,\n })\n }\n\n // ── success that delivered nothing ─────────────────────────────────────\n let emptyCompletions = 0\n let malformedToolCalls = 0\n let toolCallsWithoutEffect = 0\n let rejectedToolCalls = 0\n let unhealthyTurns = 0\n let turnsWithToolCalls = 0\n let toolCalls = 0\n let unreadableTurns = 0\n // Turns whose PARTS were interpretable — the only rows a tool verdict may be\n // drawn from. Distinct from `unreadableTurns`, which is the harder blindness\n // (nothing judgeable at all).\n let toolReadableTurns = 0\n let opaquePartsTurns = 0\n // Rows that persisted NO parts at all. Not opaque (nothing failed to parse)\n // and not evidence either — counted separately so the coverage line can say\n // which of the two blindnesses applies.\n let noPartsTurns = 0\n const opaqueTypes = new Set<string>()\n const malformedSamples: TurnHealthReason[] = []\n const rejectedSamples: TurnHealthReason[] = []\n\n for await (const row of withParts(turns, options.source)) {\n const verdict = classifyTurnOutcome({\n finalText: row.content,\n parts: parseParts(await decodeRowParts(options.decodeParts, row)),\n outputTokens: row.outputTokens ?? null,\n })\n toolCalls += verdict.toolCalls\n if (verdict.toolCalls > 0) turnsWithToolCalls += 1\n // A tool verdict needs evidence that was READ. `partsReadable` alone is\n // satisfied vacuously by a row that persisted no parts, which is how a\n // product with 243 real tool calls was paged as having a dead tool surface.\n if (verdict.partsReadable && verdict.interpretedParts > 0) toolReadableTurns += 1\n else if (verdict.partsReadable) noPartsTurns += 1\n else {\n opaquePartsTurns += 1\n for (const t of verdict.opaquePartTypes) opaqueTypes.add(t)\n }\n if (verdict.unreadable) {\n unreadableTurns += 1\n continue\n }\n if (verdict.healthy) continue\n unhealthyTurns += 1\n for (const reason of verdict.reasons) {\n if (reason.kind === 'empty_completion') emptyCompletions += 1\n if (reason.kind === 'malformed_tool_call') {\n malformedToolCalls += 1\n if (malformedSamples.length < 3) malformedSamples.push(reason)\n }\n if (reason.kind === 'tool_call_no_effect') toolCallsWithoutEffect += 1\n if (reason.kind === 'tool_call_rejected') {\n rejectedToolCalls += 1\n if (rejectedSamples.length < 3) rejectedSamples.push(reason)\n }\n }\n }\n\n // Turns this sweep could actually judge. Every rate below divides by THIS,\n // never by the raw row count.\n const readableTurns = turns.length - unreadableTurns\n\n // A malformed tool call is never acceptable at any rate — it means a\n // deliverable was requested and silently discarded. Page on the first one.\n if (malformedToolCalls > 0) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:malformed_tool_call`,\n title: `${options.product}: ${malformedToolCalls} tool call(s) had unparseable arguments — deliverables silently dropped`,\n details: malformedSamples.map(describeReason),\n data: { malformedToolCalls, turnsJudged: turns.length },\n at: now,\n })\n }\n\n // A rejected call means a deliverable was requested and thrown away while the\n // turn reported success. Never acceptable at any rate.\n if (rejectedToolCalls > 0) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:tool_call_rejected`,\n title: `${options.product}: ${rejectedToolCalls} tool call(s) were REJECTED but settled as completed — deliverables silently dropped`,\n details: rejectedSamples.map(describeReason),\n data: { rejectedToolCalls, turnsJudged: readableTurns },\n at: now,\n })\n }\n\n if (readableTurns >= minTurnsForRate) {\n const rate = emptyCompletions / readableTurns\n if (rate > emptyRateThreshold) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:empty_completion_rate`,\n title: `${options.product}: ${(rate * 100).toFixed(1)}% of turns completed with no output`,\n details: [\n `${emptyCompletions} of ${readableTurns} readable settled turns delivered nothing`,\n `threshold ${(emptyRateThreshold * 100).toFixed(1)}%`,\n ],\n data: { emptyCompletions, turnsJudged: readableTurns, rate },\n at: now,\n })\n }\n }\n\n // ── the fourth shape: a tool surface that has gone quiet ───────────────\n //\n // Nothing errors, every turn answers fluently, and the product stops DOING\n // anything. Only visible across a window, which is why it needs its own pass\n // rather than a rule inside the per-turn classifier.\n // Judged ONLY over turns whose parts could be interpreted, and the count of\n // rows that could not is stated in the alert — a verdict that names its own\n // coverage can be trusted; one that hides it cannot.\n if (options.expectsToolCalls && toolReadableTurns >= minTurnsForToolSurface && toolCalls === 0) {\n alerts.push({\n product: options.product,\n severity: 'critical',\n key: `sweep:${options.product}:dead_tool_surface`,\n title: `${options.product}: ZERO tool calls across ${toolReadableTurns} turns — the tool surface is dead`,\n details: [\n `${toolReadableTurns} assistant turns with readable parts in the lookback, none of which called a tool`,\n 'the product declares its deliverable comes from tool calls, so it has answered without doing anything',\n ...(opaquePartsTurns > 0\n ? [`${opaquePartsTurns} further turn(s) had unreadable parts and were not judged`]\n : []),\n ...(noPartsTurns > 0\n ? [`${noPartsTurns} further turn(s) persisted no parts at all and were not judged`]\n : []),\n ],\n data: {\n turnsJudged: toolReadableTurns,\n toolCalls: 0,\n turnsWithToolCalls: 0,\n turnsNotJudged: opaquePartsTurns + noPartsTurns,\n opaquePartsTurns,\n noPartsTurns,\n },\n at: now,\n })\n }\n\n // A product that ASKED for a tool-surface verdict and did not get one must be\n // told that, or the absence of a page reads as a pass. This is the honest\n // form of the alert above: same question, and the answer is \"I could not\n // see\", which is a real finding about the product's observability rather than\n // a fabricated finding about its behaviour.\n if (\n options.expectsToolCalls &&\n toolReadableTurns < minTurnsForToolSurface &&\n opaquePartsTurns + noPartsTurns > 0\n ) {\n alerts.push({\n product: options.product,\n severity: 'warning',\n key: `sweep:${options.product}:tool_surface_unmeasurable`,\n title: `${options.product}: tool surface could not be certified — only ${toolReadableTurns} of ${turns.length} turns carried readable parts`,\n details: [\n ...(noPartsTurns > 0\n ? [`${noPartsTurns} turn(s) persisted no parts at all — nothing to read a tool call from`]\n : []),\n ...(opaquePartsTurns > 0\n ? [\n `${opaquePartsTurns} turn(s) stored parts this sweep cannot interpret (${\n [...opaqueTypes].join(', ') || 'unnamed'\n }) — supply \\`decodeParts\\` to make them readable`,\n ]\n : []),\n 'this is NOT a dead tool surface finding; it is the absence of evidence either way',\n ],\n data: {\n toolReadableTurns,\n noPartsTurns,\n opaquePartsTurns,\n turnsSeen: turns.length,\n opaqueTypes: [...opaqueTypes],\n },\n at: now,\n })\n }\n\n // ── the detector reporting on ITSELF ───────────────────────────────────\n //\n // The one verdict this module must never give is \"healthy\" derived from rows\n // it could not read. If most of the window was opaque, that fact is the\n // alert — silence here would be the module committing the exact failure it\n // was built to catch.\n if (opaquePartsTurns > 0 && opaquePartsTurns >= turns.length * blindThreshold) {\n alerts.push({\n product: options.product,\n severity: 'warning',\n key: `sweep:${options.product}:detector_blind`,\n title: `${options.product}: ${opaquePartsTurns} of ${turns.length} turns have unreadable parts — this sweep cannot certify them`,\n details: [\n `uninterpretable part types: ${[...opaqueTypes].join(', ') || '(none named)'}`,\n 'these rows are excluded from every verdict above; treat them as UNMEASURED, not healthy',\n ],\n data: {\n opaquePartsTurns,\n unreadableTurns,\n turnsSeen: turns.length,\n opaqueTypes: [...opaqueTypes],\n },\n at: now,\n })\n }\n\n for (const alert of alerts) await options.sink.deliver(alert)\n\n return {\n product: options.product,\n unansweredThreads: unanswered.length,\n pendingUserMessages,\n oldestUnansweredMs,\n silentThreads: silent.length,\n pagedSilentThreads: paged.size,\n notifiedThreads: notified.length,\n turnsJudged: turns.length,\n unhealthyTurns,\n emptyCompletions,\n malformedToolCalls,\n toolCallsWithoutEffect,\n rejectedToolCalls,\n turnsWithToolCalls,\n toolCalls,\n unreadableTurns,\n opaquePartsTurns,\n noPartsTurns,\n toolReadableTurns,\n alerts,\n }\n}\n\n// ── D1 source for the shared chat-store schema ────────────────────────────\n\n/** Minimal structural D1 contract (Cloudflare's `D1Database` satisfies it). */\nexport interface D1LikeForHealth {\n prepare(sql: string): {\n bind(...values: unknown[]): {\n all<T = Record<string, unknown>>(): Promise<{ results: T[] }>\n }\n }\n}\n\n/**\n * The sweep source for products on the canonical `/chat-store` tables.\n *\n * \"Answered\" deliberately means an assistant row with NON-EMPTY content. A\n * blank assistant row is what a broken turn writes, so counting it as an\n * answer would let the exact failure being hunted mark itself resolved. That\n * single predicate is the difference between this catching the gtm outage and\n * sleeping through it — during those sixteen days the table was NOT empty.\n *\n * The query deliberately does NOT join the thread table. Products do not all\n * keep one: tax-agent's `thread` table holds zero rows because it groups by\n * its own `tax_sessions`, and an inner join against it silently reported \"0\n * unanswered threads, healthy\" while 18 real messages sat unanswered. A\n * detector that reports healthy because its join found nothing is the same\n * bug class it was built to catch.\n */\nexport function createD1TurnHealthSource(\n db: D1LikeForHealth,\n options: {\n messageTable?: string\n threadTable?: string\n /**\n * Content prefixes that mark an assistant row as an ERROR SURFACE rather\n * than an answer. A row matching one of these stops counting as a reply,\n * so the thread keeps reporting as unanswered.\n *\n * This exists because the obvious rule — \"an assistant row with non-empty\n * content is an answer\" — is wrong in the exact case that matters. On\n * 2026-07-27 gtm-agent's newest assistant row read:\n *\n * \"The sandbox model stream stopped before a clean completion.\n * Error: All 2 model(s) failed. gpt-5-mini: TANGLE_HUB_URL is required …\"\n *\n * 246 characters of well-formed prose that answers nothing. Counting it\n * marks a dead product healthy — the same failure-returning-success shape\n * this module exists to catch, recursing into the detector itself.\n *\n * There is no schema-level way to recognise it: `output_tokens IS NULL`\n * looked promising until legal-agent showed 22 of 25 GENUINE replies with\n * null usage — it would have reported a working product broken.\n *\n * Defaults to {@link SHELL_ERROR_REPLY_PREFIXES}, the openers agent-app\n * ITSELF writes in `createSandboxChatProducer`. Those are not domain —\n * this package composed them, so this package is what must recognise\n * them, and every product on the shared producer is correct with no\n * configuration. Pass your own list to ADD product-specific error prose;\n * pass `[]` to disable the rule.\n *\n * Prefixes are bound as query parameters, never interpolated.\n */\n errorReplyPrefixes?: readonly string[]\n /**\n * Read each row's whole `parts` instead of the fields the classifier reads.\n * Only a product whose `decodeParts` needs the stored bytes (an encrypted\n * parts envelope) sets this; the default reads a small projection.\n */\n fullParts?: boolean\n } = {},\n): TurnHealthSource {\n // Table names are identifiers and cannot be bound as parameters. They come\n // from deploy-time product config, never from a request, and are validated\n // here so this can never become an injection point.\n const message = safeIdentifier(options.messageTable ?? 'message')\n const thread = safeIdentifier(options.threadTable ?? 'thread')\n // D1 rejects a LIKE pattern longer than 50 characters with\n // `SQLITE_ERROR: LIKE or GLOB pattern too complex`, and the pattern is the\n // prefix PLUS the trailing `%`. Measured against production D1 on\n // 2026-07-27: a 49-char prefix (50-char pattern) succeeds, 50 fails.\n //\n // Both shipped defaults are longer than that (55 and 70 characters), so\n // before this clamp `findUnansweredThreads` threw on every product database\n // — the detector could not run at all against the only store the fleet uses.\n //\n // Truncating is safe in the one direction that matters: a shorter prefix\n // matches MORE rows as non-answers, so a thread is reported unanswered\n // rather than silently marked healthy. The first 49 characters of each\n // default are still unambiguous.\n const errorPrefixes = [...(options.errorReplyPrefixes ?? SHELL_ERROR_REPLY_PREFIXES)].map((p) =>\n p.slice(0, D1_MAX_LIKE_PATTERN_LENGTH - 1),\n )\n\n return {\n async findUnansweredThreads({ minAgeMs, maxAgeMs, now }) {\n const cutoffSeconds = Math.floor((now - minAgeMs) / 1000)\n const floorSeconds = Math.floor((now - maxAgeMs) / 1000)\n // Each prefix becomes one bound `NOT LIKE ?||'%'` term. Parameters, not\n // interpolation — a product-supplied string never reaches the SQL text.\n const errorClause = errorPrefixes\n .map((_, i) => ` AND a.content NOT LIKE ?${i + 3} || '%'`)\n .join('')\n // A row after the newest pending message that showed something (error\n // prose, or a notice part) means the person saw the failure. A blank row\n // with no notice showed nothing, so its thread stays silent.\n const { results } = await db\n .prepare(\n `WITH pending AS (\n SELECT m.thread_id AS threadId,\n COUNT(*) AS pendingMessages,\n MIN(m.created_at) AS oldestCreatedAt,\n MAX(m.created_at) AS newestCreatedAt\n FROM ${message} m\n WHERE m.role = 'user'\n AND m.created_at <= ?1\n AND m.created_at >= ?2\n AND m.created_at > COALESCE(\n (SELECT MAX(a.created_at)\n FROM ${message} a\n WHERE a.thread_id = m.thread_id\n AND a.role = 'assistant'\n AND length(trim(a.content)) > 0${errorClause}), 0)\n GROUP BY m.thread_id\n )\n SELECT p.threadId, p.pendingMessages, p.oldestCreatedAt,\n EXISTS (\n SELECT 1 FROM ${message} a\n WHERE a.thread_id = p.threadId AND a.role = 'assistant' AND a.created_at >= p.newestCreatedAt\n AND (length(trim(coalesce(a.content, ''))) > 0 OR EXISTS (\n SELECT 1 FROM json_each(CASE WHEN json_valid(a.parts) THEN CASE WHEN json_type(a.parts) = 'array' THEN a.parts ELSE '[]' END ELSE '[]' END) n\n WHERE CASE WHEN n.type = 'object' THEN json_extract(n.value, '$.type') END = 'notice'))\n ) AS notified\n FROM pending p\n ORDER BY p.oldestCreatedAt ASC`,\n )\n .bind(cutoffSeconds, floorSeconds, ...errorPrefixes)\n .all<{ threadId: string; pendingMessages: number; oldestCreatedAt: number; notified: number }>()\n\n return results.map((row) => ({\n threadId: row.threadId,\n pendingMessages: Number(row.pendingMessages),\n oldestAgeMs: now - Number(row.oldestCreatedAt) * 1000,\n notified: Number(row.notified) === 1,\n }))\n },\n\n async listRecentAssistantTurns({ sinceMs, limit }) {\n const sinceSeconds = Math.floor(sinceMs / 1000)\n const { results } = await db\n .prepare(\n `SELECT id, thread_id AS threadId, content, length(parts) AS partsSize,\n output_tokens AS outputTokens, model, created_at AS createdAt\n FROM ${message}\n WHERE role = 'assistant' AND created_at >= ?1\n ORDER BY created_at DESC\n LIMIT ?2`,\n )\n .bind(sinceSeconds, limit)\n .all<Record<string, unknown>>()\n\n return results.map((row) => ({\n id: String(row.id),\n threadId: String(row.threadId),\n content: typeof row.content === 'string' ? row.content : '',\n parts: undefined,\n partsSize: row.partsSize === null ? null : Number(row.partsSize),\n outputTokens: row.outputTokens === null ? null : Number(row.outputTokens),\n model: (row.model as string | null) ?? null,\n createdAt: Number(row.createdAt) * 1000,\n }))\n },\n\n async readParts(ids) {\n if (ids.length === 0) return new Map()\n const placeholders = ids.map((_, i) => `?${i + 1}`).join(', ')\n if (options.fullParts) {\n const { results } = await db\n .prepare(`SELECT id, parts FROM ${message} WHERE id IN (${placeholders})`)\n .bind(...ids)\n .all<{ id: string; parts: unknown }>()\n return new Map(results.map((row) => [String(row.id), row.parts]))\n }\n // One row per part with only what classifyTurnOutcome reads, so a day of\n // tool output never leaves the database: the full read\n // returned 141.9 MB per run for 500 turns.\n const { results } = await db\n .prepare(`SELECT m.id AS id, CAST(p.key AS INTEGER) AS idx, ${PART_PROJECTION}\n FROM ${message} m, json_each(CASE WHEN json_valid(m.parts) THEN CASE WHEN json_type(m.parts) = 'array' THEN m.parts ELSE '[]' END ELSE '[]' END) p\n WHERE m.id IN (${placeholders})\n ORDER BY m.id, idx`)\n .bind(...ids)\n .all<ProjectedPart & { id: string }>()\n const parts = new Map<string, unknown[]>(ids.map((id) => [id, []]))\n for (const row of results) parts.get(String(row.id))?.push(slimPart(row))\n return parts\n },\n }\n\n function safeIdentifier(name: string): string {\n if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {\n throw new Error(`unsafe table identifier: ${name}`)\n }\n return name\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqEA,SAAS,UAAU,OAAwB;AACzC,MAAI,iBAAiB,MAAO,QAAO,MAAM;AACzC,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,SAAO,OAAO,KAAK;AACrB;AAYO,SAAS,0BACd,SACqB;AAErB,QAAM,OAAO,uBAAuB,QAAQ,IAAI;AAEhD,SAAO;AAAA,IACL,MAAM,eAAe,MAAM;AACzB,YAAM,UAAU,oBAAoB;AAAA,QAClC,WAAW,KAAK;AAAA,QAChB,cAAc,KAAK,OAAO,gBAAgB;AAAA,QAC1C,YAAY,KAAK;AAAA,QACjB,GAAI,KAAK,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AAAA,MACtC,CAAC;AACD,cAAQ,YAAY;AAAA,QAClB,SAAS,QAAQ;AAAA,QACjB,SAAS,QAAQ;AAAA,QACjB,OAAO,QAAQ,QAAQ,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,QACxC,YAAY,KAAK;AAAA,MACnB,CAAC;AACD,UAAI,QAAQ,WAAW,QAAQ,aAAa,KAAM;AAElD,UAAI,CAAC,QAAQ,oBAAoB,QAAQ,QAAQ,MAAM,CAAC,MAAM,EAAE,SAAS,wBAAwB,GAAG;AAClG;AAAA,MACF;AACA,YAAM,KAAK;AAAA,QACT,UAAU;AAAA,UACR,SAAS,QAAQ;AAAA,UACjB,UAAU,QAAQ;AAAA,UAClB,SAAS,QAAQ;AAAA,UACjB,GAAI,KAAK,WAAW,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;AAAA,UACnD,GAAI,KAAK,cAAc,EAAE,QAAQ,KAAK,YAAY,IAAI,CAAC;AAAA,QACzD,CAAC;AAAA,MACH;AAAA,IACF;AAAA,IAEA,MAAM,YAAY,MAAM;AACtB,YAAM,UAAU,oBAAoB;AAAA,QAClC,QAAQ;AAAA,QACR,eAAe,UAAU,KAAK,KAAK;AAAA,QACnC,YAAY,KAAK;AAAA,MACnB,CAAC;AACD,cAAQ,YAAY;AAAA,QAClB,SAAS,QAAQ;AAAA,QACjB,SAAS;AAAA,QACT,OAAO,QAAQ,QAAQ,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,QACxC,YAAY,KAAK;AAAA,MACnB,CAAC;AACD,YAAM,KAAK;AAAA,QACT,UAAU;AAAA,UACR,SAAS,QAAQ;AAAA,UACjB,UAAU;AAAA,UACV,SAAS,QAAQ;AAAA,UACjB,GAAI,KAAK,WAAW,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;AAAA,UACnD,GAAI,KAAK,cAAc,EAAE,QAAQ,KAAK,YAAY,IAAI,CAAC;AAAA,QACzD,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACF;;;AC3DA,IAAM,WAAW,CAAC,SAAiB,oCAAoC,IAAI;AAE3E,IAAM,SAAS,CAAC,MAAc,OAAO,0BAA0B,IAAI,SAAS,SAAS,iCAAiC,IAAI,oBAAoB,IAAI,MAAM;AACxJ,IAAM,kBAAkB;AAAA,EACtB;AAAA,EACA,GAAG,OAAO,QAAQ,CAAC;AAAA,EACnB,YAAY,SAAS,8IAA8I,CAAC;AAAA,EACpK,GAAG,OAAO,QAAQ,CAAC;AAAA,EACnB,GAAG,SAAS,+BAA+B,CAAC;AAAA,EAC5C,GAAG,OAAO,gBAAgB,CAAC;AAAA,EAC3B,GAAG,OAAO,iBAAiB,wDAAwD,CAAC;AAAA,EACpF,GAAG,SAAS,qCAAqC,CAAC;AAAA,EAClD,GAAG,OAAO,uBAAuB,8DAA8D,CAAC;AAAA,EAChG,GAAG,OAAO,oBAAoB,CAAC;AAAA,EAC/B,GAAG,OAAO,iBAAiB,oDAAoD,CAAC;AAAA,EAChF,GAAG,OAAO,iBAAiB,wDAAwD,CAAC;AACtF,EAAE,KAAK,OAAO;AAkBd,SAAS,SAAS,KAA6B;AAE7C,MAAI,IAAI,aAAa,QAAS,QAAO,CAAC;AACtC,MAAI,IAAI,aAAa,SAAU,QAAO;AACtC,QAAM,OAAgC,CAAC;AACvC,MAAI,IAAI,SAAS,KAAM,MAAK,OAAO,IAAI;AACvC,MAAI,IAAI,QAAS,MAAK,OAAO;AAC7B,MAAI,IAAI,SAAS,KAAM,MAAK,OAAO,IAAI;AACvC,MAAI,IAAI,cAAc,UAAU;AAC9B,UAAM,QAAiC,CAAC;AACxC,QAAI,IAAI,WAAW,KAAM,OAAM,SAAS,IAAI;AAC5C,QAAI,IAAI,eAAe,KAAM,OAAM,QAAQ,IAAI;AAC/C,QAAI,IAAI,cAAc,UAAU;AAC9B,YAAM,QAAiC,CAAC;AACxC,UAAI,IAAI,eAAe,KAAM,OAAM,QAAQ,IAAI;AAC/C,UAAI,IAAI,cAAc,KAAM,OAAM,OAAO,IAAI;AAC7C,YAAM,QAAQ;AAAA,IAChB,WAAW,IAAI,cAAc,QAAQ;AAGnC,YAAM,QAAQ,IAAI,aAAa,OAAO,GAAG,IAAI,eAAe,EAAE;AAAA,IAChE,WAAW,IAAI,cAAc,MAAM;AACjC,YAAM,QAAQ;AAAA,IAChB;AACA,SAAK,QAAQ;AAAA,EACf;AACA,SAAO;AACT;AAGO,IAAM,+BAA+B;AAG5C,SAAS,aAAa,MAAyD;AAC7E,SAAO,aAAa,KAAK,IAAI,CAAC,SAAS,EAAE,KAAK,KAAK,MAAM,IAAI,UAAU,EAAE,GAAG,EAAE,OAAO,6BAA6B,CAAC;AACrH;AAGA,gBAAgB,UAAU,MAAmC,QAA4D;AACvH,aAAW,SAAS,aAAa,IAAI,GAAG;AACtC,UAAM,SAAS,MAAM,OAAO,CAAC,QAAQ,IAAI,UAAU,WAAc,IAAI,aAAa,KAAK,CAAC,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;AAE7G,UAAM,OAAO,OAAO,SAAS,KAAK,OAAO,YAAY,MAAM,OAAO,UAAU,MAAM,IAAI;AACtF,eAAW,OAAO,MAAO,OAAM,MAAM,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,KAAK,IAAI,IAAI,EAAE,EAAE,IAAI;AAAA,EAC3F;AACF;AAuFA,IAAM,2BAA2B,CAAC,YAAgC,QAAQ,OAAO,CAAC,WAAW,OAAO,eAAe,KAAK,OAAO;AAK/H,eAAe,eACb,QACA,KACkB;AAClB,MAAI,CAAC,OAAQ,QAAO,IAAI;AACxB,MAAI;AACF,UAAM,UAAU,MAAM,OAAO,IAAI,OAAO,GAAG;AAC3C,WAAO,WAAW,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO,IAAI;AAAA,EACb;AACF;AA+CA,SAAS,WAAW,KAAyB;AAC3C,MAAI,MAAM,QAAQ,GAAG,EAAG,QAAO;AAC/B,MAAI,OAAO,QAAQ,YAAY,IAAI,KAAK,EAAE,WAAW,EAAG,QAAO,CAAC;AAChE,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,WAAO,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC;AAAA,EAC3C,QAAQ;AAGN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,IAAM,UAAU;AAiBT,IAAM,6BAA6B;AAEnC,IAAM,6BAAgD;AAAA,EAC3D;AAAA,EACA;AAAA,EACA;AACF;AASA,eAAsB,oBAAoB,SAA6C;AACrF,QAAM,MAAM,QAAQ,OAAO,KAAK,IAAI;AACpC,QAAM,WAAW,QAAQ,YAAY,KAAK;AAC1C,QAAM,WAAW,QAAQ,YAAY,IAAI,KAAK;AAC9C,QAAM,aAAa,QAAQ,cAAc,KAAK;AAC9C,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,qBAAqB,QAAQ,sBAAsB;AACzD,QAAM,kBAAkB,QAAQ,mBAAmB;AACnD,QAAM,yBAAyB,QAAQ,0BAA0B;AAIjE,QAAM,iBAAiB;AAEvB,QAAM,CAAC,YAAY,KAAK,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC5C,QAAQ,OAAO,sBAAsB,EAAE,UAAU,UAAU,IAAI,CAAC;AAAA,IAChE,QAAQ,OAAO,yBAAyB,EAAE,SAAS,MAAM,YAAY,KAAK,MAAM,CAAC;AAAA,EACnF,CAAC;AAED,QAAM,SAA4B,CAAC;AAGnC,QAAM,sBAAsB,WAAW,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,iBAAiB,CAAC;AACpF,QAAM,qBAAqB,WAAW,OAAO,CAAC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,WAAW,GAAG,CAAC;AACxF,QAAM,SAAS,WAAW,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ;AACnD,QAAM,WAAW,WAAW,OAAO,CAAC,MAAM,EAAE,QAAQ;AACpD,QAAM,QAAQ,IAAI;AAAA,KACf,OAAO,QAAQ,qBAAqB,0BAA0B,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ;AAAA,EAC/F;AACA,QAAM,iBAAiB,CAAC,MACtB,UAAU,EAAE,QAAQ,KAAK,EAAE,eAAe,qBAAqB,EAAE,cAAc,SAAS,QAAQ,CAAC,CAAC;AAEpG,MAAI,OAAO,SAAS,GAAG;AACrB,UAAM,iBAAiB,OAAO,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,iBAAiB,CAAC;AAC3E,UAAM,SAAS,OAAO,OAAO,CAAC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,WAAW,GAAG,CAAC;AACxE,WAAO,KAAK;AAAA,MACV,SAAS,QAAQ;AAAA,MACjB,UAAU,MAAM,OAAO,IAAI,aAAa;AAAA,MACxC,KAAK,SAAS,QAAQ,OAAO;AAAA,MAC7B,OAAO,GAAG,QAAQ,OAAO,KAAK,cAAc,sCAAsC,OAAO,MAAM;AAAA,MAC/F,SAAS;AAAA,QACP,+BAA+B,SAAS,SAAS,QAAQ,CAAC,CAAC,MAAM,MAAM,IAAI;AAAA;AAAA,QAE3E,GAAG,CAAC,GAAG,OAAO,OAAO,CAAC,MAAM,MAAM,IAAI,EAAE,QAAQ,CAAC,GAAG,GAAG,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,QAAQ,CAAC,CAAC,EAChG,MAAM,GAAG,CAAC,EACV,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,QAAQ,IAAI,aAAa,EAAE,EAAE;AAAA,MAChF;AAAA,MACA,MAAM,EAAE,eAAe,OAAO,QAAQ,oBAAoB,MAAM,MAAM,qBAAqB,gBAAgB,oBAAoB,OAAO;AAAA,MACtI,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AACA,MAAI,SAAS,SAAS,KAAK,CAAC,QAAQ,0BAA0B;AAC5D,UAAM,mBAAmB,SAAS,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,iBAAiB,CAAC;AAC/E,WAAO,KAAK;AAAA,MACV,SAAS,QAAQ;AAAA,MACjB,UAAU;AAAA,MACV,KAAK,SAAS,QAAQ,OAAO;AAAA,MAC7B,OAAO,GAAG,QAAQ,OAAO,KAAK,gBAAgB,2BAA2B,SAAS,MAAM;AAAA,MACxF,SAAS,SAAS,MAAM,GAAG,CAAC,EAAE,IAAI,cAAc;AAAA,MAChD,MAAM,EAAE,iBAAiB,SAAS,QAAQ,qBAAqB,iBAAiB;AAAA,MAChF,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAGA,MAAI,mBAAmB;AACvB,MAAI,qBAAqB;AACzB,MAAI,yBAAyB;AAC7B,MAAI,oBAAoB;AACxB,MAAI,iBAAiB;AACrB,MAAI,qBAAqB;AACzB,MAAI,YAAY;AAChB,MAAI,kBAAkB;AAItB,MAAI,oBAAoB;AACxB,MAAI,mBAAmB;AAIvB,MAAI,eAAe;AACnB,QAAM,cAAc,oBAAI,IAAY;AACpC,QAAM,mBAAuC,CAAC;AAC9C,QAAM,kBAAsC,CAAC;AAE7C,mBAAiB,OAAO,UAAU,OAAO,QAAQ,MAAM,GAAG;AACxD,UAAM,UAAU,oBAAoB;AAAA,MAClC,WAAW,IAAI;AAAA,MACf,OAAO,WAAW,MAAM,eAAe,QAAQ,aAAa,GAAG,CAAC;AAAA,MAChE,cAAc,IAAI,gBAAgB;AAAA,IACpC,CAAC;AACD,iBAAa,QAAQ;AACrB,QAAI,QAAQ,YAAY,EAAG,uBAAsB;AAIjD,QAAI,QAAQ,iBAAiB,QAAQ,mBAAmB,EAAG,sBAAqB;AAAA,aACvE,QAAQ,cAAe,iBAAgB;AAAA,SAC3C;AACH,0BAAoB;AACpB,iBAAW,KAAK,QAAQ,gBAAiB,aAAY,IAAI,CAAC;AAAA,IAC5D;AACA,QAAI,QAAQ,YAAY;AACtB,yBAAmB;AACnB;AAAA,IACF;AACA,QAAI,QAAQ,QAAS;AACrB,sBAAkB;AAClB,eAAW,UAAU,QAAQ,SAAS;AACpC,UAAI,OAAO,SAAS,mBAAoB,qBAAoB;AAC5D,UAAI,OAAO,SAAS,uBAAuB;AACzC,8BAAsB;AACtB,YAAI,iBAAiB,SAAS,EAAG,kBAAiB,KAAK,MAAM;AAAA,MAC/D;AACA,UAAI,OAAO,SAAS,sBAAuB,2BAA0B;AACrE,UAAI,OAAO,SAAS,sBAAsB;AACxC,6BAAqB;AACrB,YAAI,gBAAgB,SAAS,EAAG,iBAAgB,KAAK,MAAM;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAIA,QAAM,gBAAgB,MAAM,SAAS;AAIrC,MAAI,qBAAqB,GAAG;AAC1B,WAAO,KAAK;AAAA,MACV,SAAS,QAAQ;AAAA,MACjB,UAAU;AAAA,MACV,KAAK,SAAS,QAAQ,OAAO;AAAA,MAC7B,OAAO,GAAG,QAAQ,OAAO,KAAK,kBAAkB;AAAA,MAChD,SAAS,iBAAiB,IAAI,cAAc;AAAA,MAC5C,MAAM,EAAE,oBAAoB,aAAa,MAAM,OAAO;AAAA,MACtD,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAIA,MAAI,oBAAoB,GAAG;AACzB,WAAO,KAAK;AAAA,MACV,SAAS,QAAQ;AAAA,MACjB,UAAU;AAAA,MACV,KAAK,SAAS,QAAQ,OAAO;AAAA,MAC7B,OAAO,GAAG,QAAQ,OAAO,KAAK,iBAAiB;AAAA,MAC/C,SAAS,gBAAgB,IAAI,cAAc;AAAA,MAC3C,MAAM,EAAE,mBAAmB,aAAa,cAAc;AAAA,MACtD,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAEA,MAAI,iBAAiB,iBAAiB;AACpC,UAAM,OAAO,mBAAmB;AAChC,QAAI,OAAO,oBAAoB;AAC7B,aAAO,KAAK;AAAA,QACV,SAAS,QAAQ;AAAA,QACjB,UAAU;AAAA,QACV,KAAK,SAAS,QAAQ,OAAO;AAAA,QAC7B,OAAO,GAAG,QAAQ,OAAO,MAAM,OAAO,KAAK,QAAQ,CAAC,CAAC;AAAA,QACrD,SAAS;AAAA,UACP,GAAG,gBAAgB,OAAO,aAAa;AAAA,UACvC,cAAc,qBAAqB,KAAK,QAAQ,CAAC,CAAC;AAAA,QACpD;AAAA,QACA,MAAM,EAAE,kBAAkB,aAAa,eAAe,KAAK;AAAA,QAC3D,IAAI;AAAA,MACN,CAAC;AAAA,IACH;AAAA,EACF;AAUA,MAAI,QAAQ,oBAAoB,qBAAqB,0BAA0B,cAAc,GAAG;AAC9F,WAAO,KAAK;AAAA,MACV,SAAS,QAAQ;AAAA,MACjB,UAAU;AAAA,MACV,KAAK,SAAS,QAAQ,OAAO;AAAA,MAC7B,OAAO,GAAG,QAAQ,OAAO,4BAA4B,iBAAiB;AAAA,MACtE,SAAS;AAAA,QACP,GAAG,iBAAiB;AAAA,QACpB;AAAA,QACA,GAAI,mBAAmB,IACnB,CAAC,GAAG,gBAAgB,2DAA2D,IAC/E,CAAC;AAAA,QACL,GAAI,eAAe,IACf,CAAC,GAAG,YAAY,gEAAgE,IAChF,CAAC;AAAA,MACP;AAAA,MACA,MAAM;AAAA,QACJ,aAAa;AAAA,QACb,WAAW;AAAA,QACX,oBAAoB;AAAA,QACpB,gBAAgB,mBAAmB;AAAA,QACnC;AAAA,QACA;AAAA,MACF;AAAA,MACA,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAOA,MACE,QAAQ,oBACR,oBAAoB,0BACpB,mBAAmB,eAAe,GAClC;AACA,WAAO,KAAK;AAAA,MACV,SAAS,QAAQ;AAAA,MACjB,UAAU;AAAA,MACV,KAAK,SAAS,QAAQ,OAAO;AAAA,MAC7B,OAAO,GAAG,QAAQ,OAAO,qDAAgD,iBAAiB,OAAO,MAAM,MAAM;AAAA,MAC7G,SAAS;AAAA,QACP,GAAI,eAAe,IACf,CAAC,GAAG,YAAY,4EAAuE,IACvF,CAAC;AAAA,QACL,GAAI,mBAAmB,IACnB;AAAA,UACE,GAAG,gBAAgB,sDACjB,CAAC,GAAG,WAAW,EAAE,KAAK,IAAI,KAAK,SACjC;AAAA,QACF,IACA,CAAC;AAAA,QACL;AAAA,MACF;AAAA,MACA,MAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,aAAa,CAAC,GAAG,WAAW;AAAA,MAC9B;AAAA,MACA,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAQA,MAAI,mBAAmB,KAAK,oBAAoB,MAAM,SAAS,gBAAgB;AAC7E,WAAO,KAAK;AAAA,MACV,SAAS,QAAQ;AAAA,MACjB,UAAU;AAAA,MACV,KAAK,SAAS,QAAQ,OAAO;AAAA,MAC7B,OAAO,GAAG,QAAQ,OAAO,KAAK,gBAAgB,OAAO,MAAM,MAAM;AAAA,MACjE,SAAS;AAAA,QACP,+BAA+B,CAAC,GAAG,WAAW,EAAE,KAAK,IAAI,KAAK,cAAc;AAAA,QAC5E;AAAA,MACF;AAAA,MACA,MAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,aAAa,CAAC,GAAG,WAAW;AAAA,MAC9B;AAAA,MACA,IAAI;AAAA,IACN,CAAC;AAAA,EACH;AAEA,aAAW,SAAS,OAAQ,OAAM,QAAQ,KAAK,QAAQ,KAAK;AAE5D,SAAO;AAAA,IACL,SAAS,QAAQ;AAAA,IACjB,mBAAmB,WAAW;AAAA,IAC9B;AAAA,IACA;AAAA,IACA,eAAe,OAAO;AAAA,IACtB,oBAAoB,MAAM;AAAA,IAC1B,iBAAiB,SAAS;AAAA,IAC1B,aAAa,MAAM;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AA6BO,SAAS,yBACd,IACA,UAuCI,CAAC,GACa;AAIlB,QAAM,UAAU,eAAe,QAAQ,gBAAgB,SAAS;AAChE,QAAM,SAAS,eAAe,QAAQ,eAAe,QAAQ;AAc7D,QAAM,gBAAgB,CAAC,GAAI,QAAQ,sBAAsB,0BAA2B,EAAE;AAAA,IAAI,CAAC,MACzF,EAAE,MAAM,GAAG,6BAA6B,CAAC;AAAA,EAC3C;AAEA,SAAO;AAAA,IACL,MAAM,sBAAsB,EAAE,UAAU,UAAU,IAAI,GAAG;AACvD,YAAM,gBAAgB,KAAK,OAAO,MAAM,YAAY,GAAI;AACxD,YAAM,eAAe,KAAK,OAAO,MAAM,YAAY,GAAI;AAGvD,YAAM,cAAc,cACjB,IAAI,CAAC,GAAG,MAAM,4BAA4B,IAAI,CAAC,SAAS,EACxD,KAAK,EAAE;AAIV,YAAM,EAAE,QAAQ,IAAI,MAAM,GACvB;AAAA,QACC;AAAA;AAAA;AAAA;AAAA;AAAA,sBAKY,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gCAMG,OAAO;AAAA;AAAA;AAAA,2DAGoB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA,oCAKlC,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQnC,EACC,KAAK,eAAe,cAAc,GAAG,aAAa,EAClD,IAA8F;AAEjG,aAAO,QAAQ,IAAI,CAAC,SAAS;AAAA,QAC3B,UAAU,IAAI;AAAA,QACd,iBAAiB,OAAO,IAAI,eAAe;AAAA,QAC3C,aAAa,MAAM,OAAO,IAAI,eAAe,IAAI;AAAA,QACjD,UAAU,OAAO,IAAI,QAAQ,MAAM;AAAA,MACrC,EAAE;AAAA,IACJ;AAAA,IAEA,MAAM,yBAAyB,EAAE,SAAS,MAAM,GAAG;AACjD,YAAM,eAAe,KAAK,MAAM,UAAU,GAAI;AAC9C,YAAM,EAAE,QAAQ,IAAI,MAAM,GACvB;AAAA,QACC;AAAA;AAAA,oBAEU,OAAO;AAAA;AAAA;AAAA;AAAA,MAInB,EACC,KAAK,cAAc,KAAK,EACxB,IAA6B;AAEhC,aAAO,QAAQ,IAAI,CAAC,SAAS;AAAA,QAC3B,IAAI,OAAO,IAAI,EAAE;AAAA,QACjB,UAAU,OAAO,IAAI,QAAQ;AAAA,QAC7B,SAAS,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU;AAAA,QACzD,OAAO;AAAA,QACP,WAAW,IAAI,cAAc,OAAO,OAAO,OAAO,IAAI,SAAS;AAAA,QAC/D,cAAc,IAAI,iBAAiB,OAAO,OAAO,OAAO,IAAI,YAAY;AAAA,QACxE,OAAQ,IAAI,SAA2B;AAAA,QACvC,WAAW,OAAO,IAAI,SAAS,IAAI;AAAA,MACrC,EAAE;AAAA,IACJ;AAAA,IAEA,MAAM,UAAU,KAAK;AACnB,UAAI,IAAI,WAAW,EAAG,QAAO,oBAAI,IAAI;AACrC,YAAM,eAAe,IAAI,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI;AAC7D,UAAI,QAAQ,WAAW;AACrB,cAAM,EAAE,SAAAA,SAAQ,IAAI,MAAM,GACvB,QAAQ,yBAAyB,OAAO,iBAAiB,YAAY,GAAG,EACxE,KAAK,GAAG,GAAG,EACX,IAAoC;AACvC,eAAO,IAAI,IAAIA,SAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AAAA,MAClE;AAIA,YAAM,EAAE,QAAQ,IAAI,MAAM,GACvB,QAAQ,qDAAqD,eAAe;AAAA,oBACjE,OAAO;AAAA,6BACE,YAAY;AAAA,+BACV,EACtB,KAAK,GAAG,GAAG,EACX,IAAoC;AACvC,YAAM,QAAQ,IAAI,IAAuB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClE,iBAAW,OAAO,QAAS,OAAM,IAAI,OAAO,IAAI,EAAE,CAAC,GAAG,KAAK,SAAS,GAAG,CAAC;AACxE,aAAO;AAAA,IACT;AAAA,EACF;AAEA,WAAS,eAAe,MAAsB;AAC5C,QAAI,CAAC,2BAA2B,KAAK,IAAI,GAAG;AAC1C,YAAM,IAAI,MAAM,4BAA4B,IAAI,EAAE;AAAA,IACpD;AACA,WAAO;AAAA,EACT;AACF;","names":["results"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tangle-network/agent-app",
3
- "version": "4.0.2",
3
+ "version": "4.0.3",
4
4
  "packageManager": "pnpm@11.28.8",
5
5
  "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
6
6
  "keywords": [
@@ -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 /** The harness's own reported token cost, kept when the ledger charged nothing (a failed turn). */\n harnessCostUsd?: 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/conformance/session.ts","../src/conformance/revision.ts","../src/conformance/turns.ts","../src/conformance/run.ts"],"sourcesContent":["/**\n * Sign-in for the conformance runner: the two ways a member reaches an agent app, and one question both answer,\n * \"does the app accept this session?\". Nothing here is specific to an app; a product whose sign-in differs\n * fails the check with the status it answered.\n */\n\nexport type SignInMode = 'password' | 'sso'\n\n/** A check failed for a reason worth reporting; its message is the cause. */\nexport class Failure extends Error {}\n\nexport interface MemberSession {\n origin: string\n /** A request to the app as the signed-in member; `path` is root-relative. */\n fetch(path: string, init?: RequestInit): Promise<Response>\n}\n\nconst REQUEST_MS = 30_000\n\n/** Cookies by origin: enough of a jar for one sign-in and the calls after it. */\nclass Jar {\n private readonly byOrigin = new Map<string, Map<string, string>>()\n\n header(url: string): string {\n return [...(this.byOrigin.get(new URL(url).origin) ?? [])].map(([name, value]) => `${name}=${value}`).join('; ')\n }\n\n async send(url: string, init: RequestInit = {}): Promise<Response> {\n const headers = new Headers(init.headers)\n const cookie = this.header(url)\n if (cookie) headers.set('cookie', cookie)\n const response = await fetch(url, { ...init, headers, redirect: 'manual', signal: init.signal ?? AbortSignal.timeout(REQUEST_MS) })\n this.absorb(url, response)\n return response\n }\n\n private absorb(url: string, response: Response): void {\n const origin = new URL(url).origin\n const jar = this.byOrigin.get(origin) ?? new Map<string, string>()\n for (const line of response.headers.getSetCookie()) {\n const [pair = '', ...attributes] = line.split(';')\n const eq = pair.indexOf('=')\n if (eq < 1) continue\n const name = pair.slice(0, eq).trim()\n const value = pair.slice(eq + 1).trim()\n const attribute = (key: string) => attributes.map(item => item.trim()).find(item => item.toLowerCase().startsWith(`${key}=`))?.slice(key.length + 1)\n const maxAge = attribute('max-age')\n const expires = attribute('expires')\n const gone = !value || (maxAge !== undefined && Number(maxAge) <= 0)\n || (maxAge === undefined && expires !== undefined && Date.parse(expires) <= Date.now())\n if (gone) jar.delete(name)\n else jar.set(name, value)\n }\n this.byOrigin.set(origin, jar)\n }\n}\n\nconst snippet = async (response: Response) => (await response.text().catch(() => '')).replace(/\\s+/g, ' ').slice(0, 160)\n\n/** A sign-in POST. An auth service that answers 429 is asked again after its Retry-After (at most 20 s), twice at most. */\nasync function postSignIn(jar: Jar, origin: string, email: string, password: string): Promise<Response> {\n for (let attempt = 0; ; attempt += 1) {\n const response = await jar.send(`${origin}/api/auth/sign-in/email`, {\n method: 'POST', headers: { 'content-type': 'application/json', origin }, body: JSON.stringify({ email, password }),\n })\n if (response.status !== 429 || attempt === 2) return response\n const wait = Number(response.headers.get('retry-after'))\n await response.body?.cancel().catch(() => {})\n await new Promise(resolve => setTimeout(resolve, Math.min(20, Number.isFinite(wait) && wait > 0 ? wait : 5) * 1000))\n }\n}\n\nasync function passwordSignIn(jar: Jar, origin: string, email: string, password: string): Promise<void> {\n const response = await postSignIn(jar, origin, email, password)\n if (response.status !== 200) throw new Failure(`password sign-in answered ${response.status}: ${await snippet(response)}`)\n}\n\nconst TANGLE_AUTH_PATH = /(^|\\/)auth\\/tangle\\//\n\n/**\n * The app's \"Log in with Tangle\": its start route sends the browser to Platform, Platform signs the member in and\n * authorizes, and the app's callback sets its own session. Apps mount the start route at `/auth/tangle/start` or\n * under `/api`.\n */\nasync function ssoSignIn(jar: Jar, origin: string, email: string, password: string): Promise<void> {\n const answers: string[] = []\n let location: string | null = null\n for (const path of ['/auth/tangle/start', '/api/auth/tangle/start']) {\n const start = await jar.send(`${origin}${path}`)\n location = start.headers.get('location')\n if (location) break\n answers.push(`${path} answered ${start.status}`)\n }\n if (!location) throw new Failure(`SSO start sent the member nowhere (${answers.join('; ')})`)\n const authorize = new URL(location, origin)\n const platform = authorize.origin\n const member = await postSignIn(jar, platform, email, password)\n if (member.status !== 200) throw new Failure(`Platform sign-in answered ${member.status}: ${await snippet(member)}`)\n let next = authorize.href\n for (let hop = 0; hop < 8; hop += 1) {\n const response = await jar.send(next)\n const redirect = response.headers.get('location')\n if (!redirect) throw new Failure(`SSO stopped at ${new URL(next).pathname} with ${response.status}`)\n const url = new URL(redirect, next)\n if (url.origin === origin && !TANGLE_AUTH_PATH.test(url.pathname)) {\n if (url.pathname.startsWith('/login') || url.searchParams.has('error') || url.searchParams.get('connection') === 'failed') {\n throw new Failure(`the app's SSO callback sent the member to ${url.pathname}${url.search.slice(0, 80)}`)\n }\n return\n }\n next = url.href\n }\n throw new Failure('SSO did not return to the app within 8 redirects')\n}\n\n/** A redirect to sign-in or an error page is an app that did not accept the session. */\nasync function sessionAccepted(session: MemberSession): Promise<string> {\n const who = await session.fetch('/api/auth/get-session')\n if (who.status === 200) {\n const body = await who.json().catch(() => null) as { user?: { id?: unknown } } | null\n if (typeof body?.user?.id === 'string' && body.user.id) return 'GET /api/auth/get-session returned the user'\n }\n const workspaces = await session.fetch('/api/workspaces')\n if (workspaces.status === 200) return 'GET /api/workspaces answered 200 as the member'\n throw new Failure(`signed in, but the app does not accept the session: GET /api/auth/get-session answered ${who.status}, GET /api/workspaces ${workspaces.status}`)\n}\n\n/** Signs in and proves the app accepts the session; the detail names the proof. */\nexport async function signIn(input: { origin: string; mode: SignInMode; email: string; password: string }): Promise<{ session: MemberSession; detail: string }> {\n const jar = new Jar()\n if (input.mode === 'password') await passwordSignIn(jar, input.origin, input.email, input.password)\n else await ssoSignIn(jar, input.origin, input.email, input.password)\n const session: MemberSession = {\n origin: input.origin,\n fetch: (path, init = {}) => {\n const headers = new Headers(init.headers)\n if (!headers.has('origin')) headers.set('origin', input.origin)\n return jar.send(`${input.origin}${path}`, { ...init, headers })\n },\n }\n return { session, detail: `${input.mode}: ${await sessionAccepted(session)}` }\n}\n","/**\n * The served revision, read the way an operator reads it: from the app's own `GET /api/health` body, or from the\n * `x-<app>-revision` / `x-<app>-version` header the app puts on its responses. An app that serves neither cannot\n * say what it is running, so a release cannot be told from the one before it.\n */\n\nimport { Failure } from './session.js'\n\nconst REVISION_HEADER = /^x-[a-z0-9-]+-(revision|version)$/i\nconst REQUEST_MS = 20_000\n\nconst text = (value: unknown): string | null => typeof value === 'string' && value.trim() ? value.trim() : null\n\n/** The revision a health body carries: `revision`, or what `release` carries. */\nfunction fromHealth(body: unknown): string | null {\n if (!body || typeof body !== 'object') return null\n const record = body as Record<string, unknown>\n const release = record.release && typeof record.release === 'object' ? record.release as Record<string, unknown> : {}\n return text(record.revision) ?? text(release.revision) ?? text(release.sha) ?? text(release.tag)\n}\n\nfunction fromHeaders(response: Response): { name: string; value: string } | null {\n for (const [name, value] of response.headers) if (REVISION_HEADER.test(name) && value.trim()) return { name, value: value.trim() }\n return null\n}\n\n/**\n * Reads the revision, or throws a Failure naming every place it looked. `source` says where it was read, e.g.\n * `GET /api/health` or `GET / x-creative-revision`.\n */\nexport async function readRevision(origin: string, expect?: string): Promise<{ revision: string; source: string }> {\n const looked: string[] = []\n const found = await (async (): Promise<{ revision: string; source: string } | null> => {\n for (const path of ['/api/health', '/']) {\n let response: Response\n try {\n response = await fetch(`${origin}${path}`, { headers: { accept: 'application/json' }, redirect: 'manual', signal: AbortSignal.timeout(REQUEST_MS) })\n } catch (error) {\n looked.push(`GET ${path} failed (${error instanceof Error ? error.name : 'error'})`)\n continue\n }\n const header = fromHeaders(response)\n if (path === '/api/health' && response.ok) {\n const revision = fromHealth(await response.json().catch(() => null))\n if (revision) return { revision, source: 'GET /api/health' }\n }\n if (header) return { revision: header.value, source: `GET ${path} ${header.name}` }\n await response.body?.cancel().catch(() => {})\n looked.push(`GET ${path} answered ${response.status} without a revision`)\n }\n return null\n })()\n if (!found) throw new Failure(`the app serves no readable revision (${looked.join('; ')})`)\n if (expect) {\n const [a, b] = [found.revision.toLowerCase(), expect.trim().toLowerCase()]\n if (b.length < 7 || !(a.startsWith(b) || b.startsWith(a))) {\n throw new Failure(`the app serves revision ${found.revision} (${found.source}), not the expected ${expect}`)\n }\n }\n return found\n}\n","/**\n * The conformance turns, run through the operator API every agent app mounts the same way\n * (docs/operator-api.md), so one runner drives every product. The verdict is the settled turn the app stored.\n *\n * plain a reply with text;\n * computer a turn only the workspace computer can answer: either the digest of a fresh nonce, which the model\n * cannot know without running the command, or a file the computer saves that the app then serves back.\n */\n\nimport { createHash, randomBytes, randomUUID } from 'node:crypto'\nimport { createOperatorClient, type OperatorClient } from '../operator/client.js'\nimport type { OperatorTurn, OperatorWorkspace } from '../operator/contract.js'\nimport { Failure, type MemberSession } from './session.js'\n\nexport type ComputerProof = 'digest' | 'file'\n\nconst REQUEST_MS = 30_000\nconst KEY_LIFETIME_MS = 60 * 60_000\n\nexport interface OperatorAccess {\n client: OperatorClient\n workspace: OperatorWorkspace\n /** The app's own account of what the key may do. */\n scopes: readonly string[]\n}\n\n/** An expiring key for the signed-in member, through the route every app's API access page uses. */\nexport async function mintKey(session: MemberSession): Promise<{ id: string; key: string }> {\n const response = await session.fetch('/api/keys', {\n method: 'POST', headers: { 'content-type': 'application/json' }, signal: AbortSignal.timeout(REQUEST_MS),\n body: JSON.stringify({\n name: `conformance ${new Date().toISOString()}`, scopes: ['operator:read', 'operator:run'],\n expiresAt: new Date(Date.now() + KEY_LIFETIME_MS).toISOString(), workspaceIds: [],\n }),\n })\n if (response.status === 404) {\n throw new Failure('the app has no key route (POST /api/keys answered 404), so a conformance turn has no credential; give it an operator key')\n }\n const body = await response.json().catch(() => null) as { id?: unknown; key?: unknown; error?: unknown } | null\n if (!response.ok || typeof body?.id !== 'string' || typeof body.key !== 'string') {\n throw new Failure(`POST /api/keys answered ${response.status}: ${typeof body?.error === 'string' ? body.error.slice(0, 160) : 'no key in the response'}`)\n }\n return { id: body.id, key: body.key }\n}\n\n/** Revokes a key this run created. Apps accept the id in the path, or in the body of the collection route. */\nexport async function revokeKey(session: MemberSession, id: string): Promise<void> {\n const byPath = await session.fetch(`/api/keys/${encodeURIComponent(id)}`, { method: 'DELETE', signal: AbortSignal.timeout(REQUEST_MS) })\n if (byPath.ok) return\n const byBody = await session.fetch('/api/keys', {\n method: 'DELETE', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ id }), signal: AbortSignal.timeout(REQUEST_MS),\n })\n if (byBody.ok) return\n throw new Failure(`the minted key ${id} was not revoked: DELETE /api/keys/:id answered ${byPath.status}, DELETE /api/keys ${byBody.status} (it expires within the hour)`)\n}\n\n/**\n * Opens the operator API with `key` and picks the workspace the turns run in: `workspace` is its id or exact name,\n * and omitted, the key must reach exactly one. `requestMs` bounds any one request, a held turn read included.\n */\nexport async function openOperatorAccess(\n { origin, key, workspace, requestMs }: { origin: string; key: string; workspace: string | undefined; requestMs: number },\n): Promise<OperatorAccess> {\n const client = createOperatorClient({\n origin,\n getApiKey: () => key,\n fetchImpl: (url, init) => fetch(url, { ...init, signal: init?.signal ? AbortSignal.any([init.signal, AbortSignal.timeout(requestMs)]) : AbortSignal.timeout(requestMs) }),\n })\n const described = await client.describe()\n if (!described.succeeded) throw new Failure(`GET /api/operator/v1 answered ${described.status} ${described.code}: ${described.error.slice(0, 160)}`)\n const scopes = described.value.principal.scopes\n const missing = ['operator:read', 'operator:run'].filter(scope => !scopes.includes(scope) && !scopes.includes('*'))\n if (missing.length) throw new Failure(`the operator key lacks ${missing.join(' and ')}`)\n const listed = await client.listWorkspaces()\n if (!listed.succeeded) throw new Failure(`GET /api/operator/v1/workspaces answered ${listed.status} ${listed.code}: ${listed.error.slice(0, 160)}`)\n const chosen = workspace\n ? listed.value.filter(candidate => candidate.id === workspace || candidate.name === workspace)\n : listed.value.length === 1 ? listed.value : []\n if (chosen.length !== 1) {\n const names = listed.value.slice(0, 12).map(candidate => `${candidate.name} (${candidate.id.slice(0, 8)})`).join(', ')\n throw new Failure(workspace\n ? `${chosen.length} of the key's ${listed.value.length} workspaces match \"${workspace}\": ${names}`\n : `the key reaches ${listed.value.length} workspaces; name the canary workspace: ${names}`)\n }\n return { client, workspace: chosen[0]!, scopes }\n}\n\nconst reply = (turn: OperatorTurn) => (turn.reply?.content ?? '').trim()\n\n/** One turn on a new thread, followed until it settles. */\nasync function runTurn(access: OperatorAccess, title: string, content: string, turnMs: number, model?: string): Promise<{ turn: OperatorTurn; where: string }> {\n const turnId = randomUUID()\n const started = await access.client.startTurn(access.workspace.id, { turnId, content, title, ...(model ? { model } : {}) })\n if (!started.succeeded) throw new Failure(`the turn was refused: ${started.status} ${started.code}: ${started.error.slice(0, 200)}`)\n const where = `thread ${started.value.threadId}`\n const settled = await access.client.waitForTurn(access.workspace.id, started.value.threadId, started.value.turnId, { timeoutMs: turnMs })\n if (!settled.succeeded) throw new Failure(`reading the turn answered ${settled.status} ${settled.code}: ${settled.error.slice(0, 160)} (${where})`)\n const turn = settled.value\n if (turn.state === 'failed') throw new Failure(`the turn failed${turn.failure?.code ? ` (${turn.failure.code})` : ''}: ${(turn.failure?.message ?? 'no message').slice(0, 300)} (${where})`)\n if (turn.state === 'input-required' || turn.approvals.length > 0) throw new Failure(`the turn is waiting on a decision, which no one can answer in a conformance run (${where})`)\n if (turn.state !== 'succeeded') throw new Failure(`the turn had not settled after ${Math.round(turnMs / 1000)} s (state ${turn.state}; ${where})`)\n return { turn, where }\n}\n\nexport async function plainTurn(access: OperatorAccess, turnMs: number): Promise<string> {\n const { turn, where } = await runTurn(access, 'Conformance: plain turn',\n 'Conformance check: reply with one short sentence confirming you can answer.', turnMs)\n if (!reply(turn)) throw new Failure(`the turn succeeded with an empty reply (${where})`)\n return `${reply(turn).length} characters from ${turn.model ?? 'an unreported model'} (${where})`\n}\n\nexport async function computerTurn(access: OperatorAccess, turnMs: number, proof: ComputerProof, fileDir: string, model: string): Promise<string> {\n const nonce = `conformance-${randomBytes(12).toString('hex')}`\n if (proof === 'digest') {\n const digest = createHash('sha256').update(nonce).digest('hex')\n const { turn, where } = await runTurn(access, 'Conformance: computer turn',\n 'Conformance check: run this exact shell command on the workspace computer (sandbox_run when you have it), then reply with only '\n + `the 64-character hex digest it prints:\\nprintf %s '${nonce}' | sha256sum`, turnMs, model)\n if (!reply(turn).includes(digest)) {\n throw new Failure(`the reply does not hold the digest of the fresh nonce, so the computer did not run the command: \"${reply(turn).slice(0, 160)}\" (${where})`)\n }\n return `the reply carries the digest ${digest.slice(0, 12)}… (${where})`\n }\n const path = `${fileDir.replace(/\\/+$/, '')}/${nonce}.md`\n const { where } = await runTurn(access, 'Conformance: computer turn',\n `Conformance check: use the workspace computer to save a file at ${path} whose whole content is this one line, then reply with the word saved:\\n${nonce}`, turnMs, model)\n const read = await access.client.readFile(access.workspace.id, path)\n if (!read.succeeded) throw new Failure(`the turn succeeded, but the app does not serve ${path}: ${read.status} ${read.code} (${where})`)\n if (read.value.content.trim() !== nonce) {\n throw new Failure(`${path} holds ${JSON.stringify(read.value.content.slice(0, 80))}, not the nonce (${where})`)\n }\n return `the app serves ${path} with the nonce (${where})`\n}\n","import { readRevision } from './revision.js'\nimport { Failure, signIn, type MemberSession, type SignInMode } from './session.js'\nimport { computerTurn, mintKey, openOperatorAccess, plainTurn, revokeKey, type ComputerProof, type OperatorAccess } from './turns.js'\n\nexport type CheckName = 'sign-in' | 'revision' | 'operator-access' | 'plain-turn' | 'computer-turn' | 'key-revoke'\n\n/**\n * One check's verdict. `blocked` means an earlier check it depends on failed, so nothing was measured; a blocked\n * check fails the run like a failed one, and its cause names the check that blocked it.\n */\nexport interface CheckResult {\n /** When the check started, ISO 8601. */\n at: string\n app: string\n url: string\n check: CheckName\n status: 'pass' | 'fail' | 'blocked'\n ms: number\n /** Why a failed or blocked check is not a pass. */\n cause?: string\n /** What a passing check observed: the revision read, the thread a turn ran in. */\n detail?: string\n}\n\nexport interface ConformanceOptions {\n /** A label for the result lines, e.g. `gtm`. */\n app: string\n /** The deployed origin, e.g. `https://gtm.tangle.tools`. */\n origin: string\n /** The member that signs in. Required: sign-in is the first thing a customer does. */\n member?: { mode: SignInMode; email: string; password: string }\n /** A key that already has `operator:read` and `operator:run`; without one, the signed-in member mints a one-hour key. */\n operatorKey?: string\n /** Id or exact name of the workspace the turns run in: the app's canary or smoke workspace, never a customer's. */\n workspace?: string\n /** `digest` hashes a fresh nonce on the workspace computer; `file` has the computer save a file the app serves back;\n * `none` runs the plain turn only, for a check that asks exactly once (a post-serve first ask). */\n computer?: ComputerProof | 'none'\n /** The computer turn's model. The plain turn keeps the app's own model, so the served model is still checked once. */\n computerModel?: string\n /** Where the `file` proof is saved, relative to the workspace root. */\n fileDir?: string\n /** The budget of each turn, a cold box included. */\n turnMs?: number\n /** Fail unless the served revision starts with, or is a prefix of, this. */\n expectRevision?: string\n /** Called with each result as it lands. */\n onResult?(result: CheckResult): void\n}\n\nconst DEFAULT_TURN_MS = 300_000\n// Company spend rule: checks run on the flat-rate plan; per-token models are for product serving with real users.\nconst DEFAULT_COMPUTER_MODEL = 'glm-5.3'\n\n/** Why an unexpected error is not a pass, in a line. */\nfunction describe(error: unknown): string {\n if (error instanceof Failure) return error.message\n if (error instanceof Error) {\n const cause = error.cause as { code?: unknown } | undefined\n return `${error.name}: ${error.message}${typeof cause?.code === 'string' ? ` (${cause.code})` : ''}`\n }\n return String(error)\n}\n\n/** Runs the checks against one deployed app and returns every result, in the order they ran. */\nexport async function checkDeployedApp(options: ConformanceOptions): Promise<CheckResult[]> {\n const origin = options.origin.replace(/\\/+$/, '')\n const turnMs = options.turnMs ?? DEFAULT_TURN_MS\n const secrets = [options.member?.password, options.operatorKey].filter((value): value is string => Boolean(value && value.length >= 6))\n const redact = (text: string) => secrets.reduce((out, secret) => out.split(secret).join('[redacted]'), text)\n const results: CheckResult[] = []\n\n const record = (result: CheckResult) => {\n const clean = { ...result, ...(result.cause ? { cause: redact(result.cause) } : {}), ...(result.detail ? { detail: redact(result.detail) } : {}) }\n results.push(clean)\n options.onResult?.(clean)\n }\n /** Runs `body`; whatever it returns is the passing detail, whatever it throws is the cause. */\n async function check<T>(name: CheckName, body: () => Promise<{ value: T; detail?: string }>): Promise<T | undefined> {\n const at = new Date().toISOString()\n const started = Date.now()\n const base = { at, app: options.app, url: origin, check: name }\n try {\n const { value, detail } = await body()\n record({ ...base, status: 'pass', ms: Date.now() - started, ...(detail ? { detail } : {}) })\n return value\n } catch (error) {\n record({ ...base, status: 'fail', ms: Date.now() - started, cause: describe(error) })\n return undefined\n }\n }\n const blocked = (name: CheckName, because: string) =>\n record({ at: new Date().toISOString(), app: options.app, url: origin, check: name, status: 'blocked', ms: 0, cause: because })\n\n let session: MemberSession | undefined\n if (!options.member) {\n const at = new Date().toISOString()\n record({ at, app: options.app, url: origin, check: 'sign-in', status: 'fail', ms: 0, cause: 'no member is configured: give the canary member email and password' })\n } else {\n const member = options.member\n session = await check('sign-in', async () => {\n const signedIn = await signIn({ origin, ...member })\n return { value: signedIn.session, detail: signedIn.detail }\n })\n }\n\n await check('revision', async () => {\n const served = await readRevision(origin, options.expectRevision)\n return { value: served, detail: `${served.revision} (${served.source})` }\n })\n\n let minted: { id: string } | null = null\n let access: OperatorAccess | undefined\n if (!options.operatorKey && !session) {\n blocked('operator-access', 'blocked by sign-in: no operator key is configured, and the member did not sign in to mint one')\n } else {\n access = await check('operator-access', async () => {\n let secret = options.operatorKey\n if (!secret) {\n const created = await mintKey(session!)\n secrets.push(created.key)\n secret = created.key\n minted = { id: created.id }\n }\n const opened = await openOperatorAccess({ origin, key: secret, workspace: options.workspace, requestMs: turnMs + 60_000 })\n return {\n value: opened,\n detail: `${minted ? 'a minted one-hour key' : 'the configured operator key'} reaches \"${opened.workspace.name}\" with ${opened.scopes.join(', ')}`,\n }\n })\n }\n\n if (access) {\n const open = access\n await check('plain-turn', async () => ({ value: true, detail: await plainTurn(open, turnMs) }))\n const proof = options.computer ?? 'digest'\n if (proof !== 'none') {\n await check('computer-turn', async () => ({\n value: true, detail: await computerTurn(open, turnMs, proof, options.fileDir ?? 'proof', options.computerModel ?? DEFAULT_COMPUTER_MODEL),\n }))\n }\n } else {\n blocked('plain-turn', 'blocked by operator-access')\n if (options.computer !== 'none') blocked('computer-turn', 'blocked by operator-access')\n }\n\n // A key this run minted is revoked whether or not the turns ran: it names the member and would outlive the run.\n const mintedKey = minted as { id: string } | null\n if (mintedKey && session) {\n const member = session\n await check('key-revoke', async () => {\n await revokeKey(member, mintedKey.id)\n return { value: true, detail: 'the minted key was revoked' }\n })\n }\n return results\n}\n"],"mappings":"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","names":["REQUEST_MS","REQUEST_MS","where","text"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/turn-health/classify.ts","../src/turn-health/sink.ts"],"sourcesContent":["/**\n * The classifier for turns that FAIL BY RETURNING SUCCESS.\n *\n * Every failure this module names shipped to a customer with HTTP 200, no\n * thrown error, and no log line anyone read. Three were measured in production\n * in a single week:\n *\n * - a turn settled `{\"outcome\":{\"type\":\"completed\"},\"finalText\":\"\",\n * \"tokenUsage\":{\"outputTokens\":0}}` — the customer saw a blank bubble;\n * - six `submit_proposal` tool calls collapsed into ONE whose arguments were\n * a 1,652-character non-JSON string, so zero proposals persisted and\n * nothing errored (agent-runtime #626);\n * - a thread took 255 user messages over 17 days and produced 2 replies,\n * both of them error text.\n *\n * A conventional health check cannot see any of these, because it probes\n * DEPENDENCIES (is the sandbox reachable, is the router up) and every one of\n * these failures happens with all dependencies green. This classifier probes\n * the OUTCOME instead.\n *\n * It is deliberately pure and structural: it reads a settled turn's own\n * projection, so the SAME function judges a live turn through the\n * `/chat-routes` lifecycle seam and a historical row read back out of the\n * store during a sweep. One definition of \"silently broken\", two call sites.\n */\n\n/** How loudly a reason should be routed. `critical` means a customer got\n * nothing usable; `warning` means the turn degraded but still produced\n * something a human could read. */\nexport type TurnHealthSeverity = 'critical' | 'warning'\n\n/** One specific way a turn returned success while failing.\n *\n * Each variant carries the evidence that identified it, so an alert can name\n * the offending value instead of asserting a verdict the reader has to take\n * on faith. */\nexport type TurnHealthReason =\n /** Settled without error and produced nothing a user can read: no text, and\n * no artifact part (file/image/work-product/plan/interaction). This is the\n * verbatim blank-completion capture. */\n | {\n kind: 'empty_completion'\n outputTokens: number | null\n partCount: number\n durationMs?: number\n }\n /** A tool call whose arguments never parsed. The engine surfaces unparseable\n * arguments as a RAW STRING rather than throwing, so the call is neither\n * dropped nor errored — it silently does nothing. Detecting a string-typed\n * tool input that fails `JSON.parse` is the exact fingerprint of the\n * index-less parallel-tool-call collapse. */\n | {\n kind: 'malformed_tool_call'\n tool: string\n inputLength: number\n /** Leading characters of the offending input, for the alert body. */\n sample: string\n }\n /** A tool call that never reached a terminal state carrying output. The call\n * was issued and then simply produced no effect. */\n | {\n kind: 'tool_call_no_effect'\n tool: string\n status: string\n }\n /** The turn failed outright. Not silent by itself — but it becomes silent\n * the moment nothing is watching, which is how 16 days of\n * `TANGLE_HUB_URL is required` reached customers unnoticed. */\n | { kind: 'turn_failed'; reason: string }\n /** A tool call the harness REJECTED, settled as `completed`.\n *\n * Found live in legal-agent production, and missed by every other rule here:\n * the model called `submit_proposal`, the harness answered \"Model tried to\n * call unavailable tool 'submit_proposal'\", and the part persisted as\n * `{\"tool\":\"invalid\",\"state\":{\"status\":\"completed\",\"input\":{\"error\":\"…\"}}}`.\n *\n * Status is `completed`, the arguments parse cleanly, and the turn has text —\n * so the blank-completion, malformed-argument and no-effect rules all pass it.\n * Six deliverables were requested and silently discarded while the product\n * reported success six times.\n *\n * Detected structurally, on the presence of an `error` in the settled state\n * rather than on any harness's name for a rejected call — `invalid` is one\n * harness's convention and must not be baked into the shell. */\n | {\n kind: 'tool_call_rejected'\n /** The tool the model was trying to reach, when the payload names it. */\n tool: string\n error: string\n }\n /** The turn was answered without the model ever running — a pre-producer gate\n * short-circuited and returned the product's own response.\n *\n * Reported as a `warning`, never `critical`: gating an unready turn is a\n * legitimate design (an intake flow SHOULD answer before spending a model\n * call). What is pathological is the RATE, which only the caller's own\n * threshold can judge — so this variant exists to be COUNTED, and alerting\n * on it is opt-in. It is the per-turn evidence behind a dead tool surface:\n * a gate that answers every turn means the agent never runs at all. */\n | { kind: 'answered_without_model' }\n /** The detector could not read this turn.\n *\n * Every part carried a type outside the vocabulary this classifier\n * understands — which is what field-level encryption at rest looks like from\n * the outside (tax-agent persists `{\"type\":\"__encrypted_parts__\"}`, its own\n * convention, and 32 of its 129 assistant rows are exactly that).\n *\n * This exists because the alternative is the bug this whole module hunts.\n * An unreadable row has no text, no artifact and no tool part, so every\n * other rule here would happily conclude \"nothing wrong\" — a detector\n * reporting health from data it cannot see. Blindness is a finding, not a\n * pass, so it gets its own reason and its own counter. */\n | { kind: 'unreadable_turn'; partTypes: string[] }\n\n/** A settled turn, in the narrowest shape both call sites can supply.\n *\n * Structural on purpose: the lifecycle seam supplies `finalText`/`usage`, a\n * store sweep supplies `content`/`parts` read back from a row, and neither\n * has to import the other's types. */\nexport interface TurnOutcomeInput {\n /** The turn's final assistant text. */\n finalText?: string | null\n /** The persisted assistant parts. Untyped by design — a sweep reads these\n * out of a JSON column and must not be forced to validate them first. */\n parts?: readonly unknown[] | null\n /** Output tokens, when the caller has usage. `null`/absent is unknown, which\n * is NOT the same as zero and is never treated as evidence. */\n outputTokens?: number | null\n /** Set when the turn surfaced a terminal error event. */\n failed?: boolean\n failureReason?: string | null\n durationMs?: number\n /** Set when a pre-producer gate answered this turn and the model never ran.\n * Supplied by `/chat-routes`' lifecycle seam, which stamps `gated` on the\n * completion it now fires for a `contextGate` short-circuit. */\n gated?: boolean\n}\n\n/** The verdict for one turn. `healthy` is exactly `reasons.length === 0`, kept\n * as a field so callers read intent rather than an array length. */\nexport interface TurnHealthVerdict {\n healthy: boolean\n severity: TurnHealthSeverity | null\n reasons: TurnHealthReason[]\n /** How many tool parts this turn carried.\n *\n * Zero is NOT a per-turn defect — plenty of good turns answer from context\n * without touching a tool, and paging on each one would be pure noise. It is\n * reported so a WINDOW can be judged: a product whose deliverable is tool\n * output and which produced zero tool calls across every turn in the\n * lookback has a dead tool surface, and that is the shape no per-turn rule\n * can see.\n *\n * Only meaningful alongside {@link interpretedParts} > 0. Zero tool calls\n * read off a row that persisted NO parts is not an observation about the\n * tool surface — it is the absence of one. */\n toolCalls: number\n /** True when nothing about this turn could be judged — no interpretable part\n * AND no visible text. Callers MUST exclude these from any healthy/unhealthy\n * ratio, because counting an unreadable turn as healthy is how a detector\n * reports green on data it never read. */\n unreadable: boolean\n /** False when this turn carried parts that could not be interpreted.\n *\n * Separate from {@link unreadable} because the two blindnesses have\n * different consequences, and production has a row that is one but not the\n * other: tax-agent persists CIPHERTEXT as `content` alongside an encrypted\n * `parts` blob, so the turn plainly delivered something (there is text) while\n * its tool calls are completely invisible.\n *\n * Any conclusion ABOUT TOOLS — above all the dead-tool-surface verdict — may\n * only be drawn over turns where this is true. Reading \"no tool parts\" off an\n * encrypted blob and declaring the tool surface dead would be the same\n * crime as declaring it healthy: a finding asserted from data never read. */\n partsReadable: boolean\n /** The part types that could not be interpreted. Empty when\n * {@link partsReadable}. Named in the alert so a reader can see EXACTLY what\n * the detector was blind to instead of taking \"unreadable\" on faith. */\n opaquePartTypes: string[]\n /** How many parts this module actually READ (text, artifact, tool, or a known\n * non-output kind).\n *\n * The third blindness, and the one that shipped a false page. `partsReadable`\n * only says nothing was *uninterpretable*; a row that persisted NO parts at\n * all satisfies that vacuously. Production: 97 of tax-agent's 156 assistant\n * rows predate parts persistence entirely and store `[]`, and reading \"zero\n * tool calls\" off them raised a critical `dead_tool_surface` against a\n * product whose own `turn_events` table holds 243 `tool_call` frames.\n *\n * So a tool verdict requires BOTH `partsReadable` AND this being > 0 —\n * evidence that was read, not merely evidence that failed to be unreadable. */\n interpretedParts: number\n}\n\n/** Part kinds that count as something a user actually receives.\n *\n * A tool part is deliberately NOT here. A turn that ran six tools and said\n * nothing, with no artifact to show for it, is the malformed-tool-call\n * disaster — counting a tool chip as output would suppress the very alert\n * this module exists to raise. */\nconst ARTIFACT_PART_KINDS = new Set(['file', 'image', 'work-product', 'plan', 'interaction'])\n\n/** Part types that carry no user-visible output but ARE understood.\n *\n * The distinction matters: a turn made of nothing but `reasoning` parts\n * thought hard and said nothing, which is a real empty completion. A turn made\n * of types this module has never heard of is a turn it cannot read. Only the\n * second is blindness — so these are enumerated rather than lumped in with the\n * unknown.\n *\n * Grounded in what the fleet actually persists, not guessed: a scan of every\n * assistant part in the gtm / legal / tax production tables returns exactly\n * `tool` (138), `text` (69), `reasoning` (26), `step-start` (3),\n * `step-finish` (3) and tax's opaque `__encrypted_parts__` (32). */\nconst KNOWN_NON_OUTPUT_PART_KINDS = new Set([\n 'reasoning',\n 'step-start',\n 'step-finish',\n 'source',\n 'source-url',\n 'data',\n])\n\nconst SAMPLE_CHARS = 120\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n return typeof value === 'object' && value !== null ? (value as Record<string, unknown>) : null\n}\n\nfunction nonEmptyString(value: unknown): string | null {\n return typeof value === 'string' && value.trim().length > 0 ? value : null\n}\n\n/** True when a string is not parseable JSON.\n *\n * Only meaningful for tool INPUT, where the engine's contract is that a\n * well-formed call carries an object (or a string that parses into one). A\n * string that fails to parse means the arguments were concatenated or\n * truncated upstream. */\nfunction isUnparseableJson(value: string): boolean {\n const trimmed = value.trim()\n if (trimmed.length === 0) return false\n try {\n JSON.parse(trimmed)\n return false\n } catch {\n return true\n }\n}\n\n/** Tool statuses that mean the call actually landed.\n *\n * Anything else — `pending`, `running`, an unknown string — left no persisted\n * effect by the time the turn settled. */\nconst SETTLED_TOOL_STATUSES = new Set(['completed', 'complete', 'success', 'done'])\n\n/** Tool statuses that ended the call by reporting its failure. The model and\n * the person saw the error, so the call is neither silently rejected nor left\n * without effect: on gtm-agent, 2,527 errored calls (HTTP statuses, missing\n * files, timeouts) in one day's 500 turns were all reported as REJECTED. */\nconst FAILED_TOOL_STATUSES = new Set(['error', 'failed'])\n\n/**\n * Judge one settled turn.\n *\n * Never throws: a malformed `parts` blob is a thing this function REPORTS on,\n * so it must not be a thing it dies on. Telemetry that can crash the turn it\n * measures is worse than no telemetry.\n */\nexport function classifyTurnOutcome(input: TurnOutcomeInput): TurnHealthVerdict {\n const reasons: TurnHealthReason[] = []\n\n if (input.failed) {\n reasons.push({\n kind: 'turn_failed',\n reason: nonEmptyString(input.failureReason) ?? 'unspecified',\n })\n }\n\n const parts = Array.isArray(input.parts) ? input.parts : []\n\n let hasVisibleText = nonEmptyString(input.finalText) !== null\n let artifactCount = 0\n let toolCalls = 0\n // Part types this module could not interpret. Tracked so blindness can be\n // reported as blindness instead of silently reading as health.\n const opaqueTypes: string[] = []\n let interpretedParts = 0\n\n for (const raw of parts) {\n const part = asRecord(raw)\n if (!part) continue\n const type = typeof part.type === 'string' ? part.type : ''\n\n if (type === 'text') {\n interpretedParts += 1\n if (nonEmptyString(part.text) !== null) hasVisibleText = true\n continue\n }\n if (ARTIFACT_PART_KINDS.has(type)) {\n interpretedParts += 1\n artifactCount += 1\n continue\n }\n if (KNOWN_NON_OUTPUT_PART_KINDS.has(type)) {\n interpretedParts += 1\n continue\n }\n if (type !== 'tool') {\n opaqueTypes.push(type || '(missing type)')\n continue\n }\n interpretedParts += 1\n toolCalls += 1\n\n const tool = nonEmptyString(part.tool) ?? 'unknown'\n const state = asRecord(part.state)\n const status = typeof state?.status === 'string' ? state.status : 'unknown'\n\n // The #626 fingerprint: arguments surfaced as a raw string because they\n // failed to parse upstream. Checked before the status gate — a malformed\n // call can still be marked completed, which is precisely why it is silent.\n // A rejected call settles as `completed` and carries its rejection in the\n // state. Checked BEFORE the status gate for the same reason as the\n // malformed case: the status is exactly what makes it silent.\n const toolInput = state?.input\n const inputRecord = asRecord(toolInput)\n const rejection =\n nonEmptyString(inputRecord?.error) ?? nonEmptyString((state as Record<string, unknown>)?.error)\n if (rejection && SETTLED_TOOL_STATUSES.has(status)) {\n reasons.push({\n kind: 'tool_call_rejected',\n // The payload names the tool the model MEANT to call; the part's own\n // `tool` is the harness's placeholder for a rejected call.\n tool: nonEmptyString(inputRecord?.tool) ?? tool,\n error: rejection.slice(0, 200),\n })\n continue\n }\n if (typeof toolInput === 'string' && isUnparseableJson(toolInput)) {\n reasons.push({\n kind: 'malformed_tool_call',\n tool,\n inputLength: toolInput.length,\n sample: toolInput.slice(0, SAMPLE_CHARS),\n })\n continue\n }\n\n if (!SETTLED_TOOL_STATUSES.has(status) && !FAILED_TOOL_STATUSES.has(status)) {\n reasons.push({ kind: 'tool_call_no_effect', tool, status })\n }\n }\n\n // A turn whose parts were ALL uninterpretable cannot be judged. Reported as\n // blindness and returned early, because every rule below would otherwise read\n // \"no text, no artifact\" off data that was simply encrypted and call it a\n // blank completion — a false page that would train readers to ignore this\n // module, which is the same ending as no detector at all.\n const partsReadable = opaqueTypes.length === 0\n const uniqueOpaque = [...new Set(opaqueTypes)]\n const unreadable = opaqueTypes.length > 0 && interpretedParts === 0 && !hasVisibleText\n if (unreadable) {\n reasons.push({ kind: 'unreadable_turn', partTypes: uniqueOpaque })\n return {\n healthy: false,\n severity: 'warning',\n reasons,\n toolCalls,\n unreadable: true,\n partsReadable: false,\n opaquePartTypes: uniqueOpaque,\n // Structurally 0 here — `unreadable` is only reached when\n // `interpretedParts === 0`. Carried rather than hardcoded so the field\n // has one source on every return path.\n interpretedParts,\n }\n }\n\n // A gate answered before the producer ran. Recorded rather than judged: see\n // `answered_without_model`. It also SUPPRESSES the empty-completion rule\n // below — the model producing no text is the expected outcome when the model\n // never ran, and firing `empty_completion` here would page on every healthy\n // intake turn.\n if (input.gated) {\n reasons.push({ kind: 'answered_without_model' })\n } else if (!input.failed && !hasVisibleText && artifactCount === 0) {\n // `outputTokens` is corroborating evidence, never the trigger: a turn can\n // spend tokens on reasoning and still deliver nothing, and a turn with\n // unknown usage can still be perfectly fine.\n reasons.push({\n kind: 'empty_completion',\n outputTokens: input.outputTokens ?? null,\n partCount: parts.length,\n ...(input.durationMs !== undefined ? { durationMs: input.durationMs } : {}),\n })\n }\n\n return {\n healthy: reasons.length === 0,\n severity: severityOf(reasons),\n reasons,\n toolCalls,\n unreadable: false,\n partsReadable,\n opaquePartTypes: uniqueOpaque,\n interpretedParts,\n }\n}\n\n/** `critical` when the customer got nothing usable out of the turn. A\n * malformed tool call alongside readable text is a `warning` — degraded, but\n * a human still received an answer. */\nfunction severityOf(reasons: TurnHealthReason[]): TurnHealthSeverity | null {\n if (reasons.length === 0) return null\n // A rejected tool call is critical even alongside readable prose: the\n // customer got words where they should have got a filed deliverable.\n const critical = reasons.some(\n (r) =>\n r.kind === 'empty_completion' ||\n r.kind === 'turn_failed' ||\n r.kind === 'tool_call_rejected',\n )\n return critical ? 'critical' : 'warning'\n}\n\n/** One-line human summary of a reason, for an alert body. */\nexport function describeReason(reason: TurnHealthReason): string {\n switch (reason.kind) {\n case 'empty_completion':\n return `completed with NO output (${reason.partCount} parts, outputTokens=${\n reason.outputTokens ?? 'unknown'\n })`\n case 'malformed_tool_call':\n return `tool \\`${reason.tool}\\` arguments did not parse (${reason.inputLength} chars): ${reason.sample}`\n case 'tool_call_no_effect':\n return `tool \\`${reason.tool}\\` left no effect (status=${reason.status})`\n case 'turn_failed':\n return `turn failed: ${reason.reason}`\n case 'tool_call_rejected':\n return `tool \\`${reason.tool}\\` was REJECTED but settled as completed: ${reason.error}`\n case 'answered_without_model':\n return 'answered by a pre-producer gate — the model never ran'\n case 'unreadable_turn':\n return `turn could not be read: every part had an uninterpretable type (${reason.partTypes.join(\n ', ',\n )})`\n }\n}\n","/**\n * Where a silent-failure verdict GOES.\n *\n * The detection half is worthless without this half. Every failure this module\n * finds was already visible in the database the whole time — 255 unanswered\n * messages sat in a table for 17 days. What was missing was not the data, it\n * was delivery to a human who had not thought to look.\n *\n * So the sink is a seam, not a channel: the product supplies the transport,\n * and agent-app ships the two shapes the fleet already has credentials for\n * (an ops webhook, and stderr). No new channel is invented here.\n */\n\nimport { postSlackAlert } from '../alerting/slack.js'\nimport { describeReason, type TurnHealthReason, type TurnHealthSeverity } from './classify.js'\n\n/** One deliverable alert. */\nexport interface TurnHealthAlert {\n /** Which product raised it (`projectId`). Alerts from four products land in\n * one channel, so this is what makes the message actionable. */\n product: string\n severity: TurnHealthSeverity\n /** Stable grouping key. Throttling is keyed on this, so it must NOT contain\n * a turn id or a timestamp or every alert is unique and nothing dedupes. */\n key: string\n title: string\n /** Human-readable lines. */\n details: string[]\n /** Structured payload for a machine consumer. */\n data?: Record<string, unknown>\n at: number\n}\n\n/** Deliver an alert. Implementations MUST NOT throw — see\n * {@link createGuardedAlertSink}. */\nexport interface AlertSink {\n deliver(alert: TurnHealthAlert): Promise<void>\n}\n\n/** Build the alert for a set of reasons found on one turn. */\nexport function turnAlert(input: {\n product: string\n severity: TurnHealthSeverity\n reasons: TurnHealthReason[]\n threadId?: string\n turnId?: string\n model?: string\n at?: number\n}): TurnHealthAlert {\n const kinds = [...new Set(input.reasons.map((r) => r.kind))].sort()\n return {\n product: input.product,\n severity: input.severity,\n // Keyed by product + reason kinds ONLY. A blank-completion storm across\n // 200 turns is one incident, not 200 pages.\n key: `turn:${input.product}:${kinds.join('+')}`,\n title: `${input.product}: turn completed but delivered nothing (${kinds.join(', ')})`,\n details: input.reasons.map(describeReason),\n data: {\n kinds,\n ...(input.threadId ? { threadId: input.threadId } : {}),\n ...(input.turnId ? { turnId: input.turnId } : {}),\n ...(input.model ? { model: input.model } : {}),\n },\n at: input.at ?? Date.now(),\n }\n}\n\n// ── transports ────────────────────────────────────────────────────────────\n\n/** Minimal structural fetch, so this module has no lib-dom dependency and can\n * be driven by a fake in tests. */\ntype FetchLike = (\n url: string,\n init: { method: string; headers: Record<string, string>; body: string },\n) => Promise<{ ok: boolean; status: number; text?(): Promise<string> }>\n\n/**\n * POST to an incoming webhook in the Slack message format.\n *\n * Chosen because the org already runs one (`SLACK_OPS_WEBHOOK_URL`) and\n * gtm-agent's outbound webhook code already speaks this exact shape — the\n * instruction was to route somewhere humans already look, not to stand up a\n * new channel. Discord and most log drains accept the same `{text}` body.\n */\nexport function createWebhookAlertSink(options: {\n webhookUrl: string\n fetchImpl?: FetchLike\n}): AlertSink {\n const fetchImpl = options.fetchImpl ?? (globalThis.fetch as unknown as FetchLike)\n return {\n async deliver(alert) {\n const text = slackAlertText(alert)\n const response = await fetchImpl(options.webhookUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({ text: text }),\n })\n if (!response.ok) {\n // A dropped alert is a silent failure of the silent-failure detector.\n // It must be loud in the one place that is still working: the log.\n throw new Error(`alert webhook responded ${response.status}`)\n }\n },\n }\n}\n\n/**\n * POST to Slack `chat.postMessage` with a bot token.\n *\n * This is the transport the org actually has. A survey of the four product\n * repos found NO ops alert path of any kind — no incoming webhook, no pager, no\n * notifier — which is the mechanical reason a 17-day outage never reached a\n * human. What does exist is a Slack bot token in the shared secrets store, and\n * `@tangle-network/agent-integrations` already speaks this exact API, so this\n * routes alerts through the channel the org runs rather than standing up a new\n * one.\n *\n * Slack answers `200 OK` with `{\"ok\": false, \"error\": \"...\"}` for an invalid\n * token or channel, so the body is checked and not just the status — a\n * transport that reports success on a rejected post would make the alerter\n * itself a silent failure.\n */\nexport function createSlackBotAlertSink(options: {\n botToken: string\n channel: string\n fetchImpl?: FetchLike\n}): AlertSink {\n const fetchImpl = options.fetchImpl ?? (globalThis.fetch as unknown as FetchLike)\n return {\n async deliver(alert) {\n const text = slackAlertText(alert)\n const outcome = await postSlackAlert({\n token: options.botToken, channel: options.channel, text: text, attempts: 1,\n // Preserve the public minimal-fetch seam without owning a second Slack\n // request builder or response parser. Real callers use native fetch.\n fetchImpl: options.fetchImpl ? (async (url, init) => {\n const response = await fetchImpl(String(url), {\n method: init?.method ?? 'POST',\n headers: Object.fromEntries(new Headers(init?.headers)),\n body: String(init?.body ?? ''),\n })\n return new Response(await response.text?.() ?? '', { status: response.status })\n }) : undefined,\n })\n if (!outcome.delivered) throw new Error(`Slack alert failed (${outcome.reason}): ${outcome.detail}`)\n },\n }\n}\n\n/** stderr sink. The zero-config fallback so a product that has not yet been\n * given a webhook still emits something a log search can find. */\nexport function createConsoleAlertSink(log: (message: string) => void = console.error): AlertSink {\n return {\n async deliver(alert) {\n log(\n `[turn-health] ${alert.severity.toUpperCase()} ${alert.title} :: ${alert.details.join(' | ')}`,\n )\n },\n }\n}\n\n/** Fan out to several sinks. One failing transport must not stop the others. */\nexport function createMultiAlertSink(sinks: readonly AlertSink[]): AlertSink {\n return {\n async deliver(alert) {\n const settled = await Promise.allSettled(sinks.map((s) => s.deliver(alert)))\n const failures = settled.filter((r) => r.status === 'rejected')\n if (failures.length === sinks.length && sinks.length > 0) {\n throw new Error('every alert sink failed')\n }\n },\n }\n}\n\n// ── throttling ────────────────────────────────────────────────────────────\n\n/** Records the last time a key was alerted on. A product backs this with KV,\n * D1, or a Durable Object; the in-memory default is correct for a sweep that\n * runs as a single cron invocation. */\nexport interface AlertThrottleStore {\n lastSentAt(key: string): Promise<number | null>\n markSent(key: string, at: number): Promise<void>\n}\n\n/** Process-local throttle store. */\nexport function createMemoryThrottleStore(): AlertThrottleStore {\n const seen = new Map<string, number>()\n return {\n async lastSentAt(key) {\n return seen.get(key) ?? null\n },\n async markSent(key, at) {\n seen.set(key, at)\n },\n }\n}\n\n/**\n * Collapse repeats of the same `key` inside `windowMs`.\n *\n * Deliberately re-alerts once per window rather than going silent after the\n * first: an incident that is still burning must keep saying so. Going quiet\n * after one message is how a 17-day outage stays invisible after someone\n * dismisses the first notification.\n */\nexport function createThrottledAlertSink(\n inner: AlertSink,\n options: { windowMs: number; store?: AlertThrottleStore },\n): AlertSink {\n const store = options.store ?? createMemoryThrottleStore()\n return {\n async deliver(alert) {\n const last = await store.lastSentAt(alert.key)\n if (last !== null && alert.at - last < options.windowMs) return\n await inner.deliver(alert)\n await store.markSent(alert.key, alert.at)\n },\n }\n}\n\n/**\n * Swallow transport errors so telemetry can never fail the turn it measures.\n *\n * Use this at the LIVE lifecycle call site only. A sweep should let the error\n * surface, because a sweep that cannot deliver has done nothing at all and its\n * cron run should go red.\n */\nexport function createGuardedAlertSink(\n inner: AlertSink,\n onError: (error: unknown) => void = (e) => console.error('[turn-health] alert delivery failed', e),\n): AlertSink {\n return {\n async deliver(alert) {\n try {\n await inner.deliver(alert)\n } catch (error) {\n onError(error)\n }\n },\n }\n}\n\n\nfunction slackAlertText(alert: TurnHealthAlert): string {\n const icon = alert.severity === 'critical' ? ':rotating_light:' : ':warning:'\n return [\n `${icon} *${alert.title}*`,\n ...alert.details.map((detail) => `• ${detail}`),\n `_${new Date(alert.at).toISOString()}_`,\n ].join('\\n')\n}\n"],"mappings":"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","names":[]}