@metaphi-ai/hum 0.1.74 → 0.1.76

package/bin/hum.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-// `hum` from npm: the Ink front-end, which starts Hum's engine (Python, installed by postinstall
+// `hum` from npm: the Ink front-end, which starts Hum's core (Python, installed by postinstall
 // via uv) and talks to it over localhost. Everything the person sees is here; everything the
-// session records is in the engine.
+// session records is in the core.
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import path from 'node:path';
 const here = path.dirname(fileURLToPath(import.meta.url));

package/dist/cli.mjs

@@ -83195,7 +83195,7 @@ import fs2 from "node:fs";
 import os3 from "node:os";
 import path from "node:path";
 function importedVersion(env3 = process.env, runImpl = run) {
-  const r = runImpl(enginePython(env3), ASK_VERSION);
+  const r = runImpl(corePython(env3), ASK_VERSION);
   return r && r.status === 0 ? String(r.stdout).trim() : null;
 }
 function installedVersion(env3 = process.env, runImpl = run) {
@@ -83203,7 +83203,7 @@ function installedVersion(env3 = process.env, runImpl = run) {
     return fs2.readFileSync(stampPath(env3), "utf8").trim() || null;
   } catch {
   }
-  if (!fs2.existsSync(enginePython(env3))) return null;
+  if (!fs2.existsSync(corePython(env3))) return null;
   const v = importedVersion(env3, runImpl);
   if (v) {
     try {
@@ -83221,28 +83221,28 @@ function trustedPython(env3 = process.env, runImpl = run) {
   return /^[a-z]:\\.+\\python(w)?\.exe$/i.test(p) ? p : null;
 }
 function sslBlocked(env3 = process.env, runImpl = run) {
-  const r = runImpl(enginePython(env3), ASK_SSL);
+  const r = runImpl(corePython(env3), ASK_SSL);
   if (r && r.status === 0) return null;
   const text = String(r && (r.stderr || r.stdout) || "ssl did not import").trim().split(/\r?\n/).filter(Boolean).pop() || "ssl did not import";
   return text;
 }
 function needsInstall(version, { env: env3 = process.env, installed = () => installedVersion(env3), now = Date.now(), state = readInstallState(env3) } = {}) {
-  if (!version || env3.HUM_ENGINE || env3.HUM_ENGINE_PORT) return false;
+  if (!version || env3.HUM_CORE || env3.HUM_CORE_PORT) return false;
   if (installed() === version) return false;
   if (state && !state.ok && state.version === version && now - (state.at || 0) < 10 * 60 * 1e3) return false;
   return true;
 }
-function installEngine(version, { env: env3 = process.env, say = (m) => console.log(`hum: ${m}`), runImpl = run, now = Date.now() } = {}) {
+function installCore(version, { env: env3 = process.env, say = (m) => console.log(`hum: ${m}`), runImpl = run, now = Date.now() } = {}) {
   const home = humHome(env3);
-  const dir = engineDir(env3);
-  const python = enginePython(env3);
+  const dir = coreDir(env3);
+  const python = corePython(env3);
   const localBin = path.join(os3.homedir(), ".local", "bin");
   const uvNames = ["uv", path.join(localBin, win ? "uv.exe" : "uv")];
   const uv = () => uvNames.find((u) => {
     const r = runImpl(u, ["--version"]);
     return r && r.status === 0;
   });
-  const spec = env3.HUM_ENGINE_SPEC || `hum-cli==${version}`;
+  const spec = env3.HUM_CORE_SPEC || `hum-cli==${version}`;
   const outcome = (ok, error = null, got = version) => {
     writeInstallState({ version: got, wanted: version, ok, error, at: now }, env3);
     return { ok, version: got, error };
@@ -83255,7 +83255,7 @@ function installEngine(version, { env: env3 = process.env, say = (m) => console.
       u = r && r.status === 0 ? uv() : null;
       if (!u) return outcome(false, `could not install uv; install it from https://astral.sh/uv and run:  ${npmFix(version)}`);
     }
-    say(`installing ${env3.HUM_ENGINE_SPEC ? spec : `hum ${version}`} into ${dir} \u2026`);
+    say(`installing ${env3.HUM_CORE_SPEC ? spec : `hum ${version}`} into ${dir} \u2026`);
     fs2.mkdirSync(home, { recursive: true });
     try {
       fs2.unlinkSync(stampPath(env3));
@@ -83268,7 +83268,7 @@ function installEngine(version, { env: env3 = process.env, say = (m) => console.
     if (!pipIn()) return outcome(false, `uv pip install ${spec} failed`);
     let got = importedVersion(env3, runImpl);
     if (!got) return outcome(false, "hum did not import after the install");
-    if (got !== version && !env3.HUM_ENGINE_SPEC) return outcome(false, `installed ${got}, wanted ${version}`, got);
+    if (got !== version && !env3.HUM_CORE_SPEC) return outcome(false, `installed ${got}, wanted ${version}`, got);
     let blocked = sslBlocked(env3, runImpl);
     if (blocked && trusted) {
       say(`the policy here refuses the environment's OpenSSL (${blocked}); rebuilding it on ${trusted} \u2026`);
@@ -83292,21 +83292,21 @@ function installEngine(version, { env: env3 = process.env, say = (m) => console.
     return outcome(false, e && e.message ? e.message : String(e));
   }
 }
-var win, npmFix, NPM_FIX, humHome, engineDir, enginePython, stampPath, statePath, run, ASK_VERSION, ASK_SSL, sslAdvice, readInstallState, writeInstallState;
+var win, npmFix, NPM_FIX, humHome, coreDir, corePython, stampPath, statePath, run, ASK_VERSION, ASK_SSL, sslAdvice, readInstallState, writeInstallState;
 var init_install = __esm({
   "src/install.js"() {
     win = process.platform === "win32";
     npmFix = (version = "") => `npm i -g @metaphi-ai/hum@${version || "latest"} --foreground-scripts`;
     NPM_FIX = npmFix("latest");
     humHome = (env3 = process.env) => env3.HUM_HOME || path.join(os3.homedir(), ".hum");
-    engineDir = (env3 = process.env) => path.join(humHome(env3), "engine");
-    enginePython = (env3 = process.env) => win ? path.join(engineDir(env3), "Scripts", "python.exe") : path.join(engineDir(env3), "bin", "python");
-    stampPath = (env3) => path.join(engineDir(env3), "version");
-    statePath = (env3) => path.join(humHome(env3), "engine-install.json");
+    coreDir = (env3 = process.env) => path.join(humHome(env3), "core");
+    corePython = (env3 = process.env) => win ? path.join(coreDir(env3), "Scripts", "python.exe") : path.join(coreDir(env3), "bin", "python");
+    stampPath = (env3) => path.join(coreDir(env3), "version");
+    statePath = (env3) => path.join(humHome(env3), "core-install.json");
     run = (cmd, args2, opts = {}) => spawnSync(cmd, args2, { encoding: "utf8", windowsHide: true, ...opts });
     ASK_VERSION = ["-I", "-c", "import hum; print(hum.__version__)"];
     ASK_SSL = ["-I", "-c", "import ssl"];
-    sslAdvice = (env3, version) => `the machine's application control blocked Python's OpenSSL DLL in ${engineDir(env3)}; install Python 3.12 from python.org (Microsoft signs it), then run  ${npmFix(version)}`;
+    sslAdvice = (env3, version) => `the machine's application control blocked Python's OpenSSL DLL in ${coreDir(env3)}; install Python 3.12 from python.org (Microsoft signs it), then run  ${npmFix(version)}`;
     readInstallState = (env3 = process.env) => {
       try {
         return JSON.parse(fs2.readFileSync(statePath(env3), "utf8"));
@@ -83342,7 +83342,7 @@ async function latestVersion(fetchImpl = globalThis.fetch, env3 = process.env) {
 }
 function installLayout(execPath = process.execPath, env3 = process.env) {
   const exe = String(execPath).split(/[\\/]/).pop();
-  if (/^(node|bun)(\.exe)?$/i.test(exe)) return { kind: env3.HUM_ENGINE_PORT ? "python" : "npm" };
+  if (/^(node|bun)(\.exe)?$/i.test(exe)) return { kind: env3.HUM_CORE_PORT ? "python" : "npm" };
   let real = execPath;
   try {
     real = fs3.realpathSync(execPath);
@@ -83395,7 +83395,7 @@ function startBackgroundUpdate(version, { env: env3 = process.env, now = Date.no
 function mismatchLine(mine, running, { env: env3 = process.env, layout: layout2 = installLayout(process.execPath, env3), state = readInstallState(env3) } = {}) {
   if (!mine || !running || mine === running) return "";
   const head = `hum ${mine} is installed but ${running} is what runs`;
-  if (env3.HUM_ENGINE) return `${head}: HUM_ENGINE points at it \xB7 unset HUM_ENGINE to use ${mine}`;
+  if (env3.HUM_CORE) return `${head}: HUM_CORE points at it \xB7 unset HUM_CORE to use ${mine}`;
   const fix = layout2.kind === "npm" ? npmFix(mine) : updateCommand(layout2);
   if (state && !state.ok && state.wanted === mine && state.error) return `${head}: the update did not finish (${state.error}) \xB7 ${fix}`;
   return `${head} \xB7 ${fix}`;
@@ -83484,7 +83484,7 @@ var init_update = __esm({
   }
 });
 
-// src/engine.js
+// src/core.js
 import fs4 from "node:fs";
 import net from "node:net";
 import os5 from "node:os";
@@ -83511,57 +83511,57 @@ function uvToolDirs() {
   }
   return dirs;
 }
-function enginePython2(dirs = uvToolDirs()) {
+function corePython2(dirs = uvToolDirs()) {
   for (const dir of dirs) for (const name of ["hum-cli", "hum"]) {
     const py = win3 ? path3.join(dir, name, "Scripts", "python.exe") : path3.join(dir, name, "bin", "python");
     if (exists(py)) return py;
   }
   return null;
 }
-function siblingEngine(execPath = process.execPath) {
+function siblingCore(execPath = process.execPath) {
   let dir;
   try {
     dir = path3.dirname(fs4.realpathSync(execPath));
   } catch {
     return null;
   }
-  const p = path3.join(dir, "engine", win3 ? "hum-engine.exe" : "hum-engine");
+  const p = path3.join(dir, "core", win3 ? "hum-core.exe" : "hum-core");
   return exists(p) ? p : null;
 }
-function homeEngine(env3 = process.env) {
+function homeCore(env3 = process.env) {
   const home = env3.HUM_HOME || path3.join(os5.homedir(), ".hum");
-  const py = win3 ? path3.join(home, "engine", "Scripts", "python.exe") : path3.join(home, "engine", "bin", "python");
+  const py = win3 ? path3.join(home, "core", "Scripts", "python.exe") : path3.join(home, "core", "bin", "python");
   return exists(py) ? py : null;
 }
-function engineCandidates(env3 = process.env) {
+function coreCandidates(env3 = process.env) {
   const out = [];
-  if (env3.HUM_ENGINE) {
-    const [bin, ...args2] = env3.HUM_ENGINE.split(" ");
-    out.push({ bin, args: args2, where: "HUM_ENGINE" });
-  }
-  const sib = siblingEngine();
-  if (sib) out.push({ bin: sib, args: ["engine"], where: "beside hum" });
-  const home = homeEngine(env3);
-  if (home) out.push({ bin: home, args: ["-m", "hum.cli", "engine"], where: "HUM_HOME/engine" });
-  const py = enginePython2();
-  if (py) out.push({ bin: py, args: ["-m", "hum.cli", "engine"], where: "the interpreter beside it" });
-  out.push({ bin: "hum-engine", args: [], where: "PATH" });
-  out.push({ bin: path3.join(os5.homedir(), ".local", "bin", win3 ? "hum-engine.exe" : "hum-engine"), args: [], where: "uv's bin dir" });
+  if (env3.HUM_CORE) {
+    const [bin, ...args2] = env3.HUM_CORE.split(" ");
+    out.push({ bin, args: args2, where: "HUM_CORE" });
+  }
+  const sib = siblingCore();
+  if (sib) out.push({ bin: sib, args: ["core"], where: "beside hum" });
+  const home = homeCore(env3);
+  if (home) out.push({ bin: home, args: ["-m", "hum.cli", "core"], where: "HUM_HOME/core" });
+  const py = corePython2();
+  if (py) out.push({ bin: py, args: ["-m", "hum.cli", "core"], where: "the interpreter beside it" });
+  out.push({ bin: "hum-core", args: [], where: "PATH" });
+  out.push({ bin: path3.join(os5.homedir(), ".local", "bin", win3 ? "hum-core.exe" : "hum-core"), args: [], where: "uv's bin dir" });
   return out;
 }
 function wantsPlain(argv, env3 = process.env) {
   return argv.includes("--plain") || !!env3.HUM_PLAIN;
 }
-function engineCommand(argv, candidates = engineCandidates()) {
+function coreCommand(argv, candidates = coreCandidates()) {
   for (const c of candidates) {
-    if (c.args[c.args.length - 1] !== "engine") continue;
+    if (c.args[c.args.length - 1] !== "core") continue;
     return { bin: c.bin, args: [...c.args.slice(0, -1), ...argv], where: c.where };
   }
   return null;
 }
 function candidateVersion(c, { env: env3 = process.env, runImpl = spawnSync3 } = {}) {
   if (!c || !c.bin) return null;
-  if (c.where === "HUM_HOME/engine") return installedVersion(env3);
+  if (c.where === "HUM_HOME/core") return installedVersion(env3);
   const interp = c.args.length >= 3 && c.args[c.args.length - 3] === "-m" && c.args[c.args.length - 2] === "hum.cli";
   let r;
   try {
@@ -83573,18 +83573,18 @@ function candidateVersion(c, { env: env3 = process.env, runImpl = spawnSync3 } =
   const m = String(r.stdout || "").match(/(\d+\.\d+\.\d+)/);
   return m ? m[1] : null;
 }
-function runningVersion(candidates = engineCandidates(), opts = {}) {
+function runningVersion(candidates = coreCandidates(), opts = {}) {
   for (const c of candidates) {
     const v = candidateVersion(c, opts);
     if (v) return { version: v, where: c.where };
   }
   return null;
 }
-function startFailure(failures, { npm = /^(node|bun)(\.exe)?$/i.test(String(process.execPath).split(/[\\/]/).pop()), platform: platform2 = process.platform, version = true ? "0.1.74" : "" } = {}) {
+function startFailure(failures, { npm = /^(node|bun)(\.exe)?$/i.test(String(process.execPath).split(/[\\/]/).pop()), platform: platform2 = process.platform, version = true ? "0.1.76" : "" } = {}) {
   const refused = failures.find((f) => f.error && f.error.code !== "ENOENT");
   const fix = npm ? npmFix(version) : updateCommand({ kind: "native" }, platform2);
   if (!refused) {
-    return `Hum is not fully installed here \u2014 the half that does the work is missing. Run:  ${fix}   (or set HUM_ENGINE to the command that runs it)`;
+    return `Hum is not fully installed here \u2014 the half that does the work is missing. Run:  ${fix}   (or set HUM_CORE to the command that runs it)`;
   }
   const what = refused.error.code || refused.error.message;
   const lines = [
@@ -83594,9 +83594,9 @@ function startFailure(failures, { npm = /^(node|bun)(\.exe)?$/i.test(String(proc
     lines.push("On a managed Windows machine that is usually Device Guard / WDAC refusing an executable it does not know.");
     lines.push(`To see the policy's own message, run:  "${refused.bin}" --help`);
     const dir = uvToolDirs()[0];
-    lines.push(`If uv's environment is elsewhere, point Hum at its interpreter:  set HUM_ENGINE=${path3.join(dir || "<uv tool dir>", "hum-cli", "Scripts", "python.exe")} -m hum.cli engine`);
+    lines.push(`If uv's environment is elsewhere, point Hum at its interpreter:  set HUM_CORE=${path3.join(dir || "<uv tool dir>", "hum-cli", "Scripts", "python.exe")} -m hum.cli core`);
   } else {
-    lines.push('Set HUM_ENGINE to a command that starts it, e.g.  HUM_ENGINE="python -m hum.cli engine"');
+    lines.push('Set HUM_CORE to a command that starts it, e.g.  HUM_CORE="python -m hum.cli core"');
   }
   return lines.join("\n");
 }
@@ -83671,7 +83671,7 @@ function diedMessage(logPath, text = null) {
 ${tail2}` : ""}
 (its log: ${logPath})`;
 }
-async function spawnEngine(cwd2, { task = null, images = [], resume = null, candidates = engineCandidates() } = {}) {
+async function spawnCore(cwd2, { task = null, images = [], resume = null, candidates = coreCandidates() } = {}) {
   const failures = [];
   for (const cand of candidates) {
     if (!cand.bin) continue;
@@ -83690,9 +83690,9 @@ async function spawnEngine(cwd2, { task = null, images = [], resume = null, cand
   }
   throw new EngineError(startFailure(failures));
 }
-var runDir, readRun, EngineError, win3, exists, Engine;
-var init_engine = __esm({
-  "src/engine.js"() {
+var runDir, readRun, EngineError, win3, exists, Core;
+var init_core = __esm({
+  "src/core.js"() {
     init_install();
     init_update();
     runDir = () => path3.join(process.env.HUM_HOME || path3.join(os5.homedir(), ".hum"), "run");
@@ -83714,16 +83714,16 @@ var init_engine = __esm({
         return false;
       }
     };
-    Engine = class {
+    Core = class {
       constructor(port2, token2 = "") {
         this.port = port2;
         this.token = token2;
         this.handlers = [];
         this.closed = false;
       }
-      // This front-end has a person at it: it says so on connecting, and the engine counts it as
+      // This front-end has a person at it: it says so on connecting, and the core counts it as
       // one. Only a human front-end makes the session attended. The same line carries the run's
-      // token, which the engine reads before it says anything back.
+      // token, which the core reads before it says anything back.
       connect() {
         return new Promise((resolve, reject) => {
           const sock = net.createConnection({ host: "127.0.0.1", port: this.port }, () => {
@@ -83761,7 +83761,7 @@ var init_engine = __esm({
           });
         });
       }
-      // Attach to another engine (a session running elsewhere on this machine): its token comes
+      // Attach to another core (a session running elsewhere on this machine): its token comes
       // from its run file, the old socket is dropped quietly, the new one greets us with hello
       // and a replay.
       async reconnect(port2, token2 = "") {
@@ -83936,9 +83936,9 @@ function replayLines(items, n = 20) {
   }
   return out.slice(-n);
 }
-async function peekSession(row, ready, make = (port2, token2) => new Engine(port2, token2)) {
+async function peekSession(row, ready, make = (port2, token2) => new Core(port2, token2)) {
   const token2 = (readRun(row.run_id) || {}).token || "";
-  const engine2 = make(row.port, token2);
+  const core2 = make(row.port, token2);
   let timer = null;
   let done = false;
   let replay = [];
@@ -83948,26 +83948,26 @@ async function peekSession(row, ready, make = (port2, token2) => new Engine(port
     clearTimeout(timer);
     ready({ question, lines: replayLines(replay) });
   };
-  engine2.on((ev) => {
+  core2.on((ev) => {
     if (ev.type === "replay") {
       replay = ev.items || [];
       timer = setTimeout(() => settle(null), PEEK_SETTLE_MS);
     } else if (ev.type === "question") settle(asked(ev));
     else if (ev.type === "bye") settle(null);
   });
-  await engine2.connect();
+  await core2.connect();
   return {
-    answer: (id, text) => engine2.send({ cmd: "answer", id, text }),
+    answer: (id, text) => core2.send({ cmd: "answer", id, text }),
     close: () => {
       clearTimeout(timer);
-      engine2.close();
+      core2.close();
     }
   };
 }
 var firstLine, rank, needCount, stateText, fmtCost, PEEK_SETTLE_MS, asked;
 var init_agents = __esm({
   "src/agents.js"() {
-    init_engine();
+    init_core();
     firstLine = (s) => (s || "").trim().split("\n")[0] || "";
     rank = (r) => r.needs ? 0 : r.state === "busy" ? 1 : 2;
     needCount = (rows, mine) => rows.filter((r) => r.needs && r.run_id !== mine).length;
@@ -84934,7 +84934,7 @@ function jsonError(text, e) {
   return `line ${line}: ${msg.replace(/ in JSON.*$/, "")}`;
 }
 function onPath(env3, { platform: platform2 = process.platform } = {}) {
-  const names = isWin(platform2) ? ["hum.cmd", "hum.exe", "hum", "hum-engine.exe", "hum-engine.cmd"] : ["hum", "hum-engine"];
+  const names = isWin(platform2) ? ["hum.cmd", "hum.exe", "hum", "hum-core.exe", "hum-core.cmd"] : ["hum", "hum-core"];
   const seen = /* @__PURE__ */ new Set();
   const hits = [];
   for (const dir of String(env3.PATH || env3.Path || "").split(path6.delimiter).filter(Boolean)) {
@@ -84955,7 +84955,7 @@ async function diagnose({
   homedir = os7.homedir(),
   cwd: cwd2 = process.cwd(),
   layout: layout2 = installLayout(execPath, env3),
-  candidates = engineCandidates(env3),
+  candidates = coreCandidates(env3),
   runImpl = spawnSync4,
   fetchImpl = globalThis.fetch
 } = {}) {
@@ -84976,8 +84976,8 @@ async function diagnose({
       }
     }
     const hits = onPath(env3, { platform: platform2 });
-    const hums = hits.filter((h) => !h.name.startsWith("hum-engine"));
-    const stale = hits.filter((h) => h.name.startsWith("hum-engine"));
+    const hums = hits.filter((h) => !h.name.startsWith("hum-core"));
+    const stale = hits.filter((h) => h.name.startsWith("hum-core"));
     const targets = new Set(hums.map((h) => h.real));
     if (hums.length === 0) checks.push(check("warn", "no hum on PATH: a new terminal may not find it", layout2.kind === "native" ? isWin(platform2) ? "open a new terminal" : 'export PATH="$HOME/.local/bin:$PATH"' : "npm bin -g, and put that directory on PATH"));
     else if (targets.size > 1) checks.push(check("warn", `more than one hum on PATH; the first wins: ${hums.map((h) => h.path).join(" \xB7 ")}`, "remove the ones you did not mean to keep"));
@@ -84988,7 +84988,7 @@ async function diagnose({
   let running = null;
   {
     const checks = [];
-    if (env3.HUM_ENGINE_PORT) checks.push(check("ok", `started by Python for this hum (HUM_ENGINE_PORT=${env3.HUM_ENGINE_PORT})`));
+    if (env3.HUM_CORE_PORT) checks.push(check("ok", `started by Python for this hum (HUM_CORE_PORT=${env3.HUM_CORE_PORT})`));
     for (const c of candidates) {
       const v = candidateVersion(c, { env: env3, runImpl });
       if (v) {
@@ -84998,7 +84998,7 @@ async function diagnose({
     }
     if (!running) checks.push(check("fail", "nothing answers: the part of hum that does the work is missing", layout2.kind === "npm" ? npmFix2(mine) : updateCommand(layout2, platform2)));
     else if (running.version === mine) checks.push(check("ok", `${running.version} runs from ${running.where} (${running.bin})`));
-    else if (env3.HUM_ENGINE) checks.push(check("fail", `${running.version} is what runs: HUM_ENGINE points at it (${env3.HUM_ENGINE}); you installed ${mine}`, "unset HUM_ENGINE"));
+    else if (env3.HUM_CORE) checks.push(check("fail", `${running.version} is what runs: HUM_CORE points at it (${env3.HUM_CORE}); you installed ${mine}`, "unset HUM_CORE"));
     else checks.push(check("fail", `${running.version} is what runs (${running.where}: ${running.bin}); you installed ${mine}`, layout2.kind === "npm" ? npmFix2(mine) : updateCommand(layout2, platform2)));
     if (running && running.args.includes("-m")) {
       const r = runImpl(running.bin, ["-I", "-c", "import ssl"], { encoding: "utf8", windowsHide: true, timeout: 2e4 });
@@ -85012,16 +85012,16 @@ async function diagnose({
         ));
       }
     }
-    if (env3.HUM_ENGINE && running && running.version === mine) checks.push(check("warn", `HUM_ENGINE is set (${env3.HUM_ENGINE}): it decides what runs, ahead of any install`, "unset HUM_ENGINE"));
+    if (env3.HUM_CORE && running && running.version === mine) checks.push(check("warn", `HUM_CORE is set (${env3.HUM_CORE}): it decides what runs, ahead of any install`, "unset HUM_CORE"));
     if (layout2.kind === "npm") {
       const st = readInstallState(env3);
       const stamp = installedVersion(env3, runImpl);
       if (st && !st.ok) checks.push(check(stamp === mine ? "warn" : "fail", `the last install attempt (wanted ${st.wanted || st.version}) did not finish: ${st.error}`, npmFix2(mine)));
-      else if (!stamp) checks.push(check("fail", `nothing installed under ${engineDir(env3)}`, npmFix2(mine)));
-      else checks.push(check(stamp === mine ? "ok" : "warn", `${engineDir(env3)} holds ${stamp}`, stamp === mine ? "" : npmFix2(mine)));
+      else if (!stamp) checks.push(check("fail", `nothing installed under ${coreDir(env3)}`, npmFix2(mine)));
+      else checks.push(check(stamp === mine ? "ok" : "warn", `${coreDir(env3)} holds ${stamp}`, stamp === mine ? "" : npmFix2(mine)));
     }
     if (layout2.kind === "native") {
-      const sib = path6.join(layout2.dir, "engine", isWin(platform2) ? "hum-engine.exe" : "hum-engine");
+      const sib = path6.join(layout2.dir, "core", isWin(platform2) ? "hum-core.exe" : "hum-core");
       checks.push(exists2(sib) ? check("ok", `the working half is beside hum: ${sib}`) : check("fail", `nothing beside hum at ${sib}: the install is incomplete`, updateCommand(layout2, platform2)));
     }
     sections.push({ key: "runtime", title: "The part of hum that does the work", checks });
@@ -85043,7 +85043,7 @@ async function diagnose({
     else if (latest) checks.push(check("ok", `${mine} is the latest release`));
     sections.push({ key: "updates", title: "Updates", checks });
   }
-  const interp = running && running.args.length >= 3 && running.args[running.args.length - 2] === "hum.cli" ? running.bin : exists2(enginePython(env3)) ? enginePython(env3) : null;
+  const interp = running && running.args.length >= 3 && running.args[running.args.length - 2] === "hum.cli" ? running.bin : exists2(corePython(env3)) ? corePython(env3) : null;
   let toolServers = null;
   {
     const checks = [];
@@ -85070,7 +85070,7 @@ async function diagnose({
         toolServers = parsed.mcp;
       }
     }
-    for (const f of [path6.join(home, "hooks.json"), path6.join(cwd2, ".hum", "hooks.json"), path6.join(home, "autonomy.json"), path6.join(home, "update.json"), path6.join(home, "engine-install.json")]) {
+    for (const f of [path6.join(home, "hooks.json"), path6.join(cwd2, ".hum", "hooks.json"), path6.join(home, "autonomy.json"), path6.join(home, "update.json"), path6.join(home, "core-install.json")]) {
       if (!exists2(f)) continue;
       const text = fs7.readFileSync(f, "utf8");
       try {
@@ -85148,7 +85148,7 @@ async function doctor({ json = false, mine, write = (t) => process.stdout.write(
 var isWin, npmFix2, exists2, realpath, tail, check, PARSE_CONFIG, MARK;
 var init_doctor = __esm({
   "src/doctor.js"() {
-    init_engine();
+    init_core();
     init_install();
     init_update();
     isWin = (platform2) => platform2 === "win32";
@@ -85453,7 +85453,7 @@ function bannerLines(ev, homeRel2 = (p) => p, mine = "") {
 
 // src/app.jsx
 init_update();
-init_engine();
+init_core();
 init_agents();
 
 // src/input.jsx
@@ -85599,7 +85599,7 @@ var input_default = MultilineInput;
 
 // src/app.jsx
 var import_jsx_runtime2 = __toESM(require_jsx_runtime(), 1);
-var MINE = true ? "0.1.74" : "";
+var MINE = true ? "0.1.76" : "";
 var fmtDur = (s) => s < 60 ? `${Math.max(1, Math.round(s))}s` : `${Math.floor(s / 60)}m ${Math.round(s % 60)}s`;
 var plural = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
 var firstResp = (e) => e.first_response_s ? ` \xB7 first response ${e.first_response_s.toFixed(1)}s` : "";
@@ -85686,7 +85686,7 @@ var COMMANDS = [
   { name: "/goal", desc: "the goal the session keeps working toward on its own, exchange after exchange, until the model marks it complete or blocked (/goal <objective>; /goal pause \xB7 resume \xB7 clear; /goal alone shows where it stands)" },
   { name: "/image", desc: "attach an image file to your next message (/image <path>); ctrl+v pastes a screenshot" },
   { name: "/mcp", desc: "the MCP servers in this session \u2014 what each mounted, and any that did not" },
-  { name: "/comms", desc: "the channels in the loop on this session (Slack), and whether you are paired" },
+  { name: "/slack", desc: "this session's Slack thread \u2014 opened now in the declared channel when it has none \u2014 and whether you are paired" },
   { name: "/tools", desc: "the tools the model has, and the sandbox they run in" },
   { name: "/hooks", desc: "the lifecycle hooks in scope (~/.hum/hooks.json, <repo>/.hum/hooks.json; Claude Code and Codex hook files too)" },
   { name: "/permissions", desc: "the rules in force here \u2014 what runs without asking, what is refused, and where each rule came from" },
@@ -85723,7 +85723,7 @@ var tallyLine = (tally) => Object.entries(tally).map(([name, t]) => {
   const parts = [t.ok ? `${t.ok} ok` : null, t.failed ? `${t.failed} failed` : null, t.error ? `${t.error} error` : null].filter(Boolean);
   return `${short} ${parts.join(" \xB7 ")}`;
 }).join("   ");
-function App2({ engine: engine2, task, resume, images = [], peek = peekSession, update = updateNotice, watch = watchReady }) {
+function App2({ core: core2, task, resume, images = [], peek = peekSession, update = updateNotice, watch = watchReady }) {
   const { exit } = use_app_default();
   const { stdout } = use_stdout_default();
   const width = (stdout?.columns || 80) - 2;
@@ -85981,17 +85981,17 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
         if (startedRef.current) break;
         startedRef.current = true;
         if (ev.session) {
-          if (resume === "pick") engine2.send({ cmd: "sessions" });
+          if (resume === "pick") core2.send({ cmd: "sessions" });
         } else if (task) {
           if (images.length && !ev.images) append({ kind: "warn", text: "this version of hum does not take images; update hum" });
-          engine2.send({ cmd: "start", task, images: ev.images ? images : [] });
+          core2.send({ cmd: "start", task, images: ev.images ? images : [] });
         } else if (resume === "pick") {
           setPhaseBoth("idle");
-          engine2.send({ cmd: "sessions" });
-        } else if (resume) engine2.send({ cmd: "resume", name: resume });
+          core2.send({ cmd: "sessions" });
+        } else if (resume) core2.send({ cmd: "resume", name: resume });
         else {
           setPhaseBoth("idle");
-          if (ev.images) images.forEach((p) => engine2.send({ cmd: "attach", path: p }));
+          if (ev.images) images.forEach((p) => core2.send({ cmd: "attach", path: p }));
           else if (images.length) append({ kind: "warn", text: "this version of hum does not take images; update hum" });
         }
         break;
@@ -86314,7 +86314,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     }
   };
   (0, import_react24.useEffect)(() => {
-    engine2.on(handle);
+    core2.on(handle);
   }, []);
   (0, import_react24.useEffect)(() => {
     const mine = hello && hello.run_id;
@@ -86342,14 +86342,14 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     if (phaseRef.current === "dead") return;
     const busy = phaseRef.current === "busy";
     append({ kind: "info", text: !session ? "bye" : busy ? "still working \xB7 `hum resume` brings you back" : `saved \xB7 \`hum resume\` brings you back` });
-    engine2.send({ cmd: "quit" });
+    core2.send({ cmd: "quit" });
     setPhaseBoth("dead");
     setTimeout(() => exit(), 400);
   };
   const stop = () => {
     if (phaseRef.current === "dead") return;
     append({ kind: "info", text: session ? `stopped \xB7 saved \xB7 hum resume ${shortSession(session)}` : "stopped" });
-    engine2.send({ cmd: "stop" });
+    core2.send({ cmd: "stop" });
     setTimeout(() => {
       setPhaseBoth("dead");
       exit();
@@ -86363,7 +86363,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
       }
       setCtrlc(1);
       setTimeout(() => setCtrlc(0), 1500);
-      if (phaseRef.current === "busy") engine2.send({ cmd: "interrupt" });
+      if (phaseRef.current === "busy") core2.send({ cmd: "interrupt" });
       return;
     }
     if (key.ctrl && input === "d") {
@@ -86412,7 +86412,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     if (confirm && !picker) {
       if (key.return) {
         setConfirm(null);
-        engine2.send({ cmd: "rewind", to: confirm.node, ...rewindRef.current, confirm: true });
+        core2.send({ cmd: "rewind", to: confirm.node, ...rewindRef.current, confirm: true });
         return;
       }
       if (key.escape) {
@@ -86441,7 +86441,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
         setPicker(null);
         if (!it) return;
         rewindRef.current = { files: c !== "chat", conversation: c !== "files" };
-        engine2.send({ cmd: "rewind", to: it.node, ...rewindRef.current });
+        core2.send({ cmd: "rewind", to: it.node, ...rewindRef.current });
       };
       if (key.upArrow) setPicker((pk) => ({ ...pk, choice: (pk.choice + REWIND_CHOICES.length - 1) % REWIND_CHOICES.length }));
       else if (key.downArrow || key.tab) setPicker((pk) => ({ ...pk, choice: (pk.choice + 1) % REWIND_CHOICES.length }));
@@ -86478,7 +86478,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
       }
       if (key.escape) {
         setProposal(null);
-        engine2.send({ cmd: "interrupt" });
+        core2.send({ cmd: "interrupt" });
         return;
       }
     }
@@ -86527,7 +86527,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
       const pick = (keep) => {
         setPicker(null);
         if (it.current && !(keep && !it.default)) return;
-        engine2.send(keep ? { cmd: "reasoning", level: it.level, default: true } : { cmd: "reasoning", level: it.level });
+        core2.send(keep ? { cmd: "reasoning", level: it.level, default: true } : { cmd: "reasoning", level: it.level });
       };
       if (key.leftArrow || key.upArrow) setPicker((p) => ({ ...p, index: (p.index + p.items.length - 1) % p.items.length }));
       else if (key.rightArrow || key.downArrow || key.tab) setPicker((p) => ({ ...p, index: (p.index + 1) % p.items.length }));
@@ -86542,7 +86542,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
         setPicker(null);
         if (it.current) return;
         modelRef.current = it.name;
-        engine2.send({ cmd: "model", name: it.name });
+        core2.send({ cmd: "model", name: it.name });
       };
       if (key.upArrow) setPicker((p) => ({ ...p, index: (p.index + p.items.length - 1) % p.items.length }));
       else if (key.downArrow || key.tab) setPicker((p) => ({ ...p, index: (p.index + 1) % p.items.length }));
@@ -86569,7 +86569,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
         setPicker(null);
         if (it.live && it.live.here) {
         } else if (it.live && it.live.port) attachTo(it.live.port, it.live.run_id);
-        else engine2.send({ cmd: "resume", name: it.name });
+        else core2.send({ cmd: "resume", name: it.name });
       } else if (key.ctrl && input === "a") setPicker((p) => ({ ...p, scope: p.scope === "here" ? "all" : "here", index: 0, top: 0 }));
       else if (key.backspace || key.delete) setPicker((p) => ({ ...p, query: p.query.slice(0, -1), index: 0, top: 0 }));
       else if (input && !key.ctrl && !key.meta && input >= " ") setPicker((p) => ({ ...p, query: p.query + input, index: 0, top: 0 }));
@@ -86583,14 +86583,14 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     }
     if (key.escape) {
       if (phaseRef.current === "busy") {
-        engine2.send({ cmd: "interrupt" });
+        core2.send({ cmd: "interrupt" });
         escRef.current = 0;
         return;
       }
       const now = Date.now();
       if (now - escRef.current < ESC_ESC_MS) {
         escRef.current = 0;
-        engine2.send({ cmd: "rewind_list" });
+        core2.send({ cmd: "rewind_list" });
         return;
       }
       escRef.current = now;
@@ -86604,7 +86604,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     helloRef.current = false;
     setPhaseBoth("connecting");
     const token2 = (readRun(runId || "") || {}).token || "";
-    engine2.reconnect(port2, token2).catch((e) => {
+    core2.reconnect(port2, token2).catch((e) => {
       append({ kind: "error", text: `could not attach: ${e.message}` });
       setPhaseBoth("idle");
     });
@@ -86616,7 +86616,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     const what = p && p.calls.length ? p.calls.map((c) => c.desc).join(" \xB7 ") : "the proposal";
     const also = remember ? ` \xB7 ${p.remember_text || "that shape"} allowed for ${remember === "session" ? "this session" : "this project"}` : "";
     append({ kind: "you", text: decision === "accept" ? `approved: ${what}${also}` : `rejected: ${what}${note ? ` \u2014 ${note}` : ""}` });
-    engine2.send({ cmd: "decide", decision, note: note || "", ...remember ? { remember } : {} });
+    core2.send({ cmd: "decide", decision, note: note || "", ...remember ? { remember } : {} });
   };
   const togglePick = (label) => {
     setValue("");
@@ -86635,10 +86635,10 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
       return;
     }
     dropAsk(question.id);
-    engine2.send({ cmd: "answer", id: question.id, answers });
+    core2.send({ cmd: "answer", id: question.id, answers });
   };
   const vote = (polarity, why2 = "") => {
-    engine2.send({ cmd: polarity > 0 ? "accept" : "reject", ...why2 ? { why: why2 } : {} });
+    core2.send({ cmd: polarity > 0 ? "accept" : "reject", ...why2 ? { why: why2 } : {} });
     setOffer(false);
   };
   const runCommand = (line) => {
@@ -86660,27 +86660,27 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
         append({ kind: "info", text: HELP });
         break;
       case "/resume":
-        engine2.send({ cmd: "sessions" });
+        core2.send({ cmd: "sessions" });
         break;
       case "/compact":
-        engine2.send(arg ? { cmd: "compact", text: arg } : { cmd: "compact" });
+        core2.send(arg ? { cmd: "compact", text: arg } : { cmd: "compact" });
         break;
       case "/model":
         if (arg) {
           modelRef.current = arg;
-          engine2.send({ cmd: "model", name: arg });
-        } else engine2.send({ cmd: "model" });
+          core2.send({ cmd: "model", name: arg });
+        } else core2.send({ cmd: "model" });
         break;
       case "/reasoning":
-        if (arg) engine2.send({ cmd: "reasoning", level: arg });
-        else engine2.send({ cmd: "reasoning" });
+        if (arg) core2.send({ cmd: "reasoning", level: arg });
+        else core2.send({ cmd: "reasoning" });
         break;
       case "/diff":
-        engine2.send({ cmd: "diff", scope: arg });
+        core2.send({ cmd: "diff", scope: arg });
         break;
       case "/rewind":
         wantRow.current = /^\d+$/.test(arg) ? Number(arg) : null;
-        engine2.send({ cmd: "rewind_list" });
+        core2.send({ cmd: "rewind_list" });
         break;
       case "/cost": {
         const ctx = ctxPct > 0 ? ` \xB7 context ${ctxPct}% of the compaction threshold` : "";
@@ -86690,14 +86690,14 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
       case "/image":
         if (!hello?.images) append({ kind: "warn", text: "this version of hum does not take images; update hum" });
         else if (!arg) append({ kind: "info", text: "/image <path> attaches the file to your next message \xB7 ctrl+v pastes a screenshot \xB7 @path.png in a message works too" });
-        else engine2.send({ cmd: "attach", path: arg });
+        else core2.send({ cmd: "attach", path: arg });
         break;
       case "/tools":
         append({ kind: "info", text: `${(hello?.tools || []).join(", ")} \xB7 sandbox: ${hello?.sandbox || "none"}` });
         break;
       case "/mcp":
         if (hello?.mcp === void 0) append({ kind: "warn", text: "this version of hum does not say what is mounted; update hum (/stop, then hum)" });
-        else engine2.send({ cmd: "mcp" });
+        else core2.send({ cmd: "mcp" });
         break;
       case "/accept":
         vote(1, arg);
@@ -86705,28 +86705,28 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
       case "/reject":
         vote(-1, arg);
         break;
-      case "/comms":
-        engine2.send({ cmd: "comms" });
+      case "/slack":
+        core2.send({ cmd: "slack" });
         break;
-      // the engine's words: the channels in the loop here
+      // the core's words: the session's Slack surface
       case "/hooks":
-        engine2.send({ cmd: "hooks" });
+        core2.send({ cmd: "hooks" });
         break;
       case "/usage-credits":
-        engine2.send({ cmd: "credits" });
+        core2.send({ cmd: "credits" });
         break;
       case "/permissions":
-        engine2.send({ cmd: "permissions" });
+        core2.send({ cmd: "permissions" });
         break;
       case "/continue":
-        engine2.send({ cmd: "continue" });
+        core2.send({ cmd: "continue" });
         break;
       case "/goal":
-        engine2.send(arg ? { cmd: "goal", text: arg } : { cmd: "goal" });
+        core2.send(arg ? { cmd: "goal", text: arg } : { cmd: "goal" });
         break;
       case "/approve": {
         const mode = arg === "on" ? "approve" : arg === "off" ? "off" : gate === "approve" ? "off" : "approve";
-        engine2.send({ cmd: "gate", mode });
+        core2.send({ cmd: "gate", mode });
         break;
       }
       default:
@@ -86734,7 +86734,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     }
   };
   const closeReflection = (id, vote2, reason = "") => {
-    engine2.send({ cmd: "reflect_vote", id, vote: vote2, ...reason ? { why: reason } : {} });
+    core2.send({ cmd: "reflect_vote", id, vote: vote2, ...reason ? { why: reason } : {} });
     setReflections((rs) => rs.filter((r) => r.id !== id));
     setWhy((w) => w === id ? null : w);
     setValue("");
@@ -86780,14 +86780,14 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
     }
     if (text.startsWith("!")) {
       append({ kind: "you", text });
-      engine2.send({ cmd: "shell", command: text.slice(1).trim() });
+      core2.send({ cmd: "shell", command: text.slice(1).trim() });
       if (phaseRef.current === "idle") setPhaseBoth("busy");
       return;
     }
     if (paused) setPaused(false);
     if (dropped.length) append({ kind: "info", text: `not sent (chip removed): ${dropped.map((a) => a.label).join(", ")}` });
     append({ kind: "you", text, images: attached.map((a) => `#${a.n} ${a.label}`), steering: phaseRef.current === "busy" });
-    engine2.send({ cmd: "message", text, images: attached.map((a) => a.ref) });
+    core2.send({ cmd: "message", text, images: attached.map((a) => a.ref) });
     attachRef.current = [];
     if (phaseRef.current === "idle") {
       turnT0.current = Date.now();
@@ -87272,7 +87272,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
         input_default,
         {
           ref: inputRef,
-          onPasteImage: () => hello?.images ? engine2.send({ cmd: "paste_image" }) : append({ kind: "warn", text: "this version of hum does not take images; update hum" }),
+          onPasteImage: () => hello?.images ? core2.send({ cmd: "paste_image" }) : append({ kind: "warn", text: "this version of hum does not take images; update hum" }),
           value,
           onChange: setValue,
           onSubmit,
@@ -87303,7 +87303,7 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "tab to complete \xB7 enter to run" })
     ] }),
     !menu.length && agents.length > 0 && // one flat list: ○ a sub-agent of this process, ◇ a worker session of the team (its state, what it needs,
-    // +N sub-agents of its own); the engine puts what wants a person first. ↓ moves a highlight in from the box
+    // +N sub-agents of its own); the core puts what wants a person first. ↓ moves a highlight in from the box
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", paddingX: 1, children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
         "  ",
@@ -87351,22 +87351,22 @@ function App2({ engine: engine2, task, resume, images = [], peek = peekSession,
 }
 
 // src/cli.jsx
-init_engine();
+init_core();
 init_update();
 init_install();
 var import_jsx_runtime4 = __toESM(require_jsx_runtime(), 1);
 import { spawnSync as spawnSync5 } from "node:child_process";
-var MINE2 = true ? "0.1.74" : "0.0.0";
+var MINE2 = true ? "0.1.76" : "0.0.0";
 var layout = installLayout();
 function completeInstall() {
   if (layout.kind !== "npm" || !needsInstall(MINE2)) return;
   const say = (m) => process.stderr.write(`hum: ${m}
 `);
   say(`updating to ${MINE2} \u2026`);
-  const r = installEngine(MINE2, { say });
+  const r = installCore(MINE2, { say });
   if (!r.ok) say(`the update did not finish: ${r.error} \xB7 ${npmFix(MINE2)}`);
 }
-var ENGINE_COMMANDS = /* @__PURE__ */ new Set(["run", "login", "logout", "whoami", "model", "key", "sessions", "show", "sync", "skill", "persona", "ps", "stop", "hooks", "engine"]);
+var CORE_COMMANDS = /* @__PURE__ */ new Set(["run", "login", "logout", "whoami", "model", "key", "sessions", "show", "sync", "skill", "persona", "ps", "stop", "hooks", "core"]);
 var argv0 = process.argv.slice(2);
 if (argv0[0] === "--version" || argv0[0] === "-V") {
   process.stdout.write(`hum ${MINE2}
@@ -87384,9 +87384,9 @@ if (argv0[0] === "doctor") {
   const { doctor: doctor2 } = await Promise.resolve().then(() => (init_doctor(), doctor_exports));
   process.exit(await doctor2({ json: argv0.includes("--json"), mine: MINE2, layout }));
 }
-if (ENGINE_COMMANDS.has(argv0[0]) || argv0[0] === "agents" && argv0.includes("--json") || wantsPlain(argv0)) {
+if (CORE_COMMANDS.has(argv0[0]) || argv0[0] === "agents" && argv0.includes("--json") || wantsPlain(argv0)) {
   completeInstall();
-  const cmd = engineCommand(argv0);
+  const cmd = coreCommand(argv0);
   if (!cmd) {
     process.stderr.write(startFailure([]) + "\n");
     process.exit(1);
@@ -87398,8 +87398,8 @@ if (ENGINE_COMMANDS.has(argv0[0]) || argv0[0] === "agents" && argv0.includes("--
   }
   process.exit(r.status === null ? 1 : r.status);
 }
-function leave(engine2) {
-  engine2.close();
+function leave(core2) {
+  core2.close();
   process.exit(0);
 }
 if (argv0[0] === "agents") {
@@ -87421,16 +87421,16 @@ if (argv0[0] === "agents") {
   }, onQuit: () => screen.unmount() }));
   await screen.waitUntilExit();
   if (!chosen) process.exit(0);
-  const engine2 = new Engine(chosen.port, (readRun(chosen.run_id) || {}).token || "");
+  const core2 = new Core(chosen.port, (readRun(chosen.run_id) || {}).token || "");
   try {
-    await engine2.connect();
+    await core2.connect();
   } catch (exc) {
     process.stderr.write(exc.message + "\n");
     process.exit(1);
   }
-  const app = render_default(/* @__PURE__ */ (0, import_jsx_runtime4.jsx)(App2, { engine: engine2, task: null, resume: null, images: [] }), { exitOnCtrlC: false });
+  const app = render_default(/* @__PURE__ */ (0, import_jsx_runtime4.jsx)(App2, { core: core2, task: null, resume: null, images: [] }), { exitOnCtrlC: false });
   await app.waitUntilExit();
-  leave(engine2);
+  leave(core2);
 }
 function parseArgs(argv) {
   const a = { task: null, resume: null, cwd: process.cwd(), images: [] };
@@ -87456,13 +87456,13 @@ if (!process.stdin.isTTY) {
   process.stderr.write('hum needs an interactive terminal; use `hum run "task"` when piping.\n');
   process.exit(1);
 }
-var port = Number(process.env.HUM_ENGINE_PORT || 0);
+var port = Number(process.env.HUM_CORE_PORT || 0);
 var token = port ? (readRun(process.env.HUM_RUN_ID || "") || {}).token || "" : "";
 var startedHere = false;
 try {
   if (!port) {
     completeInstall();
-    const rec = await spawnEngine(args.cwd, { task: args.task, images: args.images, resume: args.resume && args.resume !== "pick" ? args.resume : null });
+    const rec = await spawnCore(args.cwd, { task: args.task, images: args.images, resume: args.resume && args.resume !== "pick" ? args.resume : null });
     startedHere = true;
     port = rec.port;
     token = rec.token || "";
@@ -87474,15 +87474,15 @@ try {
   }
   throw exc;
 }
-var engine = new Engine(port, token);
+var core = new Core(port, token);
 try {
-  await engine.connect();
+  await core.connect();
 } catch (exc) {
   process.stderr.write(exc.message + "\n");
   process.exit(1);
 }
-var { waitUntilExit } = render_default(/* @__PURE__ */ (0, import_jsx_runtime4.jsx)(App2, { engine, task: startedHere ? null : args.task, resume: args.resume === "pick" || !startedHere ? args.resume : null, images: startedHere ? [] : args.images }), { exitOnCtrlC: false });
-waitUntilExit().then(() => leave(engine));
+var { waitUntilExit } = render_default(/* @__PURE__ */ (0, import_jsx_runtime4.jsx)(App2, { core, task: startedHere ? null : args.task, resume: args.resume === "pick" || !startedHere ? args.resume : null, images: startedHere ? [] : args.images }), { exitOnCtrlC: false });
+waitUntilExit().then(() => leave(core));
 /*! Bundled license information:
 
 react/cjs/react.production.min.js:

package/dist/install.mjs

@@ -7,14 +7,14 @@ var win = process.platform === "win32";
 var npmFix = (version = "") => `npm i -g @metaphi-ai/hum@${version || "latest"} --foreground-scripts`;
 var NPM_FIX = npmFix("latest");
 var humHome = (env = process.env) => env.HUM_HOME || path.join(os.homedir(), ".hum");
-var engineDir = (env = process.env) => path.join(humHome(env), "engine");
-var enginePython = (env = process.env) => win ? path.join(engineDir(env), "Scripts", "python.exe") : path.join(engineDir(env), "bin", "python");
-var stampPath = (env) => path.join(engineDir(env), "version");
-var statePath = (env) => path.join(humHome(env), "engine-install.json");
+var coreDir = (env = process.env) => path.join(humHome(env), "core");
+var corePython = (env = process.env) => win ? path.join(coreDir(env), "Scripts", "python.exe") : path.join(coreDir(env), "bin", "python");
+var stampPath = (env) => path.join(coreDir(env), "version");
+var statePath = (env) => path.join(humHome(env), "core-install.json");
 var run = (cmd, args, opts = {}) => spawnSync(cmd, args, { encoding: "utf8", windowsHide: true, ...opts });
 var ASK_VERSION = ["-I", "-c", "import hum; print(hum.__version__)"];
 function importedVersion(env = process.env, runImpl = run) {
-  const r = runImpl(enginePython(env), ASK_VERSION);
+  const r = runImpl(corePython(env), ASK_VERSION);
   return r && r.status === 0 ? String(r.stdout).trim() : null;
 }
 function installedVersion(env = process.env, runImpl = run) {
@@ -22,7 +22,7 @@ function installedVersion(env = process.env, runImpl = run) {
     return fs.readFileSync(stampPath(env), "utf8").trim() || null;
   } catch {
   }
-  if (!fs.existsSync(enginePython(env))) return null;
+  if (!fs.existsSync(corePython(env))) return null;
   const v = importedVersion(env, runImpl);
   if (v) {
     try {
@@ -41,12 +41,12 @@ function trustedPython(env = process.env, runImpl = run) {
 }
 var ASK_SSL = ["-I", "-c", "import ssl"];
 function sslBlocked(env = process.env, runImpl = run) {
-  const r = runImpl(enginePython(env), ASK_SSL);
+  const r = runImpl(corePython(env), ASK_SSL);
   if (r && r.status === 0) return null;
   const text = String(r && (r.stderr || r.stdout) || "ssl did not import").trim().split(/\r?\n/).filter(Boolean).pop() || "ssl did not import";
   return text;
 }
-var sslAdvice = (env, version) => `the machine's application control blocked Python's OpenSSL DLL in ${engineDir(env)}; install Python 3.12 from python.org (Microsoft signs it), then run  ${npmFix(version)}`;
+var sslAdvice = (env, version) => `the machine's application control blocked Python's OpenSSL DLL in ${coreDir(env)}; install Python 3.12 from python.org (Microsoft signs it), then run  ${npmFix(version)}`;
 var readInstallState = (env = process.env) => {
   try {
     return JSON.parse(fs.readFileSync(statePath(env), "utf8"));
@@ -62,22 +62,22 @@ var writeInstallState = (s, env) => {
   }
 };
 function needsInstall(version, { env = process.env, installed = () => installedVersion(env), now = Date.now(), state = readInstallState(env) } = {}) {
-  if (!version || env.HUM_ENGINE || env.HUM_ENGINE_PORT) return false;
+  if (!version || env.HUM_CORE || env.HUM_CORE_PORT) return false;
   if (installed() === version) return false;
   if (state && !state.ok && state.version === version && now - (state.at || 0) < 10 * 60 * 1e3) return false;
   return true;
 }
-function installEngine(version, { env = process.env, say = (m) => console.log(`hum: ${m}`), runImpl = run, now = Date.now() } = {}) {
+function installCore(version, { env = process.env, say = (m) => console.log(`hum: ${m}`), runImpl = run, now = Date.now() } = {}) {
   const home = humHome(env);
-  const dir = engineDir(env);
-  const python = enginePython(env);
+  const dir = coreDir(env);
+  const python = corePython(env);
   const localBin = path.join(os.homedir(), ".local", "bin");
   const uvNames = ["uv", path.join(localBin, win ? "uv.exe" : "uv")];
   const uv = () => uvNames.find((u) => {
     const r = runImpl(u, ["--version"]);
     return r && r.status === 0;
   });
-  const spec = env.HUM_ENGINE_SPEC || `hum-cli==${version}`;
+  const spec = env.HUM_CORE_SPEC || `hum-cli==${version}`;
   const outcome = (ok, error = null, got = version) => {
     writeInstallState({ version: got, wanted: version, ok, error, at: now }, env);
     return { ok, version: got, error };
@@ -90,7 +90,7 @@ function installEngine(version, { env = process.env, say = (m) => console.log(`h
       u = r && r.status === 0 ? uv() : null;
       if (!u) return outcome(false, `could not install uv; install it from https://astral.sh/uv and run:  ${npmFix(version)}`);
     }
-    say(`installing ${env.HUM_ENGINE_SPEC ? spec : `hum ${version}`} into ${dir} \u2026`);
+    say(`installing ${env.HUM_CORE_SPEC ? spec : `hum ${version}`} into ${dir} \u2026`);
     fs.mkdirSync(home, { recursive: true });
     try {
       fs.unlinkSync(stampPath(env));
@@ -103,7 +103,7 @@ function installEngine(version, { env = process.env, say = (m) => console.log(`h
     if (!pipIn()) return outcome(false, `uv pip install ${spec} failed`);
     let got = importedVersion(env, runImpl);
     if (!got) return outcome(false, "hum did not import after the install");
-    if (got !== version && !env.HUM_ENGINE_SPEC) return outcome(false, `installed ${got}, wanted ${version}`, got);
+    if (got !== version && !env.HUM_CORE_SPEC) return outcome(false, `installed ${got}, wanted ${version}`, got);
     let blocked = sslBlocked(env, runImpl);
     if (blocked && trusted) {
       say(`the policy here refuses the environment's OpenSSL (${blocked}); rebuilding it on ${trusted} \u2026`);
@@ -131,11 +131,11 @@ export {
   ASK_SSL,
   ASK_VERSION,
   NPM_FIX,
-  engineDir,
-  enginePython,
+  coreDir,
+  corePython,
   humHome,
   importedVersion,
-  installEngine,
+  installCore,
   installedVersion,
   needsInstall,
   npmFix,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaphi-ai/hum",
-  "version": "0.1.74",
+  "version": "0.1.76",
   "description": "Hum: a self-improving coding agent for your terminal.",
   "license": "UNLICENSED",
   "type": "module",

package/scripts/postinstall.js

@@ -1,6 +1,6 @@
 // npm's postinstall: complete the install at this package's version. The work is in
 // dist/install.mjs — the same code `hum` runs at start when the two halves differ — and the
-// outcome lands in ~/.hum/engine-install.json, because npm shows none of this unless it is
+// outcome lands in ~/.hum/core-install.json, because npm shows none of this unless it is
 // run with --foreground-scripts. Never fails the npm install.
 import fs from 'node:fs';
 import path from 'node:path';
@@ -9,9 +9,9 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 const here = path.dirname(fileURLToPath(import.meta.url));
 const version = JSON.parse(fs.readFileSync(path.join(here, '..', 'package.json'), 'utf8')).version;
 // a URL, not a path: on Windows `C:\…` is not something the ESM loader will import
-const { installedVersion, installEngine, npmFix } = await import(pathToFileURL(path.join(here, '..', 'dist', 'install.mjs')).href);
+const { installedVersion, installCore, npmFix } = await import(pathToFileURL(path.join(here, '..', 'dist', 'install.mjs')).href);
 
 if (installedVersion() !== version) {
-  const r = installEngine(version);
+  const r = installCore(version);
   if (!r.ok) console.log(`hum: the install did not finish (${r.error}); run:  ${npmFix(version)}`);
 }