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/together/video-generation-provider.test.ts

@@ -0,0 +1,345 @@
+// Together tests cover video generation provider plugin behavior.
+import {
+  getProviderHttpMocks,
+  installProviderHttpMockCleanup,
+} from "openclaw/plugin-sdk/provider-http-test-mocks";
+import { expectExplicitVideoGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts";
+import { beforeAll, describe, expect, it, vi } from "vitest";
+
+const { postJsonRequestMock, fetchWithTimeoutMock } = getProviderHttpMocks();
+
+let buildTogetherVideoGenerationProvider: typeof import("./video-generation-provider.js").buildTogetherVideoGenerationProvider;
+
+beforeAll(async () => {
+  ({ buildTogetherVideoGenerationProvider } = await import("./video-generation-provider.js"));
+});
+
+installProviderHttpMockCleanup();
+
+function requireRecord(value: unknown, label: string): Record<string, unknown> {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`expected ${label} to be a record`);
+  }
+  return value as Record<string, unknown>;
+}
+
+function requireFirstPostJsonRequest(label: string): Record<string, unknown> {
+  const [call] = postJsonRequestMock.mock.calls;
+  if (!call) {
+    throw new Error(`expected ${label}`);
+  }
+  return requireRecord(call[0], label);
+}
+
+function streamingResponse(params: {
+  body: string;
+  headers?: HeadersInit;
+  onCancel: () => void;
+}): Response {
+  const encoded = new TextEncoder().encode(params.body);
+  const stream = new ReadableStream<Uint8Array>({
+    start(controller) {
+      controller.enqueue(encoded);
+    },
+    cancel() {
+      params.onCancel();
+    },
+  });
+  return new Response(stream, { headers: params.headers });
+}
+
+function streamedJsonResponse(payload: unknown): Response {
+  return new Response(
+    new ReadableStream({
+      start(controller) {
+        controller.enqueue(new TextEncoder().encode(JSON.stringify(payload)));
+        controller.close();
+      },
+    }),
+    { headers: { "content-type": "application/json" } },
+  );
+}
+
+// Drives an unbounded JSON body (>16 MiB, no Content-Length) so the bounded
+// reader has to cancel the stream instead of buffering it all. A hard ceiling
+// guards the test from hanging if the reader ever fails to cancel.
+function oversizedJsonResponse(): {
+  response: Response;
+  state: { canceled: boolean; enqueuedBytes: number };
+} {
+  const state = { canceled: false, enqueuedBytes: 0 };
+  const chunk = 1024 * 1024;
+  const maxChunks = 64; // 64 MiB ceiling, 4x the 16 MiB cap.
+  let emitted = 0;
+  const response = new Response(
+    new ReadableStream({
+      pull(controller) {
+        if (emitted >= maxChunks) {
+          controller.close();
+          return;
+        }
+        emitted += 1;
+        state.enqueuedBytes += chunk;
+        controller.enqueue(new Uint8Array(chunk));
+      },
+      cancel() {
+        state.canceled = true;
+      },
+    }),
+    { headers: { "content-type": "application/json" } },
+  );
+  return { response, state };
+}
+
+describe("together video generation provider", () => {
+  it("declares explicit mode capabilities", () => {
+    expectExplicitVideoGenerationCapabilities(buildTogetherVideoGenerationProvider());
+  });
+
+  it("creates a video, polls completion, and downloads the output", async () => {
+    postJsonRequestMock.mockResolvedValue({
+      response: streamedJsonResponse({
+        id: "video_123",
+        status: "in_progress",
+      }),
+      release: vi.fn(async () => {}),
+    });
+    fetchWithTimeoutMock
+      .mockResolvedValueOnce({
+        json: async () => ({
+          id: "video_123",
+          status: "completed",
+          outputs: { video_url: "https://example.com/together.mp4" },
+        }),
+      })
+      .mockResolvedValueOnce({
+        headers: new Headers({ "content-type": "video/webm" }),
+        arrayBuffer: async () => Buffer.from("webm-bytes"),
+      });
+
+    const provider = buildTogetherVideoGenerationProvider();
+    const result = await provider.generateVideo({
+      provider: "together",
+      model: "Wan-AI/Wan2.2-T2V-A14B",
+      prompt: "A bicycle weaving through a rainy neon street",
+      cfg: {},
+    });
+
+    expect(postJsonRequestMock).toHaveBeenCalledOnce();
+    const request = requireFirstPostJsonRequest("Together request");
+    expect(request.url).toBe("https://api.together.xyz/v2/videos");
+    const body = requireRecord(request.body, "Together request body");
+    expect(body.model).toBe("Wan-AI/Wan2.2-T2V-A14B");
+    expect(body.prompt).toBe("A bicycle weaving through a rainy neon street");
+    expect(result.videos).toHaveLength(1);
+    const [video] = result.videos;
+    if (!video) {
+      throw new Error("Expected generated Together video");
+    }
+    expect(video.fileName).toBe("video-1.webm");
+    expect(result.metadata).toEqual({
+      videoId: "video_123",
+      status: "completed",
+      videoUrl: "https://example.com/together.mp4",
+    });
+  });
+
+  it("bounds an unbounded successful Together create JSON body and cancels the stream", async () => {
+    const oversized = oversizedJsonResponse();
+    postJsonRequestMock.mockResolvedValue({
+      response: oversized.response,
+      release: vi.fn(async () => {}),
+    });
+
+    const provider = buildTogetherVideoGenerationProvider();
+    await expect(
+      provider.generateVideo({
+        provider: "together",
+        model: "Wan-AI/Wan2.2-T2V-A14B",
+        prompt: "oversized create body",
+        cfg: {},
+      }),
+    ).rejects.toThrow("Together video generation failed: JSON response exceeds 16777216 bytes");
+    // The bounded reader cancelled the stream rather than buffering the whole
+    // body, and stopped reading well before the 64 MiB ceiling.
+    expect(oversized.state.canceled).toBe(true);
+    expect(oversized.state.enqueuedBytes).toBeLessThan(64 * 1024 * 1024);
+    expect(fetchWithTimeoutMock).not.toHaveBeenCalled();
+  });
+
+  it("bounds downloaded videos before materializing them", async () => {
+    let canceled = false;
+    postJsonRequestMock.mockResolvedValue({
+      response: streamedJsonResponse({
+        id: "video_oversized",
+        status: "in_progress",
+      }),
+      release: vi.fn(async () => {}),
+    });
+    fetchWithTimeoutMock
+      .mockResolvedValueOnce({
+        json: async () => ({
+          id: "video_oversized",
+          status: "completed",
+          outputs: { video_url: "https://example.com/oversized.mp4" },
+        }),
+      })
+      .mockResolvedValueOnce(
+        streamingResponse({
+          body: "x".repeat(32),
+          headers: { "content-type": "video/mp4" },
+          onCancel: () => {
+            canceled = true;
+          },
+        }),
+      );
+
+    const provider = buildTogetherVideoGenerationProvider();
+    await expect(
+      provider.generateVideo({
+        provider: "together",
+        model: "Wan-AI/Wan2.2-T2V-A14B",
+        prompt: "oversized video",
+        cfg: { agents: { defaults: { mediaMaxMb: 0.00001 } } },
+      }),
+    ).rejects.toThrow("Together generated video download exceeds");
+    expect(canceled).toBe(true);
+  });
+
+  it("uses the video API endpoint when the shared Together text base URL is configured", async () => {
+    postJsonRequestMock.mockResolvedValue({
+      response: streamedJsonResponse({
+        id: "video_123",
+      }),
+      release: vi.fn(async () => {}),
+    });
+    fetchWithTimeoutMock
+      .mockResolvedValueOnce({
+        json: async () => ({
+          id: "video_123",
+          status: "completed",
+          outputs: { video_url: "https://example.com/together.mp4" },
+        }),
+      })
+      .mockResolvedValueOnce({
+        headers: new Headers({ "content-type": "video/mp4" }),
+        arrayBuffer: async () => Buffer.from("mp4-bytes"),
+      });
+
+    const provider = buildTogetherVideoGenerationProvider();
+    await provider.generateVideo({
+      provider: "together",
+      model: "Wan-AI/Wan2.2-T2V-A14B",
+      prompt: "A bicycle weaving through a rainy neon street",
+      cfg: {
+        models: {
+          providers: {
+            together: {
+              baseUrl: "https://api.together.xyz/v1",
+              models: [],
+            },
+          },
+        },
+      },
+    });
+
+    const request = requireFirstPostJsonRequest("Together request");
+    expect(request.url).toBe("https://api.together.xyz/v2/videos");
+  });
+
+  it("drops out-of-range duration values before creating videos", async () => {
+    postJsonRequestMock.mockResolvedValue({
+      response: streamedJsonResponse({
+        id: "video_123",
+      }),
+      release: vi.fn(async () => {}),
+    });
+    fetchWithTimeoutMock
+      .mockResolvedValueOnce({
+        json: async () => ({
+          id: "video_123",
+          status: "completed",
+          outputs: { video_url: "https://example.com/together.mp4" },
+        }),
+      })
+      .mockResolvedValueOnce({
+        headers: new Headers({ "content-type": "video/mp4" }),
+        arrayBuffer: async () => Buffer.from("mp4-bytes"),
+      });
+
+    const provider = buildTogetherVideoGenerationProvider();
+    await provider.generateVideo({
+      provider: "together",
+      model: "Wan-AI/Wan2.2-T2V-A14B",
+      prompt: "A bicycle weaving through a rainy neon street",
+      durationSeconds: 99,
+      cfg: {},
+    });
+
+    const request = requireFirstPostJsonRequest("Together request");
+    const body = requireRecord(request.body, "Together request body");
+    expect(body).not.toHaveProperty("seconds");
+  });
+
+  it("rejects reference images for Together text-to-video models before calling the API", async () => {
+    const provider = buildTogetherVideoGenerationProvider();
+
+    await expect(
+      provider.generateVideo({
+        provider: "together",
+        model: "Wan-AI/Wan2.2-T2V-A14B",
+        prompt: "A bicycle weaving through a rainy neon street",
+        cfg: {},
+        inputImages: [
+          {
+            buffer: Buffer.from("png"),
+            mimeType: "image/png",
+            fileName: "reference.png",
+          },
+        ],
+      }),
+    ).rejects.toThrow(/does not support image reference inputs/u);
+    expect(postJsonRequestMock).not.toHaveBeenCalled();
+  });
+
+  it("sends reference images for the Together image-to-video model", async () => {
+    postJsonRequestMock.mockResolvedValue({
+      response: streamedJsonResponse({
+        id: "video_123",
+      }),
+      release: vi.fn(async () => {}),
+    });
+    fetchWithTimeoutMock
+      .mockResolvedValueOnce({
+        json: async () => ({
+          id: "video_123",
+          status: "completed",
+          outputs: { video_url: "https://example.com/together.mp4" },
+        }),
+      })
+      .mockResolvedValueOnce({
+        headers: new Headers({ "content-type": "video/mp4" }),
+        arrayBuffer: async () => Buffer.from("mp4-bytes"),
+      });
+
+    const provider = buildTogetherVideoGenerationProvider();
+    await provider.generateVideo({
+      provider: "together",
+      model: "Wan-AI/Wan2.2-I2V-A14B",
+      prompt: "Animate the reference art.",
+      cfg: {},
+      inputImages: [
+        {
+          buffer: Buffer.from("png"),
+          mimeType: "image/png",
+          fileName: "reference.png",
+        },
+      ],
+    });
+
+    const request = requireFirstPostJsonRequest("Together request");
+    const body = requireRecord(request.body, "Together request body");
+    expect(body.model).toBe("Wan-AI/Wan2.2-I2V-A14B");
+    expect(body.reference_images).toHaveLength(1);
+  });
+});