@tangle-network/agent-app 0.63.1 → 0.63.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.
Files changed (39) hide show
  1. package/dist/agent-profiles/d1.js +3 -3
  2. package/dist/agent-profiles/index.js +3 -3
  3. package/dist/chat-routes/index.d.ts +1 -0
  4. package/dist/chat-routes/index.js +15 -15
  5. package/dist/chat-routes/route-storage.d.ts +21 -1
  6. package/dist/chat-routes/turn-route-contracts.d.ts +2 -9
  7. package/dist/{chunk-A2NQMVMF.js → chunk-464WRGJ3.js} +14 -5
  8. package/dist/chunk-464WRGJ3.js.map +1 -0
  9. package/dist/{chunk-XEAZWJ3W.js → chunk-7Y7U7U7X.js} +2 -2
  10. package/dist/{chunk-5BJHKQ33.js → chunk-ACB7KOQ6.js} +4 -4
  11. package/dist/{chunk-7TZA2TAM.js → chunk-FCYHDENJ.js} +2 -2
  12. package/dist/{chunk-WSQFNMIA.js → chunk-HRBF4B5L.js} +5 -5
  13. package/dist/{chunk-WSQFNMIA.js.map → chunk-HRBF4B5L.js.map} +1 -1
  14. package/dist/{chunk-SRWQCWLR.js → chunk-IX6UVHXY.js} +3 -3
  15. package/dist/{chunk-MM3GOLHO.js → chunk-PGWKYLHC.js} +11 -25
  16. package/dist/chunk-PGWKYLHC.js.map +1 -0
  17. package/dist/{chunk-ND5XWLRU.js → chunk-POIVNKYH.js} +83 -24
  18. package/dist/chunk-POIVNKYH.js.map +1 -0
  19. package/dist/preset-cloudflare/index.js +8 -8
  20. package/dist/public-consultation/index.js +8 -8
  21. package/dist/rollout/d1.d.ts +24 -3
  22. package/dist/rollout/d1.js +46 -24
  23. package/dist/rollout/d1.js.map +1 -1
  24. package/dist/sandbox/index.js +7 -5
  25. package/dist/sandbox/prewarm-route.d.ts +7 -0
  26. package/dist/stream/index.js +17 -17
  27. package/dist/tools/index.js +4 -4
  28. package/dist/turn-stream/adapters.d.ts +6 -0
  29. package/dist/turn-stream/index.js +3 -1
  30. package/dist/turn-stream/index.js.map +1 -1
  31. package/dist/work-product/index.js +2 -2
  32. package/package.json +3 -2
  33. package/dist/chunk-A2NQMVMF.js.map +0 -1
  34. package/dist/chunk-MM3GOLHO.js.map +0 -1
  35. package/dist/chunk-ND5XWLRU.js.map +0 -1
  36. /package/dist/{chunk-XEAZWJ3W.js.map → chunk-7Y7U7U7X.js.map} +0 -0
  37. /package/dist/{chunk-5BJHKQ33.js.map → chunk-ACB7KOQ6.js.map} +0 -0
  38. /package/dist/{chunk-7TZA2TAM.js.map → chunk-FCYHDENJ.js.map} +0 -0
  39. /package/dist/{chunk-SRWQCWLR.js.map → chunk-IX6UVHXY.js.map} +0 -0
@@ -15,12 +15,6 @@ import {
15
15
  } from "../chunk-N6URQ6DM.js";
16
16
  import "../chunk-Z4RD5UF7.js";
17
17
  import "../chunk-YG66IHDU.js";
18
- import {
19
- releaseDurableTurnLock
20
- } from "../chunk-A2NQMVMF.js";
21
- import {
22
- createD1TurnEventStore
23
- } from "../chunk-ISP6ZH3G.js";
24
18
  import "../chunk-RZLCBWGG.js";
25
19
  import "../chunk-ZVEEWGDK.js";
26
20
  import "../chunk-5TSRFF5W.js";
@@ -32,11 +26,17 @@ import {
32
26
  classifySandboxTransientFailure,
33
27
  sandboxTransientBackoffMs
34
28
  } from "../chunk-PK65B6HP.js";
29
+ import {
30
+ releaseDurableTurnLock
31
+ } from "../chunk-464WRGJ3.js";
32
+ import {
33
+ createD1TurnEventStore
34
+ } from "../chunk-ISP6ZH3G.js";
35
35
  import {
36
36
  parseRenderUiSchema
37
- } from "../chunk-XEAZWJ3W.js";
37
+ } from "../chunk-7Y7U7U7X.js";
38
38
  import "../chunk-S5SRJJQG.js";
39
- import "../chunk-WSQFNMIA.js";
39
+ import "../chunk-HRBF4B5L.js";
40
40
  import {
41
41
  createTurnTrace
42
42
  } from "../chunk-AVBNS64P.js";
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  createChatTurnRoutes,
3
3
  streamChatRouteAsSandboxEvents
4
- } from "../chunk-MM3GOLHO.js";
4
+ } from "../chunk-PGWKYLHC.js";
5
5
  import "../chunk-KH4QSBNI.js";
6
6
  import "../chunk-CQGEGPY7.js";
7
7
  import "../chunk-RN4WPTBH.js";
@@ -9,30 +9,30 @@ import "../chunk-WP2GYFZ4.js";
9
9
  import "../chunk-4DBHC63F.js";
10
10
  import "../chunk-MH74DY2I.js";
11
11
  import "../chunk-MM6RLOXF.js";
12
- import "../chunk-ND5XWLRU.js";
12
+ import "../chunk-POIVNKYH.js";
13
13
  import "../chunk-F4TUZYMX.js";
14
14
  import "../chunk-N6URQ6DM.js";
15
15
  import "../chunk-Z4RD5UF7.js";
16
16
  import "../chunk-YG66IHDU.js";
17
- import "../chunk-A2NQMVMF.js";
18
- import "../chunk-ISP6ZH3G.js";
19
17
  import "../chunk-RZLCBWGG.js";
20
18
  import "../chunk-ZVEEWGDK.js";
21
19
  import "../chunk-5TSRFF5W.js";
22
20
  import "../chunk-VUBJZEZB.js";
23
21
  import "../chunk-6VQCFJWP.js";
24
22
  import "../chunk-PK65B6HP.js";
23
+ import "../chunk-464WRGJ3.js";
24
+ import "../chunk-ISP6ZH3G.js";
25
25
  import "../chunk-ZLX4BA27.js";
26
26
  import "../chunk-XELWWXJJ.js";
27
27
  import "../chunk-DSMGS4IV.js";
28
- import "../chunk-5BJHKQ33.js";
28
+ import "../chunk-ACB7KOQ6.js";
29
29
  import "../chunk-6A7MYOUI.js";
30
30
  import "../chunk-O7UX55EU.js";
31
- import "../chunk-XEAZWJ3W.js";
31
+ import "../chunk-7Y7U7U7X.js";
32
32
  import "../chunk-S5SRJJQG.js";
33
- import "../chunk-7TZA2TAM.js";
33
+ import "../chunk-FCYHDENJ.js";
34
34
  import "../chunk-UGWQLQDS.js";
35
- import "../chunk-WSQFNMIA.js";
35
+ import "../chunk-HRBF4B5L.js";
36
36
  import "../chunk-IDG2XR5O.js";
37
37
  import "../chunk-D6UJEOZQ.js";
38
38
  import "../chunk-AVBNS64P.js";
@@ -30,7 +30,9 @@ export interface D1LikeForRollout {
30
30
  };
31
31
  };
32
32
  }
33
- export declare const ROLLOUT_TURN_TIMING_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS rollout_turn_timing (\n turn_id TEXT PRIMARY KEY,\n rollout TEXT NOT NULL,\n workspace_id TEXT NOT NULL,\n lane TEXT NOT NULL,\n admission_ms INTEGER,\n request_received_at INTEGER,\n model TEXT,\n revision TEXT,\n arm TEXT,\n variant TEXT,\n first_visible_ms INTEGER,\n first_text_ms INTEGER,\n settled_ms INTEGER NOT NULL,\n failed INTEGER NOT NULL CHECK (failed IN (0, 1)),\n failure_code TEXT,\n at INTEGER NOT NULL\n);\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane ON rollout_turn_timing (rollout, lane, at);\n";
33
+ /** Apply through the product migration runner after request_received_at exists. Safe to apply again. */
34
+ export declare const ROLLOUT_TURN_TIMING_REQUEST_WINDOW_INDEX_MIGRATION_SQL = "\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_request_origin ON rollout_turn_timing (rollout, request_received_at, at);\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane_request_origin ON rollout_turn_timing (rollout, lane, request_received_at, at);\n";
35
+ export declare const ROLLOUT_TURN_TIMING_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS rollout_turn_timing (\n turn_id TEXT PRIMARY KEY,\n rollout TEXT NOT NULL,\n workspace_id TEXT NOT NULL,\n lane TEXT NOT NULL,\n admission_ms INTEGER,\n request_received_at INTEGER,\n model TEXT,\n revision TEXT,\n arm TEXT,\n variant TEXT,\n first_visible_ms INTEGER,\n first_text_ms INTEGER,\n settled_ms INTEGER NOT NULL,\n failed INTEGER NOT NULL CHECK (failed IN (0, 1)),\n failure_code TEXT,\n at INTEGER NOT NULL\n);\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane ON rollout_turn_timing (rollout, lane, at);\n\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_request_origin ON rollout_turn_timing (rollout, request_received_at, at);\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane_request_origin ON rollout_turn_timing (rollout, lane, request_received_at, at);\n\n";
34
36
  /** Apply once through the product migration runner to existing tables; historical rows stay NULL. */
35
37
  export declare const ROLLOUT_TURN_TIMING_FIRST_VISIBLE_MIGRATION_SQL = "ALTER TABLE rollout_turn_timing ADD COLUMN first_visible_ms INTEGER;";
36
38
  /** Apply once through the product migration runner; old rows remain unknown. */
@@ -97,7 +99,8 @@ export declare function createD1TurnTimingStore(options: {
97
99
  * Exact origin and stream identity must agree; old NULL origins cannot be guessed. Throws so durable owners retry. */
98
100
  recordFacts(facts: NativeTurnTimingFacts): Promise<void>;
99
101
  /** Request-origin ruler, separate from the rollout stage's relative latencies and missing-word failure rule.
100
- * Unknown facts stay in the denominator. Newest rows are bounded explicitly and truncation is reported. */
102
+ * Known origins select the request window; missing observations stay in that denominator. Unknown origins
103
+ * are unassigned and reported separately by settlement window. Limits bound returned rows, not index reads. */
101
104
  measureRequestOrigin(input: {
102
105
  rollout: string;
103
106
  lane?: string;
@@ -145,11 +148,29 @@ export declare function createD1TurnTimingStore(options: {
145
148
  rollout: string;
146
149
  lane: string | null;
147
150
  revision: string | null;
148
- clock: string;
149
151
  limit: number;
150
152
  filtered: boolean;
153
+ clock: string;
151
154
  };
152
155
  population: string;
156
+ unassignedOrigins: {
157
+ samples: number;
158
+ failed: number;
159
+ truncated: boolean;
160
+ selection: {
161
+ rollout: string;
162
+ lane: string | null;
163
+ revision: string | null;
164
+ limit: number;
165
+ filtered: boolean;
166
+ clock: string;
167
+ };
168
+ window: {
169
+ from: string;
170
+ to: string;
171
+ };
172
+ population: string;
173
+ };
153
174
  source: string;
154
175
  window: {
155
176
  from: string;
@@ -9,6 +9,10 @@ import {
9
9
  import "../chunk-MH74DY2I.js";
10
10
 
11
11
  // src/rollout/d1.ts
12
+ var ROLLOUT_TURN_TIMING_REQUEST_WINDOW_INDEX_MIGRATION_SQL = `
13
+ CREATE INDEX IF NOT EXISTS rollout_turn_timing_by_request_origin ON rollout_turn_timing (rollout, request_received_at, at);
14
+ CREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane_request_origin ON rollout_turn_timing (rollout, lane, request_received_at, at);
15
+ `;
12
16
  var ROLLOUT_TURN_TIMING_SCHEMA_SQL = `
13
17
  CREATE TABLE IF NOT EXISTS rollout_turn_timing (
14
18
  turn_id TEXT PRIMARY KEY,
@@ -29,6 +33,7 @@ CREATE TABLE IF NOT EXISTS rollout_turn_timing (
29
33
  at INTEGER NOT NULL
30
34
  );
31
35
  CREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane ON rollout_turn_timing (rollout, lane, at);
36
+ ${ROLLOUT_TURN_TIMING_REQUEST_WINDOW_INDEX_MIGRATION_SQL}
32
37
  `;
33
38
  var ROLLOUT_TURN_TIMING_FIRST_VISIBLE_MIGRATION_SQL = `ALTER TABLE rollout_turn_timing ADD COLUMN first_visible_ms INTEGER;`;
34
39
  var ROLLOUT_TURN_TIMING_RULER_MIGRATION_SQL = `
@@ -170,25 +175,27 @@ function createD1TurnTimingStore(options) {
170
175
  ).run();
171
176
  },
172
177
  /** Request-origin ruler, separate from the rollout stage's relative latencies and missing-word failure rule.
173
- * Unknown facts stay in the denominator. Newest rows are bounded explicitly and truncation is reported. */
178
+ * Known origins select the request window; missing observations stay in that denominator. Unknown origins
179
+ * are unassigned and reported separately by settlement window. Limits bound returned rows, not index reads. */
174
180
  async measureRequestOrigin(input) {
175
181
  const until = input.until ?? now();
182
+ const filters = ["rollout = ?"];
183
+ const bindings = [input.rollout];
184
+ if (input.lane !== void 0) {
185
+ filters.push("lane = ?");
186
+ bindings.push(input.lane);
187
+ }
188
+ if (input.revision === null) filters.push("(revision IS NULL OR revision = '')");
189
+ else if (input.revision !== void 0) {
190
+ filters.push("revision = ?");
191
+ bindings.push(input.revision);
192
+ }
193
+ const selected = filters.join(" AND ");
176
194
  const { results = [] } = await options.db.prepare(
177
195
  `SELECT turn_id, request_received_at, admission_ms, first_visible_ms, first_text_ms, model, lane, revision, failed FROM rollout_turn_timing
178
- WHERE rollout = ? AND (? IS NULL OR lane = ?) AND at >= ? AND at < ?
179
- AND (? = 0 OR (? IS NULL AND (revision IS NULL OR revision = '')) OR revision = ?)
180
- ORDER BY at DESC LIMIT ?`
181
- ).bind(
182
- input.rollout,
183
- input.lane ?? null,
184
- input.lane ?? null,
185
- input.since,
186
- until,
187
- input.revision === void 0 ? 0 : 1,
188
- input.revision ?? null,
189
- input.revision ?? null,
190
- MEASURE_ROW_LIMIT + 1
191
- ).all();
196
+ WHERE ${selected} AND request_received_at >= ? AND request_received_at < ?
197
+ ORDER BY request_received_at DESC LIMIT ?`
198
+ ).bind(...bindings, input.since, until, MEASURE_ROW_LIMIT + 1).all();
192
199
  const rows = results.slice(0, MEASURE_ROW_LIMIT);
193
200
  const storedCoverage = timingCoverage(rows);
194
201
  const missingTiming = () => rows.filter((row) => row.admission_ms == null || row.first_visible_ms == null || row.first_text_ms == null);
@@ -229,6 +236,19 @@ function createD1TurnTimingStore(options) {
229
236
  const visible = rows.flatMap((row) => row.admission_ms == null || row.first_visible_ms == null ? [] : [row.admission_ms + row.first_visible_ms]).sort((a, b) => a - b);
230
237
  const failed = rows.filter((row) => row.failed === 1).length;
231
238
  const coverage = timingCoverage(rows);
239
+ const { results: unassigned = [] } = await options.db.prepare(
240
+ `SELECT failed FROM rollout_turn_timing WHERE ${selected} AND request_received_at IS NULL AND at >= ? AND at < ?
241
+ ORDER BY at DESC LIMIT ?`
242
+ ).bind(...bindings, input.since, until, MEASURE_ROW_LIMIT + 1).all();
243
+ const unassignedRows = unassigned.slice(0, MEASURE_ROW_LIMIT);
244
+ const selection = {
245
+ rollout: input.rollout,
246
+ lane: input.lane ?? null,
247
+ revision: input.revision === void 0 ? "all" : input.revision,
248
+ limit: MEASURE_ROW_LIMIT,
249
+ filtered: input.lane !== void 0 || input.revision !== void 0
250
+ };
251
+ const window = { from: new Date(input.since).toISOString(), to: new Date(until).toISOString() };
232
252
  return {
233
253
  samples: rows.length,
234
254
  failed,
@@ -240,17 +260,18 @@ function createD1TurnTimingStore(options) {
240
260
  unknownCoverage: Object.fromEntries(Object.entries(coverage).map(([key, count]) => [key, rows.length - count])),
241
261
  truncated: results.length > MEASURE_ROW_LIMIT,
242
262
  observedFacts,
243
- selection: {
244
- rollout: input.rollout,
245
- lane: input.lane ?? null,
246
- revision: input.revision === void 0 ? "all" : input.revision,
247
- clock: "settled-at",
248
- limit: MEASURE_ROW_LIMIT,
249
- filtered: input.lane !== void 0 || input.revision !== void 0
263
+ selection: { ...selection, clock: "request-received-at" },
264
+ population: "Persisted terminal timing rows with known request origins in the request window; excludes pre-admission, missing-persistence and unassigned-origin attempts.",
265
+ unassignedOrigins: {
266
+ samples: unassignedRows.length,
267
+ failed: unassignedRows.filter((row) => row.failed === 1).length,
268
+ truncated: unassigned.length > MEASURE_ROW_LIMIT,
269
+ selection: { ...selection, clock: "settled-at" },
270
+ window,
271
+ population: "Persisted terminal timing rows with unknown request origins settled in this window; cannot be assigned to the request-window denominator."
250
272
  },
251
- population: "Persisted terminal timing rows in the selection; excludes pre-admission and missing-persistence attempts.",
252
273
  source: `rollout_turn_timing lane=${input.lane ?? "all"}`,
253
- window: { from: new Date(input.since).toISOString(), to: new Date(until).toISOString() }
274
+ window
254
275
  };
255
276
  },
256
277
  /** Record settled chat outcomes without a product timing/serialization adapter. Read revision at settlement. */
@@ -299,6 +320,7 @@ function createD1TurnTimingStore(options) {
299
320
  export {
300
321
  ROLLOUT_TURN_TIMING_FIRST_VISIBLE_MIGRATION_SQL,
301
322
  ROLLOUT_TURN_TIMING_REQUEST_ORIGIN_MIGRATION_SQL,
323
+ ROLLOUT_TURN_TIMING_REQUEST_WINDOW_INDEX_MIGRATION_SQL,
302
324
  ROLLOUT_TURN_TIMING_RULER_MIGRATION_SQL,
303
325
  ROLLOUT_TURN_TIMING_SCHEMA_SQL,
304
326
  ROLLOUT_TURN_TIMING_VARIANT_MIGRATION_SQL,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/rollout/d1.ts"],"sourcesContent":["/**\n * The measurement a rollout guard reads: one row per turn with its lane, its\n * first visible word and whether it failed, and the stage numbers computed\n * from those rows.\n *\n * Record from the chat route's lifecycle (`onTurnComplete` / `onTurnError`\n * carry `firstVisibleMs`, `firstTextMs` and `durationMs`), then serve `measureStage` behind an\n * operator endpoint that the deploy's `rollout.config.mjs` calls. A stage is\n * measured on the turns of the workspaces it admits, in the lane being rolled\n * out, since the time it went live.\n *\n * By default `record` fills what the product's row leaves out from what the chat route measured for the same\n * `turnId` (its `turnStreamId`): `admissionMs`, `firstVisibleMs`, `firstTextMs`, the served `model` and readable failure, on every\n * lane. It writes only the columns the table has (read once per isolate with `PRAGMA table_info`), so a table that\n * predates a migration keeps recording the columns it has instead of losing the row. `revision`, `arm` and\n * `variant` are the product's and are written when the row carries them. Pass `measuredFacts: false` to write\n * only the row's own values.\n */\nimport { measuredTurnFacts, nativeTimingObservationValues, readableTurnFailure, type NativeTurnTimingFacts } from '../turn-trace/turn-facts'\nimport type { ChatTurnLifecycle, ChatTurnLifecycleComplete, ChatTurnLifecycleError } from '../chat-routes/turn-route-contracts'\nimport { rolloutAdmits, type RolloutStage, type StageMeasurement } from './index'\n\n/** Minimal D1 surface (Cloudflare's `D1Database` satisfies it). */\nexport interface D1LikeForRollout {\n prepare(sql: string): {\n bind(...values: unknown[]): {\n run(): Promise<unknown>\n all<T = Record<string, unknown>>(): Promise<{ results?: T[] }>\n }\n }\n}\n\nexport const ROLLOUT_TURN_TIMING_SCHEMA_SQL = `\nCREATE TABLE IF NOT EXISTS rollout_turn_timing (\n turn_id TEXT PRIMARY KEY,\n rollout TEXT NOT NULL,\n workspace_id TEXT NOT NULL,\n lane TEXT NOT NULL,\n admission_ms INTEGER,\n request_received_at INTEGER,\n model TEXT,\n revision TEXT,\n arm TEXT,\n variant TEXT,\n first_visible_ms INTEGER,\n first_text_ms INTEGER,\n settled_ms INTEGER NOT NULL,\n failed INTEGER NOT NULL CHECK (failed IN (0, 1)),\n failure_code TEXT,\n at INTEGER NOT NULL\n);\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane ON rollout_turn_timing (rollout, lane, at);\n`\n\n/** Apply once through the product migration runner to existing tables; historical rows stay NULL. */\nexport const ROLLOUT_TURN_TIMING_FIRST_VISIBLE_MIGRATION_SQL =\n `ALTER TABLE rollout_turn_timing ADD COLUMN first_visible_ms INTEGER;`\n\n/** Apply once through the product migration runner; old rows remain unknown. */\nexport const ROLLOUT_TURN_TIMING_RULER_MIGRATION_SQL = `\nALTER TABLE rollout_turn_timing ADD COLUMN admission_ms INTEGER;\nALTER TABLE rollout_turn_timing ADD COLUMN model TEXT;\nALTER TABLE rollout_turn_timing ADD COLUMN revision TEXT;\nALTER TABLE rollout_turn_timing ADD COLUMN arm TEXT;\n`\n\n/** Apply once through the product migration runner before any row carries `variant`; old rows stay NULL. */\nexport const ROLLOUT_TURN_TIMING_VARIANT_MIGRATION_SQL =\n `ALTER TABLE rollout_turn_timing ADD COLUMN variant TEXT;`\n\n/** Additive upgrade for a table created before durable native timing transfer. Historical origins remain NULL. */\nexport const ROLLOUT_TURN_TIMING_REQUEST_ORIGIN_MIGRATION_SQL =\n `ALTER TABLE rollout_turn_timing ADD COLUMN request_received_at INTEGER;`\n\nexport interface TurnTimingRow {\n /** Original route trace epoch, used to prevent facts from a different attempt merging into this row. */\n requestReceivedAt?: number\n /** Request receipt to lifecycle start, before the existing relative durations. */\n admissionMs?: number\n model?: string\n revision?: string\n /** The rollout cohort arm (`assignRolloutArm`, or a synthetic cohort's label). Guards filter on it. */\n arm?: string\n /** The turn's experiment assignments, apart from `arm` so an experiment never changes the cohort a guard reads,\n * e.g. `billing_in_gate=1;prompt_prefix=0`. Written only when set, so a table without the column keeps recording. */\n variant?: string\n turnId: string\n /** The plan this turn counts toward, e.g. `hospitality-routed-chat`. */\n rollout: string\n workspaceId: string\n /** The lane that served the turn, e.g. `routed` or `sandbox`. Only the rolled-out lane is measured. */\n lane: string\n /** From the lifecycle's `firstTextMs`; absent when no word streamed. */\n firstTextMs?: number\n /** From the lifecycle firstVisibleMs; absent when no reasoning, tool or answer streamed. */\n firstVisibleMs?: number\n settledMs: number\n failed: boolean\n /** Defaults to the route's terminal code and redacted explanation. Empty or object-coerced strings use that evidence too. */\n failureCode?: string\n /** Epoch ms; defaults to now. */\n at?: number\n}\n\n/** Rows read for one measurement; a stage needing more than this would be measured on its newest rows. */\nconst MEASURE_ROW_LIMIT = 20_000\n\nfunction percentile(sorted: readonly number[], p: number): number | null {\n if (!sorted.length) return null\n return sorted[Math.min(sorted.length - 1, Math.ceil((p / 100) * sorted.length) - 1)]!\n}\n\n/** Stage metrics from turn rows: first-words and settled percentiles in ms, and the failure rate. */\nexport function stageMetrics(rows: ReadonlyArray<Pick<TurnTimingRow, 'firstVisibleMs' | 'firstTextMs' | 'settledMs' | 'failed'>>) {\n const firstVisible = rows.flatMap(row => row.firstVisibleMs == null ? [] : [row.firstVisibleMs]).sort((a, b) => a - b)\n const firstWords = rows.flatMap(row => row.firstTextMs === undefined || row.firstTextMs === null ? [] : [row.firstTextMs]).sort((a, b) => a - b)\n const settled = rows.filter(row => !row.failed).map(row => row.settledMs).sort((a, b) => a - b)\n return {\n first_visible_p50_ms: percentile(firstVisible, 50),\n first_visible_p90_ms: percentile(firstVisible, 90),\n first_words_p50_ms: percentile(firstWords, 50),\n first_words_p90_ms: percentile(firstWords, 90),\n settled_p50_ms: percentile(settled, 50),\n settled_p90_ms: percentile(settled, 90),\n // A turn that streamed no word failed the user whatever its envelope said.\n failure_rate: rows.length ? rows.filter(row => row.failed || row.firstTextMs === undefined || row.firstTextMs === null).length / rows.length : null,\n }\n}\n\ninterface TimingObservationRow {\n admission_ms: number | null; first_visible_ms: number | null; first_text_ms: number | null\n model: string | null; lane: string | null; revision: string | null\n}\n\nfunction timingCoverage(rows: readonly TimingObservationRow[]) {\n const known = (value: string | null) => Boolean(value?.trim()) && value !== 'unknown'\n return {\n admission: rows.filter(row => row.admission_ms != null).length,\n firstVisible: rows.filter(row => row.first_visible_ms != null).length,\n firstText: rows.filter(row => row.first_text_ms != null).length,\n requestOriginFirstVisible: rows.filter(row => row.admission_ms != null && row.first_visible_ms != null).length,\n model: rows.filter(row => known(row.model)).length,\n lane: rows.filter(row => known(row.lane)).length,\n revision: rows.filter(row => known(row.revision)).length,\n }\n}\n\n/** Columns `record` writes, in order; `variant` and the ruler columns arrived by migration. */\nconst RECORD_COLUMNS = ['turn_id', 'rollout', 'workspace_id', 'lane', 'first_visible_ms', 'first_text_ms', 'settled_ms', 'failed',\n 'failure_code', 'at', 'admission_ms', 'request_received_at', 'model', 'revision', 'arm', 'variant'] as const\ntype RecordColumn = typeof RECORD_COLUMNS[number]\n\n/** The table's columns per database binding, read once per isolate; `null` when they could not be read. */\nconst tableColumns = new WeakMap<object, Promise<ReadonlySet<string> | null>>()\n\nfunction readColumns(db: D1LikeForRollout, refresh: boolean): Promise<ReadonlySet<string> | null> {\n const cached = tableColumns.get(db)\n if (cached && !refresh) return cached\n const read = Promise.resolve().then(() => db.prepare('PRAGMA table_info(rollout_turn_timing)').bind().all<{ name: string }>())\n .then(({ results = [] }) => results.length ? new Set(results.map(column => column.name)) : null, () => null)\n tableColumns.set(db, read)\n return read\n}\n\nfunction roundOrNull(value: number | undefined): number | null {\n return value === undefined ? null : Math.round(value)\n}\n\nexport function createD1TurnTimingStore(options: {\n db: D1LikeForRollout\n now?: () => number\n /** Fill omitted timing and model from the chat route's measurement of the same turn. Default true. */\n measuredFacts?: boolean\n /** Read missing observations from the existing native admission owner. Bound and index the selected identity batches. */\n readObservedFacts?(turns: readonly { turnStreamId: string; requestReceivedAt: number }[]): Promise<readonly NativeTurnTimingFacts[]>\n}) {\n const now = options.now ?? Date.now\n const store = {\n /** Record one settled turn. Idempotent on `turnId`. Default never throws; durable owners opt into retryable writes with throwOnError. */\n async record(row: TurnTimingRow, write?: { throwOnError?: boolean }): Promise<void> {\n try {\n // Read before any await: the facts belong to the request that is settling this turn.\n const measured = options.measuredFacts === false ? undefined : measuredTurnFacts(row.turnId)\n const productFailure = row.failureCode?.trim()\n const values: Record<RecordColumn, unknown> = {\n turn_id: row.turnId, rollout: row.rollout, workspace_id: row.workspaceId, lane: row.lane,\n first_visible_ms: roundOrNull(row.firstVisibleMs ?? measured?.firstVisibleMs),\n first_text_ms: roundOrNull(row.firstTextMs ?? measured?.firstTextMs),\n settled_ms: Math.round(row.settledMs), failed: row.failed ? 1 : 0,\n failure_code: productFailure && productFailure !== '[object Object]'\n ? row.failureCode : measured?.failureCode ?? row.failureCode ?? null,\n at: row.at ?? now(), admission_ms: roundOrNull(row.admissionMs ?? measured?.admissionMs),\n request_received_at: row.requestReceivedAt ?? measured?.requestReceivedAt ?? null,\n model: row.model ?? measured?.model ?? null, revision: row.revision ?? null, arm: row.arm ?? null,\n variant: row.variant ?? null,\n }\n let columns = await readColumns(options.db, false)\n // A value the product passed whose column is unknown: the table may have migrated since the read.\n const explicit: Partial<Record<RecordColumn, unknown>> = { first_visible_ms: row.firstVisibleMs,\n admission_ms: row.admissionMs, request_received_at: row.requestReceivedAt, model: row.model, revision: row.revision, arm: row.arm, variant: row.variant }\n if (columns && Object.entries(explicit).some(([column, value]) => value !== undefined && !columns!.has(column))) {\n columns = await readColumns(options.db, true)\n }\n // Columns unknown (no table yet, or a binding without PRAGMA): every column, `variant` only when set.\n const written = RECORD_COLUMNS.filter(column => columns ? columns.has(column) : column !== 'variant' || row.variant !== undefined)\n await options.db.prepare(\n `INSERT OR IGNORE INTO rollout_turn_timing (${written.join(', ')}) VALUES (${written.map(() => '?').join(', ')})`,\n ).bind(...written.map(column => values[column])).run()\n } catch (error) {\n console.error(JSON.stringify({ event: 'rollout_turn_timing_record_failed', turnId: row.turnId,\n error: error instanceof Error ? error.message.slice(0, 200) : String(error).slice(0, 200) }))\n if (write?.throwOnError) throw error\n }\n },\n\n /** Merge later genuine observations into an already-terminal row. Never inserts or changes its verdict.\n * Exact origin and stream identity must agree; old NULL origins cannot be guessed. Throws so durable owners retry. */\n async recordFacts(facts: NativeTurnTimingFacts): Promise<void> {\n const values = nativeTimingObservationValues(facts)\n await options.db.prepare(`UPDATE rollout_turn_timing SET\n admission_ms = COALESCE(admission_ms, ?), first_visible_ms = COALESCE(first_visible_ms, ?),\n first_text_ms = COALESCE(first_text_ms, ?) WHERE turn_id = ? AND request_received_at = ?\n AND (admission_ms IS NULL OR ? IS NULL OR admission_ms = ?)`)\n .bind(roundOrNull(values.admissionMs), roundOrNull(values.firstVisibleMs), roundOrNull(values.firstTextMs),\n facts.turnStreamId, facts.requestReceivedAt, roundOrNull(values.admissionMs), roundOrNull(values.admissionMs)).run()\n },\n\n /** Request-origin ruler, separate from the rollout stage's relative latencies and missing-word failure rule.\n * Unknown facts stay in the denominator. Newest rows are bounded explicitly and truncation is reported. */\n async measureRequestOrigin(input: { rollout: string; lane?: string; since: number; until?: number; revision?: string | null }) {\n const until = input.until ?? now()\n const { results = [] } = await options.db.prepare(\n `SELECT turn_id, request_received_at, admission_ms, first_visible_ms, first_text_ms, model, lane, revision, failed FROM rollout_turn_timing\n WHERE rollout = ? AND (? IS NULL OR lane = ?) AND at >= ? AND at < ?\n AND (? = 0 OR (? IS NULL AND (revision IS NULL OR revision = '')) OR revision = ?)\n ORDER BY at DESC LIMIT ?`,\n ).bind(input.rollout, input.lane ?? null, input.lane ?? null, input.since, until,\n input.revision === undefined ? 0 : 1, input.revision ?? null, input.revision ?? null, MEASURE_ROW_LIMIT + 1).all<{\n turn_id: string; request_received_at: number | null\n admission_ms: number | null; first_visible_ms: number | null; first_text_ms: number | null\n model: string | null; lane: string | null; revision: string | null; failed: number\n }>()\n const rows = results.slice(0, MEASURE_ROW_LIMIT)\n const storedCoverage = timingCoverage(rows)\n const missingTiming = () => rows.filter(row => row.admission_ms == null || row.first_visible_ms == null || row.first_text_ms == null)\n const missing = missingTiming().filter(row => row.request_received_at != null)\n const observedFacts = { requested: missing.length, matched: 0, observationReadFailed: false,\n configured: Boolean(options.readObservedFacts), unknown: missingTiming().length }\n if (missing.length && options.readObservedFacts) {\n try {\n const observed = await options.readObservedFacts(missing.map(row => ({ turnStreamId: row.turn_id, requestReceivedAt: row.request_received_at! })))\n const byIdentity = new Map(missing.map(row => [row.turn_id, row]))\n const matched = new Set<string>()\n for (const facts of observed) {\n const row = byIdentity.get(facts.turnStreamId)\n if (!row || row.request_received_at !== facts.requestReceivedAt) continue\n let values: ReturnType<typeof nativeTimingObservationValues>\n try { values = nativeTimingObservationValues(facts) } catch { continue }\n if (row.admission_ms != null && values.admissionMs != null && row.admission_ms !== Math.round(values.admissionMs)) continue\n row.admission_ms ??= roundOrNull(values.admissionMs)\n row.first_visible_ms ??= roundOrNull(values.firstVisibleMs)\n row.first_text_ms ??= roundOrNull(values.firstTextMs)\n matched.add(row.turn_id)\n }\n observedFacts.matched = matched.size\n observedFacts.unknown = missingTiming().length\n } catch {\n observedFacts.observationReadFailed = true\n }\n }\n const visible = rows.flatMap(row => row.admission_ms == null || row.first_visible_ms == null\n ? [] : [row.admission_ms + row.first_visible_ms]).sort((a, b) => a - b)\n const failed = rows.filter(row => row.failed === 1).length\n const coverage = timingCoverage(rows)\n return {\n samples: rows.length, failed, failureRate: rows.length ? failed / rows.length : null,\n requestOriginFirstVisibleP50Ms: percentile(visible, 50),\n coverage,\n storedCoverage,\n recoveredCoverage: Object.fromEntries(Object.entries(coverage).map(([key, count]) => [key, count - storedCoverage[key as keyof typeof storedCoverage]])),\n unknownCoverage: Object.fromEntries(Object.entries(coverage).map(([key, count]) => [key, rows.length - count])),\n truncated: results.length > MEASURE_ROW_LIMIT,\n observedFacts,\n selection: { rollout: input.rollout, lane: input.lane ?? null, revision: input.revision === undefined ? 'all' : input.revision,\n clock: 'settled-at', limit: MEASURE_ROW_LIMIT, filtered: input.lane !== undefined || input.revision !== undefined },\n population: 'Persisted terminal timing rows in the selection; excludes pre-admission and missing-persistence attempts.',\n source: `rollout_turn_timing lane=${input.lane ?? 'all'}`,\n window: { from: new Date(input.since).toISOString(), to: new Date(until).toISOString() },\n }\n },\n\n /** Record settled chat outcomes without a product timing/serialization adapter. Read revision at settlement. */\n lifecycle<TContext>(input: {\n rollout: string\n identify(info: ChatTurnLifecycleComplete<TContext> | ChatTurnLifecycleError<TContext>):\n Pick<TurnTimingRow, 'workspaceId' | 'lane' | 'arm' | 'variant' | 'model' | 'failureCode'>\n revision?: () => string | undefined\n }): ChatTurnLifecycle<TContext> {\n const record = (info: ChatTurnLifecycleComplete<TContext> | ChatTurnLifecycleError<TContext>, failed: boolean) => {\n const identified = input.identify(info)\n return store.record({ ...identified, rollout: input.rollout, turnId: info.turnStreamId,\n admissionMs: info.admissionMs, firstVisibleMs: info.firstVisibleMs, firstTextMs: info.firstTextMs,\n model: identified.model ?? ('model' in info ? info.model : undefined),\n failureCode: identified.failureCode ?? (failed ? measuredTurnFacts(info.turnStreamId)?.failureCode\n ?? readableTurnFailure('error' in info ? info.error : undefined) : undefined),\n revision: input.revision ? input.revision() : (typeof process === 'undefined' ? undefined : process.env.DEPLOY_SHA?.trim()),\n settledMs: info.durationMs, failed })\n }\n return { onTurnComplete: info => info.gated ? undefined : record(info, false),\n onTurnError: info => record(info, true) }\n },\n\n /** The stage's numbers: its admitted workspaces' turns in `lane` since `since` (epoch ms). A row carries no\n * workspace creation time, so a workspace admitted only by a `new-since:` entry is not counted. */\n async measureStage(input: { rollout: string; stage: RolloutStage; lane: string; since: number }): Promise<StageMeasurement> {\n const { results = [] } = await options.db.prepare(\n `SELECT workspace_id, first_visible_ms, first_text_ms, settled_ms, failed FROM rollout_turn_timing\n WHERE rollout = ? AND lane = ? AND at >= ? ORDER BY at DESC LIMIT ?`,\n ).bind(input.rollout, input.lane, input.since, MEASURE_ROW_LIMIT).all<{\n workspace_id: string; first_visible_ms: number | null; first_text_ms: number | null; settled_ms: number; failed: number\n }>()\n const rows = results\n .filter(row => rolloutAdmits(input.stage.value, { id: row.workspace_id }))\n .map(row => ({ firstVisibleMs: row.first_visible_ms ?? undefined, firstTextMs: row.first_text_ms ?? undefined, settledMs: row.settled_ms, failed: row.failed === 1 }))\n return {\n stage: input.stage.name,\n lane: input.lane,\n samples: rows.length,\n metrics: stageMetrics(rows),\n source: `rollout_turn_timing lane=${input.lane}`,\n window: { from: new Date(input.since).toISOString(), to: new Date(now()).toISOString() },\n }\n },\n }\n return store\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../src/rollout/d1.ts"],"sourcesContent":["/**\n * The measurement a rollout guard reads: one row per turn with its lane, its\n * first visible word and whether it failed, and the stage numbers computed\n * from those rows.\n *\n * Record from the chat route's lifecycle (`onTurnComplete` / `onTurnError`\n * carry `firstVisibleMs`, `firstTextMs` and `durationMs`), then serve `measureStage` behind an\n * operator endpoint that the deploy's `rollout.config.mjs` calls. A stage is\n * measured on the turns of the workspaces it admits, in the lane being rolled\n * out, since the time it went live.\n *\n * By default `record` fills what the product's row leaves out from what the chat route measured for the same\n * `turnId` (its `turnStreamId`): `admissionMs`, `firstVisibleMs`, `firstTextMs`, the served `model` and readable failure, on every\n * lane. It writes only the columns the table has (read once per isolate with `PRAGMA table_info`), so a table that\n * predates a migration keeps recording the columns it has instead of losing the row. `revision`, `arm` and\n * `variant` are the product's and are written when the row carries them. Pass `measuredFacts: false` to write\n * only the row's own values.\n */\nimport { measuredTurnFacts, nativeTimingObservationValues, readableTurnFailure, type NativeTurnTimingFacts } from '../turn-trace/turn-facts'\nimport type { ChatTurnLifecycle, ChatTurnLifecycleComplete, ChatTurnLifecycleError } from '../chat-routes/turn-route-contracts'\nimport { rolloutAdmits, type RolloutStage, type StageMeasurement } from './index'\n\n/** Minimal D1 surface (Cloudflare's `D1Database` satisfies it). */\nexport interface D1LikeForRollout {\n prepare(sql: string): {\n bind(...values: unknown[]): {\n run(): Promise<unknown>\n all<T = Record<string, unknown>>(): Promise<{ results?: T[] }>\n }\n }\n}\n\n/** Apply through the product migration runner after request_received_at exists. Safe to apply again. */\nexport const ROLLOUT_TURN_TIMING_REQUEST_WINDOW_INDEX_MIGRATION_SQL = `\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_request_origin ON rollout_turn_timing (rollout, request_received_at, at);\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane_request_origin ON rollout_turn_timing (rollout, lane, request_received_at, at);\n`\n\nexport const ROLLOUT_TURN_TIMING_SCHEMA_SQL = `\nCREATE TABLE IF NOT EXISTS rollout_turn_timing (\n turn_id TEXT PRIMARY KEY,\n rollout TEXT NOT NULL,\n workspace_id TEXT NOT NULL,\n lane TEXT NOT NULL,\n admission_ms INTEGER,\n request_received_at INTEGER,\n model TEXT,\n revision TEXT,\n arm TEXT,\n variant TEXT,\n first_visible_ms INTEGER,\n first_text_ms INTEGER,\n settled_ms INTEGER NOT NULL,\n failed INTEGER NOT NULL CHECK (failed IN (0, 1)),\n failure_code TEXT,\n at INTEGER NOT NULL\n);\nCREATE INDEX IF NOT EXISTS rollout_turn_timing_by_lane ON rollout_turn_timing (rollout, lane, at);\n${ROLLOUT_TURN_TIMING_REQUEST_WINDOW_INDEX_MIGRATION_SQL}\n`\n\n/** Apply once through the product migration runner to existing tables; historical rows stay NULL. */\nexport const ROLLOUT_TURN_TIMING_FIRST_VISIBLE_MIGRATION_SQL =\n `ALTER TABLE rollout_turn_timing ADD COLUMN first_visible_ms INTEGER;`\n\n/** Apply once through the product migration runner; old rows remain unknown. */\nexport const ROLLOUT_TURN_TIMING_RULER_MIGRATION_SQL = `\nALTER TABLE rollout_turn_timing ADD COLUMN admission_ms INTEGER;\nALTER TABLE rollout_turn_timing ADD COLUMN model TEXT;\nALTER TABLE rollout_turn_timing ADD COLUMN revision TEXT;\nALTER TABLE rollout_turn_timing ADD COLUMN arm TEXT;\n`\n\n/** Apply once through the product migration runner before any row carries `variant`; old rows stay NULL. */\nexport const ROLLOUT_TURN_TIMING_VARIANT_MIGRATION_SQL =\n `ALTER TABLE rollout_turn_timing ADD COLUMN variant TEXT;`\n\n/** Additive upgrade for a table created before durable native timing transfer. Historical origins remain NULL. */\nexport const ROLLOUT_TURN_TIMING_REQUEST_ORIGIN_MIGRATION_SQL =\n `ALTER TABLE rollout_turn_timing ADD COLUMN request_received_at INTEGER;`\n\nexport interface TurnTimingRow {\n /** Original route trace epoch, used to prevent facts from a different attempt merging into this row. */\n requestReceivedAt?: number\n /** Request receipt to lifecycle start, before the existing relative durations. */\n admissionMs?: number\n model?: string\n revision?: string\n /** The rollout cohort arm (`assignRolloutArm`, or a synthetic cohort's label). Guards filter on it. */\n arm?: string\n /** The turn's experiment assignments, apart from `arm` so an experiment never changes the cohort a guard reads,\n * e.g. `billing_in_gate=1;prompt_prefix=0`. Written only when set, so a table without the column keeps recording. */\n variant?: string\n turnId: string\n /** The plan this turn counts toward, e.g. `hospitality-routed-chat`. */\n rollout: string\n workspaceId: string\n /** The lane that served the turn, e.g. `routed` or `sandbox`. Only the rolled-out lane is measured. */\n lane: string\n /** From the lifecycle's `firstTextMs`; absent when no word streamed. */\n firstTextMs?: number\n /** From the lifecycle firstVisibleMs; absent when no reasoning, tool or answer streamed. */\n firstVisibleMs?: number\n settledMs: number\n failed: boolean\n /** Defaults to the route's terminal code and redacted explanation. Empty or object-coerced strings use that evidence too. */\n failureCode?: string\n /** Epoch ms; defaults to now. */\n at?: number\n}\n\n/** Rows read for one measurement; a stage needing more than this would be measured on its newest rows. */\nconst MEASURE_ROW_LIMIT = 20_000\n\nfunction percentile(sorted: readonly number[], p: number): number | null {\n if (!sorted.length) return null\n return sorted[Math.min(sorted.length - 1, Math.ceil((p / 100) * sorted.length) - 1)]!\n}\n\n/** Stage metrics from turn rows: first-words and settled percentiles in ms, and the failure rate. */\nexport function stageMetrics(rows: ReadonlyArray<Pick<TurnTimingRow, 'firstVisibleMs' | 'firstTextMs' | 'settledMs' | 'failed'>>) {\n const firstVisible = rows.flatMap(row => row.firstVisibleMs == null ? [] : [row.firstVisibleMs]).sort((a, b) => a - b)\n const firstWords = rows.flatMap(row => row.firstTextMs === undefined || row.firstTextMs === null ? [] : [row.firstTextMs]).sort((a, b) => a - b)\n const settled = rows.filter(row => !row.failed).map(row => row.settledMs).sort((a, b) => a - b)\n return {\n first_visible_p50_ms: percentile(firstVisible, 50),\n first_visible_p90_ms: percentile(firstVisible, 90),\n first_words_p50_ms: percentile(firstWords, 50),\n first_words_p90_ms: percentile(firstWords, 90),\n settled_p50_ms: percentile(settled, 50),\n settled_p90_ms: percentile(settled, 90),\n // A turn that streamed no word failed the user whatever its envelope said.\n failure_rate: rows.length ? rows.filter(row => row.failed || row.firstTextMs === undefined || row.firstTextMs === null).length / rows.length : null,\n }\n}\n\ninterface TimingObservationRow {\n admission_ms: number | null; first_visible_ms: number | null; first_text_ms: number | null\n model: string | null; lane: string | null; revision: string | null\n}\n\nfunction timingCoverage(rows: readonly TimingObservationRow[]) {\n const known = (value: string | null) => Boolean(value?.trim()) && value !== 'unknown'\n return {\n admission: rows.filter(row => row.admission_ms != null).length,\n firstVisible: rows.filter(row => row.first_visible_ms != null).length,\n firstText: rows.filter(row => row.first_text_ms != null).length,\n requestOriginFirstVisible: rows.filter(row => row.admission_ms != null && row.first_visible_ms != null).length,\n model: rows.filter(row => known(row.model)).length,\n lane: rows.filter(row => known(row.lane)).length,\n revision: rows.filter(row => known(row.revision)).length,\n }\n}\n\n/** Columns `record` writes, in order; `variant` and the ruler columns arrived by migration. */\nconst RECORD_COLUMNS = ['turn_id', 'rollout', 'workspace_id', 'lane', 'first_visible_ms', 'first_text_ms', 'settled_ms', 'failed',\n 'failure_code', 'at', 'admission_ms', 'request_received_at', 'model', 'revision', 'arm', 'variant'] as const\ntype RecordColumn = typeof RECORD_COLUMNS[number]\n\n/** The table's columns per database binding, read once per isolate; `null` when they could not be read. */\nconst tableColumns = new WeakMap<object, Promise<ReadonlySet<string> | null>>()\n\nfunction readColumns(db: D1LikeForRollout, refresh: boolean): Promise<ReadonlySet<string> | null> {\n const cached = tableColumns.get(db)\n if (cached && !refresh) return cached\n const read = Promise.resolve().then(() => db.prepare('PRAGMA table_info(rollout_turn_timing)').bind().all<{ name: string }>())\n .then(({ results = [] }) => results.length ? new Set(results.map(column => column.name)) : null, () => null)\n tableColumns.set(db, read)\n return read\n}\n\nfunction roundOrNull(value: number | undefined): number | null {\n return value === undefined ? null : Math.round(value)\n}\n\nexport function createD1TurnTimingStore(options: {\n db: D1LikeForRollout\n now?: () => number\n /** Fill omitted timing and model from the chat route's measurement of the same turn. Default true. */\n measuredFacts?: boolean\n /** Read missing observations from the existing native admission owner. Bound and index the selected identity batches. */\n readObservedFacts?(turns: readonly { turnStreamId: string; requestReceivedAt: number }[]): Promise<readonly NativeTurnTimingFacts[]>\n}) {\n const now = options.now ?? Date.now\n const store = {\n /** Record one settled turn. Idempotent on `turnId`. Default never throws; durable owners opt into retryable writes with throwOnError. */\n async record(row: TurnTimingRow, write?: { throwOnError?: boolean }): Promise<void> {\n try {\n // Read before any await: the facts belong to the request that is settling this turn.\n const measured = options.measuredFacts === false ? undefined : measuredTurnFacts(row.turnId)\n const productFailure = row.failureCode?.trim()\n const values: Record<RecordColumn, unknown> = {\n turn_id: row.turnId, rollout: row.rollout, workspace_id: row.workspaceId, lane: row.lane,\n first_visible_ms: roundOrNull(row.firstVisibleMs ?? measured?.firstVisibleMs),\n first_text_ms: roundOrNull(row.firstTextMs ?? measured?.firstTextMs),\n settled_ms: Math.round(row.settledMs), failed: row.failed ? 1 : 0,\n failure_code: productFailure && productFailure !== '[object Object]'\n ? row.failureCode : measured?.failureCode ?? row.failureCode ?? null,\n at: row.at ?? now(), admission_ms: roundOrNull(row.admissionMs ?? measured?.admissionMs),\n request_received_at: row.requestReceivedAt ?? measured?.requestReceivedAt ?? null,\n model: row.model ?? measured?.model ?? null, revision: row.revision ?? null, arm: row.arm ?? null,\n variant: row.variant ?? null,\n }\n let columns = await readColumns(options.db, false)\n // A value the product passed whose column is unknown: the table may have migrated since the read.\n const explicit: Partial<Record<RecordColumn, unknown>> = { first_visible_ms: row.firstVisibleMs,\n admission_ms: row.admissionMs, request_received_at: row.requestReceivedAt, model: row.model, revision: row.revision, arm: row.arm, variant: row.variant }\n if (columns && Object.entries(explicit).some(([column, value]) => value !== undefined && !columns!.has(column))) {\n columns = await readColumns(options.db, true)\n }\n // Columns unknown (no table yet, or a binding without PRAGMA): every column, `variant` only when set.\n const written = RECORD_COLUMNS.filter(column => columns ? columns.has(column) : column !== 'variant' || row.variant !== undefined)\n await options.db.prepare(\n `INSERT OR IGNORE INTO rollout_turn_timing (${written.join(', ')}) VALUES (${written.map(() => '?').join(', ')})`,\n ).bind(...written.map(column => values[column])).run()\n } catch (error) {\n console.error(JSON.stringify({ event: 'rollout_turn_timing_record_failed', turnId: row.turnId,\n error: error instanceof Error ? error.message.slice(0, 200) : String(error).slice(0, 200) }))\n if (write?.throwOnError) throw error\n }\n },\n\n /** Merge later genuine observations into an already-terminal row. Never inserts or changes its verdict.\n * Exact origin and stream identity must agree; old NULL origins cannot be guessed. Throws so durable owners retry. */\n async recordFacts(facts: NativeTurnTimingFacts): Promise<void> {\n const values = nativeTimingObservationValues(facts)\n await options.db.prepare(`UPDATE rollout_turn_timing SET\n admission_ms = COALESCE(admission_ms, ?), first_visible_ms = COALESCE(first_visible_ms, ?),\n first_text_ms = COALESCE(first_text_ms, ?) WHERE turn_id = ? AND request_received_at = ?\n AND (admission_ms IS NULL OR ? IS NULL OR admission_ms = ?)`)\n .bind(roundOrNull(values.admissionMs), roundOrNull(values.firstVisibleMs), roundOrNull(values.firstTextMs),\n facts.turnStreamId, facts.requestReceivedAt, roundOrNull(values.admissionMs), roundOrNull(values.admissionMs)).run()\n },\n\n /** Request-origin ruler, separate from the rollout stage's relative latencies and missing-word failure rule.\n * Known origins select the request window; missing observations stay in that denominator. Unknown origins\n * are unassigned and reported separately by settlement window. Limits bound returned rows, not index reads. */\n async measureRequestOrigin(input: { rollout: string; lane?: string; since: number; until?: number; revision?: string | null }) {\n const until = input.until ?? now()\n const filters: string[] = ['rollout = ?']\n const bindings: unknown[] = [input.rollout]\n if (input.lane !== undefined) { filters.push('lane = ?'); bindings.push(input.lane) }\n if (input.revision === null) filters.push(\"(revision IS NULL OR revision = '')\")\n else if (input.revision !== undefined) { filters.push('revision = ?'); bindings.push(input.revision) }\n const selected = filters.join(' AND ')\n const { results = [] } = await options.db.prepare(\n `SELECT turn_id, request_received_at, admission_ms, first_visible_ms, first_text_ms, model, lane, revision, failed FROM rollout_turn_timing\n WHERE ${selected} AND request_received_at >= ? AND request_received_at < ?\n ORDER BY request_received_at DESC LIMIT ?`,\n ).bind(...bindings, input.since, until, MEASURE_ROW_LIMIT + 1).all<{\n turn_id: string; request_received_at: number | null\n admission_ms: number | null; first_visible_ms: number | null; first_text_ms: number | null\n model: string | null; lane: string | null; revision: string | null; failed: number\n }>()\n const rows = results.slice(0, MEASURE_ROW_LIMIT)\n const storedCoverage = timingCoverage(rows)\n const missingTiming = () => rows.filter(row => row.admission_ms == null || row.first_visible_ms == null || row.first_text_ms == null)\n const missing = missingTiming().filter(row => row.request_received_at != null)\n const observedFacts = { requested: missing.length, matched: 0, observationReadFailed: false,\n configured: Boolean(options.readObservedFacts), unknown: missingTiming().length }\n if (missing.length && options.readObservedFacts) {\n try {\n const observed = await options.readObservedFacts(missing.map(row => ({ turnStreamId: row.turn_id, requestReceivedAt: row.request_received_at! })))\n const byIdentity = new Map(missing.map(row => [row.turn_id, row]))\n const matched = new Set<string>()\n for (const facts of observed) {\n const row = byIdentity.get(facts.turnStreamId)\n if (!row || row.request_received_at !== facts.requestReceivedAt) continue\n let values: ReturnType<typeof nativeTimingObservationValues>\n try { values = nativeTimingObservationValues(facts) } catch { continue }\n if (row.admission_ms != null && values.admissionMs != null && row.admission_ms !== Math.round(values.admissionMs)) continue\n row.admission_ms ??= roundOrNull(values.admissionMs)\n row.first_visible_ms ??= roundOrNull(values.firstVisibleMs)\n row.first_text_ms ??= roundOrNull(values.firstTextMs)\n matched.add(row.turn_id)\n }\n observedFacts.matched = matched.size\n observedFacts.unknown = missingTiming().length\n } catch {\n observedFacts.observationReadFailed = true\n }\n }\n const visible = rows.flatMap(row => row.admission_ms == null || row.first_visible_ms == null\n ? [] : [row.admission_ms + row.first_visible_ms]).sort((a, b) => a - b)\n const failed = rows.filter(row => row.failed === 1).length\n const coverage = timingCoverage(rows)\n const { results: unassigned = [] } = await options.db.prepare(\n `SELECT failed FROM rollout_turn_timing WHERE ${selected} AND request_received_at IS NULL AND at >= ? AND at < ?\n ORDER BY at DESC LIMIT ?`,\n ).bind(...bindings, input.since, until, MEASURE_ROW_LIMIT + 1).all<{ failed: number }>()\n const unassignedRows = unassigned.slice(0, MEASURE_ROW_LIMIT)\n const selection = { rollout: input.rollout, lane: input.lane ?? null, revision: input.revision === undefined ? 'all' : input.revision,\n limit: MEASURE_ROW_LIMIT, filtered: input.lane !== undefined || input.revision !== undefined }\n const window = { from: new Date(input.since).toISOString(), to: new Date(until).toISOString() }\n return {\n samples: rows.length, failed, failureRate: rows.length ? failed / rows.length : null,\n requestOriginFirstVisibleP50Ms: percentile(visible, 50),\n coverage,\n storedCoverage,\n recoveredCoverage: Object.fromEntries(Object.entries(coverage).map(([key, count]) => [key, count - storedCoverage[key as keyof typeof storedCoverage]])),\n unknownCoverage: Object.fromEntries(Object.entries(coverage).map(([key, count]) => [key, rows.length - count])),\n truncated: results.length > MEASURE_ROW_LIMIT,\n observedFacts,\n selection: { ...selection, clock: 'request-received-at' },\n population: 'Persisted terminal timing rows with known request origins in the request window; excludes pre-admission, missing-persistence and unassigned-origin attempts.',\n unassignedOrigins: { samples: unassignedRows.length, failed: unassignedRows.filter(row => row.failed === 1).length,\n truncated: unassigned.length > MEASURE_ROW_LIMIT, selection: { ...selection, clock: 'settled-at' }, window,\n population: 'Persisted terminal timing rows with unknown request origins settled in this window; cannot be assigned to the request-window denominator.' },\n source: `rollout_turn_timing lane=${input.lane ?? 'all'}`,\n window,\n }\n },\n\n /** Record settled chat outcomes without a product timing/serialization adapter. Read revision at settlement. */\n lifecycle<TContext>(input: {\n rollout: string\n identify(info: ChatTurnLifecycleComplete<TContext> | ChatTurnLifecycleError<TContext>):\n Pick<TurnTimingRow, 'workspaceId' | 'lane' | 'arm' | 'variant' | 'model' | 'failureCode'>\n revision?: () => string | undefined\n }): ChatTurnLifecycle<TContext> {\n const record = (info: ChatTurnLifecycleComplete<TContext> | ChatTurnLifecycleError<TContext>, failed: boolean) => {\n const identified = input.identify(info)\n return store.record({ ...identified, rollout: input.rollout, turnId: info.turnStreamId,\n admissionMs: info.admissionMs, firstVisibleMs: info.firstVisibleMs, firstTextMs: info.firstTextMs,\n model: identified.model ?? ('model' in info ? info.model : undefined),\n failureCode: identified.failureCode ?? (failed ? measuredTurnFacts(info.turnStreamId)?.failureCode\n ?? readableTurnFailure('error' in info ? info.error : undefined) : undefined),\n revision: input.revision ? input.revision() : (typeof process === 'undefined' ? undefined : process.env.DEPLOY_SHA?.trim()),\n settledMs: info.durationMs, failed })\n }\n return { onTurnComplete: info => info.gated ? undefined : record(info, false),\n onTurnError: info => record(info, true) }\n },\n\n /** The stage's numbers: its admitted workspaces' turns in `lane` since `since` (epoch ms). A row carries no\n * workspace creation time, so a workspace admitted only by a `new-since:` entry is not counted. */\n async measureStage(input: { rollout: string; stage: RolloutStage; lane: string; since: number }): Promise<StageMeasurement> {\n const { results = [] } = await options.db.prepare(\n `SELECT workspace_id, first_visible_ms, first_text_ms, settled_ms, failed FROM rollout_turn_timing\n WHERE rollout = ? AND lane = ? AND at >= ? ORDER BY at DESC LIMIT ?`,\n ).bind(input.rollout, input.lane, input.since, MEASURE_ROW_LIMIT).all<{\n workspace_id: string; first_visible_ms: number | null; first_text_ms: number | null; settled_ms: number; failed: number\n }>()\n const rows = results\n .filter(row => rolloutAdmits(input.stage.value, { id: row.workspace_id }))\n .map(row => ({ firstVisibleMs: row.first_visible_ms ?? undefined, firstTextMs: row.first_text_ms ?? undefined, settledMs: row.settled_ms, failed: row.failed === 1 }))\n return {\n stage: input.stage.name,\n lane: input.lane,\n samples: rows.length,\n metrics: stageMetrics(rows),\n source: `rollout_turn_timing lane=${input.lane}`,\n window: { from: new Date(input.since).toISOString(), to: new Date(now()).toISOString() },\n }\n },\n }\n return store\n}\n"],"mappings":";;;;;;;;;;;AAiCO,IAAM,yDAAyD;AAAA;AAAA;AAAA;AAK/D,IAAM,iCAAiC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoB5C,sDAAsD;AAAA;AAIjD,IAAM,kDACX;AAGK,IAAM,0CAA0C;AAAA;AAAA;AAAA;AAAA;AAAA;AAQhD,IAAM,4CACX;AAGK,IAAM,mDACX;AAiCF,IAAM,oBAAoB;AAE1B,SAAS,WAAW,QAA2B,GAA0B;AACvE,MAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,SAAO,OAAO,KAAK,IAAI,OAAO,SAAS,GAAG,KAAK,KAAM,IAAI,MAAO,OAAO,MAAM,IAAI,CAAC,CAAC;AACrF;AAGO,SAAS,aAAa,MAAqG;AAChI,QAAM,eAAe,KAAK,QAAQ,SAAO,IAAI,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AACrH,QAAM,aAAa,KAAK,QAAQ,SAAO,IAAI,gBAAgB,UAAa,IAAI,gBAAgB,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAC/I,QAAM,UAAU,KAAK,OAAO,SAAO,CAAC,IAAI,MAAM,EAAE,IAAI,SAAO,IAAI,SAAS,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAC9F,SAAO;AAAA,IACL,sBAAsB,WAAW,cAAc,EAAE;AAAA,IACjD,sBAAsB,WAAW,cAAc,EAAE;AAAA,IACjD,oBAAoB,WAAW,YAAY,EAAE;AAAA,IAC7C,oBAAoB,WAAW,YAAY,EAAE;AAAA,IAC7C,gBAAgB,WAAW,SAAS,EAAE;AAAA,IACtC,gBAAgB,WAAW,SAAS,EAAE;AAAA;AAAA,IAEtC,cAAc,KAAK,SAAS,KAAK,OAAO,SAAO,IAAI,UAAU,IAAI,gBAAgB,UAAa,IAAI,gBAAgB,IAAI,EAAE,SAAS,KAAK,SAAS;AAAA,EACjJ;AACF;AAOA,SAAS,eAAe,MAAuC;AAC7D,QAAM,QAAQ,CAAC,UAAyB,QAAQ,OAAO,KAAK,CAAC,KAAK,UAAU;AAC5E,SAAO;AAAA,IACL,WAAW,KAAK,OAAO,SAAO,IAAI,gBAAgB,IAAI,EAAE;AAAA,IACxD,cAAc,KAAK,OAAO,SAAO,IAAI,oBAAoB,IAAI,EAAE;AAAA,IAC/D,WAAW,KAAK,OAAO,SAAO,IAAI,iBAAiB,IAAI,EAAE;AAAA,IACzD,2BAA2B,KAAK,OAAO,SAAO,IAAI,gBAAgB,QAAQ,IAAI,oBAAoB,IAAI,EAAE;AAAA,IACxG,OAAO,KAAK,OAAO,SAAO,MAAM,IAAI,KAAK,CAAC,EAAE;AAAA,IAC5C,MAAM,KAAK,OAAO,SAAO,MAAM,IAAI,IAAI,CAAC,EAAE;AAAA,IAC1C,UAAU,KAAK,OAAO,SAAO,MAAM,IAAI,QAAQ,CAAC,EAAE;AAAA,EACpD;AACF;AAGA,IAAM,iBAAiB;AAAA,EAAC;AAAA,EAAW;AAAA,EAAW;AAAA,EAAgB;AAAA,EAAQ;AAAA,EAAoB;AAAA,EAAiB;AAAA,EAAc;AAAA,EACvH;AAAA,EAAgB;AAAA,EAAM;AAAA,EAAgB;AAAA,EAAuB;AAAA,EAAS;AAAA,EAAY;AAAA,EAAO;AAAS;AAIpG,IAAM,eAAe,oBAAI,QAAqD;AAE9E,SAAS,YAAY,IAAsB,SAAuD;AAChG,QAAM,SAAS,aAAa,IAAI,EAAE;AAClC,MAAI,UAAU,CAAC,QAAS,QAAO;AAC/B,QAAM,OAAO,QAAQ,QAAQ,EAAE,KAAK,MAAM,GAAG,QAAQ,wCAAwC,EAAE,KAAK,EAAE,IAAsB,CAAC,EAC1H,KAAK,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,QAAQ,SAAS,IAAI,IAAI,QAAQ,IAAI,YAAU,OAAO,IAAI,CAAC,IAAI,MAAM,MAAM,IAAI;AAC7G,eAAa,IAAI,IAAI,IAAI;AACzB,SAAO;AACT;AAEA,SAAS,YAAY,OAA0C;AAC7D,SAAO,UAAU,SAAY,OAAO,KAAK,MAAM,KAAK;AACtD;AAEO,SAAS,wBAAwB,SAOrC;AACD,QAAM,MAAM,QAAQ,OAAO,KAAK;AAChC,QAAM,QAAQ;AAAA;AAAA,IAEZ,MAAM,OAAO,KAAoB,OAAmD;AAClF,UAAI;AAEF,cAAM,WAAW,QAAQ,kBAAkB,QAAQ,SAAY,kBAAkB,IAAI,MAAM;AAC3F,cAAM,iBAAiB,IAAI,aAAa,KAAK;AAC7C,cAAM,SAAwC;AAAA,UAC5C,SAAS,IAAI;AAAA,UAAQ,SAAS,IAAI;AAAA,UAAS,cAAc,IAAI;AAAA,UAAa,MAAM,IAAI;AAAA,UACpF,kBAAkB,YAAY,IAAI,kBAAkB,UAAU,cAAc;AAAA,UAC5E,eAAe,YAAY,IAAI,eAAe,UAAU,WAAW;AAAA,UACnE,YAAY,KAAK,MAAM,IAAI,SAAS;AAAA,UAAG,QAAQ,IAAI,SAAS,IAAI;AAAA,UAChE,cAAc,kBAAkB,mBAAmB,oBAC/C,IAAI,cAAc,UAAU,eAAe,IAAI,eAAe;AAAA,UAClE,IAAI,IAAI,MAAM,IAAI;AAAA,UAAG,cAAc,YAAY,IAAI,eAAe,UAAU,WAAW;AAAA,UACvF,qBAAqB,IAAI,qBAAqB,UAAU,qBAAqB;AAAA,UAC7E,OAAO,IAAI,SAAS,UAAU,SAAS;AAAA,UAAM,UAAU,IAAI,YAAY;AAAA,UAAM,KAAK,IAAI,OAAO;AAAA,UAC7F,SAAS,IAAI,WAAW;AAAA,QAC1B;AACA,YAAI,UAAU,MAAM,YAAY,QAAQ,IAAI,KAAK;AAEjD,cAAM,WAAmD;AAAA,UAAE,kBAAkB,IAAI;AAAA,UAC/E,cAAc,IAAI;AAAA,UAAa,qBAAqB,IAAI;AAAA,UAAmB,OAAO,IAAI;AAAA,UAAO,UAAU,IAAI;AAAA,UAAU,KAAK,IAAI;AAAA,UAAK,SAAS,IAAI;AAAA,QAAQ;AAC1J,YAAI,WAAW,OAAO,QAAQ,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,KAAK,MAAM,UAAU,UAAa,CAAC,QAAS,IAAI,MAAM,CAAC,GAAG;AAC/G,oBAAU,MAAM,YAAY,QAAQ,IAAI,IAAI;AAAA,QAC9C;AAEA,cAAM,UAAU,eAAe,OAAO,YAAU,UAAU,QAAQ,IAAI,MAAM,IAAI,WAAW,aAAa,IAAI,YAAY,MAAS;AACjI,cAAM,QAAQ,GAAG;AAAA,UACf,8CAA8C,QAAQ,KAAK,IAAI,CAAC,aAAa,QAAQ,IAAI,MAAM,GAAG,EAAE,KAAK,IAAI,CAAC;AAAA,QAChH,EAAE,KAAK,GAAG,QAAQ,IAAI,YAAU,OAAO,MAAM,CAAC,CAAC,EAAE,IAAI;AAAA,MACvD,SAAS,OAAO;AACd,gBAAQ,MAAM,KAAK,UAAU;AAAA,UAAE,OAAO;AAAA,UAAqC,QAAQ,IAAI;AAAA,UACrF,OAAO,iBAAiB,QAAQ,MAAM,QAAQ,MAAM,GAAG,GAAG,IAAI,OAAO,KAAK,EAAE,MAAM,GAAG,GAAG;AAAA,QAAE,CAAC,CAAC;AAC9F,YAAI,OAAO,aAAc,OAAM;AAAA,MACjC;AAAA,IACF;AAAA;AAAA;AAAA,IAIA,MAAM,YAAY,OAA6C;AAC7D,YAAM,SAAS,8BAA8B,KAAK;AAClD,YAAM,QAAQ,GAAG,QAAQ;AAAA;AAAA;AAAA,sEAGuC,EAC7D;AAAA,QAAK,YAAY,OAAO,WAAW;AAAA,QAAG,YAAY,OAAO,cAAc;AAAA,QAAG,YAAY,OAAO,WAAW;AAAA,QACvG,MAAM;AAAA,QAAc,MAAM;AAAA,QAAmB,YAAY,OAAO,WAAW;AAAA,QAAG,YAAY,OAAO,WAAW;AAAA,MAAC,EAAE,IAAI;AAAA,IACzH;AAAA;AAAA;AAAA;AAAA,IAKA,MAAM,qBAAqB,OAAoG;AAC7H,YAAM,QAAQ,MAAM,SAAS,IAAI;AACjC,YAAM,UAAoB,CAAC,aAAa;AACxC,YAAM,WAAsB,CAAC,MAAM,OAAO;AAC1C,UAAI,MAAM,SAAS,QAAW;AAAE,gBAAQ,KAAK,UAAU;AAAG,iBAAS,KAAK,MAAM,IAAI;AAAA,MAAE;AACpF,UAAI,MAAM,aAAa,KAAM,SAAQ,KAAK,qCAAqC;AAAA,eACtE,MAAM,aAAa,QAAW;AAAE,gBAAQ,KAAK,cAAc;AAAG,iBAAS,KAAK,MAAM,QAAQ;AAAA,MAAE;AACrG,YAAM,WAAW,QAAQ,KAAK,OAAO;AACrC,YAAM,EAAE,UAAU,CAAC,EAAE,IAAI,MAAM,QAAQ,GAAG;AAAA,QACxC;AAAA,kBACU,QAAQ;AAAA;AAAA,MAEpB,EAAE,KAAK,GAAG,UAAU,MAAM,OAAO,OAAO,oBAAoB,CAAC,EAAE,IAI5D;AACH,YAAM,OAAO,QAAQ,MAAM,GAAG,iBAAiB;AAC/C,YAAM,iBAAiB,eAAe,IAAI;AAC1C,YAAM,gBAAgB,MAAM,KAAK,OAAO,SAAO,IAAI,gBAAgB,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,iBAAiB,IAAI;AACpI,YAAM,UAAU,cAAc,EAAE,OAAO,SAAO,IAAI,uBAAuB,IAAI;AAC7E,YAAM,gBAAgB;AAAA,QAAE,WAAW,QAAQ;AAAA,QAAQ,SAAS;AAAA,QAAG,uBAAuB;AAAA,QACpF,YAAY,QAAQ,QAAQ,iBAAiB;AAAA,QAAG,SAAS,cAAc,EAAE;AAAA,MAAO;AAClF,UAAI,QAAQ,UAAU,QAAQ,mBAAmB;AAC/C,YAAI;AACF,gBAAM,WAAW,MAAM,QAAQ,kBAAkB,QAAQ,IAAI,UAAQ,EAAE,cAAc,IAAI,SAAS,mBAAmB,IAAI,oBAAqB,EAAE,CAAC;AACjJ,gBAAM,aAAa,IAAI,IAAI,QAAQ,IAAI,SAAO,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;AACjE,gBAAM,UAAU,oBAAI,IAAY;AAChC,qBAAW,SAAS,UAAU;AAC5B,kBAAM,MAAM,WAAW,IAAI,MAAM,YAAY;AAC7C,gBAAI,CAAC,OAAO,IAAI,wBAAwB,MAAM,kBAAmB;AACjE,gBAAI;AACJ,gBAAI;AAAE,uBAAS,8BAA8B,KAAK;AAAA,YAAE,QAAQ;AAAE;AAAA,YAAS;AACvE,gBAAI,IAAI,gBAAgB,QAAQ,OAAO,eAAe,QAAQ,IAAI,iBAAiB,KAAK,MAAM,OAAO,WAAW,EAAG;AACnH,gBAAI,iBAAiB,YAAY,OAAO,WAAW;AACnD,gBAAI,qBAAqB,YAAY,OAAO,cAAc;AAC1D,gBAAI,kBAAkB,YAAY,OAAO,WAAW;AACpD,oBAAQ,IAAI,IAAI,OAAO;AAAA,UACzB;AACA,wBAAc,UAAU,QAAQ;AAChC,wBAAc,UAAU,cAAc,EAAE;AAAA,QAC1C,QAAQ;AACN,wBAAc,wBAAwB;AAAA,QACxC;AAAA,MACF;AACA,YAAM,UAAU,KAAK,QAAQ,SAAO,IAAI,gBAAgB,QAAQ,IAAI,oBAAoB,OACpF,CAAC,IAAI,CAAC,IAAI,eAAe,IAAI,gBAAgB,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AACxE,YAAM,SAAS,KAAK,OAAO,SAAO,IAAI,WAAW,CAAC,EAAE;AACpD,YAAM,WAAW,eAAe,IAAI;AACpC,YAAM,EAAE,SAAS,aAAa,CAAC,EAAE,IAAI,MAAM,QAAQ,GAAG;AAAA,QACpD,gDAAgD,QAAQ;AAAA;AAAA,MAE1D,EAAE,KAAK,GAAG,UAAU,MAAM,OAAO,OAAO,oBAAoB,CAAC,EAAE,IAAwB;AACvF,YAAM,iBAAiB,WAAW,MAAM,GAAG,iBAAiB;AAC5D,YAAM,YAAY;AAAA,QAAE,SAAS,MAAM;AAAA,QAAS,MAAM,MAAM,QAAQ;AAAA,QAAM,UAAU,MAAM,aAAa,SAAY,QAAQ,MAAM;AAAA,QAC3H,OAAO;AAAA,QAAmB,UAAU,MAAM,SAAS,UAAa,MAAM,aAAa;AAAA,MAAU;AAC/F,YAAM,SAAS,EAAE,MAAM,IAAI,KAAK,MAAM,KAAK,EAAE,YAAY,GAAG,IAAI,IAAI,KAAK,KAAK,EAAE,YAAY,EAAE;AAC9F,aAAO;AAAA,QACL,SAAS,KAAK;AAAA,QAAQ;AAAA,QAAQ,aAAa,KAAK,SAAS,SAAS,KAAK,SAAS;AAAA,QAChF,gCAAgC,WAAW,SAAS,EAAE;AAAA,QACtD;AAAA,QACA;AAAA,QACA,mBAAmB,OAAO,YAAY,OAAO,QAAQ,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,QAAQ,eAAe,GAAkC,CAAC,CAAC,CAAC;AAAA,QACvJ,iBAAiB,OAAO,YAAY,OAAO,QAAQ,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,KAAK,SAAS,KAAK,CAAC,CAAC;AAAA,QAC9G,WAAW,QAAQ,SAAS;AAAA,QAC5B;AAAA,QACA,WAAW,EAAE,GAAG,WAAW,OAAO,sBAAsB;AAAA,QACxD,YAAY;AAAA,QACZ,mBAAmB;AAAA,UAAE,SAAS,eAAe;AAAA,UAAQ,QAAQ,eAAe,OAAO,SAAO,IAAI,WAAW,CAAC,EAAE;AAAA,UAC1G,WAAW,WAAW,SAAS;AAAA,UAAmB,WAAW,EAAE,GAAG,WAAW,OAAO,aAAa;AAAA,UAAG;AAAA,UACpG,YAAY;AAAA,QAA4I;AAAA,QAC1J,QAAQ,4BAA4B,MAAM,QAAQ,KAAK;AAAA,QACvD;AAAA,MACF;AAAA,IACF;AAAA;AAAA,IAGA,UAAoB,OAKY;AAC9B,YAAM,SAAS,CAAC,MAA8E,WAAoB;AAChH,cAAM,aAAa,MAAM,SAAS,IAAI;AACtC,eAAO,MAAM,OAAO;AAAA,UAAE,GAAG;AAAA,UAAY,SAAS,MAAM;AAAA,UAAS,QAAQ,KAAK;AAAA,UACxE,aAAa,KAAK;AAAA,UAAa,gBAAgB,KAAK;AAAA,UAAgB,aAAa,KAAK;AAAA,UACtF,OAAO,WAAW,UAAU,WAAW,OAAO,KAAK,QAAQ;AAAA,UAC3D,aAAa,WAAW,gBAAgB,SAAS,kBAAkB,KAAK,YAAY,GAAG,eAClF,oBAAoB,WAAW,OAAO,KAAK,QAAQ,MAAS,IAAI;AAAA,UACrE,UAAU,MAAM,WAAW,MAAM,SAAS,IAAK,OAAO,YAAY,cAAc,SAAY,QAAQ,IAAI,YAAY,KAAK;AAAA,UACzH,WAAW,KAAK;AAAA,UAAY;AAAA,QAAO,CAAC;AAAA,MACxC;AACA,aAAO;AAAA,QAAE,gBAAgB,UAAQ,KAAK,QAAQ,SAAY,OAAO,MAAM,KAAK;AAAA,QAC1E,aAAa,UAAQ,OAAO,MAAM,IAAI;AAAA,MAAE;AAAA,IAC5C;AAAA;AAAA;AAAA,IAIA,MAAM,aAAa,OAAyG;AAC1H,YAAM,EAAE,UAAU,CAAC,EAAE,IAAI,MAAM,QAAQ,GAAG;AAAA,QACxC;AAAA;AAAA,MAEF,EAAE,KAAK,MAAM,SAAS,MAAM,MAAM,MAAM,OAAO,iBAAiB,EAAE,IAE/D;AACH,YAAM,OAAO,QACV,OAAO,SAAO,cAAc,MAAM,MAAM,OAAO,EAAE,IAAI,IAAI,aAAa,CAAC,CAAC,EACxE,IAAI,UAAQ,EAAE,gBAAgB,IAAI,oBAAoB,QAAW,aAAa,IAAI,iBAAiB,QAAW,WAAW,IAAI,YAAY,QAAQ,IAAI,WAAW,EAAE,EAAE;AACvK,aAAO;AAAA,QACL,OAAO,MAAM,MAAM;AAAA,QACnB,MAAM,MAAM;AAAA,QACZ,SAAS,KAAK;AAAA,QACd,SAAS,aAAa,IAAI;AAAA,QAC1B,QAAQ,4BAA4B,MAAM,IAAI;AAAA,QAC9C,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,KAAK,EAAE,YAAY,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,YAAY,EAAE;AAAA,MACzF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}
@@ -101,7 +101,7 @@ import {
101
101
  warmKey,
102
102
  warmReceiptId,
103
103
  warmWeekdayOf
104
- } from "../chunk-ND5XWLRU.js";
104
+ } from "../chunk-POIVNKYH.js";
105
105
  import {
106
106
  createWarmCache
107
107
  } from "../chunk-F4TUZYMX.js";
@@ -145,15 +145,17 @@ import {
145
145
  workspaceSandboxRecoveryMessage,
146
146
  workspaceSandboxRecoveryRecommendedActions
147
147
  } from "../chunk-PK65B6HP.js";
148
+ import "../chunk-464WRGJ3.js";
149
+ import "../chunk-ISP6ZH3G.js";
148
150
  import "../chunk-DSMGS4IV.js";
149
- import "../chunk-5BJHKQ33.js";
151
+ import "../chunk-ACB7KOQ6.js";
150
152
  import "../chunk-6A7MYOUI.js";
151
153
  import "../chunk-O7UX55EU.js";
152
- import "../chunk-XEAZWJ3W.js";
154
+ import "../chunk-7Y7U7U7X.js";
153
155
  import "../chunk-S5SRJJQG.js";
154
- import "../chunk-7TZA2TAM.js";
156
+ import "../chunk-FCYHDENJ.js";
155
157
  import "../chunk-UGWQLQDS.js";
156
- import "../chunk-WSQFNMIA.js";
158
+ import "../chunk-HRBF4B5L.js";
157
159
  import "../chunk-D6UJEOZQ.js";
158
160
  import "../chunk-AVBNS64P.js";
159
161
  import {
@@ -1,4 +1,5 @@
1
1
  import { type WarmReceiptStore } from './warm-receipts';
2
+ import { type ChatTurnStoreBindings } from '../chat-routes/route-storage';
2
3
  /** What the product decided for this request. */
3
4
  export type WorkspacePrewarmAuthorization =
4
5
  /** Not signed in, not a member, or a foreign origin: return this response. */
@@ -19,12 +20,14 @@ export type WorkspacePrewarmAuthorization =
19
20
  */
20
21
  | {
21
22
  status: 'allowed';
23
+ workspaceId?: string;
22
24
  key: string;
23
25
  warm: () => Promise<WorkspacePrewarmReport | void>;
24
26
  }
25
27
  /** Run each step whose key has no unexpired receipt. */
26
28
  | {
27
29
  status: 'allowed';
30
+ workspaceId?: string;
28
31
  steps: readonly WorkspaceWarmStep[];
29
32
  };
30
33
  /** One warm step, keyed by exactly what it depends on. */
@@ -87,6 +90,10 @@ export type WorkspacePrewarmEvent = {
87
90
  error?: string;
88
91
  };
89
92
  export interface CreateWorkspacePrewarmRouteOptions<Context = void> {
93
+ /** The same binding descriptor chat uses. Adds the keyed turn_lock warm by default.
94
+ * An allowed authorization must carry its server-verified workspaceId; request body identity is never used.
95
+ * Receipts default to this database; apply WARM_RECEIPT_TABLE_DDL through the product migration runner. */
96
+ turnStore?: ChatTurnStoreBindings;
90
97
  /** `context` is whatever the caller passed beside the request, such as a
91
98
  * Hono context carrying the Worker's bindings. */
92
99
  /** `threadId` is the thread the composer belongs to, when the browser sent one (composer focus). Check the member's access to it before warming anything for it. */
@@ -12,23 +12,6 @@ import {
12
12
  normalizeClientTurnId,
13
13
  resolveChatTurn
14
14
  } from "../chunk-YG66IHDU.js";
15
- import {
16
- DEFAULT_RUNNING_TURN_LEASE_MS,
17
- DEFAULT_RUNNING_TURN_RENEW_INTERVAL_MS,
18
- TURN_EVENTS_MIGRATION_SQL,
19
- TURN_STATUS_LEASE_MIGRATION_SQL,
20
- TURN_STATUS_RETENTION_MIGRATION_SQL,
21
- TURN_STATUS_SCOPE_MIGRATION_SQL,
22
- coalesceChatStreamEvents,
23
- coalesceDeltas,
24
- createBufferedTurnTap,
25
- createD1TurnEventStore,
26
- createMemoryTurnEventStore,
27
- isLiveProgressEvent,
28
- pumpBufferedTurn,
29
- replayTurnEvents,
30
- stampReplaySeq
31
- } from "../chunk-ISP6ZH3G.js";
32
15
  import {
33
16
  MISSING_TOOL_TERMINAL_ERROR,
34
17
  MISSING_TOOL_TERMINAL_REASON,
@@ -52,6 +35,23 @@ import {
52
35
  terminalizeDanglingToolParts
53
36
  } from "../chunk-VUBJZEZB.js";
54
37
  import "../chunk-6VQCFJWP.js";
38
+ import {
39
+ DEFAULT_RUNNING_TURN_LEASE_MS,
40
+ DEFAULT_RUNNING_TURN_RENEW_INTERVAL_MS,
41
+ TURN_EVENTS_MIGRATION_SQL,
42
+ TURN_STATUS_LEASE_MIGRATION_SQL,
43
+ TURN_STATUS_RETENTION_MIGRATION_SQL,
44
+ TURN_STATUS_SCOPE_MIGRATION_SQL,
45
+ coalesceChatStreamEvents,
46
+ coalesceDeltas,
47
+ createBufferedTurnTap,
48
+ createD1TurnEventStore,
49
+ createMemoryTurnEventStore,
50
+ isLiveProgressEvent,
51
+ pumpBufferedTurn,
52
+ replayTurnEvents,
53
+ stampReplaySeq
54
+ } from "../chunk-ISP6ZH3G.js";
55
55
  import "../chunk-WL7PZK7Q.js";
56
56
  export {
57
57
  DEFAULT_RUNNING_TURN_LEASE_MS,
@@ -5,7 +5,7 @@ import {
5
5
  outcomeStatus,
6
6
  resolveToolCapabilities,
7
7
  restrictTaxonomy
8
- } from "../chunk-5BJHKQ33.js";
8
+ } from "../chunk-ACB7KOQ6.js";
9
9
  import {
10
10
  DEFAULT_APP_TOOL_PATHS,
11
11
  DEFAULT_HEADER_NAMES,
@@ -24,7 +24,7 @@ import {
24
24
  verifyCapabilityToken,
25
25
  verifyExpiringCapabilityToken
26
26
  } from "../chunk-O7UX55EU.js";
27
- import "../chunk-XEAZWJ3W.js";
27
+ import "../chunk-7Y7U7U7X.js";
28
28
  import "../chunk-S5SRJJQG.js";
29
29
  import {
30
30
  APP_TOOL_NAMES,
@@ -33,11 +33,11 @@ import {
33
33
  defineAppTool,
34
34
  findCustomTool,
35
35
  isAppToolName
36
- } from "../chunk-7TZA2TAM.js";
36
+ } from "../chunk-FCYHDENJ.js";
37
37
  import "../chunk-UGWQLQDS.js";
38
38
  import {
39
39
  ToolInputError
40
- } from "../chunk-WSQFNMIA.js";
40
+ } from "../chunk-HRBF4B5L.js";
41
41
  export {
42
42
  APP_TOOL_NAMES,
43
43
  DEFAULT_APP_TOOL_PATHS,
@@ -11,6 +11,10 @@ import { type DurableTurnLock, type TurnLockAcquireResult, type TurnLockReleaseI
11
11
  export interface TurnStreamStubLike {
12
12
  fetch(input: Request | string, init?: RequestInit): Promise<Response>;
13
13
  }
14
+ /** Cloudflare placement hints. A hint affects only a channel's first creation, never an existing object's location. */
15
+ export type TurnStreamLocationHint = 'wnam' | 'enam' | 'sam' | 'weur' | 'eeur' | 'apac' | 'apac-ne' | 'apac-se' | 'oc' | 'afr' | 'me';
16
+ /** The default matches the application D1 region unless its binding descriptor names another region. */
17
+ export declare const DEFAULT_TURN_LOCK_LOCATION_HINT: TurnStreamLocationHint;
14
18
  /** The surface of `DurableObjectNamespace` the adapters use. */
15
19
  export interface TurnStreamNamespaceLike {
16
20
  idFromName(name: string): unknown;
@@ -125,6 +129,8 @@ export type TurnLockSeamResult = {
125
129
  };
126
130
  /** Define options for creating a durable turn lock with customizable scope and identification methods */
127
131
  export interface CreateDurableTurnLockOptions<TContext> {
132
+ /** New channels use this hint; existing channel IDs and locations are preserved. */
133
+ locationHint?: TurnStreamLocationHint;
128
134
  namespace: TurnStreamNamespaceLike;
129
135
  /** Capability tokens for the DO; pass the worker's
130
136
  * `env.TURN_STREAM_AUTH_SECRET`. The DO validates every request. */
@@ -1,5 +1,6 @@
1
1
  import {
2
2
  ACTIVITY_TTL_MS,
3
+ DEFAULT_TURN_LOCK_LOCATION_HINT,
3
4
  MAX_RECENT_CREATED,
4
5
  TURN_LOCK_TTL_MS,
5
6
  TURN_STREAM_PATHS,
@@ -30,7 +31,7 @@ import {
30
31
  turnStorageChannelKey,
31
32
  verifyTurnStreamToken,
32
33
  workspaceChannelKey
33
- } from "../chunk-A2NQMVMF.js";
34
+ } from "../chunk-464WRGJ3.js";
34
35
  import {
35
36
  DEFAULT_RUNNING_TURN_LEASE_MS
36
37
  } from "../chunk-ISP6ZH3G.js";
@@ -542,6 +543,7 @@ function createMemoryTurnStreamHarness(createInstance = (state, secret) => new T
542
543
  }
543
544
  export {
544
545
  ACTIVITY_TTL_MS,
546
+ DEFAULT_TURN_LOCK_LOCATION_HINT,
545
547
  MAX_RECENT_CREATED,
546
548
  MEMORY_TURN_STREAM_AUTH_SECRET,
547
549
  TURN_LOCK_TTL_MS,