@newrelic/preflight 1.18.2 → 1.18.4

package/dist/homelab/homelab-accumulator.js

@@ -0,0 +1,139 @@
+import { createLogger } from '../shared/index.js';
+import { ZERO_QUALITY_PROXY_COUNTS } from '../metrics/quality-proxy-tracker.js';
+import { SessionStore } from '../storage/session-store.js';
+const logger = createLogger('homelab-accumulator');
+const SESSION_ID_RE = /^[a-zA-Z0-9_-]{1,128}$/;
+const STALE_SESSION_MS = 3 * 60 * 1000;
+const FLUSH_INTERVAL_MS = 60_000;
+function isIngestPayload(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const obj = v;
+    return (typeof obj.developer === 'string' &&
+        typeof obj.sessionId === 'string' &&
+        Array.isArray(obj.records));
+}
+export class HomelabAccumulator {
+    sessionStore;
+    sessions = new Map();
+    flushTimer = null;
+    constructor(opts) {
+        this.sessionStore = new SessionStore({ storagePath: opts.storagePath });
+    }
+    handleIngest(payload) {
+        if (!isIngestPayload(payload))
+            return 'invalid';
+        const { developer, sessionId, records } = payload;
+        if (!developer || !SESSION_ID_RE.test(sessionId))
+            return 'invalid';
+        const key = `${developer}:${sessionId}`;
+        const existing = this.sessions.get(key);
+        if (existing) {
+            existing.records.push(...records);
+            existing.lastSeen = Date.now();
+        }
+        else {
+            this.sessions.set(key, {
+                developer,
+                sessionId,
+                records: [...records],
+                startTime: records[0]?.timestamp ?? Date.now(),
+                lastSeen: Date.now(),
+            });
+        }
+        return 'ok';
+    }
+    start() {
+        this.flushTimer = setInterval(() => this.flushStaleSessions(), FLUSH_INTERVAL_MS);
+        this.flushTimer.unref?.();
+    }
+    stop() {
+        if (this.flushTimer !== null) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.flushAllSessions();
+    }
+    flushStaleSessions() {
+        const cutoff = Date.now() - STALE_SESSION_MS;
+        for (const [key, session] of this.sessions) {
+            if (session.lastSeen < cutoff) {
+                this.saveSession(session);
+                this.sessions.delete(key);
+            }
+        }
+    }
+    flushAllSessions() {
+        for (const session of this.sessions.values()) {
+            this.saveSession(session);
+        }
+        this.sessions.clear();
+    }
+    saveSession(session) {
+        const summary = buildMinimalSummary(session);
+        try {
+            this.sessionStore.saveSession(summary);
+        }
+        catch (err) {
+            logger.warn('Failed to save homelab session', {
+                error: String(err),
+                sessionId: session.sessionId,
+            });
+        }
+    }
+}
+function buildMinimalSummary(session) {
+    const toolBreakdown = {};
+    for (const r of session.records) {
+        toolBreakdown[r.toolName] = (toolBreakdown[r.toolName] ?? 0) + 1;
+    }
+    const endTime = session.records.at(-1)?.timestamp ?? session.lastSeen;
+    return {
+        sessionId: session.sessionId,
+        startTime: session.startTime,
+        endTime,
+        durationMs: endTime - session.startTime,
+        toolCallCount: session.records.length,
+        developer: session.developer,
+        sessionName: null,
+        sessionNameSource: null,
+        sessionIntent: null,
+        repoName: null,
+        model: null,
+        toolBreakdown,
+        filesRead: [],
+        filesModified: [],
+        linesAdded: 0,
+        linesRemoved: 0,
+        bashCommandCount: 0,
+        testRunCount: 0,
+        testPassCount: 0,
+        buildRunCount: 0,
+        buildPassCount: 0,
+        estimatedCostUsd: null,
+        subagentCostUsd: 0,
+        tokensInput: 0,
+        tokensOutput: 0,
+        tokensThinking: 0,
+        tokensCacheRead: 0,
+        tokensCacheCreation: 0,
+        cacheSavingsUsd: 0,
+        efficiencyScore: null,
+        toolSelectionMetrics: null,
+        modelBreakdown: {},
+        costByWorkflowRunId: {},
+        qualityProxy: { ...ZERO_QUALITY_PROXY_COUNTS },
+        antiPatterns: [],
+        taskCount: 0,
+        taskSuccessRate: null,
+        toolSuccessRate: null,
+        contextCompressions: 0,
+        agentSpawns: 0,
+        userMessages: 0,
+        assistantMessages: 0,
+        userCorrections: 0,
+        outcome: 'unknown',
+        platform: 'homelab',
+    };
+}
+//# sourceMappingURL=homelab-accumulator.js.map

package/dist/homelab/homelab-accumulator.js.map

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

package/dist/homelab/homelab-forwarder.d.ts

@@ -0,0 +1,24 @@
+import type { ToolCallRecord } from '../storage/types.js';
+export interface HomelabForwarderOptions {
+    readonly serverUrl: string;
+    readonly token: string;
+    readonly developer: string;
+    readonly sessionId: string;
+}
+export declare class HomelabForwarder {
+    private readonly serverUrl;
+    private readonly token;
+    private readonly developer;
+    private readonly sessionId;
+    private buffer;
+    private timer;
+    private stopped;
+    private readonly dispatcher;
+    constructor(opts: HomelabForwarderOptions);
+    start(): void;
+    enqueue(record: ToolCallRecord): void;
+    flush(): Promise<void>;
+    stop(): Promise<void>;
+    private post;
+}
+//# sourceMappingURL=homelab-forwarder.d.ts.map

package/dist/homelab/homelab-forwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"homelab-forwarder.d.ts","sourceRoot":"","sources":["../../src/homelab/homelab-forwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;IAOxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,IAAI,EAAE,uBAAuB;IAazC,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAQ/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAYb,IAAI;CA2BnB"}

package/dist/homelab/homelab-forwarder.js

@@ -0,0 +1,96 @@
+import { Agent } from 'undici';
+import { createLogger } from '../shared/index.js';
+import { validateSsrfUrl, createSsrfSafeLookup } from '../security/ssrf.js';
+const logger = createLogger('homelab-forwarder');
+const MAX_BUFFER_SIZE = 1000;
+const FLUSH_INTERVAL_MS = 5_000;
+export class HomelabForwarder {
+    serverUrl;
+    token;
+    developer;
+    sessionId;
+    buffer = [];
+    timer = null;
+    stopped = false;
+    // Built once and reused for every post() call. Its connect.lookup resolves
+    // and validates the address actually connected to (see
+    // createSsrfSafeLookup()'s doc comment) — allowPrivateNetworks: true
+    // because a homelab server is, by design, almost always at a private LAN
+    // address; only cloud metadata endpoints and non-http(s) schemes are
+    // blocked here, not RFC-1918/loopback ranges.
+    dispatcher;
+    constructor(opts) {
+        validateSsrfUrl('HomelabForwarder', new URL(opts.serverUrl), { allowPrivateNetworks: true });
+        this.serverUrl = opts.serverUrl;
+        this.token = opts.token;
+        this.developer = opts.developer;
+        this.sessionId = opts.sessionId;
+        this.dispatcher = new Agent({
+            connect: {
+                lookup: createSsrfSafeLookup('HomelabForwarder (resolved)', { allowPrivateNetworks: true }),
+            },
+        });
+    }
+    start() {
+        if (this.stopped)
+            return;
+        this.timer = setInterval(() => {
+            void this.flush();
+        }, FLUSH_INTERVAL_MS);
+        this.timer.unref?.();
+    }
+    enqueue(record) {
+        if (this.stopped)
+            return;
+        if (this.buffer.length >= MAX_BUFFER_SIZE) {
+            this.buffer.shift();
+        }
+        this.buffer.push(record);
+    }
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const batch = this.buffer.splice(0);
+        await this.post(batch);
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        await this.flush();
+        await this.dispatcher.close().catch((err) => {
+            logger.warn('Failed to close homelab forwarder dispatcher', { error: String(err) });
+        });
+    }
+    async post(records) {
+        const payload = JSON.stringify({
+            developer: this.developer,
+            sessionId: this.sessionId,
+            records,
+        });
+        try {
+            const response = await fetch(`${this.serverUrl}/ingest`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.token}`,
+                },
+                body: payload,
+                signal: AbortSignal.timeout(5_000),
+                dispatcher: this.dispatcher,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+        }
+        catch (err) {
+            logger.warn('Failed to forward events to homelab server', {
+                error: String(err),
+                count: records.length,
+            });
+        }
+    }
+}
+//# sourceMappingURL=homelab-forwarder.js.map

package/dist/homelab/homelab-forwarder.js.map

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

package/dist/homelab/index.d.ts

@@ -0,0 +1,5 @@
+export { HomelabForwarder } from './homelab-forwarder.js';
+export type { HomelabForwarderOptions } from './homelab-forwarder.js';
+export { HomelabAccumulator } from './homelab-accumulator.js';
+export type { HomelabIngestPayload } from './homelab-accumulator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/homelab/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/homelab/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/homelab/index.js

@@ -0,0 +1,3 @@
+export { HomelabForwarder } from './homelab-forwarder.js';
+export { HomelabAccumulator } from './homelab-accumulator.js';
+//# sourceMappingURL=index.js.map

package/dist/homelab/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/homelab/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -2,6 +2,7 @@
 import 'dotenv/config';
 import { Command, Option } from 'commander';
 import { readFileSync, realpathSync } from 'node:fs';
+import { timingSafeEqual } from 'node:crypto';
 import { resolve } from 'node:path';
 import { AlertLog } from './alerts/alert-log.js';
 import { AlertSnapshotCollector } from './alerts/alert-snapshot-collector.js';
@@ -75,6 +76,7 @@ import { SessionSpan } from './tracing/session-span.js';
 import { TaskSpanTracker } from './tracing/task-span-tracker.js';
 import { emitToolCallSpan } from './tracing/tool-call-span.js';
 import { NrIngestManager } from './transport/nr-ingest.js';
+import { HomelabAccumulator, HomelabForwarder } from './homelab/index.js';
 import { VERSION } from './version.js';
 export { loadMcpConfig, redactSensitive } from './config.js';
 export { AmazonQAdapter, ClaudeCodeAdapter, ContinueAdapter, CopilotAdapter, createDefaultRegistry, CursorAdapter, GenericMcpAdapter, parseCopilotUsageResponse, PlatformRegistry, REPORT_SESSION_END_TOOL, REPORT_SESSION_START_TOOL, REPORT_TOOL_CALL_TOOL, validateReportToolCallInput, WindsurfAdapter, ZedAdapter, } from './platforms/index.js';
@@ -324,6 +326,7 @@ export function startDashboardRepoll(opts) {
 const SUBCOMMAND_NAMES = [
     'deploy-dashboards',
     'deploy-alerts',
+    'server',
     'install',
     'uninstall',
     'setup',
@@ -335,8 +338,8 @@ const SUBCOMMAND_NAMES = [
 ];
 // Install-CLI subcommands — a subset of SUBCOMMAND_NAMES routed to runInstallCli.
 // Derived from SUBCOMMAND_NAMES to ensure a single source of truth: deploy-*
-// commands are excluded and handled by the commander path in dispatchSubcommand.
-const INSTALL_CLI_SUBCOMMANDS = SUBCOMMAND_NAMES.filter((s) => s !== 'deploy-dashboards' && s !== 'deploy-alerts');
+// and server commands are excluded and handled by the commander path in dispatchSubcommand.
+const INSTALL_CLI_SUBCOMMANDS = SUBCOMMAND_NAMES.filter((s) => s !== 'deploy-dashboards' && s !== 'deploy-alerts' && s !== 'server');
 function isSubcommand(value) {
     return typeof value === 'string' && SUBCOMMAND_NAMES.includes(value);
 }
@@ -392,6 +395,76 @@ export async function dispatchSubcommand(argv) {
             process.exitCode = code;
         });
     }
+    else if (sub === 'server') {
+        program
+            .command('server')
+            .description('Start Preflight in homelab server mode — receives events forwarded from remote clients and accumulates them to disk (no dashboard yet — see docs/homelab.md)')
+            .option('--port <port>', 'Port to bind to (default: 7777 or NEW_RELIC_AI_HOMELAB_SERVER_PORT)')
+            .option('--token <token>', 'Bearer token for /ingest auth (default: NEW_RELIC_AI_HOMELAB_TOKEN)')
+            .option('--bind <address>', 'Bind address (default: 0.0.0.0 or NEW_RELIC_AI_HOMELAB_BIND_ADDRESS)')
+            .option('--config <path>', 'Path to config file')
+            .action(async (opts) => {
+            if (opts.port)
+                process.env.NEW_RELIC_AI_HOMELAB_SERVER_PORT = opts.port;
+            if (opts.token)
+                process.env.NEW_RELIC_AI_HOMELAB_TOKEN = opts.token;
+            if (opts.bind)
+                process.env.NEW_RELIC_AI_HOMELAB_BIND_ADDRESS = opts.bind;
+            // server mode never needs cloud credentials — force local so loadMcpConfig
+            // doesn't require licenseKey/accountId.
+            process.env.NR_AI_MODE = 'local';
+            const config = loadConfigOrDie({ config: opts.config });
+            const token = config.homelabToken;
+            if (!token) {
+                process.stderr.write('[preflight] error: homelab server requires a token. Set --token or NEW_RELIC_AI_HOMELAB_TOKEN.\n');
+                process.exit(1);
+            }
+            const accumulator = new HomelabAccumulator({ storagePath: config.storagePath });
+            accumulator.start();
+            const bus = new LiveEventBus();
+            const dashboardServer = new DashboardServer({
+                port: config.homelabServer.port,
+                host: config.homelabServer.bindAddress,
+                bus,
+                serverMode: true,
+                ingestHandler: (authHeader, body) => {
+                    const expected = `Bearer ${token}`;
+                    const isAuthed = authHeader !== undefined &&
+                        authHeader.length === expected.length &&
+                        timingSafeEqual(Buffer.from(authHeader), Buffer.from(expected));
+                    if (!isAuthed)
+                        return 401;
+                    const result = accumulator.handleIngest(body);
+                    return result === 'ok' ? 204 : 400;
+                },
+            });
+            await dashboardServer.start();
+            logger.info('Homelab server ready', {
+                port: config.homelabServer.port,
+                bind: config.homelabServer.bindAddress,
+            });
+            // Keep the action (and therefore program.parseAsync) alive until a
+            // signal fires — without this, the action returns immediately and
+            // dispatchSubcommand exits the process.
+            await new Promise((resolve) => {
+                let shutting = false;
+                const shutdown = async () => {
+                    if (shutting)
+                        return;
+                    shutting = true;
+                    accumulator.stop();
+                    await dashboardServer.stop();
+                    resolve();
+                };
+                process.on('SIGTERM', () => {
+                    void shutdown();
+                });
+                process.on('SIGINT', () => {
+                    void shutdown();
+                });
+            });
+        });
+    }
     else {
         program
             .command('deploy-alerts')
@@ -582,6 +655,7 @@ async function main() {
         }, getPendingConfirmationCapMs());
         pendingConfirmationCapTimer.unref?.();
     };
+    let homelabForwarder = null;
     let shuttingDown = false;
     const shutdown = async () => {
         if (shuttingDown)
@@ -652,6 +726,7 @@ async function main() {
                 nrIngest ? nrIngest.stop() : Promise.resolve(),
                 mcpServer ? mcpServer.close() : Promise.resolve(),
                 proxyManager ? proxyManager.stop() : Promise.resolve(),
+                homelabForwarder ? homelabForwarder.stop() : Promise.resolve(),
             ]);
             for (const r of stopResults) {
                 if (r.status === 'rejected') {
@@ -1549,6 +1624,28 @@ async function main() {
             });
             capturedNrIngest = nrIngest;
         }
+        // Start homelab forwarder if configured. Construction validates
+        // homelabServerUrl (scheme + cloud-metadata-endpoint check) and can
+        // throw — caught here so a bad/malicious URL only disables forwarding,
+        // matching the "forwarding failures are non-fatal" contract in
+        // docs/homelab.md, rather than crashing MCP startup.
+        if (config.homelabServerUrl && config.homelabToken) {
+            try {
+                homelabForwarder = new HomelabForwarder({
+                    serverUrl: config.homelabServerUrl,
+                    token: config.homelabToken,
+                    developer: config.developer,
+                    sessionId: sessionTraceId ?? 'unknown',
+                });
+                homelabForwarder.start();
+            }
+            catch (err) {
+                homelabForwarder = null;
+                logger.error('Homelab forwarder failed to start — continuing without it', {
+                    error: String(err),
+                });
+            }
+        }
         const capturedAlertEngine = alertEngine;
         const capturedAlertSnapshotCollector = alertSnapshotCollector;
         budgetTracker.setOnThreshold((event) => {
@@ -1614,7 +1711,23 @@ async function main() {
                 contextWindowTracker.recordToolCall(rawRecord);
                 contextTracker.recordToolCall(rawRecord);
                 latencyTracker.recordToolCall(rawRecord);
-                retryDetector.recordToolCall(rawRecord);
+                const thrashingAlert = retryDetector.recordToolCall(rawRecord);
+                if (thrashingAlert) {
+                    capturedNrIngest?.ingestRetryAlert(thrashingAlert, {
+                        platform: typeof rawRecord.platform === 'string' ? rawRecord.platform : undefined,
+                    });
+                    liveBus.emit('retry-alert', {
+                        // alert.sessionId (not sessionTraceId) — see RetryDetector's
+                        // session-grouping comment: in --local mode this process's own
+                        // RetryDetector drains every session's buffer, so only the
+                        // alert's own sessionId can be trusted to name the offending one.
+                        sessionId: thrashingAlert.sessionId ?? undefined,
+                        toolName: thrashingAlert.toolName,
+                        occurrences: thrashingAlert.occurrences,
+                        tokensWasted: thrashingAlert.tokensWastedEstimate,
+                        ts: thrashingAlert.timestamp,
+                    });
+                }
                 qualityProxyTracker.recordToolCall(rawRecord);
                 const turnId = turnTracker.recordToolCall(rawRecord);
                 const turnNumber = turnTracker.getCurrentTurnNumber();
@@ -1777,6 +1890,7 @@ async function main() {
                         });
                     }
                 }
+                homelabForwarder?.enqueue(record);
             },
             onTokenEvent: (tokenEvent) => {
                 if (!costTracker || !config)