@gajae-code/ai 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-30
+
+### Changed
+
+- Refreshed AI package metadata for the GJC 0.2.1 release.
+
 ## [0.2.0] - 2026-05-28
 
 ### Fixed

package/dist/types/providers/openai-request-transform.d.ts

@@ -0,0 +1,4 @@
+import type { FetchImpl, ModelRequestTransform } from "../types";
+export declare function applyOpenAIRequestTransformHeaders(headers: Record<string, string>, transform: ModelRequestTransform | undefined, profileUserAgent: string): Record<string, string>;
+export declare function applyOpenAIRequestTransformBody(params: object, transform: ModelRequestTransform | undefined): void;
+export declare function wrapFetchForOpenAIRequestTransform(baseFetch: FetchImpl, transform: ModelRequestTransform | undefined, profileUserAgent: string): FetchImpl;

package/dist/types/types.d.ts

@@ -689,6 +689,16 @@ export interface VercelGatewayRouting {
     /** List of provider slugs to try in order (e.g., ["anthropic", "openai"]). */
     order?: string[];
 }
+export interface ModelRequestTransform {
+    /** Named request-shaping preset. `openai-proxy` removes OpenAI SDK telemetry headers and uses a generic Gajae-Code User-Agent. */
+    profile?: "openai-proxy";
+    /** Header names to remove from the final outbound request. Case-insensitive. */
+    stripHeaders?: string[];
+    /** Headers to set after stripping; use null to remove a header explicitly. */
+    setHeaders?: Record<string, string | null>;
+    /** Extra request body fields merged after provider defaults; protected core request keys are ignored. */
+    extraBody?: Record<string, unknown>;
+}
 export interface Model<TApi extends Api = any> {
     id: string;
     name: string;
@@ -727,6 +737,10 @@ export interface Model<TApi extends Api = any> {
     preferWebsockets?: boolean;
     /** Preferred model to switch to when context promotion is triggered (model id or provider/id). */
     contextPromotionTarget?: string;
+    /** Provider-facing model id when it differs from the local selector id. */
+    wireModelId?: string;
+    /** Declarative request shaping for OpenAI-compatible proxy providers. */
+    requestTransform?: ModelRequestTransform;
     /** Provider-assigned priority value (lower = higher priority). */
     priority?: number;
     /** Canonical thinking capability metadata for this model. */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/ai",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"description": "Unified LLM API with automatic model discovery and provider configuration",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -43,7 +43,7 @@
 	"dependencies": {
 		"@anthropic-ai/sdk": "^0.94.0",
 		"@bufbuild/protobuf": "^2.12.0",
-		"@gajae-code/utils": "0.2.0",
+		"@gajae-code/utils": "0.2.1",
 		"openai": "^6.36.0",
 		"partial-json": "^0.1.7",
 		"zod": "4.4.3"

package/src/providers/google-gemini-headers.ts

@@ -4,7 +4,7 @@
  * GeminiCLI/VERSION/MODEL (PLATFORM; ARCH; SURFACE)
  */
 export function getGeminiCliUserAgent(modelId = "gemini-3.1-pro-preview"): string {
-	const version = process.env.PI_AI_GEMINI_CLI_VERSION || "0.35.3";
+	const version = process.env.PI_AI_GEMINI_CLI_VERSION || "0.44.1";
 	const platform = process.platform === "win32" ? "win32" : process.platform;
 	const arch = process.arch === "x64" ? "x64" : process.arch;
 	return `GeminiCLI/${version}/${modelId} (${platform}; ${arch}; terminal)`;

package/src/providers/openai-completions.ts

@@ -66,6 +66,11 @@ import {
 	resolveGitHubCopilotBaseUrl,
 } from "./github-copilot-headers";
 import { detectOpenAICompat, type ResolvedOpenAICompat, resolveOpenAICompat } from "./openai-completions-compat";
+import {
+	applyOpenAIRequestTransformBody,
+	applyOpenAIRequestTransformHeaders,
+	wrapFetchForOpenAIRequestTransform,
+} from "./openai-request-transform";
 import { createInitialResponsesAssistantMessage } from "./openai-responses-shared";
 import { transformMessages } from "./transform-messages";
 import { joinTextWithImagePlaceholder, NON_VISION_IMAGE_PLACEHOLDER } from "./vision-guard";
@@ -956,6 +961,7 @@ async function createClient(
 	if (model.provider === "kimi-code") {
 		headers = { ...getKimiCommonHeaders(), ...headers };
 	}
+	headers = applyOpenAIRequestTransformHeaders(headers, model.requestTransform, `Gajae-Code/${packageJson.version}`);
 	let copilotPremiumRequests: number | undefined;
 
 	let baseUrl =
@@ -1013,7 +1019,14 @@ async function createClient(
 		},
 		baseFetch.preconnect ? { preconnect: baseFetch.preconnect } : {},
 	);
-	const debugFetch = onSseEvent ? wrapFetchForSseDebug(wrappedFetch, event => onSseEvent(event, model)) : wrappedFetch;
+	const transformedFetch = wrapFetchForOpenAIRequestTransform(
+		wrappedFetch,
+		model.requestTransform,
+		`Gajae-Code/${packageJson.version}`,
+	);
+	const debugFetch = onSseEvent
+		? wrapFetchForSseDebug(transformedFetch, event => onSseEvent(event, model))
+		: transformedFetch;
 	// Bound HTTP request timeout to roughly the first-event watchdog window.
 	// The OpenAI SDK's default is 10 minutes per attempt × `maxRetries`, which
 	// turns a stalled-before-headers fetch into a multi-minute hang invisible
@@ -1078,11 +1091,12 @@ function buildParams(
 	const effectiveMaxTokens = options?.maxTokens ?? (isKimi ? model.maxTokens : undefined);
 
 	const requestModelId =
-		model.provider === "fireworks"
+		model.wireModelId ??
+		(model.provider === "fireworks"
 			? toFireworksWireModelId(model.id)
 			: model.provider === "firepass"
 				? toFirepassWireModelId(model.id)
-				: model.id;
+				: model.id);
 	const params: OpenAICompletionsParams = {
 		model: requestModelId,
 		messages,
@@ -1260,6 +1274,7 @@ function buildParams(
 	if (compat.extraBody) {
 		Object.assign(params, compat.extraBody);
 	}
+	applyOpenAIRequestTransformBody(params, model.requestTransform);
 
 	return { params, toolStrictMode };
 }

package/src/providers/openai-request-transform.ts

@@ -0,0 +1,135 @@
+import type { FetchImpl, ModelRequestTransform } from "../types";
+
+const PROTECTED_EXTRA_BODY_KEYS = new Set([
+	"model",
+	"messages",
+	"input",
+	"instructions",
+	"stream",
+	"stream_options",
+	"store",
+	"max_tokens",
+	"max_completion_tokens",
+	"max_output_tokens",
+	"temperature",
+	"top_p",
+	"presence_penalty",
+	"frequency_penalty",
+	"reasoning",
+	"reasoning_effort",
+	"prompt_cache_key",
+	"prompt_cache_retention",
+	"service_tier",
+	"stop",
+	"tools",
+	"tool_choice",
+	"parallel_tool_calls",
+]);
+
+const OPENAI_PROXY_STRIP_HEADERS = [
+	"x-stainless-arch",
+	"x-stainless-async",
+	"x-stainless-lang",
+	"x-stainless-os",
+	"x-stainless-package-version",
+	"x-stainless-retry-count",
+	"x-stainless-runtime",
+	"x-stainless-runtime-version",
+	"x-stainless-timeout",
+	"x-stainless-helper-method",
+	"openai-organization",
+	"openai-project",
+] as const;
+
+function resolveRequestTransform(
+	transform: ModelRequestTransform | undefined,
+	profileUserAgent: string,
+): ModelRequestTransform | undefined {
+	if (!transform) return undefined;
+	const profileTransform: ModelRequestTransform =
+		transform.profile === "openai-proxy"
+			? {
+					stripHeaders: [...OPENAI_PROXY_STRIP_HEADERS],
+					setHeaders: { "User-Agent": profileUserAgent },
+				}
+			: {};
+	return {
+		...profileTransform,
+		...transform,
+		stripHeaders: transform.stripHeaders ?? profileTransform.stripHeaders,
+		setHeaders: transform.setHeaders
+			? { ...(profileTransform.setHeaders ?? {}), ...transform.setHeaders }
+			: profileTransform.setHeaders,
+		extraBody: transform.extraBody,
+	};
+}
+
+function deleteHeaders(headers: Headers, names: readonly string[] | undefined): void {
+	for (const name of names ?? []) {
+		headers.delete(name);
+	}
+}
+
+function setHeaders(headers: Headers, values: Record<string, string | null> | undefined): void {
+	for (const [name, value] of Object.entries(values ?? {})) {
+		if (value === null) {
+			headers.delete(name);
+		} else {
+			headers.set(name, value);
+		}
+	}
+}
+
+function transformHeaders(
+	headers: RequestInit["headers"] | undefined,
+	transform: ModelRequestTransform | undefined,
+): Headers {
+	const result = new Headers(headers);
+	deleteHeaders(result, transform?.stripHeaders);
+	setHeaders(result, transform?.setHeaders);
+	return result;
+}
+
+export function applyOpenAIRequestTransformHeaders(
+	headers: Record<string, string>,
+	transform: ModelRequestTransform | undefined,
+	profileUserAgent: string,
+): Record<string, string> {
+	const resolved = resolveRequestTransform(transform, profileUserAgent);
+	if (!resolved) return headers;
+	return Object.fromEntries(transformHeaders(headers, resolved).entries());
+}
+
+export function applyOpenAIRequestTransformBody(params: object, transform: ModelRequestTransform | undefined): void {
+	if (!transform?.extraBody) return;
+	const body = params as Record<string, unknown>;
+	for (const [key, value] of Object.entries(transform.extraBody)) {
+		if (!PROTECTED_EXTRA_BODY_KEYS.has(key) && !(key in body)) {
+			body[key] = value;
+		}
+	}
+}
+
+export function wrapFetchForOpenAIRequestTransform(
+	baseFetch: FetchImpl,
+	transform: ModelRequestTransform | undefined,
+	profileUserAgent: string,
+): FetchImpl {
+	const resolved = resolveRequestTransform(transform, profileUserAgent);
+	if (!resolved) return baseFetch;
+	return Object.assign(
+		async (input: string | URL | Request, init?: RequestInit): Promise<Response> => {
+			if (input instanceof Request) {
+				const request = new Request(input, init);
+				deleteHeaders(request.headers, resolved.stripHeaders);
+				setHeaders(request.headers, resolved.setHeaders);
+				return baseFetch(request);
+			}
+			return baseFetch(input, {
+				...init,
+				headers: transformHeaders(init?.headers, resolved),
+			});
+		},
+		baseFetch.preconnect ? { preconnect: baseFetch.preconnect } : {},
+	);
+}

package/src/providers/openai-responses.ts

@@ -5,6 +5,7 @@ import type {
 	ResponseCreateParamsStreaming,
 	ResponseInput,
 } from "openai/resources/responses/responses";
+import packageJson from "../../package.json" with { type: "json" };
 import { getEnvApiKey } from "../stream";
 import type {
 	AssistantMessage,
@@ -50,6 +51,11 @@ import {
 	resolveGitHubCopilotBaseUrl,
 } from "./github-copilot-headers";
 import { compactGrammarDefinition } from "./grammar";
+import {
+	applyOpenAIRequestTransformBody,
+	applyOpenAIRequestTransformHeaders,
+	wrapFetchForOpenAIRequestTransform,
+} from "./openai-request-transform";
 import {
 	appendResponsesToolResultMessages,
 	applyCommonResponsesSamplingParams,
@@ -363,7 +369,11 @@ function createClient(
 	}
 	const rawApiKey = apiKey;
 
-	const headers = { ...(model.headers ?? {}), ...(extraHeaders ?? {}) };
+	const headers = applyOpenAIRequestTransformHeaders(
+		{ ...(model.headers ?? {}), ...(extraHeaders ?? {}) },
+		model.requestTransform,
+		`Gajae-Code/${packageJson.version}`,
+	);
 	let copilotPremiumRequests: number | undefined;
 
 	let baseUrl =
@@ -390,6 +400,11 @@ function createClient(
 		headers["x-client-request-id"] ??= sessionId;
 	}
 	const baseFetch = fetchOverride ?? fetch;
+	const transformedFetch = wrapFetchForOpenAIRequestTransform(
+		baseFetch,
+		model.requestTransform,
+		`Gajae-Code/${packageJson.version}`,
+	);
 	return {
 		client: new OpenAI({
 			apiKey,
@@ -397,7 +412,9 @@ function createClient(
 			dangerouslyAllowBrowser: true,
 			maxRetries: 5,
 			defaultHeaders: headers,
-			fetch: onSseEvent ? wrapFetchForSseDebug(baseFetch, event => onSseEvent(event, model)) : baseFetch,
+			fetch: onSseEvent
+				? wrapFetchForSseDebug(transformedFetch, event => onSseEvent(event, model))
+				: transformedFetch,
 		}),
 		copilotPremiumRequests,
 		baseUrl,
@@ -453,7 +470,7 @@ function buildParams(
 	const cacheRetention = resolveCacheRetention(options?.cacheRetention);
 	const promptCacheKey = getOpenAIResponsesCacheSessionId(options);
 	const params: OpenAIResponsesSamplingParams = {
-		model: model.id,
+		model: model.wireModelId ?? model.id,
 		input: messages,
 		instructions: systemInstructions,
 		stream: true,
@@ -490,6 +507,7 @@ function buildParams(
 	applyResponsesReasoningParams(params, model, options, messages, effort =>
 		mapReasoningEffort(effort as NonNullable<OpenAIResponsesOptions["reasoning"]>, model.compat?.reasoningEffortMap),
 	);
+	applyOpenAIRequestTransformBody(params, model.requestTransform);
 
 	return { conversationMessages, params };
 }

package/src/types.ts

@@ -823,6 +823,18 @@ export interface VercelGatewayRouting {
 }
 
 // Model interface for the unified model system
+
+export interface ModelRequestTransform {
+	/** Named request-shaping preset. `openai-proxy` removes OpenAI SDK telemetry headers and uses a generic Gajae-Code User-Agent. */
+	profile?: "openai-proxy";
+	/** Header names to remove from the final outbound request. Case-insensitive. */
+	stripHeaders?: string[];
+	/** Headers to set after stripping; use null to remove a header explicitly. */
+	setHeaders?: Record<string, string | null>;
+	/** Extra request body fields merged after provider defaults; protected core request keys are ignored. */
+	extraBody?: Record<string, unknown>;
+}
+
 export interface Model<TApi extends Api = any> {
 	id: string;
 	name: string;
@@ -861,6 +873,10 @@ export interface Model<TApi extends Api = any> {
 	preferWebsockets?: boolean;
 	/** Preferred model to switch to when context promotion is triggered (model id or provider/id). */
 	contextPromotionTarget?: string;
+	/** Provider-facing model id when it differs from the local selector id. */
+	wireModelId?: string;
+	/** Declarative request shaping for OpenAI-compatible proxy providers. */
+	requestTransform?: ModelRequestTransform;
 	/** Provider-assigned priority value (lower = higher priority). */
 	priority?: number;
 	/** Canonical thinking capability metadata for this model. */