import { BaseExecutor, ExecuteInput, type ProviderCredentials } from "./base.ts"; import { PROVIDERS, OAUTH_ENDPOINTS } from "../config/constants.ts"; import { getModelTargetFormat } from "../config/providerModels.ts"; import { getGitHubCopilotChatHeaders, getGitHubCopilotRefreshHeaders, } from "../config/providerHeaderProfiles.ts"; import { sanitizeResponsesInputItems } from "../services/responsesInputSanitizer.ts"; import { stripUnsupportedParams } from "../translator/paramSupport.ts"; export class GithubExecutor extends BaseExecutor { constructor() { super("github", PROVIDERS.github); } getCopilotToken(credentials: Record | null | undefined) { return credentials?.copilotToken || credentials?.providerSpecificData?.copilotToken || null; } getCopilotTokenExpiresAt(credentials: Record | null | undefined) { return ( credentials?.copilotTokenExpiresAt || credentials?.providerSpecificData?.copilotTokenExpiresAt || null ); } // GitHub Copilot's /responses endpoint only serves OpenAI (gpt/codex) models. // Gemini and Claude variants on Copilot reject with HTTP 400 // "model does not support Responses API." (unsupported_api_for_model) // Pin a defensive invariant: even if a future registry edit (or an upstream // model-discovery refresh) tagged a Claude/Gemini entry as openai-responses, // the executor must still route it to /chat/completions. Port of 9router#1536 // (follow-up to #663); also reinforces the existing comments on the gh // registry entries (claude-opus-4-5-20251101, claude-opus-4.7, gemini-*). supportsResponsesEndpoint(model: string | null | undefined): boolean { const m = (model || "").toLowerCase(); if (!m) return true; return !(m.includes("gemini") || m.includes("claude")); } buildUrl(model: string, _stream: boolean, _urlIndex = 0) { const targetFormat = getModelTargetFormat("gh", model); // 9router#102: Copilot Codex models advertise supported_endpoints: ["/responses"] // and 400 on /chat/completions. Route any *-codex id to /responses even when it // isn't in the curated registry, so newly-shipped Codex models work out of the box. // 9router#1536: but never route Gemini/Claude variants to /responses (they 400) — // gate the whole decision on supportsResponsesEndpoint(). if ( (targetFormat === "openai-responses" || /codex/i.test(model)) && this.supportsResponsesEndpoint(model) ) { return ( this.config.responsesBaseUrl || this.config.baseUrl?.replace(/\/chat\/completions\/?$/, "/responses") || "https://api.githubcopilot.com/responses" ); } return this.config.baseUrl; } injectResponseFormat(messages: Array>, responseFormat: any) { if (!responseFormat) return messages; let formatInstruction = ""; if (responseFormat.type === "json_object") { formatInstruction = "Respond only with valid JSON. Do not include any text before or after the JSON object."; } else if (responseFormat.type === "json_schema" && responseFormat.json_schema) { formatInstruction = `Respond only with valid JSON matching this schema:\n${JSON.stringify( responseFormat.json_schema.schema, null, 2 )}\nDo not include any text before or after the JSON.`; } if (!formatInstruction) return messages; const systemIdx = messages.findIndex((m) => m.role === "system"); if (systemIdx >= 0) { return messages.map((m, i: number) => i === systemIdx ? { ...m, content: `${m.content}\n\n${formatInstruction}` } : m ); } return [{ role: "system", content: formatInstruction }, ...messages]; } transformRequest(model: string, body: any, stream: boolean, credentials: any): any { void stream; void credentials; const sourceBody = body && typeof body === "object" ? body : {}; const modifiedBody = { ...sourceBody }; if (Array.isArray(sourceBody.input)) { modifiedBody.input = sanitizeResponsesInputItems(sourceBody.input, false); } if (Array.isArray(sourceBody.messages)) { modifiedBody.messages = sourceBody.messages.map((msg) => { if (!msg || typeof msg !== "object") return msg; const role = typeof msg.role === "string" ? msg.role.toLowerCase() : ""; if (role !== "assistant") return msg; if (msg.reasoning_text === undefined && msg.reasoning_content === undefined) return msg; const next = { ...msg }; delete next.reasoning_text; delete next.reasoning_content; return next; }); } if (modifiedBody.response_format && model.toLowerCase().includes("claude")) { modifiedBody.messages = this.injectResponseFormat( Array.isArray(modifiedBody.messages) ? modifiedBody.messages : [], modifiedBody.response_format ); delete modifiedBody.response_format; } if (Array.isArray(modifiedBody.tools) && modifiedBody.tools.length > 128) { modifiedBody.tools = modifiedBody.tools.slice(0, 128); } // GitHub Copilot's gpt-5.4 family rejects requests carrying `temperature` with HTTP 400: // "Unsupported parameter: 'temperature' is not supported with this model." // OmniRoute's existing `stripGpt5SamplingWhenReasoning` guard only fires for // provider==="openai" (raw api.openai.com Chat Completions), so GitHub Copilot routes // never hit it. Strip temperature here unconditionally for gpt-5.4 so the 400 cannot // reach the user. Port from 9router#612 (closes upstream #536). if ( typeof model === "string" && /gpt-5\.4/i.test(model) && modifiedBody.temperature !== undefined ) { delete modifiedBody.temperature; } // GitHub Copilot /chat/completions only accepts {type:'text'} or {type:'image_url'} // content parts. Clients like Cursor IDE pass through Anthropic-shape parts // (tool_use, tool_result, thinking) untouched when using Claude models, which makes // the endpoint return: "type has to be either 'image_url' or 'text'" (HTTP 400). // Serialize unknown part types as text, drop empty parts, and collapse to null when // every part is stripped (assistant messages whose only content was tool_calls). // Port from 9router#220 (fixes 9router#219). if (Array.isArray(modifiedBody.messages)) { modifiedBody.messages = modifiedBody.messages.map((msg: any) => this.sanitizeChatCompletionsMessage(msg) ); } // GitHub Copilot's /chat/completions endpoint rejects a conversation that ends // with an assistant message: "This model does not support assistant message // prefill. The conversation must end with a user message." (HTTP 400). Anthropic // clients such as newest Claude Desktop send a trailing assistant turn as a // prefill seed — the Anthropic API honors it, but Copilot does not. Drop it here, // scoped to the GitHub executor only (the shared translator/contextManager and // other providers that DO honor prefill are untouched). // Port of 9router#2143 (author: Manuel ). if (Array.isArray(modifiedBody.messages)) { modifiedBody.messages = this.dropTrailingAssistantPrefill(modifiedBody.messages); } // Config-driven strip of params unsupported by the target provider/model. // For GitHub Copilot this removes Claude-style `thinking` and // `reasoning_effort` for Claude models that reject them upstream // (Haiku 4.5 / Opus 4.7 — Opus 4.6 / Sonnet 4.6 keep them). // Port from 9router#7ae9fff6 (fixes upstream #1748, #713). stripUnsupportedParams("github", model, modifiedBody); return modifiedBody; } private sanitizeChatCompletionsMessage(msg: any): any { if (!msg || typeof msg !== "object") return msg; // String content and missing content (e.g. assistant w/ only tool_calls) pass through. if (typeof msg.content === "string" || msg.content == null) return msg; if (!Array.isArray(msg.content)) return msg; const cleanContent = msg.content .map((part: any) => { if (!part || typeof part !== "object") return part; if (part.type === "text") return part; if (part.type === "image_url") return part; // Serialize any unsupported part (tool_use, tool_result, thinking, etc.) as text. // Try common text-carrying fields first; fall back to a JSON dump so nothing is // silently dropped from the model's context. const raw = (typeof part.text === "string" && part.text) || (typeof part.thinking === "string" && part.thinking) || (typeof part.content === "string" && part.content) || (part.content != null && JSON.stringify(part.content)) || JSON.stringify(part); return { type: "text", text: typeof raw === "string" ? raw : JSON.stringify(raw) }; }) .filter((part: any) => !(part && part.type === "text" && part.text === "")); // If every part stripped to empty (e.g. tool_use with no text), collapse to null so // GitHub does not reject an empty-array body. tool_calls ride alongside content. return { ...msg, content: cleanContent.length > 0 ? cleanContent : null }; } // Remove trailing assistant message(s). GitHub Copilot's /chat/completions endpoint // can't honor an assistant prefill and 400s unless the conversation ends with a // non-assistant (user/tool) message. Never empties the array — an assistant-only // conversation keeps its last message. No-op (same array reference) when the // conversation already ends with a non-assistant message. // Port of 9router#2143 (author: Manuel ). dropTrailingAssistantPrefill(messages: any): any { if (!Array.isArray(messages) || messages.length === 0) return messages; let end = messages.length; while (end > 1 && messages[end - 1]?.role === "assistant") end--; return end === messages.length ? messages : messages.slice(0, end); } async execute(input: ExecuteInput) { const result = await super.execute(input); if (!result || !result.response) return result; if (!input.stream) { // wreq-js clone/text semantics consume the original response body. Materialize // non-streaming responses immediately so downstream code always sees a native // fetch Response with a readable body. const status = result.response.status; const statusText = result.response.statusText; const headers = new Headers(result.response.headers); const payload = await result.response.text(); result.response = new Response(payload, { status, statusText, headers }); return result; } return result; } buildHeaders( credentials: ProviderCredentials, stream = true, clientHeaders?: Record | null ): Record { const token = this.getCopilotToken(credentials) || credentials.accessToken; // Forward the client's x-initiator header when present. OpenCode and other // Copilot-aware clients use this to distinguish user-initiated turns // (x-initiator: user) from autonomous tool-call continuations // (x-initiator: agent). GitHub Copilot's billing treats "agent" turns as // free, so forwarding the value avoids burning a premium request on every // tool-call round-trip. Fall back to "user" when the header is absent to // preserve the existing default behaviour. let clientInitiator = clientHeaders?.["x-initiator"] || clientHeaders?.["X-Initiator"]; if (!clientInitiator && clientHeaders) { for (const key in clientHeaders) { if (key.toLowerCase() === "x-initiator") { clientInitiator = clientHeaders[key]; break; } } } const initiator = clientInitiator === "agent" || clientInitiator === "user" ? clientInitiator : "user"; return { ...getGitHubCopilotChatHeaders(stream ? "text/event-stream" : "application/json", initiator), Authorization: `Bearer ${token}`, "x-request-id": crypto.randomUUID?.() || `${Date.now()}-${Math.random().toString(36).slice(2)}`, }; } async refreshCopilotToken(githubAccessToken, log) { try { const response = await fetch("https://api.github.com/copilot_internal/v2/token", { headers: getGitHubCopilotRefreshHeaders(`token ${githubAccessToken}`), }); if (!response.ok) return null; const data = await response.json(); log?.info?.("TOKEN", "Copilot token refreshed"); return { token: data.token, expiresAt: data.expires_at }; } catch (error) { log?.error?.("TOKEN", `Copilot refresh error: ${error.message}`); return null; } } async refreshGitHubToken(refreshToken, log) { try { // GitHub Copilot is a public device-flow client: send the public client_id, and // only attach client_secret when one is actually configured — never the literal // "undefined" that new URLSearchParams produces for a missing value (9router#442). const params = new URLSearchParams({ grant_type: "refresh_token", refresh_token: refreshToken, client_id: this.config.clientId, }); if (this.config.clientSecret) { params.set("client_secret", this.config.clientSecret); } const response = await fetch(OAUTH_ENDPOINTS.github.token, { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded", Accept: "application/json", }, body: params, }); if (!response.ok) return null; const tokens = await response.json(); log?.info?.("TOKEN", "GitHub token refreshed"); return { accessToken: tokens.access_token, refreshToken: tokens.refresh_token || refreshToken, expiresIn: tokens.expires_in, }; } catch (error) { log?.error?.("TOKEN", `GitHub refresh error: ${error.message}`); return null; } } async refreshCredentials(credentials, log) { let copilotResult = await this.refreshCopilotToken(credentials.accessToken, log); if (!copilotResult && credentials.refreshToken) { const githubTokens = await this.refreshGitHubToken(credentials.refreshToken, log); if (githubTokens?.accessToken) { copilotResult = await this.refreshCopilotToken(githubTokens.accessToken, log); if (copilotResult) { return { ...githubTokens, copilotToken: copilotResult.token, copilotTokenExpiresAt: copilotResult.expiresAt, providerSpecificData: { copilotToken: copilotResult.token, copilotTokenExpiresAt: copilotResult.expiresAt, }, }; } return githubTokens; } } if (copilotResult) { return { accessToken: credentials.accessToken, refreshToken: credentials.refreshToken, copilotToken: copilotResult.token, copilotTokenExpiresAt: copilotResult.expiresAt, providerSpecificData: { copilotToken: copilotResult.token, copilotTokenExpiresAt: copilotResult.expiresAt, }, }; } return null; } needsRefresh(credentials) { // Always refresh if no copilotToken if (!this.getCopilotToken(credentials)) return true; const copilotTokenExpiresAt = this.getCopilotTokenExpiresAt(credentials); if (copilotTokenExpiresAt) { // Handle both Unix timestamp (seconds) and ISO string let expiresAtMs = copilotTokenExpiresAt; if (typeof expiresAtMs === "number" && expiresAtMs < 1e12) { expiresAtMs = expiresAtMs * 1000; // Convert seconds to ms } else if (typeof expiresAtMs === "string") { expiresAtMs = new Date(expiresAtMs).getTime(); } if (expiresAtMs - Date.now() < 5 * 60 * 1000) return true; } return super.needsRefresh(credentials); } } export default GithubExecutor;