super-dsh 0.3.2-e → 0.3.3

package/agent-agy/dist/agent.d.ts

@@ -26,7 +26,7 @@
  * `onApiKey` (adapter state, world home only) and confirmed in the same turn.
  */
 import type { Context } from "@deepseek-ai/cordis";
-import type { Agent, AgentOptions, AgentStatus, CancelOptions, InboxTarget } from "@deepseek-ai/dsh-agent";
+import type { Agent, AgentOptions, AgentStatus, CancelOptions, InboxTarget, Model } from "@deepseek-ai/dsh-agent";
 import { Inbox } from "./inbox.js";
 import type { AgentCancelCause, Session, SessionId, UserMessage } from "@deepseek-ai/dsh-session";
 import type { TokenUsage } from "@deepseek-ai/dsh-llm";
@@ -65,6 +65,9 @@ export declare class AgyAgent implements Agent {
     readonly session: WithSystemHead<Session>;
     readonly inbox: Inbox;
     readonly ctx: Context;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    readonly model: Model;
     private readonly client;
     private readonly loopCtx;
     private readonly scope;

package/agent-agy/dist/agent.js

@@ -2,7 +2,7 @@ import { agentEvents } from "@deepseek-ai/dsh-agent";
 import { Inbox } from "./inbox.js";
 import { LlmAttemptId, ToolCallId, createAssistantMessage, createSystemMessage, createToolResultMessage } from "@deepseek-ai/dsh-llm";
 import { createScope } from "@deepseek-ai/dsh-scope";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, withSystemHead } from "../../superd-hub/dist/index.js";
 /** v2 live assistant-stream publication (same frame protocol as hermes). */
 class AssistantStreamBridge {
     attemptId;
@@ -80,6 +80,9 @@ export class AgyAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     client;
     loopCtx;
     scope;
@@ -106,6 +109,17 @@ export class AgyAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.client = client;
         this.onIdleExit = onIdleExit;
         this.runtimeInfo = runtimeInfo;

package/agent-agy/dist/index.js

@@ -21,7 +21,6 @@ import { realpathSync, statSync } from "node:fs";
 import { bindForeignHub } from "@pgmi-builds/superd-hub/foreign-hub";
 import { join } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
-import { installModelSelection } from "@deepseek-ai/dsh-agent";
 import { SessionLogOffset, SessionPreparation, interruptedTurnClosers, } from "@deepseek-ai/dsh-session";
 import { AgyCliClient } from "./agy-cli-client.js";
 import { hasSigninCredential, resolveAuthMode } from "./agy-auth.js";
@@ -475,13 +474,11 @@ async function setupAndPublish(loopCtx, ownerCtx, id, agentOptions, setup, sessi
         try {
             const selection = { provider: agentOptions.provider ?? "agy", model: agentOptions.model ?? "" };
             if (selection.model !== "") {
-                let picked = selection;
-                installModelSelection(agent.ctx, {
-                    get current() { return picked; },
-                    set current(next) { picked = next; },
-                    assembled: undefined,
-                });
-                session.append("model/selection", selection);
+                // 0.2.2: installModelSelection dropped its injected-ref parameter — the
+                // durable face (`agent.model`, the same mechanism session/selectModel
+                // uses) carries the pin: select() appends the typed, deduped
+                // `model/selection` event.
+                agent.model.select(selection);
                 trace(`session route pinned: ${selection.provider}/${selection.model}`);
             }
         }

package/agent-agy/package.json

@@ -25,12 +25,12 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
     "@pgmi-builds/superd-hub": "*"
   },
   "peerDependenciesMeta": {

package/agent-agy-sdk/dist/agent.d.ts

@@ -25,7 +25,7 @@
  * `onApiKey` (adapter state, world home only) and confirmed in the same turn.
  */
 import type { Context } from "@deepseek-ai/cordis";
-import type { Agent, AgentOptions, AgentStatus, CancelOptions, InboxTarget } from "@deepseek-ai/dsh-agent";
+import type { Agent, AgentOptions, AgentStatus, CancelOptions, InboxTarget, Model } from "@deepseek-ai/dsh-agent";
 import { Inbox } from "./inbox.js";
 import type { AgentCancelCause, Session, SessionId, UserMessage } from "@deepseek-ai/dsh-session";
 import type { TokenUsage } from "@deepseek-ai/dsh-llm";
@@ -63,6 +63,9 @@ export declare class AgyAgent implements Agent {
     readonly session: WithSystemHead<Session>;
     readonly inbox: Inbox;
     readonly ctx: Context;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    readonly model: Model;
     private readonly client;
     private readonly loopCtx;
     private readonly scope;

package/agent-agy-sdk/dist/agent.js

@@ -2,7 +2,7 @@ import { agentEvents } from "@deepseek-ai/dsh-agent";
 import { Inbox } from "./inbox.js";
 import { LlmAttemptId, ToolCallId, createAssistantMessage, createSystemMessage, createToolResultMessage } from "@deepseek-ai/dsh-llm";
 import { createScope } from "@deepseek-ai/dsh-scope";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, withSystemHead } from "../../superd-hub/dist/index.js";
 /** v2 live assistant-stream publication (same frame protocol as hermes). */
 class AssistantStreamBridge {
     attemptId;
@@ -80,6 +80,9 @@ export class AgyAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     client;
     loopCtx;
     scope;
@@ -106,6 +109,17 @@ export class AgyAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.client = client;
         this.onIdleExit = onIdleExit;
         this.runtimeInfo = runtimeInfo;

package/agent-agy-sdk/dist/index.js

@@ -26,7 +26,6 @@
 import { realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
-import { installModelSelection } from "@deepseek-ai/dsh-agent";
 import { SessionLogOffset, SessionPreparation, interruptedTurnClosers, } from "@deepseek-ai/dsh-session";
 import { AgyBridgeClient } from "./agy-client.js";
 import { registerAntigravityPreset } from "./agent-preset-agy.js";
@@ -413,13 +412,11 @@ async function setupAndPublish(loopCtx, ownerCtx, id, agentOptions, setup, sessi
         try {
             const selection = { provider: agentOptions.provider ?? "agy", model: agentOptions.model ?? "" };
             if (selection.model !== "") {
-                let picked = selection;
-                installModelSelection(agent.ctx, {
-                    get current() { return picked; },
-                    set current(next) { picked = next; },
-                    assembled: undefined,
-                });
-                session.append("model/selection", selection);
+                // 0.2.2: installModelSelection dropped its injected-ref parameter — the
+                // durable face (`agent.model`, the same mechanism session/selectModel
+                // uses) carries the pin: select() appends the typed, deduped
+                // `model/selection` event.
+                agent.model.select(selection);
                 trace(`session route pinned: ${selection.provider}/${selection.model}`);
             }
         }

package/agent-agy-sdk/package.json

@@ -27,11 +27,11 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0"
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {

package/agent-claude/dist/agent.js

@@ -50,7 +50,7 @@ import { resolveRoute, routeSeed } from "./claude-route.js";
 import { CLAUDE_PROVIDER_ID } from "./adapter.js";
 import { claudePermissionMode, presetFromEvents } from "./permission.js";
 import { catalogFromInit, modelEntryFromSdk, readModelCatalog, setModelCatalog } from "./models.js";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, withSystemHead } from "../../superd-hub/dist/index.js";
 import { registerClaudeCommands, slashCommandsFromReported, } from "./commands.js";
 /** Diagnostic trace (set CLAUDE_TRACE=1 on the dsh process to enable). */
 const TRACE = process.env.CLAUDE_TRACE === "1";
@@ -237,6 +237,9 @@ export class ClaudeAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     client;
     /** Unsubscriber for the LIVE client's wire listener — released before a swap closes the old child. */
     clientUnsubscribe = undefined;
@@ -313,6 +316,17 @@ export class ClaudeAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.client = client;
         this.clientFactory = clientFactory;
         this.onIdleExit = onIdleExit;

package/agent-claude/package.json

@@ -23,14 +23,14 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-commands": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-user-approval": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-user-questions": ">=0.1.5-0 <0.3.0-0"
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-commands": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-user-approval": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-user-questions": ">=0.2.2-0 <1.0.0-0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {

package/agent-codex/dist/agent.js

@@ -6,7 +6,7 @@ import { LlmAttemptId, ToolCallId, QUOTA_EXCEEDED_CODE, createAssistantMessage,
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { makeApprovalHandler, parseApprovalTimeout } from "./app-server-approvals.js";
 import { presetFromEvents, turnPolicyFromEvents } from "./permission.js";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, withSystemHead } from "../../superd-hub/dist/index.js";
 import { NATIVE_LAUNCH } from "./codex-launch.js";
 import { resolveRoute } from "./codex-route.js";
 /**
@@ -257,6 +257,9 @@ export class CodexAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     #client;
     #loopCtx;
     #scope;
@@ -341,6 +344,17 @@ export class CodexAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.#client = client;
         this.#onIdleExit = onIdleExit;
         this.#runtimeInfo = runtimeInfo;

package/agent-codex/package.json

@@ -32,13 +32,13 @@
 
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
     "@pgmi-builds/superd-hub": "*"
   },
   "peerDependenciesMeta": {

package/agent-codex-sdk/dist/agent.js

@@ -4,7 +4,7 @@ import { LlmAttemptId, ToolCallId, QUOTA_EXCEEDED_CODE, createAssistantMessage,
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { NATIVE_SDK_LAUNCH } from "./codex-sdk-launch.js";
 import { resolveRoute } from "./codex-route.js";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, withSystemHead } from "../../superd-hub/dist/index.js";
 /**
  * v2 live assistant-stream publication for the Codex bridge — the same frame
  * protocol the reference loop's AssistantStreamAttempt speaks (start marker,
@@ -243,6 +243,9 @@ export class CodexAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     #client;
     #loopCtx;
     #scope;
@@ -312,6 +315,17 @@ export class CodexAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.#client = client;
         this.#onIdleExit = onIdleExit;
         this.#runtimeInfo = runtimeInfo;

package/agent-codex-sdk/dist/index.js

@@ -23,7 +23,6 @@ import { OPENAI_OAUTH_ID, readEffectiveProviderStore } from "./codex-oauth.js";
 import { existsSync, realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
-import { installModelSelection } from "@deepseek-ai/dsh-agent";
 import { SessionLogOffset, SessionPreparation, interruptedTurnClosers, } from "@deepseek-ai/dsh-session";
 import { CodexSdkClient } from "./codex-sdk-client.js";
 import { CodexAgent } from "./agent.js";
@@ -659,16 +658,11 @@ async function setupAndPublish(loopCtx, ownerCtx, id, agentOptions, setup, sessi
                 // `ModelSelectionRef` (same shape the controller installs) that the
                 // next prompt's route check reads. Synchronous on purpose — the first
                 // prompt must not depend on the global default's late flush.
-                let picked = selection;
-                installModelSelection(agent.ctx, {
-                    get current() { return picked; },
-                    set current(next) { picked = next; },
-                    assembled: undefined,
-                });
-                // `model/selection` is contributed to `SessionEventMap` by the upstream
-                // session-controller package (declaration merging); this adapter does
-                // not depend on it, so the append goes through a narrow local cast.
-                session.append("model/selection", selection);
+                // 0.2.2: installModelSelection dropped its injected-ref parameter — the
+                // durable face (`agent.model`, the same mechanism session/selectModel
+                // uses) carries the pin: select() appends the typed, deduped
+                // `model/selection` event.
+                agent.model.select(selection);
                 trace(`session route pinned: ${route.provider}/${route.model}`);
             }
         }

package/agent-codex-sdk/package.json

@@ -26,13 +26,13 @@
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
     "@pgmi-builds/superd-hub": "*"
   },
   "peerDependenciesMeta": {

package/agent-hermes/dist/agent.js

@@ -4,7 +4,7 @@ import { LlmAttemptId, ToolCallId, QUOTA_EXCEEDED_CODE, createAssistantMessage,
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { GatewayRpcError, HERMES_SPAWN_ATTEMPTS } from "./hermes-client.js";
 import { approvalChoiceFromOutcome } from "./permission.js";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, withSystemHead } from "../../superd-hub/dist/index.js";
 /**
  * v2 live assistant-stream publication for the Hermes bridge — the same frame
  * protocol the reference loop's AssistantStreamAttempt speaks (start marker,
@@ -259,6 +259,9 @@ export class HermesAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     #client;
     #loopCtx;
     #scope;
@@ -319,6 +322,17 @@ export class HermesAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.#client = client;
         this.#onIdleExit = onIdleExit;
         this.#runtimeInfo = runtimeInfo;

package/agent-hermes/dist/index.js

@@ -24,7 +24,6 @@
 import { realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
-import { installModelSelection } from "@deepseek-ai/dsh-agent";
 import { SessionLogOffset, SessionPreparation, interruptedTurnClosers, } from "@deepseek-ai/dsh-session";
 import { bindForeignHub } from "@pgmi-builds/superd-hub/foreign-hub";
 import { HermesGatewayClient, HERMES_SPAWN_GRACE_MS } from "./hermes-client.js";
@@ -482,13 +481,11 @@ async function setupAndPublish(loopCtx, ownerCtx, id, agentOptions, setup, sessi
             const route = await runtimeInfo?.routeContext({ provider: agentOptions.provider, model: agentOptions.model });
             if (route !== undefined) {
                 const selection = { provider: route.provider, model: route.model };
-                let picked = selection;
-                installModelSelection(agent.ctx, {
-                    get current() { return picked; },
-                    set current(next) { picked = next; },
-                    assembled: undefined,
-                });
-                session.append("model/selection", selection);
+                // 0.2.2: installModelSelection dropped its injected-ref parameter — the
+                // durable face (`agent.model`, the same mechanism session/selectModel
+                // uses) carries the pin: select() appends the typed, deduped
+                // `model/selection` event.
+                agent.model.select(selection);
                 trace(`session route pinned: ${route.provider}/${route.model}`);
             }
         }

package/agent-hermes/package.json

@@ -26,13 +26,13 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
     "@pgmi-builds/superd-hub": "*"
   },
   "peerDependenciesMeta": {

package/agent-omp/dist/agent.js

@@ -5,7 +5,7 @@ import { LlmAttemptId, ToolCallId, QUOTA_EXCEEDED_CODE, createAssistantMessage,
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { ompPermissionCommand } from "./permission.js";
 import { getBridgeStore } from "./store/index.js";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, recordedModelSelection, withSystemHead } from "../../superd-hub/dist/index.js";
 /**
  * v2 live assistant-stream publication for the OMP bridge — the same frame
  * protocol the reference loop's AssistantStreamAttempt speaks (start marker,
@@ -255,6 +255,11 @@ export class OmpAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): recorded via `model/selection`,
+     *  resolved with the same precedence as the native AgentModel — see
+     *  {@link #recordedModelSelection}. Pushes to OMP at the next turn boundary
+     *  through the existing {@link #syncModelSelection} `set_model` path. */
+    model;
     #rpc;
     #loopCtx;
     #scope;
@@ -311,6 +316,14 @@ export class OmpAgent {
         this.#onIdleExit = onIdleExit;
         this.#dispatch = agentEvents(loopCtx, this);
         this.inbox = new Inbox();
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => this.ctx.get("agentDefaultModel")?.currentSelection(),
+        });
         this.#scope = createScope(loopCtx, this);
         this.ctx = this.#scope.ctx.extend({ agent: this });
         this.#lastTurn = session.snapshotEvents().findLast((event) => event.type === "turn/start")?.data.turn ?? 0;
@@ -649,8 +662,19 @@ export class OmpAgent {
         }
         return base;
     }
-    /** Tier-2/3 base: the session's logged header config, else the global default, else agent options. */
+    // The durable-selection fold and the `Model` face moved to the shared hub
+    // module (superd-hub agent-model-face.ts): the constructor builds `this.model`
+    // with `createAgentModelFace`, and {@link #baseModelSelection} reads the fold
+    // through the thin wrapper below.
+    #recordedModelSelection() {
+        return recordedModelSelection(this.session.snapshotEvents());
+    }
+    /** Tier-0..3 base: pending selection, else the session's logged header config, else the global default, else agent options. */
     #baseModelSelection() {
+        const pending = this.#recordedModelSelection();
+        if (pending !== null && pending.provider !== "" && pending.model !== "") {
+            return { provider: pending.provider, model: pending.model };
+        }
         const persisted = this.session.requestHeader()?.config;
         if (persisted !== undefined && persisted.provider !== "" && persisted.model !== "") {
             return { provider: persisted.provider, model: persisted.model };

package/agent-omp/package.json

@@ -34,14 +34,14 @@
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-home-paths": ">=0.2.2-0 <1.0.0-0",
     "@pgmi-builds/superd-hub": "*"
   },
   "peerDependenciesMeta": {

package/agent-omp-sdk/dist/agent.d.ts

@@ -20,7 +20,7 @@
  * are synthesized around the OMP stream.
  */
 import type { Context } from "@deepseek-ai/cordis";
-import type { Agent, AgentOptions, AgentStatus, CancelOptions, InboxTarget } from "@deepseek-ai/dsh-agent";
+import type { Agent, AgentOptions, AgentStatus, CancelOptions, InboxTarget, Model } from "@deepseek-ai/dsh-agent";
 import { Inbox } from "./inbox.js";
 import type { AgentCancelCause, Session, SessionId, UserMessage } from "@deepseek-ai/dsh-session";
 import type { ContentBlock, TokenUsage } from "@deepseek-ai/dsh-llm";
@@ -61,6 +61,9 @@ export declare class OmpAgent implements Agent {
     readonly session: WithSystemHead<Session>;
     readonly inbox: Inbox;
     readonly ctx: Context;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    readonly model: Model;
     constructor(loopCtx: Context, id: SessionId, options: AgentOptions, session: Session, rpc: OmpAgentRpc, onIdleExit?: () => void);
     get status(): AgentStatus;
     send(message: UserMessage, target: InboxTarget, wakeup: boolean): void;

package/agent-omp-sdk/dist/agent.js

@@ -4,7 +4,7 @@ import { LlmAttemptId, ToolCallId, QUOTA_EXCEEDED_CODE, createAssistantMessage,
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { ompPermissionCommand } from "./permission.js";
 import { getBridgeStore } from "./store/index.js";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, withSystemHead } from "../../superd-hub/dist/index.js";
 /**
  * v2 live assistant-stream publication for the OMP bridge — the same frame
  * protocol the reference loop's AssistantStreamAttempt speaks (start marker,
@@ -254,6 +254,9 @@ export class OmpAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     #rpc;
     #loopCtx;
     #scope;
@@ -304,6 +307,17 @@ export class OmpAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.#rpc = rpc;
         this.#onIdleExit = onIdleExit;
         this.#dispatch = agentEvents(loopCtx, this);

package/agent-omp-sdk/package.json

@@ -26,14 +26,14 @@
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-home-paths": ">=0.2.2-0 <1.0.0-0",
     "@pgmi-builds/superd-hub": "*"
   },
   "peerDependenciesMeta": {

package/agent-pi/dist/agent.js

@@ -3,7 +3,7 @@ import { randomUUID } from "node:crypto";
 import { agentEvents } from "@deepseek-ai/dsh-agent";
 import { Inbox } from "./inbox.js";
 import { LlmAttemptId, ToolCallId, QUOTA_EXCEEDED_CODE, createAssistantMessage, createSystemMessage, createToolResultMessage, createUserMessage } from "@deepseek-ai/dsh-llm";
-import { withSystemHead } from "../../superd-hub/dist/index.js";
+import { createAgentModelFace, recordedModelSelection, withSystemHead } from "../../superd-hub/dist/index.js";
 import { createScope } from "@deepseek-ai/dsh-scope";
 import { PI_IDLE_EXIT_MS } from "./knobs.js";
 import { trace } from "./knobs.js";
@@ -176,6 +176,9 @@ export class PiAgent {
     session;
     inbox;
     ctx;
+    /** Durable model selection (0.2.2 Agent face): the shared hub face over
+     *  `model/selection` events — see superd-hub agent-model-face.ts. */
+    model;
     #client;
     #loopCtx;
     #scope;
@@ -237,6 +240,17 @@ export class PiAgent {
         this.id = id;
         this.options = options;
         this.session = withSystemHead(session, () => createSystemMessage(""));
+        this.model = createAgentModelFace({
+            session: this.session,
+            options: this.options,
+            appendSelection: (selection) => {
+                this.session.append("model/selection", selection);
+            },
+            readDefault: () => {
+                const service = this.ctx.get("agentDefaultModel");
+                return service?.currentSelection?.();
+            },
+        });
         this.#client = client;
         this.#onIdleExit = onIdleExit;
         this.#runtimeInfo = runtimeInfo;
@@ -522,7 +536,11 @@ export class PiAgent {
      * LIVE (an upgrade over the codex SDK line's next-turn switch).
      */
     async #syncModelSelection() {
-        const persisted = this.session.requestHeader()?.config;
+        // 0.2.2: the recorded-selection fold (pending ?? last-used) leads the
+        // waterfall, so a `model.select` switch lands on the NEXT turn — the
+        // native precedence (pending retires only on a matching request header).
+        const recorded = recordedModelSelection(this.session.snapshotEvents());
+        const persisted = recorded ?? this.session.requestHeader()?.config;
         const service = this.ctx.get("agentDefaultModel");
         const selection = service?.currentSelection();
         const target = persisted !== undefined && persisted.provider !== "" && persisted.model !== ""

package/agent-pi/dist/index.js

@@ -29,7 +29,6 @@ import { bindForeignHub } from '@pgmi-builds/superd-hub/foreign-hub';
 import { realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
-import { installModelSelection } from "@deepseek-ai/dsh-agent";
 import { SessionLogOffset, SessionPreparation, interruptedTurnClosers, } from "@deepseek-ai/dsh-session";
 import { PiSessionClient } from "./pi-client.js";
 import { PiAgent } from "./agent.js";
@@ -514,16 +513,11 @@ async function setupAndPublish(loopCtx, ownerCtx, id, agentOptions, setup, sessi
             const route = runtimeInfo?.routeContext(agentOptions);
             if (route !== undefined) {
                 const selection = { provider: route.provider, model: route.model };
-                let picked = selection;
-                installModelSelection(agent.ctx, {
-                    get current() { return picked; },
-                    set current(next) { picked = next; },
-                    assembled: undefined,
-                });
-                // `model/selection` is contributed to `SessionEventMap` by the upstream
-                // session-controller package (declaration merging); this adapter does
-                // not depend on it, so the append goes through a narrow local cast.
-                session.append("model/selection", selection);
+                // 0.2.2: installModelSelection dropped its injected-ref parameter — the
+                // durable face (`agent.model`, the same mechanism session/selectModel
+                // uses) carries the pin: select() appends the typed, deduped
+                // `model/selection` event.
+                agent.model.select(selection);
                 trace(`session route pinned: ${route.provider}/${route.model}`);
             }
         }

package/agent-pi/package.json

@@ -27,13 +27,13 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
     "@pgmi-builds/superd-hub": "*"
   },
   "peerDependenciesMeta": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-dsh",
-  "version": "0.3.2-e",
+  "version": "0.3.3",
   "description": "Super D for the DeepSeek Harness (DSH) — one dsh plugin that mounts the superd hub (runtime selector, roster, per-runtime agents) and joins local foreign-agent runtimes (OMP, Codex, Claude, Pi, Hermes, Antigravity) into the DSH Web UI. Each runtime keeps its native home and session store; the hub only bridges.",
   "type": "module",
   "license": "MIT",
@@ -93,26 +93,26 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-api-gateway": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-commands": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-user-approval": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-user-questions": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-client-connection": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-app-boot": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-atomic-write": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-cmdline": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-plugin-manager": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-jobs": ">=0.1.5-0 <0.3.0-0"
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-api-gateway": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-commands": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-home-paths": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-tools": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-user-approval": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-user-questions": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-client-connection": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-app-boot": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-atomic-write": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-cmdline": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-plugin-manager": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-jobs": ">=0.2.2-0 <1.0.0-0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {

package/superd-hub/dist/agent-model-face.d.ts

@@ -0,0 +1,93 @@
+/**
+ * agent-model-face.ts — the 0.2.2+ `Agent.model` face for foreign-runtime
+ * bridges.
+ *
+ * dsh 0.2.2 made `model` a required `Agent` member: the Web UI's model switcher
+ * reaches every agent — native and foreign alike — through
+ * `session/selectModel` → `agent.model.select()` (session-controller
+ * commands.ts). The native `AgentModel` (dsh-agent model-selection.ts) records
+ * a `model/selection` session event durably and resolves `current()` as
+ * pending ?? lastUsed ?? live options.
+ *
+ * This module hands the foreign bridges (claude/codex/hermes/pi/agy/omp) the
+ * same semantics without mounting the projection registry:
+ *
+ *  - {@link recordedModelSelection} — the native `modelSelection` projection
+ *    fold, replayed as one pass over the session's events. A recorded
+ *    `model/selection` is the pending choice and survives non-matching
+ *    `request/header`s; a matching header retires it; `lastUsed` is the last
+ *    header's config. (The adapters that DO mount `sessionProjections` —
+ *    claude, codex — may keep reading the projection directly; both produce
+ *    the same answer.)
+ *  - {@link createAgentModelFace} — the face itself: `current()` resolves
+ *    pending → logged header → deployment default → agent options (each level
+ *    must name both halves), `select()` appends the same durable
+ *    `model/selection` event as the native face, deduped against the recorded
+ *    choice.
+ *
+ * Structural session face on the system-head pattern: the real (generic-typed)
+ * `Session` satisfies it without this package taking a dsh-agent dependency.
+ *
+ * @module superd-hub/agent-model-face
+ */
+/** A model selection: both route halves, with an optional explicit effort. */
+export interface ModelSelectionLike {
+    provider: string;
+    model: string;
+    reasoningEffort?: unknown;
+}
+/** The `Agent.model` shape (dsh-agent runtime-types `Model`), over the bridge's own selection type. */
+export interface BridgeModelFace<Sel extends ModelSelectionLike> {
+    current(): Readonly<Sel> | undefined;
+    select(selection: Readonly<Sel>): void;
+}
+/**
+ * The session slice the fold reads. Deliberately loose so the real
+ * (generic-typed) `Session` satisfies it; the events the fold inspects arrive
+ * as `unknown` data and are narrowed inside this module only.
+ */
+export interface ModelSessionFace {
+    snapshotEvents(): ReadonlyArray<{
+        type: string;
+        data: unknown;
+    }>;
+    requestHeader(): {
+        readonly config: {
+            readonly provider: string;
+            readonly model: string;
+        };
+    } | undefined;
+}
+/**
+ * The native `modelSelection` projection fold over one session's events.
+ * @param events - the session's full event snapshot (order is the log order).
+ * @returns the recorded choice — a pending selection, else the last request
+ * header's config — or `null` when the log names neither.
+ */
+export declare function recordedModelSelection(events: ReadonlyArray<{
+    type: string;
+    data: unknown;
+}>): ModelSelectionLike | null;
+/** Readers the face resolves through; each adapter wires its own sources. */
+export interface AgentModelFaceParts<Sel extends ModelSelectionLike> {
+    /** The session whose events and request header back the fold. */
+    session: ModelSessionFace;
+    /** The agent's live route options (the options fallback names both halves or neither). */
+    options: {
+        readonly provider?: string;
+        readonly model?: string;
+    };
+    /** Appends the durable `model/selection` event (the adapter's own typed append). */
+    appendSelection: (selection: Sel) => void;
+    /** Reads the deployment default (`ctx.agentDefaultModel`); absent when the service is not mounted. */
+    readDefault?: () => {
+        provider: string;
+        model: string;
+    } | undefined;
+}
+/**
+ * Build the `Agent.model` face for one foreign-runtime agent.
+ * @param parts - the session, options, typed append, and optional default reader.
+ * @returns the face; assign it to the agent's `model` member.
+ */
+export declare function createAgentModelFace<Sel extends ModelSelectionLike>(parts: AgentModelFaceParts<Sel>): BridgeModelFace<Sel>;

package/superd-hub/dist/agent-model-face.js

@@ -0,0 +1,113 @@
+/**
+ * agent-model-face.ts — the 0.2.2+ `Agent.model` face for foreign-runtime
+ * bridges.
+ *
+ * dsh 0.2.2 made `model` a required `Agent` member: the Web UI's model switcher
+ * reaches every agent — native and foreign alike — through
+ * `session/selectModel` → `agent.model.select()` (session-controller
+ * commands.ts). The native `AgentModel` (dsh-agent model-selection.ts) records
+ * a `model/selection` session event durably and resolves `current()` as
+ * pending ?? lastUsed ?? live options.
+ *
+ * This module hands the foreign bridges (claude/codex/hermes/pi/agy/omp) the
+ * same semantics without mounting the projection registry:
+ *
+ *  - {@link recordedModelSelection} — the native `modelSelection` projection
+ *    fold, replayed as one pass over the session's events. A recorded
+ *    `model/selection` is the pending choice and survives non-matching
+ *    `request/header`s; a matching header retires it; `lastUsed` is the last
+ *    header's config. (The adapters that DO mount `sessionProjections` —
+ *    claude, codex — may keep reading the projection directly; both produce
+ *    the same answer.)
+ *  - {@link createAgentModelFace} — the face itself: `current()` resolves
+ *    pending → logged header → deployment default → agent options (each level
+ *    must name both halves), `select()` appends the same durable
+ *    `model/selection` event as the native face, deduped against the recorded
+ *    choice.
+ *
+ * Structural session face on the system-head pattern: the real (generic-typed)
+ * `Session` satisfies it without this package taking a dsh-agent dependency.
+ *
+ * @module superd-hub/agent-model-face
+ */
+/** One recorded selection read structurally; incomplete routes answer `null`. */
+function selectionOf(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const { provider, model } = value;
+    if (typeof provider !== 'string' || provider === '' || typeof model !== 'string' || model === '')
+        return null;
+    const reasoningEffort = value.reasoningEffort;
+    return {
+        provider,
+        model,
+        ...(typeof reasoningEffort === 'string' && reasoningEffort !== ''
+            ? { reasoningEffort }
+            : {}),
+    };
+}
+/** Route equality without the effort, and full equality with it (the fold's own rules). */
+function sameRoute(left, right) {
+    return left.provider === right.provider && left.model === right.model;
+}
+function sameSelection(left, right) {
+    return sameRoute(left, right) && left.reasoningEffort === right.reasoningEffort;
+}
+/**
+ * The native `modelSelection` projection fold over one session's events.
+ * @param events - the session's full event snapshot (order is the log order).
+ * @returns the recorded choice — a pending selection, else the last request
+ * header's config — or `null` when the log names neither.
+ */
+export function recordedModelSelection(events) {
+    let pending = null;
+    let lastUsed = null;
+    for (const event of events) {
+        if (event.type === 'model/selection') {
+            const selection = selectionOf(event.data);
+            if (selection !== null && !(pending !== null && sameSelection(pending, selection)))
+                pending = selection;
+        }
+        else if (event.type === 'request/header') {
+            const header = event.data;
+            const config = header === null || typeof header !== 'object' ? undefined : header.header?.config;
+            const selection = selectionOf(config);
+            if (selection !== null) {
+                lastUsed = selection;
+                if (pending !== null && sameRoute(pending, selection))
+                    pending = null;
+            }
+        }
+    }
+    return pending ?? lastUsed;
+}
+/**
+ * Build the `Agent.model` face for one foreign-runtime agent.
+ * @param parts - the session, options, typed append, and optional default reader.
+ * @returns the face; assign it to the agent's `model` member.
+ */
+export function createAgentModelFace(parts) {
+    const recorded = () => recordedModelSelection(parts.session.snapshotEvents());
+    const current = () => {
+        const fold = recorded();
+        if (fold !== null)
+            return { ...fold };
+        const preferred = parts.readDefault?.();
+        if (preferred !== undefined && preferred.provider !== '' && preferred.model !== '') {
+            return { provider: preferred.provider, model: preferred.model };
+        }
+        const { provider, model } = parts.options;
+        return provider !== undefined && provider !== '' && model !== undefined && model !== ''
+            ? { provider, model }
+            : undefined;
+    };
+    return {
+        current,
+        select(selection) {
+            const fold = recorded();
+            if (fold !== null && sameSelection(fold, selection))
+                return;
+            parts.appendSelection({ ...selection });
+        },
+    };
+}

package/superd-hub/dist/index.d.ts

@@ -36,6 +36,7 @@ export { createOwnershipIndex, type OwnershipIndex, type OwnershipRow } from './
 export { registerHostMount, takeHostMount, listHostMounts, noteWorldServer, worldServerOf, type HostMount } from './world-host.js';
 export { worldMountPatches, superdTrustedHosts, WORLD_WAVE1_DISABLED_ROWS, WORLD_WAVE2_DISABLED_ROWS, WORLD_MOUNT_PLUGIN, WORLD_MOUNT_ROW_ID, WORLD_HUB_PLUGIN, WORLD_HUB_ROW_ID, type WorldPatchLayer, } from './world-mount.js';
 export { withSystemHead, type HeadAwareSessionFace, type HeadPlaceholder, type WithSystemHead } from './system-head.js';
+export { createAgentModelFace, recordedModelSelection, type AgentModelFaceParts, type BridgeModelFace, type ModelSelectionLike, type ModelSessionFace, } from './agent-model-face.js';
 export { default as worldApply, name as worldPluginName, type Config as WorldEntryConfig } from './world-entry.js';
 export { default as joinApply, name as worldJoinPluginName, type Config as WorldJoinConfig } from './world-join.js';
 export { createA2aService, A2A_MESSAGE_TEMPLATE, A2A_UNTITLED, A2A_BUFFER_MAX, A2A_NO_SESSION_CLOSE_REASON, A2A_NO_TURN_ACTIVE_NOTE, renderA2aEnvelope, loadConversations, saveConversations, shortIdFor, isDegenerateShortId, migrateConversations, type A2aService, subscribeSessionCompletion, sessionRpc, turnLivenessOf, addressErrorBody, type A2aSessionSource, type A2aGateway, type A2aAddress, type A2aInitiator, type A2aDelivery, type A2aSendRequest, type A2aReceipt, type A2aReceiptOutcome, type A2aReceiptError, type A2aConversationRef, type A2aCompletion, type A2aCompletionCb, type A2aErrorCb, type A2aSubscribeOptions, type A2aStopScope, type A2aStopResult, type A2aBufferedMessage, type A2aBufferInput, type ConversationRow, type ConversationsFile, } from './a2a-service.js';

package/superd-hub/dist/index.js

@@ -36,6 +36,7 @@ export { createOwnershipIndex } from './ownership.js';
 export { registerHostMount, takeHostMount, listHostMounts, noteWorldServer, worldServerOf } from './world-host.js';
 export { worldMountPatches, superdTrustedHosts, WORLD_WAVE1_DISABLED_ROWS, WORLD_WAVE2_DISABLED_ROWS, WORLD_MOUNT_PLUGIN, WORLD_MOUNT_ROW_ID, WORLD_HUB_PLUGIN, WORLD_HUB_ROW_ID, } from './world-mount.js';
 export { withSystemHead } from './system-head.js';
+export { createAgentModelFace, recordedModelSelection, } from './agent-model-face.js';
 export { default as worldApply, name as worldPluginName } from './world-entry.js';
 export { default as joinApply, name as worldJoinPluginName } from './world-join.js';
 export { createA2aService, A2A_MESSAGE_TEMPLATE, A2A_UNTITLED, A2A_BUFFER_MAX, A2A_NO_SESSION_CLOSE_REASON, A2A_NO_TURN_ACTIVE_NOTE, renderA2aEnvelope, loadConversations, saveConversations, shortIdFor, isDegenerateShortId, migrateConversations, 

package/superd-hub/dist/world-entry.js

@@ -1,3 +1,4 @@
+import { modelSelectionProjectionDefinition } from '@deepseek-ai/dsh-agent';
 import { noteWorldServer, publishWorldFetch, takeHostMount } from './world-host.js';
 import { WorldWebServer } from './world-web-server.js';
 import { superdTrustedHosts } from './world-mount.js';
@@ -43,6 +44,35 @@ export function apply(ctx, config) {
             dropWorldFetch = publishWorldFetch(key, connection.createSharedFetchHandler('/api'), mount);
         }
     });
+    // 0.2.2: register the `modelSelection` projection in THIS world's registry.
+    // Upstream's only registrant is the agent-loop row (agent-loop/src:334),
+    // which wave-1 minimization keeps out of world trees — without it the
+    // native model seat's projection frame never resolves and the trigger
+    // label stays "loading models…" forever (the catalog and selectModel RPC
+    // take different paths, which is why they keep working). The definition is
+    // a pure event fold (`model/selection` + `request/header`), no loop
+    // machinery; register() is ref-counted and duplicate-tolerant, so a future
+    // tree that also mounts agent-loop shares the registration cleanly.
+    ctx.inject(['sessionProjections'], (projCtx) => {
+        const projections = projCtx.get('sessionProjections');
+        if (projections === undefined)
+            return;
+        let disposed = false;
+        let handle;
+        void projections.register(modelSelectionProjectionDefinition).then((registered) => {
+            if (disposed) {
+                void registered.dispose();
+                return;
+            }
+            handle = registered;
+        }, (error) => {
+            ctx.logger?.warn?.(`superd-world-mount: modelSelection projection registration failed: ${String(error)}`);
+        });
+        return () => {
+            disposed = true;
+            void handle?.dispose();
+        };
+    });
     ctx.effect(() => () => {
         dropWorldFetch?.();
     }, 'superd-world-mount: virtual webServer');

package/superd-hub/package.json

@@ -45,16 +45,17 @@
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",
     "@deepseek-ai/cordis": "*",
-    "@deepseek-ai/dsh-api-gateway": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-client-connection": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-app-boot": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-atomic-write": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-cmdline": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-plugin-manager": ">=0.1.5-0 <0.3.0-0"
+    "@deepseek-ai/dsh-agent": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-api-gateway": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-home-paths": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-tools": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-client-connection": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-app-boot": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-atomic-write": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-cmdline": ">=0.2.2-0 <1.0.0-0",
+    "@deepseek-ai/dsh-plugin-manager": ">=0.2.2-0 <1.0.0-0"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {
@@ -66,6 +67,9 @@
     "@deepseek-ai/dsh-api-gateway": {
       "optional": true
     },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-home-paths": {
       "optional": true
     },