@co0ontty/wand 4.49.0 → 4.50.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "e521372a025630229f6976b2c6800084e851a8e7",
-  "builtAt": "2026-08-23T23:10:59.104Z",
-  "version": "4.49.0",
+  "commit": "9ef09d524d2ae51803783b8064ebeee58110edf4",
+  "builtAt": "2026-08-24T01:04:59.373Z",
+  "version": "4.50.0",
   "channel": "stable"
 }

package/dist/process-manager.js

@@ -14,7 +14,7 @@ import { buildLanguageDirective, buildManagedAutonomyDirective } from "./languag
 import { prepareSessionWorktree } from "./git-worktree.js";
 import { getProviderCommandSessionId, getProviderResumeCommandSessionId } from "./resume-policy.js";
 import { normalizeThinkingEffort, thinkingEffortToClaudeCliEffort, thinkingEffortToClaudeSlashEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToPiLevel } from "./structured-provider-common.js";
-import { SessionTopicCoordinator, shouldGenerateSessionTopicFromPtyInput } from "./session-topic.js";
+import { provisionalSessionTopic, SessionTopicCoordinator, sessionTopicBlocklistForSnapshot, shouldAcceptGeneratedSessionTitle, shouldGenerateSessionTopicFromPtyInput, } from "./session-topic.js";
 import { getErrorMessage } from "./error-utils.js";
 import { resolveSystemAiContext } from "./session-ai-context.js";
 import { resolveSessionCwd } from "./session-cwd.js";
@@ -1925,6 +1925,11 @@ export class ProcessManager extends EventEmitter {
         const record = this.sessions.get(id);
         if (this.disposed || !prompt || !record)
             return;
+        const blockedTitles = sessionTopicBlocklistForSnapshot(record, this.storage);
+        const provisional = provisionalSessionTopic(prompt, blockedTitles);
+        if (provisional && (record.title !== provisional.title || record.description !== provisional.description)) {
+            this.setSessionTopic(id, provisional.title, provisional.description);
+        }
         this.topicCoordinator.request(id, {
             messages: snapshotMessages(record),
             input: prompt,
@@ -1936,8 +1941,9 @@ export class ProcessManager extends EventEmitter {
                     this.setSessionTopicGenerating(id, generating);
             },
             onTopic: ({ title, description }) => {
-                if (!this.disposed && this.sessions.has(id))
+                if (!this.disposed && this.sessions.has(id) && shouldAcceptGeneratedSessionTitle(title, blockedTitles)) {
                     this.setSessionTopic(id, title, description);
+                }
             },
             onError: (error) => {
                 console.error(`[ProcessManager] Failed to generate session topic ${id}:`, getErrorMessage(error));

package/dist/server-workspace-routes.js

@@ -5,9 +5,17 @@ import { asyncRoute } from "./express-async.js";
 import { getErrorMessage } from "./error-utils.js";
 import { expandHomePath } from "./middleware/path-safety.js";
 import { checkSessionWorktreeMergeabilityAsync, cleanupWorktreeSync, prepareSessionWorktree, resolveWorktreeTargetBranchAsync, } from "./git-worktree.js";
+import { collectSessionTopicBlocklist } from "./session-topic.js";
 import { resolveSessionDisplayTitle } from "./session-transport.js";
 import { attachUnboundSessionsToWorkspace, backfillSessionWorkspaces, } from "./workspace-binding.js";
 const PROVIDERS = new Set(["claude", "codex", "opencode", "grok", "qoder", "pi"]);
+function workspaceSessionTitle(session, names = {}) {
+    return resolveSessionDisplayTitle(session, collectSessionTopicBlocklist({
+        taskName: names.taskName,
+        workspaceName: names.workspaceName,
+        cwd: session.cwd,
+    }));
+}
 function parseDefaultProvider(value) {
     return typeof value === "string" && PROVIDERS.has(value) ? value : undefined;
 }
@@ -189,7 +197,7 @@ export function registerWorkspaceRoutes(app, storage, sessions) {
             ...workspaceWithCounts(storage, workspace),
             sessions: storage.listSessionsByWorkspace(workspace.id).map((session) => ({
                 ...session,
-                title: resolveSessionDisplayTitle(session),
+                title: workspaceSessionTitle(session, { workspaceName: workspace.name }),
             })),
         });
     });
@@ -280,13 +288,13 @@ export function registerWorkspaceRoutes(app, storage, sessions) {
         const sessionLimit = parseBoundedCount(req.query.maxSessions);
         backfillSessionWorkspaces(storage);
         const workspaces = storage.listWorkspaces();
-        const summarize = (session) => ({
+        const summarize = (session, names = {}) => ({
             id: session.id,
             provider: session.provider,
             sessionKind: session.sessionKind,
             runner: session.runner,
             command: session.command,
-            title: resolveSessionDisplayTitle(session),
+            title: workspaceSessionTitle(session, names),
             status: session.status,
             cwd: session.cwd,
             startedAt: session.startedAt,
@@ -307,7 +315,7 @@ export function registerWorkspaceRoutes(app, storage, sessions) {
                     const sessions = allSessions
                         .slice(0, sessionLimit ?? undefined)
                         .map((session) => ({
-                        ...summarize(session),
+                        ...summarize(session, { taskName: task.name, workspaceName: workspace.name }),
                         workspaceTaskId: task.id,
                     }));
                     return {
@@ -357,7 +365,9 @@ export function registerWorkspaceRoutes(app, storage, sessions) {
             // workspaceId 过滤时，不属于目标目录组的会话直接排除（含合成组）。
             if (workspaceFilter && group?.workspaceId !== workspaceFilter)
                 continue;
-            group?.standaloneSessions.push(summarize(session));
+            group?.standaloneSessions.push(summarize(session, {
+                workspaceName: group.workspaceName,
+            }));
         }
         res.json([...groups.values()]);
     });
@@ -499,7 +509,13 @@ export function registerWorkspaceRoutes(app, storage, sessions) {
         res.json({
             ...task,
             cwd: task.worktree?.path ?? workspace?.cwd ?? "",
-            sessions: storage.listSessionsByWorkspaceTask(task.id),
+            sessions: storage.listSessionsByWorkspaceTask(task.id).map((session) => ({
+                ...session,
+                title: workspaceSessionTitle(session, {
+                    taskName: task.name,
+                    workspaceName: workspace?.name,
+                }),
+            })),
         });
     });
     // 改名 / 状态

package/dist/session-topic.d.ts

@@ -19,6 +19,32 @@ export interface SessionTopicRequest {
     onTopic(topic: SessionTopic): void;
     onError(error: unknown): void;
 }
+export declare function isSameSessionTitle(left: string, right: string): boolean;
+/** Parent task / directory names must not become a terminal's displayed title. */
+export declare function collectSessionTopicBlocklist(input: {
+    taskName?: string | null;
+    workspaceName?: string | null;
+    cwd?: string;
+}): string[];
+export declare function shouldAcceptGeneratedSessionTitle(title: string, blockedTitles?: readonly string[]): boolean;
+/** Immediate title from the user's command, without waiting for the model. */
+export declare function summarizeSessionTitleFromInput(input: string, options?: {
+    blockedTitles?: readonly string[];
+}): string;
+export declare function summarizeSessionDescriptionFromInput(input: string): string;
+export declare function provisionalSessionTopic(input: string, blockedTitles?: readonly string[]): SessionTopic | null;
+export declare function sessionTopicBlocklistForSnapshot(snapshot: {
+    cwd?: string;
+    workspaceTaskId?: string;
+}, storage: {
+    getWorkspaceTask(id: string): {
+        name: string;
+        workspaceId: string;
+    } | null;
+    getWorkspace(id: string): {
+        name: string;
+    } | null;
+}): string[];
 /** 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>;

package/dist/session-topic.js

@@ -7,19 +7,87 @@ const MAX_PROMPT_LENGTH = 12_000;
 export function shouldGenerateSessionTopicFromPtyInput(view, shortcutKey) {
     return view !== "terminal" || shortcutKey === "enter_text";
 }
+const TITLE_MAX_LENGTH = 24;
+const DESCRIPTION_MAX_LENGTH = 120;
 function cleanTopicText(value, maxLength) {
     if (typeof value !== "string")
         return "";
     return value.replace(/\s+/g, " ").trim().slice(0, maxLength);
 }
+function normalizeComparableTitle(value) {
+    return value.replace(/\s+/g, " ").trim().toLowerCase();
+}
+export function isSameSessionTitle(left, right) {
+    const first = normalizeComparableTitle(left);
+    const second = normalizeComparableTitle(right);
+    return Boolean(first && second && first === second);
+}
+/** Parent task / directory names must not become a terminal's displayed title. */
+export function collectSessionTopicBlocklist(input) {
+    const cwd = (input.cwd ?? "").replace(/[\\/]+$/, "");
+    return [...new Set([input.taskName, input.workspaceName, cwd.split(/[\\/]/).pop()]
+            .map((value) => value?.replace(/\s+/g, " ").trim() ?? "")
+            .filter(Boolean))];
+}
+export function shouldAcceptGeneratedSessionTitle(title, blockedTitles = []) {
+    const cleaned = title.replace(/\s+/g, " ").trim();
+    if (!cleaned || cleaned === "会话")
+        return false;
+    return !blockedTitles.some((blocked) => isSameSessionTitle(cleaned, blocked));
+}
+function clipTitle(value, maxLength = TITLE_MAX_LENGTH) {
+    if (value.length <= maxLength)
+        return value;
+    const sliced = value.slice(0, maxLength);
+    const lastSpace = sliced.lastIndexOf(" ");
+    if (lastSpace >= Math.floor(maxLength * 0.55))
+        return sliced.slice(0, lastSpace);
+    return sliced;
+}
+/** Immediate title from the user's command, without waiting for the model. */
+export function summarizeSessionTitleFromInput(input, options = {}) {
+    const blockedTitles = options.blockedTitles ?? [];
+    const lines = input
+        .split(/\r?\n/)
+        .map((part) => part.replace(/^#+\s*/, "").replace(/\s+/g, " ").trim())
+        .filter(Boolean);
+    const fallback = clipTitle(lines[0] ?? "");
+    for (const line of lines) {
+        const title = clipTitle(line);
+        if (shouldAcceptGeneratedSessionTitle(title, blockedTitles))
+            return title;
+    }
+    return fallback;
+}
+export function summarizeSessionDescriptionFromInput(input) {
+    return cleanTopicText(input, DESCRIPTION_MAX_LENGTH);
+}
+export function provisionalSessionTopic(input, blockedTitles = []) {
+    const title = summarizeSessionTitleFromInput(input, { blockedTitles });
+    if (!title)
+        return null;
+    return {
+        title,
+        description: summarizeSessionDescriptionFromInput(input) || title,
+    };
+}
+export function sessionTopicBlocklistForSnapshot(snapshot, storage) {
+    const task = snapshot.workspaceTaskId ? storage.getWorkspaceTask(snapshot.workspaceTaskId) : null;
+    const workspace = task ? storage.getWorkspace(task.workspaceId) : null;
+    return collectSessionTopicBlocklist({
+        taskName: task?.name,
+        workspaceName: workspace?.name,
+        cwd: snapshot.cwd,
+    });
+}
 function parseTopic(raw) {
     const json = raw.match(/\{[\s\S]*\}/)?.[0];
     if (!json)
         return null;
     try {
         const parsed = JSON.parse(json);
-        const title = cleanTopicText(parsed.title, 40);
-        const description = cleanTopicText(parsed.description, 120);
+        const title = cleanTopicText(parsed.title, TITLE_MAX_LENGTH);
+        const description = cleanTopicText(parsed.description, DESCRIPTION_MAX_LENGTH);
         return title && description ? { title, description } : null;
     }
     catch {
@@ -63,11 +131,12 @@ export async function generateSessionTopic(userMessages, cwd, language, ai = {})
         throw new Error("没有可总结的用户消息。");
     const outputLanguage = language?.trim() || "与用户消息相同的语言";
     const prompt = [
-        "请综合总结下面这段用户与编码助手对话中的所有用户消息，用于会话列表展示。",
+        "请综合总结下面这段用户与编码助手对话中的所有用户消息，用于单个终端/会话的列表标题。",
         `使用${outputLanguage}输出。`,
         "只输出一个 JSON 对象，不要 Markdown、解释或额外文字。",
         '格式：{"title":"不超过20个字的具体主题标题","description":"不超过60个字的一句话任务描述"}',
-        "标题避免使用“关于”“请求”“任务”等空泛词，描述保留当前整体目标、关键对象和新增要求。",
+        "标题必须概括该会话用户命令自己的具体工作，不要复述项目名、目录名或上级任务标题，也不要使用“关于”“请求”“任务”等空泛词。",
+        "描述保留当前整体目标、关键对象和新增要求。",
         "后续轮次与前面目标有关时必须共同概括；发生目标切换时优先反映最新目标，同时保留仍有效的上下文。",
         "",
         "按发送顺序排列的用户消息：",

package/dist/session-transport.d.ts

@@ -23,7 +23,7 @@ export interface SessionDetailDTO extends SessionBaseDTO {
     leadingBlockTotal?: number;
 }
 /** Resolve every client-visible title on the server so all clients show the same value. */
-export declare function resolveSessionDisplayTitle(snapshot: SessionSnapshot): string;
+export declare function resolveSessionDisplayTitle(snapshot: SessionSnapshot, blockedTitles?: readonly string[]): string;
 export declare function toSessionListItemDTO(snapshot: SessionSnapshot): SessionListItemDTO;
 export interface SessionDetailDTOOptions {
     output?: string;

package/dist/session-transport.js

@@ -1,18 +1,24 @@
 import { enrichStructuredMessages, WAND_PROTOCOL_VERSION } from "./structured-client-protocol.js";
+import { shouldAcceptGeneratedSessionTitle, summarizeSessionTitleFromInput, } from "./session-topic.js";
 export const SESSION_TRANSPORT_OUTPUT_LIMIT = 200_000;
 function cleanDisplayTitle(value) {
     return value?.replace(/\s+/g, " ").trim().slice(0, 40) ?? "";
 }
 /** Resolve every client-visible title on the server so all clients show the same value. */
-export function resolveSessionDisplayTitle(snapshot) {
-    for (const candidate of [snapshot.title, snapshot.description, snapshot.summary]) {
+export function resolveSessionDisplayTitle(snapshot, blockedTitles = []) {
+    for (const candidate of [snapshot.title, snapshot.description]) {
         const title = cleanDisplayTitle(candidate);
-        if (title)
+        if (title && shouldAcceptGeneratedSessionTitle(title, blockedTitles))
             return title;
     }
+    const fromSummary = summarizeSessionTitleFromInput(snapshot.summary ?? "", { blockedTitles });
+    if (fromSummary && shouldAcceptGeneratedSessionTitle(fromSummary, blockedTitles))
+        return fromSummary;
     const cwd = snapshot.cwd.replace(/[\\/]+$/, "");
     const directory = cleanDisplayTitle(cwd.split(/[\\/]/).pop());
-    return directory || "会话";
+    if (directory && shouldAcceptGeneratedSessionTitle(directory, blockedTitles))
+        return directory;
+    return "会话";
 }
 /** Explicit allow-list separating the server's session object from its wire DTO. */
 function sessionBase(snapshot) {

package/dist/structured-session-manager.js

@@ -5,7 +5,7 @@ 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 { SessionTopicCoordinator } from "./session-topic.js";
+import { provisionalSessionTopic, SessionTopicCoordinator, sessionTopicBlocklistForSnapshot, shouldAcceptGeneratedSessionTitle, } from "./session-topic.js";
 import { resolveSessionCwd } from "./session-cwd.js";
 import { resolveSystemAiContext } from "./session-ai-context.js";
 import { CodexRunner } from "./structured-codex-adapter.js";
@@ -889,6 +889,11 @@ export class StructuredSessionManager {
         const session = this.sessions.get(id);
         if (this.disposed || !session || !input.trim())
             return;
+        const blockedTitles = sessionTopicBlocklistForSnapshot(session, this.storage);
+        const provisional = provisionalSessionTopic(input, blockedTitles);
+        if (provisional && (session.title !== provisional.title || session.description !== provisional.description)) {
+            this.setSessionTopic(id, provisional.title, provisional.description);
+        }
         this.topicCoordinator.request(id, {
             messages: session.messages,
             input,
@@ -900,8 +905,9 @@ export class StructuredSessionManager {
                     this.setSessionTopicGenerating(id, generating);
             },
             onTopic: ({ title, description }) => {
-                if (!this.disposed && this.sessions.has(id))
+                if (!this.disposed && this.sessions.has(id) && shouldAcceptGeneratedSessionTitle(title, blockedTitles)) {
                     this.setSessionTopic(id, title, description);
+                }
             },
             onError: (error) => {
                 console.error(`[StructuredSessionManager] Failed to generate session topic ${id}:`, getErrorMessage(error));