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

package/dist/runtime-context-api.d.mts

@@ -0,0 +1,16 @@
+import { DoomApi, DoomApiHandler } from "./schemas/packageApi.mjs";
+import "./package-api.mjs";
+import { readContextDetail } from "./context-detail-store.mjs";
+//#region src/server/contextApi.d.ts
+export interface ContextApiOptions {
+  /** The session these routes answer for; absent when the host is the hub. */
+  sessionId?: string;
+  /** Session environment admitted by the host. */
+  environment?: Readonly<Record<string, string | undefined>>;
+  /** Injectable for tests; defaults to the file the agent writes. */
+  readDetail?: typeof readContextDetail;
+}
+export declare function createContextApi(options?: ContextApiOptions): DoomApiHandler;
+export declare const api: DoomApi;
+//#endregion
+//# sourceMappingURL=runtime-context-api.d.mts.map

package/dist/runtime-context-api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context-api.d.mts","names":[],"sources":["../src/server/contextApi.ts"],"mappings":";;;;iBA6BiB;;EAEf;;EAEA,cAAc,SAAS;;EAEvB,oBAAoB;;wBAGN,iBAAiB,UAAS,oBAAyB;qBAgCtD,KAAK"}

package/dist/runtime-context-api.mjs

@@ -0,0 +1,62 @@
+import { API_BASE_PATH, KIND_QUERY_PARAM, NAME_QUERY_PARAM } from "./constants/contextApi.mjs";
+import { findContextItem, readContextDetail } from "./context-detail-store.mjs";
+//#region src/server/contextApi.ts
+/**
+* What one row of the composition actually is, on request.
+*
+* The context panel prices every tool and skill the session carries, and the
+* figure is only half an answer: the reader deciding whether a package earns
+* its thousand tokens wants the prose and the schema behind it. Those are too
+* large to push, and they are wanted one row at a time, so they are served
+* here instead and fetched on the click.
+*
+* The agent writes the store; this reads it. The two are separate processes
+* and the inventory only exists inside the agent, which is the same split
+* every other package-owned API in the repository lives with.
+*/
+function json(body, status) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: { "content-type": "application/json; charset=utf-8" }
+	});
+}
+function isItemKind(value) {
+	return value === "tool" || value === "skill";
+}
+function createContextApi(options = {}) {
+	const readDetail = options.readDetail ?? readContextDetail;
+	return {
+		fetch(request) {
+			const url = new URL(request.url);
+			if (url.pathname !== "/item") return json({ error: "No such route." }, 404);
+			if (request.method !== "GET") return json({ error: "Only GET is served here." }, 405);
+			if (options.sessionId === void 0) return json({ error: "This host serves no session." }, 404);
+			const itemKind = url.searchParams.get(KIND_QUERY_PARAM);
+			const name = url.searchParams.get(NAME_QUERY_PARAM);
+			if (!isItemKind(itemKind)) return json({ error: "Ask for a tool or a skill." }, 400);
+			if (name === null || name === "") return json({ error: "Name the item to describe." }, 400);
+			const file = options.readDetail ? options.readDetail(options.sessionId, options.environment) : options.environment === void 0 ? void 0 : readDetail(options.sessionId, options.environment);
+			if (file === void 0) return json({ error: "This session has not reported its composition yet." }, 404);
+			const item = findContextItem(file, itemKind, name);
+			if (item === void 0) return json({ error: `The session carries no ${itemKind} called ${name}.` }, 404);
+			return json({
+				revision: file.revision,
+				item
+			}, 200);
+		},
+		close: () => {}
+	};
+}
+const api = {
+	basePath: API_BASE_PATH,
+	start(context) {
+		return createContextApi({
+			...context.sessionId === void 0 ? {} : { sessionId: context.sessionId },
+			...context.environment === void 0 ? {} : { environment: context.environment }
+		});
+	}
+};
+//#endregion
+export { api, createContextApi };
+
+//# sourceMappingURL=runtime-context-api.mjs.map

package/dist/runtime-context-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context-api.mjs","names":[],"sources":["../src/server/contextApi.ts"],"sourcesContent":["import { API_BASE_PATH, ITEM_ROUTE, KIND_QUERY_PARAM, NAME_QUERY_PARAM } from '../constants/contextApi';\nimport type { DoomApi, DoomApiContext, DoomApiHandler } from '../exports/packageApi';\nimport { findContextItem, readContextDetail } from '../services/contextDetailStore';\n\n/**\n * What one row of the composition actually is, on request.\n *\n * The context panel prices every tool and skill the session carries, and the\n * figure is only half an answer: the reader deciding whether a package earns\n * its thousand tokens wants the prose and the schema behind it. Those are too\n * large to push, and they are wanted one row at a time, so they are served\n * here instead and fetched on the click.\n *\n * The agent writes the store; this reads it. The two are separate processes\n * and the inventory only exists inside the agent, which is the same split\n * every other package-owned API in the repository lives with.\n */\n\nfunction json(body: unknown, status: number): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { 'content-type': 'application/json; charset=utf-8' },\n  });\n}\n\nfunction isItemKind(value: string | null): value is 'tool' | 'skill' {\n  return value === 'tool' || value === 'skill';\n}\n\nexport interface ContextApiOptions {\n  /** The session these routes answer for; absent when the host is the hub. */\n  sessionId?: string;\n  /** Session environment admitted by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** Injectable for tests; defaults to the file the agent writes. */\n  readDetail?: typeof readContextDetail;\n}\n\nexport function createContextApi(options: ContextApiOptions = {}): DoomApiHandler {\n  const readDetail = options.readDetail ?? readContextDetail;\n  return {\n    fetch(request: Request): Response {\n      const url = new URL(request.url);\n      if (url.pathname !== ITEM_ROUTE) return json({ error: 'No such route.' }, 404);\n      if (request.method !== 'GET') return json({ error: 'Only GET is served here.' }, 405);\n      if (options.sessionId === undefined) return json({ error: 'This host serves no session.' }, 404);\n\n      const itemKind = url.searchParams.get(KIND_QUERY_PARAM);\n      const name = url.searchParams.get(NAME_QUERY_PARAM);\n      if (!isItemKind(itemKind)) return json({ error: 'Ask for a tool or a skill.' }, 400);\n      if (name === null || name === '') return json({ error: 'Name the item to describe.' }, 400);\n\n      const file = options.readDetail\n        ? options.readDetail(options.sessionId, options.environment)\n        : options.environment === undefined\n          ? undefined\n          : readDetail(options.sessionId, options.environment);\n      // A session that has not published yet is the ordinary state for the\n      // first half-second of its life, and says so rather than looking broken.\n      if (file === undefined) {\n        return json({ error: 'This session has not reported its composition yet.' }, 404);\n      }\n      const item = findContextItem(file, itemKind, name);\n      if (item === undefined) return json({ error: `The session carries no ${itemKind} called ${name}.` }, 404);\n      return json({ revision: file.revision, item }, 200);\n    },\n    close: () => {},\n  };\n}\n\nexport const api: DoomApi = {\n  basePath: API_BASE_PATH,\n  start(context: DoomApiContext): DoomApiHandler {\n    return createContextApi({\n      ...(context.sessionId === undefined ? {} : { sessionId: context.sessionId }),\n      ...(context.environment === undefined ? {} : { environment: context.environment }),\n    });\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,SAAS,KAAK,MAAe,QAA0B;CACrD,OAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;EACxC;EACA,SAAS,EAAE,gBAAgB,kCAAkC;CAC/D,CAAC;AACH;AAEA,SAAS,WAAW,OAAiD;CACnE,OAAO,UAAU,UAAU,UAAU;AACvC;AAWA,SAAgB,iBAAiB,UAA6B,CAAC,GAAmB;CAChF,MAAM,aAAa,QAAQ,cAAc;CACzC,OAAO;EACL,MAAM,SAA4B;GAChC,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;GAC/B,IAAI,IAAI,aAAA,SAAyB,OAAO,KAAK,EAAE,OAAO,iBAAiB,GAAG,GAAG;GAC7E,IAAI,QAAQ,WAAW,OAAO,OAAO,KAAK,EAAE,OAAO,2BAA2B,GAAG,GAAG;GACpF,IAAI,QAAQ,cAAc,KAAA,GAAW,OAAO,KAAK,EAAE,OAAO,+BAA+B,GAAG,GAAG;GAE/F,MAAM,WAAW,IAAI,aAAa,IAAI,gBAAgB;GACtD,MAAM,OAAO,IAAI,aAAa,IAAI,gBAAgB;GAClD,IAAI,CAAC,WAAW,QAAQ,GAAG,OAAO,KAAK,EAAE,OAAO,6BAA6B,GAAG,GAAG;GACnF,IAAI,SAAS,QAAQ,SAAS,IAAI,OAAO,KAAK,EAAE,OAAO,6BAA6B,GAAG,GAAG;GAE1F,MAAM,OAAO,QAAQ,aACjB,QAAQ,WAAW,QAAQ,WAAW,QAAQ,WAAW,IACzD,QAAQ,gBAAgB,KAAA,IACtB,KAAA,IACA,WAAW,QAAQ,WAAW,QAAQ,WAAW;GAGvD,IAAI,SAAS,KAAA,GACX,OAAO,KAAK,EAAE,OAAO,qDAAqD,GAAG,GAAG;GAElF,MAAM,OAAO,gBAAgB,MAAM,UAAU,IAAI;GACjD,IAAI,SAAS,KAAA,GAAW,OAAO,KAAK,EAAE,OAAO,0BAA0B,SAAS,UAAU,KAAK,GAAG,GAAG,GAAG;GACxG,OAAO,KAAK;IAAE,UAAU,KAAK;IAAU;GAAK,GAAG,GAAG;EACpD;EACA,aAAa,CAAC;CAChB;AACF;AAEA,MAAa,MAAe;CAC1B,UAAU;CACV,MAAM,SAAyC;EAC7C,OAAO,iBAAiB;GACtB,GAAI,QAAQ,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,QAAQ,UAAU;GAC1E,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;EAClF,CAAC;CACH;AACF"}

package/dist/runtime-cordis-host.cjs

@@ -0,0 +1,191 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_contextContributions = require("./schemas/contextContributions.cjs");
+const require_index = require("./services/contextContributions/index.cjs");
+const require_toolOverrides = require("./schemas/toolOverrides.cjs");
+const require_toolSurface = require("./schemas/toolSurface.cjs");
+const require_index$1 = require("./services/toolOverrides/index.cjs");
+const require_index$2 = require("./services/toolSurface/index.cjs");
+let _deepseek_ai_cordis = require("@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 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 (!_deepseek_ai_cordis.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(require_toolOverrides.DOOM_TOOL_OVERRIDES_SERVICE, require_index$1.createDoomToolOverridesService(service.generation));
+}
+function sessionProvider(ctx, service, pi) {
+	ctx.provide(DOOM_CORDIS_SESSION_SERVICE, service);
+	ctx.provide(require_contextContributions.DOOM_CONTEXT_CONTRIBUTIONS_SERVICE, require_index.createDoomContextContributionsService(service.generation));
+	ctx.provide(require_toolSurface.DOOM_TOOL_SURFACE_SERVICE, require_index$2.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 _deepseek_ai_cordis.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
+exports.DOOM_CORDIS_HOST_ABI_VERSION = DOOM_CORDIS_HOST_ABI_VERSION;
+exports.DOOM_CORDIS_HOST_QUERY_CHANNEL = DOOM_CORDIS_HOST_QUERY_CHANNEL;
+exports.DOOM_CORDIS_RUNTIME_SERVICE = DOOM_CORDIS_RUNTIME_SERVICE;
+exports.DOOM_CORDIS_SESSION_SERVICE = DOOM_CORDIS_SESSION_SERVICE;
+exports.connectDoomCordisHost = connectDoomCordisHost;
+exports.finalizeDoomCordisHost = finalizeDoomCordisHost;
+exports.installDoomCordisHost = installDoomCordisHost;
+exports.requireDoomCordisSession = requireDoomCordisSession;
+
+//# sourceMappingURL=runtime-cordis-host.cjs.map

package/dist/runtime-cordis-host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-cordis-host.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';\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(pi: ExtensionAPI, source: string): 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/runtime-cordis-host.d.cts

@@ -0,0 +1,57 @@
+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 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: ExtensionAPI, 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=runtime-cordis-host.d.cts.map

package/dist/runtime-cordis-host.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-cordis-host.d.cts","names":[],"sources":["../src/pi/cordisHost.ts"],"mappings":";;;qBAUa;qBACA;qBACA;qBACA;YAID;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,sBAAsB,IAAI,cAAc,iBAAiB,QAAQ;;wBASjE,uBAAuB,IAAI,KAAK,yBAAyB,iBAAiB"}

package/dist/runtime-cordis-host.d.mts

@@ -0,0 +1,57 @@
+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 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: ExtensionAPI, 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=runtime-cordis-host.d.mts.map

package/dist/runtime-cordis-host.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-cordis-host.d.mts","names":[],"sources":["../src/pi/cordisHost.ts"],"mappings":";;;qBAUa;qBACA;qBACA;qBACA;YAID;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,sBAAsB,IAAI,cAAc,iBAAiB,QAAQ;;wBASjE,uBAAuB,IAAI,KAAK,yBAAyB,iBAAiB"}

package/dist/runtime-cordis-host.mjs

@@ -0,0 +1,183 @@
+import { DOOM_CONTEXT_CONTRIBUTIONS_SERVICE } from "./schemas/contextContributions.mjs";
+import { createDoomContextContributionsService } from "./services/contextContributions/index.mjs";
+import { DOOM_TOOL_OVERRIDES_SERVICE } from "./schemas/toolOverrides.mjs";
+import { DOOM_TOOL_SURFACE_SERVICE } from "./schemas/toolSurface.mjs";
+import { createDoomToolOverridesService } from "./services/toolOverrides/index.mjs";
+import { createDoomToolSurface } from "./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 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_SESSION_SERVICE, connectDoomCordisHost, finalizeDoomCordisHost, installDoomCordisHost, requireDoomCordisSession };
+
+//# sourceMappingURL=runtime-cordis-host.mjs.map