@tangle-network/agent-app 0.55.7 → 0.56.1

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 (32) hide show
  1. package/dist/assistant/index.js +4 -4
  2. package/dist/chat-routes/completed-sandbox-turn.d.ts +9 -1
  3. package/dist/chat-routes/detached-turn.d.ts +3 -9
  4. package/dist/chat-routes/index.d.ts +2 -1
  5. package/dist/chat-routes/index.js +206 -55
  6. package/dist/chat-routes/index.js.map +1 -1
  7. package/dist/chat-routes/plan-follow-up.d.ts +108 -0
  8. package/dist/chat-store/index.js +3 -3
  9. package/dist/{chunk-RSTPXLC3.js → chunk-3LOTQCW7.js} +3 -3
  10. package/dist/{chunk-HXTJXODG.js → chunk-GBOHTAQH.js} +11 -2
  11. package/dist/chunk-GBOHTAQH.js.map +1 -0
  12. package/dist/{chunk-V4JZ5OYC.js → chunk-HTAFI247.js} +2 -2
  13. package/dist/{chunk-YJMCRXQQ.js → chunk-LQYIBL3G.js} +3 -3
  14. package/dist/{chunk-YJMCRXQQ.js.map → chunk-LQYIBL3G.js.map} +1 -1
  15. package/dist/{chunk-UII4YDYS.js → chunk-N56FWDSP.js} +2 -2
  16. package/dist/{chunk-2HEFK764.js → chunk-TNDBW5XG.js} +3 -3
  17. package/dist/peer-floors/cli.js +123 -3
  18. package/dist/peer-floors/cli.js.map +1 -1
  19. package/dist/peer-floors/durability-owners.d.ts +23 -0
  20. package/dist/plans/index.d.ts +6 -2
  21. package/dist/plans/index.js +1 -1
  22. package/dist/public-consultation/index.js +5 -5
  23. package/dist/stream/index.js +5 -3
  24. package/dist/stream/turn-buffer.d.ts +8 -1
  25. package/dist/turn-stream/index.js +1 -1
  26. package/dist/web-react/index.js +4 -4
  27. package/package.json +1 -1
  28. package/dist/chunk-HXTJXODG.js.map +0 -1
  29. /package/dist/{chunk-RSTPXLC3.js.map → chunk-3LOTQCW7.js.map} +0 -0
  30. /package/dist/{chunk-V4JZ5OYC.js.map → chunk-HTAFI247.js.map} +0 -0
  31. /package/dist/{chunk-UII4YDYS.js.map → chunk-N56FWDSP.js.map} +0 -0
  32. /package/dist/{chunk-2HEFK764.js.map → chunk-TNDBW5XG.js.map} +0 -0
@@ -0,0 +1,108 @@
1
+ import type { SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
2
+ /** The decision a follow-up continues. */
3
+ export type PlanFollowUpOutcome = 'approved' | 'rejected';
4
+ /** The descriptor a decided plan card sends back to the chat route. */
5
+ export interface PlanFollowUpAttach {
6
+ planId: string;
7
+ revision: number;
8
+ outcome: PlanFollowUpOutcome;
9
+ turnId: string;
10
+ }
11
+ /** Result of checking a follow-up descriptor against the session's persisted plans. */
12
+ export type PlanFollowUpResolution = {
13
+ ok: true;
14
+ attach: PlanFollowUpAttach;
15
+ executionId: string;
16
+ } | {
17
+ ok: false;
18
+ status: 400 | 409;
19
+ code: string;
20
+ error: string;
21
+ };
22
+ /** Result of one exclusive follow-up claim. */
23
+ export type PlanFollowUpAdmission = {
24
+ admitted: true;
25
+ lease: string;
26
+ } | {
27
+ admitted: false;
28
+ reason: 'in_flight' | 'completed';
29
+ };
30
+ /** Result of settling a claim. `lease_lost` means a stale reclaim superseded it. */
31
+ export type PlanFollowUpSettlement = {
32
+ settled: true;
33
+ } | {
34
+ settled: false;
35
+ reason: 'lease_lost';
36
+ };
37
+ /** A bound D1 statement used by the follow-up gate. */
38
+ export interface D1BoundForPlanFollowUps {
39
+ run(): Promise<unknown>;
40
+ }
41
+ /**
42
+ * Structural D1 contract for the follow-up gate. `batch` is required: it is
43
+ * D1's atomic boundary, and the gate confirms ownership from the row read in
44
+ * the same batch instead of from a driver-specific affected-row count.
45
+ */
46
+ export interface D1LikeForPlanFollowUps {
47
+ prepare(sql: string): {
48
+ bind(...values: unknown[]): D1BoundForPlanFollowUps;
49
+ };
50
+ batch(statements: D1BoundForPlanFollowUps[]): Promise<unknown[]>;
51
+ }
52
+ /** Configure the follow-up gate. Clock and lease are injectable for tests. */
53
+ export interface PlanFollowUpGateOptions {
54
+ now?: () => Date;
55
+ createLease?: () => string;
56
+ /** How long a `running` claim may sit before another isolate may reclaim it. Default one hour. */
57
+ staleAfterMs?: number;
58
+ }
59
+ /** Exclusive claim over one follow-up execution's `turn_status` row. */
60
+ export interface PlanFollowUpGate {
61
+ admit(executionId: string, scopeId: string): Promise<PlanFollowUpAdmission>;
62
+ /** Record a completed attach. Only the current lease may settle. */
63
+ settle(executionId: string, scopeId: string, lease: string): Promise<PlanFollowUpSettlement>;
64
+ /** Record a failed attach so a retry is admitted immediately. */
65
+ abandon(executionId: string, scopeId: string, lease: string): Promise<PlanFollowUpSettlement>;
66
+ }
67
+ /** The Sidecar's execution id for a follow-up turn. Keep it byte-identical to the Sidecar. */
68
+ export declare function planFollowUpExecutionId(sessionId: string, turnId: string): string;
69
+ /** Parse a follow-up descriptor. The turn id is derived, never trusted. */
70
+ export declare function parsePlanFollowUpAttach(value: unknown): PlanFollowUpAttach | null;
71
+ /**
72
+ * Validate a follow-up request against what the session actually persisted:
73
+ * the plan must be in this session at this revision and must already carry the
74
+ * claimed decision.
75
+ */
76
+ export declare function resolvePlanFollowUpRequest(input: {
77
+ sessionId: string;
78
+ planFollowUp: unknown;
79
+ messages: ReadonlyArray<{
80
+ role: string;
81
+ parts?: unknown;
82
+ }>;
83
+ }): PlanFollowUpResolution;
84
+ /**
85
+ * Session events carry two payload shapes: replayed events hold the stream
86
+ * event under `data`, while live events nest it under `data.properties`.
87
+ * Downstream reads `data.<field>`, so a live event is unwrapped.
88
+ */
89
+ export declare function unwrapSessionEventPayload(event: SandboxEvent): SandboxEvent;
90
+ /**
91
+ * Attach to the already-enqueued follow-up execution: replay its buffered
92
+ * events from the start, then follow it live to completion. It never sends a
93
+ * new prompt. The session-events iterator has no reconnect, so a stream that
94
+ * ends without a terminal event fails instead of persisting a partial turn.
95
+ */
96
+ export declare function streamPlanFollowUpEvents(box: SandboxInstance, sessionId: string, executionId: string, options?: {
97
+ timeoutMs?: number;
98
+ }): AsyncGenerator<SandboxEvent>;
99
+ /**
100
+ * Exclusive claim over a follow-up execution in the shared `turn_status`
101
+ * table. Every claim writes a random lease and confirms ownership from the
102
+ * row returned by the same D1 batch. A running claim older than
103
+ * `staleAfterMs` may be reclaimed; the superseded holder then settles into
104
+ * `lease_lost` instead of overwriting the newer claim. The table needs the
105
+ * `leaseToken` column from `TURN_EVENTS_MIGRATION_SQL` or, for an older table,
106
+ * `TURN_STATUS_LEASE_MIGRATION_SQL` (both in `/stream`).
107
+ */
108
+ export declare function createD1PlanFollowUpGate(db: D1LikeForPlanFollowUps, options?: PlanFollowUpGateOptions): PlanFollowUpGate;
@@ -14,15 +14,15 @@ import {
14
14
  mentionInputToPart,
15
15
  mentionPartsFromMessageParts,
16
16
  toChatMessageParts
17
- } from "../chunk-V4JZ5OYC.js";
17
+ } from "../chunk-HTAFI247.js";
18
18
  import "../chunk-ZVEEWGDK.js";
19
19
  import "../chunk-GYDFGEJ2.js";
20
20
  import "../chunk-TXD5HXLE.js";
21
21
  import {
22
22
  attachmentPartKey
23
- } from "../chunk-UII4YDYS.js";
23
+ } from "../chunk-N56FWDSP.js";
24
24
  import "../chunk-FCON65I2.js";
25
- import "../chunk-YJMCRXQQ.js";
25
+ import "../chunk-LQYIBL3G.js";
26
26
 
27
27
  // src/chat-store/core.ts
28
28
  var BULK_DELETE_MAX_THREADS = 200;
@@ -7,7 +7,7 @@ import {
7
7
  import {
8
8
  mentionInputToPart,
9
9
  toChatMessageParts
10
- } from "./chunk-V4JZ5OYC.js";
10
+ } from "./chunk-HTAFI247.js";
11
11
  import {
12
12
  ChatTurnInputError,
13
13
  assertPromptPartsWithinCap,
@@ -24,7 +24,7 @@ import {
24
24
  createBufferedTurnTap,
25
25
  replayTurnEvents,
26
26
  stampReplaySeq
27
- } from "./chunk-HXTJXODG.js";
27
+ } from "./chunk-GBOHTAQH.js";
28
28
 
29
29
  // src/chat-routes/draft-persistence.ts
30
30
  var CONTENT_EVENT_TYPES = /* @__PURE__ */ new Set([
@@ -1082,4 +1082,4 @@ export {
1082
1082
  createChatTurnRoutes,
1083
1083
  streamChatRouteAsSandboxEvents
1084
1084
  };
1085
- //# sourceMappingURL=chunk-RSTPXLC3.js.map
1085
+ //# sourceMappingURL=chunk-3LOTQCW7.js.map
@@ -235,12 +235,14 @@ CREATE TABLE IF NOT EXISTS turn_status (
235
235
  turnId TEXT PRIMARY KEY,
236
236
  status TEXT NOT NULL,
237
237
  scopeId TEXT,
238
- updatedAt TEXT NOT NULL
238
+ updatedAt TEXT NOT NULL,
239
+ leaseToken TEXT
239
240
  );
240
241
  CREATE INDEX IF NOT EXISTS idx_turn_status_scope ON turn_status (scopeId, status);
241
242
  CREATE INDEX IF NOT EXISTS idx_turn_status_retention ON turn_status (status, updatedAt);
242
243
  `;
243
244
  var TURN_STATUS_SCOPE_MIGRATION_SQL = `ALTER TABLE turn_status ADD COLUMN scopeId TEXT;`;
245
+ var TURN_STATUS_LEASE_MIGRATION_SQL = "ALTER TABLE turn_status ADD COLUMN leaseToken TEXT;";
244
246
  var TURN_STATUS_RETENTION_MIGRATION_SQL = "CREATE INDEX IF NOT EXISTS idx_turn_status_retention ON turn_status (status, updatedAt);";
245
247
  var D1_APPEND_CHUNK = 33;
246
248
  function createD1TurnEventStore(db, options = {}) {
@@ -288,6 +290,9 @@ function createD1TurnEventStore(db, options = {}) {
288
290
  ).bind(scopeId, new Date(now() - runningTurnLeaseMs).toISOString()).all();
289
291
  return results.map((r) => r.turnId);
290
292
  },
293
+ async resetEvents(turnId) {
294
+ await db.prepare("DELETE FROM turn_events WHERE turnId = ?").bind(turnId).run();
295
+ },
291
296
  async deleteTurn(turnId) {
292
297
  await runAtomicTurnBatch(db, [
293
298
  db.prepare("DELETE FROM turn_events WHERE turnId = ?").bind(turnId),
@@ -346,6 +351,9 @@ function createMemoryTurnEventStore(options = {}) {
346
351
  return updatedDelta || order.indexOf(right) - order.indexOf(left);
347
352
  });
348
353
  },
354
+ async resetEvents(turnId) {
355
+ events.delete(turnId);
356
+ },
349
357
  async deleteTurn(turnId) {
350
358
  events.delete(turnId);
351
359
  status.delete(turnId);
@@ -388,8 +396,9 @@ export {
388
396
  stampReplaySeq,
389
397
  TURN_EVENTS_MIGRATION_SQL,
390
398
  TURN_STATUS_SCOPE_MIGRATION_SQL,
399
+ TURN_STATUS_LEASE_MIGRATION_SQL,
391
400
  TURN_STATUS_RETENTION_MIGRATION_SQL,
392
401
  createD1TurnEventStore,
393
402
  createMemoryTurnEventStore
394
403
  };
395
- //# sourceMappingURL=chunk-HXTJXODG.js.map
404
+ //# sourceMappingURL=chunk-GBOHTAQH.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\n/** Merge consecutive text/reasoning deltas of the same type into one event.\n * Concatenation-preserving: replaying the coalesced stream produces the same\n * accumulated text as the original. */\nexport function coalesceDeltas(events: unknown[]): unknown[] {\n const out: unknown[] = []\n for (const ev of events) {\n const type = deltaTypeOf(ev)\n const prev = out[out.length - 1]\n if (type && prev && deltaTypeOf(prev) === type) {\n const read = (x: unknown): AnyRecord =>\n ((x as AnyRecord).kind === 'event' ? (x as AnyRecord).event : x) as AnyRecord\n const merged = JSON.parse(JSON.stringify(prev)) as AnyRecord\n read(merged).text = String(read(prev).text) + String(read(ev).text)\n out[out.length - 1] = merged\n continue\n }\n out.push(ev)\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 /** 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. Events\n * received after the handoff flush before this method's caller continues,\n * so a durable owner cannot publish terminal status ahead of an observed\n * event. Call it again when observation ends to flush any 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 */\nexport function createBufferedTurnTap(opts: BufferedTurnOptions): BufferedTurnTap {\n const flushIntervalMs = opts.flushIntervalMs ?? 400\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 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 pending.push(ev)\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(JSON.stringify(ev))\n } catch {\n clientGone = true\n }\n }\n if (detached || Date.now() - lastFlush >= flushIntervalMs) 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 leaseToken TEXT\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/** For deployments whose `turn_status` table predates `leaseToken` — run once\n * to add the column `createD1PlanFollowUpGate` fences its claims on. */\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"]}
@@ -10,7 +10,7 @@ import {
10
10
  import {
11
11
  persistedPartToPlan,
12
12
  planToPersistedPart
13
- } from "./chunk-YJMCRXQQ.js";
13
+ } from "./chunk-LQYIBL3G.js";
14
14
 
15
15
  // src/chat-store/parts.ts
16
16
  function toChatMessageParts(parts) {
@@ -135,4 +135,4 @@ export {
135
135
  buildAttachmentPromptBlock,
136
136
  historyContentWithAttachments
137
137
  };
138
- //# sourceMappingURL=chunk-V4JZ5OYC.js.map
138
+ //# sourceMappingURL=chunk-HTAFI247.js.map
@@ -59,8 +59,8 @@ function planPartKey(planId) {
59
59
  function planRevisionKey(planId, revision) {
60
60
  return `plan:${planId}:revision:${revision}`;
61
61
  }
62
- function planFollowUpTurnId(planId, outcome) {
63
- return `plan:${planId}:${outcome}`;
62
+ function planFollowUpTurnId(planId, revision, outcome) {
63
+ return `${planRevisionKey(planId, revision)}:${outcome}`;
64
64
  }
65
65
  function canTransitionPlanStatus(from, to) {
66
66
  if (from === to) return true;
@@ -98,4 +98,4 @@ export {
98
98
  persistedPartToPlan,
99
99
  parsePlanSubmittedEvent
100
100
  };
101
- //# sourceMappingURL=chunk-YJMCRXQQ.js.map
101
+ //# sourceMappingURL=chunk-LQYIBL3G.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/plans/index.ts"],"sourcesContent":["/**\n * Durable-plan application-shell contract.\n *\n * The sandbox SDK owns the authoritative plan lifecycle and decision APIs.\n * This module only projects that substrate state into chat events and\n * persisted message parts that products can render and restore.\n */\n\nexport const PLAN_SUBMITTED_EVENT = 'plan.submitted' as const\n\n/** Sandbox plan lifecycle. `preparing` is the transient submission state and\n * is retained in the projection even though the chat card normally starts at\n * `pending`. */\nexport type ChatPlanStatus = 'preparing' | 'pending' | 'approved' | 'rejected' | 'superseded' | 'withdrawn'\n\ntype ChatPlanBase = {\n /** The sandbox SDK calls this field `id`; the transcript projection names\n * it explicitly so it cannot collide with a message-part id. */\n planId: string\n revision: number\n title?: string\n body: string\n submittedAt: string\n /** Provider/Sandbox metadata is deliberately opaque to this package. */\n metadata?: Record<string, unknown>\n decidedBy?: string\n}\n\n/** Browser/persisted projection of the sandbox SDK's durable-plan union. */\nexport type ChatPlan = ChatPlanBase & (\n | { status: 'preparing' }\n | { status: 'pending' }\n | { status: 'approved'; decidedAt: string }\n | { status: 'rejected'; decidedAt: string; feedback: string }\n | { status: 'superseded'; supersededAt: string; supersededByPlanId: string }\n | { status: 'withdrawn'; withdrawnAt: string; withdrawnReason: string }\n)\n\n/** Canonical transcript part for one durable plan. */\nexport type ChatPlanPersistedPart = ChatPlan & { type: 'plan' }\n\n/** Resolve the result of parsing a plan submission into success with value or failure with error */\nexport type ParsePlanSubmittedResult =\n | { succeeded: true; value: ChatPlan }\n | { succeeded: false; error: string }\n\nconst PLAN_STATUSES: ReadonlySet<string> = new Set([\n 'preparing',\n 'pending',\n 'approved',\n 'rejected',\n 'superseded',\n 'withdrawn',\n])\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n return value && typeof value === 'object' && !Array.isArray(value)\n ? value as Record<string, unknown>\n : null\n}\n\nfunction requiredString(record: Record<string, unknown>, key: string): string | null {\n const value = record[key]\n return typeof value === 'string' && value ? value : null\n}\n\nfunction parsePlan(record: Record<string, unknown>, defaultStatus?: ChatPlanStatus): ChatPlan | null {\n const planId = requiredString(record, 'planId') ?? requiredString(record, 'id')\n const revision = record.revision\n const body = requiredString(record, 'body')\n const submittedAt = requiredString(record, 'submittedAt')\n const status = typeof record.status === 'string' ? record.status : defaultStatus\n if (\n !planId ||\n typeof revision !== 'number' ||\n !Number.isInteger(revision) ||\n revision < 1 ||\n !body ||\n !submittedAt ||\n !status ||\n !PLAN_STATUSES.has(status)\n ) {\n return null\n }\n\n const common = {\n planId,\n revision,\n ...(typeof record.title === 'string' && record.title ? { title: record.title } : {}),\n body,\n submittedAt,\n ...(record.metadata && typeof record.metadata === 'object' && !Array.isArray(record.metadata)\n ? { metadata: record.metadata as Record<string, unknown> }\n : {}),\n ...(typeof record.decidedBy === 'string' && record.decidedBy ? { decidedBy: record.decidedBy } : {}),\n }\n\n if (status === 'preparing') return { ...common, status: 'preparing' }\n if (status === 'pending') return { ...common, status: 'pending' }\n if (status === 'approved') {\n const decidedAt = requiredString(record, 'decidedAt')\n return decidedAt ? { ...common, status, decidedAt } : null\n }\n if (status === 'rejected') {\n const decidedAt = requiredString(record, 'decidedAt')\n const feedback = requiredString(record, 'feedback')\n return decidedAt && feedback ? { ...common, status, decidedAt, feedback } : null\n }\n if (status === 'superseded') {\n const supersededAt = requiredString(record, 'supersededAt')\n const supersededByPlanId = requiredString(record, 'supersededByPlanId')\n return supersededAt && supersededByPlanId\n ? { ...common, status, supersededAt, supersededByPlanId }\n : null\n }\n\n const withdrawnAt = requiredString(record, 'withdrawnAt')\n const withdrawnReason = requiredString(record, 'withdrawnReason') ?? requiredString(record, 'reason')\n return withdrawnAt && withdrawnReason\n ? { ...common, status: 'withdrawn', withdrawnAt, withdrawnReason }\n : null\n}\n\n/** Generate a unique key string for a given plan identifier */\nexport function planPartKey(planId: string): string {\n return `plan:${planId}`\n}\n\n/** Generate a unique key string for a plan based on its ID and revision number */\nexport function planRevisionKey(planId: string, revision: number): string {\n return `plan:${planId}:revision:${revision}`\n}\n\n/** Generate a unique follow-up turn ID based on the plan ID and its outcome */\nexport function planFollowUpTurnId(planId: string, outcome: 'approved' | 'rejected'): string {\n return `plan:${planId}:${outcome}`\n}\n\n/** Plan status is monotonic: only a pending plan can settle. */\nexport function canTransitionPlanStatus(from: ChatPlanStatus, to: ChatPlanStatus): boolean {\n if (from === to) return true\n if (from === 'preparing') return to === 'pending' || to === 'superseded' || to === 'withdrawn'\n if (from === 'pending') return to === 'approved' || to === 'rejected' || to === 'superseded' || to === 'withdrawn'\n return false\n}\n\n/** Resolve a ChatPlan into its persisted part representation for storage or transmission */\nexport function planToPersistedPart(plan: ChatPlan): ChatPlanPersistedPart {\n return { type: 'plan', ...plan }\n}\n\n/** Resolve a persisted part object into a ChatPlan or return null if the type is not 'plan */\nexport function persistedPartToPlan(part: Record<string, unknown>): ChatPlan | null {\n if (String(part.type ?? '') !== 'plan') return null\n return parsePlan(part)\n}\n\n/** Parses both direct sandbox events (`data.plan`) and session envelopes\n * (`properties.plan`). Session identity is carried by the surrounding stream\n * and is deliberately not required in the payload. */\nexport function parsePlanSubmittedEvent(event: unknown): ParsePlanSubmittedResult {\n const root = asRecord(event)\n if (!root || root.type !== PLAN_SUBMITTED_EVENT) {\n return { succeeded: false, error: 'event is not plan.submitted' }\n }\n const plan = asRecord(asRecord(root.properties)?.plan) ?? asRecord(asRecord(root.data)?.plan)\n if (!plan) {\n return { succeeded: false, error: 'plan.submitted event carried no plan' }\n }\n const parsed = parsePlan(plan, 'pending')\n return parsed\n ? { succeeded: true, value: parsed }\n : { succeeded: false, error: 'plan.submitted event carried a malformed plan' }\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/plans/index.ts"],"sourcesContent":["/**\n * Durable-plan application-shell contract.\n *\n * The sandbox SDK owns the authoritative plan lifecycle and decision APIs.\n * This module only projects that substrate state into chat events and\n * persisted message parts that products can render and restore.\n */\n\nexport const PLAN_SUBMITTED_EVENT = 'plan.submitted' as const\n\n/** Sandbox plan lifecycle. `preparing` is the transient submission state and\n * is retained in the projection even though the chat card normally starts at\n * `pending`. */\nexport type ChatPlanStatus = 'preparing' | 'pending' | 'approved' | 'rejected' | 'superseded' | 'withdrawn'\n\ntype ChatPlanBase = {\n /** The sandbox SDK calls this field `id`; the transcript projection names\n * it explicitly so it cannot collide with a message-part id. */\n planId: string\n revision: number\n title?: string\n body: string\n submittedAt: string\n /** Provider/Sandbox metadata is deliberately opaque to this package. */\n metadata?: Record<string, unknown>\n decidedBy?: string\n}\n\n/** Browser/persisted projection of the sandbox SDK's durable-plan union. */\nexport type ChatPlan = ChatPlanBase & (\n | { status: 'preparing' }\n | { status: 'pending' }\n | { status: 'approved'; decidedAt: string }\n | { status: 'rejected'; decidedAt: string; feedback: string }\n | { status: 'superseded'; supersededAt: string; supersededByPlanId: string }\n | { status: 'withdrawn'; withdrawnAt: string; withdrawnReason: string }\n)\n\n/** Canonical transcript part for one durable plan. */\nexport type ChatPlanPersistedPart = ChatPlan & { type: 'plan' }\n\n/** Resolve the result of parsing a plan submission into success with value or failure with error */\nexport type ParsePlanSubmittedResult =\n | { succeeded: true; value: ChatPlan }\n | { succeeded: false; error: string }\n\nconst PLAN_STATUSES: ReadonlySet<string> = new Set([\n 'preparing',\n 'pending',\n 'approved',\n 'rejected',\n 'superseded',\n 'withdrawn',\n])\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n return value && typeof value === 'object' && !Array.isArray(value)\n ? value as Record<string, unknown>\n : null\n}\n\nfunction requiredString(record: Record<string, unknown>, key: string): string | null {\n const value = record[key]\n return typeof value === 'string' && value ? value : null\n}\n\nfunction parsePlan(record: Record<string, unknown>, defaultStatus?: ChatPlanStatus): ChatPlan | null {\n const planId = requiredString(record, 'planId') ?? requiredString(record, 'id')\n const revision = record.revision\n const body = requiredString(record, 'body')\n const submittedAt = requiredString(record, 'submittedAt')\n const status = typeof record.status === 'string' ? record.status : defaultStatus\n if (\n !planId ||\n typeof revision !== 'number' ||\n !Number.isInteger(revision) ||\n revision < 1 ||\n !body ||\n !submittedAt ||\n !status ||\n !PLAN_STATUSES.has(status)\n ) {\n return null\n }\n\n const common = {\n planId,\n revision,\n ...(typeof record.title === 'string' && record.title ? { title: record.title } : {}),\n body,\n submittedAt,\n ...(record.metadata && typeof record.metadata === 'object' && !Array.isArray(record.metadata)\n ? { metadata: record.metadata as Record<string, unknown> }\n : {}),\n ...(typeof record.decidedBy === 'string' && record.decidedBy ? { decidedBy: record.decidedBy } : {}),\n }\n\n if (status === 'preparing') return { ...common, status: 'preparing' }\n if (status === 'pending') return { ...common, status: 'pending' }\n if (status === 'approved') {\n const decidedAt = requiredString(record, 'decidedAt')\n return decidedAt ? { ...common, status, decidedAt } : null\n }\n if (status === 'rejected') {\n const decidedAt = requiredString(record, 'decidedAt')\n const feedback = requiredString(record, 'feedback')\n return decidedAt && feedback ? { ...common, status, decidedAt, feedback } : null\n }\n if (status === 'superseded') {\n const supersededAt = requiredString(record, 'supersededAt')\n const supersededByPlanId = requiredString(record, 'supersededByPlanId')\n return supersededAt && supersededByPlanId\n ? { ...common, status, supersededAt, supersededByPlanId }\n : null\n }\n\n const withdrawnAt = requiredString(record, 'withdrawnAt')\n const withdrawnReason = requiredString(record, 'withdrawnReason') ?? requiredString(record, 'reason')\n return withdrawnAt && withdrawnReason\n ? { ...common, status: 'withdrawn', withdrawnAt, withdrawnReason }\n : null\n}\n\n/** Generate a unique key string for a given plan identifier */\nexport function planPartKey(planId: string): string {\n return `plan:${planId}`\n}\n\n/** Generate a unique key string for a plan based on its ID and revision number */\nexport function planRevisionKey(planId: string, revision: number): string {\n return `plan:${planId}:revision:${revision}`\n}\n\n/**\n * The follow-up turn the Sandbox platform enqueues when one plan revision is\n * decided. It is revision-qualified because deciding revision 2 must not reuse\n * revision 1's execution and assistant row. The platform mints the same value.\n */\nexport function planFollowUpTurnId(planId: string, revision: number, outcome: 'approved' | 'rejected'): string {\n return `${planRevisionKey(planId, revision)}:${outcome}`\n}\n\n/** Plan status is monotonic: only a pending plan can settle. */\nexport function canTransitionPlanStatus(from: ChatPlanStatus, to: ChatPlanStatus): boolean {\n if (from === to) return true\n if (from === 'preparing') return to === 'pending' || to === 'superseded' || to === 'withdrawn'\n if (from === 'pending') return to === 'approved' || to === 'rejected' || to === 'superseded' || to === 'withdrawn'\n return false\n}\n\n/** Resolve a ChatPlan into its persisted part representation for storage or transmission */\nexport function planToPersistedPart(plan: ChatPlan): ChatPlanPersistedPart {\n return { type: 'plan', ...plan }\n}\n\n/** Resolve a persisted part object into a ChatPlan or return null if the type is not 'plan */\nexport function persistedPartToPlan(part: Record<string, unknown>): ChatPlan | null {\n if (String(part.type ?? '') !== 'plan') return null\n return parsePlan(part)\n}\n\n/** Parses both direct sandbox events (`data.plan`) and session envelopes\n * (`properties.plan`). Session identity is carried by the surrounding stream\n * and is deliberately not required in the payload. */\nexport function parsePlanSubmittedEvent(event: unknown): ParsePlanSubmittedResult {\n const root = asRecord(event)\n if (!root || root.type !== PLAN_SUBMITTED_EVENT) {\n return { succeeded: false, error: 'event is not plan.submitted' }\n }\n const plan = asRecord(asRecord(root.properties)?.plan) ?? asRecord(asRecord(root.data)?.plan)\n if (!plan) {\n return { succeeded: false, error: 'plan.submitted event carried no plan' }\n }\n const parsed = parsePlan(plan, 'pending')\n return parsed\n ? { succeeded: true, value: parsed }\n : { succeeded: false, error: 'plan.submitted event carried a malformed plan' }\n}\n"],"mappings":"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","names":[]}
@@ -7,7 +7,7 @@ import {
7
7
  persistedPartToPlan,
8
8
  planPartKey,
9
9
  planToPersistedPart
10
- } from "./chunk-YJMCRXQQ.js";
10
+ } from "./chunk-LQYIBL3G.js";
11
11
 
12
12
  // src/stream/stream-normalizer.ts
13
13
  function asRecord(value) {
@@ -406,4 +406,4 @@ export {
406
406
  terminalizeDanglingAssistantToolUpdates,
407
407
  encodeEvent
408
408
  };
409
- //# sourceMappingURL=chunk-UII4YDYS.js.map
409
+ //# sourceMappingURL=chunk-N56FWDSP.js.map
@@ -33,7 +33,7 @@ import {
33
33
  } from "./chunk-Q3ZHNN5X.js";
34
34
  import {
35
35
  attachmentPartsFromMessageParts
36
- } from "./chunk-V4JZ5OYC.js";
36
+ } from "./chunk-HTAFI247.js";
37
37
  import {
38
38
  cancelStatusFor,
39
39
  fieldAcceptsFreeText,
@@ -47,7 +47,7 @@ import {
47
47
  import {
48
48
  parsePlanSubmittedEvent,
49
49
  persistedPartToPlan
50
- } from "./chunk-YJMCRXQQ.js";
50
+ } from "./chunk-LQYIBL3G.js";
51
51
 
52
52
  // src/web-react/index.tsx
53
53
  import { useEffect as useEffect13, useMemo as useMemo7, useRef as useRef13, useState as useState18, memo } from "react";
@@ -7491,4 +7491,4 @@ export {
7491
7491
  useThinkingSeconds,
7492
7492
  ChatMessages
7493
7493
  };
7494
- //# sourceMappingURL=chunk-2HEFK764.js.map
7494
+ //# sourceMappingURL=chunk-TNDBW5XG.js.map
@@ -11,10 +11,115 @@ import {
11
11
  } from "../chunk-BOQ4HVVH.js";
12
12
 
13
13
  // src/peer-floors/cli.ts
14
- import { readFileSync } from "fs";
15
- import { join } from "path";
14
+ import { readFileSync as readFileSync2 } from "fs";
15
+ import { join as join2 } from "path";
16
+
17
+ // src/peer-floors/durability-owners.ts
18
+ import { readdirSync, readFileSync } from "fs";
19
+ import { join, relative, sep } from "path";
20
+ var RULES = [
21
+ {
22
+ id: "turn-tables",
23
+ pattern: /\b(?:INSERT\s+(?:OR\s+\w+\s+)?INTO|UPDATE|DELETE\s+FROM)\s+[`"']?(?:turn_status|turn_events)\b/i,
24
+ owner: "TurnEventStore from @tangle-network/agent-app/stream owns turn_status and turn_events (setStatus, resetEvents, deleteTurn, pruneTerminalTurns); createD1PlanFollowUpGate owns follow-up claims."
25
+ },
26
+ {
27
+ id: "session-replay",
28
+ pattern: /\.session\([^)]*\)\s*\.events\(/,
29
+ owner: "Agent App owns session-event attach and replay: streamPlanFollowUpEvents or the sandbox chat producer from @tangle-network/agent-app/chat-routes."
30
+ },
31
+ {
32
+ id: "execution-identity",
33
+ pattern: /['"`]plan-followup-/,
34
+ owner: "planFollowUpExecutionId from @tangle-network/agent-app/chat-routes matches the Sidecar byte for byte."
35
+ }
36
+ ];
37
+ var WAIVER = /agent-app-durability-owner:\s*\S/;
38
+ var SOURCE_FILE = /\.(?:[cm]?[jt]sx?)$/;
39
+ var TEST_FILE = /(?:\.|-)(?:test|spec|stories)\.[cm]?[jt]sx?$/;
40
+ var SKIP_DIRS = /* @__PURE__ */ new Set([
41
+ "node_modules",
42
+ ".git",
43
+ "dist",
44
+ "build",
45
+ "out",
46
+ "coverage",
47
+ ".wrangler",
48
+ ".react-router",
49
+ ".next",
50
+ ".turbo",
51
+ ".cache",
52
+ ".worktrees",
53
+ "storybook-static",
54
+ "test",
55
+ "tests",
56
+ "__tests__",
57
+ "fixtures",
58
+ "fixture_modules",
59
+ "migrations",
60
+ "drizzle",
61
+ "scripts",
62
+ "e2e",
63
+ "evals"
64
+ ]);
65
+ function collect(dir, repoDir, exclude, out) {
66
+ let entries;
67
+ try {
68
+ entries = readdirSync(dir, { withFileTypes: true });
69
+ } catch {
70
+ return;
71
+ }
72
+ for (const entry of entries) {
73
+ const full = join(dir, entry.name);
74
+ const rel = relative(repoDir, full).split(sep).join("/");
75
+ if (exclude.some((prefix) => rel === prefix || rel.startsWith(`${prefix}/`))) continue;
76
+ if (entry.isDirectory()) {
77
+ if (!SKIP_DIRS.has(entry.name)) collect(full, repoDir, exclude, out);
78
+ } else if (entry.isFile() && SOURCE_FILE.test(entry.name) && !TEST_FILE.test(entry.name)) {
79
+ out.push(full);
80
+ }
81
+ }
82
+ }
83
+ function checkDurabilityOwners(options) {
84
+ const files = [];
85
+ collect(options.repoDir, options.repoDir, options.exclude ?? [], files);
86
+ const violations = [];
87
+ let waived = 0;
88
+ for (const file of files) {
89
+ const lines = readFileSync(file, "utf8").split("\n");
90
+ lines.forEach((text, index) => {
91
+ const rule = RULES.find((candidate) => candidate.pattern.test(text));
92
+ if (!rule) return;
93
+ if (lines.slice(Math.max(0, index - 3), index + 1).some((line) => WAIVER.test(line))) {
94
+ waived += 1;
95
+ return;
96
+ }
97
+ violations.push({
98
+ file: relative(options.repoDir, file).split(sep).join("/"),
99
+ line: index + 1,
100
+ rule: rule.id,
101
+ owner: rule.owner,
102
+ text: text.trim()
103
+ });
104
+ });
105
+ }
106
+ return { ok: violations.length === 0, scannedFiles: files.length, waived, violations };
107
+ }
108
+ function formatDurabilityOwnerReport(report) {
109
+ if (report.ok) {
110
+ return `durability owners: ${report.scannedFiles} source files use the shared turn durability` + (report.waived ? ` (${report.waived} named exceptions)` : "");
111
+ }
112
+ return [
113
+ `DURABILITY OWNER VIOLATED: ${report.violations.length} product-local durability primitive(s).`,
114
+ ...report.violations.map((violation) => ` ${violation.file}:${violation.line} [${violation.rule}] ${violation.text}
115
+ use: ${violation.owner}`),
116
+ "Move the behavior to the shared owner, or name a product-only reason with `agent-app-durability-owner: <reason>`."
117
+ ].join("\n");
118
+ }
119
+
120
+ // src/peer-floors/cli.ts
16
121
  function checkDeclaredPins(appDir) {
17
- const manifest = JSON.parse(readFileSync(join(appDir, "package.json"), "utf8"));
122
+ const manifest = JSON.parse(readFileSync2(join2(appDir, "package.json"), "utf8"));
18
123
  const pins = Object.fromEntries(
19
124
  Object.entries({ ...manifest.devDependencies, ...manifest.dependencies }).filter(([name, version]) => name.startsWith("@tangle-network/") && /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(version))
20
125
  );
@@ -76,6 +181,21 @@ function main() {
76
181
  if (!checkDeclaredPins(appDir)) failed = true;
77
182
  } catch (err) {
78
183
  process.stderr.write(`agent-app-peer-check (declared pins) failed: ${err instanceof Error ? err.message : String(err)}
184
+ `);
185
+ failed = true;
186
+ }
187
+ try {
188
+ const durability = checkDurabilityOwners({ repoDir: appDir, exclude });
189
+ const report = formatDurabilityOwnerReport(durability);
190
+ if (durability.ok) process.stdout.write(`${report}
191
+ `);
192
+ else {
193
+ process.stderr.write(`${report}
194
+ `);
195
+ failed = true;
196
+ }
197
+ } catch (err) {
198
+ process.stderr.write(`agent-app-peer-check (durability owners) failed: ${err instanceof Error ? err.message : String(err)}
79
199
  `);
80
200
  failed = true;
81
201
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/peer-floors/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `agent-app-peer-check` — fail a consumer's CI when its dependencies are wrong\n * through installed compatibility, source, and declared-version checks.\n *\n * Runs in the CONSUMER's repo, over the consumer's own tree, because both\n * installed checks only mean anything against a real install. Add it next to\n * typecheck:\n *\n * \"scripts\": { \"peer-check\": \"agent-app-peer-check\" }\n *\n * Three gates, one report, one exit code:\n *\n * PEER FLOORS — is the installed version inside the range the shell\n * declares. `pnpm` only WARNS on an unmet peer that is\n * also a direct dependency and says nothing at all for an\n * unmet optional one.\n * DEPENDENCY SOURCE — is the installed package the one the registry\n * publishes at all. A `file:` tarball, a `link:` out of\n * the repo, or a hand-patched `node_modules` all report\n * the same version as the real release and ship different\n * bytes.\n * DECLARED PINS — do installed exact Tangle versions match the consumer's\n * dependency and development dependency declarations.\n *\n * The source gate runs FIRST and independently: it needs no installed shell, so\n * a repo whose install is broken still gets the answer that explains why.\n *\n * Usage: agent-app-peer-check [repoDir] [--exclude <path>]...\n * `--exclude` takes a repo-relative path prefix the source-tree walk skips —\n * the escape hatch for a repo that genuinely carries a tarball as test data.\n * Exits 1 on any violation, 0 otherwise.\n */\nimport { readFileSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { checkAllPeerFloors, checkPeerFloors, formatPeerFloorReport } from './check'\nimport { checkDependencySources, formatDependencySourceReport } from './dependency-source'\nimport { invokedAsScript } from '../signoff/invoked-as-script'\n\ninterface CliArgs {\n readonly appDir: string\n readonly exclude: readonly string[]\n}\n\n/** Exact consumer pins choose an artifact; engine peer ranges choose compatibility. */\nfunction checkDeclaredPins(appDir: string): boolean {\n const manifest = JSON.parse(readFileSync(join(appDir, 'package.json'), 'utf8')) as {\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n const pins = Object.fromEntries(\n Object.entries({ ...manifest.devDependencies, ...manifest.dependencies })\n .filter(([name, version]) => name.startsWith('@tangle-network/')\n && /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(version)),\n )\n const report = checkPeerFloors({ appDir, shellManifest: { peerDependencies: pins } })\n const installed = report.rows.filter((row) => row.installed !== null)\n const mismatches = installed.filter((row) => row.installed !== row.range)\n for (const row of mismatches) {\n process.stderr.write(`DECLARED PIN VIOLATED: ${row.name} declares ${row.range}, but ${row.installed} is installed. Reinstall from the current frozen lockfile.\\n`)\n }\n if (mismatches.length === 0) {\n process.stdout.write(`declared pins: ${installed.length} installed exact Tangle versions matched\\n`)\n }\n return mismatches.length === 0\n}\n\nexport function parsePeerCheckArgs(argv: readonly string[]): CliArgs {\n const exclude: string[] = []\n let appDir: string | undefined\n for (let i = 0; i < argv.length; i += 1) {\n const arg = argv[i] as string\n if (arg === '--exclude') {\n const value = argv[i + 1]\n if (value) exclude.push(value)\n i += 1\n } else if (arg.startsWith('--exclude=')) {\n exclude.push(arg.slice('--exclude='.length))\n } else if (!arg.startsWith('-') && appDir === undefined) {\n appDir = arg\n }\n }\n return { appDir: appDir ?? process.cwd(), exclude }\n}\n\nfunction main(): void {\n const { appDir, exclude } = parsePeerCheckArgs(process.argv.slice(2))\n let failed = false\n\n try {\n const sources = checkDependencySources({ repoDir: appDir, exclude })\n process.stdout.write(`${formatDependencySourceReport(sources)}\\n\\n`)\n if (!sources.ok) failed = true\n } catch (err) {\n process.stderr.write(`agent-app-peer-check (dependency sources) failed: ${err instanceof Error ? err.message : String(err)}\\n`)\n failed = true\n }\n\n try {\n const reports = checkAllPeerFloors({ appDir })\n process.stdout.write(`${reports.map((report) => formatPeerFloorReport(report)).join('\\n\\n')}\\n`)\n if (reports.some((report) => !report.ok)) failed = true\n } catch (err) {\n process.stderr.write(`agent-app-peer-check (peer floors) failed: ${err instanceof Error ? err.message : String(err)}\\n`)\n failed = true\n }\n\n try {\n if (!checkDeclaredPins(appDir)) failed = true\n } catch (err) {\n process.stderr.write(`agent-app-peer-check (declared pins) failed: ${err instanceof Error ? err.message : String(err)}\\n`)\n failed = true\n }\n\n process.exit(failed ? 1 : 0)\n}\n\n/* c8 ignore start — process wiring, exercised by the bin itself */\nif (invokedAsScript(import.meta.url, process.argv[1])) main()\n/* c8 ignore stop */\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../src/peer-floors/cli.ts","../../src/peer-floors/durability-owners.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `agent-app-peer-check` — fail a consumer's CI when its dependencies are wrong\n * through installed compatibility, source, and declared-version checks.\n *\n * Runs in the CONSUMER's repo, over the consumer's own tree, because both\n * installed checks only mean anything against a real install. Add it next to\n * typecheck:\n *\n * \"scripts\": { \"peer-check\": \"agent-app-peer-check\" }\n *\n * Four gates, one report, one exit code:\n *\n * PEER FLOORS — is the installed version inside the range the shell\n * declares. `pnpm` only WARNS on an unmet peer that is\n * also a direct dependency and says nothing at all for an\n * unmet optional one.\n * DEPENDENCY SOURCE — is the installed package the one the registry\n * publishes at all. A `file:` tarball, a `link:` out of\n * the repo, or a hand-patched `node_modules` all report\n * the same version as the real release and ship different\n * bytes.\n * DECLARED PINS — do installed exact Tangle versions match the consumer's\n * dependency and development dependency declarations.\n * DURABILITY OWNERS — does product source write the shared turn tables,\n * open its own session-event replay, or mint follow-up\n * execution ids that Agent App already owns.\n *\n * The source gate runs FIRST and independently: it needs no installed shell, so\n * a repo whose install is broken still gets the answer that explains why.\n *\n * Usage: agent-app-peer-check [repoDir] [--exclude <path>]...\n * `--exclude` takes a repo-relative path prefix the source-tree walk skips —\n * the escape hatch for a repo that genuinely carries a tarball as test data.\n * Exits 1 on any violation, 0 otherwise.\n */\nimport { readFileSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { checkAllPeerFloors, checkPeerFloors, formatPeerFloorReport } from './check'\nimport { checkDependencySources, formatDependencySourceReport } from './dependency-source'\nimport { checkDurabilityOwners, formatDurabilityOwnerReport } from './durability-owners'\nimport { invokedAsScript } from '../signoff/invoked-as-script'\n\ninterface CliArgs {\n readonly appDir: string\n readonly exclude: readonly string[]\n}\n\n/** Exact consumer pins choose an artifact; engine peer ranges choose compatibility. */\nfunction checkDeclaredPins(appDir: string): boolean {\n const manifest = JSON.parse(readFileSync(join(appDir, 'package.json'), 'utf8')) as {\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n const pins = Object.fromEntries(\n Object.entries({ ...manifest.devDependencies, ...manifest.dependencies })\n .filter(([name, version]) => name.startsWith('@tangle-network/')\n && /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(version)),\n )\n const report = checkPeerFloors({ appDir, shellManifest: { peerDependencies: pins } })\n const installed = report.rows.filter((row) => row.installed !== null)\n const mismatches = installed.filter((row) => row.installed !== row.range)\n for (const row of mismatches) {\n process.stderr.write(`DECLARED PIN VIOLATED: ${row.name} declares ${row.range}, but ${row.installed} is installed. Reinstall from the current frozen lockfile.\\n`)\n }\n if (mismatches.length === 0) {\n process.stdout.write(`declared pins: ${installed.length} installed exact Tangle versions matched\\n`)\n }\n return mismatches.length === 0\n}\n\nexport function parsePeerCheckArgs(argv: readonly string[]): CliArgs {\n const exclude: string[] = []\n let appDir: string | undefined\n for (let i = 0; i < argv.length; i += 1) {\n const arg = argv[i] as string\n if (arg === '--exclude') {\n const value = argv[i + 1]\n if (value) exclude.push(value)\n i += 1\n } else if (arg.startsWith('--exclude=')) {\n exclude.push(arg.slice('--exclude='.length))\n } else if (!arg.startsWith('-') && appDir === undefined) {\n appDir = arg\n }\n }\n return { appDir: appDir ?? process.cwd(), exclude }\n}\n\nfunction main(): void {\n const { appDir, exclude } = parsePeerCheckArgs(process.argv.slice(2))\n let failed = false\n\n try {\n const sources = checkDependencySources({ repoDir: appDir, exclude })\n process.stdout.write(`${formatDependencySourceReport(sources)}\\n\\n`)\n if (!sources.ok) failed = true\n } catch (err) {\n process.stderr.write(`agent-app-peer-check (dependency sources) failed: ${err instanceof Error ? err.message : String(err)}\\n`)\n failed = true\n }\n\n try {\n const reports = checkAllPeerFloors({ appDir })\n process.stdout.write(`${reports.map((report) => formatPeerFloorReport(report)).join('\\n\\n')}\\n`)\n if (reports.some((report) => !report.ok)) failed = true\n } catch (err) {\n process.stderr.write(`agent-app-peer-check (peer floors) failed: ${err instanceof Error ? err.message : String(err)}\\n`)\n failed = true\n }\n\n try {\n if (!checkDeclaredPins(appDir)) failed = true\n } catch (err) {\n process.stderr.write(`agent-app-peer-check (declared pins) failed: ${err instanceof Error ? err.message : String(err)}\\n`)\n failed = true\n }\n\n try {\n const durability = checkDurabilityOwners({ repoDir: appDir, exclude })\n const report = formatDurabilityOwnerReport(durability)\n if (durability.ok) process.stdout.write(`${report}\\n`)\n else {\n process.stderr.write(`${report}\\n`)\n failed = true\n }\n } catch (err) {\n process.stderr.write(`agent-app-peer-check (durability owners) failed: ${err instanceof Error ? err.message : String(err)}\\n`)\n failed = true\n }\n\n process.exit(failed ? 1 : 0)\n}\n\n/* c8 ignore start — process wiring, exercised by the bin itself */\nif (invokedAsScript(import.meta.url, process.argv[1])) main()\n/* c8 ignore stop */\n","/**\n * DURABILITY OWNERS — products must not grow their own turn durability.\n *\n * Agent App owns the turn event buffer and status rows, running-turn claims,\n * detached-turn crash recovery and the session-event attach that replays an\n * execution. A product that writes those tables, opens its own session-event\n * replay loop or mints a follow-up execution id forks recovery semantics the\n * shared owner tests, and the fork drifts: four copies of the plan follow-up\n * attach had three different execution identities before they were merged.\n *\n * The scan reads product source (not tests, migrations or build output). A\n * line that must stay product-local carries `agent-app-durability-owner:\n * <reason>` on it or within the three lines above it, so every exception is\n * named where a reviewer sees it.\n */\nimport { readdirSync, readFileSync } from 'node:fs'\nimport { join, relative, sep } from 'node:path'\n\ninterface DurabilityRule {\n readonly id: string\n readonly pattern: RegExp\n readonly owner: string\n}\n\nconst RULES: readonly DurabilityRule[] = [\n {\n id: 'turn-tables',\n pattern: /\\b(?:INSERT\\s+(?:OR\\s+\\w+\\s+)?INTO|UPDATE|DELETE\\s+FROM)\\s+[`\"']?(?:turn_status|turn_events)\\b/i,\n owner: 'TurnEventStore from @tangle-network/agent-app/stream owns turn_status and turn_events '\n + '(setStatus, resetEvents, deleteTurn, pruneTerminalTurns); createD1PlanFollowUpGate owns follow-up claims.',\n },\n {\n id: 'session-replay',\n pattern: /\\.session\\([^)]*\\)\\s*\\.events\\(/,\n owner: 'Agent App owns session-event attach and replay: streamPlanFollowUpEvents or the sandbox chat producer '\n + 'from @tangle-network/agent-app/chat-routes.',\n },\n {\n id: 'execution-identity',\n pattern: /['\"`]plan-followup-/,\n owner: 'planFollowUpExecutionId from @tangle-network/agent-app/chat-routes matches the Sidecar byte for byte.',\n },\n]\n\nconst WAIVER = /agent-app-durability-owner:\\s*\\S/\nconst SOURCE_FILE = /\\.(?:[cm]?[jt]sx?)$/\nconst TEST_FILE = /(?:\\.|-)(?:test|spec|stories)\\.[cm]?[jt]sx?$/\nconst SKIP_DIRS = new Set([\n 'node_modules', '.git', 'dist', 'build', 'out', 'coverage', '.wrangler', '.react-router', '.next',\n '.turbo', '.cache', '.worktrees', 'storybook-static', 'test', 'tests', '__tests__', 'fixtures',\n 'fixture_modules', 'migrations', 'drizzle', 'scripts', 'e2e', 'evals',\n])\n\n/** One product-local durability primitive the shared owner already provides. */\ninterface DurabilityOwnerViolation {\n readonly file: string\n readonly line: number\n readonly rule: string\n readonly owner: string\n readonly text: string\n}\n\n/** Result of one durability-owner scan. */\nexport interface DurabilityOwnerReport {\n readonly ok: boolean\n readonly scannedFiles: number\n readonly waived: number\n readonly violations: readonly DurabilityOwnerViolation[]\n}\n\nfunction collect(dir: string, repoDir: string, exclude: readonly string[], out: string[]): void {\n let entries: import('node:fs').Dirent[]\n try {\n entries = readdirSync(dir, { withFileTypes: true })\n } catch {\n return\n }\n for (const entry of entries) {\n const full = join(dir, entry.name)\n const rel = relative(repoDir, full).split(sep).join('/')\n if (exclude.some((prefix) => rel === prefix || rel.startsWith(`${prefix}/`))) continue\n if (entry.isDirectory()) {\n if (!SKIP_DIRS.has(entry.name)) collect(full, repoDir, exclude, out)\n } else if (entry.isFile() && SOURCE_FILE.test(entry.name) && !TEST_FILE.test(entry.name)) {\n out.push(full)\n }\n }\n}\n\n/** Scan a product checkout for durability primitives Agent App owns. */\nexport function checkDurabilityOwners(options: {\n repoDir: string\n exclude?: readonly string[]\n}): DurabilityOwnerReport {\n const files: string[] = []\n collect(options.repoDir, options.repoDir, options.exclude ?? [], files)\n const violations: DurabilityOwnerViolation[] = []\n let waived = 0\n for (const file of files) {\n const lines = readFileSync(file, 'utf8').split('\\n')\n lines.forEach((text, index) => {\n const rule = RULES.find((candidate) => candidate.pattern.test(text))\n if (!rule) return\n if (lines.slice(Math.max(0, index - 3), index + 1).some((line) => WAIVER.test(line))) {\n waived += 1\n return\n }\n violations.push({\n file: relative(options.repoDir, file).split(sep).join('/'),\n line: index + 1,\n rule: rule.id,\n owner: rule.owner,\n text: text.trim(),\n })\n })\n }\n return { ok: violations.length === 0, scannedFiles: files.length, waived, violations }\n}\n\n/** Human report for the peer-check CLI. */\nexport function formatDurabilityOwnerReport(report: DurabilityOwnerReport): string {\n if (report.ok) {\n return `durability owners: ${report.scannedFiles} source files use the shared turn durability`\n + (report.waived ? ` (${report.waived} named exceptions)` : '')\n }\n return [\n `DURABILITY OWNER VIOLATED: ${report.violations.length} product-local durability primitive(s).`,\n ...report.violations.map((violation) =>\n ` ${violation.file}:${violation.line} [${violation.rule}] ${violation.text}\\n use: ${violation.owner}`),\n 'Move the behavior to the shared owner, or name a product-only reason with `agent-app-durability-owner: <reason>`.',\n ].join('\\n')\n}\n"],"mappings":"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","names":["readFileSync","join","readFileSync","join"]}