@co0ontty/wand 1.58.2 → 1.59.0-beta.g811865c

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "b8a4c751866ffa12a95f41dae242e33fa4df73f1",
-  "builtAt": "2026-06-13T00:21:20.030Z",
-  "version": "1.58.2",
-  "channel": "stable"
+  "commit": "811865c1d2a63c20c1134e9048b8db5dcbed829c",
+  "builtAt": "2026-06-13T04:12:19.582Z",
+  "version": "1.59.0-beta.g811865c",
+  "channel": "beta"
 }

package/dist/process-manager.d.ts

@@ -49,6 +49,7 @@ export declare class ProcessManager extends EventEmitter {
     private readonly lastPersistedMessageState;
     /** 启动时被识别为孤儿 PTY 并标记为 exited 的旧会话数（旧服务器进程已死） */
     private orphanRecoveredCount;
+    private readonly topicRequests;
     constructor(config: WandConfig, storage: WandStorage, configDir?: string);
     on(event: "process", listener: ProcessEventHandler): this;
     /** 启动时被识别为孤儿 PTY 并标记为 exited 的旧会话数量（仅用于启动摘要展示）。 */
@@ -109,6 +110,8 @@ export declare class ProcessManager extends EventEmitter {
     /** Lightweight snapshot for list views — omits output and messages. */
     private snapshotSlim;
     private isPermissionBlocked;
+    setSessionTopic(id: string, title: string, description: string): SessionSnapshot;
+    private maybeGenerateSessionTopic;
     private defaultAutonomyPolicy;
     resolveEscalation(id: string, requestId: string, resolution?: "approve_once" | "approve_turn" | "deny"): SessionSnapshot;
     approvePermission(id: string): SessionSnapshot;

package/dist/process-manager.js

@@ -14,6 +14,8 @@ import { buildLanguageDirective, buildManagedAutonomyDirective } from "./languag
 import { prepareSessionWorktree } from "./git-worktree.js";
 import { getCodexResumeCommandSessionId, getResumeCommandSessionId } from "./resume-policy.js";
 import { applyThinkingEffortToPrompt, normalizeThinkingEffort } from "./structured-session-manager.js";
+import { generateSessionTopic } from "./session-topic.js";
+import { getErrorMessage } from "./error-utils.js";
 function resolveProviderFromCommand(command) {
     return /^codex\b/.test(command.trim()) ? "codex" : "claude";
 }
@@ -568,6 +570,7 @@ export class ProcessManager extends EventEmitter {
     lastPersistedMessageState = new Map();
     /** 启动时被识别为孤儿 PTY 并标记为 exited 的旧会话数（旧服务器进程已死） */
     orphanRecoveredCount = 0;
+    topicRequests = new Set();
     constructor(config, storage, configDir) {
         super();
         this.config = config;
@@ -930,6 +933,8 @@ export class ProcessManager extends EventEmitter {
             });
         }
         this.emitEvent({ type: "started", sessionId: id, data: this.snapshot(record) });
+        if (initialInput)
+            this.maybeGenerateSessionTopic(id, initialInput);
         let initialInputSent = false;
         const sendInitialInput = () => {
             if (initialInputSent || !initialInput)
@@ -1231,6 +1236,8 @@ export class ProcessManager extends EventEmitter {
             console.error(`[ProcessManager] Rejecting input: session ${id} has no PTY`);
             throw new SessionInputError("Session is not running.", "SESSION_NO_PTY", id, record.status);
         }
+        if (view !== "terminal")
+            this.maybeGenerateSessionTopic(id, input);
         // Log shortcut key interactions for auto-confirm and mode analysis
         if (shortcutKey) {
             const outputLines = record.output.split("\n");
@@ -1522,7 +1529,9 @@ export class ProcessManager extends EventEmitter {
             autoRecovered: record.autoRecovered ?? false,
             autoApprovePermissions: record.autoApprovePermissions || undefined,
             approvalStats: record.approvalStats.total > 0 ? record.approvalStats : undefined,
-            summary: deriveSessionSummary(messages, record.currentTask?.title ?? null),
+            summary: record.description ?? deriveSessionSummary(messages, record.currentTask?.title ?? null),
+            title: record.title,
+            description: record.description,
             currentTaskTitle: record.status === "running" ? record.currentTask?.title ?? undefined : undefined,
             selectedModel: record.selectedModel ?? null,
             thinkingEffort: record.thinkingEffort ?? null,
@@ -1542,6 +1551,29 @@ export class ProcessManager extends EventEmitter {
     isPermissionBlocked(record) {
         return record.ptyPermissionBlocked || record.pendingEscalation !== null;
     }
+    setSessionTopic(id, title, description) {
+        const record = this.mustGet(id);
+        record.title = title;
+        record.description = description;
+        const snapshot = this.snapshot(record);
+        this.storage.saveSessionMetadata(snapshot);
+        this.emitEvent({ type: "output", sessionId: id, data: { title, description, summary: description } });
+        return snapshot;
+    }
+    maybeGenerateSessionTopic(id, input) {
+        const prompt = input.trim();
+        const record = this.sessions.get(id);
+        if (!prompt || !record || record.title || this.topicRequests.has(id))
+            return;
+        this.topicRequests.add(id);
+        void generateSessionTopic(prompt, record.cwd, this.config.language)
+            .then(({ title, description }) => {
+            if (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));
+    }
     defaultAutonomyPolicy(mode) {
         if (mode === "agent" || mode === "agent-max" || mode === "managed" || mode === "native" || mode === "full-access") {
             return "agent";

package/dist/server.js

@@ -89,8 +89,8 @@ const DISPLAY_VERSION = BUILD_INFO.version || PKG_VERSION;
 let cachedGitHubApk = null;
 let gitHubApkCacheTs = 0;
 const GITHUB_APK_CACHE_TTL = 10 * 60 * 1000; // 10 minutes
-// 客户端代码没变时 CI 会跳过该平台的构建，最新 release 上可能没有 .apk/.dmg；
-// 因此不能只查 /releases/latest，要按时间倒序遍历最近的 releases，取第一个带对应产物的。
+// 按时间倒序遍历最近的 releases，取第一个带对应产物的。正常 tag release
+// 会为每个平台出包；这里保留回退以兼容旧 release 或某次平台构建失败。
 async function fetchGitHubReleaseAssetByExt(ext) {
     const apiUrl = PKG_REPO_URL.replace("github.com", "api.github.com/repos") + "/releases?per_page=30";
     const resp = await fetch(apiUrl, {
@@ -118,8 +118,8 @@ async function fetchGitHubLatestApk(forceRefresh = false) {
         const hit = await fetchGitHubReleaseAssetByExt(".apk");
         if (!hit)
             return cachedGitHubApk ?? null;
-        // 版本号优先从文件名提取：未变化的平台沿用老包，挂它的 release tag 可能更新，
-        // 用 tag 当版本会让客户端「提示新版、下载到旧包」死循环。
+        // 版本号优先从文件名提取；回退到旧 release asset 时不能把当前 release tag
+        // 误当成产物版本。
         const version = extractAndroidApkVersion(hit.asset.name)
             ?? extractAndroidApkVersion(hit.tagName)
             ?? hit.tagName.replace(/^v/, "");
@@ -193,7 +193,7 @@ async function fetchGitHubLatestDmg(forceRefresh = false) {
         const hit = await fetchGitHubReleaseAssetByExt(".dmg");
         if (!hit)
             return cachedGitHubDmg ?? null;
-        // 同 APK：版本号优先从文件名提取，避免沿用老包时把 release tag 当成新版本。
+        // 同 APK：版本号优先从文件名提取，避免回退到旧 asset 时把 release tag 当成新版本。
         const version = extractMacosDmgVersion(hit.asset.name)
             ?? extractMacosDmgVersion(hit.tagName)
             ?? hit.tagName.replace(/^v/, "");

package/dist/session-topic.d.ts

@@ -0,0 +1,5 @@
+export interface SessionTopic {
+    title: string;
+    description: string;
+}
+export declare function generateSessionTopic(userMessage: string, cwd?: string, language?: string): Promise<SessionTopic>;

package/dist/session-topic.js

@@ -0,0 +1,41 @@
+import { runClaudePrint } from "./claude-sdk-runner.js";
+const TOPIC_TIMEOUT_MS = 45_000;
+const MAX_PROMPT_LENGTH = 12_000;
+function cleanTopicText(value, maxLength) {
+    if (typeof value !== "string")
+        return "";
+    return value.replace(/\s+/g, " ").trim().slice(0, maxLength);
+}
+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);
+        return title && description ? { title, description } : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function generateSessionTopic(userMessage, cwd, language) {
+    const input = userMessage.trim().slice(0, MAX_PROMPT_LENGTH);
+    const outputLanguage = language?.trim() || "与用户消息相同的语言";
+    const prompt = [
+        "请总结下面这条用户发给编码助手的首条消息，用于会话列表展示。",
+        `使用${outputLanguage}输出。`,
+        "只输出一个 JSON 对象，不要 Markdown、解释或额外文字。",
+        '格式：{"title":"不超过20个字的具体主题标题","description":"不超过60个字的一句话任务描述"}',
+        "标题避免使用“关于”“请求”“任务”等空泛词，描述保留最重要的目标和对象。",
+        "",
+        "用户消息：",
+        input,
+    ].join("\n");
+    const raw = await runClaudePrint(prompt, { cwd, timeoutMs: TOPIC_TIMEOUT_MS, language });
+    const topic = parseTopic(raw);
+    if (!topic)
+        throw new Error("模型返回的会话主题格式无效。");
+    return topic;
+}

package/dist/storage.js

@@ -54,12 +54,12 @@ function mapWorktreeMergeFields(row) {
 }
 function sessionSelectFields() {
     return `id, provider, session_kind, runner, command, cwd, mode, status, exit_code, started_at, ended_at, output, archived, archived_at, claude_session_id, messages, queued_messages, structured_state
-             , resumed_from_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info`;
+             , resumed_from_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info, title, description`;
 }
 function sessionPersistFields() {
     return `id, command, cwd, mode, status, exit_code, started_at, ended_at, output
              , archived, archived_at, claude_session_id, provider, session_kind, runner, messages, queued_messages, structured_state
-             , resumed_from_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info`;
+             , resumed_from_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info, title, description`;
 }
 function sessionPersistAssignments() {
     return `command = excluded.command,
@@ -84,7 +84,9 @@ function sessionPersistAssignments() {
              worktree_enabled = excluded.worktree_enabled,
              worktree_info = excluded.worktree_info,
              worktree_merge_status = excluded.worktree_merge_status,
-             worktree_merge_info = excluded.worktree_merge_info`;
+             worktree_merge_info = excluded.worktree_merge_info,
+             title = excluded.title,
+             description = excluded.description`;
 }
 function sessionMetadataAssignments() {
     return `command = ?, cwd = ?, mode = ?, status = ?, exit_code = ?,
@@ -92,7 +94,8 @@ function sessionMetadataAssignments() {
            archived = ?, archived_at = ?, claude_session_id = ?,
            provider = ?, session_kind = ?, runner = ?, structured_state = ?,
            resumed_from_session_id = ?, auto_recovered = ?,
-           worktree_enabled = ?, worktree_info = ?, worktree_merge_status = ?, worktree_merge_info = ?`;
+           worktree_enabled = ?, worktree_info = ?, worktree_merge_status = ?, worktree_merge_info = ?,
+           title = ?, description = ?`;
 }
 function sessionPersistValues(snapshot) {
     return [
@@ -120,6 +123,8 @@ function sessionPersistValues(snapshot) {
         serializeWorktreeInfo(snapshot.worktree),
         snapshot.worktreeMergeStatus ?? null,
         serializeWorktreeMergeInfo(snapshot.worktreeMergeInfo),
+        snapshot.title ?? null,
+        snapshot.description ?? null,
     ];
 }
 function sessionMetadataValues(snapshot) {
@@ -145,6 +150,8 @@ function sessionMetadataValues(snapshot) {
         serializeWorktreeInfo(snapshot.worktree),
         snapshot.worktreeMergeStatus ?? null,
         serializeWorktreeMergeInfo(snapshot.worktreeMergeInfo),
+        snapshot.title ?? null,
+        snapshot.description ?? null,
         snapshot.id,
     ];
 }
@@ -173,6 +180,8 @@ function mapSessionCore(row) {
         autoRecovered: Boolean(row.auto_recovered),
         worktreeEnabled: Boolean(row.worktree_enabled),
         worktree: parseWorktreeInfo(row.worktree_info) ?? null,
+        title: row.title ?? undefined,
+        description: row.description ?? undefined,
         ...mapWorktreeMergeFields(row),
     };
 }
@@ -214,7 +223,9 @@ const INIT_SQL = `
     worktree_enabled INTEGER NOT NULL DEFAULT 0,
     worktree_info TEXT,
     worktree_merge_status TEXT,
-    worktree_merge_info TEXT
+    worktree_merge_info TEXT,
+    title TEXT,
+    description TEXT
   );
 
   CREATE TABLE IF NOT EXISTS app_config (
@@ -342,7 +353,7 @@ export class WandStorage {
             this.db
                 .prepare(`INSERT INTO command_sessions (
            ${sessionPersistFields()}
-           ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+           ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
            ON CONFLICT(id) DO UPDATE SET
              ${sessionPersistAssignments()}`)
                 .run(...sessionPersistValues(snapshot));
@@ -428,6 +439,8 @@ const SCHEMA_MIGRATIONS = [
     ["worktree_info", "ALTER TABLE command_sessions ADD COLUMN worktree_info TEXT"],
     ["worktree_merge_status", "ALTER TABLE command_sessions ADD COLUMN worktree_merge_status TEXT"],
     ["worktree_merge_info", "ALTER TABLE command_sessions ADD COLUMN worktree_merge_info TEXT"],
+    ["title", "ALTER TABLE command_sessions ADD COLUMN title TEXT"],
+    ["description", "ALTER TABLE command_sessions ADD COLUMN description TEXT"],
 ];
 function ensureCommandSessionSchema(db) {
     const columns = db.prepare("PRAGMA table_info(command_sessions)").all();

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

@@ -68,6 +68,7 @@ export declare class StructuredSessionManager {
     private readonly seenIdempotencyKeys;
     private emitEvent;
     private archiveTimer;
+    private readonly topicRequests;
     constructor(storage: WandStorage, config: WandConfig, logger?: SessionLogger | null);
     private archiveExpiredSessions;
     setEventEmitter(emitEvent: (event: ProcessEvent) => void): void;
@@ -82,6 +83,8 @@ export declare class StructuredSessionManager {
     /** Return lightweight snapshots for the session list (no output/messages). */
     listSlim(): SessionSnapshot[];
     get(id: string): SessionSnapshot | null;
+    setSessionTopic(id: string, title: string, description: string): SessionSnapshot;
+    private maybeGenerateSessionTopic;
     createSession(options: CreateStructuredSessionOptions): SessionSnapshot;
     sendMessage(id: string, input: string, opts?: {
         interrupt?: boolean;

package/dist/structured-session-manager.js

@@ -10,6 +10,7 @@ import { buildChildEnv, isRunningAsRoot } from "./env-utils.js";
 import { getErrorMessage } from "./error-utils.js";
 import { resolveSdkClaudeBinary } from "./claude-sdk-runner.js";
 import { buildLanguageDirective, buildManagedAutonomyDirective } from "./language-prompt.js";
+import { generateSessionTopic } from "./session-topic.js";
 function defaultStructuredRunner(provider) {
     return provider === "codex" ? "codex-cli-exec" : "claude-cli-print";
 }
@@ -358,6 +359,9 @@ function buildStructuredOutputPayload(snapshot) {
         queuedMessages: snapshot.queuedMessages,
         sessionKind: "structured",
         structuredState: snapshot.structuredState,
+        title: snapshot.title,
+        description: snapshot.description,
+        summary: snapshot.description ?? snapshot.summary,
     };
 }
 function buildIncrementalStructuredPayload(snapshot, cardDefaults) {
@@ -410,6 +414,7 @@ export class StructuredSessionManager {
     seenIdempotencyKeys = new Map();
     emitEvent = null;
     archiveTimer = null;
+    topicRequests = new Set();
     constructor(storage, config, logger = null) {
         this.storage = storage;
         this.config = config;
@@ -503,6 +508,27 @@ export class StructuredSessionManager {
         const s = this.sessions.get(id);
         return s ? withSummary(s) : null;
     }
+    setSessionTopic(id, title, description) {
+        const current = this.requireSession(id);
+        const updated = { ...current, title, description, summary: description };
+        this.sessions.set(id, updated);
+        this.storage.saveSessionMetadata(updated);
+        this.emitStructuredSnapshot(updated);
+        return updated;
+    }
+    maybeGenerateSessionTopic(id, input) {
+        const session = this.sessions.get(id);
+        if (!session || session.title || this.topicRequests.has(id))
+            return;
+        this.topicRequests.add(id);
+        void generateSessionTopic(input, session.cwd, this.config.language)
+            .then(({ title, description }) => {
+            if (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));
+    }
     createSession(options) {
         const id = randomUUID();
         const startedAt = new Date().toISOString();
@@ -562,6 +588,7 @@ 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)) {

package/dist/types.d.ts

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