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

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

@@ -0,0 +1,20 @@
+import { SessionIdentityDoc } from "./docs.mjs";
+//#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(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(SessionIdentityDoc);
+		doc.id = request.id;
+		doc.createdAt = Date.now();
+		doc.parentSessionId = request.parentSessionId ?? "";
+	}, context);
+}
+//#endregion
+export { DURABLE_DIRECTORY, initializeSessionIdentity };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"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,SAAS,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,IAAI,kBAAkB;EAC3C,IAAI,KAAK,QAAQ;EACjB,IAAI,YAAY,KAAK,IAAI;EACzB,IAAI,kBAAkB,QAAQ,mBAAmB;CACnD,GAAG,OAAO;AACZ"}

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

@@ -0,0 +1,15 @@
+//#region src/services/durableSubagents/docs.ts
+/** This session's child runs by run ID, and the child conversations of reported runs dropped past the cap. */
+const SubagentsDoc = (0, require("@earendil-works/pi-durable").defineDoc)({
+	kind: "po.subagents.identity",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		runs: {},
+		retired: []
+	})
+});
+//#endregion
+exports.SubagentsDoc = SubagentsDoc;
+
+//# sourceMappingURL=docs.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cjs","names":["defineDoc"],"sources":["../../../../src/services/durableSubagents/docs.ts"],"sourcesContent":["import { defineDoc, type JsonObject } from '@earendil-works/pi-durable';\n\n/** One child run in its parent's Harness, kept so it can be re-attached after a restart. */\nexport type StoredSubagent = {\n  conversationId: number;\n  anchorTaskId: number;\n  /** Request ID of the task input given to the child. */\n  inputRequestId: string;\n  /** The launcher's request without its live parts; dropped once the run is reported. */\n  request: JsonObject | null;\n  /** Set once the run's completion reached its launcher. */\n  reported: boolean;\n  /** Kept from the request once it is reported, so a finished run still has a status. */\n  agent?: string;\n  task?: string;\n  /** How the run ended, when its launcher reported it. */\n  state?: 'completed' | 'failed' | 'stopped';\n};\n\n/** This session's child runs by run ID, and the child conversations of reported runs dropped past the cap. */\nexport const SubagentsDoc = defineDoc({\n  kind: 'po.subagents.identity',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ runs: {} as Record<string, StoredSubagent>, retired: [] as number[] }),\n});\n"],"mappings":";;AAoBA,MAAa,gBAAA,uCAAeA,CAAAA,CAAAA,UAAAA,CAAU;CACpC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB;EAAE,MAAM,CAAC;EAAqC,SAAS,CAAC;CAAc;AACxF,CAAC"}

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

@@ -0,0 +1,16 @@
+import { defineDoc } from "@earendil-works/pi-durable";
+//#region src/services/durableSubagents/docs.ts
+/** This session's child runs by run ID, and the child conversations of reported runs dropped past the cap. */
+const SubagentsDoc = defineDoc({
+	kind: "po.subagents.identity",
+	version: 1,
+	scope: "session",
+	initial: () => ({
+		runs: {},
+		retired: []
+	})
+});
+//#endregion
+export { SubagentsDoc };
+
+//# sourceMappingURL=docs.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.mjs","names":[],"sources":["../../../../src/services/durableSubagents/docs.ts"],"sourcesContent":["import { defineDoc, type JsonObject } from '@earendil-works/pi-durable';\n\n/** One child run in its parent's Harness, kept so it can be re-attached after a restart. */\nexport type StoredSubagent = {\n  conversationId: number;\n  anchorTaskId: number;\n  /** Request ID of the task input given to the child. */\n  inputRequestId: string;\n  /** The launcher's request without its live parts; dropped once the run is reported. */\n  request: JsonObject | null;\n  /** Set once the run's completion reached its launcher. */\n  reported: boolean;\n  /** Kept from the request once it is reported, so a finished run still has a status. */\n  agent?: string;\n  task?: string;\n  /** How the run ended, when its launcher reported it. */\n  state?: 'completed' | 'failed' | 'stopped';\n};\n\n/** This session's child runs by run ID, and the child conversations of reported runs dropped past the cap. */\nexport const SubagentsDoc = defineDoc({\n  kind: 'po.subagents.identity',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ runs: {} as Record<string, StoredSubagent>, retired: [] as number[] }),\n});\n"],"mappings":";;;AAoBA,MAAa,eAAe,UAAU;CACpC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB;EAAE,MAAM,CAAC;EAAqC,SAAS,CAAC;CAAc;AACxF,CAAC"}

package/dist/src/services/durableSubagents/extension.cjs

@@ -0,0 +1,11 @@
+const require_tasks = require("./tasks.cjs");
+//#region src/services/durableSubagents/extension.ts
+/** Installed in every Harness so a live anchor's definition resolves after a restart. */
+const SubagentsExtension = (0, require("@earendil-works/pi-durable").defineExtension)({
+	name: "po.subagents",
+	tasks: [require_tasks.SubagentAnchorTask]
+});
+//#endregion
+exports.SubagentsExtension = SubagentsExtension;
+
+//# sourceMappingURL=extension.cjs.map

package/dist/src/services/durableSubagents/extension.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.cjs","names":["defineExtension","SubagentAnchorTask"],"sources":["../../../../src/services/durableSubagents/extension.ts"],"sourcesContent":["import { defineExtension } from '@earendil-works/pi-durable';\n\nimport { SubagentAnchorTask } from './tasks';\n\n/** Installed in every Harness so a live anchor's definition resolves after a restart. */\nexport const SubagentsExtension = defineExtension({ name: 'po.subagents', tasks: [SubagentAnchorTask] });\n"],"mappings":";;;AAKA,MAAa,sBAAA,uCAAqBA,CAAAA,CAAAA,gBAAAA,CAAgB;CAAE,MAAM;CAAgB,OAAO,CAACC,cAAAA,kBAAkB;AAAE,CAAC"}

package/dist/src/services/durableSubagents/extension.mjs

@@ -0,0 +1,12 @@
+import { SubagentAnchorTask } from "./tasks.mjs";
+import { defineExtension } from "@earendil-works/pi-durable";
+//#region src/services/durableSubagents/extension.ts
+/** Installed in every Harness so a live anchor's definition resolves after a restart. */
+const SubagentsExtension = defineExtension({
+	name: "po.subagents",
+	tasks: [SubagentAnchorTask]
+});
+//#endregion
+export { SubagentsExtension };
+
+//# sourceMappingURL=extension.mjs.map

package/dist/src/services/durableSubagents/extension.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../../src/services/durableSubagents/extension.ts"],"sourcesContent":["import { defineExtension } from '@earendil-works/pi-durable';\n\nimport { SubagentAnchorTask } from './tasks';\n\n/** Installed in every Harness so a live anchor's definition resolves after a restart. */\nexport const SubagentsExtension = defineExtension({ name: 'po.subagents', tasks: [SubagentAnchorTask] });\n"],"mappings":";;;;AAKA,MAAa,qBAAqB,gBAAgB;CAAE,MAAM;CAAgB,OAAO,CAAC,kBAAkB;AAAE,CAAC"}

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

@@ -0,0 +1,95 @@
+const require_docs = require("./docs.cjs");
+const require_tasks = require("./tasks.cjs");
+const require_extension = require("./extension.cjs");
+//#region src/services/durableSubagents/index.ts
+/**
+* Creates one run's child conversation, owned by a background anchor of `parent`, and records the run, in one
+* commit. A fresh child starts as a copy of the parent's agent; a fork also keeps its history through `forkAt`.
+*/
+async function createSubagentConversation(harness, parent, launch, context) {
+	const { id, stored } = await parent.commit(async (tx) => {
+		const anchor = await tx.createTask(require_tasks.SubagentAnchorTask, null, {
+			ownership: { kind: "conversation" },
+			background: true
+		});
+		const ownership = {
+			kind: "task",
+			taskId: anchor
+		};
+		const child = launch.forkAt === void 0 ? await tx.createConversation({ ownership }) : await tx.forkConversation(parent.id, launch.forkAt, { ownership });
+		const runs = (await tx.doc(require_docs.SubagentsDoc)).runs;
+		if (Object.hasOwn(runs, launch.runId)) throw new Error(`Child run '${launch.runId}' already exists.`);
+		const record = {
+			conversationId: child.id,
+			anchorTaskId: anchor,
+			inputRequestId: `subagent:${anchor}:1`,
+			request: launch.request,
+			reported: false
+		};
+		runs[launch.runId] = record;
+		return {
+			id: child.id,
+			stored: record
+		};
+	}, context);
+	const conversation = await harness.conversation(id, context);
+	if (!conversation) throw new Error(`Child conversation ${id} is unavailable.`);
+	return {
+		conversation,
+		stored
+	};
+}
+async function readSubagents(harness, context) {
+	return (await harness.snapshot(require_docs.SubagentsDoc, context))?.runs ?? {};
+}
+const MAX_REPORTED_RUNS = 256;
+/**
+* Marks a run reported and drops the request only a re-attach needed, keeping its agent, task and outcome. Returns
+* the run's child conversation, or nothing when the run was already reported or is unknown.
+*/
+async function markSubagentReported(harness, runId, context, outcome, maxReported = MAX_REPORTED_RUNS) {
+	return harness.commit(async (tx) => {
+		const doc = await tx.doc(require_docs.SubagentsDoc);
+		const run = doc.runs[runId];
+		if (!run || run.reported) return void 0;
+		run.reported = true;
+		if (typeof run.request?.agent === "string") run.agent = run.request.agent;
+		if (typeof run.request?.task === "string") run.task = run.request.task;
+		if (outcome) run.state = outcome.state;
+		run.request = null;
+		const reported = Object.entries(doc.runs).filter(([, stored]) => stored.reported);
+		const dropped = reported.slice(0, Math.max(0, reported.length - maxReported));
+		if (dropped.length > 0) {
+			doc.retired = [...doc.retired ?? [], ...dropped.map(([, stored]) => stored.conversationId)];
+			for (const [id] of dropped) delete doc.runs[id];
+		}
+		return run.conversationId;
+	}, context);
+}
+/**
+* Stops a run nothing could re-attach, before the Harness resumes: its child would otherwise run on without a
+* launcher. Only marks its live tasks and withdraws its queued inputs, so scheduling stays paused, then reports it
+* failed. Returns its child conversation, or nothing for an unknown or reported run.
+*/
+async function abandonSubagent(harness, runId, context) {
+	const run = (await readSubagents(harness, context))[runId];
+	if (!run || run.reported) return void 0;
+	const { tasks, submissions } = await harness.inspect(context);
+	for (const submission of submissions) if (submission.conversationId === run.conversationId && submission.status === "queued") await harness.abortSubmission(submission.id, context, submission.conversationId);
+	for (const task of tasks) if (task.record.conversationId === run.conversationId) await harness.abortTask(task.record.id, context);
+	return markSubagentReported(harness, runId, context, { state: "failed" });
+}
+/** Child conversations of this session; their launcher reports what they spend, not the parent. */
+async function subagentConversations(harness, context) {
+	const doc = await harness.snapshot(require_docs.SubagentsDoc, context);
+	return [...Object.values(doc?.runs ?? {}).map((run) => run.conversationId), ...doc?.retired ?? []].map((id) => id);
+}
+//#endregion
+exports.SubagentsExtension = require_extension.SubagentsExtension;
+exports.abandonSubagent = abandonSubagent;
+exports.createSubagentConversation = createSubagentConversation;
+exports.markSubagentReported = markSubagentReported;
+exports.readSubagents = readSubagents;
+exports.subagentConversations = subagentConversations;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["SubagentAnchorTask","SubagentsDoc"],"sources":["../../../../src/services/durableSubagents/index.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport type { Conversation, ConversationId, EntryId, Harness, JsonObject } from '@earendil-works/pi-durable';\n\nimport { SubagentsDoc, type StoredSubagent } from './docs';\nimport { SubagentAnchorTask } from './tasks';\n\nexport { SubagentsDoc, type StoredSubagent } from './docs';\nexport { SubagentsExtension } from './extension';\n\nexport interface SubagentLaunch {\n  readonly runId: string;\n  readonly request: JsonObject;\n  /** Start from the parent's history through this entry instead of a fresh copy of its agent. */\n  readonly forkAt?: EntryId;\n}\n\n/**\n * Creates one run's child conversation, owned by a background anchor of `parent`, and records the run, in one\n * commit. A fresh child starts as a copy of the parent's agent; a fork also keeps its history through `forkAt`.\n */\nexport async function createSubagentConversation(\n  harness: Harness,\n  parent: Conversation,\n  launch: SubagentLaunch,\n  context: Context,\n): Promise<{ conversation: Conversation; stored: StoredSubagent }> {\n  const { id, stored } = await parent.commit(async (tx) => {\n    const anchor = await tx.createTask(SubagentAnchorTask, null, {\n      ownership: { kind: 'conversation' },\n      background: true,\n    });\n    const ownership = { kind: 'task', taskId: anchor } as const;\n    const child =\n      launch.forkAt === undefined\n        ? await tx.createConversation({ ownership })\n        : await tx.forkConversation(parent.id, launch.forkAt, { ownership });\n    const runs = (await tx.doc(SubagentsDoc)).runs;\n    if (Object.hasOwn(runs, launch.runId)) throw new Error(`Child run '${launch.runId}' already exists.`);\n    const record: StoredSubagent = {\n      conversationId: child.id,\n      anchorTaskId: anchor,\n      // One task input per anchor, so a retried admission never posts it twice.\n      inputRequestId: `subagent:${anchor}:1`,\n      request: launch.request,\n      reported: false,\n    };\n    runs[launch.runId] = record;\n    return { id: child.id, stored: record };\n  }, context);\n  const conversation = await harness.conversation(id, context);\n  if (!conversation) throw new Error(`Child conversation ${id} is unavailable.`);\n  return { conversation, stored };\n}\n\nexport async function readSubagents(\n  harness: Harness,\n  context: Context,\n): Promise<Readonly<Record<string, StoredSubagent>>> {\n  return (await harness.snapshot(SubagentsDoc, context))?.runs ?? {};\n}\n\n// ponytail: past this many reported runs the oldest records go and only their child conversation IDs stay, so a\n// long session's doc stays small while its usage still leaves those children out. Upgrade: a doc family per run.\nconst MAX_REPORTED_RUNS = 256;\n\n/**\n * Marks a run reported and drops the request only a re-attach needed, keeping its agent, task and outcome. Returns\n * the run's child conversation, or nothing when the run was already reported or is unknown.\n */\nexport async function markSubagentReported(\n  harness: Harness,\n  runId: string,\n  context: Context,\n  outcome?: { readonly state: NonNullable<StoredSubagent['state']> },\n  maxReported = MAX_REPORTED_RUNS,\n): Promise<ConversationId | undefined> {\n  return harness.commit(async (tx) => {\n    const doc = await tx.doc(SubagentsDoc);\n    const run = doc.runs[runId];\n    if (!run || run.reported) return undefined;\n    run.reported = true;\n    if (typeof run.request?.agent === 'string') run.agent = run.request.agent;\n    if (typeof run.request?.task === 'string') run.task = run.request.task;\n    if (outcome) run.state = outcome.state;\n    run.request = null;\n    // Object keys keep insertion order, so the first reported runs are the oldest.\n    const reported = Object.entries(doc.runs).filter(([, stored]) => stored.reported);\n    const dropped = reported.slice(0, Math.max(0, reported.length - maxReported));\n    if (dropped.length > 0) {\n      doc.retired = [...(doc.retired ?? []), ...dropped.map(([, stored]) => stored.conversationId)];\n      for (const [id] of dropped) delete doc.runs[id];\n    }\n    return run.conversationId as ConversationId;\n  }, context);\n}\n\n/**\n * Stops a run nothing could re-attach, before the Harness resumes: its child would otherwise run on without a\n * launcher. Only marks its live tasks and withdraws its queued inputs, so scheduling stays paused, then reports it\n * failed. Returns its child conversation, or nothing for an unknown or reported run.\n */\nexport async function abandonSubagent(\n  harness: Harness,\n  runId: string,\n  context: Context,\n): Promise<ConversationId | undefined> {\n  const run = (await readSubagents(harness, context))[runId];\n  if (!run || run.reported) return undefined;\n  const { tasks, submissions } = await harness.inspect(context);\n  for (const submission of submissions)\n    if (submission.conversationId === run.conversationId && submission.status === 'queued')\n      await harness.abortSubmission(submission.id, context, submission.conversationId);\n  for (const task of tasks)\n    if (task.record.conversationId === run.conversationId) await harness.abortTask(task.record.id, context);\n  return markSubagentReported(harness, runId, context, { state: 'failed' });\n}\n\n/** Child conversations of this session; their launcher reports what they spend, not the parent. */\nexport async function subagentConversations(harness: Harness, context: Context): Promise<ConversationId[]> {\n  const doc = await harness.snapshot(SubagentsDoc, context);\n  return [...Object.values(doc?.runs ?? {}).map((run) => run.conversationId), ...(doc?.retired ?? [])].map(\n    (id) => id as ConversationId,\n  );\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,90 @@
+import { SubagentsDoc } from "./docs.mjs";
+import { SubagentAnchorTask } from "./tasks.mjs";
+import { SubagentsExtension } from "./extension.mjs";
+//#region src/services/durableSubagents/index.ts
+/**
+* Creates one run's child conversation, owned by a background anchor of `parent`, and records the run, in one
+* commit. A fresh child starts as a copy of the parent's agent; a fork also keeps its history through `forkAt`.
+*/
+async function createSubagentConversation(harness, parent, launch, context) {
+	const { id, stored } = await parent.commit(async (tx) => {
+		const anchor = await tx.createTask(SubagentAnchorTask, null, {
+			ownership: { kind: "conversation" },
+			background: true
+		});
+		const ownership = {
+			kind: "task",
+			taskId: anchor
+		};
+		const child = launch.forkAt === void 0 ? await tx.createConversation({ ownership }) : await tx.forkConversation(parent.id, launch.forkAt, { ownership });
+		const runs = (await tx.doc(SubagentsDoc)).runs;
+		if (Object.hasOwn(runs, launch.runId)) throw new Error(`Child run '${launch.runId}' already exists.`);
+		const record = {
+			conversationId: child.id,
+			anchorTaskId: anchor,
+			inputRequestId: `subagent:${anchor}:1`,
+			request: launch.request,
+			reported: false
+		};
+		runs[launch.runId] = record;
+		return {
+			id: child.id,
+			stored: record
+		};
+	}, context);
+	const conversation = await harness.conversation(id, context);
+	if (!conversation) throw new Error(`Child conversation ${id} is unavailable.`);
+	return {
+		conversation,
+		stored
+	};
+}
+async function readSubagents(harness, context) {
+	return (await harness.snapshot(SubagentsDoc, context))?.runs ?? {};
+}
+const MAX_REPORTED_RUNS = 256;
+/**
+* Marks a run reported and drops the request only a re-attach needed, keeping its agent, task and outcome. Returns
+* the run's child conversation, or nothing when the run was already reported or is unknown.
+*/
+async function markSubagentReported(harness, runId, context, outcome, maxReported = MAX_REPORTED_RUNS) {
+	return harness.commit(async (tx) => {
+		const doc = await tx.doc(SubagentsDoc);
+		const run = doc.runs[runId];
+		if (!run || run.reported) return void 0;
+		run.reported = true;
+		if (typeof run.request?.agent === "string") run.agent = run.request.agent;
+		if (typeof run.request?.task === "string") run.task = run.request.task;
+		if (outcome) run.state = outcome.state;
+		run.request = null;
+		const reported = Object.entries(doc.runs).filter(([, stored]) => stored.reported);
+		const dropped = reported.slice(0, Math.max(0, reported.length - maxReported));
+		if (dropped.length > 0) {
+			doc.retired = [...doc.retired ?? [], ...dropped.map(([, stored]) => stored.conversationId)];
+			for (const [id] of dropped) delete doc.runs[id];
+		}
+		return run.conversationId;
+	}, context);
+}
+/**
+* Stops a run nothing could re-attach, before the Harness resumes: its child would otherwise run on without a
+* launcher. Only marks its live tasks and withdraws its queued inputs, so scheduling stays paused, then reports it
+* failed. Returns its child conversation, or nothing for an unknown or reported run.
+*/
+async function abandonSubagent(harness, runId, context) {
+	const run = (await readSubagents(harness, context))[runId];
+	if (!run || run.reported) return void 0;
+	const { tasks, submissions } = await harness.inspect(context);
+	for (const submission of submissions) if (submission.conversationId === run.conversationId && submission.status === "queued") await harness.abortSubmission(submission.id, context, submission.conversationId);
+	for (const task of tasks) if (task.record.conversationId === run.conversationId) await harness.abortTask(task.record.id, context);
+	return markSubagentReported(harness, runId, context, { state: "failed" });
+}
+/** Child conversations of this session; their launcher reports what they spend, not the parent. */
+async function subagentConversations(harness, context) {
+	const doc = await harness.snapshot(SubagentsDoc, context);
+	return [...Object.values(doc?.runs ?? {}).map((run) => run.conversationId), ...doc?.retired ?? []].map((id) => id);
+}
+//#endregion
+export { SubagentsExtension, abandonSubagent, createSubagentConversation, markSubagentReported, readSubagents, subagentConversations };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/durableSubagents/index.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport type { Conversation, ConversationId, EntryId, Harness, JsonObject } from '@earendil-works/pi-durable';\n\nimport { SubagentsDoc, type StoredSubagent } from './docs';\nimport { SubagentAnchorTask } from './tasks';\n\nexport { SubagentsDoc, type StoredSubagent } from './docs';\nexport { SubagentsExtension } from './extension';\n\nexport interface SubagentLaunch {\n  readonly runId: string;\n  readonly request: JsonObject;\n  /** Start from the parent's history through this entry instead of a fresh copy of its agent. */\n  readonly forkAt?: EntryId;\n}\n\n/**\n * Creates one run's child conversation, owned by a background anchor of `parent`, and records the run, in one\n * commit. A fresh child starts as a copy of the parent's agent; a fork also keeps its history through `forkAt`.\n */\nexport async function createSubagentConversation(\n  harness: Harness,\n  parent: Conversation,\n  launch: SubagentLaunch,\n  context: Context,\n): Promise<{ conversation: Conversation; stored: StoredSubagent }> {\n  const { id, stored } = await parent.commit(async (tx) => {\n    const anchor = await tx.createTask(SubagentAnchorTask, null, {\n      ownership: { kind: 'conversation' },\n      background: true,\n    });\n    const ownership = { kind: 'task', taskId: anchor } as const;\n    const child =\n      launch.forkAt === undefined\n        ? await tx.createConversation({ ownership })\n        : await tx.forkConversation(parent.id, launch.forkAt, { ownership });\n    const runs = (await tx.doc(SubagentsDoc)).runs;\n    if (Object.hasOwn(runs, launch.runId)) throw new Error(`Child run '${launch.runId}' already exists.`);\n    const record: StoredSubagent = {\n      conversationId: child.id,\n      anchorTaskId: anchor,\n      // One task input per anchor, so a retried admission never posts it twice.\n      inputRequestId: `subagent:${anchor}:1`,\n      request: launch.request,\n      reported: false,\n    };\n    runs[launch.runId] = record;\n    return { id: child.id, stored: record };\n  }, context);\n  const conversation = await harness.conversation(id, context);\n  if (!conversation) throw new Error(`Child conversation ${id} is unavailable.`);\n  return { conversation, stored };\n}\n\nexport async function readSubagents(\n  harness: Harness,\n  context: Context,\n): Promise<Readonly<Record<string, StoredSubagent>>> {\n  return (await harness.snapshot(SubagentsDoc, context))?.runs ?? {};\n}\n\n// ponytail: past this many reported runs the oldest records go and only their child conversation IDs stay, so a\n// long session's doc stays small while its usage still leaves those children out. Upgrade: a doc family per run.\nconst MAX_REPORTED_RUNS = 256;\n\n/**\n * Marks a run reported and drops the request only a re-attach needed, keeping its agent, task and outcome. Returns\n * the run's child conversation, or nothing when the run was already reported or is unknown.\n */\nexport async function markSubagentReported(\n  harness: Harness,\n  runId: string,\n  context: Context,\n  outcome?: { readonly state: NonNullable<StoredSubagent['state']> },\n  maxReported = MAX_REPORTED_RUNS,\n): Promise<ConversationId | undefined> {\n  return harness.commit(async (tx) => {\n    const doc = await tx.doc(SubagentsDoc);\n    const run = doc.runs[runId];\n    if (!run || run.reported) return undefined;\n    run.reported = true;\n    if (typeof run.request?.agent === 'string') run.agent = run.request.agent;\n    if (typeof run.request?.task === 'string') run.task = run.request.task;\n    if (outcome) run.state = outcome.state;\n    run.request = null;\n    // Object keys keep insertion order, so the first reported runs are the oldest.\n    const reported = Object.entries(doc.runs).filter(([, stored]) => stored.reported);\n    const dropped = reported.slice(0, Math.max(0, reported.length - maxReported));\n    if (dropped.length > 0) {\n      doc.retired = [...(doc.retired ?? []), ...dropped.map(([, stored]) => stored.conversationId)];\n      for (const [id] of dropped) delete doc.runs[id];\n    }\n    return run.conversationId as ConversationId;\n  }, context);\n}\n\n/**\n * Stops a run nothing could re-attach, before the Harness resumes: its child would otherwise run on without a\n * launcher. Only marks its live tasks and withdraws its queued inputs, so scheduling stays paused, then reports it\n * failed. Returns its child conversation, or nothing for an unknown or reported run.\n */\nexport async function abandonSubagent(\n  harness: Harness,\n  runId: string,\n  context: Context,\n): Promise<ConversationId | undefined> {\n  const run = (await readSubagents(harness, context))[runId];\n  if (!run || run.reported) return undefined;\n  const { tasks, submissions } = await harness.inspect(context);\n  for (const submission of submissions)\n    if (submission.conversationId === run.conversationId && submission.status === 'queued')\n      await harness.abortSubmission(submission.id, context, submission.conversationId);\n  for (const task of tasks)\n    if (task.record.conversationId === run.conversationId) await harness.abortTask(task.record.id, context);\n  return markSubagentReported(harness, runId, context, { state: 'failed' });\n}\n\n/** Child conversations of this session; their launcher reports what they spend, not the parent. */\nexport async function subagentConversations(harness: Harness, context: Context): Promise<ConversationId[]> {\n  const doc = await harness.snapshot(SubagentsDoc, context);\n  return [...Object.values(doc?.runs ?? {}).map((run) => run.conversationId), ...(doc?.retired ?? [])].map(\n    (id) => id as ConversationId,\n  );\n}\n"],"mappings":"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"}

package/dist/src/services/durableSubagents/tasks.cjs

@@ -0,0 +1,25 @@
+//#region src/services/durableSubagents/tasks.ts
+/**
+* Owns a child conversation so it outlives the parent's turns. A background task that finishes at once: the
+* parent's Esc and idle waits stop at it, while the child keeps working and resumes with the Harness.
+*/
+const SubagentAnchorTask = (0, require("@earendil-works/pi-durable").defineTask)({
+	name: "po.subagents.anchor",
+	version: 1,
+	initial: () => ({ phase: "done" }),
+	phases: { done: (_anchor, runtime, context) => runtime.commit(() => ({
+		status: "terminal",
+		outcome: {
+			status: "completed",
+			result: null
+		}
+	}), context) },
+	abort: (_anchor, runtime, context) => runtime.commit(() => ({
+		status: "terminal",
+		outcome: { status: "aborted" }
+	}), context)
+});
+//#endregion
+exports.SubagentAnchorTask = SubagentAnchorTask;
+
+//# sourceMappingURL=tasks.cjs.map

package/dist/src/services/durableSubagents/tasks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.cjs","names":["defineTask"],"sources":["../../../../src/services/durableSubagents/tasks.ts"],"sourcesContent":["import { defineTask } from '@earendil-works/pi-durable';\n\n/**\n * Owns a child conversation so it outlives the parent's turns. A background task that finishes at once: the\n * parent's Esc and idle waits stop at it, while the child keeps working and resumes with the Harness.\n */\nexport const SubagentAnchorTask = defineTask<null, { phase: 'done' }, null>({\n  name: 'po.subagents.anchor',\n  version: 1,\n  initial: () => ({ phase: 'done' }),\n  phases: {\n    done: (_anchor, runtime, context) =>\n      runtime.commit(() => ({ status: 'terminal', outcome: { status: 'completed', result: null } }), context),\n  },\n  abort: (_anchor, runtime, context) =>\n    runtime.commit(() => ({ status: 'terminal', outcome: { status: 'aborted' } }), context),\n});\n"],"mappings":";;;;;AAMA,MAAa,sBAAA,uCAAqBA,CAAAA,CAAAA,WAAAA,CAA0C;CAC1E,MAAM;CACN,SAAS;CACT,gBAAgB,EAAE,OAAO,OAAO;CAChC,QAAQ,EACN,OAAO,SAAS,SAAS,YACvB,QAAQ,cAAc;EAAE,QAAQ;EAAY,SAAS;GAAE,QAAQ;GAAa,QAAQ;EAAK;CAAE,IAAI,OAAO,EAC1G;CACA,QAAQ,SAAS,SAAS,YACxB,QAAQ,cAAc;EAAE,QAAQ;EAAY,SAAS,EAAE,QAAQ,UAAU;CAAE,IAAI,OAAO;AAC1F,CAAC"}

package/dist/src/services/durableSubagents/tasks.mjs

@@ -0,0 +1,26 @@
+import { defineTask } from "@earendil-works/pi-durable";
+//#region src/services/durableSubagents/tasks.ts
+/**
+* Owns a child conversation so it outlives the parent's turns. A background task that finishes at once: the
+* parent's Esc and idle waits stop at it, while the child keeps working and resumes with the Harness.
+*/
+const SubagentAnchorTask = defineTask({
+	name: "po.subagents.anchor",
+	version: 1,
+	initial: () => ({ phase: "done" }),
+	phases: { done: (_anchor, runtime, context) => runtime.commit(() => ({
+		status: "terminal",
+		outcome: {
+			status: "completed",
+			result: null
+		}
+	}), context) },
+	abort: (_anchor, runtime, context) => runtime.commit(() => ({
+		status: "terminal",
+		outcome: { status: "aborted" }
+	}), context)
+});
+//#endregion
+export { SubagentAnchorTask };
+
+//# sourceMappingURL=tasks.mjs.map

package/dist/src/services/durableSubagents/tasks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.mjs","names":[],"sources":["../../../../src/services/durableSubagents/tasks.ts"],"sourcesContent":["import { defineTask } from '@earendil-works/pi-durable';\n\n/**\n * Owns a child conversation so it outlives the parent's turns. A background task that finishes at once: the\n * parent's Esc and idle waits stop at it, while the child keeps working and resumes with the Harness.\n */\nexport const SubagentAnchorTask = defineTask<null, { phase: 'done' }, null>({\n  name: 'po.subagents.anchor',\n  version: 1,\n  initial: () => ({ phase: 'done' }),\n  phases: {\n    done: (_anchor, runtime, context) =>\n      runtime.commit(() => ({ status: 'terminal', outcome: { status: 'completed', result: null } }), context),\n  },\n  abort: (_anchor, runtime, context) =>\n    runtime.commit(() => ({ status: 'terminal', outcome: { status: 'aborted' } }), context),\n});\n"],"mappings":";;;;;;AAMA,MAAa,qBAAqB,WAA0C;CAC1E,MAAM;CACN,SAAS;CACT,gBAAgB,EAAE,OAAO,OAAO;CAChC,QAAQ,EACN,OAAO,SAAS,SAAS,YACvB,QAAQ,cAAc;EAAE,QAAQ;EAAY,SAAS;GAAE,QAAQ;GAAa,QAAQ;EAAK;CAAE,IAAI,OAAO,EAC1G;CACA,QAAQ,SAAS,SAAS,YACxB,QAAQ,cAAc;EAAE,QAAQ;EAAY,SAAS,EAAE,QAAQ,UAAU;CAAE,IAAI,OAAO;AAC1F,CAAC"}

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

@@ -11,10 +11,10 @@ function createHeadlessClient(options) {
 		client: {
 			async notify(request) {
 				if (disposed) return;
-				const data = require_notification.createDoomNotificationEntryData(request);
+				const data = require_notification.createPoNotificationEntryData(request);
 				if (!data) throw new Error("Invalid notification request");
 				try {
-					await options.appendCustomEntry(require_notification.DOOM_NOTIFICATION_ENTRY_TYPE, data);
+					await options.appendCustomEntry(require_notification.PO_NOTIFICATION_ENTRY_TYPE, data);
 				} catch (error) {
 					if (disposed) return;
 					options.emitFrame({
@@ -25,7 +25,7 @@ function createHeadlessClient(options) {
 				}
 			},
 			setStatus(source, text) {
-				if (disposed) throw new Error("Headless client is closed");
+				if (disposed) return;
 				options.emitFrame({
 					type: "extension_ui_request",
 					method: "setStatus",
@@ -72,21 +72,25 @@ function createHeadlessClient(options) {
 						}
 					};
 					const abort = () => finish({ value: void 0 });
+					const frame = {
+						type: "extension_ui_request",
+						id,
+						method: request.kind === "input" && request.multiline ? "editor" : request.kind,
+						title: request.title,
+						message: request.message,
+						options: labels,
+						placeholder: request.message,
+						prefill: request.initialValue
+					};
 					pending.set(id, {
+						replay(listener) {
+							if (started) listener(frame);
+						},
 						start() {
 							if (started || disposed) return;
 							started = true;
 							try {
-								options.emitFrame({
-									type: "extension_ui_request",
-									id,
-									method: request.kind === "input" && request.multiline ? "editor" : request.kind,
-									title: request.title,
-									message: request.message,
-									options: labels,
-									placeholder: request.message,
-									prefill: request.initialValue
-								});
+								options.emitFrame(frame);
 							} catch (error) {
 								finish({ error });
 							}
@@ -113,6 +117,9 @@ function createHeadlessClient(options) {
 			if (typeof frame.id === "string") pending.get(frame.id)?.respond(frame);
 			return true;
 		},
+		replay(listener) {
+			pending.values().next().value?.replay(listener);
+		},
 		dispose() {
 			if (disposed) return;
 			disposed = true;

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createDoomNotificationEntryData","DOOM_NOTIFICATION_ENTRY_TYPE","randomUUID"],"sources":["../../../../src/services/headlessClient/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { createDoomNotificationEntryData, DOOM_NOTIFICATION_ENTRY_TYPE } from '../../exports/notification';\nimport type {\n  HeadlessClientBridge,\n  HeadlessClientOptions,\n  PendingClientRequest,\n} from '../../types/server/headlessClient';\n\n/** Explicit client interactions over the existing browser dialog protocol. */\nexport function createHeadlessClient(options: HeadlessClientOptions): HeadlessClientBridge {\n  const pending = new Map<string, PendingClientRequest>();\n  let disposed = false;\n  const advance = (): void => pending.values().next().value?.start();\n\n  return {\n    client: {\n      async notify(request) {\n        // Detached callbacks can outlive their session. A closed client has no recipient.\n        if (disposed) return;\n        const data = createDoomNotificationEntryData(request);\n        if (!data) throw new Error('Invalid notification request');\n        try {\n          await options.appendCustomEntry(DOOM_NOTIFICATION_ENTRY_TYPE, data);\n        } catch (error) {\n          if (disposed) return;\n          // Callers fire notify without awaiting, often to report a journal failure. A rejection here\n          // would crash the session server, so a refused append still reaches the browser live.\n          options.emitFrame({\n            type: 'error',\n            code: 'notification_undelivered',\n            error: `${data.body} (not saved to history: ${error instanceof Error ? error.message : String(error)})`,\n          });\n        }\n      },\n      setStatus(source, text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'setStatus', statusKey: source, statusText: text });\n      },\n      appendComposerText(text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'append_composer_text', id: randomUUID(), text });\n      },\n      request(request, signal) {\n        if (disposed) return Promise.reject(new Error('Headless client is closed'));\n        if (signal?.aborted) return Promise.resolve(undefined);\n        if (!['confirm', 'select', 'input'].includes(request.kind)) {\n          return Promise.reject(new Error('Unsupported headless client request'));\n        }\n        const labels = request.options?.map((option) => option.label);\n        if (labels && new Set(labels).size !== labels.length) {\n          return Promise.reject(new Error('Select option labels must be unique'));\n        }\n        const id = `headless-ui:${randomUUID()}`;\n        return new Promise((resolve, reject) => {\n          let started = false;\n          const finish = (outcome: { value: unknown } | { error: unknown }): void => {\n            if (!pending.delete(id)) return;\n            signal?.removeEventListener('abort', abort);\n            try {\n              if (started) options.emitFrame({ type: 'extension_ui_answered', id });\n              if ('error' in outcome) reject(outcome.error);\n              else resolve(outcome.value);\n            } catch (error) {\n              reject(error);\n            } finally {\n              advance();\n            }\n          };\n          const abort = (): void => finish({ value: undefined });\n          pending.set(id, {\n            start() {\n              if (started || disposed) return;\n              started = true;\n              try {\n                options.emitFrame({\n                  type: 'extension_ui_request',\n                  id,\n                  method: request.kind === 'input' && request.multiline ? 'editor' : request.kind,\n                  title: request.title,\n                  message: request.message,\n                  options: labels,\n                  placeholder: request.message,\n                  prefill: request.initialValue,\n                });\n              } catch (error) {\n                finish({ error });\n              }\n            },\n            respond(frame) {\n              if (!started) return;\n              if (frame.cancelled === true) return finish({ value: undefined });\n              if (request.kind === 'confirm') {\n                if (typeof frame.confirmed === 'boolean') finish({ value: frame.confirmed });\n              } else if (typeof frame.value === 'string') {\n                // Rich questionnaire clients return an encoded whole-answer envelope here.\n                const selected = request.options?.find((option) => option.label === frame.value);\n                finish({ value: selected?.value ?? frame.value });\n              }\n            },\n            close: () => finish({ error: new Error('Headless client is closed') }),\n          });\n          signal?.addEventListener('abort', abort, { once: true });\n          advance();\n        });\n      },\n    },\n    receive(frame) {\n      if (frame.type !== 'extension_ui_response') return false;\n      if (typeof frame.id === 'string') pending.get(frame.id)?.respond(frame);\n      return true;\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      for (const request of pending.values()) request.close();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["createPoNotificationEntryData","PO_NOTIFICATION_ENTRY_TYPE","randomUUID"],"sources":["../../../../src/services/headlessClient/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { createPoNotificationEntryData, PO_NOTIFICATION_ENTRY_TYPE } from '../../exports/notification';\nimport type {\n  HeadlessClientBridge,\n  HeadlessClientOptions,\n  PendingClientRequest,\n} from '../../types/server/headlessClient';\n\n/** Explicit client interactions over the existing browser dialog protocol. */\nexport function createHeadlessClient(options: HeadlessClientOptions): HeadlessClientBridge {\n  const pending = new Map<string, PendingClientRequest>();\n  let disposed = false;\n  const advance = (): void => pending.values().next().value?.start();\n\n  return {\n    client: {\n      async notify(request) {\n        // Detached callbacks can outlive their session. A closed client has no recipient.\n        if (disposed) return;\n        const data = createPoNotificationEntryData(request);\n        if (!data) throw new Error('Invalid notification request');\n        try {\n          await options.appendCustomEntry(PO_NOTIFICATION_ENTRY_TYPE, data);\n        } catch (error) {\n          if (disposed) return;\n          // Callers fire notify without awaiting, often to report a journal failure. A rejection here\n          // would crash the session server, so a refused append still reaches the browser live.\n          options.emitFrame({\n            type: 'error',\n            code: 'notification_undelivered',\n            error: `${data.body} (not saved to history: ${error instanceof Error ? error.message : String(error)})`,\n          });\n        }\n      },\n      setStatus(source, text) {\n        // Packages clear their status while they unwind, which is after their session shut down. A\n        // throw here used to abort that teardown and leak everything after it.\n        if (disposed) return;\n        options.emitFrame({ type: 'extension_ui_request', method: 'setStatus', statusKey: source, statusText: text });\n      },\n      appendComposerText(text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'append_composer_text', id: randomUUID(), text });\n      },\n      request(request, signal) {\n        if (disposed) return Promise.reject(new Error('Headless client is closed'));\n        if (signal?.aborted) return Promise.resolve(undefined);\n        if (!['confirm', 'select', 'input'].includes(request.kind)) {\n          return Promise.reject(new Error('Unsupported headless client request'));\n        }\n        const labels = request.options?.map((option) => option.label);\n        if (labels && new Set(labels).size !== labels.length) {\n          return Promise.reject(new Error('Select option labels must be unique'));\n        }\n        const id = `headless-ui:${randomUUID()}`;\n        return new Promise((resolve, reject) => {\n          let started = false;\n          const finish = (outcome: { value: unknown } | { error: unknown }): void => {\n            if (!pending.delete(id)) return;\n            signal?.removeEventListener('abort', abort);\n            try {\n              if (started) options.emitFrame({ type: 'extension_ui_answered', id });\n              if ('error' in outcome) reject(outcome.error);\n              else resolve(outcome.value);\n            } catch (error) {\n              reject(error);\n            } finally {\n              advance();\n            }\n          };\n          const abort = (): void => finish({ value: undefined });\n          const frame = {\n            type: 'extension_ui_request',\n            id,\n            method: request.kind === 'input' && request.multiline ? 'editor' : request.kind,\n            title: request.title,\n            message: request.message,\n            options: labels,\n            placeholder: request.message,\n            prefill: request.initialValue,\n          };\n          pending.set(id, {\n            replay(listener) {\n              if (started) listener(frame);\n            },\n            start() {\n              if (started || disposed) return;\n              started = true;\n              try {\n                options.emitFrame(frame);\n              } catch (error) {\n                finish({ error });\n              }\n            },\n            respond(frame) {\n              if (!started) return;\n              if (frame.cancelled === true) return finish({ value: undefined });\n              if (request.kind === 'confirm') {\n                if (typeof frame.confirmed === 'boolean') finish({ value: frame.confirmed });\n              } else if (typeof frame.value === 'string') {\n                // Rich questionnaire clients return an encoded whole-answer envelope here.\n                const selected = request.options?.find((option) => option.label === frame.value);\n                finish({ value: selected?.value ?? frame.value });\n              }\n            },\n            close: () => finish({ error: new Error('Headless client is closed') }),\n          });\n          signal?.addEventListener('abort', abort, { once: true });\n          advance();\n        });\n      },\n    },\n    receive(frame) {\n      if (frame.type !== 'extension_ui_response') return false;\n      if (typeof frame.id === 'string') pending.get(frame.id)?.respond(frame);\n      return true;\n    },\n    replay(listener) {\n      // A focused presentation may attach after the tool has started waiting.\n      // Only its current request is replayed, not answered or queued dialogs.\n      pending.values().next().value?.replay(listener);\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      for (const request of pending.values()) request.close();\n    },\n  };\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { DOOM_NOTIFICATION_ENTRY_TYPE, createDoomNotificationEntryData } from "../../schemas/notification.mjs";
+import { PO_NOTIFICATION_ENTRY_TYPE, createPoNotificationEntryData } from "../../schemas/notification.mjs";
 import "../../../notification.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/services/headlessClient/index.ts
@@ -11,10 +11,10 @@ function createHeadlessClient(options) {
 		client: {
 			async notify(request) {
 				if (disposed) return;
-				const data = createDoomNotificationEntryData(request);
+				const data = createPoNotificationEntryData(request);
 				if (!data) throw new Error("Invalid notification request");
 				try {
-					await options.appendCustomEntry(DOOM_NOTIFICATION_ENTRY_TYPE, data);
+					await options.appendCustomEntry(PO_NOTIFICATION_ENTRY_TYPE, data);
 				} catch (error) {
 					if (disposed) return;
 					options.emitFrame({
@@ -25,7 +25,7 @@ function createHeadlessClient(options) {
 				}
 			},
 			setStatus(source, text) {
-				if (disposed) throw new Error("Headless client is closed");
+				if (disposed) return;
 				options.emitFrame({
 					type: "extension_ui_request",
 					method: "setStatus",
@@ -72,21 +72,25 @@ function createHeadlessClient(options) {
 						}
 					};
 					const abort = () => finish({ value: void 0 });
+					const frame = {
+						type: "extension_ui_request",
+						id,
+						method: request.kind === "input" && request.multiline ? "editor" : request.kind,
+						title: request.title,
+						message: request.message,
+						options: labels,
+						placeholder: request.message,
+						prefill: request.initialValue
+					};
 					pending.set(id, {
+						replay(listener) {
+							if (started) listener(frame);
+						},
 						start() {
 							if (started || disposed) return;
 							started = true;
 							try {
-								options.emitFrame({
-									type: "extension_ui_request",
-									id,
-									method: request.kind === "input" && request.multiline ? "editor" : request.kind,
-									title: request.title,
-									message: request.message,
-									options: labels,
-									placeholder: request.message,
-									prefill: request.initialValue
-								});
+								options.emitFrame(frame);
 							} catch (error) {
 								finish({ error });
 							}
@@ -113,6 +117,9 @@ function createHeadlessClient(options) {
 			if (typeof frame.id === "string") pending.get(frame.id)?.respond(frame);
 			return true;
 		},
+		replay(listener) {
+			pending.values().next().value?.replay(listener);
+		},
 		dispose() {
 			if (disposed) return;
 			disposed = true;

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/headlessClient/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { createDoomNotificationEntryData, DOOM_NOTIFICATION_ENTRY_TYPE } from '../../exports/notification';\nimport type {\n  HeadlessClientBridge,\n  HeadlessClientOptions,\n  PendingClientRequest,\n} from '../../types/server/headlessClient';\n\n/** Explicit client interactions over the existing browser dialog protocol. */\nexport function createHeadlessClient(options: HeadlessClientOptions): HeadlessClientBridge {\n  const pending = new Map<string, PendingClientRequest>();\n  let disposed = false;\n  const advance = (): void => pending.values().next().value?.start();\n\n  return {\n    client: {\n      async notify(request) {\n        // Detached callbacks can outlive their session. A closed client has no recipient.\n        if (disposed) return;\n        const data = createDoomNotificationEntryData(request);\n        if (!data) throw new Error('Invalid notification request');\n        try {\n          await options.appendCustomEntry(DOOM_NOTIFICATION_ENTRY_TYPE, data);\n        } catch (error) {\n          if (disposed) return;\n          // Callers fire notify without awaiting, often to report a journal failure. A rejection here\n          // would crash the session server, so a refused append still reaches the browser live.\n          options.emitFrame({\n            type: 'error',\n            code: 'notification_undelivered',\n            error: `${data.body} (not saved to history: ${error instanceof Error ? error.message : String(error)})`,\n          });\n        }\n      },\n      setStatus(source, text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'setStatus', statusKey: source, statusText: text });\n      },\n      appendComposerText(text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'append_composer_text', id: randomUUID(), text });\n      },\n      request(request, signal) {\n        if (disposed) return Promise.reject(new Error('Headless client is closed'));\n        if (signal?.aborted) return Promise.resolve(undefined);\n        if (!['confirm', 'select', 'input'].includes(request.kind)) {\n          return Promise.reject(new Error('Unsupported headless client request'));\n        }\n        const labels = request.options?.map((option) => option.label);\n        if (labels && new Set(labels).size !== labels.length) {\n          return Promise.reject(new Error('Select option labels must be unique'));\n        }\n        const id = `headless-ui:${randomUUID()}`;\n        return new Promise((resolve, reject) => {\n          let started = false;\n          const finish = (outcome: { value: unknown } | { error: unknown }): void => {\n            if (!pending.delete(id)) return;\n            signal?.removeEventListener('abort', abort);\n            try {\n              if (started) options.emitFrame({ type: 'extension_ui_answered', id });\n              if ('error' in outcome) reject(outcome.error);\n              else resolve(outcome.value);\n            } catch (error) {\n              reject(error);\n            } finally {\n              advance();\n            }\n          };\n          const abort = (): void => finish({ value: undefined });\n          pending.set(id, {\n            start() {\n              if (started || disposed) return;\n              started = true;\n              try {\n                options.emitFrame({\n                  type: 'extension_ui_request',\n                  id,\n                  method: request.kind === 'input' && request.multiline ? 'editor' : request.kind,\n                  title: request.title,\n                  message: request.message,\n                  options: labels,\n                  placeholder: request.message,\n                  prefill: request.initialValue,\n                });\n              } catch (error) {\n                finish({ error });\n              }\n            },\n            respond(frame) {\n              if (!started) return;\n              if (frame.cancelled === true) return finish({ value: undefined });\n              if (request.kind === 'confirm') {\n                if (typeof frame.confirmed === 'boolean') finish({ value: frame.confirmed });\n              } else if (typeof frame.value === 'string') {\n                // Rich questionnaire clients return an encoded whole-answer envelope here.\n                const selected = request.options?.find((option) => option.label === frame.value);\n                finish({ value: selected?.value ?? frame.value });\n              }\n            },\n            close: () => finish({ error: new Error('Headless client is closed') }),\n          });\n          signal?.addEventListener('abort', abort, { once: true });\n          advance();\n        });\n      },\n    },\n    receive(frame) {\n      if (frame.type !== 'extension_ui_response') return false;\n      if (typeof frame.id === 'string') pending.get(frame.id)?.respond(frame);\n      return true;\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      for (const request of pending.values()) request.close();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/headlessClient/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { createPoNotificationEntryData, PO_NOTIFICATION_ENTRY_TYPE } from '../../exports/notification';\nimport type {\n  HeadlessClientBridge,\n  HeadlessClientOptions,\n  PendingClientRequest,\n} from '../../types/server/headlessClient';\n\n/** Explicit client interactions over the existing browser dialog protocol. */\nexport function createHeadlessClient(options: HeadlessClientOptions): HeadlessClientBridge {\n  const pending = new Map<string, PendingClientRequest>();\n  let disposed = false;\n  const advance = (): void => pending.values().next().value?.start();\n\n  return {\n    client: {\n      async notify(request) {\n        // Detached callbacks can outlive their session. A closed client has no recipient.\n        if (disposed) return;\n        const data = createPoNotificationEntryData(request);\n        if (!data) throw new Error('Invalid notification request');\n        try {\n          await options.appendCustomEntry(PO_NOTIFICATION_ENTRY_TYPE, data);\n        } catch (error) {\n          if (disposed) return;\n          // Callers fire notify without awaiting, often to report a journal failure. A rejection here\n          // would crash the session server, so a refused append still reaches the browser live.\n          options.emitFrame({\n            type: 'error',\n            code: 'notification_undelivered',\n            error: `${data.body} (not saved to history: ${error instanceof Error ? error.message : String(error)})`,\n          });\n        }\n      },\n      setStatus(source, text) {\n        // Packages clear their status while they unwind, which is after their session shut down. A\n        // throw here used to abort that teardown and leak everything after it.\n        if (disposed) return;\n        options.emitFrame({ type: 'extension_ui_request', method: 'setStatus', statusKey: source, statusText: text });\n      },\n      appendComposerText(text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'append_composer_text', id: randomUUID(), text });\n      },\n      request(request, signal) {\n        if (disposed) return Promise.reject(new Error('Headless client is closed'));\n        if (signal?.aborted) return Promise.resolve(undefined);\n        if (!['confirm', 'select', 'input'].includes(request.kind)) {\n          return Promise.reject(new Error('Unsupported headless client request'));\n        }\n        const labels = request.options?.map((option) => option.label);\n        if (labels && new Set(labels).size !== labels.length) {\n          return Promise.reject(new Error('Select option labels must be unique'));\n        }\n        const id = `headless-ui:${randomUUID()}`;\n        return new Promise((resolve, reject) => {\n          let started = false;\n          const finish = (outcome: { value: unknown } | { error: unknown }): void => {\n            if (!pending.delete(id)) return;\n            signal?.removeEventListener('abort', abort);\n            try {\n              if (started) options.emitFrame({ type: 'extension_ui_answered', id });\n              if ('error' in outcome) reject(outcome.error);\n              else resolve(outcome.value);\n            } catch (error) {\n              reject(error);\n            } finally {\n              advance();\n            }\n          };\n          const abort = (): void => finish({ value: undefined });\n          const frame = {\n            type: 'extension_ui_request',\n            id,\n            method: request.kind === 'input' && request.multiline ? 'editor' : request.kind,\n            title: request.title,\n            message: request.message,\n            options: labels,\n            placeholder: request.message,\n            prefill: request.initialValue,\n          };\n          pending.set(id, {\n            replay(listener) {\n              if (started) listener(frame);\n            },\n            start() {\n              if (started || disposed) return;\n              started = true;\n              try {\n                options.emitFrame(frame);\n              } catch (error) {\n                finish({ error });\n              }\n            },\n            respond(frame) {\n              if (!started) return;\n              if (frame.cancelled === true) return finish({ value: undefined });\n              if (request.kind === 'confirm') {\n                if (typeof frame.confirmed === 'boolean') finish({ value: frame.confirmed });\n              } else if (typeof frame.value === 'string') {\n                // Rich questionnaire clients return an encoded whole-answer envelope here.\n                const selected = request.options?.find((option) => option.label === frame.value);\n                finish({ value: selected?.value ?? frame.value });\n              }\n            },\n            close: () => finish({ error: new Error('Headless client is closed') }),\n          });\n          signal?.addEventListener('abort', abort, { once: true });\n          advance();\n        });\n      },\n    },\n    receive(frame) {\n      if (frame.type !== 'extension_ui_response') return false;\n      if (typeof frame.id === 'string') pending.get(frame.id)?.respond(frame);\n      return true;\n    },\n    replay(listener) {\n      // A focused presentation may attach after the tool has started waiting.\n      // Only its current request is replayed, not answered or queued dialogs.\n      pending.values().next().value?.replay(listener);\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      for (const request of pending.values()) request.close();\n    },\n  };\n}\n"],"mappings":"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"}