@cicctencent/agent-core 0.1.122 → 0.1.124

package/dist/cjs/observability/pricing.js

@@ -0,0 +1,110 @@
+"use strict";
+// ============================================================
+// Observability — server-side model pricing
+// ============================================================
+//
+// 服务端定价表：当上游 provider 未返回 cost（或返回不准）时，
+// 根据 usage 的 token 数 + 模型/供应商 离线计算成本。
+// 同时支持 prompt cache 命中/写入的差异化计费（OpenAI/Anthropic/DeepSeek 均支持）。
+//
+// 单位：每 1K tokens 的美元价格（USD）。汇率可后续扩展为多币种。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_PRICING = void 0;
+exports.computeCost = computeCost;
+/**
+ * 模型定价表（USD / 1K tokens）。
+ * key 统一为小写 `provider::model`。provider 允许省略（仅 model 匹配）。
+ * 仅收录常用模型，缺失型号回退到同 provider 的兜底或 NaN（交由调用方决策）。
+ */
+exports.MODEL_PRICING = {
+    // ---- OpenAI ----
+    'openai::gpt-4o': { input: 0.0025, output: 0.01, cacheRead: 0.00125, cacheWrite: 0.005, currency: 'USD' },
+    'openai::gpt-4o-mini': { input: 0.00015, output: 0.0006, cacheRead: 0.000075, cacheWrite: 0.0003, currency: 'USD' },
+    'openai::gpt-4-turbo': { input: 0.01, output: 0.03, currency: 'USD' },
+    'openai::gpt-3.5-turbo': { input: 0.0005, output: 0.0015, currency: 'USD' },
+    'openai::o1': { input: 0.015, output: 0.06, currency: 'USD' },
+    'openai::o3-mini': { input: 0.0011, output: 0.0044, currency: 'USD' },
+    // ---- Anthropic ----
+    'anthropic::claude-3-5-sonnet': { input: 0.003, output: 0.015, cacheRead: 0.0003, cacheWrite: 0.00375, currency: 'USD' },
+    'anthropic::claude-3-5-haiku': { input: 0.0008, output: 0.004, cacheRead: 0.00008, cacheWrite: 0.001, currency: 'USD' },
+    'anthropic::claude-3-opus': { input: 0.015, output: 0.075, cacheRead: 0.0015, cacheWrite: 0.01875, currency: 'USD' },
+    // ---- DeepSeek ----
+    'deepseek::deepseek-chat': { input: 0.00027, output: 0.0011, cacheRead: 0.00007, cacheWrite: 0.00055, currency: 'USD' },
+    'deepseek::deepseek-reasoner': { input: 0.00055, output: 0.00219, cacheRead: 0.00014, cacheWrite: 0.00055, currency: 'USD' },
+    'deepseek::deepseek-v3': { input: 0.00027, output: 0.0011, cacheRead: 0.00007, cacheWrite: 0.00055, currency: 'USD' },
+    'deepseek::deepseek-v4-flash': { input: 0.0001, output: 0.0004, cacheRead: 0.00003, cacheWrite: 0.0002, currency: 'USD' },
+    // ---- 通义千问 / 阿里 ----
+    'qwen::qwen-max': { input: 0.0004, output: 0.0012, currency: 'USD' },
+    'qwen::qwen-plus': { input: 0.0001, output: 0.0003, currency: 'USD' },
+    'qwen::qwen-turbo': { input: 0.00003, output: 0.00009, currency: 'USD' },
+    // ---- 智谱 GLM ----
+    'zhipu::glm-4-plus': { input: 0.0005, output: 0.0015, currency: 'USD' },
+    'zhipu::glm-4-flash': { input: 0.00001, output: 0.00001, currency: 'USD' },
+};
+/** 未知模型的兜底单价（USD / 1K tokens），用于避免 cost 完全缺失 */
+const FALLBACK_PRICE = { input: 0.001, output: 0.002, cacheRead: 0.0005, cacheWrite: 0.001, currency: 'USD' };
+function normalizeProvider(provider) {
+    if (!provider)
+        return '';
+    const p = provider.toLowerCase();
+    if (p.includes('openai') || p.includes('gpt'))
+        return 'openai';
+    if (p.includes('anthropic') || p.includes('claude'))
+        return 'anthropic';
+    if (p.includes('deepseek'))
+        return 'deepseek';
+    if (p.includes('qwen') || p.includes('dashscope'))
+        return 'qwen';
+    if (p.includes('zhipu') || p.includes('glm'))
+        return 'zhipu';
+    return p;
+}
+function resolvePrice(model, provider) {
+    const m = (model || '').toLowerCase();
+    const p = normalizeProvider(provider);
+    if (m && p) {
+        const exact = exports.MODEL_PRICING[`${p}::${m}`];
+        if (exact)
+            return exact;
+    }
+    if (m) {
+        // 仅按 model 模糊匹配（取第一个包含 model 子串的条目）
+        const byModel = Object.entries(exports.MODEL_PRICING).find(([k]) => k.includes(m));
+        if (byModel)
+            return byModel[1];
+    }
+    return FALLBACK_PRICE;
+}
+/**
+ * 根据 usage 计算成本（USD）。
+ * 计费口径（与 Langfuse/OpenAI 一致）：
+ *   cost = promptTokens * input/1K
+ *        + completionTokens * output/1K
+ *        + cacheReadTokens * cacheRead/1K
+ *        + cacheWriteTokens * cacheWrite/1K
+ * 若 usage 同时携带上游返回的 cost，则以 usage.cost 为准（更精确），本函数仅作兜底。
+ *
+ * @returns 无 token 数据时返回空（不虚构成本）
+ */
+function computeCost(usage, model, provider) {
+    if (!usage)
+        return { estimated: false };
+    // 上游已给精确 cost → 直接采用
+    if (typeof usage.cost === 'number' && usage.cost >= 0) {
+        return { cost: usage.cost, currency: usage.currency, estimated: false };
+    }
+    const prompt = usage.promptTokens ?? 0;
+    const completion = usage.completionTokens ?? 0;
+    const cacheRead = usage.cacheReadTokens ?? 0;
+    const cacheWrite = usage.cacheWriteTokens ?? 0;
+    if (prompt + completion + cacheRead + cacheWrite <= 0)
+        return { estimated: false };
+    const price = resolvePrice(model, provider);
+    const cost = (prompt * price.input +
+        completion * price.output +
+        cacheRead * (price.cacheRead ?? price.input * 0.5) +
+        cacheWrite * (price.cacheWrite ?? price.input)) /
+        1000;
+    return { cost: Math.round(cost * 1e6) / 1e6, currency: price.currency ?? 'USD', estimated: price === FALLBACK_PRICE };
+}
+//# sourceMappingURL=pricing.js.map

package/dist/cjs/observability/pricing.js.map

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

package/dist/cjs/observability/propagation.d.ts

@@ -0,0 +1,37 @@
+import type { PropagationContext } from './types.js';
+/** W3C 传播头（OpenTelemetry 标准），用于与 Jaeger/Tempo/现有 OTel 链路互操作 */
+export declare const W3C_TRACEPARENT_HEADER = "traceparent";
+export declare const W3C_TRACESTATE_HEADER = "tracestate";
+/** 将传播上下文编码为可传输字符串（base64 JSON） */
+export declare function serializePropagationContext(ctx: PropagationContext): string;
+/** 从传输字符串解码传播上下文（容错：非法返回 undefined） */
+export declare function parsePropagationContext(encoded: string | undefined | null): PropagationContext | undefined;
+/** HTTP 头名（用于服务间调用透传） */
+export declare const OBSERVABILITY_TRACE_HEADER = "x-observability-trace";
+/**
+ * 将传播上下文注入到调用参数对象中（用于 delegate_task / a2a 等工具参数）。
+ * 返回新的参数对象，不修改原对象。
+ */
+export declare function injectIntoParams(params: Record<string, unknown>, ctx: PropagationContext): Record<string, unknown>;
+/** 从调用参数对象中提取传播上下文 */
+export declare function extractFromParams(params: Record<string, unknown> | undefined): PropagationContext | undefined;
+/** 从 HTTP headers 中提取传播上下文（优先 W3C，回退自定义头） */
+export declare function extractFromHeaders(headers: Record<string, string | undefined> | undefined): PropagationContext | undefined;
+/**
+ * 将传播上下文编码为 W3C traceparent + tracestate。
+ * - traceparent：由真实 ID 派生的 32/16 位十六进制，供外部 OTel 工具（Jaeger/Tempo）展示链路；
+ * - tracestate：以 obs=<base64> 形式保存真实上下文（traceId/parentObservationId 等），
+ *   保证跨进程能无损还原我们自己的观测上下文（W3C 标准推荐的 vendor data 用法）。
+ */
+export declare function serializeToW3C(ctx: PropagationContext): {
+    traceparent: string;
+    tracestate: string;
+};
+/** 从 W3C traceparent/tracestate 解码传播上下文（优先取 tracestate 中的真实上下文） */
+export declare function parseFromW3C(traceparent: string | undefined, tracestate: string | undefined): PropagationContext | undefined;
+/**
+ * 将传播上下文注入 HTTP headers（同时携带自定义头与 W3C 头，最大化互操作性）。
+ * 返回新 headers 对象，不修改原对象。
+ */
+export declare function injectIntoHeaders(ctx: PropagationContext): Record<string, string>;
+//# sourceMappingURL=propagation.d.ts.map

package/dist/cjs/observability/propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../../src/observability/propagation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AACpD,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAWlD,mCAAmC;AACnC,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAa3E;AAED,uCAAuC;AACvC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,kBAAkB,GAAG,SAAS,CAgB1G;AAED,yBAAyB;AACzB,eAAO,MAAM,0BAA0B,0BAAc,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIlH;AAED,sBAAsB;AACtB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAI7G;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAW1H;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,kBAAkB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAMnG;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,kBAAkB,GAAG,SAAS,CAchC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMjF"}

package/dist/cjs/observability/propagation.js

@@ -0,0 +1,148 @@
+"use strict";
+// ============================================================
+// Observability — cross-process trace propagation
+// ============================================================
+//
+// 将 trace 上下文序列化后注入到跨进程调用（delegate_task / A2A / HTTP），
+// 接收方用 ObservabilityManager.continueTrace() 重建上下文，
+// 使分布式多 agent 落在同一棵 trace 树下（AsyncLocalStorage 不出进程，
+// 必须显式传递 traceId + parentObservationId）。
+//
+// 序列化格式：base64(JSON)，避免直接拼接进参数导致的注入/转义问题。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBSERVABILITY_TRACE_HEADER = exports.W3C_TRACESTATE_HEADER = exports.W3C_TRACEPARENT_HEADER = void 0;
+exports.serializePropagationContext = serializePropagationContext;
+exports.parsePropagationContext = parsePropagationContext;
+exports.injectIntoParams = injectIntoParams;
+exports.extractFromParams = extractFromParams;
+exports.extractFromHeaders = extractFromHeaders;
+exports.serializeToW3C = serializeToW3C;
+exports.parseFromW3C = parseFromW3C;
+exports.injectIntoHeaders = injectIntoHeaders;
+const node_crypto_1 = require("node:crypto");
+const HEADER_NAME = 'x-observability-trace';
+const PARAM_KEY = '__obsTrace';
+/** W3C 传播头（OpenTelemetry 标准），用于与 Jaeger/Tempo/现有 OTel 链路互操作 */
+exports.W3C_TRACEPARENT_HEADER = 'traceparent';
+exports.W3C_TRACESTATE_HEADER = 'tracestate';
+/** tracestate 中的 vendor key，承载真实观测上下文（traceId/parentObservationId 等） */
+const W3C_VENDOR = 'obs';
+function w3cTraceId(seed) {
+    return (0, node_crypto_1.createHash)('sha256').update(`tid:${seed}`).digest('hex').slice(0, 32);
+}
+function w3cSpanId(seed) {
+    return (0, node_crypto_1.createHash)('sha256').update(`sid:${seed}`).digest('hex').slice(0, 16);
+}
+/** 将传播上下文编码为可传输字符串（base64 JSON） */
+function serializePropagationContext(ctx) {
+    try {
+        const json = JSON.stringify({
+            t: ctx.traceId,
+            p: ctx.parentObservationId,
+            e: ctx.environment,
+            g: ctx.tags,
+            v: ctx.promptVersion,
+        });
+        return Buffer.from(json, 'utf-8').toString('base64');
+    }
+    catch {
+        return '';
+    }
+}
+/** 从传输字符串解码传播上下文（容错：非法返回 undefined） */
+function parsePropagationContext(encoded) {
+    if (!encoded)
+        return undefined;
+    try {
+        const json = Buffer.from(encoded, 'base64').toString('utf-8');
+        const o = JSON.parse(json);
+        if (!o || typeof o.t !== 'string')
+            return undefined;
+        return {
+            traceId: o.t,
+            parentObservationId: o.p,
+            environment: o.e,
+            tags: Array.isArray(o.g) ? o.g : undefined,
+            promptVersion: o.v,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** HTTP 头名（用于服务间调用透传） */
+exports.OBSERVABILITY_TRACE_HEADER = HEADER_NAME;
+/**
+ * 将传播上下文注入到调用参数对象中（用于 delegate_task / a2a 等工具参数）。
+ * 返回新的参数对象，不修改原对象。
+ */
+function injectIntoParams(params, ctx) {
+    const encoded = serializePropagationContext(ctx);
+    if (!encoded)
+        return params;
+    return { ...params, [PARAM_KEY]: encoded };
+}
+/** 从调用参数对象中提取传播上下文 */
+function extractFromParams(params) {
+    if (!params)
+        return undefined;
+    const raw = params[PARAM_KEY];
+    return parsePropagationContext(typeof raw === 'string' ? raw : undefined);
+}
+/** 从 HTTP headers 中提取传播上下文（优先 W3C，回退自定义头） */
+function extractFromHeaders(headers) {
+    if (!headers)
+        return undefined;
+    // 优先解析 W3C traceparent/tracestate：tracestate.obs 携带真实上下文，可权威还原
+    const tp = headers[exports.W3C_TRACEPARENT_HEADER] || headers[exports.W3C_TRACEPARENT_HEADER.toUpperCase()];
+    const ts = headers[exports.W3C_TRACESTATE_HEADER] || headers[exports.W3C_TRACESTATE_HEADER.toUpperCase()];
+    if (tp || ts) {
+        const w3c = parseFromW3C(tp, ts);
+        if (w3c)
+            return w3c;
+    }
+    // 回退到自定义头（内部 delegate_task / A2A 兼容）
+    return parsePropagationContext(headers[HEADER_NAME] || headers[HEADER_NAME.toLowerCase()]);
+}
+/**
+ * 将传播上下文编码为 W3C traceparent + tracestate。
+ * - traceparent：由真实 ID 派生的 32/16 位十六进制，供外部 OTel 工具（Jaeger/Tempo）展示链路；
+ * - tracestate：以 obs=<base64> 形式保存真实上下文（traceId/parentObservationId 等），
+ *   保证跨进程能无损还原我们自己的观测上下文（W3C 标准推荐的 vendor data 用法）。
+ */
+function serializeToW3C(ctx) {
+    const traceId = w3cTraceId(ctx.traceId);
+    const parentId = ctx.parentObservationId ? w3cSpanId(ctx.parentObservationId) : w3cSpanId(`root:${ctx.traceId}`);
+    const traceparent = `00-${traceId}-${parentId}-01`;
+    const tracestate = `${W3C_VENDOR}=${serializePropagationContext(ctx)}`;
+    return { traceparent, tracestate };
+}
+/** 从 W3C traceparent/tracestate 解码传播上下文（优先取 tracestate 中的真实上下文） */
+function parseFromW3C(traceparent, tracestate) {
+    if (tracestate) {
+        const item = tracestate
+            .split(',')
+            .map(s => s.trim())
+            .find(s => s.startsWith(`${W3C_VENDOR}=`));
+        if (item) {
+            const payload = item.slice(`${W3C_VENDOR}=`.length);
+            const ctx = parsePropagationContext(payload);
+            if (ctx)
+                return ctx;
+        }
+    }
+    // 仅有 traceparent（无 tracestate）时无法还原真实业务 ID，交由上层回退自定义头
+    return undefined;
+}
+/**
+ * 将传播上下文注入 HTTP headers（同时携带自定义头与 W3C 头，最大化互操作性）。
+ * 返回新 headers 对象，不修改原对象。
+ */
+function injectIntoHeaders(ctx) {
+    const headers = { [HEADER_NAME]: serializePropagationContext(ctx) };
+    const { traceparent, tracestate } = serializeToW3C(ctx);
+    headers[exports.W3C_TRACEPARENT_HEADER] = traceparent;
+    headers[exports.W3C_TRACESTATE_HEADER] = tracestate;
+    return headers;
+}
+//# sourceMappingURL=propagation.js.map

package/dist/cjs/observability/propagation.js.map

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

package/dist/cjs/observability/sink.d.ts

@@ -1,4 +1,4 @@
-import type { EventContext, ObservationEndData, ObservationHandle, ObservationStartContext, ObservabilityConfig, ObservabilitySink, ScoreRecord, TraceEndData, TraceHandle, TraceStartContext } from './types.js';
+import type { EventContext, ObservationEndData, ObservationHandle, ObservationStartContext, ObservabilityConfig, ObservabilitySink, PropagationContext, ScoreRecord, TraceEndData, TraceHandle, TraceStartContext } from './types.js';
 export interface ObservabilityContext {
     traceId: string;
     /** 根会话 ID（启动 trace 的 session）。子 Agent 的 on_complete 不会结束 trace */
@@ -11,6 +11,12 @@ export interface ObservabilityContext {
     metadata?: Record<string, unknown>;
     /** trace 是否已结束（由 on_complete/endTrace 置位），防止 runWithTrace 成功路径覆盖错误状态 */
     ended?: boolean;
+    /** 运行环境（dev/prod/test），贯穿整个 trace 及其 observations */
+    environment?: string;
+    /** 全局标签，贯穿整个 trace 及其 observations */
+    tags?: string[];
+    /** 关联提示词/agent 配置版本 */
+    promptVersion?: string;
 }
 export declare class NoOpObservabilitySink implements ObservabilitySink {
     startTrace(ctx: TraceStartContext): TraceHandle;
@@ -30,6 +36,14 @@ export declare class ObservabilityManager implements ObservabilitySink {
     getTraceContext(): ObservabilityContext | undefined;
     runWithContext<T>(context: ObservabilityContext, fn: () => T): T;
     runWithTrace<T>(ctx: TraceStartContext, fn: () => T | Promise<T>): Promise<T>;
+    /**
+     * 跨进程继续 trace：在子进程（delegate_task / A2A）中，用父进程传入的
+     * PropagationContext 重建观测上下文，使子进程的 observations 挂到同一棵 trace 树下。
+     * 不会结束 trace（trace 生命周期由父进程拥有），仅在本进程内传播上下文。
+     */
+    continueTrace<T>(propCtx: PropagationContext, fn: () => T | Promise<T>): Promise<T>;
+    /** 导出当前上下文为可跨进程传播的 PropagationContext（供注入到子调用参数/HTTP 头） */
+    getPropagationContext(): PropagationContext | undefined;
     startTrace(ctx: TraceStartContext): Promise<TraceHandle>;
     endTrace(traceId: string, data?: TraceEndData): void;
     startObservation(ctx: ObservationStartContext): Promise<ObservationHandle>;

package/dist/cjs/observability/sink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../../src/observability/sink.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,WAAW;IAQ/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAEtD,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,GAAG,iBAAiB;IASjE,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI;IACxE,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IACrC,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CACvC;AAED,qBAAa,oBAAqB,YAAW,iBAAiB;IAC5D,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAA+J;gBAEjK,IAAI,GAAE,iBAA+C,EAAE,MAAM,GAAE,mBAAwB;IAYnG,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAQ5C,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAItC,eAAe,IAAI,oBAAoB,GAAG,SAAS;IAInD,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI1D,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA8B7E,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAW9D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI;IASlD,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+BhF,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,IAAI;IAepE,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;CAIjB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,SAAQ,GAAG,MAAM,CAE9D"}
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../../src/observability/sink.ts"],"names":[],"mappings":"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"}

package/dist/cjs/observability/sink.js

@@ -37,10 +37,13 @@ class ObservabilityManager {
         this.config = {
             enabled: config.enabled ?? true,
             samplingRate: normalizeSamplingRate(config.samplingRate ?? 1),
+            sampleErrors: config.sampleErrors ?? false,
             captureInput: config.captureInput ?? true,
             captureOutput: config.captureOutput ?? true,
             captureMessages: config.captureMessages ?? true,
             redact: config.redact,
+            environment: config.environment,
+            tags: config.tags,
         };
     }
     configure(config) {
@@ -67,6 +70,9 @@ class ObservabilityManager {
             sampled: handle.sampled,
             startTime: handle.startTime,
             metadata: ctx.metadata,
+            environment: ctx.environment ?? this.config.environment,
+            tags: ctx.tags ?? this.config.tags,
+            promptVersion: ctx.promptVersion,
         };
         return this.storage.run(context, async () => {
             try {
@@ -79,15 +85,53 @@ class ObservabilityManager {
                 return result;
             }
             catch (err) {
-                this.endTrace(handle.traceId, {
-                    status: 'error',
-                    error: err instanceof Error ? err.message : String(err),
-                    startTime: handle.startTime,
-                });
+                // 若 on_complete 已结束 trace（例如引擎内部捕获错误后触发了 on_complete(error)），
+                // 不再重复结束，避免重复告警 / 状态覆盖。
+                if (!context.ended) {
+                    this.endTrace(handle.traceId, {
+                        status: 'error',
+                        error: err instanceof Error ? err.message : String(err),
+                        startTime: handle.startTime,
+                    });
+                }
                 throw err;
             }
         });
     }
+    /**
+     * 跨进程继续 trace：在子进程（delegate_task / A2A）中，用父进程传入的
+     * PropagationContext 重建观测上下文，使子进程的 observations 挂到同一棵 trace 树下。
+     * 不会结束 trace（trace 生命周期由父进程拥有），仅在本进程内传播上下文。
+     */
+    async continueTrace(propCtx, fn) {
+        const context = {
+            traceId: propCtx.traceId,
+            // 子进程不是 root：其 on_complete 不应结束父 trace
+            rootSessionId: undefined,
+            currentObservationId: propCtx.parentObservationId,
+            observationStack: propCtx.parentObservationId ? [propCtx.parentObservationId] : [],
+            sampled: true,
+            startTime: Date.now(),
+            environment: propCtx.environment ?? this.config.environment,
+            tags: propCtx.tags ?? this.config.tags,
+            promptVersion: propCtx.promptVersion,
+            metadata: {},
+        };
+        return this.storage.run(context, async () => fn());
+    }
+    /** 导出当前上下文为可跨进程传播的 PropagationContext（供注入到子调用参数/HTTP 头） */
+    getPropagationContext() {
+        const current = this.storage.getStore();
+        if (!current?.traceId)
+            return undefined;
+        return {
+            traceId: current.traceId,
+            parentObservationId: current.currentObservationId,
+            environment: current.environment,
+            tags: current.tags,
+            promptVersion: current.promptVersion,
+        };
+    }
     async startTrace(ctx) {
         const traceId = ctx.traceId || generateObservabilityId('trace');
         const sampled = this.shouldSample();
@@ -133,6 +177,9 @@ class ObservabilityManager {
             ...ctx,
             traceId,
             parentObservationId,
+            // 未显式指定的 environment/tags 从当前 trace 上下文继承，保证全链路一致
+            environment: ctx.environment ?? current?.environment,
+            tags: ctx.tags ?? current?.tags,
         });
         const sinkHandle = await this.sink.startObservation(safeCtx);
         return { ...handle, ...sinkHandle, traceId };
@@ -171,6 +218,11 @@ class ObservabilityManager {
     shouldSample() {
         if (!this.config.enabled)
             return false;
+        // 错误优先可观测：开启 sampleErrors 时强制全量采样。
+        // head-based 采样在 startTrace 时无法预知最终结果是否错误，「强制保留」是唯一能保证错误 trace
+        // 不被随机丢弃的方式；真正的尾部采样（trace 结束后再决策保留）见后续规划。
+        if (this.config.sampleErrors)
+            return true;
         if (this.config.samplingRate >= 1)
             return true;
         if (this.config.samplingRate <= 0)

package/dist/cjs/observability/sink.js.map

@@ -1 +1 @@
-{"version":3,"file":"sink.js","sourceRoot":"","sources":["../../../src/observability/sink.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../../../src/observability/sink.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,2DAA2D;AAC3D,+DAA+D;;;AAwR/D,0DAEC;AAxRD,uDAAqD;AAmCrD,MAAa,qBAAqB;IAChC,UAAU,CAAC,GAAsB;QAC/B,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC;YACxD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,QAAgB,EAAE,KAAoB,IAAqB,CAAC;IAErE,gBAAgB,CAAC,GAA4B;QAC3C,OAAO;YACL,aAAa,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC;YAChD,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC;YACxD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,cAAsB,EAAE,KAA0B,IAAqB,CAAC;IACvF,WAAW,CAAC,IAAkB,IAAqB,CAAC;IACpD,WAAW,CAAC,MAAmB,IAAqB,CAAC;CACtD;AAvBD,sDAuBC;AAED,MAAa,oBAAoB;IACvB,OAAO,GAAG,IAAI,oCAAiB,EAAwB,CAAC;IACxD,IAAI,CAAoB;IACxB,MAAM,CAAyM;IAEvN,YAAY,OAA0B,IAAI,qBAAqB,EAAE,EAAE,SAA8B,EAAE;QACjG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,YAAY,EAAE,qBAAqB,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;YAC7D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,KAAK;YAC1C,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI;YACzC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;YAC3C,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,IAAI;YAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAA2B;QACnC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,MAAM;YACT,YAAY,EAAE,qBAAqB,CAAC,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;SACrF,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,IAAuB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,cAAc,CAAI,OAA6B,EAAE,EAAW;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAI,GAAsB,EAAE,EAAwB;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAyB;YACpC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,GAAG,CAAC,SAAS;YAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;YACvD,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI;YAClC,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;gBAC1B,4CAA4C;gBAC5C,2BAA2B;gBAC3B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC/E,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,8DAA8D;gBAC9D,wBAAwB;gBACxB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE;wBAC5B,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;wBACvD,SAAS,EAAE,MAAM,CAAC,SAAS;qBAC5B,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAI,OAA2B,EAAE,EAAwB;QAC1E,MAAM,OAAO,GAAyB;YACpC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,uCAAuC;YACvC,aAAa,EAAE,SAAS;YACxB,oBAAoB,EAAE,OAAO,CAAC,mBAAmB;YACjD,gBAAgB,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE;YAClF,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;YAC3D,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI;YACtC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,2DAA2D;IAC3D,qBAAqB;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,OAAO;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,mBAAmB,EAAE,OAAO,CAAC,oBAAoB;YACjD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAsB;QACrC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,MAAM,MAAM,GAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC;QACxE,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,OAAqB,EAAE;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO;QACrC,+DAA+D;QAC/D,IAAI,OAAO;YAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;QAClC,sDAAsD;QACtD,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,GAA4B;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,EAAE,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAsB;YAChC,aAAa,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC;YAChD,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO;SACR,CAAC;QAEF,6CAA6C;QAC7C,8DAA8D;QAC9D,MAAM,mBAAmB,GAAG,GAAG,CAAC,mBAAmB,IAAI,OAAO,EAAE,oBAAoB,CAAC;QACrF,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,gBAAgB;gBAAE,OAAO,CAAC,gBAAgB,GAAG,EAAE,CAAC;YAC7D,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACpD,OAAO,CAAC,oBAAoB,GAAG,MAAM,CAAC,aAAa,CAAC;QACtD,CAAC;QAED,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,GAAG,GAAG;YACN,OAAO;YACP,mBAAmB;YACnB,kDAAkD;YAClD,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,OAAO,EAAE,WAAW;YACpD,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,IAAI;SAChC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC7D,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED,cAAc,CAAC,aAAqB,EAAE,OAA2B,EAAE;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,kDAAkD;QAClD,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;YAChE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBACb,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACxC,OAAO,CAAC,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO;QACrC,sDAAsD;QACtD,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrG,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAiB;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO;QACrC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxC,GAAG,GAAG;YACN,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO,EAAE,OAAO;YACxC,mBAAmB,EAAE,GAAG,CAAC,mBAAmB,IAAI,OAAO,EAAE,oBAAoB;SAC9E,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAkB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO;QACrC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QACvC,mCAAmC;QACnC,+DAA+D;QAC/D,0CAA0C;QAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAChD,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;IAClD,CAAC;IAEO,SAAS,CAAC,OAA8B;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1E,CAAC;IAEO,QAAQ,CAAI,KAAQ;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAM,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAxND,oDAwNC;AAED,SAAgB,uBAAuB,CAAC,MAAM,GAAG,KAAK;IACpD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/cjs/observability/taxonomy.d.ts

@@ -0,0 +1,9 @@
+import type { ObservabilityErrorType } from './types.js';
+/**
+ * 错误分类。
+ * 优先级：context_too_long > rate_limit > non_retryable > budget > timeout > server_error > network_error > tool_error > unknown
+ */
+export declare function classifyErrorType(err: unknown): ObservabilityErrorType;
+/** 错误类型 → 展示用中文名 */
+export declare const ERROR_TYPE_LABELS: Record<ObservabilityErrorType, string>;
+//# sourceMappingURL=taxonomy.d.ts.map

package/dist/cjs/observability/taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.d.ts","sourceRoot":"","sources":["../../../src/observability/taxonomy.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CA8CtE;AAED,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAUpE,CAAC"}

package/dist/cjs/observability/taxonomy.js

@@ -0,0 +1,67 @@
+"use strict";
+// ============================================================
+// Observability — error taxonomy (shared classification)
+// ============================================================
+//
+// 将任意错误（LLM 调用 / 工具执行 / 预算熔断 / 网络）统一分类为
+// ObservabilityErrorType，便于按类型聚合、告警与前端着色。
+// 与 llm-caller.classifyError 口径保持一致，但独立于引擎实现，
+// 供 observability 中间件/服务层复用。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_TYPE_LABELS = void 0;
+exports.classifyErrorType = classifyErrorType;
+/**
+ * 错误分类。
+ * 优先级：context_too_long > rate_limit > non_retryable > budget > timeout > server_error > network_error > tool_error > unknown
+ */
+function classifyErrorType(err) {
+    const raw = err instanceof Error ? err.message : typeof err === 'string' ? err : String(err ?? '');
+    const msg = raw.toLowerCase();
+    if (msg.includes('too long') || msg.includes('input length') ||
+        msg.includes('context length') || msg.includes('too many tokens') ||
+        msg.includes('maximum context') || msg.includes('max_tokens')) {
+        return 'context_too_long';
+    }
+    if (/\b429\b/.test(msg) || msg.includes('rate limit') || msg.includes('tpm') || msg.includes('too many requests')) {
+        return 'rate_limit';
+    }
+    if (msg.includes('unauthorized') || msg.includes('forbidden') ||
+        msg.includes('invalid api key') || msg.includes('permission') ||
+        msg.includes('quota') || msg.includes('insufficient') ||
+        /\b4\d{2}\b/.test(msg)) {
+        return 'non_retryable';
+    }
+    if (msg.includes('token budget') || msg.includes('budget exceeded') || msg.includes('cost overrun')) {
+        return 'budget';
+    }
+    if (msg.includes('stream idle timeout') || msg.includes('no data received') ||
+        msg.includes('timeout') || msg.includes('aborted') || msg.includes('deadline')) {
+        return 'timeout';
+    }
+    if (/\b5\d{2}\b/.test(msg) || msg.includes('internal server error') ||
+        msg.includes('bad gateway') || msg.includes('service unavailable')) {
+        return 'server_error';
+    }
+    if (msg.includes('econnreset') || msg.includes('socket hang up') ||
+        msg.includes('fetch failed') || msg.includes('network error') ||
+        msg.includes('etimedout') || msg.includes('econnrefused')) {
+        return 'network_error';
+    }
+    if (msg.includes('tool') || msg.includes('function call') || msg.includes('execution')) {
+        return 'tool_error';
+    }
+    return 'unknown';
+}
+/** 错误类型 → 展示用中文名 */
+exports.ERROR_TYPE_LABELS = {
+    context_too_long: '上下文超长',
+    rate_limit: '速率限制',
+    non_retryable: '不可重试错误',
+    timeout: '超时',
+    server_error: '服务端错误',
+    network_error: '网络错误',
+    tool_error: '工具错误',
+    budget: '预算超限',
+    unknown: '未知',
+};
+//# sourceMappingURL=taxonomy.js.map

package/dist/cjs/observability/taxonomy.js.map

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