@co0ontty/wand 1.15.0 → 1.17.2

package/dist/claude-pty-bridge.d.ts

@@ -85,6 +85,8 @@ export declare class ClaudePtyBridge extends EventEmitter {
     private _exited;
     private rememberedScopes;
     private rememberedTargets;
+    private lastChatEmitAt;
+    private chatEmitTimer;
     private lastOutputAt;
     private lastUserInputAt;
     private idleProbeTimer;
@@ -170,6 +172,7 @@ export declare class ClaudePtyBridge extends EventEmitter {
     private inferScope;
     private parseChatResponse;
     private detectCompletion;
+    private static readonly CHAT_THROTTLE_MS;
     private updateAssistantContent;
     private finalizeResponse;
     /**

package/dist/claude-pty-bridge.js

@@ -7,7 +7,7 @@
  * 2. Structured messages for chat view (parsed)
  */
 import { EventEmitter } from "node:events";
-import { stripAnsi, isNoiseLine, appendWindow, normalizePromptText, hasExplicitConfirmSyntax, hasPermissionActionContext, scorePermissionLikelihood, FALLBACK_SCORE_THRESHOLD } from "./pty-text-utils.js";
+import { stripAnsi, isNoiseLine, appendWindow, normalizePromptText, hasExplicitConfirmSyntax, hasPermissionActionContext, scorePermissionLikelihood, FALLBACK_SCORE_THRESHOLD, isSlashCommandMenu } from "./pty-text-utils.js";
 // ── Constants ──
 const OUTPUT_MAX_SIZE = 120000;
 const SESSION_ID_WINDOW_SIZE = 16384;
@@ -69,6 +69,9 @@ export class ClaudePtyBridge extends EventEmitter {
     // Permission memory for "approve_turn" policy
     rememberedScopes = new Set();
     rememberedTargets = new Set();
+    // Chat event throttle
+    lastChatEmitAt = 0;
+    chatEmitTimer = null;
     // Idle probe state (last-resort robustness)
     lastOutputAt;
     lastUserInputAt;
@@ -202,6 +205,11 @@ export class ClaudePtyBridge extends EventEmitter {
             clearTimeout(this.taskDebounceTimer);
             this.taskDebounceTimer = null;
         }
+        // Flush pending chat emit
+        if (this.chatEmitTimer) {
+            clearTimeout(this.chatEmitTimer);
+            this.chatEmitTimer = null;
+        }
         // Clear permission state — prevents stale blocked state after exit
         this.cancelPendingAutoApprove();
         this.clearIdleProbeTimer();
@@ -655,6 +663,10 @@ export class ClaudePtyBridge extends EventEmitter {
         this.ptyWrite("\r");
     }
     isPermissionPromptDetected(normalized) {
+        // Slash-command selection menus (/model, /effort, /output-style …) share
+        // "Enter to confirm" with permission prompts but must be left alone.
+        if (isSlashCommandMenu(normalized))
+            return false;
         const hasIntent = /\bdo you want to\b/i.test(normalized)
             || /\bwould you like to\b/i.test(normalized)
             || /\benter to confirm\b/i.test(normalized)
@@ -737,6 +749,7 @@ export class ClaudePtyBridge extends EventEmitter {
         }
         return false;
     }
+    static CHAT_THROTTLE_MS = 80;
     updateAssistantContent() {
         const idx = this.chatState.assistantIndex;
         if (idx === null)
@@ -745,6 +758,27 @@ export class ClaudePtyBridge extends EventEmitter {
         if (text) {
             this.messages[idx].content = [{ type: "text", text }];
         }
+        const now = Date.now();
+        if (now - this.lastChatEmitAt < ClaudePtyBridge.CHAT_THROTTLE_MS) {
+            if (!this.chatEmitTimer) {
+                this.chatEmitTimer = setTimeout(() => {
+                    this.chatEmitTimer = null;
+                    this.lastChatEmitAt = Date.now();
+                    this.emitEvent({
+                        type: "output.chat",
+                        sessionId: this.sessionId,
+                        timestamp: Date.now(),
+                        data: {
+                            messages: this.messages,
+                            streamingIndex: this.chatState.assistantIndex,
+                            isResponding: true,
+                        },
+                    });
+                }, ClaudePtyBridge.CHAT_THROTTLE_MS);
+            }
+            return;
+        }
+        this.lastChatEmitAt = now;
         this.emitEvent({
             type: "output.chat",
             sessionId: this.sessionId,

package/dist/config.js

@@ -19,6 +19,7 @@ export const defaultConfig = () => ({
     language: "",
     android: defaultAndroidApkConfig(),
     cardDefaults: defaultCardExpandDefaults(),
+    defaultModel: "",
     commandPresets: [
         {
             label: "Claude",
@@ -183,6 +184,7 @@ function mergeWithDefaults(input) {
             : crypto.randomBytes(32).toString("hex"),
         android: normalizeAndroidApkConfig(input.android) ?? defaults.android,
         cardDefaults: normalizeCardDefaults(input.cardDefaults),
+        defaultModel: typeof input.defaultModel === "string" ? input.defaultModel.trim() : defaults.defaultModel,
     };
 }
 export function isExecutionMode(value) {

package/dist/models.d.ts

@@ -0,0 +1,13 @@
+import { ClaudeModelInfo } from "./types.js";
+interface ModelCache {
+    models: ClaudeModelInfo[];
+    claudeVersion: string | null;
+    refreshedAt: string;
+}
+export declare function getCachedModels(): ModelCache;
+export declare function refreshModels(): Promise<ModelCache>;
+/** 返回可用于 claude CLI 的全部已知 model id（含别名） */
+export declare function knownModelIds(): string[];
+/** 判断传入值是否是已知模型；允许自由文本，因此总是返回 true。保留接口以便将来严格校验。 */
+export declare function isKnownModel(_value: string): boolean;
+export {};

package/dist/models.js

@@ -0,0 +1,54 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+const BUILT_IN_MODELS = [
+    { id: "default", label: "default（跟随 Claude Code 默认）", alias: true },
+    { id: "opus", label: "opus（最新 Opus）", alias: true },
+    { id: "sonnet", label: "sonnet（最新 Sonnet）", alias: true },
+    { id: "haiku", label: "haiku（最新 Haiku）", alias: true },
+    { id: "claude-opus-4-7", label: "Opus 4.7 · claude-opus-4-7" },
+    { id: "claude-opus-4-6", label: "Opus 4.6 · claude-opus-4-6" },
+    { id: "claude-sonnet-4-6", label: "Sonnet 4.6 · claude-sonnet-4-6" },
+    { id: "claude-haiku-4-5-20251001", label: "Haiku 4.5 · claude-haiku-4-5-20251001" },
+];
+let cache = null;
+function cloneDefaults() {
+    return BUILT_IN_MODELS.map((m) => ({ ...m }));
+}
+async function probeClaudeVersion() {
+    try {
+        const { stdout } = await execAsync("claude --version", { timeout: 5000 });
+        const match = stdout.match(/\d+\.\d+\.\d+(?:[-+][A-Za-z0-9.-]+)?/);
+        return match ? match[0] : stdout.trim().slice(0, 64) || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function getCachedModels() {
+    if (!cache) {
+        cache = {
+            models: cloneDefaults(),
+            claudeVersion: null,
+            refreshedAt: new Date().toISOString(),
+        };
+    }
+    return cache;
+}
+export async function refreshModels() {
+    const version = await probeClaudeVersion();
+    cache = {
+        models: cloneDefaults(),
+        claudeVersion: version,
+        refreshedAt: new Date().toISOString(),
+    };
+    return cache;
+}
+/** 返回可用于 claude CLI 的全部已知 model id（含别名） */
+export function knownModelIds() {
+    return BUILT_IN_MODELS.map((m) => m.id);
+}
+/** 判断传入值是否是已知模型；允许自由文本，因此总是返回 true。保留接口以便将来严格校验。 */
+export function isKnownModel(_value) {
+    return true;
+}

package/dist/process-manager.d.ts

@@ -43,6 +43,7 @@ export declare class ProcessManager extends EventEmitter {
         autoRecovered?: boolean;
         worktreeEnabled?: boolean;
         provider?: SessionProvider;
+        model?: string;
     }): SessionSnapshot;
     list(): SessionSnapshot[];
     /** Return lightweight snapshots for the session list (no output/messages). */
@@ -57,6 +58,12 @@ export declare class ProcessManager extends EventEmitter {
     }[]): number;
     get(id: string): SessionSnapshot | null;
     getPtyTranscript(id: string): string | null;
+    /**
+     * Set the Claude model for an existing PTY session. Persists the selection
+     * and, when the session is live, pipes a `/model <id>` slash command into
+     * the PTY so Claude Code switches on the fly.
+     */
+    setSessionModel(id: string, model: string | null): SessionSnapshot;
     sendInput(id: string, input: string, view?: "chat" | "terminal", shortcutKey?: string): SessionSnapshot;
     /** Emit a task event for a session, debounced to avoid flooding */
     private emitTask;

package/dist/process-manager.js

@@ -314,12 +314,14 @@ function readClaudeSessionSummary(filePath, id, cwd) {
         return null;
     }
 }
+const WORKTREE_DIR_PATTERN = /--?\.?(?:wand-worktrees|claude-worktrees)-/;
 /** Scan all ~/.claude/projects/ directories for session JSONL files. */
 function listAllClaudeHistorySessions() {
     const projectsDir = path.join(os.homedir(), ".claude", "projects");
     try {
         const projectDirs = readdirSync(projectsDir, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory());
+            .filter((entry) => entry.isDirectory())
+            .filter((entry) => !WORKTREE_DIR_PATTERN.test(entry.name));
         const results = [];
         for (const dir of projectDirs) {
             const dirPath = path.join(projectsDir, dir.name);
@@ -620,7 +622,8 @@ export class ProcessManager extends EventEmitter {
         const provider = opts?.provider ?? resolveProviderFromCommand(command);
         const effectiveMode = provider === "codex" ? "full-access" : mode;
         const isClaudeProvider = provider === "claude";
-        const processedCommand = this.processCommandForMode(command, effectiveMode, provider);
+        const selectedModel = opts?.model?.trim() || undefined;
+        const processedCommand = this.processCommandForMode(command, effectiveMode, provider, selectedModel);
         const resumeCommandSessionId = isClaudeProvider
             ? getResumeCommandSessionId(processedCommand) ?? getResumeCommandSessionId(command)
             : null;
@@ -671,7 +674,8 @@ export class ProcessManager extends EventEmitter {
             knownClaudeTaskIds: knownClaudeTaskIds ?? undefined,
             claudeTaskDiscoveryTimer: null,
             knownClaudeProjectMtimes: knownClaudeProjectMtimes ?? undefined,
-            approvalStats: { tool: 0, command: 0, file: 0, total: 0 }
+            approvalStats: { tool: 0, command: 0, file: 0, total: 0 },
+            selectedModel: selectedModel ?? null,
         };
         if (isClaudeProvider) {
             record.ptyBridge = new ClaudePtyBridge({
@@ -787,8 +791,8 @@ export class ProcessManager extends EventEmitter {
                     type: "output",
                     sessionId: id,
                     data: {
+                        incremental: true,
                         chunk,
-                        output: rec.output,
                         permissionBlocked: this.isPermissionBlocked(rec),
                     },
                 });
@@ -945,6 +949,26 @@ export class ProcessManager extends EventEmitter {
     getPtyTranscript(id) {
         return this.logger.readPtyOutput(id);
     }
+    /**
+     * Set the Claude model for an existing PTY session. Persists the selection
+     * and, when the session is live, pipes a `/model <id>` slash command into
+     * the PTY so Claude Code switches on the fly.
+     */
+    setSessionModel(id, model) {
+        const record = this.mustGet(id);
+        if (record.provider !== "claude") {
+            throw new Error("仅 Claude 会话支持切换模型。");
+        }
+        const normalized = model?.trim() || null;
+        record.selectedModel = normalized;
+        if (record.status === "running" && record.ptyProcess) {
+            const value = normalized && normalized !== "default" ? normalized : "default";
+            record.ptyProcess.write(`/model ${value}\r`);
+        }
+        this.persist(record);
+        this.emitEvent({ type: "status", sessionId: id, data: { selectedModel: normalized } });
+        return this.snapshot(record);
+    }
     sendInput(id, input, view, shortcutKey) {
         const record = this.mustGet(id);
         if (record.status !== "running") {
@@ -974,11 +998,7 @@ export class ProcessManager extends EventEmitter {
         if (record.ptyBridge) {
             record.ptyBridge.onUserInput(input);
         }
-        // Ensure input advances to a new line so subsequent PTY output doesn't overwrite it
         record.ptyProcess.write(input);
-        if (view !== "terminal" && !input.endsWith("\n")) {
-            record.ptyProcess.write("\n");
-        }
         this.persist(record);
         return this.snapshot(record);
     }
@@ -1180,6 +1200,7 @@ export class ProcessManager extends EventEmitter {
             approvalStats: record.approvalStats.total > 0 ? record.approvalStats : undefined,
             summary: deriveSessionSummary(messages, record.currentTask?.title ?? null),
             currentTaskTitle: record.status === "running" ? record.currentTask?.title ?? undefined : undefined,
+            selectedModel: record.selectedModel ?? null,
         };
     }
     /** Lightweight snapshot for list views — omits output and messages. */
@@ -1453,19 +1474,36 @@ export class ProcessManager extends EventEmitter {
      */
     handleBridgeEvent(record, event) {
         switch (event.type) {
-            case "output.raw":
+            case "output.raw": {
+                record.output = record.ptyBridge?.getRawOutput() ?? record.output;
+                this.emitEvent({
+                    type: "output",
+                    sessionId: event.sessionId,
+                    data: {
+                        incremental: true,
+                        chunk: event.data.chunk,
+                        permissionBlocked: this.isPermissionBlocked(record),
+                    },
+                });
+                break;
+            }
             case "output.chat": {
-                // Sync record.output from bridge before emitting so the event carries fresh data
                 record.output = record.ptyBridge?.getRawOutput() ?? record.output;
                 const rawMessages = record.ptyBridge?.getMessages() ?? [];
-                const messages = truncateMessagesForTransport(rawMessages, this.config.cardDefaults ?? {}, rawMessages.length - 1);
+                const isStreaming = record.status === "running";
                 const data = {
-                    output: record.output,
-                    messages,
                     permissionBlocked: this.isPermissionBlocked(record),
                 };
-                if (event.type === "output.raw") {
-                    data.chunk = event.data.chunk;
+                if (isStreaming && rawMessages.length > 0) {
+                    data.incremental = true;
+                    const lastTurn = rawMessages[rawMessages.length - 1];
+                    const truncatedLast = truncateMessagesForTransport([lastTurn], this.config.cardDefaults ?? {}, 0);
+                    data.lastMessage = truncatedLast[0];
+                    data.messageCount = rawMessages.length;
+                }
+                else {
+                    data.output = record.output;
+                    data.messages = truncateMessagesForTransport(rawMessages, this.config.cardDefaults ?? {}, rawMessages.length - 1);
                 }
                 this.emitEvent({
                     type: "output",
@@ -1607,7 +1645,7 @@ export class ProcessManager extends EventEmitter {
         }
         return false;
     }
-    processCommandForMode(command, mode, provider) {
+    processCommandForMode(command, mode, provider, model) {
         if (provider === "codex") {
             if (mode !== "full-access") {
                 return command;
@@ -1621,6 +1659,11 @@ export class ProcessManager extends EventEmitter {
         if (!isClaudeCmd)
             return command;
         let result = command;
+        const trimmedModel = model?.trim();
+        if (trimmedModel && trimmedModel !== "default" && !/--model\s/.test(command)) {
+            const escapedModel = trimmedModel.replace(/'/g, "'\\''");
+            result += ` --model '${escapedModel}'`;
+        }
         const hasPermFlag = /--permission-mode\s/.test(command);
         if (!hasPermFlag) {
             if (isRunningAsRoot()) {
@@ -1638,14 +1681,19 @@ export class ProcessManager extends EventEmitter {
                 }
             }
         }
+        const language = this.config.language?.trim();
+        const isChinese = language === "中文";
         if (mode === "managed") {
-            const autonomousPrompt = "You are running in a fully managed, autonomous mode. The user may not be available to respond to questions or confirmations in a timely manner. You MUST make all decisions independently — choose the best approach yourself instead of asking the user for preferences, confirmations, or clarifications. If multiple approaches are viable, pick the one you judge most appropriate and proceed. Never block on user input unless the task is fundamentally ambiguous and cannot be reasonably inferred. Be decisive and self-directed.";
+            const autonomousPrompt = isChinese
+                ? "你正在完全托管的自主模式下运行。用户可能无法及时回复问题或确认。你必须独立做出所有决策——自行选择最佳方案，而不是向用户询问偏好、确认或澄清。如果有多种可行方案，选择你认为最合适的并继续执行。除非任务本身存在根本性的歧义且无法合理推断，否则不要等待用户输入。果断行动，自主决策。"
+                : "You are running in a fully managed, autonomous mode. The user may not be available to respond to questions or confirmations in a timely manner. You MUST make all decisions independently — choose the best approach yourself instead of asking the user for preferences, confirmations, or clarifications. If multiple approaches are viable, pick the one you judge most appropriate and proceed. Never block on user input unless the task is fundamentally ambiguous and cannot be reasonably inferred. Be decisive and self-directed.";
             const escaped = autonomousPrompt.replace(/'/g, "'\\''");
             result += ` --append-system-prompt '${escaped}'`;
         }
-        const language = this.config.language?.trim();
         if (language) {
-            const langPrompt = `Please respond in ${language}. Use ${language} for all your explanations, comments, and conversational text.`;
+            const langPrompt = isChinese
+                ? "请使用中文回复。所有解释、注释和对话文本都使用中文。"
+                : `Please respond in ${language}. Use ${language} for all your explanations, comments, and conversational text.`;
             const escaped = langPrompt.replace(/'/g, "'\\''");
             result += ` --append-system-prompt '${escaped}'`;
         }

package/dist/pty-text-utils.d.ts

@@ -11,6 +11,13 @@ export declare function isNoiseLine(line: string): boolean;
 export declare function appendWindow(buffer: string, chunk: string, maxSize: number): string;
 export declare function hasExplicitConfirmSyntax(normalized: string): boolean;
 export declare function hasPermissionActionContext(normalized: string): boolean;
+/**
+ * Detect Claude CLI slash-command selection menus (/model, /effort, /output-style, etc.).
+ * These share "Enter to confirm" with permission prompts but are user-driven choices
+ * that must never be auto-approved. Distinguishing footer: "Esc to exit" (vs permission
+ * prompts' "Esc to cancel" / "Tab to amend").
+ */
+export declare function isSlashCommandMenu(normalized: string): boolean;
 interface PermissionScore {
     score: number;
     matched: string[];

package/dist/pty-text-utils.js

@@ -144,6 +144,15 @@ export function hasExplicitConfirmSyntax(normalized) {
 export function hasPermissionActionContext(normalized) {
     return PERMISSION_ACTION_PATTERNS.some((pattern) => pattern.test(normalized));
 }
+/**
+ * Detect Claude CLI slash-command selection menus (/model, /effort, /output-style, etc.).
+ * These share "Enter to confirm" with permission prompts but are user-driven choices
+ * that must never be auto-approved. Distinguishing footer: "Esc to exit" (vs permission
+ * prompts' "Esc to cancel" / "Tab to amend").
+ */
+export function isSlashCommandMenu(normalized) {
+    return /\besc\s+to\s+exit\b/i.test(normalized);
+}
 const PERMISSION_KEYWORD_WEIGHTS = [
     { pattern: /\bdo you want to proceed\b/i, weight: 5, label: "do you want to proceed" },
     { pattern: /\bwould you like to proceed\b/i, weight: 5, label: "would you like to proceed" },
@@ -168,6 +177,11 @@ export function scorePermissionLikelihood(normalized) {
     // Take the last ~5 lines
     const lines = normalized.split("\n");
     const tail = lines.slice(-8).join("\n");
+    // Slash-command menus are never permission prompts — zero the score so
+    // fallback auto-approve and idle-probe both skip them.
+    if (isSlashCommandMenu(tail)) {
+        return { score: 0, matched: [] };
+    }
     let score = 0;
     const matched = [];
     for (const { pattern, weight, label } of PERMISSION_KEYWORD_WEIGHTS) {

package/dist/pwa.js

@@ -1,8 +1,15 @@
 /**
  * PWA manifest and Service Worker generation.
  */
-/** Cache version is fixed per server process to avoid mid-session cache busting */
-const CACHE_VERSION = Date.now().toString(36);
+import { readFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkgPath = path.join(__dirname, "..", "package.json");
+const pkgVersion = JSON.parse(readFileSync(pkgPath, "utf-8")).version ?? "0";
+/** Cache version derived from package version — only busts on actual releases */
+const CACHE_VERSION = createHash("md5").update(pkgVersion).digest("hex").slice(0, 8);
 export function generatePwaManifest() {
     return JSON.stringify({
         id: "/wand",
@@ -46,10 +53,8 @@ const STATIC_ASSETS = [
   '/icon.svg',
   '/icon-192.png',
   '/icon-512.png',
-  '/vendor/xterm/css/xterm.css',
-  '/vendor/xterm/lib/xterm.js',
-  '/vendor/xterm-addon-fit/lib/addon-fit.js',
-  '/vendor/xterm-addon-serialize/lib/xterm-addon-serialize.js'
+  '/vendor/wterm/terminal.css',
+  '/vendor/wterm/wterm.bundle.js'
 ];
 
 self.addEventListener('install', (event) => {

package/dist/server-session-routes.js

@@ -144,7 +144,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
     });
     app.post("/api/structured-sessions", express.json(), async (req, res) => {
         const body = req.body;
-        console.log("[WAND] POST /api/structured-sessions body:", JSON.stringify({ cwd: body.cwd, mode: body.mode, runner: body.runner, provider: body.provider, worktreeEnabled: body.worktreeEnabled === true, hasPrompt: !!body.prompt }));
+        console.log("[WAND] POST /api/structured-sessions body:", JSON.stringify({ cwd: body.cwd, mode: body.mode, runner: body.runner, provider: body.provider, worktreeEnabled: body.worktreeEnabled === true, hasPrompt: !!body.prompt, model: body.model }));
         try {
             if (body.provider && body.provider !== "claude") {
                 res.status(400).json({ error: "结构化会话当前仅支持 Claude provider。" });
@@ -156,6 +156,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
                 prompt: body.prompt,
                 runner: body.runner ?? "claude-cli-print",
                 worktreeEnabled: body.worktreeEnabled === true,
+                model: typeof body.model === "string" ? body.model.trim() : undefined,
             });
             console.log("[WAND] structured session created:", JSON.stringify({ id: snapshot.id, sessionKind: snapshot.sessionKind, runner: snapshot.runner, status: snapshot.status }));
             res.status(201).json(snapshot);
@@ -164,6 +165,29 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(400).json({ error: getErrorMessage(error, "无法启动结构化会话。") });
         }
     });
+    app.post("/api/sessions/:id/model", express.json(), (req, res) => {
+        const body = req.body;
+        const rawModel = typeof body?.model === "string" ? body.model.trim() : null;
+        const id = req.params.id;
+        try {
+            const structuredSnapshot = structured.get(id);
+            if (structuredSnapshot) {
+                const updated = structured.setSessionModel(id, rawModel);
+                res.json(updated);
+                return;
+            }
+            const ptySnapshot = processes.get(id);
+            if (!ptySnapshot) {
+                res.status(404).json({ error: "未找到该会话。" });
+                return;
+            }
+            const updated = processes.setSessionModel(id, rawModel);
+            res.json(updated);
+        }
+        catch (error) {
+            res.status(400).json({ error: getErrorMessage(error, "切换模型失败。") });
+        }
+    });
     app.get("/api/structured-sessions/:id/messages", (req, res) => {
         const snapshot = structured.get(req.params.id);
         if (!snapshot) {