@chatcode/cco-better-sidebar 0.18.0-alpha.0

package/lib/types/client/ui-tweaks/index.d.ts

@@ -0,0 +1,279 @@
+/**
+ * dsh-ui-tweaks — browser half.
+ *
+ * Reads and writes the `ui-tweaks` settings namespace through the same-origin
+ * route served by the server half, applies the chosen font size / table style
+ * live via a runtime `<style>` element, and renders the Settings
+ * panel section that edits them.
+ */
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { Context as ClientContext } from '../../context-types.ts';
+/** Client context narrowed to the browser sessions face in this combined build. */
+type UITweaksClientContext = ClientContext & {
+    sessions: ISessions;
+};
+interface TweaksValue {
+    fontSize?: number;
+    /** Code font size as a percentage of the message font size (81 = stock). Legacy input. */
+    codeFontScale?: number;
+    /** Absolute code font size in px; wins over the legacy percentage. */
+    codeFontSize?: number;
+    /** 行高 base unit in px; scales message/block gaps, line-height and list/paragraph margins. */
+    lineHeight?: number;
+    tableStyle?: 'default' | 'claude';
+    /** Whether the GitBar (branch / diff / commit pills) is shown. */
+    gitBarEnabled?: boolean;
+    /** Whether the Archive manager (sidebar entry above Settings) is shown. */
+    archiveManagerEnabled?: boolean;
+    /** Whether the MCP manager (Settings page listing MCP servers) is shown. */
+    mcpManagerEnabled?: boolean;
+    /** Whether the /init slash command (AGENTS.md bootstrap prompt) is registered. */
+    initCommandEnabled?: boolean;
+    /** Whether the whale working indicator above the input is shown. */
+    whaleIndicatorEnabled?: boolean;
+    /** Whether the stats-line cache-hit figure keeps two decimals. Keep in sync with src/config.ts. */
+    preciseCacheHitEnabled?: boolean;
+    /** Whether task notifications are active. Keep in sync with src/config.ts. */
+    notificationsEnabled?: boolean;
+    /** Alert only while the tab is hidden or unfocused. */
+    notifyOnlyWhenHidden?: boolean;
+    /** Alert when a session completes its turn. */
+    notifyOnComplete?: boolean;
+    /** Alert when a session blocks on an approval, plan review or question. */
+    notifyOnInteraction?: boolean;
+    /** Blink an unread counter into the tab title. */
+    notifyTitleFlash?: boolean;
+    /** Fire desktop-level Web Notifications. */
+    notifySystemNotification?: boolean;
+    /** Play the synthesized two-note chime. */
+    notifySound?: boolean;
+}
+declare const en: {
+    readonly nav: "UI Tweaks";
+    readonly settingsTitle: "UI Tweaks";
+    readonly settingsIntro: "Tune the conversation UI — text, tables and layout, plus optional features: git bar, archive & MCP managers and the /init command. Changes apply live.";
+    readonly sectionText: "Text & tables";
+    readonly sectionLayout: "Layout";
+    readonly sectionFeatures: "Features";
+    readonly fontSize: "Message font size";
+    readonly fontSizeHint: "Number between 10 and 32; applies to message text, headings, tables and code.";
+    readonly codeFontSize: "Code font size";
+    readonly codeFontSizeHint: "Absolute code size in px (8–32); 13px is ChatCode CLI's default at a 16px body. Applies to code blocks; inline code follows proportionally.";
+    readonly lineHeight: "Line spacing";
+    readonly lineHeightHint: "Base vertical spacing in px: gaps between message rows (Think ↔ tool cards) and blocks inside one reply, plus text line-height, paragraph and list margins, all scale from it; 16 is ChatCode CLI's default.";
+    readonly tableStyle: "Table style";
+    readonly tableStyleHint: "Cell look for markdown tables: stock borders, or the Claude Desktop card style.";
+    readonly tableStyleDefault: "Default";
+    readonly tableStyleClaude: "Claude Desktop";
+    readonly gitBar: "Git bar";
+    readonly gitBarHint: "Branch / diff pills above the input inside git repos, with branch management and commit & push; auto-hidden outside git.";
+    readonly gitBarOn: "On";
+    readonly gitBarOff: "Off";
+    readonly archiveManager: "Archive manager";
+    readonly archiveManagerHint: "An Archive settings page to restore or permanently delete archived sessions.";
+    readonly archiveManagerOn: "On";
+    readonly archiveManagerOff: "Off";
+    readonly mcpManager: "MCP manager";
+    readonly mcpManagerHint: "An MCP settings page listing servers with status and tools; edit and restart them.";
+    readonly mcpManagerOn: "On";
+    readonly mcpManagerOff: "Off";
+    readonly mcpNav: "MCP";
+    readonly mcpTitle: "MCP servers";
+    readonly mcpEmpty: "No MCP servers configured.";
+    readonly mcpStatusActive: "Running";
+    readonly mcpStatusFailed: "Failed";
+    readonly mcpStatusLoading: "Loading";
+    readonly mcpStatusStopped: "Stopped";
+    readonly mcpStatusDisabled: "Disabled";
+    readonly mcpTools: "tools";
+    readonly mcpEnv: "Env";
+    readonly mcpAdd: "Add server";
+    readonly mcpAddTitle: "Add MCP server";
+    readonly mcpEditTitle: "Edit MCP server";
+    readonly mcpEdit: "Edit";
+    readonly mcpDelete: "Delete";
+    readonly mcpEnabledAction: "Enable";
+    readonly mcpDisabledAction: "Disable";
+    readonly mcpSaved: "Saved.";
+    readonly mcpRemoved: "Removed.";
+    readonly mcpFormTab: "Form";
+    readonly mcpYamlTab: "YAML";
+    readonly mcpYamlHint: "Fill in the MCP config directly (serverName / transport / command / args / env / toolCallTimeoutMs / url / headers …). It is validated before saving.";
+    readonly mcpYamlPlaceholder: "serverName: my-server\ntransport: stdio\ncommand: npx\nargs:\n  - \"-y\"\n  - \"@some/mcp-server\"\nenv:\n  KEY: value\ntoolCallTimeoutMs: 60000";
+    readonly mcpFieldId: "Instance ID";
+    readonly mcpFieldIdHint: "Loader entry id (letters, digits, - and _ only); it must be unique.";
+    readonly mcpFieldName: "Name";
+    readonly mcpFieldNameHint: "Tool namespace `mcp__<name>__*`; letters, digits, - and _ (1–32).";
+    readonly mcpFieldType: "Type";
+    readonly mcpFieldTimeout: "Timeout (ms)";
+    readonly mcpFieldCommand: "Command";
+    readonly mcpFieldCommandPlaceholder: "e.g. npx";
+    readonly mcpFieldArgs: "Arguments (one per line)";
+    readonly mcpFieldEnv: "Environment vars (optional, KEY=value per line)";
+    readonly mcpFieldUrl: "URL";
+    readonly mcpFieldHeaders: "Headers (optional, Key: value per line)";
+    readonly mcpFieldEnabled: "Enabled";
+    readonly mcpSave: "Save";
+    readonly mcpCancel: "Cancel";
+    readonly mcpInvalidId: "Instance ID may only contain letters, digits, - and _.";
+    readonly mcpInvalidName: "Name may only contain letters, digits, - and _ (1–32 chars).";
+    readonly mcpInvalidTimeout: "Timeout must be a positive integer (ms).";
+    readonly mcpInvalidUrl: "URL must start with http:// or https://.";
+    readonly mcpInvalidCommand: "Command is required.";
+    readonly mcpUnavailable: "MCP manager unavailable.";
+    readonly mcpDisabledHint: "MCP management is off. Turn it on in 界面调整 (UI Tweaks) to view and restart MCP servers here.";
+    readonly mcpEnable: "Enable MCP manager";
+    readonly initCommand: "/init command";
+    readonly initCommandHint: "The /init slash command: pick a prompt language and ChatCode CLI analyzes the project and writes AGENTS.md.";
+    readonly initCommandOn: "On";
+    readonly initCommandOff: "Off";
+    readonly whaleIndicator: "Whale indicator";
+    readonly whaleIndicatorHint: "A little whale above the input box: translucent while idle; while the model works it swims and breathes blue.";
+    readonly whaleIndicatorOn: "On";
+    readonly whaleIndicatorOff: "Off";
+    readonly preciseCacheHit: "Precise cache hit";
+    readonly preciseCacheHitHint: "Rewrites the cache-hit figure in the stats line under the input box to two decimal places (e.g. 96.35%), computed from the raw cached-read / cached-write / uncached-input token buckets instead of the stock rounded integer.";
+    readonly preciseCacheHitOn: "On";
+    readonly preciseCacheHitOff: "Off";
+    readonly sectionNotifications: "Task alerts";
+    readonly notifications: "Enable alerts";
+    readonly notificationsHint: "Call you back while the tab is in the background: a session finishes its turn, or one starts waiting for your approval, plan review or answer. The switches below apply only while this is on.";
+    readonly notifyOn: "On";
+    readonly notifyOff: "Off";
+    readonly notifyOnComplete: "Alert on finish";
+    readonly notifyOnCompleteHint: "Fire when a session ends its turn — completed, interrupted or failed; the notification says which.";
+    readonly notifyOnInteraction: "Alert on interaction";
+    readonly notifyOnInteractionHint: "Fire when a session waits on you: an approval, a plan review, or a question from the agent.";
+    readonly notifyOnlyWhenHidden: "Only when hidden";
+    readonly notifyOnlyWhenHiddenHint: "Stay quiet while you are looking at this page; alert only once the tab is hidden or unfocused.";
+    readonly notifyTitleFlash: "Tab title flash";
+    readonly notifyTitleFlashHint: "Blink an unread counter into the tab title until you come back.";
+    readonly notifySystemNotification: "System notifications";
+    readonly notifySystemNotificationHint: "Desktop-level notifications; click one to jump straight to that session. Permission is requested when enabled.";
+    readonly notifySound: "Chime";
+    readonly notifySoundHint: "A soft two-note motif — rising when work finishes, falling when it needs you.";
+    readonly notifyTest: "Test";
+    readonly notifyTitleDone: "Task finished";
+    readonly notifyTitleAborted: "Task interrupted";
+    readonly notifyTitleFailed: "Request failed";
+    readonly notifyTitlePending: "Needs you";
+    readonly bodyComplete: "✅ {title} finished its turn.";
+    readonly bodyAborted: "⏹ {title} was interrupted before finishing.";
+    readonly bodyFailed: "❌ {title} failed: {error}";
+    readonly bodyApproval: "⏸ {title} is waiting for your approval.";
+    readonly bodyPlan: "📋 {title} has a plan awaiting your review.";
+    readonly bodyQuestion: "❓ {title} asked you a question.";
+    readonly mcpServerDetail: "Configured in the profile cordis.patch.yml as @deepseek-ai/dsh-mcp-client instances; add / edit / disable / delete write to that file and apply live.";
+    readonly archiveNav: "Archive";
+    readonly archiveTitle: "Archived sessions";
+    readonly archiveEmpty: "No archived sessions.";
+    readonly archiveRestore: "Restore";
+    readonly archiveRestoring: "Working…";
+    readonly archiveDelete: "Delete";
+    readonly archiveDeleteAll: "Delete all";
+    readonly archiveRestoreAll: "Restore all";
+    readonly archiveCount: "sessions";
+    readonly archiveUnavailable: "Archive unavailable.";
+    readonly archiveLiveError: "This session is running; close it before permanently deleting it.";
+    readonly archiveDisabledHint: "Archive management is off. Turn it on in 界面调整 (UI Tweaks) to restore or permanently delete archived sessions here.";
+    readonly archiveEnable: "Enable archive management";
+    readonly archiveRestored: "Restored.";
+    readonly defaultAction: "Default";
+    readonly reset: "Reset";
+    readonly resetDone: "Reset to default.";
+    readonly applied: "Applied";
+    readonly unavailable: "Settings unavailable.";
+    readonly loading: "Loading…";
+    readonly readOnly: "The active Settings provider is read-only.";
+    readonly saved: "Saved.";
+    readonly commitMessage: "Commit";
+    readonly diffFiles: "files";
+    readonly branchLocal: "Local branches";
+    readonly branchRemote: "Remote branches";
+    readonly branchNew: "New branch";
+    readonly branchNewPlaceholder: "Branch name, e.g. fix/typo";
+    readonly branchCreate: "Create";
+    readonly diffTitle: "Changes";
+    readonly diffOnly: "Hunks";
+    readonly diffFull: "Full file";
+    readonly commitTitle: "Commit changes";
+    readonly commitPlaceholder: "Describe your changes…";
+    readonly commitHint: "Committing stages the checked files (untracked included) and commits; unchecked files are excluded from this commit. “Commit & push” also pushes; a new branch gets an -u upstream.";
+    readonly commitWillCommit: "To commit";
+    readonly commitViewDiff: "View";
+    readonly commitEmpty: "Write a commit message first";
+    readonly commitCancel: "Cancel";
+    readonly commitSubmit: "Commit";
+    readonly commitSubmitPush: "Commit & push";
+    readonly commitBusy: "Task in progress — commit is unavailable while the agent is working.";
+    readonly dirty: "Uncommitted changes";
+    readonly clean: "Working tree clean";
+    readonly noChanges: "No changes here.";
+    readonly branchDelete: "Delete branch";
+    readonly branchDeleteConfirm: "Confirm?";
+    readonly branchRemoteDelete: "Delete remote branch";
+    readonly branchFrom: "From branch";
+    readonly branchFromHead: "Current HEAD (default)";
+    readonly branchGraph: "Graph";
+    readonly branchCancel: "Cancel";
+    readonly branchRefresh: "Refresh";
+    readonly graphTitle: "Commit graph";
+    readonly graphColGraph: "Graph";
+    readonly graphColCommit: "Commit";
+    readonly graphColSubject: "Description";
+    readonly graphColAuthor: "Author";
+    readonly graphColDate: "Date";
+    readonly branchPushRemote: "Push to remote";
+    readonly includeFile: "Include in commit";
+    readonly excludeFile: "Exclude from commit";
+    readonly openProject: "Open project";
+    readonly terminal: "Terminal";
+    readonly openExplorer: "Explorer";
+    readonly openVscode: "VS Code";
+    readonly openIdea: "IntelliJ IDEA";
+    readonly openGoland: "GoLand";
+    readonly openWebstorm: "WebStorm";
+    readonly openPycharm: "PyCharm";
+    readonly termConnecting: "connecting…";
+    readonly termExited: "shell exited";
+    readonly termUnavailable: "PTY unavailable: node-pty failed to load on the host.";
+    readonly termLost: "connection lost";
+    readonly initDesc: "Analyze this project and generate an AGENTS.md for future coding agents";
+    readonly initOptionZh: "AGENTS.md — Chinese prompt";
+    readonly initOptionZhDetail: "Submit a Chinese prompt asking the agent to analyze the project and write or improve AGENTS.md.";
+    readonly initOptionEn: "AGENTS.md — English prompt";
+    readonly initOptionEnDetail: "Submit an English prompt asking the agent to analyze the project and write or improve AGENTS.md.";
+    readonly initFailed: "/init failed to send the prompt";
+};
+type LocaleKey = keyof typeof en;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** dsh-ui-tweaks Settings copy. */
+        'ui-tweaks': LocaleKey;
+    }
+}
+/** Client-side snapshot store fed by the same-origin Settings route. */
+interface SettingsState {
+    status: 'loading' | 'ready' | 'error';
+    writable: boolean;
+    value: TweaksValue | undefined;
+    revision: number | undefined;
+    error?: string;
+}
+/** Small external store shared by the Settings route and the CSS engine. */
+export declare class SettingsClient {
+    private state;
+    private listeners;
+    private generation;
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => SettingsState;
+    private publish;
+    load(): Promise<void>;
+    private post;
+    set(field: string, value: unknown): Promise<void>;
+    unset(field: string): Promise<void>;
+}
+/** Required client services: slots (settings.section), locale, sessions (git bar, whale, archive, notifier), the slash-command registry, and the scope-addressed conversation face. */
+export declare const inject: string[];
+export declare function apply(ctx: UITweaksClientContext): void;
+export {};

package/lib/types/client/ui-tweaks/mcp.d.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-ui-tweaks — MCP manager (browser half).
+ *
+ * Renders the "MCP 管理" settings section (usable when the mcpManagerEnabled
+ * toggle in 界面调整 is on — otherwise it shows an invite card). The section
+ * lists every configured MCP server with its status (active / failed / loading
+ * / stopped / disabled), command / url, env names, registered tools, and
+ * offers per-server actions: **重启** (runtime reload), **启用/停用**,
+ * **编辑**, and **删除** (two-click confirm). An **添加服务器** button opens
+ * the editor, which supports BOTH a structured **表单** and a raw **YAML**
+ * mode (the config is validated on the server before the profile's
+ * `cordis.patch.yml` is rewritten; DSH's patch watcher then hot-reloads the
+ * loader so the server starts/stops live).
+ * @module dsh-ui-tweaks/client/mcp
+ */
+import type { SettingsClient } from './index.tsx';
+/** Locale keys the MCP manager reads off the `ui-tweaks` dictionary. */
+type McpLabelKey = 'mcpTitle' | 'mcpEmpty' | 'mcpStatusActive' | 'mcpStatusFailed' | 'mcpStatusLoading' | 'mcpStatusStopped' | 'mcpStatusDisabled' | 'mcpTools' | 'mcpEnv' | 'mcpUnavailable' | 'mcpDisabledHint' | 'mcpEnable' | 'mcpServerDetail' | 'mcpAdd' | 'mcpAddTitle' | 'mcpEditTitle' | 'mcpEdit' | 'mcpDelete' | 'mcpEnabledAction' | 'mcpDisabledAction' | 'mcpSaved' | 'mcpRemoved' | 'mcpFormTab' | 'mcpYamlTab' | 'mcpYamlHint' | 'mcpYamlPlaceholder' | 'mcpFieldId' | 'mcpFieldIdHint' | 'mcpFieldName' | 'mcpFieldNameHint' | 'mcpFieldType' | 'mcpFieldTimeout' | 'mcpFieldCommand' | 'mcpFieldCommandPlaceholder' | 'mcpFieldArgs' | 'mcpFieldEnv' | 'mcpFieldUrl' | 'mcpFieldHeaders' | 'mcpFieldEnabled' | 'mcpSave' | 'mcpCancel' | 'mcpInvalidId' | 'mcpInvalidName' | 'mcpInvalidTimeout' | 'mcpInvalidUrl' | 'mcpInvalidCommand' | 'unavailable' | 'loading';
+type Translate = (key: McpLabelKey) => string;
+export declare const MCP_CSS = "\n.dut-mcp{display:grid;gap:12px;max-width:680px;padding:6px 2px 36px}\n.dut-mcp-head{display:flex;align-items:center;gap:10px;padding:14px 16px 0}\n.dut-mcp-head h2{margin:0;font-size:15px;font-weight:600;letter-spacing:-.01em;color:var(--dsw-alias-label-primary)}\n.dut-mcp-count{font-size:11.5px;color:var(--dsw-alias-label-secondary);padding:2px 8px;border-radius:999px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1)}\n.dut-mcp-spacer{flex:1}\n.dut-mcp-btn{display:inline-flex;align-items:center;height:28px;padding:0 12px;border-radius:999px;border:1px solid var(--dsw-alias-border-l1);background:transparent;color:var(--dsw-alias-label-secondary);font:inherit;font-size:12px;cursor:pointer;transition:background .15s ease,color .15s ease,border-color .15s ease}\n.dut-mcp-btn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}\n.dut-mcp-btn:disabled{opacity:.5;cursor:default}\n.dut-mcp-btn.dut-mcp-del:hover{border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 55%,transparent);color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent)}\n.dut-mcp-btn.dut-mcp-confirm{border-color:color-mix(in srgb,var(--dsw-alias-state-error-primary) 55%,transparent);color:var(--dsw-alias-state-error-primary);font-weight:600}\n.dut-mcp-body{display:grid;gap:2px;margin-top:4px}\n.dut-mcp-row{display:grid;gap:6px;padding:10px 16px;border-radius:12px}\n.dut-mcp-row:hover{background:var(--dsw-alias-interactive-bg-hover)}\n.dut-mcp-row-main{display:flex;align-items:center;gap:8px;min-width:0}\n.dut-mcp-name{font-size:13.5px;font-weight:600;color:var(--dsw-alias-label-primary);white-space:nowrap;text-overflow:ellipsis;overflow:hidden}\n.dut-mcp-badge{flex:none;font-size:11px;line-height:1;padding:4px 9px;border-radius:999px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);color:var(--dsw-alias-label-secondary)}\n.dut-mcp-badge.dut-mcp-ok{background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 12%,transparent);border-color:transparent;color:var(--dsw-alias-state-success-primary)}\n.dut-mcp-badge.dut-mcp-err{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 12%,transparent);border-color:transparent;color:var(--dsw-alias-state-error-primary)}\n.dut-mcp-badge.dut-mcp-warn{background:color-mix(in srgb,var(--dsw-alias-state-warn-primary) 14%,transparent);border-color:transparent;color:var(--dsw-alias-state-warn-label)}\n.dut-mcp-sub{font-size:11.5px;color:var(--dsw-alias-label-secondary);white-space:nowrap;text-overflow:ellipsis;overflow:hidden}\n.dut-mcp-toggle{flex:none;font-size:11.5px;color:var(--dsw-alias-label-tertiary);background:transparent;border:none;padding:0;cursor:pointer;text-align:left}\n.dut-mcp-toggle:hover{color:var(--dsw-alias-label-primary)}\n.dut-mcp-tools{margin-left:2px;display:flex;flex-wrap:wrap;gap:4px}\n.dut-mcp-tool{font-size:11px;line-height:1;padding:3px 8px;border-radius:999px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);color:var(--dsw-alias-label-secondary)}\n.dut-mcp-note{margin:2px 16px 0;padding:8px 12px;border-radius:10px;font-size:11.5px;line-height:1.55;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1)}\n.dut-mcp-empty{padding:32px 16px;text-align:center;font-size:12.5px;color:var(--dsw-alias-label-secondary)}\n.dut-mcp-alert{margin:8px 16px 0;padding:8px 12px;border-radius:10px;font-size:12px;line-height:1.5;background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent);color:var(--dsw-alias-state-error-primary)}\n.dut-mcp-notice{margin:8px 16px 0;padding:8px 12px;border-radius:10px;font-size:12px;line-height:1.5;background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 12%,transparent);color:var(--dsw-alias-state-success-primary)}\n.dut-mcp-off{padding:20px 16px;display:grid;gap:12px}\n.dut-mcp-off p{margin:0;font-size:12.5px;line-height:1.6;color:var(--dsw-alias-label-secondary)}\n.dut-mcp-overlay{z-index:1100;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}\n.dut-mcp-mask{background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur);position:absolute;inset:0}\n.dut-mcp-panel{z-index:1;background:var(--dsw-alias-bg-layer-2);box-sizing:border-box;width:720px;max-width:calc(100vw - 48px);height:min(700px,100vh - 48px);box-shadow:var(--dsw-shadow-lv3);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:20px;display:flex;flex-direction:column;overflow:hidden}\n.dut-mcp-panel-head{box-sizing:border-box;flex:none;display:flex;align-items:center;gap:10px;height:52px;padding:0 12px 0 20px}\n.dut-mcp-panel-head h2{margin:0;font-size:16px;font-weight:600;letter-spacing:-.01em;color:var(--dsw-alias-label-primary)}\n.dut-mcp-panel-close{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-primary);background:transparent;border:none;border-radius:28px;display:inline-flex;justify-content:center;align-items:center;padding:0;font-size:13px}\n.dut-mcp-panel-close:hover{background:var(--dsw-alias-interactive-bg-hover)}\n.dut-mcp-tabs{flex:none;display:inline-flex;padding:3px;gap:3px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-2);margin:0 20px 10px;align-self:flex-start}\n.dut-mcp-tabs button{border:none;border-radius:7px;padding:5px 14px;background:transparent;color:var(--dsw-alias-label-secondary);font:inherit;font-size:12.5px;cursor:pointer}\n.dut-mcp-tabs button.dut-mcp-tab-on{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 12%,transparent);color:var(--dsw-alias-state-business-primary);font-weight:600}\n.dut-mcp-form{flex:1;min-height:0;overflow-y:auto;padding:0 20px 20px;display:grid;gap:12px;align-content:start}\n.dut-mcp-field{display:grid;gap:6px}\n.dut-mcp-field>span{font-size:12px;font-weight:600;color:var(--dsw-alias-label-primary)}\n.dut-mcp-field small{font-size:11px;line-height:1.5;color:var(--dsw-alias-label-tertiary)}\n.dut-mcp-input{box-sizing:border-box;width:100%;height:34px;padding:0 10px;border-radius:9px;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;font-size:13px}\n.dut-mcp-input:focus{outline:none;border-color:color-mix(in srgb,var(--dsw-alias-state-business-primary) 55%,transparent)}\n.dut-mcp-input:disabled{opacity:.55;cursor:not-allowed}\ntextarea.dut-mcp-input{height:auto;min-height:72px;padding:8px 10px;line-height:1.5;resize:vertical;font-family:var(--dsw-font-markdown-code-block-font-family, Consolas, monospace);font-size:12px}\ntextarea.dut-mcp-input-lg{min-height:120px}\ntextarea.dut-mcp-yaml{min-height:320px}\n.dut-mcp-row2{display:grid;grid-template-columns:1fr 1fr;gap:12px;align-items:start}\n.dut-mcp-field .dut-seg{width:fit-content}\n.dut-mcp-row2 .dut-seg{height:34px;box-sizing:border-box;align-items:center}\n.dut-mcp-row2 .dut-seg button{flex:none;white-space:nowrap;padding:0 16px;height:26px}\n.dut-mcp-foot{flex:none;display:flex;align-items:center;gap:8px;justify-content:flex-end;padding:12px 20px 16px;border-top:1px solid var(--dsw-alias-border-l1)}\n.dut-mcp-error{margin:0 20px 10px;padding:8px 12px;border-radius:10px;font-size:12px;line-height:1.5;background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent);color:var(--dsw-alias-state-error-primary)}\n";
+/** Install the MCP stylesheet once (idempotent); returns the disposer. */
+export declare function installMcpStyles(): () => void;
+export interface McpSectionProps {
+    controller: SettingsClient;
+    t: Translate;
+}
+export declare function McpSection({ controller, t }: McpSectionProps): import("react").JSX.Element;
+export {};

package/lib/types/client/ui-tweaks/notifier.d.ts

@@ -0,0 +1,125 @@
+/**
+ * dsh-ui-tweaks — task notifications (browser half).
+ *
+ * Watches the sessions list feed (the same store the sidebar's running flag,
+ * amber interaction dot and green "done" reminder project from) and raises a
+ * browser-side heads-up when a session finishes its turn or starts blocking
+ * on the user — so a backgrounded tab can call you back:
+ *
+ * - "Finished" = a session's `running` flag drops (true → false) without an
+ *   interaction taking over, or its host-tracked `completed` reminder rises
+ *   (finished while not selected). The host `dshTurnOutcome` session
+ *   projection (`src/turn-outcome.ts`, folded from `turn/end` reasons) says
+ *   WHY it finished, so the copy distinguishes a clean completion from a
+ *   user abort and from a failed request (with the error text); when the
+ *   projection is missing or stale, falls back to a plain-finish announce.
+ * - "Interaction" = a session gains `pendingInteraction`
+ *   ('approval' | 'plan-review' | 'question') — exactly the sidebar's
+ *   amber-dot classification.
+ *
+ * Three independent channels, each silently degrading when unavailable:
+ * - Title flash: alternates `(N) 🔔 <title>` ↔ `(N) <title>` until the page
+ *   is visible and focused again, then restores the captured title. DSH may
+ *   rewrite `document.title` independently; while flashing our ticks win,
+ *   and on stop we restore the pre-flash capture (worst case a stale base).
+ * - System notification: the Web Notifications API; permission is requested
+ *   from the settings toggle's user gesture (`requestNotifyPermission`).
+ *   Clicking one focuses the window and opens that session. `silent` tracks
+ *   the chime channel so the two never double-beep.
+ * - Chime: a tiny WebAudio two-note motif (rising = done, falling = needs
+ *   you), synthesized in-process — no audio assets. Autoplay policy allows
+ *   this once the user has interacted with the origin (sticky activation),
+ *   which the settings-toggle clicks provide.
+ *
+ * Anti-spam: the first snapshot after install only arms the baseline (a page
+ * load never fires a burst); events fire on transitions only; a short
+ * per-session+kind cooldown absorbs reconnect re-pull flicker. Subagent child
+ * rows are skipped — their parent carries the turn, and mid-turn subagent
+ * completions would be noise.
+ * @module dsh-ui-tweaks/client/notifier
+ */
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { SessionPendingInteractionSnapshot } from '@deepseek-ai/dsh-client-ui-session/client';
+import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
+import type { TurnOutcomeValue } from '../../ui-tweaks/turn-outcome.ts';
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionMap {
+        dshTurnOutcome: TurnOutcomeValue | null;
+    }
+}
+/** Interaction kinds the host reports while a session blocks on the user. */
+export type NotifyPendingKind = 'approval' | 'plan-review' | 'question';
+/** Localized copy snapshot the notifier needs (resolved once at install). */
+export interface NotifierText {
+    /** System-notification heading for completion events. */
+    notifyTitleDone: string;
+    /** System-notification heading for user-interrupted turns. */
+    notifyTitleAborted: string;
+    /** System-notification heading for failed requests. */
+    notifyTitleFailed: string;
+    /** System-notification heading for interaction events. */
+    notifyTitlePending: string;
+    /** Completion body template; `{title}` becomes the session display title. */
+    bodyComplete: string;
+    /** Interruption body template. */
+    bodyAborted: string;
+    /** Failure body template; `{error}` becomes the truncated failure message. */
+    bodyFailed: string;
+    /** Approval body template. */
+    bodyApproval: string;
+    /** Plan-review body template. */
+    bodyPlan: string;
+    /** Question body template. */
+    bodyQuestion: string;
+}
+/**
+ * Live-read behavior switches — read through {@link TaskNotifierInput.readState}
+ * on every feed tick so settings-panel flips apply without reinstalling.
+ */
+export interface NotifierOptions {
+    /** Raise alerts only while the page is hidden or unfocused. */
+    onlyWhenHidden: boolean;
+    /** Alert when a session finishes its turn. */
+    onComplete: boolean;
+    /** Alert when a session starts waiting on the user. */
+    onInteraction: boolean;
+}
+/** Output channels, each independently toggleable. */
+export interface NotifierChannels {
+    titleFlash: boolean;
+    systemNotification: boolean;
+    sound: boolean;
+}
+/** Install-time wiring for {@link installTaskNotifier}. */
+export interface TaskNotifierInput {
+    /** The client sessions service whose list feed carries the watch states. */
+    sessionsService: ISessions;
+    /** Current Session-scoped interactions, published separately from list rows. */
+    pendingInteractions: HostObservable<SessionPendingInteractionSnapshot>;
+    /** Localized copy snapshot used across the notifier's lifetime. */
+    text: NotifierText;
+    /** Fresh behavior switches + channel toggles, read on every tick. */
+    readState(): {
+        options: NotifierOptions;
+        channels: NotifierChannels;
+    };
+}
+/**
+ * Ask the browser for desktop-notification permission. Must run inside a user
+ * gesture (the settings toggle's click) to avoid a denied or ignored prompt;
+ * repeated calls are cheap no-ops once decided.
+ */
+export declare function requestNotifyPermission(): void;
+export declare function previewTitleFlash(durationMs?: number): void;
+/**
+ * One-shot self-test for the settings panel's 测试 button: previews every
+ * enabled channel — a forced ~6s title-flash blink (the real one would clear
+ * instantly on a focused page), the falling (needs-you) chime, and, when
+ * permission is already granted, one sample system notification.
+ */
+export declare function previewAlerts(channels: NotifierChannels, text: NotifierText): void;
+/**
+ * Install the task notifier against the sessions list feed.
+ * @returns disposer — unsubscribes, restores the tab title and tears the channels down.
+ */
+export declare function installTaskNotifier(input: TaskNotifierInput): () => void;

package/lib/types/client/ui-tweaks/whale.d.ts

@@ -0,0 +1,55 @@
+/**
+ * dsh-ui-tweaks — whale working indicator (browser half).
+ *
+ * A compact China-knot brand mark perched on the composer card's top-right
+ * corner over drifting red waves. It is resident while the feature is on;
+ * idle it rests in brand red, and while the model works it floats and breathes
+ * through the red accent spectrum.
+ *
+ * - Mounted in `conversation.input.dock` (the full-width row stacked by the
+ *   composer column right above the card), registered only while the
+ *   `whaleIndicatorEnabled` toggle is on — off costs nothing. The dock row is
+ *   WIDER than the card (the card is capped at
+ *   `--dsh-composer-card-max-width` and centered with
+ *   `--dsh-composer-side-clearance` side padding by the InputBar root), so
+ *   the row replicates that exact geometry — same max-width, centered, same
+ *   side padding — before right-aligning; a 6px `translateY` then straddles
+ *   the card's top edge. The extra 14px right inset centers the whale over
+ *   the send button (34px round button, 8px tool-row padding → its center
+ *   sits 25px from the card's right edge; the 22px whale's right edge at
+ *   14px puts its center at 25px).
+ * - "Working" = the current session's `running` flag on the sessions list
+ *   feed, OR the input machine's claimed/submitting phases (the window
+ *   between pressing Enter and the agent actually starting to run).
+ * - The mark is self-contained rather than lifted from the host sidebar, so
+ *   its branding remains consistent while DSH changes its own logo.
+ * @module dsh-ui-tweaks/client/whale
+ */
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+export declare const WHALE_CSS = "\n.duwi-row{box-sizing:border-box;width:100%;max-width:calc(var(--dsh-composer-card-max-width) + 2 * var(--dsh-composer-side-clearance, 0px));margin:0 auto;padding:0 calc(var(--dsh-composer-side-clearance, 0px) + 14px) 0 var(--dsh-composer-side-clearance, 0px);display:flex;align-items:flex-end;justify-content:flex-end;height:27px;pointer-events:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}\n.duwi-stack{display:flex;flex-direction:column;align-items:center;transform:translateY(6px)}\n.duwi-whale{display:block;color:#9B0B09;transform-origin:50% 60%;pointer-events:auto;cursor:pointer}\n.duwi-row.duwi-swim .duwi-whale{animation:duwi-swim 1.9s ease-in-out infinite,duwi-breathe 1.9s ease-in-out infinite}\n.duwi-whale:hover{animation:duwi-swim 1.9s ease-in-out infinite}\n.duwi-waves{display:block;width:26px;height:9px;margin-top:-3px;overflow:hidden}\n.duwi-wave-back{stroke:#d96a65;opacity:.35}\n.duwi-wave-front{stroke:#9B0B09;opacity:.8}\n.duwi-wave-front,.duwi-wave-back{animation:duwi-drift-front 1.9s linear infinite}\n.duwi-wave-back{animation-duration:3.4s;animation-direction:reverse}\n@keyframes duwi-swim{\n0%,100%{transform:translateY(0) rotate(-4deg)}\n50%{transform:translateY(-3.5px) rotate(4deg)}\n}\n@keyframes duwi-breathe{\n0%,100%{color:#9B0B09}\n50%{color:#d94b45}\n}\n@keyframes duwi-drift-front{\nfrom{transform:translateX(0)}\nto{transform:translateX(-8px)}\n}\n@media (prefers-reduced-motion:reduce){\n.duwi-row.duwi-swim .duwi-whale,.duwi-whale:hover{animation:none}\n.duwi-wave-front,.duwi-wave-back{animation:none}\n}\n";
+/** Idempotent installer for the indicator styles (same pattern as the other features). */
+export declare function installWhaleStyles(): () => void;
+/**
+// ---------------------------------------------------------------------------
+// Component.
+// ---------------------------------------------------------------------------
+
+/**
+ * Structural slice of the framework `InputState` (not re-exported by the
+ * package's client entry) — exactly the fields the indicator reads off the
+ * dock's owner share.
+ */
+interface InputPhaseSnapshot {
+    phase: 'plain' | 'adjudicating' | 'claimed' | 'submitting';
+}
+export interface WhaleIndicatorProps {
+    /** Framework seat (PropsRuntime): current session id. */
+    sessionId: SessionId | undefined;
+    /** Owner share (InputZone): live input-machine snapshot — covers the send → run window. */
+    input: InputPhaseSnapshot;
+    /** Injected: the client sessions service (list feed carrying `running`). */
+    sessionsService: ISessions;
+}
+export declare function WhaleIndicator({ sessionId, input, sessionsService }: WhaleIndicatorProps): import("react").JSX.Element;
+export {};

package/lib/types/client/upload.d.ts

@@ -0,0 +1,69 @@
+/**
+ * File-upload plumbing for the files window: turn a file picker or a drag-drop
+ * into per-file raw-byte uploads through the sidebar's `/sidebar/upload` route.
+ *
+ * Folders keep their tree in both flows: the picker's `webkitdirectory`
+ * selection arrives as Files with `webkitRelativePath` filled, and dropped
+ * folders — which never surface in `dataTransfer.files` — are traversed via
+ * `webkitGetAsEntry`, so the relative path is preserved for every nested file
+ * and the host recreates the tree under the chosen directory. The File is
+ * streamed straight into the POST body (no base64 inflation); uploads run
+ * sequentially so one slow file cannot starve the others, and each result
+ * reports its own outcome (the tree keeps going after a failure). An
+ * optional `AbortSignal` stops the queue at the next item boundary and
+ * aborts the in-flight request; the host cleans up its temp file when the
+ * request stream dies.
+ */
+import { type SessionScope } from './api.ts';
+import type { CopyKey } from './locales.ts';
+/** One pending file: the browser File plus the workspace-relative target path. */
+export interface UploadItem {
+    file: File;
+    relativePath: string;
+}
+/** One settled upload. */
+export interface UploadResult {
+    relativePath: string;
+    ok: boolean;
+    path?: string;
+    /** Wire error code when the host refused the upload ('too-large', ...). */
+    code?: string;
+    /** The host's error message (English wire text; localize via `code`). */
+    error?: string;
+}
+/** Collect a picker selection (webkitdirectory folders carry relative paths). */
+export declare function uploadItemsFromFiles(files: FileList | readonly File[]): UploadItem[];
+/**
+ * Collect a drag-drop payload. Dropped folders do NOT surface in
+ * `dataTransfer.files` — they arrive as directory items, so entries are
+ * captured via `webkitGetAsEntry` and traversed (draining readEntries
+ * batches), keeping each nested file's relative path. MUST be invoked
+ * synchronously from the drop handler: the dataTransfer enters protected
+ * mode once the event dispatch ends, while the captured entry handles stay
+ * readable asynchronously. Falls back to the flat file list when the entry
+ * API is unavailable; an entry that fails to read is skipped, not fatal.
+ */
+export declare function uploadItemsFromDrop(data: DataTransfer | undefined): Promise<UploadItem[]>;
+/**
+ * Client-side pre-check cap. Mirrors the host's default (config `uploadLimit`)
+ * only — the host enforces the real, configurable limit, so a lowered host
+ * limit surfaces as a `too-large` wire error, never as a silent pass.
+ */
+export declare const MAX_UPLOAD_BYTES: number;
+/** How long a success hint stays before fading (failures stay until the next action). */
+export declare const UPLOAD_HINT_MS = 3500;
+/**
+ * One-line upload progress text: 'Uploading into {dir}…' while no file is in
+ * flight, then 'Uploading {done}/{total}: {name}' per file. Shared by the tree
+ * hint and the full-window upload overlay.
+ */
+export declare function uploadHintText(done: number, total: number, current: string, dir: string, t: (key: CopyKey, params?: Record<string, string | number>) => string): string;
+/**
+ * Upload every item into `dir` (absolute, inside the session workspace),
+ * sequentially, reporting progress as `(done, total, currentRelativePath)`.
+ * Resolves with one result per item — never rejects; `signal.aborted` stops
+ * the queue at the next item boundary (completed items stay uploaded).
+ */
+export declare function uploadToDir(scope: SessionScope, dir: string, items: UploadItem[], onProgress?: (done: number, total: number, current: string) => void, signal?: AbortSignal): Promise<UploadResult[]>;
+/** Fold a result list into a one-line status for the tree hint. */
+export declare function summarizeResults(results: UploadResult[], t: (key: CopyKey, params?: Record<string, string | number>) => string): string;

package/lib/types/client/useChatcodeAccount.d.ts

@@ -0,0 +1,10 @@
+import type { ChatCodeAuthState } from './api.ts';
+export declare function useChatcodeAccount(): {
+    chatcode: ChatCodeAuthState | undefined;
+    busy: boolean;
+    error: "status" | "operation" | undefined;
+    loginUrl: string | undefined;
+    startLogin: () => void;
+    logout: () => void;
+    cancelLogin: () => void;
+};

package/lib/types/client/wco.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Reactive Window Controls Overlay geometry — the STANDARD web mechanism
+ * for frameless Chromium shells that draw the native caption buttons
+ * (minimize / maximize / close) OVER the web content (Electron
+ * `titleBarOverlay` on Windows; issue #257). Feature-detected: absent in
+ * plain browsers, macOS, Tauri etc., where the snapshot stays `NONE` and
+ * the sidebar adapts nothing — this is the conservative "auto" signal.
+ *
+ * The API reports the real titlebar rect (CSS px), which differs between
+ * shells and Electron versions (32 / 36 …), and fires `geometrychange`
+ * when the window maximizes / restores / moves — so the strip must be
+ * reactive, not memoized like the URL stamps.
+ *
+ * Module-level store so the Sidebar shell can subscribe via
+ * `useSyncExternalStore`; `setWcoSourceForTests` swaps the source for unit
+ * tests (no real API exists in jsdom/headless).
+ */
+export interface WcoSource {
+    readonly visible: boolean;
+    getTitlebarAreaRect(): {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    addEventListener(type: 'geometrychange', listener: () => void): void;
+    removeEventListener(type: 'geometrychange', listener: () => void): void;
+}
+/** The current overlay geometry (present=false = API unavailable). */
+export interface WcoSnapshot {
+    readonly present: boolean;
+    readonly height: number;
+}
+/** Snapshot when the API is unavailable (plain browser / non-overlay shell). */
+export declare const WCO_NONE: WcoSnapshot;
+type Listener = () => void;
+/** Read the current snapshot (returns the frozen NONE when unavailable). */
+export declare function getWcoSnapshot(): WcoSnapshot;
+/**
+ * Subscribe to overlay geometry changes. Attaches to the real
+ * `navigator.windowControlsOverlay` on first subscribe; the disposer
+ * detaches the native listener when the last subscriber leaves.
+ */
+export declare function subscribeWco(onChange: Listener): () => void;
+/** Test hook: swap the geometry source (undefined = API unavailable). */
+export declare function setWcoSourceForTests(next: WcoSource | undefined): void;
+export {};