UNPKG

@bitkyc08/opencodex

Version:

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

63 lines (55 loc) • 4.09 kB
import type { OcxProviderConfig } from "../../types"; import { isCanonicalOpenAiForwardProvider } from "../../providers/openai-tiers"; import type { NativeSteeringReplayObserver } from "./native-steering-replay"; import type { ProviderExecutedCallType } from "../responses-undeclared-tool-guard"; import { isInjectionRequest } from "./native-injection-protocol"; import { registerProviderResponseProvenance } from "../../providers/request-pacing"; /** Shared transport ownership, not a shared steer/inject protocol state machine. */ export interface NativeResponseControl { readonly kind?: "steering" | "injection"; relayActive: boolean; normalizeContinuation?: (frame: Record<string, unknown>) => Record<string, unknown>; replayFactory?: () => NativeSteeringReplayObserver; configureToolAuthorization?: (active: boolean, names: ReadonlySet<string>, bareNames: ReadonlySet<string>, namelessCallTypes: ReadonlySet<string>, providerExecuted: ReadonlySet<ProviderExecutedCallType>) => void; readonly attached: boolean; readonly ended: boolean; attach(send: (frame: Record<string, unknown>) => void, fail: (error: Error) => void): () => void; observe(frame: Record<string, unknown>): boolean; steer(frame: Record<string, unknown>): void; inject?(frame: Record<string, unknown>): void; continue(frame: Record<string, unknown>): boolean; /** Apply operator-configured limits to the exact reconstructed upstream frame. */ assertOutboundFrame?(text: string): void; } export const OPENAI_API_RESPONSES_URL = "https://api.openai.com/v1/responses"; const nativeControlResponses = new WeakMap<Response, true>(); registerProviderResponseProvenance(nativeControlResponses); /** Mark the exact response for multi-response delivery without serializing a wire field. */ export function markNativeControlResponse(response: Response): Response { nativeControlResponses.set(response, true); return response; } /** Recognize a marked native response by identity, not by caller-controlled content. */ export function isNativeControlResponse(response: Response): boolean { return nativeControlResponses.has(response); } /** Canonical ChatGPT needs its upstream WS enabled; only injection may use the separately billed public API. */ export function nativeResponseControlEligible(provider: OcxProviderConfig, control?: NativeResponseControl): boolean { if (isCanonicalOpenAiForwardProvider(provider)) return provider.upstreamWebsocket !== false; return control?.kind === "injection" && provider.adapter === "openai-responses" && provider.upstreamWebsocket === true && provider.authMode !== "forward" && provider.baseUrl?.replace(/\/+$/, "") === "https://api.openai.com/v1"; } /** Select by execution mode, never model name; a multi-agent request cannot acquire steering. */ export function nativeResponseControlMode(frame: Record<string, unknown>, flags: { codexNativeInjection?: boolean; codexNativeSteering?: boolean; }): "injection" | "steering" | undefined { if (isInjectionRequest(frame)) return flags.codexNativeInjection === true ? "injection" : undefined; return nativeSteeringUnavailableReason(frame, flags.codexNativeSteering) === undefined ? "steering" : undefined; } /** Explain documented execution-mode exclusions without claiming model entitlement. */ export function nativeSteeringUnavailableReason(frame: Record<string, unknown>, enabled?: boolean): string | undefined { if (enabled !== true) return "Native steering is disabled; enable codexNativeSteering and WebSockets for a supported route."; if (isInjectionRequest(frame)) return "Multi-agent execution does not support single-agent response.steer; use a later client request."; if (frame.conversation != null) return "Conversation-bound responses do not support native steering."; if (Array.isArray(frame.context_management) && frame.context_management.some(item => item && typeof item === "object" && (item as Record<string, unknown>).type === "compaction")) { return "Automatic API compaction and native steering cannot share an active response."; } return undefined; }