@farmslot/protocol 0.76.0 → 0.77.0

package/dist/index.js

@@ -55,9 +55,12 @@ export * from './sources/status-view.js';
 export * from './sources/validation.js';
 export * from './surfaces/account-session.js';
 export * from './surfaces/command-center.js';
+export * from './surfaces/run-view-state.js';
+export * from './surfaces/view-state.js';
 export * from './text-order.js';
 export * from './transport/events.js';
 export * from './transport/frames.js';
+export * from './transport/gateway-recovery.js';
 export * from './transport/gateway-tls.js';
 export * from './transport/observations.js';
 export * from './transport/signal.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,cAAc,oCAAoC,CAAC"}

package/dist/performance/client.d.ts

@@ -0,0 +1,18 @@
+import { PerformanceRecorder } from './recorder.js';
+import type { ClientPerformanceReportResult, PerformanceActionClass } from './types.js';
+export declare function performanceActionClass(method: string): PerformanceActionClass;
+export declare function isPerformanceMethod(method: string): boolean;
+export declare class PerformanceReporter {
+    private metrics;
+    private ready;
+    private send;
+    private timer;
+    private disposed;
+    private timerEpoch;
+    private readonly stopActivity;
+    constructor(metrics: PerformanceRecorder, ready: () => boolean, send: (report: unknown) => Promise<ClientPerformanceReportResult>);
+    schedule(): void;
+    private flush;
+    dispose(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/performance/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAExF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAE7E;AACD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI3D;AACD,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,IAAI;IAPd,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;gBAEhC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,OAAO,EACpB,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,6BAA6B,CAAC;IAI3E,QAAQ,IAAI,IAAI;YAgBF,KAAK;IAgBnB,OAAO,IAAI,IAAI;CAMhB"}

package/dist/performance/client.js

@@ -0,0 +1,66 @@
+import { GATEWAY_COMMAND_METHODS } from '../client-cache/command-method.js';
+import { Methods } from '../rpc/registry.js';
+const commands = new Set(GATEWAY_COMMAND_METHODS);
+export function performanceActionClass(method) {
+    return commands.has(method) ? 'gate-action' : 'interactive-read';
+}
+export function isPerformanceMethod(method) {
+    return (method === Methods.GATEWAY_PERFORMANCE_GET || method === Methods.GATEWAY_PERFORMANCE_REPORT);
+}
+export class PerformanceReporter {
+    constructor(metrics, ready, send) {
+        this.metrics = metrics;
+        this.ready = ready;
+        this.send = send;
+        this.disposed = false;
+        this.timerEpoch = 0;
+        this.stopActivity = metrics.onActivity(() => this.schedule());
+    }
+    schedule() {
+        if (this.timer && this.timerEpoch !== this.metrics.epoch) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        if (this.disposed || this.timer || !this.ready())
+            return;
+        this.timerEpoch = this.metrics.epoch;
+        const epoch = this.metrics.epoch;
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            if (!this.ready() || epoch !== this.metrics.epoch)
+                return;
+            void this.flush();
+        }, 30000);
+        // Node-based CLI/tests do not stay alive for a telemetry flush.
+        if (typeof this.timer === 'object' && 'unref' in this.timer)
+            this.timer.unref();
+    }
+    async flush() {
+        const epoch = this.metrics.epoch, report = this.metrics.beginReport();
+        if (!report)
+            return;
+        try {
+            const result = await this.send(report);
+            if (epoch !== this.metrics.epoch)
+                return;
+            if (result.accepted)
+                this.metrics.acknowledge(report.sequence);
+            else
+                this.metrics.expireReportSource();
+        }
+        catch {
+            // Preserve the identical chunk for an idempotent retry after a lost response.
+            if (epoch === this.metrics.epoch)
+                this.metrics.increment('farmslot_client_report_failures_total', {});
+        }
+        if (epoch === this.metrics.epoch)
+            this.schedule();
+    }
+    dispose() {
+        this.disposed = true;
+        this.stopActivity();
+        clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/performance/client.js.map

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

package/dist/performance/histogram.d.ts

@@ -0,0 +1,5 @@
+import { type PerformanceBudgetVerdict, type PerformanceHistogram, type PerformanceSnapshot } from './types.js';
+/** UI estimate only. Budget verdicts use the exact threshold bucket. */
+export declare function histogramPercentile(histogram: PerformanceHistogram, quantile: number): number;
+export declare function performanceBudgetVerdicts(snapshot: PerformanceSnapshot): PerformanceBudgetVerdict[];
+//# sourceMappingURL=histogram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../../src/performance/histogram.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM7F;AACD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,GAC5B,wBAAwB,EAAE,CA+B5B"}

package/dist/performance/histogram.js

@@ -0,0 +1,38 @@
+import { HISTOGRAM_METRICS, PERFORMANCE_BUDGETS, } from './types.js';
+/** UI estimate only. Budget verdicts use the exact threshold bucket. */
+export function histogramPercentile(histogram, quantile) {
+    if (!histogram.count)
+        return 0;
+    const index = histogram.buckets.findIndex((count) => count >= Math.ceil(histogram.count * quantile));
+    return HISTOGRAM_METRICS[histogram.name][index] ?? histogram.max;
+}
+export function performanceBudgetVerdicts(snapshot) {
+    return snapshot.histograms.flatMap((histogram) => {
+        const actionClass = histogram.labels.action_class;
+        if (!actionClass ||
+            histogram.name.endsWith('_bytes') ||
+            histogram.name.endsWith('_age_seconds'))
+            return [];
+        const budgetSeconds = PERFORMANCE_BUDGETS[actionClass];
+        const index = HISTOGRAM_METRICS[histogram.name].findIndex((value) => value === budgetSeconds);
+        const withinBudget = histogram.buckets[index] ?? 0;
+        return [
+            {
+                metric: histogram.name,
+                cacheSource: histogram.labels.cache_source,
+                method: histogram.labels.method,
+                actionClass,
+                source: histogram.labels.side ?? 'unknown',
+                count: histogram.count,
+                withinBudget,
+                budgetSeconds,
+                status: histogram.count < 20 || snapshot.dropped > 0
+                    ? 'unmeasured'
+                    : withinBudget * 20 >= histogram.count * 19
+                        ? 'pass'
+                        : 'fail',
+            },
+        ];
+    });
+}
+//# sourceMappingURL=histogram.js.map

package/dist/performance/histogram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.js","sourceRoot":"","sources":["../../src/performance/histogram.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GAIpB,MAAM,YAAY,CAAC;AAEpB,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,SAA+B,EAAE,QAAgB;IACnF,IAAI,CAAC,SAAS,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CACvC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,QAAQ,CAAC,CAC1D,CAAC;IACF,OAAO,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC;AACnE,CAAC;AACD,MAAM,UAAU,yBAAyB,CACvC,QAA6B;IAE7B,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/C,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC;QAClD,IACE,CAAC,WAAW;YACZ,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACjC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;YAEvC,OAAO,EAAE,CAAC;QACZ,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC;QAC9F,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO;YACL;gBACE,MAAM,EAAE,SAAS,CAAC,IAAI;gBACtB,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,YAAY;gBAC1C,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;gBAC/B,WAAW;gBACX,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,SAAS;gBAC1C,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,YAAY;gBACZ,aAAa;gBACb,MAAM,EACJ,SAAS,CAAC,KAAK,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,GAAG,CAAC;oBAC1C,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,YAAY,GAAG,EAAE,IAAI,SAAS,CAAC,KAAK,GAAG,EAAE;wBACzC,CAAC,CAAC,MAAM;wBACR,CAAC,CAAC,MAAM;aACf;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/performance/index.d.ts

@@ -0,0 +1,10 @@
+export * from '../utf8-byte-length.js';
+export * from './client.js';
+export * from './histogram.js';
+export * from './paint.js';
+export * from './prometheus.js';
+export * from './ranking.js';
+export * from './recorder.js';
+export * from './types.js';
+export * from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/performance/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/performance/index.js

@@ -0,0 +1,10 @@
+export * from '../utf8-byte-length.js';
+export * from './client.js';
+export * from './histogram.js';
+export * from './paint.js';
+export * from './prometheus.js';
+export * from './ranking.js';
+export * from './recorder.js';
+export * from './types.js';
+export * from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/performance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/performance/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/performance/paint.d.ts

@@ -0,0 +1,3 @@
+/** Two frames allow the subscriber's queued render and its first data paint. */
+export declare function afterForegroundPaint(callback: () => void): (() => void) | undefined;
+//# sourceMappingURL=paint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/performance/paint.ts"],"names":[],"mappings":"AAKA,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAcnF"}

package/dist/performance/paint.js

@@ -0,0 +1,14 @@
+/** Two frames allow the subscriber's queued render and its first data paint. */
+export function afterForegroundPaint(callback) {
+    const host = globalThis;
+    if (!host.requestAnimationFrame ||
+        !host.cancelAnimationFrame ||
+        (host.document && host.document.visibilityState !== 'visible'))
+        return undefined;
+    const frame = host.requestAnimationFrame.bind(host), cancel = host.cancelAnimationFrame.bind(host);
+    let handle = frame(() => {
+        handle = frame(callback);
+    });
+    return () => cancel(handle);
+}
+//# sourceMappingURL=paint.js.map

package/dist/performance/paint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.js","sourceRoot":"","sources":["../../src/performance/paint.ts"],"names":[],"mappings":"AAKA,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,QAAoB;IACvD,MAAM,IAAI,GAAG,UAAuB,CAAC;IACrC,IACE,CAAC,IAAI,CAAC,qBAAqB;QAC3B,CAAC,IAAI,CAAC,oBAAoB;QAC1B,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS,CAAC;QAE9D,OAAO,SAAS,CAAC;IACnB,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EACjD,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE;QACtB,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/performance/prometheus.d.ts

@@ -0,0 +1,3 @@
+import { type PerformanceSnapshot } from './types.js';
+export declare function renderPrometheus(snapshot: PerformanceSnapshot): string;
+//# sourceMappingURL=prometheus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.d.ts","sourceRoot":"","sources":["../../src/performance/prometheus.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAcjG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CA4CtE"}

package/dist/performance/prometheus.js

@@ -0,0 +1,53 @@
+import { HISTOGRAM_METRICS } from './types.js';
+function escapeLabel(value) {
+    return value.replaceAll('\\', '\\\\').replaceAll('\n', '\\n').replaceAll('"', '\\"');
+}
+function labels(value, bound) {
+    const pairs = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => `${k}="${escapeLabel(String(v))}"`);
+    if (bound !== undefined)
+        pairs.push(`le="${bound}"`);
+    return pairs.length ? `{${pairs.join(',')}}` : '';
+}
+export function renderPrometheus(snapshot) {
+    const output = [];
+    const declared = new Set();
+    function type(name, kind) {
+        if (!declared.has(name)) {
+            declared.add(name);
+            output.push(`# TYPE ${name} ${kind}`);
+        }
+    }
+    for (const row of snapshot.histograms) {
+        type(row.name, 'histogram');
+        const bounds = HISTOGRAM_METRICS[row.name];
+        row.buckets.forEach((count, i) => output.push(`${row.name}_bucket${labels(row.labels, String(bounds[i] ?? '+Inf'))} ${count}`));
+        output.push(`${row.name}_count${labels(row.labels)} ${row.count}`, `${row.name}_sum${labels(row.labels)} ${row.sum}`);
+        type(`${row.name}_max`, 'gauge');
+        output.push(`${row.name}_max${labels(row.labels)} ${row.max}`);
+    }
+    for (const row of snapshot.counters) {
+        type(row.name, 'counter');
+        output.push(`${row.name}${labels(row.labels)} ${row.value}`);
+    }
+    for (const row of snapshot.gauges) {
+        type(row.name, 'gauge');
+        output.push(`${row.name}${labels(row.labels)} ${row.value}`);
+    }
+    for (const window of snapshot.clientWindows ?? []) {
+        const source = labels({ side: window.side, source: window.id });
+        for (const [name, value] of [
+            ['farmslot_client_window_start_seconds', window.startedAtMs],
+            ['farmslot_client_window_observed_seconds', window.observedAtMs],
+            ['farmslot_client_window_received_seconds', window.receivedAtMs],
+        ]) {
+            type(name, 'gauge');
+            output.push(`${name}${source} ${value / 1000}`);
+        }
+    }
+    type('farmslot_metrics_dropped_total', 'counter');
+    output.push(`farmslot_metrics_dropped_total ${snapshot.dropped}`);
+    return output.join('\n') + '\n';
+}
+//# sourceMappingURL=prometheus.js.map

package/dist/performance/prometheus.js.map

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

package/dist/performance/ranking.d.ts

@@ -0,0 +1,26 @@
+import type { PerformanceActionClass, PerformanceLabels, PerformanceSide, PerformanceSnapshot } from './types.js';
+export interface SlowAction {
+    cacheSource?: PerformanceLabels['cache_source'];
+    phase: string;
+    bytesMeasured: boolean;
+    budgetSeconds?: number;
+    budgetStatus?: string;
+    processesMeasured: boolean;
+    method: string;
+    side: PerformanceSide;
+    actionClass?: PerformanceActionClass;
+    count: number;
+    p50: number;
+    p95: number;
+    max: number;
+    bytes: number;
+    execCount: number;
+    execSeconds: number;
+    nodeCount: number;
+    nodeSeconds: number;
+    nodeWaitSeconds: number;
+    loopLagSeconds: number;
+    causes: string[];
+}
+export declare function slowestActions(snapshot: PerformanceSnapshot): SlowAction[];
+//# sourceMappingURL=ranking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../../src/performance/ranking.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AACD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,UAAU,EAAE,CAmG1E"}

package/dist/performance/ranking.js

@@ -0,0 +1,92 @@
+import { histogramPercentile, performanceBudgetVerdicts } from './histogram.js';
+export function slowestActions(snapshot) {
+    const costs = new Map();
+    const responseBytes = new Map();
+    const identity = (labels) => `${labels.side ?? 'gateway'}|${labels.method ?? '_unknown'}`;
+    const responseIdentity = (labels) => `${identity(labels)}|${labels.action_class ?? ''}`;
+    const add = (labels, name, value, max = false) => {
+        const key = identity(labels);
+        let values = costs.get(key);
+        if (!values) {
+            values = new Map();
+            costs.set(key, values);
+        }
+        values.set(name, max ? Math.max(values.get(name) ?? 0, value) : (values.get(name) ?? 0) + value);
+    };
+    for (const counter of snapshot.counters)
+        add(counter.labels, counter.name, counter.value);
+    for (const histogram of snapshot.histograms) {
+        if (histogram.name === 'farmslot_rpc_response_bytes')
+            responseBytes.set(responseIdentity(histogram.labels), (responseBytes.get(responseIdentity(histogram.labels)) ?? 0) + histogram.sum);
+        if (histogram.name === 'farmslot_event_loop_lag_seconds')
+            add(histogram.labels, 'lag', histogram.max, true);
+    }
+    const phases = {
+        farmslot_rpc_duration_seconds: 'RPC',
+        farmslot_client_cached_paint_seconds: 'Cached paint',
+        farmslot_client_visible_read_seconds: 'Visible read',
+        farmslot_client_background_refresh_seconds: 'Background refresh',
+        farmslot_client_blocking_refresh_seconds: 'Blocking refresh',
+    };
+    const verdictKey = (name, labels) => [
+        name,
+        labels.side ?? 'gateway',
+        labels.method ?? '_unknown',
+        labels.action_class,
+        labels.cache_source,
+    ].join('|');
+    const verdicts = new Map(performanceBudgetVerdicts(snapshot).map((v) => [
+        [v.metric, v.source, v.method ?? '_unknown', v.actionClass, v.cacheSource].join('|'),
+        v,
+    ]));
+    return snapshot.histograms
+        .filter((r) => Object.hasOwn(phases, r.name))
+        .map((row) => {
+        const phase = phases[row.name];
+        const bytesMeasured = row.name === 'farmslot_rpc_duration_seconds' &&
+            responseBytes.has(responseIdentity(row.labels));
+        const verdict = verdicts.get(verdictKey(row.name, row.labels));
+        const { method = '_unknown', side = 'gateway', action_class } = row.labels;
+        const values = costs.get(identity(row.labels));
+        const value = (name) => values?.get(name) ?? 0;
+        const bytes = bytesMeasured ? (responseBytes.get(responseIdentity(row.labels)) ?? 0) : 0, execCount = value('farmslot_exec_calls_total'), execSeconds = value('farmslot_exec_seconds_total');
+        const nodeCount = value('farmslot_node_calls_total'), nodeSeconds = value('farmslot_node_seconds_total'), nodeWaitSeconds = value('farmslot_node_wait_seconds_total');
+        const loopLagSeconds = value('lag');
+        const causes = [];
+        if (bytes / row.count > 131072)
+            causes.push('payload');
+        if (execCount)
+            causes.push('spawned processes');
+        if (nodeSeconds || nodeWaitSeconds)
+            causes.push('node wait');
+        if (loopLagSeconds > 0.1)
+            causes.push('event-loop stall');
+        if (!causes.length)
+            causes.push(bytesMeasured ? 'inspect handler' : phase);
+        return {
+            cacheSource: row.labels.cache_source,
+            phase,
+            bytesMeasured,
+            budgetSeconds: verdict?.budgetSeconds,
+            budgetStatus: verdict?.status,
+            processesMeasured: side === 'gateway',
+            method,
+            side,
+            actionClass: action_class,
+            count: row.count,
+            p50: histogramPercentile(row, 0.5),
+            p95: histogramPercentile(row, 0.95),
+            max: row.max,
+            bytes,
+            execCount,
+            execSeconds,
+            nodeCount,
+            nodeSeconds,
+            nodeWaitSeconds,
+            loopLagSeconds,
+            causes,
+        };
+    })
+        .sort((a, b) => b.p95 - a.p95 || b.max - a.max);
+}
+//# sourceMappingURL=ranking.js.map

package/dist/performance/ranking.js.map

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

package/dist/performance/recorder.d.ts

@@ -0,0 +1,43 @@
+import { type ClientPerformanceReport, type ClientPerformanceReportResult, type PerformanceActionClass, type PerformanceCounterName, type PerformanceHistogramName, type PerformanceLabels, type PerformanceSide, type PerformanceSnapshot } from './types.js';
+interface RecorderOptions {
+    clock?: () => number;
+    methods?: ReadonlySet<string>;
+}
+export declare class PerformanceRecorder {
+    readonly side: PerformanceSide;
+    readonly clock: () => number;
+    private readonly activity;
+    onActivity(listener: () => void): () => void;
+    private changed;
+    private methods;
+    private startedAtMs;
+    private all;
+    private delta;
+    private sourceId;
+    private sequence;
+    private report?;
+    private reporters;
+    private reporterOrdinal;
+    private rates;
+    private queryOrdinal;
+    private queryIds;
+    private scopeVersion;
+    get epoch(): number;
+    resetScope(): void;
+    private reportedGauges;
+    constructor(side: PerformanceSide, options?: RecorderOptions);
+    private labels;
+    observe(name: PerformanceHistogramName, input: PerformanceLabels, value: number): void;
+    increment(name: PerformanceCounterName, input: PerformanceLabels, value?: number): void;
+    private rotate;
+    reread(method: string, identity: object): void;
+    private snapshotState;
+    snapshot(): PerformanceSnapshot;
+    beginReport(): ClientPerformanceReport | undefined;
+    acknowledge(sequence: number): void;
+    expireReportSource(): void;
+    mergeReport(authenticatedSource: string, report: ClientPerformanceReport): ClientPerformanceReportResult;
+}
+export declare function measureClientRequest<T>(metrics: PerformanceRecorder, method: string, actionClass: PerformanceActionClass, request: (received: (bytes: number) => void) => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/performance/recorder.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAGlC,KAAK,sBAAsB,EAE3B,KAAK,sBAAsB,EAG3B,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAmBpB,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAKD,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI5C,OAAO,CAAC,OAAO;IAGf,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,MAAM,CAAC,CAA0B;IACzC,OAAO,CAAC,SAAS,CAGb;IACJ,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,YAAY,CAAK;IACzB,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,UAAU,IAAI,IAAI;IAWlB,OAAO,CAAC,cAAc,CAAmE;gBAC7E,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,eAAoB;IAKhE,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAqCtF,SAAS,CAAC,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,SAAI,GAAG,IAAI;IAmBlF,OAAO,CAAC,MAAM;IAMd,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqB9C,OAAO,CAAC,aAAa;IAiCrB,QAAQ,IAAI,mBAAmB;IAG/B,WAAW,IAAI,uBAAuB,GAAG,SAAS;IA8BlD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAGnC,kBAAkB,IAAI,IAAI;IAU1B,WAAW,CACT,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,uBAAuB,GAC9B,6BAA6B;CA+FjC;AACD,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,sBAAsB,EACnC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC,CAoBZ"}