/** * Kiro-specific constants and helpers. * * Mirrors the behaviour of `internal/translator/kiro/common/constants.go` and * `internal/translator/kiro/claude/kiro_claude_request.go` from the * CLIProxyAPIPlus reference implementation, scoped down to what 9router needs: * * - `-agentic` model suffix detection + chunked-write system prompt * - reasoning / thinking trigger detection (Anthropic-Beta header, * Claude `thinking`, OpenAI `reasoning_effort`, AMP/Cursor magic tag) * - the `enabled` system-prompt injection * that turns Kiro reasoning on * * Kiro upstream does not advertise `-agentic` model IDs; they are a 9router * fiction. The suffix is stripped before the request leaves this process. */ import { extractThinking } from "../translator/concerns/thinkingUnified.js"; import { effortToBudget } from "../translator/concerns/thinking.js"; export const KIRO_AGENTIC_SUFFIX = "-agentic"; export const KIRO_THINKING_SUFFIX = "-thinking"; // Public default CodeWhisperer profile ARNs (us-east-1), keyed by auth method. // Used when an account cannot resolve its own profileArn. Builder ID and social // (Google/GitHub) sign-ins map to different shared profiles. export const KIRO_DEFAULT_PROFILE_ARNS = { "builder-id": "arn:aws:codewhisperer:us-east-1:638616132270:profile/AAAACCCCXXXX", social: "arn:aws:codewhisperer:us-east-1:699475941385:profile/EHGA3GRVQMUK", }; // Back-compat single default (Builder ID). export const KIRO_DEFAULT_PROFILE_ARN = KIRO_DEFAULT_PROFILE_ARNS["builder-id"]; /** Resolve the shared default profileArn for a given auth method. */ export function resolveDefaultProfileArn(authMethod) { const social = authMethod === "google" || authMethod === "github"; return social ? KIRO_DEFAULT_PROFILE_ARNS.social : KIRO_DEFAULT_PROFILE_ARNS["builder-id"]; } export const KIRO_THINKING_BUDGET_DEFAULT = 16000; export const KIRO_AGENTIC_SYSTEM_PROMPT = ` # CRITICAL: CHUNKED WRITE PROTOCOL (MANDATORY) You MUST follow these rules for ALL file operations. Violation causes server timeouts and task failure. ## ABSOLUTE LIMITS - **MAXIMUM 350 LINES** per single write/edit operation - NO EXCEPTIONS - **RECOMMENDED 300 LINES** or less for optimal performance - **NEVER** write entire files in one operation if >300 lines ## MANDATORY CHUNKED WRITE STRATEGY ### For NEW FILES (>300 lines total): 1. FIRST: Write initial chunk (first 250-300 lines) using write_to_file/fsWrite 2. THEN: Append remaining content in 250-300 line chunks using file append operations 3. REPEAT: Continue appending until complete ### For EDITING EXISTING FILES: 1. Use surgical edits (apply_diff/targeted edits) - change ONLY what's needed 2. NEVER rewrite entire files - use incremental modifications 3. Split large refactors into multiple small, focused edits ### For LARGE CODE GENERATION: 1. Generate in logical sections (imports, types, functions separately) 2. Write each section as a separate operation 3. Use append operations for subsequent sections ## EXAMPLES OF CORRECT BEHAVIOR CORRECT: Writing a 600-line file - Operation 1: Write lines 1-300 (initial file creation) - Operation 2: Append lines 301-600 CORRECT: Editing multiple functions - Operation 1: Edit function A - Operation 2: Edit function B - Operation 3: Edit function C WRONG: Writing 500 lines in single operation -> TIMEOUT WRONG: Rewriting entire file to change 5 lines -> TIMEOUT WRONG: Generating massive code blocks without chunking -> TIMEOUT ## WHY THIS MATTERS - Server has 2-3 minute timeout for operations - Large writes exceed timeout and FAIL completely - Chunked writes are FASTER and more RELIABLE - Failed writes waste time and require retry REMEMBER: When in doubt, write LESS per operation. Multiple small operations > one large operation. `.trim(); /** * Resolve the Kiro thinking budget requested by a client. * * Reuses the shared thinkingUnified parser (extractThinking) so every client * shape (Claude output_config.effort / thinking.budget_tokens, OpenAI * reasoning_effort / reasoning.effort, Gemini, Qwen) maps consistently. Explicit * `none`/`off`/disabled wins and returns null (no prefix injected). * buildThinkingSystemPrefix performs Kiro's final 1..32000 clamp. * * @param {object} body OpenAI/Claude-shaped request body * @param {object} [headers] Original inbound HTTP headers (case-insensitive) * @param {string} [model] Model id the caller asked for * @returns {number|null} budget to inject, or null when thinking is disabled */ export function resolveKiroThinkingBudget(body, headers, model) { const cfg = extractThinking(body); if (cfg) { if (cfg.mode === "none") return null; if (cfg.mode === "budget") return cfg.budget; if (cfg.mode === "level") return effortToBudget(cfg.level) ?? KIRO_THINKING_BUDGET_DEFAULT; return KIRO_THINKING_BUDGET_DEFAULT; } if (headers) { const beta = pickHeader(headers, "anthropic-beta"); if (typeof beta === "string" && beta.toLowerCase().includes("interleaved-thinking")) { return KIRO_THINKING_BUDGET_DEFAULT; } } if (containsThinkingModeTag(body)) return KIRO_THINKING_BUDGET_DEFAULT; if (typeof model === "string" && model) { const m = model.toLowerCase(); if (m.includes("thinking") || m.includes("-reason")) return KIRO_THINKING_BUDGET_DEFAULT; } return null; } /** * Detect whether an inbound request is asking for reasoning / thinking output. * Thin wrapper over resolveKiroThinkingBudget (single source of truth). * * @param {object} body OpenAI-shaped request body (post-translation) * @param {object} [headers] Original inbound HTTP headers (case-insensitive) * @param {string} [model] Model id the caller asked for (post-strip ok) * @returns {boolean} */ export function isThinkingEnabled(body, headers, model) { return resolveKiroThinkingBudget(body, headers, model) !== null; } /** * Detect whether a model id refers to a 9router synthetic agentic variant. * Agentic variants share the same upstream model as the base; the only * difference is the chunked-write system prompt this module injects. * * @param {string} model * @returns {boolean} */ export function isAgenticModel(model) { return typeof model === "string" && model.endsWith(KIRO_AGENTIC_SUFFIX); } /** * Strip the `-agentic` suffix from a model id, leaving the upstream-real id. * * @param {string} model * @returns {string} */ export function stripAgenticSuffix(model) { if (!isAgenticModel(model)) return model; return model.slice(0, -KIRO_AGENTIC_SUFFIX.length); } /** * Detect whether a model id is a 9router synthetic thinking variant * (e.g. `claude-sonnet-4.5-thinking`). Same upstream model as the base; the * only difference is `enabled` injection. * * Note: real Kiro thinking-capable variants exist (e.g. `kimi-k2-thinking` in * other providers), but for the `kr/` namespace there is no `-thinking` * model on Kiro upstream. Treat the suffix as a synthetic alias. * * @param {string} model Model id with `-agentic` already stripped * @returns {boolean} */ export function isThinkingModel(model) { return typeof model === "string" && model.endsWith(KIRO_THINKING_SUFFIX); } /** * Strip the `-thinking` suffix from a model id. * * @param {string} model * @returns {string} */ export function stripThinkingSuffix(model) { if (!isThinkingModel(model)) return model; return model.slice(0, -KIRO_THINKING_SUFFIX.length); } /** * Resolve a 9router model id to the real upstream Kiro model id, plus flags * describing which behaviours the suffixes implied. * * resolveKiroModel("claude-sonnet-4.5-thinking-agentic") * => { upstream: "claude-sonnet-4.5", agentic: true, thinking: true } * resolveKiroModel("claude-sonnet-4.5-thinking") * => { upstream: "claude-sonnet-4.5", agentic: false, thinking: true } * resolveKiroModel("claude-sonnet-4.5-agentic") * => { upstream: "claude-sonnet-4.5", agentic: true, thinking: false } * resolveKiroModel("claude-sonnet-4.5") * => { upstream: "claude-sonnet-4.5", agentic: false, thinking: false } * * @param {string} model * @returns {{ upstream: string, agentic: boolean, thinking: boolean }} */ export function resolveKiroModel(model) { let upstream = model; let agentic = false; let thinking = false; if (isAgenticModel(upstream)) { agentic = true; upstream = stripAgenticSuffix(upstream); } if (isThinkingModel(upstream)) { thinking = true; upstream = stripThinkingSuffix(upstream); } return { upstream, agentic, thinking }; } /** * Build the magic system-prompt prefix that turns Kiro reasoning on. * Same shape as CLIProxyAPIPlus. * * @param {number} [budget=KIRO_THINKING_BUDGET_DEFAULT] */ export function buildThinkingSystemPrefix(budget = KIRO_THINKING_BUDGET_DEFAULT) { const safeBudget = Math.max(1, Math.min(32000, Number(budget) || KIRO_THINKING_BUDGET_DEFAULT)); return `enabled\n${safeBudget}`; } function pickHeader(headers, name) { if (!headers) return undefined; if (typeof headers.get === "function") { return headers.get(name); } const lower = name.toLowerCase(); for (const key of Object.keys(headers)) { if (key.toLowerCase() === lower) { return headers[key]; } } return undefined; } function containsThinkingModeTag(body) { const messages = Array.isArray(body?.messages) ? body.messages : []; for (const msg of messages) { if (!msg) continue; if (msg.role !== "system" && msg.role !== "user") continue; const content = msg.content; if (typeof content === "string") { if (containsTagInText(content)) return true; } else if (Array.isArray(content)) { for (const part of content) { const text = part?.text; if (typeof text === "string" && containsTagInText(text)) return true; } } } if (typeof body?.system === "string" && containsTagInText(body.system)) return true; return false; } function containsTagInText(text) { if (!text) return false; if (!text.includes("")) return false; return text.includes("enabled") || text.includes("interleaved"); }