@kybernesis/create 0.13.2 → 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";
@@ -65,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).",
@@ -111,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;
@@ -187,6 +192,8 @@ ${dim("  npm i -g @kybernesis/create@latest")}
       --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/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.2",
+  "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",