khala-cli 0.3.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # khala-cli
 
-The `khala` command connects your existing Claude Code or Codex session to a
+The `khala` command connects your existing Claude Code, Codex or Cursor session to a
 [Khala](https://khala.aiur.team) channel: an MCP server (`khala_join`, `khala_status`,
 `khala_read`, `khala_send`, `khala_event`), delivery hooks that bring channel messages into
 the session, and local channels on this computer. Requires Node 22 or newer.
@@ -26,6 +26,20 @@ This installs the CLI under `~/.local/share/khala/npm`, adds `[mcp_servers.khala
 Codex and trust the three Khala hooks under **Hooks need review**. Undo with
 `npx -y khala-cli install codex --uninstall`.
 
+## Cursor (macOS, Linux, Windows)
+
+```sh
+npx -y khala-cli install cursor
+```
+
+On Windows, run it in PowerShell or Command Prompt, not WSL. This installs the CLI under
+`~/.local/share/khala/npm` (`%LOCALAPPDATA%\khala\npm` on Windows), adds a `khala` server to
+`~/.cursor/mcp.json` and three delivery hooks to `~/.cursor/hooks.json`, keeping everything
+else and saving the originals as `*.khala-bak`. Restart Cursor (or toggle `khala` off and on
+under Settings → MCP). Undo with `npx -y khala-cli install cursor --uninstall`. Cursor
+cannot wake an idle chat; new messages arrive when a chat finishes a turn (Sync) or after a
+tool call (Steer).
+
 ## Then
 
 Tell your agent "Join this Khala channel: <link>" and open the confirmation link it returns.

package/dist/{chunk-ZRUF3P53.mjs → chunk-3WTRQEVS.mjs}

@@ -4,13 +4,13 @@ import {
   checkName,
   readHumanColorId,
   readHumanInitials
-} from "./chunk-6GOETMWV.mjs";
+} from "./chunk-AAX35R7C.mjs";
 import {
   StateError,
   ensureStateDir,
   readJson,
   stateRoot
-} from "./chunk-S6XASSNU.mjs";
+} from "./chunk-AYPFL33Q.mjs";
 import {
   LISTENING_MODES,
   M1_LABEL_MAX_BYTES,
@@ -32,10 +32,10 @@ import {
   utcTimestamp,
   utf8Length,
   version
-} from "./chunk-GO5DD2TR.mjs";
+} from "./chunk-SMCTSZYU.mjs";
 import {
   bundle
-} from "./chunk-HMGN52QY.mjs";
+} from "./chunk-NX27G3SB.mjs";
 
 // ../contracts/src/m1/local.ts
 var LOCAL_OWNER_USER_ID = "@khala_owner:local";

package/dist/{chunk-FGIU3YO2.mjs → chunk-3YSVED2R.mjs}

@@ -1,12 +1,15 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
+import {
+  CURSOR_WORKSPACE_ENV
+} from "./chunk-VUE2DDYY.mjs";
 import {
   bundle
-} from "./chunk-HMGN52QY.mjs";
-import "./chunk-6FNXMYOM.mjs";
+} from "./chunk-NX27G3SB.mjs";
+import "./chunk-ZXJIFFFU.mjs";
 
 // src/install/main.ts
 import { spawnSync } from "node:child_process";
-import * as fs from "node:fs/promises";
+import * as fs2 from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 
@@ -71,9 +74,159 @@ function mergeCodexHooks(config, action, hooksFragment = codexHooksFragment()) {
   return { config, warnings };
 }
 
+// src/install/cursor.ts
+import * as fs from "node:fs/promises";
+var CURSOR_HOOK_EVENTS = ["beforeSubmitPrompt", "postToolUse", "stop"];
+var HOOK_SUFFIX = " hook deliver --harness cursor";
+function cursorPaths({ platform, path: path2, home, env }, packageName = "khala-cli") {
+  const cursorDir = path2.join(home, ".cursor");
+  const windows = platform === "win32";
+  const dataHome = windows ? env.LOCALAPPDATA && path2.isAbsolute(env.LOCALAPPDATA) ? env.LOCALAPPDATA : path2.join(home, "AppData", "Local") : env.XDG_DATA_HOME && path2.isAbsolute(env.XDG_DATA_HOME) ? env.XDG_DATA_HOME : path2.join(home, ".local", "share");
+  const prefix = path2.join(dataHome, "khala", "npm");
+  const modules = windows ? path2.join(prefix, "node_modules") : path2.join(prefix, "lib", "node_modules");
+  return {
+    cursorDir,
+    prefix,
+    mcpFile: path2.join(cursorDir, "mcp.json"),
+    hooksFile: path2.join(cursorDir, "hooks.json"),
+    script: path2.join(modules, ...packageName.split("/"), "dist", "khala.mjs")
+  };
+}
+var posixQuote = (value) => /^[A-Za-z0-9_./:-]+$/u.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
+function cursorHookCommand(platform, node, script) {
+  if (platform === "win32") return `node "${script.replaceAll("\\", "/")}"${HOOK_SUFFIX}`;
+  return `${posixQuote(node)} ${posixQuote(script)}${HOOK_SUFFIX}`;
+}
+function cursorMcpEntry(node, script) {
+  return {
+    type: "stdio",
+    command: node,
+    args: [script, "mcp", "--harness", "cursor"],
+    env: { [CURSOR_WORKSPACE_ENV]: "${workspaceFolder}" }
+  };
+}
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function isKhalaCursorServer(entry) {
+  if (!isObject(entry) || !Array.isArray(entry.args)) return false;
+  const args = entry.args;
+  const at = args.indexOf("--harness");
+  return args.includes("mcp") && at !== -1 && args[at + 1] === "cursor";
+}
+function mergeCursorMcp(config, entry) {
+  if (!isObject(config)) return { error: "invalid_config" };
+  const servers = config.mcpServers ?? {};
+  if (!isObject(servers)) return { error: "invalid_config" };
+  if (Object.hasOwn(servers, "khala") && !isKhalaCursorServer(servers.khala)) return { error: "cursor_mcp_exists" };
+  const next = { ...servers };
+  delete next.khala;
+  if (entry) next.khala = entry;
+  return { config: { ...config, mcpServers: next } };
+}
+function mergeCursorHooks(config, command) {
+  if (!isObject(config)) return { error: "invalid_config" };
+  const hooks = config.hooks ?? {};
+  if (!isObject(hooks) || Object.values(hooks).some((list) => !Array.isArray(list) || list.some((item) => !isObject(item)))) return { error: "invalid_config" };
+  const ours = (item) => typeof item.command === "string" && item.command.endsWith(HOOK_SUFFIX);
+  const next = {};
+  for (const [event, list] of Object.entries(hooks)) {
+    const kept = list.filter((item) => !ours(item));
+    if (kept.length) next[event] = kept;
+  }
+  if (command) {
+    for (const event of CURSOR_HOOK_EVENTS) next[event] = [...next[event] ?? [], { command, timeout: 10 }];
+  }
+  return { config: { version: 1, ...config, hooks: next } };
+}
+async function readJsonFile(file) {
+  let text;
+  try {
+    text = await fs.readFile(file, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return { text: null, value: {} };
+    throw error;
+  }
+  if (!text.trim()) return { text, value: {} };
+  try {
+    return { text, value: JSON.parse(text.replace(/^/u, "")) };
+  } catch {
+    return { text, value: void 0 };
+  }
+}
+async function installCursor(input) {
+  const { paths, uninstall, stdout, stderr } = input;
+  const mcp = await readJsonFile(paths.mcpFile);
+  const hooks = await readJsonFile(paths.hooksFile);
+  const command = cursorHookCommand(input.platform, input.node, paths.script);
+  const nextMcp = mergeCursorMcp(mcp.value, uninstall ? null : cursorMcpEntry(input.node, paths.script));
+  if ("error" in nextMcp) {
+    stderr(nextMcp.error === "cursor_mcp_exists" ? `khala: ${paths.mcpFile} already has a "khala" server that is not this CLI; remove it and run this again` : `khala: invalid JSON in ${paths.mcpFile}`);
+    return 1;
+  }
+  const nextHooks = mergeCursorHooks(hooks.value, uninstall ? null : command);
+  if ("error" in nextHooks) {
+    stderr(`khala: invalid JSON in ${paths.hooksFile}`);
+    return 1;
+  }
+  if (!uninstall && input.install && !input.install()) return 1;
+  await fs.mkdir(paths.cursorDir, { recursive: true });
+  for (const [file, before, after] of [[paths.mcpFile, mcp.text, nextMcp.config], [paths.hooksFile, hooks.text, nextHooks.config]]) {
+    if (uninstall && before === null) continue;
+    if (!uninstall && before !== null) {
+      try {
+        await fs.writeFile(file + ".khala-bak", before, { flag: "wx" });
+      } catch (error) {
+        if (error.code !== "EEXIST") throw error;
+      }
+    }
+    const text = JSON.stringify(after, null, 2) + "\n";
+    if (text !== before) await fs.writeFile(file, text);
+  }
+  if (uninstall) {
+    stdout(`removed the Khala MCP server and hooks from ${paths.cursorDir}; delete ${paths.prefix} to remove the CLI`);
+  } else {
+    stdout(`configured ${paths.mcpFile} and ${paths.hooksFile}`);
+    stdout('restart Cursor (or toggle "khala" off and on in Settings > MCP), then check that khala shows its five tools');
+  }
+  return 0;
+}
+
 // src/install/main.ts
 var MCP_MARKER = "# Khala MCP server, managed by `khala install codex`";
-var USAGE = "usage: khala install codex [--codex-home <dir>] [--uninstall]";
+var USAGE = "usage: khala install codex [--codex-home <dir>] [--uninstall] | khala install cursor [--uninstall]";
+async function runCursorInstall(flags, deps, env, stdout, stderr) {
+  let uninstall = false;
+  for (const flag of flags) {
+    if (flag === "--uninstall") uninstall = true;
+    else {
+      stderr(USAGE);
+      return 1;
+    }
+  }
+  const pkg = "package" in deps ? deps.package : bundle;
+  if (!pkg && !uninstall) {
+    stderr("khala: install runs from the published package (npx -y khala-cli install cursor)");
+    return 1;
+  }
+  const platform = deps.platform ?? process.platform;
+  const pathApi = platform === "win32" ? path.win32 : path.posix;
+  const home = deps.home ?? (platform === "win32" ? env.USERPROFILE || os.homedir() : env.HOME || os.homedir());
+  const paths = cursorPaths({ platform, path: pathApi, home, env }, pkg?.name);
+  const spec = pkg ? env.KHALA_INSTALL_SPEC || `${pkg.name}@${pkg.version}` : "";
+  return installCursor({
+    paths,
+    platform,
+    node: deps.node ?? process.execPath,
+    uninstall,
+    stdout,
+    stderr,
+    install: () => {
+      stdout(`installing ${spec} into ${paths.prefix}`);
+      if ((deps.npmInstall ?? defaultNpmInstall)(paths.prefix, spec)) return true;
+      stderr("khala: npm install failed for " + spec);
+      return false;
+    }
+  });
+}
 function shellQuote(value) {
   return /^[A-Za-z0-9_./-]+$/u.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
 }
@@ -113,7 +266,7 @@ function codexMcpBlock(bin, env) {
 }
 async function readOr(file, fallback) {
   try {
-    return { text: await fs.readFile(file, "utf8"), mode: (await fs.stat(file)).mode & 511 };
+    return { text: await fs2.readFile(file, "utf8"), mode: (await fs2.stat(file)).mode & 511 };
   } catch (error) {
     if (error.code === "ENOENT") return { text: fallback, mode: 384 };
     throw error;
@@ -128,6 +281,7 @@ async function runInstall(argv, deps = {}) {
     process.stderr.write(line + "\n");
   });
   const [target, ...flags] = argv;
+  if (target === "cursor") return runCursorInstall(flags, deps, env, stdout, stderr);
   let codexHome = env.CODEX_HOME && path.isAbsolute(env.CODEX_HOME) ? env.CODEX_HOME : path.join(env.HOME ?? os.homedir(), ".codex");
   let uninstall = false;
   for (let i = 0; i < flags.length; i++) {
@@ -182,17 +336,17 @@ async function runInstall(argv, deps = {}) {
       return 1;
     }
   }
-  await fs.mkdir(codexHome, { recursive: true });
+  await fs2.mkdir(codexHome, { recursive: true });
   if (!uninstall) {
     try {
-      await fs.writeFile(hooksFile + ".khala-bak", hooks.text, { flag: "wx", mode: hooks.mode });
+      await fs2.writeFile(hooksFile + ".khala-bak", hooks.text, { flag: "wx", mode: hooks.mode });
     } catch (error) {
       if (error.code !== "EEXIST") throw error;
     }
   }
   for (const warning of merged.warnings) stderr(warning);
-  await fs.writeFile(hooksFile, JSON.stringify(merged.config, null, 2) + "\n", { mode: hooks.mode });
-  await fs.writeFile(tomlFile, nextToml.text, { mode: toml.mode });
+  await fs2.writeFile(hooksFile, JSON.stringify(merged.config, null, 2) + "\n", { mode: hooks.mode });
+  await fs2.writeFile(tomlFile, nextToml.text, { mode: toml.mode });
   if (uninstall) {
     stdout(`removed the Khala MCP server and hooks from ${codexHome}; delete ${prefix} to remove the CLI`);
   } else {

package/dist/{chunk-CTXFYQIX.mjs → chunk-7272YXO6.mjs}

@@ -13,17 +13,17 @@ import {
   decodeLocalSendResult,
   ensureHelper,
   localRoomPath
-} from "./chunk-ZRUF3P53.mjs";
+} from "./chunk-3WTRQEVS.mjs";
 import {
   KhalaClientError
-} from "./chunk-6GOETMWV.mjs";
-import "./chunk-S6XASSNU.mjs";
+} from "./chunk-AAX35R7C.mjs";
+import "./chunk-AYPFL33Q.mjs";
 import {
   CHANNEL_EVENT_TYPE,
   LISTENING_MODE_COMMAND_TYPE
-} from "./chunk-GO5DD2TR.mjs";
-import "./chunk-HMGN52QY.mjs";
-import "./chunk-6FNXMYOM.mjs";
+} from "./chunk-SMCTSZYU.mjs";
+import "./chunk-NX27G3SB.mjs";
+import "./chunk-ZXJIFFFU.mjs";
 
 // src/local/session.ts
 import { randomUUID } from "node:crypto";

package/dist/{chunk-6GOETMWV.mjs → chunk-AAX35R7C.mjs}

@@ -2,7 +2,7 @@ import { createRequire as __khalaCreateRequire } from 'node:module'; const requi
 import {
   fail,
   reserved
-} from "./chunk-GO5DD2TR.mjs";
+} from "./chunk-SMCTSZYU.mjs";
 
 // src/client.ts
 var KhalaClientError = class extends Error {
@@ -58,7 +58,7 @@ var AGENT_NAME_MIN = 2;
 var AGENT_NAME_MAX = 40;
 var mentionName = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/u;
 var adjacentSeparators = /[._-]{2}/u;
-var agentSuffix = /-(?:claude|codex)(?:-\d+)?$/iu;
+var agentSuffix = /-(?:claude|codex|cursor)(?:-\d+)?$/iu;
 function checkName(input, kind) {
   if (typeof input !== "string") return { ok: false, error: "invalid_characters" };
   const name = input.trim();
@@ -68,7 +68,7 @@ function checkName(input, kind) {
   if (reserved.test(name) || kind === "username" && agentSuffix.test(name)) return { ok: false, error: "reserved" };
   return { ok: true, name };
 }
-var MODEL_NAMES = { claude: "Claude", codex: "Codex" };
+var MODEL_NAMES = { claude: "Claude", codex: "Codex", cursor: "Cursor" };
 function defaultAgentName(username, harness, n = 1) {
   return `${username}-${MODEL_NAMES[harness]}${n === 1 ? "" : `-${n}`}`;
 }

package/dist/{chunk-S6XASSNU.mjs → chunk-AYPFL33Q.mjs}

@@ -1,4 +1,7 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
+import {
+  HARNESSES
+} from "./chunk-SMCTSZYU.mjs";
 
 // src/state.ts
 import { constants } from "node:fs";
@@ -15,15 +18,28 @@ var StateError = class extends Error {
     this.code = code;
   }
 };
+var WINDOWS = process.platform === "win32";
+async function renameWithRetry(from, to) {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      await fs.rename(from, to);
+      return;
+    } catch (error) {
+      const code = error.code;
+      if (!WINDOWS || attempt >= 20 || !["EPERM", "EACCES", "EBUSY"].includes(code ?? "")) throw error;
+      await new Promise((resolve) => setTimeout(resolve, 10 + attempt * 5));
+    }
+  }
+}
 function stateRoot(env = process.env) {
-  const base = env.XDG_STATE_HOME && path.isAbsolute(env.XDG_STATE_HOME) ? env.XDG_STATE_HOME : path.join(env.HOME ?? os.homedir(), ".local/state");
+  const base = env.XDG_STATE_HOME && path.isAbsolute(env.XDG_STATE_HOME) ? env.XDG_STATE_HOME : path.join(WINDOWS ? os.homedir() : env.HOME ?? os.homedir(), ".local", "state");
   return path.join(base, "khala");
 }
 function filesForDir(dir) {
   return { dir, mode: path.join(dir, "mode.json"), join: path.join(dir, "join.json"), session: path.join(dir, "session.json"), inbox: path.join(dir, "inbox.jsonl"), cursor: path.join(dir, "cursor.json"), status: path.join(dir, "status.json") };
 }
 function sessionFiles(harness, sessionId, env) {
-  if (!["claude", "codex"].includes(harness) || !SESSION_ID_PATTERN.test(sessionId)) throw new StateError("invalid_session_id");
+  if (!HARNESSES.includes(harness) || !SESSION_ID_PATTERN.test(sessionId)) throw new StateError("invalid_session_id");
   return filesForDir(path.join(stateRoot(env), harness, sessionId));
 }
 function resolveStateDir(harness, sessionId, env) {
@@ -38,7 +54,7 @@ async function ensureStateDir(dir) {
         if (error.code !== "EEXIST") throw error;
       }
       const stat = await fs.lstat(directory);
-      if (!stat.isDirectory() || stat.isSymbolicLink() || (stat.mode & 63) !== 0 || typeof process.getuid === "function" && stat.uid !== process.getuid()) throw new StateError("unsafe_state_dir");
+      if (!stat.isDirectory() || stat.isSymbolicLink() || !WINDOWS && (stat.mode & 63) !== 0 || typeof process.getuid === "function" && stat.uid !== process.getuid()) throw new StateError("unsafe_state_dir");
     }
   } catch (error) {
     if (error instanceof StateError) throw error;
@@ -55,12 +71,14 @@ async function writeJsonAtomic(file, value) {
     await handle.sync();
     await handle.close();
     handle = void 0;
-    await fs.rename(temporary, file);
-    const directory = await fs.open(dir, constants.O_RDONLY);
-    try {
-      await directory.sync();
-    } finally {
-      await directory.close();
+    await renameWithRetry(temporary, file);
+    if (!WINDOWS) {
+      const directory = await fs.open(dir, constants.O_RDONLY);
+      try {
+        await directory.sync();
+      } finally {
+        await directory.close();
+      }
     }
   } catch {
     throw new StateError("storage_failed");

package/dist/{chunk-MGXWUWWP.mjs → chunk-BNT6YPFR.mjs}

@@ -9,20 +9,21 @@ import {
   readListeningMode,
   toEventInboxEntry,
   unreadCount
-} from "./chunk-H2JCKPFR.mjs";
+} from "./chunk-K2SZLOBE.mjs";
 import {
   hostedUsernameFromAgentName,
   pollJoin,
   reportReady,
   requestJoin,
   saveHostedUsername
-} from "./chunk-UYTGV6TW.mjs";
+} from "./chunk-THNGKHZD.mjs";
 import {
   KHALA_AGENT_VERSION
-} from "./chunk-Y3TDVOGT.mjs";
+} from "./chunk-ENNXMNKZ.mjs";
 import {
-  KhalaClientError
-} from "./chunk-6GOETMWV.mjs";
+  KhalaClientError,
+  MODEL_NAMES
+} from "./chunk-AAX35R7C.mjs";
 import {
   SESSION_ID_PATTERN,
   StateError,
@@ -35,9 +36,10 @@ import {
   resolveStateDir,
   sessionFiles,
   writeStateFile
-} from "./chunk-S6XASSNU.mjs";
+} from "./chunk-AYPFL33Q.mjs";
 import {
   CHANNEL_EVENT_TYPE,
+  HARNESSES,
   decodeListeningModeCommand,
   displayText,
   encodeChannelEvent,
@@ -46,9 +48,13 @@ import {
   label,
   statusFor,
   utf8Length
-} from "./chunk-GO5DD2TR.mjs";
-import "./chunk-HMGN52QY.mjs";
-import "./chunk-6FNXMYOM.mjs";
+} from "./chunk-SMCTSZYU.mjs";
+import {
+  CURSOR_WORKSPACE_ENV,
+  cursorSessionId
+} from "./chunk-VUE2DDYY.mjs";
+import "./chunk-NX27G3SB.mjs";
+import "./chunk-ZXJIFFFU.mjs";
 
 // src/mcp/main.ts
 import { Console } from "node:console";
@@ -264,17 +270,18 @@ function nextChunk(iterator, signal) {
 }
 
 // src/mcp/session-id.ts
+var isHarness = (value) => HARNESSES.includes(value);
 function resolveHarness(argv, env) {
   const index = argv.indexOf("--harness");
   if (index !== -1) {
     const value = argv[index + 1];
-    return value === "claude" || value === "codex" ? value : "invalid";
+    return isHarness(value) ? value : "invalid";
   }
-  if (env.KHALA_MCP_HARNESS === "claude" || env.KHALA_MCP_HARNESS === "codex") return env.KHALA_MCP_HARNESS;
+  if (isHarness(env.KHALA_MCP_HARNESS)) return env.KHALA_MCP_HARNESS;
   return env.CLAUDE_CODE_SESSION_ID !== void 0 ? "claude" : "codex";
 }
 function resolveSessionId(harness, meta, env) {
-  const value = harness === "claude" ? env.CLAUDE_CODE_SESSION_ID : typeof meta?.threadId === "string" ? meta.threadId : env.CODEX_THREAD_ID;
+  const value = harness === "claude" ? env.CLAUDE_CODE_SESSION_ID : harness === "cursor" ? cursorSessionId(env[CURSOR_WORKSPACE_ENV]) : typeof meta?.threadId === "string" ? meta.threadId : env.CODEX_THREAD_ID;
   return typeof value === "string" && value.match(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)?.[0] === value ? value : null;
 }
 
@@ -534,7 +541,7 @@ function createKhalaTools(input) {
       } },
       ["link"],
       (args) => typeof args.link === "string" && (!Object.hasOwn(args, "label") || typeof args.label === "string" && args.label.trim().length > 0 && [...args.label].length <= 40),
-      (client, args) => client.join(args.link, args.label ?? (input.harness === "claude" ? "Claude" : "Codex")),
+      (client, args) => client.join(args.link, args.label ?? MODEL_NAMES[input.harness]),
       (result) => {
         const joined = result;
         if (joined.state === "connected") return `Connected to ${joined.channelName}.`;
@@ -598,7 +605,7 @@ function createKhalaTools(input) {
 import { createHash } from "node:crypto";
 
 // src/transport.ts
-var startChannelSession = async (creds) => creds.transport === "local" ? (await import("./chunk-CTXFYQIX.mjs")).createLocalSession(creds) : (await import("./chunk-4C2TBZVA.mjs")).createAgentMatrixSession(creds);
+var startChannelSession = async (creds) => creds.transport === "local" ? (await import("./chunk-7272YXO6.mjs")).createLocalSession(creds) : (await import("./chunk-IVPQJSFO.mjs")).createAgentMatrixSession(creds);
 
 // src/sender.ts
 function localpart(userId) {

package/dist/{chunk-Y3TDVOGT.mjs → chunk-ENNXMNKZ.mjs}

@@ -1,7 +1,7 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
 import {
   bundle
-} from "./chunk-HMGN52QY.mjs";
+} from "./chunk-NX27G3SB.mjs";
 
 // src/version.ts
 var KHALA_AGENT_VERSION = bundle?.version ?? "0.0.0";

package/dist/{chunk-PQO6675G.mjs → chunk-G3SVNU4N.mjs}

@@ -5,14 +5,18 @@ import {
   readListeningMode,
   unread,
   writeActivity
-} from "./chunk-H2JCKPFR.mjs";
+} from "./chunk-K2SZLOBE.mjs";
 import {
   StateError,
   readStatus,
   sessionFiles
-} from "./chunk-S6XASSNU.mjs";
-import "./chunk-GO5DD2TR.mjs";
-import "./chunk-6FNXMYOM.mjs";
+} from "./chunk-AYPFL33Q.mjs";
+import "./chunk-SMCTSZYU.mjs";
+import {
+  CURSOR_DEFAULT_SESSION,
+  cursorSessionId
+} from "./chunk-VUE2DDYY.mjs";
+import "./chunk-ZXJIFFFU.mjs";
 
 // hooks/deliver.ts
 import * as fs from "node:fs/promises";
@@ -79,10 +83,11 @@ async function deliver(stdin, argv, io = {
   now: () => /* @__PURE__ */ new Date()
 }) {
   const harness = argv[1];
-  if (argv.length !== 2 || argv[0] !== "--harness" || harness !== "claude" && harness !== "codex") {
+  if (argv.length !== 2 || argv[0] !== "--harness" || harness !== "claude" && harness !== "codex" && harness !== "cursor") {
     diagnostic(io, "invalid_harness");
     return 0;
   }
+  if (harness === "cursor") return deliverCursor(stdin, io);
   let input;
   try {
     input = JSON.parse(stdin);
@@ -127,9 +132,69 @@ async function deliver(stdin, argv, io = {
   }
   return 0;
 }
+var CURSOR_NOOP = { beforeSubmitPrompt: { continue: true }, postToolUse: {}, stop: {} };
+async function cursorFiles(roots, env) {
+  const first = Array.isArray(roots) && typeof roots[0] === "string" ? roots[0] : void 0;
+  for (const id of /* @__PURE__ */ new Set([cursorSessionId(first), CURSOR_DEFAULT_SESSION])) {
+    const files = sessionFiles("cursor", id, env);
+    try {
+      if ((await fs.stat(files.dir)).isDirectory()) return files;
+    } catch {
+    }
+  }
+  return null;
+}
+async function deliverCursor(stdin, io) {
+  let event;
+  let input;
+  try {
+    input = JSON.parse(stdin.replace(/^/u, ""));
+    const name = input?.hook_event_name;
+    if (typeof name === "string" && Object.hasOwn(CURSOR_NOOP, name)) event = name;
+  } catch {
+  }
+  let output = event ? CURSOR_NOOP[event] : {};
+  if (event && input) {
+    try {
+      const files = await cursorFiles(input.workspace_roots, io.env);
+      if (files) output = await cursorOutput(files, event, input.loop_count, io) ?? output;
+    } catch (error) {
+      diagnostic(io, error instanceof StateError ? error.code : "internal_error");
+    }
+  }
+  try {
+    io.stdout.write(JSON.stringify(output) + "\n");
+  } catch {
+  }
+  return 0;
+}
+async function cursorOutput(files, event, loopCount, io) {
+  const mode = await readListeningMode(files);
+  if (event === "beforeSubmitPrompt") {
+    await writeActivity(files, "busy", io.now);
+    return null;
+  }
+  if (event === "postToolUse" && mode !== "steer") return null;
+  if (event === "stop" && (mode === "async" || typeof loopCount === "number" && loopCount > 0)) {
+    await writeActivity(files, "idle", io.now);
+    return null;
+  }
+  const status = await readStatus(files);
+  for (let attempt = 0; attempt < 2; attempt++) {
+    const { entries, cursor } = await unread(files);
+    const { frame, consumed } = selectFrame(status?.channelName, entries);
+    if (!frame || !consumed.some(isWakeEntry)) break;
+    if (await advanceCursor(files, cursor, consumed) === "conflict") continue;
+    await writeActivity(files, "busy", io.now);
+    return event === "stop" ? { followup_message: frame } : { additional_context: frame };
+  }
+  if (event === "stop") await writeActivity(files, "idle", io.now);
+  return null;
+}
 export {
   run as default,
   deliver,
+  deliverCursor,
   renderFrame,
   renderLine
 };

package/dist/{chunk-HWKLLI7F.mjs → chunk-H2INZPFK.mjs}

@@ -20,14 +20,14 @@ import {
   newLocalEventId,
   newLocalRoomId,
   readHelperFile
-} from "./chunk-ZRUF3P53.mjs";
+} from "./chunk-3WTRQEVS.mjs";
 import {
   parseChannelLink,
   resolveLocalOwnerName
-} from "./chunk-UYTGV6TW.mjs";
+} from "./chunk-THNGKHZD.mjs";
 import {
   KHALA_AGENT_VERSION
-} from "./chunk-Y3TDVOGT.mjs";
+} from "./chunk-ENNXMNKZ.mjs";
 import {
   checkName,
   defaultAgentName,
@@ -35,16 +35,17 @@ import {
   isDefaultAgentName,
   isHumanColorId,
   normalizeInitials
-} from "./chunk-6GOETMWV.mjs";
+} from "./chunk-AAX35R7C.mjs";
 import {
   StateError,
   ensureStateDir,
   readJson,
   writeJsonAtomic
-} from "./chunk-S6XASSNU.mjs";
+} from "./chunk-AYPFL33Q.mjs";
 import {
   CHANNEL_EVENT_TYPE,
   DEFAULT_LISTENING_MODE,
+  HARNESSES,
   LISTENING_MODE_COMMAND_TYPE,
   LISTENING_MODE_MEMBER_KEY,
   agentConfirmPagePath,
@@ -56,11 +57,11 @@ import {
   memberListeningMode,
   object,
   utf8Length
-} from "./chunk-GO5DD2TR.mjs";
+} from "./chunk-SMCTSZYU.mjs";
 import {
   bundle
-} from "./chunk-HMGN52QY.mjs";
-import "./chunk-6FNXMYOM.mjs";
+} from "./chunk-NX27G3SB.mjs";
+import "./chunk-ZXJIFFFU.mjs";
 
 // src/local/cli.ts
 import { setTimeout as sleepDefault } from "node:timers/promises";
@@ -781,7 +782,7 @@ function agentJoinRoutes() {
       if (!Object.hasOwn(body, "link") || Object.keys(body).some((key) => !["link", "harness", "label"].includes(key))) return fail(400, "invalid_link");
       if (typeof body.link !== "string" || !parseChannelLink(body.link)) return fail(400, "invalid_link");
       const harness = body.harness;
-      if (harness !== "claude" && harness !== "codex") return fail(400, "invalid_harness");
+      if (!HARNESSES.includes(harness)) return fail(400, "invalid_harness");
       const url = new URL(body.link);
       if (url.origin !== ctx.origin && url.origin !== ctx.origin.replace("://127.0.0.1:", "://localhost:")) return fail(404, "link_unavailable");
       const token = url.pathname.slice("/join/".length);