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/image-generation-provider.ts

@@ -0,0 +1,125 @@
+// Xai provider module implements model/runtime integration.
+import type {
+  ImageGenerationProvider,
+  ImageGenerationRequest,
+  ImageGenerationSourceImage,
+} from "openclaw/plugin-sdk/image-generation";
+import {
+  createOpenAiCompatibleImageGenerationProvider,
+  toImageDataUrl,
+} from "openclaw/plugin-sdk/image-generation";
+import {
+  normalizeOptionalLowercaseString,
+  normalizeOptionalString,
+} from "openclaw/plugin-sdk/string-coerce-runtime";
+import { XAI_BASE_URL, XAI_DEFAULT_IMAGE_MODEL, XAI_IMAGE_MODELS } from "./model-definitions.js";
+
+const DEFAULT_TIMEOUT_MS = 600_000;
+
+const XAI_SUPPORTED_ASPECT_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "2:3", "3:2"] as const;
+
+function resolveImageForEdit(
+  input: (ImageGenerationSourceImage & { url?: string }) | undefined,
+): string {
+  if (!input) {
+    throw new Error("xAI image edit requires an input image.");
+  }
+  const url = normalizeOptionalString(input.url);
+  if (url) {
+    return url;
+  }
+  if (!input.buffer) {
+    throw new Error("xAI image edit input is missing both URL and buffer data.");
+  }
+  return toImageDataUrl({ buffer: input.buffer, mimeType: input.mimeType });
+}
+
+function resolveXaiImageBaseUrl(req: ImageGenerationRequest): string {
+  return normalizeOptionalString(req.cfg?.models?.providers?.xai?.baseUrl) ?? XAI_BASE_URL;
+}
+
+function buildBody(params: {
+  req: ImageGenerationRequest;
+  inputImages: ImageGenerationSourceImage[];
+  model: string;
+  count: number;
+}): Record<string, unknown> {
+  const body: Record<string, unknown> = {
+    model: params.model,
+    prompt: params.req.prompt,
+    n: Math.min(params.count, 4),
+    response_format: "b64_json" as const,
+  };
+
+  const aspect = normalizeOptionalString(params.req.aspectRatio);
+  if (aspect && (XAI_SUPPORTED_ASPECT_RATIOS as readonly string[]).includes(aspect)) {
+    body.aspect_ratio = aspect;
+  }
+
+  const resolution = normalizeOptionalLowercaseString(params.req.resolution);
+  if (resolution) {
+    body.resolution = resolution;
+  }
+
+  if (params.inputImages.length > 0) {
+    if (params.inputImages.length > 1) {
+      body.images = params.inputImages.map((input) => ({
+        url: resolveImageForEdit(input),
+        type: "image_url",
+      }));
+    } else {
+      body.image = {
+        url: resolveImageForEdit(params.inputImages[0]),
+        type: "image_url",
+      };
+    }
+  }
+
+  return body;
+}
+
+export function buildXaiImageGenerationProvider(): ImageGenerationProvider {
+  return createOpenAiCompatibleImageGenerationProvider({
+    id: "xai",
+    label: "xAI",
+    defaultModel: XAI_DEFAULT_IMAGE_MODEL,
+    models: [...XAI_IMAGE_MODELS],
+    capabilities: {
+      generate: {
+        maxCount: 4,
+        supportsAspectRatio: true,
+        supportsResolution: true,
+        supportsSize: false,
+      },
+      edit: {
+        enabled: true,
+        maxCount: 4,
+        maxInputImages: 5,
+        supportsAspectRatio: true,
+        supportsResolution: true,
+        supportsSize: false,
+      },
+      geometry: {
+        aspectRatios: [...XAI_SUPPORTED_ASPECT_RATIOS],
+        resolutions: ["1K", "2K"],
+      },
+    },
+    defaultBaseUrl: XAI_BASE_URL,
+    resolveBaseUrl: ({ req }) => resolveXaiImageBaseUrl(req),
+    resolveAllowPrivateNetwork: () => false,
+    defaultTimeoutMs: DEFAULT_TIMEOUT_MS,
+    buildGenerateRequest: ({ req, inputImages, model, count }) => ({
+      kind: "json",
+      body: buildBody({ req, inputImages, model, count }),
+    }),
+    buildEditRequest: ({ req, inputImages, model, count }) => ({
+      kind: "json",
+      body: buildBody({ req, inputImages, model, count }),
+    }),
+    missingApiKeyError: "xAI API key missing",
+    failureLabels: {
+      generate: "xAI image generation failed",
+      edit: "xAI image edit failed",
+    },
+  });
+}