@co0ontty/wand 1.15.1 → 1.17.4

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({
@@ -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,9 +1474,20 @@ 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 isStreaming = record.status === "running";
@@ -1463,7 +1495,6 @@ export class ProcessManager extends EventEmitter {
                     permissionBlocked: this.isPermissionBlocked(record),
                 };
                 if (isStreaming && rawMessages.length > 0) {
-                    // Incremental mode: send only chunk + last (streaming) turn
                     data.incremental = true;
                     const lastTurn = rawMessages[rawMessages.length - 1];
                     const truncatedLast = truncateMessagesForTransport([lastTurn], this.config.cardDefaults ?? {}, 0);
@@ -1471,13 +1502,9 @@ export class ProcessManager extends EventEmitter {
                     data.messageCount = rawMessages.length;
                 }
                 else {
-                    // Full mode: non-streaming or empty messages
                     data.output = record.output;
                     data.messages = truncateMessagesForTransport(rawMessages, this.config.cardDefaults ?? {}, rawMessages.length - 1);
                 }
-                if (event.type === "output.raw") {
-                    data.chunk = event.data.chunk;
-                }
                 this.emitEvent({
                     type: "output",
                     sessionId: event.sessionId,
@@ -1618,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;
@@ -1632,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()) {

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

@@ -53,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) {