@mnemonik/shared 7.140.1 → 7.140.3

package/dist/hookTrace.d.ts

@@ -0,0 +1,149 @@
+export type HookTraceHost = 'cursor' | 'claude-code' | 'codex' | 'copilot';
+/** Past this size the file is renamed to `<host>.jsonl.1` (replacing any older one). */
+export declare const HOOK_TRACE_MAX_BYTES: number;
+export declare const HOOK_TRACE_ENV = "MNEMONIK_HOOK_TRACE";
+export interface HookTraceCall {
+    /** URL path only; id-like segments become `:id`, never a query string. */
+    path: string;
+    status?: number;
+    /** `timeout`, `aborted`, a system code such as `ECONNREFUSED`, or an error name. */
+    error?: string;
+    /** Still waiting for an answer when the process exited. */
+    pending?: true;
+    ms: number;
+}
+export interface HookTraceOutput {
+    bytes: number;
+    /** Byte size of each output field set; nested host fields as `hookSpecificOutput.<name>`. */
+    sizes: Record<string, number>;
+    permission?: string;
+    decision?: string;
+    continue?: boolean;
+}
+/** Written as the recorder starts, before stdin is read. */
+export interface HookTraceStart {
+    v: 1;
+    phase: 'start';
+    ts: string;
+    host: HookTraceHost;
+    hookVersion?: string;
+    pid: number;
+    id: string;
+    /** From process start, including Node start-up and module load. */
+    processMs: number;
+}
+/** Written once stdin is read and the event is known. */
+export interface HookTraceInput {
+    v: 1;
+    phase: 'input';
+    ts: string;
+    host: HookTraceHost;
+    pid: number;
+    id: string;
+    event: string | null;
+    hostVersion?: string;
+    sessionId?: string;
+    conversationId?: string;
+    generationId?: string;
+    agentId?: string;
+    turnId?: string;
+    tool?: string;
+    cwd?: string;
+    inputBytes: number;
+    /** Byte size of each top-level input field's JSON value. Values are never recorded. */
+    fields: Record<string, number>;
+    /** Time from the recorder starting to the event being known (mostly the stdin read). */
+    readMs: number;
+}
+export interface HookTraceEnd {
+    v: 1;
+    phase: 'end';
+    ts: string;
+    host: HookTraceHost;
+    pid: number;
+    id: string;
+    event: string | null;
+    projectId?: string;
+    output: HookTraceOutput | null;
+    calls: HookTraceCall[];
+    /** From the recorder starting (after module load) to exit. */
+    durationMs: number;
+    /** From process start, including Node start-up and module load. */
+    processMs: number;
+    exitCode: number;
+    /** Name or system code of the error the hook failed open on. */
+    errorKind?: string;
+    /** Its message, scrubbed and cut to 80 characters. */
+    error?: string;
+}
+export type HookTraceRecord = HookTraceStart | HookTraceInput | HookTraceEnd;
+export declare function hookTraceEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function hookTraceDirectory(stateDir?: string): string;
+export declare function hookTraceFile(host: HookTraceHost, stateDir?: string): string;
+/** Append one line, rotating first when the file is full. Throws; callers swallow. */
+export declare function appendHookTraceLine(file: string, record: HookTraceRecord): void;
+/** Field names and sizes, the decision fields' short enum values, never text. */
+export declare function summarizeHookOutput(text: string): HookTraceOutput;
+export declare function errorKind(error: unknown): string;
+/** The message, whitespace folded, secrets scrubbed, cut to 80 characters. */
+export declare function scrubHookTraceMessage(error: unknown): string;
+export interface HookTraceCallToken {
+    input: unknown;
+    startedAt: number;
+}
+export interface HookTraceOptions {
+    host: HookTraceHost;
+    hookVersion?: string;
+    env?: NodeJS.ProcessEnv;
+    stateDir?: string;
+}
+export declare class HookTrace {
+    private readonly host;
+    private readonly file;
+    private readonly hookVersion?;
+    private readonly id;
+    private readonly startedAt;
+    private opened;
+    private started;
+    private ended;
+    private event;
+    private outputSummary;
+    private error?;
+    private errorKind?;
+    private projectId?;
+    private readonly calls;
+    private readonly inFlight;
+    constructor(host: HookTraceHost, file: string | undefined, hookVersion?: string | undefined);
+    get enabled(): boolean;
+    private write;
+    /**
+     * Write the `start` line: pid, run id and time since process start, nothing
+     * from the editor. Runs before stdin is read, so a run killed while the
+     * editor is still sending its event leaves this line.
+     */
+    open(): void;
+    /** Write the `input` line. `input` is the parsed payload, or null when none parsed. */
+    begin(input: unknown, event?: string | null): void;
+    /** The exact text the hook wrote to stdout (or nothing). */
+    output(text: string | null | undefined): void;
+    /** The error the hook failed open on. */
+    fail(error: unknown): void;
+    project(projectId: string | undefined): void;
+    /** A call has gone out; {@link settle} records it, {@link finish} records it as pending. */
+    callStarted(input: unknown): HookTraceCallToken;
+    settle(token: HookTraceCallToken, status?: number, error?: unknown): void;
+    call(input: unknown, startedAt: number, status?: number, error?: unknown): void;
+    /** Write the `end` line once. Runs from the process `exit` event. */
+    finish(exitCode?: number): void;
+}
+/** Resolved project ids reach the trace from the shared identity cache. */
+export declare function noteHookTraceProject(projectId: string | undefined): void;
+/**
+ * Start this process's recorder: one per hook process. Writes the `start`
+ * line at once (so call it before reading stdin), times every `fetch` the
+ * process makes (path, status or error kind, duration; `pending` when still
+ * waiting at exit) and writes the `end` line from the process `exit` event,
+ * so every exit path is covered.
+ */
+export declare function startHookTrace(options: HookTraceOptions): HookTrace;
+//# sourceMappingURL=hookTrace.d.ts.map

package/dist/hookTrace.d.ts.map

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

package/dist/hookTrace.js

@@ -0,0 +1,483 @@
+/**
+ * Hook flight recorder: a bounded, local, append-only record of every hook
+ * invocation on this machine, so an agent or support can see what a real
+ * editor sent to the hooks and what they answered.
+ *
+ * One JSON Lines file per host under the Mnemonik state folder
+ * (`<state>/hook-trace/<host>.jsonl`, directory 0700, file 0600), rotated to a
+ * single `.1` file past {@link HOOK_TRACE_MAX_BYTES}. Each invocation writes
+ * up to three lines sharing one run `id`: `start` as soon as the recorder
+ * starts (before stdin is read, so a run the editor kills while it is still
+ * sending the event leaves a trace), `input` once the event is known, and
+ * `end` when the process exits. A run with no `end` is one the editor killed
+ * (a signal ends the process without Node's `exit` event); one with only
+ * `start` was killed before its event arrived.
+ *
+ * The record holds identifiers, field names and sizes only. It never holds
+ * prompt text, tool input or output bodies, file contents, transcript
+ * contents, credentials or the environment: payload values are reduced to
+ * their byte size, and the one free-text field (an error message) passes
+ * through `scrubSecrets`.
+ *
+ * Every write is synchronous and short (one line), and every failure is
+ * swallowed: the recorder can never throw into a hook or change its output.
+ * Being synchronous, a write to a hung network home directory would block the
+ * hook. `MNEMONIK_HOOK_TRACE=off` disables it.
+ */
+import { randomBytes } from 'node:crypto';
+import { closeSync, constants, fstatSync, lstatSync, mkdirSync, openSync, renameSync, statSync, unlinkSync, writeSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { mnemonikStateDirectory } from './protectedPaths.js';
+import { ensureWindowsPrivateDirectorySync } from './runtimeSigners.js';
+import { scrubSecrets } from './secretPatterns.js';
+/** Past this size the file is renamed to `<host>.jsonl.1` (replacing any older one). */
+export const HOOK_TRACE_MAX_BYTES = 2 * 1024 * 1024;
+export const HOOK_TRACE_ENV = 'MNEMONIK_HOOK_TRACE';
+const MAX_FIELDS = 64;
+const MAX_CALLS = 64;
+const MAX_ERROR_CHARS = 80;
+const SAFE_ID = /^[A-Za-z0-9@._+:-]{1,128}$/;
+const SAFE_NAME = /^[A-Za-z0-9@._+:/-]{1,120}$/;
+const SAFE_ENUM = /^[A-Za-z_]{1,24}$/;
+export function hookTraceEnabled(env = process.env) {
+    const value = env[HOOK_TRACE_ENV]?.trim().toLowerCase();
+    return !value || !['off', '0', 'false', 'no', 'disabled'].includes(value);
+}
+export function hookTraceDirectory(stateDir = mnemonikStateDirectory()) {
+    return join(stateDir, 'hook-trace');
+}
+export function hookTraceFile(host, stateDir) {
+    return join(hookTraceDirectory(stateDir), `${host}.jsonl`);
+}
+const preparedDirectories = new Set();
+function ensurePrivateDirectory(directory) {
+    if (preparedDirectories.has(directory))
+        return;
+    if (process.platform === 'win32')
+        ensureWindowsPrivateDirectorySync(directory);
+    else {
+        mkdirSync(directory, { recursive: true, mode: 0o700 });
+        const stat = lstatSync(directory);
+        if (!stat.isDirectory() ||
+            stat.isSymbolicLink() ||
+            (process.getuid && stat.uid !== process.getuid()) ||
+            stat.mode & 0o077)
+            throw new Error('hook trace directory is not private');
+    }
+    preparedDirectories.add(directory);
+}
+function openTrace(file) {
+    return openSync(file, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT | (constants.O_NOFOLLOW ?? 0), 0o600);
+}
+/** Whether `file` still names the file `fd` has open: no other writer rotated it away. */
+function sameFile(file, fd) {
+    try {
+        const opened = fstatSync(fd, { bigint: true });
+        const named = statSync(file, { bigint: true });
+        return opened.ino === named.ino && opened.dev === named.dev;
+    }
+    catch {
+        return false;
+    }
+}
+/** A rotation lock older than this was left by a killed writer. */
+const STALE_LOCK_MS = 10_000;
+function takeLock(lock) {
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        try {
+            closeSync(openSync(lock, 'wx', 0o600));
+            return true;
+        }
+        catch {
+            try {
+                if (attempt > 0 || Date.now() - lstatSync(lock).mtimeMs < STALE_LOCK_MS)
+                    return false;
+                unlinkSync(lock);
+            }
+            catch {
+                /* Gone already: try once more. */
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Rotate the full file `fd` has open to `.1`. Hooks run concurrently, so
+ * rotation is serialised by an exclusive lock file and, while holding it,
+ * happens only when the path still names the file `fd` has open: a writer
+ * that finds another already rotated (or rotating) appends to the fresh file
+ * instead of rotating again and replacing the full file in `.1`.
+ */
+function rotate(file, fd) {
+    const lock = `${file}.lock`;
+    if (!takeLock(lock))
+        return;
+    try {
+        if (sameFile(file, fd))
+            renameSync(file, `${file}.1`);
+    }
+    finally {
+        try {
+            unlinkSync(lock);
+        }
+        catch {
+            /* Already removed as stale: nothing to release. */
+        }
+    }
+}
+/** Append one line, rotating first when the file is full. Throws; callers swallow. */
+export function appendHookTraceLine(file, record) {
+    ensurePrivateDirectory(dirname(file));
+    const line = `${JSON.stringify(record)}\n`;
+    let fd = openTrace(file);
+    try {
+        const stat = fstatSync(fd);
+        if (!stat.isFile() || (process.getuid && stat.uid !== process.getuid()))
+            throw new Error('hook trace file is not ours');
+        if (stat.size > 0 && stat.size + Buffer.byteLength(line) > HOOK_TRACE_MAX_BYTES) {
+            try {
+                rotate(file, fd);
+            }
+            finally {
+                closeSync(fd);
+                fd = -1;
+            }
+            fd = openTrace(file);
+        }
+        writeSync(fd, line);
+    }
+    finally {
+        if (fd >= 0)
+            closeSync(fd);
+    }
+}
+function byteSize(value) {
+    if (typeof value === 'string')
+        return Buffer.byteLength(value);
+    try {
+        return Buffer.byteLength(JSON.stringify(value) ?? '');
+    }
+    catch {
+        return 0;
+    }
+}
+function safe(value, pattern) {
+    return typeof value === 'string' && pattern.test(value) ? value : undefined;
+}
+function sizesOf(object, prefix = '') {
+    const sizes = {};
+    for (const key of Object.keys(object).slice(0, MAX_FIELDS))
+        if (SAFE_NAME.test(key))
+            sizes[prefix + key] = byteSize(object[key]);
+    return sizes;
+}
+const isObject = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+/** Field names and sizes, the decision fields' short enum values, never text. */
+export function summarizeHookOutput(text) {
+    const output = { bytes: Buffer.byteLength(text), sizes: {} };
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return output;
+    }
+    if (!isObject(value))
+        return output;
+    const nested = isObject(value.hookSpecificOutput) ? value.hookSpecificOutput : undefined;
+    const { hookSpecificOutput: _nested, ...top } = value;
+    output.sizes = { ...sizesOf(top), ...(nested ? sizesOf(nested, 'hookSpecificOutput.') : {}) };
+    const permission = safe(value.permission ?? nested?.permissionDecision, SAFE_ENUM);
+    const decision = safe(value.decision, SAFE_ENUM);
+    if (permission)
+        output.permission = permission;
+    if (decision)
+        output.decision = decision;
+    if (typeof value.continue === 'boolean')
+        output.continue = value.continue;
+    return output;
+}
+function routeOf(input) {
+    try {
+        const href = typeof input === 'string'
+            ? input
+            : input instanceof URL
+                ? input.href
+                : input.url;
+        return new URL(String(href)).pathname
+            .split('/')
+            .map((segment) => (segment.length >= 16 && /\d/.test(segment)) || /[%@]/.test(segment) ? ':id' : segment)
+            .join('/')
+            .slice(0, 200);
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function errorKind(error) {
+    const failure = error;
+    if (failure?.name === 'TimeoutError')
+        return 'timeout';
+    if (failure?.name === 'AbortError')
+        return 'aborted';
+    const code = failure?.cause?.code ?? failure?.code;
+    if (typeof code === 'string' && /^[A-Z0-9_]{2,40}$/.test(code))
+        return code;
+    return safe(failure?.name, /^\w{1,40}$/) ?? 'error';
+}
+/** The message, whitespace folded, secrets scrubbed, cut to 80 characters. */
+export function scrubHookTraceMessage(error) {
+    const text = error instanceof Error ? error.message : String(error);
+    return scrubSecrets(text.replace(/\s+/g, ' ').trim()).slice(0, MAX_ERROR_CHARS);
+}
+export class HookTrace {
+    host;
+    file;
+    hookVersion;
+    id = randomBytes(8).toString('hex');
+    startedAt = performance.now();
+    opened = false;
+    started = false;
+    ended = false;
+    event = null;
+    outputSummary = null;
+    error;
+    errorKind;
+    projectId;
+    calls = [];
+    inFlight = new Set();
+    constructor(host, file, hookVersion) {
+        this.host = host;
+        this.file = file;
+        this.hookVersion = hookVersion;
+    }
+    get enabled() {
+        return this.file !== undefined;
+    }
+    write(record) {
+        if (!this.file)
+            return;
+        try {
+            appendHookTraceLine(this.file, record);
+        }
+        catch {
+            /* A diagnostic record never costs the hook anything. */
+        }
+    }
+    /**
+     * Write the `start` line: pid, run id and time since process start, nothing
+     * from the editor. Runs before stdin is read, so a run killed while the
+     * editor is still sending its event leaves this line.
+     */
+    open() {
+        if (!this.file || this.opened)
+            return;
+        this.opened = true;
+        this.write({
+            v: 1,
+            phase: 'start',
+            ts: new Date().toISOString(),
+            host: this.host,
+            ...(this.hookVersion ? { hookVersion: this.hookVersion } : {}),
+            pid: process.pid,
+            id: this.id,
+            processMs: Math.round(process.uptime() * 1000),
+        });
+    }
+    /** Write the `input` line. `input` is the parsed payload, or null when none parsed. */
+    begin(input, event) {
+        if (!this.file || this.started)
+            return;
+        this.open();
+        this.started = true;
+        try {
+            const payload = isObject(input) ? input : {};
+            this.event =
+                safe(event, SAFE_NAME) ??
+                    safe(payload.hook_event_name, SAFE_NAME) ??
+                    safe(payload.hookEventName, SAFE_NAME) ??
+                    null;
+            const roots = Array.isArray(payload.workspace_roots) ? payload.workspace_roots : [];
+            const cwd = typeof payload.cwd === 'string' && payload.cwd
+                ? payload.cwd
+                : typeof roots[0] === 'string'
+                    ? roots[0]
+                    : process.cwd();
+            const record = {
+                v: 1,
+                phase: 'input',
+                ts: new Date().toISOString(),
+                host: this.host,
+                pid: process.pid,
+                id: this.id,
+                event: this.event,
+                inputBytes: isObject(input) ? byteSize(input) : 0,
+                fields: sizesOf(payload),
+                readMs: Math.round(performance.now() - this.startedAt),
+            };
+            const hostVersion = safe(payload.cursor_version ?? payload.version, /^[\w.+-]{1,40}$/);
+            if (hostVersion)
+                record.hostVersion = hostVersion;
+            const ids = [
+                ['sessionId', 'session_id'],
+                ['conversationId', 'conversation_id'],
+                ['generationId', 'generation_id'],
+                ['agentId', 'agent_id'],
+                ['agentId', 'subagent_id'],
+                ['turnId', 'turn_id'],
+            ];
+            for (const [name, key] of ids) {
+                const id = safe(payload[key], SAFE_ID);
+                if (id && record[name] === undefined)
+                    record[name] = id;
+            }
+            const tool = safe(payload.tool_name, SAFE_NAME);
+            if (tool)
+                record.tool = tool;
+            if (cwd.length <= 1024)
+                record.cwd = cwd;
+            this.write(record);
+        }
+        catch {
+            /* Never into the hook. */
+        }
+    }
+    /** The exact text the hook wrote to stdout (or nothing). */
+    output(text) {
+        if (!this.file || text === null || text === undefined)
+            return;
+        try {
+            this.outputSummary = summarizeHookOutput(text);
+        }
+        catch {
+            /* Never into the hook. */
+        }
+    }
+    /** The error the hook failed open on. */
+    fail(error) {
+        if (!this.file)
+            return;
+        try {
+            this.errorKind = errorKind(error);
+            this.error = scrubHookTraceMessage(error);
+        }
+        catch {
+            this.errorKind = 'error';
+        }
+    }
+    project(projectId) {
+        if (projectId && !this.projectId && SAFE_ID.test(projectId))
+            this.projectId = projectId;
+    }
+    /** A call has gone out; {@link settle} records it, {@link finish} records it as pending. */
+    callStarted(input) {
+        const token = { input, startedAt: performance.now() };
+        if (this.file)
+            this.inFlight.add(token);
+        return token;
+    }
+    settle(token, status, error) {
+        this.inFlight.delete(token);
+        this.call(token.input, token.startedAt, status, error);
+    }
+    call(input, startedAt, status, error) {
+        if (!this.file || this.calls.length >= MAX_CALLS)
+            return;
+        try {
+            this.calls.push({
+                path: routeOf(input),
+                ...(status !== undefined ? { status } : { error: errorKind(error) }),
+                ms: Math.round(performance.now() - startedAt),
+            });
+        }
+        catch {
+            /* Never into the hook. */
+        }
+    }
+    /** Write the `end` line once. Runs from the process `exit` event. */
+    finish(exitCode = 0) {
+        if (!this.file || this.ended)
+            return;
+        this.open();
+        this.ended = true;
+        for (const { input, startedAt } of this.inFlight) {
+            if (this.calls.length >= MAX_CALLS)
+                break;
+            try {
+                this.calls.push({
+                    path: routeOf(input),
+                    pending: true,
+                    ms: Math.round(performance.now() - startedAt),
+                });
+            }
+            catch {
+                /* Never into the hook. */
+            }
+        }
+        this.inFlight.clear();
+        this.write({
+            v: 1,
+            phase: 'end',
+            ts: new Date().toISOString(),
+            host: this.host,
+            pid: process.pid,
+            id: this.id,
+            event: this.event,
+            ...(this.projectId ? { projectId: this.projectId } : {}),
+            output: this.outputSummary,
+            calls: this.calls,
+            durationMs: Math.round(performance.now() - this.startedAt),
+            processMs: Math.round(process.uptime() * 1000),
+            exitCode,
+            ...(this.errorKind ? { errorKind: this.errorKind } : {}),
+            ...(this.error ? { error: this.error } : {}),
+        });
+    }
+}
+let active;
+/** Resolved project ids reach the trace from the shared identity cache. */
+export function noteHookTraceProject(projectId) {
+    active?.project(projectId);
+}
+/**
+ * Start this process's recorder: one per hook process. Writes the `start`
+ * line at once (so call it before reading stdin), times every `fetch` the
+ * process makes (path, status or error kind, duration; `pending` when still
+ * waiting at exit) and writes the `end` line from the process `exit` event,
+ * so every exit path is covered.
+ */
+export function startHookTrace(options) {
+    if (active)
+        return active;
+    let file;
+    try {
+        if (hookTraceEnabled(options.env))
+            file = hookTraceFile(options.host, options.stateDir ?? mnemonikStateDirectory(process.platform, options.env ?? process.env));
+    }
+    catch {
+        file = undefined;
+    }
+    const trace = new HookTrace(options.host, file, options.hookVersion);
+    active = trace;
+    if (!file)
+        return trace;
+    const original = globalThis.fetch;
+    if (typeof original === 'function') {
+        globalThis.fetch = async (input, init) => {
+            const token = trace.callStarted(input);
+            try {
+                const response = await original.call(globalThis, input, init);
+                trace.settle(token, response.status);
+                return response;
+            }
+            catch (error) {
+                trace.settle(token, undefined, error);
+                throw error;
+            }
+        };
+    }
+    process.once('exit', (code) => trace.finish(typeof code === 'number' ? code : 0));
+    trace.open();
+    return trace;
+}
+//# sourceMappingURL=hookTrace.js.map

package/dist/hookTrace.js.map

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