Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

extensions/xai/model-definitions.ts

@@ -0,0 +1,346 @@
+// Xai plugin module implements model definitions behavior.
+import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared";
+import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
+
+export const XAI_BASE_URL = "https://api.x.ai/v1";
+export const XAI_DEFAULT_IMAGE_MODEL = "grok-imagine-image";
+export const XAI_IMAGE_MODELS = ["grok-imagine-image", "grok-imagine-image-quality"] as const;
+export const XAI_DEFAULT_CONTEXT_WINDOW = 1_000_000;
+const XAI_LARGE_CONTEXT_WINDOW = 2_000_000;
+const XAI_GROK_4_CONTEXT_WINDOW = 256_000;
+const XAI_CODE_CONTEXT_WINDOW = 256_000;
+export const XAI_DEFAULT_MAX_TOKENS = 64_000;
+const XAI_LEGACY_CONTEXT_WINDOW = 131_072;
+const XAI_LEGACY_MAX_TOKENS = 8_192;
+export const XAI_DEFAULT_MODEL_ID = "grok-4.3";
+
+type XaiCost = ModelDefinitionConfig["cost"];
+
+type XaiCatalogEntry = {
+  id: string;
+  name: string;
+  reasoning: boolean;
+  input?: ModelDefinitionConfig["input"];
+  contextWindow: number;
+  maxTokens?: number;
+  cost: XaiCost;
+};
+
+const XAI_GROK_4_COST = {
+  input: 3,
+  output: 15,
+  cacheRead: 0.75,
+  cacheWrite: 0,
+} satisfies XaiCost;
+
+const XAI_FAST_COST = {
+  input: 0.2,
+  output: 0.5,
+  cacheRead: 0.05,
+  cacheWrite: 0,
+} satisfies XaiCost;
+
+const XAI_GROK_420_COST = {
+  input: 1.25,
+  output: 2.5,
+  cacheRead: 0.2,
+  cacheWrite: 0,
+} satisfies XaiCost;
+
+const XAI_GROK_43_COST = {
+  input: 1.25,
+  output: 2.5,
+  cacheRead: 0.2,
+  cacheWrite: 0,
+} satisfies XaiCost;
+
+const XAI_GROK_BUILD_COST = {
+  input: 1,
+  output: 2,
+  cacheRead: 0.2,
+  cacheWrite: 0,
+} satisfies XaiCost;
+
+const XAI_CODE_FAST_COST = {
+  input: 0.2,
+  output: 1.5,
+  cacheRead: 0.02,
+  cacheWrite: 0,
+} satisfies XaiCost;
+
+const XAI_MODEL_CATALOG = [
+  {
+    id: "grok-build-0.1",
+    name: "Grok Build 0.1",
+    reasoning: true,
+    input: ["text", "image"],
+    contextWindow: XAI_CODE_CONTEXT_WINDOW,
+    cost: XAI_GROK_BUILD_COST,
+  },
+  {
+    id: "grok-3",
+    name: "Grok 3",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: XAI_LEGACY_CONTEXT_WINDOW,
+    maxTokens: XAI_LEGACY_MAX_TOKENS,
+    cost: XAI_GROK_4_COST,
+  },
+  {
+    id: "grok-3-fast",
+    name: "Grok 3 Fast",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: XAI_LEGACY_CONTEXT_WINDOW,
+    maxTokens: XAI_LEGACY_MAX_TOKENS,
+    cost: { input: 5, output: 25, cacheRead: 1.25, cacheWrite: 0 },
+  },
+  {
+    id: "grok-3-mini",
+    name: "Grok 3 Mini",
+    reasoning: true,
+    input: ["text"],
+    contextWindow: XAI_LEGACY_CONTEXT_WINDOW,
+    maxTokens: XAI_LEGACY_MAX_TOKENS,
+    cost: { input: 0.3, output: 0.5, cacheRead: 0.075, cacheWrite: 0 },
+  },
+  {
+    id: "grok-3-mini-fast",
+    name: "Grok 3 Mini Fast",
+    reasoning: true,
+    input: ["text"],
+    contextWindow: XAI_LEGACY_CONTEXT_WINDOW,
+    maxTokens: XAI_LEGACY_MAX_TOKENS,
+    cost: { input: 0.6, output: 4, cacheRead: 0.15, cacheWrite: 0 },
+  },
+  {
+    id: "grok-4.3",
+    name: "Grok 4.3",
+    reasoning: true,
+    input: ["text", "image"],
+    contextWindow: XAI_DEFAULT_CONTEXT_WINDOW,
+    maxTokens: XAI_DEFAULT_MAX_TOKENS,
+    cost: XAI_GROK_43_COST,
+  },
+  {
+    id: "grok-4",
+    name: "Grok 4",
+    reasoning: true,
+    input: ["text"],
+    contextWindow: XAI_GROK_4_CONTEXT_WINDOW,
+    maxTokens: XAI_DEFAULT_MAX_TOKENS,
+    cost: XAI_GROK_4_COST,
+  },
+  {
+    id: "grok-4-0709",
+    name: "Grok 4 0709",
+    reasoning: false,
+    input: ["text"],
+    contextWindow: XAI_GROK_4_CONTEXT_WINDOW,
+    maxTokens: XAI_DEFAULT_MAX_TOKENS,
+    cost: XAI_GROK_4_COST,
+  },
+  {
+    id: "grok-4-fast",
+    name: "Grok 4 Fast",
+    reasoning: true,
+    input: ["text", "image"],
+    contextWindow: XAI_LARGE_CONTEXT_WINDOW,
+    maxTokens: 30_000,
+    cost: XAI_FAST_COST,
+  },
+  {
+    id: "grok-4-fast-non-reasoning",
+    name: "Grok 4 Fast (Non-Reasoning)",
+    reasoning: false,
+    input: ["text", "image"],
+    contextWindow: XAI_LARGE_CONTEXT_WINDOW,
+    maxTokens: 30_000,
+    cost: XAI_FAST_COST,
+  },
+  {
+    id: "grok-4-1-fast",
+    name: "Grok 4.1 Fast",
+    reasoning: true,
+    input: ["text", "image"],
+    contextWindow: XAI_LARGE_CONTEXT_WINDOW,
+    maxTokens: 30_000,
+    cost: XAI_FAST_COST,
+  },
+  {
+    id: "grok-4-1-fast-non-reasoning",
+    name: "Grok 4.1 Fast (Non-Reasoning)",
+    reasoning: false,
+    input: ["text", "image"],
+    contextWindow: XAI_LARGE_CONTEXT_WINDOW,
+    maxTokens: 30_000,
+    cost: XAI_FAST_COST,
+  },
+  {
+    id: "grok-4.20-beta-latest-reasoning",
+    name: "Grok 4.20 Beta Latest (Reasoning)",
+    reasoning: true,
+    input: ["text", "image"],
+    contextWindow: XAI_LARGE_CONTEXT_WINDOW,
+    maxTokens: 30_000,
+    cost: XAI_GROK_420_COST,
+  },
+  {
+    id: "grok-4.20-beta-latest-non-reasoning",
+    name: "Grok 4.20 Beta Latest (Non-Reasoning)",
+    reasoning: false,
+    input: ["text", "image"],
+    contextWindow: XAI_LARGE_CONTEXT_WINDOW,
+    maxTokens: 30_000,
+    cost: XAI_GROK_420_COST,
+  },
+] as const satisfies readonly XaiCatalogEntry[];
+
+const XAI_SELECTABLE_MODEL_IDS = new Set<string>([
+  "grok-build-0.1",
+  "grok-4.3",
+  "grok-4.20-beta-latest-reasoning",
+  "grok-4.20-beta-latest-non-reasoning",
+]);
+
+const XAI_GROK_BUILD_ALIASES = new Set<string>([
+  "grok-code-fast-1",
+  "grok-code-fast",
+  "grok-code-fast-1-0825",
+]);
+
+const XAI_RETIRED_BUILTIN_MODEL_IDS = new Set<string>(
+  XAI_MODEL_CATALOG.map((entry) => entry.id).filter((id) => !XAI_SELECTABLE_MODEL_IDS.has(id)),
+);
+
+function normalizeXaiCatalogModelId(modelId: string): string {
+  const lower = normalizeOptionalLowercaseString(modelId) ?? "";
+  const unprefixed = lower.startsWith("xai/") ? lower.slice("xai/".length) : lower;
+  if (XAI_GROK_BUILD_ALIASES.has(unprefixed)) {
+    return "grok-build-0.1";
+  }
+  return unprefixed;
+}
+
+export function isRetiredXaiBuiltinModelId(modelId: string): boolean {
+  const lower = normalizeOptionalLowercaseString(modelId) ?? "";
+  const unprefixed = lower.startsWith("xai/") ? lower.slice("xai/".length) : lower;
+  if (XAI_GROK_BUILD_ALIASES.has(unprefixed)) {
+    return true;
+  }
+  return XAI_RETIRED_BUILTIN_MODEL_IDS.has(normalizeXaiCatalogModelId(modelId));
+}
+
+function toModelDefinition(entry: XaiCatalogEntry): ModelDefinitionConfig {
+  return {
+    id: entry.id,
+    name: entry.name,
+    reasoning: entry.reasoning,
+    input: entry.input ?? ["text"],
+    cost: entry.cost,
+    contextWindow: entry.contextWindow,
+    maxTokens: entry.maxTokens ?? XAI_DEFAULT_MAX_TOKENS,
+  };
+}
+
+export function buildXaiModelDefinition(): ModelDefinitionConfig {
+  return toModelDefinition(
+    XAI_MODEL_CATALOG.find((entry) => entry.id === XAI_DEFAULT_MODEL_ID) ?? {
+      id: XAI_DEFAULT_MODEL_ID,
+      name: "Grok 4.3",
+      reasoning: true,
+      input: ["text", "image"],
+      contextWindow: XAI_DEFAULT_CONTEXT_WINDOW,
+      maxTokens: XAI_DEFAULT_MAX_TOKENS,
+      cost: XAI_GROK_43_COST,
+    },
+  );
+}
+
+export function buildXaiCatalogModels(): ModelDefinitionConfig[] {
+  return XAI_MODEL_CATALOG.filter((entry) => XAI_SELECTABLE_MODEL_IDS.has(entry.id)).map((entry) =>
+    toModelDefinition(entry),
+  );
+}
+
+export function resolveXaiCatalogEntry(modelId: string) {
+  const trimmed = modelId.trim();
+  const lower = normalizeXaiCatalogModelId(modelId);
+  const exact = XAI_MODEL_CATALOG.find(
+    (entry) => normalizeOptionalLowercaseString(entry.id) === lower,
+  );
+  if (exact) {
+    return toModelDefinition(exact);
+  }
+  if (lower.includes("multi-agent")) {
+    return undefined;
+  }
+  if (lower.startsWith("grok-code-fast")) {
+    return toModelDefinition({
+      id: trimmed,
+      name: trimmed,
+      reasoning: true,
+      input: ["text"],
+      contextWindow: XAI_CODE_CONTEXT_WINDOW,
+      maxTokens: 10_000,
+      cost: XAI_CODE_FAST_COST,
+    });
+  }
+  if (
+    lower.startsWith("grok-3-mini-fast") ||
+    lower.startsWith("grok-3-mini") ||
+    lower.startsWith("grok-3-fast") ||
+    lower.startsWith("grok-3")
+  ) {
+    const legacyCost = lower.startsWith("grok-3-mini-fast")
+      ? { input: 0.6, output: 4, cacheRead: 0.15, cacheWrite: 0 }
+      : lower.startsWith("grok-3-mini")
+        ? { input: 0.3, output: 0.5, cacheRead: 0.075, cacheWrite: 0 }
+        : lower.startsWith("grok-3-fast")
+          ? { input: 5, output: 25, cacheRead: 1.25, cacheWrite: 0 }
+          : XAI_GROK_4_COST;
+    return toModelDefinition({
+      id: trimmed,
+      name: trimmed,
+      reasoning: lower.includes("mini"),
+      input: ["text"],
+      contextWindow: XAI_LEGACY_CONTEXT_WINDOW,
+      maxTokens: XAI_LEGACY_MAX_TOKENS,
+      cost: legacyCost,
+    });
+  }
+  if (
+    lower.startsWith("grok-4.3") ||
+    lower.startsWith("grok-4.20") ||
+    lower.startsWith("grok-4-1") ||
+    lower.startsWith("grok-4-fast")
+  ) {
+    return toModelDefinition({
+      id: trimmed,
+      name: trimmed,
+      reasoning: !lower.includes("non-reasoning"),
+      input: ["text", "image"],
+      contextWindow: lower.startsWith("grok-4.3")
+        ? XAI_DEFAULT_CONTEXT_WINDOW
+        : XAI_LARGE_CONTEXT_WINDOW,
+      maxTokens: lower.startsWith("grok-4.3") ? XAI_DEFAULT_MAX_TOKENS : 30_000,
+      cost: lower.startsWith("grok-4.3")
+        ? XAI_GROK_43_COST
+        : lower.startsWith("grok-4.20")
+          ? XAI_GROK_420_COST
+          : XAI_FAST_COST,
+    });
+  }
+  if (lower.startsWith("grok-4")) {
+    return toModelDefinition({
+      id: modelId.trim(),
+      name: modelId.trim(),
+      reasoning: lower.includes("reasoning"),
+      input: ["text"],
+      contextWindow: XAI_GROK_4_CONTEXT_WINDOW,
+      maxTokens: XAI_DEFAULT_MAX_TOKENS,
+      cost: XAI_GROK_4_COST,
+    });
+  }
+  return undefined;
+}