dsh-claude-desktop-theme 0.4.4 → 0.4.6

package/lib/index.js

@@ -2,31 +2,41 @@
 import z from "@deepseek-ai/schemastery";
 
 // src/shared/config.ts
+var DEFAULT_PERSONALIZATION = Object.freeze({
+  petStyle: "claude",
+  runningStyle: "claude",
+  replySignatureStyle: "claude",
+  greetingStyle: "claude",
+  greetingName: ""
+});
 var DEFAULT_FEATURES = Object.freeze({
   shell: true,
   sidebar: true,
   "new-session": true,
   conversation: true,
-  "tool-calls": false,
-  statistics: false,
+  "tool-calls": true,
+  statistics: true,
   "composer-pet": true,
   "composer-stats": false,
-  "context-panel": true
+  "context-panel": true,
+  "hero-ripples": true
 });
 var DEFAULT_APPEARANCE = Object.freeze({
   canvas: "",
   sidebar: ""
 });
 var DEFAULT_FONTS = Object.freeze({
-  uiLatin: "",
-  uiCjk: "",
-  code: ""
+  uiLatin: "Anthropic Sans Web",
+  uiCjk: "Anthropic Serif Web",
+  code: "SF Mono"
 });
 var DEFAULT_VIEW = Object.freeze({
   showEmptyGroups: false,
   groupByStatus: true,
   showHeaderSubagents: false,
-  showHeaderTeam: false
+  showHeaderTeam: false,
+  showSidebarBrand: false,
+  showModelIcons: true
 });
 var FONT_NAME_MAX_LENGTH = 64;
 
@@ -166,7 +176,7 @@ function viewUsage(state) {
   const cached = views.get(state);
   if (cached !== void 0) return cached;
   const models = modelPairs(state.models);
-  const view = {
+  const view2 = {
     prompts: state.prompts,
     tokens: state.tokens,
     days: pairs(state.days),
@@ -174,8 +184,8 @@ function viewUsage(state) {
     models,
     modelDays: modelDayRows(state.modelDays, models)
   };
-  views.set(state, view);
-  return view;
+  views.set(state, view2);
+  return view2;
 }
 function schemaOf(parse) {
   return { parse };
@@ -975,9 +985,9 @@ function createContextProjection(policy) {
       view(state) {
         const cached = views2.get(state);
         if (cached !== void 0) return cached;
-        const view = viewContext(state, policy());
-        views2.set(state, view);
-        return view;
+        const view2 = viewContext(state, policy());
+        views2.set(state, view2);
+        return view2;
       }
     },
     stateVersion: CONTEXT_STATE_VERSION
@@ -1001,6 +1011,221 @@ function mountContextBreakdown(ctx, isEnabled) {
   });
 }
 
+// src/shared/balance.ts
+var BALANCE_PATH = "/api/ccd-deepseek-balance";
+function readCnyBalance(value) {
+  if (!value || typeof value !== "object" || !("balance_infos" in value) || !Array.isArray(value.balance_infos)) return null;
+  const row = value.balance_infos.find((row2) => row2?.currency === "CNY");
+  const amount = (value2) => typeof value2 === "string" && /^-?\d+(?:\.\d+)?$/.test(value2) && Number.isFinite(Number(value2));
+  if (!row || !amount(row.total_balance) || !amount(row.granted_balance) || !amount(row.topped_up_balance)) return null;
+  return { total: row.total_balance, granted: row.granted_balance, toppedUp: row.topped_up_balance };
+}
+
+// src/host/balance.ts
+async function readBalanceKey(ctx) {
+  const loader = ctx.get("loader");
+  const entry = loader && [...loader.entries()].find((entry2) => entry2.disabled !== true && entry2.options?.name === "@deepseek-ai/dsh-llm-deepseek-api-key");
+  if (!entry) return void 0;
+  const config = entry.options?.config;
+  const environment = ctx.get("launchEnvironment");
+  const baseURL = config?.baseURL ?? (environment ? environment.get("DEEPSEEK_BASE_URL")?.value : process.env["DEEPSEEK_BASE_URL"]) ?? "https://api.deepseek.com/anthropic";
+  if (new URL(baseURL).origin !== "https://api.deepseek.com") return void 0;
+  const ref = config?.apiKeyEnv ?? "DEEPSEEK_API_KEY";
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(ref)) return void 0;
+  const credentials = ctx.get("credentials");
+  const key = credentials ? (await credentials.resolve(ref))?.value : environment ? environment.get(ref)?.value : process.env[ref];
+  return key?.trim() || void 0;
+}
+function mountDeepSeekBalance(ctx, isEnabled) {
+  ctx.inject(["connection"], (injected) => {
+    if (!isEnabled()) return;
+    const connection = injected.get("connection");
+    if (!connection) return;
+    ctx.effect(() => connection.fetch.register({
+      path: BALANCE_PATH,
+      methods: ["GET"],
+      requestBody: "buffered",
+      fetch: async (request) => {
+        const reply = (state, balance = null) => Response.json({ state, balance }, {
+          headers: { "cache-control": "no-store" }
+        });
+        if (!isEnabled()) return reply("unconfigured");
+        try {
+          const key = await readBalanceKey(injected);
+          if (!key) return reply("unconfigured");
+          const response = await fetch("https://api.deepseek.com/user/balance", {
+            headers: { authorization: `Bearer ${key}`, accept: "application/json" },
+            redirect: "error",
+            signal: AbortSignal.any([request.signal, AbortSignal.timeout(1e4)])
+          });
+          if (response.status === 401 || response.status === 403) return reply("unauthorized");
+          if (!response.ok) return reply("error");
+          const balance = readCnyBalance(await response.json());
+          return reply(balance ? "ready" : "no-cny", balance);
+        } catch {
+          return reply("error");
+        }
+      }
+    }), "deepseek: balance route");
+  });
+}
+
+// src/host/git.ts
+import { execFile } from "node:child_process";
+
+// src/shared/git.ts
+var GIT_BRANCHES_PATH = "/api/ccd-git-branches";
+var GIT_BRANCH_LIMIT = 200;
+var GIT_CHECKOUT_PATH = "/api/ccd-git-checkout";
+
+// src/host/git.ts
+var runGit = (cwd, args, signal, timeout = 5e3) => new Promise((resolve, reject) => {
+  execFile("git", ["-c", "core.fsmonitor=false", ...args], {
+    cwd,
+    signal,
+    timeout,
+    windowsHide: true,
+    maxBuffer: 1 << 20,
+    encoding: "utf8",
+    env: { ...process.env, LC_ALL: "C", GIT_TERMINAL_PROMPT: "0", GIT_OPTIONAL_LOCKS: "0" }
+  }, (error, stdout, stderr) => {
+    if (error) reject(Object.assign(error, { stderr }));
+    else resolve(stdout);
+  });
+});
+var view = (state) => ({ state, current: null, detached: false, branches: [], truncated: false });
+async function listBranches(cwd, run, signal) {
+  let listed;
+  try {
+    listed = await run(cwd, [
+      "for-each-ref",
+      "--sort=-committerdate",
+      `--count=${GIT_BRANCH_LIMIT + 1}`,
+      "--format=%(refname:short)",
+      "refs/heads"
+    ], signal);
+  } catch (error) {
+    const failure = error;
+    if (failure.code === "ENOENT") return view("no-git");
+    if (failure.code === 128 && /not a git repository/iu.test(String(failure.stderr ?? ""))) return view("not-repo");
+    return view("error");
+  }
+  let current = null;
+  let detached = false;
+  try {
+    current = (await run(cwd, ["symbolic-ref", "--quiet", "--short", "HEAD"], signal)).trim() || null;
+  } catch {
+    try {
+      current = (await run(cwd, ["rev-parse", "--short", "HEAD"], signal)).trim() || null;
+      detached = current !== null;
+    } catch {
+    }
+  }
+  const names = listed.split("\n").map((line) => line.trim()).filter(Boolean);
+  const truncated = names.length > GIT_BRANCH_LIMIT;
+  const others = names.slice(0, GIT_BRANCH_LIMIT).filter((name) => name !== current);
+  const branches = current !== null && !detached ? [current, ...others] : others;
+  return { state: "ready", current, detached, branches: branches.slice(0, GIT_BRANCH_LIMIT), truncated };
+}
+var outcome = (state, carried = 0, message = "") => ({ state, carried, message });
+var switching = /* @__PURE__ */ new Map();
+async function checkoutBranch(cwd, branch, run) {
+  const previous = switching.get(cwd) ?? Promise.resolve();
+  const attempt = previous.catch(() => {
+  }).then(() => switchNow(cwd, branch, run));
+  switching.set(cwd, attempt);
+  try {
+    return await attempt;
+  } finally {
+    if (switching.get(cwd) === attempt) switching.delete(cwd);
+  }
+}
+async function switchNow(cwd, branch, run) {
+  const signal = new AbortController().signal;
+  if (branch === "" || branch.startsWith("-") || /[\0\n\r]/u.test(branch)) return outcome("invalid-branch");
+  try {
+    await run(cwd, ["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`], signal);
+  } catch {
+    return outcome("invalid-branch");
+  }
+  try {
+    await run(cwd, ["switch", branch], signal, 6e4);
+  } catch (error) {
+    const stderr = String(error.stderr ?? "");
+    if (/would be overwritten by checkout|overwritten by switch|commit your changes or stash them/iu.test(stderr)) return outcome("conflict");
+    if (/already (?:checked out|used by worktree)/iu.test(stderr)) return outcome("in-worktree");
+    const line = stderr.split("\n").map((text) => text.trim()).find(Boolean) ?? "";
+    return outcome("error", 0, line.replace(/^(?:fatal|error):\s*/iu, ""));
+  }
+  let carried = 0;
+  try {
+    carried = (await run(cwd, ["status", "--porcelain", "--untracked-files=no"], signal)).split("\n").filter((line) => line.trim() !== "").length;
+  } catch {
+  }
+  return outcome("switched", carried);
+}
+function mountGitBranches(ctx, isEnabled, run = runGit) {
+  ctx.inject(["connection"], (injected) => {
+    if (!isEnabled()) return;
+    const connection = injected.get("connection");
+    if (!connection) return;
+    ctx.effect(() => connection.fetch.register({
+      path: GIT_BRANCHES_PATH,
+      methods: ["GET"],
+      requestBody: "buffered",
+      fetch: async (request) => {
+        const reply = (body) => Response.json(body, { headers: { "cache-control": "no-store" } });
+        if (!isEnabled()) return reply(view("error"));
+        const id = new URL(request.url, "http://host").searchParams.get("workspace") ?? "";
+        const registry = injected.get("workspaceRegistry");
+        let path;
+        try {
+          path = id === "" ? void 0 : registry?.get(id)?.path;
+        } catch {
+          path = void 0;
+        }
+        if (path === void 0) return reply(view("unknown-workspace"));
+        try {
+          return reply(await listBranches(path, run, request.signal));
+        } catch {
+          return reply(view("error"));
+        }
+      }
+    }), "git: branch route");
+    ctx.effect(() => connection.fetch.register({
+      path: GIT_CHECKOUT_PATH,
+      methods: ["POST"],
+      requestBody: "buffered",
+      fetch: async (request) => {
+        const reply = (body2) => Response.json(body2, { headers: { "cache-control": "no-store" } });
+        if (!isEnabled()) return reply(outcome("error"));
+        let body;
+        try {
+          body = await request.json();
+        } catch {
+          body = void 0;
+        }
+        const fields = body && typeof body === "object" ? body : {};
+        const id = typeof fields["workspace"] === "string" ? fields["workspace"] : "";
+        const branch = typeof fields["branch"] === "string" ? fields["branch"] : "";
+        const registry = injected.get("workspaceRegistry");
+        let path;
+        try {
+          path = id === "" ? void 0 : registry?.get(id)?.path;
+        } catch {
+          path = void 0;
+        }
+        if (path === void 0) return reply(outcome("unknown-workspace"));
+        try {
+          return reply(await checkoutBranch(path, branch, run));
+        } catch {
+          return reply(outcome("error"));
+        }
+      }
+    }), "git: checkout route");
+  });
+}
+
 // src/host/index.ts
 var HEX_COLOUR = /^(#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6})?$/;
 var FONT_NAME = new RegExp(`^[\\p{L}\\p{N} ._-]{0,${FONT_NAME_MAX_LENGTH}}$`, "u");
@@ -1016,7 +1241,8 @@ var Config = z.object({
     statistics: z.boolean().default(DEFAULT_FEATURES.statistics),
     "composer-pet": z.boolean().default(DEFAULT_FEATURES["composer-pet"]),
     "composer-stats": z.boolean().default(DEFAULT_FEATURES["composer-stats"]),
-    "context-panel": z.boolean().default(DEFAULT_FEATURES["context-panel"])
+    "context-panel": z.boolean().default(DEFAULT_FEATURES["context-panel"]),
+    "hero-ripples": z.boolean().default(DEFAULT_FEATURES["hero-ripples"])
   }).default({ ...DEFAULT_FEATURES }).description("\u6309\u6A21\u5757\u542F\u7528").volatile(),
   /* One volatile node per section, exactly like `features`: Cordis rejects a
      volatile field nested inside another volatile field ("volatile fields
@@ -1031,7 +1257,16 @@ var Config = z.object({
     uiCjk: z.string().default(DEFAULT_FONTS.uiCjk).description("\u754C\u9762\u4E2D\u6587\u5B57\u4F53\u540D\uFF08\u7559\u7A7A\u7528\u7CFB\u7EDF\u6808\uFF09").pattern(FONT_NAME),
     code: z.string().default(DEFAULT_FONTS.code).description("\u4EE3\u7801\u4E0E\u7B49\u5BBD\u5B57\u4F53\u540D\uFF08\u7559\u7A7A\u7528\u7CFB\u7EDF\u6808\uFF09").pattern(FONT_NAME)
   }).default({ ...DEFAULT_FONTS }).description("\u5B57\u4F53").volatile(),
+  personalization: z.object({
+    petStyle: z.union(["whale", "claude"]).default(DEFAULT_PERSONALIZATION.petStyle).description("\u8F93\u5165\u6846\u5BA0\u7269\u6837\u5F0F"),
+    runningStyle: z.union(["whale", "claude"]).default(DEFAULT_PERSONALIZATION.runningStyle).description("\u804A\u5929\u8F93\u51FA\u4E2D\u7684\u7B49\u5F85\u56FE\u6807\u4E0E\u72B6\u6001\u6837\u5F0F"),
+    replySignatureStyle: z.union(["whale", "claude"]).default(DEFAULT_PERSONALIZATION.replySignatureStyle).description("\u56DE\u590D\u7ED3\u675F\u540E\u7684\u7B7E\u540D\u56FE\u6807\u6837\u5F0F"),
+    greetingStyle: z.union(["explore", "claude"]).default(DEFAULT_PERSONALIZATION.greetingStyle).description("\u9996\u9875\u95EE\u5019\u8BED\u4E0E\u56FE\u6807\u6837\u5F0F"),
+    greetingName: z.string().default("").pattern(/^.{0,64}$/u).description("\u95EE\u5019\u8BED\u4E2D\u7684\u79F0\u547C\uFF08\u53EF\u7559\u7A7A\uFF09")
+  }).default({ ...DEFAULT_PERSONALIZATION }).description("\u4E2A\u6027\u5316").volatile(),
   view: z.object({
+    showModelIcons: z.boolean().default(DEFAULT_VIEW.showModelIcons).description("\u663E\u793A\u6A21\u578B\u9009\u5355\u4E2D\u7684\u524D\u7F6E\u56FE\u6807\uFF08\u9ED8\u8BA4\u5F00\u542F\uFF09"),
+    showSidebarBrand: z.boolean().default(DEFAULT_VIEW.showSidebarBrand).description("\u663E\u793A\u4FA7\u680F DeepSeek Harness \u54C1\u724C\u6761\u76EE\uFF08\u9ED8\u8BA4\u5173\u95ED\uFF09"),
     showHeaderSubagents: z.boolean().default(DEFAULT_VIEW.showHeaderSubagents).description("\u663E\u793A\u9876\u680F\u5B50\u4EE3\u7406\u5165\u53E3\uFF08\u4EC5\u63A7\u5236\u5165\u53E3\u663E\u793A\uFF09"),
     showHeaderTeam: z.boolean().default(DEFAULT_VIEW.showHeaderTeam).description("\u663E\u793A\u9876\u680F\u56E2\u961F\u5165\u53E3\uFF08\u4EC5\u63A7\u5236\u5165\u53E3\u663E\u793A\uFF09"),
     groupByStatus: z.boolean().default(DEFAULT_VIEW.groupByStatus).description("\u6309\u4F1A\u8BDD\u72B6\u6001\u5206\u7EC4\uFF08\u4FDD\u7559\u539F\u751F\u9879\u76EE\u89C6\u56FE\u9009\u9879\uFF09"),
@@ -1053,6 +1288,8 @@ function apply(ctx, config) {
   const host = typeof config === "object" && config !== null ? config : {};
   mountStatistics(ctx, () => readValue(host.enabled, false) === true);
   mountContextBreakdown(ctx, () => readValue(host.enabled, false) === true);
+  mountDeepSeekBalance(ctx, () => readValue(host.enabled, false) === true);
+  mountGitBranches(ctx, () => readValue(host.enabled, false) === true);
 }
 export {
   Config,

package/lib/types/client/compat/account-balance.d.ts

@@ -0,0 +1,8 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Last completed display, retained across menu openings for the same account. */
+export interface AccountBalanceCache {
+    text?: string;
+    title?: string;
+}
+/** One usage row in the lower-left account menu; polling lives only while open. */
+export declare function mountAccountBalance(menu: HTMLElement, cache?: AccountBalanceCache): Disposer;

package/lib/types/client/compat/browser-header.d.ts

@@ -2,10 +2,9 @@ import type { Disposer } from '../contracts/ports.ts';
 /**
  * The name the browsing region's own title line draws.
  * @param text - the host's word, exactly as it rendered it.
- * @param noHistory - whether the plugin's no-history prompt is on screen.
  * @returns the reference's name, or null to leave the host's own word.
  */
-export declare function browserHeaderWord(text: string, noHistory: boolean): string | null;
+export declare function browserHeaderWord(text: string): string | null;
 /**
  * Name the browsing region's separate toolbar.
  *

package/lib/types/client/compat/changed-files.d.ts

@@ -0,0 +1,7 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Only the host's count title is normalized; file names are never translated. */
+export declare function changedFilesTitle(title: string): string | undefined;
+/** Decorate native completed-turn summaries without moving React-owned nodes.
+ * Native headers/rows retain review and hover-preview handlers. The added
+ * footer delegates to the header, and decorative icons copy its native glyph. */
+export declare function mountChangedFiles(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/composer-status-order.d.ts

@@ -1,56 +1,3 @@
 import type { Disposer } from '../contracts/ports.ts';
-/**
- * The Composer status bar's seat order, and the context ring's accessible name.
- *
- * Host facts (DSH `0.2.0-rc.2`, read from the installed `app.asar`):
- *
- * - The status bar is `ui-conversation`'s `InputBar` control row
- *   (`.yhfFVG_row`). Its flex children are the leading `.yhfFVG_tools` group —
- *   command button, then `.yhfFVG_modes` holding the `conversation.input.permission`
- *   and `conversation.input.plan` seats — and the trailing `.yhfFVG_trailing`
- *   group — the model seat, then the `conversation.input.activity` seat, then the
- *   absolutely positioned send/stop buttons.
- * - `@deepseek-ai/dsh-experimental-client-ui-voice-input` registers its control
- *   into `conversation.input.activity`. The renderer seats every slot entry in a
- *   `display: contents` outlet (`div[data-slot="…"]`, see
- *   `dsh-client-ui-renderer`'s `SlotOutlet`), so the seat the slot occupies is
- *   that outlet's parent element.
- * - `ContextMeter` (`ui-conversation`'s skeleton) renders the ring's trigger
- *   with an accessible name carrying the reading, and returns nothing at all
- *   until the token meter knows both a numerator and the context window.
- *
- * The voice control therefore sits one flex container away from the permission
- * control it is asked to follow, and `order` cannot cross containers: the seat
- * itself has to move. It is moved into `.yhfFVG_modes`, immediately after the
- * permission seat and before the plan seat, and marked with
- * {@link VOICE_SEAT_ATTRIBUTE} so the stylesheet and the release path can find
- * it.
- *
- * Moving a node React owns is only safe while React never removes that node from
- * the parent it was moved out of. It does not: `InputBar` renders the seat under
- * two guards, `input === void 0` and `sessionId === void 0` — `input` is the
- * shell's own store snapshot, which exists as soon as the shell does — and the
- * `conversation.composer.bar` entry that owns the whole Composer is a
- * `session-maybe` slot, whose documented contract is that such an entry adopts
- * its first session in place and remounts, as one deleted subtree, on every later
- * identity change. Within one instance the seat is therefore only ever inserted,
- * never removed. Moving the *ring* instead is not available at all: `InputBar`
- * unmounts the ring whenever the voice control expands, and React would then call
- * `removeChild` on a parent the node no longer belongs to.
- *
- * The seat goes back to its recorded host position — and the mark comes off —
- * whenever the host switches the row to the voice control's capture layout
- * (`InputBar` hides `.yhfFVG_tools` and lets `.yhfFVG_trailing` span the row), so
- * that layout keeps the host's own geometry, and again on release.
- */
-/** Mark on a relocated voice seat; the composer sheet reads it. */
-export declare const VOICE_SEAT_ATTRIBUTE = "data-ccd-voice-seat";
-/**
- * Keep the voice control beside the permission control, and the context ring's
- * accessible name free of the percentage it no longer shows.
- *
- * @param document - renderer document carrying the Composer.
- * @param report - sink for observer failures; the host's own order stays.
- * @returns disposer that restores every seat and label it touched.
- */
+/** Name context rings and suppress the host's portaled dictation hint. */
 export declare function mountComposerStatusOrder(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/hero-greeting.d.ts

@@ -0,0 +1,6 @@
+import type { PersonalizationConfig } from '../../shared/config.ts';
+import type { Disposer } from '../contracts/ports.ts';
+/** The greeting follows the interface language and never includes an account name. */
+export declare function claudeGreeting(language?: string): string;
+/** Add a reversible presentation beside the native heading without taking its React nodes. */
+export declare function mountHeroGreeting(document: Document, config: PersonalizationConfig): Disposer;

package/lib/types/client/compat/host-dom.d.ts

@@ -42,6 +42,8 @@
  * - `packages/client/ui-settings/src/client/SettingsRoot.module.css` (`Dws9Sa_`)
  * - `packages/client/ui-settings-account/src/client/AccountMenu.module.css` (`ZogL4G_`)
  * - `packages/client/ui-primitives/lib/Menu.module.css` (`_4ub78_`, `_ri079_`)
+ * - `packages/client/ui-primitives/lib/Modal.module.css` (`_o6lrb_`) and
+ *   `RiskConfirmation.module.css` (`_cjd8z_`), shared static frontend styles
  * - `packages/client/ui-primitives/lib/Menu.js` (`MenuItemButton`: the icon seat
  *   `account-menu.css` scales; its `[role="menuitem"] > span` structure)
  * - `packages/client/ui-chat/src/client/chat/AssistantMarkdown.module.css` (`gKv1-q_`)
@@ -127,6 +129,7 @@ export declare const HOST: Readonly<{
     readonly filesBody: '[data-files-body]';
     readonly filesEntry: '[data-files-entry]';
     readonly sidebarRoot: '._3WPZCG_root';
+    readonly sidebarCollapsed: '._3WPZCG_collapsed';
     readonly sidebarLogoRow: '._3WPZCG_logoRow';
     readonly sidebarBrand: '._3WPZCG_brand';
     readonly sidebarBrandName: '._3WPZCG_brandName';
@@ -166,6 +169,9 @@ export declare const HOST: Readonly<{
     /** StateDot's stable state attributes, used when root sessionStatus is absent. */
     readonly sessionNeedsInput: '[aria-hidden="true"][data-state="warning"]';
     readonly sessionWorking: '[aria-hidden="true"][data-state="ongoing"]';
+    /** Rows.module.css: the Session row the main panel is showing. A folded
+        status section keeps this one row visible. */
+    readonly sessionRowSelected: '.jJkEga_selected';
     /** Rows.module.css: one Workspace's row, the line the merged header shares,
         and its trailing action group (`sidebar.css` parks both). */
     readonly workspaceRow: '.jJkEga_projectRow';
@@ -326,6 +332,11 @@ export declare const HOST: Readonly<{
         children, so the statistics card is appended here and positioned against
         the greeting. */
     readonly heroComposerStack: '.ST7X_W_composerStack';
+    /** Shared frontend RiskConfirmation DOM, identical in both desktop builds. */
+    readonly riskConfirmation: '._confirmation_cjd8z_1[role="dialog"]';
+    readonly riskAcknowledgement: '._acknowledgement_cjd8z_38';
+    readonly riskConfirmAction: '._confirmAction_cjd8z_71';
+    readonly riskCancelAction: '._modalAction_cjd8z_67';
     /** Every menu surface the `Menu` primitive renders, portal or in place. */
     readonly menu: '[role="menu"]';
     readonly menuItem: '[role="menuitem"]';
@@ -350,6 +361,11 @@ export declare const HOST: Readonly<{
  * means the frame is not the pinned one and the feature must stay off.
  */
 export declare const ANCHOR: Readonly<{
+    /** ChatNodeSeat / ToolCallTree: immutable transcript seats and atomic calls. */
+    readonly chatFlowItem: '[data-chat-flow-kind]';
+    readonly toolFlow: '[data-chat-flow-kind="tool-call"]';
+    readonly reasoningFlow: '[data-chat-group-part="reasoning"]';
+    readonly toolCall: '[data-chat-call-id]';
     /** ui-chat TurnProcessNodeView / ChatGroupSeat: process containers, not leaf details. */
     readonly turnProcess: 'button[data-turn-process]';
     readonly stepProcessToggle: '[data-step-process] > div > button[data-process-activity]';

package/lib/types/client/compat/mutation-scope.d.ts

@@ -1,17 +1,3 @@
-/**
- * Whether a mutation batch can concern one region of the page.
- *
- * Several modules here observe the whole body because the host can move or
- * rebuild their anchor at any time, then pay a geometry pass on every batch.
- * Most batches, though, come from somewhere else — a drag in the right pane, a
- * streaming transcript on another page, another plugin writing its own markup.
- * This predicate lets a module skip those batches without narrowing what it
- * observes, so an anchor that is replaced still reaches it.
- *
- * The answer is deliberately conservative: a region that is missing, detached
- * or cannot answer `contains` makes every batch relevant, so a module that
- * cannot yet measure is never starved of the mutation that would let it.
- */
 /**
  * Whether any record in a batch can move something inside `region`.
  *
@@ -41,3 +27,21 @@ export declare function recordsTouch(records: readonly MutationRecord[], region:
  * @returns true when an inserted element is, or contains, a match.
  */
 export declare function recordsIntroduce(records: readonly MutationRecord[], selector: string): boolean;
+/**
+ * Whether every record in a batch stayed inside the transcript's chat seats.
+ *
+ * While a reply streams, nearly every batch is text and markup growing inside
+ * one `[data-chat-flow-kind]` seat. A module that only dresses the sidebar,
+ * the Composer, a menu or a dialog cannot be affected by those writes, and a
+ * document-wide `querySelectorAll` per streamed batch is the largest cost this
+ * plugin adds to the host's own rendering. Such a module returns early on
+ * these batches; a seat being inserted or removed is written on its parent,
+ * outside every seat, so structural changes still reach it.
+ *
+ * The answer is conservative: a missing or empty batch, or a target that cannot answer
+ * `closest`, is not confined, and the module looks again as it always did.
+ *
+ * @param records - the observer's batch.
+ * @returns true when the batch can be skipped by a module outside the transcript.
+ */
+export declare function recordsInTranscript(records: readonly MutationRecord[]): boolean;

package/lib/types/client/compat/pane-chrome.d.ts

@@ -14,6 +14,11 @@ export interface PaneChromeOptions {
         title: string;
         selected: boolean;
     }[];
+    readonly browsers: readonly {
+        id: string;
+        title: string;
+        selected: boolean;
+    }[];
     readonly files: readonly {
         id: string;
         title: string;

package/lib/types/client/compat/pane-icons.d.ts

@@ -17,6 +17,8 @@ declare const ICONS: {
     readonly Files: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M785 247H415Q396 247 380.5 256.0Q365 265 356.0 280.5Q347 296 347 315V835Q347 854 356.0 869.5Q365 885 380.5 894.0Q396 903 415 903H666Q693 903 713 884L833 767Q853 747 853 718V315Q853 296 844.0 280.5Q835 265 819.5 256.0Q804 247 785 247ZM785 303Q790 303 793.5 306.5Q797 310 797 315V718L793 727L674 844L666 847H415Q410 847 406.5 843.5Q403 840 403 835V315Q403 310 406.5 306.5Q410 303 415 303ZM375 753V697H215Q210 697 206.5 693.5Q203 690 203 685V165Q203 160 206.5 156.5Q210 153 215 153H585Q590 153 593.5 156.5Q597 160 597 165V275H653V165Q653 146 644.0 130.5Q635 115 619.5 106.0Q604 97 585 97H215Q196 97 180.5 106.0Q165 115 156.0 130.5Q147 146 147 165V685Q147 704 156.0 719.5Q165 735 180.5 744.0Q196 753 215 753ZM622 850Q622 862 630.0 870.0Q638 878 650 878Q662 878 670.0 870.0Q678 862 678 850V750Q678 741 684.5 734.5Q691 728 700 728H800Q812 728 820.0 720.0Q828 712 828 700Q828 688 820.0 680.0Q812 672 800 672H700Q678 672 660.5 682.5Q643 693 632.5 710.5Q622 728 622 750Z\"/></svg>";
     readonly SidebarClose: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M147 825Q147 837 155.0 845.0Q163 853 175 853Q187 853 195.0 845.0Q203 837 203 825V175Q203 163 195.0 155.0Q187 147 175 147Q163 147 155.0 155.0Q147 163 147 175ZM825 528Q837 528 845.0 520.0Q853 512 853 500Q853 488 845.0 480.0Q837 472 825 472H393L570 295Q578 287 578.0 275.0Q578 263 570 255Q562 247 550.0 247.0Q538 247 530 255L305 480Q296 489 296.5 500.5Q297 512 304.5 520.0Q312 528 325 528ZM530 745Q538 753 550.0 753.0Q562 753 570 745Q578 737 578.0 725.0Q578 713 570 705L345 480L305 520Z\"/></svg>";
     readonly SidebarOpen: "<svg viewBox=\"0 0 1000 1000\" fill=\"currentColor\" aria-hidden=\"true\"><path transform=\"translate(0 1000) scale(1 -1)\" d=\"M797 825Q797 837 805.0 845.0Q813 853 825 853Q837 853 845.0 845.0Q853 837 853 825V175Q853 163 845.0 155.0Q837 147 825 147Q813 147 805.0 155.0Q797 163 797 175ZM175 472Q163 472 155.0 480.0Q147 488 147 500Q147 512 155.0 520.0Q163 528 175 528H675Q688 528 695.5 520.0Q703 512 703.5 500.5Q704 489 695 480L470 255Q462 247 450.0 247.0Q438 247 430 255Q422 263 422.0 275.0Q422 287 430 295L607 472ZM430 705Q422 713 422.0 725.0Q422 737 430 745Q438 753 450.0 753.0Q462 753 470 745L695 520L655 480Z\"/></svg>";
+    readonly ArrowLeft: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 12H4m7-7-7 7 7 7"/></svg>';
+    readonly ArrowRight: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 12h16m-7-7 7 7-7 7"/></svg>';
 };
 export type PaneIcon = keyof typeof ICONS;
 export declare function paneIcon(name: PaneIcon): string;

package/lib/types/client/compat/pane-labels.d.ts

@@ -58,6 +58,8 @@ export interface PaneChromeLabels {
 }
 /** The capture menu's one row, and the webview area's two states. */
 export interface BrowserPaneLabels {
+    readonly newTab: string;
+    readonly tabs: string;
     readonly saveScreenshot: string;
     readonly awaitingServer: string;
     readonly enterAddress: string;

package/lib/types/client/compat/permission-confirmation.d.ts

@@ -0,0 +1,5 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Remove the redundant acknowledgement step from permission confirmations.
+ * The native handler still updates React; only the user can press Enable.
+ * Other RiskConfirmation callers retain their acknowledgement controls. */
+export declare function mountPermissionConfirmation(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/permission-menu.d.ts

@@ -36,6 +36,9 @@ export interface PermissionCopy {
  * @returns Chinese copy for a Chinese document, English otherwise.
  */
 export declare function permissionCopy(document: Document): PermissionCopy;
+/** Short summaries of DSH's four built-in Agent presets. */
+export declare function agentPresetCopy(document: Document): PermissionCopy;
+export declare function mountAgentPresetMenu(document: Document, report: (error: unknown) => void): Disposer;
 /**
  * The permission picker's card, drawn the way the reference draws it.
  *
@@ -54,7 +57,7 @@ export declare function permissionCopy(document: Document): PermissionCopy;
  * `permissionCopy` above. It is kept in one table per document language, so a
  * wording change is one edit in one place.
  *
- * Three facts decide how the rows are reached, and each is worth stating:
+ * Three facts decide how the permission rows are reached, and each is worth stating:
  *
  * - **A row is recognised by its name.** `Menu` rows carry no identity of their
  *   own — no id, no data attribute, and the preset's own glyph is a thing this

package/lib/types/client/compat/pet-anchor.d.ts

@@ -27,4 +27,8 @@ export declare const PET_INSET = 12;
  * selects new sessions; hidden, missing or unlaid-out cards publish null.
  * @returns position source whose dispose releases all listeners and observers.
  */
-export declare function createPetAnchor(document: Document, report: (error: unknown) => void): PetAnchorSource;
+export declare function createPetAnchor(document: Document, report: (error: unknown) => void, box?: {
+    readonly width: number;
+    readonly height: number;
+    readonly inset?: number;
+}): PetAnchorSource;

package/lib/types/client/compat/plugin-feedback.d.ts

@@ -0,0 +1,28 @@
+/** New-issue form of the plugin repository; title and body arrive as query parameters. */
+export declare const FEEDBACK_ISSUE_URL = "https://github.com/zkforge/dsh-claude-desktop-theme/issues/new";
+/** One diagnostic row appended under the description. */
+export type FeedbackEnvironment = readonly (readonly [label: string, value: string])[];
+/**
+ * The new-issue URL for one description.
+ *
+ * GitHub's `issues/new` reads `title` and `body` from the query string, so the
+ * report opens already filled in and the reporter still reviews and submits it
+ * on GitHub themself. Nothing is sent from the plugin.
+ *
+ * @param description - what the reporter typed; trimmed and capped.
+ * @param environment - diagnostic rows rendered as a table below it.
+ * @returns the prefilled issue URL.
+ */
+export declare function feedbackIssueUrl(description: string, environment: FeedbackEnvironment): string;
+/**
+ * Open the plugin's feedback dialog.
+ *
+ * The card follows the host's own "send feedback" sheet: a title, a description
+ * box, one line saying what the report will carry, and Cancel / Send. Send
+ * hands the description to GitHub's new-issue form in the browser; with no
+ * description it opens the blank form.
+ *
+ * @param document - renderer document the modal is shown in.
+ * @returns disposer that closes and removes the dialog.
+ */
+export declare function openPluginFeedback(document: Document): () => void;

package/lib/types/client/compat/reply-signature.d.ts

@@ -1,6 +1,7 @@
+import type { PersonalizationConfig } from '../../shared/config.ts';
 import type { Disposer } from '../contracts/ports.ts';
 /** The host marks only the latest turn ending in a reply as always revealed.
  * Starting another turn clears that marker before its response is complete. */
 export declare const REPLY_SIGNATURE_SEAT = "[data-turn-tail][data-actions-reveal=\"always\"]:has(> [data-clock=\"end\"])";
-/** Keep one playful signature at the latest settled reply, following host swaps. */
-export declare function mountReplySignature(document: Document, report: (error: unknown) => void): Disposer;
+/** Keep one static decorative signature at the latest settled reply, following host swaps. */
+export declare function mountReplySignature(document: Document, report: (error: unknown) => void, style?: PersonalizationConfig['replySignatureStyle']): Disposer;

package/lib/types/client/compat/running-status.d.ts

@@ -0,0 +1,8 @@
+import type { PersonalizationConfig } from '../../shared/config.ts';
+import type { Disposer } from '../contracts/ports.ts';
+export type RunningPhase = 'waiting' | 'thinking' | 'tool' | 'responding' | 'approval';
+/** Native clock owns time, including when reopening a turn already in progress. */
+export declare function runningDuration(label: string): string;
+export declare function runningPhase(root: Element): RunningPhase;
+/** Add a presentation sibling, leaving React's whale, clock and text untouched. */
+export declare function mountRunningStatus(document: Document, style: PersonalizationConfig['runningStyle'], report: (error: unknown) => void): Disposer;