@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
text/typescript
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;
},
} : {}),
};
}