@earendil-works/pi-coding-agent 0.84.3 → 0.85.0

package/dist/experimental/services/transcript-provider.js

@@ -0,0 +1,109 @@
+import { defineFacet } from "@earendil-works/chord";
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { reduceLaneSnapshot, } from "@earendil-works/pi-agent-core";
+import { Transcript } from "./transcript.js";
+export function createTranscriptService(lane, createState) {
+    const state = createState({ snapshot: null, event: null });
+    let watch;
+    let rebase;
+    let rebaseError;
+    const publishSnapshot = (next, event, context) => {
+        state.state.snapshot = next;
+        state.state.event = event;
+        state.publish(context);
+    };
+    const scheduleRebase = (context) => {
+        if (rebase !== undefined)
+            return;
+        const activeWatch = watch;
+        if (activeWatch === undefined)
+            return;
+        const pending = (async () => {
+            const refreshed = await activeWatch.resnapshot(context);
+            publishSnapshot(refreshed, null, context);
+        })();
+        rebase = pending;
+        void pending.then(() => {
+            if (rebase === pending)
+                rebase = undefined;
+        }, (error) => {
+            rebaseError = error instanceof Error ? error : new Error(String(error));
+            if (rebase === pending)
+                rebase = undefined;
+        });
+    };
+    const onEvent = (event, context) => {
+        if (rebaseError !== undefined)
+            throw rebaseError;
+        const forwarded = toLaneWatchEvent(event);
+        if (forwarded === undefined)
+            return;
+        const snapshot = state.state.snapshot;
+        if (snapshot === null)
+            throw new Error("Transcript service is not active");
+        if (reduceLaneSnapshot(snapshot, event) === "rebase")
+            scheduleRebase(context);
+        state.state.event = forwarded;
+        state.publish(context);
+    };
+    return {
+        service: { state },
+        async activate() {
+            if (watch !== undefined)
+                throw new Error("Transcript service is already active");
+            const opened = await lane.watch(BACKGROUND_CONTEXT);
+            watch = opened;
+            publishSnapshot(opened.snapshot, null, BACKGROUND_CONTEXT);
+            opened.start(onEvent);
+        },
+        async dispose() {
+            let failure;
+            try {
+                await rebase;
+            }
+            catch (error) {
+                failure = error;
+            }
+            watch?.unsubscribe();
+            watch = undefined;
+            if (failure !== undefined)
+                throw failure;
+        },
+    };
+}
+export function createTranscriptServiceFacet(lane) {
+    return defineFacet({
+        id: "@pi/transcript",
+        setup(env) {
+            const runtime = createTranscriptService(lane, env.replicatedState);
+            env.provide(Transcript, runtime.service);
+            env.onActivate(() => runtime.activate());
+            env.own(() => runtime.dispose());
+        },
+    });
+}
+function toLaneWatchEvent(event) {
+    switch (event.type) {
+        case "handler_error":
+        case "turn_start":
+        case "turn_end":
+        case "value_update":
+        case "lane_created":
+            return undefined;
+        case "config_update":
+            if (event.property !== "model" && event.property !== "thinkingLevel" && event.property !== "activeTools") {
+                return undefined;
+            }
+            return event;
+        case "message_update": {
+            if (event.message.role !== "assistant") {
+                throw new TypeError("Harness message_update did not carry an assistant message");
+            }
+            const { event: _providerEvent, ...update } = event;
+            return update;
+        }
+        default:
+            return event;
+    }
+}
+//# sourceMappingURL=transcript-provider.js.map

package/dist/experimental/services/transcript-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-provider.js","sourceRoot":"","sources":["../../../src/experimental/services/transcript-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineFacet, type Facet, type MutableReplicatedState } from \"@earendil-works/chord\";\nimport { BACKGROUND_CONTEXT } from \"@earendil-works/chord/context\";\nimport {\n\ttype AgentLane,\n\ttype HarnessEvent,\n\ttype LaneSnapshot,\n\ttype LaneTranscriptSnapshot,\n\ttype LaneWatchEvent,\n\treduceLaneSnapshot,\n\ttype WatchHandle,\n} from \"@earendil-works/pi-agent-core\";\nimport { Transcript, type Transcript as TranscriptService, type TranscriptState } from \"./transcript.ts\";\n\ninterface TranscriptRuntime {\n\treadonly service: TranscriptService;\n\tactivate(): Promise<void>;\n\tdispose(): Promise<void>;\n}\n\nexport function createTranscriptService(\n\tlane: AgentLane,\n\tcreateState: (initial: TranscriptState) => MutableReplicatedState<TranscriptState>,\n): TranscriptRuntime {\n\tconst state = createState({ snapshot: null, event: null });\n\tlet watch: WatchHandle<LaneSnapshot> | undefined;\n\tlet rebase: Promise<void> | undefined;\n\tlet rebaseError: Error | undefined;\n\n\tconst publishSnapshot = (\n\t\tnext: LaneSnapshot,\n\t\tevent: LaneWatchEvent | null,\n\t\tcontext: Parameters<typeof state.publish>[0],\n\t): void => {\n\t\tstate.state.snapshot = next as LaneTranscriptSnapshot;\n\t\tstate.state.event = event;\n\t\tstate.publish(context);\n\t};\n\n\tconst scheduleRebase = (context: Parameters<typeof state.publish>[0]): void => {\n\t\tif (rebase !== undefined) return;\n\t\tconst activeWatch = watch;\n\t\tif (activeWatch === undefined) return;\n\t\tconst pending = (async () => {\n\t\t\tconst refreshed = await activeWatch.resnapshot(context);\n\t\t\tpublishSnapshot(refreshed, null, context);\n\t\t})();\n\t\trebase = pending;\n\t\tvoid pending.then(\n\t\t\t() => {\n\t\t\t\tif (rebase === pending) rebase = undefined;\n\t\t\t},\n\t\t\t(error: unknown) => {\n\t\t\t\trebaseError = error instanceof Error ? error : new Error(String(error));\n\t\t\t\tif (rebase === pending) rebase = undefined;\n\t\t\t},\n\t\t);\n\t};\n\n\tconst onEvent = (event: HarnessEvent, context: Parameters<typeof state.publish>[0]): void => {\n\t\tif (rebaseError !== undefined) throw rebaseError;\n\t\tconst forwarded = toLaneWatchEvent(event);\n\t\tif (forwarded === undefined) return;\n\t\tconst snapshot = state.state.snapshot;\n\t\tif (snapshot === null) throw new Error(\"Transcript service is not active\");\n\t\tif (reduceLaneSnapshot(snapshot, event) === \"rebase\") scheduleRebase(context);\n\t\tstate.state.event = forwarded;\n\t\tstate.publish(context);\n\t};\n\n\treturn {\n\t\tservice: { state },\n\t\tasync activate() {\n\t\t\tif (watch !== undefined) throw new Error(\"Transcript service is already active\");\n\t\t\tconst opened = await lane.watch(BACKGROUND_CONTEXT);\n\t\t\twatch = opened;\n\t\t\tpublishSnapshot(opened.snapshot, null, BACKGROUND_CONTEXT);\n\t\t\topened.start(onEvent);\n\t\t},\n\t\tasync dispose() {\n\t\t\tlet failure: unknown;\n\t\t\ttry {\n\t\t\t\tawait rebase;\n\t\t\t} catch (error) {\n\t\t\t\tfailure = error;\n\t\t\t}\n\t\t\twatch?.unsubscribe();\n\t\t\twatch = undefined;\n\t\t\tif (failure !== undefined) throw failure;\n\t\t},\n\t};\n}\n\nexport function createTranscriptServiceFacet(lane: AgentLane): Facet {\n\treturn defineFacet({\n\t\tid: \"@pi/transcript\",\n\t\tsetup(env) {\n\t\t\tconst runtime = createTranscriptService(lane, env.replicatedState);\n\t\t\tenv.provide(Transcript, runtime.service);\n\t\t\tenv.onActivate(() => runtime.activate());\n\t\t\tenv.own(() => runtime.dispose());\n\t\t},\n\t});\n}\n\nfunction toLaneWatchEvent(event: HarnessEvent): LaneWatchEvent | undefined {\n\tswitch (event.type) {\n\t\tcase \"handler_error\":\n\t\tcase \"turn_start\":\n\t\tcase \"turn_end\":\n\t\tcase \"value_update\":\n\t\tcase \"lane_created\":\n\t\t\treturn undefined;\n\t\tcase \"config_update\":\n\t\t\tif (event.property !== \"model\" && event.property !== \"thinkingLevel\" && event.property !== \"activeTools\") {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn event as LaneWatchEvent;\n\t\tcase \"message_update\": {\n\t\t\tif (event.message.role !== \"assistant\") {\n\t\t\t\tthrow new TypeError(\"Harness message_update did not carry an assistant message\");\n\t\t\t}\n\t\t\tconst { event: _providerEvent, ...update } = event;\n\t\t\treturn update as LaneWatchEvent;\n\t\t}\n\t\tdefault:\n\t\t\treturn event as LaneWatchEvent;\n\t}\n}\n"]}

package/dist/experimental/services/transcript.d.ts

@@ -0,0 +1,13 @@
+import { type ReplicatedState } from "@earendil-works/chord";
+import type { LaneTranscriptSnapshot, LaneWatchEvent } from "@earendil-works/pi-agent-core";
+export interface TranscriptState {
+    snapshot: LaneTranscriptSnapshot | null;
+    /** The source event is retained for presentation side effects; hydration does not replay it. */
+    event: LaneWatchEvent | null;
+}
+/** Coherent main-lane state replicated through Chord's operation stream. */
+export interface Transcript {
+    readonly state: ReplicatedState<TranscriptState>;
+}
+export declare const Transcript: import("@earendil-works/chord").Service<Transcript>;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/experimental/services/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/experimental/services/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE5F,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,gGAAgG;IAChG,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CAC7B;AAED,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;CACjD;AAED,eAAO,MAAM,UAAU,qDAA6C,CAAC","sourcesContent":["import { defineService, type ReplicatedState } from \"@earendil-works/chord\";\nimport type { LaneTranscriptSnapshot, LaneWatchEvent } from \"@earendil-works/pi-agent-core\";\n\nexport interface TranscriptState {\n\tsnapshot: LaneTranscriptSnapshot | null;\n\t/** The source event is retained for presentation side effects; hydration does not replay it. */\n\tevent: LaneWatchEvent | null;\n}\n\n/** Coherent main-lane state replicated through Chord's operation stream. */\nexport interface Transcript {\n\treadonly state: ReplicatedState<TranscriptState>;\n}\n\nexport const Transcript = defineService<Transcript>(\"pi.transcript\");\n"]}

package/dist/experimental/services/transcript.js

@@ -0,0 +1,3 @@
+import { defineService } from "@earendil-works/chord";
+export const Transcript = defineService("pi.transcript");
+//# sourceMappingURL=transcript.js.map

package/dist/experimental/services/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../../src/experimental/services/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAwB,MAAM,uBAAuB,CAAC;AAc5E,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAa,eAAe,CAAC,CAAC","sourcesContent":["import { defineService, type ReplicatedState } from \"@earendil-works/chord\";\nimport type { LaneTranscriptSnapshot, LaneWatchEvent } from \"@earendil-works/pi-agent-core\";\n\nexport interface TranscriptState {\n\tsnapshot: LaneTranscriptSnapshot | null;\n\t/** The source event is retained for presentation side effects; hydration does not replay it. */\n\tevent: LaneWatchEvent | null;\n}\n\n/** Coherent main-lane state replicated through Chord's operation stream. */\nexport interface Transcript {\n\treadonly state: ReplicatedState<TranscriptState>;\n}\n\nexport const Transcript = defineService<Transcript>(\"pi.transcript\");\n"]}

package/dist/experimental/services/worker.d.ts

@@ -0,0 +1,28 @@
+import { type Context, type FacetLoader, type JsonValue, type ServiceCall, type ServiceProviderUpdate } from "@earendil-works/chord";
+import type { AgentHarness, AgentLane } from "@earendil-works/pi-agent-core";
+import type { ModelRuntime } from "../../core/model-runtime.ts";
+import type { SettingsManager } from "../../core/settings-manager.ts";
+export interface SessionWorkerRuntime {
+    readonly harness: AgentHarness;
+    readonly lane?: AgentLane;
+    readonly modelRuntime?: ModelRuntime;
+    readonly settingsManager?: SettingsManager;
+    readonly facetLoader?: FacetLoader;
+}
+export interface WorkerServiceScope {
+    readonly serverConnectionId: string;
+    readonly attachmentId: string;
+}
+export interface SessionWorkerServices {
+    invoke(call: ServiceCall, scope: WorkerServiceScope, context: Context): Promise<JsonValue | undefined>;
+    removeSubscriptions(matches: (scope: WorkerServiceScope) => boolean): void;
+    dispose(): Promise<void>;
+}
+export declare function createSessionWorkerServices(options: {
+    readonly lane: AgentLane;
+    readonly modelRuntime: ModelRuntime | undefined;
+    readonly settingsManager?: SettingsManager;
+    readonly facetLoader?: FacetLoader;
+    publish(scope: WorkerServiceScope, subscriptionId: string, update: ServiceProviderUpdate): Promise<void>;
+}): Promise<SessionWorkerServices>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/experimental/services/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/experimental/services/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EAMZ,KAAK,WAAW,EAChB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAOtE,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC9B;AAOD,MAAM,WAAW,qBAAqB;IACrC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACvG,mBAAmB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,GAAG,IAAI,CAAC;IAC3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IAC1D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzG,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+FjC","sourcesContent":["import {\n\ttype Context,\n\tcreateFacetHost,\n\tcreateRemoteServiceEndpoint,\n\tcreateStaticFacetLoader,\n\tdefineFacet,\n\ttype FacetHost,\n\ttype FacetLoader,\n\ttype JsonValue,\n\ttype RemoteServiceEndpoint,\n\ttype ServiceCall,\n\ttype ServiceProviderUpdate,\n} from \"@earendil-works/chord\";\nimport type { AgentHarness, AgentLane } from \"@earendil-works/pi-agent-core\";\nimport type { ModelRuntime } from \"../../core/model-runtime.ts\";\nimport type { SettingsManager } from \"../../core/settings-manager.ts\";\nimport { AgentController } from \"./agent-controller.ts\";\nimport { createAgentController } from \"./agent-controller-provider.ts\";\nimport { createModelsServiceFacet } from \"./models-provider.ts\";\nimport { SessionPlugins } from \"./plugins.ts\";\nimport { createTranscriptServiceFacet } from \"./transcript-provider.ts\";\n\nexport interface SessionWorkerRuntime {\n\treadonly harness: AgentHarness;\n\treadonly lane?: AgentLane;\n\treadonly modelRuntime?: ModelRuntime;\n\treadonly settingsManager?: SettingsManager;\n\treadonly facetLoader?: FacetLoader;\n}\n\nexport interface WorkerServiceScope {\n\treadonly serverConnectionId: string;\n\treadonly attachmentId: string;\n}\n\ninterface ScopedServiceEndpoint {\n\treadonly scope: WorkerServiceScope;\n\treadonly endpoint: RemoteServiceEndpoint;\n}\n\nexport interface SessionWorkerServices {\n\tinvoke(call: ServiceCall, scope: WorkerServiceScope, context: Context): Promise<JsonValue | undefined>;\n\tremoveSubscriptions(matches: (scope: WorkerServiceScope) => boolean): void;\n\tdispose(): Promise<void>;\n}\n\nexport async function createSessionWorkerServices(options: {\n\treadonly lane: AgentLane;\n\treadonly modelRuntime: ModelRuntime | undefined;\n\treadonly settingsManager?: SettingsManager;\n\treadonly facetLoader?: FacetLoader;\n\tpublish(scope: WorkerServiceScope, subscriptionId: string, update: ServiceProviderUpdate): Promise<void>;\n}): Promise<SessionWorkerServices> {\n\tconst agentControllerRuntimeFacet = defineFacet({\n\t\tid: \"@pi/agent-controller-runtime\",\n\t\tsetup(env) {\n\t\t\tenv.provide(AgentController, createAgentController(options.lane));\n\t\t},\n\t});\n\tlet reloadPlugins = (): Promise<void> => Promise.reject(new Error(\"Session plugins are not ready\"));\n\tconst pluginRuntimeFacet = defineFacet({\n\t\tid: \"@pi/session-plugins-runtime\",\n\t\tsetup(env) {\n\t\t\tenv.provide(SessionPlugins, { reload: () => reloadPlugins() });\n\t\t},\n\t});\n\tconst builtins = await createStaticFacetLoader([\n\t\tagentControllerRuntimeFacet,\n\t\tpluginRuntimeFacet,\n\t\tcreateModelsServiceFacet(options),\n\t\tcreateTranscriptServiceFacet(options.lane),\n\t]).load();\n\tconst pluginLoader = options.facetLoader ?? createStaticFacetLoader([]);\n\tlet loadedPlugins = await pluginLoader.load();\n\tlet facetHost: FacetHost;\n\ttry {\n\t\tfacetHost = await createFacetHost({ facets: [...builtins.facets, ...loadedPlugins.facets] });\n\t} catch (error) {\n\t\tconst cleanup = await Promise.allSettled([loadedPlugins.dispose(), builtins.dispose()]);\n\t\tconst cleanupErrors = cleanup.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n\t\tif (cleanupErrors.length > 0) {\n\t\t\tthrow new AggregateError([error, ...cleanupErrors], \"Session facets failed to start and clean up\");\n\t\t}\n\t\tthrow error;\n\t}\n\tlet reloadTail = Promise.resolve();\n\treloadPlugins = () => {\n\t\tconst operation = reloadTail.then(async () => {\n\t\t\tconst candidate = await pluginLoader.load();\n\t\t\ttry {\n\t\t\t\tawait facetHost.reload(candidate.facets);\n\t\t\t} catch (error) {\n\t\t\t\ttry {\n\t\t\t\t\tawait candidate.dispose();\n\t\t\t\t} catch (cleanupError) {\n\t\t\t\t\tthrow new AggregateError([error, cleanupError], \"Session plugin reload and cleanup failed\");\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst retired = loadedPlugins;\n\t\t\tloadedPlugins = candidate;\n\t\t\tawait retired.dispose();\n\t\t});\n\t\treloadTail = operation.catch(() => {});\n\t\treturn operation;\n\t};\n\tconst provider = facetHost.services;\n\n\tconst endpoints = new Map<string, ScopedServiceEndpoint>();\n\tconst removeSubscriptions = (matches: (scope: WorkerServiceScope) => boolean): void => {\n\t\tfor (const [key, entry] of endpoints) {\n\t\t\tif (!matches(entry.scope)) continue;\n\t\t\tentry.endpoint.dispose();\n\t\t\tendpoints.delete(key);\n\t\t}\n\t};\n\n\treturn {\n\t\tinvoke(call, scope, context) {\n\t\t\tconst key = serviceScopeKey(scope);\n\t\t\tlet entry = endpoints.get(key);\n\t\t\tif (entry === undefined) {\n\t\t\t\tentry = { scope, endpoint: createRemoteServiceEndpoint(provider) };\n\t\t\t\tendpoints.set(key, entry);\n\t\t\t}\n\t\t\treturn entry.endpoint.invoke(\n\t\t\t\tcall,\n\t\t\t\t(subscriptionId, update) => options.publish(scope, subscriptionId, update),\n\t\t\t\tcontext,\n\t\t\t);\n\t\t},\n\t\tremoveSubscriptions,\n\t\tasync dispose() {\n\t\t\tremoveSubscriptions(() => true);\n\t\t\tawait reloadTail;\n\t\t\tconst errors: unknown[] = [];\n\t\t\ttry {\n\t\t\t\tawait facetHost.dispose();\n\t\t\t} catch (error) {\n\t\t\t\terrors.push(error);\n\t\t\t}\n\t\t\tconst results = await Promise.allSettled([loadedPlugins.dispose(), builtins.dispose()]);\n\t\t\terrors.push(...results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : [])));\n\t\t\tif (errors.length === 1) throw errors[0];\n\t\t\tif (errors.length > 1) throw new AggregateError(errors, \"Failed to dispose Session facets\");\n\t\t},\n\t};\n}\n\nfunction serviceScopeKey(scope: WorkerServiceScope): string {\n\treturn `${scope.serverConnectionId}\\0${scope.attachmentId}`;\n}\n"]}

package/dist/experimental/services/worker.js

@@ -0,0 +1,107 @@
+import { createFacetHost, createRemoteServiceEndpoint, createStaticFacetLoader, defineFacet, } from "@earendil-works/chord";
+import { AgentController } from "./agent-controller.js";
+import { createAgentController } from "./agent-controller-provider.js";
+import { createModelsServiceFacet } from "./models-provider.js";
+import { SessionPlugins } from "./plugins.js";
+import { createTranscriptServiceFacet } from "./transcript-provider.js";
+export async function createSessionWorkerServices(options) {
+    const agentControllerRuntimeFacet = defineFacet({
+        id: "@pi/agent-controller-runtime",
+        setup(env) {
+            env.provide(AgentController, createAgentController(options.lane));
+        },
+    });
+    let reloadPlugins = () => Promise.reject(new Error("Session plugins are not ready"));
+    const pluginRuntimeFacet = defineFacet({
+        id: "@pi/session-plugins-runtime",
+        setup(env) {
+            env.provide(SessionPlugins, { reload: () => reloadPlugins() });
+        },
+    });
+    const builtins = await createStaticFacetLoader([
+        agentControllerRuntimeFacet,
+        pluginRuntimeFacet,
+        createModelsServiceFacet(options),
+        createTranscriptServiceFacet(options.lane),
+    ]).load();
+    const pluginLoader = options.facetLoader ?? createStaticFacetLoader([]);
+    let loadedPlugins = await pluginLoader.load();
+    let facetHost;
+    try {
+        facetHost = await createFacetHost({ facets: [...builtins.facets, ...loadedPlugins.facets] });
+    }
+    catch (error) {
+        const cleanup = await Promise.allSettled([loadedPlugins.dispose(), builtins.dispose()]);
+        const cleanupErrors = cleanup.flatMap((result) => (result.status === "rejected" ? [result.reason] : []));
+        if (cleanupErrors.length > 0) {
+            throw new AggregateError([error, ...cleanupErrors], "Session facets failed to start and clean up");
+        }
+        throw error;
+    }
+    let reloadTail = Promise.resolve();
+    reloadPlugins = () => {
+        const operation = reloadTail.then(async () => {
+            const candidate = await pluginLoader.load();
+            try {
+                await facetHost.reload(candidate.facets);
+            }
+            catch (error) {
+                try {
+                    await candidate.dispose();
+                }
+                catch (cleanupError) {
+                    throw new AggregateError([error, cleanupError], "Session plugin reload and cleanup failed");
+                }
+                throw error;
+            }
+            const retired = loadedPlugins;
+            loadedPlugins = candidate;
+            await retired.dispose();
+        });
+        reloadTail = operation.catch(() => { });
+        return operation;
+    };
+    const provider = facetHost.services;
+    const endpoints = new Map();
+    const removeSubscriptions = (matches) => {
+        for (const [key, entry] of endpoints) {
+            if (!matches(entry.scope))
+                continue;
+            entry.endpoint.dispose();
+            endpoints.delete(key);
+        }
+    };
+    return {
+        invoke(call, scope, context) {
+            const key = serviceScopeKey(scope);
+            let entry = endpoints.get(key);
+            if (entry === undefined) {
+                entry = { scope, endpoint: createRemoteServiceEndpoint(provider) };
+                endpoints.set(key, entry);
+            }
+            return entry.endpoint.invoke(call, (subscriptionId, update) => options.publish(scope, subscriptionId, update), context);
+        },
+        removeSubscriptions,
+        async dispose() {
+            removeSubscriptions(() => true);
+            await reloadTail;
+            const errors = [];
+            try {
+                await facetHost.dispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            const results = await Promise.allSettled([loadedPlugins.dispose(), builtins.dispose()]);
+            errors.push(...results.flatMap((result) => (result.status === "rejected" ? [result.reason] : [])));
+            if (errors.length === 1)
+                throw errors[0];
+            if (errors.length > 1)
+                throw new AggregateError(errors, "Failed to dispose Session facets");
+        },
+    };
+}
+function serviceScopeKey(scope) {
+    return `${scope.serverConnectionId}\0${scope.attachmentId}`;
+}
+//# sourceMappingURL=worker.js.map

package/dist/experimental/services/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/experimental/services/worker.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype Context,\n\tcreateFacetHost,\n\tcreateRemoteServiceEndpoint,\n\tcreateStaticFacetLoader,\n\tdefineFacet,\n\ttype FacetHost,\n\ttype FacetLoader,\n\ttype JsonValue,\n\ttype RemoteServiceEndpoint,\n\ttype ServiceCall,\n\ttype ServiceProviderUpdate,\n} from \"@earendil-works/chord\";\nimport type { AgentHarness, AgentLane } from \"@earendil-works/pi-agent-core\";\nimport type { ModelRuntime } from \"../../core/model-runtime.ts\";\nimport type { SettingsManager } from \"../../core/settings-manager.ts\";\nimport { AgentController } from \"./agent-controller.ts\";\nimport { createAgentController } from \"./agent-controller-provider.ts\";\nimport { createModelsServiceFacet } from \"./models-provider.ts\";\nimport { SessionPlugins } from \"./plugins.ts\";\nimport { createTranscriptServiceFacet } from \"./transcript-provider.ts\";\n\nexport interface SessionWorkerRuntime {\n\treadonly harness: AgentHarness;\n\treadonly lane?: AgentLane;\n\treadonly modelRuntime?: ModelRuntime;\n\treadonly settingsManager?: SettingsManager;\n\treadonly facetLoader?: FacetLoader;\n}\n\nexport interface WorkerServiceScope {\n\treadonly serverConnectionId: string;\n\treadonly attachmentId: string;\n}\n\ninterface ScopedServiceEndpoint {\n\treadonly scope: WorkerServiceScope;\n\treadonly endpoint: RemoteServiceEndpoint;\n}\n\nexport interface SessionWorkerServices {\n\tinvoke(call: ServiceCall, scope: WorkerServiceScope, context: Context): Promise<JsonValue | undefined>;\n\tremoveSubscriptions(matches: (scope: WorkerServiceScope) => boolean): void;\n\tdispose(): Promise<void>;\n}\n\nexport async function createSessionWorkerServices(options: {\n\treadonly lane: AgentLane;\n\treadonly modelRuntime: ModelRuntime | undefined;\n\treadonly settingsManager?: SettingsManager;\n\treadonly facetLoader?: FacetLoader;\n\tpublish(scope: WorkerServiceScope, subscriptionId: string, update: ServiceProviderUpdate): Promise<void>;\n}): Promise<SessionWorkerServices> {\n\tconst agentControllerRuntimeFacet = defineFacet({\n\t\tid: \"@pi/agent-controller-runtime\",\n\t\tsetup(env) {\n\t\t\tenv.provide(AgentController, createAgentController(options.lane));\n\t\t},\n\t});\n\tlet reloadPlugins = (): Promise<void> => Promise.reject(new Error(\"Session plugins are not ready\"));\n\tconst pluginRuntimeFacet = defineFacet({\n\t\tid: \"@pi/session-plugins-runtime\",\n\t\tsetup(env) {\n\t\t\tenv.provide(SessionPlugins, { reload: () => reloadPlugins() });\n\t\t},\n\t});\n\tconst builtins = await createStaticFacetLoader([\n\t\tagentControllerRuntimeFacet,\n\t\tpluginRuntimeFacet,\n\t\tcreateModelsServiceFacet(options),\n\t\tcreateTranscriptServiceFacet(options.lane),\n\t]).load();\n\tconst pluginLoader = options.facetLoader ?? createStaticFacetLoader([]);\n\tlet loadedPlugins = await pluginLoader.load();\n\tlet facetHost: FacetHost;\n\ttry {\n\t\tfacetHost = await createFacetHost({ facets: [...builtins.facets, ...loadedPlugins.facets] });\n\t} catch (error) {\n\t\tconst cleanup = await Promise.allSettled([loadedPlugins.dispose(), builtins.dispose()]);\n\t\tconst cleanupErrors = cleanup.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n\t\tif (cleanupErrors.length > 0) {\n\t\t\tthrow new AggregateError([error, ...cleanupErrors], \"Session facets failed to start and clean up\");\n\t\t}\n\t\tthrow error;\n\t}\n\tlet reloadTail = Promise.resolve();\n\treloadPlugins = () => {\n\t\tconst operation = reloadTail.then(async () => {\n\t\t\tconst candidate = await pluginLoader.load();\n\t\t\ttry {\n\t\t\t\tawait facetHost.reload(candidate.facets);\n\t\t\t} catch (error) {\n\t\t\t\ttry {\n\t\t\t\t\tawait candidate.dispose();\n\t\t\t\t} catch (cleanupError) {\n\t\t\t\t\tthrow new AggregateError([error, cleanupError], \"Session plugin reload and cleanup failed\");\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst retired = loadedPlugins;\n\t\t\tloadedPlugins = candidate;\n\t\t\tawait retired.dispose();\n\t\t});\n\t\treloadTail = operation.catch(() => {});\n\t\treturn operation;\n\t};\n\tconst provider = facetHost.services;\n\n\tconst endpoints = new Map<string, ScopedServiceEndpoint>();\n\tconst removeSubscriptions = (matches: (scope: WorkerServiceScope) => boolean): void => {\n\t\tfor (const [key, entry] of endpoints) {\n\t\t\tif (!matches(entry.scope)) continue;\n\t\t\tentry.endpoint.dispose();\n\t\t\tendpoints.delete(key);\n\t\t}\n\t};\n\n\treturn {\n\t\tinvoke(call, scope, context) {\n\t\t\tconst key = serviceScopeKey(scope);\n\t\t\tlet entry = endpoints.get(key);\n\t\t\tif (entry === undefined) {\n\t\t\t\tentry = { scope, endpoint: createRemoteServiceEndpoint(provider) };\n\t\t\t\tendpoints.set(key, entry);\n\t\t\t}\n\t\t\treturn entry.endpoint.invoke(\n\t\t\t\tcall,\n\t\t\t\t(subscriptionId, update) => options.publish(scope, subscriptionId, update),\n\t\t\t\tcontext,\n\t\t\t);\n\t\t},\n\t\tremoveSubscriptions,\n\t\tasync dispose() {\n\t\t\tremoveSubscriptions(() => true);\n\t\t\tawait reloadTail;\n\t\t\tconst errors: unknown[] = [];\n\t\t\ttry {\n\t\t\t\tawait facetHost.dispose();\n\t\t\t} catch (error) {\n\t\t\t\terrors.push(error);\n\t\t\t}\n\t\t\tconst results = await Promise.allSettled([loadedPlugins.dispose(), builtins.dispose()]);\n\t\t\terrors.push(...results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : [])));\n\t\t\tif (errors.length === 1) throw errors[0];\n\t\t\tif (errors.length > 1) throw new AggregateError(errors, \"Failed to dispose Session facets\");\n\t\t},\n\t};\n}\n\nfunction serviceScopeKey(scope: WorkerServiceScope): string {\n\treturn `${scope.serverConnectionId}\\0${scope.attachmentId}`;\n}\n"]}

package/dist/experimental/session-worker-manager.d.ts

@@ -0,0 +1,24 @@
+import { type Context, type JsonlSessionMetadata } from "@earendil-works/pi-agent-core";
+import { type RoutedSessionHandle } from "@earendil-works/pi-server";
+import type { CoordinatorConnection } from "./coordinator.ts";
+export declare class SessionPluginSelectionConflictError extends Error {
+    constructor(message: string);
+}
+/** Session and process bookkeeping owned by one replaceable server process. */
+export declare class SessionWorkerManager {
+    #private;
+    readonly workerPids: Map<string, number>;
+    constructor(coordinator: Pick<CoordinatorConnection, "controlPath" | "serverConnectionId" | "wasReplaced" | "onEvent" | "send" | "broadcast">, sessionDir: string, model?: {
+        readonly provider?: string;
+        readonly model: string;
+    }, onWorkerCountChanged?: (count: number) => void);
+    get trackedSessions(): readonly JsonlSessionMetadata[];
+    assertSessionPluginManifestPaths(metadata: JsonlSessionMetadata, manifestPaths: readonly string[]): void;
+    discover(peerIds: ReadonlySet<string>): Promise<void>;
+    openSession(metadata: JsonlSessionMetadata, context: Context, pluginManifestPaths: readonly string[]): Promise<RoutedSessionHandle>;
+    closeSession(metadata: JsonlSessionMetadata, context: Context): Promise<void>;
+    shutdown(): Promise<void>;
+    /** Forget workers without stopping them when this server is replaced. */
+    detach(): void;
+}
+//# sourceMappingURL=session-worker-manager.d.ts.map

package/dist/experimental/session-worker-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-worker-manager.d.ts","sourceRoot":"","sources":["../../src/experimental/session-worker-manager.ts"],"names":[],"mappings":"AAWA,OAAO,EAEN,KAAK,OAAO,EACZ,KAAK,oBAAoB,EAEzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAgC,KAAK,mBAAmB,EAAe,MAAM,2BAA2B,CAAC;AAEhH,OAAO,KAAK,EAAE,qBAAqB,EAA8B,MAAM,kBAAkB,CAAC;AAmB1F,qBAAa,mCAAoC,SAAQ,KAAK;IAC7D,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAqDD,+EAA+E;AAC/E,qBAAa,oBAAoB;;IAChC,QAAQ,CAAC,UAAU,sBAA6B;IAoBhD,YACC,WAAW,EAAE,IAAI,CAChB,qBAAqB,EACrB,aAAa,GAAG,oBAAoB,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CACvF,EACD,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAC9D,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAO9C;IAED,IAAI,eAAe,IAAI,SAAS,oBAAoB,EAAE,CAErD;IAED,gCAAgC,CAAC,QAAQ,EAAE,oBAAoB,EAAE,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAavG;IAEK,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB1D;IAEK,WAAW,CAChB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,OAAO,EAChB,mBAAmB,EAAE,SAAS,MAAM,EAAE,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAQ9B;IAEK,YAAY,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF;IAmNK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA8B9B;IAED,yEAAyE;IACzE,MAAM,IAAI,IAAI,CAWb;CAwYD","sourcesContent":["import type { ChildProcess } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { isAbsolute } from \"node:path\";\nimport {\n\tcreateServiceUnsubscribeCall,\n\tdecodeServiceControlCall,\n\ttype JsonValue,\n\tparseServiceProviderUpdate,\n\ttype ServiceCall,\n\ttype ServiceProviderUpdate,\n} from \"@earendil-works/chord\";\nimport {\n\tBACKGROUND_CONTEXT,\n\ttype Context,\n\ttype JsonlSessionMetadata,\n\tTODO_CONTEXT,\n} from \"@earendil-works/pi-agent-core\";\nimport { type RoutedSessionAttachment, type RoutedSessionHandle, ServerError } from \"@earendil-works/pi-server\";\nimport { Check } from \"typebox/value\";\nimport type { CoordinatorConnection, CoordinatorConnectionEvent } from \"./coordinator.ts\";\nimport { spawnInternalProcess } from \"./process.ts\";\nimport {\n\tSESSION_WORKER_CONTROL_ADDRESS_ENV,\n\tSESSION_WORKER_CONTROL_TOKEN_ENV,\n\tSESSION_WORKER_PEER_ID_ENV,\n\tSESSION_WORKER_SESSION_KEY_ENV,\n\ttype SessionWorkerEvent,\n\tSessionWorkerEventSchema,\n\ttype SessionWorkerOptions,\n\ttype WorkerOperationResponse,\n\ttype WorkerOperationScope,\n} from \"./session-worker.ts\";\n\nconst WORKER_STARTUP_TIMEOUT_MS = 15_000;\nconst WORKER_SHUTDOWN_TIMEOUT_MS = 10_000;\nconst WORKER_DISCOVERY_TIMEOUT_MS = 5_000;\nconst WORKER_DEMAND_TIMEOUT_MS = 5_000;\n\nexport class SessionPluginSelectionConflictError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"SessionPluginSelectionConflictError\";\n\t}\n}\n\ninterface WorkerRecord {\n\treadonly peerId: string;\n\treadonly metadata: JsonlSessionMetadata;\n\treadonly pid: number;\n\treadonly token: string;\n\treadonly pluginManifestPaths: readonly string[];\n\treadonly terminated: Promise<Error | undefined>;\n\tresolveTerminated(error: Error | undefined): void;\n\treadonly attachmentIds: Set<string>;\n\texpectedStop: boolean;\n\tstopPromise?: Promise<void>;\n\tstopping: boolean;\n}\n\ninterface PendingDemand {\n\treadonly attachmentId: string;\n\treadonly attached: boolean;\n\treadonly requestId: string;\n\treadonly timer: NodeJS.Timeout;\n\treadonly worker: WorkerRecord;\n\tresolve(): void;\n\treject(error: Error): void;\n}\n\ninterface PendingWorkerOperation {\n\treadonly worker: WorkerRecord;\n\treadonly scope: WorkerOperationScope;\n\tcleanup(): void;\n\tresolve(result: JsonValue | undefined): void;\n\treject(error: Error): void;\n}\n\ninterface WorkerServiceSubscription {\n\treadonly worker: WorkerRecord;\n\treadonly scope: WorkerOperationScope;\n\treadonly listener: (update: ServiceProviderUpdate, context: Context) => void | Promise<void>;\n\tdeliveryTail: Promise<void>;\n}\n\ninterface PendingLaunch {\n\treadonly sessionKey: string;\n\treadonly peerId: string;\n\treadonly token: string;\n\treadonly pluginManifestPaths: readonly string[];\n\treadonly child: ChildProcess;\n\treadonly timer: NodeJS.Timeout;\n\treadonly promise: Promise<WorkerRecord>;\n\tresolve(worker: WorkerRecord): void;\n\treject(error: Error): void;\n}\n\n/** Session and process bookkeeping owned by one replaceable server process. */\nexport class SessionWorkerManager {\n\treadonly workerPids = new Map<string, number>();\n\treadonly #coordinator: Pick<\n\t\tCoordinatorConnection,\n\t\t\"controlPath\" | \"serverConnectionId\" | \"wasReplaced\" | \"onEvent\" | \"send\" | \"broadcast\"\n\t>;\n\treadonly #sessionDir: string;\n\treadonly #model: { readonly provider?: string; readonly model: string } | undefined;\n\treadonly #workersBySession = new Map<string, WorkerRecord>();\n\treadonly #workersByPeer = new Map<string, WorkerRecord>();\n\treadonly #pending = new Map<string, PendingLaunch>();\n\treadonly #pendingDemand = new Map<string, PendingDemand>();\n\treadonly #pendingOperations = new Map<string, PendingWorkerOperation>();\n\treadonly #serviceSubscriptions = new Map<string, WorkerServiceSubscription>();\n\treadonly #removeListener: () => void;\n\treadonly #onWorkerCountChanged: ((count: number) => void) | undefined;\n\t#discoveryPeers?: Set<string>;\n\t#resolveDiscovery?: () => void;\n\t#detached = false;\n\t#shuttingDown = false;\n\n\tconstructor(\n\t\tcoordinator: Pick<\n\t\t\tCoordinatorConnection,\n\t\t\t\"controlPath\" | \"serverConnectionId\" | \"wasReplaced\" | \"onEvent\" | \"send\" | \"broadcast\"\n\t\t>,\n\t\tsessionDir: string,\n\t\tmodel?: { readonly provider?: string; readonly model: string },\n\t\tonWorkerCountChanged?: (count: number) => void,\n\t) {\n\t\tthis.#coordinator = coordinator;\n\t\tthis.#sessionDir = sessionDir;\n\t\tthis.#model = model;\n\t\tthis.#onWorkerCountChanged = onWorkerCountChanged;\n\t\tthis.#removeListener = coordinator.onEvent((event) => this.#handleCoordinatorEvent(event));\n\t}\n\n\tget trackedSessions(): readonly JsonlSessionMetadata[] {\n\t\treturn [...this.#workersBySession.values()].map((worker) => worker.metadata);\n\t}\n\n\tassertSessionPluginManifestPaths(metadata: JsonlSessionMetadata, manifestPaths: readonly string[]): void {\n\t\tconst existing = this.#workersBySession.get(metadata.path);\n\t\tif (existing !== undefined && !sameStrings(existing.pluginManifestPaths, manifestPaths)) {\n\t\t\tthrow new SessionPluginSelectionConflictError(\n\t\t\t\t`Session ${metadata.id} is active with a different plugin selection`,\n\t\t\t);\n\t\t}\n\t\tconst pending = this.#pending.get(metadata.path);\n\t\tif (pending !== undefined && !sameStrings(pending.pluginManifestPaths, manifestPaths)) {\n\t\t\tthrow new SessionPluginSelectionConflictError(\n\t\t\t\t`Session ${metadata.id} is starting with a different plugin selection`,\n\t\t\t);\n\t\t}\n\t}\n\n\tasync discover(peerIds: ReadonlySet<string>): Promise<void> {\n\t\tif (this.#detached) return;\n\t\tconst undiscovered = new Set(\n\t\t\t[...peerIds].filter((peerId) => !this.#workersByPeer.has(peerId) && !this.#pendingPeer(peerId)),\n\t\t);\n\t\tif (undiscovered.size === 0) return;\n\t\tthis.#discoveryPeers = undiscovered;\n\t\tconst discovered = new Promise<void>((resolve) => {\n\t\t\tthis.#resolveDiscovery = resolve;\n\t\t});\n\t\tawait this.#coordinator.broadcast({ type: \"discover_workers\" });\n\t\tlet timer: NodeJS.Timeout | undefined;\n\t\tawait Promise.race([\n\t\t\tdiscovered,\n\t\t\tnew Promise<void>((resolve) => {\n\t\t\t\ttimer = setTimeout(resolve, WORKER_DISCOVERY_TIMEOUT_MS);\n\t\t\t\ttimer.unref();\n\t\t\t}),\n\t\t]);\n\t\tif (timer) clearTimeout(timer);\n\t\tthis.#discoveryPeers = undefined;\n\t\tthis.#resolveDiscovery = undefined;\n\t}\n\n\tasync openSession(\n\t\tmetadata: JsonlSessionMetadata,\n\t\tcontext: Context,\n\t\tpluginManifestPaths: readonly string[],\n\t): Promise<RoutedSessionHandle> {\n\t\tif (this.#detached || this.#shuttingDown) throw new Error(\"Experimental server is shutting down\");\n\t\tthis.assertSessionPluginManifestPaths(metadata, pluginManifestPaths);\n\t\tconst existing = this.#workersBySession.get(metadata.path);\n\t\tif (existing) return this.#routedHandle(existing);\n\t\tconst pending = this.#pending.get(metadata.path);\n\t\tif (pending) return this.#routedHandle(await pending.promise);\n\t\treturn this.#routedHandle(await this.#launch(metadata, context, pluginManifestPaths));\n\t}\n\n\tasync closeSession(metadata: JsonlSessionMetadata, context: Context): Promise<void> {\n\t\tconst worker = this.#workersBySession.get(metadata.path) ?? (await this.#pending.get(metadata.path)?.promise);\n\t\tif (worker !== undefined) await this.#stopWorker(worker, context);\n\t}\n\n\t#routedHandle(worker: WorkerRecord): RoutedSessionHandle {\n\t\treturn {\n\t\t\tterminated: worker.terminated,\n\t\t\tattachClient: (context) => this.#attachClient(worker, context),\n\t\t\tclose: (context) => this.#stopWorker(worker, context),\n\t\t};\n\t}\n\n\tasync #attachClient(worker: WorkerRecord, context: Context): Promise<RoutedSessionAttachment> {\n\t\tif (this.#detached || this.#shuttingDown || worker.stopping) {\n\t\t\tthrow new Error(\"Experimental Session worker is stopping\");\n\t\t}\n\t\tif (this.#workersByPeer.get(worker.peerId) !== worker) {\n\t\t\tthrow new Error(\"Experimental Session worker is no longer available\");\n\t\t}\n\t\tconst attachmentId = randomUUID();\n\t\tworker.attachmentIds.add(attachmentId);\n\t\ttry {\n\t\t\tawait this.#applyDemand(worker, attachmentId, true, true, context);\n\t\t} catch (error) {\n\t\t\tworker.attachmentIds.delete(attachmentId);\n\t\t\tthrow error;\n\t\t}\n\t\tconst scope = this.#operationScope(worker, attachmentId);\n\t\tlet released = false;\n\t\treturn {\n\t\t\tinvokeService: (call, publish, serviceContext) =>\n\t\t\t\tthis.#invokeService(worker, scope, call, publish, serviceContext),\n\t\t\trelease: async (releaseContext) => {\n\t\t\t\tif (released) return;\n\t\t\t\treleased = true;\n\t\t\t\tif (this.#detached || !worker.attachmentIds.has(attachmentId)) return;\n\t\t\t\ttry {\n\t\t\t\t\tawait this.#applyDemand(worker, attachmentId, false, true, releaseContext);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!this.#detached && !this.#coordinator.wasReplaced) throw error;\n\t\t\t\t} finally {\n\t\t\t\t\tworker.attachmentIds.delete(attachmentId);\n\t\t\t\t\tthis.#removeServiceSubscriptions((entry) => entry.worker === worker && sameScope(entry.scope, scope));\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\t}\n\n\tasync #invokeService(\n\t\tworker: WorkerRecord,\n\t\tscope: WorkerOperationScope,\n\t\tcall: ServiceCall,\n\t\tpublish: (subscriptionId: string, update: ServiceProviderUpdate, context: Context) => void | Promise<void>,\n\t\tcontext: Context,\n\t): Promise<JsonValue | undefined> {\n\t\tconst control = decodeServiceControlCall(call);\n\t\tlet addedSubscriptionKey: string | undefined;\n\t\tif (control?.type === \"subscribe\") {\n\t\t\tconst key = scopedServiceSubscriptionKey(scope, control.subscriptionId);\n\t\t\tif (this.#serviceSubscriptions.has(key)) throw new Error(\"Service subscription ID is already active\");\n\t\t\tthis.#serviceSubscriptions.set(key, {\n\t\t\t\tworker,\n\t\t\t\tscope,\n\t\t\t\tlistener: (update, updateContext) => publish(control.subscriptionId, update, updateContext),\n\t\t\t\tdeliveryTail: Promise.resolve(),\n\t\t\t});\n\t\t\taddedSubscriptionKey = key;\n\t\t}\n\t\tlet response: JsonValue | undefined;\n\t\ttry {\n\t\t\tresponse = await this.#invoke(worker, scope, call, context);\n\t\t} catch (error) {\n\t\t\tif (addedSubscriptionKey !== undefined && control?.type === \"subscribe\") {\n\t\t\t\tthis.#serviceSubscriptions.delete(addedSubscriptionKey);\n\t\t\t\tvoid this.#invoke(\n\t\t\t\t\tworker,\n\t\t\t\t\tscope,\n\t\t\t\t\tcreateServiceUnsubscribeCall(control.subscriptionId),\n\t\t\t\t\tBACKGROUND_CONTEXT,\n\t\t\t\t).catch(() => {});\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t\tif (control?.type === \"unsubscribe\") {\n\t\t\tthis.#serviceSubscriptions.delete(scopedServiceSubscriptionKey(scope, control.subscriptionId));\n\t\t}\n\t\treturn response;\n\t}\n\n\tasync #applyDemand(\n\t\tworker: WorkerRecord,\n\t\tattachmentId: string,\n\t\tattached: boolean,\n\t\tcompensateOnTimeout: boolean,\n\t\t_context: Context,\n\t): Promise<void> {\n\t\tif (worker.stopping || this.#workersByPeer.get(worker.peerId) !== worker) {\n\t\t\tthrow new Error(\"Experimental Session worker is stopping\");\n\t\t}\n\t\tconst requestId = randomUUID();\n\t\tlet resolve!: () => void;\n\t\tlet reject!: (error: Error) => void;\n\t\tconst applied = new Promise<void>((resolvePromise, rejectPromise) => {\n\t\t\tresolve = resolvePromise;\n\t\t\treject = rejectPromise;\n\t\t});\n\t\tconst timer = setTimeout(() => {\n\t\t\tif (compensateOnTimeout) void this.#reconcileDemandTimeout(requestId);\n\t\t\telse this.#rejectDemand(requestId, new Error(\"Session worker demand update timed out\"));\n\t\t}, WORKER_DEMAND_TIMEOUT_MS);\n\t\ttimer.unref();\n\t\tconst pending = { attachmentId, attached, requestId, timer, worker, resolve, reject };\n\t\tthis.#pendingDemand.set(requestId, pending);\n\t\ttry {\n\t\t\tawait this.#coordinator.send(worker.peerId, {\n\t\t\t\ttype: \"session_demand\",\n\t\t\t\tserverConnectionId: this.#coordinator.serverConnectionId,\n\t\t\t\trequestId,\n\t\t\t\tattachmentId,\n\t\t\t\tattached,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tthis.#rejectDemand(requestId, error instanceof Error ? error : new Error(String(error)));\n\t\t}\n\t\treturn applied;\n\t}\n\n\t/** Worker operations have no wall-clock timeout: completion, disconnect, replacement, or shutdown settles them. */\n\t#invoke(\n\t\tworker: WorkerRecord,\n\t\tscope: WorkerOperationScope,\n\t\tcall: ServiceCall,\n\t\tcontext: Context,\n\t): Promise<JsonValue | undefined> {\n\t\ttry {\n\t\t\tthis.#operationScope(worker, scope.attachmentId);\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t\tif (context.abortSignal?.aborted) return Promise.reject(abortError(context.abortSignal));\n\t\tconst requestId = randomUUID();\n\t\tlet resolve!: (result: JsonValue | undefined) => void;\n\t\tlet reject!: (error: Error) => void;\n\t\tconst result = new Promise<JsonValue | undefined>((resolvePromise, rejectPromise) => {\n\t\t\tresolve = resolvePromise;\n\t\t\treject = rejectPromise;\n\t\t});\n\t\tconst signal = context.abortSignal;\n\t\tconst onAbort = (): void => {\n\t\t\tif (signal === undefined || !this.#pendingOperations.has(requestId)) return;\n\t\t\tvoid this.#coordinator.send(worker.peerId, { type: \"operation_cancel\", requestId, scope }).catch(() => {});\n\t\t\tthis.#rejectOperation(requestId, abortError(signal));\n\t\t};\n\t\tif (signal !== undefined) signal.addEventListener(\"abort\", onAbort, { once: true });\n\t\tthis.#pendingOperations.set(requestId, {\n\t\t\tworker,\n\t\t\tscope,\n\t\t\tcleanup: () => signal?.removeEventListener(\"abort\", onAbort),\n\t\t\tresolve,\n\t\t\treject,\n\t\t});\n\t\tvoid this.#coordinator\n\t\t\t.send(worker.peerId, { type: \"operation\", requestId, scope, call })\n\t\t\t.catch((error: unknown) =>\n\t\t\t\tthis.#rejectOperation(requestId, error instanceof Error ? error : new Error(String(error))),\n\t\t\t);\n\t\treturn result;\n\t}\n\n\t#operationScope(worker: WorkerRecord, attachmentId: string): WorkerOperationScope {\n\t\tif (this.#detached || this.#shuttingDown || worker.stopping) {\n\t\t\tthrow new Error(\"Experimental Session worker is stopping\");\n\t\t}\n\t\tif (this.#workersByPeer.get(worker.peerId) !== worker || !worker.attachmentIds.has(attachmentId)) {\n\t\t\tthrow new Error(\"Experimental Session worker has no active attachment\");\n\t\t}\n\t\treturn {\n\t\t\tserverConnectionId: this.#coordinator.serverConnectionId,\n\t\t\tattachmentId,\n\t\t};\n\t}\n\n\t#stopWorker(worker: WorkerRecord, _context: Context): Promise<void> {\n\t\tif (this.#detached || this.#workersByPeer.get(worker.peerId) !== worker) return Promise.resolve();\n\t\tworker.stopPromise ??= this.#stopWorkerInternal(worker);\n\t\treturn worker.stopPromise;\n\t}\n\n\tasync #stopWorkerInternal(worker: WorkerRecord): Promise<void> {\n\t\tthis.#rejectWorkerOperations(worker, new Error(\"Session worker is stopping\"));\n\t\tworker.stopping = true;\n\t\tworker.expectedStop = true;\n\t\tvoid this.#coordinator.send(worker.peerId, { type: \"shutdown\" }).catch(() => {});\n\t\tlet timer: NodeJS.Timeout | undefined;\n\t\tconst timedOut = new Promise<boolean>((resolve) => {\n\t\t\ttimer = setTimeout(() => resolve(true), WORKER_SHUTDOWN_TIMEOUT_MS);\n\t\t\ttimer.unref();\n\t\t});\n\t\ttry {\n\t\t\tif ((await Promise.race([worker.terminated.then(() => false), timedOut])) === true) {\n\t\t\t\ttry {\n\t\t\t\t\tprocess.kill(worker.pid, \"SIGKILL\");\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!(error instanceof Error && \"code\" in error && error.code === \"ESRCH\")) throw error;\n\t\t\t\t}\n\t\t\t\tthis.#removeWorker(worker, undefined);\n\t\t\t\tawait worker.terminated;\n\t\t\t}\n\t\t} finally {\n\t\t\tif (timer) clearTimeout(timer);\n\t\t}\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tif (this.#detached || this.#shuttingDown) return;\n\t\tthis.#shuttingDown = true;\n\t\tconst pendingWorkers = [...this.#pending.values()];\n\t\tfor (const pending of pendingWorkers) {\n\t\t\tvoid this.#coordinator.send(pending.peerId, { type: \"shutdown\" }).catch(() => {});\n\t\t}\n\t\tconst pendingFinished = Promise.all(\n\t\t\tpendingWorkers.map((pending) => {\n\t\t\t\tif (pending.child.exitCode !== null || pending.child.signalCode !== null) return Promise.resolve();\n\t\t\t\treturn new Promise<void>((resolve) => pending.child.once(\"exit\", () => resolve()));\n\t\t\t}),\n\t\t).then(() => undefined);\n\t\tlet timer: NodeJS.Timeout | undefined;\n\t\tconst pendingTimedOut = new Promise<boolean>((resolve) => {\n\t\t\ttimer = setTimeout(() => resolve(true), WORKER_SHUTDOWN_TIMEOUT_MS);\n\t\t\ttimer.unref();\n\t\t});\n\t\tconst stopPending = (async () => {\n\t\t\tif ((await Promise.race([pendingFinished.then(() => false), pendingTimedOut])) === true) {\n\t\t\t\tfor (const pending of pendingWorkers) pending.child.kill(\"SIGKILL\");\n\t\t\t\tawait pendingFinished;\n\t\t\t}\n\t\t\tif (timer) clearTimeout(timer);\n\t\t})();\n\t\tawait Promise.all([\n\t\t\tstopPending,\n\t\t\t...[...this.#workersBySession.values()].map((worker) => this.#stopWorker(worker, BACKGROUND_CONTEXT)),\n\t\t]);\n\t\tthis.#detachState();\n\t}\n\n\t/** Forget workers without stopping them when this server is replaced. */\n\tdetach(): void {\n\t\tif (this.#detached) return;\n\t\tthis.#detached = true;\n\t\tfor (const pending of this.#pending.values()) {\n\t\t\tclearTimeout(pending.timer);\n\t\t\tpending.reject(new Error(\"Experimental server was replaced\"));\n\t\t}\n\t\tfor (const requestId of [...this.#pendingOperations.keys()]) {\n\t\t\tthis.#rejectOperation(requestId, new Error(\"Experimental server was replaced during a worker operation\"));\n\t\t}\n\t\tthis.#detachState();\n\t}\n\n\t#launch(\n\t\tmetadata: JsonlSessionMetadata,\n\t\t_context: Context,\n\t\tpluginManifestPaths: readonly string[],\n\t): Promise<WorkerRecord> {\n\t\tconst sessionKey = metadata.path;\n\t\tconst peerId = `worker-${randomUUID()}`;\n\t\tconst token = randomUUID();\n\t\tlet child: ChildProcess;\n\t\ttry {\n\t\t\tconst options: SessionWorkerOptions = {\n\t\t\t\tsessionDir: this.#sessionDir,\n\t\t\t\tmetadata: {\n\t\t\t\t\tid: metadata.id,\n\t\t\t\t\tcreatedAt: metadata.createdAt,\n\t\t\t\t\tstorageVersion: metadata.storageVersion,\n\t\t\t\t\tcwd: metadata.cwd,\n\t\t\t\t\tpath: metadata.path,\n\t\t\t\t\tmodifiedAt: metadata.modifiedAt,\n\t\t\t\t\t...(metadata.parentSessionId === undefined ? {} : { parentSessionId: metadata.parentSessionId }),\n\t\t\t\t},\n\t\t\t\tpluginManifestPaths: [...pluginManifestPaths],\n\t\t\t\t...(this.#model ?? {}),\n\t\t\t};\n\t\t\tchild = spawnInternalProcess(\"session-worker\", [JSON.stringify(options)], {\n\t\t\t\tenv: {\n\t\t\t\t\t[SESSION_WORKER_CONTROL_ADDRESS_ENV]: this.#coordinator.controlPath,\n\t\t\t\t\t[SESSION_WORKER_CONTROL_TOKEN_ENV]: token,\n\t\t\t\t\t[SESSION_WORKER_SESSION_KEY_ENV]: Buffer.from(sessionKey).toString(\"base64url\"),\n\t\t\t\t\t[SESSION_WORKER_PEER_ID_ENV]: peerId,\n\t\t\t\t},\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t\tlet resolve!: (worker: WorkerRecord) => void;\n\t\tlet reject!: (error: Error) => void;\n\t\tconst promise = new Promise<WorkerRecord>((resolvePromise, rejectPromise) => {\n\t\t\tresolve = resolvePromise;\n\t\t\treject = rejectPromise;\n\t\t});\n\t\tconst timer = setTimeout(\n\t\t\t() => this.#failPending(sessionKey, new Error(\"Session worker startup timed out\")),\n\t\t\tWORKER_STARTUP_TIMEOUT_MS,\n\t\t);\n\t\ttimer.unref();\n\t\tconst pending = {\n\t\t\tsessionKey,\n\t\t\tpeerId,\n\t\t\ttoken,\n\t\t\tpluginManifestPaths: Object.freeze([...pluginManifestPaths]),\n\t\t\tchild,\n\t\t\ttimer,\n\t\t\tpromise,\n\t\t\tresolve,\n\t\t\treject,\n\t\t};\n\t\tthis.#pending.set(sessionKey, pending);\n\t\tthis.#notifyWorkerCountChanged();\n\t\tchild.once(\"error\", (error) => this.#failPending(sessionKey, error));\n\t\tchild.once(\"exit\", (code, signal) => this.#childExited(pending, code, signal));\n\t\treturn promise;\n\t}\n\n\t#handleCoordinatorEvent(event: CoordinatorConnectionEvent): void {\n\t\tif (this.#detached) return;\n\t\tif (event.type === \"peer_disconnected\") {\n\t\t\tthis.#markDiscovered(event.peerId);\n\t\t\tconst worker = this.#workersByPeer.get(event.peerId);\n\t\t\tif (worker) {\n\t\t\t\tthis.#removeWorker(\n\t\t\t\t\tworker,\n\t\t\t\t\tworker.expectedStop\n\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t: new Error(`Session worker ${worker.metadata.id} disconnected unexpectedly`),\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst pending = this.#pendingPeer(event.peerId);\n\t\t\tif (pending) this.#failPending(pending.sessionKey, new Error(\"Session worker disconnected during startup\"));\n\t\t\treturn;\n\t\t}\n\t\tif (event.type !== \"message\") return;\n\t\tif (!Check(SessionWorkerEventSchema, event.payload)) {\n\t\t\tif (\n\t\t\t\ttypeof event.payload === \"object\" &&\n\t\t\t\tevent.payload !== null &&\n\t\t\t\t\"type\" in event.payload &&\n\t\t\t\tevent.payload.type === \"operation_response\"\n\t\t\t) {\n\t\t\t\tconst worker = this.#workersByPeer.get(event.from);\n\t\t\t\tif (worker)\n\t\t\t\t\tthis.#rejectWorkerOperations(worker, new Error(\"Session worker returned an invalid operation response\"));\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tconst message: SessionWorkerEvent = event.payload;\n\t\tif (message.type === \"worker_failed\") {\n\t\t\tconst pending = this.#pending.get(message.sessionKey);\n\t\t\tif (pending?.peerId === event.from && pending.token === message.token) {\n\t\t\t\tthis.#failPending(message.sessionKey, new Error(`Session worker failed: ${message.message}`));\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (message.type === \"demand_applied\" || message.type === \"demand_rejected\") {\n\t\t\tconst pending = this.#pendingDemand.get(message.requestId);\n\t\t\tif (\n\t\t\t\t!pending ||\n\t\t\t\tpending.worker.peerId !== event.from ||\n\t\t\t\tpending.worker.token !== message.token ||\n\t\t\t\tpending.worker.metadata.path !== message.sessionKey ||\n\t\t\t\t(message.type === \"demand_applied\" &&\n\t\t\t\t\t(pending.attachmentId !== message.attachmentId || pending.attached !== message.attached))\n\t\t\t) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.#pendingDemand.delete(message.requestId);\n\t\t\tclearTimeout(pending.timer);\n\t\t\tif (message.type === \"demand_applied\") pending.resolve();\n\t\t\telse pending.reject(new Error(`Session worker rejected demand: ${message.message}`));\n\t\t\treturn;\n\t\t}\n\t\tif (message.type === \"operation_response\") {\n\t\t\tthis.#handleOperationResponse(event.from, message.token, message.sessionKey, message.response);\n\t\t\treturn;\n\t\t}\n\t\tif (message.type === \"service_update\") {\n\t\t\tthis.#handleServiceEvent(\n\t\t\t\tevent.from,\n\t\t\t\tmessage.token,\n\t\t\t\tmessage.sessionKey,\n\t\t\t\tmessage.scope,\n\t\t\t\tmessage.subscriptionId,\n\t\t\t\tmessage.update,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tthis.#recordReadyWorker(event.from, message);\n\t}\n\n\t#handleOperationResponse(\n\t\tpeerId: string,\n\t\ttoken: string,\n\t\tsessionKey: string,\n\t\tresponse: WorkerOperationResponse,\n\t): void {\n\t\tconst pending = this.#pendingOperations.get(response.requestId);\n\t\tif (!pending) return;\n\t\tif (\n\t\t\tpending.worker.peerId !== peerId ||\n\t\t\tpending.worker.token !== token ||\n\t\t\tpending.worker.metadata.path !== sessionKey ||\n\t\t\tresponse.scope.serverConnectionId !== pending.scope.serverConnectionId ||\n\t\t\tresponse.scope.attachmentId !== pending.scope.attachmentId\n\t\t) {\n\t\t\tthis.#rejectOperation(\n\t\t\t\tresponse.requestId,\n\t\t\t\tnew Error(\"Session worker returned a mismatched operation response\"),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tthis.#pendingOperations.delete(response.requestId);\n\t\tpending.cleanup();\n\t\tif (response.type === \"operation_error\") {\n\t\t\tpending.reject(\n\t\t\t\tresponse.code === undefined\n\t\t\t\t\t? new Error(`Session worker operation failed: ${response.message}`)\n\t\t\t\t\t: new ServerError(response.code, response.message),\n\t\t\t);\n\t\t} else {\n\t\t\tpending.resolve(response.result);\n\t\t}\n\t}\n\n\t#handleServiceEvent(\n\t\tpeerId: string,\n\t\ttoken: string,\n\t\tsessionKey: string,\n\t\tscope: WorkerOperationScope,\n\t\tsubscriptionId: string,\n\t\tupdate: unknown,\n\t): void {\n\t\tconst entry = this.#serviceSubscriptions.get(scopedServiceSubscriptionKey(scope, subscriptionId));\n\t\tif (\n\t\t\tentry === undefined ||\n\t\t\tentry.worker.peerId !== peerId ||\n\t\t\tentry.worker.token !== token ||\n\t\t\tentry.worker.metadata.path !== sessionKey ||\n\t\t\t!sameScope(entry.scope, scope)\n\t\t) {\n\t\t\treturn;\n\t\t}\n\t\tlet parsed: ServiceProviderUpdate;\n\t\ttry {\n\t\t\tparsed = parseServiceProviderUpdate(update);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t\tentry.deliveryTail = entry.deliveryTail.then(() => entry.listener(parsed, TODO_CONTEXT)).catch(() => {});\n\t}\n\n\t#recordReadyWorker(peerId: string, message: Extract<SessionWorkerEvent, { type: \"worker_ready\" }>): void {\n\t\tif (\n\t\t\tmessage.sessionKey !== message.metadata.path ||\n\t\t\tmessage.sessionId !== message.metadata.id ||\n\t\t\t!isAbsolute(message.metadata.cwd) ||\n\t\t\t!isAbsolute(message.metadata.path)\n\t\t) {\n\t\t\treturn;\n\t\t}\n\t\tthis.#markDiscovered(peerId);\n\t\tconst pending = this.#pending.get(message.sessionKey);\n\t\tif (pending?.peerId === peerId && !sameStrings(message.pluginManifestPaths, pending.pluginManifestPaths)) {\n\t\t\tthis.#failPending(message.sessionKey, new Error(\"Session worker started with stale plugin packages\"));\n\t\t\treturn;\n\t\t}\n\t\tconst existing = this.#workersBySession.get(message.sessionKey);\n\t\tif (existing && existing.peerId !== peerId) {\n\t\t\tvoid this.#coordinator.send(peerId, { type: \"shutdown\" }).catch(() => {});\n\t\t\treturn;\n\t\t}\n\t\tif (\n\t\t\tpending &&\n\t\t\t(pending.peerId !== peerId || pending.token !== message.token || pending.child.pid !== message.pid)\n\t\t) {\n\t\t\treturn;\n\t\t}\n\t\tif (existing) return;\n\t\tlet resolveTerminated!: (error: Error | undefined) => void;\n\t\tconst terminated = new Promise<Error | undefined>((resolve) => {\n\t\t\tresolveTerminated = resolve;\n\t\t});\n\t\tconst worker: WorkerRecord = {\n\t\t\tpeerId,\n\t\t\tmetadata: message.metadata,\n\t\t\tpid: message.pid,\n\t\t\ttoken: message.token,\n\t\t\tpluginManifestPaths: Object.freeze([...message.pluginManifestPaths]),\n\t\t\tterminated,\n\t\t\tresolveTerminated,\n\t\t\tattachmentIds: new Set(),\n\t\t\texpectedStop: false,\n\t\t\tstopping: false,\n\t\t};\n\t\tthis.#workersBySession.set(message.sessionKey, worker);\n\t\tthis.#workersByPeer.set(peerId, worker);\n\t\tthis.workerPids.set(message.sessionId, message.pid);\n\t\tif (pending) {\n\t\t\tthis.#pending.delete(message.sessionKey);\n\t\t\tclearTimeout(pending.timer);\n\t\t\tpending.resolve(worker);\n\t\t}\n\t\tthis.#notifyWorkerCountChanged();\n\t}\n\n\t#childExited(pending: PendingLaunch, code: number | null, signal: NodeJS.Signals | null): void {\n\t\tif (this.#pending.get(pending.sessionKey) === pending) {\n\t\t\tthis.#failPending(\n\t\t\t\tpending.sessionKey,\n\t\t\t\tnew Error(`Session worker exited before readiness (${signal ?? code ?? \"unknown\"})`),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tconst worker = this.#workersByPeer.get(pending.peerId);\n\t\tif (worker) {\n\t\t\tthis.#removeWorker(\n\t\t\t\tworker,\n\t\t\t\tworker.expectedStop\n\t\t\t\t\t? undefined\n\t\t\t\t\t: new Error(`Session worker ${worker.metadata.id} exited unexpectedly (${signal ?? code ?? \"unknown\"})`),\n\t\t\t);\n\t\t}\n\t}\n\n\t#failPending(sessionKey: string, error: Error): void {\n\t\tconst pending = this.#pending.get(sessionKey);\n\t\tif (!pending) return;\n\t\tthis.#pending.delete(sessionKey);\n\t\tclearTimeout(pending.timer);\n\t\tthis.#notifyWorkerCountChanged();\n\t\tif (pending.child.exitCode === null && pending.child.signalCode === null) pending.child.kill(\"SIGKILL\");\n\t\tpending.reject(error);\n\t}\n\n\t#rejectDemand(requestId: string, error: Error): void {\n\t\tconst pending = this.#pendingDemand.get(requestId);\n\t\tif (!pending) return;\n\t\tthis.#pendingDemand.delete(requestId);\n\t\tclearTimeout(pending.timer);\n\t\tpending.reject(error);\n\t}\n\n\t#rejectOperation(requestId: string, error: Error): void {\n\t\tconst pending = this.#pendingOperations.get(requestId);\n\t\tif (!pending) return;\n\t\tthis.#pendingOperations.delete(requestId);\n\t\tpending.cleanup();\n\t\tpending.reject(error);\n\t}\n\n\t#rejectWorkerOperations(worker: WorkerRecord, error: Error): void {\n\t\tfor (const [requestId, pending] of this.#pendingOperations) {\n\t\t\tif (pending.worker === worker) this.#rejectOperation(requestId, error);\n\t\t}\n\t}\n\n\tasync #reconcileDemandTimeout(requestId: string): Promise<void> {\n\t\tconst pending = this.#pendingDemand.get(requestId);\n\t\tif (!pending) return;\n\t\tthis.#pendingDemand.delete(requestId);\n\t\tclearTimeout(pending.timer);\n\t\tconst timeoutError = new Error(\"Session worker demand update timed out\");\n\t\ttry {\n\t\t\tawait this.#applyDemand(pending.worker, pending.attachmentId, false, false, BACKGROUND_CONTEXT);\n\t\t\tif (pending.attached) pending.reject(timeoutError);\n\t\t\telse pending.resolve();\n\t\t} catch (cleanupError) {\n\t\t\ttry {\n\t\t\t\tawait this.#stopWorker(pending.worker, BACKGROUND_CONTEXT);\n\t\t\t} catch (stopError) {\n\t\t\t\tpending.reject(\n\t\t\t\t\tnew AggregateError(\n\t\t\t\t\t\t[timeoutError, cleanupError, stopError],\n\t\t\t\t\t\t\"Session worker demand reconciliation and termination failed\",\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tpending.reject(\n\t\t\t\tnew AggregateError(\n\t\t\t\t\t[timeoutError, cleanupError],\n\t\t\t\t\t\"Session worker demand reconciliation failed; worker was terminated\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t}\n\n\t#removeWorker(worker: WorkerRecord, error: Error | undefined): void {\n\t\tif (this.#workersByPeer.get(worker.peerId) !== worker) return;\n\t\tthis.#rejectWorkerOperations(worker, new Error(\"Session worker disconnected during an operation\"));\n\t\tthis.#removeServiceSubscriptions((entry) => entry.worker === worker);\n\t\tfor (const pending of [...this.#pendingDemand.values()]) {\n\t\t\tif (pending.worker === worker) {\n\t\t\t\tthis.#rejectDemand(pending.requestId, new Error(\"Session worker disconnected during demand update\"));\n\t\t\t}\n\t\t}\n\t\tthis.#workersByPeer.delete(worker.peerId);\n\t\tthis.#workersBySession.delete(worker.metadata.path);\n\t\tif (this.workerPids.get(worker.metadata.id) === worker.pid) this.workerPids.delete(worker.metadata.id);\n\t\tworker.resolveTerminated(error);\n\t\tthis.#notifyWorkerCountChanged();\n\t}\n\n\t#removeServiceSubscriptions(matches: (entry: WorkerServiceSubscription) => boolean): void {\n\t\tfor (const [key, entry] of this.#serviceSubscriptions) {\n\t\t\tif (matches(entry)) this.#serviceSubscriptions.delete(key);\n\t\t}\n\t}\n\n\t#notifyWorkerCountChanged(): void {\n\t\tthis.#onWorkerCountChanged?.(this.#workersBySession.size + this.#pending.size);\n\t}\n\n\t#pendingPeer(peerId: string): PendingLaunch | undefined {\n\t\treturn [...this.#pending.values()].find((pending) => pending.peerId === peerId);\n\t}\n\n\t#markDiscovered(peerId: string): void {\n\t\tif (!this.#discoveryPeers?.delete(peerId) || this.#discoveryPeers.size !== 0) return;\n\t\tthis.#resolveDiscovery?.();\n\t}\n\n\t#detachState(): void {\n\t\tthis.#removeListener();\n\t\tfor (const requestId of [...this.#pendingOperations.keys()]) {\n\t\t\tthis.#rejectOperation(requestId, new Error(\"Experimental server detached during a worker operation\"));\n\t\t}\n\t\tfor (const pending of [...this.#pendingDemand.values()]) {\n\t\t\tthis.#pendingDemand.delete(pending.requestId);\n\t\t\tclearTimeout(pending.timer);\n\t\t\tpending.resolve();\n\t\t}\n\t\tthis.#pending.clear();\n\t\tthis.#serviceSubscriptions.clear();\n\t\tthis.#workersByPeer.clear();\n\t\tthis.#workersBySession.clear();\n\t\tthis.workerPids.clear();\n\t\tthis.#discoveryPeers = undefined;\n\t\tthis.#resolveDiscovery?.();\n\t\tthis.#resolveDiscovery = undefined;\n\t}\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n\treturn left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction sameScope(left: WorkerOperationScope, right: WorkerOperationScope): boolean {\n\treturn left.serverConnectionId === right.serverConnectionId && left.attachmentId === right.attachmentId;\n}\n\nfunction scopedServiceSubscriptionKey(scope: WorkerOperationScope, subscriptionId: string): string {\n\treturn `${scope.serverConnectionId}\\0${scope.attachmentId}\\0${subscriptionId}`;\n}\n\nfunction abortError(signal: AbortSignal): Error {\n\tconst reason: unknown = signal.reason;\n\treturn reason instanceof Error ? reason : new DOMException(\"The operation was aborted\", \"AbortError\");\n}\n"]}