@kybernesis/create 0.18.0 → 0.19.0

package/dist/doctor.d.ts

@@ -20,7 +20,7 @@ export interface DockerTemplateInspection {
     }[];
 }
 export declare function dockerTemplateDoctorChecks(result: DockerTemplateInspection): Check[];
-export declare function modelReachDoctorCheck(authoredSource: string | null, compiledRouting: CompiledModelRouting): Check;
+export declare function modelReachDoctorCheck(authoredSource: string | null, compiledRouting: CompiledModelRouting, env?: Record<string, string | undefined>): Check;
 export declare function agentInputLimitDoctorCheck(limit: AgentInputLimit): Check;
 export declare function diskUsageDoctorCheck(percent: number, dockerSummary: string | null): Check;
 /**

package/dist/doctor.js

@@ -47,8 +47,13 @@ export function dockerTemplateDoctorChecks(result) {
         detail: issue.detail,
     }));
 }
-export function modelReachDoctorCheck(authoredSource, compiledRouting) {
-    const reach = classifyModelReach(authoredSource, compiledRouting);
+export function modelReachDoctorCheck(authoredSource, compiledRouting, env = {}) {
+    const check = modelReachCheck(classifyModelReach(authoredSource, compiledRouting, env));
+    return authoredSource !== null && /\bexeModelReach\s*\(/.test(authoredSource)
+        ? { ...check, label: `${check.label} [KYB_MODEL_REACH switch]` }
+        : check;
+}
+function modelReachCheck(reach) {
     switch (reach.kind) {
         case "claude-sub":
             return { verdict: "pass", label: "Model reach: claude-sub (Claude subscription)" };
@@ -653,7 +658,7 @@ export async function doctor() {
         const reachCheck = modelReachDoctorCheck(rootAgentSource, {
             kind: "unresolved",
             reason: "eve info failed before compiled model routing could be inspected",
-        });
+        }, env);
         add(reachCheck.verdict, reachCheck.label, reachCheck.detail);
         add("warn", "Eve max input tokens/session: unresolved", "eve info failed before the compiled root policy could be inspected");
     }
@@ -663,7 +668,7 @@ export async function doctor() {
             add("pass", `eve discovery clean (${diag.warnings} warnings)`);
         else
             add("fail", `eve discovery: ${diag ? `${diag.errors} errors` : "unparsed"}`, "npx eve info --json");
-        const reachCheck = modelReachDoctorCheck(rootAgentSource, info.modelRouting);
+        const reachCheck = modelReachDoctorCheck(rootAgentSource, info.modelRouting, env);
         add(reachCheck.verdict, reachCheck.label, reachCheck.detail);
         const limitCheck = agentInputLimitDoctorCheck(info.limit);
         add(limitCheck.verdict, limitCheck.label, limitCheck.detail);

package/dist/init.js

@@ -132,17 +132,12 @@ export async function init(rawName, options = {}) {
     for (const item of CORE_ITEMS) {
         run("npx", ["eve", "add", `@kybernesis/${item}`, "--overwrite"], { cwd: dir });
     }
-    // Anthropic is always the exe eval judge and is also the claude-sub agent
-    // provider. OpenAI is needed only by the ordinary exeModel gateway route.
+    // Anthropic is always the exe eval judge. Both providers are installed on
+    // every exe agent: exeModelReach can be switched to any route at boot, and
+    // between them the routes call both.
     const extraDeps = [
         ...plan.deps,
-        ...(host === "exe"
-            ? [
-                "@kybernesis/exe",
-                ...(model.reach === "default" ? ["@ai-sdk/openai"] : []),
-                "@ai-sdk/anthropic",
-            ]
-            : []),
+        ...(host === "exe" ? ["@kybernesis/exe", "@ai-sdk/openai", "@ai-sdk/anthropic"] : []),
     ];
     if (extraDeps.length) {
         console.log(bold(`\n2b   Installing for ${channel}/${host}: ${extraDeps.join(", ")} …`));

package/dist/model-reach.d.ts

@@ -39,8 +39,15 @@ export declare function resolveModelScaffold(options: {
     envReach?: string;
     model?: string;
 }): ModelScaffoldConfig;
+/**
+ * The route an `exeModelReach` agent takes at boot: KYB_MODEL_REACH when it is
+ * one that can run, else the authored `reach`. The same rules as
+ * `resolveExeReach` in @kybernesis/exe (declared here so create keeps zero
+ * runtime deps); change both together.
+ */
+export declare function switchedModelReach(source: string, env: Record<string, string | undefined>): DoctorModelReach | null;
 /**
  * Classify the effective route from stable authored helpers first, then Eve's
  * compiled routing. Provider=anthropic alone is not evidence of a subscription.
  */
-export declare function classifyModelReach(authoredSource: string | null, compiledRouting: CompiledModelRouting): DoctorModelReach;
+export declare function classifyModelReach(authoredSource: string | null, compiledRouting: CompiledModelRouting, env?: Record<string, string | undefined>): DoctorModelReach;

package/dist/model-reach.js

@@ -27,12 +27,46 @@ export function resolveModelScaffold(options) {
     }
     return { reach, model };
 }
+/**
+ * The route an `exeModelReach` agent takes at boot: KYB_MODEL_REACH when it is
+ * one that can run, else the authored `reach`. The same rules as
+ * `resolveExeReach` in @kybernesis/exe (declared here so create keeps zero
+ * runtime deps); change both together.
+ */
+export function switchedModelReach(source, env) {
+    if (!/\bexeModelReach\s*\(/.test(source))
+        return null;
+    const authored = /\breach\s*:\s*["'](gateway|byok|claude-sub)["']/.exec(source)?.[1];
+    if (!authored)
+        return { kind: "unresolved", reason: "exeModelReach has no literal default reach to read" };
+    const model = env.EXE_MODEL ?? /\bmodel\s*:\s*["']([^"']+)["']/.exec(source)?.[1] ?? "";
+    const route = (reach) => {
+        if (reach === "gateway")
+            return { kind: "exe" };
+        if (reach === "claude-sub")
+            return { kind: "claude-sub" };
+        if (reach !== "byok")
+            return null;
+        const provider = /^(anthropic|openai)\//.exec(model)?.[1];
+        if (!provider)
+            return null;
+        return env[provider === "anthropic" ? "ANTHROPIC_API_KEY" : "OPENAI_API_KEY"]?.trim()
+            ? { kind: "direct-provider", provider }
+            : null;
+    };
+    const requested = env[MODEL_REACH_ENV]?.trim();
+    const chosen = requested ? route(requested) : null;
+    return chosen ?? route(authored) ?? { kind: "direct-provider", ...(/^(anthropic|openai)\//.exec(model) ? { provider: model.split("/")[0] } : {}) };
+}
 /**
  * Classify the effective route from stable authored helpers first, then Eve's
  * compiled routing. Provider=anthropic alone is not evidence of a subscription.
  */
-export function classifyModelReach(authoredSource, compiledRouting) {
+export function classifyModelReach(authoredSource, compiledRouting, env = {}) {
     if (authoredSource !== null) {
+        const switched = switchedModelReach(authoredSource, env);
+        if (switched)
+            return switched;
         const claudeSubscription = /\bclaudeSubscription\s*\(/.test(authoredSource);
         const exeModel = /\bexeModel\s*\(/.test(authoredSource);
         const grokSubscription = /\bgrokSubscription\s*\(/.test(authoredSource);

package/dist/templates.js

@@ -392,33 +392,38 @@ export default discordChannel({ botToken: process.env.DISCORD_BOT_TOKEN! });
 }
 /** One renderer for every model-bearing generated agent, root or subagent. */
 function agentModelTemplate(host, config) {
-    if (config.reach === "claude-sub") {
-        if (host !== "exe")
-            throw new Error("claude-sub model templates require an exe host");
-        return {
-            imports: `import { createAnthropic } from "@ai-sdk/anthropic";\n` +
-                `import { CLAUDE_SUBSCRIPTION_CONTEXT_WINDOW, claudeSubscription } from "@kybernesis/exe";\n\n`,
-            fields: `  model: claudeSubscription({ model: ${JSON.stringify(config.model)}, createAnthropic }),\n` +
-                `  modelContextWindowTokens: CLAUDE_SUBSCRIPTION_CONTEXT_WINDOW,\n`,
-        };
-    }
+    if (config.reach === "claude-sub" && host !== "exe")
+        throw new Error("claude-sub model templates require an exe host");
     if (host === "exe") {
+        /**
+         * Every exe agent takes the runtime switch: KYB_MODEL_REACH (gateway, byok
+         * or claude-sub) picks the route at boot, so the setup route can change it
+         * by writing env. `reach` here is what runs while it is unset, which is
+         * exactly what this scaffold used to hard-code.
+         *
+         * The subscription scaffold still names a gateway id, used only if the
+         * agent is switched to the gateway or BYOK with no EXE_MODEL set.
+         */
+        const defaults = config.reach === "claude-sub"
+            ? `reach: "claude-sub", model: ${JSON.stringify(`anthropic/${config.model}`)}`
+            : `reach: "gateway", model: ${JSON.stringify(config.model)}`;
         return {
-            imports: `import { createOpenAI } from "@ai-sdk/openai";\n` +
-                `import { exeModel } from "@kybernesis/exe";\n\n`,
-            fields: `  model: exeModel({ model: process.env.EXE_MODEL ?? ${JSON.stringify(config.model)}, createOpenAI }),\n` +
-                `  modelContextWindowTokens: 200_000,\n`,
+            imports: `import { createAnthropic } from "@ai-sdk/anthropic";\n` +
+                `import { createOpenAI } from "@ai-sdk/openai";\n` +
+                `import { exeModelReach } from "@kybernesis/exe";\n\n`,
+            fields: `  ...exeModelReach({ ${defaults}, createOpenAI, createAnthropic }),\n`,
         };
     }
     return { imports: "", fields: `  model: ${JSON.stringify(config.model)},\n` };
 }
 export function hostAgentTs(host, model) {
     const rendered = agentModelTemplate(host, model);
-    const comment = model.reach === "claude-sub"
-        ? `// Claude subscription model through the loopback OAuth proxy — no API key or exe gateway.\n`
-        : host === "exe"
-            ? `// Model served by the exe.dev LLM integration — no provider key on the host.\n// exe injects the credential (managed gateway, your API key, or a connected\n// ChatGPT subscription) server-side.\n`
-            : "";
+    const comment = host !== "exe"
+        ? ""
+        : (model.reach === "claude-sub"
+            ? `// By default a Claude subscription through the loopback OAuth proxy — no API key or exe gateway.\n`
+            : `// By default the exe.dev LLM integration — no provider key on the host; exe\n// injects the credential (managed gateway, your API key, or a connected\n// ChatGPT subscription) server-side.\n`) +
+            `// KYB_MODEL_REACH (gateway | byok | claude-sub) switches the route at boot\n// without editing this file; EXE_MODEL names the gateway or BYOK model.\n`;
     return `import { defineAgent } from "eve";
 ${rendered.imports}${comment}export default defineAgent({
 ${rendered.fields}${host === "exe" ? `  // This long-lived self-hosted process has no metered platform session ceiling.\n  limits: { maxInputTokensPerSession: false },\n` : ""}});

package/dist/upgrade.js

@@ -607,7 +607,7 @@ export async function preflightEvalGate(cwd) {
     const reach = classifyModelReach(authoredSource, inspection?.modelRouting ?? {
         kind: "unresolved",
         reason: "eve info failed before compiled model routing could be inspected",
-    });
+    }, env);
     const reasons = [];
     switch (reach.kind) {
         case "claude-sub":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybernesis/create",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "The Kybernesis agent scaffolder and FDE toolkit: one command to a governed, remembering, multiplayer, self-testing eve agent \u2014 plus doctor and upgrade.",
   "license": "Apache-2.0",
   "type": "module",

package/skills/kybernesis-packages/SKILL.md

@@ -82,8 +82,22 @@ then `eve add @kybernesis/<item>`). Each covers one axis:
 - **manage** — the other direction: `manageChannel()` lets Studio install
   capabilities and write schedules onto a running agent, and `routineTools()`
   turns "every morning at 8, brief me" into a real schedule file. This is how a
-  routine gets created from chat without anyone touching the repo.
-- **exe** — running off Vercel. `exeModel()` for exe.dev's LLM integration,
+  routine gets created from chat without anyone touching the repo. Since 0.11
+  it also carries the owner's setup routes (`GET /eve/v1/kyb/setup`,
+  `POST .../setup/env`, `POST .../setup/action`): a `manage` grant only;
+  allowlisted env (`EXE_MODEL`, `EXE_LLM_URL`, `ANTHROPIC_API_KEY`,
+  `OPENAI_API_KEY`, `SLACK_BOT_TOKEN`, `SLACK_SIGNING_SECRET`) and the actions
+  `claude.login` (link, then the code on stdin), `linq.signup`/`linq.verify`,
+  `link.login` and `vnc.password`. Every change applies at one restart that
+  waits until no conversation is in flight (deploy.sh's count). A BYOK key only
+  takes effect when `agent/agent.ts` uses that provider; status says so.
+  Since 0.12 it also takes `KYB_MODEL_REACH` (`gateway`, `byok`,
+  `claude-sub`) for agents authored with exe's `exeModelReach()`, and status
+  reports the route that will boot (with `fallback` when the request can't run).
+- **exe** — running off Vercel. `exeModelReach()` (0.16+, what `kyb init
+  --host=exe` writes from create 0.19) picks gateway, BYOK or the Claude
+  subscription from `KYB_MODEL_REACH` at boot and falls back to the authored
+  default rather than fail to start. `exeModel()` for exe.dev's LLM integration,
   `grokSubscription()` / `readGrokCredential()` for a SuperGrok or X Premium+
   login (`grok login` → `~/.grok/auth.json`, a valid bearer for api.x.ai —
   same shape as eve's `experimental_chatgpt()`), `hostPreflight()`, Photon