@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/services/durableQueue/index.mjs

@@ -0,0 +1,149 @@
+import { HeldQueueDoc } from "./docs.mjs";
+import { CompactionTask, GenerationTask, InboxDoc, LiveDoc, UserEntry } from "@earendil-works/pi-durable";
+//#region src/services/durableQueue/index.ts
+/** pi-durable deduplicates by request ID, so a held input can be handed over again after a crash. */
+const heldRequestId = (id) => `po.queue:${id}`;
+/** The pi.inbox content of a held or freshly submitted input. */
+function heldContent(message, images) {
+	if (typeof message !== "string") {
+		if (message.role !== "user") throw new Error("Only user messages can admit an agent run");
+		return message.content;
+	}
+	return images?.length ? [{
+		type: "text",
+		text: message
+	}, ...images] : message;
+}
+/** Appends the entry an input is placed as: `entry`'s kind and data, or `pi.user`, as pi-durable's own boundary does. */
+function appendInput(tx, conversationId, content, entry, now) {
+	const model = [{
+		role: "user",
+		content,
+		timestamp: now
+	}];
+	return entry ? tx.appendEntry(conversationId, {
+		kind: entry.kind,
+		...entry.data === void 0 ? {} : { data: entry.data },
+		model
+	}) : tx.appendEntry(UserEntry, conversationId, { model });
+}
+/**
+* Promotes one explicitly queued input to steer its operation, or starts it from idle, in one commit with only public
+* Tx operations: target validation and the move from held to pi.inbox happen on the same Session mutation line.
+*
+* Mirrors pi-durable `harness/inbox.d.ts:42-52` (`prepareBoundary`/`applyBoundary` at `final`) and `admitSubmission`
+* in `harness/submissions.js`, which pi-durable does not export. Re-run the promote tests on every pi-durable upgrade.
+*/
+async function admitSelected(tx, conversationId, selection, modes, replay) {
+	const doc = await tx.doc(HeldQueueDoc);
+	const record = JSON.parse(doc.json);
+	const requestId = heldRequestId(selection.id);
+	const accepted = await tx.submissionByRequest(conversationId, requestId);
+	if (accepted && accepted.type !== "input") throw new Error(`Request ${requestId} already identifies a submission of type ${accepted.type}`);
+	if (accepted && replay) return accepted.id;
+	if (accepted) return accepted.status === "queued" ? "in_flight" : "not_found";
+	const index = record.held.findIndex((q) => q.id === selection.id && q.explicitQueue);
+	if (index === -1) return "not_found";
+	const q = record.held[index];
+	const live = await tx.doc(LiveDoc, conversationId);
+	const task = live.run ? await tx.task(live.run.taskId) : void 0;
+	if ((live.run ? String(live.run.inputs[0]) : void 0) !== selection.operationId || task?.abortRequested || live.run && record.abortOperationId === selection.operationId) return "target_changed";
+	if (!live.run) {
+		let page = await tx.scanTasks({
+			conversationId,
+			kind: CompactionTask.definition.name,
+			background: false
+		}, 128);
+		while (true) {
+			if (page.items.some((task) => task.state.status !== "terminal")) return "target_changed";
+			if (!page.next) break;
+			page = await tx.scanTasks({
+				conversationId,
+				kind: CompactionTask.definition.name,
+				background: false
+			}, 128, page.next);
+		}
+	}
+	const content = heldContent(q.message ?? q.text, q.images);
+	const inbox = await tx.doc(InboxDoc, conversationId);
+	let head = live.run ? void 0 : (await tx.latestHeadMarker(conversationId))?.head;
+	const now = Date.now();
+	let id;
+	if (!live.run && inbox.items.length === 0) {
+		const entry = await appendInput(tx, conversationId, content, q.entry, now);
+		id = (await tx.createSubmission({
+			conversationId,
+			requestId,
+			type: "input",
+			status: "placed",
+			entry: entry.id
+		})).id;
+		live.run = {
+			taskId: await tx.createTask(GenerationTask, {}, {
+				ownership: { kind: "conversation" },
+				conversationId
+			}),
+			inputs: [id]
+		};
+	} else {
+		id = (await tx.createSubmission({
+			conversationId,
+			requestId,
+			type: "input",
+			status: "queued"
+		})).id;
+		inbox.items.push({
+			id,
+			mode: "steer",
+			content: JSON.parse(JSON.stringify(content)),
+			...q.entry ? { entry: JSON.parse(JSON.stringify(q.entry)) } : {}
+		});
+		if (!live.run) {
+			const writes = inbox.items.flatMap((item, index) => item.mode === "write" ? [index] : []);
+			const pick = (mode) => {
+				const indexes = inbox.items.flatMap((item, index) => item.mode === mode ? [index] : []);
+				return (mode === "steer" ? modes.steeringMode : modes.followUpMode) === "all" ? indexes : indexes.slice(0, 1);
+			};
+			const users = [...pick("steer"), ...pick("followUp")].sort((a, b) => a - b);
+			for (const index of writes) {
+				const item = inbox.items[index];
+				if (item.mode !== "write") continue;
+				const draft = item.entry;
+				if (typeof draft.head === "number" && head !== void 0 && draft.head < head) {
+					tx.settleSubmission(item.id, {
+						status: "unanswered",
+						reason: "stale"
+					});
+					continue;
+				}
+				const entry = await tx.appendEntry(conversationId, draft);
+				if (draft.head !== void 0) head = draft.head === "self" ? entry.id : draft.head;
+				tx.placeSubmission(item.id, entry.id);
+			}
+			const inputs = [];
+			for (const index of users) {
+				const item = inbox.items[index];
+				if (item.mode === "write") continue;
+				const entry = await appendInput(tx, conversationId, item.content, item.entry, now);
+				tx.placeSubmission(item.id, entry.id);
+				inputs.push(item.id);
+			}
+			for (const index of [...writes, ...users].sort((a, b) => b - a)) inbox.items.splice(index, 1);
+			if (inputs.length) live.run = {
+				taskId: await tx.createTask(GenerationTask, {}, {
+					ownership: { kind: "conversation" },
+					conversationId
+				}),
+				inputs
+			};
+		}
+	}
+	record.held.splice(index, 1);
+	record.revision++;
+	doc.json = JSON.stringify(record);
+	return id;
+}
+//#endregion
+export { admitSelected, heldContent, heldRequestId };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/durableQueue/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/durableQueue/index.ts"],"sourcesContent":["/**\n * Po's queue around pi.inbox. Follow-ups that are not paused go straight to pi.inbox; only paused and explicitly\n * queued inputs stay in `po.queue.held`, and a held input enters pi.inbox under its stable request ID.\n */\nimport type { ImageContent } from '@earendil-works/pi-ai';\nimport {\n  CompactionTask,\n  GenerationTask,\n  InboxDoc,\n  LiveDoc,\n  UserEntry,\n  type Conversation,\n  type ConversationId,\n  type HarnessSettings,\n  type InputEntry,\n  type SubmissionId,\n  type Tx,\n} from '@earendil-works/pi-durable';\n\nimport type { AgentMessage, DirectHarnessQueuedInput } from '../../types/server/directHarnessRuntime';\nimport { HeldQueueDoc } from './docs';\n\nexport type HeldInput = Omit<DirectHarnessQueuedInput, 'disposition'> & {\n  message?: AgentMessage;\n  // The entry the input is placed as instead of `pi.user`, kept when an abort moves a queued input here.\n  entry?: InputEntry;\n  // Only explicitly queued inputs are visible to, and removable or promotable by, the operator.\n  explicitQueue: boolean;\n};\nexport type HeldQueue = { revision: number; paused: boolean; abortOperationId?: string; held: HeldInput[] };\n\n/** pi-durable deduplicates by request ID, so a held input can be handed over again after a crash. */\nexport const heldRequestId = (id: string) => `po.queue:${id}`;\n\n/** The pi.inbox content of a held or freshly submitted input. */\nexport function heldContent(message: string | AgentMessage, images?: ImageContent[]) {\n  if (typeof message !== 'string') {\n    if (message.role !== 'user') throw new Error('Only user messages can admit an agent run');\n    return message.content;\n  }\n  return images?.length ? [{ type: 'text' as const, text: message }, ...images] : message;\n}\n\n/** Appends the entry an input is placed as: `entry`'s kind and data, or `pi.user`, as pi-durable's own boundary does. */\nfunction appendInput(\n  tx: Tx,\n  conversationId: ConversationId,\n  content: ReturnType<typeof heldContent>,\n  entry: InputEntry | undefined,\n  now: number,\n) {\n  const model = [{ role: 'user' as const, content, timestamp: now }];\n  return entry\n    ? tx.appendEntry(conversationId, {\n        kind: entry.kind,\n        ...(entry.data === undefined ? {} : { data: entry.data }),\n        model,\n      })\n    : tx.appendEntry(UserEntry, conversationId, { model });\n}\n\n/**\n * Promotes one explicitly queued input to steer its operation, or starts it from idle, in one commit with only public\n * Tx operations: target validation and the move from held to pi.inbox happen on the same Session mutation line.\n *\n * Mirrors pi-durable `harness/inbox.d.ts:42-52` (`prepareBoundary`/`applyBoundary` at `final`) and `admitSubmission`\n * in `harness/submissions.js`, which pi-durable does not export. Re-run the promote tests on every pi-durable upgrade.\n */\nexport async function admitSelected(\n  tx: Tx,\n  conversationId: ConversationId,\n  selection: { id: string; operationId?: string },\n  modes: Pick<HarnessSettings, 'steeringMode' | 'followUpMode'>,\n  replay: boolean,\n): Promise<SubmissionId | 'not_found' | 'in_flight' | 'target_changed'> {\n  const doc = await tx.doc(HeldQueueDoc);\n  const record = JSON.parse(doc.json) as HeldQueue;\n  const requestId = heldRequestId(selection.id);\n  // An accepted request survives completion/replacement and a lost acknowledgement.\n  const accepted = await tx.submissionByRequest(conversationId, requestId);\n  if (accepted && accepted.type !== 'input')\n    throw new Error(`Request ${requestId} already identifies a submission of type ${accepted.type}`);\n  if (accepted && replay) return accepted.id;\n  if (accepted) return accepted.status === 'queued' ? 'in_flight' : 'not_found';\n  const index = record.held.findIndex((q) => q.id === selection.id && q.explicitQueue);\n  if (index === -1) return 'not_found';\n  const q = record.held[index]!;\n  const live = await tx.doc(LiveDoc, conversationId);\n  const task = live.run ? await tx.task(live.run.taskId) : undefined;\n  if (\n    (live.run ? String(live.run.inputs[0]) : undefined) !== selection.operationId ||\n    task?.abortRequested ||\n    (live.run && record.abortOperationId === selection.operationId)\n  )\n    return 'target_changed';\n  if (!live.run) {\n    let page = await tx.scanTasks({ conversationId, kind: CompactionTask.definition.name, background: false }, 128);\n    while (true) {\n      if (page.items.some((task) => task.state.status !== 'terminal')) return 'target_changed';\n      if (!page.next) break;\n      page = await tx.scanTasks(\n        { conversationId, kind: CompactionTask.definition.name, background: false },\n        128,\n        page.next,\n      );\n    }\n  }\n  const content = heldContent(q.message ?? q.text, q.images);\n  const inbox = await tx.doc(InboxDoc, conversationId);\n  // Native final boundaries read the active head before any table writes.\n  let head = live.run ? undefined : (await tx.latestHeadMarker(conversationId))?.head;\n  const now = Date.now();\n  let id: SubmissionId;\n  if (!live.run && inbox.items.length === 0) {\n    const entry = await appendInput(tx, conversationId, content, q.entry, now);\n    id = (await tx.createSubmission({ conversationId, requestId, type: 'input', status: 'placed', entry: entry.id }))\n      .id;\n    live.run = {\n      taskId: await tx.createTask(GenerationTask, {}, { ownership: { kind: 'conversation' }, conversationId }),\n      inputs: [id],\n    };\n  } else {\n    id = (await tx.createSubmission({ conversationId, requestId, type: 'input', status: 'queued' })).id;\n    inbox.items.push({\n      id,\n      mode: 'steer',\n      content: JSON.parse(JSON.stringify(content)) as typeof content,\n      ...(q.entry ? { entry: JSON.parse(JSON.stringify(q.entry)) as InputEntry } : {}),\n    });\n    if (!live.run) {\n      // Preserve native write-first placement, stale heads, queue modes and\n      // positional input order rather than restarting just the selected input.\n      const writes = inbox.items.flatMap((item, index) => (item.mode === 'write' ? [index] : []));\n      const pick = (mode: 'steer' | 'followUp') => {\n        const indexes = inbox.items.flatMap((item, index) => (item.mode === mode ? [index] : []));\n        const queueMode = mode === 'steer' ? modes.steeringMode : modes.followUpMode;\n        return queueMode === 'all' ? indexes : indexes.slice(0, 1);\n      };\n      const users = [...pick('steer'), ...pick('followUp')].sort((a, b) => a - b);\n      for (const index of writes) {\n        const item = inbox.items[index]!;\n        if (item.mode !== 'write') continue;\n        // Public InboxDoc represents native write drafts as JsonObject.\n        const draft = item.entry as unknown as Extract<\n          Parameters<Conversation['submit']>[0],\n          { type: 'write' }\n        >['entry'];\n        if (typeof draft.head === 'number' && head !== undefined && draft.head < head) {\n          tx.settleSubmission(item.id, { status: 'unanswered', reason: 'stale' });\n          continue;\n        }\n        const entry = await tx.appendEntry(conversationId, draft);\n        if (draft.head !== undefined) head = draft.head === 'self' ? entry.id : draft.head;\n        tx.placeSubmission(item.id, entry.id);\n      }\n      const inputs: SubmissionId[] = [];\n      for (const index of users) {\n        const item = inbox.items[index]!;\n        if (item.mode === 'write') continue;\n        const entry = await appendInput(tx, conversationId, item.content, item.entry, now);\n        tx.placeSubmission(item.id, entry.id);\n        inputs.push(item.id);\n      }\n      for (const index of [...writes, ...users].sort((a, b) => b - a)) inbox.items.splice(index, 1);\n      if (inputs.length)\n        live.run = {\n          taskId: await tx.createTask(GenerationTask, {}, { ownership: { kind: 'conversation' }, conversationId }),\n          inputs,\n        };\n    }\n  }\n  record.held.splice(index, 1);\n  record.revision++;\n  doc.json = JSON.stringify(record);\n  return id;\n}\n"],"mappings":";;;;AAgCA,MAAa,iBAAiB,OAAe,YAAY;;AAGzD,SAAgB,YAAY,SAAgC,QAAyB;CACnF,IAAI,OAAO,YAAY,UAAU;EAC/B,IAAI,QAAQ,SAAS,QAAQ,MAAM,IAAI,MAAM,2CAA2C;EACxF,OAAO,QAAQ;CACjB;CACA,OAAO,QAAQ,SAAS,CAAC;EAAE,MAAM;EAAiB,MAAM;CAAQ,GAAG,GAAG,MAAM,IAAI;AAClF;;AAGA,SAAS,YACP,IACA,gBACA,SACA,OACA,KACA;CACA,MAAM,QAAQ,CAAC;EAAE,MAAM;EAAiB;EAAS,WAAW;CAAI,CAAC;CACjE,OAAO,QACH,GAAG,YAAY,gBAAgB;EAC7B,MAAM,MAAM;EACZ,GAAI,MAAM,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;EACvD;CACF,CAAC,IACD,GAAG,YAAY,WAAW,gBAAgB,EAAE,MAAM,CAAC;AACzD;;;;;;;;AASA,eAAsB,cACpB,IACA,gBACA,WACA,OACA,QACsE;CACtE,MAAM,MAAM,MAAM,GAAG,IAAI,YAAY;CACrC,MAAM,SAAS,KAAK,MAAM,IAAI,IAAI;CAClC,MAAM,YAAY,cAAc,UAAU,EAAE;CAE5C,MAAM,WAAW,MAAM,GAAG,oBAAoB,gBAAgB,SAAS;CACvE,IAAI,YAAY,SAAS,SAAS,SAChC,MAAM,IAAI,MAAM,WAAW,UAAU,2CAA2C,SAAS,MAAM;CACjG,IAAI,YAAY,QAAQ,OAAO,SAAS;CACxC,IAAI,UAAU,OAAO,SAAS,WAAW,WAAW,cAAc;CAClE,MAAM,QAAQ,OAAO,KAAK,WAAW,MAAM,EAAE,OAAO,UAAU,MAAM,EAAE,aAAa;CACnF,IAAI,UAAU,IAAI,OAAO;CACzB,MAAM,IAAI,OAAO,KAAK;CACtB,MAAM,OAAO,MAAM,GAAG,IAAI,SAAS,cAAc;CACjD,MAAM,OAAO,KAAK,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,MAAM,IAAI,KAAA;CACzD,KACG,KAAK,MAAM,OAAO,KAAK,IAAI,OAAO,EAAE,IAAI,KAAA,OAAe,UAAU,eAClE,MAAM,kBACL,KAAK,OAAO,OAAO,qBAAqB,UAAU,aAEnD,OAAO;CACT,IAAI,CAAC,KAAK,KAAK;EACb,IAAI,OAAO,MAAM,GAAG,UAAU;GAAE;GAAgB,MAAM,eAAe,WAAW;GAAM,YAAY;EAAM,GAAG,GAAG;EAC9G,OAAO,MAAM;GACX,IAAI,KAAK,MAAM,MAAM,SAAS,KAAK,MAAM,WAAW,UAAU,GAAG,OAAO;GACxE,IAAI,CAAC,KAAK,MAAM;GAChB,OAAO,MAAM,GAAG,UACd;IAAE;IAAgB,MAAM,eAAe,WAAW;IAAM,YAAY;GAAM,GAC1E,KACA,KAAK,IACP;EACF;CACF;CACA,MAAM,UAAU,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;CACzD,MAAM,QAAQ,MAAM,GAAG,IAAI,UAAU,cAAc;CAEnD,IAAI,OAAO,KAAK,MAAM,KAAA,KAAa,MAAM,GAAG,iBAAiB,cAAc,EAAA,EAAI;CAC/E,MAAM,MAAM,KAAK,IAAI;CACrB,IAAI;CACJ,IAAI,CAAC,KAAK,OAAO,MAAM,MAAM,WAAW,GAAG;EACzC,MAAM,QAAQ,MAAM,YAAY,IAAI,gBAAgB,SAAS,EAAE,OAAO,GAAG;EACzE,MAAM,MAAM,GAAG,iBAAiB;GAAE;GAAgB;GAAW,MAAM;GAAS,QAAQ;GAAU,OAAO,MAAM;EAAG,CAAC,EAAA,CAC5G;EACH,KAAK,MAAM;GACT,QAAQ,MAAM,GAAG,WAAW,gBAAgB,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,eAAe;IAAG;GAAe,CAAC;GACvG,QAAQ,CAAC,EAAE;EACb;CACF,OAAO;EACL,MAAM,MAAM,GAAG,iBAAiB;GAAE;GAAgB;GAAW,MAAM;GAAS,QAAQ;EAAS,CAAC,EAAA,CAAG;EACjG,MAAM,MAAM,KAAK;GACf;GACA,MAAM;GACN,SAAS,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC;GAC3C,GAAI,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,KAAK,UAAU,EAAE,KAAK,CAAC,EAAgB,IAAI,CAAC;EAChF,CAAC;EACD,IAAI,CAAC,KAAK,KAAK;GAGb,MAAM,SAAS,MAAM,MAAM,SAAS,MAAM,UAAW,KAAK,SAAS,UAAU,CAAC,KAAK,IAAI,CAAC,CAAE;GAC1F,MAAM,QAAQ,SAA+B;IAC3C,MAAM,UAAU,MAAM,MAAM,SAAS,MAAM,UAAW,KAAK,SAAS,OAAO,CAAC,KAAK,IAAI,CAAC,CAAE;IAExF,QADkB,SAAS,UAAU,MAAM,eAAe,MAAM,kBAC3C,QAAQ,UAAU,QAAQ,MAAM,GAAG,CAAC;GAC3D;GACA,MAAM,QAAQ,CAAC,GAAG,KAAK,OAAO,GAAG,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;GAC1E,KAAK,MAAM,SAAS,QAAQ;IAC1B,MAAM,OAAO,MAAM,MAAM;IACzB,IAAI,KAAK,SAAS,SAAS;IAE3B,MAAM,QAAQ,KAAK;IAInB,IAAI,OAAO,MAAM,SAAS,YAAY,SAAS,KAAA,KAAa,MAAM,OAAO,MAAM;KAC7E,GAAG,iBAAiB,KAAK,IAAI;MAAE,QAAQ;MAAc,QAAQ;KAAQ,CAAC;KACtE;IACF;IACA,MAAM,QAAQ,MAAM,GAAG,YAAY,gBAAgB,KAAK;IACxD,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,MAAM,SAAS,SAAS,MAAM,KAAK,MAAM;IAC9E,GAAG,gBAAgB,KAAK,IAAI,MAAM,EAAE;GACtC;GACA,MAAM,SAAyB,CAAC;GAChC,KAAK,MAAM,SAAS,OAAO;IACzB,MAAM,OAAO,MAAM,MAAM;IACzB,IAAI,KAAK,SAAS,SAAS;IAC3B,MAAM,QAAQ,MAAM,YAAY,IAAI,gBAAgB,KAAK,SAAS,KAAK,OAAO,GAAG;IACjF,GAAG,gBAAgB,KAAK,IAAI,MAAM,EAAE;IACpC,OAAO,KAAK,KAAK,EAAE;GACrB;GACA,KAAK,MAAM,SAAS,CAAC,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM,MAAM,OAAO,OAAO,CAAC;GAC5F,IAAI,OAAO,QACT,KAAK,MAAM;IACT,QAAQ,MAAM,GAAG,WAAW,gBAAgB,CAAC,GAAG;KAAE,WAAW,EAAE,MAAM,eAAe;KAAG;IAAe,CAAC;IACvG;GACF;EACJ;CACF;CACA,OAAO,KAAK,OAAO,OAAO,CAAC;CAC3B,OAAO;CACP,IAAI,OAAO,KAAK,UAAU,MAAM;CAChC,OAAO;AACT"}

package/dist/src/services/durableRequestReceipts/docs.cjs

@@ -0,0 +1,11 @@
+//#region src/services/durableRequestReceipts/docs.ts
+const ReceiptsDoc = (0, require("@earendil-works/pi-durable").defineDoc)({
+	kind: "po.request-receipts",
+	version: 1,
+	scope: "session",
+	initial: () => ({ receipts: {} })
+});
+//#endregion
+exports.ReceiptsDoc = ReceiptsDoc;
+
+//# sourceMappingURL=docs.cjs.map

package/dist/src/services/durableRequestReceipts/docs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cjs","names":["defineDoc"],"sources":["../../../../src/services/durableRequestReceipts/docs.ts"],"sourcesContent":["import { defineDoc, type JsonObject } from '@earendil-works/pi-durable';\n\nexport const ReceiptsDoc = defineDoc<{ receipts: JsonObject }>({\n  kind: 'po.request-receipts',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ receipts: {} }),\n});\n"],"mappings":";AAEA,MAAa,eAAA,uCAAcA,CAAAA,CAAAA,UAAAA,CAAoC;CAC7D,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,UAAU,CAAC,EAAE;AACjC,CAAC"}

package/dist/src/services/durableRequestReceipts/docs.mjs

@@ -0,0 +1,12 @@
+import { defineDoc } from "@earendil-works/pi-durable";
+//#region src/services/durableRequestReceipts/docs.ts
+const ReceiptsDoc = defineDoc({
+	kind: "po.request-receipts",
+	version: 1,
+	scope: "session",
+	initial: () => ({ receipts: {} })
+});
+//#endregion
+export { ReceiptsDoc };
+
+//# sourceMappingURL=docs.mjs.map

package/dist/src/services/durableRequestReceipts/docs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.mjs","names":[],"sources":["../../../../src/services/durableRequestReceipts/docs.ts"],"sourcesContent":["import { defineDoc, type JsonObject } from '@earendil-works/pi-durable';\n\nexport const ReceiptsDoc = defineDoc<{ receipts: JsonObject }>({\n  kind: 'po.request-receipts',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ receipts: {} }),\n});\n"],"mappings":";;AAEA,MAAa,cAAc,UAAoC;CAC7D,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,UAAU,CAAC,EAAE;AACjC,CAAC"}

package/dist/src/services/{requestReceipts → durableRequestReceipts}/index.cjs

@@ -1,17 +1,12 @@
 const require_historyOwnership = require("../../../historyOwnership.cjs");
 const require_sqliteSessionStorage = require("../../../sqliteSessionStorage.cjs");
+const require_docs = require("./docs.cjs");
 let node_crypto = require("node:crypto");
-let _earendil_works_pi_durable = require("@earendil-works/pi-durable");
-//#region src/services/requestReceipts/index.ts
+//#region src/services/durableRequestReceipts/index.ts
 const RECEIPTS_SESSION_ID = "request_receipts";
-const ReceiptsDoc = (0, _earendil_works_pi_durable.defineDoc)({
-	kind: "po.request-receipts",
-	version: 1,
-	scope: "session",
-	initial: () => ({ receipts: {} })
-});
 const FINGERPRINT = /^[a-f0-9]{64}$/u;
 const NAMESPACE = /^[a-z][a-z0-9.-]*$/u;
+const MAX_RECEIPTS = 1024;
 function bounded(value, maximum) {
 	return typeof value === "string" && value.length > 0 && value.length <= maximum;
 }
@@ -64,7 +59,7 @@ function createRequestReceipts(options) {
 				const receiptAddress = address(request);
 				if (!FINGERPRINT.test(request.fingerprint) || !bounded(request.destination, 512) || !bounded(request.transactionId, 256)) throw new Error("Invalid request receipt reservation.");
 				return operate((storage) => storage.commit(async (mutator) => {
-					const doc = await mutator.doc(ReceiptsDoc);
+					const doc = await mutator.doc(require_docs.ReceiptsDoc);
 					const existing = doc.receipts[receiptAddress];
 					if (existing !== void 0) {
 						const prior = storedReceipt(existing, request).receipt;
@@ -91,6 +86,10 @@ function createRequestReceipts(options) {
 						receipt,
 						token
 					}));
+					const older = Object.keys(doc.receipts).filter((key) => key !== receiptAddress);
+					const reserved = (key) => doc.receipts[key].receipt?.outcome === "reserved";
+					const excess = Math.max(0, older.length + 1 - (options.maxReceipts ?? MAX_RECEIPTS));
+					for (const key of [...older.filter((key) => !reserved(key)), ...older.filter(reserved)].slice(0, excess)) delete doc.receipts[key];
 					return {
 						kind: "reserved",
 						token
@@ -100,7 +99,7 @@ function createRequestReceipts(options) {
 			lookup(key) {
 				const receiptAddress = address(key);
 				return operate(async (storage) => {
-					const existing = (await storage.snapshot(ReceiptsDoc, require_sqliteSessionStorage.DURABLE_BACKGROUND_CONTEXT))?.receipts[receiptAddress];
+					const existing = (await storage.snapshot(require_docs.ReceiptsDoc, require_sqliteSessionStorage.DURABLE_BACKGROUND_CONTEXT))?.receipts[receiptAddress];
 					return existing === void 0 ? void 0 : storedReceipt(existing, key).receipt;
 				});
 			},
@@ -112,7 +111,7 @@ function createRequestReceipts(options) {
 					"uncertain"
 				].includes(request.outcome)) throw new Error("Invalid request receipt finish.");
 				return operate((storage) => storage.commit(async (mutator) => {
-					const doc = await mutator.doc(ReceiptsDoc);
+					const doc = await mutator.doc(require_docs.ReceiptsDoc);
 					const existing = doc.receipts[receiptAddress];
 					if (existing === void 0) throw new Error("Request receipt reservation does not exist.");
 					const prior = storedReceipt(existing, request);
@@ -145,11 +144,6 @@ function createRequestReceipts(options) {
 				} catch (error) {
 					errors.push(error);
 				}
-				try {
-					await storage.repository.close(require_sqliteSessionStorage.DURABLE_BACKGROUND_CONTEXT);
-				} catch (error) {
-					errors.push(error);
-				}
 				try {
 					await storage.historyLease.release();
 				} catch (error) {

package/dist/src/services/durableRequestReceipts/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createHistoryOwnership","openSqliteSessionStorage","BACKGROUND_CONTEXT","ReceiptsDoc","randomUUID"],"sources":["../../../../src/services/durableRequestReceipts/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { Session } from '@earendil-works/pi-durable';\n\nimport type {\n  PoRequestReceipt,\n  PoRequestReceiptKey,\n  PoRequestReceiptReservation,\n  PoRequestReceipts,\n} from '../../schemas/packageApi';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport { DURABLE_BACKGROUND_CONTEXT as BACKGROUND_CONTEXT, openSqliteSessionStorage } from '../sqliteSessionStorage';\nimport { ReceiptsDoc } from './docs';\n\nconst RECEIPTS_SESSION_ID = 'request_receipts';\nconst FINGERPRINT = /^[a-f0-9]{64}$/u;\nconst NAMESPACE = /^[a-z][a-z0-9.-]*$/u;\n// ponytail: oldest receipts are dropped past this cap (the whole map is one doc rewritten per commit), so a\n// retry older than ~1k sends can duplicate. Upgrade: a doc family keyed by address.\nconst MAX_RECEIPTS = 1024;\n\ntype TerminalOutcome = Exclude<PoRequestReceipt['outcome'], 'reserved'>;\ninterface StoredReceipt {\n  version: 1;\n  receipt: PoRequestReceipt;\n  token: string;\n}\n\nfunction bounded(value: unknown, maximum: number): value is string {\n  return typeof value === 'string' && value.length > 0 && value.length <= maximum;\n}\n\nfunction address(key: PoRequestReceiptKey): string {\n  if (\n    !bounded(key.namespace, 64) ||\n    !NAMESPACE.test(key.namespace) ||\n    !bounded(key.activationId, 256) ||\n    !bounded(key.requestId, 256)\n  )\n    throw new Error('Invalid request receipt address.');\n  // JSON tuple encoding retains exact arbitrary provider IDs, including separators.\n  return JSON.stringify([key.namespace, key.activationId, key.requestId]);\n}\n\nfunction storedReceipt(input: unknown, key: PoRequestReceiptKey): StoredReceipt {\n  if (typeof input !== 'object' || input === null || Array.isArray(input))\n    throw new Error('Request receipt storage is corrupt.');\n  const stored = JSON.parse(JSON.stringify(input)) as Partial<StoredReceipt>;\n  const receipt = stored.receipt;\n  if (\n    stored.version !== 1 ||\n    !bounded(stored.token, 128) ||\n    typeof receipt !== 'object' ||\n    receipt === null ||\n    receipt.namespace !== key.namespace ||\n    receipt.activationId !== key.activationId ||\n    receipt.requestId !== key.requestId ||\n    !bounded(receipt.destination, 512) ||\n    !bounded(receipt.transactionId, 256) ||\n    !FINGERPRINT.test(receipt.fingerprint) ||\n    !['reserved', 'admitted', 'rejected', 'uncertain'].includes(receipt.outcome)\n  )\n    throw new Error('Request receipt storage is corrupt.');\n  return stored as StoredReceipt;\n}\n\n/** One native SQLite metadata history, independent of any selected agent session. */\nexport function createRequestReceipts(options: { directory: string; maxReceipts?: number }): {\n  receipts: PoRequestReceipts;\n  close(): Promise<void>;\n} {\n  const ownership = createHistoryOwnership({ sourceFormat: 'sqlite' });\n  let opened: ReturnType<typeof openSqliteSessionStorage> | undefined;\n  let closed = false;\n  let closing: Promise<void> | undefined;\n  const operations = new Set<Promise<unknown>>();\n\n  const session = async (): Promise<Session> => {\n    if (closed) throw new Error('Request receipt storage is closed.');\n    opened ??= openSqliteSessionStorage(\n      { sessionsRoot: options.directory, sessionId: RECEIPTS_SESSION_ID, historyOwnership: ownership },\n      BACKGROUND_CONTEXT,\n    );\n    return (await opened).session;\n  };\n  const operate = <T>(callback: (session: Session) => Promise<T>): Promise<T> => {\n    if (closed) return Promise.reject(new Error('Request receipt storage is closed.'));\n    const operation = session().then(callback);\n    operations.add(operation);\n    void operation.then(\n      () => operations.delete(operation),\n      () => operations.delete(operation),\n    );\n    return operation;\n  };\n\n  const receipts: PoRequestReceipts = {\n    reserve(request: PoRequestReceiptReservation) {\n      const receiptAddress = address(request);\n      if (\n        !FINGERPRINT.test(request.fingerprint) ||\n        !bounded(request.destination, 512) ||\n        !bounded(request.transactionId, 256)\n      )\n        throw new Error('Invalid request receipt reservation.');\n      return operate((storage) =>\n        storage.commit(async (mutator) => {\n          const doc = await mutator.doc(ReceiptsDoc);\n          const existing = doc.receipts[receiptAddress];\n          if (existing !== undefined) {\n            const prior = storedReceipt(existing, request).receipt;\n            return prior.fingerprint === request.fingerprint &&\n              prior.destination === request.destination &&\n              prior.transactionId === request.transactionId\n              ? { kind: 'existing' as const, receipt: prior }\n              : { kind: 'conflict' as const, receipt: prior };\n          }\n          const token = randomUUID();\n          const receipt: PoRequestReceipt = {\n            namespace: request.namespace,\n            activationId: request.activationId,\n            requestId: request.requestId,\n            fingerprint: request.fingerprint,\n            destination: request.destination,\n            transactionId: request.transactionId,\n            outcome: 'reserved',\n          };\n          doc.receipts[receiptAddress] = JSON.parse(JSON.stringify({ version: 1, receipt, token }));\n          // Object keys keep insertion order, so the first keys are the oldest. Finished receipts go first; a\n          // reservation nothing finished (a crash mid-send) goes only once those run out, never the new one.\n          const older = Object.keys(doc.receipts).filter((key) => key !== receiptAddress);\n          const reserved = (key: string) =>\n            (doc.receipts[key] as unknown as StoredReceipt).receipt?.outcome === 'reserved';\n          const excess = Math.max(0, older.length + 1 - (options.maxReceipts ?? MAX_RECEIPTS));\n          for (const key of [...older.filter((key) => !reserved(key)), ...older.filter(reserved)].slice(0, excess))\n            delete doc.receipts[key];\n          return { kind: 'reserved' as const, token };\n        }, BACKGROUND_CONTEXT),\n      );\n    },\n    lookup(key: PoRequestReceiptKey) {\n      const receiptAddress = address(key);\n      return operate(async (storage) => {\n        const doc = await storage.snapshot(ReceiptsDoc, BACKGROUND_CONTEXT);\n        const existing = doc?.receipts[receiptAddress];\n        return existing === undefined ? undefined : storedReceipt(existing, key).receipt;\n      });\n    },\n    finish(request: PoRequestReceiptKey & { token: string; outcome: TerminalOutcome }) {\n      const receiptAddress = address(request);\n      if (!bounded(request.token, 128) || !['admitted', 'rejected', 'uncertain'].includes(request.outcome))\n        throw new Error('Invalid request receipt finish.');\n      return operate((storage) =>\n        storage.commit(async (mutator) => {\n          const doc = await mutator.doc(ReceiptsDoc);\n          const existing = doc.receipts[receiptAddress];\n          if (existing === undefined) throw new Error('Request receipt reservation does not exist.');\n          const prior = storedReceipt(existing, request);\n          if (prior.token !== request.token) throw new Error('Request receipt token does not match.');\n          if (prior.receipt.outcome === request.outcome) return prior.receipt;\n          if (prior.receipt.outcome !== 'reserved') throw new Error('Request receipt has already been finished.');\n          const receipt: PoRequestReceipt = { ...prior.receipt, outcome: request.outcome };\n          doc.receipts[receiptAddress] = JSON.parse(JSON.stringify({ ...prior, receipt }));\n          return receipt;\n        }, BACKGROUND_CONTEXT),\n      );\n    },\n  };\n\n  return {\n    receipts,\n    close() {\n      if (closing !== undefined) return closing;\n      closed = true;\n      closing = (async () => {\n        await Promise.allSettled(operations);\n        if (opened === undefined) return;\n        const storage = await opened.catch(() => undefined);\n        if (storage === undefined) return;\n        const errors: unknown[] = [];\n        try {\n          await storage.session.close(BACKGROUND_CONTEXT);\n        } catch (error) {\n          errors.push(error);\n        }\n        try {\n          await storage.historyLease.release();\n        } catch (error) {\n          errors.push(error);\n        }\n        if (errors.length > 0) throw new AggregateError(errors, 'Request receipt storage failed to close.');\n      })();\n      return closing;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/services/durableRequestReceipts/index.d.mts

@@ -0,0 +1,12 @@
+import { PoRequestReceipts } from "../../schemas/packageApi.mjs";
+//#region src/services/durableRequestReceipts/index.d.ts
+/** One native SQLite metadata history, independent of any selected agent session. */
+export declare function createRequestReceipts(options: {
+  directory: string;
+  maxReceipts?: number;
+}): {
+  receipts: PoRequestReceipts;
+  close(): Promise<void>;
+};
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/durableRequestReceipts/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/durableRequestReceipts/index.ts"],"mappings":";;;wBAmEgB,sBAAsB;EAAW;EAAmB;;EAClE,UAAU;EACV,SAAS"}

package/dist/src/services/{requestReceipts → durableRequestReceipts}/index.mjs

@@ -1,17 +1,12 @@
 import { createHistoryOwnership } from "../../../historyOwnership.mjs";
 import { DURABLE_BACKGROUND_CONTEXT, openSqliteSessionStorage } from "../../../sqliteSessionStorage.mjs";
+import { ReceiptsDoc } from "./docs.mjs";
 import { randomUUID } from "node:crypto";
-import { defineDoc } from "@earendil-works/pi-durable";
-//#region src/services/requestReceipts/index.ts
+//#region src/services/durableRequestReceipts/index.ts
 const RECEIPTS_SESSION_ID = "request_receipts";
-const ReceiptsDoc = defineDoc({
-	kind: "po.request-receipts",
-	version: 1,
-	scope: "session",
-	initial: () => ({ receipts: {} })
-});
 const FINGERPRINT = /^[a-f0-9]{64}$/u;
 const NAMESPACE = /^[a-z][a-z0-9.-]*$/u;
+const MAX_RECEIPTS = 1024;
 function bounded(value, maximum) {
 	return typeof value === "string" && value.length > 0 && value.length <= maximum;
 }
@@ -91,6 +86,10 @@ function createRequestReceipts(options) {
 						receipt,
 						token
 					}));
+					const older = Object.keys(doc.receipts).filter((key) => key !== receiptAddress);
+					const reserved = (key) => doc.receipts[key].receipt?.outcome === "reserved";
+					const excess = Math.max(0, older.length + 1 - (options.maxReceipts ?? MAX_RECEIPTS));
+					for (const key of [...older.filter((key) => !reserved(key)), ...older.filter(reserved)].slice(0, excess)) delete doc.receipts[key];
 					return {
 						kind: "reserved",
 						token
@@ -145,11 +144,6 @@ function createRequestReceipts(options) {
 				} catch (error) {
 					errors.push(error);
 				}
-				try {
-					await storage.repository.close(DURABLE_BACKGROUND_CONTEXT);
-				} catch (error) {
-					errors.push(error);
-				}
 				try {
 					await storage.historyLease.release();
 				} catch (error) {

package/dist/src/services/durableRequestReceipts/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["BACKGROUND_CONTEXT"],"sources":["../../../../src/services/durableRequestReceipts/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { Session } from '@earendil-works/pi-durable';\n\nimport type {\n  PoRequestReceipt,\n  PoRequestReceiptKey,\n  PoRequestReceiptReservation,\n  PoRequestReceipts,\n} from '../../schemas/packageApi';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport { DURABLE_BACKGROUND_CONTEXT as BACKGROUND_CONTEXT, openSqliteSessionStorage } from '../sqliteSessionStorage';\nimport { ReceiptsDoc } from './docs';\n\nconst RECEIPTS_SESSION_ID = 'request_receipts';\nconst FINGERPRINT = /^[a-f0-9]{64}$/u;\nconst NAMESPACE = /^[a-z][a-z0-9.-]*$/u;\n// ponytail: oldest receipts are dropped past this cap (the whole map is one doc rewritten per commit), so a\n// retry older than ~1k sends can duplicate. Upgrade: a doc family keyed by address.\nconst MAX_RECEIPTS = 1024;\n\ntype TerminalOutcome = Exclude<PoRequestReceipt['outcome'], 'reserved'>;\ninterface StoredReceipt {\n  version: 1;\n  receipt: PoRequestReceipt;\n  token: string;\n}\n\nfunction bounded(value: unknown, maximum: number): value is string {\n  return typeof value === 'string' && value.length > 0 && value.length <= maximum;\n}\n\nfunction address(key: PoRequestReceiptKey): string {\n  if (\n    !bounded(key.namespace, 64) ||\n    !NAMESPACE.test(key.namespace) ||\n    !bounded(key.activationId, 256) ||\n    !bounded(key.requestId, 256)\n  )\n    throw new Error('Invalid request receipt address.');\n  // JSON tuple encoding retains exact arbitrary provider IDs, including separators.\n  return JSON.stringify([key.namespace, key.activationId, key.requestId]);\n}\n\nfunction storedReceipt(input: unknown, key: PoRequestReceiptKey): StoredReceipt {\n  if (typeof input !== 'object' || input === null || Array.isArray(input))\n    throw new Error('Request receipt storage is corrupt.');\n  const stored = JSON.parse(JSON.stringify(input)) as Partial<StoredReceipt>;\n  const receipt = stored.receipt;\n  if (\n    stored.version !== 1 ||\n    !bounded(stored.token, 128) ||\n    typeof receipt !== 'object' ||\n    receipt === null ||\n    receipt.namespace !== key.namespace ||\n    receipt.activationId !== key.activationId ||\n    receipt.requestId !== key.requestId ||\n    !bounded(receipt.destination, 512) ||\n    !bounded(receipt.transactionId, 256) ||\n    !FINGERPRINT.test(receipt.fingerprint) ||\n    !['reserved', 'admitted', 'rejected', 'uncertain'].includes(receipt.outcome)\n  )\n    throw new Error('Request receipt storage is corrupt.');\n  return stored as StoredReceipt;\n}\n\n/** One native SQLite metadata history, independent of any selected agent session. */\nexport function createRequestReceipts(options: { directory: string; maxReceipts?: number }): {\n  receipts: PoRequestReceipts;\n  close(): Promise<void>;\n} {\n  const ownership = createHistoryOwnership({ sourceFormat: 'sqlite' });\n  let opened: ReturnType<typeof openSqliteSessionStorage> | undefined;\n  let closed = false;\n  let closing: Promise<void> | undefined;\n  const operations = new Set<Promise<unknown>>();\n\n  const session = async (): Promise<Session> => {\n    if (closed) throw new Error('Request receipt storage is closed.');\n    opened ??= openSqliteSessionStorage(\n      { sessionsRoot: options.directory, sessionId: RECEIPTS_SESSION_ID, historyOwnership: ownership },\n      BACKGROUND_CONTEXT,\n    );\n    return (await opened).session;\n  };\n  const operate = <T>(callback: (session: Session) => Promise<T>): Promise<T> => {\n    if (closed) return Promise.reject(new Error('Request receipt storage is closed.'));\n    const operation = session().then(callback);\n    operations.add(operation);\n    void operation.then(\n      () => operations.delete(operation),\n      () => operations.delete(operation),\n    );\n    return operation;\n  };\n\n  const receipts: PoRequestReceipts = {\n    reserve(request: PoRequestReceiptReservation) {\n      const receiptAddress = address(request);\n      if (\n        !FINGERPRINT.test(request.fingerprint) ||\n        !bounded(request.destination, 512) ||\n        !bounded(request.transactionId, 256)\n      )\n        throw new Error('Invalid request receipt reservation.');\n      return operate((storage) =>\n        storage.commit(async (mutator) => {\n          const doc = await mutator.doc(ReceiptsDoc);\n          const existing = doc.receipts[receiptAddress];\n          if (existing !== undefined) {\n            const prior = storedReceipt(existing, request).receipt;\n            return prior.fingerprint === request.fingerprint &&\n              prior.destination === request.destination &&\n              prior.transactionId === request.transactionId\n              ? { kind: 'existing' as const, receipt: prior }\n              : { kind: 'conflict' as const, receipt: prior };\n          }\n          const token = randomUUID();\n          const receipt: PoRequestReceipt = {\n            namespace: request.namespace,\n            activationId: request.activationId,\n            requestId: request.requestId,\n            fingerprint: request.fingerprint,\n            destination: request.destination,\n            transactionId: request.transactionId,\n            outcome: 'reserved',\n          };\n          doc.receipts[receiptAddress] = JSON.parse(JSON.stringify({ version: 1, receipt, token }));\n          // Object keys keep insertion order, so the first keys are the oldest. Finished receipts go first; a\n          // reservation nothing finished (a crash mid-send) goes only once those run out, never the new one.\n          const older = Object.keys(doc.receipts).filter((key) => key !== receiptAddress);\n          const reserved = (key: string) =>\n            (doc.receipts[key] as unknown as StoredReceipt).receipt?.outcome === 'reserved';\n          const excess = Math.max(0, older.length + 1 - (options.maxReceipts ?? MAX_RECEIPTS));\n          for (const key of [...older.filter((key) => !reserved(key)), ...older.filter(reserved)].slice(0, excess))\n            delete doc.receipts[key];\n          return { kind: 'reserved' as const, token };\n        }, BACKGROUND_CONTEXT),\n      );\n    },\n    lookup(key: PoRequestReceiptKey) {\n      const receiptAddress = address(key);\n      return operate(async (storage) => {\n        const doc = await storage.snapshot(ReceiptsDoc, BACKGROUND_CONTEXT);\n        const existing = doc?.receipts[receiptAddress];\n        return existing === undefined ? undefined : storedReceipt(existing, key).receipt;\n      });\n    },\n    finish(request: PoRequestReceiptKey & { token: string; outcome: TerminalOutcome }) {\n      const receiptAddress = address(request);\n      if (!bounded(request.token, 128) || !['admitted', 'rejected', 'uncertain'].includes(request.outcome))\n        throw new Error('Invalid request receipt finish.');\n      return operate((storage) =>\n        storage.commit(async (mutator) => {\n          const doc = await mutator.doc(ReceiptsDoc);\n          const existing = doc.receipts[receiptAddress];\n          if (existing === undefined) throw new Error('Request receipt reservation does not exist.');\n          const prior = storedReceipt(existing, request);\n          if (prior.token !== request.token) throw new Error('Request receipt token does not match.');\n          if (prior.receipt.outcome === request.outcome) return prior.receipt;\n          if (prior.receipt.outcome !== 'reserved') throw new Error('Request receipt has already been finished.');\n          const receipt: PoRequestReceipt = { ...prior.receipt, outcome: request.outcome };\n          doc.receipts[receiptAddress] = JSON.parse(JSON.stringify({ ...prior, receipt }));\n          return receipt;\n        }, BACKGROUND_CONTEXT),\n      );\n    },\n  };\n\n  return {\n    receipts,\n    close() {\n      if (closing !== undefined) return closing;\n      closed = true;\n      closing = (async () => {\n        await Promise.allSettled(operations);\n        if (opened === undefined) return;\n        const storage = await opened.catch(() => undefined);\n        if (storage === undefined) return;\n        const errors: unknown[] = [];\n        try {\n          await storage.session.close(BACKGROUND_CONTEXT);\n        } catch (error) {\n          errors.push(error);\n        }\n        try {\n          await storage.historyLease.release();\n        } catch (error) {\n          errors.push(error);\n        }\n        if (errors.length > 0) throw new AggregateError(errors, 'Request receipt storage failed to close.');\n      })();\n      return closing;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/services/durableSession/docs.cjs

@@ -0,0 +1,65 @@
+let _earendil_works_pi_durable = require("@earendil-works/pi-durable");
+//#region src/services/durableSession/docs.ts
+/** Public string identity belongs to Po, not the durable numeric ID namespace. */
+const SessionIdentityDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.session.identity",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		id: "",
+		createdAt: 0,
+		parentSessionId: ""
+	})
+});
+const SessionMetadataDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.session.metadata",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		name: "",
+		workspaceRoot: "",
+		execution: "",
+		laneName: "main",
+		groups: []
+	})
+});
+const FastModeDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.fast-mode",
+	version: 1,
+	scope: "session",
+	initial: () => ({ enabled: false })
+});
+const AgentLockDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.agent-lock",
+	version: 1,
+	scope: "session",
+	initial: () => ({ locked: false })
+});
+const LabelsDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.labels",
+	version: 1,
+	scope: "session",
+	initial: () => ({ labels: {} })
+});
+/**
+* Profile identity entries of one conversation, written in the identity entry's commit, so a transcript page finds
+* the avatar in effect without scanning backwards. Rewindable with `asOf` forks: a fork keeps only the identities
+* written before its fork point. Sessions written before this document have no entries and show the default avatar.
+*/
+const IdentityHistoryDoc = (0, _earendil_works_pi_durable.defineDoc)({
+	kind: "po.identity-history",
+	version: 1,
+	scope: "conversation",
+	history: "rewindable",
+	fork: "asOf",
+	initial: () => ({ items: [] })
+});
+//#endregion
+exports.AgentLockDoc = AgentLockDoc;
+exports.FastModeDoc = FastModeDoc;
+exports.IdentityHistoryDoc = IdentityHistoryDoc;
+exports.LabelsDoc = LabelsDoc;
+exports.SessionIdentityDoc = SessionIdentityDoc;
+exports.SessionMetadataDoc = SessionMetadataDoc;
+
+//# sourceMappingURL=docs.cjs.map

package/dist/src/services/durableSession/docs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cjs","names":["defineDoc"],"sources":["../../../../src/services/durableSession/docs.ts"],"sourcesContent":["import type { JsonValue } from '@earendil-works/chord';\nimport { defineDoc } from '@earendil-works/pi-durable';\n\n/** Public string identity belongs to Po, not the durable numeric ID namespace. */\nexport const SessionIdentityDoc = defineDoc({\n  kind: 'po.session.identity',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ id: '', createdAt: 0, parentSessionId: '' }),\n});\nexport const SessionMetadataDoc = defineDoc({\n  kind: 'po.session.metadata',\n  version: 1,\n  scope: 'session',\n  // `groups` arrived after version 1 shipped: older sessions have no field, so readers default it.\n  initial: () => ({ name: '', workspaceRoot: '', execution: '', laneName: 'main', groups: [] as string[] }),\n});\nexport const FastModeDoc = defineDoc({\n  kind: 'po.fast-mode',\n  version: 1,\n  scope: 'session',\n  initial: (): { enabled: boolean } => ({ enabled: false }),\n});\n// Blocks local agent turns so a remote MCP agent can work without the local model acting.\nexport const AgentLockDoc = defineDoc({\n  kind: 'po.agent-lock',\n  version: 1,\n  scope: 'session',\n  initial: (): { locked: boolean } => ({ locked: false }),\n});\nexport const LabelsDoc = defineDoc({\n  kind: 'po.labels',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ labels: {} as Record<string, string> }),\n});\nexport type IdentityHistory = { items: { seq: number; data: JsonValue }[] };\n/**\n * Profile identity entries of one conversation, written in the identity entry's commit, so a transcript page finds\n * the avatar in effect without scanning backwards. Rewindable with `asOf` forks: a fork keeps only the identities\n * written before its fork point. Sessions written before this document have no entries and show the default avatar.\n */\nexport const IdentityHistoryDoc = defineDoc({\n  kind: 'po.identity-history',\n  version: 1,\n  scope: 'conversation',\n  history: 'rewindable',\n  fork: 'asOf',\n  initial: (): IdentityHistory => ({ items: [] }),\n});\n"],"mappings":";;;AAIA,MAAa,sBAAA,GAAqBA,2BAAAA,UAAAA,CAAU;CAC1C,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB;EAAE,IAAI;EAAI,WAAW;EAAG,iBAAiB;CAAG;AAC9D,CAAC;AACD,MAAa,sBAAA,GAAqBA,2BAAAA,UAAAA,CAAU;CAC1C,MAAM;CACN,SAAS;CACT,OAAO;CAEP,gBAAgB;EAAE,MAAM;EAAI,eAAe;EAAI,WAAW;EAAI,UAAU;EAAQ,QAAQ,CAAC;CAAc;AACzG,CAAC;AACD,MAAa,eAAA,GAAcA,2BAAAA,UAAAA,CAAU;CACnC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAsC,EAAE,SAAS,MAAM;AACzD,CAAC;AAED,MAAa,gBAAA,GAAeA,2BAAAA,UAAAA,CAAU;CACpC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAqC,EAAE,QAAQ,MAAM;AACvD,CAAC;AACD,MAAa,aAAA,GAAYA,2BAAAA,UAAAA,CAAU;CACjC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,QAAQ,CAAC,EAA4B;AACzD,CAAC;;;;;;AAOD,MAAa,sBAAA,GAAqBA,2BAAAA,UAAAA,CAAU;CAC1C,MAAM;CACN,SAAS;CACT,OAAO;CACP,SAAS;CACT,MAAM;CACN,gBAAiC,EAAE,OAAO,CAAC,EAAE;AAC/C,CAAC"}

package/dist/src/services/durableSession/docs.d.mts

@@ -0,0 +1,17 @@
+import { JsonValue } from "@earendil-works/chord";
+//#region src/services/durableSession/docs.d.ts
+/** Public string identity belongs to Po, not the durable numeric ID namespace. */
+export declare const SessionIdentityDoc: import("@earendil-works/pi-durable").SessionDocToken<{
+  id: string;
+  createdAt: number;
+  parentSessionId: string;
+}>;
+export declare const SessionMetadataDoc: import("@earendil-works/pi-durable").SessionDocToken<{
+  name: string;
+  workspaceRoot: string;
+  execution: string;
+  laneName: string;
+  groups: string[];
+}>;
+//#endregion
+//# sourceMappingURL=docs.d.mts.map

package/dist/src/services/durableSession/docs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.mts","names":[],"sources":["../../../../src/services/durableSession/docs.ts"],"mappings":";;;qBAIa,yDAAkB;;;;;qBAMlB,yDAAkB;;;;;EAKiE"}

package/dist/src/services/durableSession/docs.mjs

@@ -0,0 +1,60 @@
+import { defineDoc } from "@earendil-works/pi-durable";
+//#region src/services/durableSession/docs.ts
+/** Public string identity belongs to Po, not the durable numeric ID namespace. */
+const SessionIdentityDoc = defineDoc({
+	kind: "po.session.identity",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		id: "",
+		createdAt: 0,
+		parentSessionId: ""
+	})
+});
+const SessionMetadataDoc = defineDoc({
+	kind: "po.session.metadata",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		name: "",
+		workspaceRoot: "",
+		execution: "",
+		laneName: "main",
+		groups: []
+	})
+});
+const FastModeDoc = defineDoc({
+	kind: "po.fast-mode",
+	version: 1,
+	scope: "session",
+	initial: () => ({ enabled: false })
+});
+const AgentLockDoc = defineDoc({
+	kind: "po.agent-lock",
+	version: 1,
+	scope: "session",
+	initial: () => ({ locked: false })
+});
+const LabelsDoc = defineDoc({
+	kind: "po.labels",
+	version: 1,
+	scope: "session",
+	initial: () => ({ labels: {} })
+});
+/**
+* Profile identity entries of one conversation, written in the identity entry's commit, so a transcript page finds
+* the avatar in effect without scanning backwards. Rewindable with `asOf` forks: a fork keeps only the identities
+* written before its fork point. Sessions written before this document have no entries and show the default avatar.
+*/
+const IdentityHistoryDoc = defineDoc({
+	kind: "po.identity-history",
+	version: 1,
+	scope: "conversation",
+	history: "rewindable",
+	fork: "asOf",
+	initial: () => ({ items: [] })
+});
+//#endregion
+export { AgentLockDoc, FastModeDoc, IdentityHistoryDoc, LabelsDoc, SessionIdentityDoc, SessionMetadataDoc };
+
+//# sourceMappingURL=docs.mjs.map

package/dist/src/services/durableSession/docs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.mjs","names":[],"sources":["../../../../src/services/durableSession/docs.ts"],"sourcesContent":["import type { JsonValue } from '@earendil-works/chord';\nimport { defineDoc } from '@earendil-works/pi-durable';\n\n/** Public string identity belongs to Po, not the durable numeric ID namespace. */\nexport const SessionIdentityDoc = defineDoc({\n  kind: 'po.session.identity',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ id: '', createdAt: 0, parentSessionId: '' }),\n});\nexport const SessionMetadataDoc = defineDoc({\n  kind: 'po.session.metadata',\n  version: 1,\n  scope: 'session',\n  // `groups` arrived after version 1 shipped: older sessions have no field, so readers default it.\n  initial: () => ({ name: '', workspaceRoot: '', execution: '', laneName: 'main', groups: [] as string[] }),\n});\nexport const FastModeDoc = defineDoc({\n  kind: 'po.fast-mode',\n  version: 1,\n  scope: 'session',\n  initial: (): { enabled: boolean } => ({ enabled: false }),\n});\n// Blocks local agent turns so a remote MCP agent can work without the local model acting.\nexport const AgentLockDoc = defineDoc({\n  kind: 'po.agent-lock',\n  version: 1,\n  scope: 'session',\n  initial: (): { locked: boolean } => ({ locked: false }),\n});\nexport const LabelsDoc = defineDoc({\n  kind: 'po.labels',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ labels: {} as Record<string, string> }),\n});\nexport type IdentityHistory = { items: { seq: number; data: JsonValue }[] };\n/**\n * Profile identity entries of one conversation, written in the identity entry's commit, so a transcript page finds\n * the avatar in effect without scanning backwards. Rewindable with `asOf` forks: a fork keeps only the identities\n * written before its fork point. Sessions written before this document have no entries and show the default avatar.\n */\nexport const IdentityHistoryDoc = defineDoc({\n  kind: 'po.identity-history',\n  version: 1,\n  scope: 'conversation',\n  history: 'rewindable',\n  fork: 'asOf',\n  initial: (): IdentityHistory => ({ items: [] }),\n});\n"],"mappings":";;;AAIA,MAAa,qBAAqB,UAAU;CAC1C,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB;EAAE,IAAI;EAAI,WAAW;EAAG,iBAAiB;CAAG;AAC9D,CAAC;AACD,MAAa,qBAAqB,UAAU;CAC1C,MAAM;CACN,SAAS;CACT,OAAO;CAEP,gBAAgB;EAAE,MAAM;EAAI,eAAe;EAAI,WAAW;EAAI,UAAU;EAAQ,QAAQ,CAAC;CAAc;AACzG,CAAC;AACD,MAAa,cAAc,UAAU;CACnC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAsC,EAAE,SAAS,MAAM;AACzD,CAAC;AAED,MAAa,eAAe,UAAU;CACpC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAqC,EAAE,QAAQ,MAAM;AACvD,CAAC;AACD,MAAa,YAAY,UAAU;CACjC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,QAAQ,CAAC,EAA4B;AACzD,CAAC;;;;;;AAOD,MAAa,qBAAqB,UAAU;CAC1C,MAAM;CACN,SAAS;CACT,OAAO;CACP,SAAS;CACT,MAAM;CACN,gBAAiC,EAAE,OAAO,CAAC,EAAE;AAC/C,CAAC"}

package/dist/src/services/durableSession/index.cjs

@@ -0,0 +1,21 @@
+const require_docs = require("./docs.cjs");
+//#region src/services/durableSession/index.ts
+/** The directory every durable session journal lives in, under the sessions root. */
+const DURABLE_DIRECTORY = "durable-v1";
+/** Stamps a new session's identity, or checks an existing one matches the requested id. */
+async function initializeSessionIdentity(session, request, context) {
+	const identity = await session.snapshot(require_docs.SessionIdentityDoc, context);
+	if (request.existing && (!identity || identity.id !== request.id)) throw new Error("SQLite session id does not match the requested session");
+	if (request.existing) return;
+	await session.commit(async (tx) => {
+		const doc = await tx.doc(require_docs.SessionIdentityDoc);
+		doc.id = request.id;
+		doc.createdAt = Date.now();
+		doc.parentSessionId = request.parentSessionId ?? "";
+	}, context);
+}
+//#endregion
+exports.DURABLE_DIRECTORY = DURABLE_DIRECTORY;
+exports.initializeSessionIdentity = initializeSessionIdentity;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/durableSession/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["SessionIdentityDoc"],"sources":["../../../../src/services/durableSession/index.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport type { Session } from '@earendil-works/pi-durable';\n\nimport { SessionIdentityDoc } from './docs';\n\n/** The directory every durable session journal lives in, under the sessions root. */\nexport const DURABLE_DIRECTORY = 'durable-v1';\n/** Stamps a new session's identity, or checks an existing one matches the requested id. */\nexport async function initializeSessionIdentity(\n  session: Session,\n  request: { readonly id: string; readonly existing: boolean; readonly parentSessionId?: string },\n  context: Context,\n): Promise<void> {\n  const identity = await session.snapshot(SessionIdentityDoc, context);\n  if (request.existing && (!identity || identity.id !== request.id))\n    throw new Error('SQLite session id does not match the requested session');\n  if (request.existing) return;\n  await session.commit(async (tx) => {\n    const doc = await tx.doc(SessionIdentityDoc);\n    doc.id = request.id;\n    doc.createdAt = Date.now();\n    doc.parentSessionId = request.parentSessionId ?? '';\n  }, context);\n}\n"],"mappings":";;;AAMA,MAAa,oBAAoB;;AAEjC,eAAsB,0BACpB,SACA,SACA,SACe;CACf,MAAM,WAAW,MAAM,QAAQ,SAASA,aAAAA,oBAAoB,OAAO;CACnE,IAAI,QAAQ,aAAa,CAAC,YAAY,SAAS,OAAO,QAAQ,KAC5D,MAAM,IAAI,MAAM,wDAAwD;CAC1E,IAAI,QAAQ,UAAU;CACtB,MAAM,QAAQ,OAAO,OAAO,OAAO;EACjC,MAAM,MAAM,MAAM,GAAG,IAAIA,aAAAA,kBAAkB;EAC3C,IAAI,KAAK,QAAQ;EACjB,IAAI,YAAY,KAAK,IAAI;EACzB,IAAI,kBAAkB,QAAQ,mBAAmB;CACnD,GAAG,OAAO;AACZ"}

package/dist/src/services/durableSession/index.d.mts

@@ -0,0 +1,13 @@
+import { Session } from "@earendil-works/pi-durable";
+import { Context } from "@earendil-works/chord";
+//#region src/services/durableSession/index.d.ts
+/** The directory every durable session journal lives in, under the sessions root. */
+export declare const DURABLE_DIRECTORY = "durable-v1";
+/** Stamps a new session's identity, or checks an existing one matches the requested id. */
+export declare function initializeSessionIdentity(session: Session, request: {
+  readonly id: string;
+  readonly existing: boolean;
+  readonly parentSessionId?: string;
+}, context: Context): Promise<void>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/durableSession/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/durableSession/index.ts"],"mappings":";;;;qBAMa;;wBAES,0BACpB,SAAS,SACT;WAAoB;WAAqB;WAA4B;GACrE,SAAS,UACR"}