@tachu/extensions 1.0.0-alpha.1

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/observability/jsonl-emitter.d.ts

@@ -0,0 +1,58 @@
+import type { EngineEvent, ObservabilityEmitter } from "@tachu/core";
+type EventHandler = (event: EngineEvent) => void;
+interface JsonlEmitterOptions {
+    filePath: string;
+    rotateSize?: number;
+}
+/**
+ * JSON Lines 文件事件发射器。
+ */
+export declare class JsonlEmitter implements ObservabilityEmitter {
+    private readonly handlers;
+    private readonly filePath;
+    private readonly rotateSize;
+    private masker;
+    private writeQueue;
+    /**
+     * 创建 JSONL 发射器。
+     *
+     * @param options 文件配置
+     */
+    constructor(options: JsonlEmitterOptions);
+    /**
+     * 订阅事件。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     * @returns 取消订阅函数
+     */
+    on(type: EngineEvent["type"] | "*", handler: EventHandler): () => void;
+    /**
+     * 取消订阅。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     */
+    off(type: EngineEvent["type"] | "*", handler: EventHandler): void;
+    /**
+     * 发射并持久化事件。
+     *
+     * @param event 引擎事件
+     */
+    emit(event: EngineEvent): void;
+    /**
+     * 设置脱敏函数。
+     *
+     * @param masker 脱敏函数
+     */
+    setMasker(masker: (payload: unknown) => unknown): void;
+    /**
+     * 等待队列写入完成。
+     */
+    dispose(): Promise<void>;
+    private emitToSubscribers;
+    private append;
+    private rotateIfNeeded;
+}
+export {};
+//# sourceMappingURL=jsonl-emitter.d.ts.map

package/dist/observability/jsonl-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-emitter.d.ts","sourceRoot":"","sources":["../../src/observability/jsonl-emitter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAErE,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAEjD,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,oBAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2D;IACpF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,UAAU,CAAqB;IAEvC;;;;OAIG;gBACS,OAAO,EAAE,mBAAmB;IAKxC;;;;;;OAMG;IACH,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAOtE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAQjE;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAS9B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI;IAItD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,OAAO,CAAC,iBAAiB;YASX,MAAM;YAMN,cAAc;CAQ7B"}

package/dist/observability/jsonl-emitter.js

@@ -0,0 +1,96 @@
+import { mkdir, rename, stat, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * JSON Lines 文件事件发射器。
+ */
+export class JsonlEmitter {
+    handlers = new Map();
+    filePath;
+    rotateSize;
+    masker = (payload) => payload;
+    writeQueue = Promise.resolve();
+    /**
+     * 创建 JSONL 发射器。
+     *
+     * @param options 文件配置
+     */
+    constructor(options) {
+        this.filePath = options.filePath;
+        this.rotateSize = options.rotateSize ?? 10 * 1024 * 1024;
+    }
+    /**
+     * 订阅事件。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     * @returns 取消订阅函数
+     */
+    on(type, handler) {
+        const bucket = this.handlers.get(type) ?? new Set();
+        bucket.add(handler);
+        this.handlers.set(type, bucket);
+        return () => this.off(type, handler);
+    }
+    /**
+     * 取消订阅。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     */
+    off(type, handler) {
+        const bucket = this.handlers.get(type);
+        bucket?.delete(handler);
+        if (bucket && bucket.size === 0) {
+            this.handlers.delete(type);
+        }
+    }
+    /**
+     * 发射并持久化事件。
+     *
+     * @param event 引擎事件
+     */
+    emit(event) {
+        const maskedEvent = {
+            ...event,
+            payload: this.masker(event.payload),
+        };
+        this.emitToSubscribers(maskedEvent);
+        this.writeQueue = this.writeQueue.then(() => this.append(maskedEvent)).catch(() => undefined);
+    }
+    /**
+     * 设置脱敏函数。
+     *
+     * @param masker 脱敏函数
+     */
+    setMasker(masker) {
+        this.masker = masker;
+    }
+    /**
+     * 等待队列写入完成。
+     */
+    async dispose() {
+        await this.writeQueue;
+    }
+    emitToSubscribers(event) {
+        for (const handler of this.handlers.get(event.type) ?? []) {
+            handler(event);
+        }
+        for (const handler of this.handlers.get("*") ?? []) {
+            handler(event);
+        }
+    }
+    async append(event) {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        await this.rotateIfNeeded();
+        await writeFile(this.filePath, `${JSON.stringify(event)}\n`, { flag: "a" });
+    }
+    async rotateIfNeeded() {
+        const info = await stat(this.filePath).catch(() => null);
+        if (!info || info.size < this.rotateSize) {
+            return;
+        }
+        const rotatedPath = `${this.filePath}.${Date.now()}.jsonl`;
+        await rename(this.filePath, rotatedPath);
+    }
+}
+//# sourceMappingURL=jsonl-emitter.js.map

package/dist/observability/jsonl-emitter.js.map

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

package/dist/observability/otel-emitter.d.ts

@@ -0,0 +1,52 @@
+import type { EngineEvent, ObservabilityEmitter } from "@tachu/core";
+import type { Tracer } from "@opentelemetry/api";
+type EventHandler = (event: EngineEvent) => void;
+/**
+ * 基于 OpenTelemetry 的 ObservabilityEmitter 实现。
+ */
+export declare class OtelEmitter implements ObservabilityEmitter {
+    private readonly options;
+    private readonly handlers;
+    private readonly phaseSpans;
+    private masker;
+    /**
+     * 创建 OTel 发射器。
+     *
+     * @param options 构造参数
+     */
+    constructor(options: {
+        tracer: Tracer;
+    });
+    /**
+     * 订阅事件。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     * @returns 取消订阅函数
+     */
+    on(type: EngineEvent["type"] | "*", handler: EventHandler): () => void;
+    /**
+     * 取消订阅。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     */
+    off(type: EngineEvent["type"] | "*", handler: EventHandler): void;
+    /**
+     * 发射事件并映射到 OTel Span。
+     *
+     * @param event 引擎事件
+     */
+    emit(event: EngineEvent): void;
+    /**
+     * 配置 payload 脱敏函数。
+     *
+     * @param masker 脱敏函数
+     */
+    setMasker(masker: (payload: unknown) => unknown): void;
+    private emitToSubscribers;
+    private emitToOtel;
+    private setIfPresent;
+}
+export {};
+//# sourceMappingURL=otel-emitter.d.ts.map

package/dist/observability/otel-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-emitter.d.ts","sourceRoot":"","sources":["../../src/observability/otel-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAEjD;;GAEG;AACH,qBAAa,WAAY,YAAW,oBAAoB;IAU1C,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2D;IACpF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsD;IACjF,OAAO,CAAC,MAAM,CAAuD;IAErE;;;;OAIG;gBAC0B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAExD;;;;;;OAMG;IACH,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAOtE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAQjE;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAS9B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI;IAItD,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,UAAU;IAiElB,OAAO,CAAC,YAAY;CASrB"}

package/dist/observability/otel-emitter.js

@@ -0,0 +1,143 @@
+import { context, trace, SpanStatusCode } from "@opentelemetry/api";
+/**
+ * 基于 OpenTelemetry 的 ObservabilityEmitter 实现。
+ */
+export class OtelEmitter {
+    options;
+    handlers = new Map();
+    phaseSpans = new Map();
+    masker = (payload) => payload;
+    /**
+     * 创建 OTel 发射器。
+     *
+     * @param options 构造参数
+     */
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * 订阅事件。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     * @returns 取消订阅函数
+     */
+    on(type, handler) {
+        const bucket = this.handlers.get(type) ?? new Set();
+        bucket.add(handler);
+        this.handlers.set(type, bucket);
+        return () => this.off(type, handler);
+    }
+    /**
+     * 取消订阅。
+     *
+     * @param type 事件类型
+     * @param handler 处理器
+     */
+    off(type, handler) {
+        const bucket = this.handlers.get(type);
+        bucket?.delete(handler);
+        if (bucket && bucket.size === 0) {
+            this.handlers.delete(type);
+        }
+    }
+    /**
+     * 发射事件并映射到 OTel Span。
+     *
+     * @param event 引擎事件
+     */
+    emit(event) {
+        const maskedEvent = {
+            ...event,
+            payload: this.masker(event.payload),
+        };
+        this.emitToSubscribers(maskedEvent);
+        this.emitToOtel(maskedEvent);
+    }
+    /**
+     * 配置 payload 脱敏函数。
+     *
+     * @param masker 脱敏函数
+     */
+    setMasker(masker) {
+        this.masker = masker;
+    }
+    emitToSubscribers(event) {
+        for (const handler of this.handlers.get(event.type) ?? []) {
+            handler(event);
+        }
+        for (const handler of this.handlers.get("*") ?? []) {
+            handler(event);
+        }
+    }
+    emitToOtel(event) {
+        const phaseKey = `${event.traceId}:${event.sessionId}:${event.phase}`;
+        if (event.type === "phase_enter") {
+            const span = this.options.tracer.startSpan(`phase:${event.phase}`, {
+                attributes: {
+                    "engine.trace_id": event.traceId,
+                    "engine.session_id": event.sessionId,
+                    "engine.phase": event.phase,
+                },
+                startTime: event.timestamp,
+            });
+            this.phaseSpans.set(phaseKey, span);
+            return;
+        }
+        if (event.type === "phase_exit") {
+            const span = this.phaseSpans.get(phaseKey);
+            if (span) {
+                if (event.payload.error) {
+                    span.recordException(event.payload.error);
+                    span.setStatus({ code: SpanStatusCode.ERROR, message: "phase failed" });
+                }
+                else {
+                    span.setStatus({ code: SpanStatusCode.OK });
+                }
+                span.end(event.timestamp);
+                this.phaseSpans.delete(phaseKey);
+            }
+            return;
+        }
+        const parent = this.phaseSpans.get(phaseKey);
+        const parentContext = parent ? trace.setSpan(context.active(), parent) : context.active();
+        const span = this.options.tracer.startSpan(`event:${event.type}`, {
+            attributes: {
+                "engine.trace_id": event.traceId,
+                "engine.session_id": event.sessionId,
+                "engine.phase": event.phase,
+                "engine.event_type": event.type,
+            },
+            startTime: event.timestamp,
+        }, parentContext);
+        if (event.type.startsWith("llm")) {
+            this.setIfPresent(span, "llm.provider", event.payload.provider);
+            this.setIfPresent(span, "llm.model", event.payload.model);
+            this.setIfPresent(span, "llm.tokens.prompt", event.payload.promptTokens);
+            this.setIfPresent(span, "llm.tokens.completion", event.payload.completionTokens);
+        }
+        if (event.type.startsWith("tool")) {
+            this.setIfPresent(span, "tool.name", event.payload.name);
+            this.setIfPresent(span, "tool.side_effect", event.payload.sideEffect);
+        }
+        if (event.type === "error" || event.payload.error) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: "engine error" });
+            if (event.payload.error instanceof Error) {
+                span.recordException(event.payload.error);
+            }
+            else if (event.payload.error) {
+                span.recordException(new Error(String(event.payload.error)));
+            }
+        }
+        else {
+            span.setStatus({ code: SpanStatusCode.OK });
+        }
+        span.end(event.timestamp);
+    }
+    setIfPresent(span, key, value) {
+        if (value !== undefined) {
+            span.setAttribute(key, value);
+        }
+    }
+}
+//# sourceMappingURL=otel-emitter.js.map

package/dist/observability/otel-emitter.js.map

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

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,73 @@
+import { type ChatRequest, type ChatResponse, type ChatStreamChunk, type Message, type ModelInfo, type ProviderAdapter } from "@tachu/core";
+interface AnthropicProviderOptions {
+    apiKey?: string;
+    baseURL?: string;
+    timeoutMs?: number;
+    /**
+     * 透传给 Anthropic SDK 构造器的附加选项（对应 `ProviderConnectionConfig.extra`）。
+     *
+     * 典型用途：`defaultHeaders` / `defaultQuery` / `httpAgent` 等 SDK 支持但未在
+     * {@link AnthropicProviderOptions} 显式暴露的字段。仅当值非空时与显式字段浅合并。
+     */
+    extra?: Record<string, unknown>;
+    /**
+     * `listAvailableModels` TTL 缓存窗口（ms）。默认 60_000；<=0 关闭缓存。
+     */
+    modelListCacheTtlMs?: number;
+}
+/**
+ * Anthropic 官方 Provider Adapter。
+ */
+export declare class AnthropicProviderAdapter implements ProviderAdapter {
+    readonly id = "anthropic";
+    readonly name = "Anthropic";
+    private readonly client;
+    private readonly timeoutMs;
+    /**
+     * `listAvailableModels` TTL 缓存（D1-LOW-22），默认 60s，避免反复命中远端 `/v1/models`。
+     */
+    private modelListCache;
+    private readonly modelListCacheTtlMs;
+    /**
+     * 创建 Anthropic Provider。
+     *
+     * @param options Provider 配置
+     * @throws ProviderError 缺失凭据时抛出
+     */
+    constructor(options?: AnthropicProviderOptions);
+    /**
+     * 调用 Anthropic `/v1/models` 返回**动态**模型清单（SDK 0.30+）。
+     *
+     * 若 SDK 调用异常（鉴权失败、网络异常、SDK 旧版本无此接口等），退化为
+     * {@link FALLBACK_MODELS} 静态清单以保证上层 ModelRouter 不会因单次列表失败
+     * 而整体不可用；真实错误已通过 `mapProviderError` 转成结构化错误抛给
+     * 诊断链路（此处吞错并落 fallback 是出于鲁棒性考虑）。
+     */
+    listAvailableModels(): Promise<ModelInfo[]>;
+    /**
+     * 发起非流式对话请求。
+     *
+     * @param request 对话请求
+     * @param signal 可选取消信号
+     * @returns 对话响应
+     */
+    chat(request: ChatRequest, signal?: AbortSignal): Promise<ChatResponse>;
+    /**
+     * 发起流式对话请求。
+     *
+     * @param request 对话请求
+     * @param signal 可选取消信号
+     * @returns 流式分片
+     */
+    chatStream(request: ChatRequest, signal?: AbortSignal): AsyncIterable<ChatStreamChunk>;
+    /**
+     * 调用官方 countTokens 接口做精确计数。
+     *
+     * @param messages 消息列表
+     * @param model 模型名
+     * @returns token 数
+     */
+    countTokens(messages: Message[], model: string): Promise<number>;
+}
+export {};
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,eAAe,EAGrB,MAAM,aAAa,CAAC;AAIrB,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAiRD;;GAEG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IAC9D,QAAQ,CAAC,EAAE,eAAe;IAC1B,QAAQ,CAAC,IAAI,eAAe;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC;;OAEG;IACH,OAAO,CAAC,cAAc,CAAmD;IACzE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C;;;;;OAKG;gBACS,OAAO,GAAE,wBAA6B;IAiBlD;;;;;;;OAOG;IACG,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAkCjD;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAkE7E;;;;;;OAMG;IACI,UAAU,CACf,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,eAAe,CAAC;IAkJjC;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYvE"}