oh-my-agent-web 0.3.0 → 0.4.0

package/dist/server/engine/dsh-log.js

@@ -0,0 +1,245 @@
+/**
+ * DSH 会话日志（v4）的只读解析 —— 侧栏标题、历史回放、token 统计都靠它。
+ *
+ * 为什么必须自己读文件：ACP 明确不支持 `session/load`（不回放历史），
+ * 所以「打开一条历史会话」只能读 DSH 自己落盘的日志。这里只**读**，从不写。
+ *
+ * 布局（dsh 0.2.0-rc.2，实测）：
+ *   <DSH_HOME>/sessions/<projectKey(cwd)>/session-<uuid>/session.v4.jsonl.zstd
+ * 每个写批次追加**一个 zstd 帧** → 必须多帧解压（`zstdDecompressSync` 只解首帧）。
+ * 帧内是 JSONL：第一行 `{type:"session",version:4,id,cwd,createdAt…}`，之后逐行事件
+ * `{type, seq, time, data}`。
+ *
+ * 事件面（v4 实测，只列 UI 用得到的）：
+ *   user/message      data:{content:[{type:"text",text}], source:{kind}, id}
+ *   assistant/message data:{turn,step,message:{role,content:[reasoning|text|tool-call],id},usage,stream}
+ *   tool/result       data:{turn,step,message:{toolCallId,content:[{type:"text",text}],isError}}
+ *   session/title     data:{title,source}
+ *   turn/start|end、step/start|end、session 等结构性事件（不进 UI）
+ *
+ * ⚠️ `user/message` 里大量是**系统注入**（runtime-context / skill-catalog / goal …）：
+ * 只有 `source.kind === "user"` 才是真的用户发言，其余一律不进对话区、也不拿来取标题。
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { zstdDecompressSync } from "node:zlib";
+/** projectKey(cwd) —— 镜像 DSH 的会话目录命名：分隔符 → "-"，其它非法字符 → ~XXXX（大写 hex） */
+export function projectKey(cwd) {
+    let readable = "";
+    let separatorRun = false;
+    for (let i = 0; i < cwd.length; i += 1) {
+        const code = cwd.charCodeAt(i);
+        const ch = String.fromCharCode(code);
+        if (ch === "/" || ch === "\\" || ch === ":") {
+            if (!separatorRun)
+                readable += "-";
+            separatorRun = true;
+        }
+        else if (ch !== "~" && /^[A-Za-z0-9._-]$/.test(ch)) {
+            readable += ch;
+            separatorRun = false;
+        }
+        else {
+            readable += `~${code.toString(16).toUpperCase().padStart(4, "0")}`;
+            separatorRun = false;
+        }
+    }
+    return `--${(readable.replace(/^-+/, "") || "root").slice(0, 251)}--`;
+}
+/** 多帧 zstd 解压：按魔数切帧；切错了就向后合并重试（数据体里可能误命中魔数） */
+export function zstdDecompressAll(buf) {
+    const MAGIC = Buffer.from([0x28, 0xb5, 0x2f, 0xfd]);
+    const starts = [];
+    for (let i = 0; i + 4 <= buf.length; i += 1) {
+        if (buf[i] === MAGIC[0] && buf[i + 1] === MAGIC[1] && buf[i + 2] === MAGIC[2] && buf[i + 3] === MAGIC[3]) {
+            starts.push(i);
+        }
+    }
+    let out = "";
+    let index = 0;
+    while (index < starts.length) {
+        const from = starts[index];
+        let next = index + 1;
+        let decompressed = null;
+        while (next <= starts.length) {
+            const to = next < starts.length ? starts[next] : buf.length;
+            try {
+                decompressed = zstdDecompressSync(buf.subarray(from, to));
+                break;
+            }
+            catch {
+                next += 1;
+            }
+        }
+        if (decompressed) {
+            out += decompressed.toString("utf8");
+            index = next;
+        }
+        else {
+            index += 1;
+        }
+    }
+    return out || buf.toString("utf8");
+}
+/** 读一个会话日志文件 → { header, events }（坏行跳过，不因为一行报废整份历史） */
+export function readSessionLog(file) {
+    const raw = readFileSync(file);
+    const text = file.endsWith(".zstd") ? zstdDecompressAll(raw) : raw.toString("utf8");
+    let header = null;
+    const events = [];
+    for (const line of text.split("\n")) {
+        if (line.trim() === "")
+            continue;
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (value?.type === "session") {
+            header = value;
+            continue;
+        }
+        if (typeof value?.type === "string")
+            events.push(value);
+    }
+    return { header, events };
+}
+/** 只读文件头（第一帧的前几 KB）—— 扫侧栏时不必解整份日志 */
+export function readSessionHeader(file) {
+    if (!file.endsWith(".zstd")) {
+        const text = readFileSync(file, "utf8");
+        const first = text.split("\n").find((line) => line.trim() !== "");
+        try {
+            return first ? JSON.parse(first) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    const handle = readFileSync(file);
+    const chunk = handle.subarray(0, Math.min(handle.length, 16 * 1024));
+    const text = zstdDecompressAll(chunk);
+    const first = text.split("\n").find((line) => line.trim() !== "");
+    try {
+        return first ? JSON.parse(first) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 系统注入的 user/message？白名单铁律：`source.kind !== "user"` 一律不算用户发言 */
+export function isInternalUserMessage(data) {
+    if (!data)
+        return false;
+    const source = data.source;
+    if (source && typeof source.kind === "string")
+        return source.kind !== "user";
+    // 老版本没有 source：靠文本特征兜底
+    const content = data.content;
+    if (!Array.isArray(content))
+        return false;
+    return content.some((block) => typeof block?.text === "string" &&
+        (block.text.includes("<system-reminder>") ||
+            block.text.includes("<goal_round") ||
+            block.text.startsWith("Current runtime context") ||
+            block.text.includes("Current DSH file policy:")));
+}
+function textOf(blocks) {
+    if (!Array.isArray(blocks))
+        return "";
+    return blocks
+        .map((block) => {
+        const item = block;
+        return item?.type === "text" && typeof item.text === "string" ? item.text : "";
+    })
+        .join("");
+}
+/** 会话标题：日志里最后一条 `session/title`（DSH 自己也会写 fallback 标题） */
+export function sessionTitle(log) {
+    let title = null;
+    for (const event of log.events) {
+        if (event.type !== "session/title")
+            continue;
+        const value = event.data?.title;
+        if (typeof value === "string" && value.trim() !== "")
+            title = value.trim();
+    }
+    return title;
+}
+/** 首条真实用户发言（标题兜底） */
+export function firstUserText(log, maxChars = 30) {
+    for (const event of log.events) {
+        if (event.type !== "user/message")
+            continue;
+        if (isInternalUserMessage(event.data))
+            continue;
+        const text = textOf(event.data?.content).trim().replace(/\s+/g, " ");
+        if (text !== "")
+            return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+    }
+    return null;
+}
+/** 递归列出目录下的会话日志文件（按 mtime 倒序） */
+export function findSessionFiles(root) {
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    const walk = (dir, depth) => {
+        if (depth > 3)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(full, depth + 1);
+            else if (entry.name.endsWith(".jsonl.zstd") || entry.name.endsWith(".jsonl"))
+                out.push(full);
+        }
+    };
+    walk(root, 0);
+    return out.sort((left, right) => {
+        try {
+            return statSync(right).mtimeMs - statSync(left).mtimeMs;
+        }
+        catch {
+            return 0;
+        }
+    });
+}
+/** 按会话 id 找它的日志文件：优先用 cwd 直算目录，否则在 sessions 下一层找 */
+export function locateSessionFile(sessionRoot, sessionId, cwd) {
+    const candidates = [];
+    const names = ["session.v4.jsonl.zstd", "session.jsonl.zstd"];
+    if (cwd)
+        for (const name of names)
+            candidates.push(join(sessionRoot, projectKey(cwd), sessionId, name));
+    for (const candidate of candidates)
+        if (existsSync(candidate))
+            return candidate;
+    // cwd 未知（历史会话还没打开过）：扫一层
+    let groups;
+    try {
+        groups = readdirSync(sessionRoot, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    for (const group of groups) {
+        if (!group.isDirectory())
+            continue;
+        for (const name of names) {
+            const candidate = join(sessionRoot, group.name, sessionId, name);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}

package/dist/server/engine/dsh-map.js

@@ -0,0 +1,221 @@
+/** 把 configOptions 里可能分组的选项摊平（保留 group 名，便于显示） */
+export function flattenChoices(option) {
+    if (!option?.options)
+        return [];
+    const out = [];
+    for (const entry of option.options) {
+        if ("options" in entry && Array.isArray(entry.options)) {
+            for (const choice of entry.options)
+                out.push({ ...choice, group: choice.group ?? entry.group ?? entry.name });
+        }
+        else {
+            out.push(entry);
+        }
+    }
+    return out;
+}
+/** `["provider","model"]` → { provider, model }；解析失败给 null（不猜） */
+export function parseModelValue(value) {
+    if (!value)
+        return null;
+    try {
+        const parsed = JSON.parse(value);
+        if (!Array.isArray(parsed) || parsed.length < 2)
+            return null;
+        const [provider, model] = parsed;
+        if (typeof provider !== "string" || typeof model !== "string" || provider === "" || model === "")
+            return null;
+        return { provider, model };
+    }
+    catch {
+        // 老版本可能直接给 `provider/model`
+        const [provider, model] = value.split("/");
+        return provider && model ? { provider, model } : null;
+    }
+}
+/** 我们在界面上用的模型 id：`provider/model`（可读、可回填） */
+export function modelIdOf(choice) {
+    const parsed = parseModelValue(choice.value);
+    return parsed ? `${parsed.provider}/${parsed.model}` : null;
+}
+export function modelOptions(config) {
+    const option = (config ?? []).find((entry) => entry.id === "model");
+    const current = parseModelValue(option?.currentValue);
+    const seen = new Set();
+    const models = [];
+    for (const choice of flattenChoices(option)) {
+        const id = modelIdOf(choice);
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        models.push({
+            id,
+            label: choice.name ?? id,
+            ...((current && id === `${current.provider}/${current.model}`) ? { current: true } : {}),
+        });
+    }
+    return models;
+}
+export function currentModelId(config) {
+    const parsed = parseModelValue((config ?? []).find((entry) => entry.id === "model")?.currentValue);
+    return parsed ? `${parsed.provider}/${parsed.model}` : null;
+}
+/** `provider/model` → ACP 需要的原始 value；找不到返回 null */
+export function modelValueFor(config, modelId) {
+    const option = (config ?? []).find((entry) => entry.id === "model");
+    for (const choice of flattenChoices(option)) {
+        if (modelIdOf(choice) === modelId)
+            return choice.value;
+    }
+    return null;
+}
+export function thinkingLevels(config) {
+    const option = (config ?? []).find((entry) => entry.id === "reasoning_effort");
+    return flattenChoices(option)
+        .map((choice) => choice.value)
+        .filter((value) => typeof value === "string" && value !== "");
+}
+export function currentThinkingLevel(config) {
+    return (config ?? []).find((entry) => entry.id === "reasoning_effort")?.currentValue ?? null;
+}
+/**
+ * 新会话默认用哪条模型路由。
+ *
+ * 为什么要挑：ACP 的默认路由是 `deepseek-official`，它要 `DEEPSEEK_API_KEY`；
+ * 只登录了 DeepSeek 账号的机器上第一次就报 "no API key"。所以优先选**账号路由**
+ * （`deepseek-account`），其次才回落到默认。顺序可被 `AGENT_WEB_DSH_MODEL` 覆盖。
+ */
+export function pickDefaultModelValue(config, preferred) {
+    const option = (config ?? []).find((entry) => entry.id === "model");
+    const choices = flattenChoices(option);
+    if (choices.length === 0)
+        return null;
+    if (preferred) {
+        const hit = choices.find((choice) => modelIdOf(choice) === preferred) ?? choices.find((choice) => choice.value === preferred);
+        if (hit)
+            return hit.value;
+    }
+    const current = parseModelValue(option?.currentValue);
+    // DSH 自己的默认不是官方路由（说明它配了自定义 provider / 账号）→ 尊重它，不要覆盖
+    if (current && current.provider !== "deepseek-official")
+        return null;
+    // 官方路由要 DEEPSEEK_API_KEY，没配时第一次 prompt 就报 no API key：
+    // 优先用用户自定义的 provider（如 nexita-deepseek），其次账号路由。
+    const providerOf = (choice) => parseModelValue(choice.value)?.provider ?? "";
+    const custom = choices.find((choice) => !["deepseek-official", "deepseek-account"].includes(providerOf(choice)));
+    if (custom)
+        return custom.value;
+    const account = choices.find((choice) => providerOf(choice) === "deepseek-account");
+    return (account ?? choices[0]).value;
+}
+/** ACP stopReason → 我们的回合结束原因 */
+export function stopReasonToTurnEnd(reason) {
+    if (reason === "cancelled")
+        return "interrupted";
+    if (reason === "refusal")
+        return "error";
+    return "done"; // end_turn / max_tokens / max_turn_requests：这轮确实结束了
+}
+function textOfContent(update) {
+    const content = update.content;
+    if (!content)
+        return "";
+    if (Array.isArray(content)) {
+        return content
+            .map((item) => (item?.content?.type === "text" ? (item.content.text ?? "") : ""))
+            .join("");
+    }
+    return content.type === "text" ? (content.text ?? "") : "";
+}
+/**
+ * `session/update` → EngineEvent。
+ * 注意：DSH 只给**已提交**的语义更新，所以这里每个 chunk 是一条完整 block 或一段文本，
+ * 不是逐 token 增量 —— 界面是按段落出现的，这是 ACP 的既定行为（不是丢帧）。
+ */
+export function updateToEvent(update) {
+    switch (update.sessionUpdate) {
+        case "agent_message_chunk": {
+            const text = textOfContent(update);
+            return text === "" ? null : { type: "text_delta", text };
+        }
+        case "agent_thought_chunk": {
+            const text = textOfContent(update);
+            return text === "" ? null : { type: "thinking_delta", text };
+        }
+        case "tool_call": {
+            const raw = update.rawInput === undefined ? "" : JSON.stringify(update.rawInput);
+            return {
+                type: "tool_start",
+                toolCallId: update.toolCallId ?? "dsh-tool",
+                name: update.title ?? update.kind ?? "tool",
+                argsSummary: raw.length > 300 ? `${raw.slice(0, 300)}…` : raw,
+                // 摘要是截过的；完整那份留给「展开看全 + 复制」
+                argsFull: raw,
+            };
+        }
+        case "tool_call_update": {
+            const status = update.status === "failed" ? "failed" : "ok";
+            return {
+                type: "tool_end",
+                toolCallId: update.toolCallId ?? "dsh-tool",
+                status,
+                output: textOfContent(update),
+            };
+        }
+        default:
+            // usage_update 只有上下文占用（没有 input/output 分桶）、config_option_update 由引擎自己处理
+            return null;
+    }
+}
+/**
+ * 权限请求 → 我们的审批请求。
+ *
+ * DSH 的请求体只带 `toolCallId`（没有命令/参数），所以调用方应先用记住的
+ * `tool_call` 事实补全 `tool`（见 `rememberToolCall` 的用法）。
+ */
+export function permissionApprovalRequest(request, tool) {
+    const title = tool?.title ?? request.toolCall?.title ?? "dsh 工具调用";
+    const args = tool?.rawInput === undefined ? request.toolCall?.rawInput : tool.rawInput;
+    const summary = args === undefined ? (request.toolCall?.toolCallId ?? "") : JSON.stringify(args).slice(0, 300);
+    return {
+        toolName: title,
+        argsSummary: summary,
+        scopeKey: `dsh|${title}`,
+        scopeHint: title,
+        riskNote: "DSH 请求执行这个操作；是否放行由你决定",
+    };
+}
+/** 我们的三态 → 权限选项 id（优先按 kind 匹配，其次按 optionId 猜） */
+export function permissionOptionId(options, decision) {
+    const list = options ?? [];
+    const byKind = (kinds) => {
+        for (const kind of kinds) {
+            const hit = list.find((option) => option.kind === kind);
+            if (hit)
+                return hit.optionId;
+        }
+        return null;
+    };
+    const picked = decision === "deny"
+        ? (byKind(["reject_once", "reject_always"]) ??
+            list.find((option) => /reject|deny|cancel/i.test(option.optionId))?.optionId)
+        : (byKind(decision === "always" ? ["allow_always", "allow_once"] : ["allow_once", "allow_always"]) ??
+            list.find((option) => /allow|accept|approve/i.test(option.optionId))?.optionId);
+    return picked ?? list[0]?.optionId ?? (decision === "deny" ? "reject-once" : "allow-once");
+}
+/**
+ * DSH 的错误 → 人话。
+ * 最常见两条：会话被 DSH 自己的 web/tui 占着（写句柄），以及模型路由没凭据。
+ */
+export function friendlyDshError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (/active write handle|already owned/i.test(message)) {
+        return "这个会话正在 DSH 自己的界面（web / tui）里打开着：先在那里关掉它，或新建一条会话";
+    }
+    if (/no API key/i.test(message)) {
+        return "这条模型路由没有凭据：换一条（例如 deepseek-account）或在环境里配置 DEEPSEEK_API_KEY";
+    }
+    if (/not found|unknown session/i.test(message))
+        return "DSH 里找不到这个会话（可能已被删除）";
+    return message;
+}

package/dist/server/engine/dsh-sessions.js

@@ -0,0 +1,207 @@
+/**
+ * DSH 的「项目 / 会话清单」提供者（对齐 DSH 原生：项目 = workspace，会话 = session）。
+ *
+ * 数据来源（只读）：
+ *   - `<DSH_HOME>/storages/workspace.json` —— 原生 workspace：path / title / sessionIds，
+ *     以及全局的 pinned / archived 会话 id；
+ *   - `<DSH_HOME>/storages/session_projcache/sessions/<id>.json` —— 会话投影缓存：
+ *     标题、最后提问时间、最近用的模型（**免解压日志**的快路径）；
+ *   - `<DSH_HOME>/sessions/<group>/<session-id>/session.v4.jsonl.zstd` —— 会话日志本身：
+ *     拿 header（cwd/createdAt）与 `session/title`，缓存里没有时兜底。
+ *
+ * 为什么要自己扫目录：ACP 的 `session/list` 只回 `{sessionId, cwd}`，**没有标题和时间**；
+ * 侧栏需要标题/时间/模型，所以直接读 DSH 自己的持久化（与 pi-web-ui 的做法一致，但我们
+ * 额外用了 workspace.json 与投影缓存，避免每个会话都解压日志）。
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { firstUserText, locateSessionFile, readSessionHeader, readSessionLog, sessionTitle } from "./dsh-log.js";
+import { isScratchCwd } from "./scratch.js";
+/** 读 workspace.json；没有/坏了都返回空表（侧栏退回按 cwd 分组） */
+export function readWorkspaces(home) {
+    const file = join(home, "storages", "workspace.json");
+    if (!existsSync(file))
+        return {};
+    try {
+        return JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+/** workspace.json → path → 项目名（title 优先，缺了用目录名） */
+export function workspaceNames(workspaces) {
+    const out = new Map();
+    for (const row of Object.values(workspaces.tables?.workspaces ?? {})) {
+        const path = row.path?.trim();
+        if (!path)
+            continue;
+        out.set(path, row.title?.trim() || basename(path) || path);
+    }
+    return out;
+}
+/** projcache 一条会话的元数据（标题/时间/模型，免解压） */
+function readProjCache(home, sessionId) {
+    const file = join(home, "storages", "session_projcache", "sessions", `${sessionId}.json`);
+    if (!existsSync(file))
+        return { title: null, updatedAt: null, cwd: null, startedAt: null, model: null };
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        const rows = parsed.record?.rows;
+        const title = rows?.title?.val;
+        const lastPromptAt = rows?.sessionListMetadata?.val?.lastPromptAt;
+        const lastUsed = rows?.modelSelection?.val?.lastUsed;
+        const model = typeof lastUsed?.provider === "string" && typeof lastUsed?.model === "string"
+            ? `${lastUsed.provider}/${lastUsed.model}`
+            : null;
+        return {
+            title: typeof title === "string" && title.trim() !== "" ? title.trim() : null,
+            updatedAt: typeof lastPromptAt === "number" ? lastPromptAt : null,
+            cwd: parsed.record?.identity?.cwd ?? null,
+            startedAt: typeof parsed.record?.identity?.createdAt === "number" ? parsed.record.identity.createdAt : null,
+            model,
+        };
+    }
+    catch {
+        return { title: null, updatedAt: null, cwd: null, startedAt: null, model: null };
+    }
+}
+/** 会话目录名就是会话 id（`session-<uuid>`） */
+function sessionDirs(sessionsRoot) {
+    if (!existsSync(sessionsRoot))
+        return [];
+    const out = [];
+    let groups;
+    try {
+        groups = readdirSync(sessionsRoot, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const group of groups) {
+        if (!group.isDirectory())
+            continue;
+        const groupDir = join(sessionsRoot, group.name);
+        let entries;
+        try {
+            entries = readdirSync(groupDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory() || !entry.name.startsWith("session-"))
+                continue;
+            const file = locateSessionFile(sessionsRoot, entry.name, undefined);
+            if (!file)
+                continue;
+            let mtimeMs = 0;
+            try {
+                mtimeMs = statSync(file).mtimeMs;
+            }
+            catch {
+                continue;
+            }
+            out.push({ id: entry.name, file, mtimeMs });
+        }
+    }
+    return out;
+}
+/** 日志兜底读取（每个文件按 mtime 缓存，扫描侧栏时不反复解压） */
+const logCache = new Map();
+function logMeta(file, mtimeMs) {
+    const known = logCache.get(file);
+    if (known && known.mtimeMs === mtimeMs)
+        return known;
+    const header = readSessionHeader(file);
+    let title = null;
+    try {
+        const log = readSessionLog(file);
+        title = sessionTitle(log) ?? firstUserText(log);
+    }
+    catch {
+        title = null;
+    }
+    const entry = {
+        mtimeMs,
+        cwd: typeof header?.cwd === "string" ? header.cwd : "",
+        title,
+        createdAt: typeof header?.createdAt === "number" ? header.createdAt : 0,
+    };
+    logCache.set(file, entry);
+    return entry;
+}
+/** 会话 id（`session-<uuid>`）→ 统一成侧栏用的 id（等于目录名，ACP 也认这个） */
+function summaryOf(home, session) {
+    const cache = readProjCache(home, session.id);
+    const fallback = cache.cwd && cache.title ? null : logMeta(session.file, session.mtimeMs);
+    const cwd = cache.cwd ?? fallback?.cwd ?? "";
+    if (cwd === "" || isScratchCwd(cwd))
+        return null;
+    return {
+        id: session.id,
+        cwd,
+        title: cache.title ?? fallback?.title ?? session.id,
+        startedAt: cache.startedAt ?? fallback?.createdAt ?? session.mtimeMs,
+        updatedAt: cache.updatedAt ?? session.mtimeMs,
+        model: cache.model,
+    };
+}
+/** 纯分组：会话 → 项目（workspace 的 path 精确匹配；否则按 cwd 单独成组） */
+export function groupDshSessions(sessions, names, options = {}) {
+    const groups = new Map();
+    for (const session of sessions) {
+        if (options.archived?.has(session.id))
+            continue;
+        const key = session.cwd;
+        const group = groups.get(key) ??
+            {
+                cwd: session.cwd,
+                name: names.get(session.cwd) ?? basename(session.cwd) ?? session.cwd,
+                sessions: [],
+            };
+        group.sessions.push({
+            id: session.id,
+            engineSessionId: session.id,
+            title: session.title,
+            startedAt: session.startedAt,
+            updatedAt: session.updatedAt,
+            cwd: session.cwd,
+            model: session.model,
+        });
+        groups.set(key, group);
+    }
+    return [...groups.values()]
+        .map((group) => ({
+        cwd: group.cwd,
+        name: group.name,
+        sessions: [...group.sessions].sort((left, right) => right.updatedAt - left.updatedAt),
+    }))
+        .sort((left, right) => (right.sessions[0]?.updatedAt ?? 0) - (left.sessions[0]?.updatedAt ?? 0));
+}
+export function createDshSessionsProvider(options) {
+    const home = options.home ?? process.env.DSH_HOME ?? join(homedir(), ".dsh");
+    const cacheMs = options.cacheMs ?? 5000;
+    const now = options.now ?? Date.now;
+    let cached = null;
+    return async () => {
+        if (cached && now() - cached.at < cacheMs)
+            return cached.value;
+        try {
+            const workspaces = readWorkspaces(home);
+            const names = workspaceNames(workspaces);
+            const archived = new Set(workspaces.global?.archivedSessionIds ?? []);
+            const sessions = sessionDirs(join(home, "sessions"))
+                .map((session) => summaryOf(home, session))
+                .filter((session) => session !== null);
+            const value = groupDshSessions(sessions, names, { archived });
+            cached = { at: now(), value };
+            return value;
+        }
+        catch (error) {
+            options.log?.(`读取 dsh 会话清单失败：${error instanceof Error ? error.message : String(error)}`);
+            return cached?.value ?? [];
+        }
+    };
+}