karajan-code 1.59.0 → 2.0.0

package/templates/workflows/{becaria-gateway.yml → kj-ci-gateway.yml}

@@ -1,17 +1,17 @@
-# BecarIA Gateway — publishes PR comments and reviews from repository_dispatch events.
+# Karajan CI Gateway — publishes PR comments and reviews from repository_dispatch events.
 # Triggered by Karajan Code pipeline via `gh api repos/{owner}/{repo}/dispatches`.
 #
 # Required secrets:
-#   BECARIA_APP_ID          — GitHub App ID for becaria-reviewer
-#   BECARIA_APP_PRIVATE_KEY — PEM private key for the GitHub App
+#   KJ_CI_APP_ID      — GitHub App ID for kj-reviewer
+#   KJ_CI_PRIVATE_KEY — PEM private key for the GitHub App
 
-name: BecarIA Gateway
+name: Karajan CI Gateway
 
 on:
   repository_dispatch:
     types:
-      - becaria-comment
-      - becaria-review
+      - kj-comment
+      - kj-review
 
 permissions:
   contents: read
@@ -25,11 +25,11 @@ jobs:
         id: app-token
         uses: actions/create-github-app-token@v1
         with:
-          app-id: ${{ secrets.BECARIA_APP_ID }}
-          private-key: ${{ secrets.BECARIA_APP_PRIVATE_KEY }}
+          app-id: ${{ secrets.KJ_CI_APP_ID }}
+          private-key: ${{ secrets.KJ_CI_PRIVATE_KEY }}
 
       - name: Post Comment
-        if: github.event.action == 'becaria-comment'
+        if: github.event.action == 'kj-comment'
         uses: actions/github-script@v7
         with:
           github-token: ${{ steps.app-token.outputs.token }}
@@ -39,11 +39,11 @@ jobs:
               owner: context.repo.owner,
               repo: context.repo.repo,
               issue_number: pr_number,
-              body: `**${agent}** (via BecarIA)\n\n${body}`
+              body: `**${agent}** (via Karajan CI)\n\n${body}`
             });
 
       - name: Submit Review
-        if: github.event.action == 'becaria-review'
+        if: github.event.action == 'kj-review'
         uses: actions/github-script@v7
         with:
           github-token: ${{ steps.app-token.outputs.token }}
@@ -54,5 +54,5 @@ jobs:
               repo: context.repo.repo,
               pull_number: pr_number,
               event: event,
-              body: `**${agent}** (via BecarIA)\n\n${body}`
+              body: `**${agent}** (via Karajan CI)\n\n${body}`
             });

package/src/proxy/adapters/anthropic.js

@@ -1,131 +0,0 @@
-/**
- * Anthropic message format adapter.
- *
- * Anthropic messages API uses an array of messages where each message has a
- * `content` array. Tool results appear as content blocks with
- * `type: "tool_result"`. Each tool_result block contains an `id` (matching
- * the prior tool_use), optional `tool_use_id`, and nested `content` that
- * can be a string or an array of content blocks (text, image, etc.).
- *
- * @module
- */
-
-/**
- * Extract tool results from Anthropic-format messages.
- *
- * @param {Array<object>} messages - Anthropic messages array
- * @returns {Array<{id: string, toolName: string, text: string, turnIndex: number}>}
- */
-export function extractToolResults(messages) {
-  const results = [];
-
-  for (let i = 0; i < messages.length; i++) {
-    const msg = messages[i];
-    if (!msg || !Array.isArray(msg.content)) continue;
-
-    // Collect tool_use names from assistant messages so we can map ids to names
-    const toolNameMap = buildToolNameMap(messages, i);
-
-    for (const block of msg.content) {
-      if (block.type !== "tool_result") continue;
-
-      const id = block.tool_use_id || block.id || "";
-      const text = extractText(block);
-      const toolName = toolNameMap.get(id) || "unknown";
-
-      results.push({ id, toolName, text, turnIndex: i });
-    }
-  }
-
-  return results;
-}
-
-/**
- * Rebuild messages replacing tool_result text with compressed versions.
- *
- * @param {Array<object>} messages - Original Anthropic messages array
- * @param {Map<string, string>|Record<string, string>} compressedMap - id → compressed text
- * @returns {Array<object>} Deep-cloned messages with replacements applied
- */
-export function rebuildMessages(messages, compressedMap) {
-  const map = compressedMap instanceof Map ? compressedMap : new Map(Object.entries(compressedMap));
-  return messages.map((msg) => {
-    if (!msg || !Array.isArray(msg.content)) return msg;
-
-    const newContent = msg.content.map((block) => {
-      if (block.type !== "tool_result") return block;
-
-      const id = block.tool_use_id || block.id || "";
-      if (!map.has(id)) return block;
-
-      const compressed = map.get(id);
-      return replaceText(block, compressed);
-    });
-
-    return { ...msg, content: newContent };
-  });
-}
-
-// ── helpers ──────────────────────────────────────────────────────────
-
-/**
- * Build a map of tool_use id → tool name by scanning assistant messages
- * that precede or are at the given turn index.
- */
-function buildToolNameMap(messages, upToIndex) {
-  const map = new Map();
-  for (let i = 0; i <= upToIndex; i++) {
-    const msg = messages[i];
-    if (!msg || msg.role !== "assistant" || !Array.isArray(msg.content)) continue;
-    for (const block of msg.content) {
-      if (block.type === "tool_use" && block.id) {
-        map.set(block.id, block.name || "unknown");
-      }
-    }
-  }
-  return map;
-}
-
-/**
- * Extract plain text from a tool_result block.
- * Content can be a string, an array of {type:"text", text} blocks, or absent.
- */
-function extractText(block) {
-  if (typeof block.content === "string") return block.content;
-  if (Array.isArray(block.content)) {
-    return block.content
-      .filter((c) => c.type === "text")
-      .map((c) => c.text)
-      .join("\n");
-  }
-  return "";
-}
-
-/**
- * Return a new tool_result block with text replaced.
- * Preserves the content shape (string vs array).
- */
-function replaceText(block, newText) {
-  if (typeof block.content === "string") {
-    return { ...block, content: newText };
-  }
-  if (Array.isArray(block.content)) {
-    // Replace only text blocks, keep images etc.
-    const newContent = block.content.map((c) =>
-      c.type === "text" ? { ...c, text: newText } : c,
-    );
-    // If there were text blocks, replace the first and remove the rest
-    let seenText = false;
-    const filtered = newContent.filter((c) => {
-      if (c.type !== "text") return true;
-      if (!seenText) {
-        seenText = true;
-        return true;
-      }
-      return false;
-    });
-    return { ...block, content: filtered };
-  }
-  // No content field — add it as string
-  return { ...block, content: newText };
-}

package/src/proxy/adapters/gemini.js

@@ -1,106 +0,0 @@
-/**
- * Gemini message format adapter.
- *
- * Gemini API uses `contents[]` where each content has `parts[]`.
- * Function responses appear as parts with a `functionResponse` field:
- * `{ functionResponse: { name: "...", response: { content: "..." } } }`
- *
- * Gemini does not use explicit IDs for function calls/responses. Instead,
- * the function name serves as the correlation key. When multiple calls to
- * the same function exist, we generate synthetic IDs combining turnIndex
- * and part index for disambiguation.
- *
- * @module
- */
-
-/**
- * Extract tool results from Gemini-format messages (contents array).
- *
- * @param {Array<object>} messages - Gemini contents array
- * @returns {Array<{id: string, toolName: string, text: string, turnIndex: number}>}
- */
-export function extractToolResults(messages) {
-  const results = [];
-
-  for (let i = 0; i < messages.length; i++) {
-    const content = messages[i];
-    if (!content || !Array.isArray(content.parts)) continue;
-
-    for (let p = 0; p < content.parts.length; p++) {
-      const part = content.parts[p];
-      if (!part.functionResponse) continue;
-
-      const fr = part.functionResponse;
-      const toolName = fr.name || "unknown";
-      const text = extractResponseText(fr.response);
-      // Synthetic ID: turn index + part index (Gemini has no explicit IDs)
-      const id = `gemini-${i}-${p}`;
-
-      results.push({ id, toolName, text, turnIndex: i });
-    }
-  }
-
-  return results;
-}
-
-/**
- * Rebuild messages replacing functionResponse content with compressed versions.
- *
- * @param {Array<object>} messages - Original Gemini contents array
- * @param {Map<string, string>|Record<string, string>} compressedMap - id → compressed text
- * @returns {Array<object>} Deep-cloned messages with replacements applied
- */
-export function rebuildMessages(messages, compressedMap) {
-  const map = compressedMap instanceof Map ? compressedMap : new Map(Object.entries(compressedMap));
-
-  return messages.map((content, i) => {
-    if (!content || !Array.isArray(content.parts)) return content;
-
-    const newParts = content.parts.map((part, p) => {
-      if (!part.functionResponse) return part;
-
-      const id = `gemini-${i}-${p}`;
-      if (!map.has(id)) return part;
-
-      const compressed = map.get(id);
-      return {
-        ...part,
-        functionResponse: {
-          ...part.functionResponse,
-          response: replaceResponseText(part.functionResponse.response, compressed),
-        },
-      };
-    });
-
-    return { ...content, parts: newParts };
-  });
-}
-
-// ── helpers ──────────────────────────────────────────────────────────
-
-/**
- * Extract text from a Gemini function response object.
- * The response can have `content` (string), `result` (string),
- * or be a nested object that we JSON-serialize.
- */
-function extractResponseText(response) {
-  if (!response) return "";
-  if (typeof response === "string") return response;
-  if (typeof response.content === "string") return response.content;
-  if (typeof response.result === "string") return response.result;
-  // For structured responses, serialize to JSON
-  return JSON.stringify(response);
-}
-
-/**
- * Replace text in a Gemini function response object.
- * Preserves the original shape (content field, result field, etc.).
- */
-function replaceResponseText(response, newText) {
-  if (!response) return { content: newText };
-  if (typeof response === "string") return newText;
-  if (typeof response.content === "string") return { ...response, content: newText };
-  if (typeof response.result === "string") return { ...response, result: newText };
-  // Default: replace with content field
-  return { content: newText };
-}

package/src/proxy/adapters/index.js

@@ -1,51 +0,0 @@
-/**
- * Provider adapter registry.
- *
- * Each adapter implements the contract:
- *   extractToolResults(messages) → [{id, toolName, text, turnIndex}]
- *   rebuildMessages(messages, compressedMap) → messages
- *
- * @module
- */
-
-import * as anthropic from "./anthropic.js";
-import * as openai from "./openai.js";
-import * as gemini from "./gemini.js";
-
-const adapters = {
-  anthropic,
-  openai,
-  gemini,
-};
-
-/**
- * Hostname → provider mapping.
- * @type {Record<string, string>}
- */
-const HOST_MAP = {
-  "api.anthropic.com": "anthropic",
-  "api.openai.com": "openai",
-  "generativelanguage.googleapis.com": "gemini",
-};
-
-/**
- * Get the adapter for a given provider name.
- *
- * @param {string} provider - "anthropic" | "openai" | "gemini"
- * @returns {object|null} Adapter with extractToolResults and rebuildMessages, or null
- */
-export function getAdapter(provider) {
-  return adapters[provider] || null;
-}
-
-/**
- * Detect the provider from a hostname.
- *
- * @param {string} hostname - e.g. "api.anthropic.com", "api.openai.com:443"
- * @returns {string} Provider name or "unknown"
- */
-export function detectProvider(hostname) {
-  // Strip port if present
-  const host = (hostname || "").split(":")[0];
-  return HOST_MAP[host] || "unknown";
-}

package/src/proxy/adapters/openai.js

@@ -1,71 +0,0 @@
-/**
- * OpenAI message format adapter.
- *
- * OpenAI Chat Completions API uses messages with `role: "tool"`.
- * Each tool message has a `tool_call_id` linking back to the assistant's
- * `tool_calls` array, and a `content` string with the tool output.
- *
- * @module
- */
-
-/**
- * Extract tool results from OpenAI-format messages.
- *
- * @param {Array<object>} messages - OpenAI messages array
- * @returns {Array<{id: string, toolName: string, text: string, turnIndex: number}>}
- */
-export function extractToolResults(messages) {
-  const results = [];
-  const toolNameMap = buildToolNameMap(messages);
-
-  for (let i = 0; i < messages.length; i++) {
-    const msg = messages[i];
-    if (!msg || msg.role !== "tool") continue;
-
-    const id = msg.tool_call_id || "";
-    const text = typeof msg.content === "string" ? msg.content : "";
-    const toolName = toolNameMap.get(id) || "unknown";
-
-    results.push({ id, toolName, text, turnIndex: i });
-  }
-
-  return results;
-}
-
-/**
- * Rebuild messages replacing tool message content with compressed versions.
- *
- * @param {Array<object>} messages - Original OpenAI messages array
- * @param {Map<string, string>|Record<string, string>} compressedMap - id → compressed text
- * @returns {Array<object>} Deep-cloned messages with replacements applied
- */
-export function rebuildMessages(messages, compressedMap) {
-  const map = compressedMap instanceof Map ? compressedMap : new Map(Object.entries(compressedMap));
-  return messages.map((msg) => {
-    if (!msg || msg.role !== "tool") return msg;
-
-    const id = msg.tool_call_id || "";
-    if (!map.has(id)) return msg;
-
-    return { ...msg, content: map.get(id) };
-  });
-}
-
-// ── helpers ──────────────────────────────────────────────────────────
-
-/**
- * Build a map of tool_call id → function name by scanning assistant messages.
- * Assistant messages contain `tool_calls: [{id, function: {name, arguments}}]`.
- */
-function buildToolNameMap(messages) {
-  const map = new Map();
-  for (const msg of messages) {
-    if (!msg || msg.role !== "assistant" || !Array.isArray(msg.tool_calls)) continue;
-    for (const call of msg.tool_calls) {
-      if (call.id && call.function) {
-        map.set(call.id, call.function.name || "unknown");
-      }
-    }
-  }
-  return map;
-}

package/src/proxy/compression/ai-compressor.js

@@ -1,209 +0,0 @@
-/**
- * Optional AI-powered compression for content that remains large
- * after deterministic compression.
- * Calls a cheap LLM model to summarize old tool results while
- * preserving key data (file paths, error messages, numbers, status codes).
- *
- * Disabled by default. Enable via config: { enabled: true, provider, apiKey }.
- * Zero external dependencies — uses vanilla Node.js https module.
- */
-import https from "node:https";
-
-// ---------------------------------------------------------------------------
-// Provider definitions
-// ---------------------------------------------------------------------------
-const PROVIDERS = {
-  anthropic: {
-    hostname: "api.anthropic.com",
-    path: "/v1/messages",
-    defaultModel: "claude-3-5-haiku-20241022",
-    costPerInputToken: 0.25 / 1_000_000,
-    costPerOutputToken: 1.25 / 1_000_000,
-    buildRequest(text, model, apiKey, maxOutputTokens) {
-      const body = JSON.stringify({
-        model,
-        max_tokens: maxOutputTokens,
-        messages: [{ role: "user", content: buildPrompt(text) }]
-      });
-      return {
-        hostname: this.hostname,
-        path: this.path,
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "x-api-key": apiKey,
-          "anthropic-version": "2023-06-01"
-        },
-        body
-      };
-    },
-    parseResponse(data) {
-      const content = data.content?.[0]?.text ?? "";
-      const input = data.usage?.input_tokens ?? 0;
-      const output = data.usage?.output_tokens ?? 0;
-      return { text: content, tokensUsed: { input, output } };
-    }
-  },
-
-  openai: {
-    hostname: "api.openai.com",
-    path: "/v1/chat/completions",
-    defaultModel: "gpt-4o-mini",
-    costPerInputToken: 0.15 / 1_000_000,
-    costPerOutputToken: 0.6 / 1_000_000,
-    buildRequest(text, model, apiKey, maxOutputTokens) {
-      const body = JSON.stringify({
-        model,
-        max_tokens: maxOutputTokens,
-        messages: [
-          { role: "system", content: SYSTEM_PROMPT },
-          { role: "user", content: text }
-        ]
-      });
-      return {
-        hostname: this.hostname,
-        path: this.path,
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${apiKey}`
-        },
-        body
-      };
-    },
-    parseResponse(data) {
-      const content = data.choices?.[0]?.message?.content ?? "";
-      const input = data.usage?.prompt_tokens ?? 0;
-      const output = data.usage?.completion_tokens ?? 0;
-      return { text: content, tokensUsed: { input, output } };
-    }
-  },
-
-  gemini: {
-    hostname: "generativelanguage.googleapis.com",
-    defaultModel: "gemini-2.0-flash-lite",
-    costPerInputToken: 0.075 / 1_000_000,
-    costPerOutputToken: 0.3 / 1_000_000,
-    buildRequest(text, model, apiKey, maxOutputTokens) {
-      const path = `/v1beta/models/${model}:generateContent?key=${apiKey}`;
-      const body = JSON.stringify({
-        contents: [{ parts: [{ text: buildPrompt(text) }] }],
-        generationConfig: { maxOutputTokens }
-      });
-      return {
-        hostname: this.hostname,
-        path,
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body
-      };
-    },
-    parseResponse(data) {
-      const content = data.candidates?.[0]?.content?.parts?.[0]?.text ?? "";
-      const input = data.usageMetadata?.promptTokenCount ?? 0;
-      const output = data.usageMetadata?.candidatesTokenCount ?? 0;
-      return { text: content, tokensUsed: { input, output } };
-    }
-  }
-};
-
-// ---------------------------------------------------------------------------
-// Prompt
-// ---------------------------------------------------------------------------
-const SYSTEM_PROMPT =
-  "You are a compression assistant. Summarize the following tool output concisely " +
-  "while preserving ALL: file paths, error messages, numbers, status codes, " +
-  "exit codes, and key technical details. Remove boilerplate, repeated lines, " +
-  "and verbose formatting. Output only the summary, no preamble.";
-
-function buildPrompt(text) {
-  return `${SYSTEM_PROMPT}\n\n---\n${text}`;
-}
-
-// ---------------------------------------------------------------------------
-// HTTPS helper
-// ---------------------------------------------------------------------------
-function httpsRequest({ hostname, path, method, headers, body }) {
-  return new Promise((resolve, reject) => {
-    const req = https.request({ hostname, path, method, headers }, (res) => {
-      const chunks = [];
-      res.on("data", (chunk) => chunks.push(chunk));
-      res.on("end", () => {
-        const raw = Buffer.concat(chunks).toString();
-        if (res.statusCode < 200 || res.statusCode >= 300) {
-          reject(new Error(`HTTP ${res.statusCode}: ${raw}`));
-          return;
-        }
-        try {
-          resolve(JSON.parse(raw));
-        } catch (err) {
-          reject(new Error(`Invalid JSON response: ${raw.slice(0, 200)}`));
-        }
-      });
-      res.on("error", reject);
-    });
-    req.on("error", reject);
-    if (body) req.write(body);
-    req.end();
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-
-/**
- * Check whether AI compression can be used with the given config.
- * @param {{ enabled?: boolean, provider?: string, apiKey?: string }} config
- * @returns {boolean}
- */
-export function isAICompressionAvailable(config) {
-  if (!config || !config.enabled) return false;
-  const provider = config.provider ?? "anthropic";
-  if (!PROVIDERS[provider]) return false;
-  return Boolean(config.apiKey);
-}
-
-/**
- * Compress text using a cheap LLM model.
- * @param {string} text - text to compress
- * @param {{ model?: string, apiKey?: string, provider?: string, maxOutputTokens?: number, enabled?: boolean }} options
- * @returns {Promise<{ compressed: string, tokensUsed: { input: number, output: number }, cost: number }>}
- */
-export async function compressWithAI(text, options = {}) {
-  const { enabled = false, provider: providerName = "anthropic", apiKey, maxOutputTokens = 1024 } = options;
-
-  // Disabled mode — return original text unchanged
-  if (!enabled || !apiKey) {
-    return { compressed: text, tokensUsed: { input: 0, output: 0 }, cost: 0 };
-  }
-
-  const provider = PROVIDERS[providerName];
-  if (!provider) {
-    return { compressed: text, tokensUsed: { input: 0, output: 0 }, cost: 0 };
-  }
-
-  const model = options.model ?? provider.defaultModel;
-
-  try {
-    const reqOpts = provider.buildRequest(text, model, apiKey, maxOutputTokens);
-    const data = await httpsRequest(reqOpts);
-    const { text: compressed, tokensUsed } = provider.parseResponse(data);
-
-    if (!compressed) {
-      return { compressed: text, tokensUsed: { input: 0, output: 0 }, cost: 0 };
-    }
-
-    const cost =
-      tokensUsed.input * provider.costPerInputToken +
-      tokensUsed.output * provider.costPerOutputToken;
-
-    return { compressed, tokensUsed, cost };
-  } catch {
-    // Graceful degradation — return original text on any failure
-    return { compressed: text, tokensUsed: { input: 0, output: 0 }, cost: 0 };
-  }
-}
-
-/** Exported for testing */
-export { PROVIDERS };