@xiaoso/dsh-tool-plus 0.1.7-beta.0 → 0.1.7

package/lib/index.mjs

@@ -3,7 +3,7 @@ __installBunShim();
 import { n as fs_promises_shim_exports, t as exists } from "./fs-promises-shim-Bx0fpxuk.mjs";
 import { i as setRuntimeLogger, n as systemChromiumCandidatesForTest, r as runtimeLogger } from "./launch-DKDH71En.mjs";
 import { $ as isEnoent, A as formatCount, C as warn, D as installBunShim, F as $flag, N as $env, O as formatAge, P as $envpos, Q as hasFsCode, U as getAutoQaDbPath, V as VERSION, X as getRemoteDir, Y as getPuppeteerDir, at as findOnPath, b as debug, c as combineSignals, d as $which, et as isEnotdir, it as untilAborted, k as formatBytes$1, l as exec, m as readImageMetadata, nt as peekFile, q as getInstallId, tt as isProbablyBinary, u as render, x as error } from "./src-BwW51vA5.mjs";
-import { C as truncateToWidth$1, S as replaceTabs, _ as formatCodeFrameLine, a as fetchBinary, b as LRUCache, c as getParallelExtractContent, d as convertFileWithMarkit, f as Settings, g as capParseErrors, h as OMP_DEFAULTS, i as convertWithMarkit, l as ensureTool, m as settings, o as extractWithParallel, p as isSettingsInitialized, s as findParallelApiKey, u as CONVERTIBLE_EXTENSIONS, v as formatParseErrors, x as padding, y as shortenPath } from "./utils-CCfhUQen.mjs";
+import { C as truncateToWidth$1, S as replaceTabs, _ as formatCodeFrameLine, a as fetchBinary, b as LRUCache, c as getParallelExtractContent, d as convertFileWithMarkit, f as Settings, g as capParseErrors, h as OMP_DEFAULTS, i as convertWithMarkit, l as ensureTool, m as settings, o as extractWithParallel, p as isSettingsInitialized, s as findParallelApiKey, u as CONVERTIBLE_EXTENSIONS, v as formatParseErrors, x as padding, y as shortenPath } from "./utils-ECAwvaPQ.mjs";
 import { t as sanitizeText } from "./sanitize-text-BCf5KmCf.mjs";
 import { n as isRecord$2 } from "./type-guards-CttAANEx.mjs";
 import { n as ToolError, r as throwIfAborted, t as ToolAbortError } from "./tool-errors-DoyxivAR.mjs";
@@ -10264,7 +10264,7 @@ let specialHandlersPromise;
 * requires a special handler, so we keep them out of the cold-startup graph.
 */
 function loadSpecialHandlers() {
-	specialHandlersPromise ??= import("./scrapers-D8oWspgW.mjs").then((m) => m.specialHandlers);
+	specialHandlersPromise ??= import("./scrapers-CtQrQ5kG.mjs").then((m) => m.specialHandlers);
 	return specialHandlersPromise;
 }
 /**
@@ -14483,9 +14483,10 @@ const writeSchema = type({
 * line-number prefixes (for example legacy or malformed hashline echoes).
 */
 function stripWriteContentWithPotentialLooseHeader(lines) {
-	const cleaned = stripHashlinePrefixes(lines);
-	if (cleaned !== lines) return {
-		text: cleaned.join("\n"),
+	const originalText = lines.join("\n");
+	const cleanedText = stripHashlinePrefixes(lines).join("\n");
+	if (cleanedText !== originalText) return {
+		text: cleanedText,
 		stripped: true
 	};
 	const headerIndex = lines.findIndex((line) => line.trim().length > 0);
@@ -14494,13 +14495,14 @@ function stripWriteContentWithPotentialLooseHeader(lines) {
 		stripped: false
 	};
 	const linesWithoutHeader = lines.slice(0, headerIndex).concat(lines.slice(headerIndex + 1));
-	const cleanedWithoutHeader = stripHashlinePrefixes(linesWithoutHeader);
-	if (cleanedWithoutHeader === linesWithoutHeader) return {
-		text: lines.join("\n"),
+	const textWithoutHeader = linesWithoutHeader.join("\n");
+	const cleanedWithoutHeader = stripHashlinePrefixes(linesWithoutHeader).join("\n");
+	if (cleanedWithoutHeader === textWithoutHeader) return {
+		text: originalText,
 		stripped: false
 	};
 	return {
-		text: cleanedWithoutHeader.join("\n"),
+		text: cleanedWithoutHeader,
 		stripped: true
 	};
 }

package/lib/{scrapers-D8oWspgW.mjs → scrapers-CtQrQ5kG.mjs}

@@ -3,7 +3,7 @@ __installBunShim();
 import { n as fs_promises_shim_exports } from "./fs-promises-shim-Bx0fpxuk.mjs";
 import { $ as isEnoent, B as USER_AGENT, C as warn, G as getDocsRsCacheDir, N as $env, c as combineSignals, j as formatNumber, k as formatBytes, l as exec, s as Snowflake, y as parseFrontmatter } from "./src-BwW51vA5.mjs";
 import { W as tryParseJson } from "./utils-CUPhpw9A.mjs";
-import { a as fetchBinary, c as getParallelExtractContent, i as convertWithMarkit, l as ensureTool, m as settings, n as asRecord, o as extractWithParallel, r as asString, s as findParallelApiKey, t as asNumber } from "./utils-CCfhUQen.mjs";
+import { a as fetchBinary, c as getParallelExtractContent, i as convertWithMarkit, l as ensureTool, m as settings, n as asRecord, o as extractWithParallel, r as asString, s as findParallelApiKey, t as asNumber } from "./utils-ECAwvaPQ.mjs";
 import { n as isRecord } from "./type-guards-CttAANEx.mjs";
 import { r as throwIfAborted, t as ToolAbortError } from "./tool-errors-DoyxivAR.mjs";
 import { c as getLocalizedText, d as looksLikeHtml, i as decodeHtmlEntities, l as htmlToBasicMarkdown, o as formatIsoDate, r as buildResult, s as formatMediaDuration, u as loadPage } from "./types-PVueGi9S.mjs";

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

@@ -0,0 +1,53 @@
+/**
+ * The tool-plus settings card — a collapsible disclosure card in the Plugins
+ * settings tab styled against the app's `--dsw-alias-*` design tokens and the
+ * official card interaction (header button with unsaved badge + rotating
+ * chevron, smooth expand/collapse respecting reduced-motion, staged edits that
+ * survive collapsing, one Save write, nothing rendered while the namespace is
+ * unavailable). Copy is fully localized through the slot-injected `t` seat
+ * (`locale: 'tool-plus'`), which re-renders on a locale switch.
+ *
+ * The card edits the FLAT settings surface (OMP `bash*`-style scalar keys) —
+ * the client scope only writes scalar fields — grouped as timeouts,
+ * backgrounding, output, completion truncation (subdivided into byte and line
+ * settings), and behavior. Field definitions, defaults, and copy keys come
+ * from the single-source field table (`src/config/fields.ts`), shared with
+ * the Tool Plus settings section.
+ * @module @xiaoso/dsh-tool-plus/client
+ */
+import { type ReactNode } from 'react';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { OutputRetentionMode, OutputTruncateStrategy } from '../config/settings.ts';
+/** The flat, scalar-editable fields this card edits (mirrors the settings schema). */
+export interface BashPlusSettings {
+    enableRunInBackground?: boolean;
+    autoBackgroundMs?: number;
+    defaultTimeoutMs?: number;
+    maxTimeoutMs?: number;
+    outputMaxBytes?: number;
+    outputSinkTailBytes?: number;
+    outputSinkHeadBytes?: number;
+    minimizerEnabled?: boolean;
+    interceptorEnabled?: boolean;
+    nonInteractiveEnv?: boolean;
+    snapshotEnabled?: boolean;
+    useShellCommandWrapper?: boolean;
+    maxBackgroundJobs?: number;
+    outputTruncateStrategy?: OutputTruncateStrategy;
+    outputTruncateTriggerBytes?: number;
+    outputTruncateTriggerLines?: number;
+    outputTruncateByteMode?: OutputRetentionMode;
+    outputTruncateByteHeadBytes?: number;
+    outputTruncateByteTailBytes?: number;
+    outputTruncateLineMode?: OutputRetentionMode;
+    outputTruncateLineHeadLines?: number;
+    outputTruncateLineTailLines?: number;
+}
+/** Business face the slot registration injects: the bound scope. */
+export interface BashPlusCardFace {
+    scope: SettingsScope<BashPlusSettings>;
+}
+/** Props the renderer binds: runtime seat, the `t` locale seat, and the scope face. */
+export type BashPlusCardProps = PropsRuntime<'settings.plugin.item'> & PropsLocale<'tool-plus'> & BashPlusCardFace;
+export declare function BashPlusCard(props: BashPlusCardProps): ReactNode;

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

@@ -0,0 +1,36 @@
+/**
+ * Tool Plus settings section — the plugin's own page in the Settings panel,
+ * registered into the `settings.section` slot (nav id `tool-plus`). The page
+ * renders one tab per tool (Bash / Read / Write & Edit / Grep /
+ * Ast Edit / Read Image); switching a tab shows that tool's configurable
+ * fields, while tools without global settings show a placeholder. Only the
+ * active tool's panel is rendered; the shared staged form over the
+ * `tool-plus` namespace lives at the page level, so drafts survive switching
+ * without keeping hidden panels mounted — the same flat schema the Bash card
+ * edits, from the same single-source field table.
+ *
+ * `action`-kind fields (e.g. 探测浏览器) are not part of the staged form:
+ * they run a host RPC endpoint over the official Connection channel
+ * (`/tool-plus`), with per-field running/result state kept at the page level.
+ *
+ * Tab chrome mirrors the official Plugins settings section
+ * (ui-settings-plugins): `role="tablist"` + tab/panel roles, aria wiring,
+ * and arrow/Home/End keyboard roaming.
+ *
+ * The page is pinned to the host settings pane: the heading, intro and tablist
+ * stay put, the save bar sits at the bottom, and the tab panel is the only
+ * scroller — so the scrollbar spans just the band between them.
+ * @module @xiaoso/dsh-tool-plus/client
+ */
+import { type ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import { type ToolSettingsValue } from './forms.ts';
+/** Registration-side face: the bound settings scope. */
+export interface ToolPlusSectionInjected {
+    scope: SettingsScope<ToolSettingsValue>;
+}
+/** Props the renderer binds for the section (owner + locale + injected face). */
+export type ToolPlusSectionProps = PropsRuntime<'settings.section'> & PropsLocale<'tool-plus'> & InjectFace<ToolPlusSectionInjected>;
+/** Render the Tool Plus settings section. */
+export declare function ToolPlusSection(props: ToolPlusSectionProps): ReactNode;

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

@@ -0,0 +1,42 @@
+/**
+ * Generic staged-form model over the plugin's flat settings namespace,
+ * shared by the Bash card and the Tool Plus settings section. A form stages
+ * what the user types and writes it only on save; field definitions come from
+ * the single-source table (`src/config/fields.ts`), so every surface renders
+ * the same fields with the same defaults.
+ * @module @xiaoso/dsh-tool-plus/client
+ */
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { CardShell } from '@deepseek-ai/dsh-client-ui-settings-plugins/client';
+import type { ToolPlusField } from '../config/fields.ts';
+import { type NumberControl, type SelectControl, type ToggleControl } from './rows.tsx';
+/** The flat settings document shape this form edits. */
+export type ToolSettingsValue = Record<string, number | boolean | string | undefined>;
+/** One group of controls (a Bash subgroup or a whole tool's section). */
+export interface ToolFormGroup {
+    group: string;
+    numbers: NumberControl[];
+    selects: SelectControl[];
+    toggles: ToggleControl[];
+}
+/** The form state a settings surface renders. */
+export interface ToolForm {
+    shell: CardShell;
+    /** Controls grouped by `ToolPlusField.group`, in first-appearance order. */
+    groups: ToolFormGroup[];
+    actions: {
+        edit: (field: string, text: string) => void;
+        resetField: (field: string) => void;
+        save: () => Promise<void>;
+        discard: () => void;
+    };
+    editSelect: (field: string, value: string) => void;
+    onToggle: (field: string, checked: boolean) => void;
+}
+/**
+ * Stage edits over the bound scope; only a Save writes the document.
+ * @param scope - bound settings scope for the `tool-plus` namespace.
+ * @param fields - the fields this surface edits (single-source table slice).
+ * @returns the form state and its write actions.
+ */
+export declare function useToolForm(scope: SettingsScope<ToolSettingsValue>, fields: readonly ToolPlusField[]): ToolForm;

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

@@ -0,0 +1,29 @@
+/**
+ * Tool-plus settings card, browser half. Registers the plugin's card into the
+ * Plugins settings surface's `settings.plugin.item` slot — keyed by the
+ * `tool-plus` namespace, so the configurable tab pairs it with the Host-side
+ * namespace of the same name — binds that namespace's settings scope for
+ * reads and writes, and registers the card's locale dictionaries.
+ *
+ * Only officially exported APIs are used (`dsh-client-ui-slots` slot
+ * registry, `dsh-client-locale` dictionary registration, `dsh-client-ui-settings`
+ * scope contract and binder, and the published
+ * `dsh-client-ui-settings-plugins` slot-type declaration); the card itself is
+ * this package's own, not a copy of any non-exported card internals.
+ *
+ * @module @xiaoso/dsh-tool-plus/client
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/**
+ * Settings namespace of this plugin, spelled here because a client package
+ * must not depend on a Host package — official convention: the browser half
+ * spells the same value the Host plugin registers (src/config/settings.ts).
+ */
+export declare const BASH_PLUS_CLIENT_NS = "tool-plus";
+/** Required services (cordis fiber inject): slots + locale + the settings scope binder. */
+export declare const inject: string[];
+/**
+ * Mount the tool-plus settings card.
+ * @param ctx - the browser plugin context.
+ */
+export declare function apply(ctx: ClientContext): void;

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

@@ -0,0 +1,19 @@
+/**
+ * Locale bundles for the bash-plus settings card. zh is the source of truth
+ * for the key set; en is checked complete against it — both dictionaries are
+ * `Record<BashPlusLocaleKey, string>`, so a missing or extra key in either is
+ * a compile error (the official registration enforces bilingual balance).
+ * @module @xiaoso/dsh-tool-plus/client
+ */
+export type BashPlusLocaleKey = 'title' | 'description' | 'nav' | 'pageTitle' | 'pageDescription' | 'tabBash' | 'tabRead' | 'tabWriteEdit' | 'tabGrep' | 'tabGlob' | 'tabAstGrep' | 'tabAstEdit' | 'tabReadImage' | 'groupTiming' | 'groupOutput' | 'groupTruncation' | 'groupBehavior' | 'groupReading' | 'groupSummary' | 'groupImages' | 'groupEditMode' | 'groupGuard' | 'groupGrep' | 'groupSearchDefaults' | 'groupFetch' | 'groupAst' | 'noConfigTitle' | 'noConfigHint' | 'readSummarizeEnabled' | 'readSummarizeEnabledHint' | 'readSummarizeProse' | 'readSummarizeProseHint' | 'readSummarizeMinBodyLines' | 'readSummarizeMinBodyLinesHint' | 'readSummarizeMinCommentLines' | 'readSummarizeMinCommentLinesHint' | 'readSummarizeMinTotalLines' | 'readSummarizeMinTotalLinesHint' | 'readSummarizeUnfoldUntil' | 'readSummarizeUnfoldUntilHint' | 'readSummarizeUnfoldLimit' | 'readSummarizeUnfoldLimitHint' | 'editBlockAutoGenerated' | 'editBlockAutoGeneratedHint' | 'readDefaultLimit' | 'readDefaultLimitHint' | 'readLineNumbers' | 'readLineNumbersHint' | 'readRenderMarkdown' | 'readRenderMarkdownHint' | 'readConcurrentSafe' | 'readConcurrentSafeHint' | 'editMode' | 'editModeHint' | 'editFuzzyMatch' | 'editFuzzyMatchHint' | 'editFuzzyThreshold' | 'editFuzzyThresholdHint' | 'editEnforceSeenLines' | 'editEnforceSeenLinesHint' | 'grepContextBefore' | 'grepContextBeforeHint' | 'grepContextAfter' | 'grepContextAfterHint' | 'grepCaseDefault' | 'grepCaseDefaultHint' | 'grepGitignoreDefault' | 'grepGitignoreDefaultHint' | 'globGitignoreDefault' | 'globGitignoreDefaultHint' | 'globHiddenDefault' | 'globHiddenDefaultHint' | 'astGrepEnabled' | 'astGrepEnabledHint' | 'astEditEnabled' | 'astEditEnabledHint' | 'optReplace' | 'optPatch' | 'optHashline' | 'optApplyPatch' | 'fetchEnabled' | 'fetchEnabledHint' | 'fetchMaxTimeoutSeconds' | 'fetchMaxTimeoutSecondsHint' | 'fetchReader' | 'fetchReaderHint' | 'browserReaderEnabled' | 'browserReaderEnabledHint' | 'browserProbe' | 'browserProbeHint' | 'browserProbeRunning' | 'browserProbeNone' | 'browserProbeFailed' | 'browserProbeUnavailable' | 'optReaderAuto' | 'optReaderNative' | 'optReaderTrafilatura' | 'optReaderLynx' | 'optReaderParallel' | 'optReaderJina' | 'optReaderBrowser' | 'imagesAutoResize' | 'imagesAutoResizeHint' | 'imagesBlockImages' | 'imagesBlockImagesHint' | 'imagesExcludeWebp' | 'imagesExcludeWebpHint' | 'imagesInputMaxBytes' | 'imagesInputMaxBytesHint' | 'imagesResizeMaxSide' | 'imagesResizeMaxSideHint' | 'imagesResizeMaxBytes' | 'imagesResizeMaxBytesHint' | 'imagesResizeMinSide' | 'imagesResizeMinSideHint' | 'imagesResizeJpegQuality' | 'imagesResizeJpegQualityHint' | 'autoBackgroundMs' | 'autoBackgroundMsHint' | 'defaultTimeoutMs' | 'defaultTimeoutMsHint' | 'maxTimeoutMs' | 'maxTimeoutMsHint' | 'maxBackgroundJobs' | 'maxBackgroundJobsHint' | 'outputMaxBytes' | 'outputMaxBytesHint' | 'outputSinkTailBytes' | 'outputSinkTailBytesHint' | 'outputSinkHeadBytes' | 'outputSinkHeadBytesHint' | 'minimizerEnabled' | 'minimizerEnabledHint' | 'enableRunInBackground' | 'enableRunInBackgroundHint' | 'interceptorEnabled' | 'interceptorEnabledHint' | 'nonInteractiveEnv' | 'nonInteractiveEnvHint' | 'snapshotEnabled' | 'snapshotEnabledHint' | 'rmSafe' | 'rmSafeHint' | 'rmSafeStatusInjected' | 'rmSafeStatusInjectedUnverified' | 'rmSafeStatusFailed' | 'rmSafeReasonSnapshotUnavailable' | 'rmSafeReasonCliMissing' | 'rmSafeReasonSnapshotWriteFailed' | 'rmSafeReasonRuntimeNotEffective' | 'useShellCommandWrapper' | 'useShellCommandWrapperHint' | 'outputTruncateStrategy' | 'outputTruncateStrategyHint' | 'outputTruncateTriggerBytes' | 'outputTruncateTriggerBytesHint' | 'outputTruncateTriggerLines' | 'outputTruncateTriggerLinesHint' | 'outputTruncateByteMode' | 'outputTruncateByteModeHint' | 'outputTruncateByteHeadBytes' | 'outputTruncateByteHeadBytesHint' | 'outputTruncateByteTailBytes' | 'outputTruncateByteTailBytesHint' | 'outputTruncateLineMode' | 'outputTruncateLineModeHint' | 'outputTruncateLineHeadLines' | 'outputTruncateLineHeadLinesHint' | 'outputTruncateLineTailLines' | 'outputTruncateLineTailLinesHint' | 'optBytes' | 'optLines' | 'optHead' | 'optTail' | 'optMiddle' | 'overridden' | 'reset' | 'readOnly' | 'expand' | 'collapse' | 'save' | 'saving' | 'discard' | 'unsaved' | 'saveFailed' | 'invalidNumber' | 'appliesTo';
+/** Simplified Chinese copy. */
+export declare const zh: Record<BashPlusLocaleKey, string>;
+/** English copy. */
+export declare const en: Record<BashPlusLocaleKey, string>;
+/** Merge this plugin's namespace into the slot locale table (official pattern). */
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** This plugin's own settings-card copy. */
+        'tool-plus': BashPlusLocaleKey;
+    }
+}

package/lib/types/client/rm-safe-status-text.d.ts

@@ -0,0 +1,15 @@
+/**
+ * rmSafe/status 结果 → 本地化文案的纯映射（无 React/DOM 依赖，可单测）。
+ * @module @xiaoso/dsh-tool-plus/client/rm-safe-status-text
+ */
+import type { RmSafeStatusValue } from '../tools/shared/browser-rpc-channel.ts';
+import type { BashPlusLocaleKey } from './locales.ts';
+/** Locale key of one rmSafe failure reason. */
+export declare function rmSafeReasonKey(reason: Extract<RmSafeStatusValue, {
+    status: 'failed';
+}>['reason']): BashPlusLocaleKey;
+/**
+ * Localized text of one rmSafe/status result. `disabled` maps to the empty
+ * string — the caller decides not to surface it.
+ */
+export declare function rmSafeStatusText(t: (key: BashPlusLocaleKey) => string, value: RmSafeStatusValue): string;

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

@@ -0,0 +1,107 @@
+/**
+ * Shared settings-row controls for the tool-plus settings surfaces: number
+ * input, select pill, and toggle switch rows, styled against the app's
+ * `--dsw-alias-*` design tokens. Extracted from the Bash card so the Plugins
+ * card and the Tool Plus settings section render identical controls.
+ * @module @xiaoso/dsh-tool-plus/client
+ */
+import { type ReactNode } from 'react';
+import type { BashPlusLocaleKey } from './locales.ts';
+/** One rendered number control. */
+export interface NumberControl {
+    field: string;
+    labelKey: BashPlusLocaleKey;
+    hintKey: BashPlusLocaleKey;
+    text: string;
+    overridden: boolean;
+    invalid: boolean;
+}
+/** One rendered select control. */
+export interface SelectControl {
+    field: string;
+    labelKey: BashPlusLocaleKey;
+    hintKey: BashPlusLocaleKey;
+    options: readonly {
+        value: string;
+        labelKey: BashPlusLocaleKey;
+    }[];
+    value: string;
+    overridden: boolean;
+}
+/** One rendered toggle control. */
+export interface ToggleControl {
+    field: string;
+    labelKey: BashPlusLocaleKey;
+    hintKey: BashPlusLocaleKey;
+    checked: boolean;
+    overridden: boolean;
+}
+/** One rendered action control (button that calls a host RPC endpoint). */
+export interface ActionControl {
+    field: string;
+    labelKey: BashPlusLocaleKey;
+    hintKey: BashPlusLocaleKey;
+    actionKey: string;
+}
+/**
+ * Shared row control CSS, keyed by `data-plugin-css` and injected once.
+ *
+ * Motion discipline: every moving control animates transform/opacity only
+ * (GPU-composited); color transitions fire on hover/focus state changes
+ * only. Everything is disabled under prefers-reduced-motion. All colors are
+ * `--dsw-alias-*` host tokens (or color-mix of them), so light/dark themes
+ * adapt automatically.
+ */
+export declare const SETTINGS_ROWS_CSS = "\n.tp-row{display:flex;align-items:center;gap:12px;padding:12px 0;border-bottom:1px solid var(--dsw-alias-border-l1);transition:background .16s ease}\n.tp-row:last-child{border-bottom:none}\n.tp-rowText{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px;padding-right:24px}\n.tp-rowTitle{font-size:14px;font-weight:400;line-height:22px;color:var(--dsw-alias-label-primary)}\n.tp-rowDesc{font-size:12px;font-weight:400;line-height:18px;color:var(--dsw-alias-label-tertiary)}\n.tp-badges{display:inline-flex;align-items:center;gap:8px}\n.tp-badge{display:inline-flex;align-items:center;gap:6px;padding:1px 0;font-size:11px;line-height:17px;white-space:nowrap;font-weight:500;color:var(--dsw-alias-label-tertiary)}\n.tp-badge::before{content:'';flex:none;width:5px;height:5px;border-radius:999px;background:var(--dsw-alias-state-business-primary)}\n.tp-reset{position:relative;border:none;background:none;padding:2px 0;font:inherit;font-size:12px;line-height:1.5;color:var(--dsw-alias-label-secondary);cursor:pointer;transition:color .16s ease}\n.tp-reset::after{content:'';position:absolute;left:0;right:0;bottom:0;height:1px;border-radius:1px;background:currentColor;opacity:0;transform:scaleX(.6);transform-origin:left center;transition:opacity .16s ease,transform .2s cubic-bezier(.22,1,.36,1)}\n.tp-reset:hover:not(:disabled){color:var(--dsw-alias-label-primary)}\n.tp-reset:hover:not(:disabled)::after{opacity:.6;transform:scaleX(1)}\n.tp-reset:disabled{cursor:default}\n.tp-reset:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px;border-radius:2px}\n.tp-input{flex:none;width:128px;height:34px;padding:0 11px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);font:inherit;font-size:13px;line-height:1.5;color:var(--dsw-alias-label-primary);box-sizing:border-box;transition:border-color .16s ease}\n.tp-input:hover:not(:disabled):not(:focus-visible){border-color:var(--dsw-alias-border-l3)}\n.tp-input:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:1px;border-color:var(--dsw-alias-border-l3)}\n.tp-input:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}\n.tp-input.tp-invalid{border-color:var(--dsw-alias-label-error)}\n.tp-input.tp-invalid:focus-visible{outline-color:var(--dsw-alias-state-error-primary)}\n.tp-invalidText{color:var(--dsw-alias-label-error);animation:tp-soft-in .18s ease both}\n.tp-selectAnchor{display:inline-flex;flex-shrink:0}\n.tp-selectTrigger{display:inline-flex;align-items:center;gap:8px;height:34px;padding:0 14px;border:1px solid var(--dsw-alias-border-l2);border-radius:999px;background:var(--dsw-alias-bg-module-platform);font:inherit;font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary);cursor:pointer;flex-shrink:0;transition:background .16s ease,border-color .16s ease,transform .1s ease}\n.tp-selectTrigger:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);border-color:var(--dsw-alias-border-l3)}\n.tp-selectTrigger:active:not(:disabled){transform:scale(.97)}\n.tp-selectTrigger:disabled{opacity:.55;cursor:default}\n.tp-selectTrigger:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:1px}\n.tp-selectChevron{flex:none;color:var(--dsw-alias-label-tertiary);display:inline-flex;transition:transform .2s cubic-bezier(.22,1,.36,1)}\n.tp-selectTrigger[aria-expanded=\"true\"] .tp-selectChevron{transform:rotate(180deg)}\n.tp-switch{position:relative;width:40px;height:24px;flex:none}\n.tp-switch input{position:absolute;opacity:0;width:100%;height:100%;margin:0;cursor:pointer;z-index:1}\n.tp-switchTrack{position:absolute;inset:0;border-radius:999px;background:var(--dsw-alias-border-l2);transition:background .18s ease;pointer-events:none}\n.tp-row:hover .tp-switchTrack{background:var(--dsw-alias-border-l3)}\n.tp-switch input:checked+.tp-switchTrack{background:var(--dsw-alias-brand-primary)}\n.tp-row:hover .tp-switch input:checked+.tp-switchTrack{background:var(--dsw-alias-brand-primary)}\n.tp-switch input:focus-visible+.tp-switchTrack{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}\n.tp-thumb{position:absolute;top:3px;left:3px;width:18px;height:18px;border-radius:999px;background:var(--dsw-alias-bg-layer-3);box-shadow:0 1px 3px rgba(0,0,0,.14),0 1px 1px rgba(0,0,0,.08);transition:transform .2s cubic-bezier(.34,1.3,.5,1);transform-origin:left center;pointer-events:none}\n.tp-switch input:checked~.tp-thumb{transform:translateX(16px);transform-origin:right center}\n.tp-switch input:active:not(:disabled)~.tp-thumb{transform:scaleX(1.2)}\n.tp-switch input:checked:active:not(:disabled)~.tp-thumb{transform:translateX(16px) scaleX(1.2)}\n.tp-switch input:disabled{cursor:default}\n.tp-switch input:disabled~.tp-switchTrack,.tp-switch input:disabled~.tp-thumb{opacity:.45}\n.tp-actionField{display:flex;flex-direction:column;gap:8px;padding:12px 0;border-bottom:1px solid var(--dsw-alias-border-l1)}\n.tp-actionField:last-child{border-bottom:none}\n.tp-actionHead{display:flex;align-items:center;gap:12px}\n.tp-actionInfo{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}\n.tp-actionTitle{font-size:14px;font-weight:400;line-height:22px;color:var(--dsw-alias-label-primary)}\n.tp-actionDesc{font-size:12px;font-weight:400;line-height:18px;color:var(--dsw-alias-label-tertiary)}\n.tp-actionButton{appearance:none;flex:none;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);padding:5px 14px;font:inherit;font-size:13px;line-height:1.5;color:var(--dsw-alias-label-primary);cursor:pointer;transition:background .16s ease,border-color .16s ease,transform .1s ease}\n.tp-actionButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);border-color:var(--dsw-alias-border-l3)}\n.tp-actionButton:active:not(:disabled){transform:scale(.97)}\n.tp-actionButton:disabled{opacity:.55;cursor:default}\n.tp-actionButton:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:1px}\n.tp-actionResult{margin:0;font-size:12px;line-height:1.5;white-space:pre-wrap;overflow-wrap:anywhere;animation:tp-soft-in .22s cubic-bezier(.22,1,.36,1) both}\n.tp-actionResult[data-state=\"ok\"]{color:var(--dsw-alias-label-secondary)}\n.tp-actionResult[data-state=\"error\"]{color:var(--dsw-alias-label-error)}\n@keyframes tp-soft-in{from{opacity:0;transform:translateY(4px)}to{opacity:1;transform:none}}\n@media (prefers-reduced-motion: reduce){\n  .tp-row,.tp-reset,.tp-reset::after,.tp-input,.tp-selectTrigger,.tp-selectChevron,.tp-switchTrack,.tp-thumb,.tp-actionButton{transition:none}\n  .tp-invalidText,.tp-actionResult{animation:none}\n}\n";
+export declare function injectSettingsRowsCss(): void;
+declare function hasOwn(obj: unknown, key: string): boolean;
+/**
+ * Number row: same left-text / right-control anatomy as toggle and select
+ * rows, with the input right-aligned at a fixed width. The title is wired to
+ * the input (htmlFor), so clicking the title focuses the input; the
+ * description and the rest of the row are inert — each side manages its own
+ * interaction.
+ */
+export declare function NumberRow(props: {
+    t: (key: BashPlusLocaleKey) => string;
+    control: NumberControl;
+    disabled: boolean;
+    onEdit: (field: string, text: string) => void;
+    onReset: (field: string) => void;
+}): ReactNode;
+/** Select row: Title + desc stacked on left, selector pill on right. */
+export declare function SelectRow(props: {
+    t: (key: BashPlusLocaleKey) => string;
+    control: SelectControl;
+    disabled: boolean;
+    open: boolean;
+    onOpenChange: (field: string | null) => void;
+    onEdit: (field: string, value: string) => void;
+    onReset: (field: string) => void;
+}): ReactNode;
+/** Toggle row: Title + desc stacked on left, switch on right. */
+export declare function ToggleRow(props: {
+    t: (key: BashPlusLocaleKey) => string;
+    control: ToggleControl;
+    disabled: boolean;
+    onToggle: (field: string, checked: boolean) => void;
+    onReset: (field: string) => void;
+}): ReactNode;
+/**
+ * Action row: Title + desc stacked on left, a button on the right that calls
+ * the host RPC endpoint named by `control.actionKey` (via the Connection
+ * channel; the caller owns the RPC). The result line renders below, colored
+ * by outcome (`ok` / `error`).
+ */
+export declare function ActionRow(props: {
+    t: (key: BashPlusLocaleKey) => string;
+    control: ActionControl;
+    disabled: boolean;
+    running: boolean;
+    result: {
+        ok: boolean;
+        text: string;
+    } | null;
+    onRun: (actionKey: string) => void;
+}): ReactNode;
+export { hasOwn };

package/lib/types/client/web-connection-rpc.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Browser caller for the plugin's Connection RPC channel.
+ *
+ * The official `@deepseek-ai/dsh-client-connection/client` package ships the
+ * protocol primitives as types (`RpcFetch`, `ClientConnectionRpc`, `RpcResult`)
+ * and the `RpcId` brand, but its published `createWebConnectionRpc` factory is
+ * internal to the bundle — not re-exported. This module re-implements that
+ * factory against the same public wire contract (docs/api-gateway.md, the
+ * client `rpc.ts` source): a `POST {origin}/{channel}/{endpoint}` with a
+ * `client-request` JSON envelope, answered by a `server-response` envelope
+ * echoing the rpcId. Host-side registration uses the official
+ * `ctx.connection.rpc.handle` — this file only mirrors the caller half.
+ * @module @xiaoso/dsh-tool-plus/client/web-connection-rpc
+ */
+import type { ClientConnectionRpc, RpcFetch } from '@deepseek-ai/dsh-client-connection/client';
+/**
+ * Create the browser-backed generic RPC caller for the plugin's channel
+ * (the `/tool-plus` host registration). Wire-compatible with the official
+ * ClientConnectionRpc contract; only the transport override differs.
+ * @param doFetch - transport override; defaults to the page's global fetch.
+ */
+export declare function createWebConnectionRpc(doFetch?: RpcFetch): ClientConnectionRpc;

package/lib/types/config/fields.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Tool-plus configuration single source of truth: every settable field across
+ * all ported tools (bash + read + write/edit guard), its kind, default value,
+ * UI copy keys, and its group/tool membership — plus the tool-tab map the
+ * settings page renders.
+ *
+ * This module is intentionally dependency-free (no host services): both the
+ * Host schema (`src/config/settings.ts`) and the browser settings UI
+ * (`src/client/*`) read from it, so a default or a field can never drift
+ * between the two planes. The only import is the locale key type, which is
+ * type-only and erased at build time.
+ * @module @xiaoso/dsh-tool-plus/config
+ */
+import type { BashPlusLocaleKey } from '../client/locales.ts';
+/** A scalar value a settings field can hold (mirrors the schema types). */
+export type ToolPlusFieldValue = number | boolean | string;
+/** Field control kinds the settings UI renders. */
+export type ToolPlusFieldKind = 'number' | 'boolean' | 'select' | 'action';
+/** One selectable option of a `select` field. */
+export interface ToolPlusSelectOption {
+    value: string;
+    labelKey: BashPlusLocaleKey;
+}
+/** Conditional visibility: show this field only while a condition field matches. */
+export interface ToolPlusFieldVisibility {
+    /** Show only while this boolean field is true (a master switch). */
+    requiresEnabled?: string;
+    /** Show only while this select field equals the value. */
+    requiresSelect?: {
+        field: string;
+        value: string;
+    };
+    /** Hide while this select field equals the value (e.g. hide head bytes in tail mode). */
+    hideWhenSelect?: {
+        field: string;
+        value: string;
+    };
+}
+/** One configurable field of the plugin's tools. */
+export interface ToolPlusField {
+    /** Settings namespace key (flat schema key). */
+    name: string;
+    /** Control kind the UI renders. */
+    kind: ToolPlusFieldKind;
+    /** Schema default; a cleared user field reverts to this value. */
+    default: ToolPlusFieldValue;
+    /** Locale keys for the control label and hint. */
+    labelKey: BashPlusLocaleKey;
+    hintKey: BashPlusLocaleKey;
+    /** Group id (a Bash subgroup or the whole-tool group); order = render order. */
+    group: string;
+    /** Owning tool tab. */
+    tool: ToolPlusToolId;
+    /** Options for `select` fields. */
+    options?: readonly ToolPlusSelectOption[];
+    /** Conditional visibility (master switches, strategy-dependent fields). */
+    visibility?: ToolPlusFieldVisibility;
+    /** Host RPC endpoint for `action` fields (channel-relative, e.g. `browser/detect`). */
+    actionKey?: string;
+}
+/** Tool tabs of the settings page; `fields: []` = no global settings. */
+export interface ToolPlusTab {
+    id: ToolPlusToolId;
+    labelKey: BashPlusLocaleKey;
+    /** Field names owned by this tool, in render order. */
+    fields: readonly string[];
+}
+/** Identifiers of every tool tab. */
+export type ToolPlusToolId = 'bash' | 'read' | 'writeEdit' | 'grep' | 'glob' | 'astGrep' | 'astEdit';
+/** Field group ids -> locale key of the group heading. */
+export declare const TOOL_PLUS_GROUP_LABELS: Record<string, BashPlusLocaleKey>;
+/**
+ * Every field of the plugin, in schema order. Defaults mirror
+ * `src/config/settings.ts` schema + `resolveConfig` — this table is the
+ * single source; settings.ts reads from here.
+ */
+export declare const TOOL_PLUS_FIELDS: readonly ToolPlusField[];
+/** Tool tabs in nav order; empty `fields` = no configurable settings. */
+export declare const TOOL_PLUS_TABS: readonly ToolPlusTab[];
+/** Look up one field definition by its schema key. */
+export declare function toolPlusField(name: string): ToolPlusField | undefined;
+/** Fields of one tool tab, in table order. */
+export declare function toolPlusFieldsOf(tool: ToolPlusToolId): readonly ToolPlusField[];
+/** Every schema key, for settings-schema parity tests. */
+export declare const TOOL_PLUS_FIELD_NAMES: readonly string[];

package/lib/types/config/omp-settings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * tool-plus 统一 OMP 配置注册表（单一事实源）。
+ *
+ * 所有移植工具（read/write/edit/grep/glob/ast_edit/ast_grep）的 OMP settings
+ * 键集中定义在这里：
+ * - `OMP_DEFAULTS`：每个键的默认值，verbatim 取自 OMP `config/settings-schema.ts`
+ *   （refs/oh-my-pi/packages/coding-agent/src/config/settings-schema.ts，5880 行注册表），
+ *   引擎行为与上游一致。
+ * - `OMP_KEY_TO_FIELD`：OMP dotted key → DSH tool-plus 扁平配置字段（fields.ts）
+ *   的映射；未映射的键走默认值（如 LSP/web-search/autoqa 等 DSH 不暴露的
+ *   能力，默认值兜底即可，不会降级）。
+ *
+ * 各工具 adapter 的 `config/settings.ts` / `config/settings-schema.ts` 引用
+ * 本模块，消除多份重复定义。新增配置键只改这里 + fields.ts。
+ */
+/** OMP dotted key -> flat tool-plus config field (when present). */
+export declare const OMP_KEY_TO_FIELD: Record<string, string | undefined>;
+/**
+ * OMP schema 默认值（verbatim，来源见上）。键 = OMP settings-schema.ts 的注册键。
+ */
+export declare const OMP_DEFAULTS: Record<string, unknown>;