@xiaoso/dsh-tool-plus 0.1.9 → 0.1.10-beta.2

package/lib/{scrapers-mhvFrvjH.mjs → scrapers-DSArdJ6N.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-DUUqyo9y.mjs";
 import { W as tryParseJson } from "./utils-BMmwLB0f.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-eiUz9n8I.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-DA8R1_Q8.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-DT9vgZ3S.mjs";

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

@@ -27,11 +27,11 @@
  */
 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 { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import { type ToolSettingsValue } from './forms.ts';
-/** Registration-side face: the bound settings scope. */
+/** Registration-side face: the `tool-plus` entry's shared configuration form. */
 export interface ToolPlusSectionInjected {
-    scope: SettingsScope<ToolSettingsValue>;
+    form: ConfigForm<ToolSettingsValue>;
 }
 /** Props the renderer binds for the section (owner + locale + injected face). */
 export type ToolPlusSectionProps = PropsRuntime<'settings.section'> & PropsLocale<'tool-plus'> & InjectFace<ToolPlusSectionInjected>;

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

@@ -6,8 +6,8 @@
  * 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 { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { SettingsFormShell } from '@deepseek-ai/dsh-client-ui-primitives';
 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. */
@@ -21,7 +21,7 @@ export interface ToolFormGroup {
 }
 /** The form state a settings surface renders. */
 export interface ToolForm {
-    shell: CardShell;
+    shell: SettingsFormShell;
     /** Controls grouped by `ToolPlusField.group`, in first-appearance order. */
     groups: ToolFormGroup[];
     actions: {
@@ -34,9 +34,9 @@ export interface ToolForm {
     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.
+ * Stage edits over the shared configuration form; only a Save writes the document.
+ * @param scope - the `tool-plus` entry's shared configuration form (`ctx.configForms`).
  * @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;
+export declare function useToolForm(scope: ConfigForm<ToolSettingsValue>, fields: readonly ToolPlusField[]): ToolForm;

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

@@ -1,15 +1,32 @@
 /**
- * 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.
+ * Tool-plus settings surface, browser half: the plugin's own Settings
+ * navigation page and the binding of the `tool-plus` namespace it reads and
+ * writes.
  *
- * 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.
+ * dsh 0.1.7 replaced the settings surface contract this file used to speak:
+ *
+ *  - `ctx.settingsScope.bind(...)` (the removed `SettingsScope` binder) is now
+ *    `ctx.configForms.get(ns)` — the settings domain's shared configuration
+ *    form for one Host entry, keyed by the settings namespace (the entry's own
+ *    id, which this package spells `tool-plus` because a client package must
+ *    not depend on the Host package that registers it);
+ *  - the keyed `settings.plugin.item` card slot is gone. Its 0.1.7
+ *    replacement — a tab inside the official Plugins section
+ *    (`settings.plugins.tab`) — is deliberately NOT used: this plugin already
+ *    ships a full Settings page of its own (`settings.section`, id
+ *    `tool-plus`) that carries every tool's configuration, so a second entry
+ *    point inside the Plugins page would only duplicate it and split the one
+ *    form across two surfaces;
+ *  - the page registers through `configForms.whileServed([ns], ...)`, so a
+ *    deployment whose Host does not serve the `tool-plus` namespace shows no
+ *    trace of it (the official rule: a page for a namespace nobody serves is
+ *    never dispatched).
+ *
+ * The navigation page (`settings.section`, id `tool-plus`) keeps its order
+ * right after the Plugins section. Only officially exported APIs are used (the
+ * `dsh-client-ui-slots` slot registry, the `dsh-client-locale` dictionary
+ * registration, the `dsh-client-ui-settings` configuration forms, and this
+ * package's own section component).
  *
  * @module @xiaoso/dsh-tool-plus/client
  */
@@ -20,10 +37,10 @@ import type { Context as ClientContext } from '@deepseek-ai/cordis';
  * 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. */
+/** Required services (cordis fiber inject): slots + locale + the shared configuration forms. */
 export declare const inject: string[];
 /**
- * Mount the tool-plus settings card.
+ * Mount the tool-plus settings page.
  * @param ctx - the browser plugin context.
  */
 export declare function apply(ctx: ClientContext): void;

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

@@ -5,7 +5,7 @@
  * a compile error (the official registration enforces bilingual balance).
  * @module @xiaoso/dsh-tool-plus/client
  */
-export type BashPlusLocaleKey = 'title' | 'description' | 'nav' | 'pageTitle' | 'pageDescription' | 'tabWeb' | 'tabBash' | 'tabRead' | 'tabWriteEdit' | 'tabGrep' | 'tabGlob' | 'tabAstGrep' | 'tabAstEdit' | 'tabReadImage' | 'groupCards' | 'groupTiming' | 'groupOutput' | 'groupTruncation' | 'groupBehavior' | 'groupReading' | 'groupSummary' | 'groupImages' | 'groupEditMode' | 'groupGuard' | 'groupGrep' | 'groupSearchDefaults' | 'groupFetch' | 'groupAst' | 'groupPresets' | 'presetNoteBroken' | 'presetNoteUnrecognized' | 'presetPickPreset' | 'presetPickTemplate' | 'presetToolOk' | 'presetToolWarn' | 'presetToolError' | 'presetToolLoading' | 'presetCompareOk' | 'presetCompareWarn' | 'presetCompareError' | 'presetCompareLoading' | 'presetDiffOpen' | 'presetDiffTitle' | 'presetDiffHint' | 'presetDiffClose' | 'presetDiffColumnPath' | 'presetDiffColumnYours' | 'presetDiffColumnTemplate' | 'presetDiffAbsent' | 'presetDiffWholeRow' | 'presetDiffEmpty' | 'presetActionUpdate' | 'presetActionUpdateHint' | 'presetActionUpdateNothing' | 'presetActionReset' | 'presetActionResetHint' | 'presetActionWorking' | 'presetPendingReset' | 'presetPendingInstall' | 'presetPendingRows' | 'presetConfirmReset' | 'presetConfirmInstall' | 'presetConfirmYes' | 'presetConfirmNo' | 'presetResultDone' | 'presetResultRows' | 'presetResultNoChange' | 'presetResultFailed' | 'presetResultResetDone' | 'presetResultResetNoChange' | 'presetResultBackup' | 'presetFailUnknown' | 'presetEntryCommand' | 'presetEntryPwsh' | 'presetEntryFiles' | 'presetEntrySearch' | 'presetListSeparator' | 'presetLoading' | 'presetUnavailable' | 'presetEmpty' | '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' | 'webCards' | 'webCardsHint' | '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';
+export type BashPlusLocaleKey = 'title' | 'description' | 'nav' | 'pageTitle' | 'pageDescription' | 'tabWeb' | 'tabBash' | 'tabRead' | 'tabWriteEdit' | 'tabGrep' | 'tabGlob' | 'tabAstGrep' | 'tabAstEdit' | 'tabReadImage' | 'groupCards' | 'groupTiming' | 'groupOutput' | 'groupTruncation' | 'groupBehavior' | 'groupReading' | 'groupSummary' | 'groupImages' | 'groupEditMode' | 'groupGuard' | 'groupGrep' | 'groupSearchDefaults' | 'groupFetch' | 'groupAst' | 'groupPresets' | 'presetNoteBroken' | 'presetNoteUnrecognized' | 'presetNoteNoRow' | 'presetNoteOther' | 'presetNoteCustomized' | 'presetNoteNoProfile' | 'presetNoteLegacy' | 'presetPickPreset' | 'presetPickTemplate' | 'presetToolOk' | 'presetToolWarn' | 'presetToolError' | 'presetToolLoading' | 'presetCompareOk' | 'presetCompareWarn' | 'presetCompareError' | 'presetCompareLoading' | 'presetDiffOpen' | 'presetDiffTitle' | 'presetDiffHint' | 'presetDiffClose' | 'presetDiffColumnPath' | 'presetDiffColumnYours' | 'presetDiffColumnTemplate' | 'presetDiffAbsent' | 'presetDiffWholeRow' | 'presetDiffEmpty' | 'presetActionUpdate' | 'presetActionUpdateHint' | 'presetActionUpdateNothing' | 'presetActionAlign' | 'presetActionAlignHint' | 'presetActionRevert' | 'presetActionRevertHint' | 'presetActionWorking' | 'presetPendingRows' | 'presetPendingBroken' | 'presetConfirmTitle' | 'presetConfirmAlign' | 'presetConfirmAlignEdits' | 'presetConfirmRevert' | 'presetConfirmYes' | 'presetConfirmNo' | 'presetResultDone' | 'presetResultRows' | 'presetResultNoChange' | 'presetResultFailed' | 'presetResultAlignDone' | 'presetResultAlignNoChange' | 'presetResultRevertDone' | 'presetResultRevertNoChange' | 'presetFailUnknown' | 'presetResultBackup' | 'presetEntryCommand' | 'presetEntryPwsh' | 'presetEntryFiles' | 'presetEntrySearch' | 'presetListSeparator' | 'presetLoading' | 'presetUnavailable' | 'presetEmpty' | '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' | 'webCards' | 'webCardsHint' | '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. */

package/lib/types/client/preset-panel.d.ts

@@ -1,9 +1,16 @@
 /**
- * 预设面板的纯映射层：把 `presets/status` / `presets/apply` 的返回值翻成本地化
- * 文案、可用动作与差异摘要。零 React、零 DOM、零 I/O —— 由
- * `tests/unit/preset-panel.spec.ts` 单独覆盖，UI（`PresetPanel.tsx`）只做渲染。
+ * 预设面板的纯映射层：把 `presets/status` / `presets/apply` / `presets/compare`
+ * 的返回值翻成本地化文案、可用动作与差异摘要。零 React、零 DOM、零 I/O ——
+ * 由 `tests/unit/preset-panel.spec.ts` 单独覆盖，UI（`PresetPanel.tsx`）只做渲染。
+ *
+ * 语义基线（dsh 0.1.7 起，别再按旧目录机制理解）：
+ * - 预设是 profile 配置里的一条 `@deepseek-ai/dsh-agent-preset` 声明行；
+ * - "没被改动过" = 这一行在 profile 补丁里**没有** `config`（`customized === false`）；
+ * - 三个动作：`upgrade` 只禁冲突行、`align` 用所选模板整份替换 plugins、
+ *   `revert` 删掉覆盖回落到随包声明；
+ * - 本插件只**声明**两个预设（{@link BUNDLED_PRESET_IDS}）；别的 preset 归别人，
+ *   面板最多替它修冲突行，不改它的内容。
  *
- * 契约来源：`docs/superpowers/specs/2026-09-17-preset-upgrade-design.md` §4.2/§7。
  * 类型与端点名直接取自共享契约模块 `src/tools/shared/browser-rpc-channel.ts`
  * （两半同一个来源，客户端这一侧不复制一份会漂移的定义）。
  * @module @xiaoso/dsh-tool-plus/client/preset-panel
@@ -14,15 +21,15 @@ import type { BashPlusLocaleKey } from './locales.ts';
 export { BUNDLED_PRESET_IDS };
 /** 端点名（共享契约常量，见模块注释）。 */
 export { PRESET_ACTION_ENDPOINT, PRESET_COMPARE_ENDPOINT, PRESET_STATUS_ENDPOINT };
-/** 预设来源：我们的随包模板 / 用户根 / 官方随附。 */
+/** 预设来源：本插件声明的 / 别人声明的。 */
 export type PresetSource = PresetSourceValue;
 /** 一个预设的完整状态（`presets/status` 的一项）。 */
 export type PresetStatus = PresetStatusValue;
 /** `presets/status` 的返回值。 */
 export type PresetStatusResult = PresetStatusListValue;
-/** 一个预设动作：`upgrade` = 只改冲突行；`reset` = 整份对齐当前模板。 */
+/** 一个预设动作：`upgrade` 只禁冲突行；`align` 整份对齐模板；`revert` 回落到随包声明。 */
 export type PresetAction = PresetActionValue;
-/** 与自带模板的一处具体差异。 */
+/** 与随包声明的一处具体差异。 */
 export type PresetDelta = PresetDeltaValue;
 /** 可选模板（面板"对比模板"下拉的一项）。 */
 export type PresetTemplate = PresetTemplateValue;
@@ -32,22 +39,17 @@ export type PresetCompare = PresetCompareValue;
 export type PresetActionChange = PresetChangeValue;
 /** `presets/apply` 的返回值。 */
 export type PresetActionResult = PresetActionResultValue;
-/**
- * roster 缺席我们随包的两份时补出「未安装」行（不改变 roster 原有顺序，
- * 补出的行按 {@link BUNDLED_PRESET_IDS} 顺序排在前面）。
- */
-export declare function mergeBundledPresets(presets: readonly PresetStatus[]): PresetStatus[];
 /**
  * 下拉里一次只看一个预设时的默认选中项：随包的那份（{@link BUNDLED_PRESET_IDS}
  * 的第一项）在场就选它，否则退清单第一项；空清单返回 undefined。
  */
 export declare function initialPresetId(presets: readonly PresetStatus[]): string | undefined;
 /**
- * 当前选中项在重拉状态后可能已经消失（预设被删、改名、roster 变化）：仍在场就
- * 保留，否则回落到 {@link initialPresetId}，避免下拉指向一个不存在的选项。
+ * 当前选中项在重拉状态后可能已经消失（声明被移除、roster 变化）：仍在场就保留，
+ * 否则回落到 {@link initialPresetId}，避免下拉指向一个不存在的选项。
  */
 export declare function resolveSelectedPresetId(presets: readonly PresetStatus[], current: string | undefined): string | undefined;
-/** 下拉选项文案：优先展示 name（preset.yml 的显示名），缺了就退 id。 */
+/** 下拉选项文案：优先展示 name（声明里的显示名），缺了就退 id。 */
 export declare function presetOptionLabel(preset: PresetStatus): string;
 /**
  * 状态点色调：绿 = 正常（不用管），黄 = 有需要处理的东西，红 = 读不到/无法比较。
@@ -69,13 +71,13 @@ export interface PresetIndicator {
 export declare function presetToolIndicator(t: (key: BashPlusLocaleKey) => string, compare: PresetCompareValue | null): PresetIndicator;
 /**
  * 状态点 ②（完整比较）：这份预设的内容与我们选中的模板差多少 ——
- * 不只是工具开关，整份组合文件都算。
+ * 不只是工具开关，整份插件行列表都算。
  * @param t - 文案表。
  * @param compare - 当前比较结果；尚未返回时给"正在比较"的黄点。
  * @returns 状态点。
  */
 export declare function presetCompareIndicator(t: (key: BashPlusLocaleKey) => string, compare: PresetCompareValue | null): PresetIndicator;
-/** 差异弹窗的一行：点号路径 + 两侧的值（缺失/整行用本地化占位）。 */
+/** 差异弹窗的一行：路径 + 两侧的值（缺失/整行用本地化占位）。 */
 export interface PresetDiffRow {
     path: string;
     /** 这份预设的值。 */
@@ -84,7 +86,7 @@ export interface PresetDiffRow {
     template: string;
 }
 /**
- * 差异弹窗的行：把比较结果翻成"路径 / 两份预设各自的值"三列。
+ * 差异弹窗的行：把比较结果翻成"路径 / 两份各自的值"三列。
  * 值缺失或整行差异都给出占位词，让用户一眼看出哪边没有。
  * @param t - 文案表。
  * @param compare - 当前比较结果。
@@ -94,10 +96,10 @@ export declare function presetDiffRows(t: (key: BashPlusLocaleKey) => string, co
 /** 模板下拉的选项文案：优先显示模板自报的名字，缺了退 id。 */
 export declare function presetTemplateLabel(template: PresetTemplate): string;
 /**
- * 选中的模板：①选中的预设自己有同名模板就用它（`tool-plus-ptc` 就该比
- * `tool-plus-ptc`）；②否则退随包的第一份模板（`BUNDLED_PRESET_IDS[0]`，即
- * `tool-plus-standard`，别按目录名排序撞上 ptc）；③再不行才退清单第一项。
- * 清单为空返回 undefined。
+ * 选中的模板：①手动选过且仍在场就用它；②否则选与当前预设**同名**的那份
+ * （`tool-plus-ptc` 就该比 `tool-plus-ptc`）；③再退随包的第一份
+ * （`BUNDLED_PRESET_IDS[0]`，即 `tool-plus-standard`，别按目录名排序撞上 ptc）；
+ * ④最后退清单第一项。清单为空返回 undefined。
  * @param templates - 可选模板清单。
  * @param current - 当前选中的模板 id。
  * @param presetId - 当前选中的预设 id（同名模板优先）。
@@ -105,62 +107,72 @@ export declare function presetTemplateLabel(template: PresetTemplate): string;
  */
 export declare function resolveSelectedTemplateId(templates: readonly PresetTemplate[], current: string | undefined, presetId: string | undefined): string | undefined;
 /**
- * 补充说明行：读取失败原因、无法识别的内容。差异不再在这里铺开 ——
- * 它进了「查看差异」弹窗，正文只留两个状态点。
+ * 补充说明行：为什么读不到、这个 preset 归谁、以及"你改过它"这件事。
+ * 差异不在这里铺开 —— 它进了「查看差异」弹窗，正文只留状态点与必要解释。
  * @param t - 文案表。
  * @param status - 该预设的状态。
+ * @param writable - 本部署有没有可编辑的 profile。
  * @returns 要渲染的说明行（可能为空）。
  */
-export declare function presetNotes(t: (key: BashPlusLocaleKey) => string, status: PresetStatus): string[];
+export declare function presetNotes(t: (key: BashPlusLocaleKey) => string, status: PresetStatus, writable?: boolean): string[];
 /**
  * 该预设可执行的动作，按渲染顺序。
  *
- * - 官方随附预设一律无动作（写不了，它的只读语义由"没有按钮"表达，不再用徽标）；
- * - 其余预设都给两个动作：`upgrade`（最小更新：只禁用冲突行）与 `reset`
- *   （用**所选模板**整份覆盖）；
- * - 读不了、无法识别时只剩 `reset` —— 整份覆盖是唯一能修的办法，最小更新会拒绝。
+ * - 本部署没有可编辑 profile（`writable === false`）→ 一个动作都不给；
+ * - 这一行不可寻址（`entryId` 缺席）→ 一个动作都不给（写了也没地方落）；
+ * - **别人的** preset → 只给 `upgrade`（我们只该修冲突行，不该替别人重写内容）；
+ * - **我们的** preset → `upgrade` + `align`；有覆盖时再加 `revert`；
+ * - 内容不可识别时 `upgrade` 没有意义（它要逐行判定），只给 `align` / `revert`。
  * @param status - 该预设的状态。
+ * @param writable - 本部署有没有可编辑的 profile。
  * @returns 动作清单。
  */
-export declare function presetActions(status: PresetStatus): PresetAction[];
-/** 动作按钮文案：两个动作都面向所有可写预设，文案不再区分来源。 */
+export declare function presetActions(status: PresetStatus, writable?: boolean): PresetAction[];
+/** 动作按钮文案。 */
 export declare function presetActionText(t: (key: BashPlusLocaleKey) => string, action: PresetAction): string;
+/** 需要二次确认的动作：两个会动到用户已有内容的动作。 */
+export declare function presetActionNeedsConfirm(action: PresetAction): boolean;
 /**
  * 动作按钮的悬浮说明：讲清这个按钮**具体会做什么**，以及当前状态下有没有意义。
  * 用户要求"一眼看出含义"：需要更新时说清改哪几行，不需要更新时也要明说无需更新。
  * @param t - 文案表。
  * @param action - 该按钮的动作。
  * @param status - 该预设状态（决定"要不要更新"）。
- * @param templateLabel - 当前所选模板的显示名（重置提示里点名它是哪份）。
+ * @param templateLabel - 当前所选模板的显示名（对齐提示里点名它是哪份）。
  * @returns 悬浮提示文案。
  */
 export declare function presetActionHint(t: (key: BashPlusLocaleKey) => string, action: PresetAction, status: PresetStatus, templateLabel: string): string;
 /** 冲突行 id → 面向使用者的名字列表（保序、不去重）。 */
 export declare function presetConflictNames(t: (key: BashPlusLocaleKey) => string, conflicts: readonly string[]): string[];
 /**
- * 重置的二次确认文案。还没安装（含 roster 缺席补出的行）时没有本地改动可丢，
- * 不能拿"会覆盖本地改动"吓人；其余情况按覆盖风险如实提示。两种情况都点名
- * 用的是**哪份模板**：重置的来源是用户在「对比模板」里选的那份。
+ * 二次确认文案。两个动作都会动到用户可能已经改过的内容，所以必须说清后果，
+ * 并且**点名写入位置**——这是本插件唯一会改用户 profile 配置的地方。
  * @param t - 文案表。
  * @param status - 该预设状态。
+ * @param action - 待确认的动作。
  * @param templateLabel - 所选模板的显示名。
  * @returns 确认文案。
  */
-export declare function presetConfirmText(t: (key: BashPlusLocaleKey) => string, status: PresetStatus, templateLabel: string): string;
+export declare function presetConfirmText(t: (key: BashPlusLocaleKey) => string, status: PresetStatus, action: PresetAction, templateLabel: string): string;
 /**
- * 执行前摘要：将要改哪几行 / 将写入什么。**没事可做时返回 null**（不渲染这一行）——
- * 用户明确要求去掉「工具行都已禁用，无需调整。」这种"没有信息量的状态句"。
+ * 执行前摘要：**当前状态**下有什么需要处理的。没事可做时返回 null
+ * （不渲染这一行）——用户明确要求去掉"工具行都已禁用，无需调整。"这种没有
+ * 信息量的状态句。
  * @param t - 文案表。
  * @param status - 该预设状态。
  * @returns 摘要文案，或 null（无需渲染）。
  */
 export declare function presetPendingText(t: (key: BashPlusLocaleKey) => string, status: PresetStatus): string | null;
 /**
- * 执行后结果：成功（改了几处、改了哪几处、是否留了备份）/ 无变化 / 失败原因。
+ * 执行后结果：成功（改了几处、改了哪几处）/ 无变化 / 失败原因。
  * 多行文本，`\n` 分段；调用方的结果行按 `white-space: pre-wrap` 渲染。
  *
- * `action` 必须传：宿主只在 `upgrade` 时返回逐行改动（`reset` 是整份覆盖，
- * `changes` 恒为空），所以重置不能套用"调整了 N 行"的句式 —— 否则会渲染成
- * "调整了 0 处"这种假话。
+ * `action` 必须传：宿主只在 `upgrade` 时返回逐行改动（`align` 是整份替换、
+ * `revert` 是删覆盖，两者的 `changes` 恒为空），所以它们不能套用"调整了 N 行"
+ * 的句式 —— 否则会渲染成"调整了 0 处"这种假话。
+ * @param t - 文案表。
+ * @param result - 宿主返回的执行结果。
+ * @param action - 刚执行的动作。
+ * @returns 结果文案。
  */
 export declare function presetResultText(t: (key: BashPlusLocaleKey) => string, result: PresetActionResult, action: PresetAction): string;

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

@@ -1,16 +1,35 @@
 /**
- * Plugin-owned settings surface for the ported bash tool: the `bash-plus`
- * namespace, a FLAT settings schema (OMP `bash*`-style scalar keys — the
- * client scope writes scalar fields only), its defaults, the mapping onto the
- * nested {@link RuntimeConfig} the runtime consumes, and the optional-settings
- * consumer wiring. Keeping the whole config-export surface here lets the
- * ported OMP runtime stay pristine — the entry only calls
+ * Plugin-owned settings surface for the ported bash tool: the `tool-plus`
+ * namespace, a FLAT settings schema (OMP `bash*`-style scalar keys — the shared
+ * client configuration form writes scalar fields only), its defaults, the
+ * mapping onto the nested {@link RuntimeConfig} the runtime consumes, and the
+ * optional-settings consumer wiring. Keeping the whole config-export surface
+ * here lets the ported OMP runtime stay pristine — the entry only calls
  * {@link installBashPlusSettings} and re-exports this module's `Config`.
  * @module @xiaoso/dsh-tool-plus/settings
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { MinimizerConfig } from '../tools/bash/types.ts';
+/**
+ * The Loader commits a settings write into this plugin's live config
+ * references and announces the changed paths on the owning fiber
+ * (`@deepseek-ai/cordis-plugin-loader` declares this event). The declaration
+ * lives in the Loader package, which a business plugin does not depend on, so
+ * the one event this module consumes is spelled here — copied verbatim from the
+ * Loader's own declaration, so a future signature change fails loudly here
+ * instead of silently missing the notification.
+ */
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /**
+         * Volatile config values were committed into the running fiber without a remount; dispatched to the owning fiber only.
+         * @param paths - changed config paths as key arrays; every value is committed before dispatch.
+         * @mode emit
+         */
+        'loader/volatile-update'(paths: readonly (readonly string[])[]): void;
+    }
+}
 /** Truncation strategy for background→foreground completion messages (OMP config parity). */
 export type OutputTruncateStrategy = 'bytes' | 'lines';
 /** Retention mode for a truncated completion message: head, tail, or middle (head+tail). */
@@ -125,8 +144,9 @@ export declare const DEFAULT_AUTO_BACKGROUND_MS = 60000;
 export declare const DEFAULT_MAX_BACKGROUND_JOBS = 15;
 /**
  * Plugin settings, one scalar key per option — every field is writable through
- * the client `SettingsScope.set`/`unset`. Defaults live in the {@link Config}
- * schema and in {@link resolveConfig}.
+ * the shared client configuration form (`ctx.configForms.get('tool-plus')`
+ * `.set`/`.unset`). Defaults live in the {@link Config} schema and in
+ * {@link resolveConfig}.
  */
 export interface Config {
     enableRunInBackground?: boolean;
@@ -193,28 +213,189 @@ export interface Config {
     imagesResizeJpegQuality?: number;
 }
 /**
- * Runtime configuration schema for the plugin. The namespace resolves through
- * this flat surface; {@link resolveConfig} maps it onto {@link RuntimeConfig}.
+ * Runtime configuration schema for the plugin, in the dsh 0.1.7 settings shape:
+ * EVERY field is declared `.volatile()`, because a settings namespace is the
+ * plugin's own entry and `SettingsForms.describe()` serves exactly the fields
+ * whose schema declares them live. {@link resolveConfig} maps the flat surface
+ * onto {@link RuntimeConfig}.
+ *
+ * The annotation is deliberately inferred rather than written as `z<Config>`:
+ * the schema's parsed output is {@link LiveConfig} (one stable reference per
+ * field), while {@link Config} stays the plain settings DOCUMENT the browser
+ * edits and the specs pass in.
+ */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    enableRunInBackground: z<boolean, boolean, "volatile-defined">;
+    autoBackgroundMs: z<number, number, "volatile-defined">;
+    defaultTimeoutMs: z<number, number, "volatile-defined">;
+    maxTimeoutMs: z<number, number, "volatile-defined">;
+    outputMaxBytes: z<number, number, "volatile-defined">;
+    outputSinkTailBytes: z<number, number, "volatile-defined">;
+    outputSinkHeadBytes: z<number, number, "volatile-defined">;
+    minimizerEnabled: z<boolean, boolean, "volatile-defined">;
+    interceptorEnabled: z<boolean, boolean, "volatile-defined">;
+    nonInteractiveEnv: z<boolean, boolean, "volatile-defined">;
+    snapshotEnabled: z<boolean, boolean, "volatile-defined">;
+    rmSafe: z<boolean, boolean, "volatile-defined">;
+    useShellCommandWrapper: z<boolean, boolean, "volatile-defined">;
+    webCards: z<boolean, boolean, "volatile-defined">;
+    maxBackgroundJobs: z<number, number, "volatile-defined">;
+    outputTruncateStrategy: z<"lines" | "bytes", "lines" | "bytes", "volatile-defined">;
+    outputTruncateTriggerBytes: z<number, number, "volatile-defined">;
+    outputTruncateTriggerLines: z<number, number, "volatile-defined">;
+    outputTruncateByteMode: z<"middle" | "head" | "tail", "middle" | "head" | "tail", "volatile-defined">;
+    outputTruncateByteHeadBytes: z<number, number, "volatile-defined">;
+    outputTruncateByteTailBytes: z<number, number, "volatile-defined">;
+    outputTruncateLineMode: z<"middle" | "head" | "tail", "middle" | "head" | "tail", "volatile-defined">;
+    outputTruncateLineHeadLines: z<number, number, "volatile-defined">;
+    outputTruncateLineTailLines: z<number, number, "volatile-defined">;
+    editBlockAutoGenerated: z<boolean, boolean, "volatile-defined">;
+    readSummarizeEnabled: z<boolean, boolean, "volatile-defined">;
+    readSummarizeProse: z<boolean, boolean, "volatile-defined">;
+    readSummarizeMinBodyLines: z<number, number, "volatile-defined">;
+    readSummarizeMinCommentLines: z<number, number, "volatile-defined">;
+    readSummarizeMinTotalLines: z<number, number, "volatile-defined">;
+    readSummarizeUnfoldUntil: z<number, number, "volatile-defined">;
+    readSummarizeUnfoldLimit: z<number, number, "volatile-defined">;
+    editMode: z<"replace" | "patch" | "hashline" | "apply_patch", "replace" | "patch" | "hashline" | "apply_patch", "volatile-defined">;
+    editFuzzyMatch: z<boolean, boolean, "volatile-defined">;
+    editFuzzyThreshold: z<number, number, "volatile-defined">;
+    editEnforceSeenLines: z<boolean, boolean, "volatile-defined">;
+    readDefaultLimit: z<number, number, "volatile-defined">;
+    readLineNumbers: z<boolean, boolean, "volatile-defined">;
+    readRenderMarkdown: z<boolean, boolean, "volatile-defined">;
+    readConcurrentSafe: z<boolean, boolean, "volatile-defined">;
+    grepContextBefore: z<number, number, "volatile-defined">;
+    grepContextAfter: z<number, number, "volatile-defined">;
+    grepCaseDefault: z<boolean, boolean, "volatile-defined">;
+    grepGitignoreDefault: z<boolean, boolean, "volatile-defined">;
+    globGitignoreDefault: z<boolean, boolean, "volatile-defined">;
+    globHiddenDefault: z<boolean, boolean, "volatile-defined">;
+    astGrepEnabled: z<boolean, boolean, "volatile-defined">;
+    astEditEnabled: z<boolean, boolean, "volatile-defined">;
+    fetchEnabled: z<boolean, boolean, "volatile-defined">;
+    fetchMaxTimeoutSeconds: z<number, number, "volatile-defined">;
+    fetchReader: z<"trafilatura" | "lynx" | "auto" | "native" | "parallel" | "jina" | "browser", "trafilatura" | "lynx" | "auto" | "native" | "parallel" | "jina" | "browser", "volatile-defined">;
+    browserReaderEnabled: z<boolean, boolean, "volatile-defined">;
+    imagesAutoResize: z<boolean, boolean, "volatile-defined">;
+    imagesBlockImages: z<boolean, boolean, "volatile-defined">;
+    imagesExcludeWebp: z<boolean, boolean, "volatile-defined">;
+    imagesInputMaxBytes: z<number, number, "volatile-defined">;
+    imagesResizeMaxSide: z<number, number, "volatile-defined">;
+    imagesResizeMaxBytes: z<number, number, "volatile-defined">;
+    imagesResizeMinSide: z<number, number, "volatile-defined">;
+    imagesResizeJpegQuality: z<number, number, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    enableRunInBackground: z<boolean, boolean, "volatile-defined">;
+    autoBackgroundMs: z<number, number, "volatile-defined">;
+    defaultTimeoutMs: z<number, number, "volatile-defined">;
+    maxTimeoutMs: z<number, number, "volatile-defined">;
+    outputMaxBytes: z<number, number, "volatile-defined">;
+    outputSinkTailBytes: z<number, number, "volatile-defined">;
+    outputSinkHeadBytes: z<number, number, "volatile-defined">;
+    minimizerEnabled: z<boolean, boolean, "volatile-defined">;
+    interceptorEnabled: z<boolean, boolean, "volatile-defined">;
+    nonInteractiveEnv: z<boolean, boolean, "volatile-defined">;
+    snapshotEnabled: z<boolean, boolean, "volatile-defined">;
+    rmSafe: z<boolean, boolean, "volatile-defined">;
+    useShellCommandWrapper: z<boolean, boolean, "volatile-defined">;
+    webCards: z<boolean, boolean, "volatile-defined">;
+    maxBackgroundJobs: z<number, number, "volatile-defined">;
+    outputTruncateStrategy: z<"lines" | "bytes", "lines" | "bytes", "volatile-defined">;
+    outputTruncateTriggerBytes: z<number, number, "volatile-defined">;
+    outputTruncateTriggerLines: z<number, number, "volatile-defined">;
+    outputTruncateByteMode: z<"middle" | "head" | "tail", "middle" | "head" | "tail", "volatile-defined">;
+    outputTruncateByteHeadBytes: z<number, number, "volatile-defined">;
+    outputTruncateByteTailBytes: z<number, number, "volatile-defined">;
+    outputTruncateLineMode: z<"middle" | "head" | "tail", "middle" | "head" | "tail", "volatile-defined">;
+    outputTruncateLineHeadLines: z<number, number, "volatile-defined">;
+    outputTruncateLineTailLines: z<number, number, "volatile-defined">;
+    editBlockAutoGenerated: z<boolean, boolean, "volatile-defined">;
+    readSummarizeEnabled: z<boolean, boolean, "volatile-defined">;
+    readSummarizeProse: z<boolean, boolean, "volatile-defined">;
+    readSummarizeMinBodyLines: z<number, number, "volatile-defined">;
+    readSummarizeMinCommentLines: z<number, number, "volatile-defined">;
+    readSummarizeMinTotalLines: z<number, number, "volatile-defined">;
+    readSummarizeUnfoldUntil: z<number, number, "volatile-defined">;
+    readSummarizeUnfoldLimit: z<number, number, "volatile-defined">;
+    editMode: z<"replace" | "patch" | "hashline" | "apply_patch", "replace" | "patch" | "hashline" | "apply_patch", "volatile-defined">;
+    editFuzzyMatch: z<boolean, boolean, "volatile-defined">;
+    editFuzzyThreshold: z<number, number, "volatile-defined">;
+    editEnforceSeenLines: z<boolean, boolean, "volatile-defined">;
+    readDefaultLimit: z<number, number, "volatile-defined">;
+    readLineNumbers: z<boolean, boolean, "volatile-defined">;
+    readRenderMarkdown: z<boolean, boolean, "volatile-defined">;
+    readConcurrentSafe: z<boolean, boolean, "volatile-defined">;
+    grepContextBefore: z<number, number, "volatile-defined">;
+    grepContextAfter: z<number, number, "volatile-defined">;
+    grepCaseDefault: z<boolean, boolean, "volatile-defined">;
+    grepGitignoreDefault: z<boolean, boolean, "volatile-defined">;
+    globGitignoreDefault: z<boolean, boolean, "volatile-defined">;
+    globHiddenDefault: z<boolean, boolean, "volatile-defined">;
+    astGrepEnabled: z<boolean, boolean, "volatile-defined">;
+    astEditEnabled: z<boolean, boolean, "volatile-defined">;
+    fetchEnabled: z<boolean, boolean, "volatile-defined">;
+    fetchMaxTimeoutSeconds: z<number, number, "volatile-defined">;
+    fetchReader: z<"trafilatura" | "lynx" | "auto" | "native" | "parallel" | "jina" | "browser", "trafilatura" | "lynx" | "auto" | "native" | "parallel" | "jina" | "browser", "volatile-defined">;
+    browserReaderEnabled: z<boolean, boolean, "volatile-defined">;
+    imagesAutoResize: z<boolean, boolean, "volatile-defined">;
+    imagesBlockImages: z<boolean, boolean, "volatile-defined">;
+    imagesExcludeWebp: z<boolean, boolean, "volatile-defined">;
+    imagesInputMaxBytes: z<number, number, "volatile-defined">;
+    imagesResizeMaxSide: z<number, number, "volatile-defined">;
+    imagesResizeMaxBytes: z<number, number, "volatile-defined">;
+    imagesResizeMinSide: z<number, number, "volatile-defined">;
+    imagesResizeJpegQuality: z<number, number, "volatile-defined">;
+}>>, "plain">;
+/**
+ * Live entry config: what the Loader hands `apply` for this entry, and what
+ * {@link installBashPlusSettings} re-reads after a settings write commits. One
+ * stable reference per schema field — read it through `.get()`, never as a
+ * plain value.
  */
-export declare const Config: z<Config>;
+export type LiveConfig = ReturnType<typeof Config>;
 /**
  * Resolve the flat settings (composition entry or the settings document) to
  * the nested runtime config the ported OMP runtime consumes. A direct mount
  * (`ctx.plugin`) skips the Loader's schema parse, so the `?? default` pass
  * mirrors the schema; the settings namespace resolution rides the same path.
- * @param config - flat settings, possibly partial and not schema-parsed.
+ * Accepts both shapes a caller can hold: the Loader's live entry config (one
+ * reference per field) and a plain settings document.
+ * @param input - the entry's live config, or a plain (possibly partial) document.
  * @returns the fully-defaulted nested runtime config.
  */
-export declare function resolveConfig(config: Config): RuntimeConfig;
+export declare function resolveConfig(input: Config | LiveConfig): RuntimeConfig;
 /**
- * Install the optional-settings consumer wiring for this plugin: while a
- * settings provider is mounted, resolve through the `tool-plus` namespace
- * (schema defaults → composition entry `base` → user document) and forward the
- * scope to `onSource`; when none is mounted, keep the composition entry, so
- * the tool keeps working exactly as composed. Mirrors the official bash-local
- * pattern so a committed change applies without a reload.
+ * Install the optional-settings consumer wiring for this plugin, in the dsh
+ * 0.1.7 shape.
+ *
+ * 0.1.7 deleted the namespace-registration API (`SettingsForms` no longer has
+ * `installSection`): a settings namespace is not something a plugin installs
+ * any more — it IS the plugin's own profile entry, and the service serves
+ * exactly the Config fields whose schema declares them live
+ * ({@link Config} declares every field `.volatile()`). The plugin therefore
+ * keeps one authoritative source, its own entry config:
+ *
+ *  - the Loader merges the composition layers and the profile override before
+ *    `apply` runs, so the entry already carries the effective settings;
+ *  - a settings write is committed INTO that entry's live references without a
+ *    remount, and the Loader then announces the changed paths on this fiber
+ *    (`loader/volatile-update`) — which is the signal for refreshing
+ *    registration facts (the `editMode`-sensitive descriptions and the AST
+ *    switches), exactly as the settings docs prescribe.
+ *
+ * The plugin ships its own settings pages in the browser half, so it owns its
+ * page policy: `configure({ auto: false })` tells the settings service not to
+ * auto-generate a schema page for this entry. That call rides an optional
+ * `ctx.inject(['settings'], ...)` child, so the plugin runs unchanged in a
+ * deployment that composes no settings service at all.
+ *
+ * Mirrors the official bash-local pattern (`packages/shell/bash-local`): the
+ * business plugin reads its own Config references and registers only its page
+ * policy; nothing re-registers the namespace.
  * @param ctx - plugin context owning the wiring.
- * @param entry - composition entry config declared by the caller.
+ * @param entry - the entry's config as the Loader resolved it (live references
+ * over the composition layers and the profile override), or a plain document.
  * @param onSource - receives a thunk of the currently authoritative runtime config.
  */
-export declare function installBashPlusSettings(ctx: Context, entry: Config, onSource: (current: () => RuntimeConfig) => void): void;
+export declare function installBashPlusSettings(ctx: Context, entry: Config | LiveConfig, onSource: (current: () => RuntimeConfig) => void): void;