@agimon-ai/doompi-core 0.0.1-alpha.100

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

@@ -0,0 +1,129 @@
+//#region src/services/acpSessionUpdates/index.ts
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function content(value) {
+	if (typeof value === "string") return [{
+		type: "text",
+		text: value
+	}];
+	if (!Array.isArray(value)) return [];
+	const blocks = [];
+	for (const part of value) {
+		const item = record(part);
+		if (item?.type === "text" && typeof item.text === "string") blocks.push({
+			type: "text",
+			text: item.text
+		});
+		if (item?.type === "image" && typeof item.data === "string" && typeof item.mimeType === "string") blocks.push({
+			type: "image",
+			data: item.data,
+			mimeType: item.mimeType
+		});
+	}
+	return blocks;
+}
+function progressUpdates(progress) {
+	const item = progress.item;
+	if (item.role === "user") return [{
+		sessionUpdate: "user_message",
+		messageId: item.id,
+		content: item.content
+	}];
+	if (item.role === "tool") return [{
+		sessionUpdate: "tool_call_update",
+		toolCallId: item.toolCallId,
+		title: item.toolName,
+		kind: "other",
+		status: item.status === "running" ? "in_progress" : item.status === "error" ? "failed" : "completed",
+		rawInput: item.input,
+		...progress.type === "item_finished" ? { content: item.content.map((block) => ({
+			type: "content",
+			content: block
+		})) } : {}
+	}];
+	const updates = [];
+	const messageContent = item.content.filter((part) => part.type === "text");
+	if (messageContent.length > 0) updates.push({
+		sessionUpdate: "agent_message",
+		messageId: item.id,
+		content: messageContent
+	});
+	const thoughtContent = item.content.flatMap((part) => part.type === "thinking" && !part.redacted ? [{
+		type: "text",
+		text: part.thinking
+	}] : []);
+	if (thoughtContent.length > 0) updates.push({
+		sessionUpdate: "agent_thought",
+		messageId: `${item.id}:thought`,
+		content: thoughtContent
+	});
+	for (const part of item.content) {
+		if (part.type !== "toolCall") continue;
+		updates.push({
+			sessionUpdate: "tool_call_update",
+			toolCallId: part.toolCallId,
+			title: part.toolName,
+			kind: "other",
+			status: "pending",
+			rawInput: part.input
+		});
+	}
+	return updates;
+}
+/** Projects the Pi frame stream into the ACP v2 session/update vocabulary. */
+function createAcpSessionUpdateProjection() {
+	const seenUserMessages = /* @__PURE__ */ new Set();
+	let lastStopReason = "end_turn";
+	return { apply(frame, reduction) {
+		const updates = [];
+		if (frame.type === "message_start" || frame.type === "message_end" || frame.type === "entry_appended") {
+			const entry = record(frame.entry);
+			const message = record(frame.type === "entry_appended" ? entry?.message : frame.message);
+			if (message?.role === "user") {
+				const blocks = content(message.content);
+				const id = typeof message.timestamp === "number" ? `user-${message.timestamp}` : typeof entry?.id === "string" ? entry.id : void 0;
+				if (id !== void 0 && blocks.length > 0 && !seenUserMessages.has(id)) {
+					seenUserMessages.add(id);
+					updates.push({
+						sessionUpdate: "user_message",
+						messageId: id,
+						content: blocks
+					});
+				}
+			}
+		}
+		if (reduction.progress) {
+			updates.push(...progressUpdates(reduction.progress));
+			if (reduction.progress.type === "item_finished" && reduction.progress.item.role === "assistant") {
+				const reason = reduction.progress.item.stopReason;
+				lastStopReason = reason === "aborted" ? "cancelled" : reason === "length" ? "max_tokens" : "end_turn";
+			}
+		}
+		if (frame.type === "agent_start") updates.push({
+			sessionUpdate: "state_update",
+			state: "running"
+		});
+		if (frame.type === "extension_ui_request") updates.push({
+			sessionUpdate: "state_update",
+			state: "requires_action"
+		});
+		if (frame.type === "extension_ui_answered") updates.push({
+			sessionUpdate: "state_update",
+			state: "running"
+		});
+		if (frame.type === "agent_settled") {
+			updates.push({
+				sessionUpdate: "state_update",
+				state: "idle",
+				stopReason: lastStopReason
+			});
+			lastStopReason = "end_turn";
+		}
+		return updates;
+	} };
+}
+//#endregion
+exports.createAcpSessionUpdateProjection = createAcpSessionUpdateProjection;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/acpSessionUpdates/index.ts"],"sourcesContent":["import type {\n  DoomContentBlock,\n  DoomSessionStopReason,\n  DoomSessionUpdate,\n  TranscriptProgress,\n} from '../../exports/sessionProtocol';\nimport type { SessionFrame } from '../../types/server/session';\nimport type { TranscriptReduction } from '../rpcTranscript';\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction content(value: unknown): DoomContentBlock[] {\n  if (typeof value === 'string') return [{ type: 'text', text: value }];\n  if (!Array.isArray(value)) return [];\n  const blocks: DoomContentBlock[] = [];\n  for (const part of value) {\n    const item = record(part);\n    if (item?.type === 'text' && typeof item.text === 'string') blocks.push({ type: 'text', text: item.text });\n    if (item?.type === 'image' && typeof item.data === 'string' && typeof item.mimeType === 'string')\n      blocks.push({ type: 'image', data: item.data, mimeType: item.mimeType });\n  }\n  return blocks;\n}\n\nfunction progressUpdates(progress: TranscriptProgress): DoomSessionUpdate[] {\n  const item = progress.item;\n  if (item.role === 'user') return [{ sessionUpdate: 'user_message', messageId: item.id, content: item.content }];\n  if (item.role === 'tool') {\n    return [\n      {\n        sessionUpdate: 'tool_call_update',\n        toolCallId: item.toolCallId,\n        title: item.toolName,\n        kind: 'other',\n        status: item.status === 'running' ? 'in_progress' : item.status === 'error' ? 'failed' : 'completed',\n        rawInput: item.input,\n        ...(progress.type === 'item_finished'\n          ? { content: item.content.map((block) => ({ type: 'content' as const, content: block })) }\n          : {}),\n      },\n    ];\n  }\n  const updates: DoomSessionUpdate[] = [];\n  const messageContent = item.content.filter((part) => part.type === 'text');\n  if (messageContent.length > 0)\n    updates.push({ sessionUpdate: 'agent_message', messageId: item.id, content: messageContent });\n  const thoughtContent = item.content.flatMap((part) =>\n    part.type === 'thinking' && !part.redacted ? [{ type: 'text' as const, text: part.thinking }] : [],\n  );\n  if (thoughtContent.length > 0)\n    updates.push({ sessionUpdate: 'agent_thought', messageId: `${item.id}:thought`, content: thoughtContent });\n  for (const part of item.content) {\n    if (part.type !== 'toolCall') continue;\n    updates.push({\n      sessionUpdate: 'tool_call_update',\n      toolCallId: part.toolCallId,\n      title: part.toolName,\n      kind: 'other',\n      status: 'pending',\n      rawInput: part.input,\n    });\n  }\n  return updates;\n}\n\n/** Projects the Pi frame stream into the ACP v2 session/update vocabulary. */\nexport function createAcpSessionUpdateProjection(): {\n  apply(frame: SessionFrame, reduction: TranscriptReduction): DoomSessionUpdate[];\n} {\n  const seenUserMessages = new Set<string>();\n  let lastStopReason: DoomSessionStopReason = 'end_turn';\n  return {\n    apply(frame, reduction) {\n      const updates: DoomSessionUpdate[] = [];\n      if (frame.type === 'message_start' || frame.type === 'message_end' || frame.type === 'entry_appended') {\n        const entry = record(frame.entry);\n        const message = record(frame.type === 'entry_appended' ? entry?.message : frame.message);\n        if (message?.role === 'user') {\n          const blocks = content(message.content);\n          const id =\n            typeof message.timestamp === 'number'\n              ? `user-${message.timestamp}`\n              : typeof entry?.id === 'string'\n                ? entry.id\n                : undefined;\n          if (id !== undefined && blocks.length > 0 && !seenUserMessages.has(id)) {\n            seenUserMessages.add(id);\n            updates.push({ sessionUpdate: 'user_message', messageId: id, content: blocks });\n          }\n        }\n      }\n      if (reduction.progress) {\n        updates.push(...progressUpdates(reduction.progress));\n        if (reduction.progress.type === 'item_finished' && reduction.progress.item.role === 'assistant') {\n          const reason = reduction.progress.item.stopReason;\n          lastStopReason = reason === 'aborted' ? 'cancelled' : reason === 'length' ? 'max_tokens' : 'end_turn';\n        }\n      }\n      if (frame.type === 'agent_start') updates.push({ sessionUpdate: 'state_update', state: 'running' });\n      if (frame.type === 'extension_ui_request')\n        updates.push({ sessionUpdate: 'state_update', state: 'requires_action' });\n      if (frame.type === 'extension_ui_answered') updates.push({ sessionUpdate: 'state_update', state: 'running' });\n      if (frame.type === 'agent_settled') {\n        updates.push({ sessionUpdate: 'state_update', state: 'idle', stopReason: lastStopReason });\n        lastStopReason = 'end_turn';\n      }\n      return updates;\n    },\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,129 @@
+//#region src/services/acpSessionUpdates/index.ts
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function content(value) {
+	if (typeof value === "string") return [{
+		type: "text",
+		text: value
+	}];
+	if (!Array.isArray(value)) return [];
+	const blocks = [];
+	for (const part of value) {
+		const item = record(part);
+		if (item?.type === "text" && typeof item.text === "string") blocks.push({
+			type: "text",
+			text: item.text
+		});
+		if (item?.type === "image" && typeof item.data === "string" && typeof item.mimeType === "string") blocks.push({
+			type: "image",
+			data: item.data,
+			mimeType: item.mimeType
+		});
+	}
+	return blocks;
+}
+function progressUpdates(progress) {
+	const item = progress.item;
+	if (item.role === "user") return [{
+		sessionUpdate: "user_message",
+		messageId: item.id,
+		content: item.content
+	}];
+	if (item.role === "tool") return [{
+		sessionUpdate: "tool_call_update",
+		toolCallId: item.toolCallId,
+		title: item.toolName,
+		kind: "other",
+		status: item.status === "running" ? "in_progress" : item.status === "error" ? "failed" : "completed",
+		rawInput: item.input,
+		...progress.type === "item_finished" ? { content: item.content.map((block) => ({
+			type: "content",
+			content: block
+		})) } : {}
+	}];
+	const updates = [];
+	const messageContent = item.content.filter((part) => part.type === "text");
+	if (messageContent.length > 0) updates.push({
+		sessionUpdate: "agent_message",
+		messageId: item.id,
+		content: messageContent
+	});
+	const thoughtContent = item.content.flatMap((part) => part.type === "thinking" && !part.redacted ? [{
+		type: "text",
+		text: part.thinking
+	}] : []);
+	if (thoughtContent.length > 0) updates.push({
+		sessionUpdate: "agent_thought",
+		messageId: `${item.id}:thought`,
+		content: thoughtContent
+	});
+	for (const part of item.content) {
+		if (part.type !== "toolCall") continue;
+		updates.push({
+			sessionUpdate: "tool_call_update",
+			toolCallId: part.toolCallId,
+			title: part.toolName,
+			kind: "other",
+			status: "pending",
+			rawInput: part.input
+		});
+	}
+	return updates;
+}
+/** Projects the Pi frame stream into the ACP v2 session/update vocabulary. */
+function createAcpSessionUpdateProjection() {
+	const seenUserMessages = /* @__PURE__ */ new Set();
+	let lastStopReason = "end_turn";
+	return { apply(frame, reduction) {
+		const updates = [];
+		if (frame.type === "message_start" || frame.type === "message_end" || frame.type === "entry_appended") {
+			const entry = record(frame.entry);
+			const message = record(frame.type === "entry_appended" ? entry?.message : frame.message);
+			if (message?.role === "user") {
+				const blocks = content(message.content);
+				const id = typeof message.timestamp === "number" ? `user-${message.timestamp}` : typeof entry?.id === "string" ? entry.id : void 0;
+				if (id !== void 0 && blocks.length > 0 && !seenUserMessages.has(id)) {
+					seenUserMessages.add(id);
+					updates.push({
+						sessionUpdate: "user_message",
+						messageId: id,
+						content: blocks
+					});
+				}
+			}
+		}
+		if (reduction.progress) {
+			updates.push(...progressUpdates(reduction.progress));
+			if (reduction.progress.type === "item_finished" && reduction.progress.item.role === "assistant") {
+				const reason = reduction.progress.item.stopReason;
+				lastStopReason = reason === "aborted" ? "cancelled" : reason === "length" ? "max_tokens" : "end_turn";
+			}
+		}
+		if (frame.type === "agent_start") updates.push({
+			sessionUpdate: "state_update",
+			state: "running"
+		});
+		if (frame.type === "extension_ui_request") updates.push({
+			sessionUpdate: "state_update",
+			state: "requires_action"
+		});
+		if (frame.type === "extension_ui_answered") updates.push({
+			sessionUpdate: "state_update",
+			state: "running"
+		});
+		if (frame.type === "agent_settled") {
+			updates.push({
+				sessionUpdate: "state_update",
+				state: "idle",
+				stopReason: lastStopReason
+			});
+			lastStopReason = "end_turn";
+		}
+		return updates;
+	} };
+}
+//#endregion
+export { createAcpSessionUpdateProjection };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/acpSessionUpdates/index.ts"],"sourcesContent":["import type {\n  DoomContentBlock,\n  DoomSessionStopReason,\n  DoomSessionUpdate,\n  TranscriptProgress,\n} from '../../exports/sessionProtocol';\nimport type { SessionFrame } from '../../types/server/session';\nimport type { TranscriptReduction } from '../rpcTranscript';\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction content(value: unknown): DoomContentBlock[] {\n  if (typeof value === 'string') return [{ type: 'text', text: value }];\n  if (!Array.isArray(value)) return [];\n  const blocks: DoomContentBlock[] = [];\n  for (const part of value) {\n    const item = record(part);\n    if (item?.type === 'text' && typeof item.text === 'string') blocks.push({ type: 'text', text: item.text });\n    if (item?.type === 'image' && typeof item.data === 'string' && typeof item.mimeType === 'string')\n      blocks.push({ type: 'image', data: item.data, mimeType: item.mimeType });\n  }\n  return blocks;\n}\n\nfunction progressUpdates(progress: TranscriptProgress): DoomSessionUpdate[] {\n  const item = progress.item;\n  if (item.role === 'user') return [{ sessionUpdate: 'user_message', messageId: item.id, content: item.content }];\n  if (item.role === 'tool') {\n    return [\n      {\n        sessionUpdate: 'tool_call_update',\n        toolCallId: item.toolCallId,\n        title: item.toolName,\n        kind: 'other',\n        status: item.status === 'running' ? 'in_progress' : item.status === 'error' ? 'failed' : 'completed',\n        rawInput: item.input,\n        ...(progress.type === 'item_finished'\n          ? { content: item.content.map((block) => ({ type: 'content' as const, content: block })) }\n          : {}),\n      },\n    ];\n  }\n  const updates: DoomSessionUpdate[] = [];\n  const messageContent = item.content.filter((part) => part.type === 'text');\n  if (messageContent.length > 0)\n    updates.push({ sessionUpdate: 'agent_message', messageId: item.id, content: messageContent });\n  const thoughtContent = item.content.flatMap((part) =>\n    part.type === 'thinking' && !part.redacted ? [{ type: 'text' as const, text: part.thinking }] : [],\n  );\n  if (thoughtContent.length > 0)\n    updates.push({ sessionUpdate: 'agent_thought', messageId: `${item.id}:thought`, content: thoughtContent });\n  for (const part of item.content) {\n    if (part.type !== 'toolCall') continue;\n    updates.push({\n      sessionUpdate: 'tool_call_update',\n      toolCallId: part.toolCallId,\n      title: part.toolName,\n      kind: 'other',\n      status: 'pending',\n      rawInput: part.input,\n    });\n  }\n  return updates;\n}\n\n/** Projects the Pi frame stream into the ACP v2 session/update vocabulary. */\nexport function createAcpSessionUpdateProjection(): {\n  apply(frame: SessionFrame, reduction: TranscriptReduction): DoomSessionUpdate[];\n} {\n  const seenUserMessages = new Set<string>();\n  let lastStopReason: DoomSessionStopReason = 'end_turn';\n  return {\n    apply(frame, reduction) {\n      const updates: DoomSessionUpdate[] = [];\n      if (frame.type === 'message_start' || frame.type === 'message_end' || frame.type === 'entry_appended') {\n        const entry = record(frame.entry);\n        const message = record(frame.type === 'entry_appended' ? entry?.message : frame.message);\n        if (message?.role === 'user') {\n          const blocks = content(message.content);\n          const id =\n            typeof message.timestamp === 'number'\n              ? `user-${message.timestamp}`\n              : typeof entry?.id === 'string'\n                ? entry.id\n                : undefined;\n          if (id !== undefined && blocks.length > 0 && !seenUserMessages.has(id)) {\n            seenUserMessages.add(id);\n            updates.push({ sessionUpdate: 'user_message', messageId: id, content: blocks });\n          }\n        }\n      }\n      if (reduction.progress) {\n        updates.push(...progressUpdates(reduction.progress));\n        if (reduction.progress.type === 'item_finished' && reduction.progress.item.role === 'assistant') {\n          const reason = reduction.progress.item.stopReason;\n          lastStopReason = reason === 'aborted' ? 'cancelled' : reason === 'length' ? 'max_tokens' : 'end_turn';\n        }\n      }\n      if (frame.type === 'agent_start') updates.push({ sessionUpdate: 'state_update', state: 'running' });\n      if (frame.type === 'extension_ui_request')\n        updates.push({ sessionUpdate: 'state_update', state: 'requires_action' });\n      if (frame.type === 'extension_ui_answered') updates.push({ sessionUpdate: 'state_update', state: 'running' });\n      if (frame.type === 'agent_settled') {\n        updates.push({ sessionUpdate: 'state_update', state: 'idle', stopReason: lastStopReason });\n        lastStopReason = 'end_turn';\n      }\n      return updates;\n    },\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,60 @@
+const require_index = require("../packageApiHarness/index.cjs");
+//#region src/services/apiSurfaceAssert/index.ts
+function sorted(values) {
+	return [...new Set(values)].sort();
+}
+/** A path under the same mount that no contract declares, used to calibrate. */
+const CONTROL_PATH = "/__doom_surface_control__";
+/**
+* Whether a response is the framework's own miss rather than a handler's answer.
+*
+* Status alone cannot tell them apart: a route that refuses an unknown record
+* answers 404 legitimately, and reading that as "not mounted" would fail every
+* honest API. So the same request is sent to a path nothing declares, and the
+* two are compared. A declared route answering exactly what an undeclared one
+* answers is not being served.
+*
+* A catch-all route would match the control too and read as unrouted. No
+* package has one; if one appears it should probe an explicit path instead.
+*/
+async function isUnrouted(mounted, response, init) {
+	if (response.status !== 404 && response.status !== 405) return false;
+	const control = await mounted.fetch(`${mounted.mountPath}${CONTROL_PATH}`, init);
+	if (control.status !== response.status) return false;
+	return await control.text() === await response.text();
+}
+/** Throws with the disagreement spelled out, or returns having found none. */
+async function assertContractSurface(options) {
+	const routes = options.contract.http.filter((route) => route.scope === options.scope && route.basePath !== void 0);
+	const declared = sorted(routes.map((route) => route.basePath));
+	const registered = sorted(options.apis.map((api) => api.basePath));
+	const missing = declared.filter((basePath) => !registered.includes(basePath));
+	if (missing.length > 0) throw new Error(`The contract declares ${missing.join(", ")} at ${options.scope} scope, but nothing is mounted there. Mounted: ${registered.join(", ") || "(nothing)"}.`);
+	const undeclared = registered.filter((basePath) => !declared.includes(basePath));
+	if (undeclared.length > 0) throw new Error(`${undeclared.join(", ")} is mounted at ${options.scope} scope but the contract never declares it there.`);
+	for (const api of options.apis) {
+		const mounted = require_index.mountPackageApi(api, {
+			...options.mount,
+			scope: options.scope
+		});
+		try {
+			for (const route of routes.filter((entry) => entry.basePath === api.basePath)) {
+				const probe = options.probe?.[route.id];
+				const path = probe?.path ?? route.path;
+				const init = {
+					method: route.method,
+					...probe
+				};
+				const response = await mounted.fetch(`${mounted.mountPath}${path === "/" ? "" : path}`, init);
+				if (!await isUnrouted(mounted, response, init)) continue;
+				throw new Error(`${route.method} ${mounted.mountPath}${path} is declared as '${route.id}' but answered ${response.status} exactly as an unrouted path does, so no handler serves it.`);
+			}
+		} finally {
+			mounted.close();
+		}
+	}
+}
+//#endregion
+exports.assertContractSurface = assertContractSurface;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["mountPackageApi"],"sources":["../../../../src/services/apiSurfaceAssert/index.ts"],"sourcesContent":["/**\n * Checks that what a package declares is what it actually serves.\n *\n * Nothing else in the toolchain does. `parseApiContract` checks a contract's\n * shape, its id uniqueness and that it is JSON, and stops there; no step\n * compares it to a mounted route or to a registration. That gap is not\n * theoretical. One package shipped a valid four-route contract, a well-tested\n * Hono app and a full unit suite for an API that was never mounted at all, and\n * the only test touching the mount asserted the emptiness rather than noticing\n * it.\n *\n * Two questions, both about liveness rather than semantics: are the base paths\n * this scope registers the same set it declares, and does every declared route\n * reach a handler. A route answering 500 passes; a route answering 404 or 405\n * does not exist.\n */\n\nimport type { DoomApiContract } from '../../schemas/apiContracts';\nimport type { DoomApi, DoomApiScope } from '../../schemas/packageApi';\nimport { mountPackageApi, type MountPackageApiOptions } from '../packageApiHarness';\n\nexport interface ApiSurfaceOptions {\n  readonly contract: DoomApiContract;\n  /** The scope being checked; only its declarations and registrations are compared. */\n  readonly scope: DoomApiScope;\n  /** What the generated facet registered at this scope, in registration order. */\n  readonly apis: readonly DoomApi[];\n  /** Passed through to the harness, so a session API gets its id and working directory. */\n  readonly mount?: Omit<MountPackageApiOptions, 'scope'>;\n  /**\n   * Extra request detail for a route a bare request cannot reach, keyed by\n   * contract id, most often a path parameter to substitute.\n   */\n  readonly probe?: Readonly<Record<string, RequestInit & { readonly path?: string }>>;\n}\n\nfunction sorted(values: Iterable<string>): string[] {\n  return [...new Set(values)].sort();\n}\n\n/** A path under the same mount that no contract declares, used to calibrate. */\nconst CONTROL_PATH = '/__doom_surface_control__';\n\n/**\n * Whether a response is the framework's own miss rather than a handler's answer.\n *\n * Status alone cannot tell them apart: a route that refuses an unknown record\n * answers 404 legitimately, and reading that as \"not mounted\" would fail every\n * honest API. So the same request is sent to a path nothing declares, and the\n * two are compared. A declared route answering exactly what an undeclared one\n * answers is not being served.\n *\n * A catch-all route would match the control too and read as unrouted. No\n * package has one; if one appears it should probe an explicit path instead.\n */\nasync function isUnrouted(\n  mounted: { readonly mountPath: string; fetch(path: string, init?: RequestInit): Promise<Response> },\n  response: Response,\n  init: RequestInit,\n): Promise<boolean> {\n  if (response.status !== 404 && response.status !== 405) return false;\n  const control = await mounted.fetch(`${mounted.mountPath}${CONTROL_PATH}`, init);\n  if (control.status !== response.status) return false;\n  return (await control.text()) === (await response.text());\n}\n\n/** Throws with the disagreement spelled out, or returns having found none. */\nexport async function assertContractSurface(options: ApiSurfaceOptions): Promise<void> {\n  const routes = options.contract.http.filter((route) => route.scope === options.scope && route.basePath !== undefined);\n  const declared = sorted(routes.map((route) => route.basePath as string));\n  const registered = sorted(options.apis.map((api) => api.basePath));\n\n  const missing = declared.filter((basePath) => !registered.includes(basePath));\n  if (missing.length > 0) {\n    throw new Error(\n      `The contract declares ${missing.join(', ')} at ${options.scope} scope, but nothing is mounted there. ` +\n        `Mounted: ${registered.join(', ') || '(nothing)'}.`,\n    );\n  }\n  const undeclared = registered.filter((basePath) => !declared.includes(basePath));\n  if (undeclared.length > 0) {\n    throw new Error(\n      `${undeclared.join(', ')} is mounted at ${options.scope} scope but the contract never declares it there.`,\n    );\n  }\n\n  for (const api of options.apis) {\n    const mounted = mountPackageApi(api, { ...options.mount, scope: options.scope });\n    try {\n      for (const route of routes.filter((entry) => entry.basePath === api.basePath)) {\n        const probe = options.probe?.[route.id];\n        const path = probe?.path ?? route.path;\n        const init = { method: route.method, ...probe };\n        const response = await mounted.fetch(`${mounted.mountPath}${path === '/' ? '' : path}`, init);\n        if (!(await isUnrouted(mounted, response, init))) continue;\n        throw new Error(\n          `${route.method} ${mounted.mountPath}${path} is declared as '${route.id}' but answered ` +\n            `${response.status} exactly as an unrouted path does, so no handler serves it.`,\n        );\n      }\n    } finally {\n      mounted.close();\n    }\n  }\n}\n"],"mappings":";;AAoCA,SAAS,OAAO,QAAoC;CAClD,OAAO,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK;AACnC;;AAGA,MAAM,eAAe;;;;;;;;;;;;;AAcrB,eAAe,WACb,SACA,UACA,MACkB;CAClB,IAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KAAK,OAAO;CAC/D,MAAM,UAAU,MAAM,QAAQ,MAAM,GAAG,QAAQ,YAAY,gBAAgB,IAAI;CAC/E,IAAI,QAAQ,WAAW,SAAS,QAAQ,OAAO;CAC/C,OAAQ,MAAM,QAAQ,KAAK,MAAQ,MAAM,SAAS,KAAK;AACzD;;AAGA,eAAsB,sBAAsB,SAA2C;CACrF,MAAM,SAAS,QAAQ,SAAS,KAAK,QAAQ,UAAU,MAAM,UAAU,QAAQ,SAAS,MAAM,aAAa,KAAA,CAAS;CACpH,MAAM,WAAW,OAAO,OAAO,KAAK,UAAU,MAAM,QAAkB,CAAC;CACvE,MAAM,aAAa,OAAO,QAAQ,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC;CAEjE,MAAM,UAAU,SAAS,QAAQ,aAAa,CAAC,WAAW,SAAS,QAAQ,CAAC;CAC5E,IAAI,QAAQ,SAAS,GACnB,MAAM,IAAI,MACR,yBAAyB,QAAQ,KAAK,IAAI,EAAE,MAAM,QAAQ,MAAM,iDAClD,WAAW,KAAK,IAAI,KAAK,YAAY,EACrD;CAEF,MAAM,aAAa,WAAW,QAAQ,aAAa,CAAC,SAAS,SAAS,QAAQ,CAAC;CAC/E,IAAI,WAAW,SAAS,GACtB,MAAM,IAAI,MACR,GAAG,WAAW,KAAK,IAAI,EAAE,iBAAiB,QAAQ,MAAM,iDAC1D;CAGF,KAAK,MAAM,OAAO,QAAQ,MAAM;EAC9B,MAAM,UAAUA,cAAAA,gBAAgB,KAAK;GAAE,GAAG,QAAQ;GAAO,OAAO,QAAQ;EAAM,CAAC;EAC/E,IAAI;GACF,KAAK,MAAM,SAAS,OAAO,QAAQ,UAAU,MAAM,aAAa,IAAI,QAAQ,GAAG;IAC7E,MAAM,QAAQ,QAAQ,QAAQ,MAAM;IACpC,MAAM,OAAO,OAAO,QAAQ,MAAM;IAClC,MAAM,OAAO;KAAE,QAAQ,MAAM;KAAQ,GAAG;IAAM;IAC9C,MAAM,WAAW,MAAM,QAAQ,MAAM,GAAG,QAAQ,YAAY,SAAS,MAAM,KAAK,QAAQ,IAAI;IAC5F,IAAI,CAAE,MAAM,WAAW,SAAS,UAAU,IAAI,GAAI;IAClD,MAAM,IAAI,MACR,GAAG,MAAM,OAAO,GAAG,QAAQ,YAAY,KAAK,mBAAmB,MAAM,GAAG,iBACnE,SAAS,OAAO,4DACvB;GACF;EACF,UAAU;GACR,QAAQ,MAAM;EAChB;CACF;AACF"}

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

@@ -0,0 +1,24 @@
+import { DoomApi, DoomApiScope } from "../../schemas/packageApi.mjs";
+import { DoomApiContract } from "../../schemas/apiContracts.mjs";
+import { MountPackageApiOptions } from "../packageApiHarness/index.mjs";
+//#region src/services/apiSurfaceAssert/index.d.ts
+export interface ApiSurfaceOptions {
+  readonly contract: DoomApiContract;
+  /** The scope being checked; only its declarations and registrations are compared. */
+  readonly scope: DoomApiScope;
+  /** What the generated facet registered at this scope, in registration order. */
+  readonly apis: readonly DoomApi[];
+  /** Passed through to the harness, so a session API gets its id and working directory. */
+  readonly mount?: Omit<MountPackageApiOptions, 'scope'>;
+  /**
+   * Extra request detail for a route a bare request cannot reach, keyed by
+   * contract id, most often a path parameter to substitute.
+   */
+  readonly probe?: Readonly<Record<string, RequestInit & {
+    readonly path?: string;
+  }>>;
+}
+/** Throws with the disagreement spelled out, or returns having found none. */
+export declare function assertContractSurface(options: ApiSurfaceOptions): Promise<void>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/apiSurfaceAssert/index.ts"],"mappings":";;;;iBAqBiB;WACN,UAAU;;WAEV,OAAO;;WAEP,eAAe;;WAEf,QAAQ,KAAK;;;;;WAKb,QAAQ,SAAS,eAAe;aAAyB;;;;wBAkC9C,sBAAsB,SAAS,oBAAoB"}

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

@@ -0,0 +1,60 @@
+import { mountPackageApi } from "../packageApiHarness/index.mjs";
+//#region src/services/apiSurfaceAssert/index.ts
+function sorted(values) {
+	return [...new Set(values)].sort();
+}
+/** A path under the same mount that no contract declares, used to calibrate. */
+const CONTROL_PATH = "/__doom_surface_control__";
+/**
+* Whether a response is the framework's own miss rather than a handler's answer.
+*
+* Status alone cannot tell them apart: a route that refuses an unknown record
+* answers 404 legitimately, and reading that as "not mounted" would fail every
+* honest API. So the same request is sent to a path nothing declares, and the
+* two are compared. A declared route answering exactly what an undeclared one
+* answers is not being served.
+*
+* A catch-all route would match the control too and read as unrouted. No
+* package has one; if one appears it should probe an explicit path instead.
+*/
+async function isUnrouted(mounted, response, init) {
+	if (response.status !== 404 && response.status !== 405) return false;
+	const control = await mounted.fetch(`${mounted.mountPath}${CONTROL_PATH}`, init);
+	if (control.status !== response.status) return false;
+	return await control.text() === await response.text();
+}
+/** Throws with the disagreement spelled out, or returns having found none. */
+async function assertContractSurface(options) {
+	const routes = options.contract.http.filter((route) => route.scope === options.scope && route.basePath !== void 0);
+	const declared = sorted(routes.map((route) => route.basePath));
+	const registered = sorted(options.apis.map((api) => api.basePath));
+	const missing = declared.filter((basePath) => !registered.includes(basePath));
+	if (missing.length > 0) throw new Error(`The contract declares ${missing.join(", ")} at ${options.scope} scope, but nothing is mounted there. Mounted: ${registered.join(", ") || "(nothing)"}.`);
+	const undeclared = registered.filter((basePath) => !declared.includes(basePath));
+	if (undeclared.length > 0) throw new Error(`${undeclared.join(", ")} is mounted at ${options.scope} scope but the contract never declares it there.`);
+	for (const api of options.apis) {
+		const mounted = mountPackageApi(api, {
+			...options.mount,
+			scope: options.scope
+		});
+		try {
+			for (const route of routes.filter((entry) => entry.basePath === api.basePath)) {
+				const probe = options.probe?.[route.id];
+				const path = probe?.path ?? route.path;
+				const init = {
+					method: route.method,
+					...probe
+				};
+				const response = await mounted.fetch(`${mounted.mountPath}${path === "/" ? "" : path}`, init);
+				if (!await isUnrouted(mounted, response, init)) continue;
+				throw new Error(`${route.method} ${mounted.mountPath}${path} is declared as '${route.id}' but answered ${response.status} exactly as an unrouted path does, so no handler serves it.`);
+			}
+		} finally {
+			mounted.close();
+		}
+	}
+}
+//#endregion
+export { assertContractSurface };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/apiSurfaceAssert/index.ts"],"sourcesContent":["/**\n * Checks that what a package declares is what it actually serves.\n *\n * Nothing else in the toolchain does. `parseApiContract` checks a contract's\n * shape, its id uniqueness and that it is JSON, and stops there; no step\n * compares it to a mounted route or to a registration. That gap is not\n * theoretical. One package shipped a valid four-route contract, a well-tested\n * Hono app and a full unit suite for an API that was never mounted at all, and\n * the only test touching the mount asserted the emptiness rather than noticing\n * it.\n *\n * Two questions, both about liveness rather than semantics: are the base paths\n * this scope registers the same set it declares, and does every declared route\n * reach a handler. A route answering 500 passes; a route answering 404 or 405\n * does not exist.\n */\n\nimport type { DoomApiContract } from '../../schemas/apiContracts';\nimport type { DoomApi, DoomApiScope } from '../../schemas/packageApi';\nimport { mountPackageApi, type MountPackageApiOptions } from '../packageApiHarness';\n\nexport interface ApiSurfaceOptions {\n  readonly contract: DoomApiContract;\n  /** The scope being checked; only its declarations and registrations are compared. */\n  readonly scope: DoomApiScope;\n  /** What the generated facet registered at this scope, in registration order. */\n  readonly apis: readonly DoomApi[];\n  /** Passed through to the harness, so a session API gets its id and working directory. */\n  readonly mount?: Omit<MountPackageApiOptions, 'scope'>;\n  /**\n   * Extra request detail for a route a bare request cannot reach, keyed by\n   * contract id, most often a path parameter to substitute.\n   */\n  readonly probe?: Readonly<Record<string, RequestInit & { readonly path?: string }>>;\n}\n\nfunction sorted(values: Iterable<string>): string[] {\n  return [...new Set(values)].sort();\n}\n\n/** A path under the same mount that no contract declares, used to calibrate. */\nconst CONTROL_PATH = '/__doom_surface_control__';\n\n/**\n * Whether a response is the framework's own miss rather than a handler's answer.\n *\n * Status alone cannot tell them apart: a route that refuses an unknown record\n * answers 404 legitimately, and reading that as \"not mounted\" would fail every\n * honest API. So the same request is sent to a path nothing declares, and the\n * two are compared. A declared route answering exactly what an undeclared one\n * answers is not being served.\n *\n * A catch-all route would match the control too and read as unrouted. No\n * package has one; if one appears it should probe an explicit path instead.\n */\nasync function isUnrouted(\n  mounted: { readonly mountPath: string; fetch(path: string, init?: RequestInit): Promise<Response> },\n  response: Response,\n  init: RequestInit,\n): Promise<boolean> {\n  if (response.status !== 404 && response.status !== 405) return false;\n  const control = await mounted.fetch(`${mounted.mountPath}${CONTROL_PATH}`, init);\n  if (control.status !== response.status) return false;\n  return (await control.text()) === (await response.text());\n}\n\n/** Throws with the disagreement spelled out, or returns having found none. */\nexport async function assertContractSurface(options: ApiSurfaceOptions): Promise<void> {\n  const routes = options.contract.http.filter((route) => route.scope === options.scope && route.basePath !== undefined);\n  const declared = sorted(routes.map((route) => route.basePath as string));\n  const registered = sorted(options.apis.map((api) => api.basePath));\n\n  const missing = declared.filter((basePath) => !registered.includes(basePath));\n  if (missing.length > 0) {\n    throw new Error(\n      `The contract declares ${missing.join(', ')} at ${options.scope} scope, but nothing is mounted there. ` +\n        `Mounted: ${registered.join(', ') || '(nothing)'}.`,\n    );\n  }\n  const undeclared = registered.filter((basePath) => !declared.includes(basePath));\n  if (undeclared.length > 0) {\n    throw new Error(\n      `${undeclared.join(', ')} is mounted at ${options.scope} scope but the contract never declares it there.`,\n    );\n  }\n\n  for (const api of options.apis) {\n    const mounted = mountPackageApi(api, { ...options.mount, scope: options.scope });\n    try {\n      for (const route of routes.filter((entry) => entry.basePath === api.basePath)) {\n        const probe = options.probe?.[route.id];\n        const path = probe?.path ?? route.path;\n        const init = { method: route.method, ...probe };\n        const response = await mounted.fetch(`${mounted.mountPath}${path === '/' ? '' : path}`, init);\n        if (!(await isUnrouted(mounted, response, init))) continue;\n        throw new Error(\n          `${route.method} ${mounted.mountPath}${path} is declared as '${route.id}' but answered ` +\n            `${response.status} exactly as an unrouted path does, so no handler serves it.`,\n        );\n      }\n    } finally {\n      mounted.close();\n    }\n  }\n}\n"],"mappings":";;AAoCA,SAAS,OAAO,QAAoC;CAClD,OAAO,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK;AACnC;;AAGA,MAAM,eAAe;;;;;;;;;;;;;AAcrB,eAAe,WACb,SACA,UACA,MACkB;CAClB,IAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KAAK,OAAO;CAC/D,MAAM,UAAU,MAAM,QAAQ,MAAM,GAAG,QAAQ,YAAY,gBAAgB,IAAI;CAC/E,IAAI,QAAQ,WAAW,SAAS,QAAQ,OAAO;CAC/C,OAAQ,MAAM,QAAQ,KAAK,MAAQ,MAAM,SAAS,KAAK;AACzD;;AAGA,eAAsB,sBAAsB,SAA2C;CACrF,MAAM,SAAS,QAAQ,SAAS,KAAK,QAAQ,UAAU,MAAM,UAAU,QAAQ,SAAS,MAAM,aAAa,KAAA,CAAS;CACpH,MAAM,WAAW,OAAO,OAAO,KAAK,UAAU,MAAM,QAAkB,CAAC;CACvE,MAAM,aAAa,OAAO,QAAQ,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC;CAEjE,MAAM,UAAU,SAAS,QAAQ,aAAa,CAAC,WAAW,SAAS,QAAQ,CAAC;CAC5E,IAAI,QAAQ,SAAS,GACnB,MAAM,IAAI,MACR,yBAAyB,QAAQ,KAAK,IAAI,EAAE,MAAM,QAAQ,MAAM,iDAClD,WAAW,KAAK,IAAI,KAAK,YAAY,EACrD;CAEF,MAAM,aAAa,WAAW,QAAQ,aAAa,CAAC,SAAS,SAAS,QAAQ,CAAC;CAC/E,IAAI,WAAW,SAAS,GACtB,MAAM,IAAI,MACR,GAAG,WAAW,KAAK,IAAI,EAAE,iBAAiB,QAAQ,MAAM,iDAC1D;CAGF,KAAK,MAAM,OAAO,QAAQ,MAAM;EAC9B,MAAM,UAAU,gBAAgB,KAAK;GAAE,GAAG,QAAQ;GAAO,OAAO,QAAQ;EAAM,CAAC;EAC/E,IAAI;GACF,KAAK,MAAM,SAAS,OAAO,QAAQ,UAAU,MAAM,aAAa,IAAI,QAAQ,GAAG;IAC7E,MAAM,QAAQ,QAAQ,QAAQ,MAAM;IACpC,MAAM,OAAO,OAAO,QAAQ,MAAM;IAClC,MAAM,OAAO;KAAE,QAAQ,MAAM;KAAQ,GAAG;IAAM;IAC9C,MAAM,WAAW,MAAM,QAAQ,MAAM,GAAG,QAAQ,YAAY,SAAS,MAAM,KAAK,QAAQ,IAAI;IAC5F,IAAI,CAAE,MAAM,WAAW,SAAS,UAAU,IAAI,GAAI;IAClD,MAAM,IAAI,MACR,GAAG,MAAM,OAAO,GAAG,QAAQ,YAAY,KAAK,mBAAmB,MAAM,GAAG,iBACnE,SAAS,OAAO,4DACvB;GACF;EACF,UAAU;GACR,QAAQ,MAAM;EAChB;CACF;AACF"}

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

@@ -0,0 +1,88 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _agimon_ai_doompi_web_security_node = require("@agimon-ai/doompi-web-security/node");
+//#region src/services/bundlePublication/index.ts
+/**
+* Signs synchronized plugin generations without replacing the stable shell publication.
+*
+* Publications are retained by the exact identity and revision advertised to pages, so
+* a concurrent sync cannot pair an old manifest with bytes from a new generation.
+*/
+function createPluginBundlePublication(stateDir, onNotice = () => {}) {
+	let signer;
+	try {
+		signer = (0, _agimon_ai_doompi_web_security_node.createBundleSigner)(stateDir, onNotice);
+	} catch (error) {
+		onNotice(`plugin compositions could not be signed: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	const byComposition = /* @__PURE__ */ new Map();
+	const byRoute = /* @__PURE__ */ new Map();
+	const publicationRoot = signer === void 0 ? void 0 : node_fs.default.mkdtempSync(node_path.default.join(stateDir, "plugin-publications-"));
+	let closed = false;
+	const routeKey = (compositionId, revision) => `${compositionId}:${String(revision)}`;
+	const publish = (compositionId, assetsDir) => {
+		if (closed) return void 0;
+		const existing = byComposition.get(compositionId);
+		if (existing !== void 0) return existing;
+		if (signer === void 0 || publicationRoot === void 0) return void 0;
+		const stagingRoot = node_fs.default.mkdtempSync(node_path.default.join(publicationRoot, ".staging-"));
+		const snapshot = node_path.default.join(stagingRoot, "assets");
+		try {
+			node_fs.default.cpSync(assetsDir, snapshot, { recursive: true });
+			const signed = signer.sign(snapshot);
+			if (signed === void 0) {
+				onNotice(`plugin composition '${compositionId}' is empty and cannot be published`);
+				return;
+			}
+			const retainedDirectory = node_path.default.join(publicationRoot, `${compositionId}-${String(signed.manifest.revision)}`);
+			node_fs.default.renameSync(snapshot, retainedDirectory);
+			const published = {
+				signed,
+				assetsDir: retainedDirectory
+			};
+			byComposition.set(compositionId, published);
+			byRoute.set(routeKey(compositionId, signed.manifest.revision), published);
+			return published;
+		} catch (error) {
+			onNotice(`plugin composition '${compositionId}' could not be signed: ${error instanceof Error ? error.message : String(error)}`);
+			return;
+		} finally {
+			node_fs.default.rmSync(stagingRoot, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+	return {
+		publish,
+		release(compositionId) {
+			const bundle = byComposition.get(compositionId);
+			if (!bundle) return;
+			byComposition.delete(compositionId);
+			byRoute.delete(routeKey(compositionId, bundle.signed.manifest.revision));
+			node_fs.default.rmSync(bundle.assetsDir, {
+				recursive: true,
+				force: true
+			});
+		},
+		get: (compositionId, revision) => byRoute.get(routeKey(compositionId, revision)),
+		publicKey: () => signer?.publicKey(),
+		close: () => {
+			if (closed) return;
+			closed = true;
+			byComposition.clear();
+			byRoute.clear();
+			if (publicationRoot !== void 0) node_fs.default.rmSync(publicationRoot, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+}
+//#endregion
+exports.createPluginBundlePublication = createPluginBundlePublication;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createBundleSigner","fs","path"],"sources":["../../../../src/services/bundlePublication/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { SignedBundleManifest } from '@agimon-ai/doompi-web-security';\nimport { createBundleSigner, type BundleSigner } from '@agimon-ai/doompi-web-security/node';\n\nexport interface PublishedBundle {\n  signed: SignedBundleManifest;\n  assetsDir: string;\n}\n\nexport interface PluginBundlePublication {\n  publish(compositionId: string, assetsDir: string): PublishedBundle | undefined;\n  get(compositionId: string, revision: number): PublishedBundle | undefined;\n  publicKey(): string | undefined;\n  release(compositionId: string): void;\n  close(): void;\n}\n\n/**\n * Signs synchronized plugin generations without replacing the stable shell publication.\n *\n * Publications are retained by the exact identity and revision advertised to pages, so\n * a concurrent sync cannot pair an old manifest with bytes from a new generation.\n */\nexport function createPluginBundlePublication(\n  stateDir: string,\n  onNotice: (message: string) => void = () => {},\n): PluginBundlePublication {\n  let signer: BundleSigner | undefined;\n  try {\n    signer = createBundleSigner(stateDir, onNotice);\n  } catch (error) {\n    onNotice(`plugin compositions could not be signed: ${error instanceof Error ? error.message : String(error)}`);\n  }\n  const byComposition = new Map<string, PublishedBundle>();\n  const byRoute = new Map<string, PublishedBundle>();\n  const publicationRoot =\n    signer === undefined ? undefined : fs.mkdtempSync(path.join(stateDir, 'plugin-publications-'));\n  let closed = false;\n  const routeKey = (compositionId: string, revision: number): string => `${compositionId}:${String(revision)}`;\n  const publish = (compositionId: string, assetsDir: string): PublishedBundle | undefined => {\n    if (closed) return undefined;\n    const existing = byComposition.get(compositionId);\n    if (existing !== undefined) return existing;\n    if (signer === undefined || publicationRoot === undefined) return undefined;\n    const stagingRoot = fs.mkdtempSync(path.join(publicationRoot, '.staging-'));\n    const snapshot = path.join(stagingRoot, 'assets');\n    try {\n      fs.cpSync(assetsDir, snapshot, { recursive: true });\n      const signed = signer.sign(snapshot);\n      if (signed === undefined) {\n        onNotice(`plugin composition '${compositionId}' is empty and cannot be published`);\n        return undefined;\n      }\n      const retainedDirectory = path.join(publicationRoot, `${compositionId}-${String(signed.manifest.revision)}`);\n      fs.renameSync(snapshot, retainedDirectory);\n      const published = { signed, assetsDir: retainedDirectory };\n      byComposition.set(compositionId, published);\n      byRoute.set(routeKey(compositionId, signed.manifest.revision), published);\n      return published;\n    } catch (error) {\n      onNotice(\n        `plugin composition '${compositionId}' could not be signed: ${error instanceof Error ? error.message : String(error)}`,\n      );\n      return undefined;\n    } finally {\n      fs.rmSync(stagingRoot, { recursive: true, force: true });\n    }\n  };\n\n  return {\n    publish,\n    release(compositionId) {\n      const bundle = byComposition.get(compositionId);\n      if (!bundle) return;\n      byComposition.delete(compositionId);\n      byRoute.delete(routeKey(compositionId, bundle.signed.manifest.revision));\n      fs.rmSync(bundle.assetsDir, { recursive: true, force: true });\n    },\n    get: (compositionId, revision) => byRoute.get(routeKey(compositionId, revision)),\n    publicKey: () => signer?.publicKey(),\n    close: () => {\n      if (closed) return;\n      closed = true;\n      byComposition.clear();\n      byRoute.clear();\n      if (publicationRoot !== undefined) fs.rmSync(publicationRoot, { recursive: true, force: true });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAyBA,SAAgB,8BACd,UACA,iBAA4C,CAAC,GACpB;CACzB,IAAI;CACJ,IAAI;EACF,UAAA,GAASA,oCAAAA,mBAAAA,CAAmB,UAAU,QAAQ;CAChD,SAAS,OAAO;EACd,SAAS,4CAA4C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;CAC/G;CACA,MAAM,gCAAgB,IAAI,IAA6B;CACvD,MAAM,0BAAU,IAAI,IAA6B;CACjD,MAAM,kBACJ,WAAW,KAAA,IAAY,KAAA,IAAYC,QAAAA,QAAG,YAAYC,UAAAA,QAAK,KAAK,UAAU,sBAAsB,CAAC;CAC/F,IAAI,SAAS;CACb,MAAM,YAAY,eAAuB,aAA6B,GAAG,cAAc,GAAG,OAAO,QAAQ;CACzG,MAAM,WAAW,eAAuB,cAAmD;EACzF,IAAI,QAAQ,OAAO,KAAA;EACnB,MAAM,WAAW,cAAc,IAAI,aAAa;EAChD,IAAI,aAAa,KAAA,GAAW,OAAO;EACnC,IAAI,WAAW,KAAA,KAAa,oBAAoB,KAAA,GAAW,OAAO,KAAA;EAClE,MAAM,cAAcD,QAAAA,QAAG,YAAYC,UAAAA,QAAK,KAAK,iBAAiB,WAAW,CAAC;EAC1E,MAAM,WAAWA,UAAAA,QAAK,KAAK,aAAa,QAAQ;EAChD,IAAI;GACF,QAAA,QAAG,OAAO,WAAW,UAAU,EAAE,WAAW,KAAK,CAAC;GAClD,MAAM,SAAS,OAAO,KAAK,QAAQ;GACnC,IAAI,WAAW,KAAA,GAAW;IACxB,SAAS,uBAAuB,cAAc,mCAAmC;IACjF;GACF;GACA,MAAM,oBAAoBA,UAAAA,QAAK,KAAK,iBAAiB,GAAG,cAAc,GAAG,OAAO,OAAO,SAAS,QAAQ,GAAG;GAC3G,QAAA,QAAG,WAAW,UAAU,iBAAiB;GACzC,MAAM,YAAY;IAAE;IAAQ,WAAW;GAAkB;GACzD,cAAc,IAAI,eAAe,SAAS;GAC1C,QAAQ,IAAI,SAAS,eAAe,OAAO,SAAS,QAAQ,GAAG,SAAS;GACxE,OAAO;EACT,SAAS,OAAO;GACd,SACE,uBAAuB,cAAc,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACrH;GACA;EACF,UAAU;GACR,QAAA,QAAG,OAAO,aAAa;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;EACzD;CACF;CAEA,OAAO;EACL;EACA,QAAQ,eAAe;GACrB,MAAM,SAAS,cAAc,IAAI,aAAa;GAC9C,IAAI,CAAC,QAAQ;GACb,cAAc,OAAO,aAAa;GAClC,QAAQ,OAAO,SAAS,eAAe,OAAO,OAAO,SAAS,QAAQ,CAAC;GACvE,QAAA,QAAG,OAAO,OAAO,WAAW;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;EAC9D;EACA,MAAM,eAAe,aAAa,QAAQ,IAAI,SAAS,eAAe,QAAQ,CAAC;EAC/E,iBAAiB,QAAQ,UAAU;EACnC,aAAa;GACX,IAAI,QAAQ;GACZ,SAAS;GACT,cAAc,MAAM;GACpB,QAAQ,MAAM;GACd,IAAI,oBAAoB,KAAA,GAAW,QAAA,QAAG,OAAO,iBAAiB;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;EAChG;CACF;AACF"}