@kybernesis/create 0.13.1 → 0.13.3

package/dist/add.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `kyb add channel <kind>` — put another surface on an agent that already exists.
+ *
+ * @remarks
+ * The scaffold has told people to run this command since the day it shipped,
+ * in its own closing summary and in the host-specific steps, and it did not
+ * exist. Anyone following those instructions got "no such command" and a
+ * suggestion to upgrade, which is a particularly bad failure: the advice is
+ * wrong, the fix it proposes does nothing, and the person concludes their
+ * install is broken.
+ *
+ * Everything it needs was already here. `channelPlan` describes each surface —
+ * its file, dependencies, registry items, env and human steps — and `init` has
+ * always applied that plan. This applies the same plan to a directory that is
+ * already an agent, which is all "add" ever meant.
+ */
+export declare function add(what: string | undefined, rest: string[]): Promise<void>;

package/dist/add.js

@@ -0,0 +1,110 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { bold, dim, green, red, run, yellow } from "./util.js";
+import { CHANNEL_KINDS, channelPlan } from "./templates.js";
+/**
+ * `kyb add channel <kind>` — put another surface on an agent that already exists.
+ *
+ * @remarks
+ * The scaffold has told people to run this command since the day it shipped,
+ * in its own closing summary and in the host-specific steps, and it did not
+ * exist. Anyone following those instructions got "no such command" and a
+ * suggestion to upgrade, which is a particularly bad failure: the advice is
+ * wrong, the fix it proposes does nothing, and the person concludes their
+ * install is broken.
+ *
+ * Everything it needs was already here. `channelPlan` describes each surface —
+ * its file, dependencies, registry items, env and human steps — and `init` has
+ * always applied that plan. This applies the same plan to a directory that is
+ * already an agent, which is all "add" ever meant.
+ */
+export async function add(what, rest) {
+    if (what !== "channel") {
+        console.error(red(`kyb add: don't know how to add "${what ?? ""}".`));
+        console.log(dim(`  kyb add channel <${CHANNEL_KINDS.filter((k) => k !== "none").join("|")}>`));
+        process.exitCode = 1;
+        return;
+    }
+    const kind = rest.find((a) => !a.startsWith("-"));
+    if (!kind || !CHANNEL_KINDS.includes(kind) || kind === "none") {
+        console.error(red(`kyb add channel: pick one of ${CHANNEL_KINDS.filter((k) => k !== "none").join(", ")}.`));
+        process.exitCode = 1;
+        return;
+    }
+    const dir = resolve(process.cwd());
+    if (!existsSync(join(dir, "package.json")) || !existsSync(join(dir, "agent"))) {
+        console.error(red("kyb add channel: run this inside an agent directory."));
+        process.exitCode = 1;
+        return;
+    }
+    const name = agentNameOf(dir);
+    const host = existsSync(join(dir, "scripts/eve-server.sh")) ? "exe" : "vercel";
+    const plan = channelPlan(kind, name, host);
+    console.log(bold(`kyb add channel ${kind}`));
+    console.log(dim(`  agent: ${name}\n  host:  ${host}`));
+    if (!plan.file) {
+        console.error(red(`  ${kind} has no channel file to add.`));
+        process.exitCode = 1;
+        return;
+    }
+    const target = join(dir, "agent/channels", plan.file);
+    // Refuse rather than overwrite. A channel file is somewhere people put real
+    // logic — routing, filters, a greeting — and silently replacing it with the
+    // template is not something an "add" command should ever do.
+    if (existsSync(target)) {
+        console.log(yellow(`  agent/channels/${plan.file} already exists — leaving it alone.`));
+    }
+    else {
+        mkdirSync(join(dir, "agent/channels"), { recursive: true });
+        writeFileSync(target, plan.content);
+        console.log(green(`  + agent/channels/${plan.file}`));
+    }
+    if (plan.deps.length) {
+        console.log(bold(`\n  Installing ${plan.deps.join(", ")} …`));
+        run("npm", ["install", ...plan.deps, "--no-audit", "--no-fund"], { cwd: dir, allowFail: true });
+    }
+    for (const item of plan.registryItems) {
+        run("npx", ["eve", "add", item, "--overwrite"], { cwd: dir, allowFail: true });
+    }
+    // Report what was actually written, not what the plan contained. Run twice,
+    // the second run adds nothing and saying otherwise sends someone looking in
+    // .env.example for variables that were already there.
+    const added = appendEnvExample(dir, kind, plan.env);
+    if (added)
+        console.log(green(`  + ${added} line(s) in .env.example`));
+    console.log(bold("\n  Still to do:"));
+    for (const step of plan.steps)
+        console.log(`    · ${step}`);
+    console.log(dim(`\n  Then fill the new values into .env.local and restart:\n` +
+        `    ${host === "exe" ? "bash scripts/eve-server.sh" : "kyb deploy"}`));
+}
+/** The agent's own name, as the rest of the toolchain reads it. */
+function agentNameOf(dir) {
+    const env = join(dir, ".env.local");
+    if (existsSync(env)) {
+        const hit = readFileSync(env, "utf8").match(/^KYBERNESIS_AGENT\s*=\s*"?([^"\n]+)"?/m);
+        if (hit?.[1])
+            return hit[1].trim();
+    }
+    return basename(dir);
+}
+/**
+ * Append the channel's variables, once.
+ *
+ * @remarks
+ * Appended rather than rewritten so a hand-edited example file survives, and
+ * skipped when the key is already present so running the command twice does not
+ * leave two copies of every variable for someone to reconcile later.
+ */
+function appendEnvExample(dir, kind, lines) {
+    const path = join(dir, ".env.example");
+    const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
+    const fresh = lines.filter((line) => {
+        const key = line.split("=")[0]?.trim();
+        return key ? !new RegExp(`^${key}\\s*=`, "m").test(existing) : true;
+    });
+    if (!fresh.length)
+        return 0;
+    writeFileSync(path, `${existing.replace(/\n*$/, "\n")}\n# ${kind}\n${fresh.join("\n")}\n`);
+    return fresh.length;
+}

package/dist/cli.js

@@ -16,6 +16,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { bold, dim, red } from "./util.js";
+import { add } from "./add.js";
 import { init } from "./init.js";
 import { doctor } from "./doctor.js";
 import { upgrade } from "./upgrade.js";
@@ -57,6 +58,7 @@ function initOptions(rest) {
         studio: rest.includes('--studio'),
         channel: flag(rest, "channel"),
         host: flag(rest, "host"),
+        model: flag(rest, "model"),
         subagents: subs === undefined ? undefined : subs.split(',').map((s) => s.trim()).filter(Boolean),
         yes: rest.includes('--yes') || rest.includes('-y'),
     };
@@ -64,6 +66,7 @@ function initOptions(rest) {
 /** What each command is for, in one line, as a person would ask for it. */
 const COMMANDS = {
     init: "Scaffold a new agent: governed, remembering, multiplayer, self-testing.",
+    add: "Add a chat surface to an agent that already exists.",
     doctor: "Check this machine and this project before an engagement.",
     arcana: "Set the memory workspaces and keys this agent uses.",
     skills: "Install the FDE skill suite (--global for every project).",
@@ -110,6 +113,9 @@ switch (command) {
     case "init":
         await init(rest.find((a) => !a.startsWith("-")), initOptions(rest));
         break;
+    case "add":
+        await add(rest.find((a) => !a.startsWith("-")), rest.slice(1));
+        break;
     case "doctor":
         await doctor();
         break;
@@ -182,9 +188,12 @@ ${dim("  npm i -g @kybernesis/create@latest")}
       --channel=<kind>  ${dim("none|slack|imessage|telegram|discord|web  (default: none)")}
       --host=<kind>     ${dim("vercel|exe                                (default: vercel)")}
       --subagents=a,b   ${dim("department subagents                      (default: none)")}
+      --model=<id>      ${dim("provider/model-id                         (default: sonnet 5)")}
       --engineer        ${dim("add the engineer layer: workshop sandbox + vision dev loop")}
       --studio          ${dim("wire for KYBER Studio: local execution + management routes")}
       --yes             ${dim("no prompts; take flags and defaults")}
+  ${bold("kyb add channel <kind>")}
+      ${dim("slack|imessage|telegram|discord|web — writes the channel, deps and env")}
   ${bold("kyb doctor")}          preflight checks (keys, issuer, envs, discovery)
   ${bold("kyb skills")}          install/refresh the FDE skill suite for Claude Code
       --global          ${dim("install to ~/.claude/skills instead of this repo")}

package/dist/init.d.ts

@@ -14,6 +14,18 @@ export interface InitOptions {
     channel?: ChannelKind;
     /** Where the agent runs. Default "vercel". */
     host?: HostKind;
+    /**
+     * The model, as provider/model-id.
+     *
+     * @remarks
+     * Passed straight through to `eve init`, and that is why it exists: without
+     * it eve ends its scaffold by opening its interactive model picker, which
+     * needs a terminal UI. On a laptop that is a prompt; on a headless machine
+     * it is `--input requires the interactive UI` and a scaffold that stops
+     * after step one having already written the project — so `--yes` was never
+     * actually non-interactive.
+     */
+    model?: string;
     /** Department subagents. Default NONE. */
     subagents?: string[];
     /** Skip prompts and take the flags/defaults as given. */

package/dist/init.js

@@ -1,6 +1,6 @@
 import { chmodSync, copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { DEFAULT_ISSUER, EVE_VERSION, REGISTRY_URL, ask, bold, closePrompts, dim, green, run, slug, yellow, } from "./util.js";
+import { DEFAULT_ISSUER, EVE_VERSION, REGISTRY_URL, ask, bold, closePrompts, dim, green, run, slug, red, yellow, } from "./util.js";
 import { CHANNEL_KINDS, channelPlan, engineerPlan, envExample, evalFileTs, exeEvalConfigTs, evalScript, hostAgentTs, hostSteps, identityMd, rootArcanaTs, subagentAgentTs, subagentArcanaTs, subagentInstructionsMd, } from "./templates.js";
 import { suiteDir } from "./skills.js";
 import { configureArcana } from "./arcana.js";
@@ -58,8 +58,26 @@ export async function init(rawName, options = {}) {
         process.exit(1);
     }
     const plan = channelPlan(channel, name, host);
+    const model = options.model ?? DEFAULT_MODEL;
     console.log(bold(`\n1/6  Scaffolding eve agent (eve@${EVE_VERSION}) …`));
-    run("npx", [`eve@${EVE_VERSION}`, "init", name]);
+    // eve's scaffold ends by opening its interactive model picker
+    // (`eve dev --input /model`), which exits non-zero wherever there is no
+    // terminal UI — AFTER the project is fully created and its dependencies
+    // installed. Treating that as a failure makes headless scaffolding
+    // impossible, which is what a machine building itself has to do.
+    //
+    // Nothing is lost by ignoring it: agent.ts is overwritten below with our own
+    // template carrying the chosen model, so eve's pick would not have survived
+    // this function either. `--model` is deliberately NOT passed through — eve
+    // refuses an id it cannot find in the AI Gateway catalog and then creates
+    // nothing at all, and an exe-hosted agent takes its model from EXE_MODEL,
+    // not from the gateway.
+    run("npx", [`eve@${EVE_VERSION}`, "init", name], { allowFail: true });
+    // The real test of that step, since its exit code cannot be trusted.
+    if (!existsSync(join(dir, "package.json"))) {
+        console.error(red(`\n  eve did not create a project in ${dir}. Nothing else can run.`));
+        process.exit(1);
+    }
     console.log(bold("\n2/6  Adding the Kybernesis registry + core packages …"));
     run("npx", ["eve", "registry", "add", `@kybernesis=${REGISTRY_URL}`], { cwd: dir });
     for (const item of CORE_ITEMS) {
@@ -108,7 +126,7 @@ export async function init(rawName, options = {}) {
                 `    This agent cannot be connected to a desktop until they install.`));
         }
     }
-    const engPlan = engineer ? engineerPlan(host, DEFAULT_MODEL) : null;
+    const engPlan = engineer ? engineerPlan(host, model) : null;
     if (engPlan) {
         console.log(bold("\n2c   Engineer subagent: workshop sandbox + vision dev loop …"));
         run("npm", ["install", ...engPlan.deps, "--no-audit", "--no-fund"], { cwd: dir, allowFail: true });
@@ -133,7 +151,7 @@ export async function init(rawName, options = {}) {
         unlinkSync(join(dir, "agent/instructions.md"));
     }
     catch { }
-    writeFileSync(join(dir, "agent/agent.ts"), hostAgentTs(host, DEFAULT_MODEL));
+    writeFileSync(join(dir, "agent/agent.ts"), hostAgentTs(host, model));
     writeFileSync(join(dir, "agent/extensions/arcana.ts"), rootArcanaTs());
     writeFileSync(join(dir, "evals/kybernesis.eval.ts"), evalFileTs(displayName, depts));
     // A self-hosted agent judges through its own integration; the default
@@ -287,7 +305,7 @@ export async function init(rawName, options = {}) {
         }
     }
     console.log(bold("\n5/6  Env template + hermetic eval script …"));
-    writeFileSync(join(dir, ".env.example"), envExample(name, depts, issuer, plan.env, host, DEFAULT_MODEL));
+    writeFileSync(join(dir, ".env.example"), envExample(name, depts, issuer, plan.env, host, model));
     const pkgPath = join(dir, "package.json");
     const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
     pkg.scripts = { ...pkg.scripts, eval: evalScript(name, depts) };

package/dist/templates.js

@@ -85,10 +85,20 @@ export default defineMcpClientConnection({
     "The ${dept} team's long-term memory (Arcana): remember, recall, search, timeline, and brain notes.",
   auth: {
     getToken: async () => {
+      // The eval brain is a DIFFERENT workspace, so it needs its own key —
+      // Arcana keys answer 403 outside the workspace they were minted for.
+      // Recognised by name rather than by suffix: an eval workspace does not
+      // have to be called "<agent>-eval", and matching on the suffix sends a
+      // custom one through the company key, where every memory eval fails with
+      // a 403 that reads as the agent's memory being broken.
+      // Falls back to the old suffix rule when nothing names the eval brain, so
+      // an agent written before this variable existed keeps working untouched.
+      const evalWorkspace = process.env.ARCANA_EVAL_WORKSPACE;
+      const isEval = evalWorkspace
+        ? workspace === evalWorkspace
+        : workspace.endsWith("-eval");
       const token =
-        (workspace.endsWith("-eval")
-          ? process.env.ARCANA_EVAL_API_KEY
-          : undefined) ??
+        (isEval ? process.env.ARCANA_EVAL_API_KEY : undefined) ??
         process.env.ARCANA_${upper}_API_KEY ??
         process.env.ARCANA_API_KEY;
       if (!token) throw new Error("ARCANA_${upper}_API_KEY is not set.");
@@ -117,9 +127,16 @@ if (!COMPANY) {
 }
 const DM = process.env.ARCANA_DM_WORKSPACE ?? COMPANY;
 
+// Same rule as the department connections: the eval brain is named, not
+// guessed from a suffix.
+// Falls back to the old suffix rule when nothing names the eval brain, so an
+// agent written before this variable existed keeps working untouched.
+const EVAL = process.env.ARCANA_EVAL_WORKSPACE;
+const IS_EVAL = EVAL ? COMPANY === EVAL : COMPANY.endsWith("-eval");
+
 export default arcana({
   apiKey:
-    (COMPANY.endsWith("-eval") ? process.env.ARCANA_EVAL_API_KEY : undefined) ??
+    (IS_EVAL ? process.env.ARCANA_EVAL_API_KEY : undefined) ??
     process.env.ARCANA_API_KEY!,
   workspace: COMPANY,
   // DM sessions carry surface:"dm" via @kybernesis/multiplayer.

package/package.json

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