@co0ontty/wand 4.27.1 → 4.28.0

package/README.md

@@ -11,7 +11,7 @@
 
 ### Overview
 
-Wand is a web console for remotely accessing and managing local CLI tools from a browser. It supports [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenCode](https://opencode.ai/), [Grok Build](https://grok.com/), and [Qoder CLI](https://docs.qoder.com/en/cli/quick-start), with terminal and structured conversation views, persistent resumable sessions, permission controls, file browsing, and native clients for multiple platforms.
+Wand is a web console for remotely accessing and managing local CLI tools from a browser. It supports [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenCode](https://opencode.ai/), [Grok Build](https://grok.com/), [Qoder CLI](https://docs.qoder.com/en/cli/quick-start), and [Pi](https://pi.dev/), with terminal and structured conversation views, persistent resumable sessions, permission controls, file browsing, and native clients for multiple platforms.
 
 The browser password manager extension source lives in `browser-extension/`; setup and supported baseline features are documented in [docs/browser-extension.md](docs/browser-extension.md).
 
@@ -56,7 +56,7 @@ wand config:password
 #### Core
 
 - **Dual view modes** — switch between raw terminal output and a structured conversation view for the same session
-- **Multiple providers** — create PTY or structured sessions for Claude Code, Codex, OpenCode, Grok, and Qoder CLI
+- **Multiple providers** — create PTY or structured sessions for Claude Code, Codex, OpenCode, Grok, Qoder CLI, and Pi
 - **Session management** — create, archive, and resume Claude, Codex, OpenCode, Grok, and Qoder sessions with their provider-native context; restore Claude/Codex native history; show summaries in the session list
 - **Permission control** — visual permission prompts with one-time approval, per-turn memory, and related policies
 
@@ -73,7 +73,7 @@ wand config:password
 - **Native clients** — Android, iOS, and macOS clients with encrypted connection codes and update checks
 - **HTTPS** — optional self-signed certificates for remote or mobile access
 - **Update channels** — built-in stable/beta update checks and upgrade prompts
-- **CLI updates** — check and quickly update Claude Code, Codex, and OpenCode from server settings, with optional automatic updates
+- **CLI updates** — check and quickly update Claude Code, Codex, OpenCode, Qoder CLI, and Pi from server settings, with optional automatic updates
 
 ### Configuration
 
@@ -155,7 +155,7 @@ npm install -g opencode-ai@latest
 
 ### 概览
 
-通过浏览器远程访问和管理本地 CLI 工具的 Web 控制台。支持 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex](https://github.com/openai/codex)、[OpenCode](https://opencode.ai/)、[Grok Build](https://grok.com/) 和 [Qoder CLI](https://docs.qoder.com/zh/cli/quick-start)，提供终端和结构化对话双视图、会话持久化与恢复、权限管控、文件浏览和多平台客户端。
+通过浏览器远程访问和管理本地 CLI 工具的 Web 控制台。支持 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex](https://github.com/openai/codex)、[OpenCode](https://opencode.ai/)、[Grok Build](https://grok.com/)、[Qoder CLI](https://docs.qoder.com/zh/cli/quick-start) 和 [Pi](https://pi.dev/)，提供终端和结构化对话双视图、会话持久化与恢复、权限管控、文件浏览和多平台客户端。
 
 <p align="center">
   <img src="docs/screenshots/clients-overview.png" width="100%" alt="Web 居中，iOS 和 Android 客户端在两侧的多端详情总览" />
@@ -205,7 +205,7 @@ npm install -g opencode-ai@latest
 #### 核心
 
 - **双视图模式** — 终端原始输出和结构化对话视图可随时切换，同一会话两种呈现
-- **多 Provider 支持** — Claude Code、Codex、OpenCode、Grok 和 Qoder CLI 均可创建 PTY 或结构化会话
+- **多 Provider 支持** — Claude Code、Codex、OpenCode、Grok、Qoder CLI 和 Pi 均可创建 PTY 或结构化会话
 - **会话管理** — 创建、归档并携带原生上下文恢复 Claude、Codex、OpenCode、Grok、Qoder 会话；支持恢复 Claude/Codex 原生历史记录；会话列表显示摘要
 - **权限控制** — 可视化权限提示，支持逐次确认、单次批准、本轮记忆等策略
 
@@ -222,7 +222,7 @@ npm install -g opencode-ai@latest
 - **多平台客户端** — Android / iOS / macOS 原生客户端，支持加密连接码分发、自动更新检查
 - **HTTPS** — 可选自签证书，适合远程或移动端访问
 - **版本管理** — 内置更新检查与升级提示，支持 stable/beta 双通道
-- **CLI 更新** — 在服务端设置中检查并快速更新 Claude Code、Codex、OpenCode，也可开启自动更新
+- **CLI 更新** — 在服务端设置中检查并快速更新 Claude Code、Codex、OpenCode、Qoder CLI 和 Pi，也可开启自动更新
 
 ### 截图
 

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "ccfdc6d997cd39ec9e87d4971ce404385e732dc6",
-  "builtAt": "2026-08-01T13:34:09.306Z",
-  "version": "4.27.1",
+  "commit": "53c936da2a9d14e6927295c028a77c6d0abd562e",
+  "builtAt": "2026-08-05T01:35:22.744Z",
+  "version": "4.28.0",
   "channel": "stable"
 }

package/dist/cli-api.d.ts

@@ -0,0 +1,11 @@
+import type { WandConfig } from "./types.js";
+export declare class WandCliApi {
+    private readonly config;
+    private cookie;
+    constructor(config: WandConfig);
+    get<T>(pathname: string): Promise<T>;
+    post<T>(pathname: string, body: unknown): Promise<T>;
+    private login;
+    private request;
+    private rawRequest;
+}

package/dist/cli-api.js

@@ -0,0 +1,76 @@
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
+export class WandCliApi {
+    config;
+    cookie = "";
+    constructor(config) {
+        this.config = config;
+    }
+    async get(pathname) {
+        return this.request("GET", pathname);
+    }
+    async post(pathname, body) {
+        return this.request("POST", pathname, body);
+    }
+    async login() {
+        const result = await this.rawRequest("POST", "/api/login", { password: this.config.password });
+        if (result.status < 200 || result.status >= 300)
+            throw new Error(`Wand 登录失败 (HTTP ${result.status})`);
+        this.cookie = result.cookies.map((value) => value.split(";", 1)[0]).join("; ");
+        if (!this.cookie)
+            throw new Error("Wand 服务未返回登录会话。");
+    }
+    async request(method, pathname, body) {
+        if (!this.cookie)
+            await this.login();
+        const result = await this.rawRequest(method, pathname, body, this.cookie);
+        let parsed = {};
+        try {
+            parsed = result.body ? JSON.parse(result.body) : {};
+        }
+        catch { /* handled below */ }
+        const error = parsed && typeof parsed === "object" && "error" in parsed && typeof parsed.error === "string"
+            ? parsed.error
+            : null;
+        if (result.status < 200 || result.status >= 300 || error) {
+            throw new Error(error || `Wand 请求失败 (HTTP ${result.status})`);
+        }
+        return parsed;
+    }
+    rawRequest(method, pathname, body, cookie) {
+        return new Promise((resolve, reject) => {
+            const protocol = this.config.https ? "https:" : "http:";
+            const url = new URL(`${protocol}//127.0.0.1:${this.config.port}${pathname}`);
+            const payload = body === undefined ? "" : JSON.stringify(body);
+            const request = protocol === "https:" ? httpsRequest : httpRequest;
+            const req = request(url, {
+                method,
+                rejectUnauthorized: false,
+                timeout: 30_000,
+                headers: {
+                    Accept: "application/json",
+                    ...(payload ? { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(payload) } : {}),
+                    ...(cookie ? { Cookie: cookie } : {}),
+                },
+            }, (res) => {
+                let responseBody = "";
+                res.setEncoding("utf8");
+                res.on("data", (chunk) => {
+                    responseBody += chunk;
+                    if (responseBody.length > 20 * 1024 * 1024)
+                        req.destroy(new Error("Wand 响应超过 20 MB。"));
+                });
+                res.on("end", () => resolve({
+                    status: res.statusCode ?? 0,
+                    body: responseBody,
+                    cookies: res.headers["set-cookie"] ?? [],
+                }));
+            });
+            req.on("timeout", () => req.destroy(new Error("连接 Wand 服务超时。")));
+            req.on("error", reject);
+            if (payload)
+                req.write(payload);
+            req.end();
+        });
+    }
+}

package/dist/cli.js

@@ -9,6 +9,7 @@ import process from "node:process";
 import { hasConfigFile, isPreferenceKey, loadConfigWithStorage, resolveConfigPath, saveConfig, writePreferenceToStorage, } from "./config.js";
 import { isPidAlive, readPidfile, removePidfile, removeSocketFile, socketPath, writePidfile, } from "./pidfile.js";
 import { getErrorMessage } from "./error-utils.js";
+import { WandCliApi } from "./cli-api.js";
 async function main() {
     const args = process.argv.slice(2);
     const command = args[0] || "help";
@@ -167,6 +168,19 @@ async function main() {
             }
             break;
         }
+        case "session:list":
+        case "session:read":
+        case "session:send":
+        case "session:wait":
+        case "inbox:list":
+        case "mission:list":
+        case "mission:create":
+        case "mission:diff":
+        case "mission:review":
+        case "mission:review:send": {
+            await runAgentCliCommand(command, args, configPath);
+            break;
+        }
         case "service:install":
         case "service:uninstall":
         case "service:start":
@@ -203,6 +217,18 @@ Commands:
   wand config:password      Print current login password
   wand config:set           Update a simple config value
 
+Agent runtime:
+  wand session:list         List sessions as JSON
+  wand session:read <id>    Read a complete session snapshot
+  wand session:send <id> <text>
+  wand session:wait <id> [--timeout 900]
+  wand inbox:list           List global Agent Inbox items
+  wand mission:list         List parallel tasks
+  wand mission:create --prompt <text> --cwd <path> --providers claude,codex
+  wand mission:diff <mission-id> <attempt-id>
+  wand mission:review <mission-id> <attempt-id> --file <path> --body <text> [--line N]
+  wand mission:review:send <mission-id> <attempt-id>
+
 System service (default = system-wide; pass --user for user-level):
   wand service:install      Register and start the background service (needs sudo for system)
   wand service:uninstall    Stop and remove the service
@@ -220,6 +246,77 @@ Options:
   --lines <N>               (service:logs) Number of log lines (default 80)
 `);
 }
+async function runAgentCliCommand(command, args, configPath) {
+    const { config } = await loadConfigForCli(configPath);
+    const api = new WandCliApi(config);
+    const output = (value) => { process.stdout.write(`${JSON.stringify(value, null, 2)}\n`); };
+    const required = (value, usage) => {
+        if (!value)
+            throw new Error(`Usage: ${usage}`);
+        return value;
+    };
+    switch (command) {
+        case "session:list": return output(await api.get("/api/sessions"));
+        case "session:read": {
+            const id = required(args[1], "wand session:read <id>");
+            return output(await api.get(`/api/sessions/${encodeURIComponent(id)}`));
+        }
+        case "session:send": {
+            const id = required(args[1], "wand session:send <id> <text>");
+            const text = required(args[2], "wand session:send <id> <text>");
+            return output(await api.post(`/api/sessions/${encodeURIComponent(id)}/input`, { input: text, respondImmediately: true }));
+        }
+        case "session:wait": {
+            const id = required(args[1], "wand session:wait <id> [--timeout 900]");
+            const timeoutSeconds = Math.max(1, Number(readFlagValue(args, "--timeout") ?? 900));
+            const deadline = Date.now() + timeoutSeconds * 1000;
+            while (true) {
+                const session = await api.get(`/api/sessions/${encodeURIComponent(id)}`);
+                const complete = session.status !== "running" && !session.structuredState?.inFlight;
+                if (complete)
+                    return output(session);
+                if (Date.now() >= deadline)
+                    throw new Error(`等待会话超时：${id}`);
+                await new Promise((resolve) => setTimeout(resolve, 500));
+            }
+        }
+        case "inbox:list": return output(await api.get("/api/inbox"));
+        case "mission:list": return output(await api.get("/api/missions"));
+        case "mission:create": {
+            const prompt = required(readFlagValue(args, "--prompt"), "wand mission:create --prompt <text> --cwd <path> --providers claude,codex");
+            const cwd = required(readFlagValue(args, "--cwd"), "wand mission:create --prompt <text> --cwd <path> --providers claude,codex");
+            const providers = required(readFlagValue(args, "--providers"), "wand mission:create --prompt <text> --cwd <path> --providers claude,codex")
+                .split(",").map((value) => value.trim()).filter(Boolean);
+            return output(await api.post("/api/missions", {
+                prompt, cwd, providers,
+                title: readFlagValue(args, "--title"),
+                baseRef: readFlagValue(args, "--base"),
+                sharedDirectories: readFlagValue(args, "--shared")?.split(",").filter(Boolean),
+                copyPaths: readFlagValue(args, "--copy")?.split(",").filter(Boolean),
+            }));
+        }
+        case "mission:diff": {
+            const missionId = required(args[1], "wand mission:diff <mission-id> <attempt-id>");
+            const attemptId = required(args[2], "wand mission:diff <mission-id> <attempt-id>");
+            return output(await api.get(`/api/missions/${encodeURIComponent(missionId)}/attempts/${encodeURIComponent(attemptId)}/diff`));
+        }
+        case "mission:review": {
+            const missionId = required(args[1], "wand mission:review <mission-id> <attempt-id> --file <path> --body <text>");
+            const attemptId = required(args[2], "wand mission:review <mission-id> <attempt-id> --file <path> --body <text>");
+            const filePath = required(readFlagValue(args, "--file"), "wand mission:review <mission-id> <attempt-id> --file <path> --body <text>");
+            const body = required(readFlagValue(args, "--body"), "wand mission:review <mission-id> <attempt-id> --file <path> --body <text>");
+            const line = readFlagValue(args, "--line");
+            return output(await api.post(`/api/missions/${encodeURIComponent(missionId)}/attempts/${encodeURIComponent(attemptId)}/comments`, {
+                filePath, body, line: line ? Number(line) : null, side: readFlagValue(args, "--side") === "old" ? "old" : "new",
+            }));
+        }
+        case "mission:review:send": {
+            const missionId = required(args[1], "wand mission:review:send <mission-id> <attempt-id>");
+            const attemptId = required(args[2], "wand mission:review:send <mission-id> <attempt-id>");
+            return output(await api.post(`/api/missions/${encodeURIComponent(missionId)}/attempts/${encodeURIComponent(attemptId)}/review/send`, {}));
+        }
+    }
+}
 async function ensureRequiredFiles(configPath, opts = {}) {
     const { config, dbPath, hadConfig, createdDb, generatedPassword } = await loadConfigForCli(configPath, {
         ensureInitialPassword: true,

package/dist/config.d.ts

@@ -7,7 +7,7 @@ import type { WandStorage } from "./storage.js";
  * 升级路径：老 JSON 里仍存有这些字段时，首次启动会被搬到 DB（见 migrateLegacyPreferencesToDb），
  * 然后下一次 saveConfig 写回 JSON 时它们会被剥离（见 stripPreferenceFields）。
  */
-export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
+export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
 export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
 export declare function isPreferenceKey(key: string): key is PreferenceKey;
 export declare const defaultConfig: () => WandConfig;
@@ -48,11 +48,12 @@ export declare function writePreferenceToStorage(config: WandConfig, storage: Wa
 export declare function validateCommitAiConfig(_config: Pick<WandConfig, "commitAiSource" | "systemAi">): void;
 export declare function normalizeCardDefaults(input: unknown): CardExpandDefaults;
 export declare function isExecutionMode(value: unknown): value is ExecutionMode;
-export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel">): {
+export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel">): {
     claude: string;
     codex: string;
     opencode: string;
     grok: string;
     qoder: string;
+    pi: string;
 };
-export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel">, provider: SessionProvider | undefined): string;
+export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultPiModel">, provider: SessionProvider | undefined): string;

package/dist/config.js

@@ -31,6 +31,7 @@ export const PREFERENCE_KEYS = [
     "defaultOpenCodeModel",
     "defaultGrokModel",
     "defaultQoderModel",
+    "defaultPiModel",
     "commitCli",
     "commitModel",
     "commitAiSource",
@@ -75,6 +76,7 @@ export const defaultConfig = () => ({
     defaultOpenCodeModel: "",
     defaultGrokModel: "",
     defaultQoderModel: "",
+    defaultPiModel: "",
     commitCli: "claude",
     commitModel: "",
     commitAiSource: "cli",
@@ -285,7 +287,7 @@ export function applyStoragePreferences(config, storage) {
     const defaults = defaultConfig();
     if (storage.hasPreference(preferenceStorageKey("defaultProvider"))) {
         const v = storage.getPreference(preferenceStorageKey("defaultProvider"), defaults.defaultProvider ?? "claude");
-        if (v === "claude" || v === "codex" || v === "opencode" || v === "grok" || v === "qoder")
+        if (v === "claude" || v === "codex" || v === "opencode" || v === "grok" || v === "qoder" || v === "pi")
             config.defaultProvider = v;
     }
     if (storage.hasPreference(preferenceStorageKey("defaultSessionKind"))) {
@@ -328,6 +330,11 @@ export function applyStoragePreferences(config, storage) {
         if (typeof v === "string")
             config.defaultQoderModel = v.trim();
     }
+    if (storage.hasPreference(preferenceStorageKey("defaultPiModel"))) {
+        const v = storage.getPreference(preferenceStorageKey("defaultPiModel"), defaults.defaultPiModel ?? "");
+        if (typeof v === "string")
+            config.defaultPiModel = v.trim();
+    }
     if (storage.hasPreference(preferenceStorageKey("commitCli"))) {
         const v = storage.getPreference(preferenceStorageKey("commitCli"), defaults.commitCli ?? "claude");
         if (v === "claude" || v === "codex" || v === "opencode")
@@ -378,7 +385,7 @@ export function writePreferenceToStorage(config, storage, key, value, options =
     const dbKey = preferenceStorageKey(key);
     switch (key) {
         case "defaultProvider": {
-            if (value !== "claude" && value !== "codex" && value !== "opencode" && value !== "grok" && value !== "qoder")
+            if (value !== "claude" && value !== "codex" && value !== "opencode" && value !== "grok" && value !== "qoder" && value !== "pi")
                 throw new Error(`无效 Provider: ${value}`);
             storage.setPreference(dbKey, value);
             config.defaultProvider = value;
@@ -434,6 +441,12 @@ export function writePreferenceToStorage(config, storage, key, value, options =
             config.defaultQoderModel = v;
             break;
         }
+        case "defaultPiModel": {
+            const v = typeof value === "string" ? value.trim() : "";
+            storage.setPreference(dbKey, v);
+            config.defaultPiModel = v;
+            break;
+        }
         case "commitCli": {
             if (value !== "claude" && value !== "codex" && value !== "opencode")
                 throw new Error(`无效 commit CLI: ${value}`);
@@ -652,13 +665,14 @@ function mergeWithDefaults(input) {
         android: normalizeAndroidApkConfig(input.android) ?? defaults.android,
         macos: normalizeMacosDmgConfig(input.macos) ?? defaults.macos,
         cardDefaults: normalizeCardDefaults(input.cardDefaults),
-        defaultProvider: input.defaultProvider === "codex" || input.defaultProvider === "opencode" || input.defaultProvider === "grok" || input.defaultProvider === "qoder" ? input.defaultProvider : "claude",
+        defaultProvider: input.defaultProvider === "codex" || input.defaultProvider === "opencode" || input.defaultProvider === "grok" || input.defaultProvider === "qoder" || input.defaultProvider === "pi" ? input.defaultProvider : "claude",
         defaultSessionKind: input.defaultSessionKind === "pty" ? "pty" : "structured",
         defaultModel: typeof input.defaultModel === "string" ? input.defaultModel.trim() : defaults.defaultModel,
         defaultCodexModel: typeof input.defaultCodexModel === "string" ? input.defaultCodexModel.trim() : defaults.defaultCodexModel,
         defaultOpenCodeModel: typeof input.defaultOpenCodeModel === "string" ? input.defaultOpenCodeModel.trim() : defaults.defaultOpenCodeModel,
         defaultGrokModel: typeof input.defaultGrokModel === "string" ? input.defaultGrokModel.trim() : defaults.defaultGrokModel,
         defaultQoderModel: typeof input.defaultQoderModel === "string" ? input.defaultQoderModel.trim() : defaults.defaultQoderModel,
+        defaultPiModel: typeof input.defaultPiModel === "string" ? input.defaultPiModel.trim() : defaults.defaultPiModel,
         commitCli: input.commitCli === "codex" || input.commitCli === "opencode" ? input.commitCli : "claude",
         commitModel: typeof input.commitModel === "string" ? input.commitModel.trim() : defaults.commitModel,
         commitAiSource: input.commitAiSource === "api" ? "api" : "cli",
@@ -677,6 +691,7 @@ export function getProviderDefaultModels(config) {
         opencode: (config.defaultOpenCodeModel ?? "").trim(),
         grok: (config.defaultGrokModel ?? "").trim(),
         qoder: (config.defaultQoderModel ?? "").trim(),
+        pi: (config.defaultPiModel ?? "").trim(),
     };
 }
 export function getDefaultModelForProvider(config, provider) {
@@ -689,6 +704,8 @@ export function getDefaultModelForProvider(config, provider) {
         return defaults.grok;
     if (provider === "qoder")
         return defaults.qoder;
+    if (provider === "pi")
+        return defaults.pi;
     return defaults.claude;
 }
 function normalizePresetCommand(command) {

package/dist/git-quick-commit.js

@@ -4,7 +4,7 @@ import { ClaudeRunError, runClaudePrint } from "./claude-sdk-runner.js";
 import { callSystemAiTextWithFallback } from "./system-ai.js";
 import { buildChildEnv } from "./env-utils.js";
 import { runGitAsync as runGitAsyncBase, runGitRawAsync as runGitRawAsyncBase, getGitErrorMessage, } from "./git-utils.js";
-import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToGrokEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToQoderEffort, } from "./structured-provider-common.js";
+import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToGrokEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToQoderEffort, thinkingEffortToPiLevel, } from "./structured-provider-common.js";
 const GIT_TIMEOUT_MS = 1500;
 const GIT_PUSH_TIMEOUT_MS = 30_000;
 const MAX_FILE_ENTRIES = 200;
@@ -306,6 +306,7 @@ function normalizeProvider(provider) {
         || provider === "opencode"
         || provider === "grok"
         || provider === "qoder"
+        || provider === "pi"
         ? provider
         : "claude";
 }
@@ -406,6 +407,35 @@ function extractQoderText(stdout) {
     }
     return (resultText || assistantTexts.join("\n")).trim();
 }
+function extractPiText(stdout) {
+    let text = "";
+    for (const line of stdout.split(/\r?\n/)) {
+        try {
+            const event = JSON.parse(line);
+            if (event.type !== "message_end" || event.message?.role !== "assistant" || !Array.isArray(event.message.content))
+                continue;
+            text = event.message.content
+                .filter((block) => !!block && typeof block === "object" && block.type === "text" && typeof block.text === "string")
+                .map((block) => block.text)
+                .join("\n");
+        }
+        catch { /* ignore non-protocol stdout */ }
+    }
+    return text.trim();
+}
+function buildPiTextArgs(prompt, opts, allowTools = false) {
+    const args = ["--mode", "json", "--print", "--no-session"];
+    if (!allowTools)
+        args.push("--no-tools");
+    const model = opts.model?.trim();
+    if (model && model !== "default")
+        args.push("--model", model);
+    const level = thinkingEffortToPiLevel(opts.thinkingEffort ?? "off");
+    if (level)
+        args.push("--thinking", level);
+    args.push(prompt);
+    return args;
+}
 function buildGrokTextArgs(prompt, opts, allowTools = false) {
     const args = ["--no-auto-update", "-p", prompt, "--output-format", "streaming-json"];
     const model = opts.model?.trim();
@@ -532,6 +562,13 @@ async function callQoderText(prompt, cwd, opts) {
         throw new QuickCommitError("Qoder 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
     return text;
 }
+async function callPiText(prompt, cwd, opts) {
+    const stdout = await runCliText("pi", buildPiTextArgs(prompt, opts), "", { cwd, timeoutMs: CODEX_MESSAGE_TIMEOUT_MS, inheritEnv: opts.inheritEnv });
+    const text = extractPiText(stdout);
+    if (!text)
+        throw new QuickCommitError("Pi 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
+    return text;
+}
 async function callCliAiText(prompt, cwd, language, opts) {
     const provider = normalizeProvider(opts.provider);
     if (provider === "codex") {
@@ -543,6 +580,8 @@ async function callCliAiText(prompt, cwd, language, opts) {
         return callGrokText(prompt, cwd, opts);
     if (provider === "qoder")
         return callQoderText(prompt, cwd, opts);
+    if (provider === "pi")
+        return callPiText(prompt, cwd, opts);
     return callClaudeText(prompt, cwd, language, opts);
 }
 async function callDirectApiText(prompt, systemAi) {
@@ -1196,6 +1235,13 @@ async function runQuickCommitFallbackCli(opts, priorError) {
             inheritEnv: opts.inheritEnv,
         });
     }
+    else if (provider === "pi") {
+        await runCliText("pi", buildPiTextArgs(prompt, opts, true), "", {
+            cwd: opts.cwd,
+            timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
+            inheritEnv: opts.inheritEnv,
+        });
+    }
     else {
         const args = [
             "-p",

package/dist/git-worktree.d.ts

@@ -1,7 +1,18 @@
 import { SessionSnapshot, WorktreeMergeCheckResult, WorktreeMergeResult } from "./types.js";
+export interface WorktreeSetupSpec {
+    /** Branch, tag, or commit used as the task's immutable starting point. */
+    baseRef?: string;
+    /** Human-readable task name used in the generated branch. */
+    taskName?: string;
+    /** Gitignored repo-relative paths copied into the new worktree. */
+    copyPaths?: string[];
+    /** Gitignored repo-relative paths symlinked from the main checkout. */
+    sharedDirectories?: string[];
+}
 interface WorktreeSetupOptions {
     cwd: string;
     sessionId: string;
+    spec?: WorktreeSetupSpec;
 }
 interface WorktreeSetupResult {
     cwd: string;

package/dist/git-worktree.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync } from "node:fs";
+import { cpSync, existsSync, lstatSync, mkdirSync, symlinkSync } from "node:fs";
 import path from "node:path";
 import { runGit, runGitAsync, getGitErrorMessage } from "./git-utils.js";
 const WORKTREE_MERGE_ERROR_CODES = {
@@ -39,6 +39,48 @@ function getCurrentBranch(repoRoot, timeoutMs = DEFAULT_WORKTREE_GIT_TIMEOUT_MS)
     const branch = runWorktreeGit(["branch", "--show-current"], repoRoot, timeoutMs);
     return branch || "master";
 }
+function normalizePortableRelativePath(value) {
+    const normalized = value.trim().replace(/\\/g, "/").replace(/^\.\//, "");
+    if (!normalized || path.isAbsolute(normalized) || normalized === ".git" || normalized.startsWith(".git/") || normalized.split("/").includes("..")) {
+        throw new Error(`无效的 worktree 共享路径：${value}`);
+    }
+    return normalized;
+}
+function ensureIgnoredPath(repoRoot, relativePath) {
+    try {
+        runGit(["check-ignore", "--quiet", "--", relativePath], repoRoot);
+    }
+    catch {
+        throw new Error(`仅允许复制或共享被 gitignore 忽略的路径：${relativePath}`);
+    }
+}
+function populateWorktreePaths(repoRoot, worktreePath, spec) {
+    for (const rawPath of spec.copyPaths ?? []) {
+        const relativePath = normalizePortableRelativePath(rawPath);
+        ensureIgnoredPath(repoRoot, relativePath);
+        const source = path.join(repoRoot, relativePath);
+        if (!existsSync(source))
+            throw new Error(`要复制的路径不存在：${relativePath}`);
+        const destination = path.join(worktreePath, relativePath);
+        if (existsSync(destination))
+            throw new Error(`Worktree 中目标路径已存在：${relativePath}`);
+        mkdirSync(path.dirname(destination), { recursive: true });
+        cpSync(source, destination, { recursive: true, preserveTimestamps: true });
+    }
+    for (const rawPath of spec.sharedDirectories ?? []) {
+        const relativePath = normalizePortableRelativePath(rawPath);
+        ensureIgnoredPath(repoRoot, relativePath);
+        const source = path.join(repoRoot, relativePath);
+        if (!existsSync(source) || !lstatSync(source).isDirectory()) {
+            throw new Error(`要共享的目录不存在：${relativePath}`);
+        }
+        const destination = path.join(worktreePath, relativePath);
+        if (existsSync(destination))
+            throw new Error(`Worktree 中目标路径已存在：${relativePath}`);
+        mkdirSync(path.dirname(destination), { recursive: true });
+        symlinkSync(source, destination, "dir");
+    }
+}
 function ensureWorktreePath(worktree) {
     const worktreePath = path.resolve(worktree.path);
     if (!existsSync(worktreePath)) {
@@ -321,18 +363,45 @@ export function prepareSessionWorktree(options) {
         throw new Error("当前目录不在 git 仓库中，无法启用 worktree 模式。");
     }
     const baseBranch = getCurrentBranch(repoRoot);
+    const requestedBaseRef = options.spec?.baseRef?.trim() || baseBranch;
+    let baseCommit;
+    try {
+        baseCommit = runGit(["rev-parse", "--verify", `${requestedBaseRef}^{commit}`], repoRoot);
+    }
+    catch {
+        throw new Error(`Worktree 基线不存在：${requestedBaseRef}`);
+    }
     const branchSuffix = sanitizeBranchSegment(options.sessionId.split("-")[0] || options.sessionId);
-    const branchName = `wand/${sanitizeBranchSegment(baseBranch)}-${branchSuffix}`;
+    const branchPrefix = sanitizeBranchSegment(options.spec?.taskName || baseBranch);
+    const branchName = `wand/${branchPrefix}-${branchSuffix}`;
     const worktreesRoot = path.join(repoRoot, ".wand-worktrees");
     const worktreePath = path.join(worktreesRoot, branchName.replace(/\//g, "-"));
     mkdirSync(worktreesRoot, { recursive: true });
-    runGit(["worktree", "add", "-b", branchName, worktreePath, "HEAD"], repoRoot);
+    runGit(["worktree", "add", "-b", branchName, worktreePath, baseCommit], repoRoot);
+    try {
+        populateWorktreePaths(repoRoot, worktreePath, options.spec ?? {});
+    }
+    catch (error) {
+        try {
+            runGit(["worktree", "remove", "--force", worktreePath], repoRoot);
+        }
+        catch { /* preserve setup error */ }
+        try {
+            runGit(["branch", "-D", branchName], repoRoot);
+        }
+        catch { /* preserve setup error */ }
+        throw error;
+    }
     return {
         cwd: worktreePath,
         worktreeEnabled: true,
         worktree: {
             branch: branchName,
             path: worktreePath,
+            // Pin the resolved commit so later movement of the source branch cannot
+            // change the mission's review baseline.
+            baseRef: baseCommit,
+            repoRoot,
         },
     };
 }

package/dist/mission-diff.d.ts

@@ -0,0 +1,8 @@
+import type { MissionDiff } from "./mission-types.js";
+export declare function buildMissionDiff(options: {
+    missionId: string;
+    attemptId: string;
+    cwd: string;
+    baseRef: string;
+    maxPatchBytes?: number;
+}): MissionDiff;