Files
OmniRoute/tests/unit/chat-core-intercept-fetch.test.ts
Diego Rodrigues de Sa e Souza a95da4a902 feat(routing): wire interceptFetch tool interception into the chat pipeline (#7339) (#7736)
Phases 3-4 of #3384 (Phases 1-2 shipped DB schema + resolveInterceptSearch in
release/v3.8.47). Adds resolveInterceptFetch(provider, model) as a structural
twin of resolveInterceptSearch, and open-sse/services/webFetchInterception.ts
(mirroring webSearchFallback.ts) to rewrite a provider-native web_fetch tool
declaration into a synthetic omniroute_web_fetch function tool. The synthetic
tool call is dispatched through the existing handleToolCallExecution path
(same as omniroute_web_search) to a new web_fetch builtin skill handler that
resolves credentials and calls handleWebFetch() against /v1/web/fetch.

Strictly opt-in: with no interceptFetch DB row configured (the default), the
outgoing request body is byte-identical to pre-change behavior — no heuristic
default bypass like the interceptSearch sibling, to guarantee zero overhead
when disabled (Hard Rule #20).

Also ships the dashboard toggle (owner decision, overriding the plan's
backend-only recommendation): ProviderInterceptionSection.tsx on the provider
detail page, backed by GET/PUT/DELETE /api/providers/[id]/interception-rules,
covering both interceptSearch and interceptFetch from one control.

chatCore.ts touch is minimal (frozen file): one resolver call + one
prepareWebFetchFallbackBody call mirroring the existing interceptSearch block,
plus threading provider/model into the existing handleToolCallExecution call.
2026-07-19 14:37:30 -03:00

116 lines
4.0 KiB
TypeScript

import { describe, it, beforeEach, after } from "node:test";
import assert from "node:assert/strict";
import os from "node:os";
import path from "node:path";
import fs from "node:fs";
// #7339 — regression guard for the chatCore.ts call site added right after the
// existing interceptSearch block. Proves that with no interceptFetch DB row
// configured (the default/common case), a request carrying a native web_fetch
// tool declaration produces a BYTE-IDENTICAL outgoing body to pre-#7339
// behavior — chatCore.ts never called any web_fetch interception logic before
// this change, so "byte-identical" here means prepareWebFetchFallbackBody must
// be a true no-op end to end (resolver -> body-prep), not just individually.
const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "omniroute-test-chatcore-intercept-fetch-"));
process.env.DATA_DIR = tmpDir;
const core = await import("../../src/lib/db/core.ts");
const { setInterceptionRules, resolveInterceptFetch } = await import(
"../../src/lib/db/interceptionRules.ts"
);
const { prepareWebFetchFallbackBody } = await import(
"../../open-sse/services/webFetchInterception.ts"
);
function buildRequestBody() {
return {
model: "gpt-5",
messages: [{ role: "user", content: "Summarize https://example.com" }],
tools: [{ type: "web_fetch" }],
};
}
// Mirrors the exact two-call sequence chatCore.ts now runs at its interceptFetch
// call site: resolveInterceptFetch(provider, effectiveModel) followed by
// prepareWebFetchFallbackBody(body, { ...options, interceptFetchOverride }).
function runChatCoreInterceptFetchStep(
provider: string,
effectiveModel: string,
body: Record<string, unknown>
) {
const interceptFetchOverride = resolveInterceptFetch(provider, effectiveModel);
return prepareWebFetchFallbackBody(body, {
provider,
sourceFormat: "openai",
targetFormat: "openai",
nativeCodexPassthrough: false,
interceptFetchOverride,
});
}
describe("chatCore.ts interceptFetch call site — flag-off regression guard (#7339)", () => {
function resetDb() {
core.resetDbInstance();
fs.rmSync(tmpDir, { recursive: true, force: true });
fs.mkdirSync(tmpDir, { recursive: true });
}
beforeEach(() => {
resetDb();
});
after(() => {
core.resetDbInstance();
fs.rmSync(tmpDir, { recursive: true, force: true });
});
it("leaves the outgoing body byte-identical when no interceptFetch rule is configured", () => {
const originalBody = buildRequestBody();
const preChangeSerialized = JSON.stringify(originalBody);
const { body: nextBody, fallback } = runChatCoreInterceptFetchStep(
"openai",
"gpt-5",
originalBody
);
assert.equal(fallback.enabled, false);
assert.equal(JSON.stringify(nextBody), preChangeSerialized);
assert.equal(nextBody, originalBody, "must be the same object reference — true no-op");
});
it("leaves the body untouched for a request with no web_fetch tool at all, regardless of rule state", () => {
setInterceptionRules("openai", { interceptFetch: true });
const originalBody = {
model: "gpt-5",
messages: [{ role: "user", content: "hi" }],
tools: [{ type: "function", function: { name: "get_weather", parameters: {} } }],
};
const preChangeSerialized = JSON.stringify(originalBody);
const { body: nextBody, fallback } = runChatCoreInterceptFetchStep(
"openai",
"gpt-5",
originalBody
);
assert.equal(fallback.enabled, false);
assert.equal(JSON.stringify(nextBody), preChangeSerialized);
});
it("only converts the tool once the operator explicitly opts a provider/model into interceptFetch", () => {
setInterceptionRules("openai", { interceptFetch: true });
const originalBody = buildRequestBody();
const { body: nextBody, fallback } = runChatCoreInterceptFetchStep(
"openai",
"gpt-5",
originalBody
);
assert.equal(fallback.enabled, true);
assert.notEqual(nextBody, originalBody);
assert.equal(originalBody.tools[0].type, "web_fetch", "the input object itself is untouched");
});
});