@adonis-agora/telescope 0.26.1 → 0.27.0

package/dist/src/ai_metrics/agent_events.js

@@ -0,0 +1,170 @@
+/**
+ * Pure readers for the `agora:agent:*` events `@adonis-agora/agent` publishes through
+ * `@adonis-agora/diagnostics` (`usage.recorded` and the run timings from agent 0.93.0 on).
+ * Telescope cannot import the agent lib, so the payload shapes are read structurally here: every
+ * field is optional and type-checked, and an event from an older agent lib simply yields fewer
+ * fields, never a throw.
+ *
+ * Shared by the Prometheus registry, the OTLP metrics exporter and the dashboard's AI screen so the
+ * three can never disagree on what "a priced call" or "a run's model time" means.
+ */
+/** The channel prefix `@adonis-agora/diagnostics` publishes on (`agora:<lib>:<event>`). */
+export const AGENT_CHANNEL_PREFIX = 'agora:agent:';
+/** The agent events the metrics read. */
+export const AGENT_METRIC_EVENTS = [
+    'usage.recorded',
+    'run.finished',
+    'run.failed',
+    'run.cancelled',
+];
+/** The `actorRef` the agent ledger uses for spend the platform pays for, not a user. */
+export const PLATFORM_ACTOR_REF = '@platform';
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function nonNegative(value) {
+    const n = num(value);
+    return n !== undefined && n > 0 ? n : 0;
+}
+function str(value) {
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+/** Read a `usage.recorded` payload. `null` when it is not one. */
+export function readUsage(payload) {
+    const p = asRecord(payload);
+    if (p === null)
+        return null;
+    const actorRef = str(p.actorRef) ?? 'unknown';
+    const costUsd = num(p.costUsd);
+    const declared = p.costSource === 'provider' || p.costSource === 'estimate' ? p.costSource : null;
+    // A cost with no declared source was priced by someone; the ledger's default is the provider.
+    const costSource = costUsd === undefined ? 'none' : (declared ?? 'provider');
+    const requests = num(p.requests);
+    const purpose = str(p.purpose);
+    const runId = str(p.runId);
+    const threadId = str(p.threadId);
+    return {
+        kind: 'usage',
+        actorRef,
+        feature: str(p.feature) ?? 'unknown',
+        model: str(p.modelId) ?? 'unknown',
+        provider: str(p.provider) ?? 'unknown',
+        costSource,
+        platform: actorRef === PLATFORM_ACTOR_REF,
+        ...(costUsd !== undefined ? { costUsd } : {}),
+        inputTokens: nonNegative(p.inputTokens),
+        outputTokens: nonNegative(p.outputTokens),
+        cacheReadTokens: nonNegative(p.cacheReadTokens),
+        cacheWriteTokens: nonNegative(p.cacheWriteTokens),
+        audioSeconds: nonNegative(p.audioSeconds),
+        characters: nonNegative(p.characters),
+        requests: requests !== undefined && requests >= 0 ? requests : 1,
+        ...(purpose !== undefined ? { purpose } : {}),
+        ...(runId !== undefined ? { runId } : {}),
+        ...(threadId !== undefined ? { threadId } : {}),
+    };
+}
+function readStepTimings(value) {
+    if (!Array.isArray(value))
+        return [];
+    const steps = [];
+    for (const raw of value) {
+        const s = asRecord(raw);
+        if (s === null)
+            continue;
+        const tools = [];
+        if (Array.isArray(s.tools)) {
+            for (const rawTool of s.tools) {
+                const t = asRecord(rawTool);
+                const ms = num(t?.ms);
+                if (t === null || ms === undefined)
+                    continue;
+                tools.push({ toolName: str(t.toolName) ?? 'unknown', ms });
+            }
+        }
+        const modelMs = num(s.modelMs);
+        steps.push({
+            step: num(s.step) ?? steps.length,
+            ...(modelMs !== undefined ? { modelMs } : {}),
+            toolsMs: num(s.toolsMs) ?? 0,
+            tools,
+        });
+    }
+    return steps;
+}
+const RUN_STATUS = {
+    'run.finished': 'completed',
+    'run.failed': 'failed',
+    'run.cancelled': 'cancelled',
+};
+/**
+ * Read a terminal run payload. The run context (`agentName`, `actorId`) rides the payload's top
+ * level; a nested `context` object is read as a fallback so a payload shaped either way parses.
+ */
+export function readRun(event, payload) {
+    const status = RUN_STATUS[event];
+    const p = asRecord(payload);
+    if (status === undefined || p === null)
+        return null;
+    const context = asRecord(p.context) ?? {};
+    const pick = (key) => p[key] ?? context[key];
+    const out = {
+        kind: 'run',
+        status,
+        agent: str(pick('agentName')) ?? 'default',
+        stepTimings: readStepTimings(p.stepTimings),
+    };
+    const strings = ['runId', 'threadId', 'actorId', 'modelId', 'code'];
+    for (const key of strings) {
+        const value = str(pick(key));
+        if (value !== undefined)
+            out[key] = value;
+    }
+    const numbers = [
+        'durationMs',
+        'ttftMs',
+        'queueMs',
+        'modelMs',
+        'toolsMs',
+        'steps',
+        'modelCalls',
+        'toolCalls',
+        'inputTokens',
+        'outputTokens',
+        'costUsd',
+    ];
+    for (const key of numbers) {
+        const value = num(pick(key));
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+/** Read any agent event the metrics care about; `null` for every other event. */
+export function readAgentEvent(event, payload) {
+    if (event === 'usage.recorded')
+        return readUsage(payload);
+    return readRun(event, payload);
+}
+/**
+ * The agent event a stored Telescope entry carries: the generic diagnostics watcher records every
+ * `agora:agent:<event>` publish as `type: 'diagnostic'` with `content: { lib: 'agent', event,
+ * payload }`. `null` for any other entry.
+ */
+export function agentEventOfEntry(entry) {
+    if (entry.type !== 'diagnostic')
+        return null;
+    const content = asRecord(entry.content);
+    if (content === null || content.lib !== 'agent')
+        return null;
+    const event = str(content.event);
+    if (event === undefined)
+        return null;
+    return { event, payload: content.payload };
+}
+//# sourceMappingURL=agent_events.js.map

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

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

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

@@ -0,0 +1,103 @@
+import type { AgentObservation } from './agent_events.js';
+/**
+ * The AI-usage and agent-run metrics, as ONE table both exporters read: the dependency-free
+ * Prometheus registry below and the OTLP exporter in `otel_metrics_exporter.ts`. Names are
+ * stable API — dashboards are built on them.
+ *
+ * Units live in the NAME (`_usd`, `_ms`, `_seconds`), and the OTLP instruments are created with an
+ * EMPTY unit on purpose: Prometheus' OTLP translation appends a unit suffix (`ms` → `_milliseconds`),
+ * which would make the same metric read `agora_agent_run_duration_ms_milliseconds` through a
+ * Collector and `agora_agent_run_duration_ms` from the scrape. With no unit both paths expose the
+ * same series, so one Grafana dashboard serves both.
+ *
+ * Cardinality: attributes are features, models, providers, agent and tool names only. `actorRef`,
+ * `runId` and `threadId` NEVER become attributes — they grow with users and runs.
+ */
+export declare const AGENT_METRICS: {
+    readonly costUsd: {
+        readonly name: 'agora_ai_cost_usd';
+        readonly type: 'counter';
+        readonly help: 'AI spend in US dollars, from usage.recorded rows that carried a cost.';
+    };
+    readonly tokens: {
+        readonly name: 'agora_ai_tokens';
+        readonly type: 'counter';
+        readonly help: 'AI tokens, by direction (in, out, cache_read, cache_write).';
+    };
+    readonly audioSeconds: {
+        readonly name: 'agora_ai_audio_seconds';
+        readonly type: 'counter';
+        readonly help: 'Seconds of audio processed by AI calls.';
+    };
+    readonly requests: {
+        readonly name: 'agora_ai_requests';
+        readonly type: 'counter';
+        readonly help: 'AI calls recorded in the usage ledger; cost_source="none" are the unpriced ones.';
+    };
+    readonly runDurationMs: {
+        readonly name: 'agora_agent_run_duration_ms';
+        readonly type: 'histogram';
+        readonly help: 'Agent run wall-clock duration in milliseconds, turn start to end.';
+    };
+    readonly runQueueMs: {
+        readonly name: 'agora_agent_run_queue_ms';
+        readonly type: 'histogram';
+        readonly help: 'Agent run time between enqueue and its body starting, in milliseconds.';
+    };
+    readonly runModelMs: {
+        readonly name: 'agora_agent_run_model_ms';
+        readonly type: 'histogram';
+        readonly help: 'Agent run time spent in model calls, in milliseconds.';
+    };
+    readonly runToolsMs: {
+        readonly name: 'agora_agent_run_tools_ms';
+        readonly type: 'histogram';
+        readonly help: 'Agent run time spent running tools (parallel calls once), in milliseconds.';
+    };
+    readonly toolDurationMs: {
+        readonly name: 'agora_agent_tool_duration_ms';
+        readonly type: 'histogram';
+        readonly help: 'One tool call duration, in milliseconds.';
+    };
+};
+export type AgentMetricKey = keyof typeof AGENT_METRICS;
+/** Histogram upper bounds (ms), shared by the scrape and the OTLP instruments. */
+export declare const AGENT_METRIC_BUCKETS_MS: readonly number[];
+/** Attribute values are strings, except `platform`, which OTLP carries as a boolean. */
+export type MetricAttributes = Record<string, string | boolean>;
+/** One value an observation contributes to one metric. */
+export interface MetricPoint {
+    metric: AgentMetricKey;
+    value: number;
+    attributes: MetricAttributes;
+}
+/** Every metric point an observation contributes. Pure. */
+export declare function agentMetricPoints(observation: AgentObservation): MetricPoint[];
+export interface AgentMetricsRegistryOptions {
+    /**
+     * Max distinct label sets kept per metric. New combinations past it are dropped (existing ones
+     * keep counting); every observation dropped that way is tallied in
+     * `agora_ai_metrics_dropped_series_total`. Default 2000.
+     */
+    maxSeriesPerMetric?: number;
+}
+/**
+ * Dependency-free, in-process aggregation of {@link AGENT_METRICS} for the Prometheus scrape
+ * (`GET <telescope path>/metrics`). Cumulative since process start, as Prometheus expects.
+ */
+export declare class AgentMetricsRegistry {
+    private readonly counters;
+    private readonly histograms;
+    private readonly dropped;
+    private readonly maxSeries;
+    constructor(options?: AgentMetricsRegistryOptions);
+    observe(observation: AgentObservation): void;
+    add(point: MetricPoint): void;
+    private drop;
+    /**
+     * Prometheus text exposition (format 0.0.4). Counters are exposed with the `_total` suffix —
+     * the same name Prometheus gives an OTLP monotonic sum — so the shipped dashboard reads either.
+     */
+    prometheus(): string;
+}
+//# sourceMappingURL=agent_metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent_metrics.d.ts","sourceRoot":"","sources":["../../../src/ai_metrics/agent_metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAoC,MAAM,mBAAmB,CAAC;AAE5F;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa;aACxB,OAAO;iBACL,IAAI,EAAE,mBAAmB;iBACzB,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,uEAAuE;;aAE/E,MAAM;iBACJ,IAAI,EAAE,iBAAiB;iBACvB,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,6DAA6D;;aAErE,YAAY;iBACV,IAAI,EAAE,wBAAwB;iBAC9B,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,yCAAyC;;aAEjD,QAAQ;iBACN,IAAI,EAAE,mBAAmB;iBACzB,IAAI,EAAE,SAAS;iBACf,IAAI,EAAE,kFAAkF;;aAE1F,aAAa;iBACX,IAAI,EAAE,6BAA6B;iBACnC,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,mEAAmE;;aAE3E,UAAU;iBACR,IAAI,EAAE,0BAA0B;iBAChC,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,wEAAwE;;aAEhF,UAAU;iBACR,IAAI,EAAE,0BAA0B;iBAChC,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,uDAAuD;;aAE/D,UAAU;iBACR,IAAI,EAAE,0BAA0B;iBAChC,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,4EAA4E;;aAEpF,cAAc;iBACZ,IAAI,EAAE,8BAA8B;iBACpC,IAAI,EAAE,WAAW;iBACjB,IAAI,EAAE,0CAA0C;;CAE1C,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,aAAa,CAAC;AAExD,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAEpD,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAEhE,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AA4DD,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,gBAAgB,GAAG,WAAW,EAAE,CAE9E;AAcD,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2D;IACtF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,OAAO,GAAE,2BAAgC,EAEpD;IAED,OAAO,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAE3C;IAED,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAsC5B;IAED,OAAO,CAAC,IAAI;IAIZ;;;OAGG;IACH,UAAU,IAAI,MAAM,CAyCnB;CACF"}

package/dist/src/ai_metrics/agent_metrics.js

@@ -0,0 +1,255 @@
+/**
+ * The AI-usage and agent-run metrics, as ONE table both exporters read: the dependency-free
+ * Prometheus registry below and the OTLP exporter in `otel_metrics_exporter.ts`. Names are
+ * stable API — dashboards are built on them.
+ *
+ * Units live in the NAME (`_usd`, `_ms`, `_seconds`), and the OTLP instruments are created with an
+ * EMPTY unit on purpose: Prometheus' OTLP translation appends a unit suffix (`ms` → `_milliseconds`),
+ * which would make the same metric read `agora_agent_run_duration_ms_milliseconds` through a
+ * Collector and `agora_agent_run_duration_ms` from the scrape. With no unit both paths expose the
+ * same series, so one Grafana dashboard serves both.
+ *
+ * Cardinality: attributes are features, models, providers, agent and tool names only. `actorRef`,
+ * `runId` and `threadId` NEVER become attributes — they grow with users and runs.
+ */
+export const AGENT_METRICS = {
+    costUsd: {
+        name: 'agora_ai_cost_usd',
+        type: 'counter',
+        help: 'AI spend in US dollars, from usage.recorded rows that carried a cost.',
+    },
+    tokens: {
+        name: 'agora_ai_tokens',
+        type: 'counter',
+        help: 'AI tokens, by direction (in, out, cache_read, cache_write).',
+    },
+    audioSeconds: {
+        name: 'agora_ai_audio_seconds',
+        type: 'counter',
+        help: 'Seconds of audio processed by AI calls.',
+    },
+    requests: {
+        name: 'agora_ai_requests',
+        type: 'counter',
+        help: 'AI calls recorded in the usage ledger; cost_source="none" are the unpriced ones.',
+    },
+    runDurationMs: {
+        name: 'agora_agent_run_duration_ms',
+        type: 'histogram',
+        help: 'Agent run wall-clock duration in milliseconds, turn start to end.',
+    },
+    runQueueMs: {
+        name: 'agora_agent_run_queue_ms',
+        type: 'histogram',
+        help: 'Agent run time between enqueue and its body starting, in milliseconds.',
+    },
+    runModelMs: {
+        name: 'agora_agent_run_model_ms',
+        type: 'histogram',
+        help: 'Agent run time spent in model calls, in milliseconds.',
+    },
+    runToolsMs: {
+        name: 'agora_agent_run_tools_ms',
+        type: 'histogram',
+        help: 'Agent run time spent running tools (parallel calls once), in milliseconds.',
+    },
+    toolDurationMs: {
+        name: 'agora_agent_tool_duration_ms',
+        type: 'histogram',
+        help: 'One tool call duration, in milliseconds.',
+    },
+};
+/** Histogram upper bounds (ms), shared by the scrape and the OTLP instruments. */
+export const AGENT_METRIC_BUCKETS_MS = [
+    10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000, 20000, 30000, 60000, 120000, 300000, 600000,
+];
+function usagePoints(u) {
+    const common = {
+        feature: u.feature,
+        model: u.model,
+        provider: u.provider,
+        cost_source: u.costSource,
+        platform: u.platform,
+    };
+    const points = [{ metric: 'requests', value: u.requests, attributes: common }];
+    if (u.costUsd !== undefined)
+        points.push({ metric: 'costUsd', value: u.costUsd, attributes: common });
+    if (u.audioSeconds > 0) {
+        points.push({ metric: 'audioSeconds', value: u.audioSeconds, attributes: common });
+    }
+    const tokens = [
+        ['in', u.inputTokens],
+        ['out', u.outputTokens],
+        ['cache_read', u.cacheReadTokens],
+        ['cache_write', u.cacheWriteTokens],
+    ];
+    for (const [direction, value] of tokens) {
+        if (value > 0) {
+            points.push({
+                metric: 'tokens',
+                value,
+                attributes: { direction, feature: u.feature, model: u.model },
+            });
+        }
+    }
+    return points;
+}
+function runPoints(r) {
+    const attributes = { agent: r.agent, status: r.status };
+    const points = [];
+    const timed = [
+        ['runDurationMs', r.durationMs],
+        ['runQueueMs', r.queueMs],
+        ['runModelMs', r.modelMs],
+        ['runToolsMs', r.toolsMs],
+    ];
+    for (const [metric, value] of timed) {
+        if (value !== undefined && value >= 0)
+            points.push({ metric, value, attributes });
+    }
+    for (const step of r.stepTimings) {
+        for (const tool of step.tools) {
+            if (tool.ms >= 0) {
+                points.push({
+                    metric: 'toolDurationMs',
+                    value: tool.ms,
+                    attributes: { tool: tool.toolName },
+                });
+            }
+        }
+    }
+    return points;
+}
+/** Every metric point an observation contributes. Pure. */
+export function agentMetricPoints(observation) {
+    return observation.kind === 'usage' ? usagePoints(observation) : runPoints(observation);
+}
+/**
+ * Dependency-free, in-process aggregation of {@link AGENT_METRICS} for the Prometheus scrape
+ * (`GET <telescope path>/metrics`). Cumulative since process start, as Prometheus expects.
+ */
+export class AgentMetricsRegistry {
+    counters = new Map();
+    histograms = new Map();
+    dropped = new Map();
+    maxSeries;
+    constructor(options = {}) {
+        this.maxSeries = options.maxSeriesPerMetric ?? 2000;
+    }
+    observe(observation) {
+        for (const point of agentMetricPoints(observation))
+            this.add(point);
+    }
+    add(point) {
+        const def = AGENT_METRICS[point.metric];
+        const key = labelKey(point.attributes);
+        if (def.type === 'counter') {
+            const series = getOrCreate(this.counters, point.metric);
+            let cell = series.get(key);
+            if (cell === undefined) {
+                if (series.size >= this.maxSeries) {
+                    // The exposed name, so the drop joins with the series it describes.
+                    this.drop(`${def.name}_total`);
+                    return;
+                }
+                cell = { labels: point.attributes, value: 0 };
+                series.set(key, cell);
+            }
+            cell.value += point.value;
+            return;
+        }
+        const series = getOrCreate(this.histograms, point.metric);
+        let cell = series.get(key);
+        if (cell === undefined) {
+            if (series.size >= this.maxSeries) {
+                this.drop(def.name);
+                return;
+            }
+            cell = {
+                labels: point.attributes,
+                sum: 0,
+                count: 0,
+                buckets: new Array(AGENT_METRIC_BUCKETS_MS.length).fill(0),
+            };
+            series.set(key, cell);
+        }
+        cell.sum += point.value;
+        cell.count += 1;
+        AGENT_METRIC_BUCKETS_MS.forEach((bound, i) => {
+            if (point.value <= bound)
+                cell.buckets[i] = (cell.buckets[i] ?? 0) + 1;
+        });
+    }
+    drop(metric) {
+        this.dropped.set(metric, (this.dropped.get(metric) ?? 0) + 1);
+    }
+    /**
+     * Prometheus text exposition (format 0.0.4). Counters are exposed with the `_total` suffix —
+     * the same name Prometheus gives an OTLP monotonic sum — so the shipped dashboard reads either.
+     */
+    prometheus() {
+        const lines = [];
+        for (const key of Object.keys(AGENT_METRICS)) {
+            const def = AGENT_METRICS[key];
+            if (def.type === 'counter') {
+                const series = this.counters.get(key);
+                if (series === undefined || series.size === 0)
+                    continue;
+                const name = `${def.name}_total`;
+                lines.push(`# HELP ${name} ${def.help}`, `# TYPE ${name} counter`);
+                for (const cell of series.values()) {
+                    lines.push(`${name}${formatLabels(cell.labels)} ${formatNumber(cell.value)}`);
+                }
+                continue;
+            }
+            const series = this.histograms.get(key);
+            if (series === undefined || series.size === 0)
+                continue;
+            lines.push(`# HELP ${def.name} ${def.help}`, `# TYPE ${def.name} histogram`);
+            for (const cell of series.values()) {
+                AGENT_METRIC_BUCKETS_MS.forEach((bound, i) => {
+                    lines.push(`${def.name}_bucket${formatLabels({ ...cell.labels, le: String(bound) })} ${cell.buckets[i] ?? 0}`);
+                });
+                lines.push(`${def.name}_bucket${formatLabels({ ...cell.labels, le: '+Inf' })} ${cell.count}`);
+                lines.push(`${def.name}_sum${formatLabels(cell.labels)} ${formatNumber(cell.sum)}`);
+                lines.push(`${def.name}_count${formatLabels(cell.labels)} ${cell.count}`);
+            }
+        }
+        if (this.dropped.size > 0) {
+            const name = 'agora_ai_metrics_dropped_series_total';
+            lines.push(`# HELP ${name} Observations dropped because their label set was new and the metric was at its series cap.`, `# TYPE ${name} counter`);
+            for (const [metric, count] of this.dropped) {
+                lines.push(`${name}${formatLabels({ metric })} ${count}`);
+            }
+        }
+        return lines.length === 0 ? '' : `${lines.join('\n')}\n`;
+    }
+}
+function getOrCreate(map, key) {
+    let inner = map.get(key);
+    if (inner === undefined) {
+        inner = new Map();
+        map.set(key, inner);
+    }
+    return inner;
+}
+function labelKey(labels) {
+    return Object.keys(labels)
+        .sort()
+        .map((k) => `${k}=${String(labels[k])}`)
+        .join('\u0000');
+}
+function escapeLabel(value) {
+    return value.replace(/\\/g, '\\\\').replace(/\n/g, '\\n').replace(/"/g, '\\"');
+}
+function formatLabels(labels) {
+    const keys = Object.keys(labels);
+    if (keys.length === 0)
+        return '';
+    return `{${keys.map((k) => `${k}="${escapeLabel(String(labels[k]))}"`).join(',')}}`;
+}
+function formatNumber(value) {
+    // Avoid float noise like 0.30000000000000004 in the exposition.
+    return Number.isInteger(value) ? String(value) : String(Number(value.toPrecision(12)));
+}
+//# sourceMappingURL=agent_metrics.js.map

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

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