@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
text/typescript
/**
* 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 = " 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;
}