@linkshell/host 0.4.17 → 0.4.19

package/dist/host/src/drivers/claude/transcript.d.ts

@@ -46,7 +46,7 @@ export declare const transcriptTimes: WeakMap<{
         type: "resource_link";
         name: string;
         uri: string;
-        kind?: "agent" | "file" | "skill" | undefined;
+        kind?: "file" | "skill" | "agent" | undefined;
     };
     sessionUpdate: "user_message_chunk";
     messageId?: string | undefined;
@@ -63,7 +63,7 @@ export declare const transcriptTimes: WeakMap<{
         type: "resource_link";
         name: string;
         uri: string;
-        kind?: "agent" | "file" | "skill" | undefined;
+        kind?: "file" | "skill" | "agent" | undefined;
     };
     sessionUpdate: "agent_message_chunk";
     messageId: string;
@@ -81,7 +81,7 @@ export declare const transcriptTimes: WeakMap<{
         type: "resource_link";
         name: string;
         uri: string;
-        kind?: "agent" | "file" | "skill" | undefined;
+        kind?: "file" | "skill" | "agent" | undefined;
     };
     sessionUpdate: "agent_thought_chunk";
     messageId: string;
@@ -90,23 +90,60 @@ export declare const transcriptTimes: WeakMap<{
     status: "completed" | "failed" | "pending" | "in_progress";
     toolCallId: string;
     title: string;
-    kind: "read" | "edit" | "delete" | "move" | "search" | "execute" | "think" | "fetch" | "other";
+    kind: "delete" | "other" | "read" | "edit" | "move" | "search" | "execute" | "think" | "fetch";
     sessionUpdate: "tool_call";
+    content?: ({
+        type: "content";
+        content: {
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            mimeType: string;
+            data?: string | undefined;
+            uri?: string | undefined;
+        } | {
+            type: "resource_link";
+            name: string;
+            uri: string;
+            kind?: "file" | "skill" | "agent" | undefined;
+        };
+    } | {
+        path: string;
+        type: "diff";
+        newText: string;
+        oldText?: string | null | undefined;
+    } | {
+        path: string;
+        type: "patch";
+        diff: string;
+        change: "add" | "delete" | "update";
+        movePath?: string | undefined;
+    } | {
+        type: "terminal";
+        terminalId: string;
+    })[] | undefined;
+    parentToolCallId?: string | undefined;
+    rawInput?: unknown;
+    locations?: {
+        path: string;
+        line?: number | undefined;
+    }[] | undefined;
     detail?: {
         type: "mcp";
-        tool: string;
         server: string;
+        tool: string;
     } | {
         type: "subagent";
         action: "message" | "resume" | "spawn" | "wait" | "stop" | "list";
-        state?: "running" | "paused" | "completed" | "failed" | "stopped" | "pending" | "unknown" | undefined;
+        state?: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending" | undefined;
         model?: string | undefined;
         name?: string | undefined;
         task?: string | undefined;
         agentType?: string | undefined;
         workflow?: {
             completed?: number | undefined;
-            state?: "running" | "paused" | "completed" | "failed" | "stopped" | undefined;
+            state?: "paused" | "running" | "completed" | "failed" | "stopped" | undefined;
             tokens?: number | undefined;
             durationMs?: number | undefined;
             startedAt?: number | undefined;
@@ -122,7 +159,7 @@ export declare const transcriptTimes: WeakMap<{
             agents?: {
                 id: string;
                 title: string;
-                state: "running" | "paused" | "completed" | "failed" | "stopped" | "pending" | "unknown";
+                state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
                 toolCallId?: string | undefined;
                 phaseId?: string | undefined;
                 model?: string | undefined;
@@ -154,7 +191,11 @@ export declare const transcriptTimes: WeakMap<{
         text: string;
         more?: number | undefined;
     } | undefined;
-    parentToolCallId?: string | undefined;
+} | {
+    toolCallId: string;
+    sessionUpdate: "tool_call_update";
+    status?: "completed" | "failed" | "pending" | "in_progress" | undefined;
+    title?: string | undefined;
     content?: ({
         type: "content";
         content: {
@@ -169,7 +210,7 @@ export declare const transcriptTimes: WeakMap<{
             type: "resource_link";
             name: string;
             uri: string;
-            kind?: "agent" | "file" | "skill" | undefined;
+            kind?: "file" | "skill" | "agent" | undefined;
         };
     } | {
         path: string;
@@ -180,37 +221,28 @@ export declare const transcriptTimes: WeakMap<{
         path: string;
         type: "patch";
         diff: string;
-        change: "delete" | "add" | "update";
+        change: "add" | "delete" | "update";
         movePath?: string | undefined;
     } | {
         type: "terminal";
         terminalId: string;
     })[] | undefined;
-    rawInput?: unknown;
-    locations?: {
-        path: string;
-        line?: number | undefined;
-    }[] | undefined;
-} | {
-    toolCallId: string;
-    sessionUpdate: "tool_call_update";
-    status?: "completed" | "failed" | "pending" | "in_progress" | undefined;
-    title?: string | undefined;
+    parentToolCallId?: string | undefined;
     detail?: {
         type: "mcp";
-        tool: string;
         server: string;
+        tool: string;
     } | {
         type: "subagent";
         action: "message" | "resume" | "spawn" | "wait" | "stop" | "list";
-        state?: "running" | "paused" | "completed" | "failed" | "stopped" | "pending" | "unknown" | undefined;
+        state?: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending" | undefined;
         model?: string | undefined;
         name?: string | undefined;
         task?: string | undefined;
         agentType?: string | undefined;
         workflow?: {
             completed?: number | undefined;
-            state?: "running" | "paused" | "completed" | "failed" | "stopped" | undefined;
+            state?: "paused" | "running" | "completed" | "failed" | "stopped" | undefined;
             tokens?: number | undefined;
             durationMs?: number | undefined;
             startedAt?: number | undefined;
@@ -226,7 +258,7 @@ export declare const transcriptTimes: WeakMap<{
             agents?: {
                 id: string;
                 title: string;
-                state: "running" | "paused" | "completed" | "failed" | "stopped" | "pending" | "unknown";
+                state: "unknown" | "paused" | "running" | "completed" | "failed" | "stopped" | "pending";
                 toolCallId?: string | undefined;
                 phaseId?: string | undefined;
                 model?: string | undefined;
@@ -258,38 +290,6 @@ export declare const transcriptTimes: WeakMap<{
         text: string;
         more?: number | undefined;
     } | undefined;
-    parentToolCallId?: string | undefined;
-    content?: ({
-        type: "content";
-        content: {
-            type: "text";
-            text: string;
-        } | {
-            type: "image";
-            mimeType: string;
-            data?: string | undefined;
-            uri?: string | undefined;
-        } | {
-            type: "resource_link";
-            name: string;
-            uri: string;
-            kind?: "agent" | "file" | "skill" | undefined;
-        };
-    } | {
-        path: string;
-        type: "diff";
-        newText: string;
-        oldText?: string | null | undefined;
-    } | {
-        path: string;
-        type: "patch";
-        diff: string;
-        change: "delete" | "add" | "update";
-        movePath?: string | undefined;
-    } | {
-        type: "terminal";
-        terminalId: string;
-    })[] | undefined;
     appendOutput?: string | undefined;
     rawOutput?: unknown;
 } | {
@@ -302,8 +302,8 @@ export declare const transcriptTimes: WeakMap<{
 } | {
     sessionUpdate: "ls_goal";
     goal: {
-        status: "paused" | "active" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
         objective: string;
+        status: "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
         tokenBudget?: number | null | undefined;
         tokensUsed?: number | undefined;
         timeUsedSeconds?: number | undefined;
@@ -328,16 +328,23 @@ export declare const transcriptTimes: WeakMap<{
     sessionUpdate: "usage_update";
     usedTokens?: number | undefined;
     contextWindow?: number | undefined;
+} | {
+    sessionUpdate: "ls_async_questions";
+    questions: {
+        options: string[];
+        id: string;
+        title: string;
+    }[];
 } | {
     sessionUpdate: "ls_message_done";
     messageId: string;
     role: "agent" | "thought" | "user";
+    parentToolCallId?: string | undefined;
     questions?: {
         options: string[];
         id: string;
         title: string;
     }[] | undefined;
-    parentToolCallId?: string | undefined;
 } | {
     options: {
         values: {
@@ -347,7 +354,7 @@ export declare const transcriptTimes: WeakMap<{
         }[];
         id: string;
         name: string;
-        category: "model" | "other" | "mode" | "effort";
+        category: "model" | "mode" | "effort" | "other";
         current: string;
     }[];
     sessionUpdate: "ls_config";
@@ -361,22 +368,22 @@ export declare const transcriptTimes: WeakMap<{
     sessionUpdate: "ls_turn";
     parentToolCallId?: string | undefined;
     turnId?: string | undefined;
-    stopReason?: "error" | "end_turn" | "cancelled" | "max_tokens" | "refusal" | undefined;
+    stopReason?: "end_turn" | "cancelled" | "error" | "max_tokens" | "refusal" | undefined;
 } | {
     options: {
         name: string;
-        optionId: string;
         kind: "allow_once" | "allow_always" | "reject_once" | "reject_always";
+        optionId: string;
     }[];
     title: string;
-    requestId: string;
     sessionUpdate: "ls_permission";
+    requestId: string;
     toolCallId?: string | undefined;
     detail?: string | undefined;
     questions?: {
         id: string;
-        kind: "text" | "choice" | "choices";
         text: string;
+        kind: "text" | "choice" | "choices";
         options?: {
             value: string;
             label: string;
@@ -388,8 +395,8 @@ export declare const transcriptTimes: WeakMap<{
         required?: boolean | undefined;
     }[] | undefined;
 } | {
-    requestId: string;
     sessionUpdate: "ls_permission_resolved";
+    requestId: string;
     optionId?: string | undefined;
     answers?: {
         values: string[];
@@ -397,27 +404,27 @@ export declare const transcriptTimes: WeakMap<{
         other?: string | undefined;
     }[] | undefined;
 } | {
-    driver: "remote" | "desktop" | "none";
     sessionUpdate: "ls_driver";
+    driver: "desktop" | "remote" | "none";
     deviceId?: string | undefined;
 } | {
-    state: "running" | "idle" | "waiting" | "error" | "offline";
+    state: "running" | "error" | "idle" | "waiting" | "offline";
     sessionUpdate: "ls_status";
 } | {
     task: {
         id: string;
         title: string;
-        state: "running" | "completed" | "failed" | "stopped" | "unknown";
+        state: "unknown" | "running" | "completed" | "failed" | "stopped";
         startedAt: number;
         kind: "shell" | "monitor";
         toolCallId?: string | undefined;
         endedAt?: number | undefined;
-        lastSeq?: number | undefined;
         command?: string | undefined;
         summary?: string | undefined;
         exitCode?: number | undefined;
         output?: boolean | undefined;
         canStop?: boolean | undefined;
+        lastSeq?: number | undefined;
     };
     sessionUpdate: "ls_task";
 } | {

package/dist/host/src/drivers/codex/archives.d.ts

@@ -0,0 +1,2 @@
+/** Codex moves archived rollouts out of sessions; absence from a paged thread/list is not evidence of archival. */
+export declare function archivedThreadIds(codexHome: string): Promise<string[]>;

package/dist/host/src/drivers/codex/archives.js

@@ -0,0 +1,18 @@
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+/** Codex moves archived rollouts out of sessions; absence from a paged thread/list is not evidence of archival. */
+export async function archivedThreadIds(codexHome) {
+    try {
+        const entries = await readdir(join(codexHome, "archived_sessions"), { withFileTypes: true });
+        return entries.flatMap((entry) => {
+            const id = entry.isFile() ? /^rollout-.+-([0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12})\.jsonl$/i.exec(entry.name)?.[1] : undefined;
+            return id ? [id] : [];
+        });
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+//# sourceMappingURL=archives.js.map

package/dist/host/src/drivers/codex/archives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archives.js","sourceRoot":"","sources":["../../../../../src/drivers/codex/archives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,mHAAmH;AACnH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7F,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/B,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,oEAAoE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnI,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/host/src/drivers/codex/attention.d.ts

@@ -0,0 +1,7 @@
+import { type AsyncQuestion } from "@linkshell/wire";
+export interface CodexAttention {
+    running: boolean;
+    questions: AsyncQuestion[];
+}
+/** Read only the current turn, so list badges work without taking ownership of the thread. */
+export declare function rolloutAttention(path: string, chunk?: number, limit?: number): CodexAttention | undefined;

package/dist/host/src/drivers/codex/attention.js

@@ -0,0 +1,82 @@
+import { closeSync, fstatSync, openSync, readSync } from "node:fs";
+import { answeredQuestions } from "@linkshell/wire";
+import { asyncQuestions } from "./mapper.js";
+/** Read only the current turn, so list badges work without taking ownership of the thread. */
+export function rolloutAttention(path, chunk = 256 * 1024, limit = 16 * 1024 * 1024) {
+    let fd;
+    try {
+        fd = openSync(path, "r");
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const size = fstatSync(fd).size;
+        let end = size;
+        let prefix = Buffer.alloc(0);
+        const questions = [];
+        const answered = new Set();
+        while (end > 0 && size - end < limit) {
+            const start = Math.max(0, end - Math.min(chunk, limit - (size - end)));
+            const bytes = Buffer.alloc(end - start);
+            readSync(fd, bytes, 0, bytes.length, start);
+            let data = Buffer.concat([bytes, prefix]);
+            // A writer may still be appending the last record.
+            if (end === size)
+                data = data.subarray(0, data.lastIndexOf(10) + 1);
+            end = start;
+            const first = start === 0 ? 0 : data.indexOf(10) + 1;
+            if (first === 0 && start > 0) {
+                prefix = data;
+                continue;
+            }
+            const lines = data.subarray(first).toString("utf8").split("\n");
+            prefix = data.subarray(0, first);
+            for (let index = lines.length - 1; index >= 0; index--) {
+                const line = lines[index];
+                if (!line.includes('"task_') && !line.includes('"turn_aborted"') && !line.includes("request_user_input_async") && !line.includes("send_user_message_question_reply"))
+                    continue;
+                let entry;
+                try {
+                    entry = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                const payload = entry.payload;
+                if (!payload || typeof payload !== "object")
+                    continue;
+                if (entry.type === "event_msg" && (payload.type === "task_complete" || payload.type === "turn_aborted"))
+                    return { running: false, questions: [] };
+                if (entry.type === "event_msg" && payload.type === "task_started") {
+                    return { running: true, questions: questions.filter((question) => !answered.has(question.id)) };
+                }
+                if (entry.type !== "response_item")
+                    continue;
+                if (payload.type === "function_call" && typeof payload.name === "string" && /(?:^|\.)request_user_input_async$/.test(payload.name)) {
+                    try {
+                        const args = JSON.parse(payload.arguments);
+                        questions.unshift(...(asyncQuestions({ id: payload.call_id, delivery: "async", questions: args.questions }) ?? []));
+                    }
+                    catch { /* Incomplete arguments cannot make an actionable question. */ }
+                }
+                if (payload.type === "message" && payload.role === "user" && Array.isArray(payload.content)) {
+                    for (const block of payload.content) {
+                        if (typeof block?.text === "string")
+                            for (const [id] of answeredQuestions(block.text))
+                                answered.add(id);
+                    }
+                }
+            }
+        }
+        // Unknown is not idle: do not clear a known pending question on a bounded read.
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=attention.js.map

package/dist/host/src/drivers/codex/attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.js","sourceRoot":"","sources":["../../../../../src/drivers/codex/attention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAsB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,8FAA8F;AAC9F,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAK,GAAG,GAAG,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;IACzF,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;QAChC,IAAI,GAAG,GAAG,IAAI,CAAC;QACf,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;YACxC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YAC1C,mDAAmD;YACnD,IAAI,GAAG,KAAK,IAAI;gBAAE,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACpE,GAAG,GAAG,KAAK,CAAC;YACZ,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACrD,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAAC,MAAM,GAAG,IAAI,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACjC,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,kCAAkC,CAAC;oBAAE,SAAS;gBAC/K,IAAI,KAAK,CAAC;gBACV,IAAI,CAAC;oBAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBACrD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;gBAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;oBAAE,SAAS;gBACtD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;gBAClJ,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAClG,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;oBAAE,SAAS;gBAC7C,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnI,IAAI,CAAC;wBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;wBAC3C,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBACtH,CAAC;oBAAC,MAAM,CAAC,CAAC,8DAA8D,CAAC,CAAC;gBAC5E,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC5F,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBACpC,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ;4BAAE,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC;gCAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAC1G,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,gFAAgF;QAChF,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;YACrB,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;AAC5B,CAAC"}

package/dist/host/src/drivers/codex/driver.d.ts

@@ -116,6 +116,8 @@ export declare class CodexDriver implements AgentDriver {
     start(host: DriverHost): Promise<DriverStatus>;
     authStatus(): Promise<AgentAuth>;
     stop(): Promise<void>;
+    private readonly attention;
+    archivedSessions(): Promise<string[]>;
     listSessions(limit: number): Promise<DiscoveredSession[]>;
     private stateElsewhere;
     /** Codex's own fork: a new thread with this one's turns, all or through `lastTurnId`, in `cwd`. */
@@ -139,6 +141,7 @@ export declare class CodexDriver implements AgentDriver {
     private observe;
     /** Reports what the other process has finished since the last look. An item still being written isn't on disk. */
     private refresh;
+    private announceQuestions;
     /**
      * The model, effort and permissions the other process runs the thread with,
      * from its rollout file: a thread that can only be read has no

package/dist/host/src/drivers/codex/driver.js

@@ -1,6 +1,10 @@
+import { rolloutAttention } from "./attention.js";
 import { closeSync, fstatSync, openSync, readSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { archivedThreadIds } from "./archives.js";
 import { codexPreview } from "./computer-preview.js";
-import { ABANDON, RpcError, sessionGoalSchema } from "@linkshell/wire";
+import { ABANDON, RpcError, questionReplies, updateAsyncQuestions, sessionGoalSchema } from "@linkshell/wire";
 import { parseCodexLoginStatus, runStatusCommand } from "../auth.js";
 import { CodexAppServer, CodexSharedServer, detectCodex, sharedServerSocket } from "./app-server.js";
 import { APPROVAL_METHODS, QUESTION_METHODS, mapApprovalRequest, mapQuestionRequest, mapNotification, threadStateOf, threadToDiscovered, spawnedThreads, subagentHistory, threadToHistory, toCodexInput, toolStart, turnUnderWay, } from "./mapper.js";
@@ -215,12 +219,26 @@ export class CodexDriver {
         await this.server?.stop();
         this.server = undefined;
     }
+    attention = new Map();
+    archivedSessions() {
+        return archivedThreadIds((this.options.env ?? process.env).CODEX_HOME || join(homedir(), ".codex"));
+    }
     async listSessions(limit) {
         const result = await this.rpc("thread/list", { limit, archived: false });
         return result.data.map((thread) => {
-            const discovered = threadToDiscovered(thread);
+            const discovered = { ...threadToDiscovered(thread), archived: false };
             // This host's app-server only knows the state of the threads loaded in it.
             const state = this.stateElsewhere(thread.id);
+            const stamp = thread.path ? fileStamp(thread.path) : undefined;
+            let attention = this.attention.get(thread.id);
+            if (thread.path && stamp && attention?.stamp !== stamp) {
+                attention = { stamp, value: rolloutAttention(thread.path) };
+                this.attention.set(thread.id, attention);
+            }
+            // Live notifications win over the file, which can lag while the agent writes.
+            if (!this.attached.has(thread.id) && !this.observed.has(thread.id) && attention?.value) {
+                return { ...discovered, state: attention.value.running ? "running" : "idle", asyncQuestions: attention.value.questions };
+            }
             return state ? { ...discovered, state } : discovered;
         });
     }
@@ -297,6 +315,14 @@ export class CodexDriver {
         }
         catch (error) {
             this.attached.delete(nativeId);
+            if (error instanceof Error && /session .+ is archived\b/i.test(error.message)) {
+                // Archives remain readable; opening history must not unarchive or resume the agent.
+                const { thread } = await this.rpc("thread/read", { threadId: nativeId, includeTurns: true });
+                this.host?.sessionSeen(this.id, { ...threadToDiscovered(thread), archived: true, state: "idle", asyncQuestions: [] });
+                const history = await this.withSubAgents(nativeId, thread, threadToHistory(thread));
+                this.host?.update(this.id, nativeId, { sessionUpdate: "ls_status", state: "idle" });
+                return history;
+            }
             if (error instanceof Error && /no rollout/i.test(error.message)) {
                 // Opened in another client but no turn yet, so not on disk. A turn can
                 // still be started on it; after that it can be joined.
@@ -391,6 +417,7 @@ export class CodexDriver {
         if (active)
             this.host?.update(this.id, threadId, { sessionUpdate: "ls_turn", state: "started", turnId: active.id });
         this.host?.update(this.id, threadId, { sessionUpdate: "ls_status", state: threadStateOf(thread.status) });
+        this.announceQuestions(threadId, thread, true);
         const read = new Set((thread.turns ?? []).flatMap((turn) => turn.items.map((item) => item.id)));
         for (const item of underWay) {
             // A command still running: its card. (Its output so far was missed, so the whole of it comes when it finishes.)
@@ -435,6 +462,7 @@ export class CodexDriver {
             this.cwds.set(threadId, thread.cwd);
         this.host?.update(this.id, threadId, { sessionUpdate: "ls_status", state: running ? "running" : "idle" });
         this.reportHeld(threadId, true);
+        this.announceQuestions(threadId, thread, true);
         this.readHeldSettings(threadId, thread.path ?? undefined);
         void this.announceCommands(threadId);
         void this.announceGoal(threadId);
@@ -478,6 +506,7 @@ export class CodexDriver {
                 watch.seen.add(item.itemId);
                 this.report(threadId, item);
             }
+            this.announceQuestions(threadId, thread);
             const last = thread.turns?.at(-1);
             const running = turnUnderWay(last);
             watch.turnId = running ? last?.id : undefined;
@@ -498,6 +527,20 @@ export class CodexDriver {
             watch.reading = false;
         }
     }
+    announceQuestions(threadId, thread, force = false) {
+        const turn = thread.turns?.at(-1);
+        let questions = [];
+        if (turnUnderWay(turn)) {
+            for (const item of threadToHistory({ ...thread, turns: turn ? [turn] : [] })) {
+                for (const update of item.updates)
+                    questions = updateAsyncQuestions(questions, update);
+            }
+        }
+        // Always restore on attach, even if this host already imported the history.
+        const changed = this.isNews(`questions:${threadId}`, questions);
+        if (force || changed)
+            this.host?.update(this.id, threadId, { sessionUpdate: "ls_async_questions", questions });
+    }
     /**
      * The model, effort and permissions the other process runs the thread with,
      * from its rollout file: a thread that can only be read has no
@@ -1046,7 +1089,21 @@ export class CodexDriver {
     async send(nativeId, input, clientMessageId) {
         if (input.length === 0)
             throw RpcError.app("invalid_params", "nothing to send");
-        if (this.observed.has(nativeId))
+        const watch = this.observed.get(nativeId);
+        if (watch?.running && questionReplies(textOf(input))) {
+            try {
+                if (!this.desktopBusPath)
+                    throw new Error("desktop bus unavailable");
+                await steerThroughDesktop(this.desktopBusPath, nativeId, this.desktopMessage(nativeId, input, clientMessageId));
+            }
+            catch (error) {
+                this.host?.log(`[codex] couldn't deliver a question answer to ${nativeId}: ${error instanceof Error ? error.message : String(error)}`);
+                throw this.refused(nativeId, "回答未确认送达 · 请重试或在电脑上回答", "回答未确认送达，问题仍保留");
+            }
+            void this.refresh(nativeId);
+            return "steered";
+        }
+        if (watch)
             return this.enqueue(nativeId, input, clientMessageId);
         const activeTurnId = this.stateOf(nativeId).activeTurnId;
         if (activeTurnId) {