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

package/dist/runtimeCordisHost.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeCordisHost.cjs","names":["Context","DOOM_TOOL_OVERRIDES_SERVICE","createDoomToolOverridesService","DOOM_CONTEXT_CONTRIBUTIONS_SERVICE","createDoomContextContributionsService","DOOM_TOOL_SURFACE_SERVICE","createDoomToolSurface"],"sources":["../src/pi/cordisHost.ts"],"sourcesContent":["import { Context, type Fiber } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext, SessionStartEvent } from '@earendil-works/pi-coding-agent';\n\nimport { DOOM_CONTEXT_CONTRIBUTIONS_SERVICE } from '../schemas/contextContributions';\nimport { DOOM_TOOL_OVERRIDES_SERVICE } from '../schemas/toolOverrides';\nimport { DOOM_TOOL_SURFACE_SERVICE } from '../schemas/toolSurface';\nimport { createDoomContextContributionsService } from '../services/contextContributions';\nimport { createDoomToolOverridesService } from '../services/toolOverrides';\nimport { createDoomToolSurface } from '../services/toolSurface';\n\nexport const DOOM_CORDIS_HOST_ABI_VERSION = 1 as const;\nexport const DOOM_CORDIS_HOST_QUERY_CHANNEL = 'doom:cordis:host:v1:query';\nexport const DOOM_CORDIS_RUNTIME_SERVICE = 'doom/runtime';\nexport const DOOM_CORDIS_SESSION_SERVICE = 'doom/session';\nexport const DOOM_CORDIS_SERVER_SERVICES = 'doom/server-session-services';\n\n/** Read-only access to services already owned by this session's server facets. */\nexport interface DoomCordisServerServices {\n  readonly sessionId: string;\n  get<T>(name: string): T | undefined;\n}\nconst HOST_PROTOCOL = 'doom.cordis.host';\nconst DEFAULT_HOST_SOURCE = '@agimon-ai/doompi/cordis-host';\n\nexport type DoomCordisHostMode = 'composed' | 'standalone';\n\nexport interface DoomCordisRuntimeService {\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly generation: string;\n  readonly mode: DoomCordisHostMode;\n}\n\nexport interface DoomCordisSessionService {\n  readonly sessionId: string;\n  readonly generation: string;\n  readonly reason: SessionStartEvent['reason'];\n  readonly context: ExtensionContext;\n}\n\nexport function requireDoomCordisSession(context: Context): DoomCordisSessionService {\n  const session = context.get(DOOM_CORDIS_SESSION_SERVICE) as DoomCordisSessionService | undefined;\n  if (!session) throw new Error('Doom Cordis session service is unavailable.');\n  return session;\n}\n\nexport interface DoomCordisHostConnection {\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  /** Releases this consumer's lease. It never disposes a composed host. */\n  dispose(): Promise<void>;\n}\n\nexport interface DoomCordisHostController {\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  /** Recursively disposes the session and application plugin tree. */\n  shutdown(): Promise<void>;\n}\n\nexport interface InstallDoomCordisHostOptions {\n  readonly mode: DoomCordisHostMode;\n  readonly source?: string;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/runtime': DoomCordisRuntimeService;\n    'doom/session': DoomCordisSessionService;\n  }\n}\n\ninterface HostQuery {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly kind: 'query';\n  readonly requestId: string;\n  readonly source: string;\n  readonly accept: (response: unknown) => void;\n}\n\ninterface HostResponder {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  readonly ready: Promise<void>;\n  acquire(): DoomCordisHostConnection;\n  shutdown(): Promise<void>;\n}\n\nfunction isRecord(value: unknown): value is Record<PropertyKey, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction asHostQuery(value: unknown): HostQuery | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.protocol !== HOST_PROTOCOL ||\n    value.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION ||\n    value.kind !== 'query' ||\n    typeof value.requestId !== 'string' ||\n    value.requestId.length === 0 ||\n    typeof value.source !== 'string' ||\n    value.source.length === 0 ||\n    typeof value.accept !== 'function'\n  ) {\n    return undefined;\n  }\n  return value as unknown as HostQuery;\n}\n\nfunction asHostResponder(value: unknown): HostResponder {\n  if (!isRecord(value)) throw new Error('The Doom Cordis host returned an invalid discovery response.');\n  if (value.protocol !== HOST_PROTOCOL) {\n    throw new Error('The Doom Cordis host returned an invalid protocol identifier.');\n  }\n  if (value.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION) {\n    throw new Error(\n      `The Doom Cordis host ABI is incompatible: expected ${String(DOOM_CORDIS_HOST_ABI_VERSION)}, received ${String(value.abiVersion)}.`,\n    );\n  }\n  if (typeof value.hostId !== 'string' || value.hostId.length === 0) {\n    throw new Error('The Doom Cordis host returned an invalid host identifier.');\n  }\n  if (!Context.is(value.root)) {\n    throw new Error('The Doom Cordis host returned a value that is not a Cordis Context.');\n  }\n  if (\n    !isRecord(value.runtime) ||\n    value.runtime.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION ||\n    value.runtime.hostId !== value.hostId ||\n    typeof value.acquire !== 'function' ||\n    typeof value.shutdown !== 'function' ||\n    !isRecord(value.ready) ||\n    typeof value.ready.then !== 'function'\n  ) {\n    throw new Error('The Doom Cordis host returned incomplete runtime metadata.');\n  }\n  return value as unknown as HostResponder;\n}\n\nfunction discoverHosts(pi: Pick<ExtensionAPI, 'events'>, source: string): HostResponder[] {\n  const responses: HostResponder[] = [];\n  const request: HostQuery = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    kind: 'query',\n    requestId: `${source}:${crypto.randomUUID()}`,\n    source,\n    accept(response) {\n      responses.push(asHostResponder(response));\n    },\n  };\n  pi.events.emit(DOOM_CORDIS_HOST_QUERY_CHANNEL, request);\n  return responses;\n}\n\nfunction exactlyOneHost(responses: readonly HostResponder[], source: string): HostResponder | undefined {\n  if (responses.length <= 1) return responses[0];\n  const hostIds = responses.map(({ hostId }) => hostId).join(', ');\n  throw new Error(`Multiple Doom Cordis hosts answered ${source}: ${hostIds}.`);\n}\n\nfunction runtimeProvider(ctx: Context, service: DoomCordisRuntimeService): void {\n  ctx.provide(DOOM_CORDIS_RUNTIME_SERVICE, service);\n  ctx.provide(DOOM_TOOL_OVERRIDES_SERVICE, createDoomToolOverridesService(service.generation));\n}\n\nfunction sessionProvider(ctx: Context, service: DoomCordisSessionService, pi: ExtensionAPI): void {\n  ctx.provide(DOOM_CORDIS_SESSION_SERVICE, service);\n  ctx.provide(DOOM_CONTEXT_CONTRIBUTIONS_SERVICE, createDoomContextContributionsService(service.generation));\n  ctx.provide(\n    DOOM_TOOL_SURFACE_SERVICE,\n    createDoomToolSurface({\n      generation: service.generation,\n      allTools: () => pi.getAllTools().map((tool) => tool.name),\n      activeTools: () => pi.getActiveTools(),\n      setActiveTools: (names) => pi.setActiveTools(names),\n    }),\n  );\n}\n\n/**\n * Installs the sole Cordis application root for one Pi extension runner.\n *\n * The versioned EventBus query is intentional: Pi may hand independently\n * loaded factories different ExtensionAPI wrapper objects, while their event\n * buses still address the same runner.\n */\nexport async function installDoomCordisHost(\n  pi: ExtensionAPI,\n  options: InstallDoomCordisHostOptions,\n): Promise<DoomCordisHostController> {\n  const source = options.source ?? DEFAULT_HOST_SOURCE;\n  const existing = exactlyOneHost(discoverHosts(pi, source), source);\n  if (existing) throw new Error(`A Doom Cordis host is already installed: ${existing.hostId}.`);\n\n  // This is the one intentional Context constructor for DoomPi extension code.\n  const root = new Context();\n  const runtime: DoomCordisRuntimeService = Object.freeze({\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    hostId: `doom-cordis:${crypto.randomUUID()}`,\n    generation: `doom-runtime:${crypto.randomUUID()}`,\n    mode: options.mode,\n  });\n  const runtimeFiber = root.plugin(runtimeProvider, runtime);\n  const ready = runtimeFiber.await().then(() => undefined);\n  let sessionFiber: Fiber | undefined;\n  let sessionGeneration = 0;\n  let sessionQueue = Promise.resolve();\n  let leaseCount = 0;\n  let shutdownPromise: Promise<void> | undefined;\n  let responder: HostResponder;\n  let disposeQuerySubscription = (): void => undefined;\n\n  const controller: DoomCordisHostController = {\n    root,\n    runtime,\n    shutdown() {\n      shutdownPromise ??= (async () => {\n        disposeQuerySubscription();\n        await ready.catch(() => undefined);\n        await sessionQueue.catch(() => undefined);\n        await sessionFiber?.dispose();\n        sessionFiber = undefined;\n        await root.fiber.dispose();\n      })();\n      return shutdownPromise;\n    },\n  };\n\n  responder = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    hostId: runtime.hostId,\n    root,\n    runtime,\n    ready,\n    acquire() {\n      if (shutdownPromise) throw new Error(`The Doom Cordis host is shutting down: ${runtime.hostId}.`);\n      leaseCount += 1;\n      let released = false;\n      return {\n        root,\n        runtime,\n        async dispose() {\n          if (released) return;\n          released = true;\n          leaseCount -= 1;\n          if (options.mode === 'standalone' && leaseCount === 0) await controller.shutdown();\n        },\n      };\n    },\n    shutdown: () => controller.shutdown(),\n  };\n  try {\n    disposeQuerySubscription = pi.events.on(DOOM_CORDIS_HOST_QUERY_CHANNEL, (value) => {\n      const query = asHostQuery(value);\n      if (query) query.accept(responder);\n    });\n    pi.on('session_start', (event, context) => {\n      sessionQueue = sessionQueue\n        .catch(() => undefined)\n        .then(async () => {\n          // Pi owns its listener table and can retain this callback across a\n          // replacement. A start delivered after finalization belongs to the\n          // stale graph and must not revive or fail the next one.\n          if (shutdownPromise) return;\n          await sessionFiber?.dispose();\n          sessionGeneration += 1;\n          const service: DoomCordisSessionService = Object.freeze({\n            sessionId: context.sessionManager.getSessionId(),\n            generation: `${runtime.generation}:${String(sessionGeneration)}`,\n            reason: event.reason,\n            context,\n          });\n          sessionFiber = root.plugin((ctx: Context, value: DoomCordisSessionService) => {\n            sessionProvider(ctx, value, pi);\n          }, service);\n          await sessionFiber.await();\n        });\n      return sessionQueue;\n    });\n    if (options.mode === 'standalone') {\n      pi.on('session_shutdown', () => {\n        disposeQuerySubscription();\n      });\n    }\n    await ready;\n  } catch (error) {\n    await controller.shutdown();\n    throw error;\n  }\n  return controller;\n}\n\n/** Resolves the composed host installed by the canonical runtime. */\nexport async function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n): Promise<DoomCordisHostConnection> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  if (!responder)\n    throw new Error('The composed Doom Cordis host is unavailable. Ensure cordisHost is the first extension.');\n  await responder.ready;\n  return responder.acquire();\n}\n\n/** Ends the host discovered on this runner. Repeated finalization is a no-op. */\nexport async function finalizeDoomCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<void> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  await responder?.shutdown();\n}\n"],"mappings":"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"}

package/dist/runtimeCordisHost.d.mts

@@ -0,0 +1,63 @@
+import { Context } from "@deepseek-ai/cordis";
+import { ExtensionAPI, ExtensionContext, SessionStartEvent } from "@earendil-works/pi-coding-agent";
+//#region src/pi/cordisHost.d.ts
+export declare const DOOM_CORDIS_HOST_ABI_VERSION: 1;
+export declare const DOOM_CORDIS_HOST_QUERY_CHANNEL = "doom:cordis:host:v1:query";
+export declare const DOOM_CORDIS_RUNTIME_SERVICE = "doom/runtime";
+export declare const DOOM_CORDIS_SESSION_SERVICE = "doom/session";
+export declare const DOOM_CORDIS_SERVER_SERVICES = "doom/server-session-services";
+/** Read-only access to services already owned by this session's server facets. */
+export interface DoomCordisServerServices {
+  readonly sessionId: string;
+  get<T>(name: string): T | undefined;
+}
+export type DoomCordisHostMode = 'composed' | 'standalone';
+export interface DoomCordisRuntimeService {
+  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;
+  readonly hostId: string;
+  readonly generation: string;
+  readonly mode: DoomCordisHostMode;
+}
+export interface DoomCordisSessionService {
+  readonly sessionId: string;
+  readonly generation: string;
+  readonly reason: SessionStartEvent['reason'];
+  readonly context: ExtensionContext;
+}
+export declare function requireDoomCordisSession(context: Context): DoomCordisSessionService;
+export interface DoomCordisHostConnection {
+  readonly root: Context;
+  readonly runtime: DoomCordisRuntimeService;
+  /** Releases this consumer's lease. It never disposes a composed host. */
+  dispose(): Promise<void>;
+}
+export interface DoomCordisHostController {
+  readonly root: Context;
+  readonly runtime: DoomCordisRuntimeService;
+  /** Recursively disposes the session and application plugin tree. */
+  shutdown(): Promise<void>;
+}
+export interface InstallDoomCordisHostOptions {
+  readonly mode: DoomCordisHostMode;
+  readonly source?: string;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/runtime': DoomCordisRuntimeService;
+    'doom/session': DoomCordisSessionService;
+  }
+}
+/**
+ * Installs the sole Cordis application root for one Pi extension runner.
+ *
+ * The versioned EventBus query is intentional: Pi may hand independently
+ * loaded factories different ExtensionAPI wrapper objects, while their event
+ * buses still address the same runner.
+ */
+export declare function installDoomCordisHost(pi: ExtensionAPI, options: InstallDoomCordisHostOptions): Promise<DoomCordisHostController>;
+/** Resolves the composed host installed by the canonical runtime. */
+export declare function connectDoomCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<DoomCordisHostConnection>;
+/** Ends the host discovered on this runner. Repeated finalization is a no-op. */
+export declare function finalizeDoomCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<void>;
+//#endregion
+//# sourceMappingURL=runtimeCordisHost.d.mts.map

package/dist/runtimeCordisHost.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeCordisHost.d.mts","names":[],"sources":["../src/pi/cordisHost.ts"],"mappings":";;;qBAUa;qBACA;qBACA;qBACA;qBACA;;iBAGI;WACN;EACT,IAAI,GAAG,eAAe;;YAKZ;iBAEK;WACN,mBAAmB;WACnB;WACA;WACA,MAAM;;iBAGA;WACN;WACA;WACA,QAAQ;WACR,SAAS;;wBAGJ,yBAAyB,SAAS,UAAU;iBAM3C;WACN,MAAM;WACN,SAAS;;EAElB,WAAW;;iBAGI;WACN,MAAM;WACN,SAAS;;EAElB,YAAY;;iBAGG;WACN,MAAM;WACN;;;YAIC;IACR,gBAAgB;IAChB,gBAAgB;;;;;;;;;;wBA2HE,sBACpB,IAAI,cACJ,SAAS,+BACR,QAAQ;;wBAyGW,sBACpB,IAAI,KAAK,yBACT,iBACC,QAAQ;;wBASW,uBAAuB,IAAI,KAAK,yBAAyB,iBAAiB"}

package/dist/runtimeCordisHost.mjs

@@ -0,0 +1,184 @@
+import { DOOM_CONTEXT_CONTRIBUTIONS_SERVICE } from "./src/schemas/contextContributions.mjs";
+import { createDoomContextContributionsService } from "./src/services/contextContributions/index.mjs";
+import { DOOM_TOOL_OVERRIDES_SERVICE } from "./src/schemas/toolOverrides.mjs";
+import { DOOM_TOOL_SURFACE_SERVICE } from "./src/schemas/toolSurface.mjs";
+import { createDoomToolOverridesService } from "./src/services/toolOverrides/index.mjs";
+import { createDoomToolSurface } from "./src/services/toolSurface/index.mjs";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/pi/cordisHost.ts
+const DOOM_CORDIS_HOST_ABI_VERSION = 1;
+const DOOM_CORDIS_HOST_QUERY_CHANNEL = "doom:cordis:host:v1:query";
+const DOOM_CORDIS_RUNTIME_SERVICE = "doom/runtime";
+const DOOM_CORDIS_SESSION_SERVICE = "doom/session";
+const DOOM_CORDIS_SERVER_SERVICES = "doom/server-session-services";
+const HOST_PROTOCOL = "doom.cordis.host";
+const DEFAULT_HOST_SOURCE = "@agimon-ai/doompi/cordis-host";
+function requireDoomCordisSession(context) {
+	const session = context.get(DOOM_CORDIS_SESSION_SERVICE);
+	if (!session) throw new Error("Doom Cordis session service is unavailable.");
+	return session;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function asHostQuery(value) {
+	if (!isRecord(value)) return void 0;
+	if (value.protocol !== HOST_PROTOCOL || value.abiVersion !== 1 || value.kind !== "query" || typeof value.requestId !== "string" || value.requestId.length === 0 || typeof value.source !== "string" || value.source.length === 0 || typeof value.accept !== "function") return;
+	return value;
+}
+function asHostResponder(value) {
+	if (!isRecord(value)) throw new Error("The Doom Cordis host returned an invalid discovery response.");
+	if (value.protocol !== HOST_PROTOCOL) throw new Error("The Doom Cordis host returned an invalid protocol identifier.");
+	if (value.abiVersion !== 1) throw new Error(`The Doom Cordis host ABI is incompatible: expected ${String(1)}, received ${String(value.abiVersion)}.`);
+	if (typeof value.hostId !== "string" || value.hostId.length === 0) throw new Error("The Doom Cordis host returned an invalid host identifier.");
+	if (!Context.is(value.root)) throw new Error("The Doom Cordis host returned a value that is not a Cordis Context.");
+	if (!isRecord(value.runtime) || value.runtime.abiVersion !== 1 || value.runtime.hostId !== value.hostId || typeof value.acquire !== "function" || typeof value.shutdown !== "function" || !isRecord(value.ready) || typeof value.ready.then !== "function") throw new Error("The Doom Cordis host returned incomplete runtime metadata.");
+	return value;
+}
+function discoverHosts(pi, source) {
+	const responses = [];
+	const request = {
+		protocol: HOST_PROTOCOL,
+		abiVersion: 1,
+		kind: "query",
+		requestId: `${source}:${crypto.randomUUID()}`,
+		source,
+		accept(response) {
+			responses.push(asHostResponder(response));
+		}
+	};
+	pi.events.emit(DOOM_CORDIS_HOST_QUERY_CHANNEL, request);
+	return responses;
+}
+function exactlyOneHost(responses, source) {
+	if (responses.length <= 1) return responses[0];
+	const hostIds = responses.map(({ hostId }) => hostId).join(", ");
+	throw new Error(`Multiple Doom Cordis hosts answered ${source}: ${hostIds}.`);
+}
+function runtimeProvider(ctx, service) {
+	ctx.provide(DOOM_CORDIS_RUNTIME_SERVICE, service);
+	ctx.provide(DOOM_TOOL_OVERRIDES_SERVICE, createDoomToolOverridesService(service.generation));
+}
+function sessionProvider(ctx, service, pi) {
+	ctx.provide(DOOM_CORDIS_SESSION_SERVICE, service);
+	ctx.provide(DOOM_CONTEXT_CONTRIBUTIONS_SERVICE, createDoomContextContributionsService(service.generation));
+	ctx.provide(DOOM_TOOL_SURFACE_SERVICE, createDoomToolSurface({
+		generation: service.generation,
+		allTools: () => pi.getAllTools().map((tool) => tool.name),
+		activeTools: () => pi.getActiveTools(),
+		setActiveTools: (names) => pi.setActiveTools(names)
+	}));
+}
+/**
+* Installs the sole Cordis application root for one Pi extension runner.
+*
+* The versioned EventBus query is intentional: Pi may hand independently
+* loaded factories different ExtensionAPI wrapper objects, while their event
+* buses still address the same runner.
+*/
+async function installDoomCordisHost(pi, options) {
+	const source = options.source ?? DEFAULT_HOST_SOURCE;
+	const existing = exactlyOneHost(discoverHosts(pi, source), source);
+	if (existing) throw new Error(`A Doom Cordis host is already installed: ${existing.hostId}.`);
+	const root = new Context();
+	const runtime = Object.freeze({
+		abiVersion: 1,
+		hostId: `doom-cordis:${crypto.randomUUID()}`,
+		generation: `doom-runtime:${crypto.randomUUID()}`,
+		mode: options.mode
+	});
+	const ready = root.plugin(runtimeProvider, runtime).await().then(() => void 0);
+	let sessionFiber;
+	let sessionGeneration = 0;
+	let sessionQueue = Promise.resolve();
+	let leaseCount = 0;
+	let shutdownPromise;
+	let responder;
+	let disposeQuerySubscription = () => void 0;
+	const controller = {
+		root,
+		runtime,
+		shutdown() {
+			shutdownPromise ??= (async () => {
+				disposeQuerySubscription();
+				await ready.catch(() => void 0);
+				await sessionQueue.catch(() => void 0);
+				await sessionFiber?.dispose();
+				sessionFiber = void 0;
+				await root.fiber.dispose();
+			})();
+			return shutdownPromise;
+		}
+	};
+	responder = {
+		protocol: HOST_PROTOCOL,
+		abiVersion: 1,
+		hostId: runtime.hostId,
+		root,
+		runtime,
+		ready,
+		acquire() {
+			if (shutdownPromise) throw new Error(`The Doom Cordis host is shutting down: ${runtime.hostId}.`);
+			leaseCount += 1;
+			let released = false;
+			return {
+				root,
+				runtime,
+				async dispose() {
+					if (released) return;
+					released = true;
+					leaseCount -= 1;
+					if (options.mode === "standalone" && leaseCount === 0) await controller.shutdown();
+				}
+			};
+		},
+		shutdown: () => controller.shutdown()
+	};
+	try {
+		disposeQuerySubscription = pi.events.on(DOOM_CORDIS_HOST_QUERY_CHANNEL, (value) => {
+			const query = asHostQuery(value);
+			if (query) query.accept(responder);
+		});
+		pi.on("session_start", (event, context) => {
+			sessionQueue = sessionQueue.catch(() => void 0).then(async () => {
+				if (shutdownPromise) return;
+				await sessionFiber?.dispose();
+				sessionGeneration += 1;
+				const service = Object.freeze({
+					sessionId: context.sessionManager.getSessionId(),
+					generation: `${runtime.generation}:${String(sessionGeneration)}`,
+					reason: event.reason,
+					context
+				});
+				sessionFiber = root.plugin((ctx, value) => {
+					sessionProvider(ctx, value, pi);
+				}, service);
+				await sessionFiber.await();
+			});
+			return sessionQueue;
+		});
+		if (options.mode === "standalone") pi.on("session_shutdown", () => {
+			disposeQuerySubscription();
+		});
+		await ready;
+	} catch (error) {
+		await controller.shutdown();
+		throw error;
+	}
+	return controller;
+}
+/** Resolves the composed host installed by the canonical runtime. */
+async function connectDoomCordisHost(pi, source) {
+	const responder = exactlyOneHost(discoverHosts(pi, source), source);
+	if (!responder) throw new Error("The composed Doom Cordis host is unavailable. Ensure cordisHost is the first extension.");
+	await responder.ready;
+	return responder.acquire();
+}
+/** Ends the host discovered on this runner. Repeated finalization is a no-op. */
+async function finalizeDoomCordisHost(pi, source) {
+	await exactlyOneHost(discoverHosts(pi, source), source)?.shutdown();
+}
+//#endregion
+export { DOOM_CORDIS_HOST_ABI_VERSION, DOOM_CORDIS_HOST_QUERY_CHANNEL, DOOM_CORDIS_RUNTIME_SERVICE, DOOM_CORDIS_SERVER_SERVICES, DOOM_CORDIS_SESSION_SERVICE, connectDoomCordisHost, finalizeDoomCordisHost, installDoomCordisHost, requireDoomCordisSession };
+
+//# sourceMappingURL=runtimeCordisHost.mjs.map

package/dist/runtimeCordisHost.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeCordisHost.mjs","names":[],"sources":["../src/pi/cordisHost.ts"],"sourcesContent":["import { Context, type Fiber } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext, SessionStartEvent } from '@earendil-works/pi-coding-agent';\n\nimport { DOOM_CONTEXT_CONTRIBUTIONS_SERVICE } from '../schemas/contextContributions';\nimport { DOOM_TOOL_OVERRIDES_SERVICE } from '../schemas/toolOverrides';\nimport { DOOM_TOOL_SURFACE_SERVICE } from '../schemas/toolSurface';\nimport { createDoomContextContributionsService } from '../services/contextContributions';\nimport { createDoomToolOverridesService } from '../services/toolOverrides';\nimport { createDoomToolSurface } from '../services/toolSurface';\n\nexport const DOOM_CORDIS_HOST_ABI_VERSION = 1 as const;\nexport const DOOM_CORDIS_HOST_QUERY_CHANNEL = 'doom:cordis:host:v1:query';\nexport const DOOM_CORDIS_RUNTIME_SERVICE = 'doom/runtime';\nexport const DOOM_CORDIS_SESSION_SERVICE = 'doom/session';\nexport const DOOM_CORDIS_SERVER_SERVICES = 'doom/server-session-services';\n\n/** Read-only access to services already owned by this session's server facets. */\nexport interface DoomCordisServerServices {\n  readonly sessionId: string;\n  get<T>(name: string): T | undefined;\n}\nconst HOST_PROTOCOL = 'doom.cordis.host';\nconst DEFAULT_HOST_SOURCE = '@agimon-ai/doompi/cordis-host';\n\nexport type DoomCordisHostMode = 'composed' | 'standalone';\n\nexport interface DoomCordisRuntimeService {\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly generation: string;\n  readonly mode: DoomCordisHostMode;\n}\n\nexport interface DoomCordisSessionService {\n  readonly sessionId: string;\n  readonly generation: string;\n  readonly reason: SessionStartEvent['reason'];\n  readonly context: ExtensionContext;\n}\n\nexport function requireDoomCordisSession(context: Context): DoomCordisSessionService {\n  const session = context.get(DOOM_CORDIS_SESSION_SERVICE) as DoomCordisSessionService | undefined;\n  if (!session) throw new Error('Doom Cordis session service is unavailable.');\n  return session;\n}\n\nexport interface DoomCordisHostConnection {\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  /** Releases this consumer's lease. It never disposes a composed host. */\n  dispose(): Promise<void>;\n}\n\nexport interface DoomCordisHostController {\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  /** Recursively disposes the session and application plugin tree. */\n  shutdown(): Promise<void>;\n}\n\nexport interface InstallDoomCordisHostOptions {\n  readonly mode: DoomCordisHostMode;\n  readonly source?: string;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/runtime': DoomCordisRuntimeService;\n    'doom/session': DoomCordisSessionService;\n  }\n}\n\ninterface HostQuery {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly kind: 'query';\n  readonly requestId: string;\n  readonly source: string;\n  readonly accept: (response: unknown) => void;\n}\n\ninterface HostResponder {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof DOOM_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly root: Context;\n  readonly runtime: DoomCordisRuntimeService;\n  readonly ready: Promise<void>;\n  acquire(): DoomCordisHostConnection;\n  shutdown(): Promise<void>;\n}\n\nfunction isRecord(value: unknown): value is Record<PropertyKey, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction asHostQuery(value: unknown): HostQuery | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.protocol !== HOST_PROTOCOL ||\n    value.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION ||\n    value.kind !== 'query' ||\n    typeof value.requestId !== 'string' ||\n    value.requestId.length === 0 ||\n    typeof value.source !== 'string' ||\n    value.source.length === 0 ||\n    typeof value.accept !== 'function'\n  ) {\n    return undefined;\n  }\n  return value as unknown as HostQuery;\n}\n\nfunction asHostResponder(value: unknown): HostResponder {\n  if (!isRecord(value)) throw new Error('The Doom Cordis host returned an invalid discovery response.');\n  if (value.protocol !== HOST_PROTOCOL) {\n    throw new Error('The Doom Cordis host returned an invalid protocol identifier.');\n  }\n  if (value.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION) {\n    throw new Error(\n      `The Doom Cordis host ABI is incompatible: expected ${String(DOOM_CORDIS_HOST_ABI_VERSION)}, received ${String(value.abiVersion)}.`,\n    );\n  }\n  if (typeof value.hostId !== 'string' || value.hostId.length === 0) {\n    throw new Error('The Doom Cordis host returned an invalid host identifier.');\n  }\n  if (!Context.is(value.root)) {\n    throw new Error('The Doom Cordis host returned a value that is not a Cordis Context.');\n  }\n  if (\n    !isRecord(value.runtime) ||\n    value.runtime.abiVersion !== DOOM_CORDIS_HOST_ABI_VERSION ||\n    value.runtime.hostId !== value.hostId ||\n    typeof value.acquire !== 'function' ||\n    typeof value.shutdown !== 'function' ||\n    !isRecord(value.ready) ||\n    typeof value.ready.then !== 'function'\n  ) {\n    throw new Error('The Doom Cordis host returned incomplete runtime metadata.');\n  }\n  return value as unknown as HostResponder;\n}\n\nfunction discoverHosts(pi: Pick<ExtensionAPI, 'events'>, source: string): HostResponder[] {\n  const responses: HostResponder[] = [];\n  const request: HostQuery = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    kind: 'query',\n    requestId: `${source}:${crypto.randomUUID()}`,\n    source,\n    accept(response) {\n      responses.push(asHostResponder(response));\n    },\n  };\n  pi.events.emit(DOOM_CORDIS_HOST_QUERY_CHANNEL, request);\n  return responses;\n}\n\nfunction exactlyOneHost(responses: readonly HostResponder[], source: string): HostResponder | undefined {\n  if (responses.length <= 1) return responses[0];\n  const hostIds = responses.map(({ hostId }) => hostId).join(', ');\n  throw new Error(`Multiple Doom Cordis hosts answered ${source}: ${hostIds}.`);\n}\n\nfunction runtimeProvider(ctx: Context, service: DoomCordisRuntimeService): void {\n  ctx.provide(DOOM_CORDIS_RUNTIME_SERVICE, service);\n  ctx.provide(DOOM_TOOL_OVERRIDES_SERVICE, createDoomToolOverridesService(service.generation));\n}\n\nfunction sessionProvider(ctx: Context, service: DoomCordisSessionService, pi: ExtensionAPI): void {\n  ctx.provide(DOOM_CORDIS_SESSION_SERVICE, service);\n  ctx.provide(DOOM_CONTEXT_CONTRIBUTIONS_SERVICE, createDoomContextContributionsService(service.generation));\n  ctx.provide(\n    DOOM_TOOL_SURFACE_SERVICE,\n    createDoomToolSurface({\n      generation: service.generation,\n      allTools: () => pi.getAllTools().map((tool) => tool.name),\n      activeTools: () => pi.getActiveTools(),\n      setActiveTools: (names) => pi.setActiveTools(names),\n    }),\n  );\n}\n\n/**\n * Installs the sole Cordis application root for one Pi extension runner.\n *\n * The versioned EventBus query is intentional: Pi may hand independently\n * loaded factories different ExtensionAPI wrapper objects, while their event\n * buses still address the same runner.\n */\nexport async function installDoomCordisHost(\n  pi: ExtensionAPI,\n  options: InstallDoomCordisHostOptions,\n): Promise<DoomCordisHostController> {\n  const source = options.source ?? DEFAULT_HOST_SOURCE;\n  const existing = exactlyOneHost(discoverHosts(pi, source), source);\n  if (existing) throw new Error(`A Doom Cordis host is already installed: ${existing.hostId}.`);\n\n  // This is the one intentional Context constructor for DoomPi extension code.\n  const root = new Context();\n  const runtime: DoomCordisRuntimeService = Object.freeze({\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    hostId: `doom-cordis:${crypto.randomUUID()}`,\n    generation: `doom-runtime:${crypto.randomUUID()}`,\n    mode: options.mode,\n  });\n  const runtimeFiber = root.plugin(runtimeProvider, runtime);\n  const ready = runtimeFiber.await().then(() => undefined);\n  let sessionFiber: Fiber | undefined;\n  let sessionGeneration = 0;\n  let sessionQueue = Promise.resolve();\n  let leaseCount = 0;\n  let shutdownPromise: Promise<void> | undefined;\n  let responder: HostResponder;\n  let disposeQuerySubscription = (): void => undefined;\n\n  const controller: DoomCordisHostController = {\n    root,\n    runtime,\n    shutdown() {\n      shutdownPromise ??= (async () => {\n        disposeQuerySubscription();\n        await ready.catch(() => undefined);\n        await sessionQueue.catch(() => undefined);\n        await sessionFiber?.dispose();\n        sessionFiber = undefined;\n        await root.fiber.dispose();\n      })();\n      return shutdownPromise;\n    },\n  };\n\n  responder = {\n    protocol: HOST_PROTOCOL,\n    abiVersion: DOOM_CORDIS_HOST_ABI_VERSION,\n    hostId: runtime.hostId,\n    root,\n    runtime,\n    ready,\n    acquire() {\n      if (shutdownPromise) throw new Error(`The Doom Cordis host is shutting down: ${runtime.hostId}.`);\n      leaseCount += 1;\n      let released = false;\n      return {\n        root,\n        runtime,\n        async dispose() {\n          if (released) return;\n          released = true;\n          leaseCount -= 1;\n          if (options.mode === 'standalone' && leaseCount === 0) await controller.shutdown();\n        },\n      };\n    },\n    shutdown: () => controller.shutdown(),\n  };\n  try {\n    disposeQuerySubscription = pi.events.on(DOOM_CORDIS_HOST_QUERY_CHANNEL, (value) => {\n      const query = asHostQuery(value);\n      if (query) query.accept(responder);\n    });\n    pi.on('session_start', (event, context) => {\n      sessionQueue = sessionQueue\n        .catch(() => undefined)\n        .then(async () => {\n          // Pi owns its listener table and can retain this callback across a\n          // replacement. A start delivered after finalization belongs to the\n          // stale graph and must not revive or fail the next one.\n          if (shutdownPromise) return;\n          await sessionFiber?.dispose();\n          sessionGeneration += 1;\n          const service: DoomCordisSessionService = Object.freeze({\n            sessionId: context.sessionManager.getSessionId(),\n            generation: `${runtime.generation}:${String(sessionGeneration)}`,\n            reason: event.reason,\n            context,\n          });\n          sessionFiber = root.plugin((ctx: Context, value: DoomCordisSessionService) => {\n            sessionProvider(ctx, value, pi);\n          }, service);\n          await sessionFiber.await();\n        });\n      return sessionQueue;\n    });\n    if (options.mode === 'standalone') {\n      pi.on('session_shutdown', () => {\n        disposeQuerySubscription();\n      });\n    }\n    await ready;\n  } catch (error) {\n    await controller.shutdown();\n    throw error;\n  }\n  return controller;\n}\n\n/** Resolves the composed host installed by the canonical runtime. */\nexport async function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n): Promise<DoomCordisHostConnection> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  if (!responder)\n    throw new Error('The composed Doom Cordis host is unavailable. Ensure cordisHost is the first extension.');\n  await responder.ready;\n  return responder.acquire();\n}\n\n/** Ends the host discovered on this runner. Repeated finalization is a no-op. */\nexport async function finalizeDoomCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<void> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  await responder?.shutdown();\n}\n"],"mappings":"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"}

package/dist/runtimeHeadlessSessionManager.d.mts

@@ -0,0 +1,18 @@
+import { HeadlessSessionHost, HeadlessSessionHostOptions } from "./headlessSessionHost.mjs";
+//#region src/systems/main/types/headlessSessionManager.d.ts
+export interface HeadlessSessionManagerCreateOptions extends HeadlessSessionHostOptions {
+  signal?: AbortSignal;
+}
+export interface HeadlessSessionCloseOptions {
+  /** Keep the session's record, so it lists as dormant: readable, and able to be woken. */
+  readonly keepDormant?: boolean;
+}
+export interface HeadlessSessionManager {
+  create(options: HeadlessSessionManagerCreateOptions): Promise<HeadlessSessionHost>;
+  get(sessionId: string): HeadlessSessionHost | undefined;
+  sessions(): readonly HeadlessSessionHost[];
+  closeSession(sessionId: string, options?: HeadlessSessionCloseOptions): Promise<void>;
+  close(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=runtimeHeadlessSessionManager.d.mts.map

package/dist/runtimeHeadlessSessionManager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeHeadlessSessionManager.d.mts","names":[],"sources":["../src/systems/main/types/headlessSessionManager.ts"],"mappings":";;iBAEiB,4CAA4C;EAC3D,SAAS;;iBAGM;;WAEN;;iBAGM;EACf,OAAO,SAAS,sCAAsC,QAAQ;EAC9D,IAAI,oBAAoB;EACxB,qBAAqB;EACrB,aAAa,mBAAmB,UAAU,8BAA8B;EACxE,SAAS"}

package/dist/runtimeHeadlessSessionManager.mjs

@@ -0,0 +1 @@
+export {};

package/dist/runtimeIdentity.cjs

@@ -0,0 +1,26 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_crypto = require("node:crypto");
+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);
+//#region src/services/runtimeIdentity/index.ts
+/** Canonical on-disk identity used for activation deduplication and fingerprints. */
+function canonicalModulePath(target) {
+	const absolute = node_path.default.resolve(target);
+	let resolved = absolute;
+	try {
+		resolved = node_fs.default.realpathSync.native(absolute);
+	} catch {}
+	return resolved.split(node_path.default.sep).join("/");
+}
+/** Stable SHA-256 digest for a canonically serialized runtime identity. */
+function sha256(value) {
+	return (0, node_crypto.createHash)("sha256").update(value).digest("hex");
+}
+//#endregion
+exports.canonicalModulePath = canonicalModulePath;
+exports.sha256 = sha256;
+
+//# sourceMappingURL=runtimeIdentity.cjs.map

package/dist/runtimeIdentity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeIdentity.cjs","names":["path","fs","createHash"],"sources":["../src/services/runtimeIdentity/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/** Canonical on-disk identity used for activation deduplication and fingerprints. */\nexport function canonicalModulePath(target: string): string {\n  const absolute = path.resolve(target);\n  let resolved = absolute;\n  try {\n    resolved = fs.realpathSync.native(absolute);\n  } catch {\n    // Missing synthetic/test paths still receive an absolute normalized identity.\n  }\n  return resolved.split(path.sep).join('/');\n}\n\n/** Stable SHA-256 digest for a canonically serialized runtime identity. */\nexport function sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n"],"mappings":";;;;;;;;;AAKA,SAAgB,oBAAoB,QAAwB;CAC1D,MAAM,WAAWA,UAAAA,QAAK,QAAQ,MAAM;CACpC,IAAI,WAAW;CACf,IAAI;EACF,WAAWC,QAAAA,QAAG,aAAa,OAAO,QAAQ;CAC5C,QAAQ,CAER;CACA,OAAO,SAAS,MAAMD,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;;AAGA,SAAgB,OAAO,OAAuB;CAC5C,QAAA,GAAOE,YAAAA,WAAAA,CAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD"}

package/dist/runtimeIdentity.d.mts

@@ -0,0 +1,7 @@
+//#region src/services/runtimeIdentity/index.d.ts
+/** Canonical on-disk identity used for activation deduplication and fingerprints. */
+export declare function canonicalModulePath(target: string): string;
+/** Stable SHA-256 digest for a canonically serialized runtime identity. */
+export declare function sha256(value: string): string;
+//#endregion
+//# sourceMappingURL=runtimeIdentity.d.mts.map

package/dist/runtimeIdentity.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeIdentity.d.mts","names":[],"sources":["../src/services/runtimeIdentity/index.ts"],"mappings":";;wBAKgB,oBAAoB;;wBAYpB,OAAO"}

package/dist/runtimeIdentity.mjs

@@ -0,0 +1,21 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/services/runtimeIdentity/index.ts
+/** Canonical on-disk identity used for activation deduplication and fingerprints. */
+function canonicalModulePath(target) {
+	const absolute = path.resolve(target);
+	let resolved = absolute;
+	try {
+		resolved = fs.realpathSync.native(absolute);
+	} catch {}
+	return resolved.split(path.sep).join("/");
+}
+/** Stable SHA-256 digest for a canonically serialized runtime identity. */
+function sha256(value) {
+	return createHash("sha256").update(value).digest("hex");
+}
+//#endregion
+export { canonicalModulePath, sha256 };
+
+//# sourceMappingURL=runtimeIdentity.mjs.map

package/dist/runtimeIdentity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeIdentity.mjs","names":[],"sources":["../src/services/runtimeIdentity/index.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/** Canonical on-disk identity used for activation deduplication and fingerprints. */\nexport function canonicalModulePath(target: string): string {\n  const absolute = path.resolve(target);\n  let resolved = absolute;\n  try {\n    resolved = fs.realpathSync.native(absolute);\n  } catch {\n    // Missing synthetic/test paths still receive an absolute normalized identity.\n  }\n  return resolved.split(path.sep).join('/');\n}\n\n/** Stable SHA-256 digest for a canonically serialized runtime identity. */\nexport function sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n"],"mappings":";;;;;AAKA,SAAgB,oBAAoB,QAAwB;CAC1D,MAAM,WAAW,KAAK,QAAQ,MAAM;CACpC,IAAI,WAAW;CACf,IAAI;EACF,WAAW,GAAG,aAAa,OAAO,QAAQ;CAC5C,QAAQ,CAER;CACA,OAAO,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;;AAGA,SAAgB,OAAO,OAAuB;CAC5C,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD"}

package/dist/runtimeJson.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_crypto = require("node:crypto");
+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);
+//#region src/services/json/index.ts
+const ATOMIC_FILE_SUFFIX = ".tmp";
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Reads a JSON object, treating a missing or empty file as the fallback. */
+function readJson(filePath, fallback = {}) {
+	if (!node_fs.default.existsSync(filePath)) return fallback;
+	const content = node_fs.default.readFileSync(filePath, "utf8").trim();
+	return content ? JSON.parse(content) : fallback;
+}
+/**
+* Writes through a uniquely named temporary file in the same directory.
+*
+* The pid and a UUID are both in the name so two harnesses writing the same
+* target cannot collide on the temporary path, and a failed write cleans up
+* after itself rather than leaving the fragment behind.
+*/
+function writeFileAtomic(filePath, content) {
+	node_fs.default.mkdirSync(node_path.default.dirname(filePath), { recursive: true });
+	const temporaryPath = `${filePath}.${process.pid}.${(0, node_crypto.randomUUID)()}${ATOMIC_FILE_SUFFIX}`;
+	try {
+		node_fs.default.writeFileSync(temporaryPath, content);
+		node_fs.default.renameSync(temporaryPath, filePath);
+	} catch (error) {
+		node_fs.default.rmSync(temporaryPath, { force: true });
+		throw error;
+	}
+}
+function writeJson(filePath, value) {
+	writeFileAtomic(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+//#endregion
+exports.isRecord = isRecord;
+exports.readJson = readJson;
+exports.writeFileAtomic = writeFileAtomic;
+exports.writeJson = writeJson;
+
+//# sourceMappingURL=runtimeJson.cjs.map

package/dist/runtimeJson.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeJson.cjs","names":["fs","path","randomUUID"],"sources":["../src/services/json/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/**\n * JSON state helpers for files the harness owns on disk.\n *\n * Compatibility frontends read these files while another repository's harness\n * may be writing them, so writes go through a rename rather than a truncate.\n */\n\nexport type JsonObject = Record<string, unknown>;\n\nconst ATOMIC_FILE_SUFFIX = '.tmp';\n\nexport function isRecord(value: unknown): value is JsonObject {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Reads a JSON object, treating a missing or empty file as the fallback. */\nexport function readJson(filePath: string, fallback: JsonObject = {}): JsonObject {\n  if (!fs.existsSync(filePath)) return fallback;\n  const content = fs.readFileSync(filePath, 'utf8').trim();\n  return content ? (JSON.parse(content) as JsonObject) : fallback;\n}\n\n/**\n * Writes through a uniquely named temporary file in the same directory.\n *\n * The pid and a UUID are both in the name so two harnesses writing the same\n * target cannot collide on the temporary path, and a failed write cleans up\n * after itself rather than leaving the fragment behind.\n */\nexport function writeFileAtomic(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}${ATOMIC_FILE_SUFFIX}`;\n  try {\n    fs.writeFileSync(temporaryPath, content);\n    fs.renameSync(temporaryPath, filePath);\n  } catch (error) {\n    fs.rmSync(temporaryPath, { force: true });\n    throw error;\n  }\n}\n\nexport function writeJson(filePath: string, value: JsonObject): void {\n  writeFileAtomic(filePath, `${JSON.stringify(value, null, 2)}\\n`);\n}\n"],"mappings":";;;;;;;;AAaA,MAAM,qBAAqB;AAE3B,SAAgB,SAAS,OAAqC;CAC5D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;AAGA,SAAgB,SAAS,UAAkB,WAAuB,CAAC,GAAe;CAChF,IAAI,CAACA,QAAAA,QAAG,WAAW,QAAQ,GAAG,OAAO;CACrC,MAAM,UAAUA,QAAAA,QAAG,aAAa,UAAU,MAAM,CAAC,CAAC,KAAK;CACvD,OAAO,UAAW,KAAK,MAAM,OAAO,IAAmB;AACzD;;;;;;;;AASA,SAAgB,gBAAgB,UAAkB,SAAuB;CACvE,QAAA,QAAG,UAAUC,UAAAA,QAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CACxD,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,IAAI,IAAA,GAAGC,YAAAA,WAAAA,CAAW,IAAI;CACnE,IAAI;EACF,QAAA,QAAG,cAAc,eAAe,OAAO;EACvC,QAAA,QAAG,WAAW,eAAe,QAAQ;CACvC,SAAS,OAAO;EACd,QAAA,QAAG,OAAO,eAAe,EAAE,OAAO,KAAK,CAAC;EACxC,MAAM;CACR;AACF;AAEA,SAAgB,UAAU,UAAkB,OAAyB;CACnE,gBAAgB,UAAU,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE,GAAG;AACjE"}

package/dist/runtimeJson.d.mts

@@ -0,0 +1,22 @@
+//#region src/services/json/index.d.ts
+/**
+ * JSON state helpers for files the harness owns on disk.
+ *
+ * Compatibility frontends read these files while another repository's harness
+ * may be writing them, so writes go through a rename rather than a truncate.
+ */
+export type JsonObject = Record<string, unknown>;
+export declare function isRecord(value: unknown): value is JsonObject;
+/** Reads a JSON object, treating a missing or empty file as the fallback. */
+export declare function readJson(filePath: string, fallback?: JsonObject): JsonObject;
+/**
+ * Writes through a uniquely named temporary file in the same directory.
+ *
+ * The pid and a UUID are both in the name so two harnesses writing the same
+ * target cannot collide on the temporary path, and a failed write cleans up
+ * after itself rather than leaving the fragment behind.
+ */
+export declare function writeFileAtomic(filePath: string, content: string): void;
+export declare function writeJson(filePath: string, value: JsonObject): void;
+//#endregion
+//# sourceMappingURL=runtimeJson.d.mts.map

package/dist/runtimeJson.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeJson.d.mts","names":[],"sources":["../src/services/json/index.ts"],"mappings":";;;;;;;YAWY,aAAa;wBAIT,SAAS,iBAAiB,SAAS;;wBAKnC,SAAS,kBAAkB,WAAU,aAAkB;;;;;;;;wBAavD,gBAAgB,kBAAkB;wBAYlC,UAAU,kBAAkB,OAAO"}

package/dist/runtimeJson.mjs

@@ -0,0 +1,39 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/services/json/index.ts
+const ATOMIC_FILE_SUFFIX = ".tmp";
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Reads a JSON object, treating a missing or empty file as the fallback. */
+function readJson(filePath, fallback = {}) {
+	if (!fs.existsSync(filePath)) return fallback;
+	const content = fs.readFileSync(filePath, "utf8").trim();
+	return content ? JSON.parse(content) : fallback;
+}
+/**
+* Writes through a uniquely named temporary file in the same directory.
+*
+* The pid and a UUID are both in the name so two harnesses writing the same
+* target cannot collide on the temporary path, and a failed write cleans up
+* after itself rather than leaving the fragment behind.
+*/
+function writeFileAtomic(filePath, content) {
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}${ATOMIC_FILE_SUFFIX}`;
+	try {
+		fs.writeFileSync(temporaryPath, content);
+		fs.renameSync(temporaryPath, filePath);
+	} catch (error) {
+		fs.rmSync(temporaryPath, { force: true });
+		throw error;
+	}
+}
+function writeJson(filePath, value) {
+	writeFileAtomic(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+//#endregion
+export { isRecord, readJson, writeFileAtomic, writeJson };
+
+//# sourceMappingURL=runtimeJson.mjs.map

package/dist/runtimeJson.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeJson.mjs","names":[],"sources":["../src/services/json/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\n/**\n * JSON state helpers for files the harness owns on disk.\n *\n * Compatibility frontends read these files while another repository's harness\n * may be writing them, so writes go through a rename rather than a truncate.\n */\n\nexport type JsonObject = Record<string, unknown>;\n\nconst ATOMIC_FILE_SUFFIX = '.tmp';\n\nexport function isRecord(value: unknown): value is JsonObject {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Reads a JSON object, treating a missing or empty file as the fallback. */\nexport function readJson(filePath: string, fallback: JsonObject = {}): JsonObject {\n  if (!fs.existsSync(filePath)) return fallback;\n  const content = fs.readFileSync(filePath, 'utf8').trim();\n  return content ? (JSON.parse(content) as JsonObject) : fallback;\n}\n\n/**\n * Writes through a uniquely named temporary file in the same directory.\n *\n * The pid and a UUID are both in the name so two harnesses writing the same\n * target cannot collide on the temporary path, and a failed write cleans up\n * after itself rather than leaving the fragment behind.\n */\nexport function writeFileAtomic(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}${ATOMIC_FILE_SUFFIX}`;\n  try {\n    fs.writeFileSync(temporaryPath, content);\n    fs.renameSync(temporaryPath, filePath);\n  } catch (error) {\n    fs.rmSync(temporaryPath, { force: true });\n    throw error;\n  }\n}\n\nexport function writeJson(filePath: string, value: JsonObject): void {\n  writeFileAtomic(filePath, `${JSON.stringify(value, null, 2)}\\n`);\n}\n"],"mappings":";;;;AAaA,MAAM,qBAAqB;AAE3B,SAAgB,SAAS,OAAqC;CAC5D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;AAGA,SAAgB,SAAS,UAAkB,WAAuB,CAAC,GAAe;CAChF,IAAI,CAAC,GAAG,WAAW,QAAQ,GAAG,OAAO;CACrC,MAAM,UAAU,GAAG,aAAa,UAAU,MAAM,CAAC,CAAC,KAAK;CACvD,OAAO,UAAW,KAAK,MAAM,OAAO,IAAmB;AACzD;;;;;;;;AASA,SAAgB,gBAAgB,UAAkB,SAAuB;CACvE,GAAG,UAAU,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CACxD,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,IAAI,GAAG,WAAW,IAAI;CACnE,IAAI;EACF,GAAG,cAAc,eAAe,OAAO;EACvC,GAAG,WAAW,eAAe,QAAQ;CACvC,SAAS,OAAO;EACd,GAAG,OAAO,eAAe,EAAE,OAAO,KAAK,CAAC;EACxC,MAAM;CACR;AACF;AAEA,SAAgB,UAAU,UAAkB,OAAyB;CACnE,gBAAgB,UAAU,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE,GAAG;AACjE"}