@kybernesis/create 0.9.0 → 0.10.0

package/dist/cli.js

@@ -19,6 +19,7 @@ import { bold, dim, red } from "./util.js";
 import { init } from "./init.js";
 import { doctor } from "./doctor.js";
 import { upgrade } from "./upgrade.js";
+import { tui } from "./tui.js";
 import { installSkills } from "./skills.js";
 import { deploy } from "./deploy.js";
 import { register } from "./register.js";
@@ -70,6 +71,7 @@ const COMMANDS = {
     register: "Register this agent with the control plane (--name, --url).",
     deploy: "Deploy this agent to its host (--no-env to leave the env file alone).",
     upgrade: "Bring @kybernesis packages and eve to the certified versions (--skip-eval).",
+    tui: "Talk to your agents in the terminal.",
     version: "Print the version of this tool.",
 };
 /**
@@ -132,6 +134,9 @@ switch (command) {
     case "deploy":
         await deploy({ host: flag(rest, "host"), noEnv: rest.includes("--no-env") });
         break;
+    case "tui":
+        tui(rest);
+        break;
     case "upgrade":
         await upgrade(rest.includes("--skip-eval"));
         break;

package/dist/tui.d.ts

@@ -0,0 +1 @@
+export declare function tui(args: string[]): void;

package/dist/tui.js

@@ -0,0 +1,48 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, join } from "node:path";
+import { bold, dim, yellow } from "./util.js";
+/**
+ * Hand the terminal to the TUI.
+ *
+ * @remarks
+ * The TUI is a compiled binary rather than part of this package, so this
+ * command's whole job is finding it and getting out of the way. `stdio:
+ * "inherit"` is the load-bearing part: a full-screen app needs the real
+ * terminal, not a pipe, and anything that buffers its output turns it into
+ * garbage on the way through.
+ *
+ * The search order is deliberate. PATH first, so a version someone installed
+ * on purpose wins; then the two places it actually lands — cargo's bin, and a
+ * checkout's release build — because "command not found" is a useless answer
+ * when the binary is sitting in one of two well-known directories.
+ */
+const BINARY = "kyb-tui";
+function candidates() {
+    const onPath = (process.env.PATH ?? "")
+        .split(delimiter)
+        .filter(Boolean)
+        .map((dir) => join(dir, BINARY));
+    return [
+        ...onPath,
+        join(homedir(), ".cargo", "bin", BINARY),
+        join(homedir(), "kyb-tui", "target", "release", BINARY),
+    ];
+}
+export function tui(args) {
+    const binary = candidates().find((path) => existsSync(path));
+    if (!binary) {
+        console.log(`\n  ${yellow("The terminal app is not installed on this machine.")}\n`);
+        console.log(`  ${bold("cargo install --path .")}  ${dim("from the kyb-tui checkout")}\n`);
+        process.exit(1);
+    }
+    const result = spawnSync(binary, args, { stdio: "inherit" });
+    // Exit with what it exited with: a wrapper that always reports success makes
+    // the thing it wraps untestable from a script.
+    if (result.error) {
+        console.error(`\n  Could not start the terminal app: ${result.error.message}\n`);
+        process.exit(1);
+    }
+    process.exit(result.status ?? 0);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybernesis/create",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "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",