UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

50 lines (44 loc) • 2.53 kB
/** * The request path a settled route takes, derived from the lane the ingress chose and the * upstream wire of the final adapter. The observed trace (PF-02) and the planner (PF-03) both * call this, so a preview and the log of the same request can never disagree on the rule. * * LEAF MODULE (see `contract.ts`). */ import { deliveryModeForPath, type DeliveryMode, type Protocol, type ProtocolHop, type UpstreamWire } from "./contract"; /** * `native`: the ingress sent its own wire to a same-wire upstream. * `bridge`: the ingress projected the request into the Responses pipeline. * `direct`: the ingress decoded its own wire straight into the IR the final adapter compiles * from, with no internal Responses body in between (the Antigravity direct lane). Only a Chat or * Messages ingress toward a non-protocol (`other`) upstream takes it; anything else falls back * to the bridge rule so an inconsistent mark cannot claim a path that does not exist. */ export type ProtocolLane = "native" | "bridge" | "direct"; function directApplies(inbound: Protocol, lane: ProtocolLane, upstream: UpstreamWire): boolean { return lane === "direct" && inbound !== "responses" && upstream === "other"; } export function requestPathForLane(inbound: Protocol, lane: ProtocolLane, upstream: UpstreamWire): ProtocolHop[] { if (inbound === "responses") { return upstream === "responses" ? ["responses", "responses"] : ["responses", "ir", upstream]; } if (lane === "native") return [inbound, inbound]; if (directApplies(inbound, lane, upstream)) return [inbound, "ir", upstream]; if (upstream === "responses") return [inbound, "responses"]; return [inbound, "responses-internal", "ir", upstream]; } /** Upstream first, client last; the internal Responses hop is not replayed on the way back. */ export function responsePathForLane(inbound: Protocol, lane: ProtocolLane, upstream: UpstreamWire): ProtocolHop[] { if (inbound === "responses") return upstream === "responses" ? ["responses", "responses"] : [upstream, "ir", "responses"]; if (lane === "native") return [inbound, inbound]; if (directApplies(inbound, lane, upstream)) return [upstream, "ir", inbound]; if (upstream === "responses") return ["responses", inbound]; return [upstream, "ir", "responses-internal", inbound]; } export function deliveryModeForLane( inbound: Protocol, lane: ProtocolLane, upstream: UpstreamWire, ): Exclude<DeliveryMode, "blocked"> { return deliveryModeForPath(requestPathForLane(inbound, lane, upstream)); }