@co0ontty/wand 4.31.0 → 4.32.0-beta.gefb23cd

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "963337ac2ab326332080b2ca10b39f1ccce64665",
-  "builtAt": "2026-08-06T12:29:30.333Z",
-  "version": "4.31.0",
-  "channel": "stable"
+  "commit": "efb23cdde52eafc12024c59c5c1259d73c2054fa",
+  "builtAt": "2026-08-06T23:29:50.325Z",
+  "version": "4.32.0-beta.gefb23cd",
+  "channel": "beta"
 }

package/dist/server-session-routes.d.ts

@@ -55,11 +55,14 @@ export interface SessionDirectoryTreeResponse {
     roots: SessionDirectoryNode<SessionListPageEntry>[];
     totalSessions: number;
     directoryCount: number;
+    /** Session-entry revision, kept identical to /api/session-list for pagination compatibility. */
     revision: string;
+    /** Full directory-tree revision, including custom workspace names. */
+    treeRevision: string;
 }
 export declare function buildSessionListEntries(sessions: SessionSnapshot[], claudeHistory: ProviderHistorySession[], codexHistory: ProviderHistorySession[], hiddenHistoryIds: Set<string>, openCodeHistory?: ProviderHistorySession[], qoderHistory?: ProviderHistorySession[]): SessionListPageEntry[];
 export declare function buildSessionListPage(sessions: SessionSnapshot[], claudeHistory: ProviderHistorySession[], codexHistory: ProviderHistorySession[], hiddenHistoryIds: Set<string>, offset: number, limit: number, openCodeHistory?: ProviderHistorySession[], qoderHistory?: ProviderHistorySession[]): SessionListPage;
-export declare function buildSessionDirectoryTree(sessions: SessionSnapshot[], claudeHistory: ProviderHistorySession[], codexHistory: ProviderHistorySession[], hiddenHistoryIds: Set<string>, openCodeHistory?: ProviderHistorySession[], qoderHistory?: ProviderHistorySession[]): SessionDirectoryTreeResponse;
+export declare function buildSessionDirectoryTree(sessions: SessionSnapshot[], claudeHistory: ProviderHistorySession[], codexHistory: ProviderHistorySession[], hiddenHistoryIds: Set<string>, openCodeHistory?: ProviderHistorySession[], qoderHistory?: ProviderHistorySession[], customNames?: ReadonlyMap<string, string>): SessionDirectoryTreeResponse;
 /**
  * Provider history is scanned by ProcessManager, but structured sessions live
  * in StructuredSessionManager. Annotate against the combined session list so a

package/dist/server-session-routes.js

@@ -12,7 +12,7 @@ import { buildProviderResumeCommand, isProviderSessionId, isSafeProviderSessionI
 import { parseBoundedInteger } from "./request-limits.js";
 import { asyncRoute } from "./express-async.js";
 import { enrichStructuredMessages, WAND_PROTOCOL_VERSION } from "./structured-client-protocol.js";
-import { buildDirectoryTree, } from "./session-directory-tree.js";
+import { buildDirectoryTree, normalizeSessionDirectory, } from "./session-directory-tree.js";
 export function parseExecutionMode(value, fallback) {
     if (value === undefined)
         return fallback;
@@ -228,9 +228,16 @@ export function buildSessionListEntries(sessions, claudeHistory, codexHistory, h
         return timestampOrder || left.key.localeCompare(right.key);
     });
 }
-function sessionListRevision(entries) {
+function sessionListRevision(entries, directoryNames = []) {
+    const entryState = entries.map((entry) => [entry.key, entry.sortTimestamp]);
+    const revisionState = directoryNames.length === 0
+        ? entryState
+        : {
+            entries: entryState,
+            directoryNames: directoryNames.slice().sort(([left], [right]) => left.localeCompare(right)),
+        };
     return createHash("sha256")
-        .update(JSON.stringify(entries.map((entry) => [entry.key, entry.sortTimestamp])))
+        .update(JSON.stringify(revisionState))
         .digest("base64url");
 }
 export function buildSessionListPage(sessions, claudeHistory, codexHistory, hiddenHistoryIds, offset, limit, openCodeHistory = [], qoderHistory = []) {
@@ -244,14 +251,31 @@ export function buildSessionListPage(sessions, claudeHistory, codexHistory, hidd
         revision,
     };
 }
-export function buildSessionDirectoryTree(sessions, claudeHistory, codexHistory, hiddenHistoryIds, openCodeHistory = [], qoderHistory = []) {
+export function buildSessionDirectoryTree(sessions, claudeHistory, codexHistory, hiddenHistoryIds, openCodeHistory = [], qoderHistory = [], customNames = new Map()) {
     const entries = buildSessionListEntries(sessions, claudeHistory, codexHistory, hiddenHistoryIds, openCodeHistory, qoderHistory);
     const tree = buildDirectoryTree(entries.map((entry) => ({
         entry,
         cwd: entry.type === "managed" ? entry.session.cwd : entry.history.cwd,
         sortTimestamp: entry.sortTimestamp,
-    })));
-    return { ...tree, revision: sessionListRevision(entries) };
+    })), "未知目录", customNames);
+    const appliedCustomNames = [];
+    const collectCustomNames = (nodes) => {
+        for (const node of nodes) {
+            if (node.customName)
+                appliedCustomNames.push([node.path, node.customName]);
+            collectCustomNames(node.children);
+        }
+    };
+    collectCustomNames(tree.roots);
+    return {
+        ...tree,
+        revision: sessionListRevision(entries),
+        treeRevision: sessionListRevision(entries, appliedCustomNames),
+    };
+}
+function directoryTreeContainsPath(nodes, directoryPath) {
+    return nodes.some((node) => ((!node.synthetic && node.path === directoryPath)
+        || directoryTreeContainsPath(node.children, directoryPath)));
 }
 /**
  * Provider history is scanned by ProcessManager, but structured sessions live
@@ -413,6 +437,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             messageTotal: windowed.messageTotal,
         });
     };
+    const currentDirectoryTree = () => buildSessionDirectoryTree(sessions.listSlim(), processes.listClaudeHistorySessions(), processes.listCodexHistorySessions(), getHiddenClaudeSessionIds(storage), processes.listOpenCodeHistorySessions(), processes.listQoderHistorySessions(), storage.listSessionDirectoryNames());
     app.get("/api/session-list", (req, res) => {
         try {
             const offset = parseBoundedInteger(req.query.offset, 0, 0, Number.MAX_SAFE_INTEGER);
@@ -432,12 +457,49 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
     });
     app.get("/api/session-directories", (_req, res) => {
         try {
-            res.json(buildSessionDirectoryTree(sessions.listSlim(), processes.listClaudeHistorySessions(), processes.listCodexHistorySessions(), getHiddenClaudeSessionIds(storage), processes.listOpenCodeHistorySessions(), processes.listQoderHistorySessions()));
+            res.json(currentDirectoryTree());
         }
         catch (error) {
             res.status(500).json({ error: getErrorMessage(error, "无法加载会话目录。") });
         }
     });
+    app.put("/api/session-directories/name", (req, res) => {
+        const body = req.body;
+        if (typeof body?.path !== "string") {
+            res.status(400).json({ error: "path 必须是当前工作区的目录路径。" });
+            return;
+        }
+        const directoryPath = normalizeSessionDirectory(body.path);
+        if (!directoryPath) {
+            res.status(400).json({ error: "不能重命名未知目录。" });
+            return;
+        }
+        if (body.name !== null && typeof body.name !== "string") {
+            res.status(400).json({ error: "name 必须是字符串或 null。" });
+            return;
+        }
+        const customName = typeof body.name === "string" ? body.name.trim() : "";
+        if (Array.from(customName).length > 80) {
+            res.status(400).json({ error: "工作区名称不能超过 80 个字符。" });
+            return;
+        }
+        if (/[\u0000-\u001F\u007F-\u009F\u2028\u2029]/u.test(customName)) {
+            res.status(400).json({ error: "工作区名称不能包含换行或控制字符。" });
+            return;
+        }
+        try {
+            const tree = currentDirectoryTree();
+            if (!directoryTreeContainsPath(tree.roots, directoryPath)) {
+                res.status(404).json({ error: "未找到该会话目录。" });
+                return;
+            }
+            storage.setSessionDirectoryName(directoryPath, customName || null);
+            res.json({ ok: true, path: directoryPath, name: customName || null });
+        }
+        catch (error) {
+            res.status(500).json({ error: getErrorMessage(error, "无法保存工作区名称。") });
+        }
+    });
     app.get("/api/sessions", (_req, res) => {
         res.json(sessions.listSlim().map(toSessionListItemDTO));
     });

package/dist/server.js

@@ -696,6 +696,7 @@ export async function startServer(config, configPath, options = {}) {
         "/api/config",
         "/api/models",
         "/api/sessions",
+        "/api/session-directories",
         "/api/structured-sessions",
         "/api/commands",
         "/api/claude-skills",

package/dist/session-directory-tree.d.ts

@@ -8,6 +8,8 @@ export interface SessionDirectoryNode<T> {
     path: string;
     /** Compact path segment label. Single-child ancestors are folded into this label. */
     name: string;
+    /** User-defined workspace label. Clients display this in preference to name. */
+    customName?: string;
     synthetic: boolean;
     /** Sessions whose cwd is exactly this node. */
     directCount: number;
@@ -24,4 +26,4 @@ export interface SessionDirectoryTree<T> {
     directoryCount: number;
 }
 export declare function normalizeSessionDirectory(value: string): string;
-export declare function buildDirectoryTree<T>(sources: readonly SessionDirectorySource<T>[], unknownLabel?: string): SessionDirectoryTree<T>;
+export declare function buildDirectoryTree<T>(sources: readonly SessionDirectorySource<T>[], unknownLabel?: string, customNames?: ReadonlyMap<string, string>): SessionDirectoryTree<T>;

package/dist/session-directory-tree.js

@@ -60,14 +60,16 @@ function compactLabel(parent, child, childPath) {
         return `${parent}${child}`;
     return `${parent}${separator}${child}`;
 }
-function finalizeNode(node) {
-    let children = [...node.children.values()].map(finalizeNode);
+function finalizeNode(node, customNames) {
+    let children = [...node.children.values()].map((child) => finalizeNode(child, customNames));
     const sortedEntries = node.entries
         .slice()
         .sort((left, right) => right.sortTimestamp - left.sortTimestamp);
+    const customName = customNames.get(node.path);
     let result = {
         path: node.path,
         name: node.name,
+        ...(customName ? { customName } : {}),
         synthetic: node.synthetic,
         directCount: sortedEntries.length,
         totalCount: sortedEntries.length + children.reduce((sum, child) => sum + child.totalCount, 0),
@@ -77,7 +79,7 @@ function finalizeNode(node) {
     };
     // A filesystem root followed by a single unambiguous chain is visual noise in
     // a 280-300px sidebar. Fold it while retaining the exact descendant path.
-    while (!result.synthetic && result.directCount === 0 && result.children.length === 1) {
+    while (!result.synthetic && !result.customName && result.directCount === 0 && result.children.length === 1) {
         const child = result.children[0];
         result = {
             ...child,
@@ -86,11 +88,11 @@ function finalizeNode(node) {
     }
     children = result.children.slice().sort((left, right) => {
         const latestOrder = right.latestTimestamp - left.latestTimestamp;
-        return latestOrder || left.name.localeCompare(right.name);
+        return latestOrder || (left.customName ?? left.name).localeCompare(right.customName ?? right.name);
     });
     return { ...result, children };
 }
-export function buildDirectoryTree(sources, unknownLabel = "未知目录") {
+export function buildDirectoryTree(sources, unknownLabel = "未知目录", customNames = new Map()) {
     const roots = new Map();
     let unknown = null;
     const realDirectories = new Set();
@@ -113,14 +115,14 @@ export function buildDirectoryTree(sources, unknownLabel = "未知目录") {
         }
         node.entries.push({ entry: source.entry, sortTimestamp: source.sortTimestamp });
     }
-    const finalized = [...roots.values()].map(finalizeNode);
+    const finalized = [...roots.values()].map((node) => finalizeNode(node, customNames));
     if (unknown)
-        finalized.push(finalizeNode(unknown));
+        finalized.push(finalizeNode(unknown, customNames));
     finalized.sort((left, right) => {
         if (left.synthetic !== right.synthetic)
             return left.synthetic ? 1 : -1;
         const latestOrder = right.latestTimestamp - left.latestTimestamp;
-        return latestOrder || left.name.localeCompare(right.name);
+        return latestOrder || (left.customName ?? left.name).localeCompare(right.customName ?? right.name);
     });
     return {
         roots: finalized,

package/dist/storage.d.ts

@@ -36,6 +36,10 @@ export declare class WandStorage {
     setPreference<T>(key: string, value: T | null | undefined): void;
     /** 判断偏好是否在 DB 中存在（区别于值为 null/false/""）。 */
     hasPreference(key: string): boolean;
+    /** Return user-defined workspace labels keyed by normalized session cwd. */
+    listSessionDirectoryNames(): Map<string, string>;
+    /** Set a workspace label, or remove it when name is null/blank. */
+    setSessionDirectoryName(directoryPath: string, name: string | null): void;
     /** Get password from database */
     getPassword(): string | null;
     /** Set password in database */

package/dist/storage.js

@@ -2,6 +2,7 @@ import crypto from "node:crypto";
 import { chmodSync, existsSync, mkdirSync } from "node:fs";
 import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
+import { normalizeSessionDirectory } from "./session-directory-tree.js";
 import { DEFAULT_PASSWORD_VAULT_ID, DEFAULT_PASSWORD_VAULT_NAME, itemMatchesFilter, normalizePasswordItemInput, normalizeVaultName, nowIso, } from "./password-manager.js";
 function safeJsonParse(raw) {
     if (!raw)
@@ -450,6 +451,12 @@ const INIT_SQL = `
     value TEXT NOT NULL
   );
 
+  CREATE TABLE IF NOT EXISTS session_directory_names (
+    path TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
   CREATE TABLE IF NOT EXISTS password_vaults (
     id TEXT PRIMARY KEY,
     name TEXT NOT NULL,
@@ -641,6 +648,32 @@ export class WandStorage {
     hasPreference(key) {
         return this.getConfigValue(key) !== null;
     }
+    // ============ Session Directory Names ============
+    /** Return user-defined workspace labels keyed by normalized session cwd. */
+    listSessionDirectoryNames() {
+        const rows = this.db
+            .prepare("SELECT path, name FROM session_directory_names ORDER BY path ASC")
+            .all();
+        return new Map(rows.map((row) => [row.path, row.name]));
+    }
+    /** Set a workspace label, or remove it when name is null/blank. */
+    setSessionDirectoryName(directoryPath, name) {
+        const normalizedPath = normalizeSessionDirectory(directoryPath);
+        if (!normalizedPath)
+            throw new Error("会话目录路径不能为空。");
+        const normalizedName = name?.trim() ?? "";
+        if (!normalizedName) {
+            this.db.prepare("DELETE FROM session_directory_names WHERE path = ?").run(normalizedPath);
+            return;
+        }
+        this.db
+            .prepare(`INSERT INTO session_directory_names (path, name, updated_at)
+         VALUES (?, ?, ?)
+         ON CONFLICT(path) DO UPDATE SET
+           name = excluded.name,
+           updated_at = excluded.updated_at`)
+            .run(normalizedPath, normalizedName, nowIso());
+    }
     /** Get password from database */
     getPassword() {
         return this.getConfigValue("password");