@code-yeongyu/senpi 2026.6.21 → 2026.6.28-4

package/dist/core/extensions/builtin/pi-codex-app-server/session-registry.js

@@ -0,0 +1,89 @@
+import { createAdapterJsonRpcError } from "./error-mapper.js";
+export function createSessionRegistry() {
+    return new InMemorySessionRegistry();
+}
+class InMemorySessionRegistry {
+    constructor() {
+        this.byExternalSessionId = new Map();
+        this.externalSessionIdByAppThreadId = new Map();
+    }
+    bindSession(input) {
+        if (this.byExternalSessionId.has(input.externalSessionId)) {
+            return rejectDuplicate(`Duplicate external session id: ${input.externalSessionId}`);
+        }
+        const existingExternalSessionId = this.externalSessionIdByAppThreadId.get(input.appThreadId);
+        if (existingExternalSessionId && existingExternalSessionId !== input.externalSessionId) {
+            return rejectDuplicate(`Duplicate app-server thread id: ${input.appThreadId}`);
+        }
+        const binding = {
+            externalSessionId: input.externalSessionId,
+            appThreadId: input.appThreadId,
+            appSessionId: input.appSessionId,
+            tombstoned: false,
+            replayCursor: {},
+        };
+        this.byExternalSessionId.set(binding.externalSessionId, binding);
+        this.externalSessionIdByAppThreadId.set(binding.appThreadId, binding.externalSessionId);
+        return { kind: "bound", binding };
+    }
+    getByExternalSessionId(externalSessionId) {
+        return this.byExternalSessionId.get(externalSessionId);
+    }
+    getByAppThreadId(appThreadId) {
+        const externalSessionId = this.externalSessionIdByAppThreadId.get(appThreadId);
+        if (!externalSessionId)
+            return undefined;
+        return this.byExternalSessionId.get(externalSessionId);
+    }
+    requireActiveSession(externalSessionId) {
+        const binding = this.byExternalSessionId.get(externalSessionId);
+        if (!binding) {
+            return rejectSession(`Unknown external session: ${externalSessionId}`);
+        }
+        if (binding.tombstoned) {
+            return rejectSession(`External session is tombstoned: ${externalSessionId}`);
+        }
+        return { kind: "active", binding };
+    }
+    tombstoneExternalSession(externalSessionId) {
+        const lookup = this.requireActiveSession(externalSessionId);
+        if (lookup.kind === "rejected")
+            return lookup;
+        const tombstoned = {
+            ...lookup.binding,
+            tombstoned: true,
+        };
+        this.byExternalSessionId.set(externalSessionId, tombstoned);
+        return { kind: "active", binding: tombstoned };
+    }
+    updateReplayCursor(externalSessionId, replayCursor) {
+        const lookup = this.requireActiveSession(externalSessionId);
+        if (lookup.kind === "rejected")
+            return lookup;
+        const updated = {
+            ...lookup.binding,
+            replayCursor,
+        };
+        this.byExternalSessionId.set(externalSessionId, updated);
+        return { kind: "active", binding: updated };
+    }
+}
+function rejectSession(message) {
+    return {
+        kind: "rejected",
+        error: createAdapterJsonRpcError({
+            adapterCode: "invalid-session-state",
+            message,
+        }),
+    };
+}
+function rejectDuplicate(message) {
+    return {
+        kind: "rejected",
+        error: createAdapterJsonRpcError({
+            adapterCode: "duplicate-routing-id",
+            message,
+        }),
+    };
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/session-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AdapterJsonRpcError, createAdapterJsonRpcError } from \"./error-mapper.ts\";\n\nexport interface SessionBindingInput {\n\treadonly externalSessionId: string;\n\treadonly appThreadId: string;\n\treadonly appSessionId: string;\n}\n\nexport interface ReplayCursor {\n\treadonly lastCompletedTurnId?: string;\n\treadonly lastProjectedItemId?: string;\n\treadonly lastLosslessSequence?: number;\n}\n\nexport interface SessionBinding {\n\treadonly externalSessionId: string;\n\treadonly appThreadId: string;\n\treadonly appSessionId: string;\n\treadonly tombstoned: boolean;\n\treadonly replayCursor: ReplayCursor;\n}\n\nexport type SessionBindResult =\n\t| { readonly kind: \"bound\"; readonly binding: SessionBinding }\n\t| { readonly kind: \"rejected\"; readonly error: AdapterJsonRpcError };\n\nexport type SessionLookupResult =\n\t| { readonly kind: \"active\"; readonly binding: SessionBinding }\n\t| { readonly kind: \"rejected\"; readonly error: AdapterJsonRpcError };\n\nexport interface SessionRegistry {\n\tbindSession(input: SessionBindingInput): SessionBindResult;\n\tgetByExternalSessionId(externalSessionId: string): SessionBinding | undefined;\n\tgetByAppThreadId(appThreadId: string): SessionBinding | undefined;\n\trequireActiveSession(externalSessionId: string): SessionLookupResult;\n\ttombstoneExternalSession(externalSessionId: string): SessionLookupResult;\n\tupdateReplayCursor(externalSessionId: string, replayCursor: ReplayCursor): SessionLookupResult;\n}\n\nexport function createSessionRegistry(): SessionRegistry {\n\treturn new InMemorySessionRegistry();\n}\n\nclass InMemorySessionRegistry implements SessionRegistry {\n\tprivate readonly byExternalSessionId = new Map<string, SessionBinding>();\n\tprivate readonly externalSessionIdByAppThreadId = new Map<string, string>();\n\n\tbindSession(input: SessionBindingInput): SessionBindResult {\n\t\tif (this.byExternalSessionId.has(input.externalSessionId)) {\n\t\t\treturn rejectDuplicate(`Duplicate external session id: ${input.externalSessionId}`);\n\t\t}\n\t\tconst existingExternalSessionId = this.externalSessionIdByAppThreadId.get(input.appThreadId);\n\t\tif (existingExternalSessionId && existingExternalSessionId !== input.externalSessionId) {\n\t\t\treturn rejectDuplicate(`Duplicate app-server thread id: ${input.appThreadId}`);\n\t\t}\n\t\tconst binding: SessionBinding = {\n\t\t\texternalSessionId: input.externalSessionId,\n\t\t\tappThreadId: input.appThreadId,\n\t\t\tappSessionId: input.appSessionId,\n\t\t\ttombstoned: false,\n\t\t\treplayCursor: {},\n\t\t};\n\t\tthis.byExternalSessionId.set(binding.externalSessionId, binding);\n\t\tthis.externalSessionIdByAppThreadId.set(binding.appThreadId, binding.externalSessionId);\n\t\treturn { kind: \"bound\", binding };\n\t}\n\n\tgetByExternalSessionId(externalSessionId: string): SessionBinding | undefined {\n\t\treturn this.byExternalSessionId.get(externalSessionId);\n\t}\n\n\tgetByAppThreadId(appThreadId: string): SessionBinding | undefined {\n\t\tconst externalSessionId = this.externalSessionIdByAppThreadId.get(appThreadId);\n\t\tif (!externalSessionId) return undefined;\n\t\treturn this.byExternalSessionId.get(externalSessionId);\n\t}\n\n\trequireActiveSession(externalSessionId: string): SessionLookupResult {\n\t\tconst binding = this.byExternalSessionId.get(externalSessionId);\n\t\tif (!binding) {\n\t\t\treturn rejectSession(`Unknown external session: ${externalSessionId}`);\n\t\t}\n\t\tif (binding.tombstoned) {\n\t\t\treturn rejectSession(`External session is tombstoned: ${externalSessionId}`);\n\t\t}\n\t\treturn { kind: \"active\", binding };\n\t}\n\n\ttombstoneExternalSession(externalSessionId: string): SessionLookupResult {\n\t\tconst lookup = this.requireActiveSession(externalSessionId);\n\t\tif (lookup.kind === \"rejected\") return lookup;\n\t\tconst tombstoned: SessionBinding = {\n\t\t\t...lookup.binding,\n\t\t\ttombstoned: true,\n\t\t};\n\t\tthis.byExternalSessionId.set(externalSessionId, tombstoned);\n\t\treturn { kind: \"active\", binding: tombstoned };\n\t}\n\n\tupdateReplayCursor(externalSessionId: string, replayCursor: ReplayCursor): SessionLookupResult {\n\t\tconst lookup = this.requireActiveSession(externalSessionId);\n\t\tif (lookup.kind === \"rejected\") return lookup;\n\t\tconst updated: SessionBinding = {\n\t\t\t...lookup.binding,\n\t\t\treplayCursor,\n\t\t};\n\t\tthis.byExternalSessionId.set(externalSessionId, updated);\n\t\treturn { kind: \"active\", binding: updated };\n\t}\n}\n\nfunction rejectSession(message: string): SessionLookupResult {\n\treturn {\n\t\tkind: \"rejected\",\n\t\terror: createAdapterJsonRpcError({\n\t\t\tadapterCode: \"invalid-session-state\",\n\t\t\tmessage,\n\t\t}),\n\t};\n}\n\nfunction rejectDuplicate(message: string): SessionBindResult {\n\treturn {\n\t\tkind: \"rejected\",\n\t\terror: createAdapterJsonRpcError({\n\t\t\tadapterCode: \"duplicate-routing-id\",\n\t\t\tmessage,\n\t\t}),\n\t};\n}\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/stream-backpressure.d.ts

@@ -0,0 +1,36 @@
+import type { AppServerJsonRpcError } from "./error-mapper.ts";
+import type { NotificationProjection } from "./notification-projector.ts";
+export type StreamBackpressureEvent = Exclude<NotificationProjection, {
+    readonly kind: "skipped";
+}>;
+export interface LagStreamEvent {
+    readonly kind: "lag";
+    readonly method: "lag";
+    readonly connectionId: string;
+    readonly sequence: number;
+    readonly streamClass: "control";
+    readonly droppedProgressEvents: number;
+    readonly nextLosslessSequence: number;
+}
+export type StreamBackpressureOutput = StreamBackpressureEvent | LagStreamEvent;
+export interface StreamBackpressureOptions {
+    readonly connectionId: string;
+    readonly bestEffortQueueLimit: number;
+}
+export interface StreamBackpressureStats {
+    readonly droppedProgressEvents: number;
+    readonly emittedLagMarkers: number;
+    readonly queuedEvents: number;
+}
+export interface AppServerOverloadOptions {
+    readonly retryAfterMs?: number;
+}
+export interface StreamBackpressureController {
+    enqueue(event: StreamBackpressureEvent): void;
+    drainAll(): readonly StreamBackpressureOutput[];
+    flushTerminal(): readonly StreamBackpressureOutput[];
+    stats(): StreamBackpressureStats;
+}
+export declare function createStreamBackpressureController(options: StreamBackpressureOptions): StreamBackpressureController;
+export declare function createAppServerOverloadError(options?: AppServerOverloadOptions): AppServerJsonRpcError;
+//# sourceMappingURL=stream-backpressure.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/stream-backpressure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-backpressure.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/stream-backpressure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAEpG,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAAG,cAAc,CAAC;AAEhF,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC5C,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9C,QAAQ,IAAI,SAAS,wBAAwB,EAAE,CAAC;IAChD,aAAa,IAAI,SAAS,wBAAwB,EAAE,CAAC;IACrD,KAAK,IAAI,uBAAuB,CAAC;CACjC;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,yBAAyB,GAAG,4BAA4B,CAEnH;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,wBAA6B,GAAG,qBAAqB,CAS1G"}

package/dist/core/extensions/builtin/pi-codex-app-server/stream-backpressure.js

@@ -0,0 +1,94 @@
+export function createStreamBackpressureController(options) {
+    return new DefaultStreamBackpressureController(options);
+}
+export function createAppServerOverloadError(options = {}) {
+    return {
+        code: -32001,
+        message: "app-server overloaded",
+        data: {
+            retryable: true,
+            ...(options.retryAfterMs === undefined ? {} : { retryAfterMs: options.retryAfterMs }),
+        },
+    };
+}
+class DefaultStreamBackpressureController {
+    constructor(options) {
+        this.queue = [];
+        this.droppedProgressEvents = 0;
+        this.emittedLagMarkers = 0;
+        this.pendingDroppedProgressEvents = 0;
+        this.connectionId = options.connectionId;
+        this.bestEffortQueueLimit = Math.max(0, options.bestEffortQueueLimit);
+    }
+    enqueue(event) {
+        if (readStreamClass(event) === "best-effort") {
+            this.enqueueBestEffort(event);
+            return;
+        }
+        this.enqueueLossless(event);
+    }
+    drainAll() {
+        return this.drainQueuedEvents();
+    }
+    flushTerminal() {
+        return this.drainQueuedEvents();
+    }
+    stats() {
+        return {
+            droppedProgressEvents: this.droppedProgressEvents,
+            emittedLagMarkers: this.emittedLagMarkers,
+            queuedEvents: this.queue.length,
+        };
+    }
+    enqueueBestEffort(event) {
+        if (this.countQueuedBestEffortEvents() >= this.bestEffortQueueLimit) {
+            this.droppedProgressEvents += 1;
+            this.pendingDroppedProgressEvents += 1;
+            this.pendingLagSequence = readSequence(event);
+            return;
+        }
+        this.queue.push(event);
+    }
+    enqueueLossless(event) {
+        if (this.pendingDroppedProgressEvents > 0) {
+            const nextLosslessSequence = readSequence(event);
+            this.queue.push(this.createLagEvent(this.pendingLagSequence ?? nextLosslessSequence - 1, nextLosslessSequence));
+            this.pendingDroppedProgressEvents = 0;
+            this.pendingLagSequence = undefined;
+            this.emittedLagMarkers += 1;
+        }
+        this.queue.push(event);
+    }
+    countQueuedBestEffortEvents() {
+        return this.queue.filter((event) => readStreamClass(event) === "best-effort").length;
+    }
+    createLagEvent(sequence, nextLosslessSequence) {
+        return {
+            kind: "lag",
+            method: "lag",
+            connectionId: this.connectionId,
+            sequence,
+            streamClass: "control",
+            droppedProgressEvents: this.pendingDroppedProgressEvents,
+            nextLosslessSequence,
+        };
+    }
+    drainQueuedEvents() {
+        const drained = [...this.queue];
+        this.queue.length = 0;
+        return drained;
+    }
+}
+function readStreamClass(event) {
+    if (event.kind === "lag")
+        return event.streamClass;
+    if (event.kind === "semantic")
+        return event.streamClass;
+    return event.envelope.streamClass;
+}
+function readSequence(event) {
+    if (event.kind === "semantic")
+        return event.sequence;
+    return event.envelope.sequence;
+}
+//# sourceMappingURL=stream-backpressure.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/stream-backpressure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-backpressure.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/stream-backpressure.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AppServerJsonRpcError } from \"./error-mapper.ts\";\nimport type { NotificationProjection } from \"./notification-projector.ts\";\n\nexport type StreamBackpressureEvent = Exclude<NotificationProjection, { readonly kind: \"skipped\" }>;\n\nexport interface LagStreamEvent {\n\treadonly kind: \"lag\";\n\treadonly method: \"lag\";\n\treadonly connectionId: string;\n\treadonly sequence: number;\n\treadonly streamClass: \"control\";\n\treadonly droppedProgressEvents: number;\n\treadonly nextLosslessSequence: number;\n}\n\nexport type StreamBackpressureOutput = StreamBackpressureEvent | LagStreamEvent;\n\nexport interface StreamBackpressureOptions {\n\treadonly connectionId: string;\n\treadonly bestEffortQueueLimit: number;\n}\n\nexport interface StreamBackpressureStats {\n\treadonly droppedProgressEvents: number;\n\treadonly emittedLagMarkers: number;\n\treadonly queuedEvents: number;\n}\n\nexport interface AppServerOverloadOptions {\n\treadonly retryAfterMs?: number;\n}\n\nexport interface StreamBackpressureController {\n\tenqueue(event: StreamBackpressureEvent): void;\n\tdrainAll(): readonly StreamBackpressureOutput[];\n\tflushTerminal(): readonly StreamBackpressureOutput[];\n\tstats(): StreamBackpressureStats;\n}\n\nexport function createStreamBackpressureController(options: StreamBackpressureOptions): StreamBackpressureController {\n\treturn new DefaultStreamBackpressureController(options);\n}\n\nexport function createAppServerOverloadError(options: AppServerOverloadOptions = {}): AppServerJsonRpcError {\n\treturn {\n\t\tcode: -32001,\n\t\tmessage: \"app-server overloaded\",\n\t\tdata: {\n\t\t\tretryable: true,\n\t\t\t...(options.retryAfterMs === undefined ? {} : { retryAfterMs: options.retryAfterMs }),\n\t\t},\n\t};\n}\n\nclass DefaultStreamBackpressureController implements StreamBackpressureController {\n\tprivate readonly connectionId: string;\n\tprivate readonly bestEffortQueueLimit: number;\n\tprivate readonly queue: StreamBackpressureOutput[] = [];\n\tprivate droppedProgressEvents = 0;\n\tprivate emittedLagMarkers = 0;\n\tprivate pendingDroppedProgressEvents = 0;\n\tprivate pendingLagSequence: number | undefined;\n\n\tconstructor(options: StreamBackpressureOptions) {\n\t\tthis.connectionId = options.connectionId;\n\t\tthis.bestEffortQueueLimit = Math.max(0, options.bestEffortQueueLimit);\n\t}\n\n\tenqueue(event: StreamBackpressureEvent): void {\n\t\tif (readStreamClass(event) === \"best-effort\") {\n\t\t\tthis.enqueueBestEffort(event);\n\t\t\treturn;\n\t\t}\n\n\t\tthis.enqueueLossless(event);\n\t}\n\n\tdrainAll(): readonly StreamBackpressureOutput[] {\n\t\treturn this.drainQueuedEvents();\n\t}\n\n\tflushTerminal(): readonly StreamBackpressureOutput[] {\n\t\treturn this.drainQueuedEvents();\n\t}\n\n\tstats(): StreamBackpressureStats {\n\t\treturn {\n\t\t\tdroppedProgressEvents: this.droppedProgressEvents,\n\t\t\temittedLagMarkers: this.emittedLagMarkers,\n\t\t\tqueuedEvents: this.queue.length,\n\t\t};\n\t}\n\n\tprivate enqueueBestEffort(event: StreamBackpressureEvent): void {\n\t\tif (this.countQueuedBestEffortEvents() >= this.bestEffortQueueLimit) {\n\t\t\tthis.droppedProgressEvents += 1;\n\t\t\tthis.pendingDroppedProgressEvents += 1;\n\t\t\tthis.pendingLagSequence = readSequence(event);\n\t\t\treturn;\n\t\t}\n\t\tthis.queue.push(event);\n\t}\n\n\tprivate enqueueLossless(event: StreamBackpressureEvent): void {\n\t\tif (this.pendingDroppedProgressEvents > 0) {\n\t\t\tconst nextLosslessSequence = readSequence(event);\n\t\t\tthis.queue.push(\n\t\t\t\tthis.createLagEvent(this.pendingLagSequence ?? nextLosslessSequence - 1, nextLosslessSequence),\n\t\t\t);\n\t\t\tthis.pendingDroppedProgressEvents = 0;\n\t\t\tthis.pendingLagSequence = undefined;\n\t\t\tthis.emittedLagMarkers += 1;\n\t\t}\n\t\tthis.queue.push(event);\n\t}\n\n\tprivate countQueuedBestEffortEvents(): number {\n\t\treturn this.queue.filter((event) => readStreamClass(event) === \"best-effort\").length;\n\t}\n\n\tprivate createLagEvent(sequence: number, nextLosslessSequence: number): LagStreamEvent {\n\t\treturn {\n\t\t\tkind: \"lag\",\n\t\t\tmethod: \"lag\",\n\t\t\tconnectionId: this.connectionId,\n\t\t\tsequence,\n\t\t\tstreamClass: \"control\",\n\t\t\tdroppedProgressEvents: this.pendingDroppedProgressEvents,\n\t\t\tnextLosslessSequence,\n\t\t};\n\t}\n\n\tprivate drainQueuedEvents(): readonly StreamBackpressureOutput[] {\n\t\tconst drained = [...this.queue];\n\t\tthis.queue.length = 0;\n\t\treturn drained;\n\t}\n}\n\nfunction readStreamClass(\n\tevent: StreamBackpressureOutput,\n): \"lossless\" | \"best-effort\" | \"snapshot-authoritative\" | \"control\" {\n\tif (event.kind === \"lag\") return event.streamClass;\n\tif (event.kind === \"semantic\") return event.streamClass;\n\treturn event.envelope.streamClass;\n}\n\nfunction readSequence(event: StreamBackpressureEvent): number {\n\tif (event.kind === \"semantic\") return event.sequence;\n\treturn event.envelope.sequence;\n}\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/transport-runtime.d.ts

@@ -0,0 +1,34 @@
+import { type PiCodexAppServerWebSocketDependencies } from "./websocket-transport.ts";
+export type { PiCodexAppServerWebSocketLike } from "./websocket-transport.ts";
+export type PiCodexAppServerTransportMode = "stdio" | "websocket" | "unix";
+export interface PiCodexAppServerRuntimeFlags {
+    readonly enabled: boolean;
+    readonly mode: PiCodexAppServerTransportMode;
+    readonly appServerCommand: string;
+    readonly appServerArgs: readonly string[];
+    readonly appServerUrl: string;
+    readonly appServerSocketPath?: string;
+    readonly connectTimeoutMs: number;
+}
+export type PiCodexAppServerRuntimeStatus = {
+    readonly kind: "stopped";
+} | {
+    readonly kind: "starting";
+    readonly mode: PiCodexAppServerTransportMode;
+} | {
+    readonly kind: "running";
+    readonly mode: PiCodexAppServerTransportMode;
+} | {
+    readonly kind: "failed";
+    readonly mode: PiCodexAppServerTransportMode;
+    readonly message: string;
+};
+export interface PiCodexAppServerRuntimeController {
+    start(flags: PiCodexAppServerRuntimeFlags): Promise<PiCodexAppServerRuntimeStatus>;
+    stop(): Promise<PiCodexAppServerRuntimeStatus>;
+    getStatus(): PiCodexAppServerRuntimeStatus;
+}
+export type PiCodexAppServerRuntime = PiCodexAppServerRuntimeController;
+export type PiCodexAppServerRuntimeDependencies = PiCodexAppServerWebSocketDependencies;
+export declare function createPiCodexAppServerRuntime(dependencies?: PiCodexAppServerRuntimeDependencies): PiCodexAppServerRuntime;
+//# sourceMappingURL=transport-runtime.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/transport-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-runtime.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/transport-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,qCAAqC,EAAE,MAAM,0BAA0B,CAAC;AAE/G,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3E,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,6BAA6B,GACtC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG,MAAM,WAAW,iCAAiC;IACjD,KAAK,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACnF,IAAI,IAAI,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC/C,SAAS,IAAI,6BAA6B,CAAC;CAC3C;AAED,MAAM,MAAM,uBAAuB,GAAG,iCAAiC,CAAC;AAExE,MAAM,MAAM,mCAAmC,GAAG,qCAAqC,CAAC;AAexF,wBAAgB,6BAA6B,CAC5C,YAAY,GAAE,mCAAwC,GACpD,uBAAuB,CAEzB"}

package/dist/core/extensions/builtin/pi-codex-app-server/transport-runtime.js

@@ -0,0 +1,179 @@
+import { spawn } from "node:child_process";
+import { PiCodexAppServerRuntimeError } from "./runtime-errors.js";
+import { openWebSocketConnection } from "./websocket-transport.js";
+export function createPiCodexAppServerRuntime(dependencies = {}) {
+    return new DefaultPiCodexAppServerRuntime(dependencies);
+}
+class DefaultPiCodexAppServerRuntime {
+    constructor(dependencies) {
+        this.status = { kind: "stopped" };
+        this.dependencies = dependencies;
+    }
+    async start(flags) {
+        await this.stop();
+        if (!flags.enabled) {
+            this.status = { kind: "stopped" };
+            return this.status;
+        }
+        this.status = { kind: "starting", mode: flags.mode };
+        try {
+            const connection = await openConnection(flags, this.dependencies);
+            connection.onFailure((message) => {
+                if (this.connection !== connection)
+                    return;
+                this.connection = undefined;
+                this.status = { kind: "failed", mode: connection.mode, message };
+            });
+            this.connection = connection;
+            this.status = { kind: "running", mode: flags.mode };
+            return this.status;
+        }
+        catch (error) {
+            this.connection = undefined;
+            this.status = { kind: "failed", mode: flags.mode, message: formatError(error) };
+            return this.status;
+        }
+    }
+    async stop() {
+        const activeConnection = this.connection;
+        this.connection = undefined;
+        if (activeConnection) {
+            await activeConnection.close();
+        }
+        this.status = { kind: "stopped" };
+        return this.status;
+    }
+    getStatus() {
+        return this.status;
+    }
+}
+async function openConnection(flags, dependencies) {
+    switch (flags.mode) {
+        case "stdio":
+            return openChildProcessConnection({
+                mode: flags.mode,
+                command: flags.appServerCommand,
+                args: flags.appServerArgs,
+                connectTimeoutMs: flags.connectTimeoutMs,
+            });
+        case "unix":
+            return openChildProcessConnection({
+                mode: flags.mode,
+                command: flags.appServerCommand,
+                args: resolveUnixProxyArgs(flags),
+                connectTimeoutMs: flags.connectTimeoutMs,
+            });
+        case "websocket": {
+            const webSocketConnection = await openWebSocketConnection(flags.appServerUrl, flags.connectTimeoutMs, dependencies);
+            return {
+                mode: "websocket",
+                close: () => webSocketConnection.close(),
+                onFailure: (handler) => webSocketConnection.onUnexpectedClose(handler),
+            };
+        }
+    }
+}
+function resolveUnixProxyArgs(flags) {
+    if (flags.appServerArgs.length > 0 && flags.appServerArgs.join(" ") !== "app-server") {
+        return flags.appServerArgs;
+    }
+    const socketPath = flags.appServerSocketPath;
+    if (!socketPath) {
+        throw new PiCodexAppServerRuntimeError("unix", "Unix transport requires an app-server socket path.");
+    }
+    return ["app-server", "proxy", "--sock", socketPath];
+}
+async function openChildProcessConnection(options) {
+    if (options.command.trim().length === 0) {
+        throw new PiCodexAppServerRuntimeError(options.mode, "App-server command is required.");
+    }
+    const child = spawn(options.command, [...options.args], { stdio: "pipe" });
+    const connection = new ChildProcessRuntimeConnection(child, options.mode);
+    await waitForChildSpawn(child, options.mode, options.connectTimeoutMs);
+    return connection;
+}
+class ChildProcessRuntimeConnection {
+    constructor(child, mode) {
+        this.closing = false;
+        this.child = child;
+        this.mode = mode;
+        child.once("exit", (code, signal) => {
+            if (this.closing)
+                return;
+            this.recordFailure(formatChildExit(mode, code, signal));
+        });
+        child.once("error", (error) => {
+            if (this.closing)
+                return;
+            this.recordFailure(error.message);
+        });
+    }
+    async close() {
+        this.closing = true;
+        await stopChild(this.child);
+    }
+    onFailure(handler) {
+        this.failureHandler = handler;
+        if (this.failureMessage) {
+            const message = this.failureMessage;
+            queueMicrotask(() => handler(message));
+        }
+    }
+    recordFailure(message) {
+        this.failureMessage = message;
+        this.failureHandler?.(message);
+    }
+}
+function waitForChildSpawn(child, mode, connectTimeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            cleanup();
+            child.kill("SIGTERM");
+            reject(new PiCodexAppServerRuntimeError(mode, `App-server process did not spawn within ${connectTimeoutMs}ms.`));
+        }, connectTimeoutMs);
+        const cleanup = () => {
+            clearTimeout(timeout);
+            child.off("spawn", onSpawn);
+            child.off("error", onError);
+        };
+        const onSpawn = () => {
+            cleanup();
+            resolve();
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        child.once("spawn", onSpawn);
+        child.once("error", onError);
+    });
+}
+function stopChild(child) {
+    return new Promise((resolve) => {
+        if (child.exitCode !== null || child.signalCode !== null) {
+            resolve();
+            return;
+        }
+        const timeout = setTimeout(() => {
+            child.kill("SIGKILL");
+        }, 1000);
+        child.once("exit", () => {
+            clearTimeout(timeout);
+            resolve();
+        });
+        child.kill("SIGTERM");
+    });
+}
+function formatError(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function formatChildExit(mode, code, signal) {
+    if (code !== null)
+        return `${mode} app-server process exited unexpectedly with code ${code}.`;
+    if (signal !== null)
+        return `${mode} app-server process exited unexpectedly from signal ${signal}.`;
+    return `${mode} app-server process exited unexpectedly.`;
+}
+//# sourceMappingURL=transport-runtime.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/transport-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-runtime.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/transport-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcessWithoutNullStreams, spawn } from \"node:child_process\";\nimport { PiCodexAppServerRuntimeError } from \"./runtime-errors.ts\";\nimport { openWebSocketConnection, type PiCodexAppServerWebSocketDependencies } from \"./websocket-transport.ts\";\n\nexport type { PiCodexAppServerWebSocketLike } from \"./websocket-transport.ts\";\n\nexport type PiCodexAppServerTransportMode = \"stdio\" | \"websocket\" | \"unix\";\n\nexport interface PiCodexAppServerRuntimeFlags {\n\treadonly enabled: boolean;\n\treadonly mode: PiCodexAppServerTransportMode;\n\treadonly appServerCommand: string;\n\treadonly appServerArgs: readonly string[];\n\treadonly appServerUrl: string;\n\treadonly appServerSocketPath?: string;\n\treadonly connectTimeoutMs: number;\n}\n\nexport type PiCodexAppServerRuntimeStatus =\n\t| { readonly kind: \"stopped\" }\n\t| { readonly kind: \"starting\"; readonly mode: PiCodexAppServerTransportMode }\n\t| { readonly kind: \"running\"; readonly mode: PiCodexAppServerTransportMode }\n\t| { readonly kind: \"failed\"; readonly mode: PiCodexAppServerTransportMode; readonly message: string };\n\nexport interface PiCodexAppServerRuntimeController {\n\tstart(flags: PiCodexAppServerRuntimeFlags): Promise<PiCodexAppServerRuntimeStatus>;\n\tstop(): Promise<PiCodexAppServerRuntimeStatus>;\n\tgetStatus(): PiCodexAppServerRuntimeStatus;\n}\n\nexport type PiCodexAppServerRuntime = PiCodexAppServerRuntimeController;\n\nexport type PiCodexAppServerRuntimeDependencies = PiCodexAppServerWebSocketDependencies;\n\ninterface RuntimeConnection {\n\treadonly mode: PiCodexAppServerTransportMode;\n\tclose(): Promise<void>;\n\tonFailure(handler: (message: string) => void): void;\n}\n\ninterface ChildProcessConnectionOptions {\n\treadonly mode: PiCodexAppServerTransportMode;\n\treadonly command: string;\n\treadonly args: readonly string[];\n\treadonly connectTimeoutMs: number;\n}\n\nexport function createPiCodexAppServerRuntime(\n\tdependencies: PiCodexAppServerRuntimeDependencies = {},\n): PiCodexAppServerRuntime {\n\treturn new DefaultPiCodexAppServerRuntime(dependencies);\n}\n\nclass DefaultPiCodexAppServerRuntime implements PiCodexAppServerRuntime {\n\tprivate status: PiCodexAppServerRuntimeStatus = { kind: \"stopped\" };\n\tprivate connection: RuntimeConnection | undefined;\n\tprivate readonly dependencies: PiCodexAppServerRuntimeDependencies;\n\n\tconstructor(dependencies: PiCodexAppServerRuntimeDependencies) {\n\t\tthis.dependencies = dependencies;\n\t}\n\n\tasync start(flags: PiCodexAppServerRuntimeFlags): Promise<PiCodexAppServerRuntimeStatus> {\n\t\tawait this.stop();\n\t\tif (!flags.enabled) {\n\t\t\tthis.status = { kind: \"stopped\" };\n\t\t\treturn this.status;\n\t\t}\n\n\t\tthis.status = { kind: \"starting\", mode: flags.mode };\n\t\ttry {\n\t\t\tconst connection = await openConnection(flags, this.dependencies);\n\t\t\tconnection.onFailure((message) => {\n\t\t\t\tif (this.connection !== connection) return;\n\t\t\t\tthis.connection = undefined;\n\t\t\t\tthis.status = { kind: \"failed\", mode: connection.mode, message };\n\t\t\t});\n\t\t\tthis.connection = connection;\n\t\t\tthis.status = { kind: \"running\", mode: flags.mode };\n\t\t\treturn this.status;\n\t\t} catch (error) {\n\t\t\tthis.connection = undefined;\n\t\t\tthis.status = { kind: \"failed\", mode: flags.mode, message: formatError(error) };\n\t\t\treturn this.status;\n\t\t}\n\t}\n\n\tasync stop(): Promise<PiCodexAppServerRuntimeStatus> {\n\t\tconst activeConnection = this.connection;\n\t\tthis.connection = undefined;\n\t\tif (activeConnection) {\n\t\t\tawait activeConnection.close();\n\t\t}\n\t\tthis.status = { kind: \"stopped\" };\n\t\treturn this.status;\n\t}\n\n\tgetStatus(): PiCodexAppServerRuntimeStatus {\n\t\treturn this.status;\n\t}\n}\n\nasync function openConnection(\n\tflags: PiCodexAppServerRuntimeFlags,\n\tdependencies: PiCodexAppServerRuntimeDependencies,\n): Promise<RuntimeConnection> {\n\tswitch (flags.mode) {\n\t\tcase \"stdio\":\n\t\t\treturn openChildProcessConnection({\n\t\t\t\tmode: flags.mode,\n\t\t\t\tcommand: flags.appServerCommand,\n\t\t\t\targs: flags.appServerArgs,\n\t\t\t\tconnectTimeoutMs: flags.connectTimeoutMs,\n\t\t\t});\n\t\tcase \"unix\":\n\t\t\treturn openChildProcessConnection({\n\t\t\t\tmode: flags.mode,\n\t\t\t\tcommand: flags.appServerCommand,\n\t\t\t\targs: resolveUnixProxyArgs(flags),\n\t\t\t\tconnectTimeoutMs: flags.connectTimeoutMs,\n\t\t\t});\n\t\tcase \"websocket\": {\n\t\t\tconst webSocketConnection = await openWebSocketConnection(\n\t\t\t\tflags.appServerUrl,\n\t\t\t\tflags.connectTimeoutMs,\n\t\t\t\tdependencies,\n\t\t\t);\n\t\t\treturn {\n\t\t\t\tmode: \"websocket\",\n\t\t\t\tclose: () => webSocketConnection.close(),\n\t\t\t\tonFailure: (handler) => webSocketConnection.onUnexpectedClose(handler),\n\t\t\t};\n\t\t}\n\t}\n}\n\nfunction resolveUnixProxyArgs(flags: PiCodexAppServerRuntimeFlags): readonly string[] {\n\tif (flags.appServerArgs.length > 0 && flags.appServerArgs.join(\" \") !== \"app-server\") {\n\t\treturn flags.appServerArgs;\n\t}\n\tconst socketPath = flags.appServerSocketPath;\n\tif (!socketPath) {\n\t\tthrow new PiCodexAppServerRuntimeError(\"unix\", \"Unix transport requires an app-server socket path.\");\n\t}\n\treturn [\"app-server\", \"proxy\", \"--sock\", socketPath];\n}\n\nasync function openChildProcessConnection(options: ChildProcessConnectionOptions): Promise<RuntimeConnection> {\n\tif (options.command.trim().length === 0) {\n\t\tthrow new PiCodexAppServerRuntimeError(options.mode, \"App-server command is required.\");\n\t}\n\tconst child = spawn(options.command, [...options.args], { stdio: \"pipe\" });\n\tconst connection = new ChildProcessRuntimeConnection(child, options.mode);\n\tawait waitForChildSpawn(child, options.mode, options.connectTimeoutMs);\n\treturn connection;\n}\n\nclass ChildProcessRuntimeConnection implements RuntimeConnection {\n\treadonly mode: PiCodexAppServerTransportMode;\n\tprivate readonly child: ChildProcessWithoutNullStreams;\n\tprivate failureHandler: ((message: string) => void) | undefined;\n\tprivate failureMessage: string | undefined;\n\tprivate closing = false;\n\n\tconstructor(child: ChildProcessWithoutNullStreams, mode: PiCodexAppServerTransportMode) {\n\t\tthis.child = child;\n\t\tthis.mode = mode;\n\t\tchild.once(\"exit\", (code, signal) => {\n\t\t\tif (this.closing) return;\n\t\t\tthis.recordFailure(formatChildExit(mode, code, signal));\n\t\t});\n\t\tchild.once(\"error\", (error) => {\n\t\t\tif (this.closing) return;\n\t\t\tthis.recordFailure(error.message);\n\t\t});\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.closing = true;\n\t\tawait stopChild(this.child);\n\t}\n\n\tonFailure(handler: (message: string) => void): void {\n\t\tthis.failureHandler = handler;\n\t\tif (this.failureMessage) {\n\t\t\tconst message = this.failureMessage;\n\t\t\tqueueMicrotask(() => handler(message));\n\t\t}\n\t}\n\n\tprivate recordFailure(message: string): void {\n\t\tthis.failureMessage = message;\n\t\tthis.failureHandler?.(message);\n\t}\n}\n\nfunction waitForChildSpawn(\n\tchild: ChildProcessWithoutNullStreams,\n\tmode: PiCodexAppServerTransportMode,\n\tconnectTimeoutMs: number,\n): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tconst timeout = setTimeout(() => {\n\t\t\tcleanup();\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\treject(\n\t\t\t\tnew PiCodexAppServerRuntimeError(mode, `App-server process did not spawn within ${connectTimeoutMs}ms.`),\n\t\t\t);\n\t\t}, connectTimeoutMs);\n\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timeout);\n\t\t\tchild.off(\"spawn\", onSpawn);\n\t\t\tchild.off(\"error\", onError);\n\t\t};\n\t\tconst onSpawn = () => {\n\t\t\tcleanup();\n\t\t\tresolve();\n\t\t};\n\t\tconst onError = (error: Error) => {\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t};\n\n\t\tchild.once(\"spawn\", onSpawn);\n\t\tchild.once(\"error\", onError);\n\t});\n}\n\nfunction stopChild(child: ChildProcessWithoutNullStreams): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tif (child.exitCode !== null || child.signalCode !== null) {\n\t\t\tresolve();\n\t\t\treturn;\n\t\t}\n\t\tconst timeout = setTimeout(() => {\n\t\t\tchild.kill(\"SIGKILL\");\n\t\t}, 1000);\n\t\tchild.once(\"exit\", () => {\n\t\t\tclearTimeout(timeout);\n\t\t\tresolve();\n\t\t});\n\t\tchild.kill(\"SIGTERM\");\n\t});\n}\n\nfunction formatError(error: unknown): string {\n\tif (error instanceof Error) return error.message;\n\treturn String(error);\n}\n\nfunction formatChildExit(\n\tmode: PiCodexAppServerTransportMode,\n\tcode: number | null,\n\tsignal: NodeJS.Signals | null,\n): string {\n\tif (code !== null) return `${mode} app-server process exited unexpectedly with code ${code}.`;\n\tif (signal !== null) return `${mode} app-server process exited unexpectedly from signal ${signal}.`;\n\treturn `${mode} app-server process exited unexpectedly.`;\n}\n"]}

package/dist/core/extensions/builtin/pi-codex-app-server/websocket-transport.d.ts

@@ -0,0 +1,20 @@
+type WebSocketEventType = "open" | "error" | "close";
+type WebSocketListener = () => void;
+export interface PiCodexAppServerWebSocketLike {
+    readonly readyState: number;
+    addEventListener(type: WebSocketEventType, listener: WebSocketListener, options?: {
+        readonly once?: boolean;
+    }): void;
+    removeEventListener(type: WebSocketEventType, listener: WebSocketListener): void;
+    close(code?: number, reason?: string): void;
+}
+export interface PiCodexAppServerWebSocketDependencies {
+    createWebSocket?(url: string): PiCodexAppServerWebSocketLike;
+}
+export interface PiCodexAppServerWebSocketConnection {
+    close(): Promise<void>;
+    onUnexpectedClose(handler: (message: string) => void): void;
+}
+export declare function openWebSocketConnection(url: string, connectTimeoutMs: number, dependencies: PiCodexAppServerWebSocketDependencies): Promise<PiCodexAppServerWebSocketConnection>;
+export {};
+//# sourceMappingURL=websocket-transport.d.ts.map

package/dist/core/extensions/builtin/pi-codex-app-server/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/websocket-transport.ts"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AACrD,KAAK,iBAAiB,GAAG,MAAM,IAAI,CAAC;AAEpC,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACrH,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,qCAAqC;IACrD,eAAe,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,6BAA6B,CAAC;CAC7D;AAED,MAAM,WAAW,mCAAmC;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,iBAAiB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CAC5D;AAED,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,qCAAqC,GACjD,OAAO,CAAC,mCAAmC,CAAC,CAqC9C"}

package/dist/core/extensions/builtin/pi-codex-app-server/websocket-transport.js

@@ -0,0 +1,90 @@
+import { PiCodexAppServerRuntimeError } from "./runtime-errors.js";
+export function openWebSocketConnection(url, connectTimeoutMs, dependencies) {
+    if (url.trim().length === 0) {
+        throw new PiCodexAppServerRuntimeError("websocket", "Websocket URL is required.");
+    }
+    return new Promise((resolve, reject) => {
+        const socket = createRuntimeWebSocket(url, dependencies);
+        const timeout = setTimeout(() => {
+            cleanup();
+            socket.close(1000, "connect_timeout");
+            reject(new PiCodexAppServerRuntimeError("websocket", `WebSocket connect timeout after ${connectTimeoutMs}ms.`));
+        }, connectTimeoutMs);
+        const cleanup = () => {
+            clearTimeout(timeout);
+            socket.removeEventListener("open", onOpen);
+            socket.removeEventListener("error", onError);
+            socket.removeEventListener("close", onClose);
+        };
+        const onOpen = () => {
+            cleanup();
+            resolve(new RuntimeWebSocketConnection(socket));
+        };
+        const onError = () => {
+            cleanup();
+            reject(new PiCodexAppServerRuntimeError("websocket", "WebSocket connection failed."));
+        };
+        const onClose = () => {
+            cleanup();
+            reject(new PiCodexAppServerRuntimeError("websocket", "WebSocket closed before opening."));
+        };
+        socket.addEventListener("open", onOpen);
+        socket.addEventListener("error", onError);
+        socket.addEventListener("close", onClose);
+    });
+}
+class RuntimeWebSocketConnection {
+    constructor(socket) {
+        this.closing = false;
+        this.socket = socket;
+        socket.addEventListener("close", () => {
+            if (this.closing)
+                return;
+            this.recordFailure("WebSocket closed unexpectedly.");
+        });
+        socket.addEventListener("error", () => {
+            if (this.closing)
+                return;
+            this.recordFailure("WebSocket failed after opening.");
+        });
+    }
+    async close() {
+        this.closing = true;
+        await closeWebSocket(this.socket);
+    }
+    onUnexpectedClose(handler) {
+        this.failureHandler = handler;
+        if (this.failureMessage) {
+            const message = this.failureMessage;
+            queueMicrotask(() => handler(message));
+        }
+    }
+    recordFailure(message) {
+        this.failureMessage = message;
+        this.failureHandler?.(message);
+    }
+}
+function createRuntimeWebSocket(url, dependencies) {
+    if (dependencies.createWebSocket)
+        return dependencies.createWebSocket(url);
+    const WebSocketConstructor = globalThis.WebSocket;
+    if (!WebSocketConstructor) {
+        throw new PiCodexAppServerRuntimeError("websocket", "WebSocket transport is unavailable in this runtime.");
+    }
+    return new WebSocketConstructor(url);
+}
+function closeWebSocket(socket) {
+    return new Promise((resolve) => {
+        if (socket.readyState === 3) {
+            resolve();
+            return;
+        }
+        const timeout = setTimeout(resolve, 1000);
+        socket.addEventListener("close", () => {
+            clearTimeout(timeout);
+            resolve();
+        }, { once: true });
+        socket.close(1000, "runtime_shutdown");
+    });
+}
+//# sourceMappingURL=websocket-transport.js.map

package/dist/core/extensions/builtin/pi-codex-app-server/websocket-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/pi-codex-app-server/websocket-transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { PiCodexAppServerRuntimeError } from \"./runtime-errors.ts\";\n\ntype WebSocketEventType = \"open\" | \"error\" | \"close\";\ntype WebSocketListener = () => void;\n\nexport interface PiCodexAppServerWebSocketLike {\n\treadonly readyState: number;\n\taddEventListener(type: WebSocketEventType, listener: WebSocketListener, options?: { readonly once?: boolean }): void;\n\tremoveEventListener(type: WebSocketEventType, listener: WebSocketListener): void;\n\tclose(code?: number, reason?: string): void;\n}\n\nexport interface PiCodexAppServerWebSocketDependencies {\n\tcreateWebSocket?(url: string): PiCodexAppServerWebSocketLike;\n}\n\nexport interface PiCodexAppServerWebSocketConnection {\n\tclose(): Promise<void>;\n\tonUnexpectedClose(handler: (message: string) => void): void;\n}\n\nexport function openWebSocketConnection(\n\turl: string,\n\tconnectTimeoutMs: number,\n\tdependencies: PiCodexAppServerWebSocketDependencies,\n): Promise<PiCodexAppServerWebSocketConnection> {\n\tif (url.trim().length === 0) {\n\t\tthrow new PiCodexAppServerRuntimeError(\"websocket\", \"Websocket URL is required.\");\n\t}\n\n\treturn new Promise((resolve, reject) => {\n\t\tconst socket = createRuntimeWebSocket(url, dependencies);\n\t\tconst timeout = setTimeout(() => {\n\t\t\tcleanup();\n\t\t\tsocket.close(1000, \"connect_timeout\");\n\t\t\treject(\n\t\t\t\tnew PiCodexAppServerRuntimeError(\"websocket\", `WebSocket connect timeout after ${connectTimeoutMs}ms.`),\n\t\t\t);\n\t\t}, connectTimeoutMs);\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timeout);\n\t\t\tsocket.removeEventListener(\"open\", onOpen);\n\t\t\tsocket.removeEventListener(\"error\", onError);\n\t\t\tsocket.removeEventListener(\"close\", onClose);\n\t\t};\n\t\tconst onOpen = () => {\n\t\t\tcleanup();\n\t\t\tresolve(new RuntimeWebSocketConnection(socket));\n\t\t};\n\t\tconst onError = () => {\n\t\t\tcleanup();\n\t\t\treject(new PiCodexAppServerRuntimeError(\"websocket\", \"WebSocket connection failed.\"));\n\t\t};\n\t\tconst onClose = () => {\n\t\t\tcleanup();\n\t\t\treject(new PiCodexAppServerRuntimeError(\"websocket\", \"WebSocket closed before opening.\"));\n\t\t};\n\n\t\tsocket.addEventListener(\"open\", onOpen);\n\t\tsocket.addEventListener(\"error\", onError);\n\t\tsocket.addEventListener(\"close\", onClose);\n\t});\n}\n\nclass RuntimeWebSocketConnection implements PiCodexAppServerWebSocketConnection {\n\tprivate readonly socket: PiCodexAppServerWebSocketLike;\n\tprivate failureHandler: ((message: string) => void) | undefined;\n\tprivate failureMessage: string | undefined;\n\tprivate closing = false;\n\n\tconstructor(socket: PiCodexAppServerWebSocketLike) {\n\t\tthis.socket = socket;\n\t\tsocket.addEventListener(\"close\", () => {\n\t\t\tif (this.closing) return;\n\t\t\tthis.recordFailure(\"WebSocket closed unexpectedly.\");\n\t\t});\n\t\tsocket.addEventListener(\"error\", () => {\n\t\t\tif (this.closing) return;\n\t\t\tthis.recordFailure(\"WebSocket failed after opening.\");\n\t\t});\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.closing = true;\n\t\tawait closeWebSocket(this.socket);\n\t}\n\n\tonUnexpectedClose(handler: (message: string) => void): void {\n\t\tthis.failureHandler = handler;\n\t\tif (this.failureMessage) {\n\t\t\tconst message = this.failureMessage;\n\t\t\tqueueMicrotask(() => handler(message));\n\t\t}\n\t}\n\n\tprivate recordFailure(message: string): void {\n\t\tthis.failureMessage = message;\n\t\tthis.failureHandler?.(message);\n\t}\n}\n\nfunction createRuntimeWebSocket(\n\turl: string,\n\tdependencies: PiCodexAppServerWebSocketDependencies,\n): PiCodexAppServerWebSocketLike {\n\tif (dependencies.createWebSocket) return dependencies.createWebSocket(url);\n\tconst WebSocketConstructor = globalThis.WebSocket;\n\tif (!WebSocketConstructor) {\n\t\tthrow new PiCodexAppServerRuntimeError(\"websocket\", \"WebSocket transport is unavailable in this runtime.\");\n\t}\n\treturn new WebSocketConstructor(url);\n}\n\nfunction closeWebSocket(socket: PiCodexAppServerWebSocketLike): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tif (socket.readyState === 3) {\n\t\t\tresolve();\n\t\t\treturn;\n\t\t}\n\t\tconst timeout = setTimeout(resolve, 1000);\n\t\tsocket.addEventListener(\n\t\t\t\"close\",\n\t\t\t() => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tresolve();\n\t\t\t},\n\t\t\t{ once: true },\n\t\t);\n\t\tsocket.close(1000, \"runtime_shutdown\");\n\t});\n}\n"]}