@akagilnc/pi-workflow-roles 0.1.3439 → 0.1.3445

package/dist/evidence-child-executor.js

@@ -802,7 +802,7 @@ function createNativeNavigatorSessionFactory(defaultModelSettingPath = navigator
         }
       },
       entries: () => sessionManager.getEntries(),
-      setModel: async (next, nextThinking) => {
+      setModel: async (next) => {
         let nextParsed;
         try {
           nextParsed = parseNavigatorModelSetting(next);
@@ -815,16 +815,10 @@ function createNativeNavigatorSessionFactory(defaultModelSettingPath = navigator
             `Navigator model switch requires a new session: ${configuredLabel} \u2192 ${next}`
           );
         }
-        if (nextParsed.thinkingLevel !== nextThinking || thinkingLevel !== nextThinking) {
-          throw new NavigatorUnavailableError(
-            "thinking",
-            `Navigator thinking level ${nextThinking} is unavailable for ${next}`
-          );
-        }
         selection = {
           provider: nextParsed.provider,
           model: nextParsed.model,
-          thinking: nextParsed.thinkingLevel
+          ...nextParsed.thinkingLevel === void 0 ? {} : { thinking: nextParsed.thinkingLevel }
         };
         thinkingLevel = nextParsed.thinkingLevel;
         configuredLabel = next;

package/dist/grok/production-host.js

@@ -750,7 +750,7 @@ async function openPiInstitutionalSession(options) {
       api: fallbackApi,
       provider: selection.provider,
       baseUrl: providerDefaultModel?.baseUrl ?? "",
-      reasoning: selection.thinking !== void 0 && selection.thinking !== "off",
+      reasoning: providerDefaultModel?.reasoning ?? false,
       input: ["text"],
       cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
       contextWindow: 128e3,
@@ -1049,11 +1049,10 @@ async function openPiInstitutionalSession(options) {
         });
       }
     }
-    const requestedThinking = options.selection.thinking === "max" ? "max" : "off";
     const { session } = await createAgentSession({
       cwd: options.cwd,
       model: effectiveModel,
-      thinkingLevel: requestedThinking,
+      ...options.selection.thinking === void 0 ? {} : { thinkingLevel: options.selection.thinking },
       modelRuntime: runtime,
       sessionManager,
       settingsManager: settings,
@@ -1063,15 +1062,6 @@ async function openPiInstitutionalSession(options) {
       ...options.toolsAllowlist === void 0 ? {} : { tools: options.toolsAllowlist },
       ...customTools.length === 0 ? {} : { customTools }
     });
-    if (requestedThinking === "max" && session.thinkingLevel !== "max") {
-      session.dispose();
-      throw withTypedReason(
-        new Error(
-          `${label} thinking level max is unavailable for ${selection.provider}/${selection.model}`
-        ),
-        "thinking"
-      );
-    }
     const listeners = /* @__PURE__ */ new Set();
     const accumulatedUsage = emptyUsage();
     let lastEmittedAssistant;
@@ -3980,33 +3970,29 @@ async function readNavigatorModelSetting(path = navigatorModelSettingPath()) {
 function parseNavigatorModelSetting(value) {
   const slash = value.indexOf("/");
   if (slash <= 0 || slash === value.length - 1) {
-    throw new Error("Navigator model setting must be provider/model[:max]");
+    throw new Error("Navigator model setting must be provider/model[:thinking]");
   }
   const provider = value.slice(0, slash);
   const modelWithThinking = value.slice(slash + 1);
   const colon = modelWithThinking.lastIndexOf(":");
   const suffix = colon < 0 ? void 0 : modelWithThinking.slice(colon + 1);
-  if (suffix !== void 0 && suffix !== "max") {
-    throw new Error("Navigator model setting must use :max or omit the thinking suffix");
-  }
   const model = colon < 0 ? modelWithThinking : modelWithThinking.slice(0, colon);
   if (model === "") throw new Error("Navigator model setting must include a model");
-  return { provider, model, thinkingLevel: suffix === "max" ? "max" : "off" };
+  return suffix === void 0 ? { provider, model } : { provider, model, thinkingLevel: suffix };
 }
 async function resolveNavigatorSeatSelection(context, modelSettingPath, defaultModelSettingPath) {
   const runDirectory = auditorRunDirectory(context);
   if (runDirectory !== void 0) {
     try {
       const selection = await readInstitutionalSeatSelection(runDirectory, "navigator");
-      const thinkingLevel = selection.thinking === "max" ? "max" : "off";
       return {
         selection: {
           provider: selection.provider,
           model: selection.model,
           ...selection.thinking === void 0 ? {} : { thinking: selection.thinking }
         },
-        configuredLabel: `${selection.provider}/${selection.model}${thinkingLevel === "max" ? ":max" : ""}`,
-        thinkingLevel
+        configuredLabel: selection.thinking === void 0 ? `${selection.provider}/${selection.model}` : `${selection.provider}/${selection.model}:${selection.thinking}`,
+        ...selection.thinking === void 0 ? {} : { thinkingLevel: selection.thinking }
       };
     } catch (error) {
       if (error instanceof InstitutionalResolutionError && (error.reason === "missing-page" || error.reason === "missing-seat")) {
@@ -4031,10 +4017,10 @@ async function resolveNavigatorSeatSelection(context, modelSettingPath, defaultM
     selection: {
       provider: parsed.provider,
       model: parsed.model,
-      thinking: parsed.thinkingLevel
+      ...parsed.thinkingLevel === void 0 ? {} : { thinking: parsed.thinkingLevel }
     },
     configuredLabel: configured,
-    thinkingLevel: parsed.thinkingLevel
+    ...parsed.thinkingLevel === void 0 ? {} : { thinkingLevel: parsed.thinkingLevel }
   };
 }
 
@@ -4852,7 +4838,7 @@ function createNativeNavigatorSessionFactory(defaultModelSettingPath = navigator
         }
       },
       entries: () => sessionManager.getEntries(),
-      setModel: async (next, nextThinking) => {
+      setModel: async (next) => {
         let nextParsed;
         try {
           nextParsed = parseNavigatorModelSetting(next);
@@ -4865,16 +4851,10 @@ function createNativeNavigatorSessionFactory(defaultModelSettingPath = navigator
             `Navigator model switch requires a new session: ${configuredLabel} \u2192 ${next}`
           );
         }
-        if (nextParsed.thinkingLevel !== nextThinking || thinkingLevel !== nextThinking) {
-          throw new NavigatorUnavailableError(
-            "thinking",
-            `Navigator thinking level ${nextThinking} is unavailable for ${next}`
-          );
-        }
         selection = {
           provider: nextParsed.provider,
           model: nextParsed.model,
-          thinking: nextParsed.thinkingLevel
+          ...nextParsed.thinkingLevel === void 0 ? {} : { thinking: nextParsed.thinkingLevel }
         };
         thinkingLevel = nextParsed.thinkingLevel;
         configuredLabel = next;
@@ -6195,9 +6175,6 @@ ${text}
         try {
           await created.setModel?.(modelSetting, model.thinkingLevel);
           if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-          if (created.getThinkingLevel?.() !== void 0 && created.getThinkingLevel() !== model.thinkingLevel) {
-            throw new NavigatorUnavailableError("thinking", `Navigator thinking level ${model.thinkingLevel} is unavailable for ${modelSetting}`);
-          }
           created.appendEntry(INVOCATION_ENTRY, { invocationId, role: options.role, phase: options.phase, subjectKey });
           if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
           session = created;
@@ -6212,9 +6189,6 @@ ${text}
     } else {
       try {
         await session.setModel?.(modelSetting, model.thinkingLevel);
-        if (session.getThinkingLevel?.() !== void 0 && session.getThinkingLevel() !== model.thinkingLevel) {
-          throw new NavigatorUnavailableError("thinking", `Navigator thinking level ${model.thinkingLevel} is unavailable for ${modelSetting}`);
-        }
       } catch (error) {
         throw error instanceof NavigatorUnavailableError ? error : navigatorUnavailableError("session", error);
       }

package/dist/navigator-attendance.js

@@ -396,9 +396,6 @@ ${text}
         try {
           await created.setModel?.(modelSetting, model.thinkingLevel);
           if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-          if (created.getThinkingLevel?.() !== void 0 && created.getThinkingLevel() !== model.thinkingLevel) {
-            throw new NavigatorUnavailableError("thinking", `Navigator thinking level ${model.thinkingLevel} is unavailable for ${modelSetting}`);
-          }
           created.appendEntry(INVOCATION_ENTRY, { invocationId, role: options.role, phase: options.phase, subjectKey });
           if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
           session = created;
@@ -413,9 +410,6 @@ ${text}
     } else {
       try {
         await session.setModel?.(modelSetting, model.thinkingLevel);
-        if (session.getThinkingLevel?.() !== void 0 && session.getThinkingLevel() !== model.thinkingLevel) {
-          throw new NavigatorUnavailableError("thinking", `Navigator thinking level ${model.thinkingLevel} is unavailable for ${modelSetting}`);
-        }
       } catch (error) {
         throw error instanceof NavigatorUnavailableError ? error : navigatorUnavailableError("session", error);
       }

package/dist/navigator-session-contracts.js

@@ -151,33 +151,29 @@ async function writeNavigatorModelSetting(model, path = navigatorModelSettingPat
 function parseNavigatorModelSetting(value) {
   const slash = value.indexOf("/");
   if (slash <= 0 || slash === value.length - 1) {
-    throw new Error("Navigator model setting must be provider/model[:max]");
+    throw new Error("Navigator model setting must be provider/model[:thinking]");
   }
   const provider = value.slice(0, slash);
   const modelWithThinking = value.slice(slash + 1);
   const colon = modelWithThinking.lastIndexOf(":");
   const suffix = colon < 0 ? void 0 : modelWithThinking.slice(colon + 1);
-  if (suffix !== void 0 && suffix !== "max") {
-    throw new Error("Navigator model setting must use :max or omit the thinking suffix");
-  }
   const model = colon < 0 ? modelWithThinking : modelWithThinking.slice(0, colon);
   if (model === "") throw new Error("Navigator model setting must include a model");
-  return { provider, model, thinkingLevel: suffix === "max" ? "max" : "off" };
+  return suffix === void 0 ? { provider, model } : { provider, model, thinkingLevel: suffix };
 }
 async function resolveNavigatorSeatSelection(context, modelSettingPath, defaultModelSettingPath) {
   const runDirectory = auditorRunDirectory(context);
   if (runDirectory !== void 0) {
     try {
       const selection = await readInstitutionalSeatSelection(runDirectory, "navigator");
-      const thinkingLevel = selection.thinking === "max" ? "max" : "off";
       return {
         selection: {
           provider: selection.provider,
           model: selection.model,
           ...selection.thinking === void 0 ? {} : { thinking: selection.thinking }
         },
-        configuredLabel: `${selection.provider}/${selection.model}${thinkingLevel === "max" ? ":max" : ""}`,
-        thinkingLevel
+        configuredLabel: selection.thinking === void 0 ? `${selection.provider}/${selection.model}` : `${selection.provider}/${selection.model}:${selection.thinking}`,
+        ...selection.thinking === void 0 ? {} : { thinkingLevel: selection.thinking }
       };
     } catch (error) {
       if (error instanceof InstitutionalResolutionError && (error.reason === "missing-page" || error.reason === "missing-seat")) {
@@ -202,10 +198,10 @@ async function resolveNavigatorSeatSelection(context, modelSettingPath, defaultM
     selection: {
       provider: parsed.provider,
       model: parsed.model,
-      thinking: parsed.thinkingLevel
+      ...parsed.thinkingLevel === void 0 ? {} : { thinking: parsed.thinkingLevel }
     },
     configuredLabel: configured,
-    thinkingLevel: parsed.thinkingLevel
+    ...parsed.thinkingLevel === void 0 ? {} : { thinkingLevel: parsed.thinkingLevel }
   };
 }
 export {

package/dist/pi/in-process-session.js

@@ -158,7 +158,7 @@ async function openPiInstitutionalSession(options) {
       api: fallbackApi,
       provider: selection.provider,
       baseUrl: providerDefaultModel?.baseUrl ?? "",
-      reasoning: selection.thinking !== void 0 && selection.thinking !== "off",
+      reasoning: providerDefaultModel?.reasoning ?? false,
       input: ["text"],
       cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
       contextWindow: 128e3,
@@ -457,11 +457,10 @@ async function openPiInstitutionalSession(options) {
         });
       }
     }
-    const requestedThinking = options.selection.thinking === "max" ? "max" : "off";
     const { session } = await createAgentSession({
       cwd: options.cwd,
       model: effectiveModel,
-      thinkingLevel: requestedThinking,
+      ...options.selection.thinking === void 0 ? {} : { thinkingLevel: options.selection.thinking },
       modelRuntime: runtime,
       sessionManager,
       settingsManager: settings,
@@ -471,15 +470,6 @@ async function openPiInstitutionalSession(options) {
       ...options.toolsAllowlist === void 0 ? {} : { tools: options.toolsAllowlist },
       ...customTools.length === 0 ? {} : { customTools }
     });
-    if (requestedThinking === "max" && session.thinkingLevel !== "max") {
-      session.dispose();
-      throw withTypedReason(
-        new Error(
-          `${label} thinking level max is unavailable for ${selection.provider}/${selection.model}`
-        ),
-        "thinking"
-      );
-    }
     const listeners = /* @__PURE__ */ new Set();
     const accumulatedUsage = emptyUsage();
     let lastEmittedAssistant;

package/dist/public-cli/config.js

@@ -18,15 +18,6 @@ const GATE_OFFICER_SEATS = [
 function isGateOfficerSeat(value) {
   return GATE_OFFICER_SEATS.includes(value);
 }
-const THINKING_LEVELS = /* @__PURE__ */ new Set([
-  "off",
-  "minimal",
-  "low",
-  "medium",
-  "high",
-  "xhigh",
-  "max"
-]);
 function publicCliConfigPath(home) {
   if (typeof home !== "string" || home.trim() === "") {
     throw new Error("home must be explicitly provided");
@@ -169,13 +160,7 @@ function parseModelSpec(spec, fallbackThinking) {
   let modelPart = trimmed;
   let thinking = fallbackThinking;
   if (thinkingSplit !== -1) {
-    const maybeThinking = trimmed.slice(thinkingSplit + 1);
-    if (!THINKING_LEVELS.has(maybeThinking)) {
-      throw new Error(
-        `model specification must be provider/model[:thinking], got ${spec}`
-      );
-    }
-    thinking = maybeThinking;
+    thinking = trimmed.slice(thinkingSplit + 1);
     modelPart = trimmed.slice(0, thinkingSplit);
   }
   const slash = modelPart.indexOf("/");
@@ -286,10 +271,8 @@ function parseSeatModelConfig(value, seat) {
   if (typeof raw.model !== "string" || raw.model.trim() === "") {
     throw new Error(`config seat ${seat} requires model`);
   }
-  if (raw.thinking !== void 0) {
-    if (typeof raw.thinking !== "string" || !THINKING_LEVELS.has(raw.thinking)) {
-      throw new Error(`config seat ${seat} requires a valid thinking level`);
-    }
+  if (raw.thinking !== void 0 && typeof raw.thinking !== "string") {
+    throw new Error(`config seat ${seat} thinking must be a string`);
   }
   const parsed = {
     provider: raw.provider,
@@ -443,7 +426,6 @@ async function loadCredentialProviders(agentDir) {
 }
 export {
   GATE_OFFICER_SEATS,
-  THINKING_LEVELS,
   buildSeatModelCliArgs,
   clearPersistentSeatConfig,
   credentialProvidersFromAuthData,

package/dist/public-cli/main.js

@@ -15537,13 +15537,7 @@ function parseModelSpec(spec, fallbackThinking) {
   let modelPart = trimmed;
   let thinking = fallbackThinking;
   if (thinkingSplit !== -1) {
-    const maybeThinking = trimmed.slice(thinkingSplit + 1);
-    if (!THINKING_LEVELS.has(maybeThinking)) {
-      throw new Error(
-        `model specification must be provider/model[:thinking], got ${spec}`
-      );
-    }
-    thinking = maybeThinking;
+    thinking = trimmed.slice(thinkingSplit + 1);
     modelPart = trimmed.slice(0, thinkingSplit);
   }
   const slash = modelPart.indexOf("/");
@@ -15644,10 +15638,8 @@ function parseSeatModelConfig(value, seat) {
   if (typeof raw.model !== "string" || raw.model.trim() === "") {
     throw new Error(`config seat ${seat} requires model`);
   }
-  if (raw.thinking !== void 0) {
-    if (typeof raw.thinking !== "string" || !THINKING_LEVELS.has(raw.thinking)) {
-      throw new Error(`config seat ${seat} requires a valid thinking level`);
-    }
+  if (raw.thinking !== void 0 && typeof raw.thinking !== "string") {
+    throw new Error(`config seat ${seat} thinking must be a string`);
   }
   const parsed = {
     provider: raw.provider,
@@ -15796,7 +15788,7 @@ async function loadCredentialProviders(agentDir) {
     throw error;
   }
 }
-var GATE_OFFICER_SEATS, THINKING_LEVELS;
+var GATE_OFFICER_SEATS;
 var init_config2 = __esm({
   "src/public-cli/config.ts"() {
     "use strict";
@@ -15808,15 +15800,6 @@ var init_config2 = __esm({
       "inspector",
       "notary"
     ];
-    THINKING_LEVELS = /* @__PURE__ */ new Set([
-      "off",
-      "minimal",
-      "low",
-      "medium",
-      "high",
-      "xhigh",
-      "max"
-    ]);
   }
 });
 
@@ -18084,7 +18067,7 @@ async function loadResumableRunRecord(home, runId, authority) {
         model = {
           provider: rec.provider,
           model: rec.model,
-          ...typeof rec.thinking === "string" && THINKING_LEVELS.has(rec.thinking) ? { thinking: rec.thinking } : {}
+          ...typeof rec.thinking === "string" ? { thinking: rec.thinking } : {}
         };
       }
       if (correlationId === void 0 || ticketNumber === void 0 || ticketResolution === void 0) {
@@ -18449,7 +18432,6 @@ var init_run_lifecycle = __esm({
     init_typed_provider_http();
     init_collector_config();
     init_engine_material();
-    init_config2();
     init_invocation();
     V1_RESUMABLE_PROVIDERS = ["openai-codex", "xai"];
     AUTO_RESUME_LIMIT = 2;
@@ -18891,8 +18873,8 @@ var init_option_definitions = __esm({
         repeatable: false,
         form: "option",
         description: {
-          en: "Override thinking level: off|minimal|low|medium|high|xhigh|max.",
-          zh: "\u8986\u76D6 thinking \u6863\u4F4D\uFF1Aoff|minimal|low|medium|high|xhigh|max\u3002"
+          en: "Override thinking level (opaque pass-through to Pi; e.g. off|minimal|low|medium|high|xhigh|max).",
+          zh: "\u8986\u76D6 thinking \u6863\u4F4D\uFF08\u539F\u6837\u900F\u4F20\u7ED9 Pi\uFF1B\u4F8B\u5982 off|minimal|low|medium|high|xhigh|max\uFF09\u3002"
         }
       },
       {
@@ -19643,7 +19625,7 @@ async function recordEffectiveInvocationModel(runDirectory, model, engine, host)
   const effectiveModel = typeof next.provider === "string" && typeof next.model === "string" ? {
     provider: next.provider,
     model: next.model,
-    ...typeof next.thinking === "string" && THINKING_LEVELS.has(next.thinking) ? { thinking: next.thinking } : {}
+    ...typeof next.thinking === "string" ? { thinking: next.thinking } : {}
   } : void 0;
   const home = homeFromRunDirectory(runDirectory);
   const config = await loadPublicCliConfig(home);
@@ -33049,9 +33031,6 @@ function resolveAgentDir(env, home) {
   return env.agentDir ?? process.env.PI_CODING_AGENT_DIR ?? join35(home, ".pi", "agent");
 }
 function parseThinking(value) {
-  if (!THINKING_LEVELS2.has(value)) {
-    throw new CliUsageError(`unknown thinking level: ${value}`);
-  }
   return value;
 }
 function parseArgv(argv) {
@@ -33884,7 +33863,7 @@ async function runAkRole(argv, env) {
     return { exitCode: 1 };
   }
 }
-var RESUME_SEAT_DISPATCH, PUBLIC_ROLE_ARGV, PUBLIC_GLOBAL_OPTIONS, HostSelectionError, THINKING_LEVELS2;
+var RESUME_SEAT_DISPATCH, PUBLIC_ROLE_ARGV, PUBLIC_GLOBAL_OPTIONS, HostSelectionError;
 var init_cli = __esm({
   "src/public-cli/cli.ts"() {
     "use strict";
@@ -33957,15 +33936,6 @@ var init_cli = __esm({
       }
       failure;
     };
-    THINKING_LEVELS2 = /* @__PURE__ */ new Set([
-      "off",
-      "minimal",
-      "low",
-      "medium",
-      "high",
-      "xhigh",
-      "max"
-    ]);
   }
 });
 

package/package.json

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

package/src/evidence-child-executor.ts

@@ -975,7 +975,7 @@ export function createNativeNavigatorSessionFactory(
   return async ({ context, subject, modelSettingPath, tool }) => {
     const resolved = await resolveNavigatorSeatSelection(context, modelSettingPath, defaultModelSettingPath);
     let selection = resolved.selection;
-    let thinkingLevel = resolved.thinkingLevel;
+    let thinkingLevel: string | undefined = resolved.thinkingLevel;
     let configuredLabel = resolved.configuredLabel;
 
     const { createRecordSession } = await import("./archivist-record-entry.ts");
@@ -1117,7 +1117,7 @@ export function createNativeNavigatorSessionFactory(
         }
       },
       entries: () => sessionManager.getEntries(),
-      setModel: async (next, nextThinking) => {
+      setModel: async (next) => {
         let nextParsed: ReturnType<typeof parseNavigatorModelSetting>;
         try {
           nextParsed = parseNavigatorModelSetting(next);
@@ -1133,16 +1133,11 @@ export function createNativeNavigatorSessionFactory(
             `Navigator model switch requires a new session: ${configuredLabel} → ${next}`,
           );
         }
-        if (nextParsed.thinkingLevel !== nextThinking || thinkingLevel !== nextThinking) {
-          throw new NavigatorUnavailableError(
-            "thinking",
-            `Navigator thinking level ${nextThinking} is unavailable for ${next}`,
-          );
-        }
+        // Thinking is opaque pass-through; no stick/availability re-check.
         selection = {
           provider: nextParsed.provider,
           model: nextParsed.model,
-          thinking: nextParsed.thinkingLevel,
+          ...(nextParsed.thinkingLevel === undefined ? {} : { thinking: nextParsed.thinkingLevel }),
         };
         thinkingLevel = nextParsed.thinkingLevel;
         configuredLabel = next;

package/src/navigator-attendance.ts

@@ -648,9 +648,6 @@ export function createNavigatorAttendance(options: NavigatorAttendanceOptions) {
           try {
             await created.setModel?.(modelSetting, model.thinkingLevel);
             if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-            if (created.getThinkingLevel?.() !== undefined && created.getThinkingLevel() !== model.thinkingLevel) {
-              throw new NavigatorUnavailableError("thinking", `Navigator thinking level ${model.thinkingLevel} is unavailable for ${modelSetting}`);
-            }
             created.appendEntry(INVOCATION_ENTRY, { invocationId, role: options.role, phase: options.phase, subjectKey });
             if (disposed) throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
             session = created;
@@ -665,9 +662,6 @@ export function createNavigatorAttendance(options: NavigatorAttendanceOptions) {
       } else {
         try {
           await session.setModel?.(modelSetting, model.thinkingLevel);
-          if (session.getThinkingLevel?.() !== undefined && session.getThinkingLevel() !== model.thinkingLevel) {
-            throw new NavigatorUnavailableError("thinking", `Navigator thinking level ${model.thinkingLevel} is unavailable for ${modelSetting}`);
-          }
         } catch (error) {
           // Contract: README.md#Navigator-attendance — resumed-session configuration failures remain typed unavailable and retain the original cause.
           throw error instanceof NavigatorUnavailableError ? error : navigatorUnavailableError("session", error);

package/src/navigator-session-contracts.ts

@@ -162,8 +162,8 @@ export type NavigatorPreparationSession = {
   appendEntry(customType: string, data: unknown): void;
   entries(): readonly unknown[];
   providerFailure?(): NavigatorProviderFailureFact | undefined;
-  setModel?(model: string, thinkingLevel: "off" | "max"): Promise<void>;
-  getThinkingLevel?(): string;
+  setModel?(model: string, thinkingLevel?: string): Promise<void>;
+  getThinkingLevel?(): string | undefined;
   recordPointer(): string;
   dispose(): void | Promise<void>;
 };
@@ -204,22 +204,22 @@ export async function writeNavigatorModelSetting(model: string, path = navigator
 export function parseNavigatorModelSetting(value: string): {
   provider: string;
   model: string;
-  thinkingLevel: "off" | "max";
+  thinkingLevel?: string;
 } {
   const slash = value.indexOf("/");
   if (slash <= 0 || slash === value.length - 1) {
-    throw new Error("Navigator model setting must be provider/model[:max]");
+    throw new Error("Navigator model setting must be provider/model[:thinking]");
   }
   const provider = value.slice(0, slash);
   const modelWithThinking = value.slice(slash + 1);
   const colon = modelWithThinking.lastIndexOf(":");
   const suffix = colon < 0 ? undefined : modelWithThinking.slice(colon + 1);
-  if (suffix !== undefined && suffix !== "max") {
-    throw new Error("Navigator model setting must use :max or omit the thinking suffix");
-  }
   const model = colon < 0 ? modelWithThinking : modelWithThinking.slice(0, colon);
   if (model === "") throw new Error("Navigator model setting must include a model");
-  return { provider, model, thinkingLevel: suffix === "max" ? "max" : "off" };
+  // Suffix is opaque pass-through; bare provider/model omits thinkingLevel (Pi default).
+  return suffix === undefined
+    ? { provider, model }
+    : { provider, model, thinkingLevel: suffix };
 }
 
 /**
@@ -230,20 +230,21 @@ export async function resolveNavigatorSeatSelection(
   context: HostContext,
   modelSettingPath: string | undefined,
   defaultModelSettingPath: string,
-): Promise<{ selection: HostInstitutionalModelSelection; configuredLabel: string; thinkingLevel: "off" | "max" }> {
+): Promise<{ selection: HostInstitutionalModelSelection; configuredLabel: string; thinkingLevel?: string }> {
   const runDirectory = auditorRunDirectory(context);
   if (runDirectory !== undefined) {
     try {
       const selection = await readInstitutionalSeatSelection(runDirectory, "navigator");
-      const thinkingLevel = selection.thinking === "max" ? "max" : "off";
       return {
         selection: {
           provider: selection.provider,
           model: selection.model,
           ...(selection.thinking === undefined ? {} : { thinking: selection.thinking }),
         },
-        configuredLabel: `${selection.provider}/${selection.model}${thinkingLevel === "max" ? ":max" : ""}`,
-        thinkingLevel,
+        configuredLabel: selection.thinking === undefined
+          ? `${selection.provider}/${selection.model}`
+          : `${selection.provider}/${selection.model}:${selection.thinking}`,
+        ...(selection.thinking === undefined ? {} : { thinkingLevel: selection.thinking }),
       };
     } catch (error) {
       if (
@@ -274,9 +275,9 @@ export async function resolveNavigatorSeatSelection(
     selection: {
       provider: parsed.provider,
       model: parsed.model,
-      thinking: parsed.thinkingLevel,
+      ...(parsed.thinkingLevel === undefined ? {} : { thinking: parsed.thinkingLevel }),
     },
     configuredLabel: configured,
-    thinkingLevel: parsed.thinkingLevel,
+    ...(parsed.thinkingLevel === undefined ? {} : { thinkingLevel: parsed.thinkingLevel }),
   };
 }

package/src/pi/in-process-session.ts

@@ -237,7 +237,7 @@ export async function openPiInstitutionalSession(
       ? childRegistry.find(selection.provider, selection.model)
       : undefined;
 
-    const withTypedReason = (error: Error, reason: "auth" | "model" | "thinking"): Error =>
+    const withTypedReason = (error: Error, reason: "auth" | "model"): Error =>
       Object.assign(error, { reason });
 
     // Existing Navigator/model contract (pre-#590): unknown provider or model is
@@ -254,13 +254,15 @@ export async function openPiInstitutionalSession(
     const fallbackApi = providerDefaultModel?.api
       ?? (childProvider as any)?.api
       ?? (selection.provider === "openai-codex" ? "openai-codex-responses" : "openai-completions");
+    // Fallback model facts come from the provider surface only — never derive
+    // reasoning (or any capability) from the thinking string (#683 pass-through).
     const modelToUse = foundModel ?? {
       id: selection.model,
       name: selection.model,
       api: fallbackApi as any,
       provider: selection.provider,
       baseUrl: providerDefaultModel?.baseUrl ?? "",
-      reasoning: selection.thinking !== undefined && selection.thinking !== "off",
+      reasoning: providerDefaultModel?.reasoning ?? false,
       input: ["text"],
       cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
       contextWindow: 128000,
@@ -631,15 +633,15 @@ export async function openPiInstitutionalSession(
       }
     }
 
-    // 7. Create AgentSession
-    // Existing Navigator contract: requested thinking must stick after open. Pi
-    // clamps unsupported levels; if max was requested and not applied, fail as
-    // typed unavailable/thinking (pre-#590 attendance setModel check).
-    const requestedThinking = options.selection.thinking === "max" ? "max" : "off";
+    // 7. Create AgentSession — thinking is opaque pass-through. Absent selection
+    // omits thinkingLevel (Pi default). Pi clamps unsupported levels itself;
+    // we do not re-check or invent defaults.
     const { session } = await createAgentSession({
       cwd: options.cwd,
       model: effectiveModel,
-      thinkingLevel: requestedThinking as any,
+      ...(options.selection.thinking === undefined
+        ? {}
+        : { thinkingLevel: options.selection.thinking as any }),
       modelRuntime: runtime,
       sessionManager,
       settingsManager: settings,
@@ -649,15 +651,6 @@ export async function openPiInstitutionalSession(
       ...(options.toolsAllowlist === undefined ? {} : { tools: options.toolsAllowlist as string[] }),
       ...(customTools.length === 0 ? {} : { customTools }),
     });
-    if (requestedThinking === "max" && session.thinkingLevel !== "max") {
-      session.dispose();
-      throw withTypedReason(
-        new Error(
-          `${label} thinking level max is unavailable for ${selection.provider}/${selection.model}`,
-        ),
-        "thinking",
-      );
-    }
 
     // 8. Event subscriptions
     const listeners = new Set<(event: HostInstitutionalSessionEvent) => void>();

package/src/public-cli/cli.ts

@@ -461,16 +461,6 @@ function cliResultFromRoleRun(result: {
   };
 }
 
-const THINKING_LEVELS = new Set([
-  "off",
-  "minimal",
-  "low",
-  "medium",
-  "high",
-  "xhigh",
-  "max",
-]);
-
 function defaultIo(): CliIo {
   return {
     stdout: (text) => {
@@ -505,10 +495,8 @@ type ParsedGlobal = {
 };
 
 function parseThinking(value: string): PublicThinkingLevel {
-  if (!THINKING_LEVELS.has(value)) {
-    throw new CliUsageError(`unknown thinking level: ${value}`);
-  }
-  return value as PublicThinkingLevel;
+  // #683: opaque pass-through — no local whitelist.
+  return value;
 }
 
 function parseArgv(argv: readonly string[]): ParsedGlobal {

package/src/public-cli/config.ts

@@ -102,16 +102,6 @@ export type InvocationModelOverride = {
   host?: string;
 };
 
-export const THINKING_LEVELS = new Set<PublicThinkingLevel>([
-  "off",
-  "minimal",
-  "low",
-  "medium",
-  "high",
-  "xhigh",
-  "max",
-]);
-
 export function publicCliConfigPath(home: string): string {
   if (typeof home !== "string" || home.trim() === "") {
     throw new Error("home must be explicitly provided");
@@ -336,17 +326,10 @@ export function parseModelSpec(
   const thinkingSplit = trimmed.lastIndexOf(":");
   let modelPart = trimmed;
   let thinking: PublicThinkingLevel | undefined = fallbackThinking;
-  // #346: no colon → bare provider/model is legal. Colon present (any index,
-  // including 0) → suffix must be a typed PublicThinkingLevel (empty/unknown
-  // stay format rejects; never swallow ":…" into the model name).
+  // #346/#683: no colon → bare provider/model is legal. Colon present → suffix
+  // is opaque thinking pass-through (no local whitelist); never swallow into model.
   if (thinkingSplit !== -1) {
-    const maybeThinking = trimmed.slice(thinkingSplit + 1);
-    if (!THINKING_LEVELS.has(maybeThinking as PublicThinkingLevel)) {
-      throw new Error(
-        `model specification must be provider/model[:thinking], got ${spec}`,
-      );
-    }
-    thinking = maybeThinking as PublicThinkingLevel;
+    thinking = trimmed.slice(thinkingSplit + 1);
     modelPart = trimmed.slice(0, thinkingSplit);
   }
   const slash = modelPart.indexOf("/");
@@ -507,14 +490,9 @@ function parseSeatModelConfig(value: unknown, seat: string): PersistentSeatConfi
   if (typeof raw.model !== "string" || raw.model.trim() === "") {
     throw new Error(`config seat ${seat} requires model`);
   }
-  // #384: thinking is optional on persistent seats; when present it must be typed.
-  if (raw.thinking !== undefined) {
-    if (
-      typeof raw.thinking !== "string" ||
-      !THINKING_LEVELS.has(raw.thinking as PublicThinkingLevel)
-    ) {
-      throw new Error(`config seat ${seat} requires a valid thinking level`);
-    }
+  // #384/#683: thinking is optional opaque pass-through; when present must be a string.
+  if (raw.thinking !== undefined && typeof raw.thinking !== "string") {
+    throw new Error(`config seat ${seat} thinking must be a string`);
   }
   const parsed: PersistentSeatConfig = {
     provider: raw.provider as string,

package/src/public-cli/invocation.ts

@@ -73,7 +73,7 @@ import {
   type OptionOwner,
   type PublicOptionDefinition,
 } from "./option-definitions.ts";
-import { loadPublicCliConfig, THINKING_LEVELS } from "./config.ts";
+import { loadPublicCliConfig } from "./config.ts";
 import type { PublicThinkingLevel } from "./registry.ts";
 import {
   resolveInstitutionalSeatSelections,
@@ -311,7 +311,7 @@ async function writeAdmittedRequestPersistence(
 /**
  * Effective provider/model selection recorded on the invocation identity page.
  * thinking is present only when the caller/seat supplied it — bare model omits it.
- * Restored values are bounded to typed PublicThinkingLevel (never arbitrary string).
+ * Thinking is opaque pass-through (#683); no local whitelist filter on restore.
  */
 export type InvocationEffectiveModel = {
   readonly provider: string;
@@ -417,9 +417,8 @@ export async function recordEffectiveInvocationModel(
       ? {
           provider: next.provider,
           model: next.model,
-          ...(typeof next.thinking === "string" &&
-          THINKING_LEVELS.has(next.thinking as PublicThinkingLevel)
-            ? { thinking: next.thinking as PublicThinkingLevel }
+          ...(typeof next.thinking === "string"
+            ? { thinking: next.thinking }
             : {}),
         }
       : undefined;

package/src/public-cli/option-definitions.ts

@@ -288,8 +288,8 @@ const GLOBAL_OPTIONS = [
     repeatable: false,
     form: "option",
     description: {
-      en: "Override thinking level: off|minimal|low|medium|high|xhigh|max.",
-      zh: "覆盖 thinking 档位：off|minimal|low|medium|high|xhigh|max。",
+      en: "Override thinking level (opaque pass-through to Pi; e.g. off|minimal|low|medium|high|xhigh|max).",
+      zh: "覆盖 thinking 档位（原样透传给 Pi；例如 off|minimal|low|medium|high|xhigh|max）。",
     },
   },
   {

package/src/public-cli/registry.ts

@@ -31,14 +31,8 @@ export const PUBLIC_CLI_SUPPORT_COMMANDS = [
 
 export type PublicCliSupportCommand = (typeof PUBLIC_CLI_SUPPORT_COMMANDS)[number];
 
-export type PublicThinkingLevel =
-  | "off"
-  | "minimal"
-  | "low"
-  | "medium"
-  | "high"
-  | "xhigh"
-  | "max";
+/** Opaque thinking level string — pass-through to Pi; no local whitelist (#683). */
+export type PublicThinkingLevel = string;
 
 export type ModelRef = {
   provider: string;

package/src/public-cli/run-lifecycle.ts

@@ -36,7 +36,6 @@ import {
   engineSessionMaterialFromOptions,
   type EngineSessionMaterial,
 } from "../package-resources/engine-material.ts";
-import { THINKING_LEVELS } from "./config.ts";
 import type { PublicThinkingLevel } from "./registry.ts";
 import {
   recordEffectiveInvocationModel,
@@ -1136,8 +1135,7 @@ async function loadResumableRunRecord(
         model = {
           provider: rec.provider,
           model: rec.model,
-          ...(typeof rec.thinking === "string" &&
-          THINKING_LEVELS.has(rec.thinking as PublicThinkingLevel)
+          ...(typeof rec.thinking === "string"
             ? { thinking: rec.thinking as PublicThinkingLevel }
             : {}),
         };