dsh-plugin-effort-declare 0.1.2 → 0.1.4

package/lib/types/client/load-drafts.d.ts

@@ -1,6 +1,12 @@
 /**
  * Load editable route drafts from llm.providers + the llm-pi-ai namespace.
  * Drafts come from the user layer; route protocol classification may use effective value.
+ *
+ * First paint uses `ensure()` (idle-only). Refresh never calls `ensure()`:
+ * wait until the mirror subscribe shows a namespace revision at least as new
+ * as the Host event, then `getSnapshot()`. Own mutate echoes are identified
+ * by revision (including older delayed echoes), not ignored as a generic
+ * document-updated.
  */
 import type { IApiClient } from '@deepseek-ai/dsh-api-remotes/client';
 import type { SettingsDescribeFace } from '@deepseek-ai/dsh-client-ui-settings/client';
@@ -12,12 +18,36 @@ export interface LoadDraftsResult {
     drafts: RouteDraft[];
     error?: string;
 }
+export type LoadDraftsMode = 'ensure' | 'snapshot';
+type MirrorSnapshot = ReturnType<SettingsDescribeFace['getSnapshot']>;
+type MirrorDescribe = Pick<SettingsDescribeFace, 'getSnapshot' | 'subscribe'>;
+/** Namespace revision on a describe snapshot, if that row exists. */
+export declare function namespaceRevision(snapshot: MirrorSnapshot, ns: string): number | undefined;
 /**
- * First paint: `ensure()` (reads only from idle). Never treat ensure as refresh.
- * Callers that must not apply a stale settlement compare generation themselves.
- *
- * `formats` is the live schema union only. Empty means the dropdown has no
- * writable choices (stored values stay visible via `thinkingFormatChoices`).
+ * True when `incoming` is the Host echo of a mutate this page already folded,
+ * or an older revision the snapshot has already passed. `echoed` is undefined
+ * until the first successful write.
+ */
+export declare function isOwnDocumentEcho(echoed: number | undefined, incoming: number): boolean;
+/**
+ * After a preserve-dirty reload: conflicted cards get a conflict notice;
+ * live cards drop leftover conflict/error; saved notices stay; gone cards drop.
+ */
+export declare function foldReloadNotices<T extends {
+    kind: string;
+}>(current: Record<string, T>, args: {
+    conflicted: readonly string[];
+    conflictNotice: T;
+    liveProviders: readonly string[];
+}): Record<string, T>;
+/** Resolve when the mirror's namespace revision is at least `revision`, or abort. */
+export declare function waitForNamespaceRevision(describe: MirrorDescribe, ns: string, revision: number, signal?: AbortSignal): Promise<'matched' | 'aborted'>;
+/** Resolve when the namespace revision differs from `previous`, or abort. */
+export declare function waitForNamespaceRevisionChange(describe: MirrorDescribe, ns: string, previous: number, signal?: AbortSignal): Promise<'changed' | 'aborted'>;
+/**
+ * `ensure`: first paint / idle recovery (official ensure only reads from idle).
+ * `snapshot`: refresh after the mirror revision already moved — do not ensure.
  */
-export declare function loadDrafts(api: Pick<IApiClient, 'llm'>, describe: Pick<SettingsDescribeFace, 'ensure' | 'getSnapshot'>, schema: SchemaOps): Promise<LoadDraftsResult>;
+export declare function loadDrafts(api: Pick<IApiClient, 'llm'>, describe: Pick<SettingsDescribeFace, 'ensure' | 'getSnapshot'>, schema: SchemaOps, mode?: LoadDraftsMode): Promise<LoadDraftsResult>;
+export {};
 //# sourceMappingURL=load-drafts.d.ts.map

package/lib/types/client/load-drafts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-drafts.d.ts","sourceRoot":"","sources":["../../../src/client/load-drafts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,qCAAqC,CAAA;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAA;AAKtF,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAOhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAC5B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,aAAa,CAAC,EAC9D,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,gBAAgB,CAAC,CA8C3B"}
+{"version":3,"file":"load-drafts.d.ts","sourceRoot":"","sources":["../../../src/client/load-drafts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,qCAAqC,CAAA;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAA;AAKtF,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAOhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAA;AAElD,KAAK,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAA;AACrE,KAAK,cAAc,GAAG,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,WAAW,CAAC,CAAA;AAE7E,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAC1B,IAAI,EAAE;IACJ,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,cAAc,EAAE,CAAC,CAAA;IACjB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC,GACA,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAcnB;AA4BD,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAUhC;AAED,6EAA6E;AAC7E,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAMhC;AAqDD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAC5B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,aAAa,CAAC,EAC9D,MAAM,EAAE,SAAS,EACjB,IAAI,GAAE,cAAyB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAG3B"}

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

@@ -1,7 +1,7 @@
 /**
  * Dictionary namespace for the effort-declare settings section.
  */
-export type EffortDeclareKey = 'nav' | 'title' | 'intro' | 'empty' | 'emptyHint' | 'loadError' | 'loading' | 'readOnly' | 'save' | 'saving' | 'saveBusy' | 'cancel' | 'saved' | 'conflict' | 'dirtyConflict' | 'presets' | 'presetDeepSeek' | 'presetOpenAI' | 'presetToggle' | 'presetToggleWarn' | 'model' | 'levels' | 'wire' | 'offMode' | 'offAbsent' | 'offEmpty' | 'offValue' | 'offValuePlaceholder' | 'clear' | 'advanced' | 'thinkingFormat' | 'thinkingFormatDefault' | 'supportsDeveloperRole' | 'supportsReasoningEffort' | 'developerTrueHint' | 'compatSummary' | 'errorEmpty' | 'errorOffOnly' | 'errorBadWire' | 'noModels' | 'reload';
+export type EffortDeclareKey = 'nav' | 'title' | 'intro' | 'empty' | 'emptyHint' | 'loadError' | 'loading' | 'readOnly' | 'save' | 'saving' | 'saveBusy' | 'cancel' | 'saved' | 'conflict' | 'dirtyConflict' | 'presets' | 'presetDeepSeek' | 'presetOpenAI' | 'presetToggle' | 'presetToggleWarn' | 'model' | 'levels' | 'wire' | 'offMode' | 'offAbsent' | 'offEmpty' | 'offValue' | 'offValuePlaceholder' | 'clear' | 'advanced' | 'thinkingFormat' | 'thinkingFormatDefault' | 'supportsDeveloperRole' | 'supportsReasoningEffort' | 'developerTrueHint' | 'compatSummary' | 'errorEmpty' | 'errorOffOnly' | 'errorBadWire' | 'noModels' | 'reload' | 'imageInput' | 'imageInputHint' | 'errorBadInput';
 export declare const NS = "plugin-effort-declare";
 export declare const zh: Record<EffortDeclareKey, string>;
 export declare const en: Record<EffortDeclareKey, string>;

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

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,OAAO,GACP,UAAU,GACV,eAAe,GACf,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,qBAAqB,GACrB,OAAO,GACP,UAAU,GACV,gBAAgB,GAChB,uBAAuB,GACvB,uBAAuB,GACvB,yBAAyB,GACzB,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,UAAU,GACV,QAAQ,CAAA;AAEZ,eAAO,MAAM,EAAE,0BAA0B,CAAA;AAEzC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CA0C/C,CAAA;AAED,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CA0C/C,CAAA"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,OAAO,GACP,UAAU,GACV,eAAe,GACf,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,qBAAqB,GACrB,OAAO,GACP,UAAU,GACV,gBAAgB,GAChB,uBAAuB,GACvB,uBAAuB,GACvB,yBAAyB,GACzB,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,gBAAgB,GAChB,eAAe,CAAA;AAEnB,eAAO,MAAM,EAAE,0BAA0B,CAAA;AAEzC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CA6C/C,CAAA;AAED,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CA6C/C,CAAA"}

package/lib/types/core/attribution.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plugin footer attribution. Version and end-year are frozen into the client
+ * bundle at pack time; this module only formats the line.
+ */
+/** First publication year (LICENSE). Not the user's wall clock. */
+export declare const COPYRIGHT_FROM = 2026;
+export declare const COPYRIGHT_HOLDER = "Stardust";
+/**
+ * `0.1.2 © 2026 Stardust` or `0.1.2 © 2026–2027 Stardust`.
+ * Throws if version is empty or `to < from` — a bad stamp must not render.
+ */
+export declare function formatAttribution(version: string, from: number, to: number): string;
+//# sourceMappingURL=attribution.d.ts.map

package/lib/types/core/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../../src/core/attribution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,eAAO,MAAM,cAAc,OAAO,CAAA;AAElC,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CASnF"}

package/lib/types/core/catalog.d.ts

@@ -30,4 +30,12 @@ export declare const LLM_DEEPSEEK_NS = "llm-deepseek";
 export declare const DEEPSEEK_OFFICIAL = "deepseek-official";
 /** Any route key walks a dict schema to the same profile node. */
 export declare const SCHEMA_PROBE_ROUTE = "\0probe";
+/** Request modalities llm-pi-ai accepts on `models[].input` / `defaultInput`. */
+export declare const INPUT_MODALITIES: readonly ["text", "image"];
+export type InputModality = (typeof INPUT_MODALITIES)[number];
+/**
+ * Canonical write for a hand-declared vision model.
+ * Must include `text`; image-only is not a serviceable OpenAI-completions route.
+ */
+export declare const IMAGE_CAPABLE_INPUT: readonly InputModality[];
 //# sourceMappingURL=catalog.d.ts.map

package/lib/types/core/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/core/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,eAAe,sEAQlB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,6DAEvC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,gJAW5B,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,YAAY,cAAc,CAAA;AAEvC,kDAAkD;AAClD,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,YAAgB,CAAA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/core/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,eAAe,sEAQlB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,6DAEvC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,gJAW5B,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,YAAY,cAAc,CAAA;AAEvC,kDAAkD;AAClD,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,YAAgB,CAAA;AAE/C,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,4BAA6B,CAAA;AAE1D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAAsB,CAAA"}

package/lib/types/core/drafts.d.ts

@@ -34,9 +34,13 @@ export declare function applySaveSuccess(drafts: readonly RouteDraft[], savedPro
     user: unknown;
     revision: number;
 }): RouteDraft[];
+/** Model-row fields this page edits; other keys follow the Models page. */
+export declare const MODEL_OVERLAY_KEYS: readonly ["reasoningEfforts", "input"];
+export type ModelOverlayKey = (typeof MODEL_OVERLAY_KEYS)[number];
 /**
  * Membership follows the latest user-layer models list (Models page add/delete).
- * Local unsaved `reasoningEfforts` (including a cleared key) overlay by id.
+ * Local unsaved overlay keys (including a cleared key) overlay by id; other
+ * fields on the row follow incoming.
  */
 export declare function mergeModelsById(args: {
     prevModels: readonly Record<string, unknown>[];
@@ -62,9 +66,9 @@ export declare function mergeCompat(args: {
 };
 /**
  * Apply a freshly loaded table. Membership and metadata follow incoming;
- * unsaved reasoningEfforts / dirty compat keys overlay by id. Conflict only
- * when a locally dirty field also changed in originals (revision-only bumps
- * and sibling-card saves do not warn).
+ * unsaved overlay keys (`reasoningEfforts`, `input`) / dirty compat keys
+ * overlay by id. Conflict only when a locally dirty field also changed in
+ * originals (revision-only bumps and sibling-card saves do not warn).
  */
 export declare function mergeLoadedDrafts(current: readonly RouteDraft[], incoming: readonly RouteDraft[], options: {
     preserveDirty: boolean;

package/lib/types/core/drafts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../../../src/core/drafts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../../../src/core/drafts.ts"],"names":[],"mappings":"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"}

package/lib/types/core/efforts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"efforts.d.ts","sourceRoot":"","sources":["../../../src/core/efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAElE,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5E,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAA;AAExE,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/F;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAMlB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAE7G;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CAKlB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAwBxG;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3F;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAKtF;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}
+{"version":3,"file":"efforts.d.ts","sourceRoot":"","sources":["../../../src/core/efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAElE,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5E,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAA;AAExE,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/F;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,gBAAgB,CASlB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAE7G;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CAKlB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAwBxG;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3F;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAKtF;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/lib/types/core/input.d.ts

@@ -0,0 +1,15 @@
+/** Whether the stored `input` list includes image. Absence is false. */
+export declare function readImageCapable(row: Record<string, unknown>): boolean;
+/**
+ * Declare or drop image input on a spread row.
+ * Enabled writes `[text, image]`; disabled unsets the key (not `[]`, not `[text]`).
+ */
+export declare function writeImageCapable(row: Record<string, unknown>, enabled: boolean): Record<string, unknown>;
+/**
+ * Validate a stored `input` field. Returns an error code; never throws.
+ * Absence is valid. Empty list is rejected so a bad stamp cannot be re-saved.
+ */
+export declare function validateInput(input: unknown): 'bad-input' | undefined;
+/** Per-model client-side check used to show errors without throwing. */
+export declare function modelInputError(row: Record<string, unknown>): 'bad-input' | undefined;
+//# sourceMappingURL=input.d.ts.map

package/lib/types/core/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/core/input.ts"],"names":[],"mappings":"AAOA,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAGtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAWrE;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,GAAG,SAAS,CAGrF"}

package/lib/types/core/validate.d.ts

@@ -1,3 +1,6 @@
+export type ModelRowError = 'empty' | 'off-only' | 'bad-wire' | 'bad-input';
 /** Per-model client-side check used to show errors without throwing. */
 export declare function modelEffortError(row: Record<string, unknown>): 'empty' | 'off-only' | 'bad-wire' | undefined;
+/** First blocking error on a model row (efforts, then input). */
+export declare function modelRowError(row: Record<string, unknown>): ModelRowError | undefined;
 //# sourceMappingURL=validate.d.ts.map

package/lib/types/core/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/core/validate.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAG5G"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/core/validate.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;AAE3E,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAG5G;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,GAAG,SAAS,CAErF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-effort-declare",
-  "description": "Settings page to declare per-model reasoningEfforts and openai-completions compat on hand-declared llm-pi-ai routes. Writes the official namespace; does not intercept llm/stream or replace the Models page.",
-  "version": "0.1.2",
+  "description": "Declare per-model reasoning efforts, image input, and openai-completions dialect on hand-declared llm-pi-ai routes. Writes the official namespace; does not intercept llm/stream or replace the Models page.",
+  "version": "0.1.4",
   "private": false,
   "license": "MIT",
   "repository": {

package/src/README.en.md

@@ -16,8 +16,8 @@ Install: [INSTALL.en.md](../INSTALL.en.md). Usage: root [README.en.md](../README
 | Path | Role |
 | --- | --- |
 | [`index.ts`](./index.ts) | Host entry. Exports `name` and `apply`. v1 registers no host services or adapters; the bundle still needs this entry so `dsh plugin add` can load the package. |
-| [`core/`](./core/) | UI-free pure functions: efforts, presets, save ops, draft merge, route filtering. Shared by the client and tests; the v1 host entry does not import them (`tsconfig.host` still compiles `core` for types). |
-| [`client/`](./client/) | Browser half: locale, settings page, `settings.mutate` against `llm-pi-ai`. |
+| [`core/`](./core/) | UI-free pure functions: reasoning efforts, image input, presets, save ops, draft merge, route filtering, footer attribution. Shared by the client and tests; the v1 host entry does not import them (`tsconfig.host` still compiles `core` for types). |
+| [`client/`](./client/) | Browser half: locale, settings page, and official `settings.mutate` against `llm-pi-ai` for `reasoningEfforts` and `input`. |
 | [`css-modules.d.ts`](./css-modules.d.ts) | Types for `*.module.css` (class map plus `cssText` / `cssTagId`). |
 
 `tsconfig.host.json` compiles host + `core`; `tsconfig.client.json` compiles `client` + `core`. Build output lives in [`lib/`](../lib/).

package/src/README.md

@@ -16,8 +16,8 @@
 | 路径 | 说明 |
 | --- | --- |
 | [`index.ts`](./index.ts) | Host 入口。导出 `name` 与 `apply`。v1 不注册 host 服务、不挂适配器；组合包仍需要这一入口才能被 `dsh plugin add` 加载。 |
-| [`core/`](./core/) | 与 UI 无关的纯函数：档位、预设、保存 ops、草稿合并、路由过滤。client 与单测共用；Host 入口 v1 不引用这些函数（`tsconfig.host` 仍编译 `core` 以产出类型）。 |
-| [`client/`](./client/) | 浏览器半区：locale、设置页、对 `llm-pi-ai` 的 `settings.mutate`。 |
+| [`core/`](./core/) | 与 UI 无关的纯函数：推理档位、图片输入、预设、保存 ops、草稿合并、路由过滤、页脚归因格式。client 与单测共用；Host 入口 v1 不引用这些函数（`tsconfig.host` 仍编译 `core` 以产出类型）。 |
+| [`client/`](./client/) | 浏览器半区：locale、设置页，经官方 `settings.mutate` 写入 `llm-pi-ai` 的 `reasoningEfforts` 与 `input`。 |
 | [`css-modules.d.ts`](./css-modules.d.ts) | `*.module.css` 模块类型（class map + `cssText` / `cssTagId`）。 |
 
 `tsconfig.host.json` 编译 host + `core`；`tsconfig.client.json` 编译 `client` + `core`。构建产物在 [`lib/`](../lib/)。

package/src/client/EffortDeclareSection.tsx

@@ -1,6 +1,6 @@
 /**
- * Settings section: per-model reasoningEfforts + openai-completions compat
- * for hand-declared llm-pi-ai routes.
+ * Settings section: per-model reasoningEfforts, image input, and
+ * openai-completions compat for hand-declared llm-pi-ai routes.
  */
 import { useCallback, useEffect, useRef, useState, type ReactNode } from 'react'
 import type { IApiClient } from '@deepseek-ai/dsh-api-remotes/client'
@@ -29,19 +29,34 @@ import {
 import { applyPresetCompat, applyPresetEfforts, PRESETS, type PresetId } from '../core/presets.ts'
 import { buildSaveOps } from '../core/path-ops.ts'
 import { cloneModels, cloneObject } from '../core/paths.ts'
-import { modelEffortError } from '../core/validate.ts'
-import { loadDrafts } from './load-drafts.ts'
+import { readImageCapable, writeImageCapable } from '../core/input.ts'
+import { modelRowError } from '../core/validate.ts'
+import { PLUGIN_FOOTER_TEXT } from './build-info.ts'
+import {
+  foldReloadNotices,
+  isOwnDocumentEcho,
+  loadDrafts,
+  waitForNamespaceRevision,
+  waitForNamespaceRevisionChange,
+  type LoadDraftsMode,
+} from './load-drafts.ts'
 import { validateSaveDraft, type SchemaOps } from './schema-ops.ts'
 import type { EffortDeclareKey } from './locales.ts'
 import css from './effort-declare.module.css'
 
-export type InvalidationSource = 'settings' | 'directory' | 'writable'
+export type InvalidationSource = 'settings' | 'directory' | 'reset' | 'writable'
+
+export type Invalidation =
+  | { source: 'writable' }
+  | { source: 'directory' }
+  | { source: 'reset' }
+  | { source: 'settings'; revision: number }
 
 export interface EffortDeclareSectionInjected {
   api: Pick<IApiClient, 'settings' | 'llm'>
   describe: SettingsDescribeFace
   schema: SchemaOps
-  subscribeInvalidate: (listener: (source: InvalidationSource) => void) => () => void
+  subscribeInvalidate: (listener: (event: Invalidation) => void) => () => void
 }
 
 export interface EffortDeclareSectionProps extends Partial<EffortDeclareSectionInjected> {
@@ -61,10 +76,11 @@ function compatSummary(compat: Record<string, unknown>): string {
   return parts.join(' · ')
 }
 
-function errorText(code: ReturnType<typeof modelEffortError>, t: (key: EffortDeclareKey) => string): string | undefined {
+function errorText(code: ReturnType<typeof modelRowError>, t: (key: EffortDeclareKey) => string): string | undefined {
   if (code === 'empty') return t('errorEmpty')
   if (code === 'off-only') return t('errorOffOnly')
   if (code === 'bad-wire') return t('errorBadWire')
+  if (code === 'bad-input') return t('errorBadInput')
   return undefined
 }
 
@@ -100,6 +116,16 @@ function ModelRowEditor(props: {
           {t('clear')}
         </button>
       </div>
+      <label className={css.check}>
+        <input
+          type="checkbox"
+          checked={readImageCapable(row)}
+          disabled={disabled}
+          onChange={(event) => { onChange(writeImageCapable(row, event.target.checked)) }}
+        />
+        {t('imageInput')}
+      </label>
+      {readImageCapable(row) ? <p className={css.notice}>{t('imageInputHint')}</p> : null}
       <span className={css.fieldLabel}>{t('levels')}</span>
       <div className={css.levels}>
         {THINKING_LEVELS_WITHOUT_OFF.map((level) => (
@@ -183,7 +209,7 @@ function RouteCard(props: {
   const summary = compatSummary(draft.compat)
   const sameWire = draft.compat.supportsReasoningEffort === false
   const clientError = draft.models
-    .map(row => errorText(modelEffortError(row), t))
+    .map(row => errorText(modelRowError(row), t))
     .find(text => text !== undefined)
   const dirty = draftDirty(draft)
 
@@ -328,58 +354,133 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
   const [notices, setNotices] = useState<Record<string, CardNotice>>({})
   const generationRef = useRef(0)
   const draftsRef = useRef(drafts)
+  const echoedRevisionRef = useRef<number | undefined>(undefined)
+  const pendingRevisionRef = useRef<number | undefined>(undefined)
+  const busyRouteRef = useRef<string | null>(null)
+  const abortRef = useRef<AbortController | null>(null)
   draftsRef.current = drafts
 
-  const reload = useCallback((preserveDirty: boolean): void => {
+  const applyDrafts = (next: RouteDraft[] | ((current: RouteDraft[]) => RouteDraft[])): void => {
+    const resolved = typeof next === 'function' ? next(draftsRef.current) : next
+    draftsRef.current = resolved
+    setDrafts(resolved)
+  }
+
+  const snapshotMode = (): LoadDraftsMode => (
+    describe === undefined || describe.getSnapshot().status === 'idle' ? 'ensure' : 'snapshot'
+  )
+
+  const beginGeneration = (): { generation: number; signal: AbortSignal } => {
+    abortRef.current?.abort()
+    const abort = new AbortController()
+    abortRef.current = abort
+    return { generation: nextGeneration(generationRef), signal: abort.signal }
+  }
+
+  const failGeneration = (generation: number, failure: unknown): void => {
+    if (!generationIsCurrent(generationRef, generation)) return
+    setStatus('error')
+    setError(failure instanceof Error ? failure.message : t('loadError'))
+  }
+
+  const settleReload = (
+    generation: number,
+    preserveDirty: boolean,
+    result: Awaited<ReturnType<typeof loadDrafts>>,
+  ): void => {
+    if (!generationIsCurrent(generationRef, generation)) return
+    setWritable(result.writable)
+    setFormats(result.formats)
+    if (result.error !== undefined) {
+      setStatus('error')
+      setError(result.error)
+      return
+    }
+    const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty })
+    applyDrafts(merged.drafts)
+    setNotices(current => foldReloadNotices(current, {
+      conflicted: merged.conflicted,
+      conflictNotice: { kind: 'conflict', text: t('dirtyConflict') },
+      liveProviders: merged.drafts.map(draft => draft.provider),
+    }))
+    setStatus('ready')
+  }
+
+  const loadSnapshotThenSettle = async (generation: number, preserveDirty: boolean): Promise<void> => {
+    if (api === undefined || describe === undefined || schema === undefined) return
+    if (!generationIsCurrent(generationRef, generation)) return
+    try {
+      const result = await loadDrafts(api, describe, schema, 'snapshot')
+      settleReload(generation, preserveDirty, result)
+    } catch (failure) {
+      failGeneration(generation, failure)
+    }
+  }
+
+  const reload = useCallback((preserveDirty: boolean, mode: LoadDraftsMode = 'ensure'): void => {
     if (api === undefined || describe === undefined || schema === undefined) {
       setStatus('error')
       setError(t('loadError'))
       return
     }
-    const generation = nextGeneration(generationRef)
+    const { generation } = beginGeneration()
     if (draftsRef.current.length === 0) setStatus('loading')
     setError('')
-    void loadDrafts(api, describe, schema).then((result) => {
-      if (!generationIsCurrent(generationRef, generation)) return
-      setWritable(result.writable)
-      setFormats(result.formats)
-      if (result.error !== undefined) {
-        setStatus('error')
-        setError(result.error)
-        return
-      }
-      const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty })
-      setDrafts(merged.drafts)
-      if (merged.conflicted.length > 0) {
-        setNotices(current => {
-          const next = { ...current }
-          for (const provider of merged.conflicted) {
-            next[provider] = { kind: 'conflict', text: t('dirtyConflict') }
-          }
-          return next
-        })
-      }
-      setStatus('ready')
+    void loadDrafts(api, describe, schema, mode).then((result) => {
+      settleReload(generation, preserveDirty, result)
     }, (failure: unknown) => {
-      if (!generationIsCurrent(generationRef, generation)) return
-      setStatus('error')
-      setError(failure instanceof Error ? failure.message : t('loadError'))
+      failGeneration(generation, failure)
+    })
+  }, [api, describe, schema, t])
+
+  const refreshAtRevision = useCallback((revision: number, preserveDirty: boolean): void => {
+    if (api === undefined || describe === undefined || schema === undefined) return
+    const { generation, signal } = beginGeneration()
+    if (draftsRef.current.length === 0) setStatus('loading')
+    setError('')
+    void waitForNamespaceRevision(describe, LLM_PI_AI_NS, revision, signal).then((outcome) => {
+      if (outcome === 'aborted' || !generationIsCurrent(generationRef, generation)) return
+      return loadSnapshotThenSettle(generation, preserveDirty)
+    }, (failure: unknown) => {
+      failGeneration(generation, failure)
     })
   }, [api, describe, schema, t])
 
-  useEffect(() => { reload(false) }, [reload])
+  const flushPendingSettings = (refresh: (revision: number, preserveDirty: boolean) => void): void => {
+    const pending = pendingRevisionRef.current
+    pendingRevisionRef.current = undefined
+    if (pending === undefined) return
+    if (isOwnDocumentEcho(echoedRevisionRef.current, pending)) return
+    refresh(pending, true)
+  }
+
+  useEffect(() => { reload(false, 'ensure') }, [reload])
+  useEffect(() => () => {
+    abortRef.current?.abort()
+    nextGeneration(generationRef)
+  }, [])
 
   useEffect(() => {
     if (props.subscribeInvalidate === undefined) return undefined
-    return props.subscribeInvalidate((source) => {
-      if (source === 'writable') {
+    return props.subscribeInvalidate((event) => {
+      if (event.source === 'writable') {
         const view = describe?.getSnapshot().view
         if (view !== undefined) setWritable(view.writable)
         return
       }
-      if (source === 'settings' || source === 'directory') reload(true)
+      if (event.source === 'settings') {
+        if (busyRouteRef.current !== null) {
+          pendingRevisionRef.current = event.revision
+          return
+        }
+        if (isOwnDocumentEcho(echoedRevisionRef.current, event.revision)) return
+        refreshAtRevision(event.revision, true)
+        return
+      }
+      if (event.source === 'directory') reload(true, snapshotMode())
+      if (event.source === 'reset') reload(true, 'ensure')
     })
-  }, [describe, props.subscribeInvalidate, reload])
+  }, [describe, props.subscribeInvalidate, refreshAtRevision, reload])
 
   const patchNotice = (provider: string, notice: CardNotice | undefined): void => {
     setNotices(current => {
@@ -392,17 +493,18 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
 
   const save = async (draft: RouteDraft): Promise<void> => {
     if (api === undefined || describe === undefined || schema === undefined) return
-    if (status === 'loading' || busyRoute !== null) {
+    if (status === 'loading' || busyRouteRef.current !== null) {
       patchNotice(draft.provider, { kind: 'error', text: t('saveBusy') })
       return
     }
     const blocking = draft.models
-      .map(row => errorText(modelEffortError(row), t))
+      .map(row => errorText(modelRowError(row), t))
       .find(text => text !== undefined)
     if (blocking !== undefined) {
       patchNotice(draft.provider, { kind: 'error', text: blocking })
       return
     }
+    busyRouteRef.current = draft.provider
     setBusyRoute(draft.provider)
     patchNotice(draft.provider, undefined)
     try {
@@ -414,7 +516,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
         afterCompat: draft.compat,
       })
       if (ops.length === 0) {
-        setDrafts(current => current.map(row => row.provider === draft.provider ? alignDraft(row) : row))
+        applyDrafts(current => current.map(row => row.provider === draft.provider ? alignDraft(row) : row))
         return
       }
       const willWriteCompat = ops.some(op => (
@@ -454,12 +556,21 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
           kind: conflict ? 'conflict' : 'error',
           text: conflict ? t('conflict') : response.result.error.message,
         })
-        if (conflict) reload(true)
+        if (conflict) {
+          const { generation, signal } = beginGeneration()
+          void waitForNamespaceRevisionChange(describe, LLM_PI_AI_NS, draft.revision, signal).then((outcome) => {
+            if (outcome === 'aborted' || !generationIsCurrent(generationRef, generation)) return
+            return loadSnapshotThenSettle(generation, true)
+          }, (failure: unknown) => {
+            failGeneration(generation, failure)
+          })
+        }
         return
       }
       const view = response.result.value
+      echoedRevisionRef.current = view.revision
       describe.acceptView(view)
-      setDrafts(current => applySaveSuccess(current, draft.provider, {
+      applyDrafts(applySaveSuccess(draftsRef.current, draft.provider, {
         user: view.user ?? {},
         revision: view.revision,
       }))
@@ -470,7 +581,9 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
         text: failure instanceof Error ? failure.message : t('loadError'),
       })
     } finally {
+      busyRouteRef.current = null
       setBusyRoute(null)
+      flushPendingSettings(refreshAtRevision)
     }
   }
 
@@ -491,7 +604,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
       {status === 'error' ? <p className={css.error}>{error}</p> : null}
       {showReload
         ? (
-          <button type="button" className={css.secondaryButton} onClick={() => { reload(true) }}>{t('reload')}</button>
+          <button type="button" className={css.secondaryButton} onClick={() => { reload(true, snapshotMode()) }}>{t('reload')}</button>
         )
         : null}
       {showEmpty
@@ -517,12 +630,12 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
                 t={t}
                 onChange={(next) => {
                   patchNotice(next.provider, undefined)
-                  setDrafts(current => current.map(row => row.provider === next.provider ? next : row))
+                  applyDrafts(current => current.map(row => row.provider === next.provider ? next : row))
                 }}
                 onSave={(next) => { void save(next) }}
                 onCancel={(next) => {
                   patchNotice(next.provider, undefined)
-                  setDrafts(current => current.map(row => row.provider === next.provider
+                  applyDrafts(current => current.map(row => row.provider === next.provider
                     ? {
                         ...row,
                         models: cloneModels(row.originalModels),
@@ -535,6 +648,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
           </ul>
         )
         : null}
+      <p className={css.footer}>{PLUGIN_FOOTER_TEXT}</p>
     </div>
   )
 }

package/src/client/README.en.md

@@ -7,7 +7,7 @@
   </samp>
 </p>
 
-Browser half: registers **Reasoning efforts** in the Web UI settings panel and writes `llm-pi-ai` through the official settings RPC.
+Browser half: registers **Reasoning efforts** in the Web UI settings panel and writes per-model `reasoningEfforts` and `input` on `llm-pi-ai` through the official settings RPC.
 
 Wiring failures in `apply` throw, same as the official Models page. Do not swallow `apply` with a blanket `try/catch`. Locale, CSS, and event subscriptions are cleaned up through `ctx.effect` on unload.
 
@@ -17,10 +17,12 @@ Cross-plugin work uses Cordis services only (`connection`, `settingsScope`, `set
 
 | File | Role |
 | --- | --- |
-| [`index.ts`](./index.ts) | Registers zh/en copy, CSS (`ctx.effect` insert/remove), and `settings.section` (id `effort-declare`, order 12). `describe.subscribe` only syncs `writable` (it fires for every namespace, including this page’s own `acceptView`). Full reloads come from `settings/document-updated` (`llm-pi-ai` only), `llm/adapters-updated`, and `connection/reset`. `locale: NS` lets the framework inject `t`; `inject` only returns `api` / `describe` / `schema` / `subscribeInvalidate`. |
-| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | Route cards, presets, Off tri-state, advanced protocol switches, save and cancel. Save is exclusive for the whole `llm-pi-ai` namespace; `busy` is “Saving…” on the in-flight card, `saveLocked` disables the others. A successful write folds `acceptView` + `applySaveSuccess` and does not full-reload. |
-| [`load-drafts.ts`](./load-drafts.ts) | Builds drafts from `llm.providers` + the settings mirror; drafts come from `user`, protocol classification may use `value`. `thinkingFormat` choices come only from the live schema union. |
-| [`locales.ts`](./locales.ts) | Copy namespace `plugin-effort-declare`. |
+| [`index.ts`](./index.ts) | Registers zh/en copy, CSS (`ctx.effect` insert/remove), and `settings.section` (id `effort-declare`, order 12). `describe.subscribe` only syncs `writable` (it fires for every namespace, including this page’s own `acceptView`). `settings/document-updated` (`llm-pi-ai` only) carries the Host revision; the section skips its own mutate echo, waits until the mirror revision has **caught up**, then `getSnapshot()` — it does not use `ensure()` as refresh. Provider directory changes come from `llm/adapters-updated`; `connection/reset` uses `ensure()` so an in-flight official `load()` is awaited. `locale: NS` lets the framework inject `t`; `inject` only returns `api` / `describe` / `schema` / `subscribeInvalidate`. |
+| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | Route cards, presets, Off tri-state, per-model **Accepts image input**, advanced protocol switches, save and cancel. Save is exclusive for the whole `llm-pi-ai` namespace (ref-guarded against double-click); `busy` is “Saving…” on the in-flight card, `saveLocked` disables the others. Save is blocked by `modelRowError` for empty efforts, Off-only, and illegal `input`. A successful write syncs `draftsRef` immediately and folds `acceptView` + `applySaveSuccess`. External `document-updated` events that arrive during save are replayed afterwards. A reload with no conflict clears that card’s conflict/error notice. Footer shows the version and copyright years frozen at pack time. |
+| [`build-info.ts`](./build-info.ts) | Reads `package.json` version and UTC pack year injected by tsdown `define`, and formats the footer line. |
+| [`globals.d.ts`](./globals.d.ts) | Types for `__PLUGIN_VERSION__` and `__COPYRIGHT_TO__`. |
+| [`load-drafts.ts`](./load-drafts.ts) | Builds drafts from `llm.providers` + the settings mirror; drafts come from `user`, protocol classification may use `value`. `thinkingFormat` choices come only from the live schema union. First paint uses `ensure()`; refresh reads `getSnapshot()` only, with helpers that wait for the namespace revision. |
+| [`locales.ts`](./locales.ts) | Copy namespace `plugin-effort-declare` (efforts, image input, and validation errors). |
 | [`effort-declare.module.css`](./effort-declare.module.css) | `--dsw-alias-*` tokens only, so dark theme stays correct. |
 | [`schema-ops.ts`](./schema-ops.ts) | Binds `settingsSchema` as plain callbacks (including `validate`) so the service identity is not passed into React. |