@tangle-network/agent-app 0.60.51 → 0.60.53
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.
- package/dist/chat-routes/index.js +5 -5
- package/dist/chat-routes/index.js.map +1 -1
- package/dist/chat-routes/sandbox-producer.d.ts +7 -2
- package/dist/{chunk-VLAZ2RZX.js → chunk-P2CGXXOJ.js} +3 -3
- package/dist/{chunk-UKZMJND6.js → chunk-Q7WEEN7P.js} +11 -6
- package/dist/chunk-Q7WEEN7P.js.map +1 -0
- package/dist/{chunk-OEHEHPPA.js → chunk-X4OMULP5.js} +54 -9
- package/dist/chunk-X4OMULP5.js.map +1 -0
- package/dist/interactions/index.js +1 -1
- package/dist/public-consultation/index.js +3 -3
- package/dist/stream/index.js +3 -1
- package/dist/stream/turn-buffer.d.ts +22 -18
- package/dist/turn-stream/index.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-OEHEHPPA.js.map +0 -1
- package/dist/chunk-UKZMJND6.js.map +0 -1
- /package/dist/{chunk-VLAZ2RZX.js.map → chunk-P2CGXXOJ.js.map} +0 -0
|
@@ -13,6 +13,7 @@
|
|
|
13
13
|
* `mergePersistedPart` / `finalizeAssistantParts`, plus the usage receipt from
|
|
14
14
|
* `step-finish` parts. `createChatTurnRoutes` reads both after drain.
|
|
15
15
|
*/
|
|
16
|
+
import { type InteractionRequestWire } from '../interactions/contract';
|
|
16
17
|
import { type JsonRecord } from '../stream/index';
|
|
17
18
|
import { type EmptyTurnRetryInfo, type ModelFallbackInfo, type OpenModelStream } from './model-failover-stream';
|
|
18
19
|
import type { ChatTurnRouteProducer } from './turn-routes';
|
|
@@ -111,8 +112,12 @@ export interface SandboxChatProducerOptions {
|
|
|
111
112
|
* auto-declined (see `declineInteraction`) so the run never hangs in the
|
|
112
113
|
* broker waiting on a card no client will show. Default: question/plan.
|
|
113
114
|
* Products with per-turn plan mode can close over it without another option:
|
|
114
|
-
* `(kind) => kind === 'question' || (kind === 'plan' && planEnabled)`.
|
|
115
|
-
|
|
115
|
+
* `(kind) => kind === 'question' || (kind === 'plan' && planEnabled)`.
|
|
116
|
+
* The parsed request lets a product decline an ask by its content, such
|
|
117
|
+
* as a question that duplicates a decision the product already shows. */
|
|
118
|
+
isRenderableInteraction?: (kind: string, request: InteractionRequestWire) => boolean;
|
|
119
|
+
/** The transcript notice for an auto-declined ask; defaults to a policy line naming its kind. */
|
|
120
|
+
declinedNotice?: (request: InteractionRequestWire, declineFailed: boolean) => string;
|
|
116
121
|
/** Resolve a non-renderable ask (wire `respondToSessionInteraction` with the
|
|
117
122
|
* session's sidecar connection). Without it, a failure notice is emitted and
|
|
118
123
|
* the run stays blocked until the broker times out. */
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import {
|
|
2
2
|
createInteractionAnswerRoute
|
|
3
|
-
} from "./chunk-
|
|
3
|
+
} from "./chunk-Q7WEEN7P.js";
|
|
4
4
|
import {
|
|
5
5
|
parseJsonObjectBody
|
|
6
6
|
} from "./chunk-3NCPXNBZ.js";
|
|
@@ -13,7 +13,7 @@ import {
|
|
|
13
13
|
createBufferedTurnTap,
|
|
14
14
|
replayTurnEvents,
|
|
15
15
|
stampReplaySeq
|
|
16
|
-
} from "./chunk-
|
|
16
|
+
} from "./chunk-X4OMULP5.js";
|
|
17
17
|
import {
|
|
18
18
|
mentionInputToPart,
|
|
19
19
|
toChatMessageParts
|
|
@@ -1177,4 +1177,4 @@ export {
|
|
|
1177
1177
|
createChatTurnRoutes,
|
|
1178
1178
|
streamChatRouteAsSandboxEvents
|
|
1179
1179
|
};
|
|
1180
|
-
//# sourceMappingURL=chunk-
|
|
1180
|
+
//# sourceMappingURL=chunk-P2CGXXOJ.js.map
|
|
@@ -163,6 +163,10 @@ function validateInteractionAnswerBody(body) {
|
|
|
163
163
|
}
|
|
164
164
|
return { ok: true, id, outcome, data };
|
|
165
165
|
}
|
|
166
|
+
function selectAnswersAsArrays(request, data) {
|
|
167
|
+
const selects = new Set(request.answerSpec.fields.filter((field) => field.type === "select").map((field) => field.name));
|
|
168
|
+
return Object.fromEntries(Object.entries(data).map(([key, value]) => [key, selects.has(key) && typeof value === "string" ? [value] : value]));
|
|
169
|
+
}
|
|
166
170
|
var DEFAULT_MAX_BODY_BYTES = 64 * 1024;
|
|
167
171
|
function mapInteractionRespondFailure(error, logger = console) {
|
|
168
172
|
if (error.code === "INVALID_INTERACTION_ANSWER") {
|
|
@@ -227,10 +231,6 @@ function createInteractionAnswerRoute(options) {
|
|
|
227
231
|
);
|
|
228
232
|
}
|
|
229
233
|
const connection = resolution.connection;
|
|
230
|
-
const answerPayload = {
|
|
231
|
-
outcome: validation.outcome,
|
|
232
|
-
...validation.data ? { data: validation.data } : {}
|
|
233
|
-
};
|
|
234
234
|
const before = await listSessionInteractions(connection);
|
|
235
235
|
if (!before.succeeded && (options.beforeAnswer || options.durable)) {
|
|
236
236
|
return mapInteractionRespondFailure(before.error, logger);
|
|
@@ -242,12 +242,17 @@ function createInteractionAnswerRoute(options) {
|
|
|
242
242
|
logger
|
|
243
243
|
);
|
|
244
244
|
}
|
|
245
|
+
const data = validation.data && answeredRequest ? selectAnswersAsArrays(answeredRequest, validation.data) : validation.data;
|
|
246
|
+
const answerPayload = {
|
|
247
|
+
outcome: validation.outcome,
|
|
248
|
+
...data ? { data } : {}
|
|
249
|
+
};
|
|
245
250
|
const answeredSignature = answeredRequest ? questionInteractionContentSignature(interactionFromWireRequest(answeredRequest)) : null;
|
|
246
251
|
const duplicateRequests = before.succeeded && answeredSignature ? before.value.filter((item) => item.id !== validation.id && questionInteractionContentSignature(interactionFromWireRequest(item)) === answeredSignature) : [];
|
|
247
252
|
const lifecycleArgs = {
|
|
248
253
|
request,
|
|
249
254
|
body,
|
|
250
|
-
answer: validation,
|
|
255
|
+
answer: { ...validation, ...data ? { data } : {} },
|
|
251
256
|
connection,
|
|
252
257
|
outstanding: before.succeeded ? before.value : [],
|
|
253
258
|
...answeredRequest ? { answeredRequest } : {},
|
|
@@ -373,4 +378,4 @@ export {
|
|
|
373
378
|
mapInteractionRespondFailure,
|
|
374
379
|
createInteractionAnswerRoute
|
|
375
380
|
};
|
|
376
|
-
//# sourceMappingURL=chunk-
|
|
381
|
+
//# sourceMappingURL=chunk-Q7WEEN7P.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/interactions/sidecar.ts","../src/interactions/route.ts"],"sourcesContent":["/**\n * Server-side client for the sandbox sidecar's generic interaction routes\n * (`GET/POST {runtimeUrl}/agents/sessions/{sessionId}/interactions`). The\n * transport supports structural connections and older response shapes across\n * question/permission/plan interactions. Exact-run cancellation belongs to the\n * native SDK, not this session-wide compatibility surface.\n *\n * Server-only: the sidecar bearer must never reach browser code. The caller\n * supplies the connection as a structural value (runtime URL + bearer +\n * session id) — no sandbox-SDK import, so any box-resolution strategy works.\n */\n\nimport type { InteractionData, InteractionOutcome, InteractionRequestWire } from './contract'\n\n/** Describe error details including code, message, and upstream HTTP status for sidecar interactions */\nexport interface SidecarInteractionsError {\n code: string\n message: string\n /** Upstream HTTP status; 0 when the sidecar was unreachable. */\n status: number\n}\n\n/** Represent the outcome of sidecar interactions with success or error details */\nexport type SidecarInteractionsResult<T> =\n | { succeeded: true; value: T }\n | { succeeded: false; error: SidecarInteractionsError }\n\n/** Where and how to reach one session's interaction registry. */\nexport interface SidecarInteractionsConnection {\n runtimeUrl: string\n authToken?: string\n /** The sidecar agent-session id (the chat thread's session). */\n sessionId: string\n /** Request deadline. A pending interaction means the box is up and the\n * sidecar responsive; a short default keeps a wedged runtime from stalling\n * the answering request. */\n timeoutMs?: number\n /** Injection seam for tests; defaults to global fetch. */\n fetchImpl?: typeof fetch\n}\n\nconst DEFAULT_TIMEOUT_MS = 5_000\n\n/** Strips bearer tokens / key material before an upstream message is logged\n * or surfaced. */\nfunction sanitizeUpstreamMessage(input: unknown): string {\n const message = input instanceof Error ? input.message : String(input)\n return message\n .replace(/Bearer\\s+[^\\s]+/gi, 'Bearer [redacted]')\n .replace(/\\b(?:sk|pk|tc)[_-][A-Za-z0-9_-]{8,}\\b/g, '[redacted-key]')\n}\n\n/** One transport for session controls and interaction answers. Keep the established\n * error codes per family; authentication, deadlines and decoding cannot drift. */\nasync function sidecarFetch(\n connection: SidecarInteractionsConnection,\n family: 'interactions' | 'session',\n init: { method: 'GET' | 'POST'; body?: Record<string, unknown> } = { method: 'GET' },\n): Promise<SidecarInteractionsResult<Record<string, unknown>>> {\n const session = `/agents/sessions/${encodeURIComponent(connection.sessionId)}`\n const path = family === 'interactions' ? `${session}/interactions`\n : init.method === 'POST' ? `${session}/abort` : session\n const failure = (code: string, message: unknown, status: number): SidecarInteractionsResult<never> => ({\n succeeded: false, error: { code, message: sanitizeUpstreamMessage(message), status },\n })\n let response: Response\n let parsed: unknown\n try {\n response = await (connection.fetchImpl ?? fetch)(`${connection.runtimeUrl.replace(/\\/$/, '')}${path}`, {\n method: init.method,\n headers: {\n ...(connection.authToken ? { authorization: `Bearer ${connection.authToken}` } : {}),\n ...(init.method === 'POST' ? { 'content-type': 'application/json' } : {}),\n },\n ...(init.method === 'POST' ? { body: JSON.stringify(init.body ?? {}) } : {}),\n redirect: 'manual',\n credentials: 'omit',\n signal: AbortSignal.timeout(connection.timeoutMs ?? DEFAULT_TIMEOUT_MS),\n })\n if (response.redirected || response.type === 'opaqueredirect' || (response.status >= 300 && response.status < 400)) {\n await response.body?.cancel().catch(() => undefined)\n return failure('UPSTREAM_REDIRECT', 'The sidecar request refused a redirect.', response.status)\n }\n try { parsed = await response.json() } catch { parsed = undefined }\n } catch (error) {\n return family === 'interactions'\n ? failure('UPSTREAM_UNREACHABLE', error, 0)\n : failure('SIDECAR_UNREACHABLE', error, 502)\n }\n const payload = asRecord(parsed)\n if (!response.ok || payload?.success === false) {\n const error = asRecord(payload?.error)\n return failure(\n typeof error?.code === 'string' && error.code ? error.code\n : family === 'interactions' ? 'UPSTREAM_ERROR' : 'SIDECAR_SESSION_FAILED',\n typeof error?.message === 'string' && error.message ? error.message\n : `sidecar ${family} ${init.method} failed (${response.status})`,\n response.status,\n )\n }\n if (!payload) return failure('MALFORMED_RESPONSE', 'The sidecar returned no JSON object.', response.status)\n return { succeeded: true, value: payload }\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === 'object' && !Array.isArray(value)\n ? value as Record<string, unknown> : undefined\n}\n\n/** Outstanding (unanswered) interactions for the session — the sidecar's\n * registry is authoritative, so this is the reconnect/reload source of truth. */\nexport async function listSessionInteractions(\n connection: SidecarInteractionsConnection,\n): Promise<SidecarInteractionsResult<InteractionRequestWire[]>> {\n const result = await sidecarFetch(connection, 'interactions')\n if (!result.succeeded) return result\n const data = result.value.data as { interactions?: unknown } | undefined\n if (!Array.isArray(data?.interactions)) {\n return {\n succeeded: false,\n error: { code: 'MALFORMED_RESPONSE', message: 'sidecar list returned no interactions array', status: 200 },\n }\n }\n return { succeeded: true, value: data.interactions as InteractionRequestWire[] }\n}\n\n/** Resolves one interaction. `data` is required by the sidecar only for\n * `accepted` outcomes and is validated fail-closed against the answerSpec\n * (400 INVALID_INTERACTION_ANSWER on mismatch). */\nexport async function respondToSessionInteraction(\n connection: SidecarInteractionsConnection,\n response: { id: string; outcome: InteractionOutcome; data?: InteractionData },\n): Promise<SidecarInteractionsResult<void>> {\n const result = await sidecarFetch(connection, 'interactions', {\n method: 'POST',\n body: {\n id: response.id,\n outcome: response.outcome,\n ...(response.data ? { data: response.data } : {}),\n },\n })\n if (!result.succeeded) return result\n // An HTTP success is not an acknowledgement that the answer was applied.\n // Current runtimes return success:true; retain the supported data.ok receipt.\n if (result.value.success !== true && asRecord(result.value.data)?.ok !== true) {\n return {\n succeeded: false,\n error: { code: 'MALFORMED_RESPONSE', message: 'sidecar answer returned no acknowledgement', status: 200 },\n }\n }\n return { succeeded: true, value: undefined }\n}\n\n/**\n * A sandbox session's lifecycle as the sidecar reports it.\n *\n * Every field is optional because the sidecar's payload has grown over time and\n * an older box answers with a subset. A reader that assumes a field is present\n * mis-reads an old box as terminal; the shapes below are read defensively for\n * that reason, not out of caution about types.\n */\nexport interface SidecarSessionState {\n state?: string\n activeExecutionId?: string | null\n activeExecutionStatus?: string | null\n reconnectable?: boolean\n registryAuthority?: string | null\n terminalReason?: string | null\n lastEventAt?: string | number | null\n outstandingInteractions?: unknown[]\n}\n\nexport interface SidecarAbortResult {\n cancelled: boolean\n reason?: string\n session?: SidecarSessionState\n}\n\n/**\n * Whether a session has finished and will not produce more events.\n *\n * The three early returns are the ones that matter: a session with a live\n * execution, one the platform says is reconnectable, or one holding an\n * unanswered interaction is NOT terminal however its `state` string reads. An\n * app that treats such a session as finished abandons a turn mid-flight, or\n * leaves an agent blocked on an answer nobody will send.\n */\nexport function isTerminalSidecarState(state: {\n state?: string\n activeExecutionId?: string | null\n reconnectable?: boolean\n outstandingInteractions?: unknown[]\n}): boolean {\n if (state.activeExecutionId) return false\n if (state.reconnectable === true) return false\n if (state.outstandingInteractions && state.outstandingInteractions.length > 0) return false\n return TERMINAL_SESSION_STATES.includes(state.state ?? '') || state.reconnectable === false\n}\n\nconst TERMINAL_SESSION_STATES = ['completed', 'failed', 'aborted', 'expired', 'idle', 'terminal']\n\n/** Read the session payload defensively: newer boxes nest under `data`, and\n * the execution id appears either on the session or on `activeExecution`. */\nfunction sessionStateFromPayload(payload: Record<string, unknown>): SidecarSessionState {\n const data = (payload.data && typeof payload.data === 'object' ? payload.data : payload) as Record<string, unknown>\n const session = data.session && typeof data.session === 'object'\n ? data.session as Record<string, unknown>\n : data\n const activeExecution = data.activeExecution && typeof data.activeExecution === 'object'\n ? data.activeExecution as Record<string, unknown>\n : session.activeExecution && typeof session.activeExecution === 'object'\n ? session.activeExecution as Record<string, unknown>\n : null\n const interactions = session.outstandingInteractions ?? session.interactions\n return {\n ...(typeof session.state === 'string' ? { state: session.state } : {}),\n ...(typeof session.activeExecutionId === 'string'\n ? { activeExecutionId: session.activeExecutionId }\n : session.activeExecutionId === null ? { activeExecutionId: null } : {}),\n ...(typeof session.reconnectable === 'boolean' ? { reconnectable: session.reconnectable } : {}),\n ...(typeof session.registryAuthority === 'string'\n ? { registryAuthority: session.registryAuthority }\n : session.registryAuthority === null ? { registryAuthority: null } : {}),\n ...(typeof session.terminalReason === 'string'\n ? { terminalReason: session.terminalReason }\n : session.terminalReason === null ? { terminalReason: null } : {}),\n ...(typeof session.lastEventAt === 'string' || typeof session.lastEventAt === 'number' || session.lastEventAt === null\n ? { lastEventAt: session.lastEventAt }\n : {}),\n ...(Array.isArray(interactions) ? { outstandingInteractions: interactions } : {}),\n ...(activeExecution && typeof activeExecution.id === 'string' && typeof session.activeExecutionId !== 'string'\n ? { activeExecutionId: activeExecution.id }\n : {}),\n ...(activeExecution && typeof activeExecution.status === 'string'\n ? { activeExecutionStatus: activeExecution.status }\n : activeExecution === null && session.activeExecution === null ? { activeExecutionStatus: null } : {}),\n }\n}\n\n/** The session's current lifecycle, for reconnect and resume decisions. */\nexport async function getSessionState(\n connection: SidecarInteractionsConnection,\n): Promise<SidecarInteractionsResult<SidecarSessionState>> {\n const result = await sidecarFetch(connection, 'session')\n if (!result.succeeded) return result\n return { succeeded: true, value: sessionStateFromPayload(result.value) }\n}\n\n/**\n * Cancel a running session.\n *\n * A 404 is reported as a SUCCESSFUL no-op rather than an error: the caller's\n * intent is \"this session must not be running\", and a session the sidecar has\n * never heard of already satisfies that. Surfacing it as a failure makes every\n * cancel-after-completion look like an outage.\n */\nexport async function abortSession(\n connection: SidecarInteractionsConnection,\n): Promise<SidecarInteractionsResult<SidecarAbortResult>> {\n const result = await sidecarFetch(connection, 'session', { method: 'POST' })\n if (!result.succeeded) {\n if (result.error.status === 404) return { succeeded: true, value: { cancelled: false, reason: 'not-found' } }\n return result\n }\n const data = (result.value.data && typeof result.value.data === 'object'\n ? result.value.data\n : result.value) as Record<string, unknown>\n const reason = typeof data.reason === 'string' && data.reason.trim()\n ? data.reason.trim()\n : typeof data.noopReason === 'string' && data.noopReason.trim()\n ? data.noopReason.trim()\n : undefined\n return {\n succeeded: true,\n value: {\n cancelled: data.cancelled === true,\n ...(reason ? { reason } : {}),\n ...(data.session && typeof data.session === 'object' ? { session: sessionStateFromPayload(result.value) } : {}),\n },\n }\n}\n","/**\n * Framework-neutral interaction-answer endpoints, lifted out of the per-app\n * route files (gtm `api.chat.interactions`, legal `api.chat.interactions`,\n * tax `api.sessions.$id.interactions` — three byte-similar forks):\n *\n * list(request) — GET: outstanding asks for a live turn (reload restore)\n * answer(request) — POST `{ id, outcome, data? }`: resolve one ask\n *\n * The product supplies ONE seam, `resolveConnection`: authenticate the caller,\n * authorize the thread/session, and resolve the sidecar connection. Everything\n * behind the seam is mechanism the forks kept re-fixing:\n *\n * - body validation (safe field keys, typed values),\n * - sidecar error → client contract mapping (every \"the ask is gone\" shape\n * becomes 410 so the card flips to its expired state),\n * - duplicate resolution: after answering, every other outstanding ask with\n * the same content signature (a re-emitted duplicate) gets the same answer,\n * - unblock verification: re-list and fail loud (503 INTERACTION_STILL_PENDING)\n * when the sidecar accepted the POST but the ask is still open,\n * - best-effort list: sidecar failures return `{ interactions: [],\n * unavailable }` so a reload restore never breaks the live stream.\n *\n * Handlers return web-standard `Response`s (Workers, Node 18+, Deno) — no\n * router import anywhere.\n */\n\nimport {\n interactionFromWireRequest,\n isSafeInteractionFieldKey,\n questionInteractionContentSignature,\n type InteractionData,\n type InteractionRequestWire,\n} from './contract'\nimport {\n listSessionInteractions,\n respondToSessionInteraction,\n type SidecarInteractionsConnection,\n type SidecarInteractionsError,\n} from './sidecar'\nimport { parseJsonObjectBody } from '../web/core'\n\n// A client resolves an ask by answering (`accepted`) or refusing (`declined`).\n// Withdrawal (`cancelled`) is an agent/broker outcome delivered via the\n// `interaction.cancel` event, never a client POST, so it is not accepted here.\n/** Define possible outcomes for an interaction client as accepted or declined */\nexport type InteractionClientOutcome = 'accepted' | 'declined'\n\n/** Validate interaction answer body and return success with data or failure with error message */\nexport type InteractionAnswerBodyValidation =\n | { ok: true; id: string; outcome: InteractionClientOutcome; data?: InteractionData }\n | { ok: false; error: string }\n\n/** Validates the client POST body: `{ id, outcome, data? }` with\n * identifier-safe field keys and primitive/string-array values only. */\nexport function validateInteractionAnswerBody(body: Record<string, unknown>): InteractionAnswerBodyValidation {\n const id = typeof body.id === 'string' && body.id ? body.id : null\n if (!id) return { ok: false, error: 'Missing interaction id' }\n const outcome = body.outcome\n if (outcome !== 'accepted' && outcome !== 'declined') {\n return { ok: false, error: 'Invalid outcome: expected accepted or declined' }\n }\n if (body.data === undefined) return { ok: true, id, outcome }\n if (!body.data || typeof body.data !== 'object' || Array.isArray(body.data)) {\n return { ok: false, error: 'Invalid data: expected an object of field values' }\n }\n const data: InteractionData = {}\n for (const [key, value] of Object.entries(body.data)) {\n if (!isSafeInteractionFieldKey(key)) {\n return { ok: false, error: 'Invalid data: field names must contain only letters, numbers, underscores, or hyphens' }\n }\n const validValue =\n typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' ||\n (Array.isArray(value) && value.every((item) => typeof item === 'string'))\n if (!validValue) {\n return { ok: false, error: 'Invalid data: field values must be strings, numbers, booleans, or string arrays' }\n }\n data[key] = value as InteractionData[string]\n }\n return { ok: true, id, outcome, data }\n}\n\n/** Wrap a plain-string answer to a select field as the one-choice array the sidecar accepts. */\nfunction selectAnswersAsArrays(request: InteractionRequestWire, data: InteractionData): InteractionData {\n const selects = new Set(request.answerSpec.fields.filter((field) => field.type === 'select').map((field) => field.name))\n return Object.fromEntries(Object.entries(data).map(([key, value]) =>\n [key, selects.has(key) && typeof value === 'string' ? [value] : value])) as InteractionData\n}\n\n/** How big the POST body may be before the route refuses to parse it. An\n * answer carries an interaction id, an outcome, and field values — 64 KiB is\n * generous; refusing larger bodies before parsing bounds per-request memory\n * (issue #748). */\nconst DEFAULT_MAX_BODY_BYTES = 64 * 1024\n\n/** Provide logging methods for warnings and errors in interaction routes */\nexport type InteractionRouteLogger = Pick<Console, 'warn' | 'error'>\n\n/** Sidecar error → the client-actionable contract. Every \"the ask is gone\"\n * shape maps to 410 so the card flips to its expired state — a raw 404/409\n * must never surface. */\nexport function mapInteractionRespondFailure(\n error: SidecarInteractionsError,\n logger: InteractionRouteLogger = console,\n): Response {\n if (error.code === 'INVALID_INTERACTION_ANSWER') {\n return Response.json(\n { code: 'INVALID_INTERACTION_ANSWER', error: 'This question needs an answer from the card above — pick one of the listed options.' },\n { status: 400 },\n )\n }\n if (error.status === 404) {\n return Response.json(\n { code: 'INTERACTION_EXPIRED', error: 'This question is no longer waiting for an answer.' },\n { status: 410 },\n )\n }\n if (error.status === 501 || error.code === 'NOT_IMPLEMENTED') {\n return Response.json(\n { code: 'INTERACTIONS_UNSUPPORTED', error: 'This agent backend cannot accept answers this way.' },\n { status: 501 },\n )\n }\n logger.error('[interactions] respond failed:', error)\n return Response.json(\n { code: 'INTERACTION_UPSTREAM_FAILED', error: 'Could not reach the agent. Try again.' },\n { status: 503 },\n )\n}\n\n/** The product seam's verdict for one request. `response` short-circuits with\n * a product-authored Response (401/404/429…); `unavailable` means the caller\n * is fine but the sandbox runtime is not reachable — the factory shapes that\n * per intent (empty list for `list`, 503 for `answer`). */\nexport type InteractionConnectionResolution =\n | { ok: true; connection: SidecarInteractionsConnection }\n | { ok: false; response: Response }\n | { ok: false; unavailable: string }\n\n/** Define arguments required to resolve interaction connections based on request and intent */\nexport interface ResolveInteractionConnectionArgs {\n request: Request\n intent: 'list' | 'answer'\n /** The parsed, validated POST body (answer intent only) so the resolver can\n * read product routing fields (workspaceId/threadId) without re-parsing. */\n body?: Record<string, unknown>\n}\n\n/** Describe the arguments provided before processing an interaction answer including request, body, and connection details */\nexport interface BeforeInteractionAnswerArgs {\n request: Request\n /** Original parsed body, including product routing fields. */\n body: Record<string, unknown>\n /** Shared validation result; products never need to parse the answer again. */\n answer: Extract<InteractionAnswerBodyValidation, { ok: true }>\n connection: SidecarInteractionsConnection\n /** The route's single authoritative pre-answer sidecar snapshot. */\n outstanding: InteractionRequestWire[]\n answeredRequest?: InteractionRequestWire\n /** Content-identical questions that the shared route will also answer. */\n duplicateRequests: InteractionRequestWire[]\n}\n\n/** Define arguments for durable interaction routes including a stable caller-created attempt key */\nexport interface DurableInteractionRouteArgs extends BeforeInteractionAnswerArgs {\n /** Caller-created opaque identifier, stable across an ambiguous retry. */\n attemptKey: string\n}\n\n/** Crash-recoverable persistence lifecycle for the answer route. The product\n * binds this structural port to its OWN durable store — agent-app ships no\n * implementation (the `/durable-chat` module that used to provide one was\n * removed in 0.44.0 after nine repos produced zero imports of it). Existing\n * `beforeAnswer` behavior remains independent and unchanged. */\nexport interface DurableInteractionRoutePersistence<TPrepared = unknown> {\n guarantee: 'reconciled' | 'best-effort'\n prepare(args: DurableInteractionRouteArgs): TPrepared | Promise<TPrepared>\n /** Resolve an ambiguous retry (for example, the sidecar says the ask is\n * already gone). Only `settled:true` permits the route to report success. */\n reconcile(args: DurableInteractionRouteArgs & { prepared: TPrepared }):\n | { settled: boolean }\n | Promise<{ settled: boolean }>\n /** Record the authority acknowledgement before terminal projection. */\n acknowledge(args: DurableInteractionRouteArgs & {\n prepared: TPrepared\n duplicateIds: string[]\n }): void | Promise<void>\n /** Idempotently materialize terminal status and accepted values. */\n finalize(args: DurableInteractionRouteArgs & {\n prepared: TPrepared\n duplicateIds: string[]\n }): void | Promise<void>\n fail?(args: DurableInteractionRouteArgs & { prepared: TPrepared; error: unknown }): void | Promise<void>\n}\n\n/** Define options to authenticate, authorize, and manage persistence for interaction answer routes */\nexport interface InteractionAnswerRouteOptions {\n /** Authenticate + authorize the caller and resolve the sidecar connection.\n * This is the only product-supplied step: session auth, workspace/thread\n * access, rate limiting, and box resolution all live here. */\n resolveConnection: (args: ResolveInteractionConnectionArgs) => Promise<InteractionConnectionResolution>\n /** Product persistence seam that runs before the answer can unblock and\n * finalize the agent turn. A throw aborts the request before any answer POST. */\n beforeAnswer?: (args: BeforeInteractionAnswerArgs) => void | Promise<void>\n /** Additive crash-recoverable settlement. When configured, POST requires an\n * `attemptKey`; accepted values are finalized only after sidecar ack. */\n durable?: DurableInteractionRoutePersistence\n /** Request-body byte cap before parsing. Default 64 KiB. */\n maxBodyBytes?: number\n logger?: InteractionRouteLogger\n}\n\n/** Define routes to list outstanding interactions and resolve answers for live turns */\nexport interface InteractionAnswerRoute {\n /** GET — outstanding interactions for a live turn. Failures return an empty\n * list with an explicit `unavailable` code: the caller is a best-effort\n * reload restore, and the live/replayed stream must stay untouched when the\n * sidecar cannot answer. */\n list: (request: Request) => Promise<Response>\n /** POST `{ id, outcome, data?, ...productFields }` — resolve one ask, answer\n * content-identical duplicates the same way, then re-list to prove the run\n * actually unblocked. */\n answer: (request: Request) => Promise<Response>\n}\n\n/** Create an interaction answer route that handles listing and resolving interaction requests */\nexport function createInteractionAnswerRoute(options: InteractionAnswerRouteOptions): InteractionAnswerRoute {\n const logger = options.logger ?? console\n\n async function list(request: Request): Promise<Response> {\n const resolution = await options.resolveConnection({ request, intent: 'list' })\n if (!resolution.ok) {\n if ('response' in resolution) return resolution.response\n return Response.json({ interactions: [], unavailable: resolution.unavailable })\n }\n const result = await listSessionInteractions(resolution.connection)\n if (!result.succeeded) {\n logger.warn('[interactions] list failed:', result.error)\n return Response.json({ interactions: [], unavailable: result.error.code })\n }\n return Response.json({ interactions: result.value })\n }\n\n async function answer(request: Request): Promise<Response> {\n // Bounded body parse (streaming cap, content-length precheck, 413) — the\n // same primitive every other route boundary in the package uses.\n const [body, bodyError] = await parseJsonObjectBody(request, { maxBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES })\n if (bodyError) {\n return Response.json(\n bodyError.status === 413\n ? { error: 'JSON body is too large' }\n : { error: 'Invalid JSON body' },\n { status: bodyError.status },\n )\n }\n const validation = validateInteractionAnswerBody(body)\n if (!validation.ok) return Response.json({ error: validation.error }, { status: 400 })\n const attemptKey = typeof body.attemptKey === 'string' ? body.attemptKey.trim() : ''\n if (options.durable && !attemptKey) {\n return Response.json({ error: 'Missing attemptKey for durable interaction answer' }, { status: 400 })\n }\n\n const resolution = await options.resolveConnection({ request, intent: 'answer', body })\n if (!resolution.ok) {\n if ('response' in resolution) return resolution.response\n return mapInteractionRespondFailure(\n { code: resolution.unavailable, message: 'sandbox runtime unavailable', status: 0 },\n logger,\n )\n }\n const connection = resolution.connection\n\n // Snapshot the answered ask's content signature BEFORE resolving it, so any\n // content-identical duplicates still outstanding afterwards (the agent may\n // have re-emitted the same question N times) can be answered the same way.\n const before = await listSessionInteractions(connection)\n if (!before.succeeded && (options.beforeAnswer || options.durable)) {\n return mapInteractionRespondFailure(before.error, logger)\n }\n const answeredRequest = before.succeeded ? before.value.find((item) => item.id === validation.id) : undefined\n if (options.beforeAnswer && !options.durable && !answeredRequest) {\n return mapInteractionRespondFailure(\n { code: 'NOT_FOUND', message: 'interaction not found', status: 404 },\n logger,\n )\n }\n // A select answer is a string array on the wire; a caller that sends one\n // choice as a plain string means that choice.\n const data = validation.data && answeredRequest ? selectAnswersAsArrays(answeredRequest, validation.data) : validation.data\n const answerPayload = {\n outcome: validation.outcome,\n ...(data ? { data } : {}),\n }\n const answeredSignature = answeredRequest\n ? questionInteractionContentSignature(interactionFromWireRequest(answeredRequest))\n : null\n const duplicateRequests = before.succeeded && answeredSignature\n ? before.value.filter((item) => item.id !== validation.id && (\n questionInteractionContentSignature(interactionFromWireRequest(item)) === answeredSignature\n ))\n : []\n\n const lifecycleArgs: BeforeInteractionAnswerArgs = {\n request,\n body,\n answer: { ...validation, ...(data ? { data } : {}) },\n connection,\n outstanding: before.succeeded ? before.value : [],\n ...(answeredRequest ? { answeredRequest } : {}),\n duplicateRequests,\n }\n\n if (options.beforeAnswer && answeredRequest) {\n try {\n await options.beforeAnswer(lifecycleArgs)\n } catch (error) {\n logger.error('[interactions] beforeAnswer failed:', error)\n return Response.json(\n { code: 'INTERACTION_BEFORE_ANSWER_FAILED', error: 'Could not save the answer. Try again.' },\n { status: 503 },\n )\n }\n }\n\n let prepared: unknown\n const durableArgs = options.durable\n ? { ...lifecycleArgs, attemptKey }\n : null\n if (options.durable && durableArgs) {\n try {\n prepared = await options.durable.prepare(durableArgs)\n } catch (error) {\n logger.error('[interactions] durable prepare failed:', error)\n return Response.json(\n { code: 'INTERACTION_PREPARE_FAILED', error: 'Could not prepare the answer. Try again.' },\n { status: 503 },\n )\n }\n if (!answeredRequest) {\n let reconciled: { settled: boolean }\n try {\n reconciled = await options.durable.reconcile({ ...durableArgs, prepared })\n } catch (error) {\n logger.error('[interactions] durable reconcile failed:', error)\n reconciled = { settled: false }\n }\n if (reconciled.settled) return Response.json({ ok: true, idempotent: true })\n return Response.json(\n { code: 'INTERACTION_RECONCILIATION_PENDING', error: 'The answer status is still being checked. Retry with the same attempt.' },\n { status: 503 },\n )\n }\n }\n\n const result = await respondToSessionInteraction(connection, { id: validation.id, ...answerPayload })\n if (!result.succeeded) {\n if (options.durable && durableArgs) {\n let reconciled: { settled: boolean }\n try {\n reconciled = await options.durable.reconcile({ ...durableArgs, prepared })\n } catch {\n reconciled = { settled: false }\n }\n if (reconciled.settled) return Response.json({ ok: true, idempotent: true })\n if (result.error.status === 404) {\n return Response.json(\n { code: 'INTERACTION_RECONCILIATION_PENDING', error: 'The answer status is still being checked. Retry with the same attempt.' },\n { status: 503 },\n )\n }\n try {\n await options.durable.fail?.({ ...durableArgs, prepared, error: result.error })\n } catch {\n // The upstream failure remains authoritative; a persistence cleanup\n // failure must not replace its client-facing mapping.\n }\n }\n return mapInteractionRespondFailure(result.error, logger)\n }\n\n let remaining = await listSessionInteractions(connection)\n const acknowledgedDuplicateIds: string[] = []\n if (remaining.succeeded && answeredSignature) {\n const remainingDuplicates = remaining.value.filter((item) => {\n if (item.id === validation.id) return false\n return questionInteractionContentSignature(interactionFromWireRequest(item)) === answeredSignature\n })\n for (const duplicate of remainingDuplicates) {\n const duplicateResult = await respondToSessionInteraction(connection, { id: duplicate.id, ...answerPayload })\n if (!duplicateResult.succeeded) break\n acknowledgedDuplicateIds.push(duplicate.id)\n }\n if (remainingDuplicates.length > 0) remaining = await listSessionInteractions(connection)\n }\n\n // Prove the run actually unblocked: neither the answered id nor any\n // content-duplicate may still be outstanding. If one is, the sidecar\n // accepted the POST but did not release the run — report it rather than\n // tell the user it was answered.\n if (remaining.succeeded && remaining.value.some((item) => item.id === validation.id || (\n answeredSignature && questionInteractionContentSignature(interactionFromWireRequest(item)) === answeredSignature\n ))) {\n logger.error('[interactions] respond returned ok but interaction is still pending:', {\n sessionId: connection.sessionId,\n interactionId: validation.id,\n })\n return Response.json(\n { code: 'INTERACTION_STILL_PENDING', error: 'The agent did not accept the answer. Try answering again.' },\n { status: 503 },\n )\n }\n\n if (options.durable && durableArgs) {\n try {\n await options.durable.acknowledge({\n ...durableArgs,\n prepared,\n duplicateIds: acknowledgedDuplicateIds,\n })\n await options.durable.finalize({\n ...durableArgs,\n prepared,\n duplicateIds: acknowledgedDuplicateIds,\n })\n } catch (error) {\n logger.error('[interactions] durable finalize failed:', error)\n return Response.json(\n { code: 'INTERACTION_FINALIZE_FAILED', error: 'The answer was accepted but is still being saved. Retry to reconcile it.' },\n { status: 503 },\n )\n }\n }\n\n return Response.json({ ok: true })\n }\n\n return { list, answer }\n}\n"],"mappings":"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","names":[]}
|
|
@@ -11,19 +11,56 @@ function deltaTypeOf(ev) {
|
|
|
11
11
|
}
|
|
12
12
|
return null;
|
|
13
13
|
}
|
|
14
|
+
function innerOf(ev) {
|
|
15
|
+
const e = ev;
|
|
16
|
+
if (!e || typeof e !== "object") return null;
|
|
17
|
+
const inner = e.kind === "event" ? e.event : e;
|
|
18
|
+
return inner && typeof inner === "object" ? inner : null;
|
|
19
|
+
}
|
|
20
|
+
function liveStateKeyOf(ev) {
|
|
21
|
+
const inner = innerOf(ev);
|
|
22
|
+
if (!inner) return null;
|
|
23
|
+
if (inner.type === "model-processing") return "model-processing";
|
|
24
|
+
if (inner.type !== "raw") return null;
|
|
25
|
+
const raw = inner.data?.event;
|
|
26
|
+
const part = raw?.part;
|
|
27
|
+
if ((raw?.type === "text" || raw?.type === "reasoning") && typeof part?.id === "string") return `raw:${part.id}`;
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
function isLiveProgressEvent(ev) {
|
|
31
|
+
return deltaTypeOf(ev) !== null || liveStateKeyOf(ev) !== null;
|
|
32
|
+
}
|
|
14
33
|
function coalesceDeltas(events) {
|
|
15
34
|
const out = [];
|
|
35
|
+
let run = null;
|
|
36
|
+
let stateSlots = /* @__PURE__ */ new Map();
|
|
16
37
|
for (const ev of events) {
|
|
17
38
|
const type = deltaTypeOf(ev);
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
39
|
+
if (type) {
|
|
40
|
+
if (run && run.type === type) {
|
|
41
|
+
const merged = JSON.parse(JSON.stringify(out[run.index]));
|
|
42
|
+
innerOf(merged).text = String(innerOf(out[run.index]).text) + String(innerOf(ev).text);
|
|
43
|
+
out[run.index] = merged;
|
|
44
|
+
} else {
|
|
45
|
+
out.push(ev);
|
|
46
|
+
run = { type, index: out.length - 1 };
|
|
47
|
+
}
|
|
48
|
+
continue;
|
|
49
|
+
}
|
|
50
|
+
const key = liveStateKeyOf(ev);
|
|
51
|
+
if (key) {
|
|
52
|
+
const slot = stateSlots.get(key);
|
|
53
|
+
if (slot === void 0) {
|
|
54
|
+
out.push(ev);
|
|
55
|
+
stateSlots.set(key, out.length - 1);
|
|
56
|
+
} else {
|
|
57
|
+
out[slot] = ev;
|
|
58
|
+
}
|
|
24
59
|
continue;
|
|
25
60
|
}
|
|
26
61
|
out.push(ev);
|
|
62
|
+
run = null;
|
|
63
|
+
stateSlots = /* @__PURE__ */ new Map();
|
|
27
64
|
}
|
|
28
65
|
return out;
|
|
29
66
|
}
|
|
@@ -52,8 +89,11 @@ function coalesceChatStreamEvents(events) {
|
|
|
52
89
|
}
|
|
53
90
|
return out;
|
|
54
91
|
}
|
|
92
|
+
var MAX_PENDING_CHARS = 64 * 1024;
|
|
55
93
|
function createBufferedTurnTap(opts) {
|
|
56
94
|
const flushIntervalMs = opts.flushIntervalMs ?? 400;
|
|
95
|
+
const detachedFlushIntervalMs = opts.detachedFlushIntervalMs ?? 2e3;
|
|
96
|
+
let pendingChars = 0;
|
|
57
97
|
const coalesce = opts.coalesce ?? coalesceDeltas;
|
|
58
98
|
const startedAt = Date.now();
|
|
59
99
|
let seq = 0;
|
|
@@ -100,6 +140,7 @@ function createBufferedTurnTap(opts) {
|
|
|
100
140
|
if (pending.length === 0) return;
|
|
101
141
|
const batch = coalesce(pending);
|
|
102
142
|
pending = [];
|
|
143
|
+
pendingChars = 0;
|
|
103
144
|
const rows = batch.map((ev) => ({ seq: ++seq, event: JSON.stringify(ev) }));
|
|
104
145
|
await opts.store.append(opts.turnId, rows);
|
|
105
146
|
lastFlush = Date.now();
|
|
@@ -119,15 +160,18 @@ function createBufferedTurnTap(opts) {
|
|
|
119
160
|
await renewLease();
|
|
120
161
|
}
|
|
121
162
|
const ev = raw && typeof raw === "object" ? { ...raw, _t: Date.now() - startedAt } : raw;
|
|
163
|
+
const line = JSON.stringify(ev);
|
|
122
164
|
pending.push(ev);
|
|
165
|
+
pendingChars += line?.length ?? 0;
|
|
123
166
|
if (!clientGone && opts.write) {
|
|
124
167
|
try {
|
|
125
|
-
await opts.write(
|
|
168
|
+
await opts.write(line);
|
|
126
169
|
} catch {
|
|
127
170
|
clientGone = true;
|
|
128
171
|
}
|
|
129
172
|
}
|
|
130
|
-
|
|
173
|
+
const due = detached ? !isLiveProgressEvent(ev) || Date.now() - lastFlush >= detachedFlushIntervalMs : Date.now() - lastFlush >= flushIntervalMs;
|
|
174
|
+
if (due || pendingChars >= MAX_PENDING_CHARS) await flush();
|
|
131
175
|
},
|
|
132
176
|
async done(status = "complete") {
|
|
133
177
|
await ensureStarted();
|
|
@@ -387,6 +431,7 @@ function createMemoryTurnEventStore(options = {}) {
|
|
|
387
431
|
export {
|
|
388
432
|
DEFAULT_RUNNING_TURN_LEASE_MS,
|
|
389
433
|
DEFAULT_RUNNING_TURN_RENEW_INTERVAL_MS,
|
|
434
|
+
isLiveProgressEvent,
|
|
390
435
|
coalesceDeltas,
|
|
391
436
|
coalesceChatStreamEvents,
|
|
392
437
|
createBufferedTurnTap,
|
|
@@ -400,4 +445,4 @@ export {
|
|
|
400
445
|
createD1TurnEventStore,
|
|
401
446
|
createMemoryTurnEventStore
|
|
402
447
|
};
|
|
403
|
-
//# sourceMappingURL=chunk-
|
|
448
|
+
//# sourceMappingURL=chunk-X4OMULP5.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/stream/turn-buffer.ts"],"sourcesContent":["/**\n * Resumable chat turns — the router-path answer to \"streams resume on\n * disconnect\" (issue #27). A turn's loop events are teed into a store as they\n * stream; the turn keeps running under `ctx.waitUntil` when the client drops;\n * a reconnecting client replays the buffered tail by sequence number and\n * keeps following until the turn completes.\n *\n * POST /chat/stream → pumpBufferedTurn(...) + live NDJSON\n * GET /chat/stream/:turnId → replayTurnEvents({ fromSeq }) → NDJSON\n *\n * Storage is a structural seam ({@link TurnEventStore}); a D1 implementation\n * ships here because that's what Cloudflare products have (KV is unsuitable:\n * eventually consistent cross-isolate). Per-token deltas would mean hundreds\n * of rows per turn, so consecutive text/reasoning deltas are coalesced within\n * a flush window before they are persisted — replay yields slightly chunkier\n * deltas with identical concatenation.\n */\n\nexport type TurnStatus = 'running' | 'complete' | 'error'\n\n/** A running row is a renewable lease, not permanent truth. If the process\n * driving a turn dies before writing a terminal status, reconnect discovery\n * must eventually stop returning that abandoned row. */\nexport const DEFAULT_RUNNING_TURN_LEASE_MS = 5 * 60_000\n\n/** Keep a healthy turn's lease comfortably ahead of expiry without turning\n * per-token streaming into status-write traffic. */\nexport const DEFAULT_RUNNING_TURN_RENEW_INTERVAL_MS = 30_000\n\n/** Represent a buffered turn event with a sequence number and serialized event data */\nexport interface BufferedTurnEvent {\n seq: number\n /** The serialized event line (JSON string, no trailing newline). */\n event: string\n}\n\n/** Manage and query turn events and their lifecycle statuses within a scoped event store */\nexport interface TurnEventStore {\n /**\n * Append rows while the turn is live. Implementations must ignore rows that\n * arrive after `setStatus` publishes `complete` or `error`; the terminal\n * status is the replay fence for a detached live projection.\n */\n append(turnId: string, events: BufferedTurnEvent[]): Promise<void>\n read(turnId: string, fromSeq: number): Promise<BufferedTurnEvent[]>\n /** Record turn lifecycle. `scopeId` (a thread/session id) is optional and lets\n * {@link TurnEventStore.listRunning} rediscover this turn after a client reload\n * loses the turnId; stores that don't track scope ignore it. */\n setStatus(turnId: string, status: TurnStatus, scopeId?: string): Promise<void>\n getStatus(turnId: string): Promise<TurnStatus | null>\n /** Unexpired running turnIds for a scope, newest first — so a reloaded client\n * (clientRunId lost) can find and resume the in-flight turn without reviving\n * a row abandoned by a dead process. Optional: a store records it only if\n * `setStatus` was given a `scopeId`. */\n listRunning?(scopeId: string): Promise<string[]>\n /** Remove one turn's buffered events and keep its status, so a genuine\n * re-stream after a crash starts at seq 0 without interleaving orphaned\n * rows. `runDetachedTurn` requires it to recover a `running` turn. */\n resetEvents?(turnId: string): Promise<void>\n /** Explicitly remove one turn's events and status. Optional so existing\n * custom stores remain source-compatible; the built-in D1 and memory stores\n * provide it. */\n deleteTurn?(turnId: string): Promise<void>\n /** Remove terminal turns whose status was updated before `before` (Unix\n * milliseconds or a Date). Running turns are never eligible. */\n pruneTerminalTurns?(before: number | Date): Promise<number>\n}\n\n/** Configure running-turn lease evaluation. The clock is injectable so store\n * contract tests do not sleep. Keep the default in production unless a\n * deployment also tunes the buffer's renewal interval. */\nexport interface TurnEventStoreOptions {\n runningTurnLeaseMs?: number\n now?: () => number\n}\n\n// ── coalescing ────────────────────────────────────────────────────────────\n\ntype AnyRecord = Record<string, unknown>\n\nfunction deltaTypeOf(ev: unknown): 'text' | 'reasoning' | null {\n const e = ev as AnyRecord | null\n if (!e || typeof e !== 'object') return null\n const inner = (e.kind === 'event' ? (e.event as AnyRecord | undefined) : e) as AnyRecord | undefined\n if (!inner || typeof inner !== 'object') return null\n if ((inner.type === 'text' || inner.type === 'reasoning') && typeof inner.text === 'string') {\n return inner.type\n }\n return null\n}\n\nfunction innerOf(ev: unknown): AnyRecord | null {\n const e = ev as AnyRecord | null\n if (!e || typeof e !== 'object') return null\n const inner = (e.kind === 'event' ? e.event : e) as AnyRecord | undefined\n return inner && typeof inner === 'object' ? inner : null\n}\n\n/**\n * The key of a live-state event whose latest value supersedes earlier ones:\n * the model-processing heartbeat, and a harness's raw update of a text or\n * reasoning part (it carries the part's whole state, keyed by part id). Null\n * for every other event.\n */\nfunction liveStateKeyOf(ev: unknown): string | null {\n const inner = innerOf(ev)\n if (!inner) return null\n if (inner.type === 'model-processing') return 'model-processing'\n if (inner.type !== 'raw') return null\n const raw = (inner.data as AnyRecord | undefined)?.event as AnyRecord | undefined\n const part = raw?.part as AnyRecord | undefined\n if ((raw?.type === 'text' || raw?.type === 'reasoning') && typeof part?.id === 'string') return `raw:${part.id}`\n return null\n}\n\n/** Whether an event only projects live progress, so it may wait for the flush window and be coalesced. */\nexport function isLiveProgressEvent(ev: unknown): boolean {\n return deltaTypeOf(ev) !== null || liveStateKeyOf(ev) !== null\n}\n\n/**\n * Merge text and reasoning deltas of the same type into one event, across the\n * live-state events a harness interleaves with them, and keep only the latest\n * of each live-state event. A reasoning model streams three events per token\n * (its raw part update, a model-processing heartbeat and the delta); merging\n * only adjacent deltas wrote all three as rows (2026-10-10: 1.63 M rows in a\n * day, 59,659 in one turn). Any other event is a boundary nothing merges\n * across. Concatenation-preserving: replaying the coalesced stream produces\n * the same accumulated text, and the latest state of every part.\n */\nexport function coalesceDeltas(events: unknown[]): unknown[] {\n const out: unknown[] = []\n let run: { type: 'text' | 'reasoning'; index: number } | null = null\n let stateSlots = new Map<string, number>()\n for (const ev of events) {\n const type = deltaTypeOf(ev)\n if (type) {\n if (run && run.type === type) {\n const merged = JSON.parse(JSON.stringify(out[run.index])) as AnyRecord\n innerOf(merged)!.text = String(innerOf(out[run.index])!.text) + String(innerOf(ev)!.text)\n out[run.index] = merged\n } else {\n out.push(ev)\n run = { type, index: out.length - 1 }\n }\n continue\n }\n const key = liveStateKeyOf(ev)\n if (key) {\n const slot = stateSlots.get(key)\n if (slot === undefined) {\n out.push(ev)\n stateSlots.set(key, out.length - 1)\n } else {\n out[slot] = ev\n }\n continue\n }\n out.push(ev)\n run = null\n stateSlots = new Map()\n }\n return out\n}\n\nfunction asPartUpdate(ev: unknown): { partId: unknown; delta: unknown } | null {\n const e = ev as AnyRecord | null\n if (!e || typeof e !== 'object' || e.type !== 'message.part.updated') return null\n const data = e.data as AnyRecord | undefined\n if (!data || typeof data !== 'object') return null\n const part = data.part as AnyRecord | undefined\n const partId = part?.id ?? data.partId ?? part?.partId ?? null\n return { partId, delta: data.delta }\n}\n\n/**\n * Coalesce consecutive `message.part.updated` deltas for the SAME part into one\n * event. agent-runtime products stream `ChatStreamEvent` NDJSON\n * (`{type:'message.part.updated', data:{part, delta}}`); pumped through the\n * buffer with the default tool-loop coalescer, every per-token delta persists as\n * its own row because that coalescer never recognizes the shape. Pass this as\n * {@link PumpBufferedTurnOptions.coalesce} instead.\n *\n * Concatenation-preserving for BOTH consumer styles: the merged event keeps the\n * LATEST event's `data.part` (already the cumulative accumulation) and sets\n * `data.delta` to the concatenation of the merged deltas, so a client that\n * appends `delta` and one that reads the cumulative `part` both reconstruct the\n * identical final text.\n */\nexport function coalesceChatStreamEvents(events: unknown[]): unknown[] {\n const out: unknown[] = []\n for (const ev of events) {\n const cur = asPartUpdate(ev)\n const prevEv = out[out.length - 1]\n const prev = prevEv ? asPartUpdate(prevEv) : null\n if (cur && prev && cur.partId != null && cur.partId === prev.partId) {\n // Base the merged row on the latest event (its `part` is the most complete\n // accumulation); carry forward the summed delta.\n const merged = JSON.parse(JSON.stringify(ev)) as AnyRecord\n ;(merged.data as AnyRecord).delta = String(prev.delta ?? '') + String(cur.delta ?? '')\n out[out.length - 1] = merged\n continue\n }\n out.push(ev)\n }\n return out\n}\n\n// ── buffering core (the tap) ────────────────────────────────────────────────\n\n/** Define options for buffering and flushing turn events with optional live client delivery and event coalescing */\nexport interface BufferedTurnOptions {\n store: TurnEventStore\n turnId: string\n /** Deliver one serialized line to the live client. Throwing here (client\n * disconnected) does NOT stop buffering — events keep persisting. */\n write?: (line: string) => Promise<void> | void\n /** Flush buffered events to the store at most this often. Default 400ms. */\n flushIntervalMs?: number\n /** Flush window once a durable owner has taken the turn ({@link BufferedTurnTap.detach}). Live-progress events\n * wait for it; any other event flushes at once, after them. Default 2000ms. */\n detachedFlushIntervalMs?: number\n /** Per-flush coalescer. Default {@link coalesceDeltas} (tool-loop text/reasoning\n * deltas). agent-runtime products streaming `ChatStreamEvent` pass\n * {@link coalesceChatStreamEvents} so per-token deltas don't each persist as a\n * row. Must be concatenation-preserving. */\n coalesce?: (events: unknown[]) => unknown[]\n /** Optional scope (thread/session id) recorded with the turn status, so\n * {@link TurnEventStore.listRunning} can find this turn after a reload. */\n scopeId?: string\n /** How often to renew the running-turn lease while a producer is alive.\n * The timer is backed up by event-driven renewal when a runtime freezes\n * unreferenced timers during remote I/O. Default\n * {@link DEFAULT_RUNNING_TURN_RENEW_INTERVAL_MS}. */\n runningTurnRenewIntervalMs?: number\n}\n\n/** A push-driven buffer for a turn whose producer the caller does NOT own. */\nexport interface BufferedTurnTap {\n /** Buffer one event: persist (coalesced, on the flush window) + best-effort\n * live-deliver. Wire to a push source's per-event hook (e.g. agent-runtime\n * `handleChatTurn`'s `hooks.onEvent`). Marks the turn 'running' on first call. */\n onEvent(raw: unknown): Promise<void>\n /** Settle the turn: final flush + set status. Call after the producer resolves\n * ('complete') or rejects ('error'). 'error' flushes what was produced first. */\n done(status?: Extract<TurnStatus, 'complete' | 'error'>): Promise<void>\n /**\n * Give terminal-status ownership to an external durable runner. Stops this\n * tap's running-lease renewal and flushes its current projection, but keeps\n * `onEvent` available as an append-only live-observation path. After the\n * handoff, an event that is not live progress (a marker, interaction, tool\n * event, error or terminal event) flushes before `onEvent` returns, so a\n * durable owner cannot publish terminal status ahead of it; live progress\n * (deltas, heartbeats, raw part updates) is coalesced over\n * `detachedFlushIntervalMs`. Call it again when observation ends to flush any\n * final event.\n *\n * A caller MUST have registered that durable owner before detaching: this\n * method intentionally writes no replacement status.\n */\n detach(): Promise<void>\n}\n\n/**\n * The buffering core. Sequence-numbers every event, delivers it to `write`\n * (best-effort — a disconnected client never stops buffering), and flushes to\n * the store in coalesced batches. Drives both transports:\n *\n * • {@link pumpBufferedTurn} — when you OWN an `AsyncIterable` producer.\n * • this tap (`onEvent`/`done`) — when the producer owns iteration and only\n * hands you a push callback (agent-runtime `handleChatTurn`'s `hooks.onEvent`\n * + the finished body). Durability stays here in the shell; the engine needs\n * no `TurnEventStore` seam.\n */\n/** Serialized characters of pending events that force a flush before the window ends. */\nconst MAX_PENDING_CHARS = 64 * 1024\n\nexport function createBufferedTurnTap(opts: BufferedTurnOptions): BufferedTurnTap {\n const flushIntervalMs = opts.flushIntervalMs ?? 400\n const detachedFlushIntervalMs = opts.detachedFlushIntervalMs ?? 2000\n let pendingChars = 0\n const coalesce = opts.coalesce ?? coalesceDeltas\n const startedAt = Date.now()\n let seq = 0\n let clientGone = false\n let pending: unknown[] = []\n let lastFlush = Date.now()\n let started = false\n let settled = false\n let detached = false\n let renewalTimer: ReturnType<typeof setTimeout> | undefined\n let renewal: Promise<void> = Promise.resolve()\n let lastRenewedAt = 0\n const runningTurnRenewIntervalMs = Math.max(\n 1,\n opts.runningTurnRenewIntervalMs ?? DEFAULT_RUNNING_TURN_RENEW_INTERVAL_MS,\n )\n\n function clearRenewalTimer(): void {\n if (renewalTimer !== undefined) clearTimeout(renewalTimer)\n renewalTimer = undefined\n }\n\n function scheduleRenewal(): void {\n if (settled || detached || !opts.scopeId) return\n clearRenewalTimer()\n const elapsedMs = Math.max(0, Date.now() - lastRenewedAt)\n const delayMs = Math.max(1, runningTurnRenewIntervalMs - elapsedMs)\n renewalTimer = setTimeout(() => {\n renewalTimer = undefined\n void renewLease()\n }, delayMs)\n // A deliberately abandoned tap in a Node test must not keep the process\n // alive until the production renewal interval elapses.\n if (typeof renewalTimer === 'object' && 'unref' in renewalTimer) {\n renewalTimer.unref()\n }\n }\n\n async function renewLease(): Promise<void> {\n if (settled || detached || !opts.scopeId) return\n clearRenewalTimer()\n lastRenewedAt = Date.now()\n renewal = renewal\n .then(() => opts.store.setStatus(opts.turnId, 'running', opts.scopeId))\n .catch(() => {})\n await renewal\n scheduleRenewal()\n }\n\n async function flush(): Promise<void> {\n if (pending.length === 0) return\n const batch = coalesce(pending)\n pending = []\n pendingChars = 0\n const rows = batch.map((ev) => ({ seq: ++seq, event: JSON.stringify(ev) }))\n await opts.store.append(opts.turnId, rows)\n lastFlush = Date.now()\n }\n\n async function ensureStarted(): Promise<void> {\n if (started) return\n started = true\n // An external durable owner may have detached before the first observed\n // event. It owns status from that point, so this tap must never resurrect\n // its running lease.\n if (detached) return\n await opts.store.setStatus(opts.turnId, 'running', opts.scopeId)\n lastRenewedAt = Date.now()\n scheduleRenewal()\n }\n\n return {\n async onEvent(raw) {\n await ensureStarted()\n // Cloudflare may freeze an unreferenced timer while a producer is\n // awaiting remote I/O. A real event (including the route heartbeat)\n // therefore also renews any lease whose interval has elapsed.\n if (\n !detached &&\n opts.scopeId &&\n Date.now() - lastRenewedAt >= runningTurnRenewIntervalMs\n ) {\n await renewLease()\n }\n // Stamp ms-since-turn-start so any stored turn is replayable AND traceable\n // (see ../trace) from the same buffered rows.\n const ev = raw && typeof raw === 'object' ? { ...(raw as Record<string, unknown>), _t: Date.now() - startedAt } : raw\n const line = JSON.stringify(ev)\n pending.push(ev)\n pendingChars += line?.length ?? 0\n if (!clientGone && opts.write) {\n try {\n // Live delivery carries a provisional ordering hint, not the persisted\n // seq (coalescing changes seq assignment); clients resume with the\n // seqs from replay, or 0 for \"everything\".\n await opts.write(line)\n } catch {\n clientGone = true\n }\n }\n // Once detached, a turn marker, interaction, tool event, error or terminal event persists at once (with the\n // progress before it), and live progress waits for the window, so a reasoning model's per-token events do\n // not each become a row. An external owner's terminal status can fence at most the last window of progress.\n const due = detached\n ? !isLiveProgressEvent(ev) || Date.now() - lastFlush >= detachedFlushIntervalMs\n : Date.now() - lastFlush >= flushIntervalMs\n if (due || pendingChars >= MAX_PENDING_CHARS) await flush()\n },\n async done(status = 'complete') {\n await ensureStarted()\n if (detached) {\n await flush()\n return\n }\n settled = true\n clearRenewalTimer()\n await renewal\n if (status === 'error') {\n await flush().catch(() => {})\n await opts.store.setStatus(opts.turnId, 'error', opts.scopeId).catch(() => {})\n return\n }\n await flush()\n await opts.store.setStatus(opts.turnId, 'complete', opts.scopeId)\n },\n async detach() {\n detached = true\n clearRenewalTimer()\n // A renewal already queued before detach may be writing `running`. Wait\n // for it before returning so the durable owner can safely publish a\n // terminal status after the awaited handoff.\n await renewal\n await flush()\n },\n }\n}\n\n// ── pump (producer side) ──────────────────────────────────────────────────\n\n/** Define options to pump data from an asynchronous iterable source with buffered turn control */\nexport interface PumpBufferedTurnOptions extends BufferedTurnOptions {\n source: AsyncIterable<unknown>\n}\n\n/**\n * Drive a turn to completion regardless of the live client, when you OWN the\n * producer as an `AsyncIterable`. A thin driver over {@link createBufferedTurnTap}.\n * Returns a promise that resolves when the turn finishes — hand it to\n * `ctx.waitUntil` so a disconnect can't kill the turn. Never rejects on\n * client-write failure; a source error marks the turn 'error' (after flushing\n * what was produced) and rethrows.\n */\nexport async function pumpBufferedTurn(opts: PumpBufferedTurnOptions): Promise<void> {\n const tap = createBufferedTurnTap(opts)\n try {\n for await (const raw of opts.source) await tap.onEvent(raw)\n await tap.done('complete')\n } catch (err) {\n await tap.done('error')\n throw err\n }\n}\n\n// ── replay (consumer side) ────────────────────────────────────────────────\n\n/** Define options for replaying turn events with control over sequence, polling, and timeout */\nexport interface ReplayTurnEventsOptions {\n store: TurnEventStore\n turnId: string\n /** Replay strictly after this sequence number (0 = from the beginning). */\n fromSeq?: number\n /** Poll cadence while the turn is still running. Default 500ms. */\n pollMs?: number\n /** Give up following a 'running' turn after this long. Default 120s. */\n timeoutMs?: number\n}\n\n/**\n * Yield buffered events after `fromSeq`, then keep polling while the turn is\n * still 'running' until it completes, errors, or times out. Terminates with a\n * final `{seq: -1, event: '{\"type\":\"turn_status\",...}'}` marker so clients\n * know why the replay ended.\n */\nexport async function* replayTurnEvents(opts: ReplayTurnEventsOptions): AsyncGenerator<BufferedTurnEvent> {\n const pollMs = opts.pollMs ?? 500\n const timeoutMs = opts.timeoutMs ?? 120_000\n let cursor = opts.fromSeq ?? 0\n const deadline = Date.now() + timeoutMs\n\n for (;;) {\n const batch = await opts.store.read(opts.turnId, cursor)\n for (const row of batch) {\n cursor = Math.max(cursor, row.seq)\n yield row\n }\n const status = await opts.store.getStatus(opts.turnId)\n if (status !== 'running') {\n // Writers flush before publishing terminal status; include rows committed after the first read.\n yield* await opts.store.read(opts.turnId, cursor)\n yield { seq: -1, event: JSON.stringify({ type: 'turn_status', status: status ?? 'unknown' }) }\n return\n }\n if (Date.now() >= deadline) {\n yield { seq: -1, event: JSON.stringify({ type: 'turn_status', status: 'timeout' }) }\n return\n }\n await new Promise((r) => setTimeout(r, pollMs))\n }\n}\n\n/**\n * Serialize a replayed row for the wire, stamping the buffer ordinal ONTO the\n * line so a reconnecting client can continue from `?fromSeq=<lastSeq>`.\n *\n * The seq lives on the {@link BufferedTurnEvent} row wrapper, not inside the\n * serialized event — `flush()` builds `{seq: ++seq, event: JSON.stringify(ev)}`.\n * A route that enqueues `row.event` alone therefore emits lines with no seq at\n * all, and every client cursor silently pins to 0: each reconnect refetches the\n * whole turn and re-applies every delta onto already-rendered state. This\n * restores the contract `web-react/chat-stream` already documents (\"replayed\n * lines carry an extra `seq` — transparently ignored\").\n *\n * The `{seq: -1}` `turn_status` sentinel is passed through unstamped: it is a\n * terminator, not a cursor position, and stamping it would move a client's\n * cursor to -1.\n *\n * Fail-soft by construction — a line that is not a JSON object passes through\n * verbatim. A stamping bug must degrade to today's behaviour, never break a\n * replay.\n */\nexport function stampReplaySeq(row: BufferedTurnEvent): string {\n if (row.seq <= 0) return row.event\n const line = row.event\n // Cheap splice instead of parse+stringify: these rows are already canonical\n // JSON objects from `JSON.stringify`, and replay is a hot per-event path.\n if (line.charCodeAt(0) !== 0x7b /* { */) return line\n const rest = line.slice(1)\n return rest.trimStart().startsWith('}')\n ? `{\"seq\":${row.seq}${rest}`\n : `{\"seq\":${row.seq},${rest}`\n}\n\n// ── D1 store ──────────────────────────────────────────────────────────────\n\n/** A bound D1 statement used by the turn store. */\nexport interface D1BoundForTurns {\n run(): Promise<unknown>\n all<T = Record<string, unknown>>(): Promise<{ results: T[] }>\n first<T = Record<string, unknown>>(): Promise<T | null>\n}\n\n/** Minimal structural D1 contract (Cloudflare `D1Database` satisfies it). */\nexport interface D1LikeForTurns {\n prepare(sql: string): {\n bind(...values: unknown[]): D1BoundForTurns\n }\n /** D1's only atomic primitive. Retention refuses a driver without it rather\n * than deleting events and status in separate, reorderable requests. */\n batch?(statements: D1BoundForTurns[]): Promise<unknown[]>\n}\n\nfunction normalizeTurnCutoff(before: number | Date): { milliseconds: number; iso: string } {\n const milliseconds = before instanceof Date ? before.getTime() : before\n if (!Number.isFinite(milliseconds)) {\n throw new RangeError('turn retention cutoff must be a finite Unix-millisecond timestamp or a valid Date')\n }\n const date = new Date(milliseconds)\n if (!Number.isFinite(date.getTime())) {\n throw new RangeError('turn retention cutoff is outside the supported Date range')\n }\n return { milliseconds, iso: date.toISOString() }\n}\n\nasync function runAtomicTurnBatch(\n db: D1LikeForTurns,\n statements: D1BoundForTurns[],\n): Promise<unknown[]> {\n if (typeof db.batch !== 'function') {\n throw new Error('turn retention requires D1 batch() for atomic deletion')\n }\n return db.batch(statements)\n}\n\nfunction changesFromD1Result(result: unknown): number {\n if (!result || typeof result !== 'object') return 0\n const meta = (result as { meta?: unknown }).meta\n if (meta && typeof meta === 'object') {\n const changes = (meta as { changes?: unknown }).changes\n if (typeof changes === 'number' && Number.isFinite(changes)) return changes\n }\n const changes = (result as { changes?: unknown }).changes\n return typeof changes === 'number' && Number.isFinite(changes) ? changes : 0\n}\n\n/** Schema for the D1 store — append to the product's migrations. */\nexport const TURN_EVENTS_MIGRATION_SQL = `\nCREATE TABLE IF NOT EXISTS turn_events (\n turnId TEXT NOT NULL,\n seq INTEGER NOT NULL,\n event TEXT NOT NULL,\n PRIMARY KEY (turnId, seq)\n);\nCREATE TABLE IF NOT EXISTS turn_status (\n turnId TEXT PRIMARY KEY,\n status TEXT NOT NULL,\n scopeId TEXT,\n updatedAt TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS idx_turn_status_scope ON turn_status (scopeId, status);\nCREATE INDEX IF NOT EXISTS idx_turn_status_retention ON turn_status (status, updatedAt);\n`\n\n/** For deployments whose `turn_status` table predates `scopeId`/`listRunning` —\n * run once to add the column (the CREATE above already includes it for new\n * deployments). SQLite ignores a duplicate-add error if already applied. */\nexport const TURN_STATUS_SCOPE_MIGRATION_SQL = `ALTER TABLE turn_status ADD COLUMN scopeId TEXT;`\n\n/** Run once before using `createD1PlanFollowUpGate`: it adds the lease column\n * the gate fences its claims on. Stores that never take follow-up claims do\n * not need it, so the base turn tables leave it out. */\nexport const TURN_STATUS_LEASE_MIGRATION_SQL = 'ALTER TABLE turn_status ADD COLUMN leaseToken TEXT;'\n\n/** For deployments that already have the turn tables, add the index used by\n * terminal-turn retention without rerunning the table migration. */\nexport const TURN_STATUS_RETENTION_MIGRATION_SQL = 'CREATE INDEX IF NOT EXISTS idx_turn_status_retention ON turn_status (status, updatedAt);'\n\n/** Resolve a TurnEventStore that appends and reads turn events using a D1-like database interface */\n/** 100 D1 variables per statement, three per row. */\nconst D1_APPEND_CHUNK = 33\n\nexport function createD1TurnEventStore(\n db: D1LikeForTurns,\n options: TurnEventStoreOptions = {},\n): TurnEventStore {\n const now = options.now ?? Date.now\n const runningTurnLeaseMs = Math.max(\n 1,\n options.runningTurnLeaseMs ?? DEFAULT_RUNNING_TURN_LEASE_MS,\n )\n return {\n async append(turnId, events) {\n if (!events.length) return\n // One multi-row insert per flush window keeps write volume bounded, but\n // D1 caps a statement at 100 bound variables, so a burst of more than 33\n // events (a subagent finishing, a long tool result) failed the whole\n // flush with `D1_ERROR: too many SQL variables` and killed the turn.\n // Rows are appended in order across chunks; a partial failure leaves a\n // prefix, which the ordered `seq` column already tolerates on replay.\n for (let start = 0; start < events.length; start += D1_APPEND_CHUNK) {\n const chunk = events.slice(start, start + D1_APPEND_CHUNK)\n const placeholders = chunk.map(() => '(?, ?, ?)').join(', ')\n const values = chunk.flatMap((e) => [turnId, e.seq, e.event])\n await db\n .prepare(\n `WITH pending(turnId, seq, event) AS (VALUES ${placeholders})\n INSERT OR IGNORE INTO turn_events (turnId, seq, event)\n SELECT pending.turnId, pending.seq, pending.event\n FROM pending\n WHERE NOT EXISTS (\n SELECT 1 FROM turn_status\n WHERE turn_status.turnId = pending.turnId\n AND turn_status.status IN ('complete', 'error')\n )`,\n )\n .bind(...values)\n .run()\n }\n },\n async read(turnId, fromSeq) {\n const { results } = await db\n .prepare('SELECT seq, event FROM turn_events WHERE turnId = ? AND seq > ? ORDER BY seq ASC')\n .bind(turnId, fromSeq)\n .all<{ seq: number; event: string }>()\n return results\n },\n async setStatus(turnId, status, scopeId) {\n // COALESCE preserves a scopeId set on the initial 'running' write when a\n // later 'complete'/'error' write passes none.\n await db\n .prepare(\n 'INSERT INTO turn_status (turnId, status, scopeId, updatedAt) VALUES (?, ?, ?, ?) ON CONFLICT(turnId) DO UPDATE SET status = excluded.status, scopeId = COALESCE(excluded.scopeId, turn_status.scopeId), updatedAt = excluded.updatedAt',\n )\n .bind(turnId, status, scopeId ?? null, new Date(now()).toISOString())\n .run()\n },\n async getStatus(turnId) {\n const row = await db.prepare('SELECT status FROM turn_status WHERE turnId = ?').bind(turnId).first<{ status: TurnStatus }>()\n return row?.status ?? null\n },\n async listRunning(scopeId) {\n const { results } = await db\n .prepare(\n \"SELECT turnId FROM turn_status WHERE scopeId = ? AND status = 'running' AND updatedAt >= ? ORDER BY updatedAt DESC, rowid DESC\",\n )\n .bind(scopeId, new Date(now() - runningTurnLeaseMs).toISOString())\n .all<{ turnId: string }>()\n return results.map((r) => r.turnId)\n },\n async resetEvents(turnId) {\n await db.prepare('DELETE FROM turn_events WHERE turnId = ?').bind(turnId).run()\n },\n async deleteTurn(turnId) {\n await runAtomicTurnBatch(db, [\n db.prepare('DELETE FROM turn_events WHERE turnId = ?').bind(turnId),\n db.prepare('DELETE FROM turn_status WHERE turnId = ?').bind(turnId),\n ])\n },\n async pruneTerminalTurns(before) {\n const cutoff = normalizeTurnCutoff(before)\n const terminalBefore = \"status IN ('complete', 'error') AND updatedAt < ?\"\n const results = await runAtomicTurnBatch(db, [\n db\n .prepare(\n `DELETE FROM turn_events WHERE turnId IN (SELECT turnId FROM turn_status WHERE ${terminalBefore})`,\n )\n .bind(cutoff.iso),\n db.prepare(`DELETE FROM turn_status WHERE ${terminalBefore}`).bind(cutoff.iso),\n ])\n return changesFromD1Result(results[1])\n },\n }\n}\n\n/** In-memory store for tests and keyless local dev. */\nexport function createMemoryTurnEventStore(\n options: TurnEventStoreOptions = {},\n): TurnEventStore {\n const events = new Map<string, BufferedTurnEvent[]>()\n const status = new Map<string, TurnStatus>()\n const scopes = new Map<string, string>()\n const order: string[] = []\n const updatedAt = new Map<string, number>()\n const now = options.now ?? Date.now\n const runningTurnLeaseMs = Math.max(\n 1,\n options.runningTurnLeaseMs ?? DEFAULT_RUNNING_TURN_LEASE_MS,\n )\n return {\n async append(turnId, rows) {\n if (status.get(turnId) === 'complete' || status.get(turnId) === 'error') return\n const list = events.get(turnId) ?? []\n list.push(...rows)\n events.set(turnId, list)\n },\n async read(turnId, fromSeq) {\n return (events.get(turnId) ?? []).filter((e) => e.seq > fromSeq)\n },\n async setStatus(turnId, s, scopeId) {\n status.set(turnId, s)\n if (scopeId) scopes.set(turnId, scopeId)\n if (!order.includes(turnId)) order.push(turnId)\n updatedAt.set(turnId, now())\n },\n async getStatus(turnId) {\n return status.get(turnId) ?? null\n },\n async listRunning(scopeId) {\n const cutoff = now() - runningTurnLeaseMs\n return order\n .filter(\n (turnId) =>\n status.get(turnId) === 'running' &&\n scopes.get(turnId) === scopeId &&\n (updatedAt.get(turnId) ?? Number.NEGATIVE_INFINITY) >= cutoff,\n )\n .sort((left, right) => {\n const updatedDelta = (updatedAt.get(right) ?? 0) - (updatedAt.get(left) ?? 0)\n return updatedDelta || order.indexOf(right) - order.indexOf(left)\n })\n },\n async resetEvents(turnId) {\n events.delete(turnId)\n },\n async deleteTurn(turnId) {\n events.delete(turnId)\n status.delete(turnId)\n scopes.delete(turnId)\n updatedAt.delete(turnId)\n const index = order.indexOf(turnId)\n if (index >= 0) order.splice(index, 1)\n },\n async pruneTerminalTurns(before) {\n const cutoff = normalizeTurnCutoff(before).milliseconds\n const removable = order.filter((turnId) => {\n const s = status.get(turnId)\n return (s === 'complete' || s === 'error') && (updatedAt.get(turnId) ?? Number.POSITIVE_INFINITY) < cutoff\n })\n for (const turnId of removable) {\n events.delete(turnId)\n status.delete(turnId)\n scopes.delete(turnId)\n updatedAt.delete(turnId)\n }\n if (removable.length) {\n const removed = new Set(removable)\n for (let i = order.length - 1; i >= 0; i--) {\n if (removed.has(order[i]!)) order.splice(i, 1)\n }\n }\n return removable.length\n },\n }\n}\n"],"mappings":"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","names":["changes"]}
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
import {
|
|
2
2
|
createChatTurnRoutes,
|
|
3
3
|
streamChatRouteAsSandboxEvents
|
|
4
|
-
} from "../chunk-
|
|
5
|
-
import "../chunk-
|
|
4
|
+
} from "../chunk-P2CGXXOJ.js";
|
|
5
|
+
import "../chunk-Q7WEEN7P.js";
|
|
6
6
|
import "../chunk-UTAIRVOK.js";
|
|
7
7
|
import "../chunk-RN4WPTBH.js";
|
|
8
8
|
import "../chunk-3NCPXNBZ.js";
|
|
9
9
|
import "../chunk-YXYQ6MJL.js";
|
|
10
10
|
import "../chunk-YG66IHDU.js";
|
|
11
|
-
import "../chunk-
|
|
11
|
+
import "../chunk-X4OMULP5.js";
|
|
12
12
|
import "../chunk-WKD4E52F.js";
|
|
13
13
|
import "../chunk-6E7LKHYV.js";
|
|
14
14
|
import "../chunk-ZVEEWGDK.js";
|
package/dist/stream/index.js
CHANGED
|
@@ -21,10 +21,11 @@ import {
|
|
|
21
21
|
createBufferedTurnTap,
|
|
22
22
|
createD1TurnEventStore,
|
|
23
23
|
createMemoryTurnEventStore,
|
|
24
|
+
isLiveProgressEvent,
|
|
24
25
|
pumpBufferedTurn,
|
|
25
26
|
replayTurnEvents,
|
|
26
27
|
stampReplaySeq
|
|
27
|
-
} from "../chunk-
|
|
28
|
+
} from "../chunk-X4OMULP5.js";
|
|
28
29
|
import {
|
|
29
30
|
MISSING_TOOL_TERMINAL_ERROR,
|
|
30
31
|
MISSING_TOOL_TERMINAL_REASON,
|
|
@@ -74,6 +75,7 @@ export {
|
|
|
74
75
|
finalizeAssistantParts,
|
|
75
76
|
finalizePendingInteractionParts,
|
|
76
77
|
getPartKey,
|
|
78
|
+
isLiveProgressEvent,
|
|
77
79
|
mergePersistedPart,
|
|
78
80
|
messageHasTurnId,
|
|
79
81
|
normalizeClientTurnId,
|
|
@@ -67,9 +67,18 @@ export interface TurnEventStoreOptions {
|
|
|
67
67
|
runningTurnLeaseMs?: number;
|
|
68
68
|
now?: () => number;
|
|
69
69
|
}
|
|
70
|
-
/**
|
|
71
|
-
|
|
72
|
-
|
|
70
|
+
/** Whether an event only projects live progress, so it may wait for the flush window and be coalesced. */
|
|
71
|
+
export declare function isLiveProgressEvent(ev: unknown): boolean;
|
|
72
|
+
/**
|
|
73
|
+
* Merge text and reasoning deltas of the same type into one event, across the
|
|
74
|
+
* live-state events a harness interleaves with them, and keep only the latest
|
|
75
|
+
* of each live-state event. A reasoning model streams three events per token
|
|
76
|
+
* (its raw part update, a model-processing heartbeat and the delta); merging
|
|
77
|
+
* only adjacent deltas wrote all three as rows (2026-10-10: 1.63 M rows in a
|
|
78
|
+
* day, 59,659 in one turn). Any other event is a boundary nothing merges
|
|
79
|
+
* across. Concatenation-preserving: replaying the coalesced stream produces
|
|
80
|
+
* the same accumulated text, and the latest state of every part.
|
|
81
|
+
*/
|
|
73
82
|
export declare function coalesceDeltas(events: unknown[]): unknown[];
|
|
74
83
|
/**
|
|
75
84
|
* Coalesce consecutive `message.part.updated` deltas for the SAME part into one
|
|
@@ -95,6 +104,9 @@ export interface BufferedTurnOptions {
|
|
|
95
104
|
write?: (line: string) => Promise<void> | void;
|
|
96
105
|
/** Flush buffered events to the store at most this often. Default 400ms. */
|
|
97
106
|
flushIntervalMs?: number;
|
|
107
|
+
/** Flush window once a durable owner has taken the turn ({@link BufferedTurnTap.detach}). Live-progress events
|
|
108
|
+
* wait for it; any other event flushes at once, after them. Default 2000ms. */
|
|
109
|
+
detachedFlushIntervalMs?: number;
|
|
98
110
|
/** Per-flush coalescer. Default {@link coalesceDeltas} (tool-loop text/reasoning
|
|
99
111
|
* deltas). agent-runtime products streaming `ChatStreamEvent` pass
|
|
100
112
|
* {@link coalesceChatStreamEvents} so per-token deltas don't each persist as a
|
|
@@ -121,27 +133,19 @@ export interface BufferedTurnTap {
|
|
|
121
133
|
/**
|
|
122
134
|
* Give terminal-status ownership to an external durable runner. Stops this
|
|
123
135
|
* tap's running-lease renewal and flushes its current projection, but keeps
|
|
124
|
-
* `onEvent` available as an append-only live-observation path.
|
|
125
|
-
*
|
|
126
|
-
*
|
|
127
|
-
*
|
|
136
|
+
* `onEvent` available as an append-only live-observation path. After the
|
|
137
|
+
* handoff, an event that is not live progress (a marker, interaction, tool
|
|
138
|
+
* event, error or terminal event) flushes before `onEvent` returns, so a
|
|
139
|
+
* durable owner cannot publish terminal status ahead of it; live progress
|
|
140
|
+
* (deltas, heartbeats, raw part updates) is coalesced over
|
|
141
|
+
* `detachedFlushIntervalMs`. Call it again when observation ends to flush any
|
|
142
|
+
* final event.
|
|
128
143
|
*
|
|
129
144
|
* A caller MUST have registered that durable owner before detaching: this
|
|
130
145
|
* method intentionally writes no replacement status.
|
|
131
146
|
*/
|
|
132
147
|
detach(): Promise<void>;
|
|
133
148
|
}
|
|
134
|
-
/**
|
|
135
|
-
* The buffering core. Sequence-numbers every event, delivers it to `write`
|
|
136
|
-
* (best-effort — a disconnected client never stops buffering), and flushes to
|
|
137
|
-
* the store in coalesced batches. Drives both transports:
|
|
138
|
-
*
|
|
139
|
-
* • {@link pumpBufferedTurn} — when you OWN an `AsyncIterable` producer.
|
|
140
|
-
* • this tap (`onEvent`/`done`) — when the producer owns iteration and only
|
|
141
|
-
* hands you a push callback (agent-runtime `handleChatTurn`'s `hooks.onEvent`
|
|
142
|
-
* + the finished body). Durability stays here in the shell; the engine needs
|
|
143
|
-
* no `TurnEventStore` seam.
|
|
144
|
-
*/
|
|
145
149
|
export declare function createBufferedTurnTap(opts: BufferedTurnOptions): BufferedTurnTap;
|
|
146
150
|
/** Define options to pump data from an asynchronous iterable source with buffered turn control */
|
|
147
151
|
export interface PumpBufferedTurnOptions extends BufferedTurnOptions {
|
package/package.json
CHANGED