@migor/agentia 0.7.1 → 0.8.0

package/dist/integrations/metrics-state.js

@@ -0,0 +1,363 @@
+import { capabilityKindOf } from '../core/trace.js';
+import { percentile } from '../core/stats.js';
+/** 超过基数上限后新键的兜底标签（能力 / 模型 / 评分三个维度共用） */
+const OTHER_LABEL = '__other__';
+/**
+ * 折叠计数最多记这么多个**不同**键（每个维度各一本）。计数只用于报警「基数爆了」，
+ * 不值得为它留一本无界的账 —— 那等于把上限又拆掉一角。正常上限（50~200）下这个数
+ * 远够用：真要记满，说明键空间已经失控，此时「≥1024」和精确值一样能说明问题。
+ */
+const MAX_DROPPED_TRACKING = 1024;
+/**
+ * 标签基数配额：三个维度共用的「有界键空间」。
+ *
+ * 键第一次出现且在额度内 → 分到自己的标签（**永远认自己**，不会时而被折叠时而不折叠）；
+ * 超限 → 归入 `OTHER_LABEL`。
+ *
+ * 被折叠的键记进 `over`，只为回答「多少个**不同**的键被折叠了」；这本账自身也有界
+ * （`MAX_DROPPED_TRACKING`），满了以后 `dropped` 是下界。
+ */
+export class KeyBudget {
+    max;
+    assigned = new Set();
+    over = new Set();
+    constructor(max) {
+        this.max = max;
+    }
+    /** 取键的标签：额度内原样返回，超限返回 `OTHER_LABEL` */
+    take(key) {
+        if (this.assigned.has(key))
+            return key;
+        if (this.assigned.size < this.max) {
+            this.assigned.add(key);
+            return key;
+        }
+        if (this.over.size < MAX_DROPPED_TRACKING)
+            this.over.add(key);
+        return OTHER_LABEL;
+    }
+    /** 被折叠的**不同**键数（记满 `MAX_DROPPED_TRACKING` 后为下界） */
+    get dropped() {
+        return this.over.size;
+    }
+    /** 清空配额（`reset()` 用）—— 与 `capabilities` / `models` / `scores` 三张表同步清 */
+    reset() {
+        this.assigned.clear();
+        this.over.clear();
+    }
+}
+/**
+ * 时长统计：环形窗口（算窗口内精确分位）+ 累积直方图（算可聚合的 bucket）。
+ * run / 能力 / 模型共用同一个实现，保证三种粒度的口径与取整完全一致。
+ */
+export class DurationStat {
+    windowSize;
+    bounds;
+    ring = [];
+    cursor = 0;
+    /** 每桶非累积计数：counts[i] 对应 le = bounds[i]；末位是 +Inf 桶 */
+    counts;
+    total = 0;
+    sum = 0;
+    constructor(windowSize, bounds) {
+        this.windowSize = windowSize;
+        this.bounds = bounds;
+        this.counts = new Array(bounds.length + 1).fill(0);
+    }
+    add(ms) {
+        this.total++;
+        this.sum += ms;
+        if (this.ring.length < this.windowSize)
+            this.ring.push(ms);
+        else {
+            this.ring[this.cursor] = ms;
+            this.cursor = (this.cursor + 1) % this.windowSize;
+        }
+        let i = 0;
+        while (i < this.bounds.length && ms > this.bounds[i])
+            i++;
+        this.counts[i]++;
+    }
+    get count() {
+        return this.total;
+    }
+    get sumMs() {
+        return this.sum;
+    }
+    get windowSamples() {
+        return this.ring.length;
+    }
+    /**
+     * 窗口内精确分位（Prometheus 的 quantile 语义：取第 ceil(q·n) 个样本）。
+     * 算法单源在 `core/stats.ts` —— 与 `report.ts` 的时长 p50/p95 必须同口径，
+     * 否则同一条 trace 在看板与报告里会有两个 p95。
+     */
+    percentile(q) {
+        if (this.ring.length === 0)
+            return 0;
+        const sorted = [...this.ring].sort((a, b) => a - b);
+        return percentile(sorted, q);
+    }
+    /** 累积 bucket 计数（长度 = bounds+1，末位为 +Inf = count）—— Prometheus 文本语义 */
+    cumulative() {
+        const out = [];
+        let running = 0;
+        for (const c of this.counts) {
+            running += c;
+            out.push(running);
+        }
+        return out;
+    }
+    /** 每桶**非累积**计数 —— OTLP histogram 的 bucketCounts 语义（与 cumulative() 千万别混用） */
+    perBucket() {
+        return [...this.counts];
+    }
+    get boundsList() {
+        return this.bounds;
+    }
+    reset() {
+        this.ring.length = 0;
+        this.cursor = 0;
+        this.counts.fill(0);
+        this.total = 0;
+        this.sum = 0;
+    }
+}
+/** run 时长：取根 span（`trace.rootSpanId`）的起止；根没收尾（如 sink 在失败路径拿到半截）时返回 undefined */
+function runDurationMs(trace) {
+    const root = trace.spans.find((s) => s.spanId === trace.rootSpanId);
+    if (!root || root.endedAt === undefined)
+        return undefined;
+    return root.endedAt - root.startedAt;
+}
+function num(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : 0;
+}
+/**
+ * 评分键 → 指标标签。键有两种形态：**折叠桶**（`__other__`，整个键就是标签，不含 `\t`）
+ * 与正常的 `name\tsource`（source 缺省为 ''）。两个出口（Prometheus 文本 / OTLP）共用一处
+ * 解码 —— 各切各的必然有一处把折叠桶切成乱码。
+ */
+export function scoreLabels(key) {
+    if (key === OTHER_LABEL)
+        return { name: OTHER_LABEL, source: '' };
+    const tab = key.indexOf('\t');
+    return { name: key.slice(0, tab), source: key.slice(tab + 1) };
+}
+/**
+ * 进程内累加器：`metricsSink` 的全部可变状态（run / 能力 / 模型 / 评分四个维度 +
+ * 三个基数配额）。渲染（`metrics-render.ts`）与 OTLP 导出（`metrics-otlp.ts`）只读它。
+ */
+export class MetricsState {
+    opts;
+    runs = 0;
+    failed = 0;
+    costUsd = 0;
+    tokens = { input: 0, output: 0, cacheRead: 0, cacheCreation: 0 };
+    runStat;
+    capabilities = new Map();
+    models = new Map();
+    /** 评分累加器：key = `${name}\t${source}`（source 缺省 ''；\t 不会出现在正常评分名里，做天然分隔符） */
+    scores = new Map();
+    // 三个维度的键空间都封在这些配额里 —— 没有它们，三张 Map 与各自的时长窗口都是无界的
+    capBudget;
+    modelBudget;
+    scoreBudget;
+    constructor(opts) {
+        this.opts = opts;
+        this.runStat = new DurationStat(opts.windowSize, opts.buckets);
+        this.capBudget = new KeyBudget(opts.maxCapabilities);
+        this.modelBudget = new KeyBudget(opts.maxModels);
+        this.scoreBudget = new KeyBudget(opts.maxScores);
+    }
+    newCapability() {
+        return {
+            calls: 0,
+            errors: 0,
+            stat: new DurationStat(this.opts.windowSize, this.opts.buckets),
+            tokens: null,
+            costUsd: null,
+        };
+    }
+    /** 能力标签分配：labelMode 决定粒度，capBudget 决定基数上限 */
+    labelFor(kind, name) {
+        if (this.opts.labelMode === 'none')
+            return null;
+        if (this.opts.labelMode === 'kind')
+            return kind;
+        return this.capBudget.take(`${kind}:${name}`);
+    }
+    accumulate(trace) {
+        this.runs++;
+        if (trace.status === 'error')
+            this.failed++;
+        const u = trace.totalUsage;
+        this.tokens.input += u.inputTokens;
+        this.tokens.output += u.outputTokens;
+        this.tokens.cacheRead += u.cacheReadTokens;
+        this.tokens.cacheCreation += u.cacheCreationTokens;
+        if (u.costEstimate != null)
+            this.costUsd += u.costEstimate;
+        const d = runDurationMs(trace);
+        if (d !== undefined)
+            this.runStat.add(d);
+        // —— 评分（R7）：只认根 span 的 score 事件（attachScore 的写入位置）；
+        // body 宽容读取 —— name 不是 string / value 不是有限 number 就跳过，观测不击穿业务
+        const rootSpan = trace.spans.find((s) => s.spanId === trace.rootSpanId);
+        if (rootSpan) {
+            for (const e of rootSpan.events) {
+                if (e.name !== 'score')
+                    continue;
+                const body = e.body;
+                if (!body || typeof body !== 'object')
+                    continue;
+                if (typeof body.name !== 'string')
+                    continue;
+                if (typeof body.value !== 'number' || !Number.isFinite(body.value))
+                    continue;
+                const source = typeof body.source === 'string' ? body.source : '';
+                const key = this.scoreBudget.take(`${body.name}\t${source}`);
+                const acc = this.scores.get(key) ?? { value: 0, count: 0, sum: 0 };
+                acc.value = body.value; // gauge 语义：覆盖为最近一次
+                acc.count++;
+                acc.sum += body.value;
+                this.scores.set(key, acc);
+            }
+        }
+        for (const span of trace.spans) {
+            if (span.kind === 'capability') {
+                const label = this.labelFor(capabilityKindOf(span), span.name);
+                // 时长与错误无论哪种 labelMode 都要累计；labelMode:'none' 时整块跳过
+                if (label !== null) {
+                    const acc = this.capabilities.get(label) ?? this.newCapability();
+                    acc.calls++;
+                    if (span.status === 'error')
+                        acc.errors++;
+                    if (span.endedAt !== undefined)
+                        acc.stat.add(Math.max(0, span.endedAt - span.startedAt));
+                    // capability.usage = 子孙 llm.turn 聚合（tracer 写入）；工具没有这个语义
+                    if (span.usage) {
+                        const sum = span.usage.inputTokens +
+                            span.usage.outputTokens +
+                            span.usage.cacheReadTokens +
+                            span.usage.cacheCreationTokens;
+                        acc.tokens = (acc.tokens ?? 0) + sum;
+                        if (span.usage.costEstimate != null)
+                            acc.costUsd = (acc.costUsd ?? 0) + span.usage.costEstimate;
+                    }
+                    this.capabilities.set(label, acc);
+                }
+                continue;
+            }
+            if (span.kind === 'llm.turn') {
+                const model = this.modelBudget.take(span.name);
+                const acc = this.models.get(model) ?? {
+                    turns: 0,
+                    tokens: 0,
+                    costUsd: 0,
+                    unpricedTurns: 0,
+                    stat: new DurationStat(this.opts.windowSize, this.opts.buckets),
+                };
+                acc.turns++;
+                if (span.usage) {
+                    acc.tokens +=
+                        span.usage.inputTokens +
+                            span.usage.outputTokens +
+                            span.usage.cacheReadTokens +
+                            span.usage.cacheCreationTokens;
+                    if (span.usage.costEstimate != null)
+                        acc.costUsd += span.usage.costEstimate;
+                    else
+                        acc.unpricedTurns++; // 有计量却算不出成本 = 模型不在价格表内
+                }
+                if (span.endedAt !== undefined)
+                    acc.stat.add(Math.max(0, span.endedAt - span.startedAt));
+                this.models.set(model, acc);
+                // 普通工具的耗时/成败在 turn 的 tool.output 事件上（E1）—— 能力指标的另一路数据源
+                for (const e of span.events) {
+                    if (e.name !== 'tool.output')
+                        continue;
+                    const body = e.body;
+                    if (!body || typeof body !== 'object' || typeof body.tool !== 'string')
+                        continue;
+                    const label = this.labelFor('tool', body.tool);
+                    if (label === null)
+                        continue;
+                    const tacc = this.capabilities.get(label) ?? this.newCapability();
+                    tacc.calls++;
+                    if (body.ok === false)
+                        tacc.errors++;
+                    tacc.stat.add(Math.max(0, num(body.durationMs)));
+                    this.capabilities.set(label, tacc);
+                }
+            }
+        }
+    }
+    snapshot() {
+        const capabilityOut = {};
+        if (this.opts.labelMode !== 'none') {
+            for (const [label, acc] of this.capabilities) {
+                capabilityOut[label] = {
+                    calls: acc.calls,
+                    errors: acc.errors,
+                    latencyP50: acc.stat.percentile(0.5),
+                    latencyP95: acc.stat.percentile(0.95),
+                    tokens: acc.tokens,
+                    costUsd: acc.costUsd,
+                };
+            }
+        }
+        const modelOut = {};
+        for (const [model, acc] of this.models) {
+            modelOut[model] = {
+                turns: acc.turns,
+                tokens: acc.tokens,
+                costUsd: acc.costUsd,
+                unpricedTurns: acc.unpricedTurns,
+                latencyP50: acc.stat.percentile(0.5),
+                latencyP95: acc.stat.percentile(0.95),
+            };
+        }
+        const scoreOut = {};
+        for (const [key, acc] of this.scores) {
+            // 折叠桶没有 `name@source` 可黏（也不该有），原样以 `__other__` 出
+            if (key === OTHER_LABEL) {
+                scoreOut[OTHER_LABEL] = { ...acc };
+                continue;
+            }
+            const { name, source } = scoreLabels(key);
+            scoreOut[source === '' ? name : `${name}@${source}`] = { ...acc };
+        }
+        return {
+            runs: this.runs,
+            failed: this.failed,
+            latencyP50: this.runStat.percentile(0.5),
+            latencyP95: this.runStat.percentile(0.95),
+            tokens: this.tokens.input + this.tokens.output + this.tokens.cacheRead + this.tokens.cacheCreation,
+            costUsd: this.costUsd,
+            capabilities: capabilityOut,
+            models: modelOut,
+            scores: scoreOut,
+            droppedCapabilities: this.capBudget.dropped,
+            droppedModels: this.modelBudget.dropped,
+            droppedScores: this.scoreBudget.dropped,
+        };
+    }
+    reset() {
+        this.runs = 0;
+        this.failed = 0;
+        this.costUsd = 0;
+        this.tokens.input = 0;
+        this.tokens.output = 0;
+        this.tokens.cacheRead = 0;
+        this.tokens.cacheCreation = 0;
+        this.runStat.reset();
+        this.capabilities.clear();
+        this.models.clear();
+        this.scores.clear();
+        this.capBudget.reset();
+        this.modelBudget.reset();
+        this.scoreBudget.reset();
+    }
+}
+//# sourceMappingURL=metrics-state.js.map

package/dist/integrations/metrics-state.js.map

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

package/dist/integrations/metrics.d.ts

@@ -1,19 +1,7 @@
 import type { TraceSink } from '../core/trace.js';
-/**
- * OTLP metrics 导出失败（带数值 `status`）。
- *
- * 为什么不能抛裸 `Error`：`engine/errors.ts` 的分类是鸭子类型，只看数据属性。
- * 裸 Error 会被判 `unknown` + `retryable:false` —— 宿主在 `onExportError` 里拿不到
- * status，也就没法区分「collector 拒收（4xx，改配置）」与「collector 挂了（5xx，等它回来）」。
- * 形状与 `otlp.ts` 的 `OtlpExportError` 一致（同层两处导出器不该有两种错误形状）。
- *
- * 注：本处抛错由 `onExportError` 接住并按「观测失败不得击穿业务」吞掉 —— 带 status 是为了
- * **可判断**，不是为了让谁重试。
- */
-export declare class MetricsExportError extends Error {
-    readonly status: number;
-    constructor(status: number, message: string);
-}
+import type { MetricsSnapshot } from './metrics-state.js';
+export type { CapabilityMetrics, ModelMetrics, ScoreMetrics, MetricsSnapshot, } from './metrics-state.js';
+export { MetricsExportError } from './metrics-otlp.js';
 /**
  * Agentia —— 指标（D3 → 可观测下沉 E2/E3/E4/E5）。
  *
@@ -36,77 +24,6 @@ export declare class MetricsExportError extends Error {
  *
  * 零依赖：Prometheus 文本与 OTLP/JSON 都手写（纯文本 / JSON，不值得为此引客户端库）。
  */
-/** 能力维度指标（`snapshot().capabilities[label]`） */
-export interface CapabilityMetrics {
-    /** 该能力的调用次数 */
-    calls: number;
-    /** 其中失败次数（工具 `ok:false`；skill/subagent 的 capability span `status:'error'`） */
-    errors: number;
-    /** 单次调用耗时（毫秒）的窗口内精确分位；无样本时 0 */
-    latencyP50: number;
-    latencyP95: number;
-    /** 仅 skill/subagent：子孙 llm.turn 的 token 聚合（四类之和）；工具为 null */
-    tokens: number | null;
-    /** 仅 skill/subagent：估算成本（美元）；未定价或工具为 null */
-    costUsd: number | null;
-}
-/** 模型维度指标（`snapshot().models[model]`） */
-export interface ModelMetrics {
-    /** 该模型的 llm.turn 次数 */
-    turns: number;
-    /** 四类 token 之和 */
-    tokens: number;
-    /** 已定价部分的成本（美元）；全未定价时为 0 */
-    costUsd: number;
-    /** 成本估不出来的 turn 数（模型不在价格表内，且未用 priceOverrides 覆盖）*/
-    unpricedTurns: number;
-    latencyP50: number;
-    latencyP95: number;
-}
-/** 评分维度指标（`snapshot().scores[key]`，key 为 `name@source`，source 缺省时裸 name） */
-export interface ScoreMetrics {
-    /** 最近一次评分值（gauge 语义 —— 分数不是累加量） */
-    value: number;
-    /** 评分条数 */
-    count: number;
-    /** 评分值合计（平均 = sum / count） */
-    sum: number;
-}
-/** 进程内累计快照（`snapshot()` 返回） */
-export interface MetricsSnapshot {
-    /** 投递过 trace 的 run 总数（= `export` 被调用次数） */
-    runs: number;
-    /** 其中 `trace.status === 'error'` 的条数（含 budget_exceeded / aborted / error） */
-    failed: number;
-    /** run 时长（根 span `endedAt - startedAt`）分位，毫秒；窗口内无样本时 0 */
-    latencyP50: number;
-    latencyP95: number;
-    /**
-     * 累计 token —— 口径 = **四类之和**（input + output + cacheRead + cacheCreation），
-     * 与 `BudgetGuard` 的 token 口径一致。分项在 `render()` 里以 label 给出，不会丢。
-     */
-    tokens: number;
-    /** 累计成本估算（美元）；模型不在价格表内时该 run 不计入（见 usage.ts） */
-    costUsd: number;
-    /**
-     * 能力维度（`labelMode:'none'` 时为空对象）。超 `maxCapabilities` 的键折叠在
-     * `'__other__'` —— 该桶照常累加，所以这里的**总量**不受上限影响。
-     */
-    capabilities: Record<string, CapabilityMetrics>;
-    /** 模型维度；超 `maxModels` 的键折叠在 `'__other__'`（同上：总量不丢） */
-    models: Record<string, ModelMetrics>;
-    /**
-     * 评分维度（key 为 `name@source`，source 缺省时裸 name；无评分时为空对象）；
-     * 超 `maxScores` 的键折叠在 `'__other__'`。
-     */
-    scores: Record<string, ScoreMetrics>;
-    /** 因 `maxCapabilities` 上限被归入 `__other__` 的不同能力数 */
-    droppedCapabilities: number;
-    /** 因 `maxModels` 上限被归入 `__other__` 的不同模型数 */
-    droppedModels: number;
-    /** 因 `maxScores` 上限被归入 `__other__` 的不同评分维度数 */
-    droppedScores: number;
-}
 export interface MetricsSinkOptions {
     /**
      * 输出形态：