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

package/dist/notification.mjs

@@ -1,2 +1 @@
-import { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DoomNotificationEntryDataSchema, DoomNotificationLevelSchema, DoomNotificationRequestSchema, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService } from "./src/schemas/notification.mjs";
-export { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DoomNotificationEntryDataSchema, DoomNotificationLevelSchema, DoomNotificationRequestSchema, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService };
+export { MAX_PO_NOTIFICATION_BODY_CHARACTERS, MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_PO_NOTIFICATION_TITLE_CHARACTERS, PO_NOTIFICATION_ENTRY_TYPE, PO_NOTIFICATION_ENTRY_VERSION, PO_NOTIFICATION_SERVICE, PoNotificationEntryDataSchema, PoNotificationLevelSchema, PoNotificationRequestSchema, createPoNotificationEntryData, isPoNotificationEntryData, isPoNotificationRequest, normalizePoNotificationRequest, readPoNotificationService, requirePoNotificationService } from "./src/schemas/notification.mjs";

package/dist/packageApi.cjs

@@ -1,17 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_executionBudget = require("./executionBudget.cjs");
 const require_packageApi = require("./src/schemas/packageApi.cjs");
-exports.DOOM_API_CALLER_DEVICE_ID_HEADER = require_packageApi.DOOM_API_CALLER_DEVICE_ID_HEADER;
-exports.DOOM_API_CALLER_HEADERS = require_packageApi.DOOM_API_CALLER_HEADERS;
-exports.DOOM_API_CALLER_LOCALITY_HEADER = require_packageApi.DOOM_API_CALLER_LOCALITY_HEADER;
-exports.DOOM_API_CALLER_STEP_UP_HEADER = require_packageApi.DOOM_API_CALLER_STEP_UP_HEADER;
-exports.DOOM_API_ROUTE_PREFIX = require_packageApi.DOOM_API_ROUTE_PREFIX;
-exports.DOOM_API_SCOPES = require_packageApi.DOOM_API_SCOPES;
-exports.DOOM_HUB_API_SESSION_QUERY_PARAM = require_packageApi.DOOM_HUB_API_SESSION_QUERY_PARAM;
-exports.DOOM_SHARE_FILE_REMOTE_OFF_MESSAGE = require_packageApi.DOOM_SHARE_FILE_REMOTE_OFF_MESSAGE;
+exports.PO_API_CALLER_DEVICE_ID_HEADER = require_packageApi.PO_API_CALLER_DEVICE_ID_HEADER;
+exports.PO_API_CALLER_HEADERS = require_packageApi.PO_API_CALLER_HEADERS;
+exports.PO_API_CALLER_LOCALITY_HEADER = require_packageApi.PO_API_CALLER_LOCALITY_HEADER;
+exports.PO_API_CALLER_STEP_UP_HEADER = require_packageApi.PO_API_CALLER_STEP_UP_HEADER;
+exports.PO_API_ROUTE_PREFIX = require_packageApi.PO_API_ROUTE_PREFIX;
+exports.PO_API_SCOPES = require_packageApi.PO_API_SCOPES;
+exports.PO_HUB_API_SESSION_QUERY_PARAM = require_packageApi.PO_HUB_API_SESSION_QUERY_PARAM;
+exports.PO_SHARE_FILE_REMOTE_OFF_MESSAGE = require_packageApi.PO_SHARE_FILE_REMOTE_OFF_MESSAGE;
 exports.createExecutionBudget = require_executionBudget.createExecutionBudget;
 exports.createServerExecutionBudget = require_executionBudget.createServerExecutionBudget;
-exports.doomApiCallerFrom = require_packageApi.doomApiCallerFrom;
-exports.doomApiMountPath = require_packageApi.doomApiMountPath;
-exports.parseDoomSocketPath = require_packageApi.parseDoomSocketPath;
+exports.parsePoSocketPath = require_packageApi.parsePoSocketPath;
+exports.poApiCallerFrom = require_packageApi.poApiCallerFrom;
+exports.poApiMountPath = require_packageApi.poApiMountPath;
 exports.sharedExecutionBudget = require_executionBudget.sharedExecutionBudget;

package/dist/packageApi.d.mts

@@ -1,3 +1,3 @@
-import { DOOM_API_CALLER_DEVICE_ID_HEADER, DOOM_API_CALLER_HEADERS, DOOM_API_CALLER_LOCALITY_HEADER, DOOM_API_CALLER_STEP_UP_HEADER, DOOM_API_ROUTE_PREFIX, DOOM_API_SCOPES, DOOM_HUB_API_SESSION_QUERY_PARAM, DOOM_SHARE_FILE_REMOTE_OFF_MESSAGE, DoomApi, DoomApiCaller, DoomApiCallerStepUp, DoomApiContext, DoomApiHandler, DoomApiMount, DoomApiScope, DoomHostExecutionBudget, DoomHostExecutionPermit, DoomHostMediaArbitration, DoomNativeComposition, DoomOAuthRedirect, DoomPeerAgentRegistry, DoomRepositorySyncView, DoomRequestReceipt, DoomRequestReceiptKey, DoomRequestReceiptReservation, DoomRequestReceiptReserveResult, DoomRequestReceipts, DoomSharedFile, DoomSocketMount, DoomWebComposition, doomApiCallerFrom, doomApiMountPath, parseDoomSocketPath } from "./src/schemas/packageApi.mjs";
+import { PO_API_CALLER_DEVICE_ID_HEADER, PO_API_CALLER_HEADERS, PO_API_CALLER_LOCALITY_HEADER, PO_API_CALLER_STEP_UP_HEADER, PO_API_ROUTE_PREFIX, PO_API_SCOPES, PO_HUB_API_SESSION_QUERY_PARAM, PO_SHARE_FILE_REMOTE_OFF_MESSAGE, PoApi, PoApiCaller, PoApiCallerStepUp, PoApiContext, PoApiHandler, PoApiMount, PoApiScope, PoEditPresenceAgent, PoEditPresenceEntry, PoEditPresenceLedger, PoHostExecutionBudget, PoHostExecutionPermit, PoHostMediaArbitration, PoNativeComposition, PoOAuthRedirect, PoPeerAgentRegistry, PoRepositorySyncView, PoRequestReceipt, PoRequestReceiptKey, PoRequestReceiptReservation, PoRequestReceiptReserveResult, PoRequestReceipts, PoSharedFile, PoSocketMount, PoWebComposition, parsePoSocketPath, poApiCallerFrom, poApiMountPath } from "./src/schemas/packageApi.mjs";
 import { createExecutionBudget, createServerExecutionBudget, sharedExecutionBudget } from "./executionBudget.mjs";
-export { DOOM_API_CALLER_DEVICE_ID_HEADER, DOOM_API_CALLER_HEADERS, DOOM_API_CALLER_LOCALITY_HEADER, DOOM_API_CALLER_STEP_UP_HEADER, DOOM_API_ROUTE_PREFIX, DOOM_API_SCOPES, DOOM_HUB_API_SESSION_QUERY_PARAM, DOOM_SHARE_FILE_REMOTE_OFF_MESSAGE, type DoomApi, type DoomApiCaller, type DoomApiCallerStepUp, type DoomApiContext, type DoomApiHandler, type DoomApiMount, type DoomApiScope, type DoomHostExecutionBudget, type DoomHostExecutionPermit, type DoomHostMediaArbitration, type DoomNativeComposition, type DoomOAuthRedirect, type DoomPeerAgentRegistry, type DoomRepositorySyncView, type DoomRequestReceipt, type DoomRequestReceiptKey, type DoomRequestReceiptReservation, type DoomRequestReceiptReserveResult, type DoomRequestReceipts, type DoomSharedFile, type DoomSocketMount, type DoomWebComposition, createExecutionBudget, createServerExecutionBudget, doomApiCallerFrom, doomApiMountPath, parseDoomSocketPath, sharedExecutionBudget };
+export { PO_API_CALLER_DEVICE_ID_HEADER, PO_API_CALLER_HEADERS, PO_API_CALLER_LOCALITY_HEADER, PO_API_CALLER_STEP_UP_HEADER, PO_API_ROUTE_PREFIX, PO_API_SCOPES, PO_HUB_API_SESSION_QUERY_PARAM, PO_SHARE_FILE_REMOTE_OFF_MESSAGE, type PoApi, type PoApiCaller, type PoApiCallerStepUp, type PoApiContext, type PoApiHandler, type PoApiMount, type PoApiScope, type PoEditPresenceAgent, type PoEditPresenceEntry, type PoEditPresenceLedger, type PoHostExecutionBudget, type PoHostExecutionPermit, type PoHostMediaArbitration, type PoNativeComposition, type PoOAuthRedirect, type PoPeerAgentRegistry, type PoRepositorySyncView, type PoRequestReceipt, type PoRequestReceiptKey, type PoRequestReceiptReservation, type PoRequestReceiptReserveResult, type PoRequestReceipts, type PoSharedFile, type PoSocketMount, type PoWebComposition, createExecutionBudget, createServerExecutionBudget, parsePoSocketPath, poApiCallerFrom, poApiMountPath, sharedExecutionBudget };

package/dist/packageApi.mjs

@@ -1,3 +1,3 @@
 import { createExecutionBudget, createServerExecutionBudget, sharedExecutionBudget } from "./executionBudget.mjs";
-import { DOOM_API_CALLER_DEVICE_ID_HEADER, DOOM_API_CALLER_HEADERS, DOOM_API_CALLER_LOCALITY_HEADER, DOOM_API_CALLER_STEP_UP_HEADER, DOOM_API_ROUTE_PREFIX, DOOM_API_SCOPES, DOOM_HUB_API_SESSION_QUERY_PARAM, DOOM_SHARE_FILE_REMOTE_OFF_MESSAGE, doomApiCallerFrom, doomApiMountPath, parseDoomSocketPath } from "./src/schemas/packageApi.mjs";
-export { DOOM_API_CALLER_DEVICE_ID_HEADER, DOOM_API_CALLER_HEADERS, DOOM_API_CALLER_LOCALITY_HEADER, DOOM_API_CALLER_STEP_UP_HEADER, DOOM_API_ROUTE_PREFIX, DOOM_API_SCOPES, DOOM_HUB_API_SESSION_QUERY_PARAM, DOOM_SHARE_FILE_REMOTE_OFF_MESSAGE, createExecutionBudget, createServerExecutionBudget, doomApiCallerFrom, doomApiMountPath, parseDoomSocketPath, sharedExecutionBudget };
+import { PO_API_CALLER_DEVICE_ID_HEADER, PO_API_CALLER_HEADERS, PO_API_CALLER_LOCALITY_HEADER, PO_API_CALLER_STEP_UP_HEADER, PO_API_ROUTE_PREFIX, PO_API_SCOPES, PO_HUB_API_SESSION_QUERY_PARAM, PO_SHARE_FILE_REMOTE_OFF_MESSAGE, parsePoSocketPath, poApiCallerFrom, poApiMountPath } from "./src/schemas/packageApi.mjs";
+export { PO_API_CALLER_DEVICE_ID_HEADER, PO_API_CALLER_HEADERS, PO_API_CALLER_LOCALITY_HEADER, PO_API_CALLER_STEP_UP_HEADER, PO_API_ROUTE_PREFIX, PO_API_SCOPES, PO_HUB_API_SESSION_QUERY_PARAM, PO_SHARE_FILE_REMOTE_OFF_MESSAGE, createExecutionBudget, createServerExecutionBudget, parsePoSocketPath, poApiCallerFrom, poApiMountPath, sharedExecutionBudget };

package/dist/packageApiServer.cjs

@@ -1,11 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_serverTelemetry = require("./serverTelemetry.cjs");
+const require_index = require("./src/services/sessionFiles/index.cjs");
 const require_packageApi = require("./src/schemas/packageApi.cjs");
 require("./packageApi.cjs");
-const require_index = require("./src/services/serverFacet/index.cjs");
-const require_serverFacetLoader = require("./src/server/serverFacetLoader.cjs");
-require("./serverFacet.cjs");
-const require_index$1 = require("./src/services/traceContext/index.cjs");
+const require_index$1 = require("./src/services/serverHost/index.cjs");
+const require_serverScope = require("./src/server/serverScope.cjs");
+require("./serverPlugin.cjs");
+const require_index$2 = require("./src/services/traceContext/index.cjs");
 //#region src/server/packageApiServer.ts
 /**
 * A body that keeps streaming well after its headers went out is worth its own span. A fast
@@ -48,12 +49,17 @@ function responseWithCompletion(response, complete) {
 	});
 	return new Response(body, response);
 }
-/** Installs session facets and dispatches authenticated package API calls in-process. */
+/** Installs session packages and dispatches authenticated package API calls in-process. */
 async function serveSessionApis(options) {
 	if (options.environment === void 0) throw new Error("Session package API server requires an admitted environment.");
 	if (options.directEvents === void 0) throw new Error("Session package API server requires direct events.");
-	const facets = options.facets ?? [];
-	if (options.apis.length === 0 && facets.length === 0 && !options.prepareFacets) return {
+	options = {
+		...options,
+		environment: await require_index.prepareSessionEnvironment(options)
+	};
+	const packages = options.packages ?? [];
+	const routesNothing = () => !options.preparePackages && options.parentScope === void 0;
+	if (options.apis.length === 0 && packages.length === 0 && routesNothing()) return {
 		request: async () => Response.json({ error: "No package APIs are mounted." }, { status: 404 }),
 		close: () => Promise.resolve()
 	};
@@ -84,7 +90,8 @@ async function serveSessionApis(options) {
 		workspaceId: options.workspaceId,
 		workspaceRoot: options.workspaceRoot,
 		...options.sessionContext === void 0 ? {} : { sessionContext: options.sessionContext },
-		homeDirectory: options.homeDirectory,
+		homeDirectory: options.homeDirectory ?? options.platform.homeDirectory,
+		sessionStorage: options.platform.sessions,
 		cwd: options.cwd,
 		environment: options.environment,
 		directEvents: options.directEvents,
@@ -92,6 +99,7 @@ async function serveSessionApis(options) {
 		...options.shareFile === void 0 ? {} : { shareFile: options.shareFile },
 		...options.mediaArbitration === void 0 ? {} : { mediaArbitration: options.mediaArbitration },
 		...options.executionBudget === void 0 ? {} : { executionBudget: options.executionBudget },
+		...options.editPresence === void 0 ? {} : { editPresence: options.editPresence },
 		...options.peerAgents === void 0 ? {} : { peerAgents: options.peerAgents },
 		...options.requestApi === void 0 ? {} : { requestApi: options.requestApi },
 		...options.publishActivity === void 0 ? {} : { publishActivity: options.publishActivity },
@@ -101,34 +109,42 @@ async function serveSessionApis(options) {
 		...communication === void 0 ? {} : { sessionCommunication: communication },
 		onNotice: options.onNotice
 	};
-	const host = require_index.createDoomServerHost({
+	const host = require_index$1.createPoServerHost({
 		scope: "session",
 		context,
 		mountChannel: options.mountChannel,
 		...options.pluginRegistry === void 0 ? {} : { pluginRegistry: options.pluginRegistry }
 	});
-	for (const api of options.apis) host.registerApi(api);
-	let installed;
+	let scope;
 	try {
-		installed = await require_serverFacetLoader.installServerFacets({
+		for (const api of options.apis) host.registerApi(api);
+		scope = await require_serverScope.PoServerScope.open("session", options.parentScope);
+		await scope.serve({
 			host,
-			facets,
+			platform: options.platform
+		});
+		await options.preparePackages?.(scope.root);
+		const installed = await scope.install(packages, {
 			onNotice: options.onNotice,
-			prepare: options.prepareFacets
+			onPackageSettled: (report) => {
+				if (!options.telemetry) return;
+				require_serverTelemetry.observe(options.telemetry.recordEvent("po_server.package_install", {
+					"package.name": report.packageName,
+					"package.outcome": report.outcome,
+					duration_ms: report.durationMs,
+					scope: "session"
+				}), options.onNotice);
+			}
 		});
-		try {
-			await options.activateFacets?.(installed);
-		} catch (error) {
-			await installed.dispose();
-			throw error;
-		}
+		await options.activatePackages?.(installed);
 	} catch (error) {
+		await scope?.dispose();
 		communication?.close();
 		host.dispose();
 		throw error;
 	}
-	if (host.mounted().length === 0 && !options.prepareFacets) {
-		await installed.dispose();
+	if (host.mounted().length === 0 && routesNothing()) {
+		await scope.dispose();
 		communication?.close();
 		host.dispose();
 		return {
@@ -136,23 +152,24 @@ async function serveSessionApis(options) {
 			close: () => Promise.resolve()
 		};
 	}
+	const sessionScope = scope;
 	const dispatch = async (request) => {
 		if (options.canDispatch?.() === false) return Response.json({ error: "Session selection is not ready." }, { status: 503 });
 		const url = new URL(request.url);
 		if (!url.pathname.startsWith(`/api/plugins/`)) return Response.json({ error: "Not found." }, { status: 404 });
-		const rest = url.pathname.slice(require_packageApi.DOOM_API_ROUTE_PREFIX.length + 1);
+		const rest = url.pathname.slice(require_packageApi.PO_API_ROUTE_PREFIX.length + 1);
 		const slash = rest.indexOf("/");
 		const basePath = slash === -1 ? rest : rest.slice(0, slash);
-		const handler = host.handlerFor(basePath);
+		const handler = sessionScope.apiHandler(basePath);
 		if (handler === void 0) return Response.json({ error: `No API '${basePath}' in this session.` }, { status: 404 });
 		url.pathname = slash === -1 ? "/" : rest.slice(slash);
 		const startedAt = performance.now();
-		const parent = require_index$1.validatedTraceContext(request.headers.get("traceparent"));
+		const parent = require_index$2.validatedTraceContext(request.headers.get("traceparent"));
 		let childContext;
 		let response;
 		try {
 			const invoke = async (context) => {
-				if (options.canDispatch?.() === false || host.handlerFor(basePath) !== handler) return Response.json({ error: "Session selection changed before dispatch." }, { status: 503 });
+				if (options.canDispatch?.() === false || sessionScope.apiHandler(basePath) !== handler) return Response.json({ error: "Session selection changed before dispatch." }, { status: 503 });
 				childContext = context;
 				return handler.fetch(new Request(url, request));
 			};
@@ -161,6 +178,7 @@ async function serveSessionApis(options) {
 				method: request.method
 			}, invoke, parent) : await invoke();
 		} catch (error) {
+			if (request.signal.aborted) return new Response(null, { status: 499 });
 			options.onNotice(`package API '${basePath}' failed on ${url.pathname} (${describeError(error)})`);
 			response = Response.json({ error: `The '${basePath}' API failed.` }, { status: 500 });
 		}
@@ -181,7 +199,7 @@ async function serveSessionApis(options) {
 		request: dispatch,
 		close: () => {
 			closePromise ??= (async () => {
-				await installed.dispose();
+				await scope.dispose();
 				communication?.close();
 				host.dispose();
 			})();

package/dist/packageApiServer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"packageApiServer.cjs","names":["createDoomServerHost","installServerFacets","DOOM_API_ROUTE_PREFIX","validatedTraceContext"],"sources":["../src/server/packageApiServer.ts"],"sourcesContent":["import type { DoomTraceContext } from '@agimon-ai/po-telemetry';\n\nimport type { DoomDirectEventBus, DoomHubSessionPromptOptions, DoomHubSessionService } from '../exports/hubChannel';\nimport { DOOM_API_ROUTE_PREFIX, type DoomApi, type DoomApiContext } from '../exports/packageApi';\nimport type { DoomPluginRegistry } from '../exports/pluginProtocol';\nimport { createDoomServerHost, type CreateDoomServerHostOptions, type DoomServerFacet } from '../exports/serverFacet';\nimport {\n  installServerFacets,\n  type LoadedServerFacet,\n  type InstalledServerFacets,\n  type InstallServerFacetsOptions,\n} from '../exports/serverFacet';\nimport { observe, type ServerTelemetry } from '../services/serverTelemetry';\nimport { validatedTraceContext } from '../services/traceContext';\n\n/**\n * A body that keeps streaming well after its headers went out is worth its own span. A fast\n * one is not: the request span already carries the duration and outcome, so emitting a second\n * span per call made package API traffic 99.65% of all spans recorded in a two hour sample.\n */\nexport const COMPLETION_SPAN_MIN_DURATION_MS = 1000;\n\nexport interface PackageApiServerOptions {\n  sessionId: string;\n  workspaceId?: string;\n  workspaceRoot?: string;\n  sessionContext?: DoomApiContext['sessionContext'];\n  homeDirectory?: string;\n  mountChannel?: CreateDoomServerHostOptions['mountChannel'];\n  cwd: string;\n  /** Admitted environment for APIs serving this session. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  /** Lifecycle-owned direct events shared with the hub. */\n  readonly directEvents: DoomDirectEventBus;\n  readonly computerUse?: DoomApiContext['computerUse'];\n  /** Bound to this session's id and cwd by the host. */\n  readonly shareFile?: DoomApiContext['shareFile'];\n  readonly mediaArbitration?: DoomApiContext['mediaArbitration'];\n  readonly executionBudget?: DoomApiContext['executionBudget'];\n  readonly peerAgents?: DoomApiContext['peerAgents'];\n  readonly requestApi?: DoomApiContext['requestApi'];\n  /** Publishes this session's activity line through the hub; bound to this session only. */\n  readonly publishActivity?: DoomApiContext['publishActivity'];\n  internalToken?: string;\n  hubToken?: string;\n  /** Shared exact-scope dispatch table, so session facets can mount plugin methods. */\n  pluginRegistry?: DoomPluginRegistry;\n  sessionService?: DoomHubSessionService;\n  apis: readonly DoomApi[];\n  /** Server facets to install; each registers its own APIs through the host. */\n  facets?: readonly (DoomServerFacet | LoadedServerFacet)[];\n  prepareFacets?: InstallServerFacetsOptions['prepare'];\n  activateFacets?: (installed: InstalledServerFacets) => Promise<void>;\n  canDispatch?: () => boolean;\n  telemetry?: ServerTelemetry;\n  onNotice: (message: string) => void;\n}\n\nexport interface PackageApiServer {\n  /** Dispatches an already-authenticated request without crossing a transport boundary. */\n  readonly request: (request: Request) => Promise<Response>;\n  close(): Promise<void>;\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction responseWithCompletion(response: Response, complete: () => void): Response {\n  if (response.body === null) {\n    complete();\n    return response;\n  }\n  const reader = response.body.getReader();\n  let completed = false;\n  const finish = (): void => {\n    if (completed) return;\n    completed = true;\n    complete();\n  };\n  const body = new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const result = await reader.read();\n        if (result.done) {\n          finish();\n          controller.close();\n        } else controller.enqueue(result.value);\n      } catch (error) {\n        finish();\n        controller.error(error);\n      }\n    },\n    async cancel(reason) {\n      finish();\n      await reader.cancel(reason);\n    },\n  });\n  return new Response(body, response);\n}\n\n/** Installs session facets and dispatches authenticated package API calls in-process. */\nexport async function serveSessionApis(options: PackageApiServerOptions): Promise<PackageApiServer> {\n  if (options.environment === undefined)\n    throw new Error('Session package API server requires an admitted environment.');\n  if (options.directEvents === undefined) throw new Error('Session package API server requires direct events.');\n  const facets = options.facets ?? [];\n  if (options.apis.length === 0 && facets.length === 0 && !options.prepareFacets) {\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n\n  const owningSessionService = options.sessionService;\n  const communication = owningSessionService?.bindCommunication?.(options.sessionId);\n  const ownedReadExecutionState = owningSessionService?.readExecutionState?.bind(owningSessionService);\n  const ownedPrompt = owningSessionService?.prompt?.bind(owningSessionService);\n  const ownedAbort = owningSessionService?.abort?.bind(owningSessionService);\n  const ownedSteer = owningSessionService?.steer?.bind(owningSessionService);\n  const ownedRelease = owningSessionService?.release?.bind(owningSessionService);\n  const exposedSessionService: DoomHubSessionService | undefined =\n    owningSessionService === undefined\n      ? undefined\n      : {\n          create: (request) => owningSessionService.create(request),\n          close: (sessionId) => owningSessionService.close(sessionId),\n          isLive: (sessionId) => owningSessionService.isLive(sessionId),\n          ...(ownedReadExecutionState === undefined\n            ? {}\n            : {\n                readExecutionState: (sessionId: string) =>\n                  ownedReadExecutionState(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          // A session may drive only the children it started, never its parent or a sibling.\n          ...(ownedPrompt === undefined\n            ? {}\n            : {\n                prompt: (sessionId: string, text: string, promptOptions?: DoomHubSessionPromptOptions) =>\n                  ownedPrompt(sessionId, text, {\n                    ...(promptOptions?.signal === undefined ? {} : { signal: promptOptions.signal }),\n                    parentSessionId: options.sessionId,\n                  }),\n              }),\n          ...(ownedAbort === undefined\n            ? {}\n            : {\n                abort: (sessionId: string) => ownedAbort(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedSteer === undefined\n            ? {}\n            : {\n                steer: (sessionId: string, message: string) =>\n                  ownedSteer(sessionId, message, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedRelease === undefined\n            ? {}\n            : {\n                release: (sessionId: string) => ownedRelease(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(owningSessionService.canCommunicate === undefined\n            ? {}\n            : {\n                canCommunicate: (sourceSessionId: string, targetSessionId: string) =>\n                  owningSessionService.canCommunicate?.(sourceSessionId, targetSessionId) === true,\n              }),\n        };\n  const context: DoomApiContext = {\n    scope: 'session',\n    sessionId: options.sessionId,\n    workspaceId: options.workspaceId,\n    workspaceRoot: options.workspaceRoot,\n    ...(options.sessionContext === undefined ? {} : { sessionContext: options.sessionContext }),\n    homeDirectory: options.homeDirectory,\n    cwd: options.cwd,\n    environment: options.environment,\n    directEvents: options.directEvents,\n    ...(options.computerUse === undefined ? {} : { computerUse: options.computerUse }),\n    ...(options.shareFile === undefined ? {} : { shareFile: options.shareFile }),\n    ...(options.mediaArbitration === undefined ? {} : { mediaArbitration: options.mediaArbitration }),\n    ...(options.executionBudget === undefined ? {} : { executionBudget: options.executionBudget }),\n    ...(options.peerAgents === undefined ? {} : { peerAgents: options.peerAgents }),\n    ...(options.requestApi === undefined ? {} : { requestApi: options.requestApi }),\n    ...(options.publishActivity === undefined ? {} : { publishActivity: options.publishActivity }),\n    ...(options.internalToken === undefined ? {} : { internalToken: options.internalToken }),\n    ...(options.hubToken === undefined ? {} : { hubToken: options.hubToken }),\n    ...(exposedSessionService === undefined ? {} : { sessionService: exposedSessionService }),\n    ...(communication === undefined ? {} : { sessionCommunication: communication }),\n    onNotice: options.onNotice,\n  };\n  const host = createDoomServerHost({\n    scope: 'session',\n    context,\n    mountChannel: options.mountChannel,\n    ...(options.pluginRegistry === undefined ? {} : { pluginRegistry: options.pluginRegistry }),\n  });\n  for (const api of options.apis) host.registerApi(api);\n  let installed: InstalledServerFacets;\n  try {\n    installed = await installServerFacets({ host, facets, onNotice: options.onNotice, prepare: options.prepareFacets });\n    try {\n      await options.activateFacets?.(installed);\n    } catch (error) {\n      await installed.dispose();\n      throw error;\n    }\n  } catch (error) {\n    communication?.close();\n    host.dispose();\n    throw error;\n  }\n  if (host.mounted().length === 0 && !options.prepareFacets) {\n    await installed.dispose();\n    communication?.close();\n    host.dispose();\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n\n  const dispatch = async (request: Request): Promise<Response> => {\n    if (options.canDispatch?.() === false)\n      return Response.json({ error: 'Session selection is not ready.' }, { status: 503 });\n    const url = new URL(request.url);\n    if (!url.pathname.startsWith(`${DOOM_API_ROUTE_PREFIX}/`))\n      return Response.json({ error: 'Not found.' }, { status: 404 });\n    const rest = url.pathname.slice(DOOM_API_ROUTE_PREFIX.length + 1);\n    const slash = rest.indexOf('/');\n    const basePath = slash === -1 ? rest : rest.slice(0, slash);\n    const handler = host.handlerFor(basePath);\n    if (handler === undefined)\n      return Response.json({ error: `No API '${basePath}' in this session.` }, { status: 404 });\n    url.pathname = slash === -1 ? '/' : rest.slice(slash);\n    const startedAt = performance.now();\n    const parent = validatedTraceContext(request.headers.get('traceparent'));\n    let childContext: DoomTraceContext | undefined;\n    let response: Response;\n    try {\n      const invoke = async (context?: DoomTraceContext): Promise<Response> => {\n        if (options.canDispatch?.() === false || host.handlerFor(basePath) !== handler) {\n          return Response.json({ error: 'Session selection changed before dispatch.' }, { status: 503 });\n        }\n        childContext = context;\n        return handler.fetch(new Request(url, request));\n      };\n      response = options.telemetry\n        ? await options.telemetry.runInSpan(\n            'po_server.package_api.request',\n            { api: basePath, method: request.method },\n            invoke,\n            parent,\n          )\n        : await invoke();\n    } catch (error) {\n      options.onNotice(`package API '${basePath}' failed on ${url.pathname} (${describeError(error)})`);\n      response = Response.json({ error: `The '${basePath}' API failed.` }, { status: 500 });\n    }\n    return responseWithCompletion(response, () => {\n      if (!options.telemetry) return;\n      const durationMs = Math.round(performance.now() - startedAt);\n      // Keep this span only where it says something the request span cannot: a failing status,\n      // or a body that took real time to flush after the headers were sent.\n      if (response.status < 400 && durationMs < COMPLETION_SPAN_MIN_DURATION_MS) return;\n      observe(\n        options.telemetry.runInSpan(\n          'po_server.package_api.complete',\n          {\n            api: basePath,\n            method: request.method,\n            status_code: response.status,\n            duration_ms: durationMs,\n          },\n          async () => undefined,\n          childContext ?? parent,\n        ),\n        options.onNotice,\n      );\n    });\n  };\n  let closePromise: Promise<void> | undefined;\n\n  return {\n    request: dispatch,\n    close: () => {\n      closePromise ??= (async () => {\n        await installed.dispose();\n        communication?.close();\n        host.dispose();\n      })();\n      return closePromise;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"packageApiServer.cjs","names":["prepareSessionEnvironment","createPoServerHost","PoServerScope","PO_API_ROUTE_PREFIX","validatedTraceContext"],"sources":["../src/server/packageApiServer.ts"],"sourcesContent":["import type { PoTraceContext } from '@agimon-ai/po-telemetry';\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport type { PoDirectEventBus, PoHubSessionPromptOptions, PoHubSessionService } from '../exports/hubChannel';\nimport { PO_API_ROUTE_PREFIX, type PoApi, type PoApiContext } from '../exports/packageApi';\nimport type { PoPlatform } from '../exports/platform';\nimport type { PoPluginRegistry } from '../exports/pluginProtocol';\nimport {\n  createPoServerHost,\n  type CreatePoServerHostOptions,\n  type LoadedServerPackage,\n  type PoServerPlugin,\n  PoServerScope,\n} from '../exports/serverPlugin';\nimport { observe, type ServerTelemetry } from '../services/serverTelemetry';\nimport { prepareSessionEnvironment } from '../services/sessionFiles';\nimport { validatedTraceContext } from '../services/traceContext';\n\n/**\n * A body that keeps streaming well after its headers went out is worth its own span. A fast\n * one is not: the request span already carries the duration and outcome, so emitting a second\n * span per call made package API traffic 99.65% of all spans recorded in a two hour sample.\n */\nexport const COMPLETION_SPAN_MIN_DURATION_MS = 1000;\n\nexport interface PackageApiServerOptions {\n  sessionId: string;\n  workspaceId?: string;\n  workspaceRoot?: string;\n  sessionContext?: PoApiContext['sessionContext'];\n  homeDirectory?: string;\n  mountChannel?: CreatePoServerHostOptions['mountChannel'];\n  cwd: string;\n  /** Admitted environment for APIs serving this session. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  /** Lifecycle-owned direct events shared with the hub. */\n  readonly directEvents: PoDirectEventBus;\n  readonly computerUse?: PoApiContext['computerUse'];\n  /** Bound to this session's id and cwd by the host. */\n  readonly shareFile?: PoApiContext['shareFile'];\n  readonly mediaArbitration?: PoApiContext['mediaArbitration'];\n  readonly executionBudget?: PoApiContext['executionBudget'];\n  readonly editPresence?: PoApiContext['editPresence'];\n  readonly peerAgents?: PoApiContext['peerAgents'];\n  readonly requestApi?: PoApiContext['requestApi'];\n  /** Publishes this session's activity line through the hub; bound to this session only. */\n  readonly publishActivity?: PoApiContext['publishActivity'];\n  internalToken?: string;\n  hubToken?: string;\n  /** Shared exact-scope dispatch table, so session packages can mount plugin methods. */\n  pluginRegistry?: PoPluginRegistry;\n  sessionService?: PoHubSessionService;\n  apis: readonly PoApi[];\n  /** Server packages to install; each registers its own APIs through the host. */\n  packages?: readonly (PoServerPlugin | LoadedServerPackage)[];\n  /** Publishes the session's own services into its scope root before any package installs. */\n  preparePackages?: (root: Context) => void | Promise<void>;\n  /** The hub's workspace or global scope; the session's own scope opens below it and closes with it. */\n  parentScope?: PoServerScope;\n  /** Host capabilities for the session scope root, injected by the composition root. */\n  platform: PoPlatform;\n  activatePackages?: (installedPackages: readonly string[]) => Promise<void>;\n  canDispatch?: () => boolean;\n  telemetry?: ServerTelemetry;\n  onNotice: (message: string) => void;\n}\n\nexport interface PackageApiServer {\n  /** Dispatches an already-authenticated request without crossing a transport boundary. */\n  readonly request: (request: Request) => Promise<Response>;\n  close(): Promise<void>;\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction responseWithCompletion(response: Response, complete: () => void): Response {\n  if (response.body === null) {\n    complete();\n    return response;\n  }\n  const reader = response.body.getReader();\n  let completed = false;\n  const finish = (): void => {\n    if (completed) return;\n    completed = true;\n    complete();\n  };\n  const body = new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const result = await reader.read();\n        if (result.done) {\n          finish();\n          controller.close();\n        } else controller.enqueue(result.value);\n      } catch (error) {\n        finish();\n        controller.error(error);\n      }\n    },\n    async cancel(reason) {\n      finish();\n      await reader.cancel(reason);\n    },\n  });\n  return new Response(body, response);\n}\n\n/** Installs session packages and dispatches authenticated package API calls in-process. */\nexport async function serveSessionApis(options: PackageApiServerOptions): Promise<PackageApiServer> {\n  if (options.environment === undefined)\n    throw new Error('Session package API server requires an admitted environment.');\n  if (options.directEvents === undefined) throw new Error('Session package API server requires direct events.');\n  options = { ...options, environment: await prepareSessionEnvironment(options) };\n  const packages = options.packages ?? [];\n  // Without a level above it, a session that mounts nothing has nothing to route.\n  const routesNothing = (): boolean => !options.preparePackages && options.parentScope === undefined;\n  if (options.apis.length === 0 && packages.length === 0 && routesNothing()) {\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n\n  const owningSessionService = options.sessionService;\n  const communication = owningSessionService?.bindCommunication?.(options.sessionId);\n  const ownedReadExecutionState = owningSessionService?.readExecutionState?.bind(owningSessionService);\n  const ownedPrompt = owningSessionService?.prompt?.bind(owningSessionService);\n  const ownedAbort = owningSessionService?.abort?.bind(owningSessionService);\n  const ownedSteer = owningSessionService?.steer?.bind(owningSessionService);\n  const ownedRelease = owningSessionService?.release?.bind(owningSessionService);\n  const exposedSessionService: PoHubSessionService | undefined =\n    owningSessionService === undefined\n      ? undefined\n      : {\n          create: (request) => owningSessionService.create(request),\n          close: (sessionId) => owningSessionService.close(sessionId),\n          isLive: (sessionId) => owningSessionService.isLive(sessionId),\n          ...(ownedReadExecutionState === undefined\n            ? {}\n            : {\n                readExecutionState: (sessionId: string) =>\n                  ownedReadExecutionState(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          // A session may drive only the children it started, never its parent or a sibling.\n          ...(ownedPrompt === undefined\n            ? {}\n            : {\n                prompt: (sessionId: string, text: string, promptOptions?: PoHubSessionPromptOptions) =>\n                  ownedPrompt(sessionId, text, {\n                    ...(promptOptions?.signal === undefined ? {} : { signal: promptOptions.signal }),\n                    parentSessionId: options.sessionId,\n                  }),\n              }),\n          ...(ownedAbort === undefined\n            ? {}\n            : {\n                abort: (sessionId: string) => ownedAbort(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedSteer === undefined\n            ? {}\n            : {\n                steer: (sessionId: string, message: string) =>\n                  ownedSteer(sessionId, message, { parentSessionId: options.sessionId }),\n              }),\n          ...(ownedRelease === undefined\n            ? {}\n            : {\n                release: (sessionId: string) => ownedRelease(sessionId, { parentSessionId: options.sessionId }),\n              }),\n          ...(owningSessionService.canCommunicate === undefined\n            ? {}\n            : {\n                canCommunicate: (sourceSessionId: string, targetSessionId: string) =>\n                  owningSessionService.canCommunicate?.(sourceSessionId, targetSessionId) === true,\n              }),\n        };\n  const context: PoApiContext = {\n    scope: 'session',\n    sessionId: options.sessionId,\n    workspaceId: options.workspaceId,\n    workspaceRoot: options.workspaceRoot,\n    ...(options.sessionContext === undefined ? {} : { sessionContext: options.sessionContext }),\n    homeDirectory: options.homeDirectory ?? options.platform.homeDirectory,\n    sessionStorage: options.platform.sessions,\n    cwd: options.cwd,\n    environment: options.environment,\n    directEvents: options.directEvents,\n    ...(options.computerUse === undefined ? {} : { computerUse: options.computerUse }),\n    ...(options.shareFile === undefined ? {} : { shareFile: options.shareFile }),\n    ...(options.mediaArbitration === undefined ? {} : { mediaArbitration: options.mediaArbitration }),\n    ...(options.executionBudget === undefined ? {} : { executionBudget: options.executionBudget }),\n    ...(options.editPresence === undefined ? {} : { editPresence: options.editPresence }),\n    ...(options.peerAgents === undefined ? {} : { peerAgents: options.peerAgents }),\n    ...(options.requestApi === undefined ? {} : { requestApi: options.requestApi }),\n    ...(options.publishActivity === undefined ? {} : { publishActivity: options.publishActivity }),\n    ...(options.internalToken === undefined ? {} : { internalToken: options.internalToken }),\n    ...(options.hubToken === undefined ? {} : { hubToken: options.hubToken }),\n    ...(exposedSessionService === undefined ? {} : { sessionService: exposedSessionService }),\n    ...(communication === undefined ? {} : { sessionCommunication: communication }),\n    onNotice: options.onNotice,\n  };\n  const host = createPoServerHost({\n    scope: 'session',\n    context,\n    mountChannel: options.mountChannel,\n    ...(options.pluginRegistry === undefined ? {} : { pluginRegistry: options.pluginRegistry }),\n  });\n  let scope: PoServerScope | undefined;\n  try {\n    for (const api of options.apis) host.registerApi(api);\n    // The session's own level of the server IoC tree; it closes with the hub level it opens below.\n    scope = await PoServerScope.open('session', options.parentScope);\n    await scope.serve({ host, platform: options.platform });\n    await options.preparePackages?.(scope.root);\n    const installed = await scope.install(packages, {\n      onNotice: options.onNotice,\n      onPackageSettled: (report) => {\n        if (!options.telemetry) return;\n        observe(\n          options.telemetry.recordEvent('po_server.package_install', {\n            'package.name': report.packageName,\n            'package.outcome': report.outcome,\n            duration_ms: report.durationMs,\n            scope: 'session',\n          }),\n          options.onNotice,\n        );\n      },\n    });\n    await options.activatePackages?.(installed);\n  } catch (error) {\n    await scope?.dispose();\n    communication?.close();\n    host.dispose();\n    throw error;\n  }\n  if (host.mounted().length === 0 && routesNothing()) {\n    await scope.dispose();\n    communication?.close();\n    host.dispose();\n    return {\n      request: async () => Response.json({ error: 'No package APIs are mounted.' }, { status: 404 }),\n      close: () => Promise.resolve(),\n    };\n  }\n  const sessionScope = scope;\n\n  const dispatch = async (request: Request): Promise<Response> => {\n    if (options.canDispatch?.() === false)\n      return Response.json({ error: 'Session selection is not ready.' }, { status: 503 });\n    const url = new URL(request.url);\n    if (!url.pathname.startsWith(`${PO_API_ROUTE_PREFIX}/`))\n      return Response.json({ error: 'Not found.' }, { status: 404 });\n    const rest = url.pathname.slice(PO_API_ROUTE_PREFIX.length + 1);\n    const slash = rest.indexOf('/');\n    const basePath = slash === -1 ? rest : rest.slice(0, slash);\n    // The session's own API, else the nearest level above it that serves one.\n    const handler = sessionScope.apiHandler(basePath);\n    if (handler === undefined)\n      return Response.json({ error: `No API '${basePath}' in this session.` }, { status: 404 });\n    url.pathname = slash === -1 ? '/' : rest.slice(slash);\n    const startedAt = performance.now();\n    const parent = validatedTraceContext(request.headers.get('traceparent'));\n    let childContext: PoTraceContext | undefined;\n    let response: Response;\n    try {\n      const invoke = async (context?: PoTraceContext): Promise<Response> => {\n        if (options.canDispatch?.() === false || sessionScope.apiHandler(basePath) !== handler) {\n          return Response.json({ error: 'Session selection changed before dispatch.' }, { status: 503 });\n        }\n        childContext = context;\n        return handler.fetch(new Request(url, request));\n      };\n      response = options.telemetry\n        ? await options.telemetry.runInSpan(\n            'po_server.package_api.request',\n            { api: basePath, method: request.method },\n            invoke,\n            parent,\n          )\n        : await invoke();\n    } catch (error) {\n      if (request.signal.aborted) return new Response(null, { status: 499 });\n      options.onNotice(`package API '${basePath}' failed on ${url.pathname} (${describeError(error)})`);\n      response = Response.json({ error: `The '${basePath}' API failed.` }, { status: 500 });\n    }\n    return responseWithCompletion(response, () => {\n      if (!options.telemetry) return;\n      const durationMs = Math.round(performance.now() - startedAt);\n      // Keep this span only where it says something the request span cannot: a failing status,\n      // or a body that took real time to flush after the headers were sent.\n      if (response.status < 400 && durationMs < COMPLETION_SPAN_MIN_DURATION_MS) return;\n      observe(\n        options.telemetry.runInSpan(\n          'po_server.package_api.complete',\n          {\n            api: basePath,\n            method: request.method,\n            status_code: response.status,\n            duration_ms: durationMs,\n          },\n          async () => undefined,\n          childContext ?? parent,\n        ),\n        options.onNotice,\n      );\n    });\n  };\n  let closePromise: Promise<void> | undefined;\n\n  return {\n    request: dispatch,\n    close: () => {\n      closePromise ??= (async () => {\n        await scope.dispose();\n        communication?.close();\n        host.dispose();\n      })();\n      return closePromise;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/packageApiServer.d.mts

@@ -1,14 +1,18 @@
-import { DoomDirectEventBus, DoomHubSessionService } from "./src/schemas/hubChannel.mjs";
-import { DoomApi, DoomApiContext } from "./src/schemas/packageApi.mjs";
-import { DoomPluginRegistry } from "./src/schemas/pluginProtocol.mjs";
-import { DoomServerFacet } from "./src/schemas/serverFacet.mjs";
+import { PoPlatform } from "./src/schemas/platform.mjs";
+import { PoDirectEventBus, PoHubSessionService } from "./src/schemas/hubChannel.mjs";
+import { PoApi, PoApiContext } from "./src/schemas/packageApi.mjs";
+import { PoPluginRegistry } from "./src/schemas/pluginProtocol.mjs";
+import { PoServerPlugin } from "./src/schemas/serverPlugin.mjs";
 import "./hubChannel.mjs";
-import { CreateDoomServerHostOptions } from "./src/services/serverFacet/index.mjs";
-import { InstallServerFacetsOptions, InstalledServerFacets, LoadedServerFacet } from "./src/server/serverFacetLoader.mjs";
-import "./serverFacet.mjs";
+import { CreatePoServerHostOptions } from "./src/services/serverHost/index.mjs";
+import { LoadedServerPackage } from "./src/server/serverPackages.mjs";
+import { PoServerScope } from "./src/server/serverScope.mjs";
+import "./serverPlugin.mjs";
 import "./packageApi.mjs";
 import { ServerTelemetry } from "./serverTelemetry.mjs";
+import "./platform.mjs";
 import "./pluginProtocol.mjs";
+import { Context } from "@deepseek-ai/cordis";
 //#region src/server/packageApiServer.d.ts
 /**
  * A body that keeps streaming well after its headers went out is worth its own span. A fast
@@ -20,33 +24,39 @@ export interface PackageApiServerOptions {
   sessionId: string;
   workspaceId?: string;
   workspaceRoot?: string;
-  sessionContext?: DoomApiContext['sessionContext'];
+  sessionContext?: PoApiContext['sessionContext'];
   homeDirectory?: string;
-  mountChannel?: CreateDoomServerHostOptions['mountChannel'];
+  mountChannel?: CreatePoServerHostOptions['mountChannel'];
   cwd: string;
   /** Admitted environment for APIs serving this session. */
   readonly environment: Readonly<Record<string, string | undefined>>;
   /** Lifecycle-owned direct events shared with the hub. */
-  readonly directEvents: DoomDirectEventBus;
-  readonly computerUse?: DoomApiContext['computerUse'];
+  readonly directEvents: PoDirectEventBus;
+  readonly computerUse?: PoApiContext['computerUse'];
   /** Bound to this session's id and cwd by the host. */
-  readonly shareFile?: DoomApiContext['shareFile'];
-  readonly mediaArbitration?: DoomApiContext['mediaArbitration'];
-  readonly executionBudget?: DoomApiContext['executionBudget'];
-  readonly peerAgents?: DoomApiContext['peerAgents'];
-  readonly requestApi?: DoomApiContext['requestApi'];
+  readonly shareFile?: PoApiContext['shareFile'];
+  readonly mediaArbitration?: PoApiContext['mediaArbitration'];
+  readonly executionBudget?: PoApiContext['executionBudget'];
+  readonly editPresence?: PoApiContext['editPresence'];
+  readonly peerAgents?: PoApiContext['peerAgents'];
+  readonly requestApi?: PoApiContext['requestApi'];
   /** Publishes this session's activity line through the hub; bound to this session only. */
-  readonly publishActivity?: DoomApiContext['publishActivity'];
+  readonly publishActivity?: PoApiContext['publishActivity'];
   internalToken?: string;
   hubToken?: string;
-  /** Shared exact-scope dispatch table, so session facets can mount plugin methods. */
-  pluginRegistry?: DoomPluginRegistry;
-  sessionService?: DoomHubSessionService;
-  apis: readonly DoomApi[];
-  /** Server facets to install; each registers its own APIs through the host. */
-  facets?: readonly (DoomServerFacet | LoadedServerFacet)[];
-  prepareFacets?: InstallServerFacetsOptions['prepare'];
-  activateFacets?: (installed: InstalledServerFacets) => Promise<void>;
+  /** Shared exact-scope dispatch table, so session packages can mount plugin methods. */
+  pluginRegistry?: PoPluginRegistry;
+  sessionService?: PoHubSessionService;
+  apis: readonly PoApi[];
+  /** Server packages to install; each registers its own APIs through the host. */
+  packages?: readonly (PoServerPlugin | LoadedServerPackage)[];
+  /** Publishes the session's own services into its scope root before any package installs. */
+  preparePackages?: (root: Context) => void | Promise<void>;
+  /** The hub's workspace or global scope; the session's own scope opens below it and closes with it. */
+  parentScope?: PoServerScope;
+  /** Host capabilities for the session scope root, injected by the composition root. */
+  platform: PoPlatform;
+  activatePackages?: (installedPackages: readonly string[]) => Promise<void>;
   canDispatch?: () => boolean;
   telemetry?: ServerTelemetry;
   onNotice: (message: string) => void;
@@ -56,7 +66,7 @@ export interface PackageApiServer {
   readonly request: (request: Request) => Promise<Response>;
   close(): Promise<void>;
 }
-/** Installs session facets and dispatches authenticated package API calls in-process. */
+/** Installs session packages and dispatches authenticated package API calls in-process. */
 export declare function serveSessionApis(options: PackageApiServerOptions): Promise<PackageApiServer>;
 //#endregion
 //# sourceMappingURL=packageApiServer.d.mts.map

package/dist/packageApiServer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"packageApiServer.d.mts","names":[],"sources":["../src/server/packageApiServer.ts"],"mappings":";;;;;;;;;;;;;;;;;qBAoBa;iBAEI;EACf;EACA;EACA;EACA,iBAAiB;EACjB;EACA,eAAe;EACf;;WAES,aAAa,SAAS;;WAEtB,cAAc;WACd,cAAc;;WAEd,YAAY;WACZ,mBAAmB;WACnB,kBAAkB;WAClB,aAAa;WACb,aAAa;;WAEb,kBAAkB;EAC3B;EACA;;EAEA,iBAAiB;EACjB,iBAAiB;EACjB,eAAe;;EAEf,mBAAmB,kBAAkB;EACrC,gBAAgB;EAChB,kBAAkB,WAAW,0BAA0B;EACvD;EACA,YAAY;EACZ,WAAW;;iBAGI;;WAEN,UAAU,SAAS,YAAY,QAAQ;EAChD,SAAS;;;wBAyCW,iBAAiB,SAAS,0BAA0B,QAAQ"}
+{"version":3,"file":"packageApiServer.d.mts","names":[],"sources":["../src/server/packageApiServer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBAuBa;iBAEI;EACf;EACA;EACA;EACA,iBAAiB;EACjB;EACA,eAAe;EACf;;WAES,aAAa,SAAS;;WAEtB,cAAc;WACd,cAAc;;WAEd,YAAY;WACZ,mBAAmB;WACnB,kBAAkB;WAClB,eAAe;WACf,aAAa;WACb,aAAa;;WAEb,kBAAkB;EAC3B;EACA;;EAEA,iBAAiB;EACjB,iBAAiB;EACjB,eAAe;;EAEf,qBAAqB,iBAAiB;;EAEtC,mBAAmB,MAAM,mBAAmB;;EAE5C,cAAc;;EAEd,UAAU;EACV,oBAAoB,yCAAyC;EAC7D;EACA,YAAY;EACZ,WAAW;;iBAGI;;WAEN,UAAU,SAAS,YAAY,QAAQ;EAChD,SAAS;;;wBAyCW,iBAAiB,SAAS,0BAA0B,QAAQ"}

package/dist/packageApiServer.mjs

@@ -1,9 +1,10 @@
 import { observe } from "./serverTelemetry.mjs";
-import { DOOM_API_ROUTE_PREFIX } from "./src/schemas/packageApi.mjs";
+import { prepareSessionEnvironment } from "./src/services/sessionFiles/index.mjs";
+import { PO_API_ROUTE_PREFIX } from "./src/schemas/packageApi.mjs";
 import "./packageApi.mjs";
-import { createDoomServerHost } from "./src/services/serverFacet/index.mjs";
-import { installServerFacets } from "./src/server/serverFacetLoader.mjs";
-import "./serverFacet.mjs";
+import { createPoServerHost } from "./src/services/serverHost/index.mjs";
+import { PoServerScope } from "./src/server/serverScope.mjs";
+import "./serverPlugin.mjs";
 import { validatedTraceContext } from "./src/services/traceContext/index.mjs";
 //#region src/server/packageApiServer.ts
 /**
@@ -47,12 +48,17 @@ function responseWithCompletion(response, complete) {
 	});
 	return new Response(body, response);
 }
-/** Installs session facets and dispatches authenticated package API calls in-process. */
+/** Installs session packages and dispatches authenticated package API calls in-process. */
 async function serveSessionApis(options) {
 	if (options.environment === void 0) throw new Error("Session package API server requires an admitted environment.");
 	if (options.directEvents === void 0) throw new Error("Session package API server requires direct events.");
-	const facets = options.facets ?? [];
-	if (options.apis.length === 0 && facets.length === 0 && !options.prepareFacets) return {
+	options = {
+		...options,
+		environment: await prepareSessionEnvironment(options)
+	};
+	const packages = options.packages ?? [];
+	const routesNothing = () => !options.preparePackages && options.parentScope === void 0;
+	if (options.apis.length === 0 && packages.length === 0 && routesNothing()) return {
 		request: async () => Response.json({ error: "No package APIs are mounted." }, { status: 404 }),
 		close: () => Promise.resolve()
 	};
@@ -83,7 +89,8 @@ async function serveSessionApis(options) {
 		workspaceId: options.workspaceId,
 		workspaceRoot: options.workspaceRoot,
 		...options.sessionContext === void 0 ? {} : { sessionContext: options.sessionContext },
-		homeDirectory: options.homeDirectory,
+		homeDirectory: options.homeDirectory ?? options.platform.homeDirectory,
+		sessionStorage: options.platform.sessions,
 		cwd: options.cwd,
 		environment: options.environment,
 		directEvents: options.directEvents,
@@ -91,6 +98,7 @@ async function serveSessionApis(options) {
 		...options.shareFile === void 0 ? {} : { shareFile: options.shareFile },
 		...options.mediaArbitration === void 0 ? {} : { mediaArbitration: options.mediaArbitration },
 		...options.executionBudget === void 0 ? {} : { executionBudget: options.executionBudget },
+		...options.editPresence === void 0 ? {} : { editPresence: options.editPresence },
 		...options.peerAgents === void 0 ? {} : { peerAgents: options.peerAgents },
 		...options.requestApi === void 0 ? {} : { requestApi: options.requestApi },
 		...options.publishActivity === void 0 ? {} : { publishActivity: options.publishActivity },
@@ -100,34 +108,42 @@ async function serveSessionApis(options) {
 		...communication === void 0 ? {} : { sessionCommunication: communication },
 		onNotice: options.onNotice
 	};
-	const host = createDoomServerHost({
+	const host = createPoServerHost({
 		scope: "session",
 		context,
 		mountChannel: options.mountChannel,
 		...options.pluginRegistry === void 0 ? {} : { pluginRegistry: options.pluginRegistry }
 	});
-	for (const api of options.apis) host.registerApi(api);
-	let installed;
+	let scope;
 	try {
-		installed = await installServerFacets({
+		for (const api of options.apis) host.registerApi(api);
+		scope = await PoServerScope.open("session", options.parentScope);
+		await scope.serve({
 			host,
-			facets,
+			platform: options.platform
+		});
+		await options.preparePackages?.(scope.root);
+		const installed = await scope.install(packages, {
 			onNotice: options.onNotice,
-			prepare: options.prepareFacets
+			onPackageSettled: (report) => {
+				if (!options.telemetry) return;
+				observe(options.telemetry.recordEvent("po_server.package_install", {
+					"package.name": report.packageName,
+					"package.outcome": report.outcome,
+					duration_ms: report.durationMs,
+					scope: "session"
+				}), options.onNotice);
+			}
 		});
-		try {
-			await options.activateFacets?.(installed);
-		} catch (error) {
-			await installed.dispose();
-			throw error;
-		}
+		await options.activatePackages?.(installed);
 	} catch (error) {
+		await scope?.dispose();
 		communication?.close();
 		host.dispose();
 		throw error;
 	}
-	if (host.mounted().length === 0 && !options.prepareFacets) {
-		await installed.dispose();
+	if (host.mounted().length === 0 && routesNothing()) {
+		await scope.dispose();
 		communication?.close();
 		host.dispose();
 		return {
@@ -135,14 +151,15 @@ async function serveSessionApis(options) {
 			close: () => Promise.resolve()
 		};
 	}
+	const sessionScope = scope;
 	const dispatch = async (request) => {
 		if (options.canDispatch?.() === false) return Response.json({ error: "Session selection is not ready." }, { status: 503 });
 		const url = new URL(request.url);
 		if (!url.pathname.startsWith(`/api/plugins/`)) return Response.json({ error: "Not found." }, { status: 404 });
-		const rest = url.pathname.slice(DOOM_API_ROUTE_PREFIX.length + 1);
+		const rest = url.pathname.slice(PO_API_ROUTE_PREFIX.length + 1);
 		const slash = rest.indexOf("/");
 		const basePath = slash === -1 ? rest : rest.slice(0, slash);
-		const handler = host.handlerFor(basePath);
+		const handler = sessionScope.apiHandler(basePath);
 		if (handler === void 0) return Response.json({ error: `No API '${basePath}' in this session.` }, { status: 404 });
 		url.pathname = slash === -1 ? "/" : rest.slice(slash);
 		const startedAt = performance.now();
@@ -151,7 +168,7 @@ async function serveSessionApis(options) {
 		let response;
 		try {
 			const invoke = async (context) => {
-				if (options.canDispatch?.() === false || host.handlerFor(basePath) !== handler) return Response.json({ error: "Session selection changed before dispatch." }, { status: 503 });
+				if (options.canDispatch?.() === false || sessionScope.apiHandler(basePath) !== handler) return Response.json({ error: "Session selection changed before dispatch." }, { status: 503 });
 				childContext = context;
 				return handler.fetch(new Request(url, request));
 			};
@@ -160,6 +177,7 @@ async function serveSessionApis(options) {
 				method: request.method
 			}, invoke, parent) : await invoke();
 		} catch (error) {
+			if (request.signal.aborted) return new Response(null, { status: 499 });
 			options.onNotice(`package API '${basePath}' failed on ${url.pathname} (${describeError(error)})`);
 			response = Response.json({ error: `The '${basePath}' API failed.` }, { status: 500 });
 		}
@@ -180,7 +198,7 @@ async function serveSessionApis(options) {
 		request: dispatch,
 		close: () => {
 			closePromise ??= (async () => {
-				await installed.dispose();
+				await scope.dispose();
 				communication?.close();
 				host.dispose();
 			})();