praisonai 1.2.2 → 1.2.3

package/dist/index.js

@@ -14,9 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createQueryRewriterAgent = exports.QueryRewriterAgent = exports.createDeepResearchAgent = exports.DeepResearchAgent = exports.createImageAgent = exports.ImageAgent = exports.createAutoAgents = exports.AutoAgents = exports.cleanupTelemetry = exports.disableTelemetry = exports.enableTelemetry = exports.getTelemetry = exports.TelemetryCollector = exports.createMemory = exports.Memory = exports.help = exports.version = exports.listProviders = exports.chat = exports.parseSkillFile = exports.createSkillManager = exports.SkillManager = exports.getObservabilityAdapter = exports.setObservabilityAdapter = exports.ConsoleObservabilityAdapter = exports.MemoryObservabilityAdapter = exports.EvalSuite = exports.reliabilityEval = exports.performanceEval = exports.accuracyEval = exports.createKnowledgeBase = exports.KnowledgeBase = exports.createContextAgent = exports.ContextAgent = exports.routeConditions = exports.createRouter = exports.RouterAgent = exports.handoffFilters = exports.handoff = exports.Handoff = exports.getTool = exports.registerTool = exports.getRegistry = exports.ToolRegistry = exports.tool = exports.FunctionTool = exports.createTool = exports.validateTool = exports.ToolValidationError = exports.BaseTool = void 0;
-exports.createQdrantStore = exports.QdrantVectorStore = exports.createWeaviateStore = exports.WeaviateVectorStore = exports.createPineconeStore = exports.PineconeVectorStore = exports.createMemoryVectorStore = exports.MemoryVectorStore = exports.BaseVectorStore = exports.createPostgresSessionStorage = exports.createMemoryPostgres = exports.createNeonPostgres = exports.PostgresSessionStorage = exports.MemoryPostgresAdapter = exports.NeonPostgresAdapter = exports.createMemoryRedis = exports.createUpstashRedis = exports.MemoryRedisAdapter = exports.UpstashRedisAdapter = exports.createSQLiteAdapter = exports.SQLiteAdapter = exports.validateWorkflowDefinition = exports.loadWorkflowFromFile = exports.createWorkflowFromYAML = exports.parseYAMLWorkflow = exports.createPubSub = exports.createEventBus = exports.AgentEvents = exports.AgentEventBus = exports.EventEmitterPubSub = exports.PubSub = exports.createFileCache = exports.createMemoryCache = exports.FileCache = exports.MemoryCache = exports.BaseCache = exports.createPlanStorage = exports.createTodoList = exports.createPlan = exports.PlanStorage = exports.TodoItem = exports.TodoList = exports.PlanStep = exports.Plan = exports.createLLMGuardrail = exports.LLMGuardrail = exports.createChunking = exports.Chunking = exports.createPromptExpanderAgent = exports.PromptExpanderAgent = void 0;
-exports.BaseProvider = exports.GoogleProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.getAvailableProviders = exports.isProviderAvailable = exports.parseModelString = exports.getDefaultProvider = exports.createProvider = exports.createGraphRAG = exports.GraphRAG = exports.GraphStore = exports.createLLMReranker = exports.createCrossEncoderReranker = exports.createCohereReranker = exports.LLMReranker = exports.CrossEncoderReranker = exports.CohereReranker = exports.BaseReranker = exports.createElevenLabsVoice = exports.createOpenAIVoice = exports.ElevenLabsVoiceProvider = exports.OpenAIVoiceProvider = exports.BaseVoiceProvider = exports.createLangfuseObservability = exports.createMemoryObservability = exports.createConsoleObservability = exports.LangfuseObservabilityProvider = exports.MemoryObservabilityProvider = exports.ConsoleObservabilityProvider = exports.BaseObservabilityProvider = exports.createChromaStore = exports.ChromaVectorStore = void 0;
+exports.ImageAgent = exports.createAutoAgents = exports.AutoAgents = exports.cleanupTelemetry = exports.disableTelemetry = exports.enableTelemetry = exports.getTelemetry = exports.TelemetryCollector = exports.DEFAULT_POLICIES = exports.createLLMSummarizer = exports.createAutoMemory = exports.AutoMemory = exports.createFileMemory = exports.FileMemory = exports.createMemory = exports.Memory = exports.CLI_SPEC_VERSION = exports.executeCommand = exports.parseArgs = exports.parseSkillFile = exports.createSkillManager = exports.SkillManager = exports.getObservabilityAdapter = exports.setObservabilityAdapter = exports.ConsoleObservabilityAdapter = exports.MemoryObservabilityAdapter = exports.EvalSuite = exports.reliabilityEval = exports.performanceEval = exports.accuracyEval = exports.createKnowledgeBase = exports.KnowledgeBase = exports.createContextAgent = exports.ContextAgent = exports.routeConditions = exports.createRouter = exports.RouterAgent = exports.handoffFilters = exports.handoff = exports.Handoff = exports.getTool = exports.registerTool = exports.getRegistry = exports.ToolRegistry = exports.tool = exports.FunctionTool = exports.createTool = exports.validateTool = exports.ToolValidationError = exports.BaseTool = void 0;
+exports.PineconeVectorStore = exports.createMemoryVectorStore = exports.MemoryVectorStore = exports.BaseVectorStore = exports.createPostgresSessionStorage = exports.createMemoryPostgres = exports.createNeonPostgres = exports.PostgresSessionStorage = exports.MemoryPostgresAdapter = exports.NeonPostgresAdapter = exports.createMemoryRedis = exports.createUpstashRedis = exports.MemoryRedisAdapter = exports.UpstashRedisAdapter = exports.createSQLiteAdapter = exports.SQLiteAdapter = exports.validateWorkflowDefinition = exports.loadWorkflowFromFile = exports.createWorkflowFromYAML = exports.parseYAMLWorkflow = exports.createPubSub = exports.createEventBus = exports.AgentEvents = exports.AgentEventBus = exports.EventEmitterPubSub = exports.PubSub = exports.createFileCache = exports.createMemoryCache = exports.FileCache = exports.MemoryCache = exports.BaseCache = exports.createPlanStorage = exports.createTodoList = exports.createPlan = exports.PlanStorage = exports.TodoItem = exports.TodoList = exports.PlanStep = exports.Plan = exports.createLLMGuardrail = exports.LLMGuardrail = exports.createChunking = exports.Chunking = exports.createPromptExpanderAgent = exports.PromptExpanderAgent = exports.createQueryRewriterAgent = exports.QueryRewriterAgent = exports.createDeepResearchAgent = exports.DeepResearchAgent = exports.createImageAgent = void 0;
+exports.InteractiveTUI = exports.MODEL_PRICING = exports.formatCost = exports.estimateTokens = exports.createCostTracker = exports.CostTracker = exports.isSlashCommand = exports.executeSlashCommand = exports.parseSlashCommand = exports.registerCommand = exports.createSlashCommandHandler = exports.SlashCommandHandler = exports.BaseProvider = exports.GoogleProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.getAvailableProviders = exports.isProviderAvailable = exports.parseModelString = exports.getDefaultProvider = exports.createProvider = exports.createGraphRAG = exports.GraphRAG = exports.GraphStore = exports.createLLMReranker = exports.createCrossEncoderReranker = exports.createCohereReranker = exports.LLMReranker = exports.CrossEncoderReranker = exports.CohereReranker = exports.BaseReranker = exports.createElevenLabsVoice = exports.createOpenAIVoice = exports.ElevenLabsVoiceProvider = exports.OpenAIVoiceProvider = exports.BaseVoiceProvider = exports.createLangfuseObservability = exports.createMemoryObservability = exports.createConsoleObservability = exports.LangfuseObservabilityProvider = exports.MemoryObservabilityProvider = exports.ConsoleObservabilityProvider = exports.BaseObservabilityProvider = exports.createChromaStore = exports.ChromaVectorStore = exports.createQdrantStore = exports.QdrantVectorStore = exports.createWeaviateStore = exports.WeaviateVectorStore = exports.createPineconeStore = void 0;
+exports.createN8NIntegration = exports.N8NIntegration = exports.externalAgentAsTool = exports.createExternalAgent = exports.getExternalAgentRegistry = exports.GenericExternalAgent = exports.AiderAgent = exports.CodexCliAgent = exports.GeminiCliAgent = exports.ClaudeCodeAgent = exports.BaseExternalAgent = exports.renderWorkflow = exports.createFlowDisplay = exports.FlowDisplay = exports.createFileCheckpointStorage = exports.FileCheckpointStorage = exports.MemoryCheckpointStorage = exports.createCheckpointManager = exports.CheckpointManager = exports.createFileJobStorage = exports.FileJobStorage = exports.MemoryJobStorage = exports.createJobQueue = exports.JobQueue = exports.cronExpressions = exports.createScheduler = exports.Scheduler = exports.MODE_POLICIES = exports.cliApprovalPrompt = exports.createAutonomyManager = exports.AutonomyManager = exports.DEFAULT_BLOCKED_PATHS = exports.DEFAULT_BLOCKED_COMMANDS = exports.CommandValidator = exports.sandboxExec = exports.createSandboxExecutor = exports.SandboxExecutor = exports.createDiffViewer = exports.DiffViewer = exports.createGitManager = exports.GitManager = exports.DEFAULT_IGNORE_PATTERNS = exports.getRepoTree = exports.createRepoMap = exports.RepoMap = exports.createHistoryManager = exports.HistoryManager = exports.createStatusDisplay = exports.StatusDisplay = exports.createInteractiveTUI = void 0;
+exports.getQuickContext = exports.createFastContext = exports.FastContext = exports.triggerN8NWebhook = void 0;
 // Export all public modules
 __exportStar(require("./agent"), exports);
 __exportStar(require("./knowledge"), exports);
@@ -82,14 +84,23 @@ Object.defineProperty(exports, "createSkillManager", { enumerable: true, get: fu
 Object.defineProperty(exports, "parseSkillFile", { enumerable: true, get: function () { return skills_1.parseSkillFile; } });
 // Export CLI
 var cli_1 = require("./cli");
-Object.defineProperty(exports, "chat", { enumerable: true, get: function () { return cli_1.chat; } });
-Object.defineProperty(exports, "listProviders", { enumerable: true, get: function () { return cli_1.listProviders; } });
-Object.defineProperty(exports, "version", { enumerable: true, get: function () { return cli_1.version; } });
-Object.defineProperty(exports, "help", { enumerable: true, get: function () { return cli_1.help; } });
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return cli_1.parseArgs; } });
+Object.defineProperty(exports, "executeCommand", { enumerable: true, get: function () { return cli_1.executeCommand; } });
+Object.defineProperty(exports, "CLI_SPEC_VERSION", { enumerable: true, get: function () { return cli_1.CLI_SPEC_VERSION; } });
 // Export Memory
 var memory_1 = require("./memory/memory");
 Object.defineProperty(exports, "Memory", { enumerable: true, get: function () { return memory_1.Memory; } });
 Object.defineProperty(exports, "createMemory", { enumerable: true, get: function () { return memory_1.createMemory; } });
+// Export FileMemory
+var file_memory_1 = require("./memory/file-memory");
+Object.defineProperty(exports, "FileMemory", { enumerable: true, get: function () { return file_memory_1.FileMemory; } });
+Object.defineProperty(exports, "createFileMemory", { enumerable: true, get: function () { return file_memory_1.createFileMemory; } });
+// Export AutoMemory
+var auto_memory_1 = require("./memory/auto-memory");
+Object.defineProperty(exports, "AutoMemory", { enumerable: true, get: function () { return auto_memory_1.AutoMemory; } });
+Object.defineProperty(exports, "createAutoMemory", { enumerable: true, get: function () { return auto_memory_1.createAutoMemory; } });
+Object.defineProperty(exports, "createLLMSummarizer", { enumerable: true, get: function () { return auto_memory_1.createLLMSummarizer; } });
+Object.defineProperty(exports, "DEFAULT_POLICIES", { enumerable: true, get: function () { return auto_memory_1.DEFAULT_POLICIES; } });
 // Export Telemetry
 var telemetry_1 = require("./telemetry");
 Object.defineProperty(exports, "TelemetryCollector", { enumerable: true, get: function () { return telemetry_1.TelemetryCollector; } });
@@ -228,3 +239,85 @@ Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: functi
 Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return providers_1.AnthropicProvider; } });
 Object.defineProperty(exports, "GoogleProvider", { enumerable: true, get: function () { return providers_1.GoogleProvider; } });
 Object.defineProperty(exports, "BaseProvider", { enumerable: true, get: function () { return providers_1.BaseProvider; } });
+// Export CLI Features
+var features_1 = require("./cli/features");
+// Slash Commands
+Object.defineProperty(exports, "SlashCommandHandler", { enumerable: true, get: function () { return features_1.SlashCommandHandler; } });
+Object.defineProperty(exports, "createSlashCommandHandler", { enumerable: true, get: function () { return features_1.createSlashCommandHandler; } });
+Object.defineProperty(exports, "registerCommand", { enumerable: true, get: function () { return features_1.registerCommand; } });
+Object.defineProperty(exports, "parseSlashCommand", { enumerable: true, get: function () { return features_1.parseSlashCommand; } });
+Object.defineProperty(exports, "executeSlashCommand", { enumerable: true, get: function () { return features_1.executeSlashCommand; } });
+Object.defineProperty(exports, "isSlashCommand", { enumerable: true, get: function () { return features_1.isSlashCommand; } });
+// Cost Tracker
+Object.defineProperty(exports, "CostTracker", { enumerable: true, get: function () { return features_1.CostTracker; } });
+Object.defineProperty(exports, "createCostTracker", { enumerable: true, get: function () { return features_1.createCostTracker; } });
+Object.defineProperty(exports, "estimateTokens", { enumerable: true, get: function () { return features_1.estimateTokens; } });
+Object.defineProperty(exports, "formatCost", { enumerable: true, get: function () { return features_1.formatCost; } });
+Object.defineProperty(exports, "MODEL_PRICING", { enumerable: true, get: function () { return features_1.MODEL_PRICING; } });
+// Interactive TUI
+Object.defineProperty(exports, "InteractiveTUI", { enumerable: true, get: function () { return features_1.InteractiveTUI; } });
+Object.defineProperty(exports, "createInteractiveTUI", { enumerable: true, get: function () { return features_1.createInteractiveTUI; } });
+Object.defineProperty(exports, "StatusDisplay", { enumerable: true, get: function () { return features_1.StatusDisplay; } });
+Object.defineProperty(exports, "createStatusDisplay", { enumerable: true, get: function () { return features_1.createStatusDisplay; } });
+Object.defineProperty(exports, "HistoryManager", { enumerable: true, get: function () { return features_1.HistoryManager; } });
+Object.defineProperty(exports, "createHistoryManager", { enumerable: true, get: function () { return features_1.createHistoryManager; } });
+// Repo Map
+Object.defineProperty(exports, "RepoMap", { enumerable: true, get: function () { return features_1.RepoMap; } });
+Object.defineProperty(exports, "createRepoMap", { enumerable: true, get: function () { return features_1.createRepoMap; } });
+Object.defineProperty(exports, "getRepoTree", { enumerable: true, get: function () { return features_1.getRepoTree; } });
+Object.defineProperty(exports, "DEFAULT_IGNORE_PATTERNS", { enumerable: true, get: function () { return features_1.DEFAULT_IGNORE_PATTERNS; } });
+// Git Integration
+Object.defineProperty(exports, "GitManager", { enumerable: true, get: function () { return features_1.GitManager; } });
+Object.defineProperty(exports, "createGitManager", { enumerable: true, get: function () { return features_1.createGitManager; } });
+Object.defineProperty(exports, "DiffViewer", { enumerable: true, get: function () { return features_1.DiffViewer; } });
+Object.defineProperty(exports, "createDiffViewer", { enumerable: true, get: function () { return features_1.createDiffViewer; } });
+// Sandbox Executor
+Object.defineProperty(exports, "SandboxExecutor", { enumerable: true, get: function () { return features_1.SandboxExecutor; } });
+Object.defineProperty(exports, "createSandboxExecutor", { enumerable: true, get: function () { return features_1.createSandboxExecutor; } });
+Object.defineProperty(exports, "sandboxExec", { enumerable: true, get: function () { return features_1.sandboxExec; } });
+Object.defineProperty(exports, "CommandValidator", { enumerable: true, get: function () { return features_1.CommandValidator; } });
+Object.defineProperty(exports, "DEFAULT_BLOCKED_COMMANDS", { enumerable: true, get: function () { return features_1.DEFAULT_BLOCKED_COMMANDS; } });
+Object.defineProperty(exports, "DEFAULT_BLOCKED_PATHS", { enumerable: true, get: function () { return features_1.DEFAULT_BLOCKED_PATHS; } });
+// Autonomy Mode
+Object.defineProperty(exports, "AutonomyManager", { enumerable: true, get: function () { return features_1.AutonomyManager; } });
+Object.defineProperty(exports, "createAutonomyManager", { enumerable: true, get: function () { return features_1.createAutonomyManager; } });
+Object.defineProperty(exports, "cliApprovalPrompt", { enumerable: true, get: function () { return features_1.cliApprovalPrompt; } });
+Object.defineProperty(exports, "MODE_POLICIES", { enumerable: true, get: function () { return features_1.MODE_POLICIES; } });
+// Scheduler
+Object.defineProperty(exports, "Scheduler", { enumerable: true, get: function () { return features_1.Scheduler; } });
+Object.defineProperty(exports, "createScheduler", { enumerable: true, get: function () { return features_1.createScheduler; } });
+Object.defineProperty(exports, "cronExpressions", { enumerable: true, get: function () { return features_1.cronExpressions; } });
+// Background Jobs
+Object.defineProperty(exports, "JobQueue", { enumerable: true, get: function () { return features_1.JobQueue; } });
+Object.defineProperty(exports, "createJobQueue", { enumerable: true, get: function () { return features_1.createJobQueue; } });
+Object.defineProperty(exports, "MemoryJobStorage", { enumerable: true, get: function () { return features_1.MemoryJobStorage; } });
+Object.defineProperty(exports, "FileJobStorage", { enumerable: true, get: function () { return features_1.FileJobStorage; } });
+Object.defineProperty(exports, "createFileJobStorage", { enumerable: true, get: function () { return features_1.createFileJobStorage; } });
+// Checkpoints
+Object.defineProperty(exports, "CheckpointManager", { enumerable: true, get: function () { return features_1.CheckpointManager; } });
+Object.defineProperty(exports, "createCheckpointManager", { enumerable: true, get: function () { return features_1.createCheckpointManager; } });
+Object.defineProperty(exports, "MemoryCheckpointStorage", { enumerable: true, get: function () { return features_1.MemoryCheckpointStorage; } });
+Object.defineProperty(exports, "FileCheckpointStorage", { enumerable: true, get: function () { return features_1.FileCheckpointStorage; } });
+Object.defineProperty(exports, "createFileCheckpointStorage", { enumerable: true, get: function () { return features_1.createFileCheckpointStorage; } });
+// Flow Display
+Object.defineProperty(exports, "FlowDisplay", { enumerable: true, get: function () { return features_1.FlowDisplay; } });
+Object.defineProperty(exports, "createFlowDisplay", { enumerable: true, get: function () { return features_1.createFlowDisplay; } });
+Object.defineProperty(exports, "renderWorkflow", { enumerable: true, get: function () { return features_1.renderWorkflow; } });
+// External Agents
+Object.defineProperty(exports, "BaseExternalAgent", { enumerable: true, get: function () { return features_1.BaseExternalAgent; } });
+Object.defineProperty(exports, "ClaudeCodeAgent", { enumerable: true, get: function () { return features_1.ClaudeCodeAgent; } });
+Object.defineProperty(exports, "GeminiCliAgent", { enumerable: true, get: function () { return features_1.GeminiCliAgent; } });
+Object.defineProperty(exports, "CodexCliAgent", { enumerable: true, get: function () { return features_1.CodexCliAgent; } });
+Object.defineProperty(exports, "AiderAgent", { enumerable: true, get: function () { return features_1.AiderAgent; } });
+Object.defineProperty(exports, "GenericExternalAgent", { enumerable: true, get: function () { return features_1.GenericExternalAgent; } });
+Object.defineProperty(exports, "getExternalAgentRegistry", { enumerable: true, get: function () { return features_1.getExternalAgentRegistry; } });
+Object.defineProperty(exports, "createExternalAgent", { enumerable: true, get: function () { return features_1.createExternalAgent; } });
+Object.defineProperty(exports, "externalAgentAsTool", { enumerable: true, get: function () { return features_1.externalAgentAsTool; } });
+// N8N Integration
+Object.defineProperty(exports, "N8NIntegration", { enumerable: true, get: function () { return features_1.N8NIntegration; } });
+Object.defineProperty(exports, "createN8NIntegration", { enumerable: true, get: function () { return features_1.createN8NIntegration; } });
+Object.defineProperty(exports, "triggerN8NWebhook", { enumerable: true, get: function () { return features_1.triggerN8NWebhook; } });
+// Fast Context
+Object.defineProperty(exports, "FastContext", { enumerable: true, get: function () { return features_1.FastContext; } });
+Object.defineProperty(exports, "createFastContext", { enumerable: true, get: function () { return features_1.createFastContext; } });
+Object.defineProperty(exports, "getQuickContext", { enumerable: true, get: function () { return features_1.getQuickContext; } });

package/dist/memory/auto-memory.d.ts

@@ -0,0 +1,136 @@
+/**
+ * AutoMemory - Policy-based automatic memory capture
+ * Integrates with Memory, KnowledgeBase, and Vector stores
+ */
+import { Memory, MemoryEntry, MemoryConfig } from './memory';
+export interface AutoMemoryPolicy {
+    name: string;
+    condition: (content: string, role: string, context: AutoMemoryContext) => boolean;
+    action: 'store' | 'summarize' | 'vectorize' | 'skip';
+    priority?: number;
+}
+export interface AutoMemoryContext {
+    messageCount: number;
+    tokenCount: number;
+    lastSummaryAt?: number;
+    metadata: Record<string, any>;
+}
+export interface AutoMemoryConfig extends MemoryConfig {
+    policies?: AutoMemoryPolicy[];
+    summaryThreshold?: number;
+    vectorizeThreshold?: number;
+    summarizer?: (entries: MemoryEntry[]) => Promise<string>;
+    vectorStore?: VectorStoreAdapter;
+    knowledgeBase?: KnowledgeBaseAdapter;
+}
+export interface VectorStoreAdapter {
+    add(id: string, embedding: number[], metadata?: Record<string, any>): Promise<void>;
+    search(embedding: number[], limit?: number): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+}
+export interface KnowledgeBaseAdapter {
+    add(content: string, metadata?: Record<string, any>): Promise<string>;
+    search(query: string, limit?: number): Promise<Array<{
+        content: string;
+        score: number;
+    }>>;
+}
+/**
+ * Default policies for automatic memory management
+ */
+export declare const DEFAULT_POLICIES: AutoMemoryPolicy[];
+/**
+ * AutoMemory - Automatic memory management with policies
+ */
+export declare class AutoMemory {
+    private memory;
+    private policies;
+    private summaryThreshold;
+    private vectorizeThreshold;
+    private summarizer?;
+    private vectorStore?;
+    private knowledgeBase?;
+    private embeddingProvider?;
+    private context;
+    private pendingVectorization;
+    constructor(config?: AutoMemoryConfig);
+    /**
+     * Process and add content with automatic policy application
+     */
+    add(content: string, role: 'user' | 'assistant' | 'system', metadata?: Record<string, any>): Promise<MemoryEntry | null>;
+    /**
+     * Get a memory entry by ID
+     */
+    get(id: string): MemoryEntry | undefined;
+    /**
+     * Get all entries
+     */
+    getAll(): MemoryEntry[];
+    /**
+     * Get recent entries
+     */
+    getRecent(count: number): MemoryEntry[];
+    /**
+     * Search memory
+     */
+    search(query: string, limit?: number): Promise<Array<{
+        entry: MemoryEntry;
+        score: number;
+    }>>;
+    /**
+     * Build context with automatic retrieval
+     */
+    buildContext(query?: string, maxTokens?: number): Promise<string>;
+    /**
+     * Add a custom policy
+     */
+    addPolicy(policy: AutoMemoryPolicy): void;
+    /**
+     * Remove a policy by name
+     */
+    removePolicy(name: string): boolean;
+    /**
+     * Get current context stats
+     */
+    getStats(): AutoMemoryContext;
+    /**
+     * Clear all memory
+     */
+    clear(): void;
+    /**
+     * Export memory
+     */
+    toJSON(): MemoryEntry[];
+    /**
+     * Import memory
+     */
+    fromJSON(entries: MemoryEntry[]): void;
+    /**
+     * Get underlying memory instance
+     */
+    getMemory(): Memory;
+    /**
+     * Flush pending vectorization
+     */
+    private flushVectorization;
+    /**
+     * Summarize old entries to save space
+     */
+    private summarizeOldEntries;
+    /**
+     * Estimate token count (rough approximation)
+     */
+    private estimateTokens;
+}
+/**
+ * Create an auto-memory instance
+ */
+export declare function createAutoMemory(config?: AutoMemoryConfig): AutoMemory;
+/**
+ * Create a simple summarizer using an LLM
+ */
+export declare function createLLMSummarizer(llm: {
+    chat: (prompt: string) => Promise<string>;
+}): (entries: MemoryEntry[]) => Promise<string>;

package/dist/memory/auto-memory.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * AutoMemory - Policy-based automatic memory capture
+ * Integrates with Memory, KnowledgeBase, and Vector stores
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoMemory = exports.DEFAULT_POLICIES = void 0;
+exports.createAutoMemory = createAutoMemory;
+exports.createLLMSummarizer = createLLMSummarizer;
+const memory_1 = require("./memory");
+/**
+ * Default policies for automatic memory management
+ */
+exports.DEFAULT_POLICIES = [
+    {
+        name: 'store-important',
+        condition: (content) => {
+            const importantKeywords = ['remember', 'important', 'note', 'save', 'key point'];
+            return importantKeywords.some(kw => content.toLowerCase().includes(kw));
+        },
+        action: 'store',
+        priority: 100
+    },
+    {
+        name: 'summarize-long',
+        condition: (content) => content.length > 2000,
+        action: 'summarize',
+        priority: 50
+    },
+    {
+        name: 'vectorize-knowledge',
+        condition: (content, role) => {
+            return role === 'assistant' && content.length > 500;
+        },
+        action: 'vectorize',
+        priority: 30
+    },
+    {
+        name: 'skip-short',
+        condition: (content) => content.length < 10,
+        action: 'skip',
+        priority: 10
+    }
+];
+/**
+ * AutoMemory - Automatic memory management with policies
+ */
+class AutoMemory {
+    constructor(config = {}) {
+        this.pendingVectorization = [];
+        this.memory = new memory_1.Memory(config);
+        this.policies = (config.policies || exports.DEFAULT_POLICIES).sort((a, b) => (b.priority || 0) - (a.priority || 0));
+        this.summaryThreshold = config.summaryThreshold ?? 50;
+        this.vectorizeThreshold = config.vectorizeThreshold ?? 10;
+        this.summarizer = config.summarizer;
+        this.vectorStore = config.vectorStore;
+        this.knowledgeBase = config.knowledgeBase;
+        this.embeddingProvider = config.embeddingProvider;
+        this.context = {
+            messageCount: 0,
+            tokenCount: 0,
+            metadata: {}
+        };
+    }
+    /**
+     * Process and add content with automatic policy application
+     */
+    async add(content, role, metadata) {
+        this.context.messageCount++;
+        this.context.tokenCount += this.estimateTokens(content);
+        // Find matching policy
+        const policy = this.policies.find(p => p.condition(content, role, this.context));
+        if (!policy || policy.action === 'skip') {
+            return null;
+        }
+        let entry;
+        switch (policy.action) {
+            case 'summarize':
+                if (this.summarizer) {
+                    const summary = await this.summarizer([{
+                            id: '', content, role, timestamp: Date.now(), metadata
+                        }]);
+                    entry = await this.memory.add(summary, role, {
+                        ...metadata,
+                        original: content,
+                        summarized: true
+                    });
+                }
+                else {
+                    entry = await this.memory.add(content, role, metadata);
+                }
+                break;
+            case 'vectorize':
+                entry = await this.memory.add(content, role, metadata);
+                this.pendingVectorization.push(entry);
+                if (this.pendingVectorization.length >= this.vectorizeThreshold) {
+                    await this.flushVectorization();
+                }
+                break;
+            case 'store':
+            default:
+                entry = await this.memory.add(content, role, metadata);
+                break;
+        }
+        // Check if we need to trigger summarization
+        if (this.memory.size >= this.summaryThreshold && this.summarizer) {
+            await this.summarizeOldEntries();
+        }
+        return entry;
+    }
+    /**
+     * Get a memory entry by ID
+     */
+    get(id) {
+        return this.memory.get(id);
+    }
+    /**
+     * Get all entries
+     */
+    getAll() {
+        return this.memory.getAll();
+    }
+    /**
+     * Get recent entries
+     */
+    getRecent(count) {
+        return this.memory.getRecent(count);
+    }
+    /**
+     * Search memory
+     */
+    async search(query, limit = 5) {
+        const memoryResults = await this.memory.search(query, limit);
+        // Also search vector store if available
+        if (this.vectorStore && this.embeddingProvider) {
+            const queryEmbedding = await this.embeddingProvider.embed(query);
+            const vectorResults = await this.vectorStore.search(queryEmbedding, limit);
+            // Merge results (deduplicate by ID)
+            const seen = new Set(memoryResults.map(r => r.entry.id));
+            for (const vr of vectorResults) {
+                if (!seen.has(vr.id)) {
+                    const entry = this.memory.get(vr.id);
+                    if (entry) {
+                        memoryResults.push({ entry, score: vr.score });
+                    }
+                }
+            }
+        }
+        // Also search knowledge base if available
+        if (this.knowledgeBase) {
+            const kbResults = await this.knowledgeBase.search(query, limit);
+            // Knowledge base results are returned separately as they may not have IDs
+        }
+        return memoryResults
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit);
+    }
+    /**
+     * Build context with automatic retrieval
+     */
+    async buildContext(query, maxTokens = 4000) {
+        let entries;
+        if (query) {
+            const results = await this.search(query, 20);
+            entries = results.map(r => r.entry);
+        }
+        else {
+            entries = this.getRecent(20);
+        }
+        // Build context within token limit
+        const contextParts = [];
+        let tokenCount = 0;
+        for (const entry of entries) {
+            const part = `${entry.role}: ${entry.content}`;
+            const partTokens = this.estimateTokens(part);
+            if (tokenCount + partTokens > maxTokens)
+                break;
+            contextParts.push(part);
+            tokenCount += partTokens;
+        }
+        return contextParts.join('\n');
+    }
+    /**
+     * Add a custom policy
+     */
+    addPolicy(policy) {
+        this.policies.push(policy);
+        this.policies.sort((a, b) => (b.priority || 0) - (a.priority || 0));
+    }
+    /**
+     * Remove a policy by name
+     */
+    removePolicy(name) {
+        const index = this.policies.findIndex(p => p.name === name);
+        if (index >= 0) {
+            this.policies.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get current context stats
+     */
+    getStats() {
+        return { ...this.context };
+    }
+    /**
+     * Clear all memory
+     */
+    clear() {
+        this.memory.clear();
+        this.pendingVectorization = [];
+        this.context = {
+            messageCount: 0,
+            tokenCount: 0,
+            metadata: {}
+        };
+    }
+    /**
+     * Export memory
+     */
+    toJSON() {
+        return this.memory.toJSON();
+    }
+    /**
+     * Import memory
+     */
+    fromJSON(entries) {
+        this.memory.fromJSON(entries);
+        this.context.messageCount = entries.length;
+    }
+    /**
+     * Get underlying memory instance
+     */
+    getMemory() {
+        return this.memory;
+    }
+    /**
+     * Flush pending vectorization
+     */
+    async flushVectorization() {
+        if (!this.vectorStore || !this.embeddingProvider || this.pendingVectorization.length === 0) {
+            return;
+        }
+        for (const entry of this.pendingVectorization) {
+            if (entry.embedding) {
+                await this.vectorStore.add(entry.id, entry.embedding, entry.metadata);
+            }
+            else {
+                const embedding = await this.embeddingProvider.embed(entry.content);
+                await this.vectorStore.add(entry.id, embedding, entry.metadata);
+            }
+        }
+        this.pendingVectorization = [];
+    }
+    /**
+     * Summarize old entries to save space
+     */
+    async summarizeOldEntries() {
+        if (!this.summarizer)
+            return;
+        const entries = this.memory.getAll();
+        const oldEntries = entries.slice(0, Math.floor(entries.length / 2));
+        if (oldEntries.length < 10)
+            return;
+        const summary = await this.summarizer(oldEntries);
+        // Delete old entries and add summary
+        for (const entry of oldEntries) {
+            this.memory.delete(entry.id);
+        }
+        await this.memory.add(summary, 'system', {
+            type: 'summary',
+            summarizedCount: oldEntries.length,
+            summarizedAt: Date.now()
+        });
+        this.context.lastSummaryAt = Date.now();
+    }
+    /**
+     * Estimate token count (rough approximation)
+     */
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+}
+exports.AutoMemory = AutoMemory;
+/**
+ * Create an auto-memory instance
+ */
+function createAutoMemory(config) {
+    return new AutoMemory(config);
+}
+/**
+ * Create a simple summarizer using an LLM
+ */
+function createLLMSummarizer(llm) {
+    return async (entries) => {
+        const content = entries.map(e => `${e.role}: ${e.content}`).join('\n');
+        const prompt = `Summarize the following conversation concisely, preserving key information:\n\n${content}`;
+        return llm.chat(prompt);
+    };
+}

package/dist/memory/file-memory.d.ts

@@ -0,0 +1,88 @@
+/**
+ * File-based Memory Storage
+ * Persistent memory using JSONL files with lockfile support for concurrent access
+ */
+import { MemoryEntry, MemoryConfig, SearchResult } from './memory';
+export interface FileMemoryConfig extends MemoryConfig {
+    filePath: string;
+    compactionThreshold?: number;
+    autoCompact?: boolean;
+}
+export interface FileMemoryEntry extends MemoryEntry {
+    deleted?: boolean;
+}
+/**
+ * FileMemory - Append-only JSONL storage with compaction
+ */
+export declare class FileMemory {
+    private filePath;
+    private entries;
+    private maxEntries;
+    private embeddingProvider?;
+    private compactionThreshold;
+    private autoCompact;
+    private initialized;
+    private writeQueue;
+    constructor(config: FileMemoryConfig);
+    /**
+     * Initialize and load existing entries
+     */
+    initialize(): Promise<void>;
+    /**
+     * Add a memory entry
+     */
+    add(content: string, role: 'user' | 'assistant' | 'system', metadata?: Record<string, any>): Promise<MemoryEntry>;
+    /**
+     * Get a memory entry by ID
+     */
+    get(id: string): Promise<MemoryEntry | undefined>;
+    /**
+     * Get all entries
+     */
+    getAll(): Promise<MemoryEntry[]>;
+    /**
+     * Get recent entries
+     */
+    getRecent(count: number): Promise<MemoryEntry[]>;
+    /**
+     * Search memory by text similarity
+     */
+    search(query: string, limit?: number): Promise<SearchResult[]>;
+    /**
+     * Delete a memory entry (soft delete)
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Clear all memory
+     */
+    clear(): Promise<void>;
+    /**
+     * Compact the file by removing deleted entries
+     */
+    compact(): Promise<void>;
+    /**
+     * Get memory size
+     */
+    get size(): number;
+    /**
+     * Export memory to JSON
+     */
+    toJSON(): Promise<MemoryEntry[]>;
+    /**
+     * Import memory from JSON
+     */
+    fromJSON(entries: MemoryEntry[]): Promise<void>;
+    /**
+     * Build context string from recent memory
+     */
+    buildContext(count?: number): Promise<string>;
+    private appendEntry;
+    private textSearch;
+    private cosineSimilarity;
+    private generateId;
+    private enforceLimit;
+}
+/**
+ * Create a file-based memory instance
+ */
+export declare function createFileMemory(config: FileMemoryConfig): FileMemory;