dsh-advisor 0.4.1 → 0.5.0

package/lib/gateway.js

@@ -11,23 +11,24 @@
  * exactly one plain-object `args` field whose keys are the method parameter
  * names (`get()` → `{ args: {} }`; `set(patch)` → `{ args: { patch } }`).
  *
- * Data: `get` reads the `AdvisorSettingsBridge` source — the same live
- * composed config the runtime reads (schema defaults → plugin-row base →
- * settings user layer), resolved through the `resolveAdvisorConfig` hard gate
- * (the SSOT for enabled-without-pair disabled-with-reason). `set` validates
- * the patch against the `Config` schema first (unknown-key rejection
- * unchanged — the settings service itself is non-strict and would accept the
- * unknown key), then writes the USER layer in-process via
- * `ctx.settings.update` (no exposed-namespace gate on the in-process write —
- * the wire-level `exposedNamespaces()` check only guards the apiproxy path),
- * and returns the new composed value.
+ * Data: `get` reads the `AdvisorSettingsBridge` source — the same live entry
+ * config the runtime reads (volatile references unwrapped), resolved through
+ * the `resolveAdvisorConfig` hard gate (the SSOT for enabled-without-pair
+ * disabled-with-reason). `set` validates the patch against the `Config`
+ * schema first (unknown-key rejection unchanged — the settings service itself
+ * is non-strict and would accept the unknown key), then writes the advisor
+ * ENTRY config in-process via `settings.update(ADVISOR_SETTINGS_NAMESPACE, ...)`
+ * (dsh 0.1.7-rc.1: the namespace key IS the profile entry id — the bundle row
+ * id `advisor` — and the write lands through the config editor into the
+ * Loader, which commits the volatile fields and emits `loader/volatile-update`,
+ * re-applying the runtime through the bridge with no restart), and returns
+ * the new composed value.
  *
  * The settings service is OPTIONAL (no settings service → the bridge source
  * stays the entry, `get` still works; `set` fails with a clear error — KD-G5
  * fallback). The gateway captures the service through a conditional
- * `ctx.inject(['settings'], ...)` child (the same activation pattern as
- * `installAdvisorSettings`), because `ctx.settings` is only resolvable from a
- * fiber that declares it.
+ * `ctx.inject(['settings'], ...)` child, because `ctx.settings` is only
+ * resolvable from a fiber that declares it.
  *
  * The returned config is normalized to the typertGateway JSON wire boundary:
  * absent keys (provider/model/disabledReason) are OMITTED, never
@@ -38,7 +39,12 @@
  */
 import { RemoteError, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import { ADVISOR_SETTINGS_NAMESPACE } from './settings.js';
+import { parseModelPair } from './commands.js';
 import { resolveAdvisorConfig } from './config.js';
+/** Build one tagged data error (keeps every call site's shape identical). */
+export function advisorSessionError(tag, message) {
+    return { error: { tag, message } };
+}
 /**
  * The host-side `advisor` config gateway (`/api/advisor/get` +
  * `/api/advisor/set`). Registered as the cordis service key `'advisor'`
@@ -60,14 +66,27 @@ export class AdvisorConfigGateway extends TypertRemoteService {
     bridge;
     /** The live settings service once the optional inject child activates. */
     settings;
+    /**
+     * The elected owner's session face, resolved LAZILY per request. The
+     * reviewer-claiming fiber assigns it after its controller exists (the
+     * gateway is constructed before the single-reviewer claim); a `undefined`
+     * answer means this fiber owns the service key but not the reviewer role —
+     * the session endpoints answer `advisor/unavailable` in data and stay
+     * inert (no second controller, no surviving-fiber promotion).
+     */
+    sessionControl;
     /**
      * @param ctx - owning context (the plugin fiber's ctx inside `apply`).
      * @param bridge - the same `AdvisorSettingsBridge` the runtime reads, so
      *   get/set always operate on the live composed config.
+     * @param sessionControl - lazy access to the elected owner's session face
+     *   (B2); defaults to "absent" so a direct construction without the wiring
+     *   keeps the session endpoints cleanly unavailable.
      */
-    constructor(ctx, bridge) {
+    constructor(ctx, bridge, sessionControl = () => undefined) {
         super(ctx, 'advisor');
         this.bridge = bridge;
+        this.sessionControl = sessionControl;
         // The settings service is optional (no settings → entry fallback). The
         // inject child activates only when a settings service is composed, mirroring
         // installAdvisorSettings' conditional child; the returned disposer mirrors
@@ -90,8 +109,66 @@ export class AdvisorConfigGateway extends TypertRemoteService {
         return { config: this.readConfig() };
     }
     /**
-     * Validate a config patch and write it to the settings USER layer (live —
-     * the runtime re-applies through the bridge `onChange`; no restart needed).
+     * B2 — the authoritative snapshot for one live session
+     * (`/api/advisor/getSession`, args `{ sessionId }`). Read-only: never
+     * allocates override state (the snapshot rides the wiring's `sessionStatus`
+     * readback). Unknown/disposed targets answer `advisor/session-unknown`
+     * without touching the controller; a gateway without an elected owner
+     * answers `advisor/unavailable`. Business outcomes live in the returned
+     * data (plugin-domain tags) — nothing here throws coded failures and the
+     * dsh failure vocabulary stays frozen.
+     */
+    getSession(sessionId) {
+        if (typeof sessionId !== 'string' || sessionId.length === 0) {
+            return advisorSessionError('advisor/rejected', 'advisor: getSession requires a non-empty sessionId');
+        }
+        const face = this.sessionControl();
+        if (face === undefined) {
+            return advisorSessionError('advisor/unavailable', 'advisor: the session control surface is not owned by this gateway — no elected owner on this fiber');
+        }
+        return face.getSession(sessionId);
+    }
+    /**
+     * B2 — set (or reset) the per-session reviewer route for one live session
+     * (`/api/advisor/setSessionModel`, args `{ sessionId, selection }`).
+     * `selection: null` = reset (re-inherit the CURRENT global defaults; never
+     * touches the enable override). A non-null selection must be the atomic
+     * `{ provider, model }` pair and passes the SAME validation as the command
+     * face (`parseModelPair` — spec §5.3); the write itself routes through the
+     * elected owner's `AdvisorCommandController` (`setModel`/`resetModel`), so
+     * pre-commit `resolveModelInfo` validation (60 s, cancellable, no retry),
+     * per-session generation fencing, and the route-change semantics are
+     * INHERITED, not reimplemented. Unknown/disposed targets are rejected
+     * BEFORE the controller runs — no generation is allocated for a dead
+     * session. Returns the post-commit snapshot on success.
+     */
+    async setSessionModel(sessionId, selection) {
+        if (typeof sessionId !== 'string' || sessionId.length === 0) {
+            return advisorSessionError('advisor/rejected', 'advisor: setSessionModel requires a non-empty sessionId');
+        }
+        const face = this.sessionControl();
+        if (face === undefined) {
+            return advisorSessionError('advisor/unavailable', 'advisor: the session control surface is not owned by this gateway — no elected owner on this fiber');
+        }
+        // Reset arm: the wire selection is null (JSON has no undefined).
+        if (selection === null)
+            return face.resetSessionModel(sessionId);
+        // Set arm: validate the atomic pair shape BEFORE touching the controller
+        // (a malformed selection must not allocate a generation). Non-object and
+        // extra-field shapes read as absent keys → the same incomplete-pair
+        // rejection the command face reports.
+        const pair = typeof selection === 'object' && selection !== null
+            ? selection
+            : {};
+        const validated = parseModelPair(pair.provider, pair.model);
+        if (!validated.ok)
+            return advisorSessionError('advisor/rejected', `advisor: ${validated.reason}`);
+        return face.setSessionModel(sessionId, validated.provider, validated.model);
+    }
+    /**
+     * Validate a config patch and write it to the advisor ENTRY config (live —
+     * the Loader commits the volatile fields and the runtime re-applies through
+     * the bridge `onChange`; no restart needed).
      * @param patch - any subset of the config keys; unknown keys are rejected
      *   by the `Config` schema before anything is written.
      * @returns the NEW composed config after the write.
@@ -116,24 +193,30 @@ export class AdvisorConfigGateway extends TypertRemoteService {
         }
         // Wire normalization (QC tri M-2): JSON cannot carry undefined, so a
         // null-valued key is a third-party client's way of saying "absent" — the
-        // resolver already treats null as missing on read, but the raw user layer
-        // must not store it. Drop null values before the write (an all-null patch
-        // is a no-op, like the empty patch above).
+        // resolver already treats null as missing on read, but the raw entry
+        // config must not store it. Drop null values before the write (an
+        // all-null patch is a no-op, like the empty patch above).
         const normalized = Object.fromEntries(Object.entries(patch).filter(([, value]) => value !== null));
         if (Object.keys(normalized).length === 0)
             return { config: this.readConfig() };
+        // The `ns` argument is the PROFILE ENTRY id — the advisor bundle row id
+        // (`cordis.patch.yml`), not a registered namespace (0.1.7-rc.1 has no
+        // registration; entries with volatile fields surface automatically). The
+        // write goes through the config editor into the Loader, which commits the
+        // volatile references and emits `loader/volatile-update` — the bridge
+        // onChange re-apply closes the loop before this promise settles.
         await settings.update(ADVISOR_SETTINGS_NAMESPACE, normalized);
         return { config: this.readConfig() };
     }
     /**
-     * Resolve the live composed config through the hard gate. Containment
-     * (qc2 W-1): a user layer the resolver rejects (e.g. an unknown key that
-     * survived the non-strict settings schema) resolves to disabled-with-reason
-     * carrying the message — the gateway never fails the RPC on a bad user
-     * layer, and gate semantics hold (no model call can start). S1: when the
-     * raw source is still readable, the fallback seeds its scalar latches
-     * (systemPrompt / immuneTurns / maxDeltaMessages) instead of hardcoded
-     * defaults, so an invalid layer only drops the offending keys.
+     * Resolve the live entry config through the hard gate. Containment
+     * (qc2 W-1): an entry config the resolver rejects (e.g. an unknown key
+     * that survived the non-strict schemastery object merge) resolves to
+     * disabled-with-reason carrying the message — the gateway never fails the
+     * RPC on a bad config, and gate semantics hold (no model call can start).
+     * S1: when the raw source is still readable, the fallback seeds its scalar
+     * latches (systemPrompt / immuneTurns / maxDeltaMessages) instead of
+     * hardcoded defaults, so an invalid config only drops the offending keys.
      */
     readConfig() {
         let config;
@@ -211,6 +294,34 @@ export function advisorTypertContribution() {
                 ],
                 result: { mode: 'src-json' },
             },
+            // B2 — the per-session model surface (issue #88). Same explicit
+            // registration, same direct/src-json dispatch shape; the payload
+            // contract stays one plain-object `args` keyed by parameter name
+            // (`getSession` → `{ args: { sessionId } }`; `setSessionModel` →
+            // `{ args: { sessionId, selection } }`).
+            {
+                id: 'dsh-advisor#advisor/getSession',
+                service: 'advisor',
+                namespace: 'advisor',
+                method: 'getSession',
+                invocation: { kind: 'direct' },
+                parameters: [
+                    { name: 'sessionId', wire: 'sessionId', source: 'json', codec: { mode: 'src-json' } },
+                ],
+                result: { mode: 'src-json' },
+            },
+            {
+                id: 'dsh-advisor#advisor/setSessionModel',
+                service: 'advisor',
+                namespace: 'advisor',
+                method: 'setSessionModel',
+                invocation: { kind: 'direct' },
+                parameters: [
+                    { name: 'sessionId', wire: 'sessionId', source: 'json', codec: { mode: 'src-json' } },
+                    { name: 'selection', wire: 'selection', source: 'json', codec: { mode: 'src-json' } },
+                ],
+                result: { mode: 'src-json' },
+            },
         ],
     };
 }

package/lib/gateway.js.map

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

package/lib/index.d.ts

@@ -31,11 +31,11 @@
  * (`ctx.get('tuiSettingsSections') !== undefined`), so the hint names the TUI
  * `/settings` Advisor section as a write path exactly while the seam is
  * mounted; the readback itself stays session-less and read-only.
- * Settings (plan dsh-advisor-settings-n2): the plugin-row config is the
- * composition base of the `advisor` settings namespace (`src/settings.ts`),
- * read live through the bridge source; committed settings edits re-apply
- * derived state (immuneTurns / maxDeltaMessages / per-session runtimes)
- * without a restart.
+ * Settings (plan dsh-advisor-settings-n2): the plugin-row entry config's six
+ * live fields are schema-volatile (`src/config.ts`), read live through the
+ * bridge source (`src/settings.ts`); committed volatile edits (Loader
+ * `loader/volatile-update`) re-apply derived state (immuneTurns /
+ * maxDeltaMessages / per-session runtimes) without a restart.
  * Config gateway (plan dsh-advisor-settings-gateway-n5): `apply` also
  * registers the host-side `AdvisorConfigGateway` (`src/gateway.ts`) — the
  * `/api/advisor/get` + `/api/advisor/set` endpoints (explicit