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

package/lib/types/ui-tweaks/config.d.ts

@@ -0,0 +1,186 @@
+/**
+ * dsh-ui-tweaks configuration: conversation font size (px), markdown table
+ * style, and feature toggles. Every field
+ * defaults at the schema boundary, so a hand-edited settings document and the
+ * Settings panel stay consistent.
+ * @module dsh-ui-tweaks/config
+ */
+import type Schema from '@deepseek-ai/schemastery';
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings';
+/** Settings document namespace owned by this plugin. */
+export declare const UI_TWEAKS_SETTINGS_NAMESPACE: SettingsNamespace;
+/** Raw user-facing configuration (partial inputs receive schema defaults). */
+export interface UITweaksConfig {
+    /** Message content font size in px. */
+    fontSize?: number;
+    /**
+     * Code font size as a percentage of the message font size. 81 is the stock
+     * ratio (13px code block at a 16px body); 100 makes code match the body.
+     *
+     * @deprecated Legacy percent input, kept for migration; prefer
+     * `codeFontSize`. Ignored once `codeFontSize` is set.
+     */
+    codeFontScale?: number;
+    /**
+     * Absolute code font size in px (8–32). 13 matches the stock DSH code block
+     * at a 16px body. Drives the code block directly; inline code and the small
+     * code font follow proportionally. When unset, falls back to the legacy
+     * `codeFontScale` percentage, then to the stock default.
+     */
+    codeFontSize?: number;
+    /**
+     * The "行高" base unit in px: the vertical rhythm of the reply area. It
+     * drives the gap between message rows (Think ↔ tool cards, user ↔
+     * assistant), the gap between content blocks inside one assistant reply
+     * (Think ↔ text), the markdown text line-height, paragraph bottom margins,
+     * and list margins — all scaled proportionally. 16 matches the stock DSH
+     * spacing.
+     */
+    lineHeight?: number;
+    /** Markdown table presentation style. */
+    tableStyle?: 'default' | 'claude';
+    /**
+     * Whether the GitBar (branch / diff / commit-message pills above the input)
+     * is shown. Off by default; the bar hides itself when the session has no
+     * cwd or the directory is not a git repository.
+     */
+    gitBarEnabled?: boolean;
+    /**
+     * Whether the Archive manager is shown: the "归档" Settings page that lists
+     * archived sessions and can restore or permanently delete them. Off by
+     * default; users turn it on in Settings.
+     */
+    archiveManagerEnabled?: boolean;
+    /**
+     * Whether the MCP manager is shown: the "MCP 管理" Settings page that lists
+     * the configured MCP servers (status, tool count) and can restart them. Off
+     * by default; users turn it on in Settings.
+     */
+    mcpManagerEnabled?: boolean;
+    /**
+     * Whether the `/init` slash command is registered: picking a prompt language
+     * submits an AGENTS.md bootstrap prompt into the session. Off by default;
+     * users turn it on in Settings.
+     */
+    initCommandEnabled?: boolean;
+    /**
+     * Whether the whale working indicator is shown: a little brand whale
+     * centered above the input box — translucent and still while the model is
+     * idle, swimming while it works. Off by default; users turn it on in
+     * Settings.
+     */
+    whaleIndicatorEnabled?: boolean;
+    /**
+     * Whether the composer stats line's cache-hit figure keeps two decimal
+     * places ("缓存命中 96.35%"), computed client-side from the raw
+     * cached-read / cached-write / uncached-input token buckets instead of
+     * DSH's rounded integer. Off by default; users turn it on in Settings.
+     */
+    preciseCacheHitEnabled?: boolean;
+    /**
+     * Master switch for task notifications: browser-side alerts (tab-title
+     * flash, system notification, chime) raised when a session finishes its
+     * turn or starts waiting on the user. Off by default; users turn it on in
+     * Settings.
+     */
+    notificationsEnabled?: boolean;
+    /** Stay quiet while the page is visible and focused; alert only once hidden or unfocused. */
+    notifyOnlyWhenHidden?: boolean;
+    /** Alert when a session ends its turn — completed, interrupted or failed. */
+    notifyOnComplete?: boolean;
+    /** Alert when a session starts blocking on an approval, plan review or question. */
+    notifyOnInteraction?: boolean;
+    /** Blink an unread counter into the tab title until the user returns. */
+    notifyTitleFlash?: boolean;
+    /** Fire desktop-level Web Notifications; clicking one opens that session. */
+    notifySystemNotification?: boolean;
+    /** Play a synthesized two-note chime (rising = done, falling = needs you). */
+    notifySound?: boolean;
+    /**
+     * Optional explicit `provider:model` for generating commit messages with the
+     * LLM (e.g. `jiyuanlvdong:deepseek-v4-flash-0731`). When unset, the first
+     * registered provider/model is used; when the LLM service is unavailable or
+     * the call fails, a heuristic commit message is generated instead.
+     */
+    suggestModel?: string;
+}
+export declare const MIN_FONT_SIZE = 10;
+export declare const MAX_FONT_SIZE = 32;
+export declare const DEFAULT_FONT_SIZE = 16;
+/** 16px matches the stock DSH vertical rhythm (message/block gaps, etc.). */
+export declare const MIN_LINE_HEIGHT = 0;
+export declare const MAX_LINE_HEIGHT = 64;
+export declare const DEFAULT_LINE_HEIGHT = 16;
+/** 81% = the stock code ratio (13px code block at a 16px body). Legacy input. */
+export declare const MIN_CODE_FONT_SCALE = 50;
+export declare const MAX_CODE_FONT_SCALE = 150;
+export declare const DEFAULT_CODE_FONT_SCALE = 81;
+/** Absolute code font size (px): 13 is the stock DSH code block at a 16px body. */
+export declare const MIN_CODE_FONT_SIZE = 8;
+export declare const MAX_CODE_FONT_SIZE = 32;
+export declare const DEFAULT_CODE_FONT_SIZE = 13;
+/** GitBar defaults to off; users turn it on in Settings. */
+export declare const DEFAULT_GITBAR_ENABLED = false;
+/** Archive manager defaults to off; users turn it on in Settings. */
+export declare const DEFAULT_ARCHIVE_MANAGER_ENABLED = false;
+/** MCP manager defaults to off; users turn it on in Settings. */
+export declare const DEFAULT_MCP_MANAGER_ENABLED = false;
+/** The /init slash command defaults to off; users turn it on in Settings. */
+export declare const DEFAULT_INIT_COMMAND_ENABLED = false;
+/** The whale working indicator defaults to off; users turn it on in Settings. */
+export declare const DEFAULT_WHALE_INDICATOR_ENABLED = false;
+/** The precise cache-hit readout defaults to off; users turn it on in Settings. */
+export declare const DEFAULT_PRECISE_CACHE_HIT_ENABLED = false;
+/** Task notifications default to off; users turn them on in Settings. */
+export declare const DEFAULT_NOTIFICATIONS_ENABLED = false;
+/** Notification behavior defaults: quiet while watched, both event kinds on. */
+export declare const DEFAULT_NOTIFY_ONLY_WHEN_HIDDEN = true;
+export declare const DEFAULT_NOTIFY_ON_COMPLETE = true;
+export declare const DEFAULT_NOTIFY_ON_INTERACTION = true;
+/** Notification channel defaults: title flash + system notification on, chime opt-in. */
+export declare const DEFAULT_NOTIFY_TITLE_FLASH = true;
+export declare const DEFAULT_NOTIFY_SYSTEM_NOTIFICATION = true;
+export declare const DEFAULT_NOTIFY_SOUND = false;
+/** Configuration schema with documented defaults. */
+export declare const Config: Schema<UITweaksConfig>;
+/** Configuration after static validation, with every default materialized. */
+export interface ResolvedUITweaksConfig {
+    fontSize: number;
+    /** Code font size as a percentage of the message font size (legacy input). */
+    codeFontScale: number;
+    /** Effective absolute code font size in px (codeFontSize, else legacy %, else stock). */
+    codeFontSize: number;
+    /** Base vertical spacing (px) for the reply area ("行高"). */
+    lineHeight: number;
+    tableStyle: 'default' | 'claude';
+    /** Whether the GitBar pills above the input are shown. */
+    gitBarEnabled: boolean;
+    /** Whether the Archive manager sidebar entry is shown. */
+    archiveManagerEnabled: boolean;
+    /** Whether the MCP manager Settings page is shown. */
+    mcpManagerEnabled: boolean;
+    /** Whether the /init slash command is registered. */
+    initCommandEnabled: boolean;
+    /** Whether the whale working indicator above the input is shown. */
+    whaleIndicatorEnabled: boolean;
+    /** Whether the stats line's cache-hit figure keeps two decimals. */
+    preciseCacheHitEnabled: boolean;
+    /** Whether task notifications (title flash / system notification / chime) are active. */
+    notificationsEnabled: boolean;
+    /** Stay quiet while the page is visible and focused. */
+    notifyOnlyWhenHidden: boolean;
+    /** Alert when a session ends its turn — completed, interrupted or failed. */
+    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;
+    /** Optional `provider:model` override for LLM commit-message generation. */
+    suggestModel?: string;
+}
+/** Resolve a partial config into a fully defaulted value. */
+export declare function resolveConfig(config?: UITweaksConfig): ResolvedUITweaksConfig;

package/lib/types/ui-tweaks/git-web.d.ts

@@ -0,0 +1,43 @@
+/**
+ * dsh-ui-tweaks — Git Web routes.
+ *
+ * Same-origin JSON endpoints backing the GitBar browser half. Every mutating
+ * action is a POST guarded by the same origin/same-site checks as the Settings
+ * route; the session id arrives as a query/body field and the backend resolves
+ * the working directory from the session header.
+ *
+ * The terminal panel rides two extra surfaces on the same prefix:
+ * - `GET /vendor/<file>` serves the vendored xterm.js UMD builds the browser
+ *   half lazy-loads on first panel open (whitelist only — no path traversal).
+ * - `WS /terminal-ws` upgrades into the persistent PTY bridge: server→client
+ *   frames are RAW pty output (plus one JSON `{"type":"exit"}` notice),
+ *   client→server frames are JSON (`input` / `resize` / `close`) so a pasted
+ *   brace can never be mistaken for a control frame.
+ * @module dsh-ui-tweaks/git-web
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Context } from '@deepseek-ai/cordis';
+import { GitBackend } from './git.ts';
+/** Route prefix shared with the browser half. */
+export declare const GIT_ROUTE = "/_dsh/ui-tweaks/git";
+/** Exact path of the terminal WebSocket upgrade route. */
+export declare const TERMINAL_WS_PATH = "/_dsh/ui-tweaks/git/terminal-ws";
+/**
+ * Same-origin Git endpoints. GETs are read-only; POSTs mutate the repository
+ * and reject cross-site requests.
+ */
+export declare class GitWebHandler {
+    private readonly backend;
+    constructor(backend: GitBackend);
+    handle(req: IncomingMessage, res: ServerResponse): Promise<void>;
+    private requireCwd;
+    /** Serve one whitelisted vendored asset; anything else is a 404. */
+    private serveVendor;
+}
+/**
+ * Attach the Git routes plus the terminal WebSocket whenever a webServer
+ * service is present.
+ * @param ctx - plugin context owning route effects.
+ * @param backend - Git backend.
+ */
+export declare function installGitWeb(ctx: Context, backend: GitBackend): void;

package/lib/types/ui-tweaks/git.d.ts

@@ -0,0 +1,311 @@
+/**
+ * dsh-ui-tweaks — Git backend (host half).
+ *
+ * Executes read-only and mutating git commands in a session's working
+ * directory (the "current project", resolved from the session header's cwd)
+ * for the GitBar: status snapshot (branch, ahead/behind, changed files with
+ * ±line counts), branch enumeration, per-file diff views, commit-message
+ * suggestion (LLM first, heuristic fallback), and the commit / push /
+ * switch / create actions.
+ *
+ * Every command runs through `child_process.execFile` — never a shell, args
+ * as an argv array, cwd pinned, bounded timeout, abort propagation — so
+ * repo-controlled strings cannot escape into a shell and a hung remote cannot
+ * wedge the plugin.
+ *
+ * The terminal panel additionally runs a PERSISTENT REAL PTY per target
+ * (node-pty — conpty on Windows), streamed to the browser over a WebSocket
+ * and rendered with xterm.js: shell state, colors, Ctrl+C and interactive
+ * apps work exactly like the DSH-better-sidebar terminal, whose pty-manager
+ * design (transcript ring replay + reconnect grace) this follows.
+ * @module dsh-ui-tweaks/git
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { UITweaksConfig } from './config.ts';
+/** One changed file with its ±line counts. */
+export interface GitFileChange {
+    path: string;
+    /** Display status: M / A / D / R / C / U (untracked). */
+    status: string;
+    added: number;
+    deleted: number;
+    untracked: boolean;
+}
+/** Full status snapshot for one session cwd. */
+export interface GitSnapshot {
+    isRepo: boolean;
+    /** Absolute working directory, when resolvable. */
+    cwd?: string;
+    /** Current branch name, or null when detached. */
+    branch: string | null;
+    /** Short HEAD sha while detached. */
+    detachedHead?: string;
+    /** Upstream ref name (e.g. `origin/main`), when tracked. */
+    upstream?: string;
+    /** Commits ahead of the upstream. */
+    ahead: number;
+    /** Commits behind the upstream. */
+    behind: number;
+    hasRemote: boolean;
+    clean: boolean;
+    files: GitFileChange[];
+    totalAdded: number;
+    totalDeleted: number;
+}
+/** Local + remote branch enumeration. */
+export interface GitBranches {
+    current: string | null;
+    local: string[];
+    remote: string[];
+}
+/** One commit row of the graph table. */
+export interface GitGraphCommit {
+    /** ASCII graph edge prefix (monospace drawing column). */
+    graph: string;
+    /** Full commit hash. */
+    fullHash: string;
+    /** Short hash (7 chars). */
+    hash: string;
+    /** Subject line. */
+    subject: string;
+    /** Author name. */
+    author: string;
+    /** ISO-8601 commit date. */
+    date: string;
+    /** Relative date, e.g. "3 days ago". */
+    dateRelative: string;
+    /** Ref decorations, e.g. `HEAD -> main, origin/main` (outer parens stripped). */
+    refs: string;
+}
+/** Git commit graph table (`git log --graph`, structured rows). */
+export interface GitGraph {
+    commits: GitGraphCommit[];
+    /** Whether the requested commit window was cut off by the limit. */
+    truncated: boolean;
+}
+/** One rendered line of a per-file diff view. */
+export interface DiffLine {
+    type: 'hunk' | 'add' | 'del' | 'ctx';
+    /** Old-file line number (null for added lines). */
+    old: number | null;
+    /** New-file line number (null for deleted lines). */
+    new: number | null;
+    /** Content after the +/-/space prefix; hunk lines carry the full `@@` header. */
+    text: string;
+}
+/** Structured per-file diff for the GitBar side panel. */
+export interface GitDiffResult {
+    path: string;
+    /** `hunk` = changed ranges only; `full` = whole file with added lines marked. */
+    mode: 'hunk' | 'full';
+    lines: DiffLine[];
+    truncated: boolean;
+}
+/** Deterministic offline commit-message generation (LLM fallback). */
+export declare function heuristicSuggest(snapshot: GitSnapshot): string;
+/** How a commit message was produced, and why the LLM path was skipped. */
+export interface GitSuggestResult {
+    message: string;
+    /** `llm` = a model wrote it; `heuristic` = offline fallback from file names. */
+    via: 'llm' | 'heuristic';
+    /** Provider/model actually used (or attempted). */
+    provider?: string;
+    model?: string;
+    /** Why the LLM path did not produce a message (only when `via` is heuristic). */
+    reason?: string;
+    /** Whether the diff excerpt handed to the model was cut short. */
+    truncated?: boolean;
+}
+/**
+ * The Git service: resolves a session's cwd and runs git on its behalf.
+ * @param ctx - plugin context (sessions and llm are read structurally, never required).
+ * @param readConfig - reads the plugin config for the `suggestModel` override.
+ */
+export declare class GitBackend {
+    private readonly ctx;
+    private readonly readConfig;
+    /** Persistent PTY shell sessions for the terminal panel (WebSocket-streamed). */
+    readonly terminals: TerminalSessionManager;
+    constructor(ctx: Context, readConfig: () => UITweaksConfig);
+    /** Resolve the session's working directory, or undefined when absent. */
+    resolveCwd(sessionId: string | undefined): string | undefined;
+    /**
+     * Resolve a workspace title (the hero/new-session screen has no real session
+     * yet, only the picked workspace) to its directory. Matches the display
+     * title exactly first, then a basename suffix — titles may duplicate, so an
+     * exact hit always wins. Optional-service read like resolveCwd.
+     */
+    resolveWorkspaceCwd(name: string | undefined): string | undefined;
+    /** Resolve either target form to a cwd (session id first, then workspace title). */
+    resolveTargetCwd(target: {
+        session?: string | undefined;
+        ws?: string | undefined;
+    }): string | undefined;
+    /**
+     * Open the project folder in an external app (explorer / editors). The
+     * editor targets launch through their CLI shims (code / idea / goland /
+     * webstorm / pycharm — Toolbox puts the JetBrains ones on PATH).
+     * Fire-and-forget GUI launches: explorer exits non-zero even on success, so
+     * only a spawn FAILURE rejects; app shims missing from PATH reject with a
+     * user-visible hint instead of crashing the route.
+     */
+    openFolder(cwd: string, target: 'explorer' | 'vscode' | 'idea' | 'goland' | 'webstorm' | 'pycharm'): Promise<void>;
+    /** Full status snapshot for a session's cwd. One merged `status -z --branch
+     *  --untracked-files=all` call carries branch/upstream/tracking and the
+     *  per-file untracked list (no ls-files expansion pass), and every read —
+     *  repo probe included — runs in one parallel batch. The previous nine
+     *  sequential process spawns cost ~700ms on Windows, this costs one spawn. */
+    snapshot(cwd: string, signal?: AbortSignal): Promise<GitSnapshot>;
+    /** Local + remote branch enumeration. */
+    branches(cwd: string, signal?: AbortSignal): Promise<GitBranches>;
+    /**
+     * Per-file diff for the side panel. `mode: 'hunk'` returns only the changed
+     * ranges (untracked files render as whole-file additions); `mode: 'full'`
+     * returns the whole file with added lines marked.
+     */
+    diff(cwd: string, path: string, mode: 'hunk' | 'full', signal?: AbortSignal): Promise<GitDiffResult>;
+    /**
+     * Suggest a commit message: LLM first (when the service and a model are
+     * available), heuristic fallback otherwise. Kept for callers that only want
+     * the text; {@link suggestDetailed} also reports which path produced it.
+     */
+    suggest(cwd: string, signal?: AbortSignal): Promise<string>;
+    /**
+     * Suggest a commit message and report how it was produced. A failing LLM
+     * path is no longer silent: the caller receives `via: 'heuristic'` plus the
+     * reason, and the failure is logged, because an offline fallback message
+     * looks exactly like a model-written one in the UI.
+     */
+    suggestDetailed(cwd: string, signal?: AbortSignal): Promise<GitSuggestResult>;
+    /**
+     * Resolve which provider/model writes the commit message: the `suggestModel`
+     * override, else this host's default Agent model. No further fallback — if
+     * the default model is unavailable or fails, the suggestion fails (the
+     * caller reports the reason) rather than silently using another provider.
+     */
+    private resolveSuggestModel;
+    private llmSuggest;
+    /**
+     * Stage and commit; optionally push afterwards. Returns the short hash.
+     * When `exclude` names changed files, they are unstaged and left out of the
+     * commit (they stay in the working tree); otherwise everything is staged
+     * with `git add -A`.
+     */
+    commit(cwd: string, message: string, opts?: {
+        push?: boolean;
+        exclude?: readonly string[];
+        signal?: AbortSignal;
+    }): Promise<{
+        hash?: string;
+        pushed: boolean;
+    }>;
+    /** Delete a local branch (force; the UI confirms first). Protected branches cannot be deleted. */
+    deleteBranch(cwd: string, name: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Delete a remote branch (`origin/foo` → `git push origin --delete foo`).
+     * Protected branches cannot be deleted. The local remote-tracking ref is
+     * pruned afterwards so the branch list refreshes without waiting for a fetch.
+     */
+    deleteRemoteBranch(cwd: string, name: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Recent commit graph as structured rows (`git log --graph --all --no-color`
+     * with a machine-readable format), bounded by `limit` commits. The graph edge
+     * prefix is kept verbatim for the monospace drawing column.
+     */
+    graph(cwd: string, limit: number | undefined, signal?: AbortSignal): Promise<GitGraph>;
+    /** Push the current branch; a branch without upstream gets `-u origin <branch>`. */
+    push(cwd: string, signal?: AbortSignal): Promise<void>;
+    /** Switch to an existing branch (git switch, falling back to checkout). */
+    checkout(cwd: string, branch: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Create a branch from `base` (default: current HEAD) and switch to it.
+     * When `pushRemote` is true, the new branch is also pushed to `origin`
+     * with `-u`, creating it on the remote.
+     */
+    createBranch(cwd: string, name: string, base: string | undefined, pushRemote: boolean, signal?: AbortSignal): Promise<void>;
+}
+/**
+ * Duck-typed face of the `node-pty` module — only what this plugin touches.
+ * Kept structural so a broken native install degrades into a clear
+ * "pty unavailable" error instead of crashing plugin activation.
+ */
+interface NodePtyModule {
+    spawn(file: string, args: readonly string[], options: {
+        name: string;
+        cols: number;
+        rows: number;
+        cwd: string;
+        env: NodeJS.ProcessEnv;
+    }): IPtyLike;
+}
+/** Duck-typed face of one node-pty terminal handle. */
+interface IPtyLike {
+    pid: number;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+    onData(listener: (data: string) => void): unknown;
+    onExit(listener: (event: {
+        exitCode: number;
+        signal?: number;
+    }) => void): unknown;
+}
+/** A browser socket attached to one terminal (the WebSocket adapter). */
+export interface TerminalClient {
+    /** Push one chunk to the browser: raw pty bytes or a JSON control frame. */
+    send(text: string): void;
+    /** Whether the connection can still carry frames. */
+    readonly alive: boolean;
+}
+interface TerminalSession {
+    key: string;
+    cwd: string;
+    pty: IPtyLike;
+    /** Output accumulated since spawn (bounded; head dropped when over the limit). */
+    transcript: string;
+    exited: boolean;
+    exitCode: number | null;
+    clients: Set<TerminalClient>;
+    closeTimer: ReturnType<typeof setTimeout> | null;
+}
+/**
+ * Owns the terminal shells, keyed by target (`session:<id>` / `ws:<name>`).
+ * One live process per key: re-attach reuses it (transcript replay makes the
+ * panel reopen seamless), an exited or cwd-changed handle is replaced with a
+ * fresh spawn. Socket drops schedule a grace close that a timely re-attach
+ * cancels; only the explicit close frame and teardown kill immediately.
+ */
+export declare class TerminalSessionManager {
+    private readonly sessions;
+    private readonly nodePty;
+    constructor(loadPty?: () => NodePtyModule | undefined);
+    /** Whether the native pty module could not be loaded (degraded mode). */
+    get unavailable(): boolean;
+    /**
+     * Attach one browser client to the target's terminal, opening (or replacing)
+     * the underlying shell as needed.
+     * @returns the session whose `transcript` must be replayed to the client
+     *   before live data (empty on a fresh spawn).
+     */
+    attach(key: string, cwd: string, cols: number, rows: number, client: TerminalClient): TerminalSession;
+    /** Remove one client; when the last one leaves, arm the reconnect grace. */
+    detach(key: string, client: TerminalClient): void;
+    /** Forward raw stdin bytes from the browser to the shell. */
+    input(key: string, data: string): void;
+    /** Propagate the xterm viewport size to the pty. */
+    resize(key: string, cols: number, rows: number): void;
+    /** Kill the target's shell now (explicit close frame / teardown path). */
+    close(key: string): void;
+    /** Kill every shell (plugin teardown). */
+    disposeAll(): void;
+    private spawn;
+    /** Fan one pty chunk out to every attached, still-open client. */
+    private broadcast;
+    /** Make room for a new shell: drop exited records first, then detached ones. */
+    private evictForNewSession;
+    /** Arm (or re-arm) the delayed destruction used for bare socket drops. */
+    private scheduleClose;
+    /** Cancel a pending scheduled close (a client re-attached in time). */
+    private cancelClose;
+}
+export {};

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

@@ -0,0 +1,17 @@
+/**
+ * dsh-ui-tweaks — server half.
+ *
+ * Registers the `ui-tweaks` settings namespace so users can tune the
+ * conversation UI either from the Settings panel or by editing the settings
+ * document directly (settings.yaml `ui-tweaks:` section). All rendering work
+ * happens in the browser bundle (`src/client`), which reads and writes this
+ * namespace through the same-origin route mounted here — the Web settings RPC
+ * only exposes a fixed allowlist of namespaces since rc.6, so a custom route is
+ * the supported way for a plugin to own a configuration page.
+ * @module dsh-ui-tweaks
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "dsh-ui-tweaks";
+/** Required services: the settings seam is the whole server-side surface. */
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

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

@@ -0,0 +1,103 @@
+/**
+ * dsh-ui-tweaks — MCP manager (host half).
+ *
+ * The browser MCP manager (the "MCP 管理" settings section, shown when the
+ * mcpManagerEnabled setting is on) manages the configured MCP servers through
+ * this same-origin route:
+ *
+ * - **list** — every `@deepseek-ai/dsh-mcp-client` loader entry with its live
+ *   fiber status (active / failed / loading / stopped / disabled), its config
+ *   (serverName, transport, command / url, env), a YAML rendering of the
+ *   config (for the YAML editor), and the tools it registered
+ *   (`mcp__<serverName>__*`) counted from the tool registry.
+ * - **save / remove / set-enabled** — ADD, EDIT, DELETE, and ENABLE/DISABLE a
+ *   server durably by editing the profile's own `cordis.patch.yml` (the same
+ *   file the user edits by hand): the entry is inserted / replaced / removed /
+ *   flagged `disabled`, the file is written atomically, and DSH's built-in
+ *   patch watcher (`watchUserPatches`, Cordis HMR) hot-reloads the loader, so
+ *   the MCP server starts / stops / restarts live. The loader tree itself is
+ *   never rewritten, so the patch file stays the single source of truth.
+ *
+ * Env values are returned to the same-origin browser (the user's own machine
+ * and config) because the editor must be able to show and modify them.
+ * @module dsh-ui-tweaks/mcp
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Context } from '@deepseek-ai/cordis';
+/** Exact route used by the browser MCP manager. */
+export declare const MCP_ROUTE = "/_dsh/ui-tweaks/mcp";
+/** Lifecycle status of one MCP server instance. */
+export type McpStatus = 'disabled' | 'stopped' | 'active' | 'failed' | 'loading';
+/** Public view of one configured MCP server. */
+export interface McpServerView {
+    /** Loader entry id (e.g. `mcp-mysql-local`). */
+    id: string;
+    /** The server's tool namespace (`mcp__<serverName>__*`). */
+    serverName: string;
+    transport: string;
+    command?: string;
+    args: string[];
+    url?: string;
+    headers: Record<string, string>;
+    env: Record<string, string>;
+    /** Per-tool-call timeout in milliseconds. */
+    toolCallTimeoutMs?: number;
+    /** The server's config rendered as YAML (for the YAML editor). */
+    yaml: string;
+    disabled: boolean;
+    status: McpStatus;
+    toolCount: number;
+    /** Raw tool names registered by this server, sorted. */
+    tools: string[];
+}
+/** Editor payload for add/edit/set-enabled. */
+export interface McpServerInput {
+    id: string;
+    serverName: string;
+    transport: 'stdio' | 'streamable-http';
+    command?: string;
+    args?: string[];
+    url?: string;
+    headers?: Record<string, string>;
+    env?: Record<string, string>;
+    toolCallTimeoutMs?: number;
+    disabled: boolean;
+}
+export interface McpSnapshot {
+    servers: McpServerView[];
+}
+/** Same-origin MCP read/write handler. */
+export declare class McpBackend {
+    private readonly ctx;
+    constructor(ctx: Context);
+    private loader;
+    /** Best-effort enumeration of the global tool registry (no public list API). */
+    private toolNames;
+    private snapshot;
+    /** Resolve the profile directory: the root Include entry's config.path is
+     * the profile's `cordis.yml` (a `file://` URL), whose parent IS the profile
+     * directory. Falls back to the loader's baseUrl. */
+    private profileDir;
+    private patchFilePath;
+    /** Find one MCP entry in the patch document; also reports its insert seq, index, and owning patch. */
+    private findPatchEntry;
+    /** The insert seq new MCP entries should join (first one already holding MCP entries, else the first insert). */
+    private insertTarget;
+    private entryNode;
+    private mutatePatchFile;
+    private validateInput;
+    /** Add or edit one server (upsert by id), persisting to the profile patch file. */
+    private save;
+    /** Delete one server from the profile patch file. */
+    private remove;
+    /** Enable or disable one server in the profile patch file. */
+    private setEnabled;
+    /** Handle the exact MCP route. */
+    handle(req: IncomingMessage, res: ServerResponse): Promise<void>;
+}
+/**
+ * Attach the MCP route whenever a webServer service is present.
+ * @param ctx - plugin context owning route effects.
+ * @param backend - MCP handler.
+ */
+export declare function installMcpWeb(ctx: Context, backend: McpBackend): void;