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/test-helpers.ts

@@ -0,0 +1,74 @@
+// Xai helper module supports test helpers behavior.
+import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
+import type { Context, Model } from "openclaw/plugin-sdk/llm";
+import { expect } from "vitest";
+
+type XaiToolPayloadFunction = {
+  function?: Record<string, unknown>;
+};
+
+type XaiTestPayload = Record<string, unknown> & {
+  tools?: Array<{ type?: string; function?: Record<string, unknown> }>;
+  input?: unknown[];
+};
+
+function createXaiToolStreamPayload(): XaiTestPayload {
+  return {
+    reasoning: { effort: "high" },
+    tools: [
+      {
+        type: "function",
+        function: {
+          name: "write",
+          parameters: { type: "object", properties: {} },
+          strict: true,
+        },
+      },
+    ],
+  };
+}
+
+export function createXaiPayloadCaptureStream() {
+  let capturedModelId = "";
+  let capturedPayload: XaiTestPayload | undefined;
+
+  const streamFn: StreamFn = (model, _context, options) => {
+    capturedModelId = model.id;
+    const payload = createXaiToolStreamPayload();
+    options?.onPayload?.(payload as never, model as never);
+    capturedPayload = payload;
+    return {
+      result: async () => ({}) as never,
+      async *[Symbol.asyncIterator]() {},
+    } as unknown as ReturnType<StreamFn>;
+  };
+
+  return {
+    streamFn,
+    getCapturedModelId: () => capturedModelId,
+    getCapturedPayload: () => capturedPayload,
+  };
+}
+
+export function runXaiGrok4ResponseStream(streamFn: StreamFn | null | undefined) {
+  void streamFn?.(
+    {
+      api: "openai-responses",
+      provider: "xai",
+      id: "grok-4",
+    } as Model<"openai-responses">,
+    { messages: [] } as Context,
+    {},
+  );
+}
+
+export function expectXaiFastToolStreamShaping(
+  capture: ReturnType<typeof createXaiPayloadCaptureStream>,
+) {
+  const capturedPayload = capture.getCapturedPayload();
+  expect(capture.getCapturedModelId()).toBe("grok-4-fast");
+  expect(capturedPayload).toMatchObject({ tool_stream: true });
+  expect(capturedPayload).not.toHaveProperty("reasoning");
+  const payloadTools = capturedPayload?.tools as XaiToolPayloadFunction[] | undefined;
+  expect(payloadTools?.[0]?.function).not.toHaveProperty("strict");
+}