chat-recall 0.7.20 → 0.7.23

package/README.md

@@ -19,7 +19,7 @@
 Every coding agent you run keeps a full transcript of its work: the decisions, the
 reasoning, the keys somebody pasted, the problems it found and never filed. Each one
 writes to its own directory in its own format, none can read another's, and nothing
-reads any of them. `chat-recall` does, through **63 MCP tools**.
+reads any of them. `chat-recall` does, through **68 MCP tools**.
 
 | | What it does | Tools |
 |---|---|---|
@@ -131,7 +131,7 @@ Exclusions live on the machine that holds the data, so the CLI owns them; they a
 ## Four things it actually does
 
 1. **Cross-tool unified memory.** One index, one search, one UI over Claude Code (`~/.claude/projects/`), Codex (`~/.codex/`), OpenCode (`~/.local/share/opencode/`), Antigravity (`~/.gemini/antigravity-cli/`), Cursor (`~/.cursor/` for the CLI, `~/.config/Cursor/` for the IDE), Hermes Agent (`~/.hermes/`) and Pi (`~/.pi/agent/`). Sessions, plans, tasks, CLAUDE.md files, paste cache, shell history and agent diaries all share one pluggable `MemorySource` interface.
-2. **The agent recalls itself.** 63 MCP tools, so Claude Code can `recall_smart_resume`, `recall_search` (with `like_session` to find similar work), `recall_edits_timeline`, `recall_subagent_search` and `recall_redundant_files` rather than asking you what happened last time. It writes back too, via `recall_decision_record`, `recall_kg_add` and `recall_set`.
+2. **The agent recalls itself.** 68 MCP tools, so Claude Code can `recall_smart_resume`, `recall_search` (with `like_session` to find similar work), `recall_edits_timeline`, `recall_subagent_search` and `recall_redundant_files` rather than asking you what happened last time. It writes back too, via `recall_decision_record`, `recall_kg_add` and `recall_set`.
 3. **Warns before you redo work.** A `UserPromptSubmit` hook searches for similar past sessions on every prompt and injects a short "you have done this before, in session X" note into the agent's context.
 4. **Temporal knowledge graph.** Decisions and tool mentions become entity-relationship triples with `valid_from`/`valid_to` windows, so you can ask what was decided in March and whether it still holds.
 
@@ -216,16 +216,20 @@ CHAT_RECALL_DAEMON_IDLE_SECS=0   # keep the daemon resident (default 900)
 If the daemon cannot be reached for any reason, the session loads the server
 itself and works exactly as it did before — slower, never broken.
 
-Then install the hooks (one command sets up auto-save, pre-compact backup, and the resume-hint that warns when you're about to redo work):
+`chat-recall init` installs the Claude Code hooks in every profile's
+`settings.json`. If you added only the MCP server, from a marketplace button or
+by hand, the MCP server installs them when it starts. You run nothing else.
+
+To choose which hooks run, or to remove them:
 
 ```bash
-chat-recall install-hooks                 # registers all five events, in every Claude profile
-chat-recall install-hooks --no-resume-hint  # skip the resume warning
-chat-recall install-hooks --no-wakeup       # skip the session-start wake-up bundle
-chat-recall install-hooks --no-escalate     # skip the session-end escalation
-chat-recall install-hooks --uninstall     # remove all of ours, leave third-party hooks alone
+chat-recall install-hooks --no-resume-hint  # without the resume warning
+chat-recall install-hooks --no-messages     # without messages between sessions
+chat-recall install-hooks --uninstall       # remove ours; third-party hooks stay
 ```
 
+After `--uninstall` the MCP server does not put them back.
+
 | Hook | When it fires | What it does |
 |---|---|---|
 | `SessionStart` | New session (`startup` / `clear`) | Injects the project-scoped wake-up bundle |
@@ -233,6 +237,44 @@ chat-recall install-hooks --uninstall     # remove all of ours, leave third-part
 | `Stop` | After every assistant turn | Auto-saves topics, decisions, and tools to `~/.chat-recall/memory/` |
 | `PreCompact` | Before Claude Code compacts context | Emergency save so nothing is lost to compaction |
 | `SessionEnd` | When the session closes | Escalates the session's learnings in the background, so nothing is delayed |
+| `SessionStart`, `UserPromptSubmit`, `Stop`, `SessionEnd` | Each turn | Messages between sessions: tells the session its id, delivers what waits for it, reports its state |
+| `SessionStart`, `UserPromptSubmit`, `Stop` (background) | Until a message arrives | Waits for a message from another session and wakes this one, also when it is idle |
+
+The other AI tools get the message hook too, so their sessions can send and
+receive messages. The installer writes it only for a tool that is installed:
+
+| Tool | Where | When a message arrives in the session |
+|---|---|---|
+| Codex | `~/.codex/hooks.json` | At the next prompt. Approve the hook once with `/hooks` in Codex. |
+| Antigravity | `~/.gemini/config/hooks.json` | At the next prompt |
+| Cursor | `~/.cursor/hooks.json` | When the agent stops, as a follow-up prompt |
+| opencode | `~/.config/opencode/plugins/chat-recall-messages.js` | At the next prompt |
+| pi | `~/.pi/agent/extensions/chat-recall-messages.js` | At the next prompt |
+
+Only Claude Code wakes an idle session. In the other tools, an idle session
+reads its messages when its user types next. `chat-recall doctor` shows the
+hook of each tool.
+
+## Sessions that work together
+
+One session can start others and direct them. In Claude Code, ask for it in
+plain words: "start two workers, one on the API and one on the web form, and
+tell me when both are done".
+
+- `recall_session_spawn` starts a child as a Claude Code background session,
+  linked to its parent. `claude attach <id>` opens it.
+- `recall_message_send` sends to a session by id or name, or to `parent`,
+  `children` or `group`. The message wakes the recipient within about a second,
+  also when it waits for input.
+- `recall_session_status` lists the sessions: what each works on, its board
+  cards, and whether it is working, idle, waiting for a permission prompt, or
+  ended.
+- Decisions, facts and shared state go in the memory every session reads:
+  `recall_decision_record`, `recall_kg_add`, `recall_set`.
+
+A message from another session is not a message from you. A child acts on its
+parent's messages because its parent started it with that instruction. Any
+other session treats a message as information and checks with you first.
 
 ## The decision guard
 
@@ -256,13 +298,13 @@ guard uninstalled; a wrong warning costs a line of context. Set
 `CHAT_RECALL_GUARD_ENFORCE=1` to block instead, per machine. `CHAT_RECALL_GUARD=0`
 turns it off.
 
-`chat-recall install-hooks` registers it in all five tools. Each one keeps its
+`chat-recall init` registers it in all five tools. Each one keeps its
 pre-execution hook in its own file, so the installer writes five shapes and
 skips any tool that is not on the machine (`--no-guard` to skip all of them):
 
 | Tool | Where | Event |
 |---|---|---|
-| Claude Code | `~/.claude/hooks.json`, every profile | `PreToolUse` |
+| Claude Code | `~/.claude/settings.json`, every profile | `PreToolUse` |
 | Codex | `~/.codex/hooks.json` | `PreToolUse` |
 | Antigravity | `~/.gemini/antigravity-cli/hooks.json` | `PreToolUse` — the one tool with a real `ask` verdict, so it can prompt |
 | Cursor | `~/.cursor/hooks.json` | `beforeShellExecution` + `afterFileEdit` |
@@ -315,7 +357,7 @@ codeindex is open source (MIT) at [github.com/munhq/codeindex](https://github.co
 | **Paste** | `~/.claude/paste-cache/*.txt` | Large pasted blobs |
 | **Diary** | `~/.chat-recall/index/diary/<agent>/*.json` | What the agent told its future self via `recall_diary_write` |
 
-## MCP tools (62, including 4 code-intelligence tools that register when the companion binary is installed)
+## MCP tools (68, including 4 code-intelligence tools that register when the companion binary is installed)
 
 **Search & retrieve** — `recall_search`, `recall_memory_search`, `recall_recent`, `recall_show`, `recall_context`, `recall_summary`, `recall_smart_resume`, `recall_project_context`, `recall_weekly_digest`, `recall_analytics_summary`, `recall_wake_up`.
 

package/dist/board-hooks.d.ts

@@ -1,3 +1,10 @@
+type HookEntry = {
+    matcher: string;
+    hooks: Array<{
+        type: string;
+        command: string;
+    }>;
+};
 /** The two events the board loop needs, and the flag each one passes. */
 export declare const BOARD_HOOKS: ReadonlyArray<{
     event: string;
@@ -12,7 +19,7 @@ export declare const BOARD_HOOKS: ReadonlyArray<{
  */
 export declare function boardHookCommand(execPath: string, cliEntry: string, mode: 'claim' | 'close'): string;
 /**
- * True when this hooks.json entry is one of ours.
+ * True when this hook entry is one of ours.
  *
  * It answers for two shapes. The first is the CLI command above. The second is
  * `chat_recall_task_hook.sh`, a wrapper that shipped briefly and did nothing
@@ -21,36 +28,39 @@ export declare function boardHookCommand(execPath: string, cliEntry: string, mod
  * cleaned up.
  */
 export declare function isBoardHookEntry(entry: unknown): boolean;
-/** The `[event, entry]` pairs for a hooks.json. */
-export declare function boardHookEntries(execPath: string, cliEntry: string): Array<[string, {
-    matcher: string;
-    hooks: Array<{
-        type: string;
-        command: string;
-    }>;
-}]>;
+/** The `[event, entry]` pairs for a settings.json. */
+export declare function boardHookEntries(execPath: string, cliEntry: string): Array<[string, HookEntry]>;
 /**
- * Merge the board hooks into one already-parsed hooks.json object.
- *
- * Every prior entry of ours is dropped first, so a reinstall after an upgrade
- * replaces a stale bundle path instead of stacking a second registration.
- * Entries that are not ours are untouched: a profile carries the resume hint on
- * the same event.
+ * The events of the message hook's turn runs. SessionStart tells the session
+ * its own id; the prompt and the turn end deliver what already waits;
+ * SessionEnd marks the session ended so a parent stops waiting for it.
  */
-export declare function mergeBoardHooks(config: {
-    hooks?: Record<string, unknown[]>;
-}, execPath: string, cliEntry: string): void;
-/** Drop the board hooks from one already-parsed hooks.json object. */
-export declare function removeBoardHooks(config: {
-    hooks?: Record<string, unknown[]>;
-}): number;
+export declare const MESSAGE_HOOK_EVENTS: readonly string[];
 /**
- * Register the board hooks in every given hooks.json.
- *
- * Returns the files it wrote. A file it cannot parse is skipped rather than
- * overwritten: another tool's config is not ours to replace.
+ * The events that start the waiter. It runs in the background (asyncRewake)
+ * until a message arrives, then exits 2 and Claude Code wakes the session; the
+ * turn that follows ends in a Stop, which starts the next waiter.
  */
-export declare function registerBoardHooks(files: string[], execPath: string, cliEntry: string): string[];
+export declare const MESSAGE_WAITER_EVENTS: readonly string[];
+/** The command Claude Code runs for the message hook. Both paths quoted, as above. */
+export declare function messageHookCommand(execPath: string, hookEntry: string, waiter?: boolean): string;
+/** True when this hook entry is the message hook, its turn run or its waiter. */
+export declare function isMessageHookEntry(entry: unknown): boolean;
+/** True when this hook entry is the waiter. */
+export declare function isMessageWaiterEntry(entry: unknown): boolean;
+type HookCommand = {
+    type: string;
+    command: string;
+    asyncRewake?: boolean;
+};
+/** The `[event, entry]` pairs for the message hook: the turn runs, then the waiters. */
+export declare function messageHookEntries(execPath: string, hookEntry: string): Array<[string, {
+    matcher: string;
+    hooks: HookCommand[];
+}]>;
 /** Resolve the CLI entry that a hook should run. */
 export declare function resolveCliEntry(distDir: string): string;
+/** Resolve the message hook bundle that sits beside the CLI. */
+export declare function resolveMessageHookEntry(distDir: string): string;
+export {};
 //# sourceMappingURL=board-hooks.d.ts.map

package/dist/board-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"board-hooks.d.ts","sourceRoot":"","sources":["../src/board-hooks.ts"],"names":[],"mappings":"AAqBA,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,CAGjF,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAEpG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAAC,CAKvF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;CAAE,EAC7C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI,CASN;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG,MAAM,CAWtF;AAYD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAehG;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD"}
+{"version":3,"file":"board-hooks.d.ts","sourceRoot":"","sources":["../src/board-hooks.ts"],"names":[],"mappings":"AA0BA,KAAK,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAQtF,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,CAGjF,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAEpG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAK/F;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAA+D,CAAC;AAEjH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAiD,CAAC;AAErG,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAE9F;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5E,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAAC,CAOlI;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,gEAAgE;AAChE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/board-hooks.js

@@ -1,5 +1,6 @@
 /**
- * Registration for the two board hooks, on every platform.
+ * The commands for the two board hooks and the message hook, on every
+ * platform. install-hooks.ts writes them into each profile's settings.json.
  *
  * The other five hooks are POSIX shell scripts, and `install-hooks` refuses to
  * register any of them on Windows: Claude Code runs a hook command through
@@ -15,9 +16,18 @@
  * Registration is also the only reason the loop reaches anyone: `init` never
  * installed hooks, so until now the board moved for whoever had separately run
  * `chat-recall install-hooks`.
+ *
+ * The message hook is registered the same way, for the same reason. It is its
+ * own small bundle (`dist/message-hook.js`) because it runs on every tool call,
+ * and the full CLI takes about 0.4 s to start.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/** The command string of a hook entry, or null for a malformed one. */
+function entryCommand(entry) {
+    const cmd = entry?.hooks?.[0]?.command;
+    return typeof cmd === 'string' ? cmd : null;
+}
 /** The two events the board loop needs, and the flag each one passes. */
 export const BOARD_HOOKS = [
     { event: 'UserPromptSubmit', mode: 'claim' },
@@ -34,7 +44,7 @@ export function boardHookCommand(execPath, cliEntry, mode) {
     return `"${execPath}" "${cliEntry}" task-hook --${mode}`;
 }
 /**
- * True when this hooks.json entry is one of ours.
+ * True when this hook entry is one of ours.
  *
  * It answers for two shapes. The first is the CLI command above. The second is
  * `chat_recall_task_hook.sh`, a wrapper that shipped briefly and did nothing
@@ -43,14 +53,14 @@ export function boardHookCommand(execPath, cliEntry, mode) {
  * cleaned up.
  */
 export function isBoardHookEntry(entry) {
-    const cmd = entry?.hooks?.[0]?.command;
-    if (typeof cmd !== 'string')
+    const cmd = entryCommand(entry);
+    if (cmd === null)
         return false;
     if (cmd.includes('chat_recall_task_hook.sh'))
         return true;
     return cmd.includes('task-hook') && (cmd.includes('--claim') || cmd.includes('--close'));
 }
-/** The `[event, entry]` pairs for a hooks.json. */
+/** The `[event, entry]` pairs for a settings.json. */
 export function boardHookEntries(execPath, cliEntry) {
     return BOARD_HOOKS.map(({ event, mode }) => [
         event,
@@ -58,87 +68,47 @@ export function boardHookEntries(execPath, cliEntry) {
     ]);
 }
 /**
- * Merge the board hooks into one already-parsed hooks.json object.
- *
- * Every prior entry of ours is dropped first, so a reinstall after an upgrade
- * replaces a stale bundle path instead of stacking a second registration.
- * Entries that are not ours are untouched: a profile carries the resume hint on
- * the same event.
+ * The events of the message hook's turn runs. SessionStart tells the session
+ * its own id; the prompt and the turn end deliver what already waits;
+ * SessionEnd marks the session ended so a parent stops waiting for it.
  */
-export function mergeBoardHooks(config, execPath, cliEntry) {
-    if (!config.hooks || typeof config.hooks !== 'object')
-        config.hooks = {};
-    const entries = boardHookEntries(execPath, cliEntry);
-    for (const { event } of BOARD_HOOKS) {
-        const current = Array.isArray(config.hooks[event]) ? config.hooks[event] : [];
-        const kept = current.filter((h) => !isBoardHookEntry(h));
-        for (const [ev, entry] of entries)
-            if (ev === event)
-                kept.push(entry);
-        config.hooks[event] = kept;
-    }
+export const MESSAGE_HOOK_EVENTS = ['SessionStart', 'UserPromptSubmit', 'Stop', 'SessionEnd'];
+/**
+ * The events that start the waiter. It runs in the background (asyncRewake)
+ * until a message arrives, then exits 2 and Claude Code wakes the session; the
+ * turn that follows ends in a Stop, which starts the next waiter.
+ */
+export const MESSAGE_WAITER_EVENTS = ['SessionStart', 'UserPromptSubmit', 'Stop'];
+/** The command Claude Code runs for the message hook. Both paths quoted, as above. */
+export function messageHookCommand(execPath, hookEntry, waiter = false) {
+    return `"${execPath}" "${hookEntry}"${waiter ? ' --wait' : ''}`;
 }
-/** Drop the board hooks from one already-parsed hooks.json object. */
-export function removeBoardHooks(config) {
-    if (!config.hooks)
-        return 0;
-    let removed = 0;
-    for (const { event } of BOARD_HOOKS) {
-        const current = Array.isArray(config.hooks[event]) ? config.hooks[event] : [];
-        const kept = current.filter((h) => !isBoardHookEntry(h));
-        removed += current.length - kept.length;
-        if (kept.length)
-            config.hooks[event] = kept;
-        else
-            delete config.hooks[event];
-    }
-    return removed;
+/** True when this hook entry is the message hook, its turn run or its waiter. */
+export function isMessageHookEntry(entry) {
+    const cmd = entryCommand(entry);
+    return cmd !== null && /message-hook\.(js|ts)"?( --wait)?$/.test(cmd.trim());
 }
-/** Read a hooks.json, tolerating an absent or unreadable file. */
-function readConfig(file) {
-    if (!existsSync(file))
-        return { hooks: {} };
-    try {
-        const parsed = JSON.parse(readFileSync(file, 'utf-8'));
-        if (!parsed.hooks || typeof parsed.hooks !== 'object')
-            parsed.hooks = {};
-        return parsed;
-    }
-    catch {
-        return { hooks: {} };
-    }
+/** True when this hook entry is the waiter. */
+export function isMessageWaiterEntry(entry) {
+    return isMessageHookEntry(entry) && /--wait$/.test(entryCommand(entry).trim());
 }
-/**
- * Register the board hooks in every given hooks.json.
- *
- * Returns the files it wrote. A file it cannot parse is skipped rather than
- * overwritten: another tool's config is not ours to replace.
- */
-export function registerBoardHooks(files, execPath, cliEntry) {
-    const written = [];
-    for (const file of files) {
-        if (existsSync(file)) {
-            try {
-                JSON.parse(readFileSync(file, 'utf-8'));
-            }
-            catch {
-                continue;
-            }
-        }
-        const config = readConfig(file);
-        mergeBoardHooks(config, execPath, cliEntry);
-        try {
-            mkdirSync(dirname(file), { recursive: true });
-            writeFileSync(file, JSON.stringify(config, null, 2) + '\n');
-            written.push(file);
-        }
-        catch { /* a read-only profile directory is not a reason to fail setup */ }
-    }
-    return written;
+/** The `[event, entry]` pairs for the message hook: the turn runs, then the waiters. */
+export function messageHookEntries(execPath, hookEntry) {
+    const turn = messageHookCommand(execPath, hookEntry);
+    const waiter = messageHookCommand(execPath, hookEntry, true);
+    return [
+        ...MESSAGE_HOOK_EVENTS.map((event) => [event, { matcher: '', hooks: [{ type: 'command', command: turn }] }]),
+        ...MESSAGE_WAITER_EVENTS.map((event) => [event, { matcher: '', hooks: [{ type: 'command', command: waiter, asyncRewake: true }] }]),
+    ];
 }
 /** Resolve the CLI entry that a hook should run. */
 export function resolveCliEntry(distDir) {
     const bundled = join(distDir, 'cli.js');
     return existsSync(bundled) ? bundled : join(distDir, 'cli.ts');
 }
+/** Resolve the message hook bundle that sits beside the CLI. */
+export function resolveMessageHookEntry(distDir) {
+    const bundled = join(distDir, 'message-hook.js');
+    return existsSync(bundled) ? bundled : join(distDir, 'message-hook.ts');
+}
 //# sourceMappingURL=board-hooks.js.map

package/dist/board-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"board-hooks.js","sourceRoot":"","sources":["../src/board-hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"board-hooks.js","sourceRoot":"","sources":["../src/board-hooks.ts"],"names":[],"mappings":"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"}