dsh-claude-desktop-theme 0.4.3 → 0.4.5

package/lib/index.js

@@ -2,6 +2,11 @@
 import z from "@deepseek-ai/schemastery";
 
 // src/shared/config.ts
+var DEFAULT_PERSONALIZATION = Object.freeze({
+  petStyle: "whale",
+  greetingStyle: "explore",
+  greetingName: ""
+});
 var DEFAULT_FEATURES = Object.freeze({
   shell: true,
   sidebar: true,
@@ -11,7 +16,8 @@ var DEFAULT_FEATURES = Object.freeze({
   statistics: false,
   "composer-pet": true,
   "composer-stats": false,
-  "context-panel": true
+  "context-panel": true,
+  "hero-ripples": true
 });
 var DEFAULT_APPEARANCE = Object.freeze({
   canvas: "",
@@ -26,7 +32,9 @@ 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;
 
@@ -431,12 +439,14 @@ var UsageAggregator = class {
   ctx;
   warn;
   values = /* @__PURE__ */ new Map();
-  queued = [];
+  queued = /* @__PURE__ */ new Map();
   folding = /* @__PURE__ */ new Set();
   failures = /* @__PURE__ */ new Map();
   running = 0;
   refreshRun = null;
   snapshot = null;
+  dirty = true;
+  listed = /* @__PURE__ */ new Set();
   disposed = false;
   constructor(ctx, warn) {
     this.ctx = ctx;
@@ -444,7 +454,15 @@ var UsageAggregator = class {
   }
   /** The most recent snapshot; an empty one before the first refresh. */
   get current() {
-    return this.snapshot ?? aggregateUsage([], { now: Date.now(), pending: 0, missed: 0 });
+    if (this.snapshot === null || this.dirty) {
+      this.snapshot = aggregateUsage(this.values.values(), {
+        now: Date.now(),
+        pending: this.queued.size + this.running,
+        missed: this.failures.size
+      });
+      this.dirty = false;
+    }
+    return this.snapshot;
   }
   /**
    * Bring the snapshot up to date.
@@ -456,6 +474,7 @@ var UsageAggregator = class {
    * @returns the snapshot as of this pass.
    */
   refresh() {
+    if (this.disposed) return Promise.resolve(this.current);
     const running = this.refreshRun;
     if (running !== null) return running;
     const run = this.pass().finally(() => {
@@ -467,24 +486,34 @@ var UsageAggregator = class {
   /** Stop folding; in-flight reads settle but no longer publish. */
   dispose() {
     this.disposed = true;
-    this.queued.length = 0;
+    this.queued.clear();
+    this.values.clear();
+    this.failures.clear();
+    this.listed.clear();
+    this.snapshot = null;
   }
   async pass() {
     try {
       const candidates = await this.list();
+      if (this.disposed) return this.current;
       const listed = new Set(candidates.map((candidate) => candidate.header.id));
+      this.listed = listed;
       for (const id of [...this.values.keys()]) if (!listed.has(id)) this.values.delete(id);
       for (const id of [...this.failures.keys()]) if (!listed.has(id)) this.failures.delete(id);
+      for (const id of this.queued.keys()) if (!listed.has(id)) this.queued.delete(id);
       for (const candidate of candidates) {
         if (this.disposed) break;
         const value = this.readSafely(candidate);
         if (value === void 0) this.enqueue(candidate);
-        else this.values.set(candidate.header.id, value);
+        else {
+          this.queued.delete(candidate.header.id);
+          this.values.set(candidate.header.id, value);
+        }
       }
     } catch (error) {
       this.warn("session listing failed; the card keeps the last snapshot", error);
     }
-    this.publish();
+    this.invalidate();
     return this.current;
   }
   /** Every stored session the card counts, newest first. */
@@ -530,24 +559,25 @@ var UsageAggregator = class {
   /** Queue one cold fold unless it is already queued, running, or cooling down. */
   enqueue(candidate) {
     const id = candidate.header.id;
-    if (this.folding.has(id) || this.queued.some((entry) => entry.header.id === id)) return;
+    if (this.disposed || this.folding.has(id) || this.queued.has(id)) return;
     const failedAt = this.failures.get(id);
     if (failedAt !== void 0 && Date.now() - failedAt < RETRY_COOLDOWN_MS) return;
-    this.queued.push(candidate);
+    this.queued.set(id, candidate);
     this.pump();
   }
   /** Keep at most {@link FOLD_CONCURRENCY} folds in flight. */
   pump() {
     while (!this.disposed && this.running < FOLD_CONCURRENCY) {
-      const candidate = this.queued.shift();
+      const candidate = this.queued.values().next().value;
       if (candidate === void 0) return;
       const id = candidate.header.id;
+      this.queued.delete(id);
       this.folding.add(id);
       this.running += 1;
       void this.fold(candidate).finally(() => {
         this.folding.delete(id);
         this.running -= 1;
-        this.publish();
+        this.invalidate();
         this.pump();
       });
     }
@@ -560,7 +590,9 @@ var UsageAggregator = class {
     let handle;
     try {
       handle = await persistence.open(candidate.header.id, "read");
+      if (this.disposed || !this.listed.has(candidate.header.id)) return;
       const { events } = await handle.read(0);
+      if (this.disposed || !this.listed.has(candidate.header.id)) return;
       const block = cache.coldSnapshot(handle.header, handle.inheritedEventCount, events);
       const value = block.values[USAGE_KEY];
       if (this.disposed) return;
@@ -571,6 +603,7 @@ var UsageAggregator = class {
       this.values.set(candidate.header.id, value);
       this.failures.delete(candidate.header.id);
     } catch (error) {
+      if (this.disposed || !this.listed.has(candidate.header.id)) return;
       this.failures.set(candidate.header.id, Date.now());
       this.warn(`fold failed for session ${candidate.header.id}`, error);
     } finally {
@@ -582,14 +615,10 @@ var UsageAggregator = class {
       }
     }
   }
-  /** Recompute the snapshot from the values read so far. */
-  publish() {
+  /** Fold completions invalidate totals; only a route read pays for aggregation. */
+  invalidate() {
     if (this.disposed) return;
-    this.snapshot = aggregateUsage(this.values.values(), {
-      now: Date.now(),
-      pending: this.queued.length + this.running,
-      missed: this.failures.size
-    });
+    this.dirty = true;
   }
 };
 function mountStatistics(ctx, isEnabled) {
@@ -995,7 +1024,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
@@ -1010,7 +1040,14 @@ 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"),
+    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"),

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/frame.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Coalesce DOM work into one paint frame.
+ *
+ * A mutation observer delivers one batch per microtask, and several documents
+ * (a panel drag, a streaming transcript, a slider writing its own inline
+ * style) can produce many batches between two paints. Doing a full geometry
+ * pass per batch multiplies the layout reads by the batch count; doing it once
+ * per frame is what the screen can actually use.
+ *
+ * The fallbacks are deliberate: an occluded Electron window throttles animation
+ * frames, and a frame without `requestAnimationFrame` at all (some test hosts)
+ * must still settle. In both cases the work runs on a timeout instead, so the
+ * published values are never left stale.
+ */
+/** One coalescing scheduler; `schedule` runs `task` once before the next paint. */
+export interface FrameScheduler {
+    /** Queue the task; repeated calls before it runs collapse into one. */
+    schedule(): void;
+    /** Drop a queued task without running it. */
+    cancel(): void;
+}
+/**
+ * Build a scheduler over one task.
+ *
+ * @param task - the read/write pass to run at most once per frame.
+ * @param win - the window supplying animation frames; defaults to the global.
+ * @returns the scheduler; its task never runs after `cancel`.
+ */
+export declare function frameScheduler(task: () => void, win?: Window | null): FrameScheduler;

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';
@@ -326,6 +329,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"]';

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

@@ -0,0 +1,43 @@
+/**
+ * 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`.
+ *
+ * `region` is the element the module measures — the composer, the scroller,
+ * the conversation root. A change inside it, on it, or on any of its ancestors
+ * counts, because those are the writes that can change its box. A `null`
+ * region, or one the host has already detached, makes the batch relevant:
+ * that is exactly the state in which the module has to look again.
+ *
+ * @param records - the observer's batch.
+ * @param region - the element being measured, or null while it is unknown.
+ * @returns true when the batch is worth a pass.
+ */
+export declare function recordsTouch(records: readonly MutationRecord[], region: Element | null): boolean;
+/**
+ * Whether a batch inserted a subtree the selector names.
+ *
+ * For modules that watch the whole body only because their anchor can be
+ * replaced: an insertion that matches the selector is the one structural event
+ * worth a pass, and it costs one `matches`/`querySelector` per inserted element
+ * rather than a scan of the document. The predicate is also conservative: a
+ * node from another realm, or one without the selector helpers, counts as a
+ * match.
+ *
+ * @param records - the observer's batch.
+ * @param selector - the marker whose arrival matters.
+ * @returns true when an inserted element is, or contains, a match.
+ */
+export declare function recordsIntroduce(records: readonly MutationRecord[], selector: string): boolean;

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

@@ -7,6 +7,7 @@ export interface PaneChromeOptions {
     readonly onNew: () => void;
     readonly onSelect: (id: string) => void;
     readonly onClose: (id: string) => void;
+    readonly onCloseGroup?: () => void;
     readonly closeTabs: readonly string[];
     readonly terminals: readonly {
         id: string;
@@ -16,6 +17,7 @@ export interface PaneChromeOptions {
     readonly files: readonly {
         id: string;
         title: string;
+        path: string;
         selected: boolean;
     }[];
     readonly panel: HTMLElement;

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/sidebar-search.d.ts

@@ -0,0 +1,18 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Marks the sidebar column whose field is currently parked above New Session. */
+export declare const SIDEBAR_SEARCH_PLACED_ATTRIBUTE = "data-ccd-sidebar-search-placed";
+/**
+ * Park the browsing region's search field above New Session.
+ *
+ * The field belongs to `ui-workspace`'s `WorkspaceBrowser`, and React removes
+ * it from the section header whenever the sidebar collapses to its rail.
+ * Moving the React-owned node would make that removal target the wrong parent,
+ * so the node stays where React put it and is positioned over the gap that New
+ * Session opens above itself. That gap sits after the brand row when the brand
+ * is visible and directly below the window strip when it is not.
+ *
+ * The section header keeps its own row. With the search slot out of flow, its
+ * label takes the leading edge and the native View options trigger stays on the
+ * trailing edge.
+ */
+export declare function mountSidebarSearch(document: Document, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/view-switch.d.ts

@@ -21,7 +21,7 @@ export declare const VIEW_GLYPH_ATTRIBUTE = "data-ccd-view-glyph";
 /**
  * The parked pill's inset from the sidebar column's right edge, in px. Measured
  * at @2x on the reference: the column's divider sits 16 device px right of the
- * pill's right edge (docs/issues/img/todo-sidebar-sessions-target.webp).
+ * pill's right edge (DESIGN.md §6.5).
  */
 export declare const VIEW_DOCK_INSET = 8;
 /** Bundled artwork, one per shipped View; see features/conversation/view-switch-icons.ts. */

package/lib/types/client/contracts/ports.d.ts

@@ -82,6 +82,8 @@ export interface SidebarRightPort {
     }): void;
     /** Focus a tab and the pane holding it; a missing tab is left alone. */
     focus(tabId: string): void;
+    /** Close a tab in the on-screen Session through the host's cleanup path. */
+    close?(tabId: string): void;
     /**
      * Open tab metadata across adopted Sessions — and, in the shipped face, the
      * snapshot store behind it: the plugin's pane layer re-reads the layout

package/lib/types/client/features/composer-pet/BlankPet.d.ts

@@ -1,7 +1,10 @@
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PersonalizationConfig } from '../../../shared/config.ts';
 import type { PetAnchor } from '../../compat/pet-anchor.ts';
 /** Business face the frame overlay injects: the measured new-session corner. */
 export interface BlankPetFace {
+    /** Visual variant chosen in settings. */
+    readonly petStyle: PersonalizationConfig['petStyle'];
     /** Selector hook over the compat layer's measurement. */
     readonly useAnchor: () => PetAnchor | null;
 }
@@ -14,4 +17,4 @@ export type BlankPetProps = PropsRuntime<'shell.overlay'> & BlankPetFace;
  * @param props - injected measurement.
  * @returns the positioned whale, or null.
  */
-export declare function BlankPet({ useAnchor }: BlankPetProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function BlankPet({ useAnchor, petStyle }: BlankPetProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/types/client/features/composer-pet/ClaudePet.d.ts

@@ -0,0 +1,7 @@
+/** Reference pixel companion: take out a laptop, type, then return to standing. */
+export declare function ClaudePet(): import("react/jsx-runtime").JSX.Element;
+/** One shared drawing path for idle and recorded poses, also used by previews. */
+export declare function ClaudeArt({ elapsed, reducedMotion }: {
+    readonly elapsed?: number | null;
+    readonly reducedMotion?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/types/client/features/composer-pet/claude-frames.d.ts

@@ -0,0 +1,12 @@
+/** Geometric reconstruction of the original click sequence, sampled at 20fps.
+ * Recording antialiasing/compression fringes are not artwork: there is no outline
+ * layer. All feet have a constant 3px width; their roots follow the belly while
+ * their toes share a ground line. Only the projected feet have a deliberate bend.
+ */
+export type ClaudeFrame = readonly [body: string, shade: string, eyes: string, laptop: string];
+export declare const CLAUDE_GROUND_Y = 23.5;
+export declare const CLAUDE_IDLE: ClaudeFrame;
+/** Pose order and hold times follow the recording; identical clean silhouettes
+ * are reused so compression noise cannot animate otherwise stationary edges. */
+export declare const CLAUDE_FRAMES: readonly ClaudeFrame[];
+export declare const CLAUDE_TRACK: readonly number[];

package/lib/types/client/features/composer-pet/claude-motion.d.ts

@@ -0,0 +1,3 @@
+export declare const CLAUDE_REACTION_MS: number;
+/** Each recorded pose lasts 50ms; null restores the static mark after playback. */
+export declare function claudePose(elapsed: number, reducedMotion?: boolean): readonly string[] | null;

package/lib/types/client/features/conversation/header-actions/HeaderActionButton.d.ts

@@ -11,8 +11,8 @@ export interface HeaderActionProps {
 /**
  * One view button for the conversation header.
  *
- * All three sit in the utilities group beside the native actions, led by the
- * project folder; the corner seat past them holds nothing (the panel's shipped
+ * All three sit in the utilities group beside the native actions, in terminal,
+ * browser, project folder order; the corner seat past them holds nothing (the panel's shipped
  * expand control is retired there and its action moves into the Session menu).
  * All three are the same control: the box size, hover surface and spacing
  * belong to the seat's own stylesheet

package/lib/types/client/features/conversation/header-actions/entries.d.ts

@@ -18,28 +18,24 @@ export declare const FILES_KIND = "files";
 /**
  * List orders inside `conversation.session.header.utilities`.
  *
- * The project folder leads the row, so it carries the lowest order of every
- * entry there is — below the retired open-in-app control (-10) and the native
- * scheduled-tasks entry (-5), not only below this plugin's own views: the
- * reference draws the folder as the cluster's first control, whatever a Session
- * happens to carry. The two views then land directly before the native session
- * menu at 0 and keep it as the cluster's closing entry.
+ * Terminal, browser and project folder sit directly before the native session
+ * menu at 0, in that order.
  */
-export declare const FOLDER_ORDER = -11;
-export declare const TERMINAL_ORDER = -2;
-export declare const BROWSER_ORDER = -1;
+export declare const TERMINAL_ORDER = -3;
+export declare const BROWSER_ORDER = -2;
+export declare const FOLDER_ORDER = -1;
 /** The views this plugin exposes in the utilities group, in cluster order. */
 export declare const VIEWS: readonly [{
-    readonly id: 'ccd-folder';
-    readonly kind: "files";
-    readonly order: -11;
-}, {
     readonly id: 'ccd-terminal';
     readonly kind: 'terminal';
-    readonly order: -2;
+    readonly order: -3;
 }, {
     readonly id: 'ccd-browser';
     readonly kind: 'browser';
+    readonly order: -2;
+}, {
+    readonly id: 'ccd-folder';
+    readonly kind: "files";
     readonly order: -1;
 }];
 /**
@@ -64,7 +60,7 @@ export type OpenViewKind = (kind: string, sessionId: string) => void;
 export declare function utilitiesEntry(view: (typeof VIEWS)[number], labels: Record<(typeof VIEWS)[number]['kind'] | typeof FILES_KIND, string>, open: OpenViewKind): {
     name: "conversation.session.header.utilities";
     id: "ccd-browser" | "ccd-folder" | "ccd-terminal";
-    order: -11 | -2 | -1;
+    order: -3 | -2 | -1;
     inject: (sessionId: string) => HeaderActionProps;
 };
 /**

package/lib/types/client/features/conversation/view-switch-icons.d.ts

@@ -1,8 +1,8 @@
 /**
  * The two View switcher glyphs, bundled as trusted static markup.
  *
- * Drawn to the reference's own segments (docs/issues/img/todo-sidebar-sessions-target.webp,
- * @2x): a pair of speech bubbles for the chat View and the `</>` pair for the
+ * Drawn to the reference's own segments (DESIGN.md §6.5, @2x): a pair of
+ * speech bubbles for the chat View and the `</>` pair for the
  * trajectory View, both on the CCD 16 grid — 1–1.2px stroke (each glyph's own
  * weight read off the reference), round caps and joins, `currentColor` ink,
  * ink box ≈ 12.5 × 11px inside the 16px artwork.

package/lib/types/client/features/model-controls/EffortPanel.d.ts

@@ -4,6 +4,7 @@ export interface EffortPanelProps {
     readonly anchor: RefObject<HTMLButtonElement>;
     readonly choices: readonly EffortChoice[];
     readonly selected: number;
+    readonly defaultIndex: number;
     readonly disabled: boolean;
     readonly busy: boolean;
     readonly error: string | null;
@@ -11,4 +12,4 @@ export interface EffortPanelProps {
     readonly onClose: () => void;
 }
 /** Presentation-only slider: continuous local preview, one supported choice on release. */
-export declare function EffortPanel({ anchor, choices, selected, disabled, busy, error, onCommit, onClose }: EffortPanelProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function EffortPanel({ anchor, choices, selected, defaultIndex, disabled, busy, error, onCommit, onClose }: EffortPanelProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/types/client/features/model-controls/ModelControls.d.ts

@@ -3,9 +3,19 @@ import type { ModelDirectoryState } from '@deepseek-ai/dsh-client-ui-model-selec
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ModelSelection } from '@deepseek-ai/dsh-api-session-controller/types';
 export type ModelControlsProps = Omit<ModelSelectInjected, 'directory'> & PropsLocale<'model'> & {
+    readonly showModelIcons: boolean;
     readonly locked: boolean;
     readonly useDirectory: () => ModelDirectoryState;
     readonly selectEffort: (route: ModelSelection, effort: string | undefined) => void;
 };
 /** SDK-derived values/hooks and callbacks only; DSH retains all business state. */
-export declare function ModelControls({ locked, available, useDirectory, load, select, selectEffort, t }: ModelControlsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ModelControls({ showModelIcons, locked, available, useDirectory, load, select, selectEffort, t }: ModelControlsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ModelPanel({ showModelIcons, anchor, state, disabled, load, t, onClose, onSelect }: PropsLocale<'model'> & {
+    readonly showModelIcons: boolean;
+    readonly anchor: React.RefObject<HTMLButtonElement>;
+    readonly state: ModelDirectoryState;
+    readonly disabled: boolean;
+    readonly load: () => void;
+    readonly onClose: () => void;
+    readonly onSelect: (selection: ModelSelection) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/types/client/features/model-controls/model-icon-data.d.ts

@@ -0,0 +1,31 @@
+export interface ModelIconShape {
+    readonly kind: 'path' | 'circle' | 'ellipse' | 'rect';
+    readonly d?: string;
+    readonly cx?: string;
+    readonly cy?: string;
+    readonly r?: string;
+    readonly rx?: string;
+    readonly ry?: string;
+    readonly x?: string;
+    readonly y?: string;
+    readonly width?: string;
+    readonly height?: string;
+    readonly fillOpacity?: string;
+    readonly fillRule?: string;
+    readonly clipRule?: string;
+    readonly opacity?: string;
+    readonly transform?: string;
+}
+export interface ModelIconMark {
+    readonly title: string;
+    readonly viewBox: string;
+    readonly shapes: readonly ModelIconShape[];
+    readonly color?: ModelIconColor;
+}
+export interface ModelIconColor {
+    readonly viewBox: string;
+    readonly fill?: string;
+    readonly fillRule?: string;
+    readonly markup: string;
+}
+export declare const MODEL_ICONS: Readonly<Record<string, ModelIconMark>>;

package/lib/types/client/features/model-controls/model-icon-match.d.ts

@@ -0,0 +1,20 @@
+import type { ModelIconMark } from './model-icon-data.ts';
+export interface ModelIconTarget {
+    readonly id: string;
+    readonly name: string;
+}
+export interface ModelIconMatch {
+    readonly slug: string;
+    readonly mark: ModelIconMark;
+}
+/**
+ * Resolve one row's mark, preferring the model over its routing group.
+ *
+ * The provider is a fallback because a group such as `Magpie` can carry
+ * several brands; matching the group first made every row in it share one
+ * initial. The model row is the closest statement of which family a route
+ * actually serves.
+ */
+export declare function resolveModelIcon(provider: ModelIconTarget, model: ModelIconTarget): ModelIconMatch | null;
+/** The fallback seat: the model's own initial, not its routing group's. */
+export declare function modelIconInitial(provider: ModelIconTarget, model: ModelIconTarget): string;

package/lib/types/client/features/model-controls/model-icons.d.ts

@@ -0,0 +1,13 @@
+interface ModelIconTarget {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * One row's leading glyph: the model family's mark when the index knows it,
+ * otherwise the model's initial. The seat is always drawn so rows align.
+ */
+export declare function ModelIcon({ provider, model }: {
+    readonly provider: ModelIconTarget;
+    readonly model: ModelIconTarget;
+}): import("react/jsx-runtime").JSX.Element;
+export {};