Distillation

🔴 (09:53) User required requests already targeting the gateway never be intercepted; direct gateway requests may still have their authentication headers observed for in-process extension scoping.

🔴 (09:53) User required local requests never be intercepted because they may target a local LLM or the gateway itself; local bypasses include localhost, 127.0.0.1, 0.0.0.0, ::1, and [::1].

🔴 (09:53) User required unreadable streaming-body requests never be rewritten to the gateway.

🔴 (09:53) Current installFetchInterceptor() in packages/core/src/fetch-interceptor.ts has a fast exit that avoids URL parsing unless the URL contains /messages, /completions, or /responses.

🔴 (09:53) Current installFetchInterceptor() extracts a URL from RequestInfo | URL, parses it once, bypasses invalid URLs, observes headers on direct gateway requests, and bypasses local hosts before attempting either URL-pattern or body-shape routing.

🔴 (09:53) Current URL-matched interception in packages/core/src/fetch-interceptor.ts calls interceptUrl(), then buildGatewayHeaders(), then observeRequestHeaders(), and finally invokes originalFetch(rewrite.gatewayUrl, { ...init, headers }).

🔴 (09:53) Current body-shape fallback in packages/core/src/fetch-interceptor.ts runs only when host is present and pathLooksLLMLike(upstream.pathname) is true; it calls extractBodyString(input, init), detectProtocolFromBody(), interceptUrlForProtocol(), buildGatewayHeaders(), and observeRequestHeaders().

🔴 (09:53) Unrecognized LLM-looking paths are passed through and warned once using warnedPaths keyed by ${upstream.host}${upstream.pathname}.

🔴 (09:53) installFetchInterceptor() preserves extra properties from the original fetch via globalThis.fetch = Object.assign(interceptor, originalFetch); cleanup restores globalThis.fetch = originalFetch and calls writeOriginalFetchSlot(null).

🔴 (09:53) Existing fetch-interceptor test files are packages/core/test/fetch-interceptor-paths.test.ts, packages/core/test/fetch-interceptor-install.test.ts, packages/core/test/fetch-interceptor-global.test.ts, and packages/core/test/fetch-interceptor-body.test.ts.

🔴 (09:53) packages/core/test/fetch-interceptor-install.test.ts uses gateway http://127.0.0.1:3207, injects dynamic headers x-lore-session-id: sess-123 and x-lore-project: /home/me/proj, and observes both authorization and x-api-key.

🔴 (09:53) Existing URL-routing tests in packages/core/test/fetch-interceptor-install.test.ts cover: Anthropic https://api.anthropic.com/v1/messages → ${GATEWAY}/v1/messages with upstream URL https://api.anthropic.com; Codex https://chatgpt.com/backend-api/codex/responses → ${GATEWAY}/v1/codex/responses with upstream URL https://chatgpt.com/backend-api; OpenAI authorization preservation; direct-gateway auth observation; simultaneous authorization and x-api-key preservation; intact string-body forwarding; and OpenRouter https://openrouter.ai/api/v1/chat/completions → ${GATEWAY}/v1/chat/completions with upstream URL https://openrouter.ai/api.

🔴 (09:53) Existing body-fallback tests cover: /v2/chat/completions detected as openai; /llm/messages detected as anthropic; /custom/responses detected as openai-responses; detection from a Uint8Array body; bypass for unrecognized { model: "gpt-4", prompt: "hi" }; and no gateway rewrite for an unreadable ReadableStream body using duplex: "half".

🔴 (09:53) Existing x-lore-upstream-path tests cover exact paths /chat/completions, /v1/chat/completions, /api/v1/chat/completions, and /backend-api/codex/responses, including GitHub Copilot’s bare endpoint and full aggregator prefixes.

🔴 (09:53) Existing non-interception tests verify https://registry.npmjs.org/some-package passes through untouched and http://localhost:8000/v1/messages is not intercepted.

🔴 (09:53) Existing interceptUrlForProtocol() tests verify: openai maps to /v1/chat/completions; anthropic maps to /v1/messages; openai-responses maps to /v1/responses; known endpoint suffixes are stripped from upstreamBase; full original upstreamPath is retained; ?stream=true is preserved; and unknown suffixes fall back to the upstream origin.