@code-yeongyu/senpi 2026.7.4 → 2026.7.9-2

package/dist/modes/app-server/server/notifications.js

@@ -0,0 +1,144 @@
+const DEFAULT_OUTBOUND_QUEUE_LIMIT = 32_768;
+const DEFAULT_TERMINAL_QUEUE_LIMIT = 100;
+const DEFAULT_EXPERIMENTAL_NOTIFICATION_METHODS = ["remoteControl/status/changed"];
+const BROADCAST_NOTIFICATION_METHODS = new Set([
+    "thread/started",
+    "thread/status/changed",
+    "thread/closed",
+    "thread/deleted",
+    "thread/archived",
+    "thread/name/updated",
+    "thread/tokenUsage/updated",
+]);
+const TERMINAL_NOTIFICATION_METHODS = new Set(["turn/completed", "turn/failed", "error"]);
+export class BroadcastNotificationMethodError extends Error {
+    constructor(method) {
+        super(`Notification method ${method} is not allowed for broadcast`);
+        this.name = "BroadcastNotificationMethodError";
+        this.method = method;
+    }
+}
+export class NotificationRouter {
+    constructor(options = {}) {
+        this.connections = new Map();
+        this.threads = new Map();
+        this.outboundQueueLimit = options.outboundQueueLimit ?? DEFAULT_OUTBOUND_QUEUE_LIMIT;
+        this.terminalQueueLimit = options.terminalQueueLimit ?? DEFAULT_TERMINAL_QUEUE_LIMIT;
+        this.experimentalNotificationMethods = new Set(options.experimentalNotificationMethods ?? DEFAULT_EXPERIMENTAL_NOTIFICATION_METHODS);
+        for (const connection of options.connections ?? []) {
+            this.addConnection(connection);
+        }
+        for (const thread of options.threads ?? []) {
+            this.addThread(thread);
+        }
+    }
+    addConnection(connection) {
+        this.connections.set(connection.id, {
+            connection,
+            pending: 0,
+            closed: false,
+        });
+    }
+    /**
+     * Removes the connection from every thread subscription. Returns the ids of
+     * threads that lost their last subscriber so the caller can schedule idle
+     * unloads for them (a dropped socket must not keep sessions loaded forever).
+     */
+    removeConnection(connectionId) {
+        this.connections.delete(connectionId);
+        const emptiedThreadIds = [];
+        for (const thread of this.threads.values()) {
+            if (thread.subscribers.delete(connectionId) && thread.subscribers.size === 0) {
+                emptiedThreadIds.push(thread.id);
+            }
+        }
+        return emptiedThreadIds;
+    }
+    addThread(thread) {
+        this.threads.set(thread.id, thread);
+    }
+    /** Drops routing state for an unloaded/deleted thread so the entry (and its session) can be collected. */
+    removeThread(threadId) {
+        this.threads.delete(threadId);
+    }
+    subscribe(threadId, connectionId) {
+        const thread = this.threads.get(threadId);
+        if (!thread) {
+            return;
+        }
+        thread.subscribers.add(connectionId);
+        const connection = this.connections.get(connectionId);
+        if (!connection) {
+            return;
+        }
+        for (const notification of thread.queuedTerminalNotifications) {
+            this.enqueue(connection, notification);
+        }
+        thread.queuedTerminalNotifications = [];
+    }
+    unsubscribe(threadId, connectionId) {
+        this.threads.get(threadId)?.subscribers.delete(connectionId);
+    }
+    broadcast(notification) {
+        if (!this.canBroadcast(notification.method)) {
+            throw new BroadcastNotificationMethodError(notification.method);
+        }
+        for (const state of this.connections.values()) {
+            if (state.connection.initialized) {
+                this.enqueue(state, notification);
+            }
+        }
+    }
+    toThread(threadId, notification) {
+        const thread = this.threads.get(threadId);
+        if (!thread) {
+            return;
+        }
+        let routed = 0;
+        for (const connectionId of thread.subscribers) {
+            const state = this.connections.get(connectionId);
+            if (state?.connection.initialized) {
+                routed += 1;
+                this.enqueue(state, notification);
+            }
+        }
+        if (routed === 0 && TERMINAL_NOTIFICATION_METHODS.has(notification.method)) {
+            thread.queuedTerminalNotifications.push(notification);
+            while (thread.queuedTerminalNotifications.length > this.terminalQueueLimit) {
+                thread.queuedTerminalNotifications.shift();
+            }
+        }
+    }
+    enqueue(state, notification) {
+        if (state.closed || this.filtered(state.connection, notification)) {
+            return;
+        }
+        if (state.connection.transport !== "stdio" && state.pending >= this.outboundQueueLimit) {
+            state.closed = true;
+            state.connection.close?.("slow-client");
+            return;
+        }
+        state.pending += 1;
+        const sendResult = state.connection.send(notification);
+        if (sendResult === undefined) {
+            state.pending -= 1;
+            return;
+        }
+        sendResult.then(() => {
+            state.pending -= 1;
+        }, () => {
+            state.pending -= 1;
+        });
+    }
+    canBroadcast(method) {
+        return BROADCAST_NOTIFICATION_METHODS.has(method) || this.experimentalNotificationMethods.has(method);
+    }
+    filtered(connection, notification) {
+        if (connection.optOutNotificationMethods?.includes(notification.method)) {
+            return true;
+        }
+        return (this.experimentalNotificationMethods.has(notification.method) &&
+            connection.capabilities?.experimentalApi !== true);
+    }
+}
+//# sourceMappingURL=notifications.js.map

package/dist/modes/app-server/server/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../../../src/modes/app-server/server/notifications.ts"],"names":[],"mappings":"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","sourcesContent":["export type RouterNotification = {\n\treadonly method: string;\n\treadonly params?: unknown;\n};\n\nexport type ConnectionTransport = \"stdio\" | \"ws\" | \"unix\";\n\nexport interface RoutableConnection {\n\treadonly id: string;\n\treadonly initialized: boolean;\n\treadonly transport: ConnectionTransport;\n\treadonly capabilities?: {\n\t\treadonly experimentalApi?: boolean;\n\t};\n\treadonly optOutNotificationMethods?: readonly string[] | null;\n\tsend(notification: RouterNotification): Promise<void> | void;\n\tclose?(reason: \"slow-client\"): void;\n}\n\nexport interface RoutableThread {\n\treadonly id: string;\n\treadonly subscribers: Set<string>;\n\tqueuedTerminalNotifications: RouterNotification[];\n}\n\nexport interface NotificationRouterOptions {\n\treadonly connections?: Iterable<RoutableConnection>;\n\treadonly threads?: Iterable<RoutableThread>;\n\treadonly outboundQueueLimit?: number;\n\treadonly terminalQueueLimit?: number;\n\treadonly experimentalNotificationMethods?: Iterable<string>;\n}\n\ninterface ConnectionState {\n\treadonly connection: RoutableConnection;\n\tpending: number;\n\tclosed: boolean;\n}\n\nconst DEFAULT_OUTBOUND_QUEUE_LIMIT = 32_768;\nconst DEFAULT_TERMINAL_QUEUE_LIMIT = 100;\n\nconst DEFAULT_EXPERIMENTAL_NOTIFICATION_METHODS = [\"remoteControl/status/changed\"] as const;\nconst BROADCAST_NOTIFICATION_METHODS = new Set([\n\t\"thread/started\",\n\t\"thread/status/changed\",\n\t\"thread/closed\",\n\t\"thread/deleted\",\n\t\"thread/archived\",\n\t\"thread/name/updated\",\n\t\"thread/tokenUsage/updated\",\n]);\nconst TERMINAL_NOTIFICATION_METHODS = new Set([\"turn/completed\", \"turn/failed\", \"error\"]);\n\nexport class BroadcastNotificationMethodError extends Error {\n\treadonly method: string;\n\n\tconstructor(method: string) {\n\t\tsuper(`Notification method ${method} is not allowed for broadcast`);\n\t\tthis.name = \"BroadcastNotificationMethodError\";\n\t\tthis.method = method;\n\t}\n}\n\nexport class NotificationRouter {\n\tprivate readonly connections = new Map<string, ConnectionState>();\n\tprivate readonly threads = new Map<string, RoutableThread>();\n\tprivate readonly outboundQueueLimit: number;\n\tprivate readonly terminalQueueLimit: number;\n\tprivate readonly experimentalNotificationMethods: ReadonlySet<string>;\n\n\tconstructor(options: NotificationRouterOptions = {}) {\n\t\tthis.outboundQueueLimit = options.outboundQueueLimit ?? DEFAULT_OUTBOUND_QUEUE_LIMIT;\n\t\tthis.terminalQueueLimit = options.terminalQueueLimit ?? DEFAULT_TERMINAL_QUEUE_LIMIT;\n\t\tthis.experimentalNotificationMethods = new Set(\n\t\t\toptions.experimentalNotificationMethods ?? DEFAULT_EXPERIMENTAL_NOTIFICATION_METHODS,\n\t\t);\n\t\tfor (const connection of options.connections ?? []) {\n\t\t\tthis.addConnection(connection);\n\t\t}\n\t\tfor (const thread of options.threads ?? []) {\n\t\t\tthis.addThread(thread);\n\t\t}\n\t}\n\n\taddConnection(connection: RoutableConnection): void {\n\t\tthis.connections.set(connection.id, {\n\t\t\tconnection,\n\t\t\tpending: 0,\n\t\t\tclosed: false,\n\t\t});\n\t}\n\n\t/**\n\t * Removes the connection from every thread subscription. Returns the ids of\n\t * threads that lost their last subscriber so the caller can schedule idle\n\t * unloads for them (a dropped socket must not keep sessions loaded forever).\n\t */\n\tremoveConnection(connectionId: string): string[] {\n\t\tthis.connections.delete(connectionId);\n\t\tconst emptiedThreadIds: string[] = [];\n\t\tfor (const thread of this.threads.values()) {\n\t\t\tif (thread.subscribers.delete(connectionId) && thread.subscribers.size === 0) {\n\t\t\t\temptiedThreadIds.push(thread.id);\n\t\t\t}\n\t\t}\n\t\treturn emptiedThreadIds;\n\t}\n\n\taddThread(thread: RoutableThread): void {\n\t\tthis.threads.set(thread.id, thread);\n\t}\n\n\t/** Drops routing state for an unloaded/deleted thread so the entry (and its session) can be collected. */\n\tremoveThread(threadId: string): void {\n\t\tthis.threads.delete(threadId);\n\t}\n\n\tsubscribe(threadId: string, connectionId: string): void {\n\t\tconst thread = this.threads.get(threadId);\n\t\tif (!thread) {\n\t\t\treturn;\n\t\t}\n\t\tthread.subscribers.add(connectionId);\n\t\tconst connection = this.connections.get(connectionId);\n\t\tif (!connection) {\n\t\t\treturn;\n\t\t}\n\t\tfor (const notification of thread.queuedTerminalNotifications) {\n\t\t\tthis.enqueue(connection, notification);\n\t\t}\n\t\tthread.queuedTerminalNotifications = [];\n\t}\n\n\tunsubscribe(threadId: string, connectionId: string): void {\n\t\tthis.threads.get(threadId)?.subscribers.delete(connectionId);\n\t}\n\n\tbroadcast(notification: RouterNotification): void {\n\t\tif (!this.canBroadcast(notification.method)) {\n\t\t\tthrow new BroadcastNotificationMethodError(notification.method);\n\t\t}\n\t\tfor (const state of this.connections.values()) {\n\t\t\tif (state.connection.initialized) {\n\t\t\t\tthis.enqueue(state, notification);\n\t\t\t}\n\t\t}\n\t}\n\n\ttoThread(threadId: string, notification: RouterNotification): void {\n\t\tconst thread = this.threads.get(threadId);\n\t\tif (!thread) {\n\t\t\treturn;\n\t\t}\n\t\tlet routed = 0;\n\t\tfor (const connectionId of thread.subscribers) {\n\t\t\tconst state = this.connections.get(connectionId);\n\t\t\tif (state?.connection.initialized) {\n\t\t\t\trouted += 1;\n\t\t\t\tthis.enqueue(state, notification);\n\t\t\t}\n\t\t}\n\t\tif (routed === 0 && TERMINAL_NOTIFICATION_METHODS.has(notification.method)) {\n\t\t\tthread.queuedTerminalNotifications.push(notification);\n\t\t\twhile (thread.queuedTerminalNotifications.length > this.terminalQueueLimit) {\n\t\t\t\tthread.queuedTerminalNotifications.shift();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate enqueue(state: ConnectionState, notification: RouterNotification): void {\n\t\tif (state.closed || this.filtered(state.connection, notification)) {\n\t\t\treturn;\n\t\t}\n\t\tif (state.connection.transport !== \"stdio\" && state.pending >= this.outboundQueueLimit) {\n\t\t\tstate.closed = true;\n\t\t\tstate.connection.close?.(\"slow-client\");\n\t\t\treturn;\n\t\t}\n\t\tstate.pending += 1;\n\t\tconst sendResult = state.connection.send(notification);\n\t\tif (sendResult === undefined) {\n\t\t\tstate.pending -= 1;\n\t\t\treturn;\n\t\t}\n\t\tsendResult.then(\n\t\t\t() => {\n\t\t\t\tstate.pending -= 1;\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tstate.pending -= 1;\n\t\t\t},\n\t\t);\n\t}\n\n\tprivate canBroadcast(method: string): boolean {\n\t\treturn BROADCAST_NOTIFICATION_METHODS.has(method) || this.experimentalNotificationMethods.has(method);\n\t}\n\n\tprivate filtered(connection: RoutableConnection, notification: RouterNotification): boolean {\n\t\tif (connection.optOutNotificationMethods?.includes(notification.method)) {\n\t\t\treturn true;\n\t\t}\n\t\treturn (\n\t\t\tthis.experimentalNotificationMethods.has(notification.method) &&\n\t\t\tconnection.capabilities?.experimentalApi !== true\n\t\t);\n\t}\n}\n"]}

package/dist/modes/app-server/server/server-core.d.ts

@@ -0,0 +1,28 @@
+import type { ClassifiedIncoming, RpcNotification } from "../rpc/envelope.ts";
+import { type MethodRegistration, type MethodRegistry } from "../rpc/registry.ts";
+import { type Connection, type ConnectionId, type ConnectionInput } from "./connection.ts";
+import { type AppServerModelRegistry } from "./models.ts";
+export interface ServerCoreOptions {
+    readonly registry?: MethodRegistry;
+    readonly modelRegistry?: AppServerModelRegistry;
+    readonly codexHome?: string;
+    readonly version?: string;
+}
+export declare class ServerCore {
+    private readonly connections;
+    private readonly registry;
+    private readonly codexHome;
+    private readonly version;
+    constructor(options?: ServerCoreOptions);
+    addConnection(input: ConnectionInput): Connection;
+    removeConnection(id: ConnectionId): void;
+    getConnection(id: ConnectionId): Connection | undefined;
+    registerMethod(method: string, registration: MethodRegistration): void;
+    receive(connectionId: ConnectionId, envelope: ClassifiedIncoming): Promise<void>;
+    sendNotificationToConnection(connectionId: ConnectionId, notification: RpcNotification): Promise<boolean>;
+    broadcastNotification(notification: RpcNotification): Promise<number>;
+    private dispatchRequest;
+    private handleInitialize;
+    private handleNotification;
+}
+//# sourceMappingURL=server-core.d.ts.map

package/dist/modes/app-server/server/server-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-core.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/server/server-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAA2B,MAAM,oBAAoB,CAAC;AAEvG,OAAO,EAAkB,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAEN,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EAIpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,sBAAsB,EAAiC,MAAM,aAAa,CAAC;AAEzF,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,YAAY,OAAO,GAAE,iBAAsB,EAK1C;IAED,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAIhD;IAED,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEvC;IAED,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAEtD;IAED,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAErE;IAEK,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBrF;IAEK,4BAA4B,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9G;IAEK,qBAAqB,CAAC,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;YAEa,eAAe;IAO7B,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/modes/app-server/server/server-core.js

@@ -0,0 +1,100 @@
+import { getAgentDir, VERSION } from "../../../config.js";
+import { alreadyInitializedError, invalidParamsError, invalidRequestError } from "../rpc/errors.js";
+import { createRegistry } from "../rpc/registry.js";
+import { buildInitializeResponse, canDeliverNotification, createConnection, parseInitializeParams, } from "./connection.js";
+import { registerAppServerModelMethods } from "./models.js";
+export class ServerCore {
+    constructor(options = {}) {
+        this.connections = new Map();
+        this.registry = options.registry ?? createRegistry();
+        registerAppServerModelMethods(this.registry, { modelRegistry: options.modelRegistry });
+        this.codexHome = options.codexHome ?? getAgentDir();
+        this.version = options.version ?? VERSION;
+    }
+    addConnection(input) {
+        const connection = createConnection(input);
+        this.connections.set(connection.id, connection);
+        return connection;
+    }
+    removeConnection(id) {
+        this.connections.delete(id);
+    }
+    getConnection(id) {
+        return this.connections.get(id);
+    }
+    registerMethod(method, registration) {
+        this.registry.register(method, registration);
+    }
+    async receive(connectionId, envelope) {
+        const connection = this.connections.get(connectionId);
+        if (!connection) {
+            return;
+        }
+        switch (envelope.kind) {
+            case "request":
+                await connection.send(await this.dispatchRequest(connection, envelope.message));
+                return;
+            case "notification":
+                this.handleNotification(envelope.message);
+                return;
+            case "response":
+                return;
+            case "protocol-invalid":
+                await connection.send({ id: null, error: invalidRequestError() });
+                return;
+            default:
+                return assertNever(envelope);
+        }
+    }
+    async sendNotificationToConnection(connectionId, notification) {
+        const connection = this.connections.get(connectionId);
+        if (!connection || !canDeliverNotification(connection, notification)) {
+            return false;
+        }
+        await connection.send(notification);
+        return true;
+    }
+    async broadcastNotification(notification) {
+        let delivered = 0;
+        for (const connection of this.connections.values()) {
+            if (canDeliverNotification(connection, notification)) {
+                await connection.send(notification);
+                delivered += 1;
+            }
+        }
+        return delivered;
+    }
+    async dispatchRequest(connection, request) {
+        if (request.method === "initialize") {
+            return this.handleInitialize(connection, request);
+        }
+        return this.registry.dispatch(connection, request);
+    }
+    handleInitialize(connection, request) {
+        if (connection.initialized) {
+            return { id: request.id, error: alreadyInitializedError() };
+        }
+        const params = parseInitializeParams(request.params);
+        if (!params) {
+            return { id: request.id, error: invalidParamsError() };
+        }
+        const initialized = connection.initialize(params, this.version);
+        switch (initialized.kind) {
+            case "initialized":
+                return { id: request.id, result: buildInitializeResponse(connection, this.codexHome) };
+            case "already-initialized":
+                return { id: request.id, error: alreadyInitializedError() };
+            default:
+                return assertNever(initialized);
+        }
+    }
+    handleNotification(notification) {
+        if (notification.method === "initialized") {
+            return;
+        }
+    }
+}
+function assertNever(value) {
+    throw new Error(`Unhandled app-server envelope kind: ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=server-core.js.map

package/dist/modes/app-server/server/server-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-core.js","sourceRoot":"","sources":["../../../../src/modes/app-server/server/server-core.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAgentDir, VERSION } from \"../../../config.ts\";\nimport type { ClassifiedIncoming, RpcNotification, RpcRequest, RpcResponse } from \"../rpc/envelope.ts\";\nimport { alreadyInitializedError, invalidParamsError, invalidRequestError } from \"../rpc/errors.ts\";\nimport { createRegistry, type MethodRegistration, type MethodRegistry } from \"../rpc/registry.ts\";\nimport {\n\tbuildInitializeResponse,\n\ttype Connection,\n\ttype ConnectionId,\n\ttype ConnectionInput,\n\tcanDeliverNotification,\n\tcreateConnection,\n\tparseInitializeParams,\n} from \"./connection.ts\";\nimport { type AppServerModelRegistry, registerAppServerModelMethods } from \"./models.ts\";\n\nexport interface ServerCoreOptions {\n\treadonly registry?: MethodRegistry;\n\treadonly modelRegistry?: AppServerModelRegistry;\n\treadonly codexHome?: string;\n\treadonly version?: string;\n}\n\nexport class ServerCore {\n\tprivate readonly connections = new Map<ConnectionId, Connection>();\n\tprivate readonly registry: MethodRegistry;\n\tprivate readonly codexHome: string;\n\tprivate readonly version: string;\n\n\tconstructor(options: ServerCoreOptions = {}) {\n\t\tthis.registry = options.registry ?? createRegistry();\n\t\tregisterAppServerModelMethods(this.registry, { modelRegistry: options.modelRegistry });\n\t\tthis.codexHome = options.codexHome ?? getAgentDir();\n\t\tthis.version = options.version ?? VERSION;\n\t}\n\n\taddConnection(input: ConnectionInput): Connection {\n\t\tconst connection = createConnection(input);\n\t\tthis.connections.set(connection.id, connection);\n\t\treturn connection;\n\t}\n\n\tremoveConnection(id: ConnectionId): void {\n\t\tthis.connections.delete(id);\n\t}\n\n\tgetConnection(id: ConnectionId): Connection | undefined {\n\t\treturn this.connections.get(id);\n\t}\n\n\tregisterMethod(method: string, registration: MethodRegistration): void {\n\t\tthis.registry.register(method, registration);\n\t}\n\n\tasync receive(connectionId: ConnectionId, envelope: ClassifiedIncoming): Promise<void> {\n\t\tconst connection = this.connections.get(connectionId);\n\t\tif (!connection) {\n\t\t\treturn;\n\t\t}\n\n\t\tswitch (envelope.kind) {\n\t\t\tcase \"request\":\n\t\t\t\tawait connection.send(await this.dispatchRequest(connection, envelope.message));\n\t\t\t\treturn;\n\t\t\tcase \"notification\":\n\t\t\t\tthis.handleNotification(envelope.message);\n\t\t\t\treturn;\n\t\t\tcase \"response\":\n\t\t\t\treturn;\n\t\t\tcase \"protocol-invalid\":\n\t\t\t\tawait connection.send({ id: null, error: invalidRequestError() });\n\t\t\t\treturn;\n\t\t\tdefault:\n\t\t\t\treturn assertNever(envelope);\n\t\t}\n\t}\n\n\tasync sendNotificationToConnection(connectionId: ConnectionId, notification: RpcNotification): Promise<boolean> {\n\t\tconst connection = this.connections.get(connectionId);\n\t\tif (!connection || !canDeliverNotification(connection, notification)) {\n\t\t\treturn false;\n\t\t}\n\t\tawait connection.send(notification);\n\t\treturn true;\n\t}\n\n\tasync broadcastNotification(notification: RpcNotification): Promise<number> {\n\t\tlet delivered = 0;\n\t\tfor (const connection of this.connections.values()) {\n\t\t\tif (canDeliverNotification(connection, notification)) {\n\t\t\t\tawait connection.send(notification);\n\t\t\t\tdelivered += 1;\n\t\t\t}\n\t\t}\n\t\treturn delivered;\n\t}\n\n\tprivate async dispatchRequest(connection: Connection, request: RpcRequest): Promise<RpcResponse> {\n\t\tif (request.method === \"initialize\") {\n\t\t\treturn this.handleInitialize(connection, request);\n\t\t}\n\t\treturn this.registry.dispatch(connection, request);\n\t}\n\n\tprivate handleInitialize(connection: Connection, request: RpcRequest): RpcResponse {\n\t\tif (connection.initialized) {\n\t\t\treturn { id: request.id, error: alreadyInitializedError() };\n\t\t}\n\n\t\tconst params = parseInitializeParams(request.params);\n\t\tif (!params) {\n\t\t\treturn { id: request.id, error: invalidParamsError() };\n\t\t}\n\n\t\tconst initialized = connection.initialize(params, this.version);\n\t\tswitch (initialized.kind) {\n\t\t\tcase \"initialized\":\n\t\t\t\treturn { id: request.id, result: buildInitializeResponse(connection, this.codexHome) };\n\t\t\tcase \"already-initialized\":\n\t\t\t\treturn { id: request.id, error: alreadyInitializedError() };\n\t\t\tdefault:\n\t\t\t\treturn assertNever(initialized);\n\t\t}\n\t}\n\n\tprivate handleNotification(notification: RpcNotification): void {\n\t\tif (notification.method === \"initialized\") {\n\t\t\treturn;\n\t\t}\n\t}\n}\n\nfunction assertNever(value: never): never {\n\tthrow new Error(`Unhandled app-server envelope kind: ${JSON.stringify(value)}`);\n}\n"]}

package/dist/modes/app-server/threads/archive-state.d.ts

@@ -0,0 +1,10 @@
+import type { WireThread } from "./registry.ts";
+export declare class ThreadArchiveState {
+    private readonly sessionDir;
+    constructor(sessionDir: string | undefined);
+    markArchived(thread: WireThread): Promise<void>;
+    clearArchived(threadId: string): Promise<void>;
+    isArchived(thread: WireThread): Promise<boolean>;
+    listArchivedThreads(): Promise<WireThread[]>;
+}
+//# sourceMappingURL=archive-state.d.ts.map

package/dist/modes/app-server/threads/archive-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-state.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/archive-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAmBhD,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,YAAY,UAAU,EAAE,MAAM,GAAG,SAAS,EAEzC;IAEK,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpD;IAEK,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnD;IAEK,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAWrD;IAEK,mBAAmB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBjD;CACD"}

package/dist/modes/app-server/threads/archive-state.js

@@ -0,0 +1,151 @@
+import { readdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const ARCHIVE_SUFFIX = ".archived";
+class ThreadArchiveStateError extends Error {
+    constructor(path, message) {
+        super(`${message}: ${path}`);
+        this.name = "ThreadArchiveStateError";
+        this.path = path;
+    }
+}
+export class ThreadArchiveState {
+    constructor(sessionDir) {
+        this.sessionDir = sessionDir;
+    }
+    async markArchived(thread) {
+        const sidecarPath = sidecarPathForThread(thread);
+        await writeFile(sidecarPath, `${JSON.stringify({ archivedAt: new Date().toISOString(), thread })}\n`, "utf8");
+    }
+    async clearArchived(threadId) {
+        const threads = await this.listArchivedThreads();
+        await Promise.all(threads
+            .filter((thread) => thread.id === threadId)
+            .map((thread) => rm(sidecarPathForThread(thread), { force: true })));
+    }
+    async isArchived(thread) {
+        const path = sidecarPathForThread(thread);
+        try {
+            await readFile(path, "utf8");
+            return true;
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                return false;
+            }
+            throw readError(path, error);
+        }
+    }
+    async listArchivedThreads() {
+        if (!this.sessionDir) {
+            return [];
+        }
+        let entries;
+        try {
+            entries = await readdir(this.sessionDir);
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                return [];
+            }
+            throw readError(this.sessionDir, error);
+        }
+        const threads = [];
+        for (const entry of entries) {
+            if (!entry.endsWith(ARCHIVE_SUFFIX)) {
+                continue;
+            }
+            const thread = await readArchivedThread(join(this.sessionDir, entry));
+            if (thread) {
+                threads.push(thread);
+            }
+        }
+        return threads;
+    }
+}
+function sidecarPathForThread(thread) {
+    if (!thread.sessionPath) {
+        throw new Error(`Thread ${thread.id} has no session path for archive state`);
+    }
+    return `${thread.sessionPath}${ARCHIVE_SUFFIX}`;
+}
+async function readArchivedThread(path) {
+    let content;
+    try {
+        content = await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (isNotFoundError(error)) {
+            return null;
+        }
+        throw readError(path, error);
+    }
+    return parseArchivedThread(path, content);
+}
+function parseArchivedThread(path, content) {
+    let value;
+    try {
+        value = JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new ThreadArchiveStateError(path, `Invalid archived thread sidecar JSON (${error.message})`);
+        }
+        throw error;
+    }
+    if (!isRecord(value) || !isRecord(value.thread)) {
+        throw new ThreadArchiveStateError(path, "Invalid archived thread sidecar record");
+    }
+    const thread = parseWireThread(value.thread);
+    if (!thread) {
+        throw new ThreadArchiveStateError(path, "Invalid archived thread record");
+    }
+    return thread;
+}
+function parseWireThread(value) {
+    const id = stringField(value.id);
+    const sessionId = stringField(value.sessionId);
+    const cwd = stringField(value.cwd);
+    const createdAt = stringField(value.createdAt);
+    const updatedAt = stringField(value.updatedAt);
+    const status = isRecord(value.status) ? stringField(value.status.type) : null;
+    const sessionPath = stringField(value.sessionPath);
+    if (!id || !sessionId || !cwd || !createdAt || !updatedAt || !status || !sessionPath) {
+        return null;
+    }
+    if (status !== "idle" && status !== "active" && status !== "notLoaded") {
+        return null;
+    }
+    return {
+        id,
+        sessionId,
+        cwd,
+        createdAt,
+        updatedAt,
+        status: { type: status },
+        preview: nullableString(value.preview),
+        name: nullableString(value.name),
+        sessionPath,
+    };
+}
+function stringField(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function nullableString(value) {
+    return typeof value === "string" ? value : null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNotFoundError(error) {
+    return isNodeFsError(error) && error.code === "ENOENT";
+}
+function isNodeFsError(error) {
+    return error instanceof Error && "code" in error;
+}
+function readError(path, error) {
+    if (error instanceof Error) {
+        return new ThreadArchiveStateError(path, `Failed to read archived thread state (${error.message})`);
+    }
+    return new ThreadArchiveStateError(path, `Failed to read archived thread state (${String(error)})`);
+}
+//# sourceMappingURL=archive-state.js.map

package/dist/modes/app-server/threads/archive-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-state.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/archive-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdir, readFile, rm, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { WireThread } from \"./registry.ts\";\n\nconst ARCHIVE_SUFFIX = \".archived\";\n\ntype ArchivedThreadRecord = {\n\treadonly archivedAt: string;\n\treadonly thread: WireThread;\n};\n\nclass ThreadArchiveStateError extends Error {\n\treadonly path: string;\n\n\tconstructor(path: string, message: string) {\n\t\tsuper(`${message}: ${path}`);\n\t\tthis.name = \"ThreadArchiveStateError\";\n\t\tthis.path = path;\n\t}\n}\n\nexport class ThreadArchiveState {\n\tprivate readonly sessionDir: string | undefined;\n\n\tconstructor(sessionDir: string | undefined) {\n\t\tthis.sessionDir = sessionDir;\n\t}\n\n\tasync markArchived(thread: WireThread): Promise<void> {\n\t\tconst sidecarPath = sidecarPathForThread(thread);\n\t\tawait writeFile(\n\t\t\tsidecarPath,\n\t\t\t`${JSON.stringify({ archivedAt: new Date().toISOString(), thread } satisfies ArchivedThreadRecord)}\\n`,\n\t\t\t\"utf8\",\n\t\t);\n\t}\n\n\tasync clearArchived(threadId: string): Promise<void> {\n\t\tconst threads = await this.listArchivedThreads();\n\t\tawait Promise.all(\n\t\t\tthreads\n\t\t\t\t.filter((thread) => thread.id === threadId)\n\t\t\t\t.map((thread) => rm(sidecarPathForThread(thread), { force: true })),\n\t\t);\n\t}\n\n\tasync isArchived(thread: WireThread): Promise<boolean> {\n\t\tconst path = sidecarPathForThread(thread);\n\t\ttry {\n\t\t\tawait readFile(path, \"utf8\");\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tif (isNotFoundError(error)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tthrow readError(path, error);\n\t\t}\n\t}\n\n\tasync listArchivedThreads(): Promise<WireThread[]> {\n\t\tif (!this.sessionDir) {\n\t\t\treturn [];\n\t\t}\n\t\tlet entries: string[];\n\t\ttry {\n\t\t\tentries = await readdir(this.sessionDir);\n\t\t} catch (error) {\n\t\t\tif (isNotFoundError(error)) {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\tthrow readError(this.sessionDir, error);\n\t\t}\n\t\tconst threads: WireThread[] = [];\n\t\tfor (const entry of entries) {\n\t\t\tif (!entry.endsWith(ARCHIVE_SUFFIX)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst thread = await readArchivedThread(join(this.sessionDir, entry));\n\t\t\tif (thread) {\n\t\t\t\tthreads.push(thread);\n\t\t\t}\n\t\t}\n\t\treturn threads;\n\t}\n}\n\nfunction sidecarPathForThread(thread: WireThread): string {\n\tif (!thread.sessionPath) {\n\t\tthrow new Error(`Thread ${thread.id} has no session path for archive state`);\n\t}\n\treturn `${thread.sessionPath}${ARCHIVE_SUFFIX}`;\n}\n\nasync function readArchivedThread(path: string): Promise<WireThread | null> {\n\tlet content: string;\n\ttry {\n\t\tcontent = await readFile(path, \"utf8\");\n\t} catch (error) {\n\t\tif (isNotFoundError(error)) {\n\t\t\treturn null;\n\t\t}\n\t\tthrow readError(path, error);\n\t}\n\treturn parseArchivedThread(path, content);\n}\n\nfunction parseArchivedThread(path: string, content: string): WireThread {\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(content);\n\t} catch (error) {\n\t\tif (error instanceof Error) {\n\t\t\tthrow new ThreadArchiveStateError(path, `Invalid archived thread sidecar JSON (${error.message})`);\n\t\t}\n\t\tthrow error;\n\t}\n\tif (!isRecord(value) || !isRecord(value.thread)) {\n\t\tthrow new ThreadArchiveStateError(path, \"Invalid archived thread sidecar record\");\n\t}\n\tconst thread = parseWireThread(value.thread);\n\tif (!thread) {\n\t\tthrow new ThreadArchiveStateError(path, \"Invalid archived thread record\");\n\t}\n\treturn thread;\n}\n\nfunction parseWireThread(value: Record<string, unknown>): WireThread | null {\n\tconst id = stringField(value.id);\n\tconst sessionId = stringField(value.sessionId);\n\tconst cwd = stringField(value.cwd);\n\tconst createdAt = stringField(value.createdAt);\n\tconst updatedAt = stringField(value.updatedAt);\n\tconst status = isRecord(value.status) ? stringField(value.status.type) : null;\n\tconst sessionPath = stringField(value.sessionPath);\n\tif (!id || !sessionId || !cwd || !createdAt || !updatedAt || !status || !sessionPath) {\n\t\treturn null;\n\t}\n\tif (status !== \"idle\" && status !== \"active\" && status !== \"notLoaded\") {\n\t\treturn null;\n\t}\n\treturn {\n\t\tid,\n\t\tsessionId,\n\t\tcwd,\n\t\tcreatedAt,\n\t\tupdatedAt,\n\t\tstatus: { type: status },\n\t\tpreview: nullableString(value.preview),\n\t\tname: nullableString(value.name),\n\t\tsessionPath,\n\t};\n}\n\nfunction stringField(value: unknown): string | null {\n\treturn typeof value === \"string\" && value.length > 0 ? value : null;\n}\n\nfunction nullableString(value: unknown): string | null {\n\treturn typeof value === \"string\" ? value : null;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n\treturn isNodeFsError(error) && error.code === \"ENOENT\";\n}\n\nfunction isNodeFsError(error: unknown): error is Error & { readonly code?: string } {\n\treturn error instanceof Error && \"code\" in error;\n}\n\nfunction readError(path: string, error: unknown): ThreadArchiveStateError {\n\tif (error instanceof Error) {\n\t\treturn new ThreadArchiveStateError(path, `Failed to read archived thread state (${error.message})`);\n\t}\n\treturn new ThreadArchiveStateError(path, `Failed to read archived thread state (${String(error)})`);\n}\n"]}

package/dist/modes/app-server/threads/handler-params.d.ts

@@ -0,0 +1,13 @@
+import type { RegistryConnection } from "../rpc/registry.ts";
+type JsonObject = {
+    readonly [key: string]: unknown;
+};
+export declare function objectValue(value: unknown): JsonObject;
+export declare function requiredString(value: unknown, name: string): string;
+export declare function optionalString(value: unknown): string | undefined;
+export declare function optionalNumber(value: unknown): number | undefined;
+export declare function connectionId(connection: RegistryConnection): string;
+export declare function encodeCursor(offset: number): string;
+export declare function decodeCursor(cursor: string | null): number;
+export {};
+//# sourceMappingURL=handler-params.d.ts.map

package/dist/modes/app-server/threads/handler-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-params.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/handler-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,KAAK,UAAU,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEtD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAKtD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAMnE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAM1D"}

package/dist/modes/app-server/threads/handler-params.js

@@ -0,0 +1,36 @@
+export function objectValue(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return {};
+    }
+    return Object.assign({}, value);
+}
+export function requiredString(value, name) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`Invalid params: ${name} is required`);
+    }
+    return value;
+}
+export function optionalString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+export function optionalNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+export function connectionId(connection) {
+    const id = Reflect.get(connection, "id");
+    if (typeof id !== "string" || id.length === 0) {
+        throw new Error("Connection id is required for thread lifecycle methods");
+    }
+    return id;
+}
+export function encodeCursor(offset) {
+    return Buffer.from(String(offset), "utf8").toString("base64");
+}
+export function decodeCursor(cursor) {
+    if (!cursor) {
+        return 0;
+    }
+    const parsed = Number.parseInt(Buffer.from(cursor, "base64").toString("utf8"), 10);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
+}
+//# sourceMappingURL=handler-params.js.map

package/dist/modes/app-server/threads/handler-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-params.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/handler-params.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAkC,EAAE,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,IAAY;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,cAAc,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAA8B;IAC1D,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACV,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["import type { RegistryConnection } from \"../rpc/registry.ts\";\n\ntype JsonObject = { readonly [key: string]: unknown };\n\nexport function objectValue(value: unknown): JsonObject {\n\tif (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n\t\treturn {};\n\t}\n\treturn Object.assign<Record<string, unknown>, object>({}, value);\n}\n\nexport function requiredString(value: unknown, name: string): string {\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new Error(`Invalid params: ${name} is required`);\n\t}\n\treturn value;\n}\n\nexport function optionalString(value: unknown): string | undefined {\n\treturn typeof value === \"string\" ? value : undefined;\n}\n\nexport function optionalNumber(value: unknown): number | undefined {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nexport function connectionId(connection: RegistryConnection): string {\n\tconst id = Reflect.get(connection, \"id\");\n\tif (typeof id !== \"string\" || id.length === 0) {\n\t\tthrow new Error(\"Connection id is required for thread lifecycle methods\");\n\t}\n\treturn id;\n}\n\nexport function encodeCursor(offset: number): string {\n\treturn Buffer.from(String(offset), \"utf8\").toString(\"base64\");\n}\n\nexport function decodeCursor(cursor: string | null): number {\n\tif (!cursor) {\n\t\treturn 0;\n\t}\n\tconst parsed = Number.parseInt(Buffer.from(cursor, \"base64\").toString(\"utf8\"), 10);\n\treturn Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;\n}\n"]}

package/dist/modes/app-server/threads/handlers.d.ts

@@ -0,0 +1,19 @@
+import type { MethodRegistry } from "../rpc/registry.ts";
+import type { NotificationRouter } from "../server/notifications.ts";
+import { type ThreadRegistry } from "./registry.ts";
+import type { TurnLog } from "./turn-log.ts";
+export interface ThreadLifecycleHandlersOptions {
+    readonly threads: ThreadRegistry;
+    readonly turnLog: TurnLog;
+    readonly notifications: NotificationRouter;
+    readonly idleUnloadMinutes?: number;
+    readonly replayPendingApprovals?: (threadId: string, connectionId: string) => void;
+}
+export interface ThreadLifecycleController {
+    /** Schedules the idle-unload countdown for a thread whose last subscriber vanished (e.g. socket close). */
+    scheduleIdleUnloadForThread(threadId: string): void;
+    /** Clears every pending idle-unload timer; used during server shutdown. */
+    dispose(): void;
+}
+export declare function registerThreadLifecycleHandlers(registry: MethodRegistry, options: ThreadLifecycleHandlersOptions): ThreadLifecycleController;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/modes/app-server/threads/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/handlers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAkC,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIrE,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACnF;AAUD,MAAM,WAAW,yBAAyB;IACzC,2GAA2G;IAC3G,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,+BAA+B,CAC9C,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,8BAA8B,GACrC,yBAAyB,CAM3B"}