@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/hooks/session-resolver.js

@@ -0,0 +1,196 @@
+/**
+ * Resolve the Claude Code session_id for the running MCP process.
+ *
+ * Two sources, in order:
+ *   1. `CLAUDE_JOB_DIR` env var → read `<dir>/state.json`, regex-extract the
+ *      session UUID from the `linkScanPath` field's filename. Instant; used
+ *      by background-job MCPs.
+ *   2. PPID breadcrumb at `<storage>/session-by-ppid/<process.ppid>.txt` —
+ *      written by the hook collector on every tool call. Polled at exponential
+ *      backoff: 100ms, 200ms, 500ms, 1s, 2s, then steady at 2s. No hard
+ *      timeout; logs a single WARN at 60s if still unresolved.
+ *
+ * The MCP must never fabricate its own session_id. If neither path resolves,
+ * tool handlers should report "session_id not yet resolved" rather than make
+ * one up.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, basename } from 'node:path';
+import { homedir } from 'node:os';
+import { createLogger } from '../shared/index.js';
+const logger = createLogger('session-resolver');
+const SESSION_ID_RE = /^[a-zA-Z0-9_-]{1,128}$/;
+const DEFAULT_STORAGE_DIR = resolve(homedir(), '.newrelic-preflight');
+const POLL_SCHEDULE_MS = [100, 200, 500, 1000, 2000];
+const STEADY_POLL_MS = 2000;
+const WARN_AFTER_MS = 60_000;
+/**
+ * Try to resolve the session_id synchronously from `CLAUDE_JOB_DIR/state.json`.
+ * Returns the validated session_id or null.
+ */
+export function resolveFromJobDir(claudeJobDir) {
+    if (!claudeJobDir || typeof claudeJobDir !== 'string')
+        return null;
+    const statePath = resolve(claudeJobDir, 'state.json');
+    if (!existsSync(statePath))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(statePath, 'utf-8');
+    }
+    catch (err) {
+        logger.debug('CLAUDE_JOB_DIR/state.json unreadable', { error: String(err) });
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        logger.debug('CLAUDE_JOB_DIR/state.json invalid JSON', { error: String(err) });
+        return null;
+    }
+    if (parsed === null || typeof parsed !== 'object')
+        return null;
+    const linkScanPath = parsed.linkScanPath;
+    if (typeof linkScanPath !== 'string' || linkScanPath.length === 0)
+        return null;
+    // The session UUID is the basename minus its extension. Validate against
+    // the same character class used everywhere else so we never accept a
+    // path-traversing value.
+    const file = basename(linkScanPath);
+    const dot = file.lastIndexOf('.');
+    const sid = dot > 0 ? file.slice(0, dot) : file;
+    if (!SESSION_ID_RE.test(sid))
+        return null;
+    return sid;
+}
+/**
+ * Try to resolve the session_id synchronously from the PPID breadcrumb file.
+ * Returns the validated session_id or null.
+ */
+export function resolveFromBreadcrumb(storagePath, ppid) {
+    if (typeof ppid !== 'number' || ppid <= 0)
+        return null;
+    const breadcrumbPath = resolve(storagePath, 'session-by-ppid', `${ppid}.txt`);
+    if (!existsSync(breadcrumbPath))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(breadcrumbPath, 'utf-8');
+    }
+    catch (err) {
+        logger.debug('Breadcrumb file unreadable', { error: String(err) });
+        return null;
+    }
+    const sid = raw.trim();
+    if (!SESSION_ID_RE.test(sid))
+        return null;
+    return sid;
+}
+/**
+ * Returns the next poll delay for attempt index `i` (0-based).
+ * Schedule: 100ms, 200ms, 500ms, 1s, 2s, then steady 2s.
+ */
+export function nextDelayMs(attempt) {
+    if (attempt < POLL_SCHEDULE_MS.length)
+        return POLL_SCHEDULE_MS[attempt];
+    return STEADY_POLL_MS;
+}
+/**
+ * Resolve the Claude Code session_id, polling forever if needed.
+ *
+ * - First tries `CLAUDE_JOB_DIR` (synchronous, free).
+ * - Falls back to the PPID breadcrumb with exponential backoff polling.
+ * - Resolves to a validated session_id string when found. Never resolves to
+ *   null; the only way out is success, the optional `signal`, or the caller
+ *   stopping the surrounding process.
+ * - Logs a single WARN at 60s if still unresolved.
+ *
+ * Pass an `AbortSignal` to allow shutdown to break the loop.
+ */
+export async function resolveSessionId(options = {}) {
+    const claudeJobDir = options.claudeJobDir !== undefined
+        ? options.claudeJobDir
+        : (process.env.CLAUDE_JOB_DIR ?? null);
+    const ppid = options.ppid ?? process.ppid;
+    const storagePath = options.storagePath ?? DEFAULT_STORAGE_DIR;
+    // Fast path: CLAUDE_JOB_DIR is set and contains a usable state.json. Used
+    // by background-job MCPs where the parent doesn't fire hooks.
+    const fromJobDir = resolveFromJobDir(claudeJobDir);
+    if (fromJobDir) {
+        logger.info('Resolved session_id from CLAUDE_JOB_DIR', { sessionId: fromJobDir });
+        return fromJobDir;
+    }
+    // Synchronous attempt before we wait — common case is the breadcrumb is
+    // already on disk because the user already typed at least one message.
+    const immediate = resolveFromBreadcrumb(storagePath, ppid);
+    if (immediate) {
+        logger.info('Resolved session_id from breadcrumb (immediate)', { sessionId: immediate });
+        return immediate;
+    }
+    const startTime = Date.now();
+    let warnedAt60s = false;
+    let attempt = 0;
+    return new Promise((resolvePromise, rejectPromise) => {
+        const onAbort = () => {
+            rejectPromise(new Error('session resolution aborted'));
+        };
+        if (options.signal) {
+            if (options.signal.aborted) {
+                onAbort();
+                return;
+            }
+            options.signal.addEventListener('abort', onAbort, { once: true });
+            // Re-check after registering in case the signal fired in the gap
+            // between the earlier aborted check and addEventListener.
+            if (options.signal.aborted) {
+                onAbort();
+                return;
+            }
+        }
+        const tick = () => {
+            if (options.signal?.aborted) {
+                options.signal.removeEventListener('abort', onAbort);
+                return;
+            }
+            const sid = resolveFromBreadcrumb(storagePath, ppid);
+            if (sid) {
+                const elapsed = Date.now() - startTime;
+                logger.info('Resolved session_id from breadcrumb', { sessionId: sid, elapsedMs: elapsed });
+                if (options.signal)
+                    options.signal.removeEventListener('abort', onAbort);
+                resolvePromise(sid);
+                return;
+            }
+            const elapsed = Date.now() - startTime;
+            if (!warnedAt60s && elapsed >= WARN_AFTER_MS && !options.suppressWarn) {
+                warnedAt60s = true;
+                logger.warn('session_id unresolved after 60s — breadcrumb missing; check that hook collector is installed and writing.');
+            }
+            const delay = nextDelayMs(attempt++);
+            const handle = setTimeout(tick, delay);
+            // Don't keep the event loop alive on this timer alone — Ctrl+C / stdin
+            // close should be able to terminate the MCP without explicitly
+            // cancelling resolution.
+            handle.unref?.();
+        };
+        const delay = nextDelayMs(attempt++);
+        const handle = setTimeout(tick, delay);
+        handle.unref?.();
+    });
+}
+/**
+ * Returns true for session IDs that are MCP-internal synthetic identifiers
+ * (not real Claude Code session IDs). These should be hidden from user-facing
+ * surfaces such as the dashboard session list and audit trail.
+ *
+ * Single source of truth: kept here alongside the other session-ID logic so
+ * that adding a new synthetic prefix only requires one change.
+ */
+export function isSyntheticSessionId(id) {
+    if (!id)
+        return false;
+    return id.startsWith('local-') || id.startsWith('proxy-');
+}
+//# sourceMappingURL=session-resolver.js.map

package/dist/hooks/session-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.js","sourceRoot":"","sources":["../../src/hooks/session-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAEhD,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACtE,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACrD,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,aAAa,GAAG,MAAM,CAAC;AAa7B;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAuC;IACvE,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,YAAY,GAAI,MAAkC,CAAC,YAAY,CAAC;IACtE,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/E,yEAAyE;IACzE,qEAAqE;IACrE,yBAAyB;IACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,IAAwB;IAExB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,IAAI,OAAO,GAAG,gBAAgB,CAAC,MAAM;QAAE,OAAO,gBAAgB,CAAC,OAAO,CAAE,CAAC;IACzE,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAA6D,EAAE;IAE/D,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,KAAK,SAAS;QAChC,CAAC,CAAC,OAAO,CAAC,YAAY;QACtB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC;IAE/D,0EAA0E;IAC1E,8DAA8D;IAC9D,MAAM,UAAU,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAClF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,MAAM,SAAS,GAAG,qBAAqB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QACzF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,IAAI,OAAO,CAAS,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QAC3D,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,aAAa,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,iEAAiE;YACjE,0DAA0D;YAC1D,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACrD,OAAO;YACT,CAAC;YACD,MAAM,GAAG,GAAG,qBAAqB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACrD,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC3F,IAAI,OAAO,CAAC,MAAM;oBAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACzE,cAAc,CAAC,GAAG,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACvC,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,aAAa,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBACtE,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM,CAAC,IAAI,CACT,2GAA2G,CAC5G,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvC,uEAAuE;YACvE,+DAA+D;YAC/D,yBAAyB;YACzB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAA6B;IAChE,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACtB,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC"}

package/dist/hooks/tool-parsers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool-specific field parsers for Claude Code hook events.
+ *
+ * Each parser extracts structured metadata from a tool's `tool_input` and
+ * `tool_response` objects. The dispatcher routes to the appropriate parser
+ * based on tool name. Unknown tools return an empty record.
+ *
+ * All parsers are defensive — null/undefined inputs return {}, and any
+ * parsing error is caught and returns {}.
+ */
+type ToolFields = Record<string, string | number | boolean>;
+/**
+ * Extract tool-specific structured fields from a tool's input and output.
+ * Returns a flat record of fields to spread into the ToolCallRecord.
+ * Unknown tools or parsing errors return {}.
+ */
+export declare function parseToolSpecificFields(toolName: string, input: unknown, output: unknown): ToolFields;
+export {};
+//# sourceMappingURL=tool-parsers.d.ts.map

package/dist/hooks/tool-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-parsers.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-parsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AA+M5D;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,GACd,UAAU,CA2BZ"}

package/dist/hooks/tool-parsers.js

@@ -0,0 +1,260 @@
+/**
+ * Tool-specific field parsers for Claude Code hook events.
+ *
+ * Each parser extracts structured metadata from a tool's `tool_input` and
+ * `tool_response` objects. The dispatcher routes to the appropriate parser
+ * based on tool name. Unknown tools return an empty record.
+ *
+ * All parsers are defensive — null/undefined inputs return {}, and any
+ * parsing error is caught and returns {}.
+ */
+import { classifyBash } from './bash-classifier.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function countLines(text) {
+    if (text === '')
+        return 0;
+    return (text.match(/\n/g) || []).length + 1;
+}
+// ---------------------------------------------------------------------------
+// Bash command classification heuristics
+// ---------------------------------------------------------------------------
+const TEST_COMMAND_RE = /\b(jest|vitest|mocha|pytest|go\s+test|npm\s+test|npm\s+run\s+test|npx\s+jest|npx\s+vitest|cargo\s+test|bun\s+test|bun\s+run\s+test|pnpm\s+test|pnpm\s+run\s+test|yarn\s+test)\b/i;
+const BUILD_COMMAND_RE = /\b(tsc|npm\s+run\s+build|make\b|cargo\s+build|go\s+build|webpack|vite\s+build)\b/i;
+const LINT_COMMAND_RE = /\b(eslint|prettier|pylint|golangci-lint|rubocop|clippy|biome\s+(check|lint))\b/i;
+// ---------------------------------------------------------------------------
+// Per-tool parsers
+// ---------------------------------------------------------------------------
+function parseRead(input) {
+    const fields = {};
+    if (typeof input.file_path === 'string')
+        fields.filePath = input.file_path;
+    if (typeof input.offset === 'number')
+        fields.lineOffset = input.offset;
+    if (typeof input.limit === 'number')
+        fields.lineLimit = input.limit;
+    return fields;
+}
+function parseWrite(input) {
+    const fields = {};
+    if (typeof input.file_path === 'string')
+        fields.filePath = input.file_path;
+    if (typeof input.contentLength === 'number') {
+        fields.contentLength = input.contentLength;
+        if (typeof input.lineCount === 'number')
+            fields.lineCount = input.lineCount;
+    }
+    else if (typeof input.content === 'string') {
+        fields.contentLength = input.content.length;
+        fields.lineCount = countLines(input.content);
+    }
+    return fields;
+}
+function parseEdit(input) {
+    const fields = {};
+    if (typeof input.file_path === 'string')
+        fields.filePath = input.file_path;
+    if (typeof input.oldStringLength === 'number') {
+        fields.oldStringLength = input.oldStringLength;
+        if (typeof input.oldLineCount === 'number')
+            fields.oldLineCount = input.oldLineCount;
+    }
+    else if (typeof input.old_string === 'string') {
+        fields.oldStringLength = input.old_string.length;
+        fields.oldLineCount = countLines(input.old_string);
+    }
+    if (typeof input.newStringLength === 'number') {
+        fields.newStringLength = input.newStringLength;
+        if (typeof input.newLineCount === 'number')
+            fields.newLineCount = input.newLineCount;
+        if (typeof input.isDelete === 'boolean')
+            fields.isDelete = input.isDelete;
+    }
+    else if (typeof input.new_string === 'string') {
+        fields.newStringLength = input.new_string.length;
+        fields.newLineCount = input.new_string.length > 0 ? countLines(input.new_string) : 0;
+        fields.isDelete = input.new_string.length === 0;
+    }
+    if (typeof input.replace_all === 'boolean')
+        fields.replaceAll = input.replace_all;
+    return fields;
+}
+function parseBash(input) {
+    const fields = {};
+    if (typeof input.command === 'string') {
+        fields.command = input.command;
+        fields.isTestCommand = TEST_COMMAND_RE.test(input.command);
+        fields.isBuildCommand = BUILD_COMMAND_RE.test(input.command);
+        fields.isLintCommand = LINT_COMMAND_RE.test(input.command);
+        // Coarse classification for downstream telemetry: turns the polymorphic
+        // command string into a fixed category (git / test-runner / build / ...)
+        // so dashboards and trackers can bucket Bash by shape, not just by name.
+        const classification = classifyBash(input.command);
+        fields.bashCategory = classification.category;
+        fields.bashLeading = classification.leading;
+        fields.bashDestructive = classification.isDestructive;
+        fields.bashNetwork = classification.isNetwork;
+    }
+    if (typeof input.description === 'string')
+        fields.commandDescription = input.description;
+    if (typeof input.timeout === 'number')
+        fields.commandTimeout = input.timeout;
+    if (typeof input.run_in_background === 'boolean')
+        fields.runInBackground = input.run_in_background;
+    return fields;
+}
+function parseGrep(input) {
+    const fields = {};
+    if (typeof input.pattern === 'string')
+        fields.pattern = input.pattern;
+    if (typeof input.path === 'string')
+        fields.grepPath = input.path;
+    if (typeof input.output_mode === 'string')
+        fields.outputMode = input.output_mode;
+    return fields;
+}
+function parseGlob(input) {
+    const fields = {};
+    if (typeof input.pattern === 'string')
+        fields.pattern = input.pattern;
+    if (typeof input.path === 'string')
+        fields.globPath = input.path;
+    return fields;
+}
+function parseAgent(input) {
+    const fields = {};
+    if (typeof input.description === 'string')
+        fields.agentDescription = input.description;
+    if (typeof input.subagent_type === 'string')
+        fields.subagentType = input.subagent_type;
+    if (typeof input.promptLength === 'number') {
+        fields.promptLength = input.promptLength;
+    }
+    else if (typeof input.prompt === 'string') {
+        fields.promptLength = input.prompt.length;
+    }
+    if (typeof input.run_in_background === 'boolean')
+        fields.runInBackground = input.run_in_background;
+    if (typeof input.name === 'string')
+        fields.agentName = input.name;
+    if (typeof input.team_name === 'string')
+        fields.agentTeamName = input.team_name;
+    if (typeof input.isolation === 'string')
+        fields.agentIsolation = input.isolation;
+    if (typeof input.model === 'string')
+        fields.agentModel = input.model;
+    return fields;
+}
+function parseAskUserQuestion(input) {
+    const fields = {};
+    if (Array.isArray(input.questions))
+        fields.questionCount = input.questions.length;
+    return fields;
+}
+function parseTaskCreate(input) {
+    const fields = {};
+    if (typeof input.subject === 'string')
+        fields.taskSubject = input.subject;
+    return fields;
+}
+function parseTaskUpdate(input) {
+    const fields = {};
+    if (typeof input.taskId === 'string')
+        fields.taskId = input.taskId;
+    if (typeof input.status === 'string')
+        fields.taskStatus = input.status;
+    if (typeof input.subject === 'string')
+        fields.taskSubject = input.subject;
+    return fields;
+}
+// ---------------------------------------------------------------------------
+// Dispatcher
+// ---------------------------------------------------------------------------
+const INPUT_PARSERS = {
+    Read: parseRead,
+    Write: parseWrite,
+    Edit: parseEdit,
+    Bash: parseBash,
+    Grep: parseGrep,
+    Glob: parseGlob,
+    Agent: parseAgent,
+    AskUserQuestion: parseAskUserQuestion,
+    TaskCreate: parseTaskCreate,
+    TaskUpdate: parseTaskUpdate,
+};
+function parseEditOutput(output) {
+    const fields = {};
+    if (typeof output.editSuccess === 'boolean')
+        fields.editSuccess = output.editSuccess;
+    if (typeof output.editMatched === 'boolean')
+        fields.editMatched = output.editMatched;
+    if (typeof output.editError === 'string')
+        fields.editErrorReason = output.editError;
+    return fields;
+}
+function parseGrepOutput(output) {
+    const fields = {};
+    if (typeof output.grepMatchCount === 'number')
+        fields.grepMatchCount = output.grepMatchCount;
+    if (typeof output.grepResultLines === 'number')
+        fields.grepResultLines = output.grepResultLines;
+    return fields;
+}
+function parseAgentOutput(output) {
+    const fields = {};
+    if (typeof output.agentCompleted === 'boolean')
+        fields.agentCompleted = output.agentCompleted;
+    if (typeof output.agentInterrupted === 'boolean')
+        fields.agentInterrupted = output.agentInterrupted;
+    if (typeof output.agentResultLength === 'number')
+        fields.agentResultLength = output.agentResultLength;
+    return fields;
+}
+const OUTPUT_PARSERS = {
+    Bash: (output) => {
+        const fields = {};
+        if (typeof output.exitCode === 'number') {
+            fields.exitCode = output.exitCode;
+        }
+        else if (typeof output.exitCode === 'string') {
+            const parsed = Number(output.exitCode);
+            if (!Number.isNaN(parsed))
+                fields.exitCode = parsed;
+        }
+        return fields;
+    },
+    Edit: parseEditOutput,
+    Grep: parseGrepOutput,
+    Agent: parseAgentOutput,
+};
+/**
+ * Extract tool-specific structured fields from a tool's input and output.
+ * Returns a flat record of fields to spread into the ToolCallRecord.
+ * Unknown tools or parsing errors return {}.
+ */
+export function parseToolSpecificFields(toolName, input, output) {
+    try {
+        const fields = {};
+        // Normalize tool name: try exact match first, then capitalize first letter
+        // to handle variants like "read" → "Read" from non-Claude-Code platforms.
+        const normalizedName = INPUT_PARSERS[toolName] !== undefined
+            ? toolName
+            : toolName.charAt(0).toUpperCase() + toolName.slice(1);
+        // Parse input fields
+        const inputParser = INPUT_PARSERS[normalizedName];
+        if (inputParser && input !== null && input !== undefined && typeof input === 'object') {
+            Object.assign(fields, inputParser(input));
+        }
+        // Parse output fields
+        const outputParser = OUTPUT_PARSERS[normalizedName];
+        if (outputParser && output !== null && output !== undefined && typeof output === 'object') {
+            Object.assign(fields, outputParser(output));
+        }
+        return fields;
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=tool-parsers.js.map

package/dist/hooks/tool-parsers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { VERSION } from './shared/index.js';
+import { LocalStore } from './storage/index.js';
+import { LiveSessionRegistry } from './metrics/live-session-registry.js';
+import { DashboardServer } from './dashboard/dashboard-server.js';
+import type { CliOptions } from './types.js';
+export { VERSION };
+export { NrMcpServer, createServer } from './server.js';
+export { loadMcpConfig, redactSensitive } from './config.js';
+export type { McpServerConfig } from './config.js';
+export { LocalStore } from './storage/index.js';
+export type { HookEvent, SessionSummary, AuditEntry } from './storage/index.js';
+export type { CliOptions, ServerOptions } from './types.js';
+export { ProxyManager } from './proxy/index.js';
+export type { ProxyToolCallRecord, ProxyRequestRecord, UpstreamConfig } from './proxy/index.js';
+export { ClaudeCodeAdapter, CursorAdapter, WindsurfAdapter, CopilotAdapter, ZedAdapter, ContinueAdapter, AmazonQAdapter, parseCopilotUsageResponse, GenericMcpAdapter, validateReportToolCallInput, REPORT_TOOL_CALL_TOOL, REPORT_SESSION_START_TOOL, REPORT_SESSION_END_TOOL, PlatformRegistry, createDefaultRegistry, } from './platforms/index.js';
+export type { NormalizedToolCall, PlatformConfig, PlatformSessionMetadata, PlatformAdapter, ReportToolCallInput, ReportSessionStartInput, ReportSessionEndInput, } from './platforms/index.js';
+export declare function maskCredential(key: string): string;
+/**
+ * Result of evaluating a dashboard-server start error.
+ *
+ * - kind: 'skip' — EADDRINUSE was observed; caller should drop the dashboard
+ *   server reference and continue without binding. The `message` field is a
+ *   human-readable INFO-level log line explaining the situation.
+ * - kind: 'rethrow' — non-EADDRINUSE error (or non-error value); caller should
+ *   re-throw `error` unchanged.
+ */
+export type DashboardStartFailure = {
+    kind: 'skip';
+    message: string;
+} | {
+    kind: 'rethrow';
+    error: unknown;
+};
+/**
+ * Decide how to handle a failure returned from `DashboardServer.start()`.
+ *
+ * When N concurrent `preflight --stdio` instances launch (one per
+ * Claude Code session) only one can bind the dashboard port; the rest receive
+ * EADDRINUSE. Rather than fataling the whole MCP server (which would render
+ * the session's tools unusable in Claude Code's UI), we log an INFO line and
+ * continue without the dashboard. Other errors still propagate.
+ */
+export declare function classifyDashboardStartError(err: unknown, host: string, port: number): DashboardStartFailure;
+/**
+ * Default interval (ms) between dashboard re-bind attempts when this MCP
+ * started in headless mode (Fix 1 EADDRINUSE skip path). Overridable via
+ * NR_AI_DASHBOARD_REPOLL_MS — kept simple to avoid threading a new config
+ * field through the loader for what is essentially a knob for tests.
+ */
+export declare const DEFAULT_DASHBOARD_REPOLL_MS = 30000;
+export declare function getDashboardRepollIntervalMs(): number;
+/**
+ * Side-effects wired up once the dashboard HTTP server has bound the port.
+ * Runs on the initial-bind success path and on the re-poll takeover path so
+ * a headless MCP that later seizes the dashboard performs the same setup
+ * (orphan GC, openOnStart warning) as one that bound on first try.
+ *
+ * Returns the orphan-GC interval handle so the shutdown path can clear it.
+ */
+export interface DashboardPostBindDeps {
+    readonly localStore: LocalStore;
+    readonly liveSessionRegistry: LiveSessionRegistry | undefined;
+    readonly openOnStart: boolean;
+}
+export declare function setupDashboardPostBind(addr: {
+    address: string;
+    port: number;
+}, deps: DashboardPostBindDeps): NodeJS.Timeout;
+/**
+ * Schedule periodic re-bind attempts after a headless start (Fix 1 path).
+ *
+ * After Fix 1 the first MCP to launch wins port 7777 and serves the
+ * dashboard; the rest run headless. If the owner exits while the headless
+ * MCPs are still alive, the port is freed and nobody picks it up — the
+ * dashboard goes dead. This re-poll closes that gap: every
+ * `intervalMs` (default 30s) the headless MCP retries `start()`, and the
+ * first one to succeed promotes itself to dashboard owner and runs the
+ * post-bind setup (GC interval, etc.).
+ *
+ * The interval is unref'd so a process whose only remaining handle is this
+ * timer can still exit cleanly when stdin closes (matters for stdio mode).
+ */
+export interface DashboardRepollOptions {
+    readonly dashboardServer: DashboardServer;
+    readonly host: string;
+    readonly port: number;
+    readonly intervalMs?: number;
+    readonly postBind: (addr: {
+        address: string;
+        port: number;
+    }) => NodeJS.Timeout;
+    readonly onTakeover?: (gcInterval: NodeJS.Timeout) => void;
+    readonly logger?: {
+        info: (msg: string, meta?: Record<string, unknown>) => void;
+        warn: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+}
+export declare function startDashboardRepoll(opts: DashboardRepollOptions): NodeJS.Timeout;
+/**
+ * If argv[2] is a known subcommand, run it and return its exit code.
+ * Otherwise return null so main() can continue with its flag-based dispatch.
+ */
+export declare function dispatchSubcommand(argv: string[]): Promise<number | null>;
+export declare function parseArgs(argv: string[]): CliOptions;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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