@agimon-ai/po-core 0.0.0-alpha.104 → 0.0.0-alpha.105

package/dist/apiContracts.d.mts

@@ -8,11 +8,104 @@ import { SqliteDatabase } from "@earendil-works/pi-durable/storage/sqlite";
 import "@agimon-ai/po-web-security/deviceProof";
 import { Schema } from "@earendil-works/pi-schema";
 import "@earendil-works/chord/context";
+//#region src/schemas/serverBundle.d.ts
+/** Every occurrence that can activate a package in this repository. */
+interface PoServerBundleOwner {
+  readonly majorMode: string;
+  readonly layer: string;
+}
+interface PoServerBundleEntry {
+  readonly packageName: string;
+  /** Host-admitted distribution catalog origin, never inferred from a local path. */
+  readonly origin?: 'po' | 'personal' | 'unknown';
+  /** Validated additive client metadata, retained without importing browser code. */
+  readonly webMetadata?: PoWebBrainMetadata;
+  /** Parsed at package load. Missing or malformed contracts cannot authorize federation. */
+  readonly apiContract?: PoApiContract;
+  /** The declared package-relative source entry, retained for attribution. */
+  readonly entry: string;
+  /** Absolute path of the package's built module; the live loader imports it from its content URL. */
+  readonly module: string;
+  readonly scopes: readonly PoApiScope[];
+  readonly owners: readonly PoServerBundleOwner[];
+  readonly required: boolean;
+}
+//#endregion
+//#region src/schemas/brain.d.ts
+/** Detached descriptions only. No service values, fibers, paths or callbacks cross this boundary. */
+interface BrainScope {
+  id: string;
+  level: PoApiScope;
+}
+interface BrainOwner {
+  kind: 'host' | 'package' | 'unknown';
+  packageName: string | null;
+  origin: NonNullable<PoServerBundleEntry['origin']>;
+}
+interface BrainService {
+  id: string;
+  name: string;
+  scope: BrainScope;
+  visibleFrom: BrainScope;
+  owner: BrainOwner;
+  public: boolean;
+  description: string | null;
+}
+interface BrainConsumer {
+  id: string;
+  name: string;
+  scope: BrainScope;
+  owner: BrainOwner;
+}
+/** Declared injections only, never inferred from ctx.get or requirePo helpers. */
+interface BrainEdge {
+  consumer: string;
+  service: string | null;
+  name: string;
+  status: 'resolved' | 'waiting';
+}
+interface BrainPackage {
+  scope: BrainScope;
+  owner: BrainOwner;
+  web: PoWebBrainMetadata | null;
+}
+interface BrainServicesSnapshot {
+  scope: BrainScope;
+  scopes: BrainScope[];
+  packages: BrainPackage[];
+  /** Exact published browser mounts, when the host supplied every scope's inventory. */
+  clientPackages?: BrainPackage[];
+  services: BrainService[];
+  consumers: BrainConsumer[];
+  edges: BrainEdge[];
+  diagnostics: string[];
+}
+/** Additive manifest metadata. Older manifests omit this block rather than claiming no slots. */
+interface PoWebBrainMetadata {
+  version: 1;
+  slots: {
+    name: string;
+    scope: PoApiScope;
+    description?: string;
+    parent?: string;
+    kind: 'data' | 'component';
+  }[];
+  fills: {
+    id: string;
+    slot: string | null;
+    scope: PoApiScope;
+    placement: 'verified' | 'unverified';
+  }[];
+  diagnostics: string[];
+}
+//#endregion
 //#region src/schemas/serverScope.d.ts
 /** An abstract service: the name every level resolves and the level that provides it. */
 interface PoServiceContract<T> {
   readonly name: string;
   readonly scope: PoApiScope;
+  /** What this service offers an author. Built public contracts require a nonblank description. */
+  readonly description?: string;
   /** Type carrier only; never set at runtime. */
   readonly _type?: T;
 }
@@ -34,6 +127,8 @@ interface PoServerPluginShare<TRoots> {
 /** What a plugin sees of the scope it is installed into. */
 interface PoServerScopeService {
   readonly level: PoApiScope;
+  /** Detached current scope and ancestry only, without reading service values. */
+  snapshot(): BrainServicesSnapshot;
   /**
    * Bind the concrete value of a contract owned by this level, visible here and in every descendant.
    * Settles once every descendant publishes it. The binding unwinds with the calling fiber; the
@@ -753,13 +848,6 @@ declare module '@deepseek-ai/cordis' {
   }
 }
 //#endregion
-//#region src/schemas/serverBundle.d.ts
-/** Every occurrence that can activate a package in this repository. */
-interface PoServerBundleOwner {
-  readonly majorMode: string;
-  readonly layer: string;
-}
-//#endregion
 //#region src/schemas/apiContracts.d.ts
 export declare const PO_API_CONTRACT_VERSION = 1;
 export declare const PO_API_CONTRACT_FILE = "contracts.json";

package/dist/apiContracts.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.d.mts","names":["_0","_0","_0","IoContext","_0","_$__hubChannel0.PoHubSessionUsage","_0","_$__protocolContracts0.ChordMethods"],"sources":["../src/schemas/serverScope.ts","../src/schemas/approvalPrompt.ts","../src/schemas/approval.ts","../src/schemas/backgroundWork.ts","../src/schemas/platform.ts","../src/schemas/workflow.ts","../src/schemas/hubChannel.ts","../src/schemas/packageApi.ts","../src/schemas/serverBundle.ts","../src/schemas/apiContracts.ts","../src/services/apiContracts/index.ts","../src/schemas/builtinApiContracts.ts","../src/schemas/httpApiContracts.ts","../src/schemas/protocolContracts.ts","../src/schemas/sessionProtocol.ts","../src/schemas/sessionApiContracts.ts","../src/schemas/transportApiContracts.ts"],"mappings":"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"}
+{"version":3,"file":"apiContracts.d.mts","names":["_0","_0","_0","IoContext","_0","_$__hubChannel0.PoHubSessionUsage","_0","_$__protocolContracts0.ChordMethods"],"sources":["../src/schemas/serverBundle.ts","../src/schemas/brain.ts","../src/schemas/serverScope.ts","../src/schemas/approvalPrompt.ts","../src/schemas/approval.ts","../src/schemas/backgroundWork.ts","../src/schemas/platform.ts","../src/schemas/workflow.ts","../src/schemas/hubChannel.ts","../src/schemas/packageApi.ts","../src/schemas/apiContracts.ts","../src/services/apiContracts/index.ts","../src/schemas/builtinApiContracts.ts","../src/schemas/httpApiContracts.ts","../src/schemas/protocolContracts.ts","../src/schemas/sessionProtocol.ts","../src/schemas/sessionApiContracts.ts","../src/schemas/transportApiContracts.ts"],"mappings":"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"}

package/dist/headlessSessionHost.d.mts

@@ -2,11 +2,11 @@ import { PoPlatform } from "./src/schemas/platform.mjs";
 import { PoWorkflowContextService } from "./src/schemas/workflow.mjs";
 import { PoHubSessionExecutionState, PoSessionContext } from "./src/schemas/hubChannel.mjs";
 import { PoNativeComposition, PoWebComposition } from "./src/schemas/packageApi.mjs";
+import { PoServerBundleEntry } from "./src/schemas/serverBundle.mjs";
 import { DirectHarnessRuntime } from "./src/types/server/directHarnessRuntime.mjs";
 import { PoChildThread } from "./src/systems/child/types/childSession.mjs";
 import { ContextProjectionInput } from "./contextProjection.mjs";
 import { SessionToolSurface } from "./src/types/server/sessionToolSurface.mjs";
-import { PoServerBundleEntry } from "./src/schemas/serverBundle.mjs";
 import { PoHeadlessRefreshAxis, PoHeadlessSelection } from "./src/schemas/headless.mjs";
 import { PoServerProviderOverride } from "./src/schemas/serverPlugin.mjs";
 import "./headless.mjs";

package/dist/nodePlatform.cjs

@@ -97,7 +97,10 @@ function createNodePlatform(options = {}) {
 		abiVersion: 1,
 		homeDirectory: options.homeDirectory ?? node_os.default.homedir(),
 		temporaryDirectory: process.platform === "darwin" || process.platform === "linux" ? options.temporaryDirectory ?? node_os.default.tmpdir() : void 0,
-		env: (cwd) => new _earendil_works_pi_durable_env_node.NodeExecutionEnv({ cwd }),
+		env: (cwd) => new _earendil_works_pi_durable_env_node.NodeExecutionEnv({
+			cwd,
+			watch: options.watch
+		}),
 		sqlite: {
 			abiVersion: 1,
 			open: openNodeSqliteDatabase

package/dist/nodePlatform.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"nodePlatform.cjs","names":["openDatabase","createHistoryOwnership","openSqliteSessionStorage","openReadOnlyDurableStorage","sqliteSessionFile","path","DURABLE_DIRECTORY","fs","os","NodeExecutionEnv"],"sources":["../src/services/nodePlatform/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { NodeExecutionEnv } from '@earendil-works/pi-durable/env/node';\nimport { openNodeSqliteDatabase as openDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoPlatform, PoSessionStorageService, PoStoredSession } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY } from '../durableSession';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport type { HistoryOwnership } from '../historyOwnership/type';\nimport { openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile } from '../sqliteSessionStorage';\n\nconst SQLITE_BUSY = 5;\nconst SQLITE_OPEN_TIMEOUT_MS = 5_000;\nconst SQLITE_OPEN_RETRY_MS = 10;\n\n/** Concurrent WAL initialization can return SQLITE_BUSY without waiting for SQLite's busy timeout. */\nexport async function openNodeSqliteDatabase(file: string) {\n  const deadline = Date.now() + SQLITE_OPEN_TIMEOUT_MS;\n  for (;;) {\n    try {\n      return await openDatabase(file, { busyTimeoutMs: Math.max(0, deadline - Date.now()) });\n    } catch (error) {\n      if (!(error instanceof Error) || !('errcode' in error) || error.errcode !== SQLITE_BUSY || Date.now() >= deadline)\n        throw error;\n      await new Promise((resolve) => setTimeout(resolve, SQLITE_OPEN_RETRY_MS));\n    }\n  }\n}\n\nexport interface NodePlatformOptions {\n  /** Defaults to the user's home directory. */\n  readonly homeDirectory?: string;\n  /** Host-admitted override; defaults to this Node host's OS temporary directory. */\n  readonly temporaryDirectory?: string;\n  /** Where the launching entry keeps agent sessions. Without it `sessions` refuses every call. */\n  readonly sessionsRoot?: string;\n  /** Shared ownership for every session this platform opens; created on first open when absent. */\n  readonly historyOwnership?: HistoryOwnership;\n}\n\n/** One lock-owned durable-v1 SQLite file per agent session. */\nfunction createNodeSessions(options: NodePlatformOptions): PoSessionStorageService {\n  let historyOwnership = options.historyOwnership;\n  const root = () => {\n    if (options.sessionsRoot === undefined) throw new Error('This Node platform was given no sessions root.');\n    return options.sessionsRoot;\n  };\n  return {\n    abiVersion: 1,\n    async open(request, context) {\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      const opened = await openSqliteSessionStorage({ ...request, sessionsRoot: root(), historyOwnership }, context);\n      return {\n        storage: opened.storage,\n        assertWritable: () => opened.historyLease.assertQuiescent(),\n        async release(releaseContext) {\n          // The lease outlives a failed close so no second writer opens a file still being written.\n          await opened.session.close(releaseContext);\n          await opened.historyLease.release();\n        },\n      };\n    },\n    openReadOnly: async (sessionId) => openReadOnlyDurableStorage(sqliteSessionFile(root(), sessionId)),\n    async list() {\n      const directory = path.join(root(), DURABLE_DIRECTORY);\n      const files = await fs.readdir(directory).catch((error: NodeJS.ErrnoException) => {\n        if (error.code === 'ENOENT') return [];\n        throw error;\n      });\n      const stored: PoStoredSession[] = [];\n      for (const file of files) {\n        if (!/^[a-zA-Z0-9_-]+\\.sqlite$/u.test(file)) continue;\n        const { mtimeMs } = await fs.stat(path.join(directory, file));\n        stored.push({ sessionId: path.basename(file, '.sqlite'), updatedAt: mtimeMs });\n      }\n      return stored;\n    },\n    async remove(sessionId) {\n      const file = sqliteSessionFile(root(), sessionId);\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      let lease: Awaited<ReturnType<HistoryOwnership['acquire']>>;\n      try {\n        lease = await historyOwnership.acquire(file);\n      } catch (error) {\n        const cause = error instanceof Error ? (error.cause as NodeJS.ErrnoException | undefined) : undefined;\n        if (cause?.code === 'EEXIST') return 'busy';\n        throw error;\n      }\n      try {\n        for (const suffix of ['', '-wal', '-shm']) await fs.rm(`${file}${suffix}`, { force: true });\n      } finally {\n        // Releasing removes the lock file, so a removed session leaves no lock behind.\n        await lease.release();\n      }\n      return 'removed';\n    },\n  };\n}\n\n/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */\nexport function createNodePlatform(options: NodePlatformOptions = {}): PoPlatform {\n  return {\n    abiVersion: 1,\n    homeDirectory: options.homeDirectory ?? os.homedir(),\n    // Secure session-file protection and viewing currently require POSIX ownership semantics.\n    temporaryDirectory:\n      process.platform === 'darwin' || process.platform === 'linux'\n        ? (options.temporaryDirectory ?? os.tmpdir())\n        : undefined,\n    env: (cwd) => new NodeExecutionEnv({ cwd }),\n    sqlite: { abiVersion: 1, open: openNodeSqliteDatabase },\n    sessions: createNodeSessions(options),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"nodePlatform.cjs","names":["openDatabase","createHistoryOwnership","openSqliteSessionStorage","openReadOnlyDurableStorage","sqliteSessionFile","path","DURABLE_DIRECTORY","fs","os","NodeExecutionEnv"],"sources":["../src/services/nodePlatform/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { NodeExecutionEnv, type NodeWatchOptions } from '@earendil-works/pi-durable/env/node';\nimport { openNodeSqliteDatabase as openDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoPlatform, PoSessionStorageService, PoStoredSession } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY } from '../durableSession';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport type { HistoryOwnership } from '../historyOwnership/type';\nimport { openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile } from '../sqliteSessionStorage';\n\nconst SQLITE_BUSY = 5;\nconst SQLITE_OPEN_TIMEOUT_MS = 5_000;\nconst SQLITE_OPEN_RETRY_MS = 10;\n\n/** Concurrent WAL initialization can return SQLITE_BUSY without waiting for SQLite's busy timeout. */\nexport async function openNodeSqliteDatabase(file: string) {\n  const deadline = Date.now() + SQLITE_OPEN_TIMEOUT_MS;\n  for (;;) {\n    try {\n      return await openDatabase(file, { busyTimeoutMs: Math.max(0, deadline - Date.now()) });\n    } catch (error) {\n      if (!(error instanceof Error) || !('errcode' in error) || error.errcode !== SQLITE_BUSY || Date.now() >= deadline)\n        throw error;\n      await new Promise((resolve) => setTimeout(resolve, SQLITE_OPEN_RETRY_MS));\n    }\n  }\n}\n\nexport interface NodePlatformOptions {\n  /** Defaults to the user's home directory. */\n  readonly homeDirectory?: string;\n  /** Host-admitted override; defaults to this Node host's OS temporary directory. */\n  readonly temporaryDirectory?: string;\n  /** Where the launching entry keeps agent sessions. Without it `sessions` refuses every call. */\n  readonly sessionsRoot?: string;\n  /** Shared ownership for every session this platform opens; created on first open when absent. */\n  readonly historyOwnership?: HistoryOwnership;\n  /** Host-selected watcher settings; omission retains the upstream defaults. */\n  readonly watch?: NodeWatchOptions;\n}\n\n/** One lock-owned durable-v1 SQLite file per agent session. */\nfunction createNodeSessions(options: NodePlatformOptions): PoSessionStorageService {\n  let historyOwnership = options.historyOwnership;\n  const root = () => {\n    if (options.sessionsRoot === undefined) throw new Error('This Node platform was given no sessions root.');\n    return options.sessionsRoot;\n  };\n  return {\n    abiVersion: 1,\n    async open(request, context) {\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      const opened = await openSqliteSessionStorage({ ...request, sessionsRoot: root(), historyOwnership }, context);\n      return {\n        storage: opened.storage,\n        assertWritable: () => opened.historyLease.assertQuiescent(),\n        async release(releaseContext) {\n          // The lease outlives a failed close so no second writer opens a file still being written.\n          await opened.session.close(releaseContext);\n          await opened.historyLease.release();\n        },\n      };\n    },\n    openReadOnly: async (sessionId) => openReadOnlyDurableStorage(sqliteSessionFile(root(), sessionId)),\n    async list() {\n      const directory = path.join(root(), DURABLE_DIRECTORY);\n      const files = await fs.readdir(directory).catch((error: NodeJS.ErrnoException) => {\n        if (error.code === 'ENOENT') return [];\n        throw error;\n      });\n      const stored: PoStoredSession[] = [];\n      for (const file of files) {\n        if (!/^[a-zA-Z0-9_-]+\\.sqlite$/u.test(file)) continue;\n        const { mtimeMs } = await fs.stat(path.join(directory, file));\n        stored.push({ sessionId: path.basename(file, '.sqlite'), updatedAt: mtimeMs });\n      }\n      return stored;\n    },\n    async remove(sessionId) {\n      const file = sqliteSessionFile(root(), sessionId);\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      let lease: Awaited<ReturnType<HistoryOwnership['acquire']>>;\n      try {\n        lease = await historyOwnership.acquire(file);\n      } catch (error) {\n        const cause = error instanceof Error ? (error.cause as NodeJS.ErrnoException | undefined) : undefined;\n        if (cause?.code === 'EEXIST') return 'busy';\n        throw error;\n      }\n      try {\n        for (const suffix of ['', '-wal', '-shm']) await fs.rm(`${file}${suffix}`, { force: true });\n      } finally {\n        // Releasing removes the lock file, so a removed session leaves no lock behind.\n        await lease.release();\n      }\n      return 'removed';\n    },\n  };\n}\n\n/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */\nexport function createNodePlatform(options: NodePlatformOptions = {}): PoPlatform {\n  return {\n    abiVersion: 1,\n    homeDirectory: options.homeDirectory ?? os.homedir(),\n    // Secure session-file protection and viewing currently require POSIX ownership semantics.\n    temporaryDirectory:\n      process.platform === 'darwin' || process.platform === 'linux'\n        ? (options.temporaryDirectory ?? os.tmpdir())\n        : undefined,\n    env: (cwd) => new NodeExecutionEnv({ cwd, watch: options.watch }),\n    sqlite: { abiVersion: 1, open: openNodeSqliteDatabase },\n    sessions: createNodeSessions(options),\n  };\n}\n"],"mappings":"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"}

package/dist/nodePlatform.d.mts

@@ -1,5 +1,6 @@
 import { PoPlatform } from "./src/schemas/platform.mjs";
 import { HistoryOwnership } from "./src/services/historyOwnership/type.mjs";
+import { NodeWatchOptions } from "@earendil-works/pi-durable/env/node";
 //#region src/services/nodePlatform/index.d.ts
 /** Concurrent WAL initialization can return SQLITE_BUSY without waiting for SQLite's busy timeout. */
 export declare function openNodeSqliteDatabase(file: string): Promise<import("@earendil-works/chord/sqlite/node").NodeSqliteDatabase>;
@@ -12,6 +13,8 @@ export interface NodePlatformOptions {
   readonly sessionsRoot?: string;
   /** Shared ownership for every session this platform opens; created on first open when absent. */
   readonly historyOwnership?: HistoryOwnership;
+  /** Host-selected watcher settings; omission retains the upstream defaults. */
+  readonly watch?: NodeWatchOptions;
 }
 /** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */
 export declare function createNodePlatform(options?: NodePlatformOptions): PoPlatform;

package/dist/nodePlatform.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"nodePlatform.d.mts","names":[],"sources":["../src/services/nodePlatform/index.ts"],"mappings":";;;;wBAkBsB,uBAAuB,eAAY,oDAAA;iBAaxC;;WAEN;;WAEA;;WAEA;;WAEA,mBAAmB;;;wBA+Dd,mBAAmB,UAAS,sBAA2B"}
+{"version":3,"file":"nodePlatform.d.mts","names":[],"sources":["../src/services/nodePlatform/index.ts"],"mappings":";;;;;wBAkBsB,uBAAuB,eAAY,oDAAA;iBAaxC;;WAEN;;WAEA;;WAEA;;WAEA,mBAAmB;;WAEnB,QAAQ;;;wBA+DH,mBAAmB,UAAS,sBAA2B"}

package/dist/nodePlatform.mjs

@@ -92,7 +92,10 @@ function createNodePlatform(options = {}) {
 		abiVersion: 1,
 		homeDirectory: options.homeDirectory ?? os.homedir(),
 		temporaryDirectory: process.platform === "darwin" || process.platform === "linux" ? options.temporaryDirectory ?? os.tmpdir() : void 0,
-		env: (cwd) => new NodeExecutionEnv({ cwd }),
+		env: (cwd) => new NodeExecutionEnv({
+			cwd,
+			watch: options.watch
+		}),
 		sqlite: {
 			abiVersion: 1,
 			open: openNodeSqliteDatabase

package/dist/nodePlatform.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"nodePlatform.mjs","names":["openDatabase"],"sources":["../src/services/nodePlatform/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { NodeExecutionEnv } from '@earendil-works/pi-durable/env/node';\nimport { openNodeSqliteDatabase as openDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoPlatform, PoSessionStorageService, PoStoredSession } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY } from '../durableSession';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport type { HistoryOwnership } from '../historyOwnership/type';\nimport { openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile } from '../sqliteSessionStorage';\n\nconst SQLITE_BUSY = 5;\nconst SQLITE_OPEN_TIMEOUT_MS = 5_000;\nconst SQLITE_OPEN_RETRY_MS = 10;\n\n/** Concurrent WAL initialization can return SQLITE_BUSY without waiting for SQLite's busy timeout. */\nexport async function openNodeSqliteDatabase(file: string) {\n  const deadline = Date.now() + SQLITE_OPEN_TIMEOUT_MS;\n  for (;;) {\n    try {\n      return await openDatabase(file, { busyTimeoutMs: Math.max(0, deadline - Date.now()) });\n    } catch (error) {\n      if (!(error instanceof Error) || !('errcode' in error) || error.errcode !== SQLITE_BUSY || Date.now() >= deadline)\n        throw error;\n      await new Promise((resolve) => setTimeout(resolve, SQLITE_OPEN_RETRY_MS));\n    }\n  }\n}\n\nexport interface NodePlatformOptions {\n  /** Defaults to the user's home directory. */\n  readonly homeDirectory?: string;\n  /** Host-admitted override; defaults to this Node host's OS temporary directory. */\n  readonly temporaryDirectory?: string;\n  /** Where the launching entry keeps agent sessions. Without it `sessions` refuses every call. */\n  readonly sessionsRoot?: string;\n  /** Shared ownership for every session this platform opens; created on first open when absent. */\n  readonly historyOwnership?: HistoryOwnership;\n}\n\n/** One lock-owned durable-v1 SQLite file per agent session. */\nfunction createNodeSessions(options: NodePlatformOptions): PoSessionStorageService {\n  let historyOwnership = options.historyOwnership;\n  const root = () => {\n    if (options.sessionsRoot === undefined) throw new Error('This Node platform was given no sessions root.');\n    return options.sessionsRoot;\n  };\n  return {\n    abiVersion: 1,\n    async open(request, context) {\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      const opened = await openSqliteSessionStorage({ ...request, sessionsRoot: root(), historyOwnership }, context);\n      return {\n        storage: opened.storage,\n        assertWritable: () => opened.historyLease.assertQuiescent(),\n        async release(releaseContext) {\n          // The lease outlives a failed close so no second writer opens a file still being written.\n          await opened.session.close(releaseContext);\n          await opened.historyLease.release();\n        },\n      };\n    },\n    openReadOnly: async (sessionId) => openReadOnlyDurableStorage(sqliteSessionFile(root(), sessionId)),\n    async list() {\n      const directory = path.join(root(), DURABLE_DIRECTORY);\n      const files = await fs.readdir(directory).catch((error: NodeJS.ErrnoException) => {\n        if (error.code === 'ENOENT') return [];\n        throw error;\n      });\n      const stored: PoStoredSession[] = [];\n      for (const file of files) {\n        if (!/^[a-zA-Z0-9_-]+\\.sqlite$/u.test(file)) continue;\n        const { mtimeMs } = await fs.stat(path.join(directory, file));\n        stored.push({ sessionId: path.basename(file, '.sqlite'), updatedAt: mtimeMs });\n      }\n      return stored;\n    },\n    async remove(sessionId) {\n      const file = sqliteSessionFile(root(), sessionId);\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      let lease: Awaited<ReturnType<HistoryOwnership['acquire']>>;\n      try {\n        lease = await historyOwnership.acquire(file);\n      } catch (error) {\n        const cause = error instanceof Error ? (error.cause as NodeJS.ErrnoException | undefined) : undefined;\n        if (cause?.code === 'EEXIST') return 'busy';\n        throw error;\n      }\n      try {\n        for (const suffix of ['', '-wal', '-shm']) await fs.rm(`${file}${suffix}`, { force: true });\n      } finally {\n        // Releasing removes the lock file, so a removed session leaves no lock behind.\n        await lease.release();\n      }\n      return 'removed';\n    },\n  };\n}\n\n/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */\nexport function createNodePlatform(options: NodePlatformOptions = {}): PoPlatform {\n  return {\n    abiVersion: 1,\n    homeDirectory: options.homeDirectory ?? os.homedir(),\n    // Secure session-file protection and viewing currently require POSIX ownership semantics.\n    temporaryDirectory:\n      process.platform === 'darwin' || process.platform === 'linux'\n        ? (options.temporaryDirectory ?? os.tmpdir())\n        : undefined,\n    env: (cwd) => new NodeExecutionEnv({ cwd }),\n    sqlite: { abiVersion: 1, open: openNodeSqliteDatabase },\n    sessions: createNodeSessions(options),\n  };\n}\n"],"mappings":";;;;;;;;;AAaA,MAAM,cAAc;AACpB,MAAM,yBAAyB;AAC/B,MAAM,uBAAuB;;AAG7B,eAAsB,uBAAuB,MAAc;CACzD,MAAM,WAAW,KAAK,IAAI,IAAI;CAC9B,SACE,IAAI;EACF,OAAO,MAAMA,yBAAa,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,WAAW,KAAK,IAAI,CAAC,EAAE,CAAC;CACvF,SAAS,OAAO;EACd,IAAI,EAAE,iBAAiB,UAAU,EAAE,aAAa,UAAU,MAAM,YAAY,eAAe,KAAK,IAAI,KAAK,UACvG,MAAM;EACR,MAAM,IAAI,SAAS,YAAY,WAAW,SAAS,oBAAoB,CAAC;CAC1E;AAEJ;;AAcA,SAAS,mBAAmB,SAAuD;CACjF,IAAI,mBAAmB,QAAQ;CAC/B,MAAM,aAAa;EACjB,IAAI,QAAQ,iBAAiB,KAAA,GAAW,MAAM,IAAI,MAAM,gDAAgD;EACxG,OAAO,QAAQ;CACjB;CACA,OAAO;EACL,YAAY;EACZ,MAAM,KAAK,SAAS,SAAS;GAC3B,qBAAqB,uBAAuB,EAAE,cAAc,SAAS,CAAC;GACtE,MAAM,SAAS,MAAM,yBAAyB;IAAE,GAAG;IAAS,cAAc,KAAK;IAAG;GAAiB,GAAG,OAAO;GAC7G,OAAO;IACL,SAAS,OAAO;IAChB,sBAAsB,OAAO,aAAa,gBAAgB;IAC1D,MAAM,QAAQ,gBAAgB;KAE5B,MAAM,OAAO,QAAQ,MAAM,cAAc;KACzC,MAAM,OAAO,aAAa,QAAQ;IACpC;GACF;EACF;EACA,cAAc,OAAO,cAAc,2BAA2B,kBAAkB,KAAK,GAAG,SAAS,CAAC;EAClG,MAAM,OAAO;GACX,MAAM,YAAY,KAAK,KAAK,KAAK,GAAG,iBAAiB;GACrD,MAAM,QAAQ,MAAM,GAAG,QAAQ,SAAS,CAAC,CAAC,OAAO,UAAiC;IAChF,IAAI,MAAM,SAAS,UAAU,OAAO,CAAC;IACrC,MAAM;GACR,CAAC;GACD,MAAM,SAA4B,CAAC;GACnC,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,CAAC,4BAA4B,KAAK,IAAI,GAAG;IAC7C,MAAM,EAAE,YAAY,MAAM,GAAG,KAAK,KAAK,KAAK,WAAW,IAAI,CAAC;IAC5D,OAAO,KAAK;KAAE,WAAW,KAAK,SAAS,MAAM,SAAS;KAAG,WAAW;IAAQ,CAAC;GAC/E;GACA,OAAO;EACT;EACA,MAAM,OAAO,WAAW;GACtB,MAAM,OAAO,kBAAkB,KAAK,GAAG,SAAS;GAChD,qBAAqB,uBAAuB,EAAE,cAAc,SAAS,CAAC;GACtE,IAAI;GACJ,IAAI;IACF,QAAQ,MAAM,iBAAiB,QAAQ,IAAI;GAC7C,SAAS,OAAO;IAEd,KADc,iBAAiB,QAAS,MAAM,QAA8C,KAAA,EAAA,EACjF,SAAS,UAAU,OAAO;IACrC,MAAM;GACR;GACA,IAAI;IACF,KAAK,MAAM,UAAU;KAAC;KAAI;KAAQ;IAAM,GAAG,MAAM,GAAG,GAAG,GAAG,OAAO,UAAU,EAAE,OAAO,KAAK,CAAC;GAC5F,UAAU;IAER,MAAM,MAAM,QAAQ;GACtB;GACA,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,mBAAmB,UAA+B,CAAC,GAAe;CAChF,OAAO;EACL,YAAY;EACZ,eAAe,QAAQ,iBAAiB,GAAG,QAAQ;EAEnD,oBACE,QAAQ,aAAa,YAAY,QAAQ,aAAa,UACjD,QAAQ,sBAAsB,GAAG,OAAO,IACzC,KAAA;EACN,MAAM,QAAQ,IAAI,iBAAiB,EAAE,IAAI,CAAC;EAC1C,QAAQ;GAAE,YAAY;GAAG,MAAM;EAAuB;EACtD,UAAU,mBAAmB,OAAO;CACtC;AACF"}
+{"version":3,"file":"nodePlatform.mjs","names":["openDatabase"],"sources":["../src/services/nodePlatform/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { NodeExecutionEnv, type NodeWatchOptions } from '@earendil-works/pi-durable/env/node';\nimport { openNodeSqliteDatabase as openDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoPlatform, PoSessionStorageService, PoStoredSession } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY } from '../durableSession';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport type { HistoryOwnership } from '../historyOwnership/type';\nimport { openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile } from '../sqliteSessionStorage';\n\nconst SQLITE_BUSY = 5;\nconst SQLITE_OPEN_TIMEOUT_MS = 5_000;\nconst SQLITE_OPEN_RETRY_MS = 10;\n\n/** Concurrent WAL initialization can return SQLITE_BUSY without waiting for SQLite's busy timeout. */\nexport async function openNodeSqliteDatabase(file: string) {\n  const deadline = Date.now() + SQLITE_OPEN_TIMEOUT_MS;\n  for (;;) {\n    try {\n      return await openDatabase(file, { busyTimeoutMs: Math.max(0, deadline - Date.now()) });\n    } catch (error) {\n      if (!(error instanceof Error) || !('errcode' in error) || error.errcode !== SQLITE_BUSY || Date.now() >= deadline)\n        throw error;\n      await new Promise((resolve) => setTimeout(resolve, SQLITE_OPEN_RETRY_MS));\n    }\n  }\n}\n\nexport interface NodePlatformOptions {\n  /** Defaults to the user's home directory. */\n  readonly homeDirectory?: string;\n  /** Host-admitted override; defaults to this Node host's OS temporary directory. */\n  readonly temporaryDirectory?: string;\n  /** Where the launching entry keeps agent sessions. Without it `sessions` refuses every call. */\n  readonly sessionsRoot?: string;\n  /** Shared ownership for every session this platform opens; created on first open when absent. */\n  readonly historyOwnership?: HistoryOwnership;\n  /** Host-selected watcher settings; omission retains the upstream defaults. */\n  readonly watch?: NodeWatchOptions;\n}\n\n/** One lock-owned durable-v1 SQLite file per agent session. */\nfunction createNodeSessions(options: NodePlatformOptions): PoSessionStorageService {\n  let historyOwnership = options.historyOwnership;\n  const root = () => {\n    if (options.sessionsRoot === undefined) throw new Error('This Node platform was given no sessions root.');\n    return options.sessionsRoot;\n  };\n  return {\n    abiVersion: 1,\n    async open(request, context) {\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      const opened = await openSqliteSessionStorage({ ...request, sessionsRoot: root(), historyOwnership }, context);\n      return {\n        storage: opened.storage,\n        assertWritable: () => opened.historyLease.assertQuiescent(),\n        async release(releaseContext) {\n          // The lease outlives a failed close so no second writer opens a file still being written.\n          await opened.session.close(releaseContext);\n          await opened.historyLease.release();\n        },\n      };\n    },\n    openReadOnly: async (sessionId) => openReadOnlyDurableStorage(sqliteSessionFile(root(), sessionId)),\n    async list() {\n      const directory = path.join(root(), DURABLE_DIRECTORY);\n      const files = await fs.readdir(directory).catch((error: NodeJS.ErrnoException) => {\n        if (error.code === 'ENOENT') return [];\n        throw error;\n      });\n      const stored: PoStoredSession[] = [];\n      for (const file of files) {\n        if (!/^[a-zA-Z0-9_-]+\\.sqlite$/u.test(file)) continue;\n        const { mtimeMs } = await fs.stat(path.join(directory, file));\n        stored.push({ sessionId: path.basename(file, '.sqlite'), updatedAt: mtimeMs });\n      }\n      return stored;\n    },\n    async remove(sessionId) {\n      const file = sqliteSessionFile(root(), sessionId);\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      let lease: Awaited<ReturnType<HistoryOwnership['acquire']>>;\n      try {\n        lease = await historyOwnership.acquire(file);\n      } catch (error) {\n        const cause = error instanceof Error ? (error.cause as NodeJS.ErrnoException | undefined) : undefined;\n        if (cause?.code === 'EEXIST') return 'busy';\n        throw error;\n      }\n      try {\n        for (const suffix of ['', '-wal', '-shm']) await fs.rm(`${file}${suffix}`, { force: true });\n      } finally {\n        // Releasing removes the lock file, so a removed session leaves no lock behind.\n        await lease.release();\n      }\n      return 'removed';\n    },\n  };\n}\n\n/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */\nexport function createNodePlatform(options: NodePlatformOptions = {}): PoPlatform {\n  return {\n    abiVersion: 1,\n    homeDirectory: options.homeDirectory ?? os.homedir(),\n    // Secure session-file protection and viewing currently require POSIX ownership semantics.\n    temporaryDirectory:\n      process.platform === 'darwin' || process.platform === 'linux'\n        ? (options.temporaryDirectory ?? os.tmpdir())\n        : undefined,\n    env: (cwd) => new NodeExecutionEnv({ cwd, watch: options.watch }),\n    sqlite: { abiVersion: 1, open: openNodeSqliteDatabase },\n    sessions: createNodeSessions(options),\n  };\n}\n"],"mappings":";;;;;;;;;AAaA,MAAM,cAAc;AACpB,MAAM,yBAAyB;AAC/B,MAAM,uBAAuB;;AAG7B,eAAsB,uBAAuB,MAAc;CACzD,MAAM,WAAW,KAAK,IAAI,IAAI;CAC9B,SACE,IAAI;EACF,OAAO,MAAMA,yBAAa,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,WAAW,KAAK,IAAI,CAAC,EAAE,CAAC;CACvF,SAAS,OAAO;EACd,IAAI,EAAE,iBAAiB,UAAU,EAAE,aAAa,UAAU,MAAM,YAAY,eAAe,KAAK,IAAI,KAAK,UACvG,MAAM;EACR,MAAM,IAAI,SAAS,YAAY,WAAW,SAAS,oBAAoB,CAAC;CAC1E;AAEJ;;AAgBA,SAAS,mBAAmB,SAAuD;CACjF,IAAI,mBAAmB,QAAQ;CAC/B,MAAM,aAAa;EACjB,IAAI,QAAQ,iBAAiB,KAAA,GAAW,MAAM,IAAI,MAAM,gDAAgD;EACxG,OAAO,QAAQ;CACjB;CACA,OAAO;EACL,YAAY;EACZ,MAAM,KAAK,SAAS,SAAS;GAC3B,qBAAqB,uBAAuB,EAAE,cAAc,SAAS,CAAC;GACtE,MAAM,SAAS,MAAM,yBAAyB;IAAE,GAAG;IAAS,cAAc,KAAK;IAAG;GAAiB,GAAG,OAAO;GAC7G,OAAO;IACL,SAAS,OAAO;IAChB,sBAAsB,OAAO,aAAa,gBAAgB;IAC1D,MAAM,QAAQ,gBAAgB;KAE5B,MAAM,OAAO,QAAQ,MAAM,cAAc;KACzC,MAAM,OAAO,aAAa,QAAQ;IACpC;GACF;EACF;EACA,cAAc,OAAO,cAAc,2BAA2B,kBAAkB,KAAK,GAAG,SAAS,CAAC;EAClG,MAAM,OAAO;GACX,MAAM,YAAY,KAAK,KAAK,KAAK,GAAG,iBAAiB;GACrD,MAAM,QAAQ,MAAM,GAAG,QAAQ,SAAS,CAAC,CAAC,OAAO,UAAiC;IAChF,IAAI,MAAM,SAAS,UAAU,OAAO,CAAC;IACrC,MAAM;GACR,CAAC;GACD,MAAM,SAA4B,CAAC;GACnC,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,CAAC,4BAA4B,KAAK,IAAI,GAAG;IAC7C,MAAM,EAAE,YAAY,MAAM,GAAG,KAAK,KAAK,KAAK,WAAW,IAAI,CAAC;IAC5D,OAAO,KAAK;KAAE,WAAW,KAAK,SAAS,MAAM,SAAS;KAAG,WAAW;IAAQ,CAAC;GAC/E;GACA,OAAO;EACT;EACA,MAAM,OAAO,WAAW;GACtB,MAAM,OAAO,kBAAkB,KAAK,GAAG,SAAS;GAChD,qBAAqB,uBAAuB,EAAE,cAAc,SAAS,CAAC;GACtE,IAAI;GACJ,IAAI;IACF,QAAQ,MAAM,iBAAiB,QAAQ,IAAI;GAC7C,SAAS,OAAO;IAEd,KADc,iBAAiB,QAAS,MAAM,QAA8C,KAAA,EAAA,EACjF,SAAS,UAAU,OAAO;IACrC,MAAM;GACR;GACA,IAAI;IACF,KAAK,MAAM,UAAU;KAAC;KAAI;KAAQ;IAAM,GAAG,MAAM,GAAG,GAAG,GAAG,OAAO,UAAU,EAAE,OAAO,KAAK,CAAC;GAC5F,UAAU;IAER,MAAM,MAAM,QAAQ;GACtB;GACA,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,mBAAmB,UAA+B,CAAC,GAAe;CAChF,OAAO;EACL,YAAY;EACZ,eAAe,QAAQ,iBAAiB,GAAG,QAAQ;EAEnD,oBACE,QAAQ,aAAa,YAAY,QAAQ,aAAa,UACjD,QAAQ,sBAAsB,GAAG,OAAO,IACzC,KAAA;EACN,MAAM,QAAQ,IAAI,iBAAiB;GAAE;GAAK,OAAO,QAAQ;EAAM,CAAC;EAChE,QAAQ;GAAE,YAAY;GAAG,MAAM;EAAuB;EACtD,UAAU,mBAAmB,OAAO;CACtC;AACF"}

package/dist/packageApiServer.cjs

@@ -138,6 +138,7 @@ async function serveSessionApis(options) {
 		sessionStorage: options.platform.sessions,
 		cwd: options.cwd,
 		environment: options.environment,
+		...options.clientPlugins === void 0 ? {} : { clientPlugins: options.clientPlugins },
 		directEvents: options.directEvents,
 		...options.computerUse === void 0 ? {} : { computerUse: options.computerUse },
 		...options.shareFile === void 0 ? {} : { shareFile: options.shareFile },

package/dist/packageApiServer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"packageApiServer.cjs","names":["SESSION_FILES_API","readAccessibleFile","prepareSessionEnvironment","createPoServerHost","createFileAccess","PO_SESSION_TEMP_DIR","path","PoServerScope","PO_FILE_ACCESS_SERVICE","PO_API_ROUTE_PREFIX","validatedTraceContext","OperationCancelledError"],"sources":["../src/server/packageApiServer.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport { SESSION_FILES_API } from '../constants/sessionFiles';\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 PoServerPackageFailure,\n  type PoServerPlugin,\n  PoServerScope,\n} from '../exports/serverPlugin';\nimport {\n  createFileAccess,\n  PO_FILE_ACCESS_SERVICE,\n  type PoFileAccess,\n  readAccessibleFile,\n} from '../services/fileAccess';\nimport type { PoTraceContext } from '../services/poTelemetry';\nimport { observe, type ServerTelemetry } from '../services/serverTelemetry';\nimport { PO_SESSION_TEMP_DIR, prepareSessionEnvironment } from '../services/sessionFiles';\nimport { OperationCancelledError } from '../services/telemetry';\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/** A body this large is worth a span however fast it flushed: big bodies drive heap spikes. */\nexport const COMPLETION_SPAN_MIN_BYTES = 1024 * 1024;\n\n/** A coarse body class, so a size can be attributed without recording a path or file name. */\nexport function contentClass(contentType: string | null): string {\n  const type = contentType?.split(';')[0]?.trim().toLowerCase() ?? '';\n  if (type === '') return 'none';\n  if (type.startsWith('image/')) return 'image';\n  if (type.endsWith('json')) return 'json';\n  if (type.startsWith('text/')) return 'text';\n  return 'binary';\n}\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 shareRegisteredFile?: PoApiContext['shareRegisteredFile'];\n  readonly mediaArbitration?: PoApiContext['mediaArbitration'];\n  readonly executionBudget?: PoApiContext['executionBudget'];\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 operation?: (basePath: string, method: string, path: string) => string | undefined;\n  readonly request: (request: Request) => Promise<Response>;\n  /**\n   * Brings the session's installed packages up to date: changed and added `packages` install with\n   * per-package rollback, and installed ones no longer `declared` are disposed. A declared package\n   * whose new build failed to load is absent from `packages` but keeps its running build.\n   */\n  readonly reconcile?: (\n    packages: readonly (PoServerPlugin | LoadedServerPackage)[],\n    declared: readonly string[],\n  ) => Promise<PackageReconcileResult>;\n  close(): Promise<void>;\n}\n\nexport interface PackageReconcileResult {\n  readonly installed: readonly string[];\n  readonly removed: readonly string[];\n  readonly failed: readonly PoServerPackageFailure[];\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction responseWithCompletion(response: Response, complete: (bytes: number) => void): Response {\n  if (response.body === null) {\n    complete(0);\n    return response;\n  }\n  const reader = response.body.getReader();\n  let completed = false;\n  let bytes = 0;\n  const finish = (): void => {\n    if (completed) return;\n    completed = true;\n    complete(bytes);\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 {\n          bytes += result.value.byteLength;\n          controller.enqueue(result.value);\n        }\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/** Reads files under the session's open folders; the hub's session `/file` route forwards here. */\nfunction sessionFilesApi(fileAccess: PoFileAccess, cwd: string): PoApi {\n  return {\n    basePath: SESSION_FILES_API,\n    start: () => ({\n      fetch: (request) => {\n        if (request.method !== 'GET') return Response.json({ error: 'Method not allowed.' }, { status: 405 });\n        return readAccessibleFile({\n          roots: fileAccess.roots(),\n          cwd,\n          path: new URL(request.url).searchParams.get('path'),\n          ...(request.headers.get('range') === null ? {} : { range: request.headers.get('range')! }),\n          ...(request.headers.get('if-match') === null ? {} : { expectedVersion: request.headers.get('if-match')! }),\n        });\n      },\n      close: () => undefined,\n    }),\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, releaseOptions) =>\n                  ownedRelease(sessionId, {\n                    ...(releaseOptions?.onlyIfIdle === undefined ? {} : { onlyIfIdle: releaseOptions.onlyIfIdle }),\n                    parentSessionId: options.sessionId,\n                  }),\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.shareRegisteredFile === undefined ? {} : { shareRegisteredFile: options.shareRegisteredFile }),\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 = createPoServerHost({\n    scope: 'session',\n    context,\n    mountChannel: options.mountChannel,\n    ...(options.pluginRegistry === undefined ? {} : { pluginRegistry: options.pluginRegistry }),\n  });\n  // The session's own folder, its workspace and the temp folders of every session under this Po home;\n  // extensions open their own beside these.\n  const fileAccess = createFileAccess();\n  const tempDirectory = options.environment[PO_SESSION_TEMP_DIR];\n  const sessionsTemp =\n    tempDirectory !== undefined && path.basename(path.dirname(tempDirectory)) === 'sessions'\n      ? path.dirname(tempDirectory)\n      : tempDirectory;\n  for (const directory of [options.cwd, options.workspaceRoot, sessionsTemp])\n    if (directory !== undefined && path.isAbsolute(directory)) fileAccess.register(directory);\n  let scope: PoServerScope | undefined;\n  const installOptions = (failed?: PoServerPackageFailure[]) => ({\n    onNotice: options.onNotice,\n    ...(failed === undefined ? {} : { onPackageFailed: (failure: PoServerPackageFailure) => failed.push(failure) }),\n    onPackageSettled: (report: { packageName: string; outcome: string; durationMs: number }) => {\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  try {\n    // Registered first, so no package can claim the host's own base path.\n    host.registerApi(sessionFilesApi(fileAccess, options.cwd));\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 scope.root.plugin((root) => {\n      root.provide(PO_FILE_ACCESS_SERVICE, fileAccess);\n    });\n    await options.preparePackages?.(scope.root);\n    const installed = await scope.install(packages, installOptions());\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  const reconcile = async (\n    next: readonly (PoServerPlugin | LoadedServerPackage)[],\n    declared: readonly string[],\n  ): Promise<PackageReconcileResult> => {\n    const failed: PoServerPackageFailure[] = [];\n    const installed = await sessionScope.install(next, installOptions(failed));\n    const removed = installed.filter((name) => !declared.includes(name));\n    return { installed: await sessionScope.uninstall(removed), removed, failed };\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(`${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        const incoming = new Request(url, request);\n        try {\n          return await handler.fetch(incoming);\n        } catch (error) {\n          if (incoming.signal.aborted && (error === incoming.signal.reason || error instanceof OperationCancelledError))\n            return new Response(null, { status: 499 });\n          throw error;\n        }\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    // A long poll waits before its headers; only time spent after them is a slow flush.\n    const headersAt = performance.now();\n    return responseWithCompletion(response, (responseBytes) => {\n      if (!options.telemetry) return;\n      const now = performance.now();\n      const durationMs = Math.round(now - startedAt);\n      // Keep this span only where it says something the request span cannot: a failing status,\n      // a body that took real time to flush after the headers were sent, or a large body.\n      if (\n        response.status < 400 &&\n        now - headersAt < COMPLETION_SPAN_MIN_DURATION_MS &&\n        responseBytes < COMPLETION_SPAN_MIN_BYTES\n      )\n        return;\n      const requestBytes = Number(request.headers.get('content-length'));\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            response_bytes: responseBytes,\n            response_kind: contentClass(response.headers.get('content-type')),\n            ...(Number.isFinite(requestBytes) && requestBytes > 0 ? { request_bytes: requestBytes } : {}),\n          },\n          async () => undefined,\n          childContext ?? parent,\n        ),\n        options.onNotice,\n      );\n    });\n  };\n  let closePromise: Promise<void> | undefined;\n\n  return {\n    operation: (basePath, method, path) => scope?.apiOperation(basePath, method, path),\n    request: dispatch,\n    reconcile,\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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"}
+{"version":3,"file":"packageApiServer.cjs","names":["SESSION_FILES_API","readAccessibleFile","prepareSessionEnvironment","createPoServerHost","createFileAccess","PO_SESSION_TEMP_DIR","path","PoServerScope","PO_FILE_ACCESS_SERVICE","PO_API_ROUTE_PREFIX","validatedTraceContext","OperationCancelledError"],"sources":["../src/server/packageApiServer.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport { SESSION_FILES_API } from '../constants/sessionFiles';\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 PoServerPackageFailure,\n  type PoServerPlugin,\n  PoServerScope,\n} from '../exports/serverPlugin';\nimport {\n  createFileAccess,\n  PO_FILE_ACCESS_SERVICE,\n  type PoFileAccess,\n  readAccessibleFile,\n} from '../services/fileAccess';\nimport type { PoTraceContext } from '../services/poTelemetry';\nimport { observe, type ServerTelemetry } from '../services/serverTelemetry';\nimport { PO_SESSION_TEMP_DIR, prepareSessionEnvironment } from '../services/sessionFiles';\nimport { OperationCancelledError } from '../services/telemetry';\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/** A body this large is worth a span however fast it flushed: big bodies drive heap spikes. */\nexport const COMPLETION_SPAN_MIN_BYTES = 1024 * 1024;\n\n/** A coarse body class, so a size can be attributed without recording a path or file name. */\nexport function contentClass(contentType: string | null): string {\n  const type = contentType?.split(';')[0]?.trim().toLowerCase() ?? '';\n  if (type === '') return 'none';\n  if (type.startsWith('image/')) return 'image';\n  if (type.endsWith('json')) return 'json';\n  if (type.startsWith('text/')) return 'text';\n  return 'binary';\n}\n\nexport interface PackageApiServerOptions {\n  sessionId: string;\n  workspaceId?: string;\n  workspaceRoot?: string;\n  sessionContext?: PoApiContext['sessionContext'];\n  clientPlugins?: PoApiContext['clientPlugins'];\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 shareRegisteredFile?: PoApiContext['shareRegisteredFile'];\n  readonly mediaArbitration?: PoApiContext['mediaArbitration'];\n  readonly executionBudget?: PoApiContext['executionBudget'];\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 operation?: (basePath: string, method: string, path: string) => string | undefined;\n  readonly request: (request: Request) => Promise<Response>;\n  /**\n   * Brings the session's installed packages up to date: changed and added `packages` install with\n   * per-package rollback, and installed ones no longer `declared` are disposed. A declared package\n   * whose new build failed to load is absent from `packages` but keeps its running build.\n   */\n  readonly reconcile?: (\n    packages: readonly (PoServerPlugin | LoadedServerPackage)[],\n    declared: readonly string[],\n  ) => Promise<PackageReconcileResult>;\n  close(): Promise<void>;\n}\n\nexport interface PackageReconcileResult {\n  readonly installed: readonly string[];\n  readonly removed: readonly string[];\n  readonly failed: readonly PoServerPackageFailure[];\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction responseWithCompletion(response: Response, complete: (bytes: number) => void): Response {\n  if (response.body === null) {\n    complete(0);\n    return response;\n  }\n  const reader = response.body.getReader();\n  let completed = false;\n  let bytes = 0;\n  const finish = (): void => {\n    if (completed) return;\n    completed = true;\n    complete(bytes);\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 {\n          bytes += result.value.byteLength;\n          controller.enqueue(result.value);\n        }\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/** Reads files under the session's open folders; the hub's session `/file` route forwards here. */\nfunction sessionFilesApi(fileAccess: PoFileAccess, cwd: string): PoApi {\n  return {\n    basePath: SESSION_FILES_API,\n    start: () => ({\n      fetch: (request) => {\n        if (request.method !== 'GET') return Response.json({ error: 'Method not allowed.' }, { status: 405 });\n        return readAccessibleFile({\n          roots: fileAccess.roots(),\n          cwd,\n          path: new URL(request.url).searchParams.get('path'),\n          ...(request.headers.get('range') === null ? {} : { range: request.headers.get('range')! }),\n          ...(request.headers.get('if-match') === null ? {} : { expectedVersion: request.headers.get('if-match')! }),\n        });\n      },\n      close: () => undefined,\n    }),\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, releaseOptions) =>\n                  ownedRelease(sessionId, {\n                    ...(releaseOptions?.onlyIfIdle === undefined ? {} : { onlyIfIdle: releaseOptions.onlyIfIdle }),\n                    parentSessionId: options.sessionId,\n                  }),\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    ...(options.clientPlugins === undefined ? {} : { clientPlugins: options.clientPlugins }),\n    directEvents: options.directEvents,\n    ...(options.computerUse === undefined ? {} : { computerUse: options.computerUse }),\n    ...(options.shareFile === undefined ? {} : { shareFile: options.shareFile }),\n    ...(options.shareRegisteredFile === undefined ? {} : { shareRegisteredFile: options.shareRegisteredFile }),\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 = createPoServerHost({\n    scope: 'session',\n    context,\n    mountChannel: options.mountChannel,\n    ...(options.pluginRegistry === undefined ? {} : { pluginRegistry: options.pluginRegistry }),\n  });\n  // The session's own folder, its workspace and the temp folders of every session under this Po home;\n  // extensions open their own beside these.\n  const fileAccess = createFileAccess();\n  const tempDirectory = options.environment[PO_SESSION_TEMP_DIR];\n  const sessionsTemp =\n    tempDirectory !== undefined && path.basename(path.dirname(tempDirectory)) === 'sessions'\n      ? path.dirname(tempDirectory)\n      : tempDirectory;\n  for (const directory of [options.cwd, options.workspaceRoot, sessionsTemp])\n    if (directory !== undefined && path.isAbsolute(directory)) fileAccess.register(directory);\n  let scope: PoServerScope | undefined;\n  const installOptions = (failed?: PoServerPackageFailure[]) => ({\n    onNotice: options.onNotice,\n    ...(failed === undefined ? {} : { onPackageFailed: (failure: PoServerPackageFailure) => failed.push(failure) }),\n    onPackageSettled: (report: { packageName: string; outcome: string; durationMs: number }) => {\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  try {\n    // Registered first, so no package can claim the host's own base path.\n    host.registerApi(sessionFilesApi(fileAccess, options.cwd));\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 scope.root.plugin((root) => {\n      root.provide(PO_FILE_ACCESS_SERVICE, fileAccess);\n    });\n    await options.preparePackages?.(scope.root);\n    const installed = await scope.install(packages, installOptions());\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  const reconcile = async (\n    next: readonly (PoServerPlugin | LoadedServerPackage)[],\n    declared: readonly string[],\n  ): Promise<PackageReconcileResult> => {\n    const failed: PoServerPackageFailure[] = [];\n    const installed = await sessionScope.install(next, installOptions(failed));\n    const removed = installed.filter((name) => !declared.includes(name));\n    return { installed: await sessionScope.uninstall(removed), removed, failed };\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(`${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        const incoming = new Request(url, request);\n        try {\n          return await handler.fetch(incoming);\n        } catch (error) {\n          if (incoming.signal.aborted && (error === incoming.signal.reason || error instanceof OperationCancelledError))\n            return new Response(null, { status: 499 });\n          throw error;\n        }\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    // A long poll waits before its headers; only time spent after them is a slow flush.\n    const headersAt = performance.now();\n    return responseWithCompletion(response, (responseBytes) => {\n      if (!options.telemetry) return;\n      const now = performance.now();\n      const durationMs = Math.round(now - startedAt);\n      // Keep this span only where it says something the request span cannot: a failing status,\n      // a body that took real time to flush after the headers were sent, or a large body.\n      if (\n        response.status < 400 &&\n        now - headersAt < COMPLETION_SPAN_MIN_DURATION_MS &&\n        responseBytes < COMPLETION_SPAN_MIN_BYTES\n      )\n        return;\n      const requestBytes = Number(request.headers.get('content-length'));\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            response_bytes: responseBytes,\n            response_kind: contentClass(response.headers.get('content-type')),\n            ...(Number.isFinite(requestBytes) && requestBytes > 0 ? { request_bytes: requestBytes } : {}),\n          },\n          async () => undefined,\n          childContext ?? parent,\n        ),\n        options.onNotice,\n      );\n    });\n  };\n  let closePromise: Promise<void> | undefined;\n\n  return {\n    operation: (basePath, method, path) => scope?.apiOperation(basePath, method, path),\n    request: dispatch,\n    reconcile,\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

@@ -29,6 +29,7 @@ export interface PackageApiServerOptions {
   workspaceId?: string;
   workspaceRoot?: string;
   sessionContext?: PoApiContext['sessionContext'];
+  clientPlugins?: PoApiContext['clientPlugins'];
   homeDirectory?: string;
   mountChannel?: CreatePoServerHostOptions['mountChannel'];
   cwd: string;

package/dist/packageApiServer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"packageApiServer.d.mts","names":[],"sources":["../src/server/packageApiServer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBAkCa;;qBAEA;;wBAGG,aAAa;iBASZ;EACf;EACA;EACA;EACA,iBAAiB;EACjB;EACA,eAAe;EACf;;WAES,aAAa,SAAS;;WAEtB,cAAc;WACd,cAAc;;WAEd,YAAY;WACZ,sBAAsB;WACtB,mBAAmB;WACnB,kBAAkB;WAClB,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,aAAa,kBAAkB,gBAAgB;WAC/C,UAAU,SAAS,YAAY,QAAQ;;;;;;WAMvC,aACP,oBAAoB,iBAAiB,wBACrC,gCACG,QAAQ;EACb,SAAS;;iBAGM;WACN;WACA;WACA,iBAAiB;;;wBAgEN,iBAAiB,SAAS,0BAA0B,QAAQ"}
+{"version":3,"file":"packageApiServer.d.mts","names":[],"sources":["../src/server/packageApiServer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBAkCa;;qBAEA;;wBAGG,aAAa;iBASZ;EACf;EACA;EACA;EACA,iBAAiB;EACjB,gBAAgB;EAChB;EACA,eAAe;EACf;;WAES,aAAa,SAAS;;WAEtB,cAAc;WACd,cAAc;;WAEd,YAAY;WACZ,sBAAsB;WACtB,mBAAmB;WACnB,kBAAkB;WAClB,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,aAAa,kBAAkB,gBAAgB;WAC/C,UAAU,SAAS,YAAY,QAAQ;;;;;;WAMvC,aACP,oBAAoB,iBAAiB,wBACrC,gCACG,QAAQ;EACb,SAAS;;iBAGM;WACN;WACA;WACA,iBAAiB;;;wBAgEN,iBAAiB,SAAS,0BAA0B,QAAQ"}

package/dist/packageApiServer.mjs

@@ -135,6 +135,7 @@ async function serveSessionApis(options) {
 		sessionStorage: options.platform.sessions,
 		cwd: options.cwd,
 		environment: options.environment,
+		...options.clientPlugins === void 0 ? {} : { clientPlugins: options.clientPlugins },
 		directEvents: options.directEvents,
 		...options.computerUse === void 0 ? {} : { computerUse: options.computerUse },
 		...options.shareFile === void 0 ? {} : { shareFile: options.shareFile },