@adonis-agora/telescope 0.26.1 → 0.27.0

package/dist/src/ai_metrics/ai_usage.d.ts

@@ -0,0 +1,123 @@
+import type { Entry } from '../entry.js';
+import { type RunStatus, type StepTiming } from './agent_events.js';
+/** One row of a spend breakdown (by feature, model or actor). */
+export interface AiSpendRow {
+    key: string;
+    costUsd: number;
+    calls: number;
+    /** Calls in this group that had no cost. */
+    unpricedCalls: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+/** One time bucket of spend. */
+export interface AiSpendBucket {
+    /** Bucket start, ISO. */
+    start: string;
+    costUsd: number;
+    platformUsd: number;
+    estimatedUsd: number;
+    calls: number;
+}
+/** The spend half of the AI screen. */
+export interface AiSpend {
+    totalUsd: number;
+    /** Paid by the platform (`actorRef === '@platform'`). */
+    platformUsd: number;
+    /** Priced by an estimate rather than the provider's own figure. */
+    estimatedUsd: number;
+    calls: number;
+    unpricedCalls: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    audioSeconds: number;
+    byFeature: AiSpendRow[];
+    byModel: AiSpendRow[];
+    /** Top N payers. `@platform` is the platform itself. */
+    byActor: AiSpendRow[];
+    buckets: AiSpendBucket[];
+}
+/** One agent run, as the runs table shows it. */
+export interface AiRunRow {
+    /** The Telescope entry the run's terminal event was recorded as. */
+    entryId: string;
+    /** The entry's trace — the link to the existing trace/waterfall view; `null` when none. */
+    traceId: string | null;
+    at: string;
+    status: RunStatus;
+    agent: string;
+    runId: string | null;
+    threadId: string | null;
+    modelId: string | null;
+    durationMs: number | null;
+    ttftMs: number | null;
+    queueMs: number | null;
+    modelMs: number | null;
+    toolsMs: number | null;
+    steps: number | null;
+    modelCalls: number | null;
+    toolCalls: number | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    costUsd: number | null;
+    /** Failure slug on a failed run. */
+    code: string | null;
+    stepTimings: StepTiming[];
+}
+/** Calls with no cost, grouped. */
+export interface AiUnpricedRow {
+    feature: string;
+    model: string;
+    provider: string;
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    audioSeconds: number;
+    characters: number;
+    lastAt: string;
+}
+/**
+ * What the window held, so the screen can tell "nothing happened" from "this app's agent lib does
+ * not publish these events yet".
+ */
+export interface AiCoverage {
+    usageEvents: number;
+    runEvents: number;
+    /** Every agent event seen, of any kind (`run.started`, `tool-call`, …). */
+    agentEvents: number;
+    /** Agent events exist but none is `usage.recorded`: the agent lib predates the ledger event. */
+    legacyAgentLib: boolean;
+    /** Runs whose terminal event carried no timing breakdown (queue/model/tools). */
+    runsWithoutTimings: number;
+}
+export interface AiUsageSummary {
+    windowStart: string;
+    windowEnd: string;
+    spend: AiSpend;
+    /** Most recent first. */
+    runs: AiRunRow[];
+    slowest: AiRunRow[];
+    mostExpensive: AiRunRow[];
+    unpriced: AiUnpricedRow[];
+    coverage: AiCoverage;
+}
+export interface SummarizeAiUsageOptions {
+    windowStart: Date;
+    windowEnd: Date;
+    /** Spend time buckets. Default 24. */
+    buckets?: number;
+    /** Rows per breakdown and per runs table. Default 10 for breakdowns, 50 for runs. */
+    top?: number;
+    runsLimit?: number;
+}
+/**
+ * Summarize the agent entries of a window into the AI screen: spend (total, platform and estimated
+ * shares, by feature / model / actor, over time), runs (recent, slowest, most expensive, each with
+ * its step breakdown) and the unpriced calls, from the `diagnostic` entries the generic watcher
+ * records for `agora:agent:*` (see {@link agentEventOfEntry}). Entries outside the window are
+ * ignored. Pure.
+ */
+export declare function summarizeAiUsage(entries: readonly Entry[], options: SummarizeAiUsageOptions): AiUsageSummary;
+//# sourceMappingURL=ai_usage.d.ts.map

package/dist/src/ai_metrics/ai_usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_usage.d.ts","sourceRoot":"","sources":["../../../src/ai_metrics/ai_usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,wDAAwD;IACxD,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oCAAoC;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,cAAc,EAAE,OAAO,CAAC;IACxB,iFAAiF;IACjF,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwDD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,KAAK,EAAE,EACzB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAsJhB"}

package/dist/src/ai_metrics/ai_usage.js

@@ -0,0 +1,207 @@
+import { agentEventOfEntry, readAgentEvent, } from './agent_events.js';
+function emptyRow(key) {
+    return { key, costUsd: 0, calls: 0, unpricedCalls: 0, inputTokens: 0, outputTokens: 0 };
+}
+function addTo(map, key, u) {
+    let row = map.get(key);
+    if (row === undefined) {
+        row = emptyRow(key);
+        map.set(key, row);
+    }
+    row.costUsd += u.costUsd ?? 0;
+    row.calls += u.requests;
+    if (u.costUsd === undefined)
+        row.unpricedCalls += u.requests;
+    row.inputTokens += u.inputTokens;
+    row.outputTokens += u.outputTokens;
+}
+function ranked(map, top) {
+    return [...map.values()]
+        .sort((a, b) => b.costUsd - a.costUsd || b.calls - a.calls || a.key.localeCompare(b.key))
+        .slice(0, top)
+        .map((r) => ({ ...r, costUsd: round(r.costUsd) }));
+}
+function round(value) {
+    return Math.round(value * 1e8) / 1e8;
+}
+function toRunRow(entry, r) {
+    return {
+        entryId: entry.id,
+        traceId: entry.traceId,
+        at: new Date(entry.createdAt).toISOString(),
+        status: r.status,
+        agent: r.agent,
+        runId: r.runId ?? null,
+        threadId: r.threadId ?? null,
+        modelId: r.modelId ?? null,
+        durationMs: r.durationMs ?? null,
+        ttftMs: r.ttftMs ?? null,
+        queueMs: r.queueMs ?? null,
+        modelMs: r.modelMs ?? null,
+        toolsMs: r.toolsMs ?? null,
+        steps: r.steps ?? (r.stepTimings.length > 0 ? r.stepTimings.length : null),
+        modelCalls: r.modelCalls ?? null,
+        toolCalls: r.toolCalls ?? null,
+        inputTokens: r.inputTokens ?? null,
+        outputTokens: r.outputTokens ?? null,
+        costUsd: r.costUsd ?? null,
+        code: r.code ?? null,
+        stepTimings: r.stepTimings,
+    };
+}
+/**
+ * Summarize the agent entries of a window into the AI screen: spend (total, platform and estimated
+ * shares, by feature / model / actor, over time), runs (recent, slowest, most expensive, each with
+ * its step breakdown) and the unpriced calls, from the `diagnostic` entries the generic watcher
+ * records for `agora:agent:*` (see {@link agentEventOfEntry}). Entries outside the window are
+ * ignored. Pure.
+ */
+export function summarizeAiUsage(entries, options) {
+    const start = options.windowStart.getTime();
+    const end = options.windowEnd.getTime();
+    const bucketCount = Math.max(1, Math.min(500, Math.floor(options.buckets ?? 24)));
+    const top = Math.max(1, Math.floor(options.top ?? 10));
+    const runsLimit = Math.max(1, Math.floor(options.runsLimit ?? 50));
+    const bucketMs = Math.max(1, (end - start) / bucketCount);
+    const buckets = Array.from({ length: bucketCount }, (_, i) => ({
+        start: new Date(start + i * bucketMs).toISOString(),
+        costUsd: 0,
+        platformUsd: 0,
+        estimatedUsd: 0,
+        calls: 0,
+    }));
+    const spend = {
+        totalUsd: 0,
+        platformUsd: 0,
+        estimatedUsd: 0,
+        calls: 0,
+        unpricedCalls: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheReadTokens: 0,
+        cacheWriteTokens: 0,
+        audioSeconds: 0,
+        byFeature: [],
+        byModel: [],
+        byActor: [],
+        buckets,
+    };
+    const byFeature = new Map();
+    const byModel = new Map();
+    const byActor = new Map();
+    const unpriced = new Map();
+    const runs = [];
+    const coverage = {
+        usageEvents: 0,
+        runEvents: 0,
+        agentEvents: 0,
+        legacyAgentLib: false,
+        runsWithoutTimings: 0,
+    };
+    for (const entry of entries) {
+        const at = new Date(entry.createdAt).getTime();
+        if (at < start || at > end)
+            continue;
+        const event = agentEventOfEntry(entry);
+        if (event === null)
+            continue;
+        coverage.agentEvents += 1;
+        const observation = readAgentEvent(event.event, event.payload);
+        if (observation === null)
+            continue;
+        if (observation.kind === 'run') {
+            coverage.runEvents += 1;
+            if (observation.queueMs === undefined &&
+                observation.modelMs === undefined &&
+                observation.toolsMs === undefined) {
+                coverage.runsWithoutTimings += 1;
+            }
+            runs.push(toRunRow(entry, observation));
+            continue;
+        }
+        const u = observation;
+        coverage.usageEvents += 1;
+        const cost = u.costUsd ?? 0;
+        spend.totalUsd += cost;
+        if (u.platform)
+            spend.platformUsd += cost;
+        if (u.costSource === 'estimate')
+            spend.estimatedUsd += cost;
+        spend.calls += u.requests;
+        spend.inputTokens += u.inputTokens;
+        spend.outputTokens += u.outputTokens;
+        spend.cacheReadTokens += u.cacheReadTokens;
+        spend.cacheWriteTokens += u.cacheWriteTokens;
+        spend.audioSeconds += u.audioSeconds;
+        addTo(byFeature, u.feature, u);
+        addTo(byModel, u.model, u);
+        addTo(byActor, u.actorRef, u);
+        const bucket = buckets[Math.min(bucketCount - 1, Math.floor((at - start) / bucketMs))];
+        if (bucket !== undefined) {
+            bucket.costUsd += cost;
+            if (u.platform)
+                bucket.platformUsd += cost;
+            if (u.costSource === 'estimate')
+                bucket.estimatedUsd += cost;
+            bucket.calls += u.requests;
+        }
+        if (u.costUsd === undefined) {
+            spend.unpricedCalls += u.requests;
+            const key = `${u.feature}\u0000${u.model}\u0000${u.provider}`;
+            let row = unpriced.get(key);
+            if (row === undefined) {
+                row = {
+                    feature: u.feature,
+                    model: u.model,
+                    provider: u.provider,
+                    calls: 0,
+                    inputTokens: 0,
+                    outputTokens: 0,
+                    audioSeconds: 0,
+                    characters: 0,
+                    lastAt: new Date(at).toISOString(),
+                };
+                unpriced.set(key, row);
+            }
+            row.calls += u.requests;
+            row.inputTokens += u.inputTokens;
+            row.outputTokens += u.outputTokens;
+            row.audioSeconds += u.audioSeconds;
+            row.characters += u.characters;
+            if (new Date(at).toISOString() > row.lastAt)
+                row.lastAt = new Date(at).toISOString();
+        }
+    }
+    coverage.legacyAgentLib = coverage.agentEvents > 0 && coverage.usageEvents === 0;
+    spend.totalUsd = round(spend.totalUsd);
+    spend.platformUsd = round(spend.platformUsd);
+    spend.estimatedUsd = round(spend.estimatedUsd);
+    spend.byFeature = ranked(byFeature, top);
+    spend.byModel = ranked(byModel, top);
+    spend.byActor = ranked(byActor, top);
+    for (const b of buckets) {
+        b.costUsd = round(b.costUsd);
+        b.platformUsd = round(b.platformUsd);
+        b.estimatedUsd = round(b.estimatedUsd);
+    }
+    runs.sort((a, b) => b.at.localeCompare(a.at));
+    const slowest = runs
+        .filter((r) => r.durationMs !== null)
+        .sort((a, b) => (b.durationMs ?? 0) - (a.durationMs ?? 0))
+        .slice(0, 5);
+    const mostExpensive = runs
+        .filter((r) => r.costUsd !== null && r.costUsd > 0)
+        .sort((a, b) => (b.costUsd ?? 0) - (a.costUsd ?? 0))
+        .slice(0, 5);
+    return {
+        windowStart: options.windowStart.toISOString(),
+        windowEnd: options.windowEnd.toISOString(),
+        spend,
+        runs: runs.slice(0, runsLimit),
+        slowest,
+        mostExpensive,
+        unpriced: [...unpriced.values()].sort((a, b) => b.calls - a.calls),
+        coverage,
+    };
+}
+//# sourceMappingURL=ai_usage.js.map

package/dist/src/ai_metrics/ai_usage.js.map

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

package/dist/src/ai_metrics/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AI usage and agent run observability: pure readers for the `agora:agent:*` events, the metric
+ * table both exporters (Prometheus scrape, OTLP) read, the in-process Prometheus registry, and the
+ * AI screen's summarizer. The OTLP exporter (`otel_metrics_exporter.ts`) is intentionally NOT
+ * re-exported: it is loaded lazily by the provider so importing this never pulls in OTel.
+ */
+export { AGENT_CHANNEL_PREFIX, AGENT_METRIC_EVENTS, type AgentMetricEvent, type AgentObservation, agentEventOfEntry, type CostSource, PLATFORM_ACTOR_REF, type RunObservation, type RunStatus, readAgentEvent, readRun, readUsage, type StepTiming, type ToolTiming, type UsageObservation, } from './agent_events.js';
+export { AGENT_METRIC_BUCKETS_MS, AGENT_METRICS, type AgentMetricKey, AgentMetricsRegistry, type AgentMetricsRegistryOptions, agentMetricPoints, type MetricAttributes, type MetricPoint, } from './agent_metrics.js';
+export { type AiCoverage, type AiRunRow, type AiSpend, type AiSpendBucket, type AiSpendRow, type AiUnpricedRow, type AiUsageSummary, type SummarizeAiUsageOptions, summarizeAiUsage, } from './ai_usage.js';
+export { type AgentObservationListener, subscribeAgentObservations } from './subscribe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/ai_metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai_metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,KAAK,UAAU,EACf,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,cAAc,EACd,OAAO,EACP,SAAS,EACT,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/ai_metrics/index.js

@@ -0,0 +1,11 @@
+/**
+ * AI usage and agent run observability: pure readers for the `agora:agent:*` events, the metric
+ * table both exporters (Prometheus scrape, OTLP) read, the in-process Prometheus registry, and the
+ * AI screen's summarizer. The OTLP exporter (`otel_metrics_exporter.ts`) is intentionally NOT
+ * re-exported: it is loaded lazily by the provider so importing this never pulls in OTel.
+ */
+export { AGENT_CHANNEL_PREFIX, AGENT_METRIC_EVENTS, agentEventOfEntry, PLATFORM_ACTOR_REF, readAgentEvent, readRun, readUsage, } from './agent_events.js';
+export { AGENT_METRIC_BUCKETS_MS, AGENT_METRICS, AgentMetricsRegistry, agentMetricPoints, } from './agent_metrics.js';
+export { summarizeAiUsage, } from './ai_usage.js';
+export { subscribeAgentObservations } from './subscribe.js';
+//# sourceMappingURL=index.js.map

package/dist/src/ai_metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai_metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EAGnB,iBAAiB,EAEjB,kBAAkB,EAGlB,cAAc,EACd,OAAO,EACP,SAAS,GAIV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,aAAa,EAEb,oBAAoB,EAEpB,iBAAiB,GAGlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EASL,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAiC,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/ai_metrics/otel_metrics_exporter.d.ts

@@ -0,0 +1,60 @@
+import type { Counter, Histogram } from '@opentelemetry/api';
+import type { ResolvedOtelMetricsConfig } from '../define_config.js';
+import type { AgentObservation } from './agent_events.js';
+/**
+ * The OTLP METRICS signal: the AI-usage and agent-run instruments of {@link AGENT_METRICS}, pushed
+ * over OTLP/HTTP by a periodic reader.
+ *
+ * Loaded ONLY through the dynamic `import()` in `telescope_provider.ts`, and only when
+ * `otel.metrics.enabled` is `true`; the `@opentelemetry/*` metrics packages are imported lazily
+ * inside {@link loadOtelMetricsSdk}, so a host that never opts in never needs them installed.
+ *
+ * Like the traces/logs bridge it owns a PRIVATE `MeterProvider` and never calls
+ * `metrics.setGlobalMeterProvider`, so it cannot clash with a host's own OTel setup.
+ *
+ * Fed from the `agora:agent:*` diagnostics channels directly (see `subscribe.ts`), not from stored
+ * entries: sampling, retention and the overload guard never change a count.
+ *
+ * Instruments are created with an EMPTY unit on purpose (the unit is in the name): Prometheus'
+ * OTLP translation appends a unit suffix (`ms` → `_milliseconds`), which would make a metric read
+ * `agora_agent_run_duration_ms_milliseconds` through a Collector but `agora_agent_run_duration_ms`
+ * from the scrape endpoint. With no unit both paths expose the same series, so one Grafana
+ * dashboard serves both.
+ */
+/** The meter-provider surface this exporter uses. */
+export interface MeterProviderLike {
+    getMeter(name: string): {
+        createCounter(name: string, options?: {
+            description?: string;
+            unit?: string;
+        }): Counter;
+        createHistogram(name: string, options?: {
+            description?: string;
+            unit?: string;
+            advice?: {
+                explicitBucketBoundaries?: number[];
+            };
+        }): Histogram;
+    };
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/** Builds the provider from the resolved config. Injectable for tests. */
+export type MeterProviderFactory = (config: ResolvedOtelMetricsConfig) => Promise<MeterProviderLike>;
+/** Import the OTel metrics SDK and build a provider exporting to `config.url`. */
+export declare const loadOtelMetricsSdk: MeterProviderFactory;
+/** A running OTLP metrics export; stop it with {@link OtelMetricsExporter.shutdown}. */
+export interface OtelMetricsExporter {
+    /** Record one observation (exposed for tests and for hosts that read the events themselves). */
+    observe(observation: AgentObservation): void;
+    /** Push whatever is pending now. */
+    flush(): Promise<void>;
+    /** Unsubscribe, flush the tail and shut the provider down. */
+    shutdown(): Promise<void>;
+}
+/**
+ * Build the provider and its instruments, then subscribe to the agent channels. Rejects when the
+ * OTel packages cannot be loaded; the provider logs that and leaves metrics export off.
+ */
+export declare function createOtelMetricsExporter(config: ResolvedOtelMetricsConfig, factory?: MeterProviderFactory): Promise<OtelMetricsExporter>;
+//# sourceMappingURL=otel_metrics_exporter.d.ts.map

package/dist/src/ai_metrics/otel_metrics_exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel_metrics_exporter.d.ts","sourceRoot":"","sources":["../../../src/ai_metrics/otel_metrics_exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAS1D;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;QACtB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;QACxF,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;YACR,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,MAAM,CAAC,EAAE;gBAAE,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SAClD,GACA,SAAS,CAAC;KACd,CAAC;IACF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,yBAAyB,KAC9B,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,EAAE,oBAoBhC,CAAC;AAEF,wFAAwF;AACxF,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,OAAO,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7C,oCAAoC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,yBAAyB,EACjC,OAAO,GAAE,oBAAyC,GACjD,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}

package/dist/src/ai_metrics/otel_metrics_exporter.js

@@ -0,0 +1,66 @@
+import { AGENT_METRIC_BUCKETS_MS, AGENT_METRICS, agentMetricPoints, } from './agent_metrics.js';
+import { subscribeAgentObservations } from './subscribe.js';
+/** Import the OTel metrics SDK and build a provider exporting to `config.url`. */
+export const loadOtelMetricsSdk = async (config) => {
+    const [sdk, exporterPkg, resources] = await Promise.all([
+        import('@opentelemetry/sdk-metrics'),
+        import('@opentelemetry/exporter-metrics-otlp-http'),
+        import('@opentelemetry/resources'),
+    ]);
+    const exporter = new exporterPkg.OTLPMetricExporter({
+        url: config.url,
+        headers: config.headers,
+        timeoutMillis: config.timeoutMs,
+    });
+    const reader = new sdk.PeriodicExportingMetricReader({
+        exporter,
+        exportIntervalMillis: config.exportIntervalMs,
+        exportTimeoutMillis: Math.min(config.timeoutMs, config.exportIntervalMs),
+    });
+    return new sdk.MeterProvider({
+        resource: resources.resourceFromAttributes({ 'service.name': config.serviceName }),
+        readers: [reader],
+    });
+};
+/**
+ * Build the provider and its instruments, then subscribe to the agent channels. Rejects when the
+ * OTel packages cannot be loaded; the provider logs that and leaves metrics export off.
+ */
+export async function createOtelMetricsExporter(config, factory = loadOtelMetricsSdk) {
+    const provider = await factory(config);
+    const meter = provider.getMeter('@adonis-agora/telescope');
+    const instruments = new Map();
+    for (const key of Object.keys(AGENT_METRICS)) {
+        const def = AGENT_METRICS[key];
+        instruments.set(key, def.type === 'counter'
+            ? meter.createCounter(def.name, { description: def.help, unit: '' })
+            : meter.createHistogram(def.name, {
+                description: def.help,
+                unit: '',
+                advice: { explicitBucketBoundaries: [...AGENT_METRIC_BUCKETS_MS] },
+            }));
+    }
+    const observe = (observation) => {
+        for (const point of agentMetricPoints(observation)) {
+            const instrument = instruments.get(point.metric);
+            if (instrument === undefined)
+                continue;
+            if (AGENT_METRICS[point.metric].type === 'counter') {
+                instrument.add(point.value, point.attributes);
+            }
+            else {
+                instrument.record(point.value, point.attributes);
+            }
+        }
+    };
+    const unsubscribe = subscribeAgentObservations(observe);
+    return {
+        observe,
+        flush: () => provider.forceFlush(),
+        async shutdown() {
+            unsubscribe();
+            await provider.shutdown().catch(() => undefined);
+        },
+    };
+}
+//# sourceMappingURL=otel_metrics_exporter.js.map

package/dist/src/ai_metrics/otel_metrics_exporter.js.map

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

package/dist/src/ai_metrics/subscribe.d.ts

@@ -0,0 +1,17 @@
+import { type AgentObservation } from './agent_events.js';
+/** A consumer of agent observations. A throw is swallowed — it never reaches the agent loop. */
+export type AgentObservationListener = (observation: AgentObservation) => void;
+/**
+ * Subscribe to the agent's `usage.recorded` and terminal run channels DIRECTLY on
+ * `node:diagnostics_channel` and hand each event, parsed, to `listener`.
+ *
+ * Direct, and not through recorded Telescope entries, on purpose: entries are sampled, pruned and
+ * may not be recorded at all (the `diagnostics` watcher is off, or the event is excluded). A metric must count every event exactly
+ * once, so it reads the source. Subscribing is also what makes `emit()` publish at all
+ * (`channel.hasSubscribers`), so this works with the
+ * `diagnostics` watcher off.
+ *
+ * Returns the unsubscribe function.
+ */
+export declare function subscribeAgentObservations(listener: AgentObservationListener): () => void;
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/src/ai_metrics/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../../src/ai_metrics/subscribe.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,mBAAmB,CAAC;AAE3B,gGAAgG;AAChG,MAAM,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAmBzF"}

package/dist/src/ai_metrics/subscribe.js

@@ -0,0 +1,38 @@
+import diagnostics_channel from 'node:diagnostics_channel';
+import { AGENT_CHANNEL_PREFIX, AGENT_METRIC_EVENTS, readAgentEvent, } from './agent_events.js';
+/**
+ * Subscribe to the agent's `usage.recorded` and terminal run channels DIRECTLY on
+ * `node:diagnostics_channel` and hand each event, parsed, to `listener`.
+ *
+ * Direct, and not through recorded Telescope entries, on purpose: entries are sampled, pruned and
+ * may not be recorded at all (the `diagnostics` watcher is off, or the event is excluded). A metric must count every event exactly
+ * once, so it reads the source. Subscribing is also what makes `emit()` publish at all
+ * (`channel.hasSubscribers`), so this works with the
+ * `diagnostics` watcher off.
+ *
+ * Returns the unsubscribe function.
+ */
+export function subscribeAgentObservations(listener) {
+    const handlers = [];
+    for (const event of AGENT_METRIC_EVENTS) {
+        const name = `${AGENT_CHANNEL_PREFIX}${event}`;
+        const handler = (message) => {
+            try {
+                const envelope = message;
+                const observation = readAgentEvent(event, envelope?.payload);
+                if (observation !== null)
+                    listener(observation);
+            }
+            catch {
+                // Observability must never break the agent run that published the event.
+            }
+        };
+        diagnostics_channel.subscribe(name, handler);
+        handlers.push([name, handler]);
+    }
+    return () => {
+        for (const [name, handler] of handlers)
+            diagnostics_channel.unsubscribe(name, handler);
+    };
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/src/ai_metrics/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../../src/ai_metrics/subscribe.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EAEnB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAK3B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAkC;IAC3E,MAAM,QAAQ,GAA2C,EAAE,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,mBAAmB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,GAAG,oBAAoB,GAAG,KAAK,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,CAAC,OAAgB,EAAQ,EAAE;YACzC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,OAAwD,CAAC;gBAC1E,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC7D,IAAI,WAAW,KAAK,IAAI;oBAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC,CAAC;QACF,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ;YAAE,mBAAmB,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/alerts/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.26.1";
+export declare const VERSION = "0.27.0";
 export type { AlertChannel, ChannelFetch, ConsoleSink } from './alert_channel.js';
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 export type { AlertDiagnosis, AlertGeoLocation, AlertMetric, AlertPayload, AlertRule, ExceptionAlertContext, GeoLookup, ResolvedAlerts, } from './alert_rule.js';

package/dist/src/alerts/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.26.1';
+export const VERSION = '0.27.0';
 // — channels —
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 // — alerter (exception source → tracker → channels) —

package/dist/src/client_errors/ingestor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingestor.d.ts","sourceRoot":"","sources":["../../../src/client_errors/ingestor.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,IAAI,IAAI,OAAO,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,kFAAkF;IAClF,EAAE,IAAI,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC1C,6DAA6D;IAC7D,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,0BAA0B,CAAC;IACnC;;;;OAIG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAAC;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,GACpB,CAAC,KAAK,EAAE,WAAW,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAQtD;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAGjE;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuD;IAC9E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,6EAA6E;IAC7E,OAAO,CAAC,eAAe,CAAS;IAEhC,YAAY,IAAI,EAAE,uBAAuB,EAQxC;IAEK,MAAM,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4E1D;IAED;;;;OAIG;YACW,YAAY;IAmB1B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ;CAIjB"}
+{"version":3,"file":"ingestor.d.ts","sourceRoot":"","sources":["../../../src/client_errors/ingestor.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,IAAI,IAAI,OAAO,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,kFAAkF;IAClF,EAAE,IAAI,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC1C,6DAA6D;IAC7D,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,0BAA0B,CAAC;IACnC;;;;OAIG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAAC;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,GACpB,CAAC,KAAK,EAAE,WAAW,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAQtD;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAGjE;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuD;IAC9E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,6EAA6E;IAC7E,OAAO,CAAC,eAAe,CAAS;IAEhC,YAAY,IAAI,EAAE,uBAAuB,EAQxC;IAEK,MAAM,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4E1D;IAED;;;;OAIG;YACW,YAAY;IAmB1B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ;CAIjB"}

package/dist/src/client_errors/ingestor.js

@@ -2,6 +2,7 @@ import { currentUserRef } from '../context_accessor.js';
 import { EntryType } from '../entry.js';
 import { exceptionFamilyHash } from '../exception_family_hash.js';
 import { getTelescopeRuntime } from '../registry.js';
+import { failureMessage, reportFailure } from '../report_failure.js';
 import { ClientErrorRateLimiter } from './rate_limiter.js';
 import { userIdentityTag, validateClientErrorBody, } from './validation.js';
 /**
@@ -20,8 +21,8 @@ export function storeRecorder(store) {
     };
 }
 function reportError(err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`telescope client-errors: failed to record entry: ${message}`);
+    const line = `telescope client-errors: failed to record entry: ${failureMessage(err)}`;
+    reportFailure(line, line);
 }
 /**
  * The user to attribute a browser-reported error to.