@farmslot/protocol 0.76.0 → 0.77.0

package/dist/performance/recorder.js

@@ -0,0 +1,352 @@
+import { Methods } from '../rpc/registry.js';
+import { HISTOGRAM_METRICS, } from './types.js';
+const MAX_SERIES = 8192;
+const MAX_QUERIES = 128;
+const MAX_REPORTERS = 32;
+const REPORT_CHUNK = 128;
+const empty = () => ({ histograms: new Map(), counters: new Map(), dropped: 0 });
+const id = () => `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+const key = (name, l) => [name, l.method, l.side, l.action_class, l.kind, l.cache_source, l.query].join('|');
+export class PerformanceRecorder {
+    onActivity(listener) {
+        this.activity.add(listener);
+        return () => this.activity.delete(listener);
+    }
+    changed() {
+        for (const listener of this.activity)
+            listener();
+    }
+    get epoch() {
+        return this.scopeVersion;
+    }
+    resetScope() {
+        this.scopeVersion++;
+        this.all = empty();
+        this.delta = empty();
+        this.report = undefined;
+        this.rates.clear();
+        this.queryIds = new WeakMap();
+        this.sourceId = id();
+        this.sequence = 0;
+        this.startedAtMs = Date.now();
+    }
+    constructor(side, options = {}) {
+        this.activity = new Set();
+        this.startedAtMs = Date.now();
+        this.all = empty();
+        this.delta = empty();
+        this.sourceId = id();
+        this.sequence = 0;
+        this.reporters = new Map();
+        this.reporterOrdinal = 0;
+        this.rates = new Map();
+        this.queryOrdinal = 0;
+        this.queryIds = new WeakMap();
+        this.scopeVersion = 0;
+        this.reportedGauges = new Map();
+        this.side = side;
+        this.clock = options.clock ?? (() => performance.now() / 1000);
+        this.methods = options.methods ?? new Set(Object.values(Methods));
+    }
+    labels(input) {
+        return {
+            ...input,
+            side: input.side ?? this.side,
+            ...(input.method
+                ? {
+                    method: this.methods.has(input.method) || input.method === '_background'
+                        ? input.method
+                        : '_unknown',
+                }
+                : {}),
+        };
+    }
+    observe(name, input, value) {
+        if (!Number.isFinite(value) || value < 0) {
+            this.all.dropped++;
+            this.delta.dropped++;
+            return;
+        }
+        const labels = this.labels(input), identity = key(name, labels), bounds = HISTOGRAM_METRICS[name];
+        let index = bounds.findIndex((bound) => value <= bound);
+        if (index < 0)
+            index = bounds.length;
+        const update = (state) => {
+            let row = state.histograms.get(identity);
+            if (!row) {
+                if (state.histograms.size + state.counters.size >= MAX_SERIES) {
+                    state.dropped++;
+                    return;
+                }
+                row = {
+                    name,
+                    labels,
+                    bins: Array(bounds.length + 1).fill(0),
+                    count: 0,
+                    sum: 0,
+                    max: 0,
+                };
+                state.histograms.set(identity, row);
+            }
+            row.bins[index]++;
+            row.count++;
+            row.sum += value;
+            row.max = Math.max(row.max, value);
+        };
+        update(this.all);
+        if (this.side !== 'gateway')
+            update(this.delta);
+        this.changed();
+    }
+    increment(name, input, value = 1) {
+        if (!Number.isFinite(value) || value < 0) {
+            this.all.dropped++;
+            this.delta.dropped++;
+            return;
+        }
+        const labels = this.labels(input), identity = key(name, labels);
+        const update = (state) => {
+            const row = state.counters.get(identity);
+            if (row)
+                row.value += value;
+            else if (state.histograms.size + state.counters.size < MAX_SERIES)
+                state.counters.set(identity, { name, labels, value });
+            else
+                state.dropped++;
+        };
+        update(this.all);
+        if (this.side !== 'gateway')
+            update(this.delta);
+        this.changed();
+    }
+    rotate(rate, second) {
+        const elapsed = Math.max(0, second - rate.second);
+        if (elapsed >= 60)
+            rate.bins.fill(0);
+        else
+            for (let i = 1; i <= elapsed; i++)
+                rate.bins[(rate.second + i) % 60] = 0;
+        rate.second = second;
+    }
+    reread(method, identity) {
+        let queryKey = this.queryIds.get(identity);
+        if (!queryKey) {
+            queryKey = `q${++this.queryOrdinal}`;
+            this.queryIds.set(identity, queryKey);
+        }
+        const second = Math.floor(this.clock());
+        let rate = this.rates.get(queryKey);
+        if (!rate) {
+            if (this.rates.size >= MAX_QUERIES) {
+                const oldest = this.rates.keys().next().value;
+                if (oldest !== undefined)
+                    this.rates.delete(oldest);
+            }
+            rate = { id: queryKey, method, second, bins: Array(60).fill(0) };
+        }
+        this.rotate(rate, second);
+        rate.bins[second % 60]++;
+        this.rates.delete(queryKey);
+        this.rates.set(queryKey, rate);
+        this.changed();
+    }
+    snapshotState(state) {
+        const histograms = [...state.histograms.values()].map((row) => {
+            let cumulative = 0;
+            return {
+                name: row.name,
+                labels: { ...row.labels },
+                buckets: row.bins.map((count) => (cumulative += count)),
+                count: row.count,
+                sum: row.sum,
+                max: row.max,
+            };
+        });
+        const gauges = [...this.rates.values()].map((rate) => ({
+            name: 'farmslot_client_rereads_per_minute',
+            labels: this.labels({ method: rate.method, query: rate.id }),
+            value: (this.rotate(rate, Math.floor(this.clock())), rate.bins.reduce((a, b) => a + b, 0)),
+        }));
+        return {
+            version: 1,
+            clientWindows: [...this.reporters.values()].map((row) => ({ ...row.window })),
+            startedAtMs: this.startedAtMs,
+            observedAtMs: Date.now(),
+            histograms,
+            counters: [...state.counters.values()].map((row) => ({ ...row, labels: { ...row.labels } })),
+            gauges: [
+                ...gauges,
+                ...[...this.reportedGauges.values()]
+                    .filter((row) => row.expires > Date.now())
+                    .map((row) => row.gauge),
+            ],
+            dropped: state.dropped,
+        };
+    }
+    snapshot() {
+        return this.snapshotState(this.all);
+    }
+    beginReport() {
+        if (this.side === 'gateway')
+            return undefined;
+        if (this.report)
+            return this.report;
+        if (!this.delta.histograms.size && !this.delta.counters.size && !this.delta.dropped)
+            return undefined;
+        const selected = empty();
+        let remaining = REPORT_CHUNK;
+        const histogramLimit = this.delta.counters.size ? REPORT_CHUNK / 2 : REPORT_CHUNK;
+        for (const [k, v] of this.delta.histograms) {
+            if (selected.histograms.size >= histogramLimit)
+                break;
+            remaining--;
+            selected.histograms.set(k, v);
+            this.delta.histograms.delete(k);
+        }
+        if (remaining > 0)
+            for (const [k, v] of this.delta.counters) {
+                if (!remaining--)
+                    break;
+                selected.counters.set(k, v);
+                this.delta.counters.delete(k);
+            }
+        selected.dropped = this.delta.dropped;
+        this.delta.dropped = 0;
+        this.report = {
+            ...this.snapshotState(selected),
+            sourceId: this.sourceId,
+            sequence: ++this.sequence,
+            side: this.side,
+        };
+        return this.report;
+    }
+    acknowledge(sequence) {
+        if (this.report?.sequence === sequence)
+            this.report = undefined;
+    }
+    expireReportSource() {
+        if (this.report) {
+            const discarded = this.report.histograms.reduce((sum, row) => sum + row.count, 0);
+            this.all.dropped += discarded;
+            this.delta.dropped += discarded + this.report.dropped;
+        }
+        this.report = undefined;
+        this.sourceId = id();
+        this.sequence = 0;
+    }
+    mergeReport(authenticatedSource, report) {
+        const identity = `${authenticatedSource}:${report.sourceId}`;
+        const previous = this.reporters.get(identity);
+        if (previous && report.sequence <= previous.sequence)
+            return { accepted: true, duplicate: true };
+        if (!previous && report.sequence !== 1)
+            return { accepted: false, reason: 'source-expired' };
+        if (previous && report.sequence !== previous.sequence + 1)
+            return { accepted: false, reason: 'sequence-gap' };
+        if (report.histograms.some((row) => {
+            const bounds = HISTOGRAM_METRICS[row.name];
+            return (!bounds ||
+                row.buckets.length !== bounds.length + 1 ||
+                row.buckets.at(-1) !== row.count ||
+                row.buckets.some((n, i) => !Number.isFinite(n) || n < 0 || (i > 0 && n < row.buckets[i - 1])) ||
+                !Number.isFinite(row.sum) ||
+                row.sum < 0 ||
+                !Number.isFinite(row.max) ||
+                row.max < 0);
+        }))
+            return { accepted: false, reason: 'invalid-report' };
+        if (this.reporters.size >= MAX_REPORTERS && !previous) {
+            const oldest = this.reporters.keys().next().value;
+            if (oldest !== undefined)
+                this.reporters.delete(oldest);
+        }
+        const ordinal = previous?.ordinal ?? ++this.reporterOrdinal;
+        const checkpoint = {
+            sequence: report.sequence,
+            ordinal,
+            window: {
+                id: `p${ordinal}`,
+                side: report.side,
+                startedAtMs: report.startedAtMs,
+                observedAtMs: report.observedAtMs,
+                receivedAtMs: Date.now(),
+            },
+        };
+        this.reporters.delete(identity);
+        this.reporters.set(identity, checkpoint);
+        for (const row of report.histograms) {
+            const labels = this.labels({ ...row.labels, side: report.side }), identity = key(row.name, labels);
+            let target = this.all.histograms.get(identity);
+            if (!target) {
+                if (this.all.histograms.size + this.all.counters.size >= MAX_SERIES) {
+                    this.all.dropped += row.count;
+                    continue;
+                }
+                target = {
+                    name: row.name,
+                    labels,
+                    bins: row.buckets.map(() => 0),
+                    count: 0,
+                    sum: 0,
+                    max: 0,
+                };
+                this.all.histograms.set(identity, target);
+            }
+            let previous = 0;
+            row.buckets.forEach((count, i) => {
+                target.bins[i] += count - previous;
+                previous = count;
+            });
+            target.count += row.count;
+            target.sum += row.sum;
+            target.max = Math.max(target.max, row.max);
+        }
+        for (const row of report.counters)
+            this.increment(row.name, { ...row.labels, side: report.side }, row.value);
+        for (const row of report.gauges) {
+            const labels = this.labels({
+                ...row.labels,
+                side: report.side,
+                query: `p${checkpoint.ordinal}_${row.labels.query ?? 'all'}`,
+            });
+            if (this.reportedGauges.size >= MAX_QUERIES &&
+                !this.reportedGauges.has(key(row.name, labels))) {
+                const oldest = this.reportedGauges.keys().next().value;
+                if (oldest !== undefined)
+                    this.reportedGauges.delete(oldest);
+            }
+            this.reportedGauges.set(key(row.name, labels), {
+                gauge: { ...row, labels },
+                expires: Date.now() + 60000,
+            });
+        }
+        this.all.dropped += report.dropped;
+        return { accepted: true };
+    }
+}
+export async function measureClientRequest(metrics, method, actionClass, request) {
+    const epoch = metrics.epoch;
+    const started = metrics.clock();
+    let bytes;
+    let failed = false;
+    try {
+        return await request((value) => {
+            bytes = value;
+        });
+    }
+    catch (error) {
+        failed = true;
+        throw error;
+    }
+    finally {
+        if (epoch === metrics.epoch) {
+            const labels = { method, action_class: actionClass };
+            metrics.observe('farmslot_rpc_duration_seconds', labels, metrics.clock() - started);
+            if (bytes !== undefined)
+                metrics.observe('farmslot_rpc_response_bytes', labels, bytes);
+            if (failed)
+                metrics.increment('farmslot_rpc_errors_total', labels);
+        }
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/performance/recorder.js.map

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

package/dist/performance/types.d.ts

@@ -0,0 +1,93 @@
+export declare const PERFORMANCE_BUDGETS: {
+    readonly 'cached-paint': 0.1;
+    readonly 'interactive-read': 0.25;
+    readonly 'gate-action': 2;
+    readonly 'background-refresh': 5;
+};
+export type PerformanceActionClass = keyof typeof PERFORMANCE_BUDGETS;
+export type PerformanceSide = 'gateway' | 'command-center' | 'companion' | 'cli';
+export type ClientPerformanceSide = Exclude<PerformanceSide, 'gateway'>;
+export type ExecutionKind = 'git' | 'tmux' | 'ssh' | 'node' | 'shell' | 'other';
+export declare const DURATION_BUCKETS: number[];
+export declare const BYTE_BUCKETS: number[];
+export declare const AGE_BUCKETS: number[];
+export declare const HISTOGRAM_METRICS: {
+    readonly farmslot_rpc_duration_seconds: number[];
+    readonly farmslot_rpc_response_bytes: number[];
+    readonly farmslot_event_loop_lag_seconds: number[];
+    readonly farmslot_client_cached_paint_seconds: number[];
+    readonly farmslot_client_visible_read_seconds: number[];
+    readonly farmslot_client_background_refresh_seconds: number[];
+    readonly farmslot_client_blocking_refresh_seconds: number[];
+    readonly farmslot_client_cache_age_seconds: number[];
+};
+export declare const COUNTER_METRICS: readonly ["farmslot_rpc_errors_total", "farmslot_exec_calls_total", "farmslot_exec_seconds_total", "farmslot_node_calls_total", "farmslot_node_seconds_total", "farmslot_node_wait_seconds_total", "farmslot_client_cache_reads_total", "farmslot_client_stale_reads_total", "farmslot_client_blocking_reads_total", "farmslot_client_unknown_age_total", "farmslot_client_unmeasured_paints_total", "farmslot_client_report_failures_total"];
+export declare const GAUGE_METRICS: readonly ["farmslot_client_rereads_per_minute"];
+export type PerformanceHistogramName = keyof typeof HISTOGRAM_METRICS;
+export type PerformanceCounterName = (typeof COUNTER_METRICS)[number];
+export type PerformanceGaugeName = (typeof GAUGE_METRICS)[number];
+export interface PerformanceLabels {
+    method?: string;
+    side?: PerformanceSide;
+    action_class?: PerformanceActionClass;
+    kind?: ExecutionKind;
+    cache_source?: 'memory' | 'stored' | 'network' | 'unknown';
+    query?: string;
+}
+export interface PerformanceHistogram {
+    name: PerformanceHistogramName;
+    labels: PerformanceLabels;
+    buckets: number[];
+    count: number;
+    sum: number;
+    max: number;
+}
+export interface PerformanceCounter {
+    name: PerformanceCounterName;
+    labels: PerformanceLabels;
+    value: number;
+}
+export interface PerformanceGauge {
+    name: PerformanceGaugeName;
+    labels: PerformanceLabels;
+    value: number;
+}
+export interface ClientPerformanceWindow {
+    id: string;
+    side: ClientPerformanceSide;
+    startedAtMs: number;
+    observedAtMs: number;
+    receivedAtMs: number;
+}
+export interface PerformanceSnapshot {
+    clientWindows?: ClientPerformanceWindow[];
+    version: 1;
+    startedAtMs: number;
+    observedAtMs: number;
+    histograms: PerformanceHistogram[];
+    counters: PerformanceCounter[];
+    gauges: PerformanceGauge[];
+    dropped: number;
+}
+export interface ClientPerformanceReport extends PerformanceSnapshot {
+    sourceId: string;
+    sequence: number;
+    side: ClientPerformanceSide;
+}
+export interface ClientPerformanceReportResult {
+    accepted: boolean;
+    duplicate?: boolean;
+    reason?: 'source-expired' | 'sequence-gap' | 'invalid-report';
+}
+export interface PerformanceBudgetVerdict {
+    metric: PerformanceHistogramName;
+    cacheSource?: PerformanceLabels['cache_source'];
+    method?: string;
+    actionClass: PerformanceActionClass;
+    source: string;
+    count: number;
+    withinBudget: number;
+    budgetSeconds: number;
+    status: 'pass' | 'fail' | 'unmeasured';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/performance/types.d.ts.map

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

package/dist/performance/types.js

@@ -0,0 +1,40 @@
+export const PERFORMANCE_BUDGETS = {
+    'cached-paint': 0.1,
+    'interactive-read': 0.25,
+    'gate-action': 2,
+    'background-refresh': 5,
+};
+export const DURATION_BUCKETS = [
+    0.001, 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.15, 0.25, 0.5, 1, 2, 5, 10, 20, 30, 60, 120, 180,
+    300, 600, 3600,
+];
+export const BYTE_BUCKETS = [
+    0, 1024, 4096, 16384, 65536, 131072, 262144, 524288, 1048576, 2097152, 4194304, 8388608, 16777216,
+];
+export const AGE_BUCKETS = [1, 5, 10, 30, 60, 300, 900, 3600, 21600, 86400, 604800];
+export const HISTOGRAM_METRICS = {
+    farmslot_rpc_duration_seconds: DURATION_BUCKETS,
+    farmslot_rpc_response_bytes: BYTE_BUCKETS,
+    farmslot_event_loop_lag_seconds: DURATION_BUCKETS,
+    farmslot_client_cached_paint_seconds: DURATION_BUCKETS,
+    farmslot_client_visible_read_seconds: DURATION_BUCKETS,
+    farmslot_client_background_refresh_seconds: DURATION_BUCKETS,
+    farmslot_client_blocking_refresh_seconds: DURATION_BUCKETS,
+    farmslot_client_cache_age_seconds: AGE_BUCKETS,
+};
+export const COUNTER_METRICS = [
+    'farmslot_rpc_errors_total',
+    'farmslot_exec_calls_total',
+    'farmslot_exec_seconds_total',
+    'farmslot_node_calls_total',
+    'farmslot_node_seconds_total',
+    'farmslot_node_wait_seconds_total',
+    'farmslot_client_cache_reads_total',
+    'farmslot_client_stale_reads_total',
+    'farmslot_client_blocking_reads_total',
+    'farmslot_client_unknown_age_total',
+    'farmslot_client_unmeasured_paints_total',
+    'farmslot_client_report_failures_total',
+];
+export const GAUGE_METRICS = ['farmslot_client_rereads_per_minute'];
+//# sourceMappingURL=types.js.map

package/dist/performance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/performance/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,cAAc,EAAE,GAAG;IACnB,kBAAkB,EAAE,IAAI;IACxB,aAAa,EAAE,CAAC;IAChB,oBAAoB,EAAE,CAAC;CACf,CAAC;AAKX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG;IAC/F,GAAG,EAAE,GAAG,EAAE,IAAI;CACf,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ;CAClG,CAAC;AACF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,6BAA6B,EAAE,gBAAgB;IAC/C,2BAA2B,EAAE,YAAY;IACzC,+BAA+B,EAAE,gBAAgB;IACjD,oCAAoC,EAAE,gBAAgB;IACtD,oCAAoC,EAAE,gBAAgB;IACtD,0CAA0C,EAAE,gBAAgB;IAC5D,wCAAwC,EAAE,gBAAgB;IAC1D,iCAAiC,EAAE,WAAW;CACtC,CAAC;AACX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,2BAA2B;IAC3B,6BAA6B;IAC7B,2BAA2B;IAC3B,6BAA6B;IAC7B,kCAAkC;IAClC,mCAAmC;IACnC,mCAAmC;IACnC,sCAAsC;IACtC,mCAAmC;IACnC,yCAAyC;IACzC,uCAAuC;CAC/B,CAAC;AACX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,oCAAoC,CAAU,CAAC"}

package/dist/performance/validation.d.ts

@@ -0,0 +1,3 @@
+import { type ClientPerformanceReport } from './types.js';
+export declare function isClientPerformanceReport(v: unknown): v is ClientPerformanceReport;
+//# sourceMappingURL=validation.d.ts.map

package/dist/performance/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/performance/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAI7B,MAAM,YAAY,CAAC;AAiCpB,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,uBAAuB,CA8ClF"}

package/dist/performance/validation.js

@@ -0,0 +1,55 @@
+import { COUNTER_METRICS, GAUGE_METRICS, HISTOGRAM_METRICS, } from './types.js';
+const object = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const number = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0;
+const integer = (v) => number(v) && Number.isSafeInteger(v);
+const bounded = (v) => typeof v === 'string' && /^[a-zA-Z0-9_.-]{1,80}$/.test(v);
+function labels(v) {
+    if (!object(v) ||
+        Object.keys(v).some((k) => !['method', 'side', 'action_class', 'kind', 'cache_source', 'query'].includes(k)))
+        return false;
+    return Object.entries(v).every(([k, x]) => x === undefined ||
+        (k === 'side'
+            ? ['command-center', 'companion', 'cli'].includes(String(x))
+            : k === 'action_class'
+                ? ['cached-paint', 'interactive-read', 'gate-action', 'background-refresh'].includes(String(x))
+                : k === 'kind'
+                    ? ['git', 'tmux', 'ssh', 'node', 'shell', 'other'].includes(String(x))
+                    : k === 'cache_source'
+                        ? ['memory', 'stored', 'network', 'unknown'].includes(String(x))
+                        : k === 'query'
+                            ? typeof x === 'string' && /^q[0-9]+$/.test(x)
+                            : bounded(x)));
+}
+export function isClientPerformanceReport(v) {
+    if (!object(v) ||
+        v.version !== 1 ||
+        !bounded(v.sourceId) ||
+        !integer(v.sequence) ||
+        v.sequence < 1 ||
+        !['command-center', 'companion', 'cli'].includes(String(v.side)) ||
+        !number(v.startedAtMs) ||
+        !number(v.observedAtMs) ||
+        !integer(v.dropped))
+        return false;
+    if (!Array.isArray(v.histograms) ||
+        !Array.isArray(v.counters) ||
+        !Array.isArray(v.gauges) ||
+        v.histograms.length + v.counters.length > 128 ||
+        v.gauges.length > 128)
+        return false;
+    return (v.histograms.every((r) => object(r) &&
+        typeof r.name === 'string' &&
+        Object.hasOwn(HISTOGRAM_METRICS, r.name) &&
+        labels(r.labels) &&
+        integer(r.count) &&
+        number(r.sum) &&
+        number(r.max) &&
+        Array.isArray(r.buckets) &&
+        r.buckets.every(integer)) &&
+        v.counters.every((r) => object(r) &&
+            COUNTER_METRICS.some((n) => n === r.name) &&
+            labels(r.labels) &&
+            number(r.value)) &&
+        v.gauges.every((r) => object(r) && GAUGE_METRICS.some((n) => n === r.name) && labels(r.labels) && number(r.value)));
+}
+//# sourceMappingURL=validation.js.map

package/dist/performance/validation.js.map

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

package/dist/recipes/step-io.d.ts

@@ -122,6 +122,8 @@ export interface MonitorSnapshot {
  *  Enables per-step cost tracking and model comparison across runs.
  *  Populated by callLLM() wrapper when it exists; manual until then. */
 export interface StepLLMUsage {
+    /** Shared pipeline receipt, also returned when no run owns the helper call. */
+    sessionUsage?: import('../contracts/runs.js').RunnerSessionUsage;
     provider: string;
     model: string;
     inputTokens?: number;