@agimon-ai/po-core 0.0.0-alpha.13 → 0.0.0-alpha.15

package/dist/extensionFile.cjs

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_extensionFile = require("./src/extensions/extensionFile.cjs");
+const require_serverScope = require("./src/schemas/serverScope.cjs");
 exports.composeRootHooks = require_extensionFile.composeRootHooks;
+exports.composeRootInjects = require_extensionFile.composeRootInjects;
 exports.defineActivity = require_extensionFile.defineActivity;
 exports.defineChannel = require_extensionFile.defineChannel;
 exports.defineCommand = require_extensionFile.defineCommand;
@@ -15,5 +17,6 @@ exports.defineRoutedContribution = require_extensionFile.defineRoutedContributio
 exports.defineServerCommand = require_extensionFile.defineServerCommand;
 exports.defineServerTool = require_extensionFile.defineServerTool;
 exports.defineService = require_extensionFile.defineService;
+exports.defineServiceContract = require_serverScope.defineServiceContract;
 exports.defineTool = require_extensionFile.defineTool;
 exports.defineToolRestriction = require_extensionFile.defineToolRestriction;

package/dist/extensionFile.d.mts

@@ -1,3 +1,4 @@
+import { defineServiceContract } from "./src/schemas/serverScope.mjs";
 import { ActivityFile, ChannelFile, CommandContribution, CommandFile, HookFile, MethodFile, OrFactory, PathSupplied, RootDeclaration, RootFile, RouteFile, RoutedCardinality, RoutedFileOptions, ServerCommandFile, ServerToolFile, ServiceFile, ToolContribution, ToolFile, WithRoot } from "./src/schemas/extensionFile.mjs";
-import { composeRootHooks, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineTool, defineToolRestriction } from "./src/extensions/extensionFile.mjs";
-export { type ActivityFile, type ChannelFile, type CommandContribution, type CommandFile, type HookFile, type MethodFile, type OrFactory, type PathSupplied, type RootDeclaration, type RootFile, type RouteFile, type RoutedCardinality, type RoutedFileOptions, type ServerCommandFile, type ServerToolFile, type ServiceFile, type ToolContribution, type ToolFile, type WithRoot, composeRootHooks, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineTool, defineToolRestriction };
+import { composeRootHooks, composeRootInjects, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineTool, defineToolRestriction } from "./src/extensions/extensionFile.mjs";
+export { type ActivityFile, type ChannelFile, type CommandContribution, type CommandFile, type HookFile, type MethodFile, type OrFactory, type PathSupplied, type RootDeclaration, type RootFile, type RouteFile, type RoutedCardinality, type RoutedFileOptions, type ServerCommandFile, type ServerToolFile, type ServiceFile, type ToolContribution, type ToolFile, type WithRoot, composeRootHooks, composeRootInjects, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineServiceContract, defineTool, defineToolRestriction };

package/dist/extensionFile.mjs

@@ -1 +1,3 @@
-export { composeRootHooks, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineTool, defineToolRestriction } from "./src/extensions/extensionFile.mjs";
+import { composeRootHooks, composeRootInjects, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineTool, defineToolRestriction } from "./src/extensions/extensionFile.mjs";
+import { defineServiceContract } from "./src/schemas/serverScope.mjs";
+export { composeRootHooks, composeRootInjects, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineServiceContract, defineTool, defineToolRestriction };

package/dist/headlessHub.cjs

@@ -9,9 +9,9 @@ require("./src/schemas/sessionProtocol.cjs");
 require("./src/constants/agentSettled.cjs");
 const require_pluginProtocol = require("./src/schemas/pluginProtocol.cjs");
 require("./pluginProtocol.cjs");
-const require_index = require("./src/services/serverFacet/index.cjs");
-const require_serverFacetLoader = require("./src/server/serverFacetLoader.cjs");
-require("./serverFacet.cjs");
+const require_index = require("./src/services/serverHost/index.cjs");
+const require_serverScope = require("./src/server/serverScope.cjs");
+require("./serverPlugin.cjs");
 const require_index$1 = require("./src/services/sessionGitStatus/index.cjs");
 let node_crypto = require("node:crypto");
 node_crypto = require_runtime.__toESM(node_crypto, 1);
@@ -90,13 +90,18 @@ function createHeadlessHub(options) {
 	const maxDirectEventLatest = 4096;
 	const communicationEndpoints = /* @__PURE__ */ new Map();
 	let closed = false;
-	const mounts = /* @__PURE__ */ new Map();
-	const disposeMount = async (mounted) => {
-		try {
-			await mounted.installed.dispose();
-		} finally {
-			mounted.host.dispose();
+	/** The mount table each served global or workspace scope publishes, by mount key. */
+	const scopeHosts = /* @__PURE__ */ new Map();
+	let globalScope;
+	const workspaceScopes = /* @__PURE__ */ new Map();
+	const openGlobalScope = () => globalScope ??= require_serverScope.PoServerScope.open("global");
+	const openWorkspaceScope = (workspaceId) => {
+		let scope = workspaceScopes.get(workspaceId);
+		if (scope === void 0) {
+			scope = openGlobalScope().then((global) => require_serverScope.PoServerScope.open("workspace", global));
+			workspaceScopes.set(workspaceId, scope);
 		}
+		return scope;
 	};
 	const workspaces = /* @__PURE__ */ new Map();
 	const worktreeProvisioners = /* @__PURE__ */ new Map();
@@ -745,7 +750,7 @@ function createHeadlessHub(options) {
 		canCommunicate,
 		bindCommunication
 	};
-	const installMount = async (facets, suppliedContext, announceWorkspace) => {
+	const serveScope = async (suppliedContext, packages = []) => {
 		if (closed) throw new Error("The headless hub is closed.");
 		const context = suppliedContext ?? {
 			scope: "global",
@@ -754,14 +759,14 @@ function createHeadlessHub(options) {
 			directEvents,
 			onNotice: (message) => options.onNotice?.(message)
 		};
-		if (context.scope === "session") throw new Error("Session facets belong to their session host.");
+		if (context.scope === "session") throw new Error("Session packages belong to their session host.");
 		if (context.scope === "workspace" && (!context.workspaceId || !context.workspaceRoot)) throw new Error("Workspace mounts require an admitted identity and root.");
 		const mount = context.scope === "global" ? { scope: "global" } : {
 			scope: "workspace",
 			workspaceId: context.workspaceId
 		};
 		const key = mountKey(mount);
-		if (mounts.has(key)) throw new Error(`The '${key}' facets are already mounted.`);
+		if (scopeHosts.has(key)) throw new Error(`The '${key}' scope is already served.`);
 		const host = require_index.createPoServerHost({
 			scope: context.scope,
 			context: {
@@ -783,24 +788,20 @@ function createHeadlessHub(options) {
 			},
 			pluginRegistry
 		});
+		let scope;
 		try {
-			const installed = await require_serverFacetLoader.installServerFacets({
+			scope = await (mount.scope === "global" ? openGlobalScope() : openWorkspaceScope(mount.workspaceId));
+			await scope.serve({
 				host,
-				facets,
-				onNotice: options.onNotice,
 				platform: options.platform
 			});
-			if (closed) {
-				await installed.dispose();
-				throw new Error("The headless hub was closed while mounting facets.");
-			}
-			mounts.set(key, {
+			scopeHosts.set(key, {
 				host,
-				installed,
-				context,
-				facets
+				scope
 			});
-			if (announceWorkspace && mount.scope === "workspace") {
+			await scope.install(packages, { onNotice: (message) => options.onNotice?.(message) });
+			if (closed) throw new Error("The headless hub was closed while serving a scope.");
+			if (mount.scope === "workspace") {
 				const workspace = {
 					id: mount.workspaceId,
 					root: context.workspaceRoot,
@@ -813,35 +814,20 @@ function createHeadlessHub(options) {
 				});
 			}
 		} catch (error) {
+			if (scopeHosts.get(key)?.host === host) scopeHosts.delete(key);
 			host.dispose();
+			if (mount.scope === "workspace") workspaceScopes.delete(mount.workspaceId);
+			else globalScope = void 0;
+			await scope?.dispose();
 			throw error;
 		}
 	};
-	const mountFacets = (facets, suppliedContext) => installMount(facets, suppliedContext, true);
-	const replacements = /* @__PURE__ */ new Map();
-	const replaceFacets = (mount, facets) => {
-		if (mount.scope === "session") return Promise.reject(/* @__PURE__ */ new Error("Session facets belong to their session host."));
-		const key = mountKey(mount);
-		const run = (replacements.get(key) ?? Promise.resolve()).then(async () => {
-			if (closed) throw new Error("The headless hub is closed.");
-			const previous = mounts.get(key);
-			if (previous === void 0) throw new Error(`The '${key}' facets are not mounted.`);
-			mounts.delete(key);
-			await disposeMount(previous);
-			if (closed || mount.scope === "workspace" && !workspaces.has(mount.workspaceId)) return;
-			try {
-				await installMount(facets, previous.context, false);
-			} catch (error) {
-				await installMount(previous.facets, previous.context, false).catch((rollbackError) => options.onNotice?.(`The '${key}' facets could not be restored (${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)})`));
-				throw error;
-			}
-		});
-		const settled = run.then(() => void 0, () => void 0);
-		replacements.set(key, settled);
-		settled.then(() => {
-			if (replacements.get(key) === settled) replacements.delete(key);
-		});
-		return run;
+	const installPackages = async (mount, packages) => {
+		if (mount.scope === "session") throw new Error("Session packages belong to their session host.");
+		if (closed) throw new Error("The headless hub is closed.");
+		const served = scopeHosts.get(mountKey(mount));
+		if (served === void 0) throw new Error(`The '${mountKey(mount)}' scope is not served.`);
+		await served.scope.install(packages, { onNotice: (message) => options.onNotice?.(message) });
 	};
 	return {
 		sessionService,
@@ -1017,8 +1003,12 @@ function createHeadlessHub(options) {
 				sessionId
 			});
 		},
-		mountFacets,
-		replaceFacets,
+		serveScope,
+		installPackages,
+		sessionParentScope: (workspaceId) => {
+			if (closed) return Promise.reject(/* @__PURE__ */ new Error("The headless hub is closed."));
+			return workspaceId === void 0 ? openGlobalScope() : openWorkspaceScope(workspaceId);
+		},
 		workspaces: () => [...workspaces.values()],
 		registerWorkspace(workspace) {
 			workspaces.set(workspace.id, workspace);
@@ -1037,17 +1027,23 @@ function createHeadlessHub(options) {
 				scope: "workspace",
 				workspaceId: id
 			});
-			const mounted = mounts.get(key);
-			if (!workspaces.has(id)) return;
-			options.onWorkspaceRemoved?.(id);
-			workspaces.delete(id);
-			emit({
-				kind: "workspace_removed",
-				workspaceId: id
-			});
-			if (!mounted) return;
-			mounts.delete(key);
-			await disposeMount(mounted);
+			const served = scopeHosts.get(key);
+			scopeHosts.delete(key);
+			const scope = workspaceScopes.get(id);
+			workspaceScopes.delete(id);
+			if (workspaces.has(id)) {
+				options.onWorkspaceRemoved?.(id);
+				workspaces.delete(id);
+				emit({
+					kind: "workspace_removed",
+					workspaceId: id
+				});
+			}
+			try {
+				await (await scope)?.dispose();
+			} finally {
+				served?.host.dispose();
+			}
 		},
 		async requestApi(mount, basePath, request) {
 			if (closed) return Response.json({ error: "Server is closed." }, { status: 503 });
@@ -1064,7 +1060,7 @@ function createHeadlessHub(options) {
 					body: request.body === null ? void 0 : new Uint8Array(await request.arrayBuffer())
 				});
 			}
-			const handler = mounts.get(mountKey(mount))?.host.handlerFor(basePath);
+			const handler = scopeHosts.get(mountKey(mount))?.scope.apiHandler(basePath);
 			if (!handler) return Response.json({ error: `API '${basePath}' is not mounted in ${mountKey(mount)}.` }, { status: 404 });
 			return handler.fetch(request);
 		},
@@ -1164,19 +1160,6 @@ function createHeadlessHub(options) {
 			for (const cleanup of presentationCleanups.values()) cleanup();
 			presentationCleanups.clear();
 			const failures = [];
-			for (const mounted of [...mounts.values()].reverse()) {
-				try {
-					await mounted.installed.dispose();
-				} catch (error) {
-					failures.push(error);
-				}
-				try {
-					mounted.host.dispose();
-				} catch (error) {
-					failures.push(error);
-				}
-			}
-			mounts.clear();
 			pluginRegistry.dispose();
 			editPresence.clear();
 			workspaces.clear();
@@ -1191,6 +1174,18 @@ function createHeadlessHub(options) {
 			sessions.clear();
 			const outcomes = await Promise.allSettled(shutdowns);
 			for (const outcome of outcomes) if (outcome.status === "rejected") failures.push(outcome.reason);
+			try {
+				await (await globalScope)?.dispose();
+			} catch (error) {
+				failures.push(error);
+			}
+			for (const { host } of scopeHosts.values()) try {
+				host.dispose();
+			} catch (error) {
+				failures.push(error);
+			}
+			scopeHosts.clear();
+			workspaceScopes.clear();
 			if (failures.length) throw new AggregateError(failures, "Mount shutdown failed");
 		}
 	};