kojee-mcp 0.4.0 → 0.5.2

package/dist/wizard-7KHD5JT4.js

@@ -0,0 +1,265 @@
+import {
+  buildCodexMcpServerTable,
+  buildCodexStopHookBlock,
+  removeCodexConfig,
+  writeCodexConfig
+} from "./chunk-ZW4SW7LJ.js";
+import {
+  WIZARD_RUNTIMES,
+  isWizardRuntime
+} from "./chunk-LVL25VLO.js";
+import {
+  clearRuntimeRecord,
+  readRecordedRuntime,
+  recordRuntime
+} from "./chunk-EW72ZNQL.js";
+import {
+  kojeeHomeDir
+} from "./chunk-SQL56SEB.js";
+import {
+  CODEX_LISTEN_CAP_MS,
+  buildWebhookReceiverNote
+} from "./chunk-C6GZ2L2W.js";
+import {
+  secureFile
+} from "./chunk-BLEGIR35.js";
+import {
+  resolveWebhookConfig
+} from "./chunk-F7L25L2J.js";
+
+// src/wizard/wizard.ts
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+function generateWebhookSecret() {
+  return crypto.randomBytes(32).toString("hex");
+}
+async function resolveRuntime(opts) {
+  if (opts.runtime !== void 0) {
+    if (!isWizardRuntime(opts.runtime)) {
+      return {
+        error: `Unknown --runtime "${opts.runtime}". Expected one of: ${WIZARD_RUNTIMES.join(", ")}.`
+      };
+    }
+    return { runtime: opts.runtime };
+  }
+  if (opts.interactive && opts.promptRuntime) {
+    const picked = await opts.promptRuntime();
+    if (!isWizardRuntime(picked)) {
+      return { error: `Unknown runtime "${picked}". Expected one of: ${WIZARD_RUNTIMES.join(", ")}.` };
+    }
+    return { runtime: picked };
+  }
+  return { runtime: "claude-code" };
+}
+function resolveWizardWebhook(opts) {
+  const env = opts.env ?? process.env;
+  const url = (opts.webhookUrl ?? env["KOJEE_WEBHOOK_URL"] ?? "").trim();
+  let secret = (opts.webhookSecret ?? env["KOJEE_WEBHOOK_SECRET"] ?? "").trim();
+  if (url && !secret) secret = generateWebhookSecret();
+  const resolution = resolveWebhookConfig({
+    KOJEE_WEBHOOK_URL: url,
+    KOJEE_WEBHOOK_SECRET: secret,
+    ...env["KOJEE_WEBHOOK_TIMEOUT_MS"] !== void 0 ? { KOJEE_WEBHOOK_TIMEOUT_MS: env["KOJEE_WEBHOOK_TIMEOUT_MS"] } : {},
+    ...env["KOJEE_WEBHOOK_MAX_RETRIES"] !== void 0 ? { KOJEE_WEBHOOK_MAX_RETRIES: env["KOJEE_WEBHOOK_MAX_RETRIES"] } : {}
+  });
+  if (resolution.error) {
+    return { url, secret, redactedSummary: "", error: resolution.error };
+  }
+  return {
+    url,
+    secret,
+    redactedSummary: resolution.config?.redactedSummary ?? `url=${url} secret=<redacted>`
+  };
+}
+function writeRuntimeEnvFile(runtime, url, secret) {
+  const envPath = path.join(kojeeHomeDir(), ".kojee", `${runtime}.env`);
+  const body = [
+    `# kojee daemon env for runtime=${runtime} (source this before starting the daemon)`,
+    `export KOJEE_RUNTIME="${runtime}"`,
+    `export KOJEE_WEBHOOK_URL="${url}"`,
+    `export KOJEE_WEBHOOK_SECRET="${secret}"`,
+    ""
+  ].join("\n");
+  fs.mkdirSync(path.dirname(envPath), { recursive: true, mode: 448 });
+  fs.writeFileSync(envPath, body, { mode: 384 });
+  secureFile(envPath);
+  return envPath;
+}
+var CODEX_UNVERIFIED_NOTE = "NOTE: live Codex verification (hook fires, MCP server connects, bounded listen works) has not been run on this build \u2014 confirm in a real Codex session. This is the owner morning step.";
+async function runWizard(opts) {
+  const resolved = await resolveRuntime(opts);
+  if ("error" in resolved) {
+    return { runtime: "claude-code", output: resolved.error, exitCode: 2 };
+  }
+  const runtime = resolved.runtime;
+  if (opts.uninstall) {
+    return runWizardUninstall(runtime, opts);
+  }
+  if (runtime === "claude-code") return configureClaudeCode(opts);
+  if (runtime === "codex") return configureCodex(opts);
+  return configureWebhookDaemon(runtime, opts);
+}
+async function configureClaudeCode(opts) {
+  const { runInit } = await import("./install-WBIUVBZW.js");
+  const report = runInit({
+    ...opts.configPath ? { configPath: opts.configPath } : {},
+    ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {}
+  });
+  recordRuntime("claude-code");
+  return { runtime: "claude-code", output: formatClaudeInit(report), exitCode: 0 };
+}
+function formatClaudeInit(report) {
+  const tick = (s) => {
+    if (s === "added") return "\u2713 added";
+    if (s === "already-installed") return "\u21BB already installed";
+    if (s === "preserved-different") return "\u26A0 preserved (existing entry differs \u2014 left untouched)";
+    if (s === "not-found") return "\u2014 not found";
+    return s ?? "\u2014";
+  };
+  const lines = ["Configured runtime: claude-code", "", "Installing kojee for Claude:"];
+  for (const t of report.targets) {
+    const label = t.kind === "cli" ? "CLI" : "Claude.app";
+    lines.push("");
+    lines.push(`  ${t.path} (${label})`);
+    lines.push(`    mcpServers.kojee           ${tick(t.mcpServer)}`);
+    if (t.kind === "cli") {
+      if (t.hooksPath) lines.push(`  ${t.hooksPath} (hooks)`);
+      lines.push(`    hooks.Stop                 ${tick(t.stopHook)}`);
+      lines.push(`    hooks.UserPromptSubmit     ${tick(t.userPromptSubmitHook)}`);
+    } else {
+      lines.push(`    (hooks not applicable for Claude.app agent mode)`);
+    }
+  }
+  lines.push("");
+  if (report.targets.some((t) => t.kind === "desktop" && t.mcpServer === "added")) {
+    lines.push(
+      "Existing Claude.app agent-mode sessions snapshotted the previous config",
+      "and won't pick up this change automatically. Start a NEW agent-mode",
+      "session (not a resumed one) to use the updated kojee config.",
+      ""
+    );
+  }
+  lines.push("To verify: in any new CC session, run /mcp and confirm `kojee` is listed.");
+  lines.push("                          run /hooks and confirm both Stop and UserPromptSubmit show the kojee entries.");
+  lines.push("To remove: `kojee-mcp init --uninstall`");
+  return lines.join("\n");
+}
+function configureCodex(opts) {
+  const wh = resolveWizardWebhook(opts);
+  if (wh.error) {
+    return { runtime: "codex", output: `webhook env ERROR: ${wh.error}`, exitCode: 2 };
+  }
+  const url = wh.url || "https://YOUR-CODEX-WEBHOOK-RECEIVER.local/kojee";
+  const secret = wh.secret || generateWebhookSecret();
+  writeCodexConfig({
+    ...opts.configPath ? { configPath: opts.configPath } : {},
+    ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {},
+    webhookUrl: url,
+    webhookSecret: secret
+  });
+  recordRuntime("codex");
+  const lines = [];
+  lines.push("Configured runtime: codex");
+  lines.push("Wake mode: webhook-sink + stop-hook peek (Codex has no channel injection).");
+  lines.push("");
+  lines.push("Wrote [mcp_servers.kojee] to ~/.codex/config.toml:");
+  lines.push(indent(buildCodexMcpServerTable({ webhookUrl: url, webhookSecret: "<redacted>" })));
+  lines.push("");
+  lines.push("Wrote the Codex Stop hook (~/.codex/hooks.json; inline TOML form):");
+  lines.push(indent(buildCodexStopHookBlock()));
+  lines.push("");
+  lines.push(`webhook: ${wh.url ? wh.redactedSummary : "(receiver URL not set \u2014 fill KOJEE_WEBHOOK_URL above)"}`);
+  lines.push(`bounded-listen cap: ${CODEX_LISTEN_CAP_MS}ms (the model picks listen vs drain vs ignore).`);
+  lines.push("");
+  lines.push("Next steps (codex):");
+  lines.push("  Restart Codex (or start a new `codex` / `codex exec` session) to load the MCP server and hook.");
+  lines.push("  Stand up your webhook receiver at KOJEE_WEBHOOK_URL \u2014 contract:");
+  lines.push(indent(buildWebhookReceiverNote()));
+  lines.push("  Verify: kojee-mcp doctor");
+  lines.push("");
+  lines.push(CODEX_UNVERIFIED_NOTE);
+  return { runtime: "codex", output: lines.join("\n"), exitCode: 0 };
+}
+function configureWebhookDaemon(runtime, opts) {
+  const wh = resolveWizardWebhook(opts);
+  if (wh.error) {
+    return { runtime, output: `webhook env ERROR: ${wh.error}`, exitCode: 2 };
+  }
+  recordRuntime(runtime);
+  const lines = [];
+  lines.push(`Configured runtime: ${runtime}`);
+  lines.push("Wake mode: webhook sink (daemon-consumed). NO MCP-config file, NO hooks written.");
+  lines.push("");
+  if (wh.url) {
+    const envFile = writeRuntimeEnvFile(runtime, wh.url, wh.secret);
+    lines.push("Export these before starting the daemon (also written to a source-able file):");
+    lines.push(`  export KOJEE_RUNTIME="${runtime}"`);
+    lines.push(`  export KOJEE_WEBHOOK_URL="${wh.url}"`);
+    lines.push(`  export KOJEE_WEBHOOK_SECRET=<generated; in ${envFile}>`);
+    lines.push(`  (validated: ${wh.redactedSummary})`);
+    lines.push(`  source ${envFile}`);
+  } else {
+    lines.push("Set the daemon env (no receiver URL supplied yet):");
+    lines.push(`  export KOJEE_RUNTIME="${runtime}"`);
+    lines.push(`  export KOJEE_WEBHOOK_URL="https://YOUR-RECEIVER.local/kojee"`);
+    lines.push(`  export KOJEE_WEBHOOK_SECRET=<generate a hex secret>`);
+  }
+  lines.push("");
+  lines.push("Receiver contract:");
+  lines.push(indent(buildWebhookReceiverNote()));
+  lines.push("");
+  lines.push(`Next steps (${runtime}):`);
+  lines.push("  Start the daemon with the env above. Verify: kojee-mcp doctor (after the daemon is up).");
+  return { runtime, output: lines.join("\n"), exitCode: 0 };
+}
+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-WBIUVBZW.js");
+    const report = runUninstall({
+      ...opts.configPath ? { configPath: opts.configPath } : {},
+      ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {}
+    });
+    lines.push("Removing kojee from Claude:");
+    for (const t of report.targets) {
+      const label = t.kind === "cli" ? "CLI" : "Claude.app";
+      lines.push("");
+      lines.push(`  ${t.path} (${label})`);
+      lines.push(`    mcpServers.kojee   ${t.mcpServer ? "\u2713 removed" : "\u2014 not found"}`);
+      if (t.kind === "cli") {
+        if (t.hooksPath) lines.push(`  ${t.hooksPath} (hooks)`);
+        lines.push(`    hook entries       ${t.hooks ? "\u2713 removed" : "\u2014 not found"}`);
+      }
+    }
+  } else if (effective === "codex") {
+    const removed = removeCodexConfig({
+      ...opts.configPath ? { configPath: opts.configPath } : {},
+      ...opts.hooksPath ? { hooksPath: opts.hooksPath } : {}
+    });
+    lines.push(`  config.toml [mcp_servers.kojee]: ${removed.mcpServer ? "removed" : "not found"}`);
+    lines.push(`  hooks.json Stop: ${removed.stopHook ? "removed" : "not found"}`);
+  } else {
+    lines.push("  (hermes/openclaw write no MCP-config or hooks \u2014 nothing to tear down.");
+    lines.push("   Stop the daemon and unset KOJEE_WEBHOOK_URL/SECRET to disable the sink.)");
+    const envPath = path.join(kojeeHomeDir(), ".kojee", `${effective}.env`);
+    try {
+      fs.unlinkSync(envPath);
+      lines.push(`  removed ${envPath}`);
+    } catch {
+    }
+  }
+  clearRuntimeRecord();
+  return { runtime: effective, output: lines.join("\n"), exitCode: 0 };
+}
+function indent(s) {
+  return s.split("\n").map((l) => "    " + l).join("\n");
+}
+export {
+  CODEX_UNVERIFIED_NOTE,
+  generateWebhookSecret,
+  resolveRuntime,
+  resolveWizardWebhook,
+  runWizard
+};

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "kojee-mcp",
-  "version": "0.4.0",
+  "version": "0.5.2",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "kojee-mcp": "dist/cli.js"
   },
+  "_buildNote": "src/version.ts resolves package.json via '../package.json' from import.meta.url; this assumes dist output stays flat one level under the package root (tsup default outDir=dist, no nesting). If the build adds outDir nesting or a deeper entry, update version.ts's relative path.",
   "scripts": {
     "build": "tsup src/cli.ts src/index.ts --format esm --dts --clean",
     "dev": "tsup src/cli.ts --format esm --watch",
@@ -19,16 +20,17 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "latest",
-    "jose": "^5.0.0",
     "commander": "^12.0.0",
-    "zod": "^3.22.0",
-    "ulidx": "^2.3.0"
+    "jose": "^5.0.0",
+    "ps-list": "^8.1.1",
+    "ulidx": "^2.3.0",
+    "zod": "^3.22.0"
   },
   "devDependencies": {
-    "typescript": "^5.4.0",
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
-    "vitest": "^1.0.0",
-    "tsx": "^4.7.0"
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
   }
 }

package/dist/event-log-ETWR6PPY.js

@@ -1,112 +0,0 @@
-import {
-  sessionDiscoveryDir
-} from "./chunk-VZVGTHGF.js";
-
-// src/tandem/event-log.ts
-import fs from "fs";
-import path from "path";
-var DEFAULT_DIR = "/tmp";
-var MAX_BODY_CHARS = 200;
-var DEFAULT_MIN_AGE_MS = 6e4;
-function startEventLog(opts) {
-  const dir = opts.dir ?? DEFAULT_DIR;
-  const filePath = path.join(dir, `kojee-events-${opts.key}.log`);
-  fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(filePath, "", { mode: 384 });
-  try {
-    fs.chmodSync(filePath, 384);
-  } catch {
-  }
-  return {
-    path: filePath,
-    async append(event) {
-      const line = formatLine(event);
-      try {
-        await fs.promises.appendFile(filePath, line + "\n", { encoding: "utf8" });
-      } catch (err) {
-        console.error("[event-log] append failed:", err.message);
-      }
-    },
-    cleanup() {
-      try {
-        fs.unlinkSync(filePath);
-      } catch {
-      }
-    }
-  };
-}
-function formatLine(event) {
-  const body = (event.content?.body ?? "").replace(/[\r\n]+/g, " ").slice(0, MAX_BODY_CHARS + 1);
-  const truncated = body.length > MAX_BODY_CHARS;
-  const safeBody = truncated ? body.slice(0, MAX_BODY_CHARS) + "\u2026" : body;
-  return `[${event.time}] tandem=${event.tandem_id} from=${event.from.displayname} (${event.from.principal}) kind=${event.kind} cursor=${event.cursor}: ${safeBody}`;
-}
-function isProcessAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (err) {
-    if (err.code === "EPERM") return true;
-    return false;
-  }
-}
-function listActiveSessionIds() {
-  const dir = sessionDiscoveryDir();
-  const active = /* @__PURE__ */ new Set();
-  let entries;
-  try {
-    entries = fs.readdirSync(dir);
-  } catch {
-    return active;
-  }
-  for (const name of entries) {
-    if (!name.endsWith(".json")) continue;
-    const rawId = name.slice(0, -".json".length);
-    const sessionId = rawId.startsWith("cc-") ? rawId.slice("cc-".length) : rawId;
-    const filePath = path.join(dir, name);
-    try {
-      const data = JSON.parse(fs.readFileSync(filePath, "utf8"));
-      if (typeof data.pid === "number" && isProcessAlive(data.pid)) {
-        active.add(sessionId);
-      } else {
-        try {
-          fs.unlinkSync(filePath);
-        } catch {
-        }
-      }
-    } catch {
-    }
-  }
-  return active;
-}
-function sweepStaleEventLogs(dir = DEFAULT_DIR, minAgeMs = DEFAULT_MIN_AGE_MS) {
-  try {
-    fs.unlinkSync(path.join(dir, "kojee-events-no-session.log"));
-  } catch {
-  }
-  const active = listActiveSessionIds();
-  let entries;
-  try {
-    entries = fs.readdirSync(dir);
-  } catch {
-    return;
-  }
-  const now = Date.now();
-  for (const name of entries) {
-    if (!name.startsWith("kojee-events-") || !name.endsWith(".log")) continue;
-    const sessionId = name.slice("kojee-events-".length, -".log".length);
-    if (active.has(sessionId)) continue;
-    const filePath = path.join(dir, name);
-    try {
-      const stat = fs.statSync(filePath);
-      const ageMs = Math.max(0, now - stat.mtimeMs);
-      if (ageMs < minAgeMs) continue;
-      fs.unlinkSync(filePath);
-    } catch {
-    }
-  }
-}
-export {
-  startEventLog,
-  sweepStaleEventLogs
-};

package/dist/stop-hook-5XU3EQAE.js

@@ -1,76 +0,0 @@
-import {
-  readHookStdin
-} from "./chunk-WHTH6WBP.js";
-import {
-  deriveDiscoveryKey,
-  findClaudeAncestorPid
-} from "./chunk-36DMIXH7.js";
-import {
-  readSessionDiscoveryByKey
-} from "./chunk-VZVGTHGF.js";
-
-// src/hooks/stop-hook.ts
-import { spawn } from "child_process";
-import fs from "fs";
-async function isMonitorRunning(logPath) {
-  return new Promise((resolve) => {
-    const child = spawn("pgrep", ["-f", `tail -n \\+1 -F ${logPath}`], { stdio: "ignore" });
-    child.on("exit", (code) => resolve(code === 0));
-    child.on("error", () => resolve(false));
-  });
-}
-var STOP_POLL_TIMEOUT_MS = Number.parseInt(
-  process.env["KOJEE_STOP_HOOK_TIMEOUT_MS"] ?? "30000",
-  10
-);
-async function runStopHook() {
-  await readHookStdin();
-  const ccPid = findClaudeAncestorPid();
-  const key = deriveDiscoveryKey(process.env["CLAUDE_PROJECT_DIR"], ccPid);
-  const discovery = readSessionDiscoveryByKey(key);
-  if (!discovery) {
-    process.stdout.write("{}");
-    return;
-  }
-  const logPath = `/tmp/kojee-events-${key}.log`;
-  const monitorAlive = await isMonitorRunning(logPath);
-  const pollTimeoutMs = monitorAlive ? 0 : STOP_POLL_TIMEOUT_MS;
-  let body = null;
-  try {
-    const res = await fetch(
-      `http://127.0.0.1:${discovery.port}/poll?type=stop&timeout_ms=${pollTimeoutMs}`
-    );
-    if (res.ok) {
-      body = await res.json();
-    }
-  } catch {
-  }
-  if (body && body.count > 0) {
-    const reason = formatEvents(body.events);
-    process.stdout.write(JSON.stringify({ decision: "block", reason }));
-    return;
-  }
-  if (!monitorAlive && fs.existsSync(logPath)) {
-    process.stdout.write(JSON.stringify({
-      decision: "block",
-      reason: `Before stopping, spawn the kojee Tandem event watcher: Monitor(command="tail -n +1 -F ${logPath}", persistent=true, description="kojee Tandem events"). This is needed so Tandem peer messages can wake you from idle. After spawning it once at the start of the session, you don't need to spawn it again.`
-    }));
-    return;
-  }
-  process.stdout.write("{}");
-}
-function formatEvents(events) {
-  const header = `[${events.length} unread Tandem ${events.length === 1 ? "event" : "events"}]
-
-`;
-  const bodies = events.map((evt) => {
-    const attrs = Object.entries(evt.meta).map(([k, v]) => `${k}="${v}"`).join(" ");
-    return `<channel source="kojee-mcp" ${attrs}>
-${evt.content}
-</channel>`;
-  });
-  return header + bodies.join("\n\n");
-}
-export {
-  runStopHook
-};