@newrelic/preflight 1.4.47 → 1.5.1

package/dist/metrics/cost-tracker.js

@@ -7,8 +7,10 @@
  *
  * Cost calculation delegates to `calculateCost()` from the shared package.
  */
-import { calculateCost } from '../shared/index.js';
+import { calculateCost, createLogger } from '../shared/index.js';
 import { localDateKey } from '../lib/date.js';
+const logger = createLogger('cost-tracker');
+const LATE_ARRIVAL_REJECTION_MS = 48 * 60 * 60 * 1000;
 // ---------------------------------------------------------------------------
 // CostTracker
 // ---------------------------------------------------------------------------
@@ -33,16 +35,39 @@ export class CostTracker {
     // including tokens spent before midnight.
     costByDayUsd = new Map();
     firstActivityMsByDay = new Map();
+    /**
+     * Per-workflow-run cost attribution split by local-day so a run that crosses
+     * midnight contributes to each day's bucket independently. Two-level map:
+     * `costByWorkflowRunId.get(runId).get(dayKey) → usd`. Restart-resets to empty
+     * (intentional: per-day totals remain correct even if run-level attribution
+     * is lost across restarts).
+     */
+    costByWorkflowRunId = new Map();
+    /** Per-day mutation counter so dashboards can invalidate cached day cards. */
+    lastMutationMsByDay = new Map();
+    /**
+     * Subagent-attributed spend: accumulated when `ctx.agentId` is set.
+     * Parent spend covers all other token reports.
+     */
+    subagentCostUsd = 0;
+    /** Subagent-attributed spend per local-day key, for a today-scoped KPI. */
+    subagentCostByDayUsd = new Map();
+    parentCostUsd = 0;
     totalLinesChanged = 0;
     constructor(sessionTracker) {
         this.sessionTracker = sessionTracker ?? null;
     }
     /**
      * Primary path: record exact token usage from self-reporting.
+     *
+     * The optional `ctx` argument lets the subagent watcher attribute tokens
+     * to the actual JSONL `timestamp` (rather than `Date.now()`) so a run
+     * that crosses midnight is bucketed correctly, AND to a `workflowRunId` /
+     * `agentId` for per-run and subagent/parent cost attribution.
      */
-    recordTokenUsage(usage, model) {
+    recordTokenUsage(usage, model, ctx) {
         this.reportCount++;
-        return this.accumulateTokens(usage, model);
+        return this.accumulateTokens(usage, model, ctx);
     }
     /**
      * Fallback path: estimate tokens from character counts.
@@ -62,8 +87,40 @@ export class CostTracker {
         this.estimationCount++;
         return this.accumulateTokens(usage, model);
     }
-    accumulateTokens(usage, model) {
+    accumulateTokens(usage, model, ctx) {
         const breakdown = calculateCost(model, usage);
+        const wallNowMs = Date.now();
+        // Late-arrival rejection: a `ctx.timestampMs` more than 48h before now is
+        // dropped from day buckets to bound retroactive mutation. Session-level
+        // totals (totalCostUsd, subagentCostUsd, etc.) still accumulate because
+        // they are session-scoped and the cost is real.
+        const tsMs = ctx?.timestampMs ?? wallNowMs;
+        const isLate = ctx?.timestampMs !== undefined && wallNowMs - ctx.timestampMs > LATE_ARRIVAL_REJECTION_MS;
+        if (isLate) {
+            logger.warn('Late-arrival token event dropped from day bucket', {
+                timestampMs: ctx?.timestampMs,
+                deltaMs: wallNowMs - (ctx?.timestampMs ?? wallNowMs),
+            });
+            // Still accumulate session-level totals, but skip day bucketing and
+            // workflow-run maps.
+            this.totalCostUsd += breakdown.totalUsd;
+            this.totalInputTokens += usage.inputTokens;
+            this.totalOutputTokens += usage.outputTokens;
+            this.totalThinkingTokens += usage.thinkingTokens;
+            this.totalCacheReadTokens += usage.cacheReadTokens;
+            this.totalCacheCreationTokens += usage.cacheCreationTokens;
+            this.currentModel = model;
+            this.latestCostBreakdown = breakdown;
+            this.costByModel.set(model, (this.costByModel.get(model) ?? 0) + breakdown.totalUsd);
+            this.totalCacheSavingsUsd += breakdown.savingsFromCacheUsd;
+            if (ctx?.agentId !== undefined) {
+                this.subagentCostUsd += breakdown.totalUsd;
+            }
+            else {
+                this.parentCostUsd += breakdown.totalUsd;
+            }
+            return breakdown;
+        }
         this.totalCostUsd += breakdown.totalUsd;
         this.totalInputTokens += usage.inputTokens;
         this.totalOutputTokens += usage.outputTokens;
@@ -74,11 +131,31 @@ export class CostTracker {
         this.latestCostBreakdown = breakdown;
         this.costByModel.set(model, (this.costByModel.get(model) ?? 0) + breakdown.totalUsd);
         this.totalCacheSavingsUsd += breakdown.savingsFromCacheUsd;
-        const nowMs = Date.now();
-        const dayKey = localDateKey(nowMs);
+        // Subagent vs parent split
+        if (ctx?.agentId !== undefined) {
+            this.subagentCostUsd += breakdown.totalUsd;
+        }
+        else {
+            this.parentCostUsd += breakdown.totalUsd;
+        }
+        // Day bucketing
+        const dayKey = localDateKey(tsMs);
         this.costByDayUsd.set(dayKey, (this.costByDayUsd.get(dayKey) ?? 0) + breakdown.totalUsd);
-        if (!this.firstActivityMsByDay.has(dayKey)) {
-            this.firstActivityMsByDay.set(dayKey, nowMs);
+        if (ctx?.agentId !== undefined) {
+            this.subagentCostByDayUsd.set(dayKey, (this.subagentCostByDayUsd.get(dayKey) ?? 0) + breakdown.totalUsd);
+        }
+        this.lastMutationMsByDay.set(dayKey, wallNowMs);
+        const existingFirst = this.firstActivityMsByDay.get(dayKey);
+        if (existingFirst === undefined || tsMs < existingFirst) {
+            // Use earliest event timestamp for the day so cross-midnight burn-rate
+            // denominators stay correct (NOT wall-clock arrival time).
+            this.firstActivityMsByDay.set(dayKey, tsMs);
+        }
+        // Per-workflow-run day bucketing
+        if (ctx?.workflowRunId) {
+            const runMap = this.costByWorkflowRunId.get(ctx.workflowRunId) ?? new Map();
+            runMap.set(dayKey, (runMap.get(dayKey) ?? 0) + breakdown.totalUsd);
+            this.costByWorkflowRunId.set(ctx.workflowRunId, runMap);
         }
         return breakdown;
     }
@@ -99,6 +176,15 @@ export class CostTracker {
     getCostForDay(dayKey) {
         return this.costByDayUsd.get(dayKey) ?? 0;
     }
+    /**
+     * Subagent-attributed cost during a specific local-time day. Today-scoped
+     * counterpart to getSubagentMetrics().subagentUsd (which is session-
+     * cumulative) so the "subagent spend" KPI lines up with the day-bucketed
+     * "spend today" total.
+     */
+    getSubagentCostForDay(dayKey) {
+        return this.subagentCostByDayUsd.get(dayKey) ?? 0;
+    }
     /**
      * Epoch ms of the first token event recorded today (local time), or null
      * if no spend has been booked today. The forecast burn-rate denominator
@@ -109,6 +195,48 @@ export class CostTracker {
     getFirstActivityMsForDay(dayKey) {
         return this.firstActivityMsByDay.get(dayKey) ?? null;
     }
+    /** Most recent wall-clock ms a per-day bucket was mutated (cache-key seed). */
+    getLastMutationMsForDay(dayKey) {
+        return this.lastMutationMsByDay.get(dayKey) ?? null;
+    }
+    /**
+     * Per-workflow-run total spend, summed across all day-keys this run
+     * touched. Returns 0 for unknown runIds.
+     */
+    getCostForWorkflowRun(runId) {
+        const m = this.costByWorkflowRunId.get(runId);
+        if (!m)
+            return 0;
+        let total = 0;
+        for (const v of m.values())
+            total += v;
+        return total;
+    }
+    /** Iterable view of every (runId, dayKey, usd) tuple — for dashboard joins. */
+    *iterCostByWorkflowRun() {
+        for (const [runId, m] of this.costByWorkflowRunId) {
+            for (const [dayKey, usd] of m) {
+                yield { runId, dayKey, usd };
+            }
+        }
+    }
+    /**
+     * Subagent / parent cost split for the current session.
+     *
+     * `reconciliationDeltaPct` is a placeholder: it will compare the
+     * total tokens reported by WorkflowRunEvent against the sum of per-subagent
+     * cost to detect attribution gaps. Returns null until that data is available.
+     */
+    getSubagentMetrics() {
+        const total = this.subagentCostUsd + this.parentCostUsd;
+        const subagentSharePct = total > 0 ? (this.subagentCostUsd / total) * 100 : 0;
+        return {
+            subagentUsd: this.subagentCostUsd,
+            parentUsd: this.parentCostUsd,
+            subagentSharePct,
+            reconciliationDeltaPct: null,
+        };
+    }
     /**
      * Record lines of code changed (from Edit/Write tool data).
      */
@@ -120,6 +248,11 @@ export class CostTracker {
         const uniqueFilesWritten = this.sessionTracker
             ? this.sessionTracker.getMetrics().uniqueFilesWritten
             : 0;
+        // Serialise the two-level Map into a plain Record for JSON compatibility.
+        const costByWorkflowRunId = {};
+        for (const [runId, dayMap] of this.costByWorkflowRunId) {
+            costByWorkflowRunId[runId] = Object.fromEntries(dayMap);
+        }
         return {
             sessionTotalCostUsd: hasData ? this.totalCostUsd : null,
             costByTask: null,
@@ -137,6 +270,9 @@ export class CostTracker {
             reportCount: this.reportCount,
             estimationCount: this.estimationCount,
             latestCostBreakdown: this.latestCostBreakdown,
+            subagentCostUsd: this.subagentCostUsd,
+            parentCostUsd: this.parentCostUsd,
+            costByWorkflowRunId,
         };
     }
     emitMetrics(aggregator) {
@@ -162,6 +298,8 @@ export class CostTracker {
         }
         aggregator.record('ai.cost.report_count', this.reportCount, attrs);
         aggregator.record('ai.cost.estimation_count', this.estimationCount, attrs);
+        aggregator.record('ai.cost.subagent_usd', this.subagentCostUsd, attrs);
+        aggregator.record('ai.cost.parent_usd', this.parentCostUsd, attrs);
     }
     reset() {
         this.totalCostUsd = 0;
@@ -177,7 +315,12 @@ export class CostTracker {
         this.latestCostBreakdown = null;
         this.costByModel = new Map();
         this.costByDayUsd = new Map();
+        this.subagentCostByDayUsd = new Map();
         this.firstActivityMsByDay = new Map();
+        this.costByWorkflowRunId = new Map();
+        this.lastMutationMsByDay = new Map();
+        this.subagentCostUsd = 0;
+        this.parentCostUsd = 0;
         this.totalLinesChanged = 0;
     }
 }

package/dist/metrics/cost-tracker.js.map

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

package/dist/metrics/recommendation-engine.d.ts

@@ -1,5 +1,5 @@
 /**
- * Unified Recommendation Engine — synthesizes all Phase 4 analyzers into
+ * Unified Recommendation Engine — synthesizes all analyzers into
  * a single prioritized, deduplicated recommendation list.
  *
  * Categories:

package/dist/metrics/recommendation-engine.js

@@ -1,5 +1,5 @@
 /**
- * Unified Recommendation Engine — synthesizes all Phase 4 analyzers into
+ * Unified Recommendation Engine — synthesizes all analyzers into
  * a single prioritized, deduplicated recommendation list.
  *
  * Categories:

package/dist/metrics/workflow-run-tracker.d.ts

@@ -0,0 +1,140 @@
+/**
+ * WorkflowRunTracker — captures one record per detected workflow run.
+ *
+ * Two input sources (identifier-space discriminator):
+ *   1. run_source: 'agent_tool' — from PreToolUse/PostToolUse hook pairs on
+ *      the 'Agent' tool.  workflow_run_id = toolUseId (toolu_*).
+ *      Entry points: recordAgentToolCall(record) or recordToolCall(record).
+ *
+ *   2. run_source: 'script' — from wf_*.json WorkflowWatcher events.
+ *      workflow_run_id = wf_<hex>-<hex>.
+ *      Entry point: recordScriptRun(event).
+ *
+ * For agent_tool runs, non-Agent tool calls that fall within a run's
+ * [started_at, started_at + duration_ms] window are attributed to it via
+ * tool_call_count and child_agent_count heuristics (best-effort, because hook
+ * payloads do not distinguish inner-subagent calls from parent calls).
+ */
+import type { ToolCallRecord } from '../storage/types.js';
+export type WorkflowRunStatus = 'completed' | 'errored' | 'in_progress';
+/** Event shape produced by the WorkflowWatcher from wf_*.json files. */
+export interface WorkflowRunEvent {
+    readonly mode: 'workflow_run';
+    readonly timestamp: number;
+    readonly workflowRunId: string;
+    readonly status: string;
+    readonly durationMs: number | null;
+    readonly totalTokens: number;
+    readonly agentCount: number;
+    readonly workflowName: string;
+    readonly phases: readonly string[];
+    readonly workflowProgress: ReadonlyArray<{
+        readonly type?: string;
+        readonly state?: string;
+        readonly agentId?: string;
+    }>;
+    readonly parentSessionId: string;
+}
+/**
+ * One row per completed workflow run.
+ *
+ * Fields marked "agent_tool only" are null when run_source === 'script'.
+ * Fields marked "script only" are null/0 when run_source === 'agent_tool'.
+ */
+export interface WorkflowRunMetrics {
+    readonly workflow_run_id: string;
+    readonly run_source: 'agent_tool' | 'script';
+    readonly session_id: string;
+    readonly workflow_name: string;
+    readonly status: string;
+    readonly started_at: number;
+    readonly duration_ms: number;
+    readonly agent_count: number;
+    readonly total_tokens: number;
+    readonly declared_phases: number | null;
+    readonly observed_phases: number;
+    readonly incomplete: boolean;
+    readonly subagent_type: string | null;
+    readonly agent_name: string | null;
+    readonly agent_model: string | null;
+    readonly agent_description: string | null;
+    readonly run_in_background: boolean | null;
+    readonly exit_error: string | null;
+    readonly tool_call_count: number;
+    readonly child_agent_count: number;
+}
+export interface WorkflowRunTrackerOptions {
+    /** Max characters of agent_description retained on the metrics row. */
+    readonly descriptionMaxLength?: number;
+    /** Hard cap on simultaneously-tracked open runs to prevent unbounded growth. */
+    readonly maxOpenRuns?: number;
+    /** Hard cap on drainable completed runs awaiting consumption. */
+    readonly maxCompletedRuns?: number;
+}
+export declare class WorkflowRunTracker {
+    private readonly descriptionMaxLength;
+    private readonly maxOpenRuns;
+    private readonly maxCompletedRuns;
+    /** Open runs keyed by workflow_run_id. Insertion order = arrival order. */
+    private readonly openRuns;
+    /** Completed (drainable) runs in arrival order. */
+    private readonly completed;
+    constructor(options?: WorkflowRunTrackerOptions);
+    /**
+     * Record a ToolCallRecord from the hook event processor.
+     * Only Agent tool calls are recorded as workflow runs; other tool calls are
+     * attributed to the enclosing run as child calls.
+     *
+     * Kept for backward compatibility — delegates to recordAgentToolCall or
+     * the attribution heuristic as appropriate.
+     */
+    recordToolCall(record: ToolCallRecord): void;
+    /**
+     * Record a completed Agent tool call hook pair.
+     * Only processes records where toolName === 'Agent'.
+     */
+    recordAgentToolCall(record: ToolCallRecord): void;
+    /**
+     * Record a workflow run event from a wf_*.json WorkflowWatcher file.
+     *
+     * NOTE: currently unused in production wiring. `src/index.ts` feeds only
+     * `run_source='agent_tool'` runs into the tracker (via `onWorkflowAgent` →
+     * `recordToolCall`); script workflow runs are surfaced to the dashboard by
+     * WorkflowStore reading wf_*.json directly, not through this tracker. This
+     * method is retained (and covered by tests) for a future buffer path that
+     * routes WorkflowWatcher events through the processor — do not delete.
+     */
+    recordScriptRun(event: WorkflowRunEvent): void;
+    /**
+     * Returns and clears all completed (drainable) runs in arrival order.
+     * Open (in-progress) runs are not returned.
+     * Each run is returned exactly once.
+     */
+    drainCompleted(): WorkflowRunMetrics[];
+    /**
+     * Snapshot of all currently-tracked runs (open + completed-but-not-drained),
+     * primarily for tests and MCP tool inspection. Does not clear the buffer.
+     *
+     * A completed agent_tool run is kept in BOTH `openRuns` (for attribution
+     * lookups by late-arriving child tool calls) and `completed` (until
+     * drained) — dedupe by workflow_run_id so it isn't double-counted here.
+     */
+    getMetrics(): readonly WorkflowRunMetrics[];
+    /**
+     * Clears all state for a new session. The sessionId parameter is accepted
+     * for interface consistency with other trackers.
+     */
+    reset(_sessionId: string): void;
+    private attributeChildToolCall;
+    private incrementParentChildAgentCount;
+    /**
+     * Find the most-recently-started run in the same session whose
+     * [started_at, started_at + duration_ms] window encloses `timestamp`.
+     * Falls back to the most recent run that started before `timestamp` when
+     * no window encloses it (best-effort attribution).
+     */
+    private findEnclosingRun;
+    private pushCompleted;
+    private enforceOpenRunsCap;
+}
+//# sourceMappingURL=workflow-run-tracker.d.ts.map

package/dist/metrics/workflow-run-tracker.d.ts.map

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