@code-yeongyu/senpi 2026.7.5-2 → 2026.7.9

package/dist/modes/app-server/threads/registry.js

@@ -0,0 +1,186 @@
+import { existsSync, unlinkSync } from "node:fs";
+import { createAgentSession, } from "../../../core/sdk.js";
+import { SessionManager } from "../../../core/session-manager.js";
+import { resolvePath } from "../../../utils/paths.js";
+import { buildDiskThread, compareThreads, decodeCursor, encodeCursor } from "./registry-listing.js";
+export class ThreadNotFoundError extends Error {
+    constructor(threadId) {
+        super(`Thread not found: ${threadId}`);
+        this.name = "ThreadNotFoundError";
+        this.threadId = threadId;
+    }
+}
+export class ThreadRegistry {
+    constructor(options = {}) {
+        this.entries = new Map();
+        this.deletedThreadIds = new Set();
+        this.agentDir = options.agentDir ? resolvePath(options.agentDir) : undefined;
+        this.sessionDir = options.sessionDir ? resolvePath(options.sessionDir) : undefined;
+        this.createSession = options.createSession ?? createAgentSession;
+    }
+    async createThread(options) {
+        const cwd = resolvePath(options.cwd);
+        const sessionManager = SessionManager.create(cwd, this.sessionDir);
+        const { session } = await this.createSession({
+            cwd,
+            agentDir: this.agentDir,
+            sessionManager,
+            model: options.model,
+        });
+        this.deletedThreadIds.delete(session.sessionId);
+        return this.registerSession(session, cwd);
+    }
+    async resumeThread(threadId) {
+        const loaded = this.entries.get(threadId);
+        if (loaded) {
+            return loaded;
+        }
+        if (this.deletedThreadIds.has(threadId)) {
+            throw new ThreadNotFoundError(threadId);
+        }
+        const sessionInfo = await this.findSessionInfo(threadId);
+        if (!sessionInfo) {
+            throw new ThreadNotFoundError(threadId);
+        }
+        const sessionManager = SessionManager.open(sessionInfo.path, this.sessionDir, sessionInfo.cwd || undefined);
+        const { session } = await this.createSession({
+            cwd: sessionManager.getCwd(),
+            agentDir: this.agentDir,
+            sessionManager,
+        });
+        return this.registerSession(session, sessionManager.getCwd(), sessionInfo);
+    }
+    async forkThread(threadId, options = {}) {
+        const source = await this.resumeThread(threadId);
+        const cwd = resolvePath(options.cwd ?? source.cwd);
+        const sourceFile = source.session.sessionFile;
+        const sessionManager = sourceFile && existsSync(sourceFile)
+            ? SessionManager.forkFrom(sourceFile, cwd, this.sessionDir)
+            : SessionManager.create(cwd, this.sessionDir, sourceFile ? { parentSession: sourceFile } : undefined);
+        const { session } = await this.createSession({
+            cwd,
+            agentDir: this.agentDir,
+            sessionManager,
+            model: options.model,
+        });
+        this.deletedThreadIds.delete(session.sessionId);
+        return this.registerSession(session, cwd);
+    }
+    async deleteThread(threadId) {
+        const loaded = this.entries.get(threadId);
+        if (loaded) {
+            loaded.session.dispose();
+            this.entries.delete(threadId);
+            this.deletedThreadIds.add(threadId);
+            const sessionFile = loaded.session.sessionFile;
+            if (sessionFile && existsSync(sessionFile)) {
+                unlinkSync(sessionFile);
+            }
+            return true;
+        }
+        const sessionInfo = await this.findSessionInfo(threadId);
+        if (!sessionInfo) {
+            this.deletedThreadIds.add(threadId);
+            return false;
+        }
+        if (existsSync(sessionInfo.path)) {
+            unlinkSync(sessionInfo.path);
+        }
+        this.deletedThreadIds.add(threadId);
+        return true;
+    }
+    listLoaded() {
+        return [...this.entries.values()].map((entry) => this.buildLoadedThread(entry));
+    }
+    async listThreads(options = {}) {
+        const offset = decodeCursor(options.cursor);
+        const limit = Math.max(0, options.limit ?? 50);
+        const threadsById = new Map();
+        for (const info of await this.listSessionInfos()) {
+            if (!this.deletedThreadIds.has(info.id)) {
+                threadsById.set(info.id, buildDiskThread(info));
+            }
+        }
+        for (const entry of this.entries.values()) {
+            threadsById.set(entry.id, this.buildLoadedThread(entry));
+        }
+        const threads = [...threadsById.values()].sort(compareThreads);
+        const page = threads.slice(offset, offset + limit);
+        const nextOffset = offset + page.length;
+        return {
+            threads: page,
+            nextCursor: nextOffset < threads.length ? encodeCursor(nextOffset) : null,
+        };
+    }
+    runThreadTask(threadId, task) {
+        const entry = this.getLoadedThread(threadId);
+        const run = entry.taskQueue.then(task, task);
+        entry.taskQueue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    getLoadedThread(threadId) {
+        const entry = this.entries.get(threadId);
+        if (!entry) {
+            throw new ThreadNotFoundError(threadId);
+        }
+        return entry;
+    }
+    unloadThread(threadId) {
+        const entry = this.entries.get(threadId);
+        entry?.session.dispose();
+        return this.entries.delete(threadId);
+    }
+    buildThread(entry) {
+        return this.buildLoadedThread(entry);
+    }
+    getSessionDir() {
+        return this.sessionDir;
+    }
+    registerSession(session, cwd, sessionInfo) {
+        const existing = this.entries.get(session.sessionId);
+        if (existing) {
+            if (existing.session !== session) {
+                session.dispose();
+            }
+            return existing;
+        }
+        const now = new Date().toISOString();
+        const entry = {
+            id: session.sessionId,
+            session,
+            cwd,
+            subscribers: new Set(),
+            activeTurn: null,
+            queuedTerminalNotifications: [],
+            status: "idle",
+            taskQueue: Promise.resolve(),
+            createdAt: sessionInfo?.created.toISOString() ?? now,
+            updatedAt: sessionInfo?.modified.toISOString() ?? now,
+        };
+        this.entries.set(entry.id, entry);
+        return entry;
+    }
+    async findSessionInfo(threadId) {
+        return (await this.listSessionInfos()).find((info) => info.id === threadId);
+    }
+    async listSessionInfos() {
+        if (this.sessionDir) {
+            return SessionManager.listAll(this.sessionDir);
+        }
+        return SessionManager.listAll();
+    }
+    buildLoadedThread(entry) {
+        return {
+            id: entry.id,
+            sessionId: entry.session.sessionId,
+            sessionPath: entry.session.sessionFile ?? null,
+            cwd: entry.cwd,
+            createdAt: entry.createdAt,
+            updatedAt: entry.updatedAt,
+            status: { type: entry.status },
+            preview: entry.session.getUserMessagesForForking()[0]?.text ?? null,
+            name: entry.session.sessionName ?? null,
+        };
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/modes/app-server/threads/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, unlinkSync } from \"node:fs\";\nimport type { AgentSession } from \"../../../core/agent-session.ts\";\nimport {\n\ttype CreateAgentSessionOptions,\n\ttype CreateAgentSessionResult,\n\tcreateAgentSession,\n} from \"../../../core/sdk.ts\";\nimport { type SessionInfo, SessionManager } from \"../../../core/session-manager.ts\";\nimport { resolvePath } from \"../../../utils/paths.ts\";\nimport { buildDiskThread, compareThreads, decodeCursor, encodeCursor } from \"./registry-listing.ts\";\n\nexport type ConnectionId = string;\n\nexport interface RpcNotification {\n\tmethod: string;\n\tparams?: unknown;\n}\n\nexport interface ActiveTurn {\n\tturnId: string;\n\tstartedAt: string;\n}\n\nexport type LoadedThreadStatus = \"idle\" | \"active\";\nexport type ThreadStatusType = LoadedThreadStatus | \"notLoaded\";\n\nexport interface WireThread {\n\tid: string;\n\tsessionId: string;\n\tsessionPath: string | null;\n\tcwd: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tstatus: { type: ThreadStatusType };\n\tpreview: string | null;\n\tname: string | null;\n}\n\nexport interface ThreadEntry {\n\tid: string;\n\tsession: AgentSession;\n\tcwd: string;\n\tsubscribers: Set<ConnectionId>;\n\tactiveTurn: ActiveTurn | null;\n\tqueuedTerminalNotifications: RpcNotification[];\n\tstatus: LoadedThreadStatus;\n\ttaskQueue: Promise<void>;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\nexport interface CreateThreadOptions {\n\tcwd: string;\n\tmodel?: CreateAgentSessionOptions[\"model\"];\n}\n\nexport interface ListThreadsOptions {\n\tcursor?: string | null;\n\tlimit?: number;\n}\n\nexport interface ListThreadsResult {\n\tthreads: WireThread[];\n\tnextCursor: string | null;\n}\n\nexport interface ThreadRegistryOptions {\n\tagentDir?: string;\n\tsessionDir?: string;\n\tcreateSession?: (options: CreateAgentSessionOptions) => Promise<CreateAgentSessionResult>;\n}\n\nexport class ThreadNotFoundError extends Error {\n\treadonly threadId: string;\n\n\tconstructor(threadId: string) {\n\t\tsuper(`Thread not found: ${threadId}`);\n\t\tthis.name = \"ThreadNotFoundError\";\n\t\tthis.threadId = threadId;\n\t}\n}\n\nexport class ThreadRegistry {\n\tprivate readonly entries = new Map<string, ThreadEntry>();\n\tprivate readonly deletedThreadIds = new Set<string>();\n\tprivate readonly agentDir: string | undefined;\n\tprivate readonly sessionDir: string | undefined;\n\tprivate readonly createSession: (options: CreateAgentSessionOptions) => Promise<CreateAgentSessionResult>;\n\n\tconstructor(options: ThreadRegistryOptions = {}) {\n\t\tthis.agentDir = options.agentDir ? resolvePath(options.agentDir) : undefined;\n\t\tthis.sessionDir = options.sessionDir ? resolvePath(options.sessionDir) : undefined;\n\t\tthis.createSession = options.createSession ?? createAgentSession;\n\t}\n\n\tasync createThread(options: CreateThreadOptions): Promise<ThreadEntry> {\n\t\tconst cwd = resolvePath(options.cwd);\n\t\tconst sessionManager = SessionManager.create(cwd, this.sessionDir);\n\t\tconst { session } = await this.createSession({\n\t\t\tcwd,\n\t\t\tagentDir: this.agentDir,\n\t\t\tsessionManager,\n\t\t\tmodel: options.model,\n\t\t});\n\t\tthis.deletedThreadIds.delete(session.sessionId);\n\t\treturn this.registerSession(session, cwd);\n\t}\n\n\tasync resumeThread(threadId: string): Promise<ThreadEntry> {\n\t\tconst loaded = this.entries.get(threadId);\n\t\tif (loaded) {\n\t\t\treturn loaded;\n\t\t}\n\t\tif (this.deletedThreadIds.has(threadId)) {\n\t\t\tthrow new ThreadNotFoundError(threadId);\n\t\t}\n\n\t\tconst sessionInfo = await this.findSessionInfo(threadId);\n\t\tif (!sessionInfo) {\n\t\t\tthrow new ThreadNotFoundError(threadId);\n\t\t}\n\n\t\tconst sessionManager = SessionManager.open(sessionInfo.path, this.sessionDir, sessionInfo.cwd || undefined);\n\t\tconst { session } = await this.createSession({\n\t\t\tcwd: sessionManager.getCwd(),\n\t\t\tagentDir: this.agentDir,\n\t\t\tsessionManager,\n\t\t});\n\t\treturn this.registerSession(session, sessionManager.getCwd(), sessionInfo);\n\t}\n\n\tasync forkThread(threadId: string, options: Partial<CreateThreadOptions> = {}): Promise<ThreadEntry> {\n\t\tconst source = await this.resumeThread(threadId);\n\t\tconst cwd = resolvePath(options.cwd ?? source.cwd);\n\t\tconst sourceFile = source.session.sessionFile;\n\t\tconst sessionManager =\n\t\t\tsourceFile && existsSync(sourceFile)\n\t\t\t\t? SessionManager.forkFrom(sourceFile, cwd, this.sessionDir)\n\t\t\t\t: SessionManager.create(cwd, this.sessionDir, sourceFile ? { parentSession: sourceFile } : undefined);\n\t\tconst { session } = await this.createSession({\n\t\t\tcwd,\n\t\t\tagentDir: this.agentDir,\n\t\t\tsessionManager,\n\t\t\tmodel: options.model,\n\t\t});\n\t\tthis.deletedThreadIds.delete(session.sessionId);\n\t\treturn this.registerSession(session, cwd);\n\t}\n\n\tasync deleteThread(threadId: string): Promise<boolean> {\n\t\tconst loaded = this.entries.get(threadId);\n\t\tif (loaded) {\n\t\t\tloaded.session.dispose();\n\t\t\tthis.entries.delete(threadId);\n\t\t\tthis.deletedThreadIds.add(threadId);\n\t\t\tconst sessionFile = loaded.session.sessionFile;\n\t\t\tif (sessionFile && existsSync(sessionFile)) {\n\t\t\t\tunlinkSync(sessionFile);\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\n\t\tconst sessionInfo = await this.findSessionInfo(threadId);\n\t\tif (!sessionInfo) {\n\t\t\tthis.deletedThreadIds.add(threadId);\n\t\t\treturn false;\n\t\t}\n\t\tif (existsSync(sessionInfo.path)) {\n\t\t\tunlinkSync(sessionInfo.path);\n\t\t}\n\t\tthis.deletedThreadIds.add(threadId);\n\t\treturn true;\n\t}\n\n\tlistLoaded(): WireThread[] {\n\t\treturn [...this.entries.values()].map((entry) => this.buildLoadedThread(entry));\n\t}\n\n\tasync listThreads(options: ListThreadsOptions = {}): Promise<ListThreadsResult> {\n\t\tconst offset = decodeCursor(options.cursor);\n\t\tconst limit = Math.max(0, options.limit ?? 50);\n\t\tconst threadsById = new Map<string, WireThread>();\n\n\t\tfor (const info of await this.listSessionInfos()) {\n\t\t\tif (!this.deletedThreadIds.has(info.id)) {\n\t\t\t\tthreadsById.set(info.id, buildDiskThread(info));\n\t\t\t}\n\t\t}\n\t\tfor (const entry of this.entries.values()) {\n\t\t\tthreadsById.set(entry.id, this.buildLoadedThread(entry));\n\t\t}\n\n\t\tconst threads = [...threadsById.values()].sort(compareThreads);\n\t\tconst page = threads.slice(offset, offset + limit);\n\t\tconst nextOffset = offset + page.length;\n\t\treturn {\n\t\t\tthreads: page,\n\t\t\tnextCursor: nextOffset < threads.length ? encodeCursor(nextOffset) : null,\n\t\t};\n\t}\n\n\trunThreadTask<T>(threadId: string, task: () => Promise<T> | T): Promise<T> {\n\t\tconst entry = this.getLoadedThread(threadId);\n\t\tconst run = entry.taskQueue.then(task, task);\n\t\tentry.taskQueue = run.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined,\n\t\t);\n\t\treturn run;\n\t}\n\n\tgetLoadedThread(threadId: string): ThreadEntry {\n\t\tconst entry = this.entries.get(threadId);\n\t\tif (!entry) {\n\t\t\tthrow new ThreadNotFoundError(threadId);\n\t\t}\n\t\treturn entry;\n\t}\n\n\tunloadThread(threadId: string): boolean {\n\t\tconst entry = this.entries.get(threadId);\n\t\tentry?.session.dispose();\n\t\treturn this.entries.delete(threadId);\n\t}\n\n\tbuildThread(entry: ThreadEntry): WireThread {\n\t\treturn this.buildLoadedThread(entry);\n\t}\n\n\tgetSessionDir(): string | undefined {\n\t\treturn this.sessionDir;\n\t}\n\n\tprivate registerSession(session: AgentSession, cwd: string, sessionInfo?: SessionInfo): ThreadEntry {\n\t\tconst existing = this.entries.get(session.sessionId);\n\t\tif (existing) {\n\t\t\tif (existing.session !== session) {\n\t\t\t\tsession.dispose();\n\t\t\t}\n\t\t\treturn existing;\n\t\t}\n\n\t\tconst now = new Date().toISOString();\n\t\tconst entry: ThreadEntry = {\n\t\t\tid: session.sessionId,\n\t\t\tsession,\n\t\t\tcwd,\n\t\t\tsubscribers: new Set<ConnectionId>(),\n\t\t\tactiveTurn: null,\n\t\t\tqueuedTerminalNotifications: [],\n\t\t\tstatus: \"idle\",\n\t\t\ttaskQueue: Promise.resolve(),\n\t\t\tcreatedAt: sessionInfo?.created.toISOString() ?? now,\n\t\t\tupdatedAt: sessionInfo?.modified.toISOString() ?? now,\n\t\t};\n\t\tthis.entries.set(entry.id, entry);\n\t\treturn entry;\n\t}\n\n\tprivate async findSessionInfo(threadId: string): Promise<SessionInfo | undefined> {\n\t\treturn (await this.listSessionInfos()).find((info) => info.id === threadId);\n\t}\n\n\tprivate async listSessionInfos(): Promise<SessionInfo[]> {\n\t\tif (this.sessionDir) {\n\t\t\treturn SessionManager.listAll(this.sessionDir);\n\t\t}\n\t\treturn SessionManager.listAll();\n\t}\n\n\tprivate buildLoadedThread(entry: ThreadEntry): WireThread {\n\t\treturn {\n\t\t\tid: entry.id,\n\t\t\tsessionId: entry.session.sessionId,\n\t\t\tsessionPath: entry.session.sessionFile ?? null,\n\t\t\tcwd: entry.cwd,\n\t\t\tcreatedAt: entry.createdAt,\n\t\t\tupdatedAt: entry.updatedAt,\n\t\t\tstatus: { type: entry.status },\n\t\t\tpreview: entry.session.getUserMessagesForForking()[0]?.text ?? null,\n\t\t\tname: entry.session.sessionName ?? null,\n\t\t};\n\t}\n}\n"]}

package/dist/modes/app-server/threads/start-options.d.ts

@@ -0,0 +1,5 @@
+import { type Api, type Model } from "@earendil-works/pi-ai/compat";
+import type { AskForApproval } from "../protocol/generated/v2/index.ts";
+export declare function requestedStartModel(params: Record<string, unknown>): Model<Api> | undefined;
+export declare function requestedApprovalPolicy(params: Record<string, unknown>): AskForApproval;
+//# sourceMappingURL=start-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-options.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/start-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAA2B,KAAK,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAOxE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAU3F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAWvF"}

package/dist/modes/app-server/threads/start-options.js

@@ -0,0 +1,55 @@
+import { getModels, getProviders } from "@earendil-works/pi-ai/compat";
+import { objectValue, optionalString } from "./handler-params.js";
+const DEFAULT_APPROVAL_POLICY = "never";
+export function requestedStartModel(params) {
+    const model = optionalString(params.model);
+    if (!model) {
+        return undefined;
+    }
+    const parsed = parseModelReference(model, optionalString(params.modelProvider));
+    if (!parsed) {
+        return undefined;
+    }
+    return findBuiltinModel(parsed.provider, parsed.modelId);
+}
+export function requestedApprovalPolicy(params) {
+    const value = params.approvalPolicy;
+    switch (value) {
+        case "untrusted":
+        case "on-failure":
+        case "on-request":
+        case "never":
+            return value;
+        default:
+            return isGranularApproval(value) ? value : DEFAULT_APPROVAL_POLICY;
+    }
+}
+function parseModelReference(model, modelProvider) {
+    if (modelProvider) {
+        const prefix = `${modelProvider}/`;
+        return { provider: modelProvider, modelId: model.startsWith(prefix) ? model.slice(prefix.length) : model };
+    }
+    const separator = model.indexOf("/");
+    if (separator <= 0 || separator >= model.length - 1) {
+        return undefined;
+    }
+    return { provider: model.slice(0, separator), modelId: model.slice(separator + 1) };
+}
+function isGranularApproval(value) {
+    const granular = objectValue(value).granular;
+    const object = objectValue(granular);
+    return (typeof object.sandbox_approval === "boolean" &&
+        typeof object.rules === "boolean" &&
+        typeof object.skill_approval === "boolean" &&
+        typeof object.request_permissions === "boolean" &&
+        typeof object.mcp_elicitations === "boolean");
+}
+function findBuiltinModel(provider, modelId) {
+    for (const builtinProvider of getProviders()) {
+        if (builtinProvider === provider) {
+            return getModels(builtinProvider).find((model) => model.id === modelId);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=start-options.js.map

package/dist/modes/app-server/threads/start-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-options.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/start-options.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Api, getModels, getProviders, type Model } from \"@earendil-works/pi-ai/compat\";\nimport type { AskForApproval } from \"../protocol/generated/v2/index.ts\";\nimport { objectValue, optionalString } from \"./handler-params.ts\";\n\nconst DEFAULT_APPROVAL_POLICY: AskForApproval = \"never\";\n\ntype GranularApproval = Extract<AskForApproval, { readonly granular: unknown }>;\n\nexport function requestedStartModel(params: Record<string, unknown>): Model<Api> | undefined {\n\tconst model = optionalString(params.model);\n\tif (!model) {\n\t\treturn undefined;\n\t}\n\tconst parsed = parseModelReference(model, optionalString(params.modelProvider));\n\tif (!parsed) {\n\t\treturn undefined;\n\t}\n\treturn findBuiltinModel(parsed.provider, parsed.modelId);\n}\n\nexport function requestedApprovalPolicy(params: Record<string, unknown>): AskForApproval {\n\tconst value = params.approvalPolicy;\n\tswitch (value) {\n\t\tcase \"untrusted\":\n\t\tcase \"on-failure\":\n\t\tcase \"on-request\":\n\t\tcase \"never\":\n\t\t\treturn value;\n\t\tdefault:\n\t\t\treturn isGranularApproval(value) ? value : DEFAULT_APPROVAL_POLICY;\n\t}\n}\n\nfunction parseModelReference(\n\tmodel: string,\n\tmodelProvider: string | undefined,\n): { readonly provider: string; readonly modelId: string } | undefined {\n\tif (modelProvider) {\n\t\tconst prefix = `${modelProvider}/`;\n\t\treturn { provider: modelProvider, modelId: model.startsWith(prefix) ? model.slice(prefix.length) : model };\n\t}\n\tconst separator = model.indexOf(\"/\");\n\tif (separator <= 0 || separator >= model.length - 1) {\n\t\treturn undefined;\n\t}\n\treturn { provider: model.slice(0, separator), modelId: model.slice(separator + 1) };\n}\n\nfunction isGranularApproval(value: unknown): value is GranularApproval {\n\tconst granular = objectValue(value).granular;\n\tconst object = objectValue(granular);\n\treturn (\n\t\ttypeof object.sandbox_approval === \"boolean\" &&\n\t\ttypeof object.rules === \"boolean\" &&\n\t\ttypeof object.skill_approval === \"boolean\" &&\n\t\ttypeof object.request_permissions === \"boolean\" &&\n\t\ttypeof object.mcp_elicitations === \"boolean\"\n\t);\n}\n\nfunction findBuiltinModel(provider: string, modelId: string): Model<Api> | undefined {\n\tfor (const builtinProvider of getProviders()) {\n\t\tif (builtinProvider === provider) {\n\t\t\treturn getModels(builtinProvider).find((model) => model.id === modelId);\n\t\t}\n\t}\n\treturn undefined;\n}\n"]}

package/dist/modes/app-server/threads/turn-log.d.ts

@@ -0,0 +1,22 @@
+export type TurnStatus = "running" | "completed" | "failed" | "interrupted";
+export type WireItem = Record<string, unknown>;
+export interface LoggedTurn {
+    turnId: string;
+    startedAt: string;
+    status: TurnStatus;
+    items: WireItem[];
+}
+export interface RecordTurnOptions {
+    turnId: string;
+    startedAt: string;
+    status?: TurnStatus;
+}
+export declare class TurnLog {
+    private readonly turnsByThreadId;
+    recordTurn(threadId: string, turn: RecordTurnOptions): LoggedTurn;
+    appendItem(threadId: string, turnId: string, item: WireItem): void;
+    completeTurn(threadId: string, turnId: string, status: Exclude<TurnStatus, "running">): void;
+    readTurns(threadId: string): LoggedTurn[];
+    private getThreadTurns;
+}
+//# sourceMappingURL=turn-log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turn-log.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/turn-log.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE5E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IAEnE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAUhE;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAMjE;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,IAAI,CAM3F;IAED,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAExC;IAED,OAAO,CAAC,cAAc;CAQtB"}

package/dist/modes/app-server/threads/turn-log.js

@@ -0,0 +1,53 @@
+export class TurnLog {
+    constructor() {
+        this.turnsByThreadId = new Map();
+    }
+    recordTurn(threadId, turn) {
+        const turns = this.getThreadTurns(threadId);
+        const loggedTurn = {
+            turnId: turn.turnId,
+            startedAt: turn.startedAt,
+            status: turn.status ?? "running",
+            items: [],
+        };
+        turns.push(loggedTurn);
+        return cloneTurn(loggedTurn);
+    }
+    appendItem(threadId, turnId, item) {
+        const turn = this.getThreadTurns(threadId).find((candidate) => candidate.turnId === turnId);
+        if (!turn) {
+            throw new Error(`Turn not found: ${turnId}`);
+        }
+        turn.items.push(cloneWireItem(item));
+    }
+    completeTurn(threadId, turnId, status) {
+        const turn = this.getThreadTurns(threadId).find((candidate) => candidate.turnId === turnId);
+        if (!turn) {
+            throw new Error(`Turn not found: ${turnId}`);
+        }
+        turn.status = status;
+    }
+    readTurns(threadId) {
+        return this.getThreadTurns(threadId).map(cloneTurn);
+    }
+    getThreadTurns(threadId) {
+        let turns = this.turnsByThreadId.get(threadId);
+        if (!turns) {
+            turns = [];
+            this.turnsByThreadId.set(threadId, turns);
+        }
+        return turns;
+    }
+}
+function cloneTurn(turn) {
+    return {
+        turnId: turn.turnId,
+        startedAt: turn.startedAt,
+        status: turn.status,
+        items: turn.items.map(cloneWireItem),
+    };
+}
+function cloneWireItem(item) {
+    return { ...item };
+}
+//# sourceMappingURL=turn-log.js.map

package/dist/modes/app-server/threads/turn-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-log.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/turn-log.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,OAAO;IAApB;QACkB,oBAAe,GAAG,IAAI,GAAG,EAAwB,CAAC;IA0CpE,CAAC;IAxCA,UAAU,CAAC,QAAgB,EAAE,IAAuB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAe;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;YAChC,KAAK,EAAE,EAAE;SACT,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU,CAAC,QAAgB,EAAE,MAAc,EAAE,IAAc;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,MAAc,EAAE,MAAsC;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAEO,cAAc,CAAC,QAAgB;QACtC,IAAI,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,KAAK,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD;AAED,SAAS,SAAS,CAAC,IAAgB;IAClC,OAAO;QACN,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;KACpC,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAc;IACpC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;AACpB,CAAC","sourcesContent":["export type TurnStatus = \"running\" | \"completed\" | \"failed\" | \"interrupted\";\n\nexport type WireItem = Record<string, unknown>;\n\nexport interface LoggedTurn {\n\tturnId: string;\n\tstartedAt: string;\n\tstatus: TurnStatus;\n\titems: WireItem[];\n}\n\nexport interface RecordTurnOptions {\n\tturnId: string;\n\tstartedAt: string;\n\tstatus?: TurnStatus;\n}\n\nexport class TurnLog {\n\tprivate readonly turnsByThreadId = new Map<string, LoggedTurn[]>();\n\n\trecordTurn(threadId: string, turn: RecordTurnOptions): LoggedTurn {\n\t\tconst turns = this.getThreadTurns(threadId);\n\t\tconst loggedTurn: LoggedTurn = {\n\t\t\tturnId: turn.turnId,\n\t\t\tstartedAt: turn.startedAt,\n\t\t\tstatus: turn.status ?? \"running\",\n\t\t\titems: [],\n\t\t};\n\t\tturns.push(loggedTurn);\n\t\treturn cloneTurn(loggedTurn);\n\t}\n\n\tappendItem(threadId: string, turnId: string, item: WireItem): void {\n\t\tconst turn = this.getThreadTurns(threadId).find((candidate) => candidate.turnId === turnId);\n\t\tif (!turn) {\n\t\t\tthrow new Error(`Turn not found: ${turnId}`);\n\t\t}\n\t\tturn.items.push(cloneWireItem(item));\n\t}\n\n\tcompleteTurn(threadId: string, turnId: string, status: Exclude<TurnStatus, \"running\">): void {\n\t\tconst turn = this.getThreadTurns(threadId).find((candidate) => candidate.turnId === turnId);\n\t\tif (!turn) {\n\t\t\tthrow new Error(`Turn not found: ${turnId}`);\n\t\t}\n\t\tturn.status = status;\n\t}\n\n\treadTurns(threadId: string): LoggedTurn[] {\n\t\treturn this.getThreadTurns(threadId).map(cloneTurn);\n\t}\n\n\tprivate getThreadTurns(threadId: string): LoggedTurn[] {\n\t\tlet turns = this.turnsByThreadId.get(threadId);\n\t\tif (!turns) {\n\t\t\tturns = [];\n\t\t\tthis.turnsByThreadId.set(threadId, turns);\n\t\t}\n\t\treturn turns;\n\t}\n}\n\nfunction cloneTurn(turn: LoggedTurn): LoggedTurn {\n\treturn {\n\t\tturnId: turn.turnId,\n\t\tstartedAt: turn.startedAt,\n\t\tstatus: turn.status,\n\t\titems: turn.items.map(cloneWireItem),\n\t};\n}\n\nfunction cloneWireItem(item: WireItem): WireItem {\n\treturn { ...item };\n}\n"]}

package/dist/modes/app-server/threads/turn-runtime.d.ts

@@ -0,0 +1,73 @@
+import type { JsonValue, ThreadId, Turn, TurnInterruptParams, TurnInterruptResponse, TurnStartParams, TurnStartResponse, TurnSteerParams, TurnSteerResponse, UserInput } from "../protocol/index.ts";
+import { type JsonRpcError, RpcHandlerError } from "../rpc/errors.ts";
+import type { ActiveTurn } from "./registry.ts";
+import type { TurnLog, WireItem } from "./turn-log.ts";
+export type TurnWireStatus = "inProgress" | "completed" | "failed" | "interrupted";
+export type LoggedStartStatus = "running";
+export type TurnEngineSessionEvent = {
+    readonly type: string;
+};
+export interface TurnEngineSession {
+    prompt(text: string, options?: {
+        readonly source?: "rpc";
+        readonly preflightResult?: (success: boolean) => void;
+    }): Promise<void>;
+    steer(text: string): Promise<void>;
+    abort(): Promise<void>;
+    subscribe(listener: (event: TurnEngineSessionEvent) => void): () => void;
+}
+export type TurnEngineThreadStatus = "idle" | "active";
+export interface TurnEngineThreadEntry {
+    readonly id: string;
+    readonly session: TurnEngineSession;
+    readonly cwd?: string;
+    activeTurn: ActiveTurn | null;
+    status: TurnEngineThreadStatus;
+    updatedAt: string;
+}
+export interface TurnEngineStore<Entry extends TurnEngineThreadEntry = TurnEngineThreadEntry> {
+    getLoadedThread(threadId: string): Entry;
+    runThreadTask<T>(threadId: string, task: () => Promise<T> | T): Promise<T>;
+}
+export interface TurnEngineNotification {
+    readonly method: string;
+    readonly params?: JsonValue;
+}
+export interface TurnEngineOptions<Entry extends TurnEngineThreadEntry = TurnEngineThreadEntry> {
+    readonly store: TurnEngineStore<Entry>;
+    readonly turnLog: TurnLog;
+    readonly emitToThread: (threadId: string, notification: TurnEngineNotification) => void;
+    readonly broadcast: (notification: TurnEngineNotification) => void;
+}
+export type TurnEngineApi = {
+    readonly startTurn: (params: TurnStartParams) => Promise<TurnStartResponse>;
+    readonly steerTurn: (params: TurnSteerParams) => Promise<TurnSteerResponse>;
+    readonly interruptTurn: (params: TurnInterruptParams) => Promise<TurnInterruptResponse>;
+    readonly completeTurn: (threadId: ThreadId, status?: Exclude<TurnWireStatus, "inProgress">, message?: string) => void;
+};
+export type ParsedInput = {
+    readonly text: string;
+    readonly content: readonly UserInput[];
+};
+export type PendingTurn = {
+    readonly turnId: string;
+    readonly startedAt: string;
+    readonly startedAtMs: number;
+    readonly resolve: () => void;
+    interrupted: boolean;
+    completed: boolean;
+};
+export declare function createTurnId(): string;
+export declare class TurnEngineError extends RpcHandlerError {
+    readonly error: JsonRpcError;
+    constructor(error: JsonRpcError);
+}
+export declare function parseInput(input: readonly UserInput[]): ParsedInput;
+export declare function buildTurn(turnId: string, status: TurnWireStatus, startedAtMs: number, completedAtMs: number | null, items: readonly JsonValue[], message?: string): Turn;
+export declare function buildUserMessage(clientUserMessageId: string | null, content: readonly UserInput[]): WireItem;
+export declare function wireItemToJson(item: WireItem): JsonValue;
+export declare function readLoggedItems(turnLog: TurnLog, threadId: ThreadId, turnId: string): readonly JsonValue[];
+export declare function invalidRequest(message: string): TurnEngineError;
+export declare function invalidParams(message: string): TurnEngineError;
+export declare function toTurnEngineError(error: unknown): TurnEngineError;
+//# sourceMappingURL=turn-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turn-runtime.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/turn-runtime.ts"],"names":[],"mappings":"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"}

package/dist/modes/app-server/threads/turn-runtime.js

@@ -0,0 +1,115 @@
+import * as crypto from "node:crypto";
+import { RpcHandlerError } from "../rpc/errors.js";
+export function createTurnId() {
+    return crypto.randomUUID();
+}
+export class TurnEngineError extends RpcHandlerError {
+    constructor(error) {
+        super(error);
+        this.name = "TurnEngineError";
+        this.error = error;
+    }
+}
+export function parseInput(input) {
+    if (input.length === 0) {
+        throw invalidParams("Invalid params: input must include at least one text item");
+    }
+    const content = [];
+    const textParts = [];
+    for (const item of input) {
+        switch (item.type) {
+            case "text": {
+                if (item.text.trim().length === 0) {
+                    throw invalidParams("Invalid params: text input must not be empty");
+                }
+                const textItem = {
+                    type: "text",
+                    text: item.text,
+                    text_elements: item.text_elements ?? [],
+                };
+                content.push(textItem);
+                textParts.push(item.text);
+                break;
+            }
+            case "image":
+            case "localImage":
+            case "skill":
+            case "mention":
+                throw invalidParams(`Invalid params: unsupported input item type ${item.type}`);
+            default:
+                throw invalidParams("Invalid params: unknown input item type");
+        }
+    }
+    if (textParts.length === 0) {
+        throw invalidParams("Invalid params: text input is required");
+    }
+    return { text: textParts.join("\n"), content };
+}
+export function buildTurn(turnId, status, startedAtMs, completedAtMs, items, message) {
+    return {
+        id: turnId,
+        items,
+        itemsView: "full",
+        status,
+        error: status === "failed"
+            ? {
+                message: message ?? "Turn failed",
+                codexErrorInfo: "other",
+                additionalDetails: null,
+            }
+            : null,
+        startedAt: startedAtMs / 1000,
+        completedAt: completedAtMs === null ? null : completedAtMs / 1000,
+        durationMs: completedAtMs === null ? null : completedAtMs - startedAtMs,
+    };
+}
+export function buildUserMessage(clientUserMessageId, content) {
+    return {
+        type: "userMessage",
+        id: clientUserMessageId ?? crypto.randomUUID(),
+        clientId: clientUserMessageId,
+        content: [...content],
+    };
+}
+export function wireItemToJson(item) {
+    const jsonItem = {};
+    for (const [key, value] of Object.entries(item)) {
+        jsonItem[key] = unknownToJsonValue(value);
+    }
+    return jsonItem;
+}
+export function readLoggedItems(turnLog, threadId, turnId) {
+    return (turnLog
+        .readTurns(threadId)
+        .find((turn) => turn.turnId === turnId)
+        ?.items.map((item) => wireItemToJson(item)) ?? []);
+}
+export function invalidRequest(message) {
+    return new TurnEngineError({ code: -32600, message });
+}
+export function invalidParams(message) {
+    return new TurnEngineError({ code: -32602, message });
+}
+export function toTurnEngineError(error) {
+    if (error instanceof TurnEngineError) {
+        return error;
+    }
+    return new TurnEngineError({ code: -32603, message: error instanceof Error ? error.message : String(error) });
+}
+function unknownToJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(unknownToJsonValue);
+    }
+    if (typeof value === "object") {
+        const objectValue = {};
+        for (const [key, child] of Object.entries(value)) {
+            objectValue[key] = unknownToJsonValue(child);
+        }
+        return objectValue;
+    }
+    return null;
+}
+//# sourceMappingURL=turn-runtime.js.map

package/dist/modes/app-server/threads/turn-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-runtime.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/turn-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import * as crypto from \"node:crypto\";\nimport type {\n\tJsonValue,\n\tThreadId,\n\tTurn,\n\tTurnInterruptParams,\n\tTurnInterruptResponse,\n\tTurnStartParams,\n\tTurnStartResponse,\n\tTurnSteerParams,\n\tTurnSteerResponse,\n\tUserInput,\n} from \"../protocol/index.ts\";\nimport { type JsonRpcError, RpcHandlerError } from \"../rpc/errors.ts\";\nimport type { ActiveTurn } from \"./registry.ts\";\nimport type { TurnLog, WireItem } from \"./turn-log.ts\";\n\nexport type TurnWireStatus = \"inProgress\" | \"completed\" | \"failed\" | \"interrupted\";\nexport type LoggedStartStatus = \"running\";\nexport type TurnEngineSessionEvent = { readonly type: string };\n\nexport interface TurnEngineSession {\n\tprompt(\n\t\ttext: string,\n\t\toptions?: { readonly source?: \"rpc\"; readonly preflightResult?: (success: boolean) => void },\n\t): Promise<void>;\n\tsteer(text: string): Promise<void>;\n\tabort(): Promise<void>;\n\tsubscribe(listener: (event: TurnEngineSessionEvent) => void): () => void;\n}\n\nexport type TurnEngineThreadStatus = \"idle\" | \"active\";\n\nexport interface TurnEngineThreadEntry {\n\treadonly id: string;\n\treadonly session: TurnEngineSession;\n\treadonly cwd?: string;\n\tactiveTurn: ActiveTurn | null;\n\tstatus: TurnEngineThreadStatus;\n\tupdatedAt: string;\n}\n\nexport interface TurnEngineStore<Entry extends TurnEngineThreadEntry = TurnEngineThreadEntry> {\n\tgetLoadedThread(threadId: string): Entry;\n\trunThreadTask<T>(threadId: string, task: () => Promise<T> | T): Promise<T>;\n}\n\nexport interface TurnEngineNotification {\n\treadonly method: string;\n\treadonly params?: JsonValue;\n}\n\nexport interface TurnEngineOptions<Entry extends TurnEngineThreadEntry = TurnEngineThreadEntry> {\n\treadonly store: TurnEngineStore<Entry>;\n\treadonly turnLog: TurnLog;\n\treadonly emitToThread: (threadId: string, notification: TurnEngineNotification) => void;\n\treadonly broadcast: (notification: TurnEngineNotification) => void;\n}\n\nexport type TurnEngineApi = {\n\treadonly startTurn: (params: TurnStartParams) => Promise<TurnStartResponse>;\n\treadonly steerTurn: (params: TurnSteerParams) => Promise<TurnSteerResponse>;\n\treadonly interruptTurn: (params: TurnInterruptParams) => Promise<TurnInterruptResponse>;\n\treadonly completeTurn: (\n\t\tthreadId: ThreadId,\n\t\tstatus?: Exclude<TurnWireStatus, \"inProgress\">,\n\t\tmessage?: string,\n\t) => void;\n};\n\nexport type ParsedInput = {\n\treadonly text: string;\n\treadonly content: readonly UserInput[];\n};\n\nexport type PendingTurn = {\n\treadonly turnId: string;\n\treadonly startedAt: string;\n\treadonly startedAtMs: number;\n\treadonly resolve: () => void;\n\tinterrupted: boolean;\n\tcompleted: boolean;\n};\n\nexport function createTurnId(): string {\n\treturn crypto.randomUUID();\n}\n\nexport class TurnEngineError extends RpcHandlerError {\n\treadonly error: JsonRpcError;\n\n\tconstructor(error: JsonRpcError) {\n\t\tsuper(error);\n\t\tthis.name = \"TurnEngineError\";\n\t\tthis.error = error;\n\t}\n}\n\nexport function parseInput(input: readonly UserInput[]): ParsedInput {\n\tif (input.length === 0) {\n\t\tthrow invalidParams(\"Invalid params: input must include at least one text item\");\n\t}\n\n\tconst content: UserInput[] = [];\n\tconst textParts: string[] = [];\n\tfor (const item of input) {\n\t\tswitch (item.type) {\n\t\t\tcase \"text\": {\n\t\t\t\tif (item.text.trim().length === 0) {\n\t\t\t\t\tthrow invalidParams(\"Invalid params: text input must not be empty\");\n\t\t\t\t}\n\t\t\t\tconst textItem = {\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: item.text,\n\t\t\t\t\ttext_elements: item.text_elements ?? [],\n\t\t\t\t} satisfies UserInput;\n\t\t\t\tcontent.push(textItem);\n\t\t\t\ttextParts.push(item.text);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"image\":\n\t\t\tcase \"localImage\":\n\t\t\tcase \"skill\":\n\t\t\tcase \"mention\":\n\t\t\t\tthrow invalidParams(`Invalid params: unsupported input item type ${item.type}`);\n\t\t\tdefault:\n\t\t\t\tthrow invalidParams(\"Invalid params: unknown input item type\");\n\t\t}\n\t}\n\n\tif (textParts.length === 0) {\n\t\tthrow invalidParams(\"Invalid params: text input is required\");\n\t}\n\treturn { text: textParts.join(\"\\n\"), content };\n}\n\nexport function buildTurn(\n\tturnId: string,\n\tstatus: TurnWireStatus,\n\tstartedAtMs: number,\n\tcompletedAtMs: number | null,\n\titems: readonly JsonValue[],\n\tmessage?: string,\n): Turn {\n\treturn {\n\t\tid: turnId,\n\t\titems,\n\t\titemsView: \"full\",\n\t\tstatus,\n\t\terror:\n\t\t\tstatus === \"failed\"\n\t\t\t\t? {\n\t\t\t\t\t\tmessage: message ?? \"Turn failed\",\n\t\t\t\t\t\tcodexErrorInfo: \"other\",\n\t\t\t\t\t\tadditionalDetails: null,\n\t\t\t\t\t}\n\t\t\t\t: null,\n\t\tstartedAt: startedAtMs / 1000,\n\t\tcompletedAt: completedAtMs === null ? null : completedAtMs / 1000,\n\t\tdurationMs: completedAtMs === null ? null : completedAtMs - startedAtMs,\n\t};\n}\n\nexport function buildUserMessage(clientUserMessageId: string | null, content: readonly UserInput[]): WireItem {\n\treturn {\n\t\ttype: \"userMessage\",\n\t\tid: clientUserMessageId ?? crypto.randomUUID(),\n\t\tclientId: clientUserMessageId,\n\t\tcontent: [...content],\n\t};\n}\n\nexport function wireItemToJson(item: WireItem): JsonValue {\n\tconst jsonItem: { [key: string]: JsonValue | undefined } = {};\n\tfor (const [key, value] of Object.entries(item)) {\n\t\tjsonItem[key] = unknownToJsonValue(value);\n\t}\n\treturn jsonItem;\n}\n\nexport function readLoggedItems(turnLog: TurnLog, threadId: ThreadId, turnId: string): readonly JsonValue[] {\n\treturn (\n\t\tturnLog\n\t\t\t.readTurns(threadId)\n\t\t\t.find((turn) => turn.turnId === turnId)\n\t\t\t?.items.map((item) => wireItemToJson(item)) ?? []\n\t);\n}\n\nexport function invalidRequest(message: string): TurnEngineError {\n\treturn new TurnEngineError({ code: -32600, message });\n}\n\nexport function invalidParams(message: string): TurnEngineError {\n\treturn new TurnEngineError({ code: -32602, message });\n}\n\nexport function toTurnEngineError(error: unknown): TurnEngineError {\n\tif (error instanceof TurnEngineError) {\n\t\treturn error;\n\t}\n\treturn new TurnEngineError({ code: -32603, message: error instanceof Error ? error.message : String(error) });\n}\n\nfunction unknownToJsonValue(value: unknown): JsonValue {\n\tif (value === null || typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn value.map(unknownToJsonValue);\n\t}\n\tif (typeof value === \"object\") {\n\t\tconst objectValue: { [key: string]: JsonValue | undefined } = {};\n\t\tfor (const [key, child] of Object.entries(value)) {\n\t\t\tobjectValue[key] = unknownToJsonValue(child);\n\t\t}\n\t\treturn objectValue;\n\t}\n\treturn null;\n}\n"]}

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

@@ -0,0 +1,4 @@
+import { type TurnEngineApi, type TurnEngineOptions, type TurnEngineThreadEntry } from "./turn-runtime.ts";
+export { type TurnEngineApi, TurnEngineError, type TurnEngineNotification, type TurnEngineOptions, type TurnEngineSession, type TurnEngineSessionEvent, type TurnEngineStore, type TurnEngineThreadEntry, type TurnEngineThreadStatus, } from "./turn-runtime.ts";
+export declare function createTurnEngine<Entry extends TurnEngineThreadEntry = TurnEngineThreadEntry>(options: TurnEngineOptions<Entry>): TurnEngineApi;
+//# sourceMappingURL=turns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turns.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/turns.ts"],"names":[],"mappings":"AAcA,OAAO,EASN,KAAK,aAAa,EAElB,KAAK,iBAAiB,EAGtB,KAAK,qBAAqB,EAI1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,KAAK,aAAa,EAClB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,qBAAqB,GAAG,qBAAqB,EAC3F,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAC/B,aAAa,CAEf"}