kagent-ts 0.1.3 → 0.1.5

package/dist/rag/vector-store.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * In-memory vector store with cosine similarity search.
+ *
+ * Zero external dependencies — pure TypeScript implementation suitable
+ * for knowledge bases with up to ~10K chunks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryVectorStore = void 0;
+exports.cosineSimilarity = cosineSimilarity;
+/**
+ * An in-memory vector store backed by a simple array.
+ *
+ * Search uses brute-force cosine similarity, which is fast enough
+ * for typical knowledge base sizes (a few thousand chunks).
+ */
+class InMemoryVectorStore {
+    chunks = [];
+    async add(chunks) {
+        this.chunks.push(...chunks);
+    }
+    get size() {
+        return this.chunks.length;
+    }
+    async clear() {
+        this.chunks = [];
+    }
+    /**
+     * Search for the top-K most similar chunks via cosine similarity.
+     *
+     * Returns results sorted by similarity score descending (best match first).
+     * Chunks with near-zero-norm embeddings are excluded from results.
+     */
+    async search(queryEmbedding, topK) {
+        if (this.chunks.length === 0)
+            return [];
+        const results = [];
+        for (const chunk of this.chunks) {
+            const score = cosineSimilarity(queryEmbedding, chunk.embedding);
+            if (score > 0) {
+                results.push({ chunk, score });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, topK);
+    }
+}
+exports.InMemoryVectorStore = InMemoryVectorStore;
+// ─── Cosine similarity ───────────────────────────────────────────────────────
+/**
+ * Compute cosine similarity between two vectors.
+ *
+ * Returns a value in [0, 1] for non-negative embeddings (the usual case),
+ * or [-1, 1] in the general case. Returns 0 for zero-norm vectors.
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dotProduct / denominator;
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/rag/vector-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.js","sourceRoot":"","sources":["../../src/rag/vector-store.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAwDH,4CAoBC;AAxED;;;;;GAKG;AACH,MAAa,mBAAmB;IACtB,MAAM,GAAe,EAAE,CAAC;IAEhC,KAAK,CAAC,GAAG,CAAC,MAAkB;QAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,cAAwB,EAAE,IAAY;QACjD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAExC,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,gBAAgB,CAAC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAChE,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AApCD,kDAoCC;AAED,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,8BAA8B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CACxD,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,OAAO,UAAU,GAAG,WAAW,CAAC;AAClC,CAAC"}

package/dist/reflection/error-notebook.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Category of an error found during reflection.
+ */
+export type ReflectionErrorCategory = "reasoning_error" | "tool_misuse" | "missed_optimization" | "incomplete_answer" | "hallucination" | "context_mismanagement" | "other";
+/**
+ * A single entry in the error notebook (错题本).
+ */
+export interface ErrorNotebookEntry {
+    id: string;
+    sessionId: string;
+    timestamp: string;
+    category: ReflectionErrorCategory;
+    description: string;
+    cause: string;
+    suggestion: string;
+    userQuery?: string;
+    relatedTraceIds?: string[];
+}
+/**
+ * Configuration for the ErrorNotebook.
+ */
+export interface ErrorNotebookConfig {
+    /** Directory where notebook entries are stored. Default: ".error-notebook". */
+    storageDir?: string;
+    /** Max entries to keep. Default: 200. */
+    maxEntries?: number;
+}
+/**
+ * Error Notebook (错题本) — persistent record of mistakes discovered
+ * during post-execution reflection.
+ *
+ * Storage layout:
+ * ```
+ * .error-notebook/
+ *   index.json          ← lightweight index (id, sessionId, category, description)
+ *   entries/
+ *     nb_xxx.json        ← full entry, one file per entry
+ * ```
+ *
+ * The index is always kept in memory and written on every mutation.
+ * Individual entry files are loaded lazily (only when querying by session,
+ * category, or building the rules prompt).
+ */
+export declare class ErrorNotebook {
+    private index;
+    private storageDir;
+    private entriesDir;
+    private indexFile;
+    private maxEntries;
+    constructor(config?: ErrorNotebookConfig);
+    /**
+     * Add an entry to the notebook.
+     */
+    add(entry: Omit<ErrorNotebookEntry, "id" | "timestamp">): ErrorNotebookEntry;
+    /**
+     * Add multiple entries at once.
+     */
+    addMany(entries: Array<Omit<ErrorNotebookEntry, "id" | "timestamp">>): void;
+    /**
+     * Remove an entry by ID.
+     */
+    remove(id: string): boolean;
+    /**
+     * Get all entries (loads full data from disk).
+     */
+    getAll(): ErrorNotebookEntry[];
+    /**
+     * Get entries for a specific session.
+     */
+    getBySession(sessionId: string): ErrorNotebookEntry[];
+    /**
+     * Get recent entries (most recent first).
+     */
+    getRecent(limit?: number): ErrorNotebookEntry[];
+    /**
+     * Get entries by category.
+     */
+    getByCategory(category: ReflectionErrorCategory): ErrorNotebookEntry[];
+    /**
+     * Total number of entries.
+     */
+    get count(): number;
+    /**
+     * Category distribution.
+     */
+    getCategoryStats(): Record<ReflectionErrorCategory, number>;
+    /**
+     * Build a compact prompt section from recent entries.
+     *
+     * The content is LLM-generated (via ReflectionAgent), so it is wrapped
+     * with {@link wrapUntrusted} boundary markers and scanned for prompt-
+     * injection signatures before being returned. This prevents the LLM
+     * from accidentally poisoning its own system prompt via the notebook.
+     */
+    buildRulesPrompt(maxEntries?: number, minRepetitions?: number): string;
+    private entryPath;
+    private ensureDirs;
+    private persistIndex;
+    private loadIndex;
+    /**
+     * Load a single full entry from its individual file.
+     * Returns null if the file is missing or corrupt.
+     */
+    private loadEntry;
+    /**
+     * Load full entry data for a slice of the index.
+     */
+    private loadFullEntries;
+    /**
+     * Prune the oldest entries if over maxEntries.
+     * Also cleans up orphaned individual entry files that aren't referenced
+     * by the current index.
+     */
+    private pruneIfNeeded;
+    /**
+     * Clean up orphaned entry files (files not referenced by the index).
+     * Call this during construction to recover from partial writes.
+     */
+    private cleanupOrphans;
+    /**
+     * Generate a human-readable markdown report.
+     */
+    generateMarkdownReport(): string;
+}
+//# sourceMappingURL=error-notebook.d.ts.map

package/dist/reflection/error-notebook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-notebook.d.ts","sourceRoot":"","sources":["../../src/reflection/error-notebook.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,iBAAiB,GACjB,aAAa,GACb,qBAAqB,GACrB,mBAAmB,GACnB,eAAe,GACf,uBAAuB,GACvB,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2BD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,CAAC,EAAE,mBAAmB;IAWxC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,kBAAkB;IA6B5E;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC,GAAG,IAAI;IAI3E;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAe3B;;OAEG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAKrD;;OAEG;IACH,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,kBAAkB,EAAE;IAOnD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,uBAAuB,GAAG,kBAAkB,EAAE;IAKtE;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC;IAU3D;;;;;;;OAOG;IACH,gBAAgB,CAAC,UAAU,GAAE,MAAW,EAAE,cAAc,GAAE,MAAU,GAAG,MAAM;IAkD7E,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,SAAS;IASjB;;;OAGG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAYrB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,sBAAsB,IAAI,MAAM;CAiCjC"}

package/dist/reflection/error-notebook.js

@@ -0,0 +1,368 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorNotebook = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const boundaries_1 = require("../security/boundaries");
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function generateId() {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    let id = "nb_";
+    for (let i = 0; i < 12; i++)
+        id += chars[Math.floor(Math.random() * chars.length)];
+    return id;
+}
+function nowISO() {
+    return new Date().toISOString();
+}
+// ─── ErrorNotebook ───────────────────────────────────────────────────────────
+/**
+ * Error Notebook (错题本) — persistent record of mistakes discovered
+ * during post-execution reflection.
+ *
+ * Storage layout:
+ * ```
+ * .error-notebook/
+ *   index.json          ← lightweight index (id, sessionId, category, description)
+ *   entries/
+ *     nb_xxx.json        ← full entry, one file per entry
+ * ```
+ *
+ * The index is always kept in memory and written on every mutation.
+ * Individual entry files are loaded lazily (only when querying by session,
+ * category, or building the rules prompt).
+ */
+class ErrorNotebook {
+    index = [];
+    storageDir;
+    entriesDir;
+    indexFile;
+    maxEntries;
+    constructor(config) {
+        this.storageDir = path.resolve(config?.storageDir ?? ".error-notebook");
+        this.entriesDir = path.join(this.storageDir, "entries");
+        this.indexFile = path.join(this.storageDir, "index.json");
+        this.maxEntries = config?.maxEntries ?? 200;
+        this.ensureDirs();
+        this.loadIndex();
+    }
+    // ─── Write ──────────────────────────────────────────────────────────────
+    /**
+     * Add an entry to the notebook.
+     */
+    add(entry) {
+        const full = {
+            ...entry,
+            id: generateId(),
+            timestamp: nowISO(),
+        };
+        // Write individual entry file
+        const filePath = this.entryPath(full.id);
+        fs.writeFileSync(filePath, JSON.stringify(full, null, 2), "utf-8");
+        // Update in-memory index
+        this.index.push({
+            id: full.id,
+            sessionId: full.sessionId,
+            timestamp: full.timestamp,
+            category: full.category,
+            description: full.description,
+        });
+        // Prune oldest if over limit
+        this.pruneIfNeeded();
+        // Persist index
+        this.persistIndex();
+        return full;
+    }
+    /**
+     * Add multiple entries at once.
+     */
+    addMany(entries) {
+        for (const e of entries)
+            this.add(e);
+    }
+    /**
+     * Remove an entry by ID.
+     */
+    remove(id) {
+        const idx = this.index.findIndex((e) => e.id === id);
+        if (idx === -1)
+            return false;
+        // Remove individual file
+        try {
+            fs.unlinkSync(this.entryPath(id));
+        }
+        catch { /* already gone */ }
+        // Remove from index
+        this.index.splice(idx, 1);
+        this.persistIndex();
+        return true;
+    }
+    // ─── Read ───────────────────────────────────────────────────────────────
+    /**
+     * Get all entries (loads full data from disk).
+     */
+    getAll() {
+        return this.loadFullEntries(this.index);
+    }
+    /**
+     * Get entries for a specific session.
+     */
+    getBySession(sessionId) {
+        const matches = this.index.filter((e) => e.sessionId === sessionId);
+        return this.loadFullEntries(matches);
+    }
+    /**
+     * Get recent entries (most recent first).
+     */
+    getRecent(limit = 20) {
+        const recent = [...this.index]
+            .sort((a, b) => b.timestamp.localeCompare(a.timestamp))
+            .slice(0, limit);
+        return this.loadFullEntries(recent);
+    }
+    /**
+     * Get entries by category.
+     */
+    getByCategory(category) {
+        const matches = this.index.filter((e) => e.category === category);
+        return this.loadFullEntries(matches);
+    }
+    /**
+     * Total number of entries.
+     */
+    get count() {
+        return this.index.length;
+    }
+    /**
+     * Category distribution.
+     */
+    getCategoryStats() {
+        const stats = {};
+        for (const e of this.index) {
+            stats[e.category] = (stats[e.category] || 0) + 1;
+        }
+        return stats;
+    }
+    // ─── Prompt Injection ───────────────────────────────────────────────────
+    /**
+     * Build a compact prompt section from recent entries.
+     *
+     * The content is LLM-generated (via ReflectionAgent), so it is wrapped
+     * with {@link wrapUntrusted} boundary markers and scanned for prompt-
+     * injection signatures before being returned. This prevents the LLM
+     * from accidentally poisoning its own system prompt via the notebook.
+     */
+    buildRulesPrompt(maxEntries = 10, minRepetitions = 1) {
+        // Group by (category, description) to count repetitions — uses index only
+        const grouped = new Map();
+        for (const e of this.index) {
+            const key = `${e.category}::${e.description}`;
+            const existing = grouped.get(key);
+            if (existing) {
+                existing.count++;
+            }
+            else {
+                grouped.set(key, { entry: e, count: 1 });
+            }
+        }
+        const filtered = Array.from(grouped.values())
+            .filter((g) => g.count >= minRepetitions)
+            .slice(-maxEntries)
+            .reverse();
+        if (filtered.length === 0)
+            return "";
+        const lines = [
+            "=== Error Notebook (错题本) ===",
+            "These mistakes were discovered during previous sessions. Learn from them.",
+            "",
+        ];
+        for (const { entry, count } of filtered) {
+            // Load full entry to get the suggestion
+            const full = this.loadEntry(entry.id);
+            const cat = formatCategory(entry.category);
+            const rep = count > 1 ? ` (×${count})` : "";
+            lines.push(`**${cat}${rep}**: ${full?.suggestion ?? entry.description}`);
+        }
+        const body = lines.join("\n");
+        // Scan for prompt-injection signatures in LLM-generated content.
+        // The notebook is authored by the LLM itself — it could accidentally
+        // (or adversarially) produce injection text that poisons future runs.
+        const patterns = (0, boundaries_1.detectInjectionSignatures)(body);
+        const warning = (0, boundaries_1.buildInjectionWarning)(patterns, "error notebook");
+        // Wrap as untrusted data (LLM-authored, not user-authored)
+        const wrapped = (0, boundaries_1.wrapUntrusted)("error-notebook", body);
+        return "\n\n" + warning + wrapped;
+    }
+    // ─── Persistence ────────────────────────────────────────────────────────
+    entryPath(id) {
+        return path.join(this.entriesDir, `${id}.json`);
+    }
+    ensureDirs() {
+        if (!fs.existsSync(this.storageDir)) {
+            fs.mkdirSync(this.storageDir, { recursive: true });
+        }
+        if (!fs.existsSync(this.entriesDir)) {
+            fs.mkdirSync(this.entriesDir, { recursive: true });
+        }
+    }
+    persistIndex() {
+        fs.writeFileSync(this.indexFile, JSON.stringify(this.index, null, 2), "utf-8");
+    }
+    loadIndex() {
+        try {
+            const raw = fs.readFileSync(this.indexFile, "utf-8");
+            this.index = JSON.parse(raw);
+        }
+        catch {
+            this.index = [];
+        }
+    }
+    /**
+     * Load a single full entry from its individual file.
+     * Returns null if the file is missing or corrupt.
+     */
+    loadEntry(id) {
+        try {
+            const raw = fs.readFileSync(this.entryPath(id), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load full entry data for a slice of the index.
+     */
+    loadFullEntries(subset) {
+        const results = [];
+        for (const idx of subset) {
+            const full = this.loadEntry(idx.id);
+            if (full)
+                results.push(full);
+        }
+        return results;
+    }
+    /**
+     * Prune the oldest entries if over maxEntries.
+     * Also cleans up orphaned individual entry files that aren't referenced
+     * by the current index.
+     */
+    pruneIfNeeded() {
+        const excess = this.index.length - this.maxEntries;
+        if (excess <= 0)
+            return;
+        // Index is append-only, so oldest entries are at the front
+        const toRemove = this.index.splice(0, excess);
+        for (const { id } of toRemove) {
+            try {
+                fs.unlinkSync(this.entryPath(id));
+            }
+            catch { /* ok */ }
+        }
+    }
+    /**
+     * Clean up orphaned entry files (files not referenced by the index).
+     * Call this during construction to recover from partial writes.
+     */
+    cleanupOrphans() {
+        let entryFiles;
+        try {
+            entryFiles = fs.readdirSync(this.entriesDir);
+        }
+        catch {
+            return;
+        }
+        const referenced = new Set(this.index.map((e) => `${e.id}.json`));
+        for (const file of entryFiles) {
+            if (!file.endsWith(".json"))
+                continue;
+            if (!referenced.has(file)) {
+                try {
+                    fs.unlinkSync(path.join(this.entriesDir, file));
+                }
+                catch { /* ok */ }
+            }
+        }
+    }
+    // ─── Markdown Report ─────────────────────────────────────────────────────
+    /**
+     * Generate a human-readable markdown report.
+     */
+    generateMarkdownReport() {
+        const entries = this.getRecent(100);
+        if (entries.length === 0) {
+            return "# Error Notebook Report\n\n*No errors recorded. Keep up the good work!*\n";
+        }
+        const stats = this.getCategoryStats();
+        let report = `# Error Notebook Report (错题本)\n\n`;
+        report += `- **Total entries:** ${this.count}\n`;
+        report += `- **Generated:** ${nowISO()}\n\n`;
+        report += `## Category Distribution\n\n| Category | Count |\n|----------|------|\n`;
+        for (const [cat, count] of Object.entries(stats)) {
+            report += `| ${formatCategory(cat)} | ${count} |\n`;
+        }
+        report += `\n---\n\n## Recent Entries\n\n`;
+        for (const e of entries) {
+            report += `### ${e.id} — ${formatCategory(e.category)}\n\n`;
+            report += `- **Session:** \`${e.sessionId}\`\n`;
+            report += `- **Time:** ${e.timestamp}\n`;
+            report += `- **Description:** ${e.description}\n`;
+            report += `- **Cause:** ${e.cause}\n`;
+            report += `- **Suggestion:** ${e.suggestion}\n`;
+            if (e.userQuery)
+                report += `- **User Query:** ${e.userQuery}\n`;
+            if (e.relatedTraceIds?.length) {
+                report += `- **Related Traces:** ${e.relatedTraceIds.join(", ")}\n`;
+            }
+            report += `\n`;
+        }
+        return report;
+    }
+}
+exports.ErrorNotebook = ErrorNotebook;
+// ─── Formatting ──────────────────────────────────────────────────────────────
+function formatCategory(cat) {
+    switch (cat) {
+        case "reasoning_error": return "🧠 Reasoning Error";
+        case "tool_misuse": return "🔧 Tool Misuse";
+        case "missed_optimization": return "⚡ Missed Optimization";
+        case "incomplete_answer": return "📝 Incomplete Answer";
+        case "hallucination": return "💭 Hallucination";
+        case "context_mismanagement": return "📋 Context Mismanagement";
+        case "other": return "❓ Other";
+    }
+}
+//# sourceMappingURL=error-notebook.js.map

package/dist/reflection/error-notebook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-notebook.js","sourceRoot":"","sources":["../../src/reflection/error-notebook.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,uDAIgC;AAmDhC,gFAAgF;AAEhF,SAAS,UAAU;IACjB,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,IAAI,EAAE,GAAG,KAAK,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,MAAa,aAAa;IAChB,KAAK,GAAiB,EAAE,CAAC;IACzB,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,SAAS,CAAS;IAClB,UAAU,CAAS;IAE3B,YAAY,MAA4B;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,IAAI,iBAAiB,CAAC,CAAC;QACxE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,GAAG,CAAC;QAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACH,GAAG,CAAC,KAAmD;QACrD,MAAM,IAAI,GAAuB;YAC/B,GAAG,KAAK;YACR,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS,EAAE,MAAM,EAAE;SACpB,CAAC;QAEF,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAEnE,yBAAyB;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;QAEH,6BAA6B;QAC7B,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,gBAAgB;QAChB,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAA4D;QAClE,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAE7B,yBAAyB;QACzB,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAEvE,oBAAoB;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAiB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB,EAAE;QAC1B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;aAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;aACtD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAiC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,KAAgD,CAAC;IAC1D,CAAC;IAED,2EAA2E;IAE3E;;;;;;;OAOG;IACH,gBAAgB,CAAC,aAAqB,EAAE,EAAE,iBAAyB,CAAC;QAClE,0EAA0E;QAC1E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgD,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aAC1C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,cAAc,CAAC;aACxC,KAAK,CAAC,CAAC,UAAU,CAAC;aAClB,OAAO,EAAE,CAAC;QAEb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,KAAK,GAAG;YACZ,8BAA8B;YAC9B,2EAA2E;YAC3E,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;YACxC,wCAAwC;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,OAAO,IAAI,EAAE,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,iEAAiE;QACjE,qEAAqE;QACrE,sEAAsE;QACtE,MAAM,QAAQ,GAAG,IAAA,sCAAyB,EAAC,IAAI,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAA,kCAAqB,EAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAElE,2DAA2D;QAC3D,MAAM,OAAO,GAAG,IAAA,0BAAa,EAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAEtD,OAAO,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACpC,CAAC;IAED,2EAA2E;IAEnE,SAAS,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAEO,SAAS;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,SAAS,CAAC,EAAU;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAoB;QAC1C,MAAM,OAAO,GAAyB,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACK,aAAa;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;QACnD,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO;QAExB,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAE9C,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,cAAc;QACpB,IAAI,UAAoB,CAAC;QACzB,IAAI,CAAC;YACH,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAE5E;;OAEG;IACH,sBAAsB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,2EAA2E,CAAC;QACrF,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtC,IAAI,MAAM,GAAG,mCAAmC,CAAC;QACjD,MAAM,IAAI,wBAAwB,IAAI,CAAC,KAAK,IAAI,CAAC;QACjD,MAAM,IAAI,oBAAoB,MAAM,EAAE,MAAM,CAAC;QAE7C,MAAM,IAAI,yEAAyE,CAAC;QACpF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,cAAc,CAAC,GAA8B,CAAC,MAAM,KAAK,MAAM,CAAC;QACjF,CAAC;QAED,MAAM,IAAI,gCAAgC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,OAAO,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC5D,MAAM,IAAI,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC;YAChD,MAAM,IAAI,eAAe,CAAC,CAAC,SAAS,IAAI,CAAC;YACzC,MAAM,IAAI,sBAAsB,CAAC,CAAC,WAAW,IAAI,CAAC;YAClD,MAAM,IAAI,gBAAgB,CAAC,CAAC,KAAK,IAAI,CAAC;YACtC,MAAM,IAAI,qBAAqB,CAAC,CAAC,UAAU,IAAI,CAAC;YAChD,IAAI,CAAC,CAAC,SAAS;gBAAE,MAAM,IAAI,qBAAqB,CAAC,CAAC,SAAS,IAAI,CAAC;YAChE,IAAI,CAAC,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;gBAC9B,MAAM,IAAI,yBAAyB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACtE,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzTD,sCAyTC;AAED,gFAAgF;AAEhF,SAAS,cAAc,CAAC,GAA4B;IAClD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,iBAAiB,CAAC,CAAO,OAAO,oBAAoB,CAAC;QAC1D,KAAK,aAAa,CAAC,CAAW,OAAO,gBAAgB,CAAC;QACtD,KAAK,qBAAqB,CAAC,CAAG,OAAO,uBAAuB,CAAC;QAC7D,KAAK,mBAAmB,CAAC,CAAK,OAAO,sBAAsB,CAAC;QAC5D,KAAK,eAAe,CAAC,CAAS,OAAO,kBAAkB,CAAC;QACxD,KAAK,uBAAuB,CAAC,CAAC,OAAO,0BAA0B,CAAC;QAChE,KAAK,OAAO,CAAC,CAAiB,OAAO,SAAS,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/reflection/index.d.ts

@@ -0,0 +1,8 @@
+export { ErrorNotebook } from "./error-notebook";
+export type { ErrorNotebookEntry, ErrorNotebookConfig, ReflectionErrorCategory, } from "./error-notebook";
+export { ReflectionAgent } from "./reflection-agent";
+export type { ReflectionAgentConfig, ReflectionInput, ReflectionFinding, } from "./reflection-agent";
+export { MemoryReflector } from "./memory-reflector";
+export type { MemoryReflectorConfig, MemoryReflectionInput, ExtractedMemory, } from "./memory-reflector";
+export { createReflectionHook } from "./reflection-hook";
+//# sourceMappingURL=index.d.ts.map

package/dist/reflection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reflection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/reflection/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReflectionHook = exports.MemoryReflector = exports.ReflectionAgent = exports.ErrorNotebook = void 0;
+var error_notebook_1 = require("./error-notebook");
+Object.defineProperty(exports, "ErrorNotebook", { enumerable: true, get: function () { return error_notebook_1.ErrorNotebook; } });
+var reflection_agent_1 = require("./reflection-agent");
+Object.defineProperty(exports, "ReflectionAgent", { enumerable: true, get: function () { return reflection_agent_1.ReflectionAgent; } });
+var memory_reflector_1 = require("./memory-reflector");
+Object.defineProperty(exports, "MemoryReflector", { enumerable: true, get: function () { return memory_reflector_1.MemoryReflector; } });
+var reflection_hook_1 = require("./reflection-hook");
+Object.defineProperty(exports, "createReflectionHook", { enumerable: true, get: function () { return reflection_hook_1.createReflectionHook; } });
+//# sourceMappingURL=index.js.map

package/dist/reflection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reflection/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAMtB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAMxB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAMxB,qDAAyD;AAAhD,uHAAA,oBAAoB,OAAA"}