@agimon-ai/po-core 0.0.0-alpha.0

package/dist/runtimeTransition.d.mts

@@ -0,0 +1,114 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/transition.d.ts
+export type TransitionAxis = 'domains' | 'major-mode' | 'live' | 'profile';
+export type TransitionDisposition = 'live' | 'reload' | 'relaunch' | 'sync-required';
+export type TransitionExecutionStrategy = 'pi-reload' | 'process-relaunch';
+export type TransitionOutcome = 'applied' | 'queued' | 'unchanged' | 'rejected' | 'stale';
+export type TransitionSource = 'voice' | 'command' | 'leader' | 'ui' | 'system';
+/** Runtime identities captured when a transition enters the serialized queue. */
+export interface TransitionGeneration {
+  readonly sessionId: string;
+  readonly hostGeneration: string;
+  readonly configGeneration?: string;
+}
+export interface TransitionSelectionSnapshot {
+  readonly domains: readonly string[];
+  readonly majorMode: string;
+  readonly layers: readonly string[];
+  readonly profile?: string;
+  readonly compositionFingerprint?: string;
+  readonly parentActivation?: readonly string[];
+  readonly childActivation?: readonly string[];
+}
+export interface DomainTransitionTarget {
+  readonly axis: 'domains';
+  readonly domains: readonly string[];
+}
+export interface MajorModeTransitionTarget {
+  readonly axis: 'major-mode';
+  readonly majorMode: string;
+}
+export interface LiveTransitionTarget {
+  readonly axis: 'live';
+  readonly capability: string;
+}
+export interface ProfileTransitionTarget {
+  readonly axis: 'profile';
+  readonly profile: string;
+}
+export type TransitionTarget = DomainTransitionTarget | MajorModeTransitionTarget | LiveTransitionTarget | ProfileTransitionTarget;
+export interface DoomTransitionRequest {
+  readonly sessionId: string;
+  readonly hostGeneration: string;
+  readonly operationId: string;
+  readonly source: TransitionSource;
+  readonly target: TransitionTarget;
+  readonly signal?: AbortSignal;
+}
+export type TransitionSynchronization = {
+  readonly kind: 'launcher';
+} |
+/**
+ * A launcher session whose Pi entry resolves its composition on every load.
+ *
+ * Pi freezes the CLI extension list at construction, so a session handed a
+ * fingerprint-named bundle cannot change composition without a new process.
+ * One entry that reads the selection when its factory runs lifts that limit:
+ * the list Pi holds never changes, and a reload composes again. Such a
+ * session is never `sync-required`, because the entry falls back to the
+ * individual extension paths when no aggregate has been built yet.
+ */
+{
+  readonly kind: 'launcher-composed';
+} | {
+  readonly kind: 'synchronized';
+  readonly resolutionAvailable: boolean;
+  readonly availableCompositionFingerprints: readonly string[];
+};
+export type TransitionDiagnosticCode = 'transition.live.capability' | 'transition.no-change' | 'transition.reload.domains' | 'transition.reload.major-mode' | 'transition.reload.profile' | 'transition.rejected.aborted' | 'transition.rejected.duplicate' | 'transition.rejected.execution' | 'transition.rejected.unavailable' | 'transition.relaunch.extension-closure' | 'transition.stale.generation' | 'transition.stale.config' | 'transition.stale.session' | 'transition.sync-required.artifact' | 'transition.sync-required.resolution';
+export interface DoomTransitionPlan {
+  readonly operationId: string;
+  readonly axis: TransitionAxis;
+  readonly disposition: TransitionDisposition;
+  readonly strategy?: TransitionExecutionStrategy;
+  readonly previous: TransitionSelectionSnapshot;
+  readonly candidate: TransitionSelectionSnapshot;
+  readonly diagnostics: readonly TransitionDiagnosticCode[];
+  readonly reloadHandoffRequired: boolean;
+  readonly externalRelaunchRequired: boolean;
+}
+export interface DoomTransitionResult extends DoomTransitionPlan {
+  readonly outcome: TransitionOutcome;
+}
+export type StructuralTransitionExecution = (request: DoomTransitionRequest, plan: DoomTransitionPlan) => Promise<TransitionOutcome>;
+/** Cordis service name the Po host publishes its transition coordinator under. */
+export declare const DOOM_TRANSITION_SERVICE = "doom/transition";
+/**
+ * The session-scoped object that serializes structural transitions.
+ *
+ * Declared here rather than beside its implementation because the packages that
+ * drive the selection axes resolve it from the session and must not depend on
+ * the host that builds it. plan() is deliberately synchronous and the result
+ * carries live values, so this contract is an in-process handle, not a wire
+ * protocol.
+ */
+export interface DoomTransitionCoordinator {
+  readonly sessionId: string;
+  readonly hostGeneration: string;
+  plan(request: DoomTransitionRequest): DoomTransitionPlan;
+  execute(request: DoomTransitionRequest, executeStructural?: StructuralTransitionExecution): Promise<DoomTransitionResult>;
+  dispose(): void;
+}
+/**
+ * Typed reads of the two host services off the session's cordis registry.
+ *
+ * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should
+ * declare the corresponding service name with `ctx.inject()` before reading it.
+ */
+export declare function readDoomTransitionCoordinator(root: Context): DoomTransitionCoordinator | undefined;
+/**
+ * The coordinator for an injected Cordis context.
+ */
+export declare function requireDoomTransitionCoordinator(context: Context): DoomTransitionCoordinator;
+//#endregion
+//# sourceMappingURL=runtimeTransition.d.mts.map

package/dist/runtimeTransition.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeTransition.d.mts","names":[],"sources":["../src/schemas/transition.ts"],"mappings":";;YAEY;YAEA;YAEA;YAEA;YAEA;;iBAGK;WACN;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;YAGC,mBACR,yBACA,4BACA,uBACA;iBAEa;WACN;WACA;WACA;WACA,QAAQ;WACR,QAAQ;WACR,SAAS;;YAGR;WACG;;;;;;;;;;;;;WAWA;;WAEA;WACA;WACA;;YAGH;iBAiBK;WACN;WACA,MAAM;WACN,aAAa;WACb,WAAW;WACX,UAAU;WACV,WAAW;WACX,sBAAsB;WACtB;WACA;;iBAGM,6BAA6B;WACnC,SAAS;;YAGR,iCACV,SAAS,uBACT,MAAM,uBACH,QAAQ;;qBAGA;;;;;;;;;;iBAWI;WACN;WACA;EACT,KAAK,SAAS,wBAAwB;EACtC,QACE,SAAS,uBACT,oBAAoB,gCACnB,QAAQ;EACX;;;;;;;;wBASc,8BAA8B,MAAM,UAAU;;;;wBAO9C,iCAAiC,SAAS,UAAU"}

package/dist/runtimeTransition.mjs

@@ -0,0 +1,24 @@
+//#region src/schemas/transition.ts
+/** Cordis service name the Po host publishes its transition coordinator under. */
+const DOOM_TRANSITION_SERVICE = "doom/transition";
+/**
+* Typed reads of the two host services off the session's cordis registry.
+*
+* Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should
+* declare the corresponding service name with `ctx.inject()` before reading it.
+*/
+function readDoomTransitionCoordinator(root) {
+	return root.get(DOOM_TRANSITION_SERVICE);
+}
+/**
+* The coordinator for an injected Cordis context.
+*/
+function requireDoomTransitionCoordinator(context) {
+	const coordinator = readDoomTransitionCoordinator(context);
+	if (!coordinator) throw new Error("Doom transition coordinator is unavailable. Load the Po parent runtime.");
+	return coordinator;
+}
+//#endregion
+export { DOOM_TRANSITION_SERVICE, readDoomTransitionCoordinator, requireDoomTransitionCoordinator };
+
+//# sourceMappingURL=runtimeTransition.mjs.map

package/dist/runtimeTransition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeTransition.mjs","names":[],"sources":["../src/schemas/transition.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\nexport type TransitionAxis = 'domains' | 'major-mode' | 'live' | 'profile';\n\nexport type TransitionDisposition = 'live' | 'reload' | 'relaunch' | 'sync-required';\n\nexport type TransitionExecutionStrategy = 'pi-reload' | 'process-relaunch';\n\nexport type TransitionOutcome = 'applied' | 'queued' | 'unchanged' | 'rejected' | 'stale';\n\nexport type TransitionSource = 'voice' | 'command' | 'leader' | 'ui' | 'system';\n\n/** Runtime identities captured when a transition enters the serialized queue. */\nexport interface TransitionGeneration {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly configGeneration?: string;\n}\n\nexport interface TransitionSelectionSnapshot {\n  readonly domains: readonly string[];\n  readonly majorMode: string;\n  readonly layers: readonly string[];\n  readonly profile?: string;\n  readonly compositionFingerprint?: string;\n  readonly parentActivation?: readonly string[];\n  readonly childActivation?: readonly string[];\n}\n\nexport interface DomainTransitionTarget {\n  readonly axis: 'domains';\n  readonly domains: readonly string[];\n}\n\nexport interface MajorModeTransitionTarget {\n  readonly axis: 'major-mode';\n  readonly majorMode: string;\n}\n\nexport interface LiveTransitionTarget {\n  readonly axis: 'live';\n  readonly capability: string;\n}\n\nexport interface ProfileTransitionTarget {\n  readonly axis: 'profile';\n  readonly profile: string;\n}\n\nexport type TransitionTarget =\n  | DomainTransitionTarget\n  | MajorModeTransitionTarget\n  | LiveTransitionTarget\n  | ProfileTransitionTarget;\n\nexport interface DoomTransitionRequest {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  readonly operationId: string;\n  readonly source: TransitionSource;\n  readonly target: TransitionTarget;\n  readonly signal?: AbortSignal;\n}\n\nexport type TransitionSynchronization =\n  | { readonly kind: 'launcher' }\n  /**\n   * A launcher session whose Pi entry resolves its composition on every load.\n   *\n   * Pi freezes the CLI extension list at construction, so a session handed a\n   * fingerprint-named bundle cannot change composition without a new process.\n   * One entry that reads the selection when its factory runs lifts that limit:\n   * the list Pi holds never changes, and a reload composes again. Such a\n   * session is never `sync-required`, because the entry falls back to the\n   * individual extension paths when no aggregate has been built yet.\n   */\n  | { readonly kind: 'launcher-composed' }\n  | {\n      readonly kind: 'synchronized';\n      readonly resolutionAvailable: boolean;\n      readonly availableCompositionFingerprints: readonly string[];\n    };\n\nexport type TransitionDiagnosticCode =\n  | 'transition.live.capability'\n  | 'transition.no-change'\n  | 'transition.reload.domains'\n  | 'transition.reload.major-mode'\n  | 'transition.reload.profile'\n  | 'transition.rejected.aborted'\n  | 'transition.rejected.duplicate'\n  | 'transition.rejected.execution'\n  | 'transition.rejected.unavailable'\n  | 'transition.relaunch.extension-closure'\n  | 'transition.stale.generation'\n  | 'transition.stale.config'\n  | 'transition.stale.session'\n  | 'transition.sync-required.artifact'\n  | 'transition.sync-required.resolution';\n\nexport interface DoomTransitionPlan {\n  readonly operationId: string;\n  readonly axis: TransitionAxis;\n  readonly disposition: TransitionDisposition;\n  readonly strategy?: TransitionExecutionStrategy;\n  readonly previous: TransitionSelectionSnapshot;\n  readonly candidate: TransitionSelectionSnapshot;\n  readonly diagnostics: readonly TransitionDiagnosticCode[];\n  readonly reloadHandoffRequired: boolean;\n  readonly externalRelaunchRequired: boolean;\n}\n\nexport interface DoomTransitionResult extends DoomTransitionPlan {\n  readonly outcome: TransitionOutcome;\n}\n\nexport type StructuralTransitionExecution = (\n  request: DoomTransitionRequest,\n  plan: DoomTransitionPlan,\n) => Promise<TransitionOutcome>;\n\n/** Cordis service name the Po host publishes its transition coordinator under. */\nexport const DOOM_TRANSITION_SERVICE = 'doom/transition';\n\n/**\n * The session-scoped object that serializes structural transitions.\n *\n * Declared here rather than beside its implementation because the packages that\n * drive the selection axes resolve it from the session and must not depend on\n * the host that builds it. plan() is deliberately synchronous and the result\n * carries live values, so this contract is an in-process handle, not a wire\n * protocol.\n */\nexport interface DoomTransitionCoordinator {\n  readonly sessionId: string;\n  readonly hostGeneration: string;\n  plan(request: DoomTransitionRequest): DoomTransitionPlan;\n  execute(\n    request: DoomTransitionRequest,\n    executeStructural?: StructuralTransitionExecution,\n  ): Promise<DoomTransitionResult>;\n  dispose(): void;\n}\n\n/**\n * Typed reads of the two host services off the session's cordis registry.\n *\n * Optional reads use Cordis's public `ctx.get()` surface. Hard consumers should\n * declare the corresponding service name with `ctx.inject()` before reading it.\n */\nexport function readDoomTransitionCoordinator(root: Context): DoomTransitionCoordinator | undefined {\n  return root.get(DOOM_TRANSITION_SERVICE) as DoomTransitionCoordinator | undefined;\n}\n\n/**\n * The coordinator for an injected Cordis context.\n */\nexport function requireDoomTransitionCoordinator(context: Context): DoomTransitionCoordinator {\n  const coordinator = readDoomTransitionCoordinator(context);\n  if (!coordinator) throw new Error('Doom transition coordinator is unavailable. Load the Po parent runtime.');\n  return coordinator;\n}\n"],"mappings":";;AA0HA,MAAa,0BAA0B;;;;;;;AA4BvC,SAAgB,8BAA8B,MAAsD;CAClG,OAAO,KAAK,IAAI,uBAAuB;AACzC;;;;AAKA,SAAgB,iCAAiC,SAA6C;CAC5F,MAAM,cAAc,8BAA8B,OAAO;CACzD,IAAI,CAAC,aAAa,MAAM,IAAI,MAAM,yEAAyE;CAC3G,OAAO;AACT"}

package/dist/sandboxHarness.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sandboxHarness = require("./src/schemas/sandboxHarness.cjs");
+exports.PO_SANDBOX_ENV = require_sandboxHarness.PO_SANDBOX_ENV;
+exports.SANDBOX_HARNESS_EXPORT_SUBPATH = require_sandboxHarness.SANDBOX_HARNESS_EXPORT_SUBPATH;
+exports.insideSandbox = require_sandboxHarness.insideSandbox;
+exports.isSandboxHarnessModule = require_sandboxHarness.isSandboxHarnessModule;

package/dist/sandboxHarness.d.mts

@@ -0,0 +1,2 @@
+import { PO_SANDBOX_ENV, SANDBOX_HARNESS_EXPORT_SUBPATH, SandboxHarnessModule, SandboxLaunchRequest, insideSandbox, isSandboxHarnessModule } from "./src/schemas/sandboxHarness.mjs";
+export { PO_SANDBOX_ENV, SANDBOX_HARNESS_EXPORT_SUBPATH, type SandboxHarnessModule, type SandboxLaunchRequest, insideSandbox, isSandboxHarnessModule };

package/dist/sandboxHarness.mjs

@@ -0,0 +1,2 @@
+import { PO_SANDBOX_ENV, SANDBOX_HARNESS_EXPORT_SUBPATH, insideSandbox, isSandboxHarnessModule } from "./src/schemas/sandboxHarness.mjs";
+export { PO_SANDBOX_ENV, SANDBOX_HARNESS_EXPORT_SUBPATH, insideSandbox, isSandboxHarnessModule };

package/dist/server.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./src/services/rpcTranscript/index.cjs");
+const require_piSessionRuntime = require("./src/pi/piSessionRuntime.cjs");
+const require_headlessChildSessionService = require("./src/systems/child/adapters/headlessChildSessionService.cjs");
+const require_headlessHub = require("./headlessHub.cjs");
+const require_headlessServer = require("./headlessServer.cjs");
+const require_terminalPiChildSessionService = require("./terminalPiChildSessionService.cjs");
+exports.captureTerminalPiForkSource = require_terminalPiChildSessionService.captureTerminalPiForkSource;
+exports.createAgentServerService = require_piSessionRuntime.createAgentServerService;
+exports.createAgentSessionRuntime = require_piSessionRuntime.createAgentSessionRuntime;
+exports.createHeadlessChildSessionService = require_headlessChildSessionService.createHeadlessChildSessionService;
+exports.createHeadlessChildSessionServiceProvider = require_headlessChildSessionService.createHeadlessChildSessionServiceProvider;
+exports.createHeadlessHub = require_headlessHub.createHeadlessHub;
+exports.createRpcTranscript = require_index.createRpcTranscript;
+exports.createTerminalPiChildSessionService = require_terminalPiChildSessionService.createTerminalPiChildSessionService;
+exports.createTerminalPiChildSessionServiceProvider = require_terminalPiChildSessionService.createTerminalPiChildSessionServiceProvider;
+exports.serveHeadlessServer = require_headlessServer.serveHeadlessServer;

package/dist/server.d.mts

@@ -0,0 +1,10 @@
+import { HeadlessSessionHost, HeadlessSessionHostOptions } from "./headlessSessionHost.mjs";
+import { HeadlessSessionManager, HeadlessSessionManagerCreateOptions } from "./runtimeHeadlessSessionManager.mjs";
+import { HeadlessHub, HeadlessHubEvent, HeadlessHubOptions, HeadlessHubSession, createHeadlessHub } from "./headlessHub.mjs";
+import { HeadlessServer, HeadlessServerOptions, serveHeadlessServer } from "./headlessServer.mjs";
+import { HeadlessChildSessionServiceOptions, HeadlessChildSessionServiceProvider, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider } from "./src/systems/child/adapters/headlessChildSessionService.mjs";
+import { TerminalPiChildSessionServiceOptions, TerminalPiChildSessionServiceProvider, TerminalPiForkSourceManager, captureTerminalPiForkSource, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider } from "./terminalPiChildSessionService.mjs";
+import { SessionFrame } from "./src/types/server/session.mjs";
+import { RpcTranscript, RpcTranscriptOptions, TranscriptReduction, createRpcTranscript } from "./src/services/rpcTranscript/index.mjs";
+import { AgentServerServiceOptions, AgentSessionRuntime, AgentSessionRuntimeOptions, DoomSessionMetadata, createAgentServerService, createAgentSessionRuntime } from "./src/pi/piSessionRuntime.mjs";
+export { type AgentServerServiceOptions, type AgentSessionRuntime, type AgentSessionRuntimeOptions, type DoomSessionMetadata, type HeadlessChildSessionServiceOptions, type HeadlessChildSessionServiceProvider, type HeadlessHub, type HeadlessHubEvent, type HeadlessHubOptions, type HeadlessHubSession, type HeadlessServer, type HeadlessServerOptions, type HeadlessSessionHost, type HeadlessSessionHostOptions, type HeadlessSessionManager, type HeadlessSessionManagerCreateOptions, type RpcTranscript, type RpcTranscriptOptions, type SessionFrame, type TerminalPiChildSessionServiceOptions, type TerminalPiChildSessionServiceProvider, type TerminalPiForkSourceManager, type TranscriptReduction, captureTerminalPiForkSource, createAgentServerService, createAgentSessionRuntime, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider, createHeadlessHub, createRpcTranscript, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider, serveHeadlessServer };

package/dist/server.mjs

@@ -0,0 +1,7 @@
+import { createRpcTranscript } from "./src/services/rpcTranscript/index.mjs";
+import { createAgentServerService, createAgentSessionRuntime } from "./src/pi/piSessionRuntime.mjs";
+import { createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider } from "./src/systems/child/adapters/headlessChildSessionService.mjs";
+import { createHeadlessHub } from "./headlessHub.mjs";
+import { serveHeadlessServer } from "./headlessServer.mjs";
+import { captureTerminalPiForkSource, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider } from "./terminalPiChildSessionService.mjs";
+export { captureTerminalPiForkSource, createAgentServerService, createAgentSessionRuntime, createHeadlessChildSessionService, createHeadlessChildSessionServiceProvider, createHeadlessHub, createRpcTranscript, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider, serveHeadlessServer };

package/dist/serverFacet.cjs

@@ -0,0 +1,34 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_liveImport = require("./src/server/liveImport.cjs");
+const require_serverFacet = require("./src/schemas/serverFacet.cjs");
+const require_index = require("./src/services/serverFacet/index.cjs");
+const require_serverFacetLoader = require("./src/server/serverFacetLoader.cjs");
+const require_pluginContributions = require("./src/schemas/pluginContributions.cjs");
+const require_serverPlugin = require("./src/extensions/serverPlugin.cjs");
+const require_index$1 = require("./src/services/packageResource/index.cjs");
+const require_index$2 = require("./src/services/sessionAttachments/index.cjs");
+exports.DOOM_SERVER_FACET_EXPORT = require_serverFacet.DOOM_SERVER_FACET_EXPORT;
+exports.DOOM_SERVER_FACET_MANIFEST_FIELD = require_serverFacet.DOOM_SERVER_FACET_MANIFEST_FIELD;
+exports.DOOM_SERVER_HOST_SERVICE = require_serverFacet.DOOM_SERVER_HOST_SERVICE;
+exports.DoomServerFacetManifestError = require_serverFacet.DoomServerFacetManifestError;
+exports.LIVE_FACTORY_TIMEOUT_MS = require_liveImport.LIVE_FACTORY_TIMEOUT_MS;
+exports.LIVE_IMPORT_TIMEOUT_MS = require_liveImport.LIVE_IMPORT_TIMEOUT_MS;
+exports.composeServerProviderOverrides = require_serverFacet.composeServerProviderOverrides;
+exports.createDoomServerHost = require_index.createDoomServerHost;
+exports.declaredServerFacetsOf = require_serverFacet.declaredServerFacetsOf;
+exports.defineCommand = require_pluginContributions.defineCommand;
+exports.defineServerMethod = require_serverFacet.defineServerMethod;
+exports.defineServerPlugin = require_serverPlugin.defineServerPlugin;
+exports.defineTool = require_pluginContributions.defineTool;
+exports.guardedImport = require_liveImport.guardedImport;
+exports.installServerFacets = require_serverFacetLoader.installServerFacets;
+exports.isDoomServerFacet = require_serverFacet.isDoomServerFacet;
+exports.loadServerFacets = require_serverFacetLoader.loadServerFacets;
+exports.orderServerFacets = require_serverFacet.orderServerFacets;
+exports.packageResourcePath = require_index$1.packageResourcePath;
+exports.readDoomServerHost = require_serverFacet.readDoomServerHost;
+exports.readPackageResource = require_index$1.readPackageResource;
+exports.requireDoomServerHost = require_serverFacet.requireDoomServerHost;
+exports.selectedServerProviderOverrides = require_serverFacetLoader.selectedServerProviderOverrides;
+exports.withTimeout = require_liveImport.withTimeout;
+exports.writeSessionAttachment = require_index$2.writeSessionAttachment;

package/dist/serverFacet.d.mts

@@ -0,0 +1,10 @@
+import { DoomServerBundleEntry, DoomServerBundleOwner } from "./src/schemas/serverBundle.mjs";
+import { DoomPluginCommand, DoomPluginTool, DoomPluginToolExecution, DoomPluginToolResult, defineCommand, defineTool } from "./src/schemas/pluginContributions.mjs";
+import { DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, DeclaredServerFacet, DoomServerFacet, DoomServerFacetManifestError, DoomServerHostService, DoomServerMethod, DoomServerPluginContext, DoomServerPluginDefinition, DoomServerPluginScope, DoomServerProviderOverride, DoomServerProviderOverrides, DoomServerRegistration, DoomServerSessionPlugin, composeServerProviderOverrides, declaredServerFacetsOf, defineServerMethod, isDoomServerFacet, orderServerFacets, readDoomServerHost, requireDoomServerHost } from "./src/schemas/serverFacet.mjs";
+import { CreateDoomServerHostOptions, DoomServerHost, createDoomServerHost } from "./src/services/serverFacet/index.mjs";
+import { LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, LiveImportGuard, guardedImport, withTimeout } from "./src/server/liveImport.mjs";
+import { InstallServerFacetsOptions, InstalledServerFacets, LiveServerFacetEntry, LoadServerFacetsOptions, LoadedServerFacet, LoadedServerFacets, installServerFacets, loadServerFacets, selectedServerProviderOverrides } from "./src/server/serverFacetLoader.mjs";
+import { defineServerPlugin } from "./src/extensions/serverPlugin.mjs";
+import { packageResourcePath, readPackageResource } from "./src/services/packageResource/index.mjs";
+import { writeSessionAttachment } from "./src/services/sessionAttachments/index.mjs";
+export { type CreateDoomServerHostOptions, DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, type DeclaredServerFacet, type DoomPluginCommand, type DoomPluginTool, type DoomPluginToolExecution, type DoomPluginToolResult, type DoomServerBundleEntry, type DoomServerBundleOwner, type DoomServerFacet, DoomServerFacetManifestError, type DoomServerHost, type DoomServerHostService, type DoomServerMethod, type DoomServerPluginContext, type DoomServerPluginDefinition, type DoomServerPluginScope, type DoomServerProviderOverride, type DoomServerProviderOverrides, type DoomServerRegistration, type DoomServerSessionPlugin, type InstallServerFacetsOptions, type InstalledServerFacets, LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, type LiveImportGuard, type LiveServerFacetEntry, type LoadServerFacetsOptions, type LoadedServerFacet, type LoadedServerFacets, composeServerProviderOverrides, createDoomServerHost, declaredServerFacetsOf, defineCommand, defineServerMethod, defineServerPlugin, defineTool, guardedImport, installServerFacets, isDoomServerFacet, loadServerFacets, orderServerFacets, packageResourcePath, readDoomServerHost, readPackageResource, requireDoomServerHost, selectedServerProviderOverrides, withTimeout, writeSessionAttachment };

package/dist/serverFacet.mjs

@@ -0,0 +1,9 @@
+import { LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, guardedImport, withTimeout } from "./src/server/liveImport.mjs";
+import { DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, DoomServerFacetManifestError, composeServerProviderOverrides, declaredServerFacetsOf, defineServerMethod, isDoomServerFacet, orderServerFacets, readDoomServerHost, requireDoomServerHost } from "./src/schemas/serverFacet.mjs";
+import { createDoomServerHost } from "./src/services/serverFacet/index.mjs";
+import { installServerFacets, loadServerFacets, selectedServerProviderOverrides } from "./src/server/serverFacetLoader.mjs";
+import { defineCommand, defineTool } from "./src/schemas/pluginContributions.mjs";
+import { defineServerPlugin } from "./src/extensions/serverPlugin.mjs";
+import { packageResourcePath, readPackageResource } from "./src/services/packageResource/index.mjs";
+import { writeSessionAttachment } from "./src/services/sessionAttachments/index.mjs";
+export { DOOM_SERVER_FACET_EXPORT, DOOM_SERVER_FACET_MANIFEST_FIELD, DOOM_SERVER_HOST_SERVICE, DoomServerFacetManifestError, LIVE_FACTORY_TIMEOUT_MS, LIVE_IMPORT_TIMEOUT_MS, composeServerProviderOverrides, createDoomServerHost, declaredServerFacetsOf, defineCommand, defineServerMethod, defineServerPlugin, defineTool, guardedImport, installServerFacets, isDoomServerFacet, loadServerFacets, orderServerFacets, packageResourcePath, readDoomServerHost, readPackageResource, requireDoomServerHost, selectedServerProviderOverrides, withTimeout, writeSessionAttachment };

package/dist/serverTelemetry.cjs

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _agimon_ai_po_telemetry = require("@agimon-ai/po-telemetry");
+//#region src/services/serverTelemetry/index.ts
+const SERVICE_NAME = "po-server";
+const PACKAGE_NAME = "@agimon-ai/po";
+function createServerTelemetry(options = {}) {
+	return (0, _agimon_ai_po_telemetry.createDoomTelemetry)({
+		serviceName: SERVICE_NAME,
+		packageName: PACKAGE_NAME,
+		cwd: options.cwd,
+		env: options.env,
+		warn: options.warn,
+		enableLogs: true,
+		enableTraces: true
+	});
+}
+/** Telemetry is diagnostic and must never interrupt the server's critical path. */
+function observe(operation, onNotice) {
+	operation.catch((error) => onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`));
+}
+//#endregion
+exports.createServerTelemetry = createServerTelemetry;
+exports.observe = observe;
+
+//# sourceMappingURL=serverTelemetry.cjs.map

package/dist/serverTelemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTelemetry.cjs","names":["createDoomTelemetry"],"sources":["../src/services/serverTelemetry/index.ts"],"sourcesContent":["import { createDoomTelemetry, type DoomTelemetry } from '@agimon-ai/po-telemetry';\n\nconst SERVICE_NAME = 'po-server';\nconst PACKAGE_NAME = '@agimon-ai/po';\n\nexport type ServerTelemetry = Pick<\n  DoomTelemetry,\n  'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'\n>;\n\nexport function createServerTelemetry(\n  options: {\n    cwd?: string;\n    env?: NodeJS.ProcessEnv;\n    warn?: (message: string) => void;\n  } = {},\n): ServerTelemetry {\n  return createDoomTelemetry({\n    serviceName: SERVICE_NAME,\n    packageName: PACKAGE_NAME,\n    cwd: options.cwd,\n    env: options.env,\n    warn: options.warn,\n    enableLogs: true,\n    enableTraces: true,\n  });\n}\n\n/** Telemetry is diagnostic and must never interrupt the server's critical path. */\nexport function observe(operation: Promise<unknown>, onNotice?: (message: string) => void): void {\n  void operation.catch((error: unknown) =>\n    onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`),\n  );\n}\n"],"mappings":";;;AAEA,MAAM,eAAe;AACrB,MAAM,eAAe;AAOrB,SAAgB,sBACd,UAII,CAAC,GACY;CACjB,QAAA,GAAOA,wBAAAA,oBAAAA,CAAoB;EACzB,aAAa;EACb,aAAa;EACb,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,MAAM,QAAQ;EACd,YAAY;EACZ,cAAc;CAChB,CAAC;AACH;;AAGA,SAAgB,QAAQ,WAA6B,UAA4C;CAC/F,UAAe,OAAO,UACpB,WAAW,qBAAqB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,CAC1F;AACF"}

package/dist/serverTelemetry.d.mts

@@ -0,0 +1,12 @@
+import { DoomTelemetry } from "@agimon-ai/po-telemetry";
+//#region src/services/serverTelemetry/index.d.ts
+export type ServerTelemetry = Pick<DoomTelemetry, 'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'>;
+export declare function createServerTelemetry(options?: {
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+  warn?: (message: string) => void;
+}): ServerTelemetry;
+/** Telemetry is diagnostic and must never interrupt the server's critical path. */
+export declare function observe(operation: Promise<unknown>, onNotice?: (message: string) => void): void;
+//#endregion
+//# sourceMappingURL=serverTelemetry.d.mts.map

package/dist/serverTelemetry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTelemetry.d.mts","names":[],"sources":["../src/services/serverTelemetry/index.ts"],"mappings":";;YAKY,kBAAkB,KAC5B;wBAIc,sBACd;EACE;EACA,MAAM,OAAO;EACb,QAAQ;IAET;;wBAaa,QAAQ,WAAW,kBAAkB,YAAY"}

package/dist/serverTelemetry.mjs

@@ -0,0 +1,23 @@
+import { createDoomTelemetry } from "@agimon-ai/po-telemetry";
+//#region src/services/serverTelemetry/index.ts
+const SERVICE_NAME = "po-server";
+const PACKAGE_NAME = "@agimon-ai/po";
+function createServerTelemetry(options = {}) {
+	return createDoomTelemetry({
+		serviceName: SERVICE_NAME,
+		packageName: PACKAGE_NAME,
+		cwd: options.cwd,
+		env: options.env,
+		warn: options.warn,
+		enableLogs: true,
+		enableTraces: true
+	});
+}
+/** Telemetry is diagnostic and must never interrupt the server's critical path. */
+function observe(operation, onNotice) {
+	operation.catch((error) => onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`));
+}
+//#endregion
+export { createServerTelemetry, observe };
+
+//# sourceMappingURL=serverTelemetry.mjs.map

package/dist/serverTelemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTelemetry.mjs","names":[],"sources":["../src/services/serverTelemetry/index.ts"],"sourcesContent":["import { createDoomTelemetry, type DoomTelemetry } from '@agimon-ai/po-telemetry';\n\nconst SERVICE_NAME = 'po-server';\nconst PACKAGE_NAME = '@agimon-ai/po';\n\nexport type ServerTelemetry = Pick<\n  DoomTelemetry,\n  'recordEvent' | 'recordWarning' | 'recordError' | 'runInSpan' | 'flush' | 'shutdown'\n>;\n\nexport function createServerTelemetry(\n  options: {\n    cwd?: string;\n    env?: NodeJS.ProcessEnv;\n    warn?: (message: string) => void;\n  } = {},\n): ServerTelemetry {\n  return createDoomTelemetry({\n    serviceName: SERVICE_NAME,\n    packageName: PACKAGE_NAME,\n    cwd: options.cwd,\n    env: options.env,\n    warn: options.warn,\n    enableLogs: true,\n    enableTraces: true,\n  });\n}\n\n/** Telemetry is diagnostic and must never interrupt the server's critical path. */\nexport function observe(operation: Promise<unknown>, onNotice?: (message: string) => void): void {\n  void operation.catch((error: unknown) =>\n    onNotice?.(`telemetry failed: ${error instanceof Error ? error.message : String(error)}`),\n  );\n}\n"],"mappings":";;AAEA,MAAM,eAAe;AACrB,MAAM,eAAe;AAOrB,SAAgB,sBACd,UAII,CAAC,GACY;CACjB,OAAO,oBAAoB;EACzB,aAAa;EACb,aAAa;EACb,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,MAAM,QAAQ;EACd,YAAY;EACZ,cAAc;CAChB,CAAC;AACH;;AAGA,SAAgB,QAAQ,WAA6B,UAA4C;CAC/F,UAAe,OAAO,UACpB,WAAW,qBAAqB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,CAC1F;AACF"}

package/dist/sessionFilesApi.cjs

@@ -0,0 +1,96 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let ignore = require("ignore");
+ignore = require_runtime.__toESM(ignore, 1);
+//#region src/server/sessionFilesApi.ts
+const EXCLUDED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
+const IGNORE_FILES = [".gitignore", ".poignore"];
+const FILE_QUERY_TIMEOUT_MS = 2e3;
+const MAX_FILE_RESULTS = 50;
+/**
+* The project's ignore test, or nothing when it declares no rules.
+*
+* Only the session root's files are read. A nested .gitignore would need one
+* matcher per directory, and the cost of skipping it is a suggestion that
+* should not have been offered rather than a file that cannot be opened. An
+* unreadable or malformed file leaves completion listing everything, because
+* hiding the tree is the worse failure.
+*/
+function readIgnoreRules(cwd) {
+	const rules = IGNORE_FILES.map((name) => {
+		try {
+			return node_fs.default.readFileSync(node_path.default.join(cwd, name), "utf8");
+		} catch {
+			return "";
+		}
+	}).join("\n");
+	if (rules.trim().length === 0) return void 0;
+	try {
+		const matcher = (0, ignore.default)().add(rules);
+		return (relativePath) => matcher.ignores(relativePath);
+	} catch {
+		return;
+	}
+}
+async function listSessionFiles(cwd, query, signal) {
+	const isIgnored = readIgnoreRules(cwd);
+	const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;
+	const pending = [""];
+	let next = 0;
+	const matches = [];
+	while (next < pending.length && matches.length < MAX_FILE_RESULTS) {
+		if (signal.aborted) throw signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("File completion was aborted.");
+		if (Date.now() > deadline && next > 0) break;
+		const relativeDirectory = pending[next++];
+		if (relativeDirectory === void 0) break;
+		if (relativeDirectory !== "" && `${relativeDirectory}/`.toLowerCase().includes(query)) matches.push(`${relativeDirectory}/`);
+		if (matches.length === MAX_FILE_RESULTS) break;
+		const entries = await node_fs.default.promises.readdir(node_path.default.join(cwd, relativeDirectory), { withFileTypes: true });
+		const matchingDirectories = [];
+		for (const entry of entries) {
+			const file = relativeDirectory === "" ? entry.name : `${relativeDirectory}/${entry.name}`;
+			if (entry.isDirectory()) {
+				if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;
+				if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);
+				else pending.push(file);
+			} else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) matches.push(file);
+			if (matches.length === MAX_FILE_RESULTS) break;
+		}
+		pending.splice(next, 0, ...matchingDirectories);
+	}
+	return matches.sort().slice(0, MAX_FILE_RESULTS);
+}
+/** Bounded, read-only file completion rooted in the owning session. */
+const sessionFilesApi = {
+	basePath: "files",
+	start(context) {
+		if (context.scope !== "session" || !context.cwd) throw new Error("File completion requires a session.");
+		const cwd = context.cwd;
+		let closed = false;
+		return {
+			async fetch(request) {
+				if (closed) return new Response(null, { status: 503 });
+				const url = new URL(request.url);
+				if (request.method !== "GET" || url.pathname !== "/") return new Response(null, { status: 404 });
+				const query = (url.searchParams.get("q") ?? "").toLowerCase();
+				if (query.length > 256) return Response.json({ error: "File query is too long." }, { status: 400 });
+				try {
+					return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });
+				} catch {
+					return Response.json({ error: "File completion could not be read." }, { status: 503 });
+				}
+			},
+			close() {
+				closed = true;
+			}
+		};
+	}
+};
+//#endregion
+exports.sessionFilesApi = sessionFilesApi;
+
+//# sourceMappingURL=sessionFilesApi.cjs.map

package/dist/sessionFilesApi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionFilesApi.cjs","names":["fs","path"],"sources":["../src/server/sessionFilesApi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport ignore from 'ignore';\n\nimport type { DoomApi } from '../exports/packageApi';\n\nconst EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);\nconst IGNORE_FILES = ['.gitignore', '.poignore'];\nconst FILE_QUERY_TIMEOUT_MS = 2000;\nconst MAX_FILE_RESULTS = 50;\n\n/**\n * The project's ignore test, or nothing when it declares no rules.\n *\n * Only the session root's files are read. A nested .gitignore would need one\n * matcher per directory, and the cost of skipping it is a suggestion that\n * should not have been offered rather than a file that cannot be opened. An\n * unreadable or malformed file leaves completion listing everything, because\n * hiding the tree is the worse failure.\n */\nfunction readIgnoreRules(cwd: string): ((relativePath: string) => boolean) | undefined {\n  const rules = IGNORE_FILES.map((name) => {\n    try {\n      return fs.readFileSync(path.join(cwd, name), 'utf8');\n    } catch {\n      return '';\n    }\n  }).join('\\n');\n  if (rules.trim().length === 0) return undefined;\n  try {\n    const matcher = ignore().add(rules);\n    return (relativePath: string): boolean => matcher.ignores(relativePath);\n  } catch {\n    return undefined;\n  }\n}\n\nasync function listSessionFiles(cwd: string, query: string, signal: AbortSignal): Promise<string[]> {\n  const isIgnored = readIgnoreRules(cwd);\n  const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;\n  const pending = [''];\n  let next = 0;\n  const matches: string[] = [];\n\n  while (next < pending.length && matches.length < MAX_FILE_RESULTS) {\n    if (signal.aborted) {\n      throw signal.reason instanceof Error ? signal.reason : new Error('File completion was aborted.');\n    }\n    // ponytail: Return matches found so far on huge trees; a search index is the upgrade path.\n    if (Date.now() > deadline && next > 0) break;\n    const relativeDirectory = pending[next++];\n    if (relativeDirectory === undefined) break;\n    if (relativeDirectory !== '' && `${relativeDirectory}/`.toLowerCase().includes(query)) {\n      matches.push(`${relativeDirectory}/`);\n    }\n    if (matches.length === MAX_FILE_RESULTS) break;\n    const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });\n    const matchingDirectories: string[] = [];\n    for (const entry of entries) {\n      // Ignore rules are written in posix form, and so is every result.\n      const file = relativeDirectory === '' ? entry.name : `${relativeDirectory}/${entry.name}`;\n      if (entry.isDirectory()) {\n        // An ignored directory is pruned rather than filtered at its leaves:\n        // walking a build cache is what exhausts the completion budget. The\n        // trailing slash is what makes a directory-only rule such as\n        // '.nx-cache/' match.\n        if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;\n        // Explore a matching folder before its siblings so its files follow it.\n        if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);\n        else pending.push(file);\n      } else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) {\n        matches.push(file);\n      }\n      if (matches.length === MAX_FILE_RESULTS) break;\n    }\n    pending.splice(next, 0, ...matchingDirectories);\n  }\n\n  return matches.sort().slice(0, MAX_FILE_RESULTS);\n}\n\n/** Bounded, read-only file completion rooted in the owning session. */\nexport const sessionFilesApi: DoomApi = {\n  basePath: 'files',\n  start(context) {\n    if (context.scope !== 'session' || !context.cwd) throw new Error('File completion requires a session.');\n    const cwd = context.cwd;\n    let closed = false;\n    return {\n      async fetch(request) {\n        if (closed) return new Response(null, { status: 503 });\n        const url = new URL(request.url);\n        if (request.method !== 'GET' || url.pathname !== '/') return new Response(null, { status: 404 });\n        const query = (url.searchParams.get('q') ?? '').toLowerCase();\n        if (query.length > 256) return Response.json({ error: 'File query is too long.' }, { status: 400 });\n        try {\n          return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });\n        } catch {\n          return Response.json({ error: 'File completion could not be read.' }, { status: 503 });\n        }\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":"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"}

package/dist/sessionFilesApi.d.mts

@@ -0,0 +1,7 @@
+import { DoomApi } from "./src/schemas/packageApi.mjs";
+import "./packageApi.mjs";
+//#region src/server/sessionFilesApi.d.ts
+/** Bounded, read-only file completion rooted in the owning session. */
+export declare const sessionFilesApi: DoomApi;
+//#endregion
+//# sourceMappingURL=sessionFilesApi.d.mts.map

package/dist/sessionFilesApi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionFilesApi.d.mts","names":[],"sources":["../src/server/sessionFilesApi.ts"],"mappings":";;;;qBAmFa,iBAAiB"}

package/dist/sessionFilesApi.mjs

@@ -0,0 +1,91 @@
+import fs from "node:fs";
+import path from "node:path";
+import ignore from "ignore";
+//#region src/server/sessionFilesApi.ts
+const EXCLUDED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
+const IGNORE_FILES = [".gitignore", ".poignore"];
+const FILE_QUERY_TIMEOUT_MS = 2e3;
+const MAX_FILE_RESULTS = 50;
+/**
+* The project's ignore test, or nothing when it declares no rules.
+*
+* Only the session root's files are read. A nested .gitignore would need one
+* matcher per directory, and the cost of skipping it is a suggestion that
+* should not have been offered rather than a file that cannot be opened. An
+* unreadable or malformed file leaves completion listing everything, because
+* hiding the tree is the worse failure.
+*/
+function readIgnoreRules(cwd) {
+	const rules = IGNORE_FILES.map((name) => {
+		try {
+			return fs.readFileSync(path.join(cwd, name), "utf8");
+		} catch {
+			return "";
+		}
+	}).join("\n");
+	if (rules.trim().length === 0) return void 0;
+	try {
+		const matcher = ignore().add(rules);
+		return (relativePath) => matcher.ignores(relativePath);
+	} catch {
+		return;
+	}
+}
+async function listSessionFiles(cwd, query, signal) {
+	const isIgnored = readIgnoreRules(cwd);
+	const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;
+	const pending = [""];
+	let next = 0;
+	const matches = [];
+	while (next < pending.length && matches.length < MAX_FILE_RESULTS) {
+		if (signal.aborted) throw signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("File completion was aborted.");
+		if (Date.now() > deadline && next > 0) break;
+		const relativeDirectory = pending[next++];
+		if (relativeDirectory === void 0) break;
+		if (relativeDirectory !== "" && `${relativeDirectory}/`.toLowerCase().includes(query)) matches.push(`${relativeDirectory}/`);
+		if (matches.length === MAX_FILE_RESULTS) break;
+		const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });
+		const matchingDirectories = [];
+		for (const entry of entries) {
+			const file = relativeDirectory === "" ? entry.name : `${relativeDirectory}/${entry.name}`;
+			if (entry.isDirectory()) {
+				if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;
+				if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);
+				else pending.push(file);
+			} else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) matches.push(file);
+			if (matches.length === MAX_FILE_RESULTS) break;
+		}
+		pending.splice(next, 0, ...matchingDirectories);
+	}
+	return matches.sort().slice(0, MAX_FILE_RESULTS);
+}
+/** Bounded, read-only file completion rooted in the owning session. */
+const sessionFilesApi = {
+	basePath: "files",
+	start(context) {
+		if (context.scope !== "session" || !context.cwd) throw new Error("File completion requires a session.");
+		const cwd = context.cwd;
+		let closed = false;
+		return {
+			async fetch(request) {
+				if (closed) return new Response(null, { status: 503 });
+				const url = new URL(request.url);
+				if (request.method !== "GET" || url.pathname !== "/") return new Response(null, { status: 404 });
+				const query = (url.searchParams.get("q") ?? "").toLowerCase();
+				if (query.length > 256) return Response.json({ error: "File query is too long." }, { status: 400 });
+				try {
+					return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });
+				} catch {
+					return Response.json({ error: "File completion could not be read." }, { status: 503 });
+				}
+			},
+			close() {
+				closed = true;
+			}
+		};
+	}
+};
+//#endregion
+export { sessionFilesApi };
+
+//# sourceMappingURL=sessionFilesApi.mjs.map

package/dist/sessionFilesApi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionFilesApi.mjs","names":[],"sources":["../src/server/sessionFilesApi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport ignore from 'ignore';\n\nimport type { DoomApi } from '../exports/packageApi';\n\nconst EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);\nconst IGNORE_FILES = ['.gitignore', '.poignore'];\nconst FILE_QUERY_TIMEOUT_MS = 2000;\nconst MAX_FILE_RESULTS = 50;\n\n/**\n * The project's ignore test, or nothing when it declares no rules.\n *\n * Only the session root's files are read. A nested .gitignore would need one\n * matcher per directory, and the cost of skipping it is a suggestion that\n * should not have been offered rather than a file that cannot be opened. An\n * unreadable or malformed file leaves completion listing everything, because\n * hiding the tree is the worse failure.\n */\nfunction readIgnoreRules(cwd: string): ((relativePath: string) => boolean) | undefined {\n  const rules = IGNORE_FILES.map((name) => {\n    try {\n      return fs.readFileSync(path.join(cwd, name), 'utf8');\n    } catch {\n      return '';\n    }\n  }).join('\\n');\n  if (rules.trim().length === 0) return undefined;\n  try {\n    const matcher = ignore().add(rules);\n    return (relativePath: string): boolean => matcher.ignores(relativePath);\n  } catch {\n    return undefined;\n  }\n}\n\nasync function listSessionFiles(cwd: string, query: string, signal: AbortSignal): Promise<string[]> {\n  const isIgnored = readIgnoreRules(cwd);\n  const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;\n  const pending = [''];\n  let next = 0;\n  const matches: string[] = [];\n\n  while (next < pending.length && matches.length < MAX_FILE_RESULTS) {\n    if (signal.aborted) {\n      throw signal.reason instanceof Error ? signal.reason : new Error('File completion was aborted.');\n    }\n    // ponytail: Return matches found so far on huge trees; a search index is the upgrade path.\n    if (Date.now() > deadline && next > 0) break;\n    const relativeDirectory = pending[next++];\n    if (relativeDirectory === undefined) break;\n    if (relativeDirectory !== '' && `${relativeDirectory}/`.toLowerCase().includes(query)) {\n      matches.push(`${relativeDirectory}/`);\n    }\n    if (matches.length === MAX_FILE_RESULTS) break;\n    const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });\n    const matchingDirectories: string[] = [];\n    for (const entry of entries) {\n      // Ignore rules are written in posix form, and so is every result.\n      const file = relativeDirectory === '' ? entry.name : `${relativeDirectory}/${entry.name}`;\n      if (entry.isDirectory()) {\n        // An ignored directory is pruned rather than filtered at its leaves:\n        // walking a build cache is what exhausts the completion budget. The\n        // trailing slash is what makes a directory-only rule such as\n        // '.nx-cache/' match.\n        if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;\n        // Explore a matching folder before its siblings so its files follow it.\n        if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);\n        else pending.push(file);\n      } else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) {\n        matches.push(file);\n      }\n      if (matches.length === MAX_FILE_RESULTS) break;\n    }\n    pending.splice(next, 0, ...matchingDirectories);\n  }\n\n  return matches.sort().slice(0, MAX_FILE_RESULTS);\n}\n\n/** Bounded, read-only file completion rooted in the owning session. */\nexport const sessionFilesApi: DoomApi = {\n  basePath: 'files',\n  start(context) {\n    if (context.scope !== 'session' || !context.cwd) throw new Error('File completion requires a session.');\n    const cwd = context.cwd;\n    let closed = false;\n    return {\n      async fetch(request) {\n        if (closed) return new Response(null, { status: 503 });\n        const url = new URL(request.url);\n        if (request.method !== 'GET' || url.pathname !== '/') return new Response(null, { status: 404 });\n        const query = (url.searchParams.get('q') ?? '').toLowerCase();\n        if (query.length > 256) return Response.json({ error: 'File query is too long.' }, { status: 400 });\n        try {\n          return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });\n        } catch {\n          return Response.json({ error: 'File completion could not be read.' }, { status: 503 });\n        }\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":";;;;AAOA,MAAM,uCAAuB,IAAI,IAAI,CAAC,QAAQ,cAAc,CAAC;AAC7D,MAAM,eAAe,CAAC,cAAc,WAAW;AAC/C,MAAM,wBAAwB;AAC9B,MAAM,mBAAmB;;;;;;;;;;AAWzB,SAAS,gBAAgB,KAA8D;CACrF,MAAM,QAAQ,aAAa,KAAK,SAAS;EACvC,IAAI;GACF,OAAO,GAAG,aAAa,KAAK,KAAK,KAAK,IAAI,GAAG,MAAM;EACrD,QAAQ;GACN,OAAO;EACT;CACF,CAAC,CAAC,CAAC,KAAK,IAAI;CACZ,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,OAAO,KAAA;CACtC,IAAI;EACF,MAAM,UAAU,OAAO,CAAC,CAAC,IAAI,KAAK;EAClC,QAAQ,iBAAkC,QAAQ,QAAQ,YAAY;CACxE,QAAQ;EACN;CACF;AACF;AAEA,eAAe,iBAAiB,KAAa,OAAe,QAAwC;CAClG,MAAM,YAAY,gBAAgB,GAAG;CACrC,MAAM,WAAW,KAAK,IAAI,IAAI;CAC9B,MAAM,UAAU,CAAC,EAAE;CACnB,IAAI,OAAO;CACX,MAAM,UAAoB,CAAC;CAE3B,OAAO,OAAO,QAAQ,UAAU,QAAQ,SAAS,kBAAkB;EACjE,IAAI,OAAO,SACT,MAAM,OAAO,kBAAkB,QAAQ,OAAO,yBAAS,IAAI,MAAM,8BAA8B;EAGjG,IAAI,KAAK,IAAI,IAAI,YAAY,OAAO,GAAG;EACvC,MAAM,oBAAoB,QAAQ;EAClC,IAAI,sBAAsB,KAAA,GAAW;EACrC,IAAI,sBAAsB,MAAM,GAAG,kBAAkB,GAAG,YAAY,CAAC,CAAC,SAAS,KAAK,GAClF,QAAQ,KAAK,GAAG,kBAAkB,EAAE;EAEtC,IAAI,QAAQ,WAAW,kBAAkB;EACzC,MAAM,UAAU,MAAM,GAAG,SAAS,QAAQ,KAAK,KAAK,KAAK,iBAAiB,GAAG,EAAE,eAAe,KAAK,CAAC;EACpG,MAAM,sBAAgC,CAAC;EACvC,KAAK,MAAM,SAAS,SAAS;GAE3B,MAAM,OAAO,sBAAsB,KAAK,MAAM,OAAO,GAAG,kBAAkB,GAAG,MAAM;GACnF,IAAI,MAAM,YAAY,GAAG;IAKvB,IAAI,qBAAqB,IAAI,MAAM,IAAI,KAAK,YAAY,GAAG,KAAK,EAAE,MAAM,MAAM;IAE9E,IAAI,SAAS,MAAM,KAAK,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,oBAAoB,KAAK,IAAI;SAC/E,QAAQ,KAAK,IAAI;GACxB,OAAO,IAAI,MAAM,OAAO,KAAK,YAAY,IAAI,MAAM,QAAQ,KAAK,YAAY,CAAC,CAAC,SAAS,KAAK,GAC1F,QAAQ,KAAK,IAAI;GAEnB,IAAI,QAAQ,WAAW,kBAAkB;EAC3C;EACA,QAAQ,OAAO,MAAM,GAAG,GAAG,mBAAmB;CAChD;CAEA,OAAO,QAAQ,KAAK,CAAC,CAAC,MAAM,GAAG,gBAAgB;AACjD;;AAGA,MAAa,kBAA2B;CACtC,UAAU;CACV,MAAM,SAAS;EACb,IAAI,QAAQ,UAAU,aAAa,CAAC,QAAQ,KAAK,MAAM,IAAI,MAAM,qCAAqC;EACtG,MAAM,MAAM,QAAQ;EACpB,IAAI,SAAS;EACb,OAAO;GACL,MAAM,MAAM,SAAS;IACnB,IAAI,QAAQ,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;IACrD,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;IAC/B,IAAI,QAAQ,WAAW,SAAS,IAAI,aAAa,KAAK,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;IAC/F,MAAM,SAAS,IAAI,aAAa,IAAI,GAAG,KAAK,GAAA,CAAI,YAAY;IAC5D,IAAI,MAAM,SAAS,KAAK,OAAO,SAAS,KAAK,EAAE,OAAO,0BAA0B,GAAG,EAAE,QAAQ,IAAI,CAAC;IAClG,IAAI;KACF,OAAO,SAAS,KAAK,EAAE,OAAO,MAAM,iBAAiB,KAAK,OAAO,QAAQ,MAAM,EAAE,CAAC;IACpF,QAAQ;KACN,OAAO,SAAS,KAAK,EAAE,OAAO,qCAAqC,GAAG,EAAE,QAAQ,IAAI,CAAC;IACvF;GACF;GACA,QAAQ;IACN,SAAS;GACX;EACF;CACF;AACF"}

package/dist/sessionMcp.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./src/services/sessionMcpAuthorization/index.cjs");
+const require_sessionMcpHandler = require("./src/server/sessionMcpHandler.cjs");
+exports.SessionMcpOAuthError = require_index.SessionMcpOAuthError;
+exports.createSessionMcpAuthorizationService = require_index.createSessionMcpAuthorizationService;
+exports.createSessionMcpHttpHandler = require_sessionMcpHandler.createSessionMcpHttpHandler;

package/dist/sessionMcp.d.mts

@@ -0,0 +1,5 @@
+import { SessionSkillDescriptor, SessionToolDescriptor, SessionToolInvocation, SessionToolSurface, SessionToolSurfaceSnapshot, SessionUiResourceDescriptor } from "./src/types/server/sessionToolSurface.mjs";
+import { SessionMcpActivitySnapshot, SessionMcpAvailableTool, SessionMcpCall, SessionMcpCallStatus } from "./src/schemas/sessionMcpActivity.mjs";
+import { CreateSessionMcpAuthorizationBindingInput, CreateSessionMcpClientInput, CreatedSessionMcpClient, IssueSessionMcpAuthorizationCodeInput, SessionMcpAccessGrant, SessionMcpAuthorizationBinding, SessionMcpAuthorizationCode, SessionMcpAuthorizationService, SessionMcpAuthorizationServiceOptions, SessionMcpClient, SessionMcpGrant, SessionMcpOAuthError, SessionMcpOAuthErrorCode, SessionMcpScope, SessionMcpTokenRequest, SessionMcpTokenResponse, createSessionMcpAuthorizationService } from "./src/services/sessionMcpAuthorization/index.mjs";
+import { SessionMcpHttpHandler, SessionMcpHttpHandlerOptions, SessionMcpTarget, createSessionMcpHttpHandler } from "./src/server/sessionMcpHandler.mjs";
+export { type CreateSessionMcpAuthorizationBindingInput, type CreateSessionMcpClientInput, type CreatedSessionMcpClient, type IssueSessionMcpAuthorizationCodeInput, type SessionMcpAccessGrant, type SessionMcpActivitySnapshot, type SessionMcpAuthorizationBinding, type SessionMcpAuthorizationCode, type SessionMcpAuthorizationService, type SessionMcpAuthorizationServiceOptions, type SessionMcpAvailableTool, type SessionMcpCall, type SessionMcpCallStatus, type SessionMcpClient, type SessionMcpGrant, type SessionMcpHttpHandler, type SessionMcpHttpHandlerOptions, SessionMcpOAuthError, type SessionMcpOAuthErrorCode, type SessionMcpScope, type SessionMcpTarget, type SessionMcpTokenRequest, type SessionMcpTokenResponse, type SessionSkillDescriptor, type SessionToolDescriptor, type SessionToolInvocation, type SessionToolSurface, type SessionToolSurfaceSnapshot, type SessionUiResourceDescriptor, createSessionMcpAuthorizationService, createSessionMcpHttpHandler };

package/dist/sessionMcp.mjs

@@ -0,0 +1,3 @@
+import { SessionMcpOAuthError, createSessionMcpAuthorizationService } from "./src/services/sessionMcpAuthorization/index.mjs";
+import { createSessionMcpHttpHandler } from "./src/server/sessionMcpHandler.mjs";
+export { SessionMcpOAuthError, createSessionMcpAuthorizationService, createSessionMcpHttpHandler };