kojee-mcp 0.7.1 → 0.7.3

package/dist/chunk-XLRF5ATG.js

@@ -0,0 +1,103 @@
+// src/delivery/codex-status.ts
+import fs from "fs";
+import fsp from "fs/promises";
+import os from "os";
+import path from "path";
+import crypto from "crypto";
+var CODEX_STATUS_HEARTBEAT_MS = 6e4;
+var CODEX_STATUS_STALE_MS = 5 * 6e4;
+function codexStatusDir() {
+  return path.join(os.homedir(), ".kojee");
+}
+function codexStatusPath(pid = process.pid) {
+  return path.join(codexStatusDir(), `codex-status-${pid}.json`);
+}
+var STATUS_FILE_RE = /^codex-status(?:-(\d+))?\.json$/;
+function readAllCodexStatusRaw() {
+  const dir = codexStatusDir();
+  let names;
+  try {
+    names = fs.readdirSync(dir);
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const name of names.filter((n) => STATUS_FILE_RE.test(n)).sort()) {
+    try {
+      out.push(fs.readFileSync(path.join(dir, name), "utf8"));
+    } catch {
+    }
+  }
+  return out;
+}
+async function sweepDeadCodexStatusFiles(isPidAlive = defaultIsPidAlive) {
+  const dir = codexStatusDir();
+  let names;
+  try {
+    names = await fsp.readdir(dir);
+  } catch {
+    return;
+  }
+  for (const name of names) {
+    const m = STATUS_FILE_RE.exec(name);
+    if (!m) continue;
+    const full = path.join(dir, name);
+    let pid = m[1] ? Number(m[1]) : null;
+    if (pid === null) {
+      try {
+        pid = readCodexStatus(await fsp.readFile(full, "utf8"))?.pid ?? null;
+      } catch {
+        pid = null;
+      }
+    }
+    if (pid === process.pid) continue;
+    if (pid !== null && isPidAlive(pid)) continue;
+    try {
+      await fsp.unlink(full);
+    } catch {
+    }
+  }
+}
+function defaultIsPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err?.code === "EPERM";
+  }
+}
+function readCodexStatus(raw) {
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed) || typeof parsed.pid !== "number" || typeof parsed.updated_at !== "string" || typeof parsed.stream !== "object" || parsed.stream === null) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+async function writeCodexStatus(status) {
+  const statusPath = codexStatusPath(status.pid);
+  const tmp = `${statusPath}.tmp-${process.pid}-${crypto.randomUUID()}`;
+  try {
+    await fsp.mkdir(path.dirname(statusPath), { recursive: true });
+    await fsp.writeFile(tmp, JSON.stringify(status, null, 2), { mode: 384 });
+    await fsp.rename(tmp, statusPath);
+  } catch {
+    try {
+      await fsp.unlink(tmp);
+    } catch {
+    }
+  }
+}
+
+export {
+  CODEX_STATUS_HEARTBEAT_MS,
+  CODEX_STATUS_STALE_MS,
+  readAllCodexStatusRaw,
+  sweepDeadCodexStatusFiles,
+  readCodexStatus,
+  writeCodexStatus
+};

package/dist/{chunk-UFHGZUST.js → chunk-XPIW4N55.js}

@@ -1,14 +1,19 @@
-import {
-  removeOpenclawMcpServer,
-  writeOpenclawMcpConfig
-} from "./chunk-E6WMFMM2.js";
 import {
   buildCodexMcpServerTable,
+  buildCodexPromptSubmitHookBlock,
   buildCodexStopHookBlock,
   isPlaceholderWebhookUrl,
   removeCodexConfig,
   writeCodexConfig
-} from "./chunk-KPMD72FY.js";
+} from "./chunk-6XWTUDWW.js";
+import {
+  removeOpenclawMcpServer,
+  writeOpenclawMcpConfig
+} from "./chunk-E6WMFMM2.js";
+import {
+  WIZARD_RUNTIMES,
+  isWizardRuntime
+} from "./chunk-77HWBSRH.js";
 import {
   CONNECT_RUNTIMES
 } from "./chunk-EIH2LNF4.js";
@@ -20,10 +25,6 @@ import {
 import {
   kojeeHomeDir
 } from "./chunk-SQL56SEB.js";
-import {
-  WIZARD_RUNTIMES,
-  isWizardRuntime
-} from "./chunk-77HWBSRH.js";
 import {
   resolveSignatureEmission,
   resolveWebhookConfig
@@ -48,7 +49,7 @@ import {
   CODEX_LISTEN_CAP_MS,
   buildCondensedTandemRules,
   buildWebhookReceiverNote
-} from "./chunk-SSW5AQSR.js";
+} from "./chunk-FJUAMJHU.js";
 
 // src/wizard/pair-slot.ts
 import fs from "fs";
@@ -789,7 +790,7 @@ function whatHappensNext(runtime, opts) {
   return lines.join("\n");
 }
 async function configureClaudeCode(opts) {
-  const { runInit } = await import("./install-V7LSQCYZ.js");
+  const { runInit } = await import("./install-JQNDGAAQ.js");
   const report = runInit({
     ...opts.configPath ? { configPath: opts.configPath } : {},
     ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {},
@@ -853,7 +854,7 @@ function configureCodex(opts) {
   const secret = connectPairedMode || !hasRealUrl ? void 0 : wh.secret || generateWebhookSecret();
   const tokenArgs = opts.token && opts.url ? { token: opts.token, url: opts.url } : {};
   const pairedArgs = opts.pairedConfigPath ? { pairedConfigPath: opts.pairedConfigPath } : {};
-  writeCodexConfig({
+  const writeResult = writeCodexConfig({
     ...opts.configPath ? { configPath: opts.configPath } : {},
     ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {},
     ...url !== void 0 ? { webhookUrl: url } : {},
@@ -885,9 +886,16 @@ function configureCodex(opts) {
   })));
   if (wh.warning) lines.push(`webhook WARNING: ${wh.warning}`);
   lines.push("");
-  lines.push("Wrote the Codex Stop hook (~/.codex/hooks.json; inline TOML form):");
+  lines.push("Wrote the Codex Stop + UserPromptSubmit hooks (~/.codex/hooks.json; inline TOML form):");
   lines.push(indent(buildCodexStopHookBlock()));
+  lines.push(indent(buildCodexPromptSubmitHookBlock()));
   lines.push("");
+  if (writeResult.hooksChanged) {
+    lines.push(
+      "IMPORTANT: Codex will re-prompt to trust hooks on its next launch \u2014 approve it, or wakes silently stop."
+    );
+    lines.push("");
+  }
   lines.push(
     connectPairedMode ? "webhook: (unchanged \u2014 `connect` rewrites only the credential args, not the wake path)" : `webhook: ${wh.url ? wh.redactedSummary : "OPTIONAL \u2014 not configured (wake is self-contained; set KOJEE_WEBHOOK_URL only for an extra low-latency push path)"}`
   );
@@ -1027,7 +1035,7 @@ 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-V7LSQCYZ.js");
+    const { runUninstall } = await import("./install-JQNDGAAQ.js");
     const report = runUninstall({
       ...opts.configPath ? { configPath: opts.configPath } : {},
       ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {}

package/dist/cli.js

@@ -4,25 +4,25 @@ import {
 } from "./chunk-EIAUW6KO.js";
 import {
   startProxy
-} from "./chunk-FBJCPRVH.js";
-import "./chunk-UPJV7GBE.js";
+} from "./chunk-ABECLEYE.js";
+import "./chunk-TCWIXG5C.js";
 import {
   pairedConfigPath
 } from "./chunk-5SZHXYPK.js";
 import "./chunk-247WFMCJ.js";
-import "./chunk-I67C2HYA.js";
 import "./chunk-Z5LPNJQ6.js";
+import "./chunk-I67C2HYA.js";
 import "./chunk-MIEI4PLB.js";
 import {
   defaultPairedKeystorePath,
   deriveKeystorePath
 } from "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
-import "./chunk-GNLCUJBK.js";
+import "./chunk-A4IOKD4Z.js";
 import {
   VERSION
 } from "./chunk-5DHIUN73.js";
-import "./chunk-SSW5AQSR.js";
+import "./chunk-FJUAMJHU.js";
 import "./chunk-PPTKGWFF.js";
 import "./chunk-XJEBJIQE.js";
 import "./chunk-KNEJTD6G.js";
@@ -48,7 +48,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-4DRTFMOB.js");
+  const { runConnect } = await import("./connect-handler-NZINEMG3.js");
   const result = await runConnect({
     code,
     runtime: opts.runtime,
@@ -58,9 +58,12 @@ program.command("connect <code>").description(
   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, or codex-stop").action(async (opts) => {
+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-5ABGTC2O.js");
+    const { runStopHook } = await import("./stop-hook-N6TX4YQT.js");
     await runStopHook();
     process.exit(0);
   } else if (opts.type === "user-prompt-submit") {
@@ -68,16 +71,22 @@ 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-BMOJVM6O.js");
+    const { runCodexStopHook } = await import("./codex-stop-hook-32W4BIOM.js");
     await runCodexStopHook();
     process.exit(0);
+  } else if (opts.type === "codex-prompt-submit") {
+    const { runCodexPromptSubmitHook } = await import("./codex-prompt-submit-hook-J5PZEJSK.js");
+    await runCodexPromptSubmitHook();
+    process.exit(0);
   } else {
-    console.error(`Unknown hook type: ${opts.type}. Expected 'stop', 'user-prompt-submit', or 'codex-stop'.`);
+    console.error(
+      `Unknown hook type: ${opts.type}. Expected 'stop', 'user-prompt-submit', 'codex-stop', or 'codex-prompt-submit'.`
+    );
     process.exit(1);
   }
 });
 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-V7LSQCYZ.js");
+  const { installHooks, uninstallHooks } = await import("./install-JQNDGAAQ.js");
   if (opts.uninstall) {
     const removed = uninstallHooks({ hooksPath: opts.hooksPath });
     console.error(removed ? "Removed kojee hook entries." : "No kojee hook entries found.");
@@ -106,7 +115,7 @@ program.command("send <tandem_id>").description(
   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-NBGHHBS4.js");
+  const { runTail } = await import("./tail-stream-N43D53RC.js");
   try {
     await runTail(filePath);
   } catch (err) {
@@ -115,7 +124,7 @@ program.command("tail <path>").description("Stream a file's contents and follow
   }
 });
 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-5QJ3HGNR.js");
+  const { runDoctor } = await import("./doctor-WUU5BVPT.js");
   const code = await runDoctor();
   process.exit(code);
 });
@@ -134,7 +143,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-JFM45NCN.js");
+    const { runSetup, resolvePairCode } = await import("./setup-handler-44ASXYMS.js");
     const pairCode = resolvePairCode(opts);
     const result = await runSetup({
       verb,

package/dist/codex-prompt-submit-hook-J5PZEJSK.js

@@ -0,0 +1,39 @@
+import {
+  readHookStdin
+} from "./chunk-LSUB6QMP.js";
+import {
+  listPending
+} from "./chunk-IZN7IZPW.js";
+import {
+  CODEX_WAKE_BELL
+} from "./chunk-FJUAMJHU.js";
+
+// src/hooks/codex-prompt-submit-hook.ts
+function buildCodexPromptSubmitOutput() {
+  let pending;
+  try {
+    pending = listPending();
+  } catch {
+    return "{}";
+  }
+  if (pending.length === 0) return "{}";
+  return JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "UserPromptSubmit",
+      additionalContext: CODEX_WAKE_BELL
+    }
+  });
+}
+async function runCodexPromptSubmitHook() {
+  await readHookStdin();
+  let out = "{}";
+  try {
+    out = buildCodexPromptSubmitOutput();
+  } catch {
+  }
+  process.stdout.write(out);
+}
+export {
+  buildCodexPromptSubmitOutput,
+  runCodexPromptSubmitHook
+};

package/dist/codex-stop-hook-32W4BIOM.js

@@ -0,0 +1,136 @@
+import {
+  readHookStdin
+} from "./chunk-LSUB6QMP.js";
+import {
+  drainedRoomsPath,
+  listPending,
+  pendingRoomsPath
+} from "./chunk-IZN7IZPW.js";
+import {
+  CODEX_WAKE_BELL
+} from "./chunk-FJUAMJHU.js";
+
+// src/hooks/codex-stop-hook.ts
+import fs from "fs";
+import path2 from "path";
+
+// src/hooks/codex-pending-path.ts
+import path from "path";
+function codexNudgeAttemptsPath() {
+  return path.join(path.dirname(pendingRoomsPath()), "codex-nudge-attempts");
+}
+function codexWakeDropLogPath() {
+  return path.join(path.dirname(pendingRoomsPath()), "codex-pending-wake-drops.log");
+}
+
+// src/hooks/codex-stop-hook.ts
+var CODEX_PEEK_MS = clampPeekMs(
+  Number.parseInt(process.env["KOJEE_CODEX_PEEK_MS"] ?? "150", 10)
+);
+function clampPeekMs(raw) {
+  if (!Number.isFinite(raw) || raw <= 0) return 150;
+  return Math.min(raw, 500);
+}
+var MAX_NUDGES_PER_ROOM = 3;
+var ANON_KEY = "-";
+function readNudgeAttempts() {
+  const out = /* @__PURE__ */ new Map();
+  let raw;
+  try {
+    raw = fs.readFileSync(codexNudgeAttemptsPath(), "utf8");
+  } catch {
+    return out;
+  }
+  for (const line of raw.split("\n")) {
+    const parts = line.trim().split(/\s+/);
+    if (parts.length !== 3) continue;
+    const cursor = Number.parseInt(parts[1], 10);
+    const count = Number.parseInt(parts[2], 10);
+    if (!Number.isFinite(cursor) || !Number.isFinite(count) || count < 0) continue;
+    out.set(parts[0], { cursor, count });
+  }
+  return out;
+}
+function writeNudgeAttempts(attempts) {
+  const filePath = codexNudgeAttemptsPath();
+  const tmp = `${filePath}.tmp-${process.pid}`;
+  try {
+    fs.mkdirSync(path2.dirname(filePath), { recursive: true });
+    const body = Array.from(attempts.entries()).map(([key, rec]) => `${key} ${rec.cursor} ${rec.count}`).join("\n");
+    fs.writeFileSync(tmp, body === "" ? "" : body + "\n", { mode: 384 });
+    fs.renameSync(tmp, filePath);
+  } catch {
+    try {
+      fs.unlinkSync(tmp);
+    } catch {
+    }
+  }
+}
+function logCappedRoom(key, cursor, attempts) {
+  try {
+    const logPath = codexWakeDropLogPath();
+    fs.mkdirSync(path2.dirname(logPath), { recursive: true });
+    fs.appendFileSync(
+      logPath,
+      `${(/* @__PURE__ */ new Date()).toISOString()} stopped nudging room ${key} (cursor=${cursor}) after ${attempts} un-drained block attempts \u2014 either Codex is silently rejecting the Stop-hook output (run \`kojee-mcp doctor\` and approve Codex's trust prompt) or the room belongs to another session; the room stays pending in the ledger until its proxy drains it
+`,
+      { mode: 384 }
+    );
+  } catch {
+  }
+}
+function decideCodexStop(stopHookActive) {
+  if (stopHookActive) return "{}";
+  let pending;
+  try {
+    pending = listPending();
+  } catch {
+    return "{}";
+  }
+  if (pending.length === 0) return "{}";
+  const attempts = readNudgeAttempts();
+  const next = /* @__PURE__ */ new Map();
+  const nudgeable = [];
+  for (const room of pending) {
+    const key = room.tandemId ?? ANON_KEY;
+    const prior = attempts.get(key);
+    const count = prior !== void 0 && prior.cursor === room.cursor ? prior.count : 0;
+    if (count >= MAX_NUDGES_PER_ROOM) {
+      if (count === MAX_NUDGES_PER_ROOM) {
+        logCappedRoom(key, room.cursor, count);
+        next.set(key, { cursor: room.cursor, count: count + 1 });
+      } else {
+        next.set(key, { cursor: room.cursor, count });
+      }
+      continue;
+    }
+    next.set(key, { cursor: room.cursor, count: count + 1 });
+    nudgeable.push(room);
+  }
+  writeNudgeAttempts(next);
+  if (nudgeable.length === 0) return "{}";
+  return JSON.stringify({
+    decision: "block",
+    reason: CODEX_WAKE_BELL
+  });
+}
+async function runCodexStopHook() {
+  const { stopHookActive } = await readHookStdin();
+  let out = "{}";
+  try {
+    out = decideCodexStop(stopHookActive);
+  } catch {
+  }
+  process.stdout.write(out);
+}
+var CODEX_PEEK_BUDGET_MS = CODEX_PEEK_MS;
+export {
+  CODEX_PEEK_BUDGET_MS,
+  MAX_NUDGES_PER_ROOM,
+  codexNudgeAttemptsPath,
+  codexWakeDropLogPath,
+  decideCodexStop,
+  drainedRoomsPath,
+  pendingRoomsPath,
+  runCodexStopHook
+};

package/dist/{connect-handler-4DRTFMOB.js → connect-handler-NZINEMG3.js}

@@ -2,17 +2,17 @@ import {
   DEFAULT_BROKER_URL,
   reconcileConnectPairSlot,
   runWizard
-} from "./chunk-UFHGZUST.js";
+} from "./chunk-XPIW4N55.js";
+import "./chunk-6XWTUDWW.js";
 import "./chunk-E6WMFMM2.js";
-import "./chunk-KPMD72FY.js";
-import "./chunk-QJFMU4QC.js";
+import "./chunk-77HWBSRH.js";
+import "./chunk-TMCNB4JH.js";
 import "./chunk-D6JKFJ6A.js";
 import {
   CONNECT_RUNTIMES
 } from "./chunk-EIH2LNF4.js";
 import "./chunk-RDLF4NQC.js";
 import "./chunk-SQL56SEB.js";
-import "./chunk-77HWBSRH.js";
 import "./chunk-V5VZPYMZ.js";
 import {
   runPair
@@ -30,7 +30,7 @@ import {
 } from "./chunk-6G6YYST6.js";
 import "./chunk-U5HHHRXA.js";
 import "./chunk-5DHIUN73.js";
-import "./chunk-SSW5AQSR.js";
+import "./chunk-FJUAMJHU.js";
 
 // src/wizard/connect-handler.ts
 import os from "os";
@@ -48,6 +48,13 @@ function identityLabel(cfg) {
   if (cfg?.principal_id) return cfg.principal_id;
   return "this runtime";
 }
+function identityChangeWarning(runtime, oldConfig, newConfig) {
+  if (oldConfig.agent_id && newConfig?.agent_id) {
+    if (oldConfig.agent_id === newConfig.agent_id) return null;
+    return `\u26A0 WARNING: this paired ${runtime} as a NEW agent identity (${oldConfig.agent_id} \u2192 ${newConfig.agent_id}) \u2014 room seats stay with the old agent. Re-join rooms, or regenerate a code for the SAME agent in the dashboard.`;
+  }
+  return `Note: identity continuity cannot be verified for this re-connect (the broker response carries no agent id). If this code was minted for a different agent, room seats stay with the old one \u2014 re-join rooms if wakes stop.`;
+}
 async function runConnect(opts) {
   if (opts.runtime === "hermes") return runConnectHermes(opts);
   const messages = [];
@@ -89,8 +96,8 @@ async function runConnect(opts) {
   const newConfig = loadPairedConfig(configPath);
   const newLabel = identityLabel(newConfig);
   const summary = oldConfig ? `\u21BB re-connected ${runtime} as ${newLabel} (was ${identityLabel(oldConfig)})` : `\u2713 connected ${runtime} as ${newLabel} \u2192 ${url}`;
-  const output = `${summary}
-Restart ${runtime} to pick up the connection.`;
+  const warning = runtime === "codex" && oldConfig ? identityChangeWarning(runtime, oldConfig, newConfig) : null;
+  const output = [summary, ...warning ? [warning] : [], `Restart ${runtime} to pick up the connection.`].join("\n");
   return { messages, output, exitCode: 0 };
 }
 async function runConnectHermes(opts) {

package/dist/{doctor-5QJ3HGNR.js → doctor-WUU5BVPT.js}

@@ -18,7 +18,7 @@ import "./chunk-U5HHHRXA.js";
 import {
   buildMonitorSpawn,
   buildReplyRecipe
-} from "./chunk-SSW5AQSR.js";
+} from "./chunk-FJUAMJHU.js";
 import {
   deriveDiscoveryKey,
   findClaudeAncestorPid
@@ -354,7 +354,7 @@ function formatDoctorReport(report) {
 async function runDoctor() {
   const { readRecordedRuntime } = await import("./runtime-record-OXRLTOLC.js");
   if (readRecordedRuntime() === "codex") {
-    const { collectCodexDoctorReport, formatCodexDoctorReport } = await import("./doctor-codex-VGJKTX2E.js");
+    const { collectCodexDoctorReport, formatCodexDoctorReport } = await import("./doctor-codex-PJFWIABF.js");
     const report2 = collectCodexDoctorReport();
     console.error(formatCodexDoctorReport(report2));
     return report2.verdict === "broken" ? 1 : 0;