dsh-advisor 0.4.0 → 0.5.0

package/lib/client/index.d.ts

@@ -1,13 +1,16 @@
 /**
- * Advisor settings plugin, browser half. Registers the `advisor` card into
- * the shell-declared `settings.plugin.item` keyed slot (the "插件配置"
- * settings page — key `advisor`, the settings namespace the card edits,
- * appearing after the upstream bash / agent-loop / web-search cards in
- * registration order). The card's store joins the settings namespaces and the
- * provider directory through the connection wire, and keeps fresh on pushed
- * invalidations. Export discipline: the client half value-imports ONLY the
- * frozen platform module table (CLIENT_EXTERNALS: react /
- * `@deepseek-ai/cordis` / ui-slots / ui-primitives / the documented
+ * Advisor settings plugin, browser half. Registers the Advisor card into the
+ * shell-declared `plugins.bundle.config` keyed slot (the Plugins page's
+ * per-bundle configuration seat — key `dsh-advisor`, the bundle's package name
+ * the page dispatches, rendered on the bundle's own page between its
+ * description and its rows) and, since B2, an Advisor action into the
+ * shell-declared `conversation.session.header.actions` list slot (the
+ * per-session reviewer-model control, bound to the slot parent's SessionId —
+ * the global card stays global-only). The card's store joins the settings
+ * namespaces and the provider directory through the connection wire, and
+ * keeps fresh on pushed invalidations. Export discipline: the client half
+ * value-imports ONLY the frozen platform module table (CLIENT_EXTERNALS:
+ * react / `@deepseek-ai/cordis` / ui-slots / ui-primitives / the documented
  * `@deepseek-ai/dsh-client-store` exemption); every other
  * `@deepseek-ai/*` import is type-only (erased at build) — values arrive via
  * cordis injection (`ctx.get('connection')`, slot inject faces, the
@@ -16,8 +19,9 @@
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { type AdvisorKey } from './locales.ts';
 export type { AdvisorCardInjected, AdvisorCardProps } from './advisor-card.tsx';
+export type { AdvisorSessionActionInjected, AdvisorSessionActionProps } from './advisor-session.tsx';
 export type { AdvisorKey } from './locales.ts';
-export type { AdvisorDraft, AdvisorSettingsState, AdvisorSettingsStore, ApplyFailure, ApplyState, ModelOption, ModelsEmptyReason, ProviderOption, } from './advisor-store.ts';
+export type { AdvisorDraft, AdvisorSessionMenuState, AdvisorSessionModelController, AdvisorSessionRpcPayload, AdvisorSessionSelection, AdvisorSessionSnapshotView, AdvisorSettingsState, AdvisorSettingsStore, ApplyFailure, ApplyState, ModelOption, ModelsEmptyReason, ProviderOption, } from './advisor-store.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         /** The Advisor settings card copy. */
@@ -27,8 +31,9 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
 export { refreshIfLoaded } from './advisor-store.ts';
 /**
  * Required services (cordis fiber inject). The target slot is declared by
- * ui-plugin-config's apply, whose activation order relative to this one is
- * NOT constrained; registration depends on the slot through `slots.inject()`.
+ * ui-plugin-manager's apply (its `plugins` main-panel entry), whose activation
+ * order relative to this one is NOT constrained; registration depends on the
+ * slot through `slots.inject()`.
  *
  * rc.1 dotted-namespace contract: each client Remote namespace is a
  * child-fiber service named `remote.<ns>` (upstream `remoteServiceKey`), and
@@ -41,7 +46,7 @@ export { refreshIfLoaded } from './advisor-store.ts';
  */
 export declare const inject: string[];
 /**
- * Register the Advisor card once the `settings.plugin.item` declaration is on
+ * Register the Advisor card once the `plugins.bundle.config` declaration is on
  * the ledger, wire its store to the connection, and keep it fresh on every
  * pushed invalidation (settings or provider topology).
  * @param ctx - client root context.

package/lib/client/locales.d.ts

@@ -33,6 +33,21 @@ export declare const en: {
     saved: string;
     readOnly: string;
     namespaceUnavailable: string;
+    sessionTrigger: string;
+    sessionExpand: string;
+    sessionCollapse: string;
+    sessionLoading: string;
+    sessionModelHeading: string;
+    sessionSourceSession: string;
+    sessionSourceGlobal: string;
+    sessionNoPair: string;
+    sessionLifetime: string;
+    sessionAdvisorOff: string;
+    sessionGateBlocked: string;
+    sessionPinAction: string;
+    sessionPending: string;
+    sessionReset: string;
+    sessionUnavailable: string;
 };
 /** The settings.advisor namespace key union. */
 export type AdvisorKey = keyof typeof en;

package/lib/client.js

@@ -34,7 +34,7 @@ module.exports = __toCommonJS(index_exports);
 var import_react = require("react");
 var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 
-var css = `.kPHV8a_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s}.kPHV8a_card:hover{border-color:var(--dsw-alias-label-dimmed)}.kPHV8a_cardOpen{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}.kPHV8a_header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}.kPHV8a_header:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}.kPHV8a_headText{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}.kPHV8a_name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}.kPHV8a_description{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}.kPHV8a_chevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}.kPHV8a_chevronOpen{transform:rotate(180deg)}.kPHV8a_body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:8px}.kPHV8a_readOnly{color:var(--dsw-alias-label-tertiary);margin:12px 0 0;font-size:12px;line-height:1.5}.kPHV8a_pending{white-space:nowrap;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.kPHV8a_footer{border-top:1px solid var(--dsw-alias-border-l2);justify-content:flex-end;align-items:center;gap:8px;padding:12px 0 4px;display:flex}.kPHV8a_failed{min-width:0;color:var(--dsw-alias-label-error);flex:1;margin:0;font-size:12px;line-height:1.5}.kPHV8a_discard,.kPHV8a_save{appearance:none;font:inherit;cursor:pointer;border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5}.kPHV8a_discard{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}.kPHV8a_discard:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}.kPHV8a_save{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}.kPHV8a_discard:disabled,.kPHV8a_save:disabled{opacity:.4;cursor:default}.kPHV8a_discard:focus-visible,.kPHV8a_save:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.kPHV8a_notice{color:var(--dsw-alias-state-warn-label);margin:12px 0 0;font-size:12px;line-height:18px}.kPHV8a_savedNotice{color:var(--dsw-alias-state-success-primary);margin:12px 0 0;font-size:12px;line-height:18px}.kPHV8a_error{color:var(--dsw-alias-state-error-primary);margin:12px 0 0;font-size:12px;line-height:18px}.kPHV8a_form{flex-direction:column;gap:12px;padding:12px 0 0;display:flex}.kPHV8a_checkboxRow{align-items:center;gap:8px;display:flex}.kPHV8a_checkLabel{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.kPHV8a_checkbox{width:16px;height:16px;accent-color:var(--dsw-alias-brand-primary);cursor:pointer;margin:0}.kPHV8a_checkbox:disabled{opacity:.4;cursor:default}.kPHV8a_checkbox:focus-visible{outline:2px solid var(--dsw-alias-border-l3);outline-offset:2px}.kPHV8a_fieldset{border:none;flex-direction:column;gap:12px;margin:0;padding:0;display:flex}.kPHV8a_field{flex-direction:column;gap:6px;display:flex}.kPHV8a_fieldLabel{color:var(--dsw-alias-label-secondary);align-items:center;gap:10px;font-size:12px;font-weight:500;line-height:18px;display:inline-flex}.kPHV8a_input{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);width:100%;height:32px;font:inherit;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 10px;font-size:14px;line-height:22px}select.kPHV8a_input{cursor:pointer;max-width:240px}.kPHV8a_input:focus{border-color:var(--dsw-alias-brand-primary);outline:none}.kPHV8a_input::placeholder{color:var(--dsw-alias-label-dimmed)}.kPHV8a_input:disabled{opacity:.6;cursor:default}.kPHV8a_selectInput{appearance:none;background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12' fill='none'%3E%3Cpath d='M3 4.5L6 7.5L9 4.5' stroke='%2381858C' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E");background-position:right 12px center;background-repeat:no-repeat;background-size:12px 12px;padding-right:32px}.kPHV8a_textarea{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);width:100%;min-height:96px;font:inherit;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);resize:vertical;border-radius:8px;padding:8px 10px;font-size:14px;line-height:22px}.kPHV8a_textarea:focus{border-color:var(--dsw-alias-brand-primary);outline:none}.kPHV8a_textarea:disabled{opacity:.6;cursor:default}.kPHV8a_numberFields{grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:12px;display:grid}.kPHV8a_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.kPHV8a_warnHint{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}`;
+var css = `.kPHV8a_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;transition:border-color .16s,background .16s}.kPHV8a_card:hover{border-color:var(--dsw-alias-label-dimmed)}.kPHV8a_cardOpen{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}.kPHV8a_header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}.kPHV8a_header:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}.kPHV8a_headText{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}.kPHV8a_name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}.kPHV8a_description{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}.kPHV8a_chevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}.kPHV8a_chevronOpen{transform:rotate(180deg)}.kPHV8a_body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:8px}.kPHV8a_readOnly{color:var(--dsw-alias-label-tertiary);margin:12px 0 0;font-size:12px;line-height:1.5}.kPHV8a_pending{white-space:nowrap;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.kPHV8a_footer{border-top:1px solid var(--dsw-alias-border-l2);justify-content:flex-end;align-items:center;gap:8px;padding:12px 0 4px;display:flex}.kPHV8a_failed{min-width:0;color:var(--dsw-alias-label-error);flex:1;margin:0;font-size:12px;line-height:1.5}.kPHV8a_discard,.kPHV8a_save{appearance:none;font:inherit;cursor:pointer;border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5}.kPHV8a_discard{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}.kPHV8a_discard:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}.kPHV8a_save{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}.kPHV8a_discard:disabled,.kPHV8a_save:disabled{opacity:.4;cursor:default}.kPHV8a_discard:focus-visible,.kPHV8a_save:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.kPHV8a_notice{color:var(--dsw-alias-state-warn-label);margin:12px 0 0;font-size:12px;line-height:18px}.kPHV8a_savedNotice{color:var(--dsw-alias-state-success-primary);margin:12px 0 0;font-size:12px;line-height:18px}.kPHV8a_error{color:var(--dsw-alias-state-error-primary);margin:12px 0 0;font-size:12px;line-height:18px}.kPHV8a_form{flex-direction:column;gap:12px;padding:12px 0 0;display:flex}.kPHV8a_checkboxRow{align-items:center;gap:8px;display:flex}.kPHV8a_checkLabel{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.kPHV8a_checkbox{width:16px;height:16px;accent-color:var(--dsw-alias-brand-primary);cursor:pointer;margin:0}.kPHV8a_checkbox:disabled{opacity:.4;cursor:default}.kPHV8a_checkbox:focus-visible{outline:2px solid var(--dsw-alias-border-l3);outline-offset:2px}.kPHV8a_fieldset{border:none;flex-direction:column;gap:12px;margin:0;padding:0;display:flex}.kPHV8a_field{flex-direction:column;gap:6px;display:flex}.kPHV8a_fieldLabel{color:var(--dsw-alias-label-secondary);align-items:center;gap:10px;font-size:12px;font-weight:500;line-height:18px;display:inline-flex}.kPHV8a_input{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);width:100%;height:32px;font:inherit;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 10px;font-size:14px;line-height:22px}select.kPHV8a_input{cursor:pointer;max-width:240px}.kPHV8a_input:focus{border-color:var(--dsw-alias-brand-primary);outline:none}.kPHV8a_input::placeholder{color:var(--dsw-alias-label-dimmed)}.kPHV8a_input:disabled{opacity:.6;cursor:default}.kPHV8a_selectInput{appearance:none;background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12' fill='none'%3E%3Cpath d='M3 4.5L6 7.5L9 4.5' stroke='%2381858C' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E");background-position:right 12px center;background-repeat:no-repeat;background-size:12px 12px;padding-right:32px}.kPHV8a_textarea{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);width:100%;min-height:96px;font:inherit;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);resize:vertical;border-radius:8px;padding:8px 10px;font-size:14px;line-height:22px}.kPHV8a_textarea:focus{border-color:var(--dsw-alias-brand-primary);outline:none}.kPHV8a_textarea:disabled{opacity:.6;cursor:default}.kPHV8a_numberFields{grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:12px;display:grid}.kPHV8a_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.kPHV8a_warnHint{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}`;
 var tagId = "dsh-advisor/advisor-card.module.css";
 if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
   const tag = document.createElement("style");
@@ -80,7 +80,7 @@ function AdvisorCard(props) {
         ] }),
         state.dirty ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: advisor_card_module_css_default["pending"], children: t("unsaved") }) : null,
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-          import_dsh_client_ui_primitives.IconChevronDownOutline14,
+          import_dsh_client_ui_primitives.IconChevronDownOutlineRegular,
           {
             className: open ? `${advisor_card_module_css_default["chevron"]} ${advisor_card_module_css_default["chevronOpen"]}` : advisor_card_module_css_default["chevron"]
           }
@@ -276,12 +276,154 @@ function AdvisorCard(props) {
   } else {
     body = /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: advisor_card_module_css_default["body"] });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("li", { className: open ? `${advisor_card_module_css_default["card"]} ${advisor_card_module_css_default["cardOpen"]}` : advisor_card_module_css_default["card"], children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: open ? `${advisor_card_module_css_default["card"]} ${advisor_card_module_css_default["cardOpen"]}` : advisor_card_module_css_default["card"], children: [
     header,
     open ? body : null
   ] });
 }
 
+// src/client/advisor-session.tsx
+var import_react2 = require("react");
+
+var css2 = ".C5gNya_trigger{appearance:none;border:1px solid var(--dsw-alias-border-l2);font:inherit;color:var(--dsw-alias-label-secondary);cursor:pointer;white-space:nowrap;background:0 0;border-radius:999px;padding:3px 12px;font-size:13px;line-height:20px}.C5gNya_trigger:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}.C5gNya_trigger[aria-expanded=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-3);border-color:var(--dsw-alias-label-dimmed)}.C5gNya_trigger:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.C5gNya_anchor{display:inline-flex;position:relative}.C5gNya_panel{z-index:30;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;flex-direction:column;gap:10px;width:300px;padding:12px 14px;display:flex;position:absolute;top:calc(100% + 6px);right:0;box-shadow:0 8px 24px #0000002e}.C5gNya_panelHeading{color:var(--dsw-alias-label-primary);margin:0;font-size:13px;font-weight:600;line-height:20px}.C5gNya_routeLine{color:var(--dsw-alias-label-primary);overflow-wrap:anywhere;margin:0;font-size:13px;line-height:20px}.C5gNya_sourceBadge{white-space:nowrap;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;margin-left:6px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.C5gNya_mutedLine{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.C5gNya_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.C5gNya_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.C5gNya_controls{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:8px;padding-top:8px;display:flex}.C5gNya_selectRow{gap:8px;display:flex}.C5gNya_select{appearance:auto;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);min-width:0;color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;flex:1;padding:4px 6px;font-size:12px;line-height:18px}.C5gNya_select:disabled{opacity:.4;cursor:default}.C5gNya_select:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-1px}.C5gNya_actions{justify-content:flex-end;align-items:center;gap:8px;display:flex}.C5gNya_reset,.C5gNya_pin{appearance:none;font:inherit;cursor:pointer;border:1px solid #0000;border-radius:8px;padding:4px 12px;font-size:12px;line-height:18px}.C5gNya_reset{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}.C5gNya_reset:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}.C5gNya_pin{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}.C5gNya_reset:disabled,.C5gNya_pin:disabled{opacity:.4;cursor:default}.C5gNya_reset:focus-visible,.C5gNya_pin:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}";
+var tagId2 = "dsh-advisor/advisor-session.module.css";
+if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId2) + "]") === null) {
+  const tag = document.createElement("style");
+  tag.dataset.plugin = "dsh-advisor";
+  tag.dataset.pluginCss = tagId2;
+  tag.textContent = css2;
+  document.head.appendChild(tag);
+}
+var advisor_session_module_css_default = { "actions": "C5gNya_actions", "anchor": "C5gNya_anchor", "controls": "C5gNya_controls", "error": "C5gNya_error", "mutedLine": "C5gNya_mutedLine", "notice": "C5gNya_notice", "panel": "C5gNya_panel", "panelHeading": "C5gNya_panelHeading", "pin": "C5gNya_pin", "reset": "C5gNya_reset", "routeLine": "C5gNya_routeLine", "select": "C5gNya_select", "selectRow": "C5gNya_selectRow", "sourceBadge": "C5gNya_sourceBadge", "trigger": "C5gNya_trigger" };
+
+// src/client/advisor-session.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function AdvisorSessionAction(props) {
+  const { controller, directory, useSnapshot, useRefreshSignal, useDirectory, t } = props;
+  const state = useSnapshot((s) => s);
+  const epoch = useRefreshSignal((s) => s.epoch);
+  const directoryState = useDirectory((s) => s);
+  const [open, setOpen] = (0, import_react2.useState)(false);
+  const [provider, setProvider] = (0, import_react2.useState)("");
+  const [model, setModel] = (0, import_react2.useState)("");
+  const openAdvisor = () => {
+    setOpen(true);
+    controller.takeSignal(epoch);
+    void controller.refresh();
+    if (directoryState.status === "idle") void directory.load();
+  };
+  if (open && controller.takeSignal(epoch)) void controller.refresh();
+  const snapshot = state.snapshot;
+  const busy = state.pending;
+  const pinned = snapshot?.modelSource === "session";
+  let body;
+  if (state.unavailable) {
+    body = /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.notice, role: "status", children: t("sessionUnavailable") });
+  } else if (snapshot === null) {
+    body = /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.mutedLine, role: "status", children: t("sessionLoading") });
+  } else {
+    const pair = snapshot.effectiveModel !== void 0 ? `${snapshot.effectiveModel.provider}/${snapshot.effectiveModel.model}` : void 0;
+    body = /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
+      snapshot.enabled ? null : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.notice, children: t("sessionAdvisorOff") }),
+      snapshot.disabledReason !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.notice, children: t("sessionGateBlocked", { reason: snapshot.disabledReason }) }) : null,
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("p", { className: advisor_session_module_css_default.routeLine, children: [
+        pair === void 0 ? t("sessionNoPair") : pair,
+        pair !== void 0 && snapshot.modelSource !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: advisor_session_module_css_default.sourceBadge, children: t(snapshot.modelSource === "session" ? "sessionSourceSession" : "sessionSourceGlobal") }) : null
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.mutedLine, children: t("sessionLifetime") }),
+      state.error !== null ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.error, role: "status", children: state.error }) : null,
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: advisor_session_module_css_default.controls, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: advisor_session_module_css_default.selectRow, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+            "select",
+            {
+              "aria-label": t("provider"),
+              className: advisor_session_module_css_default.select,
+              value: provider,
+              disabled: busy,
+              onChange: (event) => {
+                const next = event.target.value;
+                setProvider(next);
+                setModel("");
+                if (next !== "") void directory.ensureModels(next);
+              },
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("option", { value: "", children: t("providerPlaceholder") }),
+                directoryState.providers.map((option) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("option", { value: option.provider, children: option.displayName }, option.provider))
+              ]
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+            "select",
+            {
+              "aria-label": t("model"),
+              className: advisor_session_module_css_default.select,
+              value: model,
+              disabled: busy || provider === "" || (directoryState.modelsByProvider[provider]?.length ?? 0) === 0,
+              onChange: (event) => {
+                setModel(event.target.value);
+              },
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("option", { value: "", children: t("modelPlaceholder") }),
+                (directoryState.modelsByProvider[provider] ?? []).map((option) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("option", { value: option.id, children: option.name }, option.id))
+              ]
+            }
+          )
+        ] }),
+        provider !== "" && (directoryState.modelsByProvider[provider]?.length ?? 0) === 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.mutedLine, children: t("noModels") }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: advisor_session_module_css_default.actions, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+            "button",
+            {
+              type: "button",
+              className: advisor_session_module_css_default.reset,
+              disabled: busy || !pinned,
+              onClick: () => {
+                void controller.resetSessionModel();
+              },
+              children: t("sessionReset")
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+            "button",
+            {
+              type: "button",
+              className: advisor_session_module_css_default.pin,
+              disabled: busy || provider === "" || model === "",
+              onClick: () => {
+                void controller.setSessionModel(provider, model);
+              },
+              children: busy ? t("sessionPending") : t("sessionPinAction")
+            }
+          )
+        ] })
+      ] })
+    ] });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: advisor_session_module_css_default.anchor, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "button",
+      {
+        type: "button",
+        className: advisor_session_module_css_default.trigger,
+        "aria-expanded": open,
+        "aria-haspopup": "dialog",
+        "aria-label": t(open ? "sessionCollapse" : "sessionExpand"),
+        onClick: () => {
+          if (open) setOpen(false);
+          else openAdvisor();
+        },
+        children: t("sessionTrigger")
+      }
+    ),
+    open ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: advisor_session_module_css_default.panel, role: "dialog", "aria-label": t("sessionModelHeading"), children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.panelHeading, children: t("sessionModelHeading") }),
+      directoryState.providers.length === 0 && directoryState.status === "ready" && !state.unavailable ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: advisor_session_module_css_default.mutedLine, children: t("noProviders") }) : null,
+      body
+    ] }) : null
+  ] });
+}
+
 // src/client/advisor-store.ts
 var import_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 function defaultDraft() {
@@ -741,6 +883,162 @@ function refreshIfLoaded(controller) {
   if (controller.store.getSnapshot().status === "idle") return;
   void controller.load();
 }
+var AdvisorSessionModelController = class {
+  constructor(sessionId, rpc) {
+    __publicField(this, "rpc", rpc);
+    __publicField(this, "sessionId");
+    /** The snapshot the menu renders from (uSES-safe store). */
+    __publicField(this, "store", (0, import_dsh_client_store.createSnapshotStore)({
+      phase: "idle",
+      snapshot: null,
+      error: null,
+      unavailable: false,
+      pending: false
+    }));
+    /** Fence token: a newer op makes every older settle stale. */
+    __publicField(this, "requestSeq", 0);
+    /** Last consumed refresh-signal epoch (reconnect / focus bumps). */
+    __publicField(this, "lastSignal");
+    this.sessionId = sessionId;
+  }
+  /**
+   * Record the refresh-signal epoch and report whether it is NEW. The open
+   * handler always refetches and merely marks the signal current; the render
+   * watcher calls this while open and refetches only on a true return (a
+   * reconnect/focus bump). Idempotent per epoch, so a re-render never
+   * double-fetches.
+   */
+  takeSignal(epoch) {
+    if (this.lastSignal === epoch) return false;
+    this.lastSignal = epoch;
+    return true;
+  }
+  /**
+   * Fetch the authoritative snapshot (`/api/advisor/getSession`). Called on
+   * menu open and on every refresh signal while open. A stale settle (a newer
+   * op superseded this fetch) touches nothing. An `advisor/unavailable` /
+   * `advisor/session-unknown` tag or a transport failure latches
+   * `unavailable` (writes stay off until a later successful refresh); other
+   * tagged outcomes leave the surface usable with the error shown.
+   */
+  async refresh() {
+    const seq = ++this.requestSeq;
+    this.store.update((s) => {
+      s.phase = "loading";
+      s.pending = false;
+      s.error = null;
+    });
+    let payload;
+    let transport;
+    try {
+      const result = await this.rpc.call("/api", "advisor/getSession", { args: { sessionId: this.sessionId } });
+      if (seq !== this.requestSeq) return;
+      if (result.ok) payload = result.value;
+      else transport = result.error.message;
+    } catch (error) {
+      if (seq !== this.requestSeq) return;
+      transport = error instanceof Error ? error.message : String(error);
+    }
+    this.applyOutcome(payload, transport, seq);
+  }
+  /**
+   * Pin the atomic `{provider, model}` pair for THIS session
+   * (`/api/advisor/setSessionModel`, selection = the pair). Refuses outright
+   * while `unavailable` (store-side defense-in-depth — an unavailable menu
+   * must never issue a write, and must never fall back to the global
+   * `advisor/set` channel). The host validates the pair through the same
+   * rules as the `/advisor model set` command face.
+   */
+  async setSessionModel(provider, model) {
+    await this.write({ provider, model });
+  }
+  /**
+   * Drop the session pin and re-inherit the CURRENT global defaults
+   * (`selection: null`). Never touches the enable override; reset to a
+   * missing global pair still succeeds — the returned snapshot reports the
+   * gate-blocked/no-call state, which the menu renders truthfully.
+   */
+  async resetSessionModel() {
+    await this.write(null);
+  }
+  /** Shared write path (both arms ride the same endpoint + fence + outcome mapping). */
+  async write(selection) {
+    if (this.store.getSnapshot().unavailable) {
+      this.store.update((s) => {
+        s.error = "advisor: the session control surface is unavailable \u2014 writes are not offered";
+      });
+      return;
+    }
+    const seq = ++this.requestSeq;
+    this.store.update((s) => {
+      s.pending = true;
+      s.error = null;
+    });
+    let payload;
+    let transport;
+    try {
+      const result = await this.rpc.call("/api", "advisor/setSessionModel", {
+        args: { sessionId: this.sessionId, selection }
+      });
+      if (seq !== this.requestSeq) return;
+      if (result.ok) payload = result.value;
+      else transport = result.error.message;
+    } catch (error) {
+      if (seq !== this.requestSeq) return;
+      transport = error instanceof Error ? error.message : String(error);
+    }
+    this.applyOutcome(payload, transport, seq);
+  }
+  /**
+   * Commit one settled outcome. Guards (seq checked by the callers before
+   * reaching here): tagged `advisor/unavailable` / `advisor/session-unknown`
+   * and transport failures latch `unavailable` (no writes offered, last good
+   * snapshot kept for context); other tagged outcomes keep the surface usable
+   * and surface the message (the host left the previous selection untouched);
+   * a snapshot commits as the new authoritative state.
+   */
+  applyOutcome(payload, transport, seq) {
+    if (seq !== this.requestSeq) return;
+    const tagged = payload?.error;
+    if (transport !== void 0 || tagged?.tag === "advisor/unavailable" || tagged?.tag === "advisor/session-unknown") {
+      this.store.update((s) => {
+        s.phase = "ready";
+        s.unavailable = true;
+        s.pending = false;
+        s.error = transport ?? tagged?.message ?? "advisor: the session control surface is unavailable";
+      });
+      return;
+    }
+    if (tagged !== void 0) {
+      this.store.update((s) => {
+        s.phase = "ready";
+        s.pending = false;
+        s.error = tagged.message;
+      });
+      return;
+    }
+    const snapshot = payload?.snapshot;
+    if (snapshot === void 0) {
+      this.store.update((s) => {
+        s.phase = "ready";
+        s.unavailable = true;
+        s.pending = false;
+        s.error = "advisor: the session endpoint returned no snapshot";
+      });
+      return;
+    }
+    this.store.update((s) => {
+      s.phase = "ready";
+      s.snapshot = snapshot;
+      s.unavailable = false;
+      s.pending = false;
+      s.error = null;
+    });
+  }
+};
+
+// src/client/index.ts
+var import_dsh_client_store2 = require("@deepseek-ai/dsh-client-store");
 
 // src/client/locales.ts
 var en = {
@@ -771,7 +1069,24 @@ var en = {
   discard: "Discard",
   saved: "Advisor settings saved. New sessions pick them up immediately.",
   readOnly: "Settings are read-only in this environment.",
-  namespaceUnavailable: "The advisor configuration channel is not available yet \u2014 the settings gateway is not ready on this host. Configure the advisor via the plugin config row \u2014 `- id: advisor` whose `config:` map sets `enabled`/`provider`/`model` (e.g. `config: { enabled: true, provider: \u2026, model: \u2026 }`) in `$DSH_HOME/profiles/<name>/cordis.patch.yml`. The advisor plugin runs fully from its plugin config row; the web settings form becomes available again on the next load once the gateway is reachable. Note: `/advisor` only toggles the advisor per session; it cannot supply provider/model."
+  namespaceUnavailable: "The advisor configuration channel is not available yet \u2014 the settings gateway is not ready on this host. Configure the advisor via the plugin config row \u2014 `- id: advisor` whose `config:` map sets `enabled`/`provider`/`model` (e.g. `config: { enabled: true, provider: \u2026, model: \u2026 }`) in `$DSH_HOME/profiles/<name>/cordis.patch.yml`. The advisor plugin runs fully from its plugin config row; the web settings form becomes available again on the next load once the gateway is reachable. Note: `/advisor` only toggles the advisor per session; it cannot supply provider/model.",
+  // Session header action (B2): the control lives on the session header and
+  // drives the live-session reviewer route only.
+  sessionTrigger: "Advisor",
+  sessionExpand: "Open the advisor controls for this session",
+  sessionCollapse: "Close the advisor controls for this session",
+  sessionLoading: "Loading\u2026",
+  sessionModelHeading: "Reviewer model for this session",
+  sessionSourceSession: "session override",
+  sessionSourceGlobal: "global default",
+  sessionNoPair: "No reviewer model \u2014 the global default has no provider/model.",
+  sessionLifetime: "Lives for this session only \u2014 never persisted; cleared on dispose or restart. A new or forked session inherits the global defaults.",
+  sessionAdvisorOff: "The advisor is off for this session.",
+  sessionGateBlocked: "No model call can start: {reason}",
+  sessionPinAction: "Pin this model",
+  sessionPending: "Applying\u2026",
+  sessionReset: "Use global default",
+  sessionUnavailable: "The advisor session control surface is not available on this host. Use /advisor model in the session, or configure the global defaults on the Plugins page."
 };
 var zh = {
   title: "\u987E\u95EE",
@@ -801,16 +1116,33 @@ var zh = {
   discard: "\u653E\u5F03\u4FEE\u6539",
   saved: "\u987E\u95EE\u8BBE\u7F6E\u5DF2\u4FDD\u5B58\u3002\u65B0\u4F1A\u8BDD\u7ACB\u5373\u751F\u6548\u3002",
   readOnly: "\u5F53\u524D\u73AF\u5883\u4E2D\u7684\u8BBE\u7F6E\u4E3A\u53EA\u8BFB\u3002",
-  namespaceUnavailable: "\u987E\u95EE\u914D\u7F6E\u901A\u9053\u6682\u4E0D\u53EF\u7528\u2014\u2014\u672C\u5BBF\u4E3B\u4E0A\u7684\u8BBE\u7F6E\u7F51\u5173\u5C1A\u672A\u5C31\u7EEA\u3002\u8BF7\u901A\u8FC7\u63D2\u4EF6\u914D\u7F6E\u884C\u914D\u7F6E\u987E\u95EE\u2014\u2014\u5728 `$DSH_HOME/profiles/<name>/cordis.patch.yml` \u4E2D\u5199 `- id: advisor`\uFF0C\u5176 `config:` \u6620\u5C04\u4E2D\u8BBE\u7F6E `enabled`/`provider`/`model`\uFF08\u4F8B\u5982 `config: { enabled: true, provider: \u2026, model: \u2026 }`\uFF09\u3002\u987E\u95EE\u63D2\u4EF6\u5B8C\u5168\u901A\u8FC7\u63D2\u4EF6\u914D\u7F6E\u884C\u8FD0\u884C\uFF1B\u7F51\u5173\u53EF\u7528\u540E\uFF0Cweb \u8BBE\u7F6E\u8868\u5355\u5C06\u5728\u4E0B\u6B21\u52A0\u8F7D\u65F6\u91CD\u65B0\u663E\u793A\u3002\u6CE8\u610F\uFF1A`/advisor` \u4EC5\u5207\u6362\u5F53\u524D\u4F1A\u8BDD\u7684\u987E\u95EE\u5F00\u5173\uFF0C\u65E0\u6CD5\u63D0\u4F9B provider/model\u3002"
+  namespaceUnavailable: "\u987E\u95EE\u914D\u7F6E\u901A\u9053\u6682\u4E0D\u53EF\u7528\u2014\u2014\u672C\u5BBF\u4E3B\u4E0A\u7684\u8BBE\u7F6E\u7F51\u5173\u5C1A\u672A\u5C31\u7EEA\u3002\u8BF7\u901A\u8FC7\u63D2\u4EF6\u914D\u7F6E\u884C\u914D\u7F6E\u987E\u95EE\u2014\u2014\u5728 `$DSH_HOME/profiles/<name>/cordis.patch.yml` \u4E2D\u5199 `- id: advisor`\uFF0C\u5176 `config:` \u6620\u5C04\u4E2D\u8BBE\u7F6E `enabled`/`provider`/`model`\uFF08\u4F8B\u5982 `config: { enabled: true, provider: \u2026, model: \u2026 }`\uFF09\u3002\u987E\u95EE\u63D2\u4EF6\u5B8C\u5168\u901A\u8FC7\u63D2\u4EF6\u914D\u7F6E\u884C\u8FD0\u884C\uFF1B\u7F51\u5173\u53EF\u7528\u540E\uFF0Cweb \u8BBE\u7F6E\u8868\u5355\u5C06\u5728\u4E0B\u6B21\u52A0\u8F7D\u65F6\u91CD\u65B0\u663E\u793A\u3002\u6CE8\u610F\uFF1A`/advisor` \u4EC5\u5207\u6362\u5F53\u524D\u4F1A\u8BDD\u7684\u987E\u95EE\u5F00\u5173\uFF0C\u65E0\u6CD5\u63D0\u4F9B provider/model\u3002",
+  sessionTrigger: "\u987E\u95EE",
+  sessionExpand: "\u6253\u5F00\u672C\u4F1A\u8BDD\u7684\u987E\u95EE\u63A7\u5236",
+  sessionCollapse: "\u5173\u95ED\u672C\u4F1A\u8BDD\u7684\u987E\u95EE\u63A7\u5236",
+  sessionLoading: "\u52A0\u8F7D\u4E2D\u2026",
+  sessionModelHeading: "\u672C\u4F1A\u8BDD\u7684\u5BA1\u9605\u6A21\u578B",
+  sessionSourceSession: "\u4F1A\u8BDD\u8986\u76D6",
+  sessionSourceGlobal: "\u5168\u5C40\u9ED8\u8BA4",
+  sessionNoPair: "\u6682\u65E0\u5BA1\u9605\u6A21\u578B\u2014\u2014\u5168\u5C40\u9ED8\u8BA4\u672A\u914D\u7F6E provider/model\u3002",
+  sessionLifetime: "\u4EC5\u5728\u672C\u4F1A\u8BDD\u5185\u6709\u6548\u2014\u2014\u4ECE\u4E0D\u6301\u4E45\u5316\uFF1B\u4F1A\u8BDD\u9500\u6BC1\u6216\u91CD\u542F\u540E\u6E05\u9664\u3002\u65B0\u5EFA\u6216\u5206\u53C9\u7684\u4F1A\u8BDD\u7EE7\u627F\u5168\u5C40\u9ED8\u8BA4\u503C\u3002",
+  sessionAdvisorOff: "\u672C\u4F1A\u8BDD\u7684\u987E\u95EE\u5DF2\u5173\u95ED\u3002",
+  sessionGateBlocked: "\u65E0\u6CD5\u53D1\u8D77\u6A21\u578B\u8C03\u7528\uFF1A{reason}",
+  sessionPinAction: "\u56FA\u5B9A\u6B64\u6A21\u578B",
+  sessionPending: "\u5E94\u7528\u4E2D\u2026",
+  sessionReset: "\u4F7F\u7528\u5168\u5C40\u9ED8\u8BA4",
+  sessionUnavailable: "\u672C\u5BBF\u4E3B\u4E0A\u7684\u987E\u95EE\u4F1A\u8BDD\u63A7\u5236\u9762\u4E0D\u53EF\u7528\u3002\u8BF7\u5728\u4F1A\u8BDD\u4E2D\u4F7F\u7528 /advisor model\uFF0C\u6216\u5728 Plugins \u9875\u914D\u7F6E\u5168\u5C40\u9ED8\u8BA4\u503C\u3002"
 };
 
 // src/client/index.ts
 var NS = "settings.advisor";
+var BUNDLE_NAME = "dsh-advisor";
 var inject = ["slots", "locale", "connection", "settingsSchema", "remote", "remote.llm", "remote.settings", "remote.session"];
 function apply(ctx) {
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), "advisor: copy dictionaries");
   const connection = ctx.get("connection");
   const controller = new AdvisorSettingsStore(ctx.remote, connection.rpc, ctx.settingsSchema);
+  const refreshSignal = (0, import_dsh_client_store2.createSnapshotStore)({ epoch: 0 });
   ctx.effect(() => {
     let pending = false;
     const refresh = () => {
@@ -819,25 +1151,30 @@ function apply(ctx) {
       queueMicrotask(() => {
         pending = false;
         refreshIfLoaded(controller);
+        refreshSignal.update((signal) => {
+          signal.epoch += 1;
+        });
       });
     };
     const disposers = [ctx.on("connection/reset", refresh)];
     disposers.push(ctx.remote.$on("settings/document-updated", refresh));
     disposers.push(ctx.remote.$on("llm/adapters-updated", refresh));
+    const onFocus = () => {
+      refresh();
+    };
+    window.addEventListener("focus", onFocus);
     return () => {
+      window.removeEventListener("focus", onFocus);
       for (const dispose of disposers) dispose();
     };
   }, "advisor: pushed invalidations");
-  ctx.slots.inject("settings.plugin.item", function* () {
+  ctx.slots.inject("plugins.bundle.config", function* () {
     yield ctx.slots.register({
-      name: "settings.plugin.item",
-      // Keyed slot: the key is the settings namespace the card edits —
-      // the already-installed `advisor` namespace (ADVISOR_SETTINGS_NAMESPACE
-      // in src/settings.ts; spelled as a literal here because the host-half
-      // settings module is outside the client bundle's externals). Keyed
-      // entries declare no `id`/`order` — appearance order is registration
-      // order, which still places this card after the upstream three.
-      key: "advisor",
+      name: "plugins.bundle.config",
+      // Keyed slot: the key is the bundle package name the page dispatches
+      // (`entryKey = pkg.name` in ui-plugin-manager's PackageDetail). Keyed
+      // entries declare no `id`/`order` — there is one entry per bundle page.
+      key: BUNDLE_NAME,
       locale: NS,
       // Hooks compartment: the renderer binds `hooks.snapshot` to the
       // component's `useSnapshot` selector hook (the old web-react
@@ -845,5 +1182,29 @@ function apply(ctx) {
       inject: () => ({ controller, hooks: { snapshot: controller.store } })
     }, AdvisorCard);
   });
+  ctx.slots.inject("conversation.session.header.actions", function* () {
+    yield ctx.slots.register({
+      name: "conversation.session.header.actions",
+      // List slot: one cell per `id` — this bundle contributes exactly one
+      // action; default order keeps registration sequencing.
+      id: BUNDLE_NAME,
+      locale: NS,
+      inject: (sessionId) => {
+        const sessionController = new AdvisorSessionModelController(sessionId, connection.rpc);
+        return {
+          sessionId,
+          controller: sessionController,
+          // READ-only directory reuse: provider/model options come from the
+          // global card's store; the session surface never writes through it.
+          directory: controller,
+          hooks: {
+            snapshot: sessionController.store,
+            refreshSignal,
+            directory: controller.store
+          }
+        };
+      }
+    }, AdvisorSessionAction);
+  });
 }
 return module.exports; } });