@berthdev/berth 0.3.6 → 0.4.3

package/README.md

@@ -13,5 +13,11 @@ berth tmux install                   # snapshot automatically as sessions change
 berth ensure                         # after a reboot: rebuild and resume
 ```
 
-Requires Node ≥ 20 and tmux ≥ 3.0. Behaviour is specified in the repository's
+Recovery requires a verified conversation ID and its profile. Installing hooks
+cannot identify every conversation that was already running: the agent must
+execute a supported event or expose verified native identity evidence. Codex's
+shared-daemon TUI does not yet support passive binding. Berth preserves unknown
+bindings rather than resuming the most recent conversation in a directory.
+
+Requires Node ≥ 20 and tmux ≥ 3.0. macOS process discovery also uses system Perl. Behaviour is specified in the repository's
 `design/spec.md`.

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

@@ -0,0 +1,13 @@
+import type { Adapter } from './registry.js';
+export interface VersionObservation {
+    executable: string;
+    version?: string;
+    detail?: string;
+}
+export interface CapabilityAssessment {
+    severity: 'info' | 'warning';
+    detail: string;
+}
+export declare function assessCapability(agent: string, version: string): CapabilityAssessment;
+/** Query only a standard adapter executable; never invoke a custom launcher. */
+export declare function versionInspector(env: NodeJS.ProcessEnv): (adapter: Adapter, cwd?: string) => VersionObservation;

package/dist/src/agents/capabilities.js

@@ -0,0 +1,52 @@
+import { spawnSync } from 'node:child_process';
+import { executableOnPath } from '../tools.js';
+/** Evidence refers to a tested release, not the current process or profile. */
+const TESTED = {
+    claude: ['2.1.310'], codex: ['0.162.1', '0.166.0'], kimi: ['0.31.1'], opencode: ['1.19.5'], gemini: ['0.66.0'], copilot: ['1.0.105'],
+};
+export function assessCapability(agent, version) {
+    // Cursor's dated build format is distinct from its editor's semantic version.
+    // Source: https://cursor.com/changelog/cli-jan-16-2026 (checked 2026-11-01).
+    const dated = /^(20\d{2})\.(\d{2})\.(\d{2})(?:-[A-Za-z0-9.-]+)?$/.exec(version);
+    const date = dated && new Date(Date.UTC(Number(dated[1]), Number(dated[2]) - 1, Number(dated[3])));
+    const validDate = dated && date && date.getUTCFullYear() === Number(dated[1])
+        && date.getUTCMonth() + 1 === Number(dated[2]) && date.getUTCDate() === Number(dated[3]);
+    if (agent === 'cursor' && validDate && dated.slice(1, 4).join('') < '20260116') {
+        return { severity: 'warning', detail: 'Predates the 2026-01-16 lifecycle hooks release. Update Cursor CLI, then verify a session binding and exact-ID recovery.' };
+    }
+    if (TESTED[agent]?.includes(version)) {
+        return { severity: 'info', detail: 'Berth tested this release on macOS with an isolated model fixture. Hook trust, binding and recovery in this profile still require their own acknowledgement.' };
+    }
+    return { severity: 'info', detail: 'This exact release has no Berth native acceptance record. Verify hook delivery and exact-ID recovery; hook files alone do not establish compatibility.' };
+}
+/** Query only a standard adapter executable; never invoke a custom launcher. */
+export function versionInspector(env) {
+    const cache = new Map();
+    let probes = 0;
+    return (adapter, cwd = process.cwd()) => {
+        const executable = executableOnPath(adapter.binary, env, cwd);
+        if (!executable)
+            return { executable: adapter.binary, detail: 'executable unavailable' };
+        const prior = cache.get(executable);
+        if (prior)
+            return prior;
+        if (probes >= 8)
+            return { executable, detail: 'version query limit reached; inspect this executable separately' };
+        probes++;
+        let observation;
+        try {
+            const result = spawnSync(executable, ['--version'], { env, cwd, encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'pipe'], timeout: 1000, killSignal: 'SIGKILL', maxBuffer: 16 * 1024 });
+            const output = result.status === 0 && !result.error ? result.stdout.trim() : '';
+            const matches = [...output.matchAll(/(?:^|\s)v?(\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?)(?=$|\s|\()/g)].map((match) => match[1]);
+            const version = new Set(matches).size === 1 ? matches[0] : undefined;
+            observation = { executable, ...(version ? { version } : { detail: result.error ? 'version query failed or timed out' : 'version output unavailable or unrecognized' }) };
+        }
+        catch {
+            observation = { executable, detail: 'version query could not run' };
+        }
+        cache.set(executable, observation);
+        return observation;
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/src/agents/capabilities.js.map

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

package/dist/src/agents/codex-binding.d.ts

@@ -0,0 +1,10 @@
+export interface CodexBinding {
+    conversation: string;
+    root: string;
+}
+/** Only numeric descriptors open for writing; never a filename mentioned in output. */
+export declare function writableFiles(output: string, pid: number): string[];
+/** Read metadata only, never transcript text or the newest file in a directory. */
+export declare function rolloutBinding(file: string, expectedInode?: number): CodexBinding | undefined;
+/** The same writer must still own the same file and process after inspection. */
+export declare function codexProcessBinding(pid: number, lifetime: string): CodexBinding | undefined;

package/dist/src/agents/codex-binding.js

@@ -0,0 +1,105 @@
+import { spawnSync } from 'node:child_process';
+import { closeSync, fstatSync, openSync, readSync, realpathSync } from 'node:fs';
+import { dirname, basename, sep } from 'node:path';
+import { processLifetime } from '../process-owner.js';
+const UUID = '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}';
+const ROLLOUT = new RegExp(`^rollout-.+-(${UUID})\\.jsonl$`, 'i');
+const HEADER_LIMIT = 1024 * 1024;
+const failures = new Map();
+/** Only numeric descriptors open for writing; never a filename mentioned in output. */
+export function writableFiles(output, pid) {
+    let owner = false, descriptor = false, writable = false;
+    const files = [];
+    for (const field of output.split('\n')) {
+        if (field.startsWith('p')) {
+            owner = field === `p${pid}`;
+            descriptor = false;
+            writable = false;
+        }
+        else if (field.startsWith('f')) {
+            descriptor = /^f\d+$/.test(field);
+            writable = false;
+        }
+        else if (field.startsWith('a'))
+            writable = field === 'aw' || field === 'au';
+        else if (owner && descriptor && writable && field.startsWith('n/'))
+            files.push(field.slice(1));
+    }
+    return [...new Set(files)];
+}
+/** Read metadata only, never transcript text or the newest file in a directory. */
+export function rolloutBinding(file, expectedInode) {
+    let fd;
+    try {
+        const canonical = realpathSync(file);
+        const match = ROLLOUT.exec(basename(canonical));
+        if (!match)
+            return undefined;
+        const parts = canonical.split(sep);
+        const index = parts.length - 5;
+        if (parts[index] !== 'sessions' || !/^\d{4}$/.test(parts[index + 1]) || !/^\d{2}$/.test(parts[index + 2]) || !/^\d{2}$/.test(parts[index + 3]))
+            return undefined;
+        fd = openSync(canonical, 'r');
+        const stat = fstatSync(fd);
+        if (!stat.isFile() || (expectedInode !== undefined && stat.ino !== expectedInode))
+            return undefined;
+        const bytes = Buffer.alloc(HEADER_LIMIT);
+        const count = readSync(fd, bytes, 0, bytes.length, 0);
+        const end = bytes.subarray(0, count).indexOf(10);
+        if (end < 0)
+            return undefined;
+        const record = JSON.parse(bytes.subarray(0, end).toString('utf8'));
+        const meta = record?.payload;
+        if (record?.type !== 'session_meta' || meta?.source !== 'cli' || meta.parent_thread_id || meta.agent_role || meta.agent_path)
+            return undefined;
+        if (typeof meta.id !== 'string' || meta.id.toLowerCase() !== match[1].toLowerCase())
+            return undefined;
+        return { conversation: meta.id, root: dirname(dirname(dirname(dirname(dirname(canonical))))) };
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+    }
+}
+/** The same writer must still own the same file and process after inspection. */
+export function codexProcessBinding(pid, lifetime) {
+    const key = `${pid}:${lifetime}`, now = Date.now();
+    if ((failures.get(key) ?? 0) > now)
+        return undefined;
+    for (const [entry, until] of failures)
+        if (until <= now)
+            failures.delete(entry);
+    const readFiles = () => {
+        const result = spawnSync('lsof', ['-n', '-P', '-a', '-p', String(pid), '-F', 'pfain'], {
+            encoding: 'utf8', timeout: 750, killSignal: 'SIGKILL', maxBuffer: 256 * 1024,
+        });
+        if (result.status !== 0 || result.error)
+            return [];
+        const files = new Set(writableFiles(result.stdout, pid));
+        return result.stdout.split(/(?=^f)/m).flatMap(block => {
+            const file = /^n(.+)$/m.exec(block)?.[1];
+            const inode = Number(/^i(\d+)$/m.exec(block)?.[1]);
+            return file && files.has(file) && ROLLOUT.test(basename(file)) && Number.isSafeInteger(inode) && inode > 0 ? [{ file, inode }] : [];
+        });
+    };
+    try {
+        if (processLifetime(pid)?.key !== lifetime)
+            return undefined;
+        const files = readFiles();
+        // Multiple writer files may represent concurrent threads, even when only one parses.
+        if (files.length === 1) {
+            const binding = rolloutBinding(files[0].file, files[0].inode);
+            if (binding && JSON.stringify(readFiles()) === JSON.stringify(files) && processLifetime(pid)?.key === lifetime)
+                return binding;
+        }
+    }
+    catch { /* Optional native evidence must not interrupt discovery. */ }
+    if (failures.size >= 256)
+        failures.clear();
+    failures.set(key, now + 30_000);
+    return undefined;
+}
+//# sourceMappingURL=codex-binding.js.map

package/dist/src/agents/codex-binding.js.map

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

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

@@ -3,8 +3,8 @@ import { type Adapter } from './registry.js';
 export declare function requireAdapter(id: string): Adapter;
 /**
  * Options from an original launch command that are kept on resume
- * (implementation §3.2). Anything not in the adapter's keep-set is dropped:
- * prompts, positional arguments, session selectors, one-shot modes.
+ * (implementation §3.2). Parse known option arity before selecting the keep-set. Unknown syntax
+ * requires explicit review instead of interpreting its values as options.
  */
 export declare function keptArgs(adapter: Adapter, argv: string): string[];
 export interface CommandInput {
@@ -21,3 +21,5 @@ export declare function resumeCommand(input: CommandInput & {
     conversation: string;
     originalArgv: string;
 }): string | undefined;
+/** Unverified provenance or unsupported syntax requires explicit review. */
+export declare function recoveryOptionsRequired(agent: string, argv: string, verified?: boolean): boolean;

package/dist/src/agents/commands.js

@@ -9,23 +9,44 @@ export function requireAdapter(id) {
 }
 /**
  * Options from an original launch command that are kept on resume
- * (implementation §3.2). Anything not in the adapter's keep-set is dropped:
- * prompts, positional arguments, session selectors, one-shot modes.
+ * (implementation §3.2). Parse known option arity before selecting the keep-set. Unknown syntax
+ * requires explicit review instead of interpreting its values as options.
  */
 export function keptArgs(adapter, argv) {
     const words = argv ? shellSplit(argv).slice(1) : [];
     const kept = [];
     for (let i = 0; i < words.length; i++) {
         const word = words[i];
-        if (!word.startsWith('-'))
+        if (word === '--')
+            break;
+        if (!word.startsWith('-') || word === '-')
             continue;
         const [flag] = word.split('=', 1);
-        if (!(flag in adapter.keep))
-            continue;
-        kept.push(word);
-        const takesValue = adapter.keep[flag];
-        if (takesValue && !word.includes('=') && i + 1 < words.length)
-            kept.push(words[++i]);
+        const retain = Object.hasOwn(adapter.keep, flag);
+        const arity = retain ? adapter.keep[flag] : adapter.discard?.[flag];
+        if (arity === undefined)
+            throw new BerthError(`Review recovery options: unsupported option ${flag}.`);
+        const values = [];
+        if (word.includes('=')) {
+            if (arity === false)
+                throw new BerthError(`Unexpected value for ${flag}.`);
+        }
+        else if (arity === true) {
+            if (i + 1 >= words.length || words[i + 1] === '--')
+                throw new BerthError(`Missing value for ${flag}.`);
+            values.push(words[++i]);
+        }
+        else if (arity === 'optional' && i + 1 < words.length && !words[i + 1].startsWith('-')) {
+            values.push(words[++i]);
+        }
+        if (arity === 'many') {
+            while (i + 1 < words.length && !words[i + 1].startsWith('-'))
+                values.push(words[++i]);
+            if (!word.includes('=') && values.length === 0)
+                throw new BerthError(`Missing value for ${flag}.`);
+        }
+        if (retain)
+            kept.push(word, ...values);
     }
     return kept;
 }
@@ -45,4 +66,15 @@ export function resumeCommand(input) {
     const args = keptArgs(input.adapter, input.originalArgv).map(shellQuote).join(' ');
     return renderTemplate(tpl, { name: input.name, cwd: input.cwd, conversation: input.conversation, args });
 }
+/** Unverified provenance or unsupported syntax requires explicit review. */
+export function recoveryOptionsRequired(agent, argv, verified) {
+    if (agent === 'shell')
+        return false;
+    try {
+        return keptArgs(requireAdapter(agent), argv).length > 0 && verified !== true;
+    }
+    catch {
+        return true;
+    }
+}
 //# sourceMappingURL=commands.js.map

package/dist/src/agents/commands.js.map

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

package/dist/src/agents/copilot-state.d.ts

@@ -0,0 +1,3 @@
+export declare function copilotCursor(conversation: string, env: NodeJS.ProcessEnv): string;
+/** Retry hooks are not terminal: require the native root turn-end and outcome. */
+export declare function copilotState(value: string | undefined, conversation: string, env: NodeJS.ProcessEnv): '' | 'working' | undefined;

package/dist/src/agents/copilot-state.js

@@ -0,0 +1,94 @@
+import { join } from 'node:path';
+import { agentRoot } from './roots.js';
+import { transcriptCursor, transcriptTail } from './transcript-cursor.js';
+function headerMatches(header, conversation) {
+    const data = header.data;
+    return header.type === 'session.start' && !!data && typeof data === 'object'
+        && 'sessionId' in data && data.sessionId === conversation;
+}
+export function copilotCursor(conversation, env) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(conversation))
+        return '';
+    const root = agentRoot('copilot', env);
+    return transcriptCursor(join(root, 'session-state', conversation, 'events.jsonl'), root, (header) => headerMatches(header, conversation));
+}
+/** Retry hooks are not terminal: require the native root turn-end and outcome. */
+export function copilotState(value, conversation, env) {
+    try {
+        const tail = transcriptTail(value, agentRoot('copilot', env), (header) => headerMatches(header, conversation));
+        if (!tail)
+            return undefined;
+        let turnId;
+        let ended = false;
+        let inactive = false;
+        let pending = {};
+        let completed = false;
+        let resumed = false;
+        for (const line of tail.lines) {
+            const row = JSON.parse(line);
+            const data = row?.data;
+            if (!row || typeof row.type !== 'string' || !data || typeof data !== 'object' || Array.isArray(data))
+                return undefined;
+            if (['assistant.turn_end', 'session.error', 'abort'].includes(row.type)
+                && (data.agentId || data.parentAgentId || data.parentToolCallId || data.parentAgentTaskId))
+                return undefined;
+            if (['hook.start', 'hook.end', 'session.usage_record'].includes(row.type))
+                continue;
+            const timestamp = typeof row.timestamp === 'string' ? Date.parse(row.timestamp) : NaN;
+            if (!Number.isFinite(timestamp) || timestamp < tail.at || timestamp > Date.now())
+                return undefined;
+            if (row.type === 'permission.requested') {
+                const id = data.requestId;
+                const tool = data.permissionRequest?.toolCallId;
+                if (typeof id !== 'string' || !id || typeof tool !== 'string' || !tool
+                    || data.ownerSessionId !== conversation || Object.hasOwn(pending, id))
+                    return undefined;
+                pending = { ...pending, [id]: tool };
+                resumed = false;
+            }
+            else if (row.type === 'permission.completed') {
+                const id = data.requestId;
+                if (typeof id !== 'string' || !Object.hasOwn(pending, id) || pending[id] !== data.toolCallId
+                    || !data.result || typeof data.result.kind !== 'string')
+                    return undefined;
+                const { [id]: settled, ...remaining } = pending;
+                pending = remaining;
+                completed = true;
+            }
+            if (row.type === 'assistant.turn_end') {
+                ended = typeof data.turnId === 'string' && data.turnId.length > 0
+                    && (turnId === undefined || data.turnId === turnId);
+                inactive = false;
+                resumed = false;
+            }
+            else if (row.type === 'session.error') {
+                inactive = ended && typeof data.errorType === 'string' && typeof data.message === 'string' && data.message.trim().length > 0;
+            }
+            else if (row.type === 'abort') {
+                inactive = ended && data.reason === 'user_initiated';
+            }
+            else {
+                if (!['assistant.message', 'tool.execution_start', 'tool.execution_complete', 'system.message',
+                    'permission.requested', 'permission.completed', 'assistant.turn_start'].includes(row.type))
+                    resumed = false;
+                if (row.type === 'user.message') {
+                    turnId = undefined;
+                    completed = false;
+                    resumed = false;
+                    pending = {};
+                }
+                if (row.type === 'assistant.turn_start') {
+                    turnId = typeof data.turnId === 'string' ? data.turnId : undefined;
+                    resumed = !!turnId && completed && Object.keys(pending).length === 0;
+                }
+                ended = false;
+                inactive = false;
+            }
+        }
+        return inactive ? '' : resumed && Object.keys(pending).length === 0 ? 'working' : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=copilot-state.js.map

package/dist/src/agents/copilot-state.js.map

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

package/dist/src/agents/gemini-state.d.ts

@@ -0,0 +1,3 @@
+export declare function geminiCursor(file: unknown, conversation: string, env: NodeJS.ProcessEnv): string;
+/** Native cancellation is terminal; an error additionally needs a completed-loop acknowledgement. */
+export declare function geminiInactive(value: string | undefined, conversation: string, env: NodeJS.ProcessEnv, completed?: boolean): boolean;

package/dist/src/agents/gemini-state.js

@@ -0,0 +1,41 @@
+import { agentRoot } from './roots.js';
+import { transcriptCursor, transcriptTail } from './transcript-cursor.js';
+export function geminiCursor(file, conversation, env) {
+    return transcriptCursor(file, agentRoot('gemini', env), (header) => header.sessionId === conversation);
+}
+/** Native cancellation is terminal; an error additionally needs a completed-loop acknowledgement. */
+export function geminiInactive(value, conversation, env, completed = false) {
+    try {
+        const tail = transcriptTail(value, agentRoot('gemini', env), (header) => header.sessionId === conversation);
+        if (!tail)
+            return false;
+        let last;
+        for (const line of tail.lines) {
+            const data = JSON.parse(line);
+            if (!data || typeof data !== 'object' || Array.isArray(data))
+                return false;
+            const row = data;
+            if (typeof row.type === 'string')
+                last = row;
+            else if (typeof row.$rewindTo === 'string' && row.$rewindTo.length > 0)
+                continue;
+            else if (!row.$set || typeof row.$set !== 'object' || Array.isArray(row.$set))
+                return false;
+        }
+        const timestamp = typeof last?.timestamp === 'string' ? Date.parse(last.timestamp) : NaN;
+        if (!last || typeof last.id !== 'string' || !Number.isFinite(timestamp)
+            || timestamp < tail.at || timestamp > Date.now())
+            return false;
+        const content = typeof last.content === 'string' ? last.content : '';
+        if (last.type === 'info' && ['Request cancelled.', 'User cancelled the request.'].includes(content))
+            return true;
+        return completed && ((last.type === 'error' && content.trim().length > 0) || (last.type === 'info' && [
+            'This request failed. Press F12 for diagnostics, or run /settings and change "Error Verbosity" to full for full details.',
+            'Some internal tool attempts failed before this final error. Press F12 for diagnostics, or run /settings and change "Error Verbosity" to full for details.',
+        ].includes(content)));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=gemini-state.js.map

package/dist/src/agents/gemini-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-state.js","sourceRoot":"","sources":["../../../src/agents/gemini-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,YAAoB,EAAE,GAAsB;IACtF,OAAO,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC;AACzG,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,cAAc,CAAC,KAAyB,EAAE,YAAoB,EAAE,GAAsB,EAAE,SAAS,GAAG,KAAK;IACvH,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC;QAC5G,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,IAAyC,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC3E,MAAM,GAAG,GAAG,IAA+B,CAAC;YAC5C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,GAAG,GAAG,CAAC;iBACxC,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;iBAC5E,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC9F,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACzF,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;eAClE,SAAS,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE;YAAE,OAAO,KAAK,CAAC;QACjE,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,oBAAoB,EAAE,6BAA6B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACjH,OAAO,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI;YACpG,yHAAyH;YACzH,2JAA2J;SAC5J,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC3B,CAAC"}

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

@@ -14,8 +14,6 @@ interface HookFormat {
     uninstall(file: string): void;
 }
 /** OpenCode loads every module in its plugins folder; this one forwards session events to `berth hook`. */
-export declare function opencodePlugin(node: string, cli: string, events: string[]): string;
+export declare function opencodePlugin(node: string, cli: string, events: string[], electron?: boolean): string;
 export declare function hookFormat(target: HookTarget, cli?: string): HookFormat;
-/** Whether the target file holds Berth's entries. */
-export declare function containsBerth(file: string): boolean;
 export {};