@linkshell/host 0.4.18 → 0.4.20

package/README.md

@@ -8,6 +8,18 @@ Run it through the CLI: `npm install -g linkshell-cli`, then `linkshell host --d
 
 Claude Workflow progress and background sub-agent transcripts stay synchronized even while the main conversation is idle. The app can open each run, phase and Agent independently.
 
+## Session recovery
+
+Host 0.4.19 revalidates busy sessions after restart, reconciles Codex native archives,
+and treats interrupted turns as finished. Archived Codex history is read without unarchiving.
+Missing Claude transcripts and other history failures preserve cached messages and show a
+retryable error. Lazy ACP agents initialize before their restore capabilities are checked;
+resume-only agents explain that earlier messages cannot be fetched.
+
+The host negotiates and validates ACP 1. ACP 2 remains draft and changes prompt completion,
+history replay, messages and permissions; changing the version number alone is incompatible.
+See [session recovery, protocol evidence and validation](../../docs/v2/session-recovery.md).
+
 ## Agent questions
 
 Codex Desktop asynchronous questions retain their pending state and accept immediate replies.
@@ -18,8 +30,8 @@ See [question support and validation boundaries](../../docs/v2/agent-questions.m
 ## Remote screen
 
 `screen.start` returns a token-protected loopback viewer port and display list. The phone
-forwards the port; the web client hosts the same page in an isolated iframe. On Apple silicon
-Macs, LinkShell.app captures and encodes with ScreenCaptureKit/VideoToolbox. The host passes
+forwards the port; the web client hosts the same page in an isolated iframe. On Apple silicon and Intel
+Macs running macOS 13+, the universal LinkShell.app captures and encodes with ScreenCaptureKit/VideoToolbox. The host passes
 SDP/ICE over its Unix socket; the media track and four input/cursor channels run directly
 between LinkShell.app and the native iOS receiver or web player.
 

package/dist/host/src/acp-settings.d.ts

@@ -0,0 +1,12 @@
+import { type AcpAgentSettings, type AcpRemoteAgent } from "@linkshell/wire";
+export declare class AcpSettingsStore {
+    private readonly path;
+    constructor(path: string);
+    private read;
+    settings(agent: string): AcpAgentSettings;
+    setSettings(agent: string, settings: AcpAgentSettings): void;
+    agents(): AcpRemoteAgent[];
+    saveAgent(agent: AcpRemoteAgent): void;
+    removeAgent(id: string): void;
+    private write;
+}

package/dist/host/src/acp-settings.js

@@ -0,0 +1,41 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { z } from "zod";
+import { acpAgentSettingsSchema, acpRemoteAgentSchema } from "@linkshell/wire";
+const schema = z.object({ settings: z.record(acpAgentSettingsSchema).default({}), agents: z.array(acpRemoteAgentSchema).default([]) });
+export class AcpSettingsStore {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    read() {
+        try {
+            return schema.parse(JSON.parse(readFileSync(this.path, "utf8")));
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return { settings: {}, agents: [] };
+            throw new Error("ACP 配置文件无效，请检查 acp.json", { cause: error });
+        }
+    }
+    settings(agent) { const value = this.read(); return value.settings[agent] ?? value.agents.find((entry) => entry.id === agent)?.settings ?? acpAgentSettingsSchema.parse({}); }
+    setSettings(agent, settings) {
+        const value = this.read();
+        value.settings[agent] = acpAgentSettingsSchema.parse(settings);
+        this.write(value);
+    }
+    agents() { return this.read().agents; }
+    saveAgent(agent) {
+        const value = this.read();
+        value.agents = [...value.agents.filter((entry) => entry.id !== agent.id), acpRemoteAgentSchema.parse(agent)];
+        this.write(value);
+    }
+    removeAgent(id) { const value = this.read(); value.agents = value.agents.filter((agent) => agent.id !== id); delete value.settings[id]; this.write(value); }
+    write(value) {
+        mkdirSync(dirname(this.path), { recursive: true, mode: 0o700 });
+        const temp = `${this.path}.${process.pid}.tmp`;
+        writeFileSync(temp, JSON.stringify(value, null, 2) + "\n", { mode: 0o600 });
+        renameSync(temp, this.path);
+    }
+}
+//# sourceMappingURL=acp-settings.js.map

package/dist/host/src/acp-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-settings.js","sourceRoot":"","sources":["../../../src/acp-settings.ts"],"names":[],"mappings":"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"}

package/dist/host/src/carry.js

@@ -4,6 +4,7 @@
 /** What of a session's log is the conversation itself: what was said and done, not state that was true then. */
 export function isConversation(update) {
     switch (update.sessionUpdate) {
+        case "ls_message":
         case "user_message_chunk":
         case "agent_message_chunk":
         case "agent_thought_chunk":
@@ -50,9 +51,19 @@ export function conversationDigest(events, maxBytes = 60_000) {
     for (const { update } of events) {
         if ("parentToolCallId" in update && update.parentToolCallId)
             continue;
-        if (update.sessionUpdate === "user_message_chunk" || update.sessionUpdate === "agent_message_chunk") {
+        if (update.sessionUpdate === "ls_message" && update.role !== "thought" && update.content) {
+            const label = update.role === "user" ? "User" : "Assistant", key = `${label}:${update.messageId}`;
+            const text = update.content.map((block) => block.type === "text" ? block.text : block.type === "resource" ? `${block.resource.uri}\n${block.resource.text ?? "[attachment]"}` : block.type === "resource_link" ? `[${block.name}]` : `[${block.type}]`).join("");
+            const existing = entries.find((entry) => entry.key === key);
+            if (existing)
+                existing.text = (update.append ? existing.text : "") + text;
+            else
+                entries.push({ key, label, text });
+        }
+        else if (update.sessionUpdate === "user_message_chunk" || update.sessionUpdate === "agent_message_chunk") {
             const label = update.sessionUpdate === "user_message_chunk" ? "User" : "Assistant";
-            const text = update.content.type === "text" ? update.content.text : update.content.type === "image" ? "[image]" : `[${update.content.name}]`;
+            const block = update.content;
+            const text = block.type === "text" ? block.text : block.type === "resource" ? `${block.resource.uri}\n${block.resource.text ?? "[attachment]"}` : block.type === "resource_link" ? `[${block.name}]` : `[${block.type}]`;
             const key = `${label}:${update.messageId ?? ""}`;
             if (last()?.key === key)
                 last().text += text;

package/dist/host/src/carry.js.map

@@ -1 +1 @@
-{"version":3,"file":"carry.js","sourceRoot":"","sources":["../../../src/carry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"carry.js","sourceRoot":"","sources":["../../../src/carry.ts"],"names":[],"mappings":"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"}

package/dist/host/src/drivers/acp/client-services.d.ts

@@ -0,0 +1,29 @@
+export interface AcpScope {
+    cwd: string;
+    additionalDirectories?: string[];
+}
+export interface AcpTerminalSnapshot {
+    output: string;
+    truncated: boolean;
+    exitStatus?: {
+        exitCode: number | null;
+        signal?: string | null;
+    };
+}
+/** Resolve the nearest existing ancestor so new files cannot escape through a symlink. */
+export declare function scopedPath(scope: AcpScope, path: string): Promise<string>;
+export declare class AcpClientServices {
+    private readonly options;
+    private readonly terminals;
+    constructor(options: {
+        scope: (sessionId: string) => AcpScope | undefined;
+        env: NodeJS.ProcessEnv;
+        output: (sessionId: string, terminalId: string, text: string, snapshot: AcpTerminalSnapshot) => void;
+    });
+    private scope;
+    request(method: string, raw: unknown, signal?: AbortSignal): Promise<unknown>;
+    output(sessionId: string, terminalId: string): AcpTerminalSnapshot | undefined;
+    private snapshot;
+    private kill;
+    close(sessionId?: string): Promise<void>;
+}

package/dist/host/src/drivers/acp/client-services.js

@@ -0,0 +1,192 @@
+import { spawn } from "node:child_process";
+import { mkdir, readFile, realpath, stat, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { StringDecoder } from "node:string_decoder";
+import { randomUUID } from "node:crypto";
+import { RpcError } from "@linkshell/wire";
+const object = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+const invalid = (message) => new RpcError(-32602, message);
+const cancelled = () => new RpcError(-32800, "请求已取消");
+const within = (root, path) => { const rel = relative(root, path); return rel === "" || (rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel)); };
+/** Resolve the nearest existing ancestor so new files cannot escape through a symlink. */
+export async function scopedPath(scope, path) {
+    if (!isAbsolute(path))
+        throw invalid("文件路径必须是绝对路径");
+    const target = resolve(path);
+    let ancestor = target;
+    while (true) {
+        try {
+            ancestor = await realpath(ancestor);
+            break;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT" || dirname(ancestor) === ancestor)
+                throw error;
+            ancestor = dirname(ancestor);
+        }
+    }
+    for (const root of [scope.cwd, ...(scope.additionalDirectories ?? [])]) {
+        const canonical = await realpath(root).catch(() => undefined);
+        if (canonical && within(canonical, ancestor))
+            return target;
+    }
+    throw new RpcError(-32000, "这个文件不在会话的工作目录中");
+}
+export class AcpClientServices {
+    options;
+    terminals = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    scope(sessionId) {
+        const scope = typeof sessionId === "string" ? this.options.scope(sessionId) : undefined;
+        if (!scope)
+            throw invalid("文件或终端请求没有有效的会话");
+        return scope;
+    }
+    async request(method, raw, signal) {
+        const p = object(raw);
+        const scope = this.scope(p.sessionId);
+        if (signal?.aborted)
+            throw cancelled();
+        if (method === "fs/read_text_file" || method === "fs/write_text_file") {
+            if (typeof p.path !== "string")
+                throw invalid("缺少文件路径");
+            const path = await scopedPath(scope, p.path);
+            if (method === "fs/write_text_file") {
+                if (typeof p.content !== "string")
+                    throw invalid("文件内容必须是文本");
+                if (Buffer.byteLength(p.content) > 16 * 1024 * 1024)
+                    throw invalid("文本文件超过 16 MB");
+                if (signal?.aborted)
+                    throw cancelled();
+                await mkdir(dirname(path), { recursive: true });
+                await writeFile(path, p.content, { encoding: "utf8", signal });
+                return {};
+            }
+            for (const key of ["line", "limit"]) {
+                if (p[key] != null && (!Number.isSafeInteger(p[key]) || Number(p[key]) < (key === "line" ? 1 : 0)))
+                    throw invalid(`${key} 必须是${key === "line" ? "正" : "非负"}整数`);
+            }
+            if ((await stat(path)).size > 16 * 1024 * 1024)
+                throw invalid("文本文件超过 16 MB");
+            const bytes = await readFile(path, { signal });
+            const content = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
+            if (p.line == null && p.limit == null)
+                return { content };
+            const lines = content.match(/[^\n]*\n|[^\n]+$/g) ?? [];
+            const from = Number(p.line ?? 1) - 1;
+            return { content: lines.slice(from, p.limit == null ? undefined : from + Number(p.limit)).join("") };
+        }
+        if (method === "terminal/create") {
+            if (this.terminals.size >= 64)
+                throw invalid("请先释放不用的 ACP 终端");
+            if (typeof p.command !== "string" || !p.command || (p.args != null && (!Array.isArray(p.args) || p.args.some((arg) => typeof arg !== "string"))))
+                throw invalid("终端命令无效");
+            const cwd = typeof p.cwd === "string" ? await scopedPath(scope, p.cwd) : scope.cwd;
+            if (signal?.aborted)
+                throw cancelled();
+            const env = { ...this.options.env };
+            for (const entry of Array.isArray(p.env) ? p.env : []) {
+                const item = object(entry);
+                if (typeof item.name !== "string" || typeof item.value !== "string")
+                    throw invalid("终端环境变量无效");
+                env[item.name] = item.value;
+            }
+            if (p.outputByteLimit != null && (!Number.isSafeInteger(p.outputByteLimit) || Number(p.outputByteLimit) < 0))
+                throw invalid("终端输出上限必须是非负整数");
+            const child = spawn(p.command, (p.args ?? []), { cwd, env, detached: process.platform !== "win32", stdio: ["ignore", "pipe", "pipe"] });
+            const terminalId = randomUUID();
+            let finish;
+            const terminal = { sessionId: String(p.sessionId), child, output: "", truncated: false,
+                limit: Math.min(Number(p.outputByteLimit ?? 256 * 1024), 4 * 1024 * 1024), exited: new Promise((resolve) => { finish = resolve; }) };
+            this.terminals.set(terminalId, terminal);
+            const append = (text) => {
+                if (!text)
+                    return;
+                const bytes = Buffer.from(terminal.output + text);
+                let start = Math.max(0, bytes.length - terminal.limit);
+                if (start) {
+                    terminal.truncated = true;
+                    while (start < bytes.length && (bytes[start] & 0xc0) === 0x80)
+                        start++;
+                }
+                terminal.output = bytes.subarray(start).toString("utf8");
+                this.options.output(terminal.sessionId, terminalId, text, this.snapshot(terminal));
+            };
+            for (const stream of [child.stdout, child.stderr]) {
+                const decoder = new StringDecoder("utf8");
+                stream?.on("data", (data) => append(decoder.write(data)));
+                stream?.on("end", () => append(decoder.end()));
+            }
+            const exited = (exitCode, exitSignal) => {
+                if (terminal.exitStatus)
+                    return;
+                terminal.exitStatus = { exitCode, signal: exitSignal };
+                finish(terminal.exitStatus);
+                this.options.output(terminal.sessionId, terminalId, "", this.snapshot(terminal));
+            };
+            child.once("close", exited);
+            child.once("error", (error) => { append(error.message); exited(1); });
+            return { terminalId };
+        }
+        const terminal = typeof p.terminalId === "string" ? this.terminals.get(p.terminalId) : undefined;
+        if (!terminal || terminal.sessionId !== p.sessionId)
+            throw invalid("找不到这个会话的终端");
+        if (method === "terminal/output")
+            return this.snapshot(terminal);
+        if (method === "terminal/wait_for_exit") {
+            if (!signal)
+                return terminal.exited;
+            return new Promise((resolve, reject) => {
+                const abort = () => reject(cancelled());
+                signal.addEventListener("abort", abort, { once: true });
+                void terminal.exited.then((status) => { signal.removeEventListener("abort", abort); resolve(status); });
+            });
+        }
+        if (method === "terminal/kill" || method === "terminal/release") {
+            await this.kill(terminal);
+            if (method === "terminal/release")
+                this.terminals.delete(String(p.terminalId));
+            return {};
+        }
+        throw new RpcError(-32601, `不支持 ${method}`);
+    }
+    output(sessionId, terminalId) {
+        const terminal = this.terminals.get(terminalId);
+        return terminal?.sessionId === sessionId ? this.snapshot(terminal) : undefined;
+    }
+    snapshot(terminal) { return { output: terminal.output, truncated: terminal.truncated, ...(terminal.exitStatus ? { exitStatus: terminal.exitStatus } : {}) }; }
+    async kill(terminal) {
+        const kill = (signal) => {
+            try {
+                if (process.platform !== "win32" && terminal.child.pid)
+                    process.kill(-terminal.child.pid, signal);
+                else
+                    terminal.child.kill(signal);
+            }
+            catch { /* The process may have exited between the status check and the signal. */ }
+        };
+        // The launcher may exit while a detached-from-stdio child still owns its
+        // process group. Releasing the terminal must also release those children.
+        if (terminal.exitStatus) {
+            kill("SIGKILL");
+            return;
+        }
+        kill("SIGTERM");
+        const timer = setTimeout(() => kill("SIGKILL"), 1500);
+        timer.unref();
+        await terminal.exited;
+        kill("SIGKILL");
+        clearTimeout(timer);
+    }
+    async close(sessionId) {
+        for (const [id, terminal] of this.terminals) {
+            if (sessionId && terminal.sessionId !== sessionId)
+                continue;
+            await this.kill(terminal);
+            this.terminals.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=client-services.js.map

package/dist/host/src/drivers/acp/client-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-services.js","sourceRoot":"","sources":["../../../../../src/drivers/acp/client-services.ts"],"names":[],"mappings":"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"}

package/dist/host/src/drivers/acp/connection.d.ts

@@ -1,19 +1,37 @@
 import { type RpcId } from "@linkshell/wire";
-/** The subset of ACP `initialize` results LinkShell reads. */
+export declare const ACP_PROTOCOL_VERSION = 1;
+export declare class AcpProtocolError extends Error {
+    constructor(version: unknown, requested?: number);
+}
+/** Both versions normalize their capability names here, never their wire semantics. */
 export interface AcpAgentCapabilities {
+    sessions?: boolean;
     loadSession?: boolean;
     promptCapabilities?: {
         image?: boolean;
         audio?: boolean;
         embeddedContext?: boolean;
     };
+    mcpCapabilities?: {
+        http?: boolean;
+        sse?: boolean;
+        stdio?: boolean;
+        acp?: boolean;
+    };
     sessionCapabilities?: {
         list?: unknown;
         resume?: unknown;
         close?: unknown;
         fork?: unknown;
         delete?: unknown;
+        additionalDirectories?: unknown;
     };
+    auth?: {
+        logout?: unknown;
+    };
+    providers?: unknown;
+    nes?: unknown;
+    positionEncoding?: string;
     _meta?: Record<string, unknown>;
 }
 export interface AcpInitializeResult {
@@ -26,39 +44,54 @@ export interface AcpInitializeResult {
     authMethods?: {
         id: string;
         name?: string;
+        description?: string;
+        type?: string;
+        args?: string[];
+        env?: Record<string, string>;
     }[];
     _meta?: Record<string, unknown>;
 }
 export interface AcpConnectionOptions {
     command: string;
     args: string[];
+    transport?: {
+        type: "http" | "websocket";
+        url: string;
+        headers?: Record<string, string>;
+    };
+    protocolVersion?: 1 | 2;
+    experimental?: boolean;
     env?: NodeJS.ProcessEnv;
     cwd?: string;
     clientVersion: string;
-    /** Namespace extensions implemented by this client for this adapter. */
     clientMeta?: Record<string, unknown>;
     onUpdate: (sessionId: string, update: unknown) => void;
-    /** Agent → client requests (session/request_permission, …). */
     onRequest: (method: string, params: unknown, id: RpcId) => unknown;
+    onNotification?: (method: string, params: unknown) => void;
     onCancelRequest?: (id: RpcId) => void;
     onExit: (reason: string) => void;
 }
-/**
- * One ACP agent subprocess: JSON-RPC 2.0 over newline-delimited stdio.
- * A single process serves every session of that agent.
- */
+/** One version-negotiated ACP connection. Native credentials remain owned by the agent. */
 export declare class AcpConnection {
     private readonly options;
     private child?;
     private peer?;
+    private reader?;
+    private writer?;
     private stopping;
+    private closed;
     private stderrTail;
     initializeResult: AcpInitializeResult;
     constructor(options: AcpConnectionOptions);
     get capabilities(): AcpAgentCapabilities;
     get alive(): boolean;
+    get protocolVersion(): 1 | 2;
     start(): Promise<AcpInitializeResult>;
+    private read;
+    private notification;
+    private lost;
     request<T>(method: string, params: unknown, timeoutMs?: number): Promise<T>;
+    hasPendingRequest(id: RpcId): boolean;
     notify(method: string, params: unknown): void;
     stop(): Promise<void>;
 }