@akagilnc/pi-workflow-roles 0.1.5475 → 0.1.5478

package/dist/acp-host/description.js

@@ -12,12 +12,15 @@ export function acpStdioArgs(description, model, seat) {
 }
 /**
  * The modelId the host addresses the seat model by.
- * "argv" hosts address by bare model name; "set_model" hosts address by the
- * `provider:model` modelId the ACP catalog exposes (seat provider after host
- * alias projection, concatenated — never a package provider map).
+ * "argv" hosts use the bare model on the CLI flag. "set_model" hosts use the
+ * host-native catalog form in `setModelId` (hermes `provider:model` after seat
+ * provider / host-alias projection; grok bare model — never a package map).
  */
-export function acpModelId(modelPassing, model) {
+export function acpModelId(description, model) {
     if (model?.model === undefined)
         return undefined;
-    return modelPassing === "set_model" ? `${model.provider}:${model.model}` : model.model;
+    if (description.modelPassing !== "set_model")
+        return model.model;
+    const form = description.setModelId ?? "provider:model";
+    return form === "bare" ? model.model : `${model.provider}:${model.model}`;
 }

package/dist/acp-host/production-host.js

@@ -44,15 +44,19 @@ var init_host_descriptions = __esm({
     "use strict";
     DEFAULT_ROLE_TURN_HOST = "pi";
     HOST_DESCRIPTIONS = Object.freeze({
-      /** Operator home `~/.grok`, native session/load resume, `agent [--model X] stdio`. */
+      /**
+       * Operator home `~/.grok`, native session/load resume, `agent stdio`.
+       * Model arrives as ACP `session/set_model` with bare modelId (grok catalog);
+       * argv `--model` is ignored by current grok (#1146 probe).
+       */
       "grok-build": Object.freeze({
         binaryFromHome: Object.freeze([".grok", "bin", "grok"]),
         argv: Object.freeze({
           prefix: Object.freeze(["agent"]),
-          suffix: Object.freeze(["stdio"]),
-          modelFlag: "--model"
+          suffix: Object.freeze(["stdio"])
         }),
-        modelPassing: "argv",
+        modelPassing: "set_model",
+        setModelId: "bare",
         sessionBindingFile: "grok-acp-session.json"
       }),
       /**
@@ -70,6 +74,7 @@ var init_host_descriptions = __esm({
           thinkingFlag: "--reasoning"
         }),
         modelPassing: "set_model",
+        setModelId: "provider:model",
         sessionBindingFile: "hermes-acp-session.json",
         seatProfileSoul: Object.freeze({
           flag: "-p",
@@ -24837,9 +24842,11 @@ function acpStdioArgs(description, model, seat) {
     ...suffix
   ];
 }
-function acpModelId(modelPassing, model) {
+function acpModelId(description, model) {
   if (model?.model === void 0) return void 0;
-  return modelPassing === "set_model" ? `${model.provider}:${model.model}` : model.model;
+  if (description.modelPassing !== "set_model") return model.model;
+  const form = description.setModelId ?? "provider:model";
+  return form === "bare" ? model.model : `${model.provider}:${model.model}`;
 }
 
 // src/acp-host/role-turn-host.ts
@@ -25226,7 +25233,7 @@ function createAcpRoleTurnHost(config) {
         });
         const initializeMeta = initialized._meta;
         const availableModels = Array.isArray(initializeMeta?.modelState?.availableModels) ? initializeMeta.modelState.availableModels : void 0;
-        if (request.model !== void 0 && availableModels !== void 0 && !availableModels.some((entry) => typeof entry === "object" && entry !== null && entry.modelId === acpModelId(config.modelPassing, request.model))) {
+        if (request.model !== void 0 && availableModels !== void 0 && !availableModels.some((entry) => typeof entry === "object" && entry !== null && entry.modelId === acpModelId(config, request.model))) {
           outcome = externalHostFailure("activation", "AcpHostModelMismatch", "host-model-mismatch", {
             provider: request.model.provider,
             model: request.model.model
@@ -25291,7 +25298,7 @@ function createAcpRoleTurnHost(config) {
             if (config.modelPassing === "set_model" && request.model !== void 0 && sessionId !== void 0) {
               await rpc("session/set_model", {
                 sessionId,
-                modelId: acpModelId(config.modelPassing, request.model)
+                modelId: acpModelId(config, request.model)
               });
               sessionId = await loadSession(sessionId);
             }
@@ -25512,6 +25519,7 @@ function createProductionAcpRoleTurnHost(options) {
     hostName,
     sessionIdentity: createSessionIdentityAuthority(principalAuthority, description.sessionBindingFile),
     modelPassing: description.modelPassing,
+    ...description.setModelId === void 0 ? {} : { setModelId: description.setModelId },
     roleRuntimeDependencies: createRoleRuntimeDependencies(packageRoot),
     async connect(request) {
       const seatProfile = description.seatProfileSoul;

package/dist/headless-host/production-host.js

@@ -44,15 +44,19 @@ var init_host_descriptions = __esm({
     "use strict";
     DEFAULT_ROLE_TURN_HOST = "pi";
     HOST_DESCRIPTIONS = Object.freeze({
-      /** Operator home `~/.grok`, native session/load resume, `agent [--model X] stdio`. */
+      /**
+       * Operator home `~/.grok`, native session/load resume, `agent stdio`.
+       * Model arrives as ACP `session/set_model` with bare modelId (grok catalog);
+       * argv `--model` is ignored by current grok (#1146 probe).
+       */
       "grok-build": Object.freeze({
         binaryFromHome: Object.freeze([".grok", "bin", "grok"]),
         argv: Object.freeze({
           prefix: Object.freeze(["agent"]),
-          suffix: Object.freeze(["stdio"]),
-          modelFlag: "--model"
+          suffix: Object.freeze(["stdio"])
         }),
-        modelPassing: "argv",
+        modelPassing: "set_model",
+        setModelId: "bare",
         sessionBindingFile: "grok-acp-session.json"
       }),
       /**
@@ -70,6 +74,7 @@ var init_host_descriptions = __esm({
           thinkingFlag: "--reasoning"
         }),
         modelPassing: "set_model",
+        setModelId: "provider:model",
         sessionBindingFile: "hermes-acp-session.json",
         seatProfileSoul: Object.freeze({
           flag: "-p",

package/dist/host-descriptions.js

@@ -13,15 +13,19 @@ export function resolveHostBinary(description, operatorHome) {
 }
 export const DEFAULT_ROLE_TURN_HOST = "pi";
 export const HOST_DESCRIPTIONS = Object.freeze({
-    /** Operator home `~/.grok`, native session/load resume, `agent [--model X] stdio`. */
+    /**
+     * Operator home `~/.grok`, native session/load resume, `agent stdio`.
+     * Model arrives as ACP `session/set_model` with bare modelId (grok catalog);
+     * argv `--model` is ignored by current grok (#1146 probe).
+     */
     "grok-build": Object.freeze({
         binaryFromHome: Object.freeze([".grok", "bin", "grok"]),
         argv: Object.freeze({
             prefix: Object.freeze(["agent"]),
             suffix: Object.freeze(["stdio"]),
-            modelFlag: "--model",
         }),
-        modelPassing: "argv",
+        modelPassing: "set_model",
+        setModelId: "bare",
         sessionBindingFile: "grok-acp-session.json",
     }),
     /**
@@ -39,6 +43,7 @@ export const HOST_DESCRIPTIONS = Object.freeze({
             thinkingFlag: "--reasoning",
         }),
         modelPassing: "set_model",
+        setModelId: "provider:model",
         sessionBindingFile: "hermes-acp-session.json",
         seatProfileSoul: Object.freeze({
             flag: "-p",

package/dist/migrate-book-topology.js

@@ -14736,15 +14736,19 @@ var init_host_descriptions = __esm({
   "src/host-descriptions.ts"() {
     "use strict";
     HOST_DESCRIPTIONS = Object.freeze({
-      /** Operator home `~/.grok`, native session/load resume, `agent [--model X] stdio`. */
+      /**
+       * Operator home `~/.grok`, native session/load resume, `agent stdio`.
+       * Model arrives as ACP `session/set_model` with bare modelId (grok catalog);
+       * argv `--model` is ignored by current grok (#1146 probe).
+       */
       "grok-build": Object.freeze({
         binaryFromHome: Object.freeze([".grok", "bin", "grok"]),
         argv: Object.freeze({
           prefix: Object.freeze(["agent"]),
-          suffix: Object.freeze(["stdio"]),
-          modelFlag: "--model"
+          suffix: Object.freeze(["stdio"])
         }),
-        modelPassing: "argv",
+        modelPassing: "set_model",
+        setModelId: "bare",
         sessionBindingFile: "grok-acp-session.json"
       }),
       /**
@@ -14762,6 +14766,7 @@ var init_host_descriptions = __esm({
           thinkingFlag: "--reasoning"
         }),
         modelPassing: "set_model",
+        setModelId: "provider:model",
         sessionBindingFile: "hermes-acp-session.json",
         seatProfileSoul: Object.freeze({
           flag: "-p",

package/dist/public-cli/main.js

@@ -15805,15 +15805,19 @@ var init_host_descriptions = __esm({
     "use strict";
     DEFAULT_ROLE_TURN_HOST = "pi";
     HOST_DESCRIPTIONS = Object.freeze({
-      /** Operator home `~/.grok`, native session/load resume, `agent [--model X] stdio`. */
+      /**
+       * Operator home `~/.grok`, native session/load resume, `agent stdio`.
+       * Model arrives as ACP `session/set_model` with bare modelId (grok catalog);
+       * argv `--model` is ignored by current grok (#1146 probe).
+       */
       "grok-build": Object.freeze({
         binaryFromHome: Object.freeze([".grok", "bin", "grok"]),
         argv: Object.freeze({
           prefix: Object.freeze(["agent"]),
-          suffix: Object.freeze(["stdio"]),
-          modelFlag: "--model"
+          suffix: Object.freeze(["stdio"])
         }),
-        modelPassing: "argv",
+        modelPassing: "set_model",
+        setModelId: "bare",
         sessionBindingFile: "grok-acp-session.json"
       }),
       /**
@@ -15831,6 +15835,7 @@ var init_host_descriptions = __esm({
           thinkingFlag: "--reasoning"
         }),
         modelPassing: "set_model",
+        setModelId: "provider:model",
         sessionBindingFile: "hermes-acp-session.json",
         seatProfileSoul: Object.freeze({
           flag: "-p",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.5475",
+  "version": "0.1.5478",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/src/acp-host/description.ts

@@ -18,11 +18,17 @@ export type AcpHostDescription = HostIdentityDescription & Readonly<{
   }>;
   /**
    * How the seat model reaches the agent:
-   * - "argv": passed as the CLI `--model` flag (grok);
-   * - "set_model": sent as an ACP `session/set_model` RPC with modelId
-   *   `provider:model` (hermes).
+   * - "argv": passed as the CLI `--model` flag;
+   * - "set_model": sent as an ACP `session/set_model` RPC after session new/load
+   *   and before prompt. Catalog modelId shape is `setModelId` (host-native).
    */
   modelPassing: "argv" | "set_model";
+  /**
+   * Host-native `session/set_model` modelId form when `modelPassing` is
+   * `"set_model"`. hermes catalogs are `provider:model`; grok catalogs are bare
+   * model ids. Ignored for `"argv"` hosts.
+   */
+  setModelId?: "bare" | "provider:model";
   /**
    * When set, the production factory ensures a seat profile whose SOUL.md is a
    * symlink to the packaged role soul, and prefixes argv with `flag <name>`.
@@ -51,14 +57,19 @@ export function acpStdioArgs(
 
 /**
  * The modelId the host addresses the seat model by.
- * "argv" hosts address by bare model name; "set_model" hosts address by the
- * `provider:model` modelId the ACP catalog exposes (seat provider after host
- * alias projection, concatenated — never a package provider map).
+ * "argv" hosts use the bare model on the CLI flag. "set_model" hosts use the
+ * host-native catalog form in `setModelId` (hermes `provider:model` after seat
+ * provider / host-alias projection; grok bare model — never a package map).
  */
 export function acpModelId(
-  modelPassing: AcpHostDescription["modelPassing"],
+  description: {
+    readonly modelPassing: AcpHostDescription["modelPassing"];
+    readonly setModelId?: AcpHostDescription["setModelId"] | undefined;
+  },
   model?: { readonly model?: string; readonly provider?: string },
 ): string | undefined {
   if (model?.model === undefined) return undefined;
-  return modelPassing === "set_model" ? `${model.provider}:${model.model}` : model.model;
+  if (description.modelPassing !== "set_model") return model.model;
+  const form = description.setModelId ?? "provider:model";
+  return form === "bare" ? model.model : `${model.provider}:${model.model}`;
 }

package/src/acp-host/production-host.ts

@@ -63,6 +63,7 @@ export function createProductionAcpRoleTurnHost(options: ProductionAcpHostOption
     hostName,
     sessionIdentity: createSessionIdentityAuthority(principalAuthority, description.sessionBindingFile),
     modelPassing: description.modelPassing,
+    ...(description.setModelId === undefined ? {} : { setModelId: description.setModelId }),
     roleRuntimeDependencies: createRoleRuntimeDependencies(packageRoot),
     async connect(request) {
       const seatProfile = description.seatProfileSoul;

package/src/acp-host/role-turn-host.ts

@@ -98,10 +98,13 @@ export type AcpRoleTurnHostConfig = Readonly<{
   hostName: string;
   /**
    * How the seat model reaches the agent: "set_model" sends an ACP
-   * `session/set_model` RPC with modelId `provider:model` once the session
-   * exists (new or loaded); "argv" leaves it to the connect argv (--model).
+   * `session/set_model` RPC once the session exists (new or loaded); "argv"
+   * leaves it to the connect argv (--model). Catalog modelId shape is
+   * `setModelId` (host-native).
    */
   modelPassing: AcpHostDescription["modelPassing"];
+  /** Host-native set_model catalog id; see AcpHostDescription.setModelId. */
+  setModelId?: AcpHostDescription["setModelId"];
   connect(request: RoleTurnRequest): Promise<AcpConnection>;
   prepare(request: RoleTurnRequest): Promise<PreparedRoleTurn>;
 }>;
@@ -296,7 +299,7 @@ export function createAcpRoleTurnHost(config: AcpRoleTurnHostConfig): RoleTurnHo
           : undefined;
         if (request.model !== undefined && availableModels !== undefined && !availableModels.some((entry) =>
           typeof entry === "object" && entry !== null
-          && (entry as { modelId?: unknown }).modelId === acpModelId(config.modelPassing, request.model))) {
+          && (entry as { modelId?: unknown }).modelId === acpModelId(config, request.model))) {
           outcome = failure("activation", "AcpHostModelMismatch", "host-model-mismatch", {
             provider: request.model.provider,
             model: request.model.model,
@@ -354,11 +357,11 @@ export function createAcpRoleTurnHost(config: AcpRoleTurnHostConfig): RoleTurnHo
         }
 
         if (sessionReady) {
-        // set_model seat provider:model (#778); may rebuild agent — re-bind via loadSession.
+        // set_model host-native catalog id (#778 / #1146); may rebuild agent — re-bind via loadSession.
         if (config.modelPassing === "set_model" && request.model !== undefined && sessionId !== undefined) {
           await rpc("session/set_model", {
             sessionId,
-            modelId: acpModelId(config.modelPassing, request.model),
+            modelId: acpModelId(config, request.model),
           });
           sessionId = await loadSession(sessionId);
         }

package/src/host-descriptions.ts

@@ -32,15 +32,19 @@ export const DEFAULT_ROLE_TURN_HOST = "pi" as const;
 export type HostFamily = "acp" | "headless";
 
 export const HOST_DESCRIPTIONS: Readonly<Record<string, AcpHostDescription>> = Object.freeze({
-  /** Operator home `~/.grok`, native session/load resume, `agent [--model X] stdio`. */
+  /**
+   * Operator home `~/.grok`, native session/load resume, `agent stdio`.
+   * Model arrives as ACP `session/set_model` with bare modelId (grok catalog);
+   * argv `--model` is ignored by current grok (#1146 probe).
+   */
   "grok-build": Object.freeze({
     binaryFromHome: Object.freeze([".grok", "bin", "grok"]),
     argv: Object.freeze({
       prefix: Object.freeze(["agent"]),
       suffix: Object.freeze(["stdio"]),
-      modelFlag: "--model",
     }),
-    modelPassing: "argv",
+    modelPassing: "set_model",
+    setModelId: "bare",
     sessionBindingFile: "grok-acp-session.json",
   }),
   /**
@@ -58,6 +62,7 @@ export const HOST_DESCRIPTIONS: Readonly<Record<string, AcpHostDescription>> = O
       thinkingFlag: "--reasoning",
     }),
     modelPassing: "set_model",
+    setModelId: "provider:model",
     sessionBindingFile: "hermes-acp-session.json",
     seatProfileSoul: Object.freeze({
       flag: "-p",