kojee-mcp 0.7.5-staging.6 → 0.7.5-staging.8

package/dist/{chunk-6XWTUDWW.js → chunk-376ZI3J7.js}

@@ -1,11 +1,11 @@
+import {
+  wrapNpxLauncher
+} from "./chunk-D6JKFJ6A.js";
 import {
   buildHookCommand,
   isKojeeHookCommand,
   npxHookCommand
-} from "./chunk-TMCNB4JH.js";
-import {
-  wrapNpxLauncher
-} from "./chunk-D6JKFJ6A.js";
+} from "./chunk-COM6435C.js";
 import {
   kojeeHomeDir
 } from "./chunk-SQL56SEB.js";
@@ -14,7 +14,7 @@ import {
 } from "./chunk-U5HHHRXA.js";
 import {
   VERSION
-} from "./chunk-5DHIUN73.js";
+} from "./chunk-O4JQY7IF.js";
 
 // src/wizard/codex-config.ts
 import fs from "fs";

package/dist/chunk-COM6435C.js

@@ -0,0 +1,65 @@
+// src/hooks/hook-command.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+function npxHookCommand(type) {
+  return `npx -y kojee-mcp hook --type=${type}`;
+}
+var NPX_CACHE_RE = /[\\/]_npx[\\/]/;
+function resolveCliEntry(moduleUrl = import.meta.url) {
+  try {
+    const here = fileURLToPath(moduleUrl);
+    const candidate = path.join(path.dirname(here), "cli.js");
+    if (!fs.existsSync(candidate)) return null;
+    if (NPX_CACHE_RE.test(candidate)) return null;
+    return candidate;
+  } catch {
+    return null;
+  }
+}
+function stableExecPath(execPath = process.execPath) {
+  const m = /^(.*)\/Cellar\/node(?:@[^/]+)?\/[^/]+\/bin\/node$/.exec(execPath);
+  if (!m || !m[1]) return execPath;
+  const alias = path.join(m[1], "bin", "node");
+  try {
+    if (!fs.existsSync(alias)) return execPath;
+    const real = fs.realpathSync(alias);
+    return /[\\/]Cellar[\\/]node(@[^/]+)?[\\/]/.test(real) ? alias : execPath;
+  } catch {
+    return execPath;
+  }
+}
+function buildHookCommand(type, opts = {}) {
+  const cliEntry = opts.cliEntry !== void 0 ? opts.cliEntry : resolveCliEntry();
+  if (!cliEntry) return npxHookCommand(type);
+  const execPath = stableExecPath(opts.execPath ?? process.execPath);
+  return `"${execPath}" "${cliEntry}" hook --type=${type}`;
+}
+var PINNED_HOOK_RE = /^"[^"]+" "[^"]+" hook --type=(stop|user-prompt-submit|codex-stop|codex-prompt-submit)$/;
+function isKojeeHookCommand(command) {
+  if (command.startsWith("npx -y kojee-mcp hook --type=")) return true;
+  return PINNED_HOOK_RE.test(command);
+}
+function classifyHookCommand(command, deps = {}) {
+  if (command.startsWith("npx -y kojee-mcp hook --type=")) return "npx";
+  if (!PINNED_HOOK_RE.test(command)) return "foreign";
+  const paths = [...command.matchAll(/"([^"]+)"/g)].map((m) => m[1] ?? "");
+  const cliPath = paths[1] ?? "";
+  if (NPX_CACHE_RE.test(cliPath)) return "pinned-ephemeral";
+  const exists = deps.exists ?? ((p) => {
+    try {
+      return fs.existsSync(p);
+    } catch {
+      return true;
+    }
+  });
+  if (cliPath && !exists(cliPath)) return "pinned-broken";
+  return "pinned-durable";
+}
+
+export {
+  npxHookCommand,
+  buildHookCommand,
+  isKojeeHookCommand,
+  classifyHookCommand
+};

package/dist/{chunk-4ATSAH7H.js → chunk-HRDASFRF.js}

@@ -1,6 +1,6 @@
 import {
   claudeCodeAdapter
-} from "./chunk-TCWIXG5C.js";
+} from "./chunk-XYDNRVOU.js";
 import {
   GatewayClient,
   applyStableSessionId
@@ -11,7 +11,7 @@ import {
 import {
   createMcpServer,
   startMcpServer
-} from "./chunk-A4IOKD4Z.js";
+} from "./chunk-S35ZIVOL.js";
 import {
   findClaudeAncestorPid
 } from "./chunk-XJEBJIQE.js";
@@ -295,9 +295,11 @@ async function startProxy(config) {
   }
   console.error(`[kojee-mcp] Tandem memberships: ${tandemMembershipCount === -1 ? "unknown" : tandemMembershipCount}`);
   let server;
-  const { selectDelivery } = await import("./registry-DKWVVXJM.js");
+  const isHeadlessDaemon = !!process.env["KOJEE_HEADLESS"] || !!process.env["KOJEE_WEBHOOK_EXPECTED"];
+  const { selectDelivery } = await import("./registry-NLRXVII7.js");
   const delivery = selectDelivery(adapter.runtime, {
     supportsChannels: adapter.supportsChannels,
+    headless: isHeadlessDaemon,
     // Per-window delivered mirror for the tandem_pending tool (codex only —
     // other runtimes' deliveries ignore this even when passed).
     ...pendingState ? { onDelivered: (e) => pendingState.noteDelivered(e.tandem_id, e.cursor) } : {}
@@ -338,13 +340,12 @@ async function startProxy(config) {
     }
     server = createMcpServer(registry, adapter, tandemMembershipCount);
   }
-  const isHeadlessDaemon = !!process.env["KOJEE_WEBHOOK_EXPECTED"];
   if (!isHeadlessDaemon) {
     process.stdin.on("end", () => shutdown("stdin end"));
     process.stdin.on("close", () => shutdown("stdin close"));
   } else {
     console.error(
-      "[kojee-mcp] headless daemon (KOJEE_WEBHOOK_EXPECTED=1): stdin EOF ignored; lifecycle owned by the service manager (SIGTERM/SIGINT/SIGHUP)."
+      "[kojee-mcp] headless daemon (KOJEE_HEADLESS / KOJEE_WEBHOOK_EXPECTED): stdin EOF ignored; lifecycle owned by the service manager (SIGTERM/SIGINT/SIGHUP)."
     );
   }
   process.on("SIGHUP", () => shutdown("SIGHUP"));

package/dist/{chunk-NE2F5CKS.js → chunk-LKGKDZSO.js}

@@ -87,18 +87,22 @@ function createCachedOpenclawWakeResolver(opts = {}) {
     return resolution;
   };
 }
-async function postOpenclawWake(target, body, deps = {}) {
+function openclawAgentUrl(wakeUrl) {
+  return wakeUrl.replace(/\/wake$/, "/agent");
+}
+async function postOpenclawAgent(target, body, deps = {}) {
   const doFetch = deps.fetch ?? fetch;
+  const url = openclawAgentUrl(target.url);
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), deps.timeoutMs ?? 4e3);
   try {
-    const res = await doFetch(target.url, {
+    const res = await doFetch(url, {
       method: "POST",
       headers: { "content-type": "application/json", authorization: `Bearer ${target.token}` },
-      body: JSON.stringify(body),
+      body: JSON.stringify({ name: "Kojee", wakeMode: "now", ...body }),
       signal: controller.signal
     });
-    return res.ok ? { ok: true, status: res.status } : { ok: false, status: res.status, error: `wake POST ${res.status}` };
+    return res.ok ? { ok: true, status: res.status } : { ok: false, status: res.status, error: `agent POST ${res.status}` };
   } catch (err) {
     return { ok: false, error: err.message };
   } finally {
@@ -109,5 +113,5 @@ async function postOpenclawWake(target, body, deps = {}) {
 export {
   resolveOpenclawWakeTarget,
   createCachedOpenclawWakeResolver,
-  postOpenclawWake
+  postOpenclawAgent
 };

package/dist/{chunk-FJUAMJHU.js → chunk-O4JQY7IF.js}

@@ -1,7 +1,32 @@
+// src/version.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var FALLBACK_VERSION = "0.0.0-unknown";
+function resolveVersion() {
+  try {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const parsed = JSON.parse(
+      fs.readFileSync(path.join(here, "..", "package.json"), "utf8")
+    );
+    return typeof parsed?.version === "string" && parsed.version ? parsed.version : FALLBACK_VERSION;
+  } catch (err) {
+    process.stderr.write(
+      `kojee-mcp: could not resolve version from package.json, falling back to ${FALLBACK_VERSION}: ${String(err)}
+`
+    );
+    return FALLBACK_VERSION;
+  }
+}
+var VERSION = resolveVersion();
+
 // src/tandem/recipe.ts
 var SEND_BODY_PARAM = "body";
+function monitorPackageSpec() {
+  return VERSION && VERSION !== "0.0.0-unknown" ? `kojee-mcp@${VERSION}` : "kojee-mcp";
+}
 function buildMonitorCommand(logPath) {
-  return `npx kojee-mcp tail "${logPath}"`;
+  return `npx ${monitorPackageSpec()} tail --wake-only "${logPath}"`;
 }
 function buildMonitorSpawn(logPath) {
   return `Monitor(command=\`${buildMonitorCommand(logPath)}\`, persistent=true, description="kojee Tandem events")`;
@@ -32,6 +57,7 @@ var CODEX_LISTEN_CAP_MS = 8e3;
 var CODEX_WAKE_BELL = "[kojee] Tandem events may be pending. Call tandem_pending now and drain each room it lists (tandem_messages(id, since=cursor)), then reply in the room with a normal message (kind=message \u2014 never status). If it returns none for you, ignore this.";
 
 export {
+  VERSION,
   buildMonitorSpawn,
   buildReplyRecipe,
   buildCatchUpNote,

package/dist/{chunk-A4IOKD4Z.js → chunk-S35ZIVOL.js}

@@ -1,12 +1,10 @@
 import {
-  VERSION
-} from "./chunk-5DHIUN73.js";
-import {
+  VERSION,
   buildCatchUpNote,
   buildCondensedTandemRules,
   buildMonitorSpawn,
   buildReplyRecipe
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 import {
   translateToolCallResult
 } from "./chunk-PPTKGWFF.js";

package/dist/{chunk-TCWIXG5C.js → chunk-XYDNRVOU.js}

@@ -1,6 +1,6 @@
 import {
   buildReplyRecipe
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 
 // src/adapters/claude-code.ts
 function computeSeverity(event) {

package/dist/{chunk-CPOK642I.js → chunk-ZUF47CPP.js}

@@ -5,7 +5,7 @@ import {
   isPlaceholderWebhookUrl,
   removeCodexConfig,
   writeCodexConfig
-} from "./chunk-6XWTUDWW.js";
+} from "./chunk-376ZI3J7.js";
 import {
   removeOpenclawMcpServer,
   writeOpenclawMcpConfig
@@ -48,14 +48,12 @@ import {
   secureFile,
   unlinkSyncRetry
 } from "./chunk-U5HHHRXA.js";
-import {
-  VERSION
-} from "./chunk-5DHIUN73.js";
 import {
   CODEX_LISTEN_CAP_MS,
+  VERSION,
   buildCondensedTandemRules,
   buildWebhookReceiverNote
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 
 // src/wizard/pair-slot.ts
 import fs from "fs";
@@ -424,9 +422,18 @@ function installBundledPayload(opts) {
 // src/wizard/service.ts
 import fs5 from "fs";
 import path5 from "path";
+function shQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function wrapperEnvEntries(spec) {
+  const marker = spec.wrapperEnv ?? { KOJEE_WEBHOOK_EXPECTED: "1" };
+  return [["KOJEE_RUNTIME", spec.runtime], ...Object.entries(marker)];
+}
 function daemonSourceExecCommand(spec) {
   const target = spec.nodePath ? `${spec.nodePath} ${spec.binPath}` : spec.binPath;
-  return `set -a; . ${spec.envFile}; set +a; exec ${target}`;
+  const withArgs = spec.binArgs && spec.binArgs.length > 0 ? `${target} ${spec.binArgs.map(shQuote).join(" ")}` : target;
+  const source = spec.envFile ? `set -a; . ${spec.envFile}; set +a; ` : "";
+  return `${source}exec ${withArgs}`;
 }
 function xmlEscape(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
@@ -445,7 +452,7 @@ function systemdUnit(spec) {
     // otherwise kill the marker too. It lets startProxy tell the "webhook was
     // meant to be here" daemon apart from the tools-only child (which never sets
     // it) when the sourced URL is absent → null delivery.
-    `Environment=KOJEE_RUNTIME=${spec.runtime} KOJEE_WEBHOOK_EXPECTED=1`,
+    `Environment=${wrapperEnvEntries(spec).map(([k, v]) => `${k}=${v}`).join(" ")}`,
     // §2a: source the env file inside a shell wrapper (replaces EnvironmentFile=).
     `ExecStart=/bin/sh -c '${daemonSourceExecCommand(spec)}'`,
     "Restart=always",
@@ -480,7 +487,7 @@ function launchdPlist(spec, label) {
     "  </array>",
     // §2b: KOJEE_WEBHOOK_EXPECTED in the wrapper env (NOT the sourced file).
     "  <key>EnvironmentVariables</key>",
-    `  <dict><key>KOJEE_RUNTIME</key><string>${xmlEscape(spec.runtime)}</string><key>KOJEE_WEBHOOK_EXPECTED</key><string>1</string></dict>`,
+    `  <dict>${wrapperEnvEntries(spec).map(([k, v]) => `<key>${xmlEscape(k)}</key><string>${xmlEscape(v)}</string>`).join("")}</dict>`,
     "  <key>RunAtLoad</key><true/>",
     "  <key>KeepAlive</key><true/>",
     "</dict>",
@@ -532,6 +539,15 @@ function writeService(platform, spec) {
   }
   return plan;
 }
+function removeService(platform, spec) {
+  const plan = planService(platform, spec);
+  let removed = false;
+  if (plan.unitPath && fs5.existsSync(plan.unitPath)) {
+    fs5.unlinkSync(plan.unitPath);
+    removed = true;
+  }
+  return { removed, deactivateCmd: plan.deactivateCmd };
+}
 
 // src/wizard/installers/hermes.ts
 function installHermes(inp) {
@@ -619,6 +635,16 @@ function installOpenclaw(inp) {
     ...inp.pairedConfigPath ? { pairedConfigPath: inp.pairedConfigPath } : {},
     ...inp.now ? { now: inp.now } : {}
   });
+  const platform = inp.platform ?? process.platform;
+  const svc = !inp.skipService && inp.binPath && inp.homeDir ? writeService(platform, {
+    serviceName: "kojee-openclaw",
+    binPath: inp.binPath,
+    ...inp.nodePath ? { nodePath: inp.nodePath } : {},
+    runtime: "openclaw",
+    homeDir: inp.homeDir,
+    binArgs: ["--paired-config", inp.pairedConfigPath ?? perRuntimeConfigPath("openclaw")],
+    wrapperEnv: { KOJEE_HEADLESS: "1" }
+  }) : null;
   const lines = [];
   if (r.backedUp) {
     lines.push(
@@ -627,17 +653,22 @@ function installOpenclaw(inp) {
     );
   }
   lines.push(
-    "Configured runtime: openclaw (MCP server + /wake injector)",
-    "Wake mode: kojee-mcp runs as OpenClaw's MCP server; Tandem events POST to the local",
-    "           OpenClaw gateway /hooks/wake (Bearer hooks.token) \u2192 the agent wakes.",
-    `  mcp config:  ${inp.openclawConfigPath} (mcp.servers.kojee)`,
+    "Configured runtime: openclaw (MCP server + standing /hooks/agent wake daemon)",
+    "Wake mode: the kojee-openclaw DAEMON holds the Tandem SSE stream and, on an @mention,",
+    "           POSTs the local OpenClaw gateway /hooks/agent (Bearer hooks.token) \u2192 a FULL",
+    "           agent run (kojee tools mounted) so the agent can reply via tandem_send.",
+    `  mcp config:  ${inp.openclawConfigPath} (mcp.servers.kojee \u2014 per-run tools; no SSE stream)`,
     inp.pairedConfigPath ? `  credentials: per-runtime paired slot (${inp.pairedConfigPath})` : `  credentials: shared ~/.kojee/config.json (paired)`,
     `  hooks token: ${r.hooksTokenGenerated ? "generated + hooks.enabled=true (new)" : "preserved existing"}`,
+    svc ? svc.supported ? `  wake daemon: ${svc.unitPath}` : `  wake daemon: manual \u2014 ${svc.note ?? "unsupported platform"}` : "  wake daemon: NOT installed (no launch path resolved) \u2014 run connect from the CLI",
     "",
     "Next steps (openclaw):",
-    "  - Run OpenClaw as its GATEWAY DAEMON (its default mode) \u2014 the /wake injector only",
-    "    wakes a running gateway. If the gateway is down, nudges are dropped until it restarts.",
-    "  - Restart the OpenClaw gateway to spawn the kojee MCP server: openclaw gateway restart",
+    ...svc && svc.supported ? [
+      `  - Start the standing wake daemon:  ${svc.activateCmd}`,
+      "    (it holds the SSE stream so an IDLE agent is still woken on @mentions)."
+    ] : svc ? [`  - Start the standing wake daemon:  ${svc.activateCmd}`] : [],
+    "  - Ensure the OpenClaw gateway is running (the daemon POSTs /hooks/agent to it).",
+    "  - Restart the OpenClaw gateway to spawn the kojee MCP tools server: openclaw gateway restart",
     "  - Verify: openclaw mcp list  (kojee should be listed)  /  kojee-mcp doctor",
     "",
     // Belt-and-suspenders: the same condensed rules ride the kojee MCP server's
@@ -652,11 +683,21 @@ function installOpenclaw(inp) {
 }
 function uninstallOpenclaw(inp) {
   const removed = removeOpenclawMcpServer(inp.openclawConfigPath);
+  const svc = inp.homeDir ? removeService(inp.platform ?? process.platform, {
+    serviceName: "kojee-openclaw",
+    binPath: "",
+    runtime: "openclaw",
+    homeDir: inp.homeDir
+  }) : null;
   const lines = [
-    "Uninstalling runtime: openclaw (MCP server + /wake injector)",
+    "Uninstalling runtime: openclaw (MCP server + wake daemon)",
     removed ? `  removed mcp.servers.kojee from ${inp.openclawConfigPath} (hooks + siblings preserved)` : `  no mcp.servers.kojee in ${inp.openclawConfigPath} \u2014 nothing to remove`,
+    ...svc ? [
+      svc.removed ? `  removed the kojee-openclaw wake-daemon unit (stop it: ${svc.deactivateCmd})` : "  no kojee-openclaw wake-daemon unit found"
+    ] : [],
     "",
     "Next steps (openclaw):",
+    "  - Stop the wake daemon if still running (see the deactivate command above).",
     "  - Restart the OpenClaw gateway: openclaw gateway restart",
     "  - hooks.enabled/token were left intact (you may use hooks for other integrations)."
   ];
@@ -829,7 +870,7 @@ function whatHappensNext(runtime, opts) {
   return lines.join("\n");
 }
 async function configureClaudeCode(opts) {
-  const { runInit } = await import("./install-JQNDGAAQ.js");
+  const { runInit } = await import("./install-NG366AOQ.js");
   const report = runInit({
     ...opts.configPath ? { configPath: opts.configPath } : {},
     ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {},
@@ -1088,18 +1129,35 @@ function openclawConfigPath(opts) {
 }
 function configureOpenclaw(opts) {
   const runtime = "openclaw";
+  const daemonExec = resolveDaemonExec();
   const install = installOpenclaw({
     openclawConfigPath: openclawConfigPath(opts),
-    ...opts.pairedConfigPath ? { pairedConfigPath: opts.pairedConfigPath } : {}
+    ...opts.pairedConfigPath ? { pairedConfigPath: opts.pairedConfigPath } : {},
+    // Launch coords for the standing kojee-openclaw wake daemon (holds the SSE
+    // stream so an idle agent is reachable). Absent → installer writes only the
+    // MCP config (the shape tests).
+    binPath: daemonExec.binPath,
+    nodePath: daemonExec.nodePath,
+    homeDir: kojeeHomeDir(),
+    platform: process.platform
   });
   recordRuntime(runtime);
-  return { runtime, output: install.output, exitCode: install.exitCode };
+  const lines = [install.output];
+  if (daemonExec.ephemeral) {
+    lines.push(
+      "",
+      "\u26A0 DURABILITY: this ran from an ephemeral npx cache, so the wake daemon points at a",
+      "  path npx will eventually delete (the daemon would then fail to start). For a durable",
+      "  daemon:  npm i -g kojee-mcp && kojee-mcp connect <code> --runtime openclaw"
+    );
+  }
+  return { runtime, output: lines.join("\n"), exitCode: install.exitCode };
 }
 async function runWizardUninstall(runtime, opts) {
   const effective = opts.runtime !== void 0 ? runtime : readRecordedRuntime() ?? runtime;
   const lines = [`Uninstalling runtime: ${effective}`];
   if (effective === "claude-code") {
-    const { runUninstall } = await import("./install-JQNDGAAQ.js");
+    const { runUninstall } = await import("./install-NG366AOQ.js");
     const report = runUninstall({
       ...opts.configPath ? { configPath: opts.configPath } : {},
       ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {}
@@ -1123,7 +1181,11 @@ async function runWizardUninstall(runtime, opts) {
     lines.push(`  config.toml [mcp_servers.kojee]: ${removed.mcpServer ? "removed" : "not found"}`);
     lines.push(`  hooks.json Stop: ${removed.stopHook ? "removed" : "not found"}`);
   } else if (effective === "openclaw") {
-    const un = uninstallOpenclaw({ openclawConfigPath: openclawConfigPath(opts) });
+    const un = uninstallOpenclaw({
+      openclawConfigPath: openclawConfigPath(opts),
+      homeDir: kojeeHomeDir(),
+      platform: process.platform
+    });
     lines.push(un.output);
   } else {
     const hermesConfig = defaultHermesConfigPath(kojeeHomeDir());

package/dist/cli.js

@@ -4,8 +4,8 @@ import {
 } from "./chunk-EIAUW6KO.js";
 import {
   startProxy
-} from "./chunk-4ATSAH7H.js";
-import "./chunk-TCWIXG5C.js";
+} from "./chunk-HRDASFRF.js";
+import "./chunk-XYDNRVOU.js";
 import {
   pairedConfigPath
 } from "./chunk-5SZHXYPK.js";
@@ -18,11 +18,10 @@ import {
   deriveKeystorePath
 } from "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
-import "./chunk-A4IOKD4Z.js";
+import "./chunk-S35ZIVOL.js";
 import {
   VERSION
-} from "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 import "./chunk-PPTKGWFF.js";
 import "./chunk-XJEBJIQE.js";
 import "./chunk-SRLD2UY7.js";
@@ -48,7 +47,7 @@ program.command("pair <code>").description("Pair this machine against Kojee usin
 program.command("connect <code>").description(
   "Connect this runtime to Kojee with a per-agent pair code from the dashboard (claude-code | codex | openclaw | hermes). claude-code/codex/openclaw write a per-runtime paired slot (~/.kojee/agents/<runtime>/config.json) and point the runtime launcher at it via --paired-config; hermes writes the global ~/.kojee/config.json (its daemon + `kojee-mcp send` read that). Idempotent."
 ).requiredOption("--runtime <id>", "Target runtime: claude-code | codex | openclaw | hermes").option("--url <url>", "Broker base URL (default: the canonical staging broker)").action(async (code, opts) => {
-  const { runConnect } = await import("./connect-handler-NCHC6WPU.js");
+  const { runConnect } = await import("./connect-handler-NJ4FZIAM.js");
   const result = await runConnect({
     code,
     runtime: opts.runtime,
@@ -58,12 +57,21 @@ program.command("connect <code>").description(
   console.error(result.output);
   process.exit(result.exitCode);
 });
+program.command("reconnect").description(
+  "Re-run configure for an already-paired runtime, KEEPING the token + enrolled key (no re-pair). Re-writes configs/hooks to this install and refreshes the agent instructions."
+).option("--runtime <id>", "Target runtime (defaults to the recorded runtime from the last connect/init)").action(async (opts) => {
+  const { runReconnect } = await import("./connect-handler-NJ4FZIAM.js");
+  const result = await runReconnect({ ...opts.runtime ? { runtime: opts.runtime } : {} });
+  for (const m of result.messages) console.error(m);
+  console.error(result.output);
+  process.exit(result.exitCode);
+});
 program.command("hook").description("Run a kojee MCP hook script (called by Claude Code via ~/.claude/settings.json)").requiredOption(
   "--type <type>",
   "Hook type: stop, user-prompt-submit, codex-stop, or codex-prompt-submit"
 ).action(async (opts) => {
   if (opts.type === "stop") {
-    const { runStopHook } = await import("./stop-hook-4MNOSDCB.js");
+    const { runStopHook } = await import("./stop-hook-Y34L3RCR.js");
     await runStopHook();
     process.exit(0);
   } else if (opts.type === "user-prompt-submit") {
@@ -71,11 +79,11 @@ program.command("hook").description("Run a kojee MCP hook script (called by Clau
     await runUserPromptSubmitHook();
     process.exit(0);
   } else if (opts.type === "codex-stop") {
-    const { runCodexStopHook } = await import("./codex-stop-hook-32W4BIOM.js");
+    const { runCodexStopHook } = await import("./codex-stop-hook-M3LEWCNP.js");
     await runCodexStopHook();
     process.exit(0);
   } else if (opts.type === "codex-prompt-submit") {
-    const { runCodexPromptSubmitHook } = await import("./codex-prompt-submit-hook-J5PZEJSK.js");
+    const { runCodexPromptSubmitHook } = await import("./codex-prompt-submit-hook-ACDZSHHC.js");
     await runCodexPromptSubmitHook();
     process.exit(0);
   } else {
@@ -86,7 +94,7 @@ program.command("hook").description("Run a kojee MCP hook script (called by Clau
   }
 });
 program.command("install-hooks").description("Install kojee Stop + UserPromptSubmit hooks in ~/.claude/settings.json (idempotent)").option("--hooks-path <path>", "Override default ~/.claude/settings.json").option("--uninstall", "Remove kojee hook entries instead of installing them").action(async (opts) => {
-  const { installHooks, uninstallHooks } = await import("./install-JQNDGAAQ.js");
+  const { installHooks, uninstallHooks } = await import("./install-NG366AOQ.js");
   if (opts.uninstall) {
     const removed = uninstallHooks({ hooksPath: opts.hooksPath });
     console.error(removed ? "Removed kojee hook entries." : "No kojee hook entries found.");
@@ -114,17 +122,20 @@ program.command("send <tandem_id>").description(
   process.stdout.write(JSON.stringify(envelope) + "\n");
   process.exit(exitCode);
 });
-program.command("tail <path>").description("Stream a file's contents and follow appends (portable replacement for `tail -F`)").action(async (filePath) => {
-  const { runTail } = await import("./tail-stream-G4WGTXDS.js");
+program.command("tail <path>").description("Stream a file's contents and follow appends (portable replacement for `tail -F`)").option(
+  "--wake-only",
+  "Suppress routine heartbeat warn/recover telemetry; surface only a sustained stream outage"
+).action(async (filePath, opts) => {
+  const { runTail } = await import("./tail-stream-HG4BKJOG.js");
   try {
-    await runTail(filePath);
+    await runTail(filePath, { wakeOnly: opts.wakeOnly === true });
   } catch (err) {
     console.error("[kojee-mcp tail] Error:", err.message);
     process.exit(1);
   }
 });
 program.command("doctor").description("Diagnose the kojee wake path (proxy, hook-server, SSE stream, event log, Monitor) and print the exact wake recipe").action(async () => {
-  const { runDoctor } = await import("./doctor-RKLXZR2B.js");
+  const { runDoctor } = await import("./doctor-KMYKRYPE.js");
   const code = await runDoctor();
   process.exit(code);
 });
@@ -143,7 +154,7 @@ function addInstallOptions(cmd, runtimeHelp) {
 function makeInstallAction(verb) {
   return async (opts) => {
     const interactive = process.stdin.isTTY === true && opts.runtime === void 0;
-    const { runSetup, resolvePairCode } = await import("./setup-handler-DA4465VH.js");
+    const { runSetup, resolvePairCode } = await import("./setup-handler-I7ZEZTKW.js");
     const pairCode = resolvePairCode(opts);
     const result = await runSetup({
       verb,

package/dist/{codex-prompt-submit-hook-J5PZEJSK.js → codex-prompt-submit-hook-ACDZSHHC.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-IZN7IZPW.js";
 import {
   CODEX_WAKE_BELL
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 
 // src/hooks/codex-prompt-submit-hook.ts
 function buildCodexPromptSubmitOutput() {

package/dist/{codex-stop-hook-32W4BIOM.js → codex-stop-hook-M3LEWCNP.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-IZN7IZPW.js";
 import {
   CODEX_WAKE_BELL
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 
 // src/hooks/codex-stop-hook.ts
 import fs from "fs";

package/dist/{connect-handler-NCHC6WPU.js → connect-handler-NJ4FZIAM.js}

@@ -2,17 +2,19 @@ import {
   DEFAULT_BROKER_URL,
   reconcileConnectPairSlot,
   runWizard
-} from "./chunk-CPOK642I.js";
-import "./chunk-6XWTUDWW.js";
+} from "./chunk-ZUF47CPP.js";
+import "./chunk-376ZI3J7.js";
 import "./chunk-E6WMFMM2.js";
 import "./chunk-GEGUWQYT.js";
 import "./chunk-77HWBSRH.js";
-import "./chunk-TMCNB4JH.js";
 import "./chunk-D6JKFJ6A.js";
+import "./chunk-COM6435C.js";
 import {
   CONNECT_RUNTIMES
 } from "./chunk-EIH2LNF4.js";
-import "./chunk-RDLF4NQC.js";
+import {
+  readRecordedRuntime
+} from "./chunk-RDLF4NQC.js";
 import "./chunk-SQL56SEB.js";
 import "./chunk-V5VZPYMZ.js";
 import {
@@ -30,10 +32,10 @@ import {
   deriveKeystorePath
 } from "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
-import "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+import "./chunk-O4JQY7IF.js";
 
 // src/wizard/connect-handler.ts
+import fs from "fs";
 import os from "os";
 import path from "path";
 function absConfigPath(runtime) {
@@ -140,7 +142,63 @@ Start (or restart) the hermes daemon to pick up the connection.`,
     exitCode: 0
   };
 }
+async function runReconnect(opts = {}) {
+  const messages = [];
+  const runtime = opts.runtime ?? readRecordedRuntime() ?? null;
+  if (!runtime) {
+    return {
+      messages,
+      output: `reconnect: no runtime recorded on this box \u2014 pass --runtime (${CONNECT_RUNTIMES.join(" | ")} | hermes), or run \`kojee-mcp connect <code> --runtime <id>\` first.`,
+      exitCode: 2
+    };
+  }
+  const isHermes = runtime === "hermes";
+  if (!isHermes && !CONNECT_RUNTIMES.includes(runtime)) {
+    return {
+      messages,
+      output: `reconnect supports: ${CONNECT_RUNTIMES.join(", ")}, hermes. Unknown --runtime "${runtime}".`,
+      exitCode: 2
+    };
+  }
+  const configPath = isHermes ? pairedConfigPath() : absConfigPath(runtime);
+  const paired = loadPairedConfig(configPath);
+  if (!paired?.token) {
+    return {
+      messages,
+      output: `reconnect: no paired config at ${configPath} \u2014 nothing to keep. Run \`kojee-mcp connect <code> --runtime ${runtime}\` to pair first.`,
+      exitCode: 2
+    };
+  }
+  const keystorePath = isHermes ? defaultPairedKeystorePath() : deriveKeystorePath(paired.token);
+  if (!fs.existsSync(keystorePath)) {
+    messages.push(
+      `\u26A0 enrolled keystore MISSING at ${keystorePath} \u2014 configs will be refreshed, but the proxy cannot authenticate with a new key on this token (backend rejects double-enroll). If sends fail, re-pair with a fresh code.`
+    );
+  }
+  const wizard = opts.runWizard ?? runWizard;
+  const wiz = await wizard({
+    runtime,
+    ...isHermes ? {} : { pairedConfigPath: configPath },
+    interactive: false
+  });
+  if (wiz.exitCode !== 0) {
+    return { messages, output: wiz.output, exitCode: wiz.exitCode };
+  }
+  const label = identityLabel(paired);
+  return {
+    messages,
+    output: [
+      `\u21BB reconfigured ${runtime} as ${label} \u2014 token KEPT (no re-pair, no key re-enrollment).`,
+      "Configs + hooks re-written to this install; agent instructions refreshed below.",
+      `Restart ${runtime} to pick up the changes.`,
+      "",
+      wiz.output
+    ].join("\n"),
+    exitCode: 0
+  };
+}
 export {
   runConnect,
-  runConnectHermes
+  runConnectHermes,
+  runReconnect
 };

package/dist/{doctor-RKLXZR2B.js → doctor-KMYKRYPE.js}

@@ -1,3 +1,7 @@
+import {
+  classifyHookCommand,
+  isKojeeHookCommand
+} from "./chunk-COM6435C.js";
 import "./chunk-XLKGPGZT.js";
 import {
   loadControlToken
@@ -18,7 +22,7 @@ import "./chunk-U5HHHRXA.js";
 import {
   buildMonitorSpawn,
   buildReplyRecipe
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 import {
   deriveDiscoveryKey,
   findClaudeAncestorPid
@@ -149,6 +153,53 @@ async function resolveDefaultPairedScope() {
   }
   return { scope: resolution.scope, present, ...runtime ? { runtime } : {} };
 }
+function defaultReadHookCommands() {
+  try {
+    const p = path.join(os.homedir(), ".claude", "settings.json");
+    const raw = fs.readFileSync(p, "utf8");
+    const cfg = JSON.parse(raw);
+    const out = [];
+    for (const event of ["Stop", "UserPromptSubmit"]) {
+      for (const matcher of cfg.hooks?.[event] ?? []) {
+        for (const h of matcher.hooks ?? []) {
+          if (typeof h.command === "string" && isKojeeHookCommand(h.command)) out.push(h.command);
+        }
+      }
+    }
+    return out;
+  } catch {
+    return null;
+  }
+}
+var HOOK_REPIN_FIX = "fix: `npm i -g kojee-mcp` then re-run `kojee-mcp setup` (re-pins in place, no re-pair)";
+function hookPinCheck(commands) {
+  const name = "hook pin (settings.json Stop/UserPromptSubmit)";
+  if (commands === null) {
+    return { name, ok: "warn", detail: `no ~/.claude/settings.json readable \u2014 run \`kojee-mcp setup\` to install the wake hooks` };
+  }
+  if (commands.length === 0) {
+    return { name, ok: "warn", detail: `no kojee hooks installed \u2014 run \`kojee-mcp setup\` (the stop-hook is the Monitor self-heal)` };
+  }
+  const states = commands.map((c) => classifyHookCommand(c));
+  if (states.includes("pinned-broken")) {
+    return { name, ok: false, detail: `pinned cli.js is GONE \u2014 hooks are failing with exit 127 RIGHT NOW; ${HOOK_REPIN_FIX}` };
+  }
+  if (states.includes("pinned-ephemeral")) {
+    return {
+      name,
+      ok: false,
+      detail: `pinned INTO the npx cache (~/.npm/_npx/\u2026) \u2014 npx cache GC will silently kill the hooks (exit 127 every turn); ${HOOK_REPIN_FIX}`
+    };
+  }
+  if (states.includes("npx")) {
+    return {
+      name,
+      ok: "warn",
+      detail: `unpinned (npx -y) \u2014 pays npx resolution every turn and can stall on a registry fetch; ${HOOK_REPIN_FIX}`
+    };
+  }
+  return { name, ok: true, detail: `pinned to a durable binary (${commands.length} hook${commands.length === 1 ? "" : "s"})` };
+}
 async function collectDoctorReport(deps = {}) {
   const fetchFn = deps.fetchFn ?? fetch;
   const isPidAlive = deps.isPidAlive ?? defaultIsPidAlive;
@@ -183,6 +234,8 @@ async function collectDoctorReport(deps = {}) {
       detail: pairedScope.present ? "present (legacy global slot)" : "MISSING \u2014 run `kojee-mcp connect <code> --runtime <id>` (or `kojee-mcp pair`)"
     });
   }
+  const hookCommands = (deps.readHookCommands ?? defaultReadHookCommands)();
+  checks.push(hookPinCheck(hookCommands));
   let logPath = null;
   if (!discovery) {
     checks.push({
@@ -354,13 +407,13 @@ function formatDoctorReport(report) {
 async function runDoctor() {
   const { readRecordedRuntime } = await import("./runtime-record-OXRLTOLC.js");
   if (readRecordedRuntime() === "codex") {
-    const { collectCodexDoctorReport, formatCodexDoctorReport } = await import("./doctor-codex-PJFWIABF.js");
+    const { collectCodexDoctorReport, formatCodexDoctorReport } = await import("./doctor-codex-HB442SFA.js");
     const report2 = collectCodexDoctorReport();
     console.error(formatCodexDoctorReport(report2));
     return report2.verdict === "broken" ? 1 : 0;
   }
   if (readRecordedRuntime() === "openclaw") {
-    const { collectOpenclawDoctorReport, formatOpenclawDoctorReport } = await import("./doctor-openclaw-LL6NSPLC.js");
+    const { collectOpenclawDoctorReport, formatOpenclawDoctorReport } = await import("./doctor-openclaw-IWY64I2E.js");
     const report2 = collectOpenclawDoctorReport();
     console.error(formatOpenclawDoctorReport(report2));
     return report2.verdict === "broken" ? 1 : 0;

package/dist/{doctor-codex-PJFWIABF.js → doctor-codex-HB442SFA.js}

@@ -2,9 +2,12 @@ import {
   defaultCodexConfigPath,
   defaultCodexHooksPath,
   isPlaceholderWebhookUrl
-} from "./chunk-6XWTUDWW.js";
-import "./chunk-TMCNB4JH.js";
+} from "./chunk-376ZI3J7.js";
 import "./chunk-D6JKFJ6A.js";
+import {
+  classifyHookCommand,
+  isKojeeHookCommand
+} from "./chunk-COM6435C.js";
 import {
   CODEX_STATUS_STALE_MS,
   readAllCodexStatusRaw,
@@ -16,11 +19,9 @@ import {
 } from "./chunk-V5VZPYMZ.js";
 import "./chunk-U5HHHRXA.js";
 import {
+  CODEX_LISTEN_CAP_MS,
   VERSION
-} from "./chunk-5DHIUN73.js";
-import {
-  CODEX_LISTEN_CAP_MS
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 
 // src/doctor-codex.ts
 import fs from "fs";
@@ -175,6 +176,39 @@ function collectCodexDoctorReport(deps = {}) {
     ok: upsPresent ? true : "warn",
     detail: upsPresent ? "present (pending-wake catch-up at the next prompt)" : `MISSING \u2014 a silently-dropped Stop block is never re-surfaced. ${WIZARD_RERUN}`
   });
+  const codexHookCommands = [];
+  for (const event of ["Stop", "UserPromptSubmit"]) {
+    for (const e of hooksJson.hooks?.[event] ?? []) {
+      for (const h of e.hooks ?? []) {
+        if (typeof h.command === "string" && isKojeeHookCommand(h.command)) codexHookCommands.push(h.command);
+      }
+    }
+  }
+  if (codexHookCommands.length > 0) {
+    const states = codexHookCommands.map((c) => classifyHookCommand(c));
+    const repin = "fix: `npm i -g kojee-mcp` then re-run connect for codex (re-pins in place, no re-pair)";
+    if (states.includes("pinned-broken")) {
+      checks.push({
+        name: "hook pin (hooks.json)",
+        ok: false,
+        detail: `pinned cli.js is GONE \u2014 hooks fail with exit 127 RIGHT NOW; ${repin}`
+      });
+    } else if (states.includes("pinned-ephemeral")) {
+      checks.push({
+        name: "hook pin (hooks.json)",
+        ok: false,
+        detail: `pinned INTO the npx cache (~/.npm/_npx/\u2026) \u2014 cache GC will silently kill the hooks (exit 127 every turn); ${repin}`
+      });
+    } else if (states.includes("npx")) {
+      checks.push({
+        name: "hook pin (hooks.json)",
+        ok: "warn",
+        detail: `unpinned (npx -y) \u2014 pays npx resolution every turn and can stall on a registry fetch; ${repin}`
+      });
+    } else {
+      checks.push({ name: "hook pin (hooks.json)", ok: true, detail: "pinned to a durable binary" });
+    }
+  }
   const featureHooks = parseCodexFeatureHooks(toml);
   if (featureHooks !== true) {
     checks.push({

package/dist/{doctor-openclaw-LL6NSPLC.js → doctor-openclaw-IWY64I2E.js}

@@ -5,7 +5,7 @@ import {
 import "./chunk-D6JKFJ6A.js";
 import {
   resolveOpenclawWakeTarget
-} from "./chunk-NE2F5CKS.js";
+} from "./chunk-LKGKDZSO.js";
 import "./chunk-SQL56SEB.js";
 import {
   loadPairedConfig,

package/dist/index.js

@@ -1,17 +1,16 @@
 import {
   listTandemIds,
   startProxy
-} from "./chunk-4ATSAH7H.js";
-import "./chunk-TCWIXG5C.js";
+} from "./chunk-HRDASFRF.js";
+import "./chunk-XYDNRVOU.js";
 import "./chunk-TBVJOXIR.js";
 import "./chunk-Z5LPNJQ6.js";
 import "./chunk-I67C2HYA.js";
 import "./chunk-MIEI4PLB.js";
 import "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
-import "./chunk-A4IOKD4Z.js";
-import "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+import "./chunk-S35ZIVOL.js";
+import "./chunk-O4JQY7IF.js";
 import "./chunk-PPTKGWFF.js";
 import "./chunk-XJEBJIQE.js";
 import "./chunk-SRLD2UY7.js";

package/dist/{install-JQNDGAAQ.js → install-NG366AOQ.js}

@@ -1,10 +1,10 @@
-import {
-  buildHookCommand,
-  isKojeeHookCommand
-} from "./chunk-TMCNB4JH.js";
 import {
   wrapNpxLauncher
 } from "./chunk-D6JKFJ6A.js";
+import {
+  buildHookCommand,
+  isKojeeHookCommand
+} from "./chunk-COM6435C.js";
 import {
   secureFile
 } from "./chunk-U5HHHRXA.js";

package/dist/{registry-DKWVVXJM.js → registry-NLRXVII7.js}

@@ -5,20 +5,19 @@ import {
 } from "./chunk-XLRF5ATG.js";
 import {
   createCachedOpenclawWakeResolver,
-  postOpenclawWake
-} from "./chunk-NE2F5CKS.js";
+  postOpenclawAgent
+} from "./chunk-LKGKDZSO.js";
 import "./chunk-PHXO5P25.js";
 import {
   recordDelivered
 } from "./chunk-IZN7IZPW.js";
 import {
   claudeCodeAdapter
-} from "./chunk-TCWIXG5C.js";
-import "./chunk-A4IOKD4Z.js";
+} from "./chunk-XYDNRVOU.js";
+import "./chunk-S35ZIVOL.js";
 import {
   VERSION
-} from "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 import "./chunk-PPTKGWFF.js";
 
 // src/delivery/lib/fanout.ts
@@ -127,7 +126,7 @@ function createClaudeCodeDelivery() {
       const { resolveWebhookConfig } = await import("./webhook-config-O4WMQ532.js");
       const { createWebhookSink } = await import("./webhook-sink-N6AUTFL3.js");
       const { startEventStream } = await import("./event-stream-ATKYXDBV.js");
-      const { createMcpServer } = await import("./server-DU3LFS32.js");
+      const { createMcpServer } = await import("./server-RK4UK6SP.js");
       const { deriveDiscoveryKey } = await import("./ancestry-A2F5KQ6A.js");
       const { resolveSharedSessionId } = await import("./cc-session-id-NNCZCHZZ.js");
       sweepStaleDiscovery();
@@ -324,7 +323,7 @@ function createWebhookDelivery(name, pendingLedger) {
       const { createWebhookSink } = await import("./webhook-sink-N6AUTFL3.js");
       const { resubscribeMemberships } = await import("./resubscribe-G5OGDZJD.js");
       const { startEventStream } = await import("./event-stream-ATKYXDBV.js");
-      const { createMcpServer } = await import("./server-DU3LFS32.js");
+      const { createMcpServer } = await import("./server-RK4UK6SP.js");
       sweepStaleEventLogs();
       eventLog = startEventLog({
         key: ctx.instanceKey,
@@ -501,14 +500,13 @@ function createCodexDelivery(onDelivered) {
 }
 
 // src/delivery/openclaw.ts
-function formatOpenclawNudge(event) {
-  const who = event.from?.member_id ?? "someone";
-  const body = (event.content?.body ?? "").replace(/\s+/g, " ").slice(0, 160);
-  return `New Kojee Tandem activity in ${event.tandem_id} from ${who}: "${body}". Catch up with tandem_messages / tandem_listen and reply via tandem_send.`;
+function formatOpenclawAgentPrompt(event) {
+  const since = Math.max(0, (event.cursor ?? 1) - 1);
+  return `You were mentioned in Kojee Tandem ${event.tandem_id}. Read it to see who and what \u2014 tandem_messages(tandem_id="${event.tandem_id}", since=${since}) \u2014 then REPLY IN THE FORUM now with tandem_send(tandem_id="${event.tandem_id}", body=..., reply_to="${event.id}"). Do this now; don't just read or ack.`;
 }
 function createOpenclawDelivery(deps = {}) {
   const resolveTarget = deps.resolveTarget ?? createCachedOpenclawWakeResolver();
-  const postWake = deps.postWake ?? postOpenclawWake;
+  const postAgent = deps.postAgent ?? postOpenclawAgent;
   let eventLog = null;
   let streamHandle = null;
   let warnedUnconfigured = false;
@@ -518,7 +516,7 @@ function createOpenclawDelivery(deps = {}) {
       const { startEventLog, sweepStaleEventLogs } = await import("./event-log-2NBJEIEP.js");
       const { resubscribeMemberships } = await import("./resubscribe-G5OGDZJD.js");
       const { startEventStream } = await import("./event-stream-ATKYXDBV.js");
-      const { createMcpServer } = await import("./server-DU3LFS32.js");
+      const { createMcpServer } = await import("./server-RK4UK6SP.js");
       sweepStaleEventLogs();
       eventLog = startEventLog({
         key: ctx.instanceKey,
@@ -587,8 +585,13 @@ function createOpenclawDelivery(deps = {}) {
           return;
         }
         warnedUnconfigured = false;
-        const res = await postWake(r.target, { text: formatOpenclawNudge(event), mode: "now" });
-        if (!res.ok) console.error(`[openclaw] wake POST failed: ${res.error ?? res.status}`);
+        const res = await postAgent(r.target, {
+          message: formatOpenclawAgentPrompt(event),
+          channel: "last",
+          name: "Kojee",
+          wakeMode: "now"
+        });
+        if (!res.ok) console.error(`[openclaw] agent wake POST failed: ${res.error ?? res.status}`);
       })().catch((err) => {
         console.error("[openclaw] wake delivery failed:", err);
       });
@@ -615,7 +618,7 @@ function selectDelivery(runtime, opts) {
     return createCodexDelivery(opts.onDelivered);
   }
   if (runtime === "openclaw") {
-    return createOpenclawDelivery();
+    return opts.headless ? createOpenclawDelivery() : null;
   }
   if (!needsWebhookEventStream(opts.env)) {
     return null;

package/dist/{server-DU3LFS32.js → server-RK4UK6SP.js}

@@ -5,9 +5,8 @@ import {
   executeToolCall,
   extractDrainCursor,
   startMcpServer
-} from "./chunk-A4IOKD4Z.js";
-import "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+} from "./chunk-S35ZIVOL.js";
+import "./chunk-O4JQY7IF.js";
 import "./chunk-PPTKGWFF.js";
 export {
   buildChannelInstructions,

package/dist/{setup-handler-DA4465VH.js → setup-handler-I7ZEZTKW.js}

@@ -3,15 +3,15 @@ import {
   pairSlotFor,
   reconcileConnectPairSlot,
   runWizard
-} from "./chunk-CPOK642I.js";
-import "./chunk-6XWTUDWW.js";
+} from "./chunk-ZUF47CPP.js";
+import "./chunk-376ZI3J7.js";
 import "./chunk-E6WMFMM2.js";
 import "./chunk-GEGUWQYT.js";
 import {
   isWizardRuntime
 } from "./chunk-77HWBSRH.js";
-import "./chunk-TMCNB4JH.js";
 import "./chunk-D6JKFJ6A.js";
+import "./chunk-COM6435C.js";
 import "./chunk-EIH2LNF4.js";
 import "./chunk-RDLF4NQC.js";
 import "./chunk-SQL56SEB.js";
@@ -26,8 +26,7 @@ import "./chunk-I67C2HYA.js";
 import "./chunk-MIEI4PLB.js";
 import "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
-import "./chunk-5DHIUN73.js";
-import "./chunk-FJUAMJHU.js";
+import "./chunk-O4JQY7IF.js";
 
 // src/wizard/setup-handler.ts
 var SETUP_SUPPORTED_RUNTIMES = ["claude-code", "codex"];

package/dist/{stop-hook-4MNOSDCB.js → stop-hook-Y34L3RCR.js}

@@ -19,7 +19,7 @@ import "./chunk-67F67AQ6.js";
 import "./chunk-U5HHHRXA.js";
 import {
   buildMonitorNudge
-} from "./chunk-FJUAMJHU.js";
+} from "./chunk-O4JQY7IF.js";
 import "./chunk-XJEBJIQE.js";
 import "./chunk-SRLD2UY7.js";
 

package/dist/{tail-stream-G4WGTXDS.js → tail-stream-HG4BKJOG.js}

@@ -16,6 +16,7 @@ import "./chunk-U5HHHRXA.js";
 
 // src/tail-stream.ts
 import fs from "fs";
+import { spawn } from "child_process";
 var STATUS_LINE_RE = new RegExp(`^\\[[^\\]]*\\] ${STATUS_LINE_PREFIX} (.*)$`);
 var HEARTBEAT_FIELDS_RE = /(^|\s)status=heartbeat(\s|$)/;
 var ROTATED_FIELDS_RE = /(^|\s)status=rotated(\s|$)/;
@@ -29,6 +30,7 @@ var TAIL_STALE_FLOOR_MS = envInt(
 );
 var STALE_CHECK_INTERVAL_MS = envInt("KOJEE_TAIL_CHECK_MS", 5e3);
 var TAIL_REWARN_AFTER_MS = 30 * 6e4;
+var SUSTAINED_STALE_MS = envInt("KOJEE_TAIL_SUSTAINED_MS", TAIL_REWARN_AFTER_MS);
 var TAIL_HEALTHY_RESET_MS = 30 * 6e4;
 var TAIL_BACKOFF_CAP_CYCLES = 3;
 function envInt(name, fallback) {
@@ -99,9 +101,13 @@ function createStallDetector(startNow, options = {}) {
     }
   };
 }
-async function runTail(messagesPath) {
+async function runTail(messagesPath, opts = {}) {
+  const wakeOnly = opts.wakeOnly === true;
   const statusPath = statusLogPath(messagesPath);
-  const detector = createStallDetector(Date.now(), { floorMs: TAIL_STALE_FLOOR_MS });
+  const detector = createStallDetector(Date.now(), {
+    floorMs: TAIL_STALE_FLOOR_MS,
+    rewarnAfterMs: SUSTAINED_STALE_MS
+  });
   const heartbeatPath = monitorHeartbeatPath(messagesPath);
   const touchHeartbeat = () => {
     const now = /* @__PURE__ */ new Date();
@@ -116,7 +122,7 @@ async function runTail(messagesPath) {
   };
   let lastCursor = null;
   function onMessageLine(line) {
-    if (detector.onLife(Date.now())?.kind === "recovered") {
+    if (detector.onLife(Date.now())?.kind === "recovered" && !wakeOnly) {
       process.stdout.write(
         "[kojee] stream recovered \u2014 events flowing again (recovery is automatic; no action needed).\n"
       );
@@ -133,7 +139,7 @@ async function runTail(messagesPath) {
     if (HEARTBEAT_FIELDS_RE.test(fields)) {
       detector.onHeartbeat(now);
     }
-    if (detector.onLife(now)?.kind === "recovered") {
+    if (detector.onLife(now)?.kind === "recovered" && !wakeOnly) {
       process.stdout.write(
         "[kojee] stream recovered \u2014 heartbeats resumed (the stall was transient, likely idle-period timing or brief host load; no action needed).\n"
       );
@@ -149,7 +155,12 @@ async function runTail(messagesPath) {
     }
   }
   const followers = [
-    makeFollower(messagesPath, onMessageLine, touchHeartbeat),
+    // MESSAGES (wake-critical) — prefer the OS `tail -F` follower where the
+    // platform has one; it delegates file-following to the battle-tested system
+    // binary instead of the Node fs.watch/poll tailer. STATUS (telemetry) stays
+    // on the Node follower: its startup-backlog seeding boundary (statusSeeded)
+    // is clean to detect only when we control the drain. See makeMessagesFollower.
+    makeMessagesFollower(messagesPath, onMessageLine, touchHeartbeat),
     makeFollower(statusPath, onStatusLine, touchHeartbeat)
   ];
   void Promise.all([
@@ -171,6 +182,7 @@ async function runTail(messagesPath) {
       );
       return;
     }
+    if (wakeOnly) return;
     const thresholdS = Math.round((signal.thresholdMs ?? 0) / 1e3);
     process.stdout.write(
       `[kojee] WARNING: no events or heartbeat for ${silentS}s (threshold ${thresholdS}s) \u2014 stream may be dead, but this is often benign (idle stream, or brief host load delaying heartbeats) and recovery is automatic; if it persists, run \`npx kojee-mcp doctor\`.
@@ -273,11 +285,99 @@ function makeFollower(filePath, onLine, onActivity) {
     }
   };
 }
+function osTailAvailable() {
+  const override = (process.env.KOJEE_TAIL_IMPL ?? "").trim().toLowerCase();
+  if (override === "os") return true;
+  if (override === "node") return false;
+  return process.platform !== "win32";
+}
+function makeMessagesFollower(filePath, onLine, onActivity) {
+  if (!osTailAvailable()) return makeFollower(filePath, onLine, onActivity);
+  return makeTailFollower(
+    filePath,
+    onLine,
+    onActivity,
+    () => makeFollower(filePath, onLine, onActivity)
+  );
+}
+function makeTailFollower(filePath, onLine, onActivity, fallback) {
+  let child = null;
+  let heir = null;
+  let hbTimer = null;
+  let buffer = "";
+  let stopped = false;
+  let handedOff = false;
+  function emit(chunk) {
+    onActivity();
+    buffer += chunk;
+    let nl;
+    while ((nl = buffer.indexOf("\n")) !== -1) {
+      onLine(buffer.slice(0, nl));
+      buffer = buffer.slice(nl + 1);
+    }
+  }
+  function handOff() {
+    if (stopped || handedOff) return;
+    handedOff = true;
+    if (hbTimer) {
+      clearInterval(hbTimer);
+      hbTimer = null;
+    }
+    if (child) {
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+      child = null;
+    }
+    heir = fallback();
+    void heir.start().catch(() => {
+    });
+  }
+  return {
+    async start() {
+      try {
+        child = spawn("tail", ["-n", "+1", "-F", filePath], {
+          stdio: ["ignore", "pipe", "ignore"]
+        });
+      } catch {
+        handOff();
+        return;
+      }
+      child.on("error", () => handOff());
+      child.on("exit", () => {
+        if (!stopped) handOff();
+      });
+      child.stdout?.setEncoding("utf8");
+      child.stdout?.on("data", (d) => emit(d));
+      onActivity();
+      hbTimer = setInterval(onActivity, 1e3);
+    },
+    stop() {
+      stopped = true;
+      if (hbTimer) {
+        clearInterval(hbTimer);
+        hbTimer = null;
+      }
+      if (child) {
+        try {
+          child.kill("SIGTERM");
+        } catch {
+        }
+        child = null;
+      }
+      if (heir) heir.stop();
+    }
+  };
+}
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 export {
   createStallDetector,
   makeFollower,
+  makeMessagesFollower,
+  makeTailFollower,
+  osTailAvailable,
   runTail
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kojee-mcp",
-  "version": "0.7.5-staging.6",
+  "version": "0.7.5-staging.8",
   "type": "module",
   "main": "dist/index.js",
   "exports": {

package/dist/chunk-5DHIUN73.js

@@ -1,25 +0,0 @@
-// src/version.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-var FALLBACK_VERSION = "0.0.0-unknown";
-function resolveVersion() {
-  try {
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const parsed = JSON.parse(
-      fs.readFileSync(path.join(here, "..", "package.json"), "utf8")
-    );
-    return typeof parsed?.version === "string" && parsed.version ? parsed.version : FALLBACK_VERSION;
-  } catch (err) {
-    process.stderr.write(
-      `kojee-mcp: could not resolve version from package.json, falling back to ${FALLBACK_VERSION}: ${String(err)}
-`
-    );
-    return FALLBACK_VERSION;
-  }
-}
-var VERSION = resolveVersion();
-
-export {
-  VERSION
-};

package/dist/chunk-TMCNB4JH.js

@@ -1,33 +0,0 @@
-// src/hooks/hook-command.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-function npxHookCommand(type) {
-  return `npx -y kojee-mcp hook --type=${type}`;
-}
-function resolveCliEntry(moduleUrl = import.meta.url) {
-  try {
-    const here = fileURLToPath(moduleUrl);
-    const candidate = path.join(path.dirname(here), "cli.js");
-    return fs.existsSync(candidate) ? candidate : null;
-  } catch {
-    return null;
-  }
-}
-function buildHookCommand(type, opts = {}) {
-  const cliEntry = opts.cliEntry !== void 0 ? opts.cliEntry : resolveCliEntry();
-  if (!cliEntry) return npxHookCommand(type);
-  const execPath = opts.execPath ?? process.execPath;
-  return `"${execPath}" "${cliEntry}" hook --type=${type}`;
-}
-var PINNED_HOOK_RE = /^"[^"]+" "[^"]+" hook --type=(stop|user-prompt-submit|codex-stop|codex-prompt-submit)$/;
-function isKojeeHookCommand(command) {
-  if (command.startsWith("npx -y kojee-mcp hook --type=")) return true;
-  return PINNED_HOOK_RE.test(command);
-}
-
-export {
-  npxHookCommand,
-  buildHookCommand,
-  isKojeeHookCommand
-};