@xiaoso/dsh-tool-plus 0.1.6 → 0.1.7-beta.1

package/lib/{stream-markup-healing-DZ6bVDxH.mjs → thinking-CiLa2LFB.mjs}

@@ -1,9 +1,7 @@
 import { installBunShim as __installBunShim } from "./bun-shim.mjs";
 __installBunShim();
-import { D as partialSuffixOverlapAny, E as FencedThinkingScanner, T as createInbandScanner } from "./utils-Cp2Mxf_U.mjs";
-import { h as isDeepseekModelIdOrName } from "./models-DRA2c_8U.mjs";
-import "./identity-HNO1Oe9B.mjs";
-//#region node_modules/.pnpm/@oh-my-pi+pi-ai@17.3.5/node_modules/@oh-my-pi/pi-ai/src/dialect/thinking.ts
+import { D as FencedThinkingScanner, O as partialSuffixOverlapAny } from "./utils-CUPhpw9A.mjs";
+//#region node_modules/.pnpm/@oh-my-pi+pi-ai@18.1.17/node_modules/@oh-my-pi/pi-ai/src/dialect/thinking.ts
 /**
 * Every dialect's in-band thinking section in its canonical `renderThinking`
 * form (see the sibling `./*.ts` scanners). {@link ThinkingInbandScanner} heals
@@ -18,7 +16,8 @@ import "./identity-HNO1Oe9B.mjs";
 const TAGS = [
 	{
 		open: "<think>",
-		close: "</think>"
+		close: "</think>",
+		impliedOpen: true
 	},
 	{
 		open: "<thinking>",
@@ -47,7 +46,10 @@ const TAGS = [
 	}
 ];
 const OPENS = TAGS.map((tag) => tag.open);
+const IMPLIED_OPEN_TAGS = TAGS.filter((tag) => tag.impliedOpen);
+const IMPLIED_OPEN_DELIMITERS = [...OPENS, ...IMPLIED_OPEN_TAGS.map((tag) => tag.close)];
 var ThinkingInbandScanner = class {
+	#impliedOpen;
 	#buffer = "";
 	#closeTag = "";
 	#thinking = "";
@@ -63,6 +65,9 @@ var ThinkingInbandScanner = class {
 	* stream — or one indented ≤3 spaces, as CommonMark allows — is recognized.
 	*/
 	#lineIndent = 0;
+	constructor(options = {}) {
+		this.#impliedOpen = options.impliedOpen === true;
+	}
 	feed(text) {
 		if (text.length === 0) return [];
 		this.#buffer += text;
@@ -127,7 +132,7 @@ var ThinkingInbandScanner = class {
 				if (this.#emitCode(final, events)) continue;
 				break;
 			}
-			const hit = scanVisible(this.#buffer, final);
+			const hit = scanVisible(this.#buffer, final, this.#impliedOpen);
 			if (hit.kind === "none") {
 				this.#emitText(this.#buffer, events);
 				this.#buffer = "";
@@ -138,6 +143,11 @@ var ThinkingInbandScanner = class {
 				this.#buffer = this.#buffer.slice(hit.index);
 				break;
 			}
+			if (hit.kind === "impliedClose") {
+				this.#buffer = this.#buffer.slice(hit.index + hit.tag.close.length);
+				events.push({ type: "impliedThinkingEnd" });
+				continue;
+			}
 			if (hit.kind === "code") {
 				const fenced = hit.ticks >= 3 && this.#lineIndent >= 0 && this.#lineIndent <= 3;
 				this.#emitText(this.#buffer.slice(hit.index, hit.index + hit.ticks), events);
@@ -217,14 +227,16 @@ var ThinkingInbandScanner = class {
 };
 /**
 * Walk idle visible text for the earliest boundary: a leaked reasoning-tag open,
-* a Markdown code-span/fence opener (a backtick run), or — when more chunks may
-* follow — a held partial delimiter at the buffer tail.
+* a bare close of an implied-open tag (when `impliedOpen`), a Markdown
+* code-span/fence opener (a backtick run), or — when more chunks may follow — a
+* held partial delimiter at the buffer tail.
 *
 * Reasoning tags win at any position so the gemini ` ```thinking ` fence is
 * healed instead of being read as a code fence. Backtick runs enter code mode so
 * a literal `<think>` inside inline code or a fenced block stays visible text.
 */
-function scanVisible(buffer, final) {
+function scanVisible(buffer, final, impliedOpen) {
+	const delimiters = impliedOpen ? IMPLIED_OPEN_DELIMITERS : OPENS;
 	for (let i = 0; i < buffer.length; i++) {
 		const tag = TAGS.find((candidate) => buffer.startsWith(candidate.open, i));
 		if (tag) return {
@@ -232,9 +244,17 @@ function scanVisible(buffer, final) {
 			index: i,
 			tag
 		};
+		if (impliedOpen) {
+			const closed = IMPLIED_OPEN_TAGS.find((candidate) => buffer.startsWith(candidate.close, i));
+			if (closed) return {
+				kind: "impliedClose",
+				index: i,
+				tag: closed
+			};
+		}
 		if (!final) {
 			const rest = buffer.slice(i);
-			if (OPENS.some((open) => open.length > rest.length && open.startsWith(rest))) return {
+			if (delimiters.some((delimiter) => delimiter.length > rest.length && delimiter.startsWith(rest))) return {
 				kind: "hold",
 				index: i
 			};
@@ -313,179 +333,4 @@ function isAllBackticks(text) {
 	return text.length > 0;
 }
 //#endregion
-//#region node_modules/.pnpm/@oh-my-pi+pi-ai@17.3.5/node_modules/@oh-my-pi/pi-ai/src/utils/stream-markup-healing.ts
-/**
-* Streaming-safe filters for leaked chat-template tool-call and thinking markup.
-*
-* Hosted models sometimes leak raw template markup into visible `content` instead
-* of returning structured events. Tool-call healing delegates to the same
-* dialect scanners used by owned in-band tool calling; this file keeps the
-* provider-facing compatibility wrapper and model/provider gating.
-*/
-const KIMI_SECTION_END = "<|tool_calls_section_end|>";
-const DSML_TOOL_CALLS_CLOSE_FULLWIDTH = "</｜DSML｜tool_calls>";
-const DSML_TOOL_CALLS_CLOSE_ASCII = "</|DSML|tool_calls>";
-/**
-* State machine that consumes streamed visible text and emits cleaned text,
-* thinking deltas, and reconstructed tool calls.
-*
-* A {@link ThinkingInbandScanner} always heals leaked reasoning idioms
-* (`<think>`, `<thinking>`, ` ```thinking `, Gemma/Harmony channels, …) out of
-* the visible channel. For Kimi / DeepSeek-DSML the provider tool-call grammar
-* runs first and its cleaned text is piped through that thinking healer, so a
-* model can leak tool-call markup and reasoning in the same stream.
-*
-* Feed only one stream channel (usually `delta.content` / `message.content`).
-* Mixing reasoning and visible text into the same instance can corrupt held-back
-* partial tag buffers.
-*/
-var StreamMarkupHealing = class {
-	#pattern;
-	/** Provider tool-call grammar (Kimi tokens / DSML envelope); absent for plain text streams. */
-	#toolScanner;
-	/** Always-on healer for leaked reasoning idioms in the visible text channel. */
-	#thinkingScanner = new ThinkingInbandScanner();
-	#sectionTerminated = false;
-	#completed = [];
-	constructor(options) {
-		this.#pattern = options.pattern;
-		this.#toolScanner = options.pattern === "kimi" ? createInbandScanner("kimi") : options.pattern === "dsml" ? createInbandScanner("xml", { xmlTagset: "dsml" }) : void 0;
-	}
-	get pattern() {
-		return this.#pattern;
-	}
-	/**
-	* Feed a chunk and return visible text only. Reconstructed tool calls are
-	* stored for {@link drainCompleted}; thinking blocks are intentionally not
-	* returned by this compatibility helper. Use {@link feedEvents} when the caller
-	* needs ordered text/thinking/tool-call events.
-	*/
-	feed(text) {
-		let clean = "";
-		for (const event of this.feedEvents(text)) if (event.type === "text") clean += event.text;
-		else if (event.type === "toolCall") this.#completed.push(event.call);
-		return clean;
-	}
-	/** Feed a chunk and return cleaned text/thinking/tool-call events in stream order. */
-	feedEvents(text) {
-		if (text.length === 0) return [];
-		this.#markSectionClosed(text);
-		if (!this.#toolScanner) return this.#convertScannerEvents(this.#thinkingScanner.feed(text));
-		return this.#convertScannerEvents(this.#healThinking(this.#toolScanner.feed(text)));
-	}
-	/**
-	* Feed a chunk and return cleaned events, excluding synthesized tool calls.
-	* Used when the upstream chunk also carries structured `tool_calls`, keeping
-	* that structured payload as the single source of truth while preserving
-	* adjacent text and thinking events.
-	*/
-	feedEventsWithoutCalls(text) {
-		const events = this.feedEvents(text);
-		let out;
-		for (let i = 0; i < events.length; i++) {
-			const event = events[i];
-			if (event.type === "toolCall") out ??= events.slice(0, i);
-			else if (out) out.push(event);
-		}
-		return out ?? events;
-	}
-	/** Drain accumulated tool calls from calls to {@link feed}. */
-	drainCompleted() {
-		if (this.#completed.length === 0) return [];
-		return this.#completed.splice(0, this.#completed.length);
-	}
-	/**
-	* Flush held-back stream-end fragments as ordered events. Partial tool-call
-	* sections/envelopes are dropped by the delegated scanners; unterminated
-	* thinking blocks are emitted as thinking, matching the previous MiniMax parser
-	* behavior.
-	*/
-	flushEvents() {
-		const tail = this.#toolScanner ? this.#healThinking(this.#toolScanner.flush()) : [];
-		tail.push(...this.#thinkingScanner.flush());
-		return this.#convertScannerEvents(tail);
-	}
-	/** Flush held-back text only. Reconstructed calls are retained for {@link drainCompleted}. */
-	flushPending() {
-		let clean = "";
-		for (const event of this.flushEvents()) if (event.type === "text") clean += event.text;
-		else if (event.type === "toolCall") this.#completed.push(event.call);
-		return clean;
-	}
-	/** True once any configured tool-call section/envelope has fully closed. */
-	get sectionClosed() {
-		return this.#sectionTerminated;
-	}
-	#markSectionClosed(text) {
-		if (this.#sectionTerminated || !this.#toolScanner) return;
-		if (this.#pattern === "kimi") {
-			this.#sectionTerminated = text.includes(KIMI_SECTION_END);
-			return;
-		}
-		this.#sectionTerminated = text.includes(DSML_TOOL_CALLS_CLOSE_FULLWIDTH) || text.includes(DSML_TOOL_CALLS_CLOSE_ASCII);
-	}
-	/**
-	* Re-scan the tool scanner's visible text through the always-on thinking
-	* healer: `text` events are healed for leaked reasoning idioms, while the tool
-	* scanner's own thinking / tool-call events pass through in stream order.
-	*/
-	#healThinking(toolEvents) {
-		const out = [];
-		for (const event of toolEvents) if (event.type === "text") out.push(...this.#thinkingScanner.feed(event.text));
-		else out.push(event);
-		return out;
-	}
-	#convertScannerEvents(events) {
-		const out = [];
-		for (const event of events) switch (event.type) {
-			case "text":
-				out.push({
-					type: "text",
-					text: event.text
-				});
-				break;
-			case "thinkingDelta":
-				if (event.delta.length > 0) out.push({
-					type: "thinking",
-					thinking: event.delta
-				});
-				break;
-			case "toolEnd": out.push({
-				type: "toolCall",
-				call: {
-					id: generateHealedToolCallId(),
-					name: event.name,
-					arguments: JSON.stringify(event.arguments)
-				}
-			});
-		}
-		return out;
-	}
-};
-function generateHealedToolCallId() {
-	return `call_${crypto.randomUUID().replace(/-/g, "").slice(0, 24)}`;
-}
-/** Cheap model/provider gate for Kimi-K2 chat-template token leaks. */
-function modelMayLeakKimiToolCalls(provider, modelId) {
-	if (provider === "kimi-code" || provider === "moonshot") return true;
-	return /kimi[-/_.]?k2/i.test(modelId);
-}
-/** Cheap model/provider gate for DeepSeek DSML envelope leaks. */
-function modelMayLeakDsmlToolCalls(provider, modelId) {
-	if (!isDeepseekModelIdOrName(modelId)) return false;
-	return provider === "ollama" || provider === "ollama-cloud" || provider === "nvidia" || provider === "deepseek" || provider === "fireworks" || provider === "nanogpt" || provider === "opencode-go" || provider === "openrouter";
-}
-/**
-* Pick the leaked-markup healer for an OpenAI-compatible / Ollama visible-text
-* stream. Kimi chat-template tokens and DeepSeek DSML envelopes need their
-* dedicated tool-call grammars; every other model uses `"thinking"`. All three
-* patterns run the generic {@link ThinkingInbandScanner}, so leaked reasoning
-* idioms (e.g. a Gemini ` ```thinking ` fence on OpenRouter) are always healed.
-*/
-function getStreamMarkupHealingPattern(provider, modelId) {
-	if (modelMayLeakKimiToolCalls(provider, modelId)) return "kimi";
-	if (modelMayLeakDsmlToolCalls(provider, modelId)) return "dsml";
-	return "thinking";
-}
-//#endregion
-export { getStreamMarkupHealingPattern as n, StreamMarkupHealing as t };
+export { ThinkingInbandScanner as t };

package/lib/{turndown-DN7ByzEI.mjs → turndown-DrX1M4WG.mjs}

@@ -1,7 +1,7 @@
 import { installBunShim as __installBunShim } from "./bun-shim.mjs";
 __installBunShim();
 import { r as __exportAll } from "./fs-promises-shim-Bx0fpxuk.mjs";
-//#region node_modules/.pnpm/@oh-my-pi+pi-utils@17.3.5/node_modules/@oh-my-pi/pi-utils/src/turndown/gfm.ts
+//#region node_modules/.pnpm/@oh-my-pi+pi-utils@18.1.17/node_modules/@oh-my-pi/pi-utils/src/turndown/gfm.ts
 function descendantElements(node, name) {
 	const matches = [];
 	for (const child of Array.from(node.children)) {
@@ -98,7 +98,7 @@ const gfm = (service) => {
 	taskListItems(service);
 };
 //#endregion
-//#region node_modules/.pnpm/@oh-my-pi+pi-utils@17.3.5/node_modules/@oh-my-pi/pi-utils/src/turndown/html.ts
+//#region node_modules/.pnpm/@oh-my-pi+pi-utils@18.1.17/node_modules/@oh-my-pi/pi-utils/src/turndown/html.ts
 const VOID_ELEMENTS = {
 	AREA: true,
 	BASE: true,
@@ -284,7 +284,7 @@ function parseHtmlFragment(html) {
 	const stack = [root];
 	for (const token of htmlTokens(html)) {
 		const parent = stack[stack.length - 1] ?? root;
-		if (token.startsWith("<!--") || /^<!/i.test(token)) continue;
+		if (token.startsWith("<!--") || token.startsWith("<!")) continue;
 		if (!token.startsWith("<")) {
 			parent.append(new HtmlText(decodeEntities(token)));
 			continue;
@@ -317,7 +317,7 @@ function serializeNode(node) {
 	return Array.from(node.childNodes).map(serializeNode).join("");
 }
 //#endregion
-//#region node_modules/.pnpm/@oh-my-pi+pi-utils@17.3.5/node_modules/@oh-my-pi/pi-utils/src/turndown/service.ts
+//#region node_modules/.pnpm/@oh-my-pi+pi-utils@18.1.17/node_modules/@oh-my-pi/pi-utils/src/turndown/service.ts
 const BLOCK_ELEMENTS = {
 	ADDRESS: true,
 	ARTICLE: true,

package/lib/{type-guards-B9VVjRDK.mjs → type-guards-CttAANEx.mjs}

@@ -1,6 +1,6 @@
 import { installBunShim as __installBunShim } from "./bun-shim.mjs";
 __installBunShim();
-//#region node_modules/.pnpm/@oh-my-pi+pi-utils@17.3.5/node_modules/@oh-my-pi/pi-utils/src/type-guards.ts
+//#region node_modules/.pnpm/@oh-my-pi+pi-utils@18.1.17/node_modules/@oh-my-pi/pi-utils/src/type-guards.ts
 function isRecord(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value);
 }

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 };