@carljia/omd-dsh 0.1.7 → 0.1.9

package/lib/client.js

@@ -0,0 +1,427 @@
+window.__ModuleLoader__.load({
+	id: "@carljia/omd-dsh",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/client.tsx
+var client_exports = {};
+__export(client_exports, {
+  OmdModelAllocationSection: () => OmdModelAllocationSection,
+  apply: () => apply,
+  inject: () => inject
+});
+module.exports = __toCommonJS(client_exports);
+var React = __toESM(require("react"), 1);
+
+// src/omd-matrix-controller.ts
+var OMD_SETTINGS_NS = "omd-model-allocation";
+function cloneMatrix(value) {
+  if (value === void 0) return null;
+  return JSON.parse(JSON.stringify(value));
+}
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var OmdMatrixController = class {
+  constructor(api, scope, describe) {
+    __publicField(this, "api", api);
+    __publicField(this, "scope", scope);
+    __publicField(this, "describe", describe);
+    __publicField(this, "draft");
+    __publicField(this, "status", "idle");
+    __publicField(this, "error", null);
+    __publicField(this, "saved", false);
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+    __publicField(this, "unsubscribeScope");
+    /**
+     * Cached snapshot handed to `useSyncExternalStore`. React requires
+     * `getSnapshot()` to return the SAME reference between changes — a fresh
+     * object per call throws "The result of getSnapshot should be cached" and
+     * crashes the whole settings entry (blank page). Rebuilt only in `emit()`.
+     */
+    __publicField(this, "snapshot");
+    this.draft = cloneMatrix(scope.getSnapshot().value);
+    this.snapshot = { draft: this.draft, status: this.status, error: this.error, saved: this.saved };
+    this.unsubscribeScope = scope.subscribe(() => this.onScopeChange());
+  }
+  /** Release the scope subscription (plugin fiber teardown). */
+  dispose() {
+    this.unsubscribeScope();
+    this.listeners.clear();
+  }
+  /** Stable snapshot reference (uSES-safe): the SAME object until state changes. */
+  getSnapshot() {
+    return this.snapshot;
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  emit() {
+    this.snapshot = { draft: this.draft, status: this.status, error: this.error, saved: this.saved };
+    for (const listener of [...this.listeners]) listener();
+  }
+  /** External change (mirror reload after a rejected write, another window):
+   *  rebuild the draft from the fresh value, unless a save is in flight. */
+  onScopeChange() {
+    if (this.status === "saving") return;
+    this.refreshDraft();
+    this.emit();
+  }
+  refreshDraft() {
+    const value = this.scope.getSnapshot().value;
+    if (value !== void 0) this.draft = cloneMatrix(value);
+  }
+  /** Whether the Save / Reset controls may run. */
+  get canSave() {
+    const snap = this.scope.getSnapshot();
+    return snap.status === "ready" && snap.writable && this.status !== "saving" && this.draft !== null;
+  }
+  /** Whether the namespace accepts writes at all (read-only provider / memory mode). */
+  get writable() {
+    return this.scope.getSnapshot().writable;
+  }
+  /** Edit one mode's top-level field; an empty string removes the override
+   *  (the field re-inherits the composition base / schema default). */
+  patchMode(modeId, field, value) {
+    const draft = this.draft;
+    if (draft === null) return;
+    const modes = { ...draft.modes };
+    const cfg = { ...modes[modeId] ?? {} };
+    if (value === "") delete cfg[field];
+    else cfg[field] = value;
+    modes[modeId] = cfg;
+    this.draft = { ...draft, modes };
+    this.saved = false;
+    this.emit();
+  }
+  /** Edit one tier's provider/model; an empty string removes the override. */
+  patchTier(modeId, tier, field, value) {
+    const draft = this.draft;
+    if (draft === null) return;
+    const modes = { ...draft.modes };
+    const cfg = { ...modes[modeId] ?? {} };
+    const tiers = { ...cfg.tiers ?? {} };
+    const tierCfg = { ...tiers[tier] ?? {} };
+    if (value === "") delete tierCfg[field];
+    else tierCfg[field] = value;
+    tiers[tier] = tierCfg;
+    cfg.tiers = tiers;
+    modes[modeId] = cfg;
+    this.draft = { ...draft, modes };
+    this.saved = false;
+    this.emit();
+  }
+  /**
+   * Persist the whole draft matrix through `settings.replace` (wholesale
+   * section replacement — the removal/reset path merge cannot express). The
+   * revision fence makes a stale editor fail loudly instead of overwriting.
+   * @returns once the write settled and the snapshot reflects the outcome.
+   */
+  async save() {
+    if (!this.canSave || this.draft === null) return;
+    const snap = this.scope.getSnapshot();
+    this.status = "saving";
+    this.error = null;
+    this.emit();
+    const response = await this.replace({ section: this.draft, revision: snap.revision });
+    if (response.ok) this.saved = true;
+    else {
+      this.error = response.message;
+      await this.describe.load();
+    }
+    this.refreshDraft();
+    this.status = "idle";
+    this.emit();
+  }
+  /** Restore the shipped default matrix: replace with an empty section. */
+  async reset() {
+    if (!this.canSave) return;
+    const snap = this.scope.getSnapshot();
+    this.status = "saving";
+    this.error = null;
+    this.emit();
+    const response = await this.replace({ section: {}, revision: snap.revision });
+    if (response.ok) this.saved = true;
+    else this.error = response.message;
+    await this.describe.load();
+    this.refreshDraft();
+    this.status = "idle";
+    this.emit();
+  }
+  async replace(request) {
+    try {
+      const response = await this.api.settings.replace({
+        ns: OMD_SETTINGS_NS,
+        section: request.section,
+        ...request.revision === void 0 ? {} : { expectedRevision: request.revision }
+      });
+      if (response.result.ok) return { ok: true };
+      return { ok: false, message: response.result.error.message };
+    } catch (error) {
+      return { ok: false, message: messageOf(error) };
+    }
+  }
+};
+
+// src/client.tsx
+var NS = "settings.omd";
+var MODE_ORDER = ["executor", "ultraworker", "planner", "reviewer", "explorer", "librarian", "chat"];
+var en = {
+  nav: "OMD model allocation",
+  title: "OMD model allocation",
+  intro: "Model routes for the 7 OMD agent presets. Changes apply to sessions you start from now on \u2014 running sessions keep the models they began with.",
+  loading: "Loading the model matrix\u2026",
+  unavailable: "The model matrix is not available from this browser (settings are process-local for remote connections).",
+  readOnly: "The settings document is read-only here; the current matrix is shown for reference.",
+  mode: "Mode",
+  provider: "Provider",
+  model: "Model",
+  reasoningEffort: "Reasoning effort",
+  reasoningEffortHint: "Optional; leave empty to let the provider decide.",
+  tiers: "Tiers",
+  tier: "Tier",
+  hint: "Purpose",
+  save: "Save",
+  saving: "Saving\u2026",
+  reset: "Restore defaults",
+  saved: "Saved \u2014 new sessions will use the new matrix.",
+  errorPrefix: "Save failed:",
+  renderError: "The model matrix form could not be rendered:",
+  conflict: "The matrix changed on the host; the form was reloaded with the latest values.",
+  executor: "Executor",
+  ultraworker: "Ultraworker",
+  planner: "Planner",
+  reviewer: "Reviewer",
+  explorer: "Explorer",
+  librarian: "Librarian",
+  chat: "Chat"
+};
+var zh = {
+  nav: "omd\u6A21\u578B\u5206\u914D",
+  title: "omd \u6A21\u578B\u5206\u914D",
+  intro: "7 \u4E2A OMD agent \u9884\u8BBE\u7684\u6A21\u578B\u8DEF\u7531\u3002\u4FDD\u5B58\u540E\u5BF9\u4E4B\u540E\u65B0\u5EFA\u7684\u4F1A\u8BDD\u751F\u6548\u2014\u2014\u8FD0\u884C\u4E2D\u7684\u4F1A\u8BDD\u4FDD\u6301\u5B83\u5F00\u59CB\u65F6\u7684\u6A21\u578B\u3002",
+  loading: "\u6B63\u5728\u52A0\u8F7D\u6A21\u578B\u77E9\u9635\u2026",
+  unavailable: "\u5F53\u524D\u6D4F\u89C8\u5668\u65E0\u6CD5\u8BBF\u95EE\u6A21\u578B\u77E9\u9635\uFF08\u8FDC\u7A0B\u8FDE\u63A5\u65F6\u8BBE\u7F6E\u4EC5\u5728\u672C\u673A\u8FDB\u7A0B\u5185\u6709\u6548\uFF09\u3002",
+  readOnly: "\u8BBE\u7F6E\u6587\u6863\u5F53\u524D\u53EA\u8BFB\uFF1B\u4EE5\u4E0B\u5C55\u793A\u73B0\u6709\u77E9\u9635\uFF0C\u4EC5\u4F9B\u53C2\u8003\u3002",
+  mode: "\u6A21\u5F0F",
+  provider: "Provider",
+  model: "Model",
+  reasoningEffort: "\u63A8\u7406\u5F3A\u5EA6",
+  reasoningEffortHint: "\u53EF\u9009\uFF1B\u7559\u7A7A\u4EA4\u7ED9 provider \u9ED8\u8BA4\u3002",
+  tiers: "\u6863\u4F4D\uFF08Tiers\uFF09",
+  tier: "\u6863\u4F4D",
+  hint: "\u7528\u9014",
+  save: "\u4FDD\u5B58",
+  saving: "\u4FDD\u5B58\u4E2D\u2026",
+  reset: "\u6062\u590D\u9ED8\u8BA4",
+  saved: "\u5DF2\u4FDD\u5B58\u2014\u2014\u65B0\u4F1A\u8BDD\u5C06\u6309\u65B0\u77E9\u9635\u8DEF\u7531\u6A21\u578B\u3002",
+  errorPrefix: "\u4FDD\u5B58\u5931\u8D25\uFF1A",
+  renderError: "\u6A21\u578B\u77E9\u9635\u8868\u5355\u6E32\u67D3\u5931\u8D25\uFF1A",
+  conflict: "\u77E9\u9635\u5DF2\u5728\u5BBF\u4E3B\u4FA7\u53D8\u66F4\uFF0C\u8868\u5355\u5DF2\u6309\u6700\u65B0\u503C\u91CD\u65B0\u52A0\u8F7D\u3002",
+  executor: "\u6267\u884C\u8005",
+  ultraworker: "\u8D85\u80FD\u5DE5\u4F5C\u8005",
+  planner: "\u89C4\u5212\u8005",
+  reviewer: "\u8BC4\u5BA1\u8005",
+  explorer: "\u63A2\u7D22\u8005",
+  librarian: "\u56FE\u4E66\u7BA1\u7406\u5458",
+  chat: "\u5BF9\u8BDD"
+};
+var inject = ["slots", "locale", "connection", "settingsScope"];
+function apply(ctx) {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), "omd-dsh: settings section dictionaries");
+  const { api } = ctx.get("connection");
+  const describe = ctx.settingsScope.describe();
+  const scope = ctx.settingsScope.bind({ namespace: OMD_SETTINGS_NS });
+  const controller = new OmdMatrixController(api, scope, describe);
+  const t = ctx.locale.bind(NS);
+  ctx.slots.inject("settings.section", () => ctx.slots.register({
+    name: "settings.section",
+    id: "omd-model-allocation",
+    order: 30,
+    // after Models (10) and Agent presets (20)
+    label: () => t("nav"),
+    locale: NS,
+    inject: () => ({ scope, controller, t })
+  }, OmdModelAllocationSection));
+}
+var styles = {
+  section: { maxWidth: 720, color: "var(--dsw-alias-label-primary)", display: "flex", flexDirection: "column", gap: 12 },
+  title: { margin: 0, fontSize: 18, fontWeight: 600 },
+  intro: { color: "var(--dsw-alias-label-tertiary)", margin: 0, fontSize: 13, lineHeight: "20px" },
+  notice: { color: "var(--dsw-alias-state-warn-label)", margin: 0, fontSize: 12, lineHeight: "18px" },
+  savedNotice: { color: "var(--dsw-alias-state-success-primary)", margin: 0, fontSize: 12, lineHeight: "18px" },
+  error: { color: "var(--dsw-alias-state-error-primary)", margin: 0, fontSize: 12, lineHeight: "18px" },
+  card: { border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-layer-3)", borderRadius: 12, padding: "14px 16px", display: "flex", flexDirection: "column", gap: 10 },
+  cardHead: { display: "flex", alignItems: "baseline", gap: 8 },
+  cardTitle: { margin: 0, fontSize: 15, fontWeight: 600 },
+  cardRoute: { color: "var(--dsw-alias-label-tertiary)", fontSize: 12, lineHeight: "18px" },
+  field: { display: "flex", flexDirection: "column", gap: 4 },
+  fieldLabel: { color: "var(--dsw-alias-label-secondary)", fontSize: 12, fontWeight: 500, lineHeight: "18px" },
+  input: { boxSizing: "border-box", border: "1px solid var(--dsw-alias-border-l2)", width: "100%", height: 32, font: "inherit", background: "var(--dsw-alias-bg-layer-1)", color: "var(--dsw-alias-label-primary)", borderRadius: 8, padding: "0 10px", fontSize: 14, lineHeight: "22px" },
+  inputDisabled: { opacity: 0.6, cursor: "default" },
+  tierRow: { borderTop: "1px solid var(--dsw-alias-border-l2)", paddingTop: 10, display: "flex", flexDirection: "column", gap: 8 },
+  tierHead: { display: "flex", alignItems: "baseline", gap: 8 },
+  tierName: { margin: 0, fontSize: 13, fontWeight: 600 },
+  tierHint: { color: "var(--dsw-alias-label-tertiary)", fontSize: 12, lineHeight: "18px", flex: 1, overflowWrap: "anywhere" },
+  grid2: { display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(200px, 1fr))", gap: 8 },
+  actions: { display: "flex", alignItems: "center", gap: 8, marginTop: 4 },
+  primaryButton: { boxSizing: "border-box", height: 36, font: "inherit", cursor: "pointer", border: "none", borderRadius: 18, padding: "0 14px", fontSize: 14, lineHeight: "22px", background: "var(--dsw-alias-button-primary-fill)", color: "var(--dsw-alias-label-primary-foreground)" },
+  secondaryButton: { boxSizing: "border-box", height: 36, font: "inherit", cursor: "pointer", border: "1px solid var(--dsw-alias-border-l2)", background: "transparent", color: "var(--dsw-alias-label-primary)", borderRadius: 18, padding: "0 14px", fontSize: 14, lineHeight: "22px" },
+  buttonDisabled: { opacity: 0.4, cursor: "default" }
+};
+var OmdRenderBoundary = class extends React.Component {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "state", { error: null });
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  render() {
+    if (this.state.error !== null) {
+      return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, this.props.t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.error, role: "alert" }, this.props.t("renderError"), " ", this.state.error instanceof Error ? this.state.error.message : String(this.state.error)));
+    }
+    return this.props.children ?? null;
+  }
+};
+function OmdModelAllocationSection(props) {
+  return /* @__PURE__ */ React.createElement(OmdRenderBoundary, { t: props.t }, /* @__PURE__ */ React.createElement(OmdModelAllocationBody, { ...props }));
+}
+function OmdModelAllocationBody(props) {
+  const { scope, controller, t } = props;
+  const scopeSnapshot = React.useSyncExternalStore(
+    React.useCallback((listener) => scope.subscribe(listener), [scope]),
+    React.useCallback(() => scope.getSnapshot(), [scope]),
+    React.useCallback(() => scope.getSnapshot(), [scope])
+    // SSR/test renderers; no-op in the browser
+  );
+  const ui = React.useSyncExternalStore(
+    React.useCallback((listener) => controller.subscribe(listener), [controller]),
+    React.useCallback(() => controller.getSnapshot(), [controller]),
+    React.useCallback(() => controller.getSnapshot(), [controller])
+  );
+  if (scopeSnapshot.status === "unavailable") {
+    return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.intro }, t("unavailable")));
+  }
+  if (scopeSnapshot.status !== "ready" || ui.draft === null) {
+    return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.intro }, t("loading")));
+  }
+  const matrix = ui.draft;
+  const readOnly = !controller.writable;
+  return /* @__PURE__ */ React.createElement("div", { style: styles.section }, /* @__PURE__ */ React.createElement("h2", { style: styles.title }, t("nav")), /* @__PURE__ */ React.createElement("p", { style: styles.intro }, t("intro")), readOnly ? /* @__PURE__ */ React.createElement("p", { style: styles.notice }, t("readOnly")) : null, ui.saved ? /* @__PURE__ */ React.createElement("p", { style: styles.savedNotice, role: "status" }, t("saved")) : null, ui.error !== null ? /* @__PURE__ */ React.createElement("p", { style: styles.error, role: "alert" }, t("errorPrefix"), " ", ui.error, ui.error.toLowerCase().includes("revision") || ui.error.toLowerCase().includes("changed") ? ` ${t("conflict")}` : "") : null, MODE_ORDER.map((modeId) => {
+    const cfg = matrix.modes[modeId] ?? {};
+    const route = cfg.provider !== void 0 || cfg.model !== void 0 ? `${cfg.provider ?? "?"}/${cfg.model ?? "?"}` : "";
+    const modeName = t(modeId) ?? modeId;
+    return /* @__PURE__ */ React.createElement("div", { key: modeId, style: styles.card }, /* @__PURE__ */ React.createElement("div", { style: styles.cardHead }, /* @__PURE__ */ React.createElement("h3", { style: styles.cardTitle }, modeName), /* @__PURE__ */ React.createElement("span", { style: styles.cardRoute }, modeId, route !== "" ? ` \xB7 ${route}` : "")), /* @__PURE__ */ React.createElement("div", { style: styles.grid2 }, /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("provider")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: cfg.provider ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        placeholder: "deepseek-official",
+        onChange: (event) => controller.patchMode(modeId, "provider", event.target.value)
+      }
+    )), /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("model")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: cfg.model ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        placeholder: "deepseek-v4-pro",
+        onChange: (event) => controller.patchMode(modeId, "model", event.target.value)
+      }
+    ))), /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("reasoningEffort")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: cfg.reasoningEffort ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        placeholder: "",
+        title: t("reasoningEffortHint"),
+        onChange: (event) => controller.patchMode(modeId, "reasoningEffort", event.target.value)
+      }
+    )), cfg.tiers !== void 0 && Object.keys(cfg.tiers).length > 0 ? /* @__PURE__ */ React.createElement("div", { style: styles.tierRow }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("tiers")), Object.entries(cfg.tiers).map(([tierName, tier]) => /* @__PURE__ */ React.createElement("div", { key: tierName, style: styles.tierRow }, /* @__PURE__ */ React.createElement("div", { style: styles.tierHead }, /* @__PURE__ */ React.createElement("h4", { style: styles.tierName }, tierName), /* @__PURE__ */ React.createElement("span", { style: styles.tierHint }, tier.hint ?? "")), /* @__PURE__ */ React.createElement("div", { style: styles.grid2 }, /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("provider")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: tier.provider ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        onChange: (event) => controller.patchTier(modeId, tierName, "provider", event.target.value)
+      }
+    )), /* @__PURE__ */ React.createElement("label", { style: styles.field }, /* @__PURE__ */ React.createElement("span", { style: styles.fieldLabel }, t("model")), /* @__PURE__ */ React.createElement(
+      "input",
+      {
+        style: { ...styles.input, ...readOnly ? styles.inputDisabled : {} },
+        value: tier.model ?? "",
+        disabled: readOnly || ui.status === "saving",
+        spellCheck: false,
+        onChange: (event) => controller.patchTier(modeId, tierName, "model", event.target.value)
+      }
+    )))))) : null);
+  }), !readOnly ? /* @__PURE__ */ React.createElement("div", { style: styles.actions }, /* @__PURE__ */ React.createElement(
+    "button",
+    {
+      type: "button",
+      style: { ...styles.primaryButton, ...!controller.canSave ? styles.buttonDisabled : {} },
+      disabled: !controller.canSave,
+      onClick: () => {
+        controller.save();
+      }
+    },
+    ui.status === "saving" ? t("saving") : t("save")
+  ), /* @__PURE__ */ React.createElement(
+    "button",
+    {
+      type: "button",
+      style: { ...styles.secondaryButton, ...!controller.canSave ? styles.buttonDisabled : {} },
+      disabled: !controller.canSave,
+      onClick: () => {
+        controller.reset();
+      }
+    },
+    t("reset")
+  )) : null);
+}
+
+		return module.exports;
+	}
+});

package/lib/host.d.ts

@@ -0,0 +1,42 @@
+import type { Matrix } from "./sync.js";
+/**
+ * @module @carljia/omd-dsh
+ *
+ * omd-dsh host row (package root entry, injected by cordis.patch.yml):
+ *
+ *  1. registers the `omd-model-allocation` settings namespace (base = the
+ *     shipped default matrix, `applies: "live"`), making the settings
+ *     document (<DSH_HOME>/settings.yaml) the authoritative "online edit"
+ *     store for the model matrix;
+ *  2. reconciles once at startup: if <DSH_HOME>/omd-matrix.json exists and
+ *     differs from the namespace's resolved value, its content is imported
+ *     into the namespace (`replace`) — CLI edits and pre-settings installs
+ *     survive the migration, and CLI edits are picked up on the next restart;
+ *  3. renders the 7 presets from the namespace's resolved matrix and mirrors
+ *     that matrix back to omd-matrix.json (the export mirror + CLI face);
+ *  4. watches the namespace: every UI save re-renders the presets and
+ *     re-mirrors the file. New sessions route with the new matrix; running
+ *     sessions keep the combination they started with.
+ *
+ * The browser half (lib/client.js) binds the same namespace and renders the
+ * "omd模型分配" settings section (see src/client.tsx). Because the client
+ * plugin discovery (dsh-client-modules) matches loader entries by package
+ * name, the bundle patch injects THIS row under the bare package name
+ * `@carljia/omd-dsh` — not a `/boot` subpath.
+ *
+ * Failure policy: a broken settings document / namespace must never brick the
+ * host's boot — any failure here falls back to the plain file sync (the old
+ * boot behavior) and is logged.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "omd-dsh";
+/** Requires the settings service (provided by dsh-base → dsh-settings-file in every profile). */
+export declare const inject: string[];
+/**
+ * Startup reconciliation decision (pure, unit-tested): the file matrix is
+ * imported into the settings namespace exactly when it exists AND differs
+ * from the namespace's currently resolved value. Equal values need no write;
+ * a missing file leaves the namespace (defaults / user section) authoritative.
+ */
+export declare function shouldImportFile(fileMatrix: Matrix | undefined, resolved: Matrix): boolean;
+export declare function apply(ctx: any): Promise<void>;

package/lib/host.js

@@ -0,0 +1,103 @@
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { readDefaultMatrix, readMatrixFileIfExists, matrixEquals, runSyncWithMatrix, runSync, saveMatrix, MatrixSchema, MATRIX_PATH, } from "./sync.js";
+/**
+ * @module @carljia/omd-dsh
+ *
+ * omd-dsh host row (package root entry, injected by cordis.patch.yml):
+ *
+ *  1. registers the `omd-model-allocation` settings namespace (base = the
+ *     shipped default matrix, `applies: "live"`), making the settings
+ *     document (<DSH_HOME>/settings.yaml) the authoritative "online edit"
+ *     store for the model matrix;
+ *  2. reconciles once at startup: if <DSH_HOME>/omd-matrix.json exists and
+ *     differs from the namespace's resolved value, its content is imported
+ *     into the namespace (`replace`) — CLI edits and pre-settings installs
+ *     survive the migration, and CLI edits are picked up on the next restart;
+ *  3. renders the 7 presets from the namespace's resolved matrix and mirrors
+ *     that matrix back to omd-matrix.json (the export mirror + CLI face);
+ *  4. watches the namespace: every UI save re-renders the presets and
+ *     re-mirrors the file. New sessions route with the new matrix; running
+ *     sessions keep the combination they started with.
+ *
+ * The browser half (lib/client.js) binds the same namespace and renders the
+ * "omd模型分配" settings section (see src/client.tsx). Because the client
+ * plugin discovery (dsh-client-modules) matches loader entries by package
+ * name, the bundle patch injects THIS row under the bare package name
+ * `@carljia/omd-dsh` — not a `/boot` subpath.
+ *
+ * Failure policy: a broken settings document / namespace must never brick the
+ * host's boot — any failure here falls back to the plain file sync (the old
+ * boot behavior) and is logged.
+ */
+/** Cordis plugin name used by loader diagnostics. */
+export const name = "omd-dsh";
+/** Requires the settings service (provided by dsh-base → dsh-settings-file in every profile). */
+export const inject = ["settings"];
+const NS = settingsNamespace("omd-model-allocation");
+/**
+ * Startup reconciliation decision (pure, unit-tested): the file matrix is
+ * imported into the settings namespace exactly when it exists AND differs
+ * from the namespace's currently resolved value. Equal values need no write;
+ * a missing file leaves the namespace (defaults / user section) authoritative.
+ */
+export function shouldImportFile(fileMatrix, resolved) {
+    return fileMatrix !== undefined && !matrixEquals(fileMatrix, resolved);
+}
+function makeLog(ctx) {
+    return {
+        info: (message) => { try {
+            ctx?.logger?.info?.(message);
+        }
+        catch {
+            console.log(message);
+        } },
+        error: (message) => { try {
+            ctx?.logger?.error?.(message);
+        }
+        catch {
+            console.error(message);
+        } },
+    };
+}
+export async function apply(ctx) {
+    const log = makeLog(ctx);
+    const flags = { dryRun: false, verbose: false };
+    try {
+        const settings = ctx.settings; // SettingsProvider (dsh-base provides it in every profile)
+        const scope = settings.register(NS, MatrixSchema, {
+            base: readDefaultMatrix(),
+            applies: "live",
+        });
+        // 启动期调和：文件 → 命名空间（幂等；导入 CLI/旧版自定义，CLI 手改在下次重启被采纳）
+        const fileMatrix = readMatrixFileIfExists();
+        if (shouldImportFile(fileMatrix, scope.get())) {
+            log.info("omd-dsh: importing " + MATRIX_PATH + " into settings namespace " + NS);
+            await scope.replace(fileMatrix);
+        }
+        // 用命名空间解析出的完整矩阵渲染 presets，并把该矩阵写回镜像文件
+        const resolved = scope.get();
+        saveMatrix(resolved);
+        await runSyncWithMatrix(resolved, flags, log.info);
+        // 后续 UI 编辑：重渲染 + 更新镜像（watch 仅在解析值真正变化时触发）
+        scope.watch((next) => {
+            log.info("omd-dsh: matrix changed via settings — re-syncing presets and mirroring omd-matrix.json");
+            try {
+                saveMatrix(next);
+            }
+            catch (error) {
+                log.error("omd-dsh: failed to mirror " + MATRIX_PATH + ": " + (error instanceof Error ? error.message : String(error)));
+            }
+            runSyncWithMatrix(next, flags, log.info).catch((error) => log.error("omd-dsh re-sync failed: " + (error instanceof Error ? error.message : String(error))));
+        });
+    }
+    catch (error) {
+        // settings 不可用 / 命名空间已损坏时退回纯文件 sync（保持老 boot 行为）
+        log.error("omd-dsh: settings namespace failed, falling back to file sync: " + (error instanceof Error ? error.message : String(error)));
+        try {
+            await runSync(flags, log.info);
+        }
+        catch (fallbackError) {
+            log.error("omd-dsh: file sync fallback failed: " + (fallbackError instanceof Error ? fallbackError.message : String(fallbackError)));
+        }
+    }
+}

package/lib/index.js

@@ -1,5 +1,4 @@
 import z from "@deepseek-ai/schemastery";
-import { scopeOf } from "@deepseek-ai/dsh-scope";
 import { setModeOverride } from "./shared.js";
 /**
  * @module @carljia/omd-dsh
@@ -81,10 +80,10 @@ function presetSwitchedAfterLastRequest(session) {
     return lastSwitch > lastHeader;
 }
 function apply(ctx, config) {
-    if (scopeOf(ctx) === undefined) {
-        throw new Error("omd-mode: refusing to mount outside a scoped context (mode '" + config.mode + "'). " +
-            "Mount this row inside an agent preset; a global mount would pin the model for every agent in the process.");
-    }
+    // 无 scope 守卫：本行以自包含 bundle（.omd-vendor/omd-mode.mjs）分发，bundle 内
+    // 自带的 dsh-scope 副本永远读不到 harness 实例写入的 kScope Symbol，守卫会误报
+    // （曾导致全部 omd preset 挂载失败）。preset 挂载由 harness 的 loader 保证作用域；
+    // 若误挂到全局组合，后果（进程级钉模型）立即可见。见 docs/ARCHITECTURE.md。
     const pinned = config.provider !== undefined && config.model !== undefined
         ? {
             provider: config.provider,

package/lib/mode.js

@@ -1,5 +1,4 @@
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { scopeOf } from "@deepseek-ai/dsh-scope";
 /**
  * @module @carljia/omd-dsh/mode
  *
@@ -127,9 +126,7 @@ async function executeSwitch(ctx, invocation) {
     }
 }
 function apply(ctx) {
-    if (scopeOf(ctx) === undefined) {
-        throw new Error("omd-mode-switch: refusing to mount outside a scoped context; mount this row inside an agent preset");
-    }
+    // 无 scope 守卫：见 src/index.ts 的说明（自包含 bundle 无法读取 harness 的 kScope）。
     ctx.inject(["commands"], (commandCtx) => {
         commandCtx.commands.register({
             name: "mode",