@aitytech/agentkits-memory 1.0.0

package/dist/hooks/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Hook Types for AgentKits Memory
+ *
+ * Lightweight hook system for auto-capturing Claude Code sessions.
+ * Based on claude-mem patterns but simplified for project-scoped storage.
+ *
+ * @module @agentkits/memory/hooks/types
+ */
+/**
+ * Raw input from Claude Code hooks (via stdin JSON)
+ */
+export interface ClaudeCodeHookInput {
+    /** Claude's session ID */
+    session_id?: string;
+    /** Current working directory */
+    cwd?: string;
+    /** User's prompt (UserPromptSubmit) */
+    prompt?: string;
+    /** Tool name (PostToolUse) */
+    tool_name?: string;
+    /** Tool input parameters (PostToolUse) */
+    tool_input?: unknown;
+    /** Tool response/output (PostToolUse) */
+    tool_result?: unknown;
+    /** Path to conversation transcript (Stop) */
+    transcript_path?: string;
+    /** Stop reason (Stop) */
+    stop_reason?: string;
+}
+/**
+ * Normalized hook input for handlers
+ */
+export interface NormalizedHookInput {
+    /** Session ID */
+    sessionId: string;
+    /** Project directory */
+    cwd: string;
+    /** Project name (derived from cwd) */
+    project: string;
+    /** User's prompt */
+    prompt?: string;
+    /** Tool name */
+    toolName?: string;
+    /** Tool input */
+    toolInput?: unknown;
+    /** Tool response */
+    toolResponse?: unknown;
+    /** Transcript path */
+    transcriptPath?: string;
+    /** Stop reason */
+    stopReason?: string;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Hook execution result
+ */
+export interface HookResult {
+    /** Continue processing (always true for us) */
+    continue: boolean;
+    /** Suppress output to Claude */
+    suppressOutput: boolean;
+    /** Additional context to inject (SessionStart only) */
+    additionalContext?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Hook-specific output for Claude Code
+ */
+export interface HookSpecificOutput {
+    hookEventName: string;
+    additionalContext?: string;
+}
+/**
+ * Full hook response for Claude Code
+ */
+export interface ClaudeCodeHookResponse {
+    continue?: boolean;
+    suppressOutput?: boolean;
+    hookSpecificOutput?: HookSpecificOutput;
+}
+/**
+ * Hook event types
+ */
+export type HookEventType = 'context' | 'session-init' | 'observation' | 'summarize';
+/**
+ * Event handler interface
+ */
+export interface EventHandler {
+    /** Execute the hook handler */
+    execute(input: NormalizedHookInput): Promise<HookResult>;
+}
+/**
+ * Captured observation from tool usage
+ */
+export interface Observation {
+    /** Unique ID */
+    id: string;
+    /** Session ID */
+    sessionId: string;
+    /** Project name */
+    project: string;
+    /** Tool name */
+    toolName: string;
+    /** Tool input (JSON) */
+    toolInput: string;
+    /** Tool response (JSON, truncated) */
+    toolResponse: string;
+    /** Working directory */
+    cwd: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Observation type */
+    type: ObservationType;
+    /** Brief title (auto-generated) */
+    title?: string;
+}
+/**
+ * Observation types based on tool usage
+ */
+export type ObservationType = 'read' | 'write' | 'execute' | 'search' | 'other';
+/**
+ * Session record for tracking
+ */
+export interface SessionRecord {
+    /** Database ID */
+    id: number;
+    /** Claude's session ID */
+    sessionId: string;
+    /** Project name */
+    project: string;
+    /** First user prompt */
+    prompt: string;
+    /** Session start time */
+    startedAt: number;
+    /** Session end time */
+    endedAt?: number;
+    /** Number of observations */
+    observationCount: number;
+    /** Auto-generated summary */
+    summary?: string;
+    /** Status */
+    status: 'active' | 'completed' | 'abandoned';
+}
+/**
+ * Context to inject on session start
+ */
+export interface MemoryContext {
+    /** Recent observations */
+    recentObservations: Observation[];
+    /** Previous sessions */
+    previousSessions: SessionRecord[];
+    /** Project-specific patterns */
+    patterns?: string[];
+    /** Recent decisions */
+    decisions?: string[];
+    /** Formatted markdown */
+    markdown: string;
+}
+/**
+ * Generate observation ID
+ */
+export declare function generateObservationId(): string;
+/**
+ * Get project name from cwd
+ */
+export declare function getProjectName(cwd: string): string;
+/**
+ * Determine observation type from tool name
+ */
+export declare function getObservationType(toolName: string): ObservationType;
+/**
+ * Generate observation title from tool usage
+ */
+export declare function generateObservationTitle(toolName: string, toolInput: unknown): string;
+/**
+ * Truncate string to max length
+ */
+export declare function truncate(str: string, maxLength?: number): string;
+/**
+ * Standard hook response (continue, no output)
+ */
+export declare const STANDARD_RESPONSE: ClaudeCodeHookResponse;
+/**
+ * Format hook response for stdout
+ */
+export declare function formatResponse(result: HookResult): string;
+/**
+ * Parse stdin input from Claude Code
+ */
+export declare function parseHookInput(stdin: string): NormalizedHookInput;
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

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

package/dist/hooks/types.js

@@ -0,0 +1,137 @@
+/**
+ * Hook Types for AgentKits Memory
+ *
+ * Lightweight hook system for auto-capturing Claude Code sessions.
+ * Based on claude-mem patterns but simplified for project-scoped storage.
+ *
+ * @module @agentkits/memory/hooks/types
+ */
+// ===== Utility Functions =====
+/**
+ * Generate observation ID
+ */
+export function generateObservationId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 6);
+    return `obs_${timestamp}_${random}`;
+}
+/**
+ * Get project name from cwd
+ */
+export function getProjectName(cwd) {
+    const parts = cwd.split(/[/\\]/);
+    return parts[parts.length - 1] || 'unknown';
+}
+/**
+ * Determine observation type from tool name
+ */
+export function getObservationType(toolName) {
+    const readTools = ['Read', 'Glob', 'Grep', 'LS'];
+    const writeTools = ['Write', 'Edit', 'NotebookEdit'];
+    const executeTools = ['Bash', 'Task', 'Skill'];
+    const searchTools = ['WebSearch', 'WebFetch'];
+    if (readTools.includes(toolName))
+        return 'read';
+    if (writeTools.includes(toolName))
+        return 'write';
+    if (executeTools.includes(toolName))
+        return 'execute';
+    if (searchTools.includes(toolName))
+        return 'search';
+    return 'other';
+}
+/**
+ * Generate observation title from tool usage
+ */
+export function generateObservationTitle(toolName, toolInput) {
+    try {
+        const input = typeof toolInput === 'string' ? JSON.parse(toolInput) : toolInput;
+        switch (toolName) {
+            case 'Read':
+                return `Read ${input?.file_path || input?.path || 'file'}`;
+            case 'Write':
+                return `Write ${input?.file_path || input?.path || 'file'}`;
+            case 'Edit':
+                return `Edit ${input?.file_path || input?.path || 'file'}`;
+            case 'Bash':
+                const cmd = input?.command || '';
+                return `Run: ${cmd.substring(0, 50)}${cmd.length > 50 ? '...' : ''}`;
+            case 'Glob':
+                return `Find ${input?.pattern || 'files'}`;
+            case 'Grep':
+                return `Search "${input?.pattern || ''}"`;
+            case 'Task':
+                return `Task: ${input?.description || 'agent'}`;
+            case 'WebSearch':
+                return `Search: ${input?.query || ''}`;
+            case 'WebFetch':
+                return `Fetch: ${input?.url || ''}`;
+            default:
+                return `${toolName}`;
+        }
+    }
+    catch {
+        return toolName;
+    }
+}
+/**
+ * Truncate string to max length
+ */
+export function truncate(str, maxLength = 1000) {
+    if (str.length <= maxLength)
+        return str;
+    return str.substring(0, maxLength) + '...[truncated]';
+}
+/**
+ * Standard hook response (continue, no output)
+ */
+export const STANDARD_RESPONSE = {
+    continue: true,
+    suppressOutput: true,
+};
+/**
+ * Format hook response for stdout
+ */
+export function formatResponse(result) {
+    if (result.additionalContext) {
+        return JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: 'SessionStart',
+                additionalContext: result.additionalContext,
+            },
+        });
+    }
+    return JSON.stringify(STANDARD_RESPONSE);
+}
+/**
+ * Parse stdin input from Claude Code
+ */
+export function parseHookInput(stdin) {
+    try {
+        const raw = JSON.parse(stdin);
+        const cwd = raw.cwd || process.cwd();
+        return {
+            sessionId: raw.session_id || `session_${Date.now()}`,
+            cwd,
+            project: getProjectName(cwd),
+            prompt: raw.prompt,
+            toolName: raw.tool_name,
+            toolInput: raw.tool_input,
+            toolResponse: raw.tool_result,
+            transcriptPath: raw.transcript_path,
+            stopReason: raw.stop_reason,
+            timestamp: Date.now(),
+        };
+    }
+    catch {
+        // Fallback for empty or invalid input
+        const cwd = process.cwd();
+        return {
+            sessionId: `session_${Date.now()}`,
+            cwd,
+            project: getProjectName(cwd),
+            timestamp: Date.now(),
+        };
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgOH,gCAAgC;AAEhC;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAE9C,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IAChD,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAClD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,SAAkB;IAC3E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEhF,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,MAAM;gBACT,OAAO,QAAQ,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,CAAC;YAC7D,KAAK,OAAO;gBACV,OAAO,SAAS,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,CAAC;YAC9D,KAAK,MAAM;gBACT,OAAO,QAAQ,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,CAAC;YAC7D,KAAK,MAAM;gBACT,MAAM,GAAG,GAAG,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;gBACjC,OAAO,QAAQ,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACvE,KAAK,MAAM;gBACT,OAAO,QAAQ,KAAK,EAAE,OAAO,IAAI,OAAO,EAAE,CAAC;YAC7C,KAAK,MAAM;gBACT,OAAO,WAAW,KAAK,EAAE,OAAO,IAAI,EAAE,GAAG,CAAC;YAC5C,KAAK,MAAM;gBACT,OAAO,SAAS,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,CAAC;YAClD,KAAK,WAAW;gBACd,OAAO,WAAW,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;YACzC,KAAK,UAAU;gBACb,OAAO,UAAU,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;YACtC;gBACE,OAAO,GAAG,QAAQ,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,YAAoB,IAAI;IAC5D,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,gBAAgB,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,QAAQ,EAAE,IAAI;IACd,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,kBAAkB,EAAE;gBAClB,aAAa,EAAE,cAAc;gBAC7B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;aAC5C;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAwB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEnD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAErC,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE;YACpD,GAAG;YACH,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,YAAY,EAAE,GAAG,CAAC,WAAW;YAC7B,cAAc,EAAE,GAAG,CAAC,eAAe;YACnC,UAAU,EAAE,GAAG,CAAC,WAAW;YAC3B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,OAAO;YACL,SAAS,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE;YAClC,GAAG;YACH,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC;YAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,173 @@
+/**
+ * @agentkits/memory - Project-Scoped Memory System
+ *
+ * Provides persistent memory for Claude Code sessions within a project.
+ * Stores data in .claude/memory/memory.db using SQLite with optional
+ * HNSW vector indexing for semantic search.
+ *
+ * @module @agentkits/memory
+ *
+ * @example
+ * ```typescript
+ * import { ProjectMemoryService } from '@agentkits/memory';
+ *
+ * // Initialize memory for current project
+ * const memory = new ProjectMemoryService('.claude/memory');
+ * await memory.initialize();
+ *
+ * // Store an entry
+ * await memory.store({
+ *   key: 'auth-pattern',
+ *   content: 'Use JWT with refresh tokens for authentication',
+ *   namespace: 'patterns',
+ *   tags: ['auth', 'security'],
+ * });
+ *
+ * // Query entries
+ * const patterns = await memory.query({
+ *   type: 'hybrid',
+ *   namespace: 'patterns',
+ *   tags: ['auth'],
+ *   limit: 10,
+ * });
+ *
+ * // Semantic search (if embeddings enabled)
+ * const similar = await memory.semanticSearch('how to authenticate users', 5);
+ *
+ * // Session management
+ * await memory.startSession();
+ * await memory.checkpoint('Completed authentication setup');
+ * await memory.endSession('Successfully implemented auth');
+ * ```
+ */
+import { EventEmitter } from 'node:events';
+import { IMemoryBackend, MemoryEntry, MemoryEntryInput, MemoryEntryUpdate, MemoryQuery, SearchResult, SearchOptions, BackendStats, HealthCheckResult, EmbeddingGenerator, SessionInfo, MigrationResult } from './types.js';
+export * from './types.js';
+export { SqlJsBackend } from './sqljs-backend.js';
+export { CacheManager, TieredCacheManager } from './cache-manager.js';
+export { HNSWIndex } from './hnsw-index.js';
+export { MemoryMigrator, migrateMarkdownMemory } from './migration.js';
+/**
+ * Configuration for ProjectMemoryService
+ */
+export interface ProjectMemoryConfig {
+    /** Base directory for memory storage (default: .claude/memory) */
+    baseDir: string;
+    /** Database filename (default: memory.db) */
+    dbFilename: string;
+    /** Enable HNSW vector indexing */
+    enableVectorIndex: boolean;
+    /** Vector dimensions for embeddings (default: 384 for local models) */
+    dimensions: number;
+    /** Embedding generator function (optional) */
+    embeddingGenerator?: EmbeddingGenerator;
+    /** Enable caching */
+    cacheEnabled: boolean;
+    /** Cache size (number of entries) */
+    cacheSize: number;
+    /** Cache TTL in milliseconds */
+    cacheTtl: number;
+    /** Auto-persist interval in milliseconds */
+    autoPersistInterval: number;
+    /** Maximum entries before cleanup */
+    maxEntries: number;
+    /** Enable verbose logging */
+    verbose: boolean;
+}
+/**
+ * Project-Scoped Memory Service
+ *
+ * High-level interface for project memory that provides:
+ * - Persistent storage in .claude/memory/memory.db
+ * - Session tracking and checkpoints
+ * - Optional semantic search with HNSW indexing
+ * - Migration from existing markdown files
+ * - Backward-compatible markdown exports
+ */
+export declare class ProjectMemoryService extends EventEmitter implements IMemoryBackend {
+    private config;
+    private backend;
+    private cache;
+    private vectorIndex;
+    private initialized;
+    private currentSession;
+    constructor(baseDirOrConfig?: string | Partial<ProjectMemoryConfig>);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    store(entry: MemoryEntry): Promise<void>;
+    get(id: string): Promise<MemoryEntry | null>;
+    getByKey(namespace: string, key: string): Promise<MemoryEntry | null>;
+    update(id: string, update: MemoryEntryUpdate): Promise<MemoryEntry | null>;
+    delete(id: string): Promise<boolean>;
+    query(query: MemoryQuery): Promise<MemoryEntry[]>;
+    search(embedding: Float32Array, options: SearchOptions): Promise<SearchResult[]>;
+    bulkInsert(entries: MemoryEntry[]): Promise<void>;
+    bulkDelete(ids: string[]): Promise<number>;
+    count(namespace?: string): Promise<number>;
+    listNamespaces(): Promise<string[]>;
+    clearNamespace(namespace: string): Promise<number>;
+    getStats(): Promise<BackendStats>;
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Store an entry from simple input
+     */
+    storeEntry(input: MemoryEntryInput): Promise<MemoryEntry>;
+    /**
+     * Semantic search by content string
+     */
+    semanticSearch(content: string, k?: number, threshold?: number): Promise<SearchResult[]>;
+    /**
+     * Get entries by namespace (convenience method)
+     */
+    getByNamespace(namespace: string, limit?: number): Promise<MemoryEntry[]>;
+    /**
+     * Get or create an entry
+     */
+    getOrCreate(namespace: string, key: string, creator: () => MemoryEntryInput | Promise<MemoryEntryInput>): Promise<MemoryEntry>;
+    /**
+     * Start a new session
+     */
+    startSession(): Promise<SessionInfo>;
+    /**
+     * Get current session
+     */
+    getCurrentSession(): SessionInfo | null;
+    /**
+     * Create a checkpoint in current session
+     */
+    checkpoint(description: string): Promise<void>;
+    /**
+     * End current session
+     */
+    endSession(summary?: string): Promise<SessionInfo | null>;
+    /**
+     * Get recent sessions
+     */
+    getRecentSessions(limit?: number): Promise<SessionInfo[]>;
+    /**
+     * Migrate from existing markdown memory files
+     */
+    migrateFromMarkdown(options?: {
+        generateEmbeddings?: boolean;
+    }): Promise<MigrationResult>;
+    /**
+     * Export namespace to markdown (for git-friendly backup)
+     */
+    exportToMarkdown(namespace: string, outputPath?: string): Promise<string>;
+    /**
+     * Export all namespaces to markdown
+     */
+    exportAllToMarkdown(): Promise<string[]>;
+    private ensureInitialized;
+    private rebuildVectorIndex;
+}
+/**
+ * Create a memory service for the current project
+ */
+export declare function createProjectMemory(baseDir?: string, options?: Partial<ProjectMemoryConfig>): ProjectMemoryService;
+/**
+ * Create a memory service with embedding support
+ */
+export declare function createEmbeddingMemory(baseDir: string, embeddingGenerator: EmbeddingGenerator, dimensions?: number): ProjectMemoryService;
+export default ProjectMemoryService;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,eAAe,EAKhB,MAAM,YAAY,CAAC;AAOpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAE3B,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC,qBAAqB;IACrB,YAAY,EAAE,OAAO,CAAC;IAEtB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAE5B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAkBD;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,SAAQ,YAAa,YAAW,cAAc;IAC9E,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAA4B;gBAEtC,eAAe,GAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAM;IAqDjE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBzB,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAmB5C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAsBrE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAgC1E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKjD,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0BhF,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1C,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1C,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKnC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWlD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAkBjC,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAO/C;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAM/D;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,CAAC,GAAE,MAAW,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC;IAS1B;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQpF;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAC1D,OAAO,CAAC,WAAW,CAAC;IAUvB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAuB1C;;OAEG;IACH,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAIvC;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpD;;OAEG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA2B/D;;OAEG;IACG,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAqBnE;;OAEG;IACG,mBAAmB,CAAC,OAAO,GAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAiBnG;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB/E;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAc9C,OAAO,CAAC,iBAAiB;YAMX,kBAAkB;CAwBjC;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,MAAyB,EAClC,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,oBAAoB,CAEtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,GAAE,MAAY,GACvB,oBAAoB,CAOtB;AAGD,eAAe,oBAAoB,CAAC"}