import { describe, it } from "node:test"; import assert from "node:assert"; import * as generator from "../../../src/lib/cli-helper/config-generator/index.ts"; describe("config-generator", () => { describe("validateBaseUrl", () => { it("accepts http URLs", async () => { const mod = await import("../../../src/lib/cli-helper/config-generator/index.ts"); assert.strictEqual(mod.validateBaseUrl("http://localhost:20128"), true); }); it("accepts https URLs", async () => { const mod = await import("../../../src/lib/cli-helper/config-generator/index.ts"); assert.strictEqual(mod.validateBaseUrl("https://example.com"), true); }); it("rejects non-URL strings", async () => { const mod = await import("../../../src/lib/cli-helper/config-generator/index.ts"); assert.strictEqual(mod.validateBaseUrl("not-a-url"), false); }); }); describe("assertSafeCatalogUrl (SSRF guard, CodeQL #326)", () => { it("allows the loopback OmniRoute target (the legitimate default) and returns a URL", async () => { const { assertSafeCatalogUrl } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); // The catalog source IS the user's own OmniRoute — localhost must stay allowed. assert.doesNotThrow(() => assertSafeCatalogUrl("http://localhost:20128/v1/models")); assert.doesNotThrow(() => assertSafeCatalogUrl("http://127.0.0.1:20128/v1/models")); // Returns the validated, re-parsed URL (taint-severed value the caller fetches). const safe = assertSafeCatalogUrl("http://localhost:20128/v1/models"); assert.ok(safe instanceof URL); assert.equal(safe.href, "http://localhost:20128/v1/models"); }); it("allows a public OmniRoute Cloud target", async () => { const { assertSafeCatalogUrl } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); assert.doesNotThrow(() => assertSafeCatalogUrl("https://api.omniroute.online/v1/models")); }); it("blocks the cloud-metadata SSRF→IAM pivot (169.254.169.254)", async () => { const { assertSafeCatalogUrl } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); assert.throws(() => assertSafeCatalogUrl("http://169.254.169.254/v1/models")); assert.throws(() => assertSafeCatalogUrl("http://metadata.google.internal/v1/models") ); }); it("blocks non-http(s) protocols and embedded credentials", async () => { const { assertSafeCatalogUrl } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); assert.throws(() => assertSafeCatalogUrl("file:///etc/passwd")); assert.throws(() => assertSafeCatalogUrl("http://user:pass@example.com/v1/models")); }); }); describe("generateConfig", () => { it("returns error for invalid baseUrl", async () => { const result = await generator.generateConfig("claude", { baseUrl: "invalid", apiKey: "sk-xxx", }); assert.strictEqual(result.success, false); assert.ok(result.error?.includes("Invalid baseUrl")); }); it("returns error for empty apiKey", async () => { const result = await generator.generateConfig("claude", { baseUrl: "http://localhost:20128", apiKey: "", }); assert.strictEqual(result.success, false); assert.ok(result.error?.includes("API key")); }); it("returns success for valid claude config", async () => { // This may fail if the claude generator has issues - just ensure error handling works const result = await generator.generateConfig("claude", { baseUrl: "http://localhost:20128", apiKey: "sk-test", }); // Either success or error (if generator missing), but check structure is correct assert.ok("success" in result); assert.ok("configPath" in result); }); it("returns success for valid hermes config", async () => { const result = await generator.generateConfig("hermes", { baseUrl: "http://localhost:20128", apiKey: "sk-test", model: "gpt-5.4-mini", }); assert.strictEqual(result.success, true); assert.ok(result.configPath.endsWith(".hermes/config.yaml")); assert.ok(String(result.content || "").includes("providers:")); assert.ok(String(result.content || "").includes("omniroute")); }); it("returns error for unknown tool", async () => { const result = await generator.generateConfig("unknown-tool-xyz", { baseUrl: "http://localhost:20128", apiKey: "sk-xxx", }); assert.strictEqual(result.success, false); assert.ok(result.error?.includes("Unknown tool")); }); }); describe("generateAllConfigs", () => { it("returns array of GenerateResult for all tools", async () => { const results = await generator.generateAllConfigs({ baseUrl: "http://localhost:20128", apiKey: "sk-xxx", }); assert.ok(Array.isArray(results)); assert.strictEqual(results.length, 7); // claude, codex, opencode, cline, kilocode, continue, hermes }); }); describe("hermes-agent (rich multi-role)", () => { it("exports HERMES_AGENT_ROLES with expected roles", async () => { const hermesAgent = await import("../../../src/lib/cli-helper/config-generator/hermes-agent.ts"); assert.ok(Array.isArray(hermesAgent.HERMES_AGENT_ROLES)); const ids = hermesAgent.HERMES_AGENT_ROLES.map((r: any) => r.id); assert.ok(ids.includes("default")); assert.ok(ids.includes("delegation")); assert.ok(ids.includes("vision")); assert.ok(ids.includes("approval")); }); it("getCurrentHermesAgentRoles returns an object", async () => { const hermesAgent = await import("../../../src/lib/cli-helper/config-generator/hermes-agent.ts"); const roles = await hermesAgent.getCurrentHermesAgentRoles(); assert.ok(typeof roles === "object" && roles !== null); }); it("generateHermesAgentConfig returns yaml string for valid payload", async () => { const hermesAgent = await import("../../../src/lib/cli-helper/config-generator/hermes-agent.ts"); const result = await hermesAgent.generateHermesAgentConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test-omniroute", selections: [ { role: "default", model: "gpt-4o" }, { role: "delegation", model: "claude-3-5-sonnet" }, { role: "vision", model: "gpt-4o" }, ], }); assert.ok(!result.error); assert.ok(typeof result.yaml === "string"); assert.ok(result.yaml.length > 50); assert.ok(result.yaml.includes("provider: omniroute")); }); it("generateHermesAgentConfig includes auxiliary section for non-default roles", async () => { const hermesAgent = await import("../../../src/lib/cli-helper/config-generator/hermes-agent.ts"); const result = await hermesAgent.generateHermesAgentConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", selections: [ { role: "compression", model: "test-model" }, { role: "skills_hub", model: "test-model-2" }, ], }); assert.ok(result.yaml.includes("auxiliary:")); assert.ok(result.yaml.includes("compression:")); }); it("generateHermesAgentConfig returns error when baseUrl is missing", async () => { const hermesAgent = await import("../../../src/lib/cli-helper/config-generator/hermes-agent.ts"); const result = await hermesAgent.generateHermesAgentConfig({ baseUrl: "", selections: [{ role: "default", model: "x" }], } as any); assert.ok(result.error); assert.ok(result.error.includes("baseUrl")); }); it("generateHermesAgentConfig correctly structures delegation and auxiliary roles", async () => { const hermesAgent = await import("../../../src/lib/cli-helper/config-generator/hermes-agent.ts"); const result = await hermesAgent.generateHermesAgentConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", selections: [ { role: "default", model: "model-default" }, { role: "delegation", model: "model-delegation" }, { role: "approval", model: "model-approval" }, ], }); const yaml = result.yaml; assert.ok(yaml.includes("model:")); assert.ok(yaml.includes("default: model-default")); assert.ok(yaml.includes("delegation:")); assert.ok(yaml.includes("auxiliary:")); assert.ok(yaml.includes("approval:")); }); it("generateHermesAgentConfig performs non-destructive merge (preserves other keys)", async () => { // This test mainly verifies the function doesn't blow away unrelated config const hermesAgent = await import("../../../src/lib/cli-helper/config-generator/hermes-agent.ts"); const result = await hermesAgent.generateHermesAgentConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", selections: [{ role: "default", model: "new-model" }], }); // Should still contain providers block and the new model assert.ok(result.yaml.includes("providers:")); assert.ok(result.yaml.includes("new-model")); }); }); describe("opencode (context-aware)", () => { /** * The catalog is the single source of truth for context windows — * we never fabricate a default. Tests below pin this contract. */ function makeCatalogResponse(models: unknown[]): unknown { return { object: "list", data: models }; } const SAMPLE_CATALOG: unknown[] = [ { id: "ds/deepseek-v4-flash", owned_by: "deepseek", context_length: 1_000_000, max_input_tokens: 1_000_000 }, { id: "llama3", owned_by: "llama", max_context_window_tokens: 8192 }, { id: "MASTER", owned_by: "combo", context_length: 131072, max_input_tokens: 131072 }, { id: "Opencode FREE Omni", owned_by: "combo", context_length: 200000, max_input_tokens: 160000 }, // Combo whose targets have no known context — generator must NOT // fabricate a default. The model is emitted without limit.context. { id: "NO_CTX_COMBO", owned_by: "combo" }, ]; function stubFetchOnce(body: unknown, status = 200) { const original = globalThis.fetch; let calls = 0; // @ts-ignore — globalThis.fetch signature is compatible for our purposes globalThis.fetch = (async (url: string | URL, init?: RequestInit) => { calls += 1; return new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json" }, }); }) as typeof fetch; return { calls: () => calls, restore: () => { globalThis.fetch = original; }, }; } it("emits limit.context from the catalog (no hardcoded fallback)", async () => { const stub = stubFetchOnce(makeCatalogResponse(SAMPLE_CATALOG)); try { const { generateOpencodeConfig } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); const out = await generateOpencodeConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", }); const cfg = JSON.parse(out); const models = cfg.provider.omniroute.models; assert.strictEqual(models["ds/deepseek-v4-flash"].limit.context, 1_000_000); assert.strictEqual(models["MASTER"].limit.context, 131072); // Combo with min-of-targets 200K: must reflect the catalog's value, // not a hardcoded 128K. assert.strictEqual(models["Opencode FREE Omni"].limit.context, 200000); } finally { stub.restore(); } }); it("does NOT fabricate a default context when the catalog has no entry", async () => { const stub = stubFetchOnce(makeCatalogResponse(SAMPLE_CATALOG)); try { const { generateOpencodeConfig } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); const out = await generateOpencodeConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", }); const cfg = JSON.parse(out); // NO_CTX_COMBO has no context_length in the catalog — generator // must NOT default to 128K (or any other value). The entry is // emitted without limit.context so OpenCode's own heuristic // applies and the user can fix the upstream. const noCtx = cfg.provider.omniroute.models["NO_CTX_COMBO"]; assert.strictEqual( noCtx.limit?.context, undefined, `NO_CTX_COMBO should not have a fabricated limit.context (got ${noCtx.limit?.context})` ); } finally { stub.restore(); } }); it("prefers max_context_window_tokens when context_length is absent", async () => { const stub = stubFetchOnce(makeCatalogResponse(SAMPLE_CATALOG)); try { const { generateOpencodeConfig } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); const out = await generateOpencodeConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", }); const cfg = JSON.parse(out); assert.strictEqual(cfg.provider.omniroute.models.llama3.limit.context, 8192); } finally { stub.restore(); } }); it("THROWS when the catalog fetch fails (no silent stale config)", async () => { // When the catalog fetch fails, the generator MUST throw rather than // emit a config with fabricated values. The CLI catches the error // and surfaces it to the user; the user's existing opencode.json is // left untouched. const original = globalThis.fetch; // @ts-ignore globalThis.fetch = (async () => { throw new Error("ECONNREFUSED"); }) as typeof fetch; try { const { generateOpencodeConfig } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); let threw = false; try { await generateOpencodeConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", }); } catch (e) { threw = true; assert.ok( /catalog|fetch|ECONNREFUSED/i.test(String(e?.message ?? e)), `Expected fetch error, got: ${String(e?.message ?? e)}` ); } assert.ok(threw, "generator must throw when catalog fetch fails"); } finally { globalThis.fetch = original; } }); it("writes a top-level model prefixed with provider id when options.model is supplied", async () => { const stub = stubFetchOnce(makeCatalogResponse(SAMPLE_CATALOG)); try { const { generateOpencodeConfig } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); const out = await generateOpencodeConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", model: "MASTER", }); const cfg = JSON.parse(out); assert.strictEqual(cfg.model, "omniroute/MASTER"); } finally { stub.restore(); } }); it("auto-pulls the Opencode FREE Omni combo context (the user-reported case)", async () => { // Regression guard: the catalog's min-of-targets for combos must be // reflected verbatim. No hardcoded 128K, no fallback that overrides // the catalog's actual value. const stub = stubFetchOnce(makeCatalogResponse(SAMPLE_CATALOG)); try { const { generateOpencodeConfig } = await import( "../../../src/lib/cli-helper/config-generator/opencode.ts" ); const out = await generateOpencodeConfig({ baseUrl: "http://localhost:20128", apiKey: "sk-test", }); const cfg = JSON.parse(out); assert.strictEqual( cfg.provider.omniroute.models["Opencode FREE Omni"].limit.context, 200000, "Opencode FREE Omni must have context=200000 from the catalog, not 128000" ); } finally { stub.restore(); } }); }); });