UNPKG

@bitkyc08/opencodex

Version:

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

65 lines (61 loc) • 3.17 kB
import type { ProviderAdapter } from "../base"; import { requiresToolCall, type AdapterEvent, type OcxParsedRequest } from "../../types"; import { releaseTranslatedEvent, retainTranslatedEvent, type TranslatorBudget } from "../../lib/translator-budget"; import type { AdapterTierMetadata } from "../../providers/fastwire"; import { isTruncatedStopReason } from "../../responses/truncated-stop-reason"; function requiresClientCall(parsed: OcxParsedRequest): boolean { if (!requiresToolCall(parsed.options.toolChoice)) return false; // Sidecars own their own tool lifecycle; this boundary validates client-executed calls only. return !(parsed.context.tools ?? []).some(t => t.webSearch || t.imageGeneration || t.videoGeneration || t.advisor); } function terminalGuard(required: boolean): (event: AdapterEvent) => AdapterEvent { // The shared response bridge owns tool-choice authorization and alias restoration. // Count a completed call here without introducing a second, narrower name resolver. let pending = false; let fulfilled = false; let failed = false; return event => { if (event.type === "tool_call_start") pending = true; if (event.type === "tool_call_end") { fulfilled ||= pending && !event.incomplete; pending = false; } if (event.type === "error" || event.type === "incomplete") failed = true; if (event.type !== "done" || !required || fulfilled || failed || isTruncatedStopReason(event.stopReason)) return event; // Preserve delivered output and consumption. A mandatory call is a contract, not a hint // that permits replaying an already-visible turn or silently reporting text as success. return { type: "error", status: 502, errorType: "upstream_error", code: "required_tool_not_called", message: "The upstream response completed without the required client tool call.", retryable: false, usage: event.usage, }; }; } /** Keep the same per-request lifetime as the Chat adapter's tool-name registry. */ export function withRequiredChatToolResult(adapter: ProviderAdapter): ProviderAdapter { let required = false; return { ...adapter, buildRequest(parsed, incoming) { required = requiresClientCall(parsed); return adapter.buildRequest(parsed, incoming); }, async *parseStream(response, budget, tierMetadata, streamContext) { const guard = terminalGuard(required); for await (const event of adapter.parseStream(response, budget, tierMetadata, streamContext)) yield guard(event); }, ...(adapter.parseResponse ? { async parseResponse(response: Response, budget: TranslatorBudget, tierMetadata?: AdapterTierMetadata) { const events = await adapter.parseResponse!(response, budget, tierMetadata); const guard = terminalGuard(required); for (let i = 0; i < events.length; i++) { const original = events[i]!; const guarded = guard(original); if (guarded !== original) { releaseTranslatedEvent(original, budget); retainTranslatedEvent(guarded, budget); events[i] = guarded; } } return events; }, } : {}), }; }