test(scripts): route mock OpenAI fixture helper

scripts/test-projects.test-support.mjs

@@ -1555,6 +1555,7 @@ const TOOLING_SOURCE_TEST_TARGETS = new Map([
     ["test/scripts/fixture-config.test.ts", "test/scripts/fixtures-workspace.test.ts"],
   ],
   ["scripts/e2e/lib/fixtures/config.mjs", ["test/scripts/fixture-config.test.ts"]],
+  ["scripts/e2e/lib/fixtures/mock-openai-config.mjs", ["test/scripts/mock-openai-config.test.ts"]],
   [
     "scripts/e2e/lib/kitchen-sink-plugin/sweep.sh",
     ["test/scripts/kitchen-sink-plugin-assertions.test.ts"],

test/scripts/mock-openai-config.test.ts

@@ -0,0 +1,119 @@
+// Mock OpenAI Config tests cover shared E2E mock model config helpers.
+import { describe, expect, it } from "vitest";
+import {
+  applyMockOpenAiModelConfig,
+  parseMockOpenAiPort,
+} from "../../scripts/e2e/lib/fixtures/mock-openai-config.mjs";
+
+type MockConfig = {
+  agents: {
+    defaults: {
+      imageGenerationModel?: unknown;
+      imageModel?: unknown;
+      model?: unknown;
+      models: Record<string, unknown>;
+    };
+    list: Array<{
+      id: string;
+      model: { primary: string };
+      models: Record<string, { agentRuntime?: unknown; params: Record<string, unknown> }>;
+    }>;
+  };
+  models: {
+    providers: {
+      openai: {
+        api?: string;
+        apiKey?: unknown;
+        baseUrl?: string;
+        models?: unknown[];
+        request: Record<string, unknown>;
+      };
+    };
+  };
+  plugins?: unknown;
+};
+
+describe("scripts/e2e/lib/fixtures/mock-openai-config.mjs", () => {
+  it("parses strict TCP port values", () => {
+    expect(parseMockOpenAiPort("18080")).toBe(18080);
+    expect(parseMockOpenAiPort(443)).toBe(443);
+
+    for (const value of [undefined, "", "0", "65536", "1e3", "18080tcp"]) {
+      expect(() => parseMockOpenAiPort(value, "test mock port")).toThrow(
+        /test mock port must be a TCP port from 1 to 65535/u,
+      );
+    }
+  });
+
+  it("writes mock OpenAI provider and agent defaults", () => {
+    const cfg: MockConfig = {
+      agents: {
+        defaults: {
+          models: {
+            "openai/gpt-5.4": { params: { preserved: true } },
+          },
+        },
+        list: [
+          {
+            id: "release-agent",
+            model: { primary: "openai/gpt-5.4" },
+            models: {
+              "openai/gpt-5.5": {
+                params: { existing: true },
+              },
+            },
+          },
+        ],
+      },
+      models: {
+        providers: {
+          openai: {
+            request: { timeoutMs: 10_000 },
+          },
+        },
+      },
+    };
+
+    applyMockOpenAiModelConfig(cfg, {
+      includeImageDefaults: true,
+      mockPort: "18181",
+      modelRef: "openai/gpt-5.5",
+    });
+
+    expect(cfg.models.providers.openai).toMatchObject({
+      api: "openai-responses",
+      apiKey: { source: "env", provider: "default", id: "OPENAI_API_KEY" },
+      baseUrl: "http://127.0.0.1:18181/v1",
+      request: { allowPrivateNetwork: true, timeoutMs: 10_000 },
+    });
+    expect(cfg.models.providers.openai.models).toEqual([
+      expect.objectContaining({
+        id: "gpt-5.5",
+        api: "openai-responses",
+        input: ["text", "image"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+      }),
+    ]);
+    expect(cfg.agents.defaults).toMatchObject({
+      imageGenerationModel: { primary: "openai/gpt-image-1", timeoutMs: 30_000 },
+      imageModel: { primary: "openai/gpt-5.5", timeoutMs: 30_000 },
+      model: { primary: "openai/gpt-5.5" },
+      models: {
+        "openai/gpt-5.4": { params: { preserved: true } },
+        "openai/gpt-5.5": {
+          agentRuntime: { id: "openclaw" },
+          params: { transport: "sse", openaiWsWarmup: false },
+        },
+      },
+    });
+    expect(cfg.agents.list[0]).toMatchObject({
+      model: { primary: "openai/gpt-5.5" },
+      models: {
+        "openai/gpt-5.5": {
+          params: { existing: true, transport: "sse", openaiWsWarmup: false },
+        },
+      },
+    });
+    expect(cfg.plugins).toEqual({ enabled: true });
+  });
+});

test/scripts/test-projects.test.ts

@@ -496,6 +496,10 @@ describe("scripts/test-projects changed-target routing", () => {
         ["test/scripts/fixture-config.test.ts", "test/scripts/fixtures-workspace.test.ts"],
       ],
       ["scripts/e2e/lib/fixtures/config.mjs", ["test/scripts/fixture-config.test.ts"]],
+      [
+        "scripts/e2e/lib/fixtures/mock-openai-config.mjs",
+        ["test/scripts/mock-openai-config.test.ts"],
+      ],
       [
         "scripts/e2e/lib/kitchen-sink-plugin/sweep.sh",
         ["test/scripts/kitchen-sink-plugin-assertions.test.ts"],