@tachu/extensions 1.0.0-beta.1 → 1.0.0-rc.1

package/dist/memory/projection-outbox.js

@@ -0,0 +1,187 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import { basename, dirname, extname, join } from "node:path";
+const DEFAULT_MAX_ATTEMPTS = 5;
+const DEFAULT_STALE_MS = 5 * 60_000;
+function parseRecord(raw) {
+    try {
+        const obj = JSON.parse(raw);
+        if (typeof obj.ref !== "string" || typeof obj.state !== "string")
+            return null;
+        return obj;
+    }
+    catch {
+        return null;
+    }
+}
+export class ProjectionOutbox {
+    dir;
+    maxAttempts;
+    staleAfterMs;
+    cache = new Map();
+    constructor(options) {
+        this.dir = options.dir;
+        this.maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+        this.staleAfterMs = options.staleAfterMs ?? DEFAULT_STALE_MS;
+    }
+    pathFor(sessionId) {
+        return join(this.dir, `${sessionId}.jsonl`);
+    }
+    deadDir() {
+        return join(this.dir, "dead");
+    }
+    /** 读取/构造 session 的内存索引（按 ref 唯一）。 */
+    async loadIndex(sessionId) {
+        const cached = this.cache.get(sessionId);
+        if (cached)
+            return cached;
+        const map = new Map();
+        const path = this.pathFor(sessionId);
+        if (existsSync(path)) {
+            const text = await readFile(path, "utf8");
+            for (const line of text.split("\n")) {
+                if (!line.trim())
+                    continue;
+                const rec = parseRecord(line);
+                if (rec)
+                    map.set(rec.ref, rec); // last-write-wins
+            }
+        }
+        this.cache.set(sessionId, map);
+        return map;
+    }
+    /** 原子重写 jsonl。 */
+    async flush(sessionId) {
+        const map = this.cache.get(sessionId);
+        if (!map)
+            return;
+        await mkdir(this.dir, { recursive: true });
+        const tmp = `${this.pathFor(sessionId)}.tmp`;
+        const lines = [...map.values()].map((rec) => JSON.stringify(rec)).join("\n");
+        await writeFile(tmp, lines.length > 0 ? `${lines}\n` : "", "utf8");
+        await rename(tmp, this.pathFor(sessionId));
+    }
+    /** 启动恢复：将陈旧 retrying 重置为 pending。 */
+    async recover(sessionId, now = Date.now()) {
+        const map = await this.loadIndex(sessionId);
+        let reset = 0;
+        for (const rec of map.values()) {
+            if (rec.state === "retrying" && now - rec.updatedAt > this.staleAfterMs) {
+                rec.state = "pending";
+                rec.updatedAt = now;
+                reset += 1;
+            }
+        }
+        if (reset > 0)
+            await this.flush(sessionId);
+        return reset;
+    }
+    async enqueue(sessionId, ref, now = Date.now()) {
+        const map = await this.loadIndex(sessionId);
+        const existing = map.get(ref);
+        if (existing && existing.state === "indexed")
+            return; // idempotent
+        map.set(ref, {
+            ref,
+            state: "pending",
+            attempts: existing?.attempts ?? 0,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        });
+        await this.flush(sessionId);
+    }
+    async markRetrying(sessionId, ref, now = Date.now()) {
+        const map = await this.loadIndex(sessionId);
+        const rec = map.get(ref);
+        if (!rec)
+            return;
+        rec.state = "retrying";
+        rec.updatedAt = now;
+        await this.flush(sessionId);
+    }
+    async markIndexed(sessionId, ref, vectorId, now = Date.now()) {
+        const map = await this.loadIndex(sessionId);
+        const rec = map.get(ref) ?? {
+            ref,
+            state: "pending",
+            attempts: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        rec.state = "indexed";
+        rec.vectorId = vectorId;
+        rec.updatedAt = now;
+        map.set(ref, rec);
+        await this.flush(sessionId);
+    }
+    async markFailed(sessionId, ref, error, now = Date.now()) {
+        const map = await this.loadIndex(sessionId);
+        const rec = map.get(ref) ?? {
+            ref,
+            state: "pending",
+            attempts: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        rec.attempts += 1;
+        rec.lastError = error;
+        rec.updatedAt = now;
+        if (rec.attempts >= this.maxAttempts) {
+            rec.state = "dead";
+            map.set(ref, rec);
+            await this.flush(sessionId);
+            // DLQ
+            await mkdir(this.deadDir(), { recursive: true });
+            const dlqPath = join(this.deadDir(), `${sessionId}.${now}.${rec.ref}.json`);
+            await writeFile(dlqPath, JSON.stringify({ sessionId, record: rec }, null, 2), "utf8");
+        }
+        else {
+            rec.state = "failed";
+            map.set(ref, rec);
+            await this.flush(sessionId);
+        }
+        return rec.state;
+    }
+    async list(sessionId) {
+        const map = await this.loadIndex(sessionId);
+        return [...map.values()];
+    }
+    async listSessions() {
+        if (!existsSync(this.dir))
+            return [];
+        const entries = await readdir(this.dir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile() && extname(entry.name) === ".jsonl")
+            .map((entry) => basename(entry.name, ".jsonl"))
+            .sort();
+    }
+    async listPending(sessionId) {
+        const map = await this.loadIndex(sessionId);
+        return [...map.values()].filter((rec) => rec.state === "pending" || rec.state === "failed");
+    }
+    async pendingCount(sessionId) {
+        const map = await this.loadIndex(sessionId);
+        let n = 0;
+        for (const rec of map.values()) {
+            if (rec.state === "pending" || rec.state === "failed" || rec.state === "retrying")
+                n += 1;
+        }
+        return n;
+    }
+    /** 清空缓存（用于测试模拟进程重启）。 */
+    resetCache() {
+        this.cache.clear();
+    }
+    get directory() {
+        return this.dir;
+    }
+    /** 仅用于内部诊断：用户可拿到 dead 目录路径检查 DLQ。 */
+    get deadLetterDir() {
+        return this.deadDir();
+    }
+    // 兼容 lint/test：保留 dirname 引用以避免 unused import 报错。
+    static dirnameOf(path) {
+        return dirname(path);
+    }
+}
+//# sourceMappingURL=projection-outbox.js.map

package/dist/memory/projection-outbox.js.map

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

package/dist/memory/projection-projector.d.ts

@@ -0,0 +1,16 @@
+import type { AdapterCallContext, EmbeddingRuntime, MemoryEntry, VectorIndexAdapter } from "@tachu/core";
+import type { ProjectionWorkerProjectResult } from "./projection-worker";
+export interface ProjectionProjectorDeps {
+    embedding: EmbeddingRuntime;
+    vectorIndex: VectorIndexAdapter;
+    loadEntry: (sessionId: string, ref: string) => Promise<{
+        entry: MemoryEntry;
+        content: string;
+    } | null>;
+    namespace?: string | undefined;
+}
+/**
+ * embed source text via EmbeddingRuntime, upsert precomputed vectors, mark outbox indexed.
+ */
+export declare function projectMemoryRefs(deps: ProjectionProjectorDeps, sessionId: string, refs: readonly string[], ctx: AdapterCallContext, signal: AbortSignal): Promise<ProjectionWorkerProjectResult[]>;
+//# sourceMappingURL=projection-projector.d.ts.map

package/dist/memory/projection-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-projector.d.ts","sourceRoot":"","sources":["../../src/memory/projection-projector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,CACT,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,uBAAuB,EAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,6BAA6B,EAAE,CAAC,CAyD1C"}

package/dist/memory/projection-projector.js

@@ -0,0 +1,56 @@
+import { createHash } from "node:crypto";
+function contentHash(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+/**
+ * embed source text via EmbeddingRuntime, upsert precomputed vectors, mark outbox indexed.
+ */
+export async function projectMemoryRefs(deps, sessionId, refs, ctx, signal) {
+    const results = [];
+    const profile = deps.embedding.describe();
+    const namespace = deps.namespace ?? sessionId;
+    for (const ref of refs) {
+        signal.throwIfAborted();
+        const loaded = await deps.loadEntry(sessionId, ref);
+        if (!loaded) {
+            throw new Error(`projection source not found for ref ${ref}`);
+        }
+        const { entry, content } = loaded;
+        const hash = contentHash(content);
+        const response = await deps.embedding.embed({
+            model: profile.model,
+            inputs: [content],
+            taskType: "RETRIEVAL_DOCUMENT",
+            ...(profile.dimensions !== undefined
+                ? { outputDimensionality: profile.dimensions }
+                : {}),
+        }, ctx, signal);
+        const vector = response.embeddings[0];
+        if (!vector || vector.length === 0) {
+            throw new Error(`embedding runtime returned empty vector for ref ${ref}`);
+        }
+        const vectorId = `${sessionId}-${entry.timestamp}`;
+        await deps.vectorIndex.upsert([
+            {
+                id: vectorId,
+                vector,
+                payload: {
+                    ref: entry.id,
+                    sourceKind: "memory-entry",
+                    contentHash: hash,
+                    sessionId,
+                    namespace,
+                    role: entry.role,
+                    timestamp: entry.timestamp,
+                    projectionVersion: 1,
+                    embeddingProvider: profile.providerId,
+                    embeddingModel: profile.model,
+                    ...(profile.dimensions !== undefined ? { embeddingDimensions: profile.dimensions } : {}),
+                },
+            },
+        ], ctx, signal);
+        results.push({ ref, vectorId });
+    }
+    return results;
+}
+//# sourceMappingURL=projection-projector.js.map

package/dist/memory/projection-projector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-projector.js","sourceRoot":"","sources":["../../src/memory/projection-projector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmBzC,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA6B,EAC7B,SAAiB,EACjB,IAAuB,EACvB,GAAuB,EACvB,MAAmB;IAEnB,MAAM,OAAO,GAAoC,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAClC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CACzC;YACE,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,CAAC,OAAO,CAAC;YACjB,QAAQ,EAAE,oBAAoB;YAC9B,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS;gBAClC,CAAC,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,UAAU,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,EACD,GAAG,EACH,MAAM,CACP,CAAC;QACF,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mDAAmD,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACnD,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAC3B;YACE;gBACE,EAAE,EAAE,QAAQ;gBACZ,MAAM;gBACN,OAAO,EAAE;oBACP,GAAG,EAAE,KAAK,CAAC,EAAE;oBACb,UAAU,EAAE,cAAc;oBAC1B,WAAW,EAAE,IAAI;oBACjB,SAAS;oBACT,SAAS;oBACT,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,iBAAiB,EAAE,CAAC;oBACpB,iBAAiB,EAAE,OAAO,CAAC,UAAU;oBACrC,cAAc,EAAE,OAAO,CAAC,KAAK;oBAC7B,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzF;aACF;SACF,EACD,GAAG,EACH,MAAM,CACP,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/memory/projection-worker.d.ts

@@ -0,0 +1,28 @@
+import { ProjectionOutbox } from "./projection-outbox";
+export interface ProjectionWorkerProjectResult {
+    ref: string;
+    vectorId: string;
+}
+export interface ProjectionWorkerOptions {
+    outbox: ProjectionOutbox;
+    project: (sessionId: string, refs: readonly string[], signal: AbortSignal) => Promise<ProjectionWorkerProjectResult[] | void>;
+    intervalMs?: number | undefined;
+}
+export interface ProjectionWorkerFlushResult {
+    sessions: number;
+    projected: number;
+    failed: number;
+}
+export declare class ProjectionWorker {
+    private readonly outbox;
+    private readonly project;
+    private readonly intervalMs;
+    private timer;
+    private abortController;
+    private running;
+    constructor(options: ProjectionWorkerOptions);
+    start(): void;
+    stop(): Promise<void>;
+    flush(sessionId?: string): Promise<ProjectionWorkerFlushResult>;
+}
+//# sourceMappingURL=projection-worker.d.ts.map

package/dist/memory/projection-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-worker.d.ts","sourceRoot":"","sources":["../../src/memory/projection-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,6BAA6B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,CACP,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,6BAA6B,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,uBAAuB;IAM5C,KAAK,IAAI,IAAI;IAUP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAqDtE"}

package/dist/memory/projection-worker.js

@@ -0,0 +1,84 @@
+export class ProjectionWorker {
+    outbox;
+    project;
+    intervalMs;
+    timer;
+    abortController;
+    running = false;
+    constructor(options) {
+        this.outbox = options.outbox;
+        this.project = options.project;
+        this.intervalMs = options.intervalMs ?? 1_000;
+    }
+    start() {
+        if (this.timer !== undefined)
+            return;
+        this.abortController = new AbortController();
+        this.timer = setInterval(() => {
+            void this.flush().catch(() => {
+                // Individual projection failures are recorded in the outbox.
+            });
+        }, this.intervalMs);
+    }
+    async stop() {
+        if (this.timer !== undefined) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        this.abortController?.abort();
+        this.abortController = undefined;
+    }
+    async flush(sessionId) {
+        if (this.running) {
+            return { sessions: 0, projected: 0, failed: 0 };
+        }
+        this.running = true;
+        try {
+            const signal = this.abortController?.signal ?? new AbortController().signal;
+            const sessions = sessionId !== undefined ? [sessionId] : await this.outbox.listSessions();
+            let touchedSessions = 0;
+            let projected = 0;
+            let failed = 0;
+            for (const sid of sessions) {
+                await this.outbox.recover(sid);
+                const pending = await this.outbox.listPending(sid);
+                if (pending.length === 0)
+                    continue;
+                touchedSessions += 1;
+                const refs = pending.map((record) => record.ref);
+                for (const ref of refs) {
+                    await this.outbox.markRetrying(sid, ref);
+                }
+                try {
+                    const result = await this.project(sid, refs, signal);
+                    const vectorIds = new Map((result ?? refs.map((ref) => ({ ref, vectorId: `${sid}-${ref}` }))).map((item) => [
+                        item.ref,
+                        item.vectorId,
+                    ]));
+                    for (const ref of refs) {
+                        const vectorId = vectorIds.get(ref);
+                        if (vectorId === undefined) {
+                            failed += 1;
+                            await this.outbox.markFailed(sid, ref, "projection worker did not return vectorId");
+                            continue;
+                        }
+                        await this.outbox.markIndexed(sid, ref, vectorId);
+                        projected += 1;
+                    }
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    failed += refs.length;
+                    for (const ref of refs) {
+                        await this.outbox.markFailed(sid, ref, message);
+                    }
+                }
+            }
+            return { sessions: touchedSessions, projected, failed };
+        }
+        finally {
+            this.running = false;
+        }
+    }
+}
+//# sourceMappingURL=projection-worker.js.map

package/dist/memory/projection-worker.js.map

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

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

@@ -14,41 +14,41 @@ export declare class JsonlEmitter implements ObservabilityEmitter {
     private masker;
     private writeQueue;
     /**
-     * 创建 JSONL 发射器。
-     *
-     * @param options 文件配置
-     */
+    * 创建 JSONL 发射器。
+    *
+    * @param options 文件配置
+    */
     constructor(options: JsonlEmitterOptions);
     /**
-     * 订阅事件。
-     *
-     * @param type 事件类型
-     * @param handler 处理器
-     * @returns 取消订阅函数
-     */
+    * 订阅事件。
+    *
+    * @param type 事件类型
+    * @param handler 处理器
+    * @returns 取消订阅函数
+    */
     on(type: EngineEvent["type"] | "*", handler: EventHandler): () => void;
     /**
-     * 取消订阅。
-     *
-     * @param type 事件类型
-     * @param handler 处理器
-     */
+    * 取消订阅。
+    *
+    * @param type 事件类型
+    * @param handler 处理器
+    */
     off(type: EngineEvent["type"] | "*", handler: EventHandler): void;
     /**
-     * 发射并持久化事件。
-     *
-     * @param event 引擎事件
-     */
+    * 发射并持久化事件。
+    *
+    * @param event 引擎事件
+    */
     emit(event: EngineEvent): void;
     /**
-     * 设置脱敏函数。
-     *
-     * @param masker 脱敏函数
-     */
+    * 设置脱敏函数。
+    *
+    * @param masker 脱敏函数
+    */
     setMasker(masker: (payload: unknown) => unknown): void;
     /**
-     * 等待队列写入完成。
-     */
+    * 等待队列写入完成。
+    */
     dispose(): Promise<void>;
     private emitToSubscribers;
     private append;

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

@@ -1 +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"}
+{"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;IAExC;;;;MAIE;gBACW,OAAO,EAAE,mBAAmB;IAKzC;;;;;;MAME;IACD,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAOvE;;;;;MAKE;IACD,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAQlE;;;;MAIE;IACD,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAS/B;;;;MAIE;IACD,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI;IAIvD;;MAEE;IACK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,OAAO,CAAC,iBAAiB;YASX,MAAM;YAMN,cAAc;CAQ7B"}

package/dist/observability/jsonl-emitter.js

@@ -10,21 +10,21 @@ export class JsonlEmitter {
     masker = (payload) => payload;
     writeQueue = Promise.resolve();
     /**
-     * 创建 JSONL 发射器。
-     *
-     * @param options 文件配置
-     */
+    * 创建 JSONL 发射器。
+    *
+    * @param options 文件配置
+    */
     constructor(options) {
         this.filePath = options.filePath;
         this.rotateSize = options.rotateSize ?? 10 * 1024 * 1024;
     }
     /**
-     * 订阅事件。
-     *
-     * @param type 事件类型
-     * @param handler 处理器
-     * @returns 取消订阅函数
-     */
+    * 订阅事件。
+    *
+    * @param type 事件类型
+    * @param handler 处理器
+    * @returns 取消订阅函数
+    */
     on(type, handler) {
         const bucket = this.handlers.get(type) ?? new Set();
         bucket.add(handler);
@@ -32,11 +32,11 @@ export class JsonlEmitter {
         return () => this.off(type, handler);
     }
     /**
-     * 取消订阅。
-     *
-     * @param type 事件类型
-     * @param handler 处理器
-     */
+    * 取消订阅。
+    *
+    * @param type 事件类型
+    * @param handler 处理器
+    */
     off(type, handler) {
         const bucket = this.handlers.get(type);
         bucket?.delete(handler);
@@ -45,10 +45,10 @@ export class JsonlEmitter {
         }
     }
     /**
-     * 发射并持久化事件。
-     *
-     * @param event 引擎事件
-     */
+    * 发射并持久化事件。
+    *
+    * @param event 引擎事件
+    */
     emit(event) {
         const maskedEvent = {
             ...event,
@@ -58,16 +58,16 @@ export class JsonlEmitter {
         this.writeQueue = this.writeQueue.then(() => this.append(maskedEvent)).catch(() => undefined);
     }
     /**
-     * 设置脱敏函数。
-     *
-     * @param masker 脱敏函数
-     */
+    * 设置脱敏函数。
+    *
+    * @param masker 脱敏函数
+    */
     setMasker(masker) {
         this.masker = masker;
     }
     /**
-     * 等待队列写入完成。
-     */
+    * 等待队列写入完成。
+    */
     async dispose() {
         await this.writeQueue;
     }

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

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

@@ -10,39 +10,39 @@ export declare class OtelEmitter implements ObservabilityEmitter {
     private readonly phaseSpans;
     private masker;
     /**
-     * 创建 OTel 发射器。
-     *
-     * @param options 构造参数
-     */
+    * 创建 OTel 发射器。
+    *
+    * @param options 构造参数
+    */
     constructor(options: {
         tracer: Tracer;
     });
     /**
-     * 订阅事件。
-     *
-     * @param type 事件类型
-     * @param handler 处理器
-     * @returns 取消订阅函数
-     */
+    * 订阅事件。
+    *
+    * @param type 事件类型
+    * @param handler 处理器
+    * @returns 取消订阅函数
+    */
     on(type: EngineEvent["type"] | "*", handler: EventHandler): () => void;
     /**
-     * 取消订阅。
-     *
-     * @param type 事件类型
-     * @param handler 处理器
-     */
+    * 取消订阅。
+    *
+    * @param type 事件类型
+    * @param handler 处理器
+    */
     off(type: EngineEvent["type"] | "*", handler: EventHandler): void;
     /**
-     * 发射事件并映射到 OTel Span。
-     *
-     * @param event 引擎事件
-     */
+    * 发射事件并映射到 OTel Span。
+    *
+    * @param event 引擎事件
+    */
     emit(event: EngineEvent): void;
     /**
-     * 配置 payload 脱敏函数。
-     *
-     * @param masker 脱敏函数
-     */
+    * 配置 payload 脱敏函数。
+    *
+    * @param masker 脱敏函数
+    */
     setMasker(masker: (payload: unknown) => unknown): void;
     private emitToSubscribers;
     private emitToOtel;