@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
87 lines (78 loc) • 4.68 kB
text/typescript
import { googleVertexLocationConfigError } from "../providers/google-vertex-location";
import { VERTEX_PROJECT_AUTO } from "./google-vertex-key-project";
/**
* Vertex endpoint selection, shared by inference and replay identity.
*
* API keys follow explicit provider configuration only: `provider.project` selects the project
* endpoint (location defaults to `global`), otherwise the projectless express endpoint is used.
* `provider.project: "auto"` resolves the project of each key it sends (see
* google-vertex-key-project.ts), so one key pool may span several projects.
* Ambient GOOGLE_CLOUD_PROJECT / GCLOUD_PROJECT / GOOGLE_CLOUD_LOCATION belong to ADC, so an
* unrelated gcloud default in the shell cannot move an express-mode key onto another project.
*/
export type VertexEndpointSelection =
| { kind: "express" }
| { kind: "project"; project: string; location: string };
type VertexEndpointConfig = { project?: string; location?: string };
export function selectVertexEndpoint(
provider: VertexEndpointConfig,
hasApiKey: boolean,
env: NodeJS.ProcessEnv = process.env,
): VertexEndpointSelection {
// A blank or whitespace-only project is unset: it must not select a /projects/%20/ endpoint.
const rawProject = provider.project?.trim() || undefined;
const configuredProject = rawProject?.toLowerCase() === VERTEX_PROJECT_AUTO ? VERTEX_PROJECT_AUTO : rawProject;
if (hasApiKey) {
if (!configuredProject) return { kind: "express" };
return { kind: "project", project: configuredProject, location: provider.location || "global" };
}
// "auto" names a per-key lookup, never a project id; ADC has no key to resolve it from.
if (configuredProject === VERTEX_PROJECT_AUTO) {
throw new Error('Vertex AI project "auto" requires an API key; set provider.project to a project id for ADC.');
}
const project = configuredProject || env.GOOGLE_CLOUD_PROJECT || env.GCLOUD_PROJECT;
if (!project) throw new Error("Vertex AI requires a project id (provider.project or GOOGLE_CLOUD_PROJECT/GCLOUD_PROJECT).");
const location = provider.location || env.GOOGLE_CLOUD_LOCATION;
if (!location) throw new Error("Vertex AI requires a location (provider.location or GOOGLE_CLOUD_LOCATION).");
return { kind: "project", project, location };
}
/**
* Replay namespace for thought-signature continuation; mirrors the endpoint actually used.
* The endpoint kind is part of the key and the project is encoded, so no configured project
* (for example one literally named "api-key" or containing ":") can share express mode's space.
*/
export function vertexReplayModelKey(selection: VertexEndpointSelection, modelId: string): string {
return selection.kind === "express"
? `vertex:express:${modelId}`
: `vertex:project:${encodeURIComponent(selection.project)}:${selection.location}:${modelId}`;
}
const VERTEX_MODEL_PATH_REJECT = /[/?#\\%]/;
/** The model id is interpolated as one URL path segment after a fixed Google authority. */
export function vertexModelPathError(modelId: string): string | undefined {
if (!modelId || VERTEX_MODEL_PATH_REJECT.test(modelId) || modelId.includes("..")) {
return "Vertex AI model id must be a single path segment without '/', '?', '#', '\\', '%' or '..'.";
}
return undefined;
}
/** Builds the inference URL for a selection; validates location before any authority is formed. */
export function vertexInferenceUrl(selection: VertexEndpointSelection, modelId: string, method: string, streamParam: string): string {
const modelError = vertexModelPathError(modelId);
if (modelError) throw new Error(modelError);
if (selection.kind === "express") {
return `https://aiplatform.googleapis.com/v1/publishers/google/models/${modelId}:${method}${streamParam}`;
}
const locationError = googleVertexLocationConfigError(selection.location);
if (locationError) throw new Error(locationError);
const host = vertexHostForLocation(selection.location);
return `https://${host}/v1/projects/${encodeURIComponent(selection.project)}/locations/${selection.location}/publishers/google/models/${modelId}:${method}${streamParam}`;
}
/**
* The inference authority for an already validated location: `global` uses the global host, the
* `us` and `eu` multi-regions use their regional-endpoint (rep) hosts, and every region keeps
* `<location>-aiplatform.googleapis.com` (CPA's vertexBaseURL table).
*/
export function vertexHostForLocation(location: string): string {
if (location === "global") return "aiplatform.googleapis.com";
if (location === "us" || location === "eu") return `aiplatform.${location}.rep.googleapis.com`;
return `${location}-aiplatform.googleapis.com`;
}