@berthdev/berth 0.3.6 → 0.4.3

package/dist/src/agents/hook-files.js

@@ -1,6 +1,7 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { homedir } from 'node:os';
+import { agentRoot } from './roots.js';
+import { existsSync, readFileSync, rmSync } from 'node:fs';
+import { writeConfigFile } from '../config/write.js';
+import { join } from 'node:path';
 import { BerthError, ExitCode } from '../errors.js';
 /**
  * Where and how each agent reads its hooks (spec §8). Every format marks
@@ -8,7 +9,6 @@ import { BerthError, ExitCode } from '../errors.js';
  * only Berth's own entries.
  */
 export const MARKER = 'BERTH_HOOK=1';
-const home = (env) => env.HOME || homedir();
 function readJson(file) {
     if (!existsSync(file))
         return {};
@@ -19,11 +19,7 @@ function readJson(file) {
         throw new BerthError(`cannot parse ${file}: ${error.message}`);
     }
 }
-function writeText(file, text) {
-    mkdirSync(dirname(file), { recursive: true });
-    writeFileSync(file, text);
-}
-const writeJson = (file, data) => writeText(file, `${JSON.stringify(data, null, 2)}\n`);
+const writeJson = (file, data) => writeConfigFile(file, `${JSON.stringify(data, null, 2)}\n`);
 function withoutBerthNested(groups = []) {
     return groups
         .map((g) => ({ ...g, hooks: (g.hooks ?? []).filter((h) => !h.command?.includes(MARKER)) }))
@@ -98,58 +94,83 @@ function stripTomlBlock(text) {
  */
 const tomlConfig = {
     file(env) {
-        if (env.KIMI_CODE_HOME)
-            return join(env.KIMI_CODE_HOME, 'config.toml');
-        const legacy = join(home(env), '.kimi');
-        const current = join(home(env), '.kimi-code');
-        return existsSync(legacy) && !existsSync(current) ? join(legacy, 'config.toml') : join(current, 'config.toml');
+        return join(agentRoot('kimi', env), 'config.toml');
     },
     install(path, events, commandFor) {
         const base = stripTomlBlock(existsSync(path) ? readFileSync(path, 'utf8') : '');
         const tables = events.map((event) => `[[hooks]]\nevent = ${JSON.stringify(event)}\ncommand = ${JSON.stringify(commandFor(event))}\n`);
         const sep = base && !base.endsWith('\n') ? '\n\n' : base ? '\n' : '';
-        writeText(path, `${base}${sep}${TOML_BEGIN}\n${tables.join('\n')}${TOML_END}\n`);
+        writeConfigFile(path, `${base}${sep}${TOML_BEGIN}\n${tables.join('\n')}${TOML_END}\n`);
     },
     uninstall(path) {
         if (existsSync(path))
-            writeText(path, stripTomlBlock(readFileSync(path, 'utf8')));
+            writeConfigFile(path, stripTomlBlock(readFileSync(path, 'utf8')));
     },
 };
 // ---- OpenCode: a plugin module ------------------------------------------
 /** OpenCode loads every module in its plugins folder; this one forwards session events to `berth hook`. */
-export function opencodePlugin(node, cli, events) {
+export function opencodePlugin(node, cli, events, electron = process.env.ELECTRON_RUN_AS_NODE === '1') {
     return `// ${MARKER}: written by \`berth hooks install opencode\`; remove with \`berth hooks uninstall opencode\`.
 import { spawn } from 'node:child_process';
 
 const EVENTS = new Set(${JSON.stringify(events)});
-const children = new Set();
+const roots = new Set();
+const failed = new Set();
+let pending = Promise.resolve();
 
-function send(event, id) {
-  if (!process.env.TMUX_PANE) return;
-  try {
-    const child = spawn(${JSON.stringify(node)}, [${JSON.stringify(cli)}, 'hook', 'opencode', event], {
-      stdio: ['pipe', 'ignore', 'ignore'],
-      env: { ...process.env, BERTH_HOOK: '1' },
-    });
-    child.on('error', () => {});
-    child.stdin.end(JSON.stringify({ session_id: id ?? '' }));
-  } catch {
-    // Never disturb the agent.
-  }
+function send(event, id, payload = {}) {
+  if (!process.env.TMUX_PANE) return Promise.resolve();
+  return new Promise((resolve) => {
+    try {
+      const child = spawn(${JSON.stringify(node)}, [${JSON.stringify(cli)}, 'hook', 'opencode', event], {
+        stdio: ['pipe', 'ignore', 'ignore'],
+        env: { ...process.env, BERTH_HOOK: '1', ...${JSON.stringify(electron ? { ELECTRON_RUN_AS_NODE: '1' } : {})} },
+      });
+      const timer = setTimeout(() => child.kill('SIGKILL'), 10_000);
+      const finish = () => { clearTimeout(timer); resolve(); };
+      child.on('error', finish);
+      child.on('close', finish);
+      child.stdin.on('error', () => {});
+      child.stdin.end(JSON.stringify({ ...payload, session_id: id }));
+    } catch {
+      resolve();
+    }
+  });
 }
 
-export const BerthPlugin = async () => ({
-  event: async ({ event }) => {
-    if (!EVENTS.has(event.type)) return;
-    const props = event.properties ?? event.data ?? {};
-    const id = props.sessionID ?? props.info?.id;
-    // Subagent sessions are children of the conversation the user resumes.
-    if (props.info?.parentID) {
-      if (id) children.add(id);
+async function forward(event) {
+  if (!EVENTS.has(event.type)) return;
+  const props = event.properties ?? event.data ?? {};
+  const identity = event.type === 'session.created' || event.type === 'session.updated';
+  const id = props.sessionID ?? (identity ? props.info?.id : undefined);
+  if (typeof id !== 'string' || !id) return;
+  if (identity) {
+    if (!props.info || props.info.id !== id || props.info.parentID) {
+      roots.delete(id);
       return;
     }
-    if (id && children.has(id)) return;
-    send(event.type, id);
+    roots.add(id);
+    return send(event.type, id);
+  }
+  if (!roots.has(id)) return;
+  if (event.type === 'session.status') {
+    if (!['busy', 'retry'].includes(props.status?.type)) return;
+    failed.delete(id);
+  }
+  const rejected = event.type === 'permission.replied' && props.reply === 'reject';
+  if (event.type === 'permission.replied' && !['once', 'always', 'reject'].includes(props.reply)) return;
+  if (event.type === 'session.error' || rejected) failed.add(id);
+  const type = rejected || (event.type === 'session.idle' && failed.has(id)) ? 'session.error' : event.type;
+  const payload = event.type === 'permission.asked' && typeof props.permission === 'string'
+    ? { message: 'Approval requested: ' + props.permission } : {};
+  return send(type, id, payload);
+}
+
+export const BerthPlugin = async () => ({
+  event: ({ event }) => {
+    // Native publishers need not await plugin callbacks; keep child processes ordered.
+    pending = pending.then(() => forward(event)).catch(() => {});
+    return pending;
   },
 });
 `;
@@ -157,11 +178,10 @@ export const BerthPlugin = async () => ({
 function opencodeFormat(node, cli) {
     return {
         file(env) {
-            const config = env.XDG_CONFIG_HOME || join(home(env), '.config');
-            return join(config, 'opencode', 'plugins', 'berth.js');
+            return join(agentRoot('opencode', env), 'plugins', 'berth.js');
         },
         install(path, events) {
-            writeText(path, opencodePlugin(node, cli, events));
+            writeConfigFile(path, opencodePlugin(node, cli, events));
         },
         uninstall(path) {
             if (existsSync(path) && readFileSync(path, 'utf8').includes(MARKER))
@@ -173,17 +193,17 @@ function opencodeFormat(node, cli) {
 export function hookFormat(target, cli = '') {
     switch (target) {
         case 'claude-settings':
-            return nestedJson((env) => join(home(env), '.claude', 'settings.json'));
+            return nestedJson((env) => join(agentRoot('claude', env), 'settings.json'));
         case 'codex-hooks':
-            return nestedJson((env) => join(home(env), '.codex', 'hooks.json'));
+            return nestedJson((env) => join(agentRoot('codex', env), 'hooks.json'));
         case 'gemini-settings':
-            return nestedJson((env) => join(home(env), '.gemini', 'settings.json'));
+            return nestedJson((env) => join(agentRoot('gemini', env), 'settings.json'));
         case 'qoder-settings':
-            return nestedJson((env) => join(env.QODER_CONFIG_DIR || join(home(env), '.qoder'), 'settings.json'));
+            return nestedJson((env) => join(agentRoot('qoder', env), 'settings.json'));
         case 'cursor-hooks':
-            return flatJson((env) => join(home(env), '.cursor', 'hooks.json'), false);
+            return flatJson((env) => join(agentRoot('cursor', env), 'hooks.json'), false);
         case 'copilot-hooks':
-            return flatJson((env) => join(env.COPILOT_HOME || join(home(env), '.copilot'), 'hooks', 'berth.json'), true);
+            return flatJson((env) => join(agentRoot('copilot', env), 'hooks', 'berth.json'), true);
         case 'kimi-config':
             return tomlConfig;
         case 'opencode-plugin':
@@ -192,8 +212,4 @@ export function hookFormat(target, cli = '') {
             throw new BerthError(`unknown hook target ${String(target)}`, ExitCode.usage);
     }
 }
-/** Whether the target file holds Berth's entries. */
-export function containsBerth(file) {
-    return existsSync(file) && readFileSync(file, 'utf8').includes(MARKER);
-}
 //# sourceMappingURL=hook-files.js.map

package/dist/src/agents/hook-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-files.js","sourceRoot":"","sources":["../../../src/agents/hook-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,cAAc,CAAC;AAYrC,MAAM,IAAI,GAAG,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;AAMjD,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAS,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,gBAAgB,IAAI,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IAC3C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,IAAU,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAKtG,SAAS,kBAAkB,CAAC,SAAwB,EAAE;IACpD,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;SAC1F,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,SAAS,CAAI,IAAU,EAAE,IAA0B;IAC1D,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAwB,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAA0B;IAC5C,OAAO;QACL,IAAI;QACJ,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU;YAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,KAAK,GAAG,SAAS,CAAc,IAAI,EAAE,kBAAkB,CAAC,CAAC;YAC/D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACzG,CAAC;YACD,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,CAAc,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;KACF,CAAC;AACJ,CAAC;AAKD,MAAM,gBAAgB,GAAG,CAAC,UAAuB,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5G,SAAS,QAAQ,CAAC,IAA0B,EAAE,OAAgB;IAC5D,OAAO;QACL,IAAI;QACJ,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU;YAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,SAAS,CAAY,IAAI,EAAE,gBAAgB,CAAC,CAAC;YAC3D,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtH,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC9B,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,CAAY,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,GAAG,sBAAsB,MAAM,4CAA4C,CAAC;AAC5F,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAErC,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC5D,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACrH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,GAAe;IAC7B,IAAI,CAAC,GAAG;QACN,IAAI,GAAG,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;QAC9C,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU;QAC9B,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QACtI,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,GAAG,GAAG,UAAU,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;IACnF,CAAC;IACD,SAAS,CAAC,IAAI;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;CACF,CAAC;AAEF,4EAA4E;AAE5E,2GAA2G;AAC3G,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW,EAAE,MAAgB;IACxE,OAAO,MAAM,MAAM;;;yBAGI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;;;;;;0BAMrB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CAyBtE,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,GAAW;IAC/C,OAAO;QACL,IAAI,CAAC,GAAG;YACN,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,IAAI,EAAE,MAAM;YAClB,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrG,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,GAAG,GAAG,EAAE;IACrD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,iBAAiB;YACpB,OAAO,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;QAC1E,KAAK,aAAa;YAChB,OAAO,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;QACtE,KAAK,iBAAiB;YACpB,OAAO,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;QAC1E,KAAK,gBAAgB;YACnB,OAAO,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;QACvG,KAAK,cAAc;YACjB,OAAO,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5E,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/G,KAAK,aAAa;YAChB,OAAO,UAAU,CAAC;QACpB,KAAK,iBAAiB;YACpB,OAAO,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/C;YACE,MAAM,IAAI,UAAU,CAAC,uBAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC"}
+{"version":3,"file":"hook-files.js","sourceRoot":"","sources":["../../../src/agents/hook-files.ts"],"names":[],"mappings":"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"}

package/dist/src/agents/hook-health.d.ts

@@ -0,0 +1,4 @@
+import type { Adapter } from './registry.js';
+export type FileHookHealth = 'installed' | 'missing' | 'broken';
+/** Configuration health only; agent version and runtime delivery need separate evidence. */
+export declare function inspectHooks(adapter: Adapter, env: NodeJS.ProcessEnv): FileHookHealth;

package/dist/src/agents/hook-health.js

@@ -0,0 +1,95 @@
+import { accessSync, constants, existsSync, readFileSync, statSync } from 'node:fs';
+import { isAbsolute } from 'node:path';
+import { parse as parseToml } from 'smol-toml';
+import { shellQuote, shellSplit } from '../shell.js';
+import { hookFormat, MARKER, opencodePlugin } from './hook-files.js';
+const record = (value) => value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+function accessible(file, mode) {
+    try {
+        if (!isAbsolute(file) || !statSync(file).isFile())
+            return false;
+        accessSync(file, mode);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function targetsExist(runtime, cli) {
+    return accessible(runtime, constants.X_OK) && accessible(cli, constants.R_OK);
+}
+/** Accept only the shell command shape Berth writes; never execute it to inspect it. */
+function validCommand(value, agent, event) {
+    if (typeof value !== 'string' || !value.startsWith(`${MARKER} `))
+        return false;
+    const words = shellSplit(value);
+    if (words[0] !== MARKER)
+        return false;
+    const electron = words[1] === 'ELECTRON_RUN_AS_NODE=1';
+    const offset = electron ? 2 : 1;
+    const args = words.slice(offset);
+    if (args.length !== 5 || args[2] !== 'hook' || args[3] !== agent || args[4] !== event)
+        return false;
+    const canonical = `${MARKER} ${electron ? 'ELECTRON_RUN_AS_NODE=1 ' : ''}${shellQuote(args[0])} ${shellQuote(args[1])} hook ${agent} ${shellQuote(event)}`;
+    return value === canonical && targetsExist(args[0], args[1]);
+}
+function jsonComplete(text, adapter, events) {
+    const data = record(JSON.parse(text));
+    if (data.disableAllHooks === true)
+        return false;
+    const flat = adapter.hookTarget === 'cursor-hooks' || adapter.hookTarget === 'copilot-hooks';
+    if (flat && data.version !== 1)
+        return false;
+    const hooks = record(data.hooks);
+    return events.every((event) => {
+        const groups = hooks[event];
+        if (!Array.isArray(groups))
+            return false;
+        const commands = flat ? groups : groups.flatMap((value) => {
+            const group = record(value);
+            if (group.matcher && group.matcher !== '*')
+                return [];
+            return Array.isArray(group.hooks) ? group.hooks : [];
+        });
+        return commands.some((value) => {
+            const entry = record(value);
+            return entry.type === 'command' && validCommand(entry.command, adapter.id, event);
+        });
+    });
+}
+function tomlComplete(text, adapter, events) {
+    const hooks = parseToml(text).hooks;
+    return Array.isArray(hooks) && events.every((event) => hooks.some((value) => {
+        const entry = record(value);
+        return entry.event === event && validCommand(entry.command, adapter.id, event);
+    }));
+}
+function pluginComplete(text, events) {
+    const match = /const child = spawn\(("(?:[^"\\]|\\.)*"), \[("(?:[^"\\]|\\.)*"), 'hook', 'opencode', event\]/.exec(text);
+    if (!match)
+        return false;
+    const runtime = JSON.parse(match[1]), cli = JSON.parse(match[2]);
+    return targetsExist(runtime, cli) && [false, true].some((electron) => text === opencodePlugin(runtime, cli, events, electron));
+}
+/** Configuration health only; agent version and runtime delivery need separate evidence. */
+export function inspectHooks(adapter, env) {
+    if (!adapter.hookTarget)
+        return 'missing';
+    const file = hookFormat(adapter.hookTarget).file(env);
+    try {
+        if (!existsSync(file))
+            return 'missing';
+        const text = readFileSync(file, 'utf8');
+        if (!text.includes(MARKER))
+            return 'missing';
+        const events = [...new Set(Object.values(adapter.events).flat())];
+        const complete = adapter.hookTarget === 'opencode-plugin' ? pluginComplete(text, events)
+            : adapter.hookTarget === 'kimi-config' ? tomlComplete(text, adapter, events)
+                : jsonComplete(text, adapter, events);
+        return complete ? 'installed' : 'broken';
+    }
+    catch {
+        return 'broken';
+    }
+}
+//# sourceMappingURL=hook-health.js.map

package/dist/src/agents/hook-health.js.map

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

package/dist/src/agents/hooks.d.ts

@@ -4,9 +4,12 @@ export declare function hookCommand(cliPath: string, agent: string, event: strin
 export declare function installHooks(agentId: string, cliPath: string, env?: NodeJS.ProcessEnv): string;
 export declare function uninstallHooks(agentId: string, env?: NodeJS.ProcessEnv): string;
 export declare function hooksInstalled(agentId: string, env?: NodeJS.ProcessEnv): boolean;
-export type HookStatus = 'installed' | 'missing' | 'none';
+export type HookStatus = 'installed' | 'missing' | 'broken' | 'none' | 'unknown';
 /** Whether an agent's hooks are installed; `none` when Berth has no hooks for it. */
 export declare function hookStatus(agentId: string, env?: NodeJS.ProcessEnv): HookStatus;
+/** Agent-owned activation that writing a hook file cannot complete. */
+export declare function hookSetupGuidance(agentId: string): string | undefined;
+export declare function hookInstallNotice(agentId: string, file: string): string;
 /** What a user is told when an agent in use has no hooks (spec §4.2). */
 export declare function hookHint(agentId: string): string;
 /** What a hook event changes on the session, or nothing when the event does not matter. */

package/dist/src/agents/hooks.js

@@ -1,15 +1,22 @@
+import { copilotCursor } from './copilot-state.js';
+import { lateBindingId } from './late-binding.js';
+import { geminiCursor } from './gemini-state.js';
+import { processLifetime } from '../process-owner.js';
+import { captureProfile, profileKey, readProfile } from './profile.js';
+import { withLock } from '../restore/lock.js';
 import { BerthError, ExitCode } from '../errors.js';
 import { shellQuote } from '../shell.js';
 import { Tmux } from '../tmux/client.js';
 import { presentState } from '../present/state.js';
 import { createContext } from '../context.js';
+import { discover, processes, sessionProducers, PRODUCER_CHANGED, BINDING_UNVERIFIED } from '../registry/discover.js';
 import { snapshotQuietly } from '../snapshot/take.js';
 import { requireAdapter } from './commands.js';
 import { getAdapter, stateForEvent } from './registry.js';
-import { containsBerth, hookFormat, MARKER } from './hook-files.js';
+import { inspectHooks } from './hook-health.js';
+import { hookFormat, MARKER } from './hook-files.js';
 function hookEvents(adapter) {
-    const { start, working, waiting, done } = adapter.events;
-    return [...new Set([...start, ...working, ...waiting, ...done])];
+    return [...new Set(Object.values(adapter.events).flat())];
 }
 function targetOf(adapter) {
     if (!adapter.hookTarget)
@@ -18,13 +25,16 @@ function targetOf(adapter) {
 }
 /** Command an agent runs for an event: `BERTH_HOOK=1 <node> <cli> hook <agent> <event>`. */
 export function hookCommand(cliPath, agent, event) {
-    return `${MARKER} ${shellQuote(process.execPath)} ${shellQuote(cliPath)} hook ${agent} ${shellQuote(event)}`;
+    const runtimeMode = process.env.ELECTRON_RUN_AS_NODE === '1' ? 'ELECTRON_RUN_AS_NODE=1 ' : '';
+    return `${MARKER} ${runtimeMode}${shellQuote(process.execPath)} ${shellQuote(cliPath)} hook ${agent} ${shellQuote(event)}`;
 }
 export function installHooks(agentId, cliPath, env = process.env) {
     const adapter = requireAdapter(agentId);
     const format = hookFormat(targetOf(adapter), cliPath);
     const file = format.file(env);
     format.install(file, hookEvents(adapter), (event) => hookCommand(cliPath, adapter.id, event), adapter);
+    if (inspectHooks(adapter, env) !== 'installed')
+        throw new BerthError(`Hooks were written to ${file}, but configuration remains incomplete, disabled, or its runtime is unavailable. Inspect this file before retrying.`);
     return file;
 }
 export function uninstallHooks(agentId, env = process.env) {
@@ -37,7 +47,7 @@ export function hooksInstalled(agentId, env = process.env) {
     const adapter = requireAdapter(agentId);
     if (!adapter.hookTarget)
         return false;
-    return containsBerth(hookFormat(adapter.hookTarget).file(env));
+    return inspectHooks(adapter, env) === 'installed';
 }
 /** Whether an agent's hooks are installed; `none` when Berth has no hooks for it. */
 export function hookStatus(agentId, env = process.env) {
@@ -45,16 +55,26 @@ export function hookStatus(agentId, env = process.env) {
     if (!adapter?.hookTarget)
         return 'none';
     try {
-        return hooksInstalled(agentId, env) ? 'installed' : 'missing';
+        return inspectHooks(adapter, env);
     }
     catch {
         return 'missing';
     }
 }
+/** Agent-owned activation that writing a hook file cannot complete. */
+export function hookSetupGuidance(agentId) {
+    return agentId === 'codex'
+        ? 'Codex manages hook trust in /hooks. Review new or changed Berth hooks there before they can run.'
+        : undefined;
+}
+export function hookInstallNotice(agentId, file) {
+    const name = getAdapter(agentId)?.displayName ?? agentId;
+    return `Berth: ${name} hook configuration installed (${file}).${hookSetupGuidance(agentId) ? ` ${hookSetupGuidance(agentId)}` : ''}`;
+}
 /** What a user is told when an agent in use has no hooks (spec §4.2). */
 export function hookHint(agentId) {
     const name = getAdapter(agentId)?.displayName ?? agentId;
-    return `Berth: ${name} hooks are not installed, so after a restart this session starts a new conversation. Run: berth hooks install ${agentId}`;
+    return `Berth: ${name} hooks are not installed. State updates and future conversation binding may be unavailable. Run: berth hooks install ${agentId}`;
 }
 /** What a hook event changes on the session, or nothing when the event does not matter. */
 export function metaForEvent(adapter, event, payload) {
@@ -64,14 +84,33 @@ export function metaForEvent(adapter, event, payload) {
         meta.conversation = id;
     let state = stateForEvent(adapter, event);
     // Some agents also notify for idle reminders; only a permission request means waiting.
-    if (state === 'waiting' && adapter.waitingWhen && !adapter.waitingWhen(payload))
+    if (state === 'waiting' && adapter.waitingWhen && !adapter.waitingWhen(payload, event))
         state = undefined;
-    if (state)
+    if (state !== undefined && adapter.idleWhen?.(event, payload))
+        state = '';
+    if (state !== undefined)
         meta.state = state;
     // Latest notification text, shown in session lists (spec §6). A new state
     // replaces it, so a finished session never shows an old permission request.
-    if (state)
-        meta.note = typeof payload.message === 'string' ? payload.message.trim().slice(0, 200) : '';
+    if (state !== undefined) {
+        const input = payload.tool_input;
+        const description = input && typeof input === 'object' && 'description' in input ? input.description : undefined;
+        const message = typeof payload.message === 'string' && payload.message.trim() ? payload.message
+            : state === 'waiting' && typeof description === 'string' ? description
+                : state === 'waiting' && typeof payload.tool_name === 'string' ? `Approval requested: ${payload.tool_name}` : '';
+        meta.note = state === '' ? '' : message.trim().slice(0, 200);
+    }
+    // The session's subtitle: the first line of the prompt the user just sent (spec §4.2).
+    // Text the agent injects itself (`<task-notification>`, `<command-name>`…) is not the user's.
+    if (state === 'working' && typeof payload.prompt === 'string' && !/^\s*<[a-z][\w-]*[\s>]/i.test(payload.prompt)) {
+        // Attachment placeholders such as `[Image #3]` say nothing about the topic.
+        const first = payload.prompt
+            .split('\n')
+            .map((l) => l.replace(/\[(Image|Pasted text) #\d+[^\]]*\]/g, '').replace(/\s+/g, ' ').trim())
+            .find(Boolean);
+        if (first)
+            meta.topic = first.slice(0, 120);
+    }
     return meta;
 }
 /**
@@ -92,22 +131,115 @@ export function handleHook(agentId, event, stdin, env = process.env) {
         catch {
             payload = {};
         }
-        const meta = metaForEvent(adapter, event, payload);
+        let meta = metaForEvent(adapter, event, payload);
+        const lateId = lateBindingId(agentId, event, payload);
         if (Object.keys(meta).length === 0)
             return {};
         const tmux = new Tmux({ bin: env.BERTH_TMUX || 'tmux', socketPath });
         const session = tmux.sessionOfPane(pane);
         if (!session)
             return {};
-        tmux.setMeta(session, meta);
-        if (meta.state)
-            presentState(tmux, session, meta.state, { note: meta.note });
-        // A new conversation id must reach the snapshot before any reboot.
-        if (meta.conversation) {
-            const ctx = createContext({ ...env, BERTH_TMUX_SOCKET_PATH: socketPath });
-            snapshotQuietly(ctx);
-        }
-        return meta;
+        const ctx = createContext({ ...env, BERTH_TMUX_SOCKET_PATH: socketPath });
+        return withLock(ctx.config.stateDir, () => {
+            let live = tmux.listSessions().find((s) => s.name === session);
+            const table = processes();
+            const producers = sessionProducers(ctx, session, table);
+            const ancestors = [];
+            for (let pid = process.pid; pid > 1 && ancestors.length < 64 && !ancestors.includes(pid);) {
+                ancestors.push(pid);
+                pid = table.find((p) => p.pid === pid)?.ppid ?? 0;
+            }
+            if (!live?.meta.agent || live.meta.agent === 'shell') {
+                const producer = producers[0];
+                if (!ctx.config.autoAdopt || (!adapter.events.start.includes(event) && !lateId) || producers.length !== 1
+                    || producer.agent !== agentId || producer.pane !== pane || !ancestors.includes(producer.pid))
+                    return {};
+                discover(ctx);
+                live = tmux.listSessions().find((s) => s.name === session);
+            }
+            if (!live?.meta.agent)
+                return {};
+            if (agentId === 'gemini' && event === 'BeforeModel' && live.meta.state !== 'waiting')
+                return {};
+            if (live.meta.agent !== agentId) {
+                tmux.setMeta(session, { bindingIssue: 'Agent producer changed. Verify the conversation before restoring.' });
+                snapshotQuietly(ctx);
+                return {};
+            }
+            const otherPane = live.meta.producerPane && live.meta.producerPane !== pane;
+            if (producers.length > 1 || otherPane) {
+                tmux.setMeta(session, { bindingIssue: 'Multiple independent agents. Move each agent to its own tmux session before restoring.' });
+                snapshotQuietly(ctx);
+                return {};
+            }
+            const producer = producers[0];
+            if (producer) {
+                if (producer.agent !== agentId || producer.pane !== pane || !ancestors.includes(producer.pid))
+                    return {};
+            }
+            if (!producer && (!live.meta.recovery || live.meta.recovery === 'confirmed') && meta.conversation && live.meta.conversation && meta.conversation !== live.meta.conversation) {
+                tmux.setMeta(session, { bindingIssue: 'Cannot verify the producer of a different conversation. Inspect the agent and re-adopt before restoring.' });
+                snapshotQuietly(ctx);
+                return {};
+            }
+            const payloadId = payload.session_id ?? payload.sessionId ?? payload.sessionID ?? payload.conversation_id;
+            if (!adapter.events.start.includes(event) && typeof payloadId === 'string' && live.meta.conversation && payloadId !== live.meta.conversation)
+                return {};
+            if (producer && lateId && !live.meta.conversation && (!live.meta.recovery || live.meta.recovery === 'confirmed')
+                && (!live.meta.bindingIssue || [PRODUCER_CHANGED, BINDING_UNVERIFIED].includes(live.meta.bindingIssue))) {
+                const existingProfile = readProfile(agentId, live.meta.profile);
+                const observedProfile = captureProfile(agentId, env);
+                if (live.meta.profile && (!existingProfile || profileKey(agentId, existingProfile) !== profileKey(agentId, observedProfile)))
+                    return {};
+                meta = { ...meta, conversation: lateId };
+            }
+            // Claim once in tmux, so simultaneous first hooks cannot both own the row.
+            tmux.run(['set-option', '-o', '-t', `=${session}:`, '@berth_producerPane', pane], true);
+            const owner = tmux.run(['display-message', '-p', '-t', `=${session}:`, '#{@berth_producerPane}'], true).stdout.trim();
+            if (owner !== pane) {
+                tmux.setMeta(session, { bindingIssue: 'Another pane owns this conversation. Separate agents before restoring.' });
+                snapshotQuietly(ctx);
+                return {};
+            }
+            const confirmsExisting = !!producer && typeof payloadId === 'string' && !!live.meta.conversation && payloadId === live.meta.conversation;
+            const profile = meta.conversation || (confirmsExisting && !live.meta.profile) ? captureProfile(agentId, env) : undefined;
+            if (live.meta.recovery && live.meta.recovery !== 'confirmed' && meta.conversation) {
+                const expectedProfile = readProfile(agentId, live.meta.profile);
+                if (profile && expectedProfile && profileKey(agentId, profile) !== profileKey(agentId, expectedProfile)) {
+                    tmux.setMeta(session, { recovery: 'failed', recoveryDetail: 'Agent opened a different profile. The expected conversation and profile were preserved.' });
+                    snapshotQuietly(ctx);
+                    return {};
+                }
+                if (meta.conversation !== live.meta.conversation) {
+                    tmux.setMeta(session, { recovery: 'failed', recoveryDetail: 'Agent opened a different conversation. Inspect the terminal; the expected ID was preserved.' });
+                    snapshotQuietly(ctx);
+                    return {};
+                }
+                const dead = tmux.run(['display-message', '-p', '-t', pane, '#{pane_dead}'], true).stdout.trim();
+                if (dead === '1')
+                    return {};
+                tmux.setMeta(session, { recovery: 'confirmed', recoveryDetail: '' });
+                tmux.run(['set-option', '-w', '-t', `=${session}:`, 'remain-on-exit', 'off']);
+            }
+            tmux.setMeta(session, {
+                ...meta, producerPane: pane,
+                ...(agentId === 'gemini' && event === 'BeforeAgent' ? {
+                    nativeTranscript: producer ? geminiCursor(payload.transcript_path, meta.conversation || live.meta.conversation || '', env) : '',
+                } : agentId === 'copilot' && event === 'userPromptSubmitted' ? {
+                    nativeTranscript: producer ? copilotCursor(meta.conversation || live.meta.conversation || '', env) : '',
+                } : ['gemini', 'copilot'].includes(agentId) && adapter.events.start.includes(event) ? { nativeTranscript: '' } : {}),
+                ...(producer ? { producerLifetime: processLifetime(producer.pid)?.key } : {}),
+                ...(producer && (meta.conversation || (typeof payloadId === 'string' && payloadId === live.meta.conversation)) && (live.meta.bindingIssue === PRODUCER_CHANGED || live.meta.bindingIssue === BINDING_UNVERIFIED) ? { bindingIssue: '' } : {}),
+                ...(profile ? { profile: JSON.stringify(profile) } : {}),
+            });
+            if (meta.state !== undefined)
+                presentState(tmux, session, meta.state, { note: meta.note });
+            // A new conversation id must reach the snapshot before any reboot.
+            if (meta.conversation || (confirmsExisting && (profile || live.meta.bindingIssue === PRODUCER_CHANGED || live.meta.bindingIssue === BINDING_UNVERIFIED))) {
+                snapshotQuietly(ctx);
+            }
+            return meta;
+        });
     }
     catch {
         return {};