@co0ontty/wand 4.13.0 → 4.14.0-beta.ga6331de

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "95fe372be4bebb2e489b287ddc8de993291d390c",
-  "builtAt": "2026-07-17T21:08:20.623Z",
-  "version": "4.13.0",
-  "channel": "stable"
+  "commit": "a6331de5ad360ff5cd861a4ffe8bc5dc37f56562",
+  "builtAt": "2026-07-18T00:02:04.661Z",
+  "version": "4.14.0-beta.ga6331de",
+  "channel": "beta"
 }

package/dist/git-quick-commit.d.ts

@@ -25,7 +25,7 @@ interface QuickCommitOptions {
      */
     submodule?: boolean;
 }
-interface QuickCommitAiOptions {
+export interface QuickCommitAiOptions {
     provider?: SessionProvider;
     model?: string | null;
     thinkingEffort?: SessionSnapshot["thinkingEffort"];
@@ -37,6 +37,11 @@ export declare class QuickCommitError extends Error {
     readonly code: QuickCommitErrorCode;
     constructor(message: string, code: QuickCommitErrorCode);
 }
+/**
+ * Run a lightweight AI request through the same source ordering used by quick
+ * commit: the user's selected source first, then the reciprocal source once.
+ */
+export declare function callConfiguredAiText(prompt: string, cwd: string, language: string, opts: QuickCommitAiOptions): Promise<string>;
 export interface GenerateCommitMessageResult {
     message: string;
     /** AI-suggested next tag derived from the staged diff and the latest existing tag. */

package/dist/git-quick-commit.js

@@ -625,7 +625,11 @@ function aiFallbackFailed(primary, primaryError, fallbackError) {
     const fallback = primary === "直连 API" ? "CLI" : "直连 API";
     return new QuickCommitError(`${primary} 与 ${fallback} 均失败：${getGitErrorMessage(primaryError)}；${getGitErrorMessage(fallbackError)}`, "AI_FALLBACK_FAILED");
 }
-async function callAiText(prompt, cwd, language, opts) {
+/**
+ * Run a lightweight AI request through the same source ordering used by quick
+ * commit: the user's selected source first, then the reciprocal source once.
+ */
+export async function callConfiguredAiText(prompt, cwd, language, opts) {
     if (opts.systemAi?.enabled) {
         try {
             return await callDirectApiText(prompt, opts.systemAi);
@@ -682,7 +686,7 @@ async function generateCommitMessage(cwd, language, ai = {}) {
     const diff = await collectStagedDiff(cwd);
     const lang = language.trim() || "中文";
     const prompt = `阅读以下 git diff，用${lang}写一条简洁的 commit message。要求：祈使句，不超过 50 字，描述「做了什么」。只输出 message 本身，不要引号、不要 Markdown 格式、不要任何额外说明。\n\n${diff}`;
-    const raw = await callAiText(prompt, cwd, language, ai);
+    const raw = await callConfiguredAiText(prompt, cwd, language, ai);
     const message = normalizeAiText(raw);
     if (!message) {
         throw new QuickCommitError("AI 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
@@ -738,7 +742,7 @@ async function generateCommitMessageWithTag(cwd, language, ai = {}) {
 
 git diff:
 ${diff}`;
-    const raw = await callAiText(prompt, cwd, language, ai);
+    const raw = await callConfiguredAiText(prompt, cwd, language, ai);
     const parsed = tryParseJson(raw);
     let message;
     let suggestedTag;
@@ -812,7 +816,7 @@ commit message：${commitMessage}
 
 git diff：
 ${diff}`;
-    const raw = await callAiText(prompt, cwd, language, ai);
+    const raw = await callConfiguredAiText(prompt, cwd, language, ai);
     const parsed = tryParseJson(raw);
     let suggested;
     if (parsed && typeof parsed.tag === "string") {

package/dist/process-manager.d.ts

@@ -29,7 +29,7 @@ export declare class ProcessManager extends EventEmitter {
     private readonly dirtySessions;
     /** 启动时被识别为孤儿 PTY 并标记为 exited 的旧会话数（旧服务器进程已死） */
     private orphanRecoveredCount;
-    private readonly topicRequests;
+    private readonly topicCoordinator;
     private disposed;
     constructor(config: WandConfig, storage: WandStorage, configDir?: string);
     on(_event: "process", listener: ProcessEventHandler): this;
@@ -102,6 +102,7 @@ export declare class ProcessManager extends EventEmitter {
     private snapshotSlim;
     private isPermissionBlocked;
     setSessionTopic(id: string, title: string, description: string): SessionSnapshot;
+    private setSessionTopicGenerating;
     /**
      * Persist worktree merge progress through the manager that owns the live
      * session record. Returning null lets callers fall back to another owner (or

package/dist/process-manager.js

@@ -16,8 +16,9 @@ import { buildLanguageDirective, buildManagedAutonomyDirective } from "./languag
 import { prepareSessionWorktree } from "./git-worktree.js";
 import { getProviderCommandSessionId, getProviderResumeCommandSessionId } from "./resume-policy.js";
 import { normalizeThinkingEffort, thinkingEffortToClaudeCliEffort, thinkingEffortToClaudeSlashEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant } from "./structured-provider-common.js";
-import { generateSessionTopic } from "./session-topic.js";
+import { SessionTopicCoordinator } from "./session-topic.js";
 import { getErrorMessage } from "./error-utils.js";
+import { resolveCommitAiContext } from "./session-ai-context.js";
 import { resolveSessionCwd } from "./session-cwd.js";
 import { ProviderHistoryScanner, } from "./provider-history-scanner.js";
 function resolveProviderFromCommand(command) {
@@ -529,7 +530,7 @@ export class ProcessManager extends EventEmitter {
     dirtySessions = new Map();
     /** 启动时被识别为孤儿 PTY 并标记为 exited 的旧会话数（旧服务器进程已死） */
     orphanRecoveredCount = 0;
-    topicRequests = new Set();
+    topicCoordinator = new SessionTopicCoordinator();
     disposed = false;
     constructor(config, storage, configDir) {
         super();
@@ -624,6 +625,7 @@ export class ProcessManager extends EventEmitter {
                     openCodeSessionDiscoveryTimer: null,
                     claudeSessionId: restoredSessionId ?? updated.claudeSessionId,
                     approvalStats: snapshot.approvalStats ?? { tool: 0, command: 0, file: 0, total: 0 },
+                    titleGenerating: false,
                     ptyCols: snapshot.ptyCols ?? 120,
                     ptyRows: snapshot.ptyRows ?? 36,
                 });
@@ -669,6 +671,7 @@ export class ProcessManager extends EventEmitter {
                     openCodeSessionDiscoveryTimer: null,
                     claudeSessionId: restoredSessionId ?? updated.claudeSessionId,
                     approvalStats: snapshot.approvalStats ?? { tool: 0, command: 0, file: 0, total: 0 },
+                    titleGenerating: false,
                     ptyCols: snapshot.ptyCols ?? 120,
                     ptyRows: snapshot.ptyRows ?? 36,
                 });
@@ -726,7 +729,7 @@ export class ProcessManager extends EventEmitter {
                 catch { /* best-effort shutdown flush */ }
             }
         }
-        this.topicRequests.clear();
+        this.topicCoordinator.clear();
         this.removeAllListeners("process");
         this.logger.dispose();
     }
@@ -1672,10 +1675,17 @@ export class ProcessManager extends EventEmitter {
         record.title = title;
         record.description = description;
         const snapshot = this.snapshot(record);
-        this.storage.updateSessionRuntimeMetadata(snapshot);
+        this.storage.updateSessionRuntimeMetadata({ ...snapshot, titleGenerating: undefined });
         this.emitEvent({ type: "output", sessionId: id, data: { title, description, summary: description } });
         return snapshot;
     }
+    setSessionTopicGenerating(id, titleGenerating) {
+        const record = this.sessions.get(id);
+        if (!record || record.titleGenerating === titleGenerating)
+            return;
+        record.titleGenerating = titleGenerating;
+        this.emitEvent({ type: "output", sessionId: id, data: { titleGenerating } });
+    }
     /**
      * Persist worktree merge progress through the manager that owns the live
      * session record. Returning null lets callers fall back to another owner (or
@@ -1703,16 +1713,26 @@ export class ProcessManager extends EventEmitter {
     maybeGenerateSessionTopic(id, input) {
         const prompt = input.trim();
         const record = this.sessions.get(id);
-        if (this.disposed || !prompt || !record || record.title || this.topicRequests.has(id))
+        if (this.disposed || !prompt || !record)
             return;
-        this.topicRequests.add(id);
-        void generateSessionTopic(prompt, record.cwd, this.config.language, this.config.systemAi)
-            .then(({ title, description }) => {
-            if (!this.disposed && this.sessions.has(id))
-                this.setSessionTopic(id, title, description);
-        })
-            .catch((error) => console.error(`[ProcessManager] Failed to generate session topic ${id}:`, getErrorMessage(error)))
-            .finally(() => this.topicRequests.delete(id));
+        this.topicCoordinator.request(id, {
+            messages: snapshotMessages(record),
+            input: prompt,
+            cwd: record.cwd,
+            language: this.config.language,
+            ai: resolveCommitAiContext(record, this.config),
+            onGenerating: (generating) => {
+                if (!this.disposed)
+                    this.setSessionTopicGenerating(id, generating);
+            },
+            onTopic: ({ title, description }) => {
+                if (!this.disposed && this.sessions.has(id))
+                    this.setSessionTopic(id, title, description);
+            },
+            onError: (error) => {
+                console.error(`[ProcessManager] Failed to generate session topic ${id}:`, getErrorMessage(error));
+            },
+        });
     }
     defaultAutonomyPolicy(mode) {
         if (mode === "agent" || mode === "agent-max" || mode === "managed" || mode === "native" || mode === "full-access") {

package/dist/session-topic.d.ts

@@ -1,6 +1,32 @@
-import type { SystemAiConfig } from "./types.js";
+import { type QuickCommitAiOptions } from "./git-quick-commit.js";
+import type { ConversationTurn } from "./types.js";
 export interface SessionTopic {
     title: string;
     description: string;
 }
-export declare function generateSessionTopic(userMessage: string, cwd?: string, language?: string, systemAi?: SystemAiConfig): Promise<SessionTopic>;
+export interface SessionTopicRequest {
+    messages?: readonly ConversationTurn[];
+    input: string;
+    cwd?: string;
+    language?: string;
+    ai?: QuickCommitAiOptions;
+    onGenerating(generating: boolean): void;
+    onTopic(topic: SessionTopic): void;
+    onError(error: unknown): void;
+}
+/** Collect every completed user turn plus the newly submitted input in order. */
+export declare function collectSessionTopicMessages(messages: readonly ConversationTurn[] | undefined, input: string): string[];
+export declare function generateSessionTopic(userMessages: readonly string[], cwd?: string, language?: string, ai?: QuickCommitAiOptions): Promise<SessionTopic>;
+/**
+ * Coalesces title refreshes per session. A newer user message invalidates an
+ * in-flight result and is summarized together with every earlier user turn.
+ */
+export declare class SessionTopicCoordinator {
+    private readonly generate;
+    private readonly states;
+    private disposed;
+    constructor(generate?: typeof generateSessionTopic);
+    request(sessionId: string, request: SessionTopicRequest): void;
+    clear(): void;
+    private run;
+}

package/dist/session-topic.js

@@ -1,6 +1,4 @@
-import { runClaudePrint } from "./claude-sdk-runner.js";
-import { callSystemAiText } from "./system-ai.js";
-const TOPIC_TIMEOUT_MS = 45_000;
+import { callConfiguredAiText } from "./git-quick-commit.js";
 const MAX_PROMPT_LENGTH = 12_000;
 function cleanTopicText(value, maxLength) {
     if (typeof value !== "string")
@@ -21,24 +19,123 @@ function parseTopic(raw) {
         return null;
     }
 }
-export async function generateSessionTopic(userMessage, cwd, language, systemAi) {
-    const input = userMessage.trim().slice(0, MAX_PROMPT_LENGTH);
+function turnText(turn) {
+    return turn.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text.trim())
+        .filter(Boolean)
+        .join("\n")
+        .trim();
+}
+/** Collect every completed user turn plus the newly submitted input in order. */
+export function collectSessionTopicMessages(messages, input) {
+    const collected = (messages ?? [])
+        .filter((turn) => turn.role === "user")
+        .map(turnText)
+        .filter(Boolean);
+    const next = input.trim();
+    if (next)
+        collected.push(next);
+    return collected;
+}
+function topicConversationInput(userMessages) {
+    const sections = userMessages.map((message, index) => `第 ${index + 1} 轮：\n${message.trim()}`);
+    const kept = [];
+    let remaining = MAX_PROMPT_LENGTH;
+    for (let index = sections.length - 1; index >= 0 && remaining > 0; index -= 1) {
+        const section = sections[index];
+        const value = section.length <= remaining ? section : section.slice(section.length - remaining);
+        kept.unshift(value);
+        remaining -= value.length + 2;
+    }
+    return kept.join("\n\n");
+}
+export async function generateSessionTopic(userMessages, cwd, language, ai = {}) {
+    const input = topicConversationInput(userMessages);
+    if (!input)
+        throw new Error("没有可总结的用户消息。");
     const outputLanguage = language?.trim() || "与用户消息相同的语言";
     const prompt = [
-        "请总结下面这条用户发给编码助手的首条消息，用于会话列表展示。",
+        "请综合总结下面这段用户与编码助手对话中的所有用户消息，用于会话列表展示。",
         `使用${outputLanguage}输出。`,
         "只输出一个 JSON 对象，不要 Markdown、解释或额外文字。",
         '格式：{"title":"不超过20个字的具体主题标题","description":"不超过60个字的一句话任务描述"}',
-        "标题避免使用“关于”“请求”“任务”等空泛词，描述保留最重要的目标和对象。",
+        "标题避免使用“关于”“请求”“任务”等空泛词，描述保留当前整体目标、关键对象和新增要求。",
+        "后续轮次与前面目标有关时必须共同概括；发生目标切换时优先反映最新目标，同时保留仍有效的上下文。",
         "",
-        "用户消息：",
+        "按发送顺序排列的用户消息：",
         input,
     ].join("\n");
-    const raw = systemAi?.enabled
-        ? await callSystemAiText(prompt, systemAi, TOPIC_TIMEOUT_MS)
-        : await runClaudePrint(prompt, { cwd, timeoutMs: TOPIC_TIMEOUT_MS, language });
+    const raw = await callConfiguredAiText(prompt, cwd ?? process.cwd(), language ?? "", ai);
     const topic = parseTopic(raw);
     if (!topic)
         throw new Error("模型返回的会话主题格式无效。");
     return topic;
 }
+/**
+ * Coalesces title refreshes per session. A newer user message invalidates an
+ * in-flight result and is summarized together with every earlier user turn.
+ */
+export class SessionTopicCoordinator {
+    generate;
+    states = new Map();
+    disposed = false;
+    constructor(generate = generateSessionTopic) {
+        this.generate = generate;
+    }
+    request(sessionId, request) {
+        if (this.disposed)
+            return;
+        const input = request.input.trim();
+        if (!input)
+            return;
+        let state = this.states.get(sessionId);
+        if (!state) {
+            state = {
+                revision: 0,
+                running: false,
+                userMessages: collectSessionTopicMessages(request.messages, input),
+                request,
+            };
+            this.states.set(sessionId, state);
+        }
+        else {
+            state.userMessages.push(input);
+            state.request = request;
+        }
+        state.revision += 1;
+        if (!state.running) {
+            state.running = true;
+            request.onGenerating(true);
+            void this.run(sessionId, state);
+        }
+    }
+    clear() {
+        this.disposed = true;
+        this.states.clear();
+    }
+    async run(sessionId, state) {
+        const revision = state.revision;
+        const request = state.request;
+        const userMessages = state.userMessages.slice();
+        try {
+            const topic = await this.generate(userMessages, request.cwd, request.language, request.ai);
+            if (!this.disposed && this.states.get(sessionId) === state && state.revision === revision) {
+                state.request.onTopic(topic);
+            }
+        }
+        catch (error) {
+            if (!this.disposed && this.states.get(sessionId) === state && state.revision === revision) {
+                state.request.onError(error);
+            }
+        }
+        if (this.disposed || this.states.get(sessionId) !== state)
+            return;
+        if (state.revision !== revision) {
+            await this.run(sessionId, state);
+            return;
+        }
+        state.running = false;
+        state.request.onGenerating(false);
+    }
+}

package/dist/structured-session-manager.d.ts

@@ -78,7 +78,7 @@ export declare class StructuredSessionManager {
     private readonly seenIdempotencyKeys;
     private emitEvent;
     private archiveTimer;
-    private readonly topicRequests;
+    private readonly topicCoordinator;
     private readonly streamEmitTimers;
     private readonly claudeCliRunner;
     private readonly codexRunner;
@@ -105,6 +105,7 @@ export declare class StructuredSessionManager {
     listSlim(): SessionSnapshot[];
     get(id: string): SessionSnapshot | null;
     setSessionTopic(id: string, title: string, description: string): SessionSnapshot;
+    private setSessionTopicGenerating;
     /**
      * Update worktree merge progress on the canonical in-memory snapshot before
      * persisting it. A null result means this manager does not own the session.

package/dist/structured-session-manager.js

@@ -5,8 +5,9 @@ import { truncateMessagesForTransport } from "./message-truncator.js";
 import { buildChildEnv } from "./env-utils.js";
 import { getErrorMessage } from "./error-utils.js";
 import { resolveSdkClaudeBinary } from "./claude-sdk-runner.js";
-import { generateSessionTopic } from "./session-topic.js";
+import { SessionTopicCoordinator } from "./session-topic.js";
 import { resolveSessionCwd } from "./session-cwd.js";
+import { resolveCommitAiContext } from "./session-ai-context.js";
 import { CodexRunner } from "./structured-codex-adapter.js";
 import { normalizeStructuredToolResultContent } from "./structured-content.js";
 import { buildAppendSystemPromptParts, buildClaudeSdkThinking, ClaudeCliRunner, derivePermissionPolicy, } from "./structured-claude-adapter.js";
@@ -198,7 +199,7 @@ export class StructuredSessionManager {
     seenIdempotencyKeys = new Map();
     emitEvent = null;
     archiveTimer = null;
-    topicRequests = new Set();
+    topicCoordinator = new SessionTopicCoordinator();
     streamEmitTimers = new Set();
     claudeCliRunner;
     codexRunner;
@@ -252,6 +253,7 @@ export class StructuredSessionManager {
                     activeRequestId: null,
                 },
                 selectedModel: snapshot.selectedModel ?? null,
+                titleGenerating: false,
             };
             this.sessions.set(restored.id, restored);
             this.storage.saveSession(restored);
@@ -347,7 +349,7 @@ export class StructuredSessionManager {
         this.streamCheckpointTimers.clear();
         this.streamCheckpointDirty.clear();
         this.lastStreamSaveAt.clear();
-        this.topicRequests.clear();
+        this.topicCoordinator.clear();
         this.emitEvent = null;
     }
     trackStreamEmitTimer(timer) {
@@ -452,10 +454,18 @@ export class StructuredSessionManager {
         const current = this.requireSession(id);
         const updated = { ...current, title, description, summary: description };
         this.sessions.set(id, updated);
-        this.storage.updateSessionRuntimeMetadata(updated);
+        this.storage.updateSessionRuntimeMetadata({ ...updated, titleGenerating: undefined });
         this.emitStructuredSnapshot(updated);
         return updated;
     }
+    setSessionTopicGenerating(id, titleGenerating) {
+        const current = this.sessions.get(id);
+        if (!current || current.titleGenerating === titleGenerating)
+            return;
+        const updated = { ...current, titleGenerating };
+        this.sessions.set(id, updated);
+        this.emit({ type: "output", sessionId: id, data: { sessionKind: "structured", titleGenerating } });
+    }
     /**
      * Update worktree merge progress on the canonical in-memory snapshot before
      * persisting it. A null result means this manager does not own the session.
@@ -484,16 +494,26 @@ export class StructuredSessionManager {
     }
     maybeGenerateSessionTopic(id, input) {
         const session = this.sessions.get(id);
-        if (this.disposed || !session || session.title || this.topicRequests.has(id))
+        if (this.disposed || !session || !input.trim())
             return;
-        this.topicRequests.add(id);
-        void generateSessionTopic(input, session.cwd, this.config.language, this.config.systemAi)
-            .then(({ title, description }) => {
-            if (!this.disposed && this.sessions.has(id))
-                this.setSessionTopic(id, title, description);
-        })
-            .catch((error) => console.error(`[StructuredSessionManager] Failed to generate session topic ${id}:`, getErrorMessage(error)))
-            .finally(() => this.topicRequests.delete(id));
+        this.topicCoordinator.request(id, {
+            messages: session.messages,
+            input,
+            cwd: session.cwd,
+            language: this.config.language,
+            ai: resolveCommitAiContext(session, this.config),
+            onGenerating: (generating) => {
+                if (!this.disposed)
+                    this.setSessionTopicGenerating(id, generating);
+            },
+            onTopic: ({ title, description }) => {
+                if (!this.disposed && this.sessions.has(id))
+                    this.setSessionTopic(id, title, description);
+            },
+            onError: (error) => {
+                console.error(`[StructuredSessionManager] Failed to generate session topic ${id}:`, getErrorMessage(error));
+            },
+        });
     }
     createSession(options) {
         if (this.disposed)
@@ -570,7 +590,6 @@ export class StructuredSessionManager {
         const prompt = input.trim();
         if (!prompt)
             return session;
-        this.maybeGenerateSessionTopic(id, prompt);
         if (opts?.idempotencyKey) {
             const mapKey = `${id}:${opts.idempotencyKey}`;
             if (this.seenIdempotencyKeys.has(mapKey)) {
@@ -587,6 +606,7 @@ export class StructuredSessionManager {
                 }
             }
         }
+        this.maybeGenerateSessionTopic(id, prompt);
         if (session.structuredState?.inFlight) {
             const runnerExecution = this.pendingRunnerExecutions.get(id);
             const sdkAbort = this.pendingSdkAbort.get(id);

package/dist/types.d.ts

@@ -525,10 +525,12 @@ export interface SessionSnapshot {
     };
     /** 会话摘要：从首条用户消息或当前任务提取 */
     summary?: string;
-    /** 由模型根据首条用户消息生成的短标题。 */
+    /** 由模型根据全部用户消息生成的短标题。 */
     title?: string;
-    /** 由模型根据首条用户消息生成的一句话描述。 */
+    /** 由模型根据全部用户消息生成的一句话描述。 */
     description?: string;
+    /** 会话标题正在根据最新消息重新生成；仅用于实时展示，重启时强制清空。 */
+    titleGenerating?: boolean;
     /** 当前正在执行的任务标题（用于会话列表展示） */
     currentTaskTitle?: string;
     /** 用户为此会话选定的 Claude 模型（别名或完整 ID）。结构化会话下次 spawn 时使用；PTY 会话仅用于展示。 */