UNPKG

@bitkyc08/opencodex

Version:

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

209 lines (191 loc) • 10.3 kB
/** * Whether a settled Chat or Messages route may take the Antigravity direct lane. * * On that lane the ingress hands the Responses core a body that carries only the request * settings (model, stream, reasoning, limits, tool choice, tier) and decodes the conversation * straight from the client body into the IR at the parse seam (`src/protocols/codecs/chat-ir.ts`, * `messages-ir.ts`), so the Google adapter compiles from the caller's own messages. Everything * that is decided from those settings keeps its current owner in the core: routing, account * rotation, effort policy, usage and logging. * * PURE: reads the route, the body's structure and config. The ingresses and the protocol planner * (`src/protocols/plan-snapshot.ts`) both ask here, so a preview and the real send cannot * disagree about the lane. */ import { chatBodyCarriesImage } from "../chat/image-parts"; import { contentToText } from "../chat/inbound"; import { isClaudeWebSearchToolName } from "../claude/outbound"; import { isShadowSourceModel } from "../lib/shadow-call"; import type { ProtocolReasonCode } from "../protocols/contract"; import { resolveProtocolSettings } from "../protocols/settings"; import { effectiveGoogleMode } from "../providers/registry"; import type { RouteResult } from "../router"; import type { OcxConfig } from "../types"; import { requiresVisionPreprocessing } from "../vision"; /** Why the Antigravity direct lane declines a route, as a protocol reason code. */ export type AntigravityDirectDeclineReason = Extract< ProtocolReasonCode, | "rollout-disabled" | "not-migrated" | "combo-or-policy-route" | "hosted-tool" | "vision-preprocessing" | "bridge-only-policy" >; type Rec = Record<string, unknown>; function isRec(value: unknown): value is Rec { return value !== null && typeof value === "object" && !Array.isArray(value); } type RouteShape = Pick<RouteResult, "providerName" | "modelId" | "provider" | "combo" | "routeKind">; /** A Google adapter route in Cloud Code Assist mode: the Antigravity wire. */ export function isAntigravityRoute(route: Pick<RouteResult, "providerName" | "provider">): boolean { return effectiveGoogleMode(route.providerName, route.provider) === "cloud-code-assist"; } /** * A hosted web-search tool the bridge would hand to the web-search sidecar. The sidecar reads * the hosted tool from the parsed Responses body, which this lane does not build. */ function declaresHostedWebSearch(body: Readonly<Rec>): boolean { return Array.isArray(body.tools) && body.tools.some(tool => isRec(tool) && (tool.type === "web_search" || tool.type === "web_search_preview")); } /** * The shadow-call intercept rewrites the model to another target (often a combo) before the * core parses the body, so the request would leave the route this lane was decided for. */ function shadowInterceptMayApply(model: unknown, config: OcxConfig): boolean { const intercept = config.shadowCallIntercept; return intercept?.enabled === true && typeof intercept.model === "string" && intercept.model.length > 0 && typeof model === "string" && isShadowSourceModel(model, intercept.sourceModels); } const SKILLS_CATALOG_MARKER = "<skills_instructions>"; const GENERATED_IMAGE_LINK = "![Generated image](<"; /** * Text the Responses core rewrites on the bridge body before parsing: a skills catalog in an * instruction (the per-session skills snapshot substitutes a stored block) and a generated-image * link in assistant history (hosted display paths are redacted to the artifact URL). The lane's * settings-only body has neither, so such a request keeps the bridge. */ function carriesBridgeRewrittenText(body: Readonly<Rec>): boolean { if (!Array.isArray(body.messages)) return false; return body.messages.some(message => { if (!isRec(message)) return false; if (message.role === "system" || message.role === "developer") { return contentToText(message.content).includes(SKILLS_CATALOG_MARKER); } if (message.role === "assistant") return contentToText(message.content).includes(GENERATED_IMAGE_LINK); return false; }); } /** Request facts the body and config cannot carry, supplied by a caller that is about to send. */ export interface AntigravityDirectRuntime { /** * The cache diagnostic recorder is observing inbound bodies. It records the body the core * receives, which on the lane has no conversation, so the request keeps the bridge while it * observes. The planner never supplies this. */ cacheDiagnostics?: boolean; } /** * The first rule that keeps a Chat request off the Antigravity direct lane, or `undefined` when * the route is eligible. * * - the `protocols.rollout.antigravityDirect` switch is explicitly off (it defaults on); * - the final adapter is not Google in Cloud Code Assist mode; * - a combo or policy route owns multi-candidate execution in the Responses pipeline; * - a hosted web-search tool would engage the sidecar, which reads the Responses body; * - an image would reach a model the operator declared unable to read it (the vision sidecar * rewrites images on the Responses body as well as the IR); * - the shadow-call intercept could move the request to another target before parsing. * - the core would rewrite conversation text on the bridge body (a skills catalog, a generated * image link), or the cache diagnostic recorder is observing. */ export function antigravityDirectDeclineReason( route: RouteShape, body: Readonly<Rec>, config: OcxConfig, runtime: AntigravityDirectRuntime = {}, ): AntigravityDirectDeclineReason | undefined { const routeDecline = antigravityRouteDeclineReason(route, config); if (routeDecline) return routeDecline; if (declaresHostedWebSearch(body)) return "hosted-tool"; if (chatBodyCarriesImage(body) && requiresVisionPreprocessing(config, route.provider, route.modelId, route.providerName)) { return "vision-preprocessing"; } if (shadowInterceptMayApply(body.model, config)) return "bridge-only-policy"; if (carriesBridgeRewrittenText(body) || runtime.cacheDiagnostics === true) return "bridge-only-policy"; return undefined; } /** The declines that read only the route and config, shared by both ingresses. */ function antigravityRouteDeclineReason(route: RouteShape, config: OcxConfig): AntigravityDirectDeclineReason | undefined { if (!resolveProtocolSettings(config).rollout.antigravityDirect) return "rollout-disabled"; if (!isAntigravityRoute(route)) return "not-migrated"; if (route.combo !== undefined || route.routeKind === "combo" || route.routeKind === "policy") return "combo-or-policy-route"; return undefined; } function anthropicBlocks(content: unknown): Rec[] { return Array.isArray(content) ? content.filter(isRec) : []; } /** Text of an Anthropic `system` or message content: a string or its text blocks. */ function anthropicText(content: unknown): string { if (typeof content === "string") return content; return anthropicBlocks(content) .map(block => (block.type === "text" && typeof block.text === "string" ? block.text : "")) .join("\n"); } /** A Messages hosted web-search tool (or a forced WebSearch choice) would engage the sidecar. */ function messagesDeclaresHostedWebSearch(body: Readonly<Rec>): boolean { const tools = Array.isArray(body.tools) && body.tools.some(tool => isRec(tool) && typeof tool.type === "string" && tool.type.startsWith("web_search")); const choice = body.tool_choice; return tools || (isRec(choice) && choice.type === "tool" && typeof choice.name === "string" && isClaudeWebSearchToolName(choice.name)); } /** An image block in a user turn or inside a tool result. */ function messagesBodyCarriesImage(body: Readonly<Rec>): boolean { if (!Array.isArray(body.messages)) return false; return body.messages.some(message => isRec(message) && message.role === "user" && anthropicBlocks(message.content).some(block => block.type === "image" || (block.type === "tool_result" && anthropicBlocks(block.content).some(inner => inner.type === "image")))); } /** The Messages counterpart of `carriesBridgeRewrittenText`: system text and assistant history. */ function messagesCarryBridgeRewrittenText(body: Readonly<Rec>): boolean { if (anthropicText(body.system).includes(SKILLS_CATALOG_MARKER)) return true; if (!Array.isArray(body.messages)) return false; return body.messages.some(message => { if (!isRec(message)) return false; if (message.role === "system") return anthropicText(message.content).includes(SKILLS_CATALOG_MARKER); if (message.role === "assistant") return anthropicText(message.content).includes(GENERATED_IMAGE_LINK); return false; }); } /** * The first rule that keeps a Messages request off the Antigravity direct lane, or `undefined` * when the route is eligible. `model` is the resolved model the bridge body would carry, which is * what the shadow-call intercept matches. * * The route and config rules are the Chat ones. The body rules are the Messages spellings of the * same hazards: a hosted web-search tool (`web_search_*`) or forced WebSearch choice, an image * (in a user turn or a tool result) for a model the operator declared unable to read it, a * shadow-call intercept, a skills catalog in the system text or a generated-image link in * assistant history, or an observing cache diagnostic recorder. Blocked-skill elision, the * `stabilizePromptCache` relocation and the ocxr1 envelopes are reproduced by the decoder and * decline nothing. */ export function antigravityMessagesDeclineReason( route: RouteShape, body: Readonly<Rec>, model: string, config: OcxConfig, runtime: AntigravityDirectRuntime = {}, ): AntigravityDirectDeclineReason | undefined { const routeDecline = antigravityRouteDeclineReason(route, config); if (routeDecline) return routeDecline; if (messagesDeclaresHostedWebSearch(body)) return "hosted-tool"; if (messagesBodyCarriesImage(body) && requiresVisionPreprocessing(config, route.provider, route.modelId, route.providerName)) { return "vision-preprocessing"; } if (shadowInterceptMayApply(model, config)) return "bridge-only-policy"; if (messagesCarryBridgeRewrittenText(body) || runtime.cacheDiagnostics === true) return "bridge-only-policy"; return undefined; }