@kody-ade/kody-engine 0.4.596 → 0.4.598

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.596",
+      version: "0.4.598",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -4228,7 +4228,7 @@ async function runAgent(opts) {
     }
     try {
       const queryOptions = {
-        model: opts.litellmUrl ? litellmModelGroup(opts.model) : opts.model.model,
+        model: opts.litellmUrl ? opts.litellmModelGroupOverride ?? litellmModelGroup(opts.model) : opts.model.model,
         cwd: opts.cwd,
         // Fresh array (never mutate the shared DEFAULT_ALLOWED_TOOLS const) so
         // opt-in tools like fetch_repo can be appended below.
@@ -7850,6 +7850,43 @@ function generateLitellmConfigYaml(model) {
   ]);
   return ["model_list:", ...modelEntries, "", "litellm_settings:", "  drop_params: true", ""].join("\n");
 }
+function modelEntry(modelName, model) {
+  const apiKeyVar = model.apiKeyEnvVar ?? providerApiKeyEnvVar(model.provider);
+  const litellmProvider = model.litellmProvider ?? model.provider;
+  return [
+    `  - model_name: ${modelName}`,
+    `    litellm_params:`,
+    `      model: ${litellmProvider}/${model.model}`,
+    `      api_key: os.environ/${apiKeyVar}`,
+    ...model.baseURL ? [`      api_base: ${model.baseURL}`] : []
+  ];
+}
+function generateAutomaticLitellmConfigYaml(models) {
+  if (models.length < 2) throw new Error("Automatic LiteLLM requires at least two models");
+  const groups = models.map((_, index) => `kody-automatic-${index}`);
+  const entries = models.flatMap((model, index) => modelEntry(groups[index], model));
+  for (const alias of CLAUDE_CODE_PROXY_MODEL_ALIASES) entries.push(...modelEntry(alias, models[0]));
+  const fallbackSources = [groups[0], ...CLAUDE_CODE_PROXY_MODEL_ALIASES, ...groups.slice(1, -1)];
+  const fallbacks = fallbackSources.map((source) => {
+    const sourceIndex = source.startsWith("kody-automatic-") ? Number(source.slice("kody-automatic-".length)) : 0;
+    return `    - ${source}: [${groups.slice(sourceIndex + 1).join(", ")}]`;
+  });
+  return [
+    "model_list:",
+    ...entries,
+    "",
+    "litellm_settings:",
+    "  drop_params: true",
+    "",
+    "router_settings:",
+    "  num_retries: 0",
+    "  allowed_fails: 0",
+    "  disable_cooldowns: true",
+    "  fallbacks:",
+    ...fallbacks,
+    ""
+  ].join("\n");
+}
 function litellmModelGroups(model) {
   const primary = litellmModelGroup(model);
   return Array.from(/* @__PURE__ */ new Set([primary, ...CLAUDE_CODE_PROXY_MODEL_ALIASES]));
@@ -7922,9 +7959,29 @@ function resolveLitellmCommand() {
 }
 async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL, runtimeEnvironment = {}) {
   if (!needsLitellmProxy(model)) return null;
+  return startLitellmProxy({
+    projectDir,
+    url,
+    runtimeEnvironment,
+    configYaml: generateLitellmConfigYaml(model),
+    requiredModelGroups: litellmModelGroups(model)
+  });
+}
+async function startAutomaticLitellm(models, projectDir, runtimeEnvironment = {}, url = LITELLM_DEFAULT_URL) {
+  const handle = await startLitellmProxy({
+    projectDir,
+    url,
+    runtimeEnvironment,
+    configYaml: generateAutomaticLitellmConfigYaml(models),
+    requiredModelGroups: [AUTOMATIC_LITELLM_MODEL_GROUP, ...CLAUDE_CODE_PROXY_MODEL_ALIASES]
+  });
+  return { ...handle, modelGroup: AUTOMATIC_LITELLM_MODEL_GROUP };
+}
+async function startLitellmProxy(input) {
+  const { projectDir, runtimeEnvironment } = input;
   const cmd = resolveLitellmCommand();
-  let activeUrl = url.replace(/\/+$/, "");
-  const modelGroups = litellmModelGroups(model);
+  let activeUrl = input.url.replace(/\/+$/, "");
+  const modelGroups = input.requiredModelGroups;
   const childEnv = stripBlockingEnv({
     ...process.env,
     ...readDotenvApiKeys(projectDir),
@@ -7936,7 +7993,7 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
     const portMatch = activeUrl.match(/:(\d+)/);
     const port = portMatch ? portMatch[1] : "4000";
     const configPath = path27.join(os4.tmpdir(), `kody-local-litellm-${Date.now()}.yaml`);
-    fs28.writeFileSync(configPath, generateLitellmConfigYaml(model));
+    fs28.writeFileSync(configPath, input.configYaml);
     const args = ["--config", configPath, "--port", port];
     const nextLogPath = path27.join(os4.tmpdir(), `kody-local-litellm-${Date.now()}.log`);
     const outFd = fs28.openSync(nextLogPath, "w");
@@ -8062,7 +8119,7 @@ function stripBlockingEnv(env) {
   delete out.AI_BASE_URL;
   return out;
 }
-var LITELLM_PIP_PACKAGES, DEFAULT_LITELLM_STARTUP_TIMEOUT_SEC, LITELLM_HEALTH_POLL_INTERVAL_MS, CLAUDE_CODE_PROXY_MODEL_ALIASES;
+var LITELLM_PIP_PACKAGES, DEFAULT_LITELLM_STARTUP_TIMEOUT_SEC, LITELLM_HEALTH_POLL_INTERVAL_MS, CLAUDE_CODE_PROXY_MODEL_ALIASES, AUTOMATIC_LITELLM_MODEL_GROUP;
 var init_litellm = __esm({
   "src/litellm.ts"() {
     "use strict";
@@ -8071,6 +8128,7 @@ var init_litellm = __esm({
     DEFAULT_LITELLM_STARTUP_TIMEOUT_SEC = 150;
     LITELLM_HEALTH_POLL_INTERVAL_MS = 2e3;
     CLAUDE_CODE_PROXY_MODEL_ALIASES = ["claude-haiku-4-5-20251001", "haiku"];
+    AUTOMATIC_LITELLM_MODEL_GROUP = "kody-automatic-0";
   }
 });
 
@@ -18269,8 +18327,7 @@ function githubRepositoryParts(repoUrl) {
   if (!parts[0] || !repo) throw new Error("repository URL is incomplete");
   return { owner: parts[0], repo };
 }
-function browserOrigin(ctx) {
-  const raw = typeof ctx.data.previewUrl === "string" ? ctx.data.previewUrl : "";
+function browserOrigin(raw) {
   if (!raw) throw new Error("QA target URL is unavailable");
   const parsed = new URL(raw);
   if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
@@ -18355,6 +18412,17 @@ async function prepareMethod(ctx, profile, method) {
   const { repositoryKey, credentialKey } = fieldsForKodyRepository(method);
   const variables = readKodyVariables(ctx.cwd);
   const repositoryUrl = variables[repositoryKey]?.trim() ?? "";
+  const targetUrl = typeof ctx.data.previewUrl === "string" ? ctx.data.previewUrl : "";
+  return prepareKodyRepositoryBrowserAuth(ctx, profile, {
+    repositoryUrl,
+    repositoryKey,
+    credentialKey,
+    methodName: method.name,
+    targetUrl
+  });
+}
+async function prepareKodyRepositoryBrowserAuth(ctx, profile, input) {
+  const { repositoryUrl, credentialKey } = input;
   const credential = await resolveRuntimeSecret(credentialKey, ctx);
   ctx.data.qaAuthSecretSources = {
     ...ctx.data.qaAuthSecretSources ?? {},
@@ -18368,14 +18436,14 @@ async function prepareMethod(ctx, profile, method) {
   if (!repositoryUrl) {
     appendAuthMessage(
       ctx,
-      `Auth: ${method.name} is incomplete because no \`${repositoryKey}\` variable was found. Note this authenticated surface as a gap.`
+      `Auth: ${input.methodName} is incomplete because no \`${input.repositoryKey ?? "repository"}\` variable was found. Note this authenticated surface as a gap.`
     );
     return false;
   }
   if (!credential.value) {
     appendAuthMessage(
       ctx,
-      `Auth: ${method.name} is incomplete because no \`${credentialKey}\` secret was found. Note this authenticated surface as a gap.`
+      `Auth: ${input.methodName} is incomplete because no \`${credentialKey}\` secret was found. Note this authenticated surface as a gap.`
     );
     return false;
   }
@@ -18394,7 +18462,7 @@ async function prepareMethod(ctx, profile, method) {
       throw new Error("GitHub returned incomplete identity data");
     }
     state = writeKodyStorageState({
-      origin: browserOrigin(ctx),
+      origin: browserOrigin(input.targetUrl),
       repoUrl: `https://github.com/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`,
       owner,
       repo,
@@ -18408,7 +18476,7 @@ async function prepareMethod(ctx, profile, method) {
     });
     appendAuthMessage(
       ctx,
-      `Auth: ${method.name} is already authenticated by the engine-provided browser session. The credential is not available to you; never request, reveal, or report it.`
+      `Auth: ${input.methodName} is already authenticated by the engine-provided browser session. The credential is not available to you; never request, reveal, or report it.`
     );
     return true;
   } catch (error) {
@@ -18416,7 +18484,7 @@ async function prepareMethod(ctx, profile, method) {
     const reason = error instanceof Error ? error.message : String(error);
     appendAuthMessage(
       ctx,
-      `Auth: the engine could not prepare ${method.name} (${reason}). Note this authenticated surface as a gap.`
+      `Auth: the engine could not prepare ${input.methodName} (${reason}). Note this authenticated surface as a gap.`
     );
     return false;
   }
@@ -18635,7 +18703,7 @@ var init_prepareSimpleCapabilityRuntime = __esm({
   "src/scripts/prepareSimpleCapabilityRuntime.ts"() {
     "use strict";
     init_loadQaContext();
-    init_runtimeSecrets();
+    init_prepareBrowserAuth();
     PLAYWRIGHT_SERVER = {
       name: "playwright",
       command: "npx",
@@ -18647,6 +18715,18 @@ var init_prepareSimpleCapabilityRuntime = __esm({
       configureBrowser(ctx, profile, requirements);
       if (requirements.qaCredentials) {
         await loadQaContext(ctx, profile);
+      }
+      if (requirements.githubTestToken) {
+        const capabilityInput = ctx.data.capabilityInput && typeof ctx.data.capabilityInput === "object" && !Array.isArray(ctx.data.capabilityInput) ? ctx.data.capabilityInput : {};
+        const targetUrl = typeof capabilityInput.url === "string" ? capabilityInput.url : typeof capabilityInput.targetUrl === "string" ? capabilityInput.targetUrl : "";
+        await prepareKodyRepositoryBrowserAuth(ctx, profile, {
+          repositoryUrl: `https://github.com/${ctx.config.github.owner}/${ctx.config.github.repo}`,
+          credentialKey: "E2E_GITHUB_TOKEN",
+          methodName: "Kody protected QA login",
+          targetUrl
+        });
+      }
+      if (requirements.qaCredentials || requirements.githubTestToken) {
         appendPrompt(
           ctx,
           [
@@ -18658,22 +18738,6 @@ var init_prepareSimpleCapabilityRuntime = __esm({
           ].join("\n")
         );
       }
-      if (requirements.githubTestToken) {
-        const token = await resolveRuntimeSecret("E2E_GITHUB_TOKEN", ctx);
-        appendPrompt(
-          ctx,
-          token.value ? [
-            "## Protected GitHub test login",
-            "",
-            `A protected GitHub test token is available: \`${token.value}\``,
-            "Use it only if the target application asks for a GitHub personal access token; never include the token in screenshots, output, logs, files, or messages."
-          ].join("\n") : [
-            "## Protected GitHub test login",
-            "",
-            "E2E_GITHUB_TOKEN is not configured. If this Quality Scenario requires GitHub token authentication, return a blocked result."
-          ].join("\n")
-        );
-      }
     };
   }
 });
@@ -22454,6 +22518,19 @@ async function runImplementation(profileName, input) {
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     const agents = loadSubagents(profile);
+    if (modelSpec === "automatic") {
+      const automaticEnvironment = {};
+      for (const candidate of modelCandidates) {
+        const resolved2 = await resolveRuntimeModelEnvironment(candidate, ctx);
+        Object.assign(automaticEnvironment, resolved2.environment);
+        for (const warning of resolved2.warnings) process.stderr.write(`\u26A0 ${warning}
+`);
+      }
+      const lm = await startAutomaticLitellm(modelCandidates, input.cwd, automaticEnvironment);
+      activeLiteLLM.add(lm);
+      const result = await invokeModel(modelCandidates[0], lm, automaticEnvironment, lm.modelGroup);
+      return result;
+    }
     let finalResult;
     for (let candidateIndex = 0; candidateIndex < modelCandidates.length; candidateIndex++) {
       const candidate = modelCandidates[candidateIndex];
@@ -22473,7 +22550,24 @@ async function runImplementation(profileName, input) {
       }
       ctx.data.jobModelProvider = candidate.provider;
       ctx.data.jobModelName = candidate.model;
-      const result = await runAgent({
+      const result = await invokeModel(candidate, lm, runtimeModelEnvironment);
+      finalResult = result;
+      const next = modelCandidates[candidateIndex + 1];
+      if (!next || result.outcome !== "failed" || result.outcomeKind !== "rate_limit" || result.safeToReplay !== true) {
+        return result;
+      }
+      process.stderr.write(
+        `[kody agent] ${candidate.spec ?? candidate.model} is rate limited; continuing with ${next.spec ?? next.model}
+`
+      );
+      if (lm) {
+        lm.kill();
+        activeLiteLLM.delete(lm);
+      }
+    }
+    return finalResult;
+    async function invokeModel(candidate, lm, runtimeModelEnvironment, litellmModelGroupOverride) {
+      return runAgent({
         prompt,
         model: candidate,
         cwd: input.cwd,
@@ -22482,6 +22576,7 @@ async function runImplementation(profileName, input) {
           ...runtimeModelEnvironment
         },
         litellmUrl: lm?.url ?? null,
+        litellmModelGroupOverride,
         // On a connection drop mid-run, restart the (possibly crashed) proxy
         // before the agent retries. No-op for direct-Anthropic runs (lm null).
         ensureBackend: lm ? () => lm.ensureHealthy().then(() => void 0) : void 0,
@@ -22491,7 +22586,7 @@ async function runImplementation(profileName, input) {
         verbose: input.verbose,
         quiet: input.quiet,
         abortController: input.abortController,
-        stopOnRateLimit: candidateIndex < modelCandidates.length - 1,
+        stopOnRateLimit: false,
         deadlineAtMs: input.deadlineAtMs,
         ndjsonDir,
         additionalDirectories: agentTaskArtifacts ? [agentTaskArtifacts.absDir] : void 0,
@@ -22541,21 +22636,7 @@ async function runImplementation(profileName, input) {
           schema: ctx.data.capabilityOutputSchema
         } : void 0
       });
-      finalResult = result;
-      const next = modelCandidates[candidateIndex + 1];
-      if (!next || result.outcome !== "failed" || result.outcomeKind !== "rate_limit" || result.safeToReplay !== true) {
-        return result;
-      }
-      process.stderr.write(
-        `[kody agent] ${candidate.spec ?? candidate.model} is rate limited; continuing with ${next.spec ?? next.model}
-`
-      );
-      if (lm) {
-        lm.kill();
-        activeLiteLLM.delete(lm);
-      }
     }
-    return finalResult;
   };
   ctx.data.__invokeAgent = invokeAgent;
   const cc = profile.claudeCode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.596",
+  "version": "0.4.598",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",