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

package/dist/runtimeCordisHost.cjs

@@ -7,12 +7,12 @@ const require_index$1 = require("./src/services/toolOverrides/index.cjs");
 const require_index$2 = require("./src/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 DOOM_CORDIS_SERVER_SERVICES = "doom/server-session-services";
-const HOST_PROTOCOL = "doom.cordis.host";
+const PO_CORDIS_HOST_ABI_VERSION = 1;
+const PO_CORDIS_HOST_QUERY_CHANNEL = "po:cordis:host:v1:query";
+const PO_CORDIS_RUNTIME_SERVICE = "po/runtime";
+const PO_CORDIS_SESSION_SERVICE = "po/session";
+const PO_CORDIS_SERVER_SERVICES = "po/server-session-services";
+const HOST_PROTOCOL = "po.cordis.host";
 const DEFAULT_HOST_SOURCE = "@agimon-ai/po/cordis-host";
 /**
 * Admitted environments of sessions sharing this process, by session id.
@@ -21,14 +21,14 @@ const DEFAULT_HOST_SOURCE = "@agimon-ai/po/cordis-host";
 * the server's, not any session's. Held on a global symbol because extension
 * packages can load their own copy of this module.
 */
-const SESSION_ENVIRONMENTS = globalThis[Symbol.for("doom.cordis.session-environments.v1")] ??= /* @__PURE__ */ new Map();
+const SESSION_ENVIRONMENTS = globalThis[Symbol.for("po.cordis.session-environments.v1")] ??= /* @__PURE__ */ new Map();
 /**
 * Binds a session id to its admitted environment until the returned release runs.
 *
 * The newest registration wins: a reopened session can start before its previous host has
 * finished closing, and that late release must not unbind the new one.
 */
-function registerDoomSessionEnvironment(sessionId, environment) {
+function registerPoSessionEnvironment(sessionId, environment) {
 	const registration = { environment };
 	SESSION_ENVIRONMENTS.set(sessionId, registration);
 	return () => {
@@ -36,12 +36,12 @@ function registerDoomSessionEnvironment(sessionId, environment) {
 	};
 }
 /** The session's admitted environment, or `process.env` for a session that owns its process. */
-function readDoomSessionEnvironment(sessionId) {
+function readPoSessionEnvironment(sessionId) {
 	return (sessionId === void 0 ? void 0 : SESSION_ENVIRONMENTS.get(sessionId)?.environment) ?? process.env;
 }
-function requireDoomCordisSession(context) {
-	const session = context.get(DOOM_CORDIS_SESSION_SERVICE);
-	if (!session) throw new Error("Doom Cordis session service is unavailable.");
+function requirePoCordisSession(context) {
+	const session = context.get(PO_CORDIS_SESSION_SERVICE);
+	if (!session) throw new Error("Po Cordis session service is unavailable.");
 	return session;
 }
 function isRecord(value) {
@@ -53,12 +53,12 @@ function asHostQuery(value) {
 	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.");
+	if (!isRecord(value)) throw new Error("The Po Cordis host returned an invalid discovery response.");
+	if (value.protocol !== HOST_PROTOCOL) throw new Error("The Po Cordis host returned an invalid protocol identifier.");
+	if (value.abiVersion !== 1) throw new Error(`The Po 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 Po Cordis host returned an invalid host identifier.");
+	if (!_deepseek_ai_cordis.Context.is(value.root)) throw new Error("The Po 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 Po Cordis host returned incomplete runtime metadata.");
 	return value;
 }
 function discoverHosts(pi, source) {
@@ -73,22 +73,22 @@ function discoverHosts(pi, source) {
 			responses.push(asHostResponder(response));
 		}
 	};
-	pi.events.emit(DOOM_CORDIS_HOST_QUERY_CHANNEL, request);
+	pi.events.emit(PO_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}.`);
+	throw new Error(`Multiple Po 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));
+	ctx.provide(PO_CORDIS_RUNTIME_SERVICE, service);
+	ctx.provide(require_toolOverrides.PO_TOOL_OVERRIDES_SERVICE, require_index$1.createPoToolOverridesService(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({
+	ctx.provide(PO_CORDIS_SESSION_SERVICE, service);
+	ctx.provide(require_contextContributions.PO_CONTEXT_CONTRIBUTIONS_SERVICE, require_index.createPoContextContributionsService(service.generation));
+	ctx.provide(require_toolSurface.PO_TOOL_SURFACE_SERVICE, require_index$2.createPoToolSurface({
 		generation: service.generation,
 		allTools: () => pi.getAllTools().map((tool) => tool.name),
 		activeTools: () => pi.getActiveTools(),
@@ -102,15 +102,15 @@ function sessionProvider(ctx, service, pi) {
 * loaded factories different ExtensionAPI wrapper objects, while their event
 * buses still address the same runner.
 */
-async function installDoomCordisHost(pi, options) {
+async function installPoCordisHost(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}.`);
+	if (existing) throw new Error(`A Po 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()}`,
+		hostId: `po-cordis:${crypto.randomUUID()}`,
+		generation: `po-runtime:${crypto.randomUUID()}`,
 		mode: options.mode
 	});
 	const ready = root.plugin(runtimeProvider, runtime).await().then(() => void 0);
@@ -144,7 +144,7 @@ async function installDoomCordisHost(pi, options) {
 		runtime,
 		ready,
 		acquire() {
-			if (shutdownPromise) throw new Error(`The Doom Cordis host is shutting down: ${runtime.hostId}.`);
+			if (shutdownPromise) throw new Error(`The Po Cordis host is shutting down: ${runtime.hostId}.`);
 			leaseCount += 1;
 			let released = false;
 			return {
@@ -161,7 +161,7 @@ async function installDoomCordisHost(pi, options) {
 		shutdown: () => controller.shutdown()
 	};
 	try {
-		disposeQuerySubscription = pi.events.on(DOOM_CORDIS_HOST_QUERY_CHANNEL, (value) => {
+		disposeQuerySubscription = pi.events.on(PO_CORDIS_HOST_QUERY_CHANNEL, (value) => {
 			const query = asHostQuery(value);
 			if (query) query.accept(responder);
 		});
@@ -175,7 +175,7 @@ async function installDoomCordisHost(pi, options) {
 					generation: `${runtime.generation}:${String(sessionGeneration)}`,
 					reason: event.reason,
 					context,
-					environment: readDoomSessionEnvironment(context.sessionManager.getSessionId())
+					environment: readPoSessionEnvironment(context.sessionManager.getSessionId())
 				});
 				sessionFiber = root.plugin((ctx, value) => {
 					sessionProvider(ctx, value, pi);
@@ -194,30 +194,30 @@ async function installDoomCordisHost(pi, options) {
 	}
 	return controller;
 }
-async function connectDoomCordisHost(pi, source, options) {
+async function connectPoCordisHost(pi, source, options) {
 	const responder = exactlyOneHost(discoverHosts(pi, source), source);
 	if (!responder) {
 		if (options?.optional) return void 0;
-		throw new Error("The composed Doom Cordis host is unavailable. Ensure cordisHost is the first extension.");
+		throw new Error("The composed Po 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) {
+async function finalizePoCordisHost(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_SERVER_SERVICES = DOOM_CORDIS_SERVER_SERVICES;
-exports.DOOM_CORDIS_SESSION_SERVICE = DOOM_CORDIS_SESSION_SERVICE;
-exports.connectDoomCordisHost = connectDoomCordisHost;
-exports.finalizeDoomCordisHost = finalizeDoomCordisHost;
-exports.installDoomCordisHost = installDoomCordisHost;
-exports.readDoomSessionEnvironment = readDoomSessionEnvironment;
-exports.registerDoomSessionEnvironment = registerDoomSessionEnvironment;
-exports.requireDoomCordisSession = requireDoomCordisSession;
+exports.PO_CORDIS_HOST_ABI_VERSION = PO_CORDIS_HOST_ABI_VERSION;
+exports.PO_CORDIS_HOST_QUERY_CHANNEL = PO_CORDIS_HOST_QUERY_CHANNEL;
+exports.PO_CORDIS_RUNTIME_SERVICE = PO_CORDIS_RUNTIME_SERVICE;
+exports.PO_CORDIS_SERVER_SERVICES = PO_CORDIS_SERVER_SERVICES;
+exports.PO_CORDIS_SESSION_SERVICE = PO_CORDIS_SESSION_SERVICE;
+exports.connectPoCordisHost = connectPoCordisHost;
+exports.finalizePoCordisHost = finalizePoCordisHost;
+exports.installPoCordisHost = installPoCordisHost;
+exports.readPoSessionEnvironment = readPoSessionEnvironment;
+exports.registerPoSessionEnvironment = registerPoSessionEnvironment;
+exports.requirePoCordisSession = requirePoCordisSession;
 
 //# sourceMappingURL=runtimeCordisHost.cjs.map

package/dist/runtimeCordisHost.cjs.map

@@ -1 +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/po/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  /** This session's admitted environment: its own in a server, the process's in a terminal. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n}\n\ntype SessionEnvironment = Readonly<Record<string, string | undefined>>;\n\n/**\n * Admitted environments of sessions sharing this process, by session id.\n *\n * A server runs many sessions' Pi extensions in one process, so `process.env` is\n * the server's, not any session's. Held on a global symbol because extension\n * packages can load their own copy of this module.\n */\nconst SESSION_ENVIRONMENTS: Map<string, { readonly environment: SessionEnvironment }> = ((\n  globalThis as Record<symbol, unknown>\n)[Symbol.for('doom.cordis.session-environments.v1')] ??= new Map()) as Map<\n  string,\n  { readonly environment: SessionEnvironment }\n>;\n\n/**\n * Binds a session id to its admitted environment until the returned release runs.\n *\n * The newest registration wins: a reopened session can start before its previous host has\n * finished closing, and that late release must not unbind the new one.\n */\nexport function registerDoomSessionEnvironment(sessionId: string, environment: SessionEnvironment): () => void {\n  const registration = { environment };\n  SESSION_ENVIRONMENTS.set(sessionId, registration);\n  return () => {\n    if (SESSION_ENVIRONMENTS.get(sessionId) === registration) SESSION_ENVIRONMENTS.delete(sessionId);\n  };\n}\n\n/** The session's admitted environment, or `process.env` for a session that owns its process. */\nexport function readDoomSessionEnvironment(sessionId: string | undefined): SessionEnvironment {\n  return (sessionId === undefined ? undefined : SESSION_ENVIRONMENTS.get(sessionId)?.environment) ?? process.env;\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 Po 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            environment: readDoomSessionEnvironment(context.sessionManager.getSessionId()),\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 function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n): Promise<DoomCordisHostConnection>;\nexport function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options: { readonly optional: true },\n): Promise<DoomCordisHostConnection | undefined>;\nexport async function connectDoomCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options?: { readonly optional: true },\n): Promise<DoomCordisHostConnection | undefined> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  if (!responder) {\n    // Vanilla Pi plugins do not install a Doom host. Optional discovery permits only\n    // that absence, never an invalid or ambiguous responder.\n    if (options?.optional) return undefined;\n    throw new Error('The composed Doom Cordis host is unavailable. Ensure cordisHost is the first extension.');\n  }\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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"}
+{"version":3,"file":"runtimeCordisHost.cjs","names":["Context","PO_TOOL_OVERRIDES_SERVICE","createPoToolOverridesService","PO_CONTEXT_CONTRIBUTIONS_SERVICE","createPoContextContributionsService","PO_TOOL_SURFACE_SERVICE","createPoToolSurface"],"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 { PO_CONTEXT_CONTRIBUTIONS_SERVICE } from '../schemas/contextContributions';\nimport { PO_TOOL_OVERRIDES_SERVICE } from '../schemas/toolOverrides';\nimport { PO_TOOL_SURFACE_SERVICE } from '../schemas/toolSurface';\nimport { createPoContextContributionsService } from '../services/contextContributions';\nimport { createPoToolOverridesService } from '../services/toolOverrides';\nimport { createPoToolSurface } from '../services/toolSurface';\n\nexport const PO_CORDIS_HOST_ABI_VERSION = 1 as const;\nexport const PO_CORDIS_HOST_QUERY_CHANNEL = 'po:cordis:host:v1:query';\nexport const PO_CORDIS_RUNTIME_SERVICE = 'po/runtime';\nexport const PO_CORDIS_SESSION_SERVICE = 'po/session';\nexport const PO_CORDIS_SERVER_SERVICES = 'po/server-session-services';\n\n/** Read-only access to services already owned by this session's server packages. */\nexport interface PoCordisServerServices {\n  readonly sessionId: string;\n  get<T>(name: string): T | undefined;\n}\nconst HOST_PROTOCOL = 'po.cordis.host';\nconst DEFAULT_HOST_SOURCE = '@agimon-ai/po/cordis-host';\n\nexport type PoCordisHostMode = 'composed' | 'standalone';\n\nexport interface PoCordisRuntimeService {\n  readonly abiVersion: typeof PO_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly generation: string;\n  readonly mode: PoCordisHostMode;\n}\n\nexport interface PoCordisSessionService {\n  readonly sessionId: string;\n  readonly generation: string;\n  readonly reason: SessionStartEvent['reason'];\n  readonly context: ExtensionContext;\n  /** This session's admitted environment: its own in a server, the process's in a terminal. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n}\n\ntype SessionEnvironment = Readonly<Record<string, string | undefined>>;\n\n/**\n * Admitted environments of sessions sharing this process, by session id.\n *\n * A server runs many sessions' Pi extensions in one process, so `process.env` is\n * the server's, not any session's. Held on a global symbol because extension\n * packages can load their own copy of this module.\n */\nconst SESSION_ENVIRONMENTS: Map<string, { readonly environment: SessionEnvironment }> = ((\n  globalThis as Record<symbol, unknown>\n)[Symbol.for('po.cordis.session-environments.v1')] ??= new Map()) as Map<\n  string,\n  { readonly environment: SessionEnvironment }\n>;\n\n/**\n * Binds a session id to its admitted environment until the returned release runs.\n *\n * The newest registration wins: a reopened session can start before its previous host has\n * finished closing, and that late release must not unbind the new one.\n */\nexport function registerPoSessionEnvironment(sessionId: string, environment: SessionEnvironment): () => void {\n  const registration = { environment };\n  SESSION_ENVIRONMENTS.set(sessionId, registration);\n  return () => {\n    if (SESSION_ENVIRONMENTS.get(sessionId) === registration) SESSION_ENVIRONMENTS.delete(sessionId);\n  };\n}\n\n/** The session's admitted environment, or `process.env` for a session that owns its process. */\nexport function readPoSessionEnvironment(sessionId: string | undefined): SessionEnvironment {\n  return (sessionId === undefined ? undefined : SESSION_ENVIRONMENTS.get(sessionId)?.environment) ?? process.env;\n}\n\nexport function requirePoCordisSession(context: Context): PoCordisSessionService {\n  const session = context.get(PO_CORDIS_SESSION_SERVICE) as PoCordisSessionService | undefined;\n  if (!session) throw new Error('Po Cordis session service is unavailable.');\n  return session;\n}\n\nexport interface PoCordisHostConnection {\n  readonly root: Context;\n  readonly runtime: PoCordisRuntimeService;\n  /** Releases this consumer's lease. It never disposes a composed host. */\n  dispose(): Promise<void>;\n}\n\nexport interface PoCordisHostController {\n  readonly root: Context;\n  readonly runtime: PoCordisRuntimeService;\n  /** Recursively disposes the session and application plugin tree. */\n  shutdown(): Promise<void>;\n}\n\nexport interface InstallPoCordisHostOptions {\n  readonly mode: PoCordisHostMode;\n  readonly source?: string;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/runtime': PoCordisRuntimeService;\n    'po/session': PoCordisSessionService;\n  }\n}\n\ninterface HostQuery {\n  readonly protocol: typeof HOST_PROTOCOL;\n  readonly abiVersion: typeof PO_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 PO_CORDIS_HOST_ABI_VERSION;\n  readonly hostId: string;\n  readonly root: Context;\n  readonly runtime: PoCordisRuntimeService;\n  readonly ready: Promise<void>;\n  acquire(): PoCordisHostConnection;\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 !== PO_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 Po Cordis host returned an invalid discovery response.');\n  if (value.protocol !== HOST_PROTOCOL) {\n    throw new Error('The Po Cordis host returned an invalid protocol identifier.');\n  }\n  if (value.abiVersion !== PO_CORDIS_HOST_ABI_VERSION) {\n    throw new Error(\n      `The Po Cordis host ABI is incompatible: expected ${String(PO_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 Po Cordis host returned an invalid host identifier.');\n  }\n  if (!Context.is(value.root)) {\n    throw new Error('The Po Cordis host returned a value that is not a Cordis Context.');\n  }\n  if (\n    !isRecord(value.runtime) ||\n    value.runtime.abiVersion !== PO_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 Po 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: PO_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(PO_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 Po Cordis hosts answered ${source}: ${hostIds}.`);\n}\n\nfunction runtimeProvider(ctx: Context, service: PoCordisRuntimeService): void {\n  ctx.provide(PO_CORDIS_RUNTIME_SERVICE, service);\n  ctx.provide(PO_TOOL_OVERRIDES_SERVICE, createPoToolOverridesService(service.generation));\n}\n\nfunction sessionProvider(ctx: Context, service: PoCordisSessionService, pi: ExtensionAPI): void {\n  ctx.provide(PO_CORDIS_SESSION_SERVICE, service);\n  ctx.provide(PO_CONTEXT_CONTRIBUTIONS_SERVICE, createPoContextContributionsService(service.generation));\n  ctx.provide(\n    PO_TOOL_SURFACE_SERVICE,\n    createPoToolSurface({\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 installPoCordisHost(\n  pi: ExtensionAPI,\n  options: InstallPoCordisHostOptions,\n): Promise<PoCordisHostController> {\n  const source = options.source ?? DEFAULT_HOST_SOURCE;\n  const existing = exactlyOneHost(discoverHosts(pi, source), source);\n  if (existing) throw new Error(`A Po Cordis host is already installed: ${existing.hostId}.`);\n\n  // This is the one intentional Context constructor for Po extension code.\n  const root = new Context();\n  const runtime: PoCordisRuntimeService = Object.freeze({\n    abiVersion: PO_CORDIS_HOST_ABI_VERSION,\n    hostId: `po-cordis:${crypto.randomUUID()}`,\n    generation: `po-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: PoCordisHostController = {\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: PO_CORDIS_HOST_ABI_VERSION,\n    hostId: runtime.hostId,\n    root,\n    runtime,\n    ready,\n    acquire() {\n      if (shutdownPromise) throw new Error(`The Po 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(PO_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: PoCordisSessionService = Object.freeze({\n            sessionId: context.sessionManager.getSessionId(),\n            generation: `${runtime.generation}:${String(sessionGeneration)}`,\n            reason: event.reason,\n            context,\n            environment: readPoSessionEnvironment(context.sessionManager.getSessionId()),\n          });\n          sessionFiber = root.plugin((ctx: Context, value: PoCordisSessionService) => {\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 function connectPoCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<PoCordisHostConnection>;\nexport function connectPoCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options: { readonly optional: true },\n): Promise<PoCordisHostConnection | undefined>;\nexport async function connectPoCordisHost(\n  pi: Pick<ExtensionAPI, 'events'>,\n  source: string,\n  options?: { readonly optional: true },\n): Promise<PoCordisHostConnection | undefined> {\n  const responder = exactlyOneHost(discoverHosts(pi, source), source);\n  if (!responder) {\n    // Vanilla Pi plugins do not install a Po host. Optional discovery permits only\n    // that absence, never an invalid or ambiguous responder.\n    if (options?.optional) return undefined;\n    throw new Error('The composed Po Cordis host is unavailable. Ensure cordisHost is the first extension.');\n  }\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 finalizePoCordisHost(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

@@ -1,24 +1,24 @@
 import { ExtensionAPI, ExtensionContext, SessionStartEvent } from "@earendil-works/pi-coding-agent";
 import { Context } from "@deepseek-ai/cordis";
 //#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 {
+export declare const PO_CORDIS_HOST_ABI_VERSION: 1;
+export declare const PO_CORDIS_HOST_QUERY_CHANNEL = "po:cordis:host:v1:query";
+export declare const PO_CORDIS_RUNTIME_SERVICE = "po/runtime";
+export declare const PO_CORDIS_SESSION_SERVICE = "po/session";
+export declare const PO_CORDIS_SERVER_SERVICES = "po/server-session-services";
+/** Read-only access to services already owned by this session's server packages. */
+export interface PoCordisServerServices {
   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;
+export type PoCordisHostMode = 'composed' | 'standalone';
+export interface PoCordisRuntimeService {
+  readonly abiVersion: typeof PO_CORDIS_HOST_ABI_VERSION;
   readonly hostId: string;
   readonly generation: string;
-  readonly mode: DoomCordisHostMode;
+  readonly mode: PoCordisHostMode;
 }
-export interface DoomCordisSessionService {
+export interface PoCordisSessionService {
   readonly sessionId: string;
   readonly generation: string;
   readonly reason: SessionStartEvent['reason'];
@@ -33,30 +33,30 @@ type SessionEnvironment = Readonly<Record<string, string | undefined>>;
  * The newest registration wins: a reopened session can start before its previous host has
  * finished closing, and that late release must not unbind the new one.
  */
-export declare function registerDoomSessionEnvironment(sessionId: string, environment: SessionEnvironment): () => void;
+export declare function registerPoSessionEnvironment(sessionId: string, environment: SessionEnvironment): () => void;
 /** The session's admitted environment, or `process.env` for a session that owns its process. */
-export declare function readDoomSessionEnvironment(sessionId: string | undefined): SessionEnvironment;
-export declare function requireDoomCordisSession(context: Context): DoomCordisSessionService;
-export interface DoomCordisHostConnection {
+export declare function readPoSessionEnvironment(sessionId: string | undefined): SessionEnvironment;
+export declare function requirePoCordisSession(context: Context): PoCordisSessionService;
+export interface PoCordisHostConnection {
   readonly root: Context;
-  readonly runtime: DoomCordisRuntimeService;
+  readonly runtime: PoCordisRuntimeService;
   /** Releases this consumer's lease. It never disposes a composed host. */
   dispose(): Promise<void>;
 }
-export interface DoomCordisHostController {
+export interface PoCordisHostController {
   readonly root: Context;
-  readonly runtime: DoomCordisRuntimeService;
+  readonly runtime: PoCordisRuntimeService;
   /** Recursively disposes the session and application plugin tree. */
   shutdown(): Promise<void>;
 }
-export interface InstallDoomCordisHostOptions {
-  readonly mode: DoomCordisHostMode;
+export interface InstallPoCordisHostOptions {
+  readonly mode: PoCordisHostMode;
   readonly source?: string;
 }
 declare module '@deepseek-ai/cordis' {
   interface Context {
-    'doom/runtime': DoomCordisRuntimeService;
-    'doom/session': DoomCordisSessionService;
+    'po/runtime': PoCordisRuntimeService;
+    'po/session': PoCordisSessionService;
   }
 }
 /**
@@ -66,13 +66,14 @@ declare module '@deepseek-ai/cordis' {
  * 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>;
+export declare function installPoCordisHost(pi: ExtensionAPI, options: InstallPoCordisHostOptions): Promise<PoCordisHostController>;
 /** Resolves the composed host installed by the canonical runtime. */
-export declare function connectDoomCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<DoomCordisHostConnection>;
-export declare function connectDoomCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string, options: {
+export declare function connectPoCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<PoCordisHostConnection>;
+export declare function connectPoCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string, options: {
   readonly optional: true;
-}): Promise<DoomCordisHostConnection | undefined>;
+}): Promise<PoCordisHostConnection | undefined>;
 /** 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>;
+export declare function finalizePoCordisHost(pi: Pick<ExtensionAPI, 'events'>, source: string): Promise<void>;
 //#endregion
+export {};
 //# sourceMappingURL=runtimeCordisHost.d.mts.map

package/dist/runtimeCordisHost.d.mts.map

@@ -1 +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;;WAET,aAAa,SAAS;;KAG5B,qBAAqB,SAAS;;;;;;;wBAsBnB,+BAA+B,mBAAmB,aAAa;;wBAS/D,2BAA2B,gCAAgC;wBAI3D,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;;wBA0GK,sBACd,IAAI,KAAK,yBACT,iBACC,QAAQ;wBACK,sBACd,IAAI,KAAK,yBACT,gBACA;WAAoB;IACnB,QAAQ;;wBAkBW,uBAAuB,IAAI,KAAK,yBAAyB,iBAAiB"}
+{"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;;WAET,aAAa,SAAS;;KAG5B,qBAAqB,SAAS;;;;;;;wBAsBnB,6BAA6B,mBAAmB,aAAa;;wBAS7D,yBAAyB,gCAAgC;wBAIzD,uBAAuB,SAAS,UAAU;iBAMzC;WACN,MAAM;WACN,SAAS;;EAElB,WAAW;;iBAGI;WACN,MAAM;WACN,SAAS;;EAElB,YAAY;;iBAGG;WACN,MAAM;WACN;;;YAIC;IACR,cAAc;IACd,cAAc;;;;;;;;;;wBA2HI,oBACpB,IAAI,cACJ,SAAS,6BACR,QAAQ;;wBA0GK,oBAAoB,IAAI,KAAK,yBAAyB,iBAAiB,QAAQ;wBAC/E,oBACd,IAAI,KAAK,yBACT,gBACA;WAAoB;IACnB,QAAQ;;wBAkBW,qBAAqB,IAAI,KAAK,yBAAyB,iBAAiB"}

package/dist/runtimeCordisHost.mjs

@@ -1,17 +1,17 @@
-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 { PO_CONTEXT_CONTRIBUTIONS_SERVICE } from "./src/schemas/contextContributions.mjs";
+import { createPoContextContributionsService } from "./src/services/contextContributions/index.mjs";
+import { PO_TOOL_OVERRIDES_SERVICE } from "./src/schemas/toolOverrides.mjs";
+import { PO_TOOL_SURFACE_SERVICE } from "./src/schemas/toolSurface.mjs";
+import { createPoToolOverridesService } from "./src/services/toolOverrides/index.mjs";
+import { createPoToolSurface } 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 PO_CORDIS_HOST_ABI_VERSION = 1;
+const PO_CORDIS_HOST_QUERY_CHANNEL = "po:cordis:host:v1:query";
+const PO_CORDIS_RUNTIME_SERVICE = "po/runtime";
+const PO_CORDIS_SESSION_SERVICE = "po/session";
+const PO_CORDIS_SERVER_SERVICES = "po/server-session-services";
+const HOST_PROTOCOL = "po.cordis.host";
 const DEFAULT_HOST_SOURCE = "@agimon-ai/po/cordis-host";
 /**
 * Admitted environments of sessions sharing this process, by session id.
@@ -20,14 +20,14 @@ const DEFAULT_HOST_SOURCE = "@agimon-ai/po/cordis-host";
 * the server's, not any session's. Held on a global symbol because extension
 * packages can load their own copy of this module.
 */
-const SESSION_ENVIRONMENTS = globalThis[Symbol.for("doom.cordis.session-environments.v1")] ??= /* @__PURE__ */ new Map();
+const SESSION_ENVIRONMENTS = globalThis[Symbol.for("po.cordis.session-environments.v1")] ??= /* @__PURE__ */ new Map();
 /**
 * Binds a session id to its admitted environment until the returned release runs.
 *
 * The newest registration wins: a reopened session can start before its previous host has
 * finished closing, and that late release must not unbind the new one.
 */
-function registerDoomSessionEnvironment(sessionId, environment) {
+function registerPoSessionEnvironment(sessionId, environment) {
 	const registration = { environment };
 	SESSION_ENVIRONMENTS.set(sessionId, registration);
 	return () => {
@@ -35,12 +35,12 @@ function registerDoomSessionEnvironment(sessionId, environment) {
 	};
 }
 /** The session's admitted environment, or `process.env` for a session that owns its process. */
-function readDoomSessionEnvironment(sessionId) {
+function readPoSessionEnvironment(sessionId) {
 	return (sessionId === void 0 ? void 0 : SESSION_ENVIRONMENTS.get(sessionId)?.environment) ?? process.env;
 }
-function requireDoomCordisSession(context) {
-	const session = context.get(DOOM_CORDIS_SESSION_SERVICE);
-	if (!session) throw new Error("Doom Cordis session service is unavailable.");
+function requirePoCordisSession(context) {
+	const session = context.get(PO_CORDIS_SESSION_SERVICE);
+	if (!session) throw new Error("Po Cordis session service is unavailable.");
 	return session;
 }
 function isRecord(value) {
@@ -52,12 +52,12 @@ function asHostQuery(value) {
 	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.");
+	if (!isRecord(value)) throw new Error("The Po Cordis host returned an invalid discovery response.");
+	if (value.protocol !== HOST_PROTOCOL) throw new Error("The Po Cordis host returned an invalid protocol identifier.");
+	if (value.abiVersion !== 1) throw new Error(`The Po 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 Po Cordis host returned an invalid host identifier.");
+	if (!Context.is(value.root)) throw new Error("The Po 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 Po Cordis host returned incomplete runtime metadata.");
 	return value;
 }
 function discoverHosts(pi, source) {
@@ -72,22 +72,22 @@ function discoverHosts(pi, source) {
 			responses.push(asHostResponder(response));
 		}
 	};
-	pi.events.emit(DOOM_CORDIS_HOST_QUERY_CHANNEL, request);
+	pi.events.emit(PO_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}.`);
+	throw new Error(`Multiple Po 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));
+	ctx.provide(PO_CORDIS_RUNTIME_SERVICE, service);
+	ctx.provide(PO_TOOL_OVERRIDES_SERVICE, createPoToolOverridesService(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({
+	ctx.provide(PO_CORDIS_SESSION_SERVICE, service);
+	ctx.provide(PO_CONTEXT_CONTRIBUTIONS_SERVICE, createPoContextContributionsService(service.generation));
+	ctx.provide(PO_TOOL_SURFACE_SERVICE, createPoToolSurface({
 		generation: service.generation,
 		allTools: () => pi.getAllTools().map((tool) => tool.name),
 		activeTools: () => pi.getActiveTools(),
@@ -101,15 +101,15 @@ function sessionProvider(ctx, service, pi) {
 * loaded factories different ExtensionAPI wrapper objects, while their event
 * buses still address the same runner.
 */
-async function installDoomCordisHost(pi, options) {
+async function installPoCordisHost(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}.`);
+	if (existing) throw new Error(`A Po 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()}`,
+		hostId: `po-cordis:${crypto.randomUUID()}`,
+		generation: `po-runtime:${crypto.randomUUID()}`,
 		mode: options.mode
 	});
 	const ready = root.plugin(runtimeProvider, runtime).await().then(() => void 0);
@@ -143,7 +143,7 @@ async function installDoomCordisHost(pi, options) {
 		runtime,
 		ready,
 		acquire() {
-			if (shutdownPromise) throw new Error(`The Doom Cordis host is shutting down: ${runtime.hostId}.`);
+			if (shutdownPromise) throw new Error(`The Po Cordis host is shutting down: ${runtime.hostId}.`);
 			leaseCount += 1;
 			let released = false;
 			return {
@@ -160,7 +160,7 @@ async function installDoomCordisHost(pi, options) {
 		shutdown: () => controller.shutdown()
 	};
 	try {
-		disposeQuerySubscription = pi.events.on(DOOM_CORDIS_HOST_QUERY_CHANNEL, (value) => {
+		disposeQuerySubscription = pi.events.on(PO_CORDIS_HOST_QUERY_CHANNEL, (value) => {
 			const query = asHostQuery(value);
 			if (query) query.accept(responder);
 		});
@@ -174,7 +174,7 @@ async function installDoomCordisHost(pi, options) {
 					generation: `${runtime.generation}:${String(sessionGeneration)}`,
 					reason: event.reason,
 					context,
-					environment: readDoomSessionEnvironment(context.sessionManager.getSessionId())
+					environment: readPoSessionEnvironment(context.sessionManager.getSessionId())
 				});
 				sessionFiber = root.plugin((ctx, value) => {
 					sessionProvider(ctx, value, pi);
@@ -193,20 +193,20 @@ async function installDoomCordisHost(pi, options) {
 	}
 	return controller;
 }
-async function connectDoomCordisHost(pi, source, options) {
+async function connectPoCordisHost(pi, source, options) {
 	const responder = exactlyOneHost(discoverHosts(pi, source), source);
 	if (!responder) {
 		if (options?.optional) return void 0;
-		throw new Error("The composed Doom Cordis host is unavailable. Ensure cordisHost is the first extension.");
+		throw new Error("The composed Po 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) {
+async function finalizePoCordisHost(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, readDoomSessionEnvironment, registerDoomSessionEnvironment, requireDoomCordisSession };
+export { PO_CORDIS_HOST_ABI_VERSION, PO_CORDIS_HOST_QUERY_CHANNEL, PO_CORDIS_RUNTIME_SERVICE, PO_CORDIS_SERVER_SERVICES, PO_CORDIS_SESSION_SERVICE, connectPoCordisHost, finalizePoCordisHost, installPoCordisHost, readPoSessionEnvironment, registerPoSessionEnvironment, requirePoCordisSession };
 
 //# sourceMappingURL=runtimeCordisHost.mjs.map