dsh-fps-workbench 0.0.0-stage → 0.1.78

package/locale/detail.en.md

@@ -0,0 +1,39 @@
+# Four-pointed star (FPS)
+
+FPS is a conversation workspace for DeepSeek Harness (DSH). Track tool progress, open session outputs, and check context and provider usage from one interface. Return to unsent attachments when you switch sessions, and use a configured vision model to interpret images for a text-only model.
+
+## What you can do
+
+- **Context and session outputs.** Open Context in the conversation header to see the model, session state, and estimated context composition. Outputs lists local files produced or explicitly linked in the session. Select a file to open it in DSH's native preview. The header also gives you access to Files, Terminal, and Browser.
+- **Tool progress summaries.** Consecutive file reads, commands, and edits appear in one summary row. Expand it for DSH's native tool details. The task list distinguishes completed, active, and pending work. While the session runs, `ThinKing` shows elapsed time alongside the FPS mark and respects the system's reduced motion setting.
+- **Composer and attachment drafts.** Paste images or use the Add menu to choose images and files. When you return to a session, its draft text and unsent attachments are restored. Reloading or closing the interface clears unsent attachments. Each message supports up to four images of 8 MB each and six files of 20 MB each.
+- **Images with text-only models.** When the selected model does not support images, FPS looks for an available model with image input in DSH. It sends the image and prompt to that model and passes the resulting description to the current session. If no suitable model is available, the composer keeps the draft and shows an error.
+- **Sessions and workspaces.** The sidebar keeps DSH's workspaces, session search, and settings. Use the back and forward arrows beside the sidebar toggle to revisit sessions opened in the current window.
+- **Commands, references, and voice.** Type `/` to find commands and `@` to reference files or sessions. The composer footer gives you access to the workspace, permissions, model, reasoning effort, and usage. Enable the DSH voice input plugin to see a microphone in the composer.
+
+FPS sends messages through the native DSH session. Models can use the tools enabled in the current configuration, and DSH runs them or requests approval according to the session permissions.
+
+## Provider usage
+
+Click the ring next to the model selector. FPS queries usage using the providers and API keys enabled in DSH. It shows the balance, spending, quota, or reset time returned by a supported endpoint. Zero balances are displayed. Accounts or fields are hidden when an endpoint is unsupported, a query fails, or data is missing. DSH supplies the session's token counts and estimated context usage separately.
+
+## Optional image generation
+
+Open **Plugins → Four-pointed star → Image generation** to switch on the providers you want. All four start off. Enabled providers become available once their setup is complete, and compatible session models can call them through DSH according to the session's permissions. FPS saves generated images in DSH's generated files directory, where you can open them with DSH's native preview. Cloud tools send prompts to the selected service, so avoid including confidential material.
+
+You can name a provider in your prompt. By default, FPS asks the model to prefer an existing image generation tool. When it uses FPS, it tries to select ComfyUI first if ready, followed by Z-Image Turbo, CogView-3-Flash, and Pollinations. A failed request returns its error so you can decide whether to try again or switch providers.
+
+- **Z-Image Turbo.** Uses the official Hugging Face Space without an API key. It generates images at roughly one megapixel and is suitable for quick concepts. The shared service may queue requests or stop accepting them when its GPU quota runs out. The documented anonymous ZeroGPU allowance is two minutes of GPU time per day. [ZeroGPU quota](https://huggingface.co/docs/hub/spaces-zerogpu#usage-tiers)
+- **CogView-3-Flash.** Requires an API key from the Zhipu BigModel platform. Zhipu lists the Flash tier as free. It suits standard-quality images and is subject to the provider's eligibility, rate limits, and availability. FPS uses the specified Flash model only. [Zhipu pricing](https://docs.bigmodel.cn/cn/guide/start/pricing)
+- **Pollinations.** Requires your own Pollinations API key and may require a positive available balance even for a zero-priced model. FPS checks the live price of its SDXL Lightning model before sending a generation request. This community model is suited to quick drafts, and its description states that prompts and completions are logged. [Pollinations API](https://gen.pollinations.ai/docs)
+- **ComfyUI + Comfy MCP.** Switch it on, then start the download from Image generation. The setup installs ComfyUI and its official Comfy MCP integration. It targets Apple Silicon with macOS 14 or newer, 64-bit Windows, and x86-64 Linux with glibc 2.28 or newer. Have Git, Python 3.11–3.13 with `venv` and `pip`, internet access, at least 8 GB of RAM, and 16 GiB of free disk space for setup. A compatible Apple or NVIDIA GPU is recommended. CPU generation can take several minutes. The included SD 1.5 workflow produces local drafts around 512 × 512 pixels by default. Fine text and photorealism can be limited. Local generation needs no Comfy account or credits. [Comfy MCP](https://github.com/Comfy-Org/comfy-mcp) · [Checkpoint and license](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive)
+
+Turning ComfyUI off disables local image generation and keeps the downloaded files for later use. FPS uses the official MCP to run the starter workflow and exposes only image generation to the conversation.
+
+Save the CogView-3-Flash and Pollinations keys in the Image generation settings. FPS uses the DSH credential store. You can also provide `FPS_COGVIEW_API_KEY` or `POLLINATIONS_API_KEY` in the environment that starts DSH. Each provider uses its own key.
+
+## Customize
+
+- **Appearance.** In DSH, open Settings → General → Appearance and select Light, Dark, or System. FPS follows that setting across its sidebar, conversation, composer, and menus.
+- **Models and usage.** In DSH, open Settings → Models to add or edit your providers, API endpoints, models, and API keys. Reopen the usage panel to query the updated configuration. A custom endpoint needs a matching usage integration to show balances or quotas. If you use a text-only model, you can add a model that supports image input here for FPS to select automatically.
+- **Tools and permissions.** Manage plugins that provide tools in DSH's Plugins page. Use the composer footer to select your session model and permissions. Tool availability depends on the model's capabilities and the session permissions.

package/locale/detail.zh.md

@@ -0,0 +1,39 @@
+# Four-pointed star（FPS）
+
+FPS 是 DeepSeek Harness（DSH）的会话工作台。你可以在同一处跟踪工具进度、打开会话产物、查看上下文与服务商用量。切换会话后可以找回未发送的附件，使用纯文本模型时也可以借助已配置的视觉模型读图。
+
+## 主要功能
+
+- **上下文与会话产物**。点会话顶栏的「上下文」按钮，查看模型、会话状态和上下文占用估算。「输出内容」汇集会话生成或明确链接的本地文件，点击后用 DSH 原生预览打开。顶栏也可切换文件、终端和浏览器。
+- **工具步骤摘要**。连续的读文件、执行命令和编辑操作会汇总成一行，展开可查看 DSH 原生详情。任务列表区分已完成、进行中和待处理。会话运行时，`ThinKing` 显示用时和 FPS 标志动画，遵循系统的减少动态效果设置。
+- **输入与附件草稿**。支持粘贴图片，也可从「添加」菜单选择图片和文件。切换会话再回来时，会恢复该会话的文字草稿和未发送的附件。重新加载或关闭界面会清除未发送的附件。每条消息最多可添加 4 张各 8 MB 的图片和 6 个各 20 MB 的文件。
+- **纯文本模型识图**。如果所选模型不支持图片输入，FPS 会从 DSH 的可用模型中查找支持图片的模型，将图片和问题发给它，再把生成的描述交给当前会话。找不到可用模型时，输入框会保留草稿并提示失败。
+- **会话和工作区**。左栏保留 DSH 的原生工作区、会话搜索和设置。侧栏按钮旁的前进、后退箭头可在本次打开窗口后访问过的会话间切换。
+- **命令、引用和语音**。输入 `/` 查找命令，输入 `@` 引用文件或会话。输入框下方可选择工作区、权限、模型和推理强度，也可查看用量。DSH 启用语音输入插件时，输入框会显示麦克风。
+
+FPS 通过 DSH 原生会话发送消息。模型可以使用当前配置已启用的工具，由 DSH 按会话权限执行或请求确认。
+
+## 用量怎么显示
+
+点模型选择器旁的圆环。FPS 根据 DSH 中已启用的服务商及其 API Key 查询用量，按适配接口实际返回的内容显示余额、已用金额、额度或重置时间。零余额正常显示。接口未适配、查询失败或缺少数据时，相应账户或字段会自动隐藏。会话 Token 和上下文占用估算由 DSH 提供，单独显示。
+
+## 可选生图工具
+
+在「插件 → Four-pointed star → 图片生成」中按需开启。四项开关默认关闭。服务开启并准备就绪后，支持工具调用的会话模型可以按 DSH 的会话权限使用。FPS 将图片保存到 DSH 的生成目录，可用 DSH 原生预览打开。使用云端生图时，提示词会发送给相应服务，请避免在提示词里写入机密信息。
+
+可以在提示词里指定服务商。FPS 默认提示模型优先使用已有生图工具。调用 FPS 时，会按 ComfyUI（已就绪）、Z-Image Turbo、CogView-3-Flash、Pollinations 的顺序选取可用服务。请求失败时会返回错误，由你决定重试或换用其他服务。
+
+- **Z-Image Turbo**。使用官方 Hugging Face Space，无需 API Key。生成的图片约为一百万像素，适合快速试构图和风格。共享 GPU 繁忙时需要排队，额度用尽时需等服务恢复。ZeroGPU 文档给出的匿名额度为每天两分钟 GPU 时间。[ZeroGPU 额度](https://huggingface.co/docs/hub/spaces-zerogpu#usage-tiers)
+- **CogView-3-Flash**。需要智谱开放平台的 API Key。智谱将该 Flash 模型列为免费，适合常规画质需求，实际可用性取决于账号资格、服务限流与运行状态。FPS 只调用这个 Flash 模型。[智谱定价](https://docs.bigmodel.cn/cn/guide/start/pricing)
+- **Pollinations**。需要自己的 Pollinations API Key。即使使用零价模型，服务也可能要求账户有正的可用余额。FPS 在请求前检查 SDXL Lightning 的实时价格，仅在零价时调用。该社区模型适合快速打样，模型说明标明会记录提示词和生成结果。[Pollinations API](https://gen.pollinations.ai/docs)
+- **ComfyUI + Comfy MCP**。开启开关后，在「图片生成」中启动下载，安装 ComfyUI 和官方 Comfy MCP。安装支持 Apple 芯片的 macOS 14 或更新版本、64 位 Windows，以及 glibc 2.28 或更新版本的 x86-64 Linux。安装需要 Git、带 `venv` 和 `pip` 的 Python 3.11–3.13、网络连接、至少 8 GB 内存和 16 GiB 可用磁盘空间。建议使用兼容的 Apple 或 NVIDIA GPU，CPU 生图可能需要几分钟。随附的 SD 1.5 工作流默认在本地生成约 512 × 512 像素的草图，细小文字和写实效果有限。本地生成无需 Comfy 账号或积分。[Comfy MCP](https://github.com/Comfy-Org/comfy-mcp) · [模型与许可](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive)
+
+关闭 ComfyUI 开关后，本地生图停用，已下载的文件保留供下次使用。FPS 通过官方 MCP 运行入门工作流，会话中只开放生图功能。
+
+在「图片生成」设置中，可将 CogView-3-Flash 和 Pollinations 的 Key 保存至 DSH 的凭证存储。也可以在启动 DSH 的环境中设置 `FPS_COGVIEW_API_KEY` 或 `POLLINATIONS_API_KEY`。各服务使用自己的 Key。
+
+## 自定义
+
+- **外观**。在 DSH「设置 → 通用 → 外观」中选择浅色、深色或跟随系统。FPS 会同步切换侧栏、消息区、输入框和弹层的配色。
+- **模型和用量**。在 DSH「设置 → 模型」中添加或编辑自己的服务商、接口地址、模型和 API Key。再次打开用量面板即可按新配置查询。自定义地址的余额或额度需要对应的用量接口适配。使用纯文本模型时，可在同一处添加支持图片输入的模型，供 FPS 自动选择。
+- **工具和权限**。在 DSH 的「插件」中管理提供工具的插件，并在输入框下方选择会话模型和权限模式。工具能否调用取决于模型能力和当前会话权限。

package/locale/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "Four-pointed star",
+    "description": "A DeepSeek Harness workspace with session outputs, tool summaries, attachment drafts, provider usage, vision fallback, and optional cloud and local image generation.",
+    "detail": "locale/detail.en.md"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "Four-pointed star",
+    "description": "DeepSeek Harness 会话工作台，支持会话产物、工具摘要、附件草稿、服务商用量、纯文本模型识图，以及可选的云端和本地生图。",
+    "detail": "locale/detail.zh.md"
+  }
+}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "dsh-fps-workbench",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.78",
+  "description": "Session outputs, tool summaries, attachment drafts, provider usage, and optional image tools for DeepSeek Harness.",
+  "author": "Blacstar7",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Blacstar7/dsh-fps-workbench.git"
+  },
+  "homepage": "https://github.com/Blacstar7/dsh-fps-workbench#readme",
+  "keywords": ["dsh-plugin", "deepseek-harness", "workbench"],
+  "engines": {
+    "dsh": ">=0.2.2-rc.1"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "provider-usage.js",
+    "image-generation.js",
+    "image-providers.js",
+    "comfy-image.js",
+    "session-outputs.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "locale/detail.*.md",
+    "icon.svg",
+    "README.md",
+    "README.zh.md",
+    "CHANGELOG.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
+    }
+  }
+}

package/provider-usage.js

@@ -0,0 +1,301 @@
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+
+const KIMI_CODE_ORIGINS = new Set(['https://api.kimi.com', 'https://api.kimi.ai']);
+const KIMI_WINDOWS = [
+  ['limit_5h', 'fiveHours'],
+  ['limit_7d', 'sevenDays'],
+  ['limit_month_total', 'monthTotal'],
+];
+const USER_AGENT = 'DeepSeek-Harness-Claude-Workbench';
+const DREAMINA_CREDIT_CYCLE_MS = 30 * 24 * 60 * 60 * 1000;
+const execFileAsync = promisify(execFile);
+
+function number(value) {
+  if (typeof value !== 'number' && !(typeof value === 'string' && value.trim())) return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function money(currency, amount) {
+  return typeof currency === 'string' && /^[A-Z]{3}$/u.test(currency) && amount !== null
+    ? { currency, amount } : null;
+}
+
+function resetTimestamp(value) {
+  const timestamp = number(value);
+  return timestamp > 0 && Number.isFinite(new Date(timestamp).getTime()) ? timestamp : null;
+}
+
+function deepSeekUsage(payload) {
+  const balances = Array.isArray(payload?.balance_infos)
+    ? payload.balance_infos.map((entry) => money(entry?.currency, number(entry?.total_balance))).filter(Boolean)
+    : [];
+  return balances.length ? { balances } : null;
+}
+
+function kimiCodeUsage(payload) {
+  const windows = [];
+  for (const [field, id] of KIMI_WINDOWS) {
+    const entry = payload?.usages?.[field];
+    const ratio = number(entry?.used_ratio);
+    if (ratio === null || ratio < 0) continue;
+    const resetAt = typeof entry.reset_time === 'string' ? Date.parse(entry.reset_time) : NaN;
+    windows.push({ id, ratio, ...(Number.isFinite(resetAt) ? { resetAt } : {}) });
+  }
+
+  const wallet = payload?.booster_wallet ?? payload?.boosterWallet;
+  const currency = wallet?.monthlyChargeLimit?.currency ?? wallet?.monthlyUsed?.currency ?? wallet?.topupLimit?.currency;
+  const rawBalance = number(wallet?.balance?.amountLeft);
+  // Kimi's wallet uses one million fixed-point units per cent.
+  const balance = wallet?.balance?.type === 'BOOSTER' && rawBalance !== null
+    ? money(currency, (rawBalance > 0 && rawBalance < 1_000_000 ? 1 : Math.round(rawBalance / 1_000_000)) / 100)
+    : null;
+  return windows.length || balance ? { windows, balance } : null;
+}
+
+function kimiApiUsage(payload) {
+  if (payload?.code !== 0 || payload?.status !== true) return null;
+  const balance = money('CNY', number(payload.data?.available_balance));
+  return balance ? { balances: [balance] } : null;
+}
+
+function miniMaxUsage(payload) {
+  if (payload?.base_resp?.status_code !== 0 || !Array.isArray(payload?.model_remains)) return null;
+  const quota = payload.model_remains.find((row) => row?.model_name === 'general');
+  if (!quota) return null;
+
+  const windows = [];
+  for (const [id, percentField, resetField] of [
+    ['fiveHours', 'current_interval_remaining_percent', 'end_time'],
+    ['sevenDays', 'current_weekly_remaining_percent', 'weekly_end_time'],
+  ]) {
+    const remaining = number(quota[percentField]);
+    if (remaining === null || remaining < 0 || remaining > 100) continue;
+    const resetAt = resetTimestamp(quota[resetField]);
+    windows.push({ id, ratio: (100 - remaining) / 100, ...(resetAt ? { resetAt } : {}) });
+  }
+  return windows.length ? { windows } : null;
+}
+
+function zhipuUsage(payload) {
+  const data = payload?.data;
+  if (payload?.success !== true || !Array.isArray(data?.limits)) return null;
+
+  const windows = [];
+  // GLM reports the 5-hour and weekly windows as units 3 and 6 respectively.
+  for (const [unit, id] of [[3, 'fiveHours'], [6, 'sevenDays']]) {
+    const entry = data.limits.find((row) => number(row?.unit) === unit
+      && (row.type === 'CREDIT_LIMIT' || row.type === 'TOKENS_LIMIT'));
+    const percentage = number(entry?.percentage);
+    if (percentage === null || percentage < 0) continue;
+
+    const window = { id, ratio: percentage / 100 };
+    const resetAt = resetTimestamp(entry.nextResetTime);
+    if (resetAt) window.resetAt = resetAt;
+    const remaining = number(entry.remaining);
+    const total = number(entry.usage);
+    if (entry.type === 'CREDIT_LIMIT' && remaining !== null && remaining >= 0 && total > 0) {
+      window.credits = { remaining, total };
+    }
+    windows.push(window);
+  }
+
+  const plans = { lite: 'Lite', pro: 'Pro', max: 'Max' };
+  const level = typeof data.level === 'string' ? data.level.toLowerCase() : '';
+  const plan = Object.hasOwn(plans, level) ? plans[level] : undefined;
+  return windows.length ? { windows, plan } : null;
+}
+
+function openRouterUsage(payload) {
+  const data = payload?.data;
+  const charges = [
+    ['spent', number(data?.usage)],
+    ['keyRemaining', number(data?.limit_remaining)],
+  ].flatMap(([id, amount]) => amount !== null && amount >= 0 ? [{ id, currency: 'USD', amount }] : []);
+  return charges.length ? { charges } : null;
+}
+
+function adapterFor(baseURL) {
+  if (typeof baseURL !== 'string') return null;
+  let url;
+  try { url = new URL(baseURL); } catch { return null; }
+  if (url.protocol !== 'https:' || url.username || url.password || url.search || url.hash) return null;
+  const { origin, pathname } = url;
+  if (KIMI_CODE_ORIGINS.has(origin) && /^\/coding(?:\/|$)/u.test(pathname)) {
+    return { name: 'Kimi Coding', url: `${origin}/coding/v1/usages`, parse: kimiCodeUsage };
+  }
+  switch (origin) {
+    case 'https://api.deepseek.com':
+      return { name: 'DeepSeek', url: `${origin}/user/balance`, parse: deepSeekUsage };
+    case 'https://api.moonshot.cn':
+      return { name: 'Kimi API', url: `${origin}/v1/users/me/balance`, parse: kimiApiUsage };
+    case 'https://open.bigmodel.cn':
+    case 'https://api.z.ai':
+      return { name: 'GLM Coding Plan', url: `${origin}/api/monitor/usage/quota/limit`, parse: zhipuUsage, rawAuthorization: true };
+    case 'https://api.minimaxi.com':
+    case 'https://api.minimax.cn':
+      return { name: 'MiniMax', url: 'https://www.minimaxi.com/v1/token_plan/remains', parse: miniMaxUsage };
+    case 'https://api.minimax.io':
+      return { name: 'MiniMax', url: 'https://www.minimax.io/v1/token_plan/remains', parse: miniMaxUsage };
+    case 'https://openrouter.ai':
+      return { name: 'OpenRouter', url: `${origin}/api/v1/key`, parse: openRouterUsage };
+    default:
+      return null;
+  }
+}
+
+function configuredTargets(ctx) {
+  const active = new Set(ctx.llm.listProviders().map(({ id }) => id));
+  const settings = ctx.get('settings')?.describe({ redactSecrets: true }) ?? [];
+  const byNamespace = new Map(settings.map(({ ns, value }) => [ns, value]));
+  const targets = [];
+  for (const entry of ctx.llm.listConfigurableProviders?.() ?? []) {
+    if (!active.has(entry.provider)) continue;
+    const profile = entry.settingsPath.reduce((value, key) =>
+      value && Object.hasOwn(value, key) ? value[key] : undefined, byNamespace.get(entry.settingsNs));
+    if (!profile || typeof profile !== 'object') continue;
+    const adapter = adapterFor(profile.baseURL ?? entry.defaultBaseURL);
+    if (!adapter) continue;
+    const native = adapterFor(entry.defaultBaseURL);
+    targets.push({
+      id: entry.provider, adapter, ref: profile.apiKeyEnv,
+      // The catalog's native credentials belong to its official account and region.
+      ...(native?.url === adapter.url ? { nativeRefs: entry.nativeAuth?.env ?? [], nativeId: entry.provider } : {}),
+    });
+  }
+
+  const installedDeepSeek = ctx.get('configEditor')?.entries().find(({ options }) =>
+    options.name === '@deepseek-ai/dsh-llm-deepseek-api-key');
+  const official = byNamespace.get(installedDeepSeek?.options.id ?? 'llm-deepseek');
+  if (active.has('deepseek-official') && official) {
+    const envBase = ctx.get('launchEnvironment')?.get('DEEPSEEK_BASE_URL')?.value ?? process.env.DEEPSEEK_BASE_URL;
+    const adapter = adapterFor(official.baseURL ?? envBase ?? 'https://api.deepseek.com');
+    if (adapter?.parse === deepSeekUsage) {
+      targets.push({ id: 'deepseek-official', adapter, ref: official.apiKeyEnv ?? 'DEEPSEEK_API_KEY' });
+    }
+  }
+  return targets;
+}
+
+async function resolveKey(credentials, target) {
+  const readRef = async (ref) => {
+    if (typeof ref !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/u.test(ref)) return null;
+    return (await credentials?.resolve?.(ref))?.value?.trim() || null;
+  };
+  if (target.ref !== undefined) return readRef(target.ref);
+  if (target.nativeId && /^[a-z][a-z0-9-]*$/u.test(target.nativeId)) {
+    const record = await credentials?.readRecord?.(`llm-pi-ai/${target.nativeId}`);
+    if (record) return record.kind === 'api-key' ? record.key?.trim() || null : null;
+  }
+  for (const ref of target.nativeRefs ?? []) {
+    const key = await readRef(ref);
+    if (key) return key;
+  }
+  return null;
+}
+
+async function kimiCodeFromCCSwitch() {
+  // This optional source is restricted to the named Kimi Coding entry and official origin.
+  let db;
+  try {
+    const { DatabaseSync } = await import('node:sqlite');
+    db = new DatabaseSync(join(homedir(), '.cc-switch', 'cc-switch.db'), { readOnly: true });
+    const row = db.prepare("SELECT settings_config FROM providers WHERE app_type = ? AND id = ?")
+      .get('opencode', 'kimi-coding');
+    const options = row ? JSON.parse(row.settings_config)?.options : null;
+    if (typeof options?.baseURL !== 'string' || typeof options.apiKey !== 'string' || !options.apiKey.trim()) return null;
+    const base = new URL(options.baseURL);
+    if (!KIMI_CODE_ORIGINS.has(base.origin) || !/^\/coding(?:\/v1)?\/?$/u.test(base.pathname)
+        || base.username || base.password || base.search || base.hash) return null;
+    return { id: 'cc-switch-kimi-code', key: options.apiKey.trim(), adapter: adapterFor(base.href) };
+  } catch {
+    return null;
+  } finally {
+    db?.close();
+  }
+}
+
+async function queryUsage({ id, adapter, key }, signal, request) {
+  try {
+    const response = await request(adapter.url, {
+      headers: {
+        Authorization: adapter.rawAuthorization ? key : `Bearer ${key}`,
+        Accept: 'application/json',
+        'User-Agent': USER_AGENT,
+      },
+      redirect: 'error',
+      signal: AbortSignal.any([signal, AbortSignal.timeout(8_000)]),
+    });
+    if (!response.ok) return null;
+    const usage = adapter.parse(await response.json());
+    return usage ? { id, name: adapter.name, ...usage } : null;
+  } catch {
+    return null;
+  }
+}
+
+async function readLocalSettings() {
+  try {
+    const directory = process.env.DSH_HOME || join(homedir(), '.dsh');
+    return JSON.parse(await readFile(join(directory, 'workbench-usage.json'), 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function dreaminaCreditReset(subscription, userId) {
+  if (!Number.isSafeInteger(userId) || userId !== subscription.userId) return null;
+  const openedAt = Date.parse(subscription.openedAt);
+  const expiresAt = Date.parse(subscription.expiresAt);
+  const now = Date.now();
+  if (!(openedAt <= now && now < expiresAt)) return null;
+  const nextCycle = Math.floor((now - openedAt) / DREAMINA_CREDIT_CYCLE_MS) + 1;
+  const resetAt = openedAt + nextCycle * DREAMINA_CREDIT_CYCLE_MS;
+  return resetAt < expiresAt ? resetAt : null;
+}
+
+async function dreaminaUsage(subscription, signal) {
+  if (!subscription || subscription.enabled === false) return null;
+  const executable = process.env.DREAMINA_BIN || join(homedir(), '.local', 'bin', 'dreamina');
+  try {
+    const { stdout } = await execFileAsync(executable, ['user_credit'], {
+      signal, timeout: 8_000, maxBuffer: 64 * 1024,
+    });
+    const account = JSON.parse(stdout);
+    const credits = number(account?.total_credit);
+    if (credits === null || credits < 0) return null;
+    const resetAt = dreaminaCreditReset(subscription, account.user_id);
+    return { id: 'dreamina', name: 'Dreamina', credits, ...(resetAt ? { resetAt } : {}) };
+  } catch {
+    return null;
+  }
+}
+
+export async function providerUsage(ctx, signal, { request = fetch, localSettings = readLocalSettings } = {}) {
+  const credentials = ctx.get('credentials');
+  const local = await localSettings();
+  const resolved = await Promise.allSettled(configuredTargets(ctx).map(async (target) => ({
+    ...target, key: await resolveKey(credentials, target),
+  })));
+  const candidates = resolved.flatMap((result) => result.status === 'fulfilled' && result.value.key ? [result.value] : []);
+  if (local?.kimiCode?.source === 'cc-switch') {
+    const kimiCode = await kimiCodeFromCCSwitch();
+    if (kimiCode) candidates.push(kimiCode);
+  }
+
+  const seen = new Map();
+  const jobs = candidates.flatMap((target) => {
+    const url = target.adapter.url;
+    const keys = seen.get(url) ?? new Set();
+    if (keys.has(target.key)) return [];
+    keys.add(target.key);
+    seen.set(url, keys);
+    return [queryUsage(target, signal, request)];
+  });
+  const sections = (await Promise.all([...jobs, dreaminaUsage(local?.dreamina, signal)])).filter(Boolean);
+  return sections;
+}

package/session-outputs.js

@@ -0,0 +1,154 @@
+import { isAbsolute, normalize, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const FILE_TOOLS = new Set(['write', 'edit', 'str_replace_editor', 'apply_patch']);
+const IMAGE_TOOL = /(?:^(?:fps_)?|__)generate_image$/u;
+
+function isPath(value) {
+  return typeof value === 'string' && value.trim() !== '' && !value.includes('\0');
+}
+
+function outputPath(cwd, path) {
+  if (!isPath(path)) return null;
+  if (isAbsolute(path)) return normalize(path);
+  return cwd && !path.startsWith('~/') ? resolve(cwd, path) : null;
+}
+
+function addOutputs(state, paths) {
+  const files = new Set(state.files);
+  for (const path of paths) {
+    const absolute = outputPath(state.cwd, path);
+    if (absolute) files.add(absolute);
+  }
+  return files.size === state.files.length ? state : { ...state, files: [...files] };
+}
+
+function localLinkPath(destination) {
+  const value = destination.replace(/\\([\\()[\]<>])/gu, '$1');
+  if (/^file:\/\//iu.test(value)) {
+    try { return fileURLToPath(value); } catch { return null; }
+  }
+  if (/^(?:[a-z][a-z\d+.-]*:|\/\/|[#?])/iu.test(value)) return null;
+  try {
+    return decodeURIComponent(value.replace(/#L?\d+(?:-L?\d+)?$/iu, ''));
+  } catch {
+    return null;
+  }
+}
+
+function messageLinkPaths(content) {
+  const paths = [];
+  const link = /(?<!\\)\[(?:\\.|[^\]\\\n])+\]\(\s*(?:<([^<>\n]+)>|((?:\\.|[^\s()\\]|\([^()\s]*\))+))(?:[ \t]+(?:"[^"\n]*"|'[^'\n]*'))?\s*\)/gu;
+  for (const part of content) {
+    if (part.type !== 'text' || typeof part.text !== 'string') continue;
+    let fence;
+    const prose = part.text.split(/\r?\n/u).map((line) => {
+      const marker = /^ {0,3}(`{3,}|~{3,})(.*)$/u.exec(line);
+      if (fence) {
+        if (marker?.[1][0] === fence[0] && marker[1].length >= fence.length && !marker[2].trim()) fence = undefined;
+        return '';
+      }
+      if (marker) fence = marker[1];
+      return marker || /^(?: {4}|\t)/u.test(line) ? '' : line;
+    }).join('\n').replace(/(?<!`)(`+)(?!`)[\s\S]*?(?<!`)\1(?!`)/gu, '');
+    for (const [, angle, bare] of prose.matchAll(link)) {
+      const path = localLinkPath(angle ?? bare);
+      if (path) paths.push(path);
+    }
+  }
+  return paths;
+}
+
+function toolArgumentPath(name, raw) {
+  if (name !== 'write' && name !== 'edit' && name !== 'str_replace_editor') return null;
+  let args = raw;
+  if (typeof raw === 'string') {
+    try {
+      args = JSON.parse(raw);
+    } catch {
+      return null;
+    }
+  }
+  if (name === 'write' || name === 'edit') return args?.file_path;
+  if (name === 'str_replace_editor' && ['create', 'insert', 'str_replace'].includes(args?.command)) {
+    return args.path;
+  }
+  return null;
+}
+
+function resultPaths(name, content, meta, argumentPath) {
+  if (IMAGE_TOOL.test(name)) {
+    return (content ?? []).flatMap((part) => {
+      if (part.type !== 'text' || typeof part.text !== 'string') return [];
+      // The media tool reports its saved path before the provider and aspect ratio.
+      const match = /^Saved image to: (.+) \(provider=[^\r\n]+\)\r?$/mu.exec(part.text);
+      return match ? [match[1]] : [];
+    });
+  }
+  if (name === 'apply_patch') {
+    return (content ?? []).flatMap((part) => {
+      if (part.type !== 'text' || typeof part.text !== 'string' ||
+        !part.text.startsWith('Success. Updated the following files:\n')) return [];
+      return [...part.text.matchAll(/^[AM] (.+)$/gmu)].map((match) => match[1]);
+    });
+  }
+  if (name === 'str_replace_editor' && !argumentPath) return [];
+  return FILE_TOOLS.has(name) ? [meta?.path ?? argumentPath] : [];
+}
+
+const filesSchema = {
+  parse(files) {
+    if (!Array.isArray(files) || !files.every(isPath)) throw new Error('Invalid session output files');
+    return files;
+  },
+};
+
+export const sessionOutputsProjection = {
+  key: 'workbenchOutputs',
+  stateVersion: 3,
+  stateSchema: {
+    parse(state) {
+      if (!state || !(state.cwd === null || isPath(state.cwd)) || !Array.isArray(state.calls) ||
+        !state.calls.every((call) => typeof call?.id === 'string' && typeof call.name === 'string' &&
+          (call.path === null || isPath(call.path)))) {
+        throw new Error('Invalid session output state');
+      }
+      filesSchema.parse(state.files);
+      return state;
+    },
+  },
+  init: (header) => ({ cwd: header.cwd ?? null, files: [], calls: [] }),
+  apply(state, { type, data }) {
+    switch (type) {
+      case 'working-directory/change':
+        return state.cwd === data.cwd ? state : { ...state, cwd: data.cwd };
+      case 'deliverables/presented':
+        return addOutputs(state, (data.files ?? []).map((file) => file.path));
+      case 'assistant/message': {
+        const content = data.message.content;
+        if (data.interrupted || content.some((part) => part.type === 'tool-call')) return state;
+        return addOutputs(state, messageLinkPaths(content));
+      }
+      case 'tool/call': {
+        const { callId, name, arguments: args } = data;
+        if (!FILE_TOOLS.has(name) && !IMAGE_TOOL.test(name)) return state;
+        const path = outputPath(state.cwd, toolArgumentPath(name, args));
+        return { ...state, calls: [...state.calls, { id: callId, name, path }] };
+      }
+      case 'tool/result': {
+        const { message, meta } = data;
+        const call = state.calls.find(({ id }) => id === message.source.callId);
+        if (!call) return state;
+        const settled = { ...state, calls: state.calls.filter(({ id }) => id !== call.id) };
+        return message.isError ? settled : addOutputs(settled, resultPaths(call.name, message.content, meta, call.path));
+      }
+      case 'tool/ptc-dispatch':
+        if (data.isError !== false) return state;
+        return addOutputs(state, resultPaths(data.name, data.content, data.meta,
+          toolArgumentPath(data.name, data.arguments)));
+      default:
+        return state;
+    }
+  },
+  wire: { summary: false, viewSchema: filesSchema, view: (state) => state.files },
+};