@kybernesis/create 0.14.11 → 0.15.1

package/dist/init.js

@@ -142,13 +142,14 @@ export async function init(rawName, options = {}) {
         run("npx", ["eve", "add", item, "--overwrite"], { cwd: dir, allowFail: true });
     }
     if (studio) {
-        // Two separate items on purpose: `local` lets the agent act on the USER'S
+        // Three separate items on purpose: `local` lets the agent act on the USER'S
         // machine (consent per effect, granted on the desktop); `manage` lets a
-        // client change THIS AGENT — its dependencies and its source. Different
-        // blast radius, so an agent can have one without the other.
-        console.log(bold("\n2b2  KYBER Studio: local execution + management routes …"));
+        // client change THIS AGENT — its dependencies and its source; `notify`
+        // lets it reach the person's phone. Different blast radius, so an agent
+        // can have one without the others.
+        console.log(bold("\n2b2  KYBER Studio: local execution + management routes + phone notifications …"));
         const studioFailures = [];
-        for (const item of ["local", "manage"]) {
+        for (const item of ["local", "manage", "notify"]) {
             // The @kybernesis/ prefix is load-bearing: a bare name resolves against
             // eve OWN registry, which has no such item, so both installs failed with
             // "not found" — and allowFail swallowed it. --studio therefore did

package/dist/templates.d.ts

@@ -75,3 +75,8 @@ export declare function exeEvalConfigTs(): string;
 export declare function arcanaMemorySlotTs(options: {
     extensionMounted: boolean;
 }): string;
+/**
+ * The notify mount. One source for `kyb init --studio`, `kyb upgrade` and the
+ * registry item, so the three can never disagree about what the file says.
+ */
+export declare function notifyMountTs(): string;

package/dist/templates.js

@@ -722,3 +722,14 @@ export default defineMemory({
 });
 `;
 }
+/**
+ * The notify mount. One source for `kyb init --studio`, `kyb upgrade` and the
+ * registry item, so the three can never disagree about what the file says.
+ */
+export function notifyMountTs() {
+    return `// Tell the person's phone when this agent parks on a question or finishes a
+// reply while they are away. The person is the verified session principal;
+// the control plane does the ringing. See @kybernesis/notify.
+export { default } from "@kybernesis/notify/extension";
+`;
+}

package/dist/upgrade.d.ts

@@ -1,5 +1,20 @@
 import { type AgentInputLimit } from "./agent-limits.js";
 export declare function agentInputLimitUpgradeMessage(limit: AgentInputLimit): string;
+/**
+ * A Studio agent that cannot ring the person's phone.
+ *
+ * `@kybernesis/notify` arrived after most agents were made, and an upgrade
+ * only ever moved packages an agent already had — so every existing agent
+ * would have stayed silent on the phone, and the first sign would have been
+ * a person waiting for a notification that never came. The agents that need
+ * it are the ones a desktop can manage: anything with `@kybernesis/manage`.
+ *
+ * The pure part — is it needed, is the mount there — is separate from the
+ * npm call so it can be tested without a network.
+ */
+export declare function needsNotify(deps: Record<string, string>): boolean;
+/** Write the notify mount if it is missing. Never touches a file that exists. */
+export declare function repairNotifyMount(cwd: string): "mounted" | "present";
 export type GithubToolsMountRepair = {
     kind: "missing" | "current" | "updated" | "customized";
 } | {

package/dist/upgrade.js

@@ -15,7 +15,7 @@ import { inspectEveAgent } from "./agent-limits.js";
 import { remoteProjectPath, sshTarget } from "./deploy.js";
 import { classifyModelReach } from "./model-reach.js";
 import { checkSelfVersion, versionLt } from "./self-version.js";
-import { LEGACY_GITHUB_TOOLS_MOUNT, githubToolsMountTs } from "./templates.js";
+import { LEGACY_GITHUB_TOOLS_MOUNT, githubToolsMountTs, notifyMountTs } from "./templates.js";
 import { confirmEveUpgrade, inspectBuzzSessions, inspectDurableRuns, reconcileEvalScript, } from "./upgrade-sessions.js";
 export function agentInputLimitUpgradeMessage(limit) {
     switch (limit.kind) {
@@ -165,6 +165,51 @@ function repairBuzzSetup(cwd, deps) {
         console.log(`    ${dim("Takes effect after the next build and restart.")}\n`);
     }
 }
+/**
+ * A Studio agent that cannot ring the person's phone.
+ *
+ * `@kybernesis/notify` arrived after most agents were made, and an upgrade
+ * only ever moved packages an agent already had — so every existing agent
+ * would have stayed silent on the phone, and the first sign would have been
+ * a person waiting for a notification that never came. The agents that need
+ * it are the ones a desktop can manage: anything with `@kybernesis/manage`.
+ *
+ * The pure part — is it needed, is the mount there — is separate from the
+ * npm call so it can be tested without a network.
+ */
+export function needsNotify(deps) {
+    return Boolean(deps["@kybernesis/manage"]) && !deps["@kybernesis/notify"];
+}
+/** Write the notify mount if it is missing. Never touches a file that exists. */
+export function repairNotifyMount(cwd) {
+    const mount = join(cwd, "agent/extensions/notify.ts");
+    if (existsSync(mount))
+        return "present";
+    mkdirSync(join(cwd, "agent/extensions"), { recursive: true });
+    writeFileSync(mount, notifyMountTs());
+    return "mounted";
+}
+function repairNotifySetup(cwd, deps) {
+    if (!deps["@kybernesis/manage"])
+        return;
+    const done = [];
+    if (needsNotify(deps)) {
+        const ok = run("npm", ["install", "@kybernesis/notify@latest", "--no-audit", "--no-fund"], { cwd, allowFail: true, quiet: true });
+        if (!ok) {
+            console.log(`  ${yellow("!")} could not install @kybernesis/notify, so this agent cannot reach the person's phone.\n` +
+                `    Run: npm install @kybernesis/notify@latest && npx kyb upgrade`);
+            return;
+        }
+        deps["@kybernesis/notify"] = "latest";
+        done.push("installed @kybernesis/notify");
+    }
+    if (repairNotifyMount(cwd) === "mounted")
+        done.push("mounted it (agent/extensions/notify.ts)");
+    if (done.length > 0) {
+        console.log(`  ${green("+")} Notify: ${done.join("; ")} ${dim("— the person's phone hears when this agent needs them")}`);
+        console.log(`    ${dim("Takes effect after the next build and restart.")}\n`);
+    }
+}
 /** Quote one argument for the manual shell commands printed after a failed repair. */
 function shellQuote(value) {
     return `'${value.replaceAll("'", `'"'"'`)}'`;
@@ -676,15 +721,6 @@ function startStoppedBridge(cwd, unit) {
 }
 export async function upgrade(options = {}) {
     console.log(bold("\nkyb upgrade — checking @kybernesis/* and eve against npm\n"));
-    const selfVersion = checkSelfVersion();
-    if (selfVersion.kind === "stale") {
-        console.log(`  ${yellow("!")} ${selfVersion.message}`);
-        console.log(`    ${dim(selfVersion.fix)}\n`);
-        if (!options.allowStale) {
-            process.exitCode = 1;
-            return;
-        }
-    }
     const cwd = process.cwd();
     const packagePath = join(cwd, "package.json");
     const pkg = JSON.parse(readFileSync(packagePath, "utf8"));
@@ -692,6 +728,39 @@ export async function upgrade(options = {}) {
         ...(pkg.dependencies ?? {}),
         ...(pkg.devDependencies ?? {}),
     };
+    const selfVersion = checkSelfVersion();
+    if (selfVersion.kind === "stale" && !options.allowStale) {
+        /**
+         * A stale kyb that is the PROJECT's own dependency renews itself.
+         *
+         * On every self-hosted agent, kyb is in package.json and `npx kyb` runs
+         * that copy; a global install — the printed fix until now — changes
+         * nothing there, and the person who followed it was back at the same
+         * message. So when the project owns kyb, install the latest into the
+         * project and run the upgrade again from that copy. The re-run is marked
+         * so that a registry that has not caught up cannot make this loop.
+         */
+        if (deps["@kybernesis/create"] && process.env.KYB_UPGRADE_RENEWED !== "1") {
+            console.log(`  ${yellow("↑")} kyb ${selfVersion.installed} → ${selfVersion.latest} ${dim("(this project's own copy; renewing it first)")}`);
+            const renewed = run("npm", ["install", `@kybernesis/create@${selfVersion.latest}`, "--no-audit", "--no-fund"], { cwd, allowFail: true, quiet: true });
+            const cli = join(cwd, "node_modules/@kybernesis/create/dist/cli.js");
+            if (renewed && existsSync(cli)) {
+                const again = spawnSync(process.execPath, [cli, "upgrade", ...process.argv.slice(3)], {
+                    cwd, stdio: "inherit", env: { ...process.env, KYB_UPGRADE_RENEWED: "1" },
+                });
+                process.exitCode = again.status ?? 1;
+                return;
+            }
+        }
+        console.log(`  ${yellow("!")} ${selfVersion.message}`);
+        console.log(`    ${dim(deps["@kybernesis/create"] ? `npm install @kybernesis/create@latest && npx kyb upgrade` : selfVersion.fix)}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    if (selfVersion.kind === "stale") {
+        console.log(`  ${yellow("!")} ${selfVersion.message}`);
+        console.log(`    ${dim(selfVersion.fix)} ${dim("(continuing: --allow-stale)")}\n`);
+    }
     reportAgentInputLimit(cwd);
     const entries = dependencyEntries(pkg);
     const installedVersions = new Map();
@@ -776,6 +845,7 @@ export async function upgrade(options = {}) {
         reportGithubToolsMountRepair(cwd);
         repairHostArtifacts(cwd, deps);
         repairEvalCommand(cwd);
+        repairNotifySetup(cwd, deps);
         repairManageRestart(cwd, deps);
         return;
     }
@@ -847,6 +917,7 @@ export async function upgrade(options = {}) {
     reportGithubToolsMountRepair(cwd);
     repairHostArtifacts(cwd, deps);
     repairEvalCommand(cwd);
+    repairNotifySetup(cwd, deps);
     repairManageRestart(cwd, deps);
     run("npm", ["run", "typecheck"], { cwd });
     if (eveChanged) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kybernesis/create",
-  "version": "0.14.11",
-  "description": "The Kybernesis agent scaffolder and FDE toolkit: one command to a governed, remembering, multiplayer, self-testing eve agent — plus doctor and upgrade.",
+  "version": "0.15.1",
+  "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",
   "homepage": "https://kybernesis.ai",