@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
76 lines (70 loc) • 3.73 kB
text/typescript
import { namespacedToolName, requiresToolCall, toolChoiceToolPredicate, type OcxParsedRequest } from "../../types";
import { stripResponsesOnlyEncryptedMarker } from "../responses-tool-schema";
// The selected catalog also supplies one comma-joined --allowed-tools argv value.
// Bound that full argument separately from individual names for Windows process creation.
export const CODING_AGENT_TOOL_LIMITS = Object.freeze({
maxTools: 128,
maxNameBytes: 512,
maxAllowedToolsArgBytes: 8 * 1024,
maxToolBytes: 256 * 1024,
maxCatalogBytes: 2 * 1024 * 1024,
});
const encoder = new TextEncoder();
const INVALID_NAME_PART = /[,\s\u0000-\u001f\u007f-\u009f]/u;
export class CodingAgentToolCatalogError extends Error {
constructor(message: string) {
super(message);
this.name = "CodingAgentToolCatalogError";
}
}
export function isValidCodingAgentToolNamePart(value: unknown): value is string {
if (typeof value !== "string" || !value || INVALID_NAME_PART.test(value)) return false;
// TextEncoder replaces lone surrogates, which would change tool identity on the MCP wire.
for (let i = 0; i < value.length; i++) {
const unit = value.charCodeAt(i);
if (unit >= 0xd800 && unit <= 0xdbff) {
const next = value.charCodeAt(++i);
if (!(next >= 0xdc00 && next <= 0xdfff)) return false;
} else if (unit >= 0xdc00 && unit <= 0xdfff) {
return false;
}
}
return true;
}
/** One client-owned catalog; the CLI spelling is only a projection of its wire names. */
export function buildCodingAgentToolCatalog(parsed: OcxParsedRequest, serverName: string) {
const declared = parsed.context.tools ?? [];
const selected = declared.filter(toolChoiceToolPredicate(parsed.options.toolChoice, declared));
if (selected.length > CODING_AGENT_TOOL_LIMITS.maxTools) throw new CodingAgentToolCatalogError("tool catalog exceeds tool count limit");
const requireToolCall = requiresToolCall(parsed.options.toolChoice);
const emittedNameMap = new Map<string, string>();
// JSON array brackets and commas count too; avoid serializing the whole catalog twice.
let catalogBytes = 2;
let allowedToolsArgBytes = 0;
const tools = selected.map((tool, index) => {
if (!tool || !isValidCodingAgentToolNamePart(tool.name) || (tool.namespace !== undefined && !isValidCodingAgentToolNamePart(tool.namespace))) {
throw new CodingAgentToolCatalogError("invalid tool name or namespace");
}
const wireName = namespacedToolName(tool.namespace, tool.name);
if (encoder.encode(wireName).byteLength > CODING_AGENT_TOOL_LIMITS.maxNameBytes) {
throw new CodingAgentToolCatalogError("tool name exceeds byte limit");
}
const definition = {
name: wireName,
description: tool.description || `Tool: ${wireName}`,
inputSchema: stripResponsesOnlyEncryptedMarker(tool.parameters) as Record<string, unknown>,
};
const bytes = encoder.encode(JSON.stringify(definition)).byteLength;
if (bytes > CODING_AGENT_TOOL_LIMITS.maxToolBytes) throw new CodingAgentToolCatalogError("tool definition exceeds byte limit");
catalogBytes += bytes + (index ? 1 : 0);
if (catalogBytes > CODING_AGENT_TOOL_LIMITS.maxCatalogBytes) throw new CodingAgentToolCatalogError("tool catalog exceeds byte limit");
const emittedName = `mcp__${serverName}__${wireName}`;
allowedToolsArgBytes += encoder.encode(emittedName).byteLength + (index ? 1 : 0);
if (allowedToolsArgBytes > CODING_AGENT_TOOL_LIMITS.maxAllowedToolsArgBytes) {
throw new CodingAgentToolCatalogError("allowed-tools argument exceeds byte limit");
}
emittedNameMap.set(emittedName, wireName);
return definition;
});
return { tools, emittedNameMap, requireToolCall };
}