openclaw/packages/agent-core/src/reasoning.ts

import {
  resolveClaudeFable5ModelIdentity,
  resolveClaudeSonnet5ModelIdentity,
  type Model,
  type SimpleStreamOptions,
} from "../../llm-core/src/index.js";
import type { ThinkingLevel } from "./types.js";

type EnabledThinkingLevel = Exclude<NonNullable<SimpleStreamOptions["reasoning"]>, "off">;

const ENABLED_THINKING_LEVELS = new Set<EnabledThinkingLevel>([
  "minimal",
  "low",
  "medium",
  "high",
  "xhigh",
  "max",
]);

function isEnabledThinkingLevel(value: unknown): value is EnabledThinkingLevel {
  return ENABLED_THINKING_LEVELS.has(value as EnabledThinkingLevel);
}

export function resolveAgentReasoningOption(
  model: Model,
  thinkingLevel: ThinkingLevel,
): SimpleStreamOptions["reasoning"] {
  if (thinkingLevel !== "off") {
    return thinkingLevel;
  }
  const offFallback =
    model.thinkingLevelMap?.off ??
    ((model.api === "anthropic-messages" || model.api === "bedrock-converse-stream") &&
    resolveClaudeFable5ModelIdentity(model)
      ? "low"
      : undefined);
  if (isEnabledThinkingLevel(offFallback)) {
    return offFallback;
  }
  return model.api === "anthropic-messages" && resolveClaudeSonnet5ModelIdentity(model)
    ? "off"
    : undefined;
}