evo-skills 0.1.0

package/dist/core/evaluator/rules/repeated-drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeated-drift.js","sourceRoot":"","sources":["../../../../src/core/evaluator/rules/repeated-drift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C;QACE,KAAK,CACH,gBAAgB,EAChB,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,MAAe;QACtB,SAAS;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAE9D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,cAAc;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEnD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,SAAS;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAExD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAE1E,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,aAAa;YAC1B,MAAM,EAAE,kBAAkB,YAAY,CAAC,CAAC,CAAC,iBAAiB,SAAS,iBAAiB,UAAU,CAAC,MAAM,WAAW;YAChH,eAAe,EAAE,UAAU;YAC3B,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAe;QACtC,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,kBAAkB;QAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,UAAU,KAAK,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACxD,YAAY;gBACZ,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,UAAU,KAAK,aAAa;oBAC9B,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;oBAC/B,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;oBACjD,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAC/E,CAAC;gBAEF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACnC,oBAAoB;oBACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;wBACvC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,MAAe,EAAE,YAAsB;QACxD,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,UAAU,KAAK,WAAW,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;gBACrF,eAAe;gBACf,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,UAAU,KAAK,aAAa;oBAC9B,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;oBAC/B,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;oBACjD,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAC/E,CAAC;gBAEF,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,KAAK,EAAE,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/core/evaluator/rules/repeated-manual-fix.d.ts

@@ -0,0 +1,23 @@
+import { BaseRule } from '../base-rule.js';
+import type { Trace, EvaluationResult } from '../../../types/index.js';
+/**
+ * Repeated Manual Fix 规则
+ * 检测用户是否在同类任务中反复手动补充相同步骤
+ */
+export declare class RepeatedManualFixRule extends BaseRule {
+    constructor();
+    evaluate(traces: Trace[]): EvaluationResult | null;
+    /**
+     * 提取用户输入的模式
+     */
+    private extractPatterns;
+    /**
+     * 找出频繁出现的模式
+     */
+    private findFrequentPatterns;
+    /**
+     * 统计助手输出后出现的信号
+     */
+    private countPostAssistantSignals;
+}
+//# sourceMappingURL=repeated-manual-fix.d.ts.map

package/dist/core/evaluator/rules/repeated-manual-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeated-manual-fix.d.ts","sourceRoot":"","sources":["../../../../src/core/evaluator/rules/repeated-manual-fix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEvE;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;;IAQjD,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,gBAAgB,GAAG,IAAI;IA0ClD;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAkClC"}

package/dist/core/evaluator/rules/repeated-manual-fix.js

@@ -0,0 +1,97 @@
+import { BaseRule } from '../base-rule.js';
+/**
+ * Repeated Manual Fix 规则
+ * 检测用户是否在同类任务中反复手动补充相同步骤
+ */
+export class RepeatedManualFixRule extends BaseRule {
+    constructor() {
+        super('repeated-manual-fix', 'Detects when users repeatedly manually supplement the same steps after agent output');
+    }
+    evaluate(traces) {
+        // 查找用户在助手输出后的输入
+        const assistantOutputs = this.filterByEventType(traces, 'assistant_output');
+        const userInputs = this.filterByEventType(traces, 'user_input');
+        if (assistantOutputs.length === 0 || userInputs.length === 0) {
+            return null;
+        }
+        // 分析用户输入中是否有重复的模式
+        const patterns = this.extractPatterns(userInputs);
+        // 找出出现频率最高的模式
+        const frequentPatterns = this.findFrequentPatterns(patterns, 3);
+        if (frequentPatterns.length === 0) {
+            return null;
+        }
+        // 检查这些模式是否出现在助手输出之后
+        const signals = this.countPostAssistantSignals(assistantOutputs, userInputs, frequentPatterns);
+        if (signals.count < 3) {
+            return null;
+        }
+        const sessionIds = this.extractSessionIds(traces);
+        const confidence = this.calculateConfidence(signals.count, sessionIds.length);
+        if (confidence < 0.7) {
+            return null;
+        }
+        return {
+            should_patch: true,
+            change_type: 'add_fallback',
+            reason: `User manually supplemented "${signals.pattern}" in ${signals.count} sessions after agent output`,
+            source_sessions: sessionIds,
+            confidence,
+        };
+    }
+    /**
+     * 提取用户输入的模式
+     */
+    extractPatterns(userInputs) {
+        const patterns = new Map();
+        for (const input of userInputs) {
+            if (!input.user_input)
+                continue;
+            // 简单的模式提取：取前 50 个字符作为模式
+            const pattern = input.user_input.substring(0, 50).toLowerCase().trim();
+            if (pattern.length > 10) {
+                patterns.set(pattern, (patterns.get(pattern) ?? 0) + 1);
+            }
+        }
+        return patterns;
+    }
+    /**
+     * 找出频繁出现的模式
+     */
+    findFrequentPatterns(patterns, minCount) {
+        const result = [];
+        for (const [pattern, count] of patterns.entries()) {
+            if (count >= minCount) {
+                result.push(pattern);
+            }
+        }
+        return result;
+    }
+    /**
+     * 统计助手输出后出现的信号
+     */
+    countPostAssistantSignals(assistantOutputs, userInputs, patterns) {
+        let maxCount = 0;
+        let bestPattern = '';
+        for (const pattern of patterns) {
+            let count = 0;
+            for (const output of assistantOutputs) {
+                // 查找在助手输出后的用户输入
+                const subsequentInputs = userInputs.filter((input) => new Date(input.timestamp) > new Date(output.timestamp) &&
+                    new Date(input.timestamp).getTime() - new Date(output.timestamp).getTime() < 60000 // 1 分钟内
+                );
+                for (const input of subsequentInputs) {
+                    if (input.user_input?.toLowerCase().includes(pattern)) {
+                        count++;
+                    }
+                }
+            }
+            if (count > maxCount) {
+                maxCount = count;
+                bestPattern = pattern;
+            }
+        }
+        return { count: maxCount, pattern: bestPattern };
+    }
+}
+//# sourceMappingURL=repeated-manual-fix.js.map

package/dist/core/evaluator/rules/repeated-manual-fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeated-manual-fix.js","sourceRoot":"","sources":["../../../../src/core/evaluator/rules/repeated-manual-fix.ts"],"names":[],"mappings":"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"}

package/dist/core/journal/index.d.ts

@@ -0,0 +1,76 @@
+import type { EvolutionRecord, JournalQueryOptions } from '../../types/index.js';
+/**
+ * Journal Manager
+ * 负责管理演化日志和版本控制
+ */
+export declare class JournalManager {
+    private db;
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * 初始化数据库
+     */
+    init(): Promise<void>;
+    /**
+     * 记录一次演化
+     */
+    record(shadowId: string, record: Omit<EvolutionRecord, 'revision'>): Promise<number>;
+    /**
+     * 获取 journal
+     */
+    getJournal(shadowId: string): import("../../storage/ndjson.js").JournalStore;
+    /**
+     * 获取 journal 记录
+     */
+    getJournalRecords(shadowId: string, options?: JournalQueryOptions): Promise<EvolutionRecord[]>;
+    /**
+     * 获取最新 revision
+     */
+    getLatestRevision(shadowId: string): Promise<number>;
+    /**
+     * 获取指定 revision 的记录
+     */
+    getRecordByRevision(shadowId: string, revision: number): Promise<EvolutionRecord | null>;
+    /**
+     * 创建 snapshot
+     */
+    createSnapshot(shadowId: string, revision?: number): Promise<void>;
+    /**
+     * 回滚到指定 revision
+     */
+    rollback(shadowId: string, targetRevision: number): Promise<void>;
+    /**
+     * 回滚到上一个 snapshot
+     */
+    rollbackToSnapshot(shadowId: string): Promise<void>;
+    /**
+     * 获取所有 snapshots
+     */
+    getSnapshots(shadowId: string): {
+        id: number;
+        revision: number;
+        timestamp: string;
+        file_path: string;
+        content_hash: string;
+    }[];
+    /**
+     * 获取最新 snapshot
+     */
+    getLatestSnapshot(shadowId: string): {
+        id: number;
+        revision: number;
+        timestamp: string;
+        file_path: string;
+        content_hash: string;
+    } | null;
+    /**
+     * 从 shadowId 提取 skillId
+     */
+    private extractSkillId;
+    /**
+     * 关闭数据库连接
+     */
+    close(): void;
+}
+export declare function createJournalManager(projectRoot: string): JournalManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/journal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/journal/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIjF;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAC;IACX,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAM/B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC;IAuClB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM;IAY3B;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC;IA4B7B;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D;;OAEG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAKlC;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDxE;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvE;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM;;;;;;;IAI7B;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM;;;;;;;IAIlC;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAGD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAExE"}

package/dist/core/journal/index.js

@@ -0,0 +1,207 @@
+import { existsSync, mkdirSync, copyFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createChildLogger } from '../../utils/logger.js';
+import { hashString } from '../../utils/hash.js';
+import { createJournalStore } from '../../storage/ndjson.js';
+import { createSQLiteStorage } from '../../storage/sqlite.js';
+const logger = createChildLogger('journal');
+/**
+ * Journal Manager
+ * 负责管理演化日志和版本控制
+ */
+export class JournalManager {
+    db;
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        const dbPath = join(projectRoot, '.evo', 'state', 'sessions.db');
+        this.db = createSQLiteStorage(dbPath);
+    }
+    /**
+     * 初始化数据库
+     */
+    async init() {
+        await this.db.init();
+    }
+    /**
+     * 记录一次演化
+     */
+    async record(shadowId, record) {
+        // 获取当前 revision
+        const currentRevision = await this.getLatestRevision(shadowId);
+        const newRevision = currentRevision + 1;
+        // 创建完整的演化记录
+        const fullRecord = {
+            ...record,
+            revision: newRevision,
+        };
+        // 写入 journal
+        const journal = this.getJournal(shadowId);
+        journal.append(fullRecord);
+        // 更新数据库索引
+        this.db.addEvolutionRecordIndex({
+            shadow_id: shadowId,
+            revision: newRevision,
+            timestamp: fullRecord.timestamp,
+            change_type: fullRecord.change_type,
+            source_sessions: fullRecord.source_sessions,
+            confidence: 0, // 默认置信度
+        });
+        // 更新 shadow revision
+        const skillId = this.extractSkillId(shadowId);
+        if (skillId) {
+            this.db.updateShadowRevision(shadowId, newRevision);
+        }
+        logger.info(`Evolution recorded: revision ${newRevision}`, {
+            shadow_id: shadowId,
+            change_type: fullRecord.change_type,
+        });
+        return newRevision;
+    }
+    /**
+     * 获取 journal
+     */
+    getJournal(shadowId) {
+        const skillId = this.extractSkillId(shadowId);
+        const journalPath = join(this.projectRoot, '.evo', 'skills', skillId, 'journal.ndjson');
+        return createJournalStore(journalPath);
+    }
+    /**
+     * 获取 journal 记录
+     */
+    async getJournalRecords(shadowId, options) {
+        const journal = this.getJournal(shadowId);
+        const allRecords = await journal.readAll();
+        let filtered = allRecords;
+        if (options?.fromRevision !== undefined) {
+            filtered = filtered.filter((r) => r.revision >= options.fromRevision);
+        }
+        if (options?.toRevision !== undefined) {
+            filtered = filtered.filter((r) => r.revision <= options.toRevision);
+        }
+        if (options?.changeType) {
+            filtered = filtered.filter((r) => r.change_type === options.changeType);
+        }
+        // 按 revision 降序排列
+        filtered.sort((a, b) => b.revision - a.revision);
+        if (options?.limit) {
+            filtered = filtered.slice(0, options.limit);
+        }
+        return filtered;
+    }
+    /**
+     * 获取最新 revision
+     */
+    async getLatestRevision(shadowId) {
+        const journal = this.getJournal(shadowId);
+        return journal.getLatestRevision();
+    }
+    /**
+     * 获取指定 revision 的记录
+     */
+    async getRecordByRevision(shadowId, revision) {
+        const journal = this.getJournal(shadowId);
+        return journal.getByRevision(revision);
+    }
+    /**
+     * 创建 snapshot
+     */
+    async createSnapshot(shadowId, revision) {
+        const skillId = this.extractSkillId(shadowId);
+        const targetRevision = revision ?? (await this.getLatestRevision(shadowId));
+        // 读取当前 shadow 内容
+        const shadowPath = join(this.projectRoot, '.evo', 'skills', skillId, 'current.md');
+        if (!existsSync(shadowPath)) {
+            throw new Error(`Shadow skill not found: ${skillId}`);
+        }
+        // 创建 snapshot 文件
+        const snapshotsDir = join(this.projectRoot, '.evo', 'skills', skillId, 'snapshots');
+        if (!existsSync(snapshotsDir)) {
+            mkdirSync(snapshotsDir, { recursive: true });
+        }
+        const snapshotFileName = `rev_${String(targetRevision).padStart(4, '0')}.md`;
+        const snapshotPath = join(snapshotsDir, snapshotFileName);
+        // 复制当前内容到 snapshot
+        copyFileSync(shadowPath, snapshotPath);
+        // 计算内容哈希
+        const { readFileSync } = require('node:fs');
+        const content = readFileSync(shadowPath, 'utf-8');
+        const contentHash = hashString(content);
+        // 记录到数据库
+        this.db.addSnapshot({
+            shadow_id: shadowId,
+            revision: targetRevision,
+            timestamp: new Date().toISOString(),
+            file_path: snapshotPath,
+            content_hash: contentHash,
+        });
+        logger.info(`Snapshot created: revision ${targetRevision}`, {
+            shadow_id: shadowId,
+            path: snapshotPath,
+        });
+    }
+    /**
+     * 回滚到指定 revision
+     */
+    async rollback(shadowId, targetRevision) {
+        const skillId = this.extractSkillId(shadowId);
+        // 查找 snapshot
+        const snapshots = this.db.getSnapshots(shadowId);
+        const snapshot = snapshots.find((s) => s.revision === targetRevision);
+        if (!snapshot) {
+            throw new Error(`Snapshot not found for revision ${targetRevision}`);
+        }
+        // 复制 snapshot 到当前
+        const shadowPath = join(this.projectRoot, '.evo', 'skills', skillId, 'current.md');
+        copyFileSync(snapshot.file_path, shadowPath);
+        // 更新 revision
+        this.db.updateShadowRevision(shadowId, targetRevision);
+        logger.info(`Rolled back to revision ${targetRevision}`, {
+            shadow_id: shadowId,
+            snapshot_path: snapshot.file_path,
+        });
+    }
+    /**
+     * 回滚到上一个 snapshot
+     */
+    async rollbackToSnapshot(shadowId) {
+        const snapshots = this.db.getSnapshots(shadowId);
+        if (snapshots.length === 0) {
+            throw new Error('No snapshots available');
+        }
+        // 获取最新的 snapshot
+        const latestSnapshot = snapshots[0];
+        await this.rollback(shadowId, latestSnapshot.revision);
+    }
+    /**
+     * 获取所有 snapshots
+     */
+    getSnapshots(shadowId) {
+        return this.db.getSnapshots(shadowId);
+    }
+    /**
+     * 获取最新 snapshot
+     */
+    getLatestSnapshot(shadowId) {
+        return this.db.getLatestSnapshot(shadowId);
+    }
+    /**
+     * 从 shadowId 提取 skillId
+     */
+    extractSkillId(shadowId) {
+        // shadowId 格式: skillId@projectId
+        const parts = shadowId.split('@');
+        return parts[0] || shadowId;
+    }
+    /**
+     * 关闭数据库连接
+     */
+    close() {
+        this.db.close();
+    }
+}
+// 导出工厂函数
+export function createJournalManager(projectRoot) {
+    return new JournalManager(projectRoot);
+}
+//# sourceMappingURL=index.js.map

package/dist/core/journal/index.js.map

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

package/dist/core/observer/base-observer.d.ts

@@ -0,0 +1,64 @@
+import type { Trace, TraceStatus, RuntimeType } from '../../types/index.js';
+/**
+ * Observer 基类
+ * 负责从主 Agent 采集执行 trace
+ */
+export declare abstract class BaseObserver {
+    protected runtime: RuntimeType;
+    protected isRunning: boolean;
+    protected onTraceCallback?: (trace: Trace) => void;
+    constructor(runtime: RuntimeType);
+    /**
+     * 启动 observer
+     */
+    abstract start(): Promise<void>;
+    /**
+     * 停止 observer
+     */
+    abstract stop(): Promise<void>;
+    /**
+     * 注册 trace 回调
+     */
+    onTrace(callback: (trace: Trace) => void): void;
+    /**
+     * 发送 trace
+     */
+    protected emitTrace(trace: Omit<Trace, 'trace_id' | 'runtime'>): void;
+    /**
+     * 创建用户输入 trace
+     */
+    protected createUserInputTrace(sessionId: string, turnId: string, input: string): Omit<Trace, 'trace_id' | 'runtime'>;
+    /**
+     * 创建助手输出 trace
+     */
+    protected createAssistantOutputTrace(sessionId: string, turnId: string, output: string): Omit<Trace, 'trace_id' | 'runtime'>;
+    /**
+     * 创建工具调用 trace
+     */
+    protected createToolCallTrace(sessionId: string, turnId: string, toolName: string, toolArgs: Record<string, unknown>): Omit<Trace, 'trace_id' | 'runtime'>;
+    /**
+     * 创建工具结果 trace
+     */
+    protected createToolResultTrace(sessionId: string, turnId: string, toolName: string, toolResult: Record<string, unknown>, status?: TraceStatus): Omit<Trace, 'trace_id' | 'runtime'>;
+    /**
+     * 创建文件变化 trace
+     */
+    protected createFileChangeTrace(sessionId: string, turnId: string, filesChanged: string[]): Omit<Trace, 'trace_id' | 'runtime'>;
+    /**
+     * 创建重试 trace
+     */
+    protected createRetryTrace(sessionId: string, turnId: string, reason?: string): Omit<Trace, 'trace_id' | 'runtime'>;
+    /**
+     * 创建状态 trace
+     */
+    protected createStatusTrace(sessionId: string, turnId: string, status: TraceStatus, metadata?: Record<string, unknown>): Omit<Trace, 'trace_id' | 'runtime'>;
+    /**
+     * 检查是否正在运行
+     */
+    isActive(): boolean;
+    /**
+     * 获取 runtime 类型
+     */
+    getRuntime(): RuntimeType;
+}
+//# sourceMappingURL=base-observer.d.ts.map

package/dist/core/observer/base-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-observer.d.ts","sourceRoot":"","sources":["../../../src/core/observer/base-observer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAK5E;;;GAGG;AACH,8BAAsB,YAAY;IAChC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC;IAC/B,SAAS,CAAC,SAAS,EAAE,OAAO,CAAS;IACrC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;gBAEvC,OAAO,EAAE,WAAW;IAIhC;;OAEG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI/C;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC,GAAG,IAAI;IAerE;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAWtC;;OAEG;IACH,SAAS,CAAC,0BAA0B,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAWtC;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAYtC;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,GAAE,WAAuB,GAC9B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAYtC;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,GACrB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAWtC;;OAEG;IACH,SAAS,CAAC,gBAAgB,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAWtC;;OAEG;IACH,SAAS,CAAC,iBAAiB,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAWtC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,UAAU,IAAI,WAAW;CAG1B"}

package/dist/core/observer/base-observer.js

@@ -0,0 +1,142 @@
+import { createChildLogger } from '../../utils/logger.js';
+import { v4 as uuidv4 } from 'uuid';
+const logger = createChildLogger('observer');
+/**
+ * Observer 基类
+ * 负责从主 Agent 采集执行 trace
+ */
+export class BaseObserver {
+    runtime;
+    isRunning = false;
+    onTraceCallback;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    /**
+     * 注册 trace 回调
+     */
+    onTrace(callback) {
+        this.onTraceCallback = callback;
+    }
+    /**
+     * 发送 trace
+     */
+    emitTrace(trace) {
+        const fullTrace = {
+            ...trace,
+            trace_id: uuidv4(),
+            runtime: this.runtime,
+        };
+        logger.debug('Trace emitted', {
+            trace_id: fullTrace.trace_id,
+            event_type: fullTrace.event_type,
+        });
+        this.onTraceCallback?.(fullTrace);
+    }
+    /**
+     * 创建用户输入 trace
+     */
+    createUserInputTrace(sessionId, turnId, input) {
+        return {
+            session_id: sessionId,
+            turn_id: turnId,
+            event_type: 'user_input',
+            timestamp: new Date().toISOString(),
+            user_input: input,
+            status: 'success',
+        };
+    }
+    /**
+     * 创建助手输出 trace
+     */
+    createAssistantOutputTrace(sessionId, turnId, output) {
+        return {
+            session_id: sessionId,
+            turn_id: turnId,
+            event_type: 'assistant_output',
+            timestamp: new Date().toISOString(),
+            assistant_output: output,
+            status: 'success',
+        };
+    }
+    /**
+     * 创建工具调用 trace
+     */
+    createToolCallTrace(sessionId, turnId, toolName, toolArgs) {
+        return {
+            session_id: sessionId,
+            turn_id: turnId,
+            event_type: 'tool_call',
+            timestamp: new Date().toISOString(),
+            tool_name: toolName,
+            tool_args: toolArgs,
+            status: 'success',
+        };
+    }
+    /**
+     * 创建工具结果 trace
+     */
+    createToolResultTrace(sessionId, turnId, toolName, toolResult, status = 'success') {
+        return {
+            session_id: sessionId,
+            turn_id: turnId,
+            event_type: 'tool_result',
+            timestamp: new Date().toISOString(),
+            tool_name: toolName,
+            tool_result: toolResult,
+            status,
+        };
+    }
+    /**
+     * 创建文件变化 trace
+     */
+    createFileChangeTrace(sessionId, turnId, filesChanged) {
+        return {
+            session_id: sessionId,
+            turn_id: turnId,
+            event_type: 'file_change',
+            timestamp: new Date().toISOString(),
+            files_changed: filesChanged,
+            status: 'success',
+        };
+    }
+    /**
+     * 创建重试 trace
+     */
+    createRetryTrace(sessionId, turnId, reason) {
+        return {
+            session_id: sessionId,
+            turn_id: turnId,
+            event_type: 'retry',
+            timestamp: new Date().toISOString(),
+            status: 'retry',
+            metadata: reason ? { reason } : undefined,
+        };
+    }
+    /**
+     * 创建状态 trace
+     */
+    createStatusTrace(sessionId, turnId, status, metadata) {
+        return {
+            session_id: sessionId,
+            turn_id: turnId,
+            event_type: 'status',
+            timestamp: new Date().toISOString(),
+            status,
+            metadata,
+        };
+    }
+    /**
+     * 检查是否正在运行
+     */
+    isActive() {
+        return this.isRunning;
+    }
+    /**
+     * 获取 runtime 类型
+     */
+    getRuntime() {
+        return this.runtime;
+    }
+}
+//# sourceMappingURL=base-observer.js.map

package/dist/core/observer/base-observer.js.map

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