@gajae-code/ai 0.1.1

package/src/providers/openai-codex/request-transformer.ts

@@ -0,0 +1,161 @@
+import type { Effort } from "../../model-thinking";
+import { requireSupportedEffort } from "../../model-thinking";
+import type { Api, Model } from "../../types";
+
+export interface ReasoningConfig {
+	effort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+	summary?: "auto" | "concise" | "detailed";
+}
+
+export interface CodexRequestOptions {
+	reasoningEffort?: ReasoningConfig["effort"];
+	reasoningSummary?: ReasoningConfig["summary"] | null;
+	textVerbosity?: "low" | "medium" | "high";
+	include?: string[];
+}
+
+export interface InputItem {
+	id?: string | null;
+	type?: string | null;
+	role?: string;
+	content?: unknown;
+	call_id?: string | null;
+	name?: string;
+	output?: unknown;
+	arguments?: unknown;
+}
+
+export interface RequestBody {
+	model: string;
+	store?: boolean;
+	stream?: boolean;
+	instructions?: string;
+	input?: InputItem[];
+	tools?: unknown;
+	tool_choice?: unknown;
+	temperature?: number;
+	top_p?: number;
+	top_k?: number;
+	min_p?: number;
+	presence_penalty?: number;
+	repetition_penalty?: number;
+	reasoning?: Partial<ReasoningConfig>;
+	text?: {
+		verbosity?: "low" | "medium" | "high";
+	};
+	include?: string[];
+	prompt_cache_key?: string;
+	prompt_cache_retention?: "in_memory" | "24h";
+	max_output_tokens?: number;
+	max_completion_tokens?: number;
+	[key: string]: unknown;
+}
+
+function getReasoningConfig(model: Model<Api>, options: CodexRequestOptions): ReasoningConfig {
+	const config: ReasoningConfig = {
+		effort:
+			options.reasoningEffort === "none" ? "none" : requireSupportedEffort(model, options.reasoningEffort as Effort),
+	};
+	if (options.reasoningSummary !== null) {
+		config.summary = options.reasoningSummary ?? "detailed";
+	}
+	return config;
+}
+
+function filterInput(input: InputItem[] | undefined): InputItem[] | undefined {
+	if (!Array.isArray(input)) return input;
+
+	return input
+		.filter(item => item.type !== "item_reference")
+		.map(item => {
+			if (item.id != null) {
+				const { id: _id, ...rest } = item;
+				return rest as InputItem;
+			}
+			return item;
+		});
+}
+
+export async function transformRequestBody(
+	body: RequestBody,
+	model: Model<Api>,
+	options: CodexRequestOptions = {},
+	prompt?: { developerMessages: string[] },
+): Promise<RequestBody> {
+	body.store = false;
+	body.stream = true;
+
+	if (body.input && Array.isArray(body.input)) {
+		body.input = filterInput(body.input);
+
+		if (body.input) {
+			const functionCallIds = new Set(
+				body.input
+					.filter(item => item.type === "function_call" && typeof item.call_id === "string")
+					.map(item => item.call_id as string),
+			);
+
+			body.input = body.input.map(item => {
+				if (item.type === "function_call_output" && typeof item.call_id === "string") {
+					const callId = item.call_id as string;
+					if (!functionCallIds.has(callId)) {
+						const itemRecord = item as unknown as Record<string, unknown>;
+						const toolName = typeof itemRecord.name === "string" ? itemRecord.name : "tool";
+						let text = "";
+						try {
+							const output = itemRecord.output;
+							text = typeof output === "string" ? output : JSON.stringify(output);
+						} catch {
+							text = String(itemRecord.output ?? "");
+						}
+						if (text.length > 16000) {
+							text = `${text.slice(0, 16000)}\n...[truncated]`;
+						}
+						return {
+							type: "message",
+							role: "assistant",
+							content: `[Previous ${toolName} result; call_id=${callId}]: ${text}`,
+						} as InputItem;
+					}
+				}
+				return item;
+			});
+		}
+	}
+
+	if (prompt?.developerMessages && prompt.developerMessages.length > 0 && Array.isArray(body.input)) {
+		const developerMessages = prompt.developerMessages.map(
+			text =>
+				({
+					type: "message",
+					role: "developer",
+					content: [{ type: "input_text", text }],
+				}) as InputItem,
+		);
+		body.input = [...developerMessages, ...body.input];
+	}
+
+	if (options.reasoningEffort !== undefined) {
+		const reasoningConfig = getReasoningConfig(model, options);
+		body.reasoning = {
+			...body.reasoning,
+			...reasoningConfig,
+		};
+	} else {
+		delete body.reasoning;
+	}
+
+	body.text = {
+		...body.text,
+		verbosity: options.textVerbosity || "low",
+	};
+
+	const include = Array.isArray(options.include) ? [...options.include] : [];
+	include.push("reasoning.encrypted_content");
+	body.include = Array.from(new Set(include));
+
+	delete body.max_output_tokens;
+	delete body.max_completion_tokens;
+
+	return body;
+}

package/src/providers/openai-codex/response-handler.ts

@@ -0,0 +1,81 @@
+import { toNumber } from "../../utils";
+
+export type CodexRateLimit = {
+	used_percent?: number;
+	window_minutes?: number;
+	resets_at?: number;
+};
+
+export type CodexRateLimits = {
+	primary?: CodexRateLimit;
+	secondary?: CodexRateLimit;
+};
+
+export type CodexErrorInfo = {
+	message: string;
+	status: number;
+	friendlyMessage?: string;
+	rateLimits?: CodexRateLimits;
+	raw?: string;
+};
+
+export async function parseCodexError(response: Response): Promise<CodexErrorInfo> {
+	const raw = await response.text();
+	let message = raw || response.statusText || "Request failed";
+	let friendlyMessage: string | undefined;
+	let rateLimits: CodexRateLimits | undefined;
+
+	try {
+		const parsed = JSON.parse(raw) as { error?: Record<string, unknown> };
+		const err = parsed?.error ?? {};
+
+		const headers = response.headers;
+		const primary = {
+			used_percent: toNumber(headers.get("x-codex-primary-used-percent")),
+			window_minutes: toInt(headers.get("x-codex-primary-window-minutes")),
+			resets_at: toInt(headers.get("x-codex-primary-reset-at")),
+		};
+		const secondary = {
+			used_percent: toNumber(headers.get("x-codex-secondary-used-percent")),
+			window_minutes: toInt(headers.get("x-codex-secondary-window-minutes")),
+			resets_at: toInt(headers.get("x-codex-secondary-reset-at")),
+		};
+		rateLimits =
+			primary.used_percent !== undefined || secondary.used_percent !== undefined
+				? { primary, secondary }
+				: undefined;
+
+		const code = String((err as { code?: string; type?: string }).code ?? (err as { type?: string }).type ?? "");
+		const resetsAt = (err as { resets_at?: number }).resets_at ?? primary.resets_at ?? secondary.resets_at;
+		const mins = resetsAt ? Math.max(0, Math.round((resetsAt * 1000 - Date.now()) / 60000)) : undefined;
+
+		if (/usage_limit_reached|usage_not_included/i.test(code)) {
+			const planType = (err as { plan_type?: string }).plan_type;
+			const plan = planType ? ` (${String(planType).toLowerCase()} plan)` : "";
+			const when = mins !== undefined ? ` Try again in ~${mins} min.` : "";
+			friendlyMessage = `You have hit your ChatGPT usage limit${plan}.${when}`.trim();
+		} else if (/rate_limit_exceeded/i.test(code) || response.status === 429) {
+			const when = mins !== undefined ? ` Try again in ~${mins} min.` : "";
+			friendlyMessage = `ChatGPT rate limit exceeded.${when}`.trim();
+		}
+
+		const errMessage = (err as { message?: string }).message;
+		message = errMessage || friendlyMessage || message;
+	} catch {
+		// raw body not JSON
+	}
+
+	return {
+		message,
+		status: response.status,
+		friendlyMessage,
+		rateLimits,
+		raw: raw,
+	};
+}
+
+function toInt(v: string | null): number | undefined {
+	if (v == null) return undefined;
+	const n = parseInt(v, 10);
+	return Number.isFinite(n) ? n : undefined;
+}