@foxden-app/foxclaw 0.13.4 → 0.13.5

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.13.5 - 2026-10-06
+
+### 中文
+
+- 修复 DSH `/threads` 只显示会话 ID：补充读取 DSH 原生持久化标题，旧会话无标题时使用首条用户消息；空会话显示未命名、工作目录和短编号。
+- 标题读取不恢复会话、不调用模型，单个历史会话读取失败不会影响列表；保留分页及原会话 ID 的打开行为。
+
+### English
+
+- Fixed DSH `/threads` displaying session IDs instead of readable names. Read native persisted titles, derive legacy names from the first human message, and show a workspace and short identifier for empty sessions.
+- Title reads do not resume sessions or invoke a model. Unreadable histories cannot break the list; pagination and opening by the original session ID are preserved.
+
 ## 0.13.4 - 2026-10-06
 
 ### 中文

package/dist/dsh/adapter.d.ts

@@ -40,7 +40,22 @@ export declare class DshEngineAdapter implements IEngineAdapter {
     listEfforts(scopeId: string): Promise<SessionConfigSelectOption[]>;
     selectEffort(scopeId: string, effort: string | null): Promise<void>;
     setAccess(scopeId: string, access: AccessPresetValue): Promise<void>;
-    listSessions(scopeId: string, cursor?: string): Promise<import("@agentclientprotocol/sdk").ListSessionsResponse>;
+    listSessions(scopeId: string, cursor?: string): Promise<import("@agentclientprotocol/sdk").ListSessionsResponse | {
+        sessions: {
+            title: string | undefined;
+            sessionId: import("@agentclientprotocol/sdk").SessionId;
+            cwd: string;
+            additionalDirectories?: Array<string>;
+            updatedAt?: string | null;
+            _meta?: {
+                [key: string]: unknown;
+            } | null;
+        }[];
+        nextCursor?: string | null;
+        _meta?: {
+            [key: string]: unknown;
+        } | null;
+    }>;
     isBusy(scopeId: string): boolean;
     executeTurn(request: EngineTurnRequest): EngineTurnExecution;
     stop(): Promise<void>;

package/dist/dsh/client.d.ts

@@ -29,6 +29,7 @@ export declare class DshClient extends EventEmitter {
     private policyPath;
     private policyWrite;
     private stderr;
+    private titlesDirectory;
     permissionHandler?: (request: RequestPermissionRequest, signal: AbortSignal) => Promise<RequestPermissionResponse>;
     cancelPermissions?: () => void;
     constructor(options: DshClientOptions, scopeId: string, logger: Logger);
@@ -42,7 +43,23 @@ export declare class DshClient extends EventEmitter {
     session(cwd: string, sessionId?: string | null): Promise<string>;
     configOptions(sessionId: string): SessionConfigOption[];
     setConfig(sessionId: string, configId: string, value: string): Promise<void>;
-    listSessions(cursor?: string): Promise<import("@agentclientprotocol/sdk").ListSessionsResponse>;
+    listSessions(cursor?: string): Promise<import("@agentclientprotocol/sdk").ListSessionsResponse | {
+        sessions: {
+            title: string | undefined;
+            sessionId: import("@agentclientprotocol/sdk").SessionId;
+            cwd: string;
+            additionalDirectories?: Array<string>;
+            updatedAt?: string | null;
+            _meta?: {
+                [key: string]: unknown;
+            } | null;
+        }[];
+        nextCursor?: string | null;
+        _meta?: {
+            [key: string]: unknown;
+        } | null;
+    }>;
+    private readSessionTitles;
     closeSession(sessionId: string): Promise<void>;
     stop(): Promise<void>;
     private dispose;

package/dist/dsh/client.js

@@ -4,7 +4,7 @@ import { EventEmitter } from 'node:events';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { createHash } from 'node:crypto';
+import { createHash, randomUUID } from 'node:crypto';
 import { createRequire } from 'node:module';
 import { ClientApp, ndJsonStream, PROTOCOL_VERSION } from '@agentclientprotocol/sdk';
 /** An owned ACP process; protocol stdout stays separate from diagnostics. */
@@ -21,6 +21,7 @@ export class DshClient extends EventEmitter {
     policyPath = '';
     policyWrite = Promise.resolve();
     stderr = '';
+    titlesDirectory = '';
     permissionHandler;
     cancelPermissions;
     constructor(options, scopeId, logger) {
@@ -65,6 +66,15 @@ export class DshClient extends EventEmitter {
             pluginPath = pluginPath.replace(/\.js$/, '.ts');
         }
         await fs.writeFile(patchPath, `- insert:\n    - id: foxclaw-permissions\n      name: ${JSON.stringify(pathToFileURL(pluginPath).href)}\n      config:\n        policyPath: ${JSON.stringify(this.policyPath)}\n`, { mode: 0o600 });
+        this.titlesDirectory = path.join(path.dirname(this.policyPath), `titles-${randomUUID()}`);
+        let titlesPlugin = fileURLToPath(new URL('./session_titles_plugin.js', import.meta.url));
+        try {
+            await fs.access(titlesPlugin);
+        }
+        catch {
+            titlesPlugin = titlesPlugin.replace(/\.js$/, '.ts');
+        }
+        await fs.appendFile(patchPath, `- insert:\n    - id: foxclaw-session-titles\n      name: ${JSON.stringify(pathToFileURL(titlesPlugin).href)}\n      config:\n        directory: ${JSON.stringify(this.titlesDirectory)}\n`);
         if (this.options.credentialControl) {
             let credentialsPlugin = fileURLToPath(new URL('./credentials_plugin.js', import.meta.url));
             try {
@@ -172,7 +182,50 @@ export class DshClient extends EventEmitter {
         await this.start();
         if (!this.capabilities.list)
             throw new Error('This DSH profile cannot list sessions');
-        return this.agent.request('session/list', cursor ? { cursor } : {});
+        const page = await this.agent.request('session/list', cursor ? { cursor } : {});
+        const unnamed = page.sessions.filter(session => !session.title?.trim());
+        if (unnamed.length === 0)
+            return page;
+        const titles = await this.readSessionTitles(unnamed.map(session => session.sessionId));
+        return { ...page, sessions: page.sessions.map(session => ({ ...session, title: session.title?.trim() ? session.title : titles[session.sessionId] })) };
+    }
+    async readSessionTitles(ids) {
+        const directory = this.titlesDirectory;
+        try {
+            await fs.access(path.join(directory, 'ready'));
+        }
+        catch {
+            return {};
+        }
+        const requestPath = path.join(directory, `${randomUUID()}.request`);
+        const responsePath = requestPath.replace(/\.request$/, '.response');
+        try {
+            await fs.writeFile(`${requestPath}.tmp`, JSON.stringify(ids), { mode: 0o600 });
+            await fs.rename(`${requestPath}.tmp`, requestPath);
+            const deadline = Date.now() + 5000;
+            while (this.connected && Date.now() < deadline) {
+                try {
+                    const result = JSON.parse(await fs.readFile(responsePath, 'utf8'));
+                    if (result && typeof result === 'object' && !Array.isArray(result)) {
+                        return Object.fromEntries(Object.entries(result).filter(([id, title]) => ids.includes(id) && typeof title === 'string'));
+                    }
+                    return {};
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                }
+                await new Promise(resolve => setTimeout(resolve, 50));
+            }
+            this.logger.warn('dsh.session_titles.timeout', { scopeId: this.scopeId });
+        }
+        catch {
+            this.logger.warn('dsh.session_titles.unavailable', { scopeId: this.scopeId });
+        }
+        finally {
+            await Promise.all([requestPath, responsePath, `${requestPath}.tmp`].map(file => fs.rm(file, { force: true }).catch(() => { })));
+        }
+        return {};
     }
     async closeSession(sessionId) {
         await this.agent.request('session/close', { sessionId });
@@ -190,6 +243,8 @@ export class DshClient extends EventEmitter {
         this.optionsBySession.clear();
         if (!child || !child.pid) {
             connection?.close();
+            if (this.titlesDirectory)
+                await fs.rm(this.titlesDirectory, { recursive: true, force: true });
             return;
         }
         const exited = new Promise(resolve => child.once('exit', () => resolve()));
@@ -207,5 +262,7 @@ export class DshClient extends EventEmitter {
         connection?.close();
         if (this.process === child)
             this.process = null;
+        if (this.titlesDirectory)
+            await fs.rm(this.titlesDirectory, { recursive: true, force: true });
     }
 }

package/dist/dsh/session_titles_plugin.d.ts

@@ -0,0 +1,32 @@
+interface SessionQuery {
+    readTitle(id: string): Promise<{
+        title: string;
+    } | undefined>;
+    readSession(id: string): Promise<{
+        events: Array<{
+            type: string;
+            data: {
+                source?: {
+                    kind: string;
+                };
+                content?: Array<{
+                    type: string;
+                    text?: string;
+                }>;
+            };
+        }>;
+    }>;
+}
+interface Context {
+    sessionQuery: SessionQuery;
+    effect(callback: () => () => Promise<void>): void;
+}
+export declare const name = "foxclaw-session-titles";
+export declare const inject: string[];
+/** Read native log-backed names without resuming sessions or invoking a model. */
+export declare function readSessionTitle(query: SessionQuery, id: string): Promise<string | undefined>;
+/** A private, per-process mailbox supplements ACP versions that omit titles. */
+export declare function apply(ctx: Context, config: {
+    directory: string;
+}): Promise<void>;
+export {};

package/dist/dsh/session_titles_plugin.js

@@ -0,0 +1,62 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export const name = 'foxclaw-session-titles';
+export const inject = ['sessionQuery'];
+/** Read native log-backed names without resuming sessions or invoking a model. */
+export async function readSessionTitle(query, id) {
+    const title = (await query.readTitle(id))?.title;
+    if (title?.trim())
+        return title;
+    const { events } = await query.readSession(id);
+    for (const event of events) {
+        if (event.type !== 'user/message' || event.data.source?.kind !== 'user')
+            continue;
+        const text = event.data.content?.filter(block => block.type === 'text').map(block => block.text ?? '').join(' ');
+        if (text?.trim())
+            return Array.from(text.replace(/\s+/gu, ' ').trim()).slice(0, 120).join('');
+    }
+    return undefined;
+}
+/** A private, per-process mailbox supplements ACP versions that omit titles. */
+export async function apply(ctx, config) {
+    await fs.mkdir(config.directory, { recursive: true, mode: 0o700 });
+    let active;
+    let stopped = false;
+    const poll = async () => {
+        for (const file of await fs.readdir(config.directory)) {
+            if (!/^[a-f0-9-]+\.request$/.test(file))
+                continue;
+            const requestPath = path.join(config.directory, file);
+            const responsePath = requestPath.replace(/\.request$/, '.response');
+            let titles = Object.create(null);
+            try {
+                const ids = JSON.parse(await fs.readFile(requestPath, 'utf8'));
+                if (!Array.isArray(ids) || ids.length > 1000 || !ids.every(id => typeof id === 'string'))
+                    throw new Error('Invalid session title request');
+                const results = await Promise.allSettled(ids.map(async (id) => ({ id, title: await readSessionTitle(ctx.sessionQuery, id) })));
+                titles = Object.create(null);
+                for (const result of results) {
+                    if (result.status === 'fulfilled' && result.value.title)
+                        titles[result.value.id] = result.value.title;
+                }
+            }
+            catch { /* Metadata failure must not break native session listing. */ }
+            if (!stopped) {
+                await fs.writeFile(`${responsePath}.tmp`, JSON.stringify(titles), { mode: 0o600 });
+                await fs.rename(`${responsePath}.tmp`, responsePath);
+            }
+            await fs.rm(requestPath, { force: true });
+        }
+    };
+    const timer = setInterval(() => {
+        if (!active)
+            active = poll().catch(() => { }).finally(() => { active = undefined; });
+    }, 50);
+    ctx.effect(() => async () => {
+        stopped = true;
+        clearInterval(timer);
+        await active;
+        await fs.rm(path.join(config.directory, 'ready'), { force: true });
+    });
+    await fs.writeFile(path.join(config.directory, 'ready'), '', { mode: 0o600 });
+}

package/dist/dsh/ui.js

@@ -141,7 +141,12 @@ export class DshUi {
     }
     async threads(scopeId, locale, orchestrator, messageId, cursor) {
         const page = await this.adapter.listSessions(scopeId, cursor);
-        const rows = page.sessions.map(session => [this.button(scopeId, 'open', session.sessionId, (session.title || session.sessionId).slice(0, 60), session.cwd)]);
+        const rows = page.sessions.map(session => {
+            const workspace = session.cwd.split(/[\\/]/).filter(Boolean).at(-1) || session.cwd;
+            const fallback = `${this.copy(locale, '未命名会话', 'Untitled session')} · ${workspace} · ${session.sessionId.slice(-8)}`;
+            const title = session.title?.replace(/\s+/gu, ' ').trim() || fallback;
+            return [this.button(scopeId, 'open', session.sessionId, Array.from(title).slice(0, 60).join(''), session.cwd)];
+        });
         if (page.nextCursor)
             rows.push([this.button(scopeId, 'page', page.nextCursor, this.copy(locale, '下一页', 'Next page'))]);
         rows.push([{ text: this.copy(locale, '返回设置', 'Back'), callback_data: 'engine:setup:main' }]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.13.4",
+  "version": "0.13.5",
   "description": "Foxden local execution claw for controlling Codex, OpenCode, Antigravity, and DeepSeek Harness from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",