@cogitator-ai/core 0.1.0 → 0.3.0

package/dist/reasoning/prompts.js

@@ -0,0 +1,161 @@
+export function buildBranchGenerationPrompt(goal, currentNode, availableTools, k, exploredThoughts) {
+    const stateSection = currentNode
+        ? `CURRENT STATE:
+Previous thought: ${currentNode.branch.thought}
+Previous action: ${JSON.stringify(currentNode.branch.proposedAction)}
+Result: ${currentNode.result?.response ?? currentNode.result?.error ?? 'pending'}
+Depth: ${currentNode.depth}`
+        : 'CURRENT STATE: Starting fresh';
+    const exploredSection = exploredThoughts.length > 0
+        ? `\nALREADY EXPLORED (avoid similar approaches):\n${exploredThoughts.map((t) => `- ${t}`).join('\n')}`
+        : '';
+    return `You are exploring different approaches to solve a problem.
+
+GOAL: ${goal}
+
+${stateSection}
+${exploredSection}
+
+AVAILABLE TOOLS: ${availableTools.join(', ')}
+
+Generate exactly ${k} DIFFERENT approaches to make progress toward the goal.
+Each approach should be genuinely distinct - don't just vary parameters slightly.
+
+For each approach, provide:
+1. THOUGHT: Your reasoning for this approach (2-3 sentences explaining WHY this might work)
+2. ACTION: One of:
+   - tool_call: Use a specific tool
+   - response: Provide a direct answer
+   - sub_goal: Break down into a smaller goal
+
+Respond ONLY with valid JSON (no markdown):
+{
+  "branches": [
+    {
+      "thought": "reasoning for this approach...",
+      "action": {
+        "type": "tool_call",
+        "toolName": "tool_name",
+        "arguments": {}
+      }
+    },
+    {
+      "thought": "different reasoning...",
+      "action": {
+        "type": "response",
+        "content": "direct answer if applicable"
+      }
+    }
+  ]
+}`;
+}
+export function buildBranchEvaluationPrompt(branch, goal, siblings) {
+    const siblingsSection = siblings.length > 0
+        ? `\nOTHER APPROACHES BEING CONSIDERED:\n${siblings.map((s) => `- ${s.thought}`).join('\n')}`
+        : '';
+    return `Evaluate this approach for solving a problem.
+
+GOAL: ${goal}
+
+PROPOSED APPROACH:
+Thought: ${branch.thought}
+Action: ${JSON.stringify(branch.proposedAction)}
+${siblingsSection}
+
+Evaluate this approach on these dimensions:
+1. CONFIDENCE (0.0-1.0): How likely is this approach to make progress?
+2. PROGRESS (0.0-1.0): How much of the goal would this step complete?
+3. NOVELTY (0.0-1.0): How different is this from the other approaches?
+4. FEASIBILITY: Can this action actually be executed successfully?
+
+Respond ONLY with valid JSON (no markdown):
+{
+  "confidence": 0.7,
+  "progress": 0.3,
+  "novelty": 0.8,
+  "reasoning": "brief explanation of the evaluation"
+}`;
+}
+export function buildSynthesisPrompt(goal, path) {
+    const pathSummary = path
+        .map((node, i) => {
+        const result = node.result?.response ?? node.result?.error ?? 'no result';
+        return `Step ${i + 1}:
+  Thought: ${node.branch.thought}
+  Action: ${JSON.stringify(node.branch.proposedAction)}
+  Result: ${result}`;
+    })
+        .join('\n\n');
+    return `Synthesize a final answer based on the explored path.
+
+ORIGINAL GOAL: ${goal}
+
+EXPLORATION PATH:
+${pathSummary}
+
+Based on this exploration, provide the best possible answer to the original goal.
+Focus on synthesizing the insights from each step into a coherent response.
+
+Respond with your final answer:`;
+}
+export function parseBranchResponse(response) {
+    try {
+        let cleaned = response.trim();
+        if (cleaned.startsWith('```json')) {
+            cleaned = cleaned.slice(7);
+        }
+        else if (cleaned.startsWith('```')) {
+            cleaned = cleaned.slice(3);
+        }
+        if (cleaned.endsWith('```')) {
+            cleaned = cleaned.slice(0, -3);
+        }
+        cleaned = cleaned.trim();
+        const parsed = JSON.parse(cleaned);
+        if (!Array.isArray(parsed.branches)) {
+            return null;
+        }
+        parsed.branches = parsed.branches.filter((b) => {
+            if (!b || typeof b !== 'object')
+                return false;
+            if (typeof b.thought !== 'string' || !b.thought)
+                return false;
+            if (!b.action || typeof b.action !== 'object')
+                return false;
+            if (!['tool_call', 'response', 'sub_goal'].includes(b.action.type))
+                return false;
+            return true;
+        });
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function parseEvaluationResponse(response) {
+    try {
+        let cleaned = response.trim();
+        if (cleaned.startsWith('```json')) {
+            cleaned = cleaned.slice(7);
+        }
+        else if (cleaned.startsWith('```')) {
+            cleaned = cleaned.slice(3);
+        }
+        if (cleaned.endsWith('```')) {
+            cleaned = cleaned.slice(0, -3);
+        }
+        cleaned = cleaned.trim();
+        const parsed = JSON.parse(cleaned);
+        const clamp = (n) => Math.max(0, Math.min(1, n));
+        return {
+            confidence: typeof parsed.confidence === 'number' ? clamp(parsed.confidence) : 0.5,
+            progress: typeof parsed.progress === 'number' ? clamp(parsed.progress) : 0.3,
+            novelty: typeof parsed.novelty === 'number' ? clamp(parsed.novelty) : 0.5,
+            reasoning: typeof parsed.reasoning === 'string' ? parsed.reasoning : '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/reasoning/prompts.js.map

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

package/dist/reasoning/thought-tree.d.ts

@@ -0,0 +1,32 @@
+import type { ToTConfig, ToTResult, ToTRunOptions, Agent } from '@cogitator-ai/types';
+import type { Cogitator } from '../cogitator';
+export declare class ThoughtTreeExecutor {
+    private cogitator;
+    private config;
+    private branchGenerator;
+    private branchEvaluator;
+    private currentModel;
+    private nodes;
+    private stats;
+    constructor(cogitator: Cogitator, config?: Partial<ToTConfig>);
+    explore(agent: Agent, goal: string, options?: ToTRunOptions): Promise<ToTResult>;
+    private createRootNode;
+    private expandNode;
+    private buildNodePrompt;
+    private shouldTerminate;
+    private backtrack;
+    private findBestNode;
+    private getPathToNode;
+    private getExploredThoughts;
+    private createResult;
+    private synthesizeOutput;
+    private fallbackSynthesis;
+    private buildAgentContext;
+    private getLLMBackend;
+    private cachedLLM?;
+    private getLLMBackendFromCache;
+    private parseModel;
+    private getReflectionEngine;
+    private createInitialStats;
+}
+//# sourceMappingURL=thought-tree.d.ts.map

package/dist/reasoning/thought-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought-tree.d.ts","sourceRoot":"","sources":["../../src/reasoning/thought-tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EAET,aAAa,EAIb,KAAK,EAGN,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU9C,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAWV;IACJ,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,YAAY,CAAc;IAElC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,KAAK,CAAuC;gBAExC,SAAS,EAAE,SAAS,EAAE,MAAM,GAAE,OAAO,CAAC,SAAS,CAAM;IAK3D,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAqH1F,OAAO,CAAC,cAAc;YAsBR,UAAU;IAuDxB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,mBAAmB;YAMb,YAAY;YAuDZ,gBAAgB;IAsB9B,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,iBAAiB;YAaX,aAAa;IAO3B,OAAO,CAAC,SAAS,CAAC,CAAa;YACjB,sBAAsB;IAIpC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/reasoning/thought-tree.js

@@ -0,0 +1,352 @@
+import { nanoid } from 'nanoid';
+import { DEFAULT_TOT_CONFIG } from '@cogitator-ai/types';
+import { BranchGenerator } from './branch-generator';
+import { BranchEvaluator } from './branch-evaluator';
+import { buildSynthesisPrompt } from './prompts';
+function generateId() {
+    return `node_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
+}
+export class ThoughtTreeExecutor {
+    cogitator;
+    config;
+    branchGenerator;
+    branchEvaluator;
+    currentModel = '';
+    nodes = new Map();
+    stats = this.createInitialStats();
+    constructor(cogitator, config = {}) {
+        this.cogitator = cogitator;
+        this.config = { ...DEFAULT_TOT_CONFIG, ...config };
+    }
+    async explore(agent, goal, options = {}) {
+        const runId = `tot_${nanoid(12)}`;
+        const startTime = Date.now();
+        this.nodes.clear();
+        this.stats = this.createInitialStats();
+        const llm = await this.getLLMBackend(agent);
+        this.currentModel = agent.model;
+        this.branchGenerator = new BranchGenerator(llm, this.currentModel);
+        this.branchEvaluator = new BranchEvaluator({
+            llm,
+            model: this.currentModel,
+            reflectionEngine: this.getReflectionEngine(),
+        });
+        const context = this.buildAgentContext(agent, goal);
+        const root = this.createRootNode(goal);
+        this.nodes.set(root.id, root);
+        let frontier = [root];
+        let bestNode = null;
+        let bestScore = -Infinity;
+        const timeoutAt = options.timeout ? startTime + options.timeout : null;
+        const abortSignal = options.abortSignal;
+        while (frontier.length > 0) {
+            if (abortSignal?.aborted) {
+                break;
+            }
+            if (timeoutAt && Date.now() > timeoutAt) {
+                break;
+            }
+            if (this.stats.totalNodes >= this.config.maxTotalNodes) {
+                break;
+            }
+            const node = frontier.shift();
+            node.status = 'exploring';
+            node.exploredAt = Date.now();
+            if (node.depth >= this.config.maxDepth) {
+                node.status = 'pruned';
+                this.stats.prunedNodes++;
+                continue;
+            }
+            const branches = await this.branchGenerator.generate(node.depth === 0 ? null : node, goal, this.config.branchFactor, context, this.getExploredThoughts());
+            this.stats.llmCalls++;
+            this.config.onBranchGenerated?.(node, branches);
+            const scores = await this.branchEvaluator.evaluateBatch(branches, goal, context);
+            this.stats.llmCalls++;
+            for (const branch of branches) {
+                const score = scores.get(branch.id);
+                if (score) {
+                    branch.score = score;
+                    this.config.onBranchEvaluated?.(branch, score);
+                }
+            }
+            const validBranches = branches
+                .filter((b) => b.score && b.score.composite >= this.config.confidenceThreshold)
+                .sort((a, b) => (b.score?.composite ?? 0) - (a.score?.composite ?? 0))
+                .slice(0, this.config.beamWidth);
+            if (validBranches.length === 0) {
+                const backtrackTarget = this.backtrack(node);
+                if (backtrackTarget) {
+                    frontier.unshift(backtrackTarget);
+                }
+                continue;
+            }
+            for (const branch of validBranches) {
+                const childNode = await this.expandNode(branch, node, agent, goal);
+                this.stats.exploredNodes++;
+                this.config.onNodeExplored?.(childNode);
+                if (childNode.cumulativeScore > bestScore) {
+                    bestScore = childNode.cumulativeScore;
+                    bestNode = childNode;
+                }
+                if (this.shouldTerminate(childNode)) {
+                    return this.createResult(runId, goal, agent.id, childNode, startTime);
+                }
+                if (childNode.status === 'completed') {
+                    frontier.push(childNode);
+                }
+                else if (childNode.status === 'failed') {
+                    const backtrackTarget = this.backtrack(childNode);
+                    if (backtrackTarget) {
+                        frontier.unshift(backtrackTarget);
+                    }
+                }
+            }
+            frontier.sort((a, b) => b.cumulativeScore - a.cumulativeScore);
+            options.onProgress?.(this.stats);
+        }
+        const resultNode = bestNode ?? this.findBestNode();
+        return this.createResult(runId, goal, agent.id, resultNode, startTime);
+    }
+    createRootNode(goal) {
+        const rootBranch = {
+            id: generateId(),
+            parentId: null,
+            thought: `Starting exploration for: ${goal}`,
+            proposedAction: { type: 'sub_goal', goal },
+            messagesSnapshot: [],
+        };
+        return {
+            id: generateId(),
+            parentId: null,
+            depth: 0,
+            branch: rootBranch,
+            messages: [],
+            status: 'pending',
+            cumulativeScore: 0,
+            children: [],
+            createdAt: Date.now(),
+        };
+    }
+    async expandNode(branch, parent, agent, goal) {
+        const nodeId = generateId();
+        const node = {
+            id: nodeId,
+            parentId: parent.id,
+            depth: parent.depth + 1,
+            branch: { ...branch, parentId: parent.id },
+            messages: [...branch.messagesSnapshot],
+            status: 'exploring',
+            cumulativeScore: parent.cumulativeScore + (branch.score?.composite ?? 0),
+            children: [],
+            createdAt: Date.now(),
+        };
+        parent.children.push(nodeId);
+        this.nodes.set(nodeId, node);
+        this.stats.totalNodes++;
+        this.stats.maxDepthReached = Math.max(this.stats.maxDepthReached, node.depth);
+        if (branch.proposedAction.type === 'response') {
+            node.result = { response: branch.proposedAction.content };
+            node.status = 'completed';
+            node.exploredAt = Date.now();
+            return node;
+        }
+        const input = this.buildNodePrompt(branch, goal);
+        try {
+            const result = await this.cogitator.run(agent, {
+                input,
+                useMemory: false,
+            });
+            this.stats.tokenUsage.input += result.usage.inputTokens;
+            this.stats.tokenUsage.output += result.usage.outputTokens;
+            node.result = { response: result.output };
+            node.messages = [...result.messages];
+            node.status = 'completed';
+            node.exploredAt = Date.now();
+        }
+        catch (error) {
+            node.result = { error: error instanceof Error ? error.message : String(error) };
+            node.status = 'failed';
+            node.exploredAt = Date.now();
+        }
+        return node;
+    }
+    buildNodePrompt(branch, goal) {
+        const action = branch.proposedAction;
+        if (action.type === 'tool_call') {
+            return `Goal: ${goal}\n\nApproach: ${branch.thought}\n\nExecute this approach using the ${action.toolName} tool with arguments: ${JSON.stringify(action.arguments)}`;
+        }
+        if (action.type === 'sub_goal') {
+            return `Goal: ${goal}\n\nApproach: ${branch.thought}\n\nWork on this sub-goal: ${action.goal}`;
+        }
+        return `Goal: ${goal}\n\nApproach: ${branch.thought}`;
+    }
+    shouldTerminate(node) {
+        if (node.status === 'failed')
+            return false;
+        if (!node.branch.score)
+            return false;
+        return node.branch.score.confidence >= this.config.terminationConfidence;
+    }
+    backtrack(from) {
+        from.status = 'failed';
+        this.stats.backtrackCount++;
+        let current = from;
+        while (current.parentId) {
+            const parent = this.nodes.get(current.parentId);
+            if (!parent)
+                break;
+            const unexplored = parent.children
+                .map((id) => this.nodes.get(id))
+                .filter((n) => n?.status === 'pending' &&
+                (n.branch.score?.composite ?? 0) >= this.config.confidenceThreshold)
+                .sort((a, b) => (b.branch.score?.composite ?? 0) - (a.branch.score?.composite ?? 0));
+            if (unexplored.length > 0) {
+                this.config.onBacktrack?.(from, unexplored[0]);
+                return unexplored[0];
+            }
+            current = parent;
+        }
+        this.config.onBacktrack?.(from, null);
+        return null;
+    }
+    findBestNode() {
+        let best = null;
+        let bestScore = -Infinity;
+        for (const node of this.nodes.values()) {
+            if (node.status === 'completed' && node.cumulativeScore > bestScore) {
+                best = node;
+                bestScore = node.cumulativeScore;
+            }
+        }
+        return best;
+    }
+    getPathToNode(node) {
+        const path = [];
+        let current = node;
+        while (current) {
+            path.unshift(current);
+            current = current.parentId ? this.nodes.get(current.parentId) : undefined;
+        }
+        return path;
+    }
+    getExploredThoughts() {
+        return Array.from(this.nodes.values())
+            .filter((n) => n.status === 'completed' || n.status === 'exploring')
+            .map((n) => n.branch.thought);
+    }
+    async createResult(runId, goal, agentId, bestNode, startTime) {
+        const duration = Date.now() - startTime;
+        this.stats.duration = duration;
+        const bestPath = bestNode ? this.getPathToNode(bestNode) : [];
+        let output = '';
+        if (bestNode?.result?.response) {
+            output = bestNode.result.response;
+        }
+        else if (bestPath.length > 0) {
+            const llm = await this.getLLMBackendFromCache();
+            if (llm) {
+                output = await this.synthesizeOutput(llm, goal, bestPath);
+            }
+            else {
+                output = this.fallbackSynthesis(bestPath);
+            }
+        }
+        const root = this.nodes.values().next().value;
+        const tree = {
+            id: runId,
+            goal,
+            agentId,
+            root: root ?? this.createRootNode(goal),
+            nodes: new Map(this.nodes),
+            bestPath: bestPath.map((n) => n.id),
+            bestScore: bestNode?.cumulativeScore ?? 0,
+            stats: { ...this.stats },
+        };
+        return {
+            success: bestNode !== null && bestNode.status === 'completed',
+            output,
+            tree,
+            bestPath,
+            stats: { ...this.stats },
+            runId,
+            agentId,
+            usage: {
+                inputTokens: this.stats.tokenUsage.input,
+                outputTokens: this.stats.tokenUsage.output,
+                totalTokens: this.stats.tokenUsage.input + this.stats.tokenUsage.output,
+                cost: 0,
+                duration,
+            },
+        };
+    }
+    async synthesizeOutput(llm, goal, path) {
+        const prompt = buildSynthesisPrompt(goal, path);
+        try {
+            const response = await llm.chat({
+                model: this.currentModel,
+                messages: [{ role: 'user', content: prompt }],
+                temperature: 0.5,
+                maxTokens: 1000,
+            });
+            this.stats.llmCalls++;
+            return response.content;
+        }
+        catch {
+            return this.fallbackSynthesis(path);
+        }
+    }
+    fallbackSynthesis(path) {
+        if (path.length === 0)
+            return 'No solution found.';
+        const last = path[path.length - 1];
+        if (last.result?.response)
+            return last.result.response;
+        return path
+            .filter((n) => n.result?.response)
+            .map((n) => n.result.response)
+            .join('\n\n');
+    }
+    buildAgentContext(agent, goal, runId = '') {
+        return {
+            agentId: agent.id,
+            agentName: agent.name,
+            runId: runId || `tot_${nanoid(8)}`,
+            threadId: `thread_${nanoid(8)}`,
+            goal,
+            iterationIndex: 0,
+            availableTools: agent.tools.map((t) => t.name),
+            previousActions: [],
+        };
+    }
+    async getLLMBackend(agent) {
+        const parsed = this.parseModel(agent.model);
+        return this.cogitator.getOrCreateBackend(parsed.provider);
+    }
+    cachedLLM;
+    async getLLMBackendFromCache() {
+        return this.cachedLLM;
+    }
+    parseModel(model) {
+        const parts = model.split('/');
+        if (parts.length >= 2) {
+            return { provider: parts[0], model: parts.slice(1).join('/') };
+        }
+        return { provider: 'openai', model };
+    }
+    getReflectionEngine() {
+        return this.cogitator.reflectionEngine;
+    }
+    createInitialStats() {
+        return {
+            totalNodes: 0,
+            exploredNodes: 0,
+            prunedNodes: 0,
+            maxDepthReached: 0,
+            backtrackCount: 0,
+            duration: 0,
+            llmCalls: 0,
+            tokenUsage: { input: 0, output: 0 },
+        };
+    }
+}
+//# sourceMappingURL=thought-tree.js.map

package/dist/reasoning/thought-tree.js.map

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

package/dist/reflection/index.d.ts

@@ -0,0 +1,4 @@
+export { ReflectionEngine, type ReflectionEngineOptions } from './reflection-engine';
+export { InMemoryInsightStore } from './insight-store';
+export { buildToolReflectionPrompt, buildErrorReflectionPrompt, buildRunReflectionPrompt, parseReflectionResponse, type ParsedReflection, } from './prompts';
+//# 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,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC"}

package/dist/reflection/index.js

@@ -0,0 +1,4 @@
+export { ReflectionEngine } from './reflection-engine';
+export { InMemoryInsightStore } from './insight-store';
+export { buildToolReflectionPrompt, buildErrorReflectionPrompt, buildRunReflectionPrompt, parseReflectionResponse, } from './prompts';
+//# 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,OAAO,EAAE,gBAAgB,EAAgC,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,GAExB,MAAM,WAAW,CAAC"}

package/dist/reflection/insight-store.d.ts

@@ -0,0 +1,19 @@
+import type { Insight, InsightStore } from '@cogitator-ai/types';
+export declare class InMemoryInsightStore implements InsightStore {
+    private insights;
+    private agentIndex;
+    store(insight: Insight): Promise<void>;
+    storeMany(insights: Insight[]): Promise<void>;
+    findRelevant(agentId: string, context: string, limit?: number): Promise<Insight[]>;
+    getAll(agentId: string): Promise<Insight[]>;
+    getById(id: string): Promise<Insight | null>;
+    markUsed(id: string): Promise<void>;
+    prune(agentId: string, maxInsights: number): Promise<number>;
+    delete(id: string): Promise<boolean>;
+    clear(agentId: string): Promise<void>;
+    getStats(): {
+        totalInsights: number;
+        agentCount: number;
+    };
+}
+//# sourceMappingURL=insight-store.d.ts.map

package/dist/reflection/insight-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-store.d.ts","sourceRoot":"","sources":["../../src/reflection/insight-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAE9E,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAAkC;IAE9C,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgD7E,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAc3C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI5C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+B5D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASpC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAM1D"}