agentic-flow 2.0.2 → 2.0.4

package/dist/memory/SharedMemoryPool.d.ts

@@ -1,129 +0,0 @@
-/**
- * Shared Memory Pool for AgentDB
- *
- * Provides a singleton memory pool that multiple agents can share:
- * - Single SQLite database connection (reduces overhead)
- * - Single embedding model instance (saves ~150MB per agent)
- * - Shared query cache (LRU with TTL)
- * - Shared embedding cache (deduplication)
- *
- * Memory savings: ~300-500MB for 4+ concurrent agents
- *
- * @example
- * ```typescript
- * import { SharedMemoryPool } from 'agentic-flow/memory';
- *
- * const pool = SharedMemoryPool.getInstance();
- * const db = pool.getDatabase();
- * const embedder = pool.getEmbedder();
- * ```
- */
-import { Database as DatabaseInstance } from 'better-sqlite3';
-declare class EmbeddingService {
-    private model;
-    private dimension;
-    constructor(config: {
-        model?: string;
-        dimension?: number;
-        cacheSize?: number;
-        provider?: string;
-    });
-    embed(text: string): Promise<Float32Array>;
-    initialize(): Promise<void>;
-}
-export interface SharedMemoryPoolConfig {
-    dbPath?: string;
-    cacheSize?: number;
-    embeddingCacheSize?: number;
-    embeddingModel?: string;
-    embeddingDimension?: number;
-}
-export declare class SharedMemoryPool {
-    private static instance;
-    private db;
-    private embedder;
-    private queryCache;
-    private embeddingCache;
-    private config;
-    private initialized;
-    private constructor();
-    /**
-     * Get singleton instance of SharedMemoryPool
-     */
-    static getInstance(config?: SharedMemoryPoolConfig): SharedMemoryPool;
-    /**
-     * Reset singleton instance (for testing)
-     */
-    static resetInstance(): void;
-    /**
-     * Ensure embedding service is initialized
-     */
-    ensureInitialized(): Promise<void>;
-    /**
-     * Get shared database connection
-     */
-    getDatabase(): DatabaseInstance;
-    /**
-     * Get shared embedding service
-     */
-    getEmbedder(): EmbeddingService;
-    /**
-     * Get or compute embedding with caching
-     *
-     * @param text Text to embed
-     * @returns Cached or newly computed embedding
-     */
-    getCachedEmbedding(text: string): Promise<Float32Array>;
-    /**
-     * Cache query result with TTL
-     *
-     * @param key Cache key
-     * @param result Result to cache
-     * @param ttl Time-to-live in milliseconds (default: 60s)
-     */
-    cacheQuery(key: string, result: any, ttl?: number): void;
-    /**
-     * Get cached query result
-     *
-     * @param key Cache key
-     * @returns Cached result or null if expired/missing
-     */
-    getCachedQuery(key: string): any | null;
-    /**
-     * Clear all caches
-     */
-    clearCaches(): void;
-    /**
-     * Get memory pool statistics
-     */
-    getStats(): {
-        database: {
-            path: string;
-            size: any;
-            tables: any;
-            walMode: unknown;
-        };
-        cache: {
-            queryCacheSize: number;
-            queryCacheMax: number;
-            embeddingCacheSize: number;
-            embeddingCacheMax: number;
-        };
-        embedder: {
-            model: string;
-            dimension: number;
-            initialized: boolean;
-        };
-        memory: {
-            heapUsed: number;
-            external: number;
-        };
-    };
-    /**
-     * Close database connection and cleanup
-     */
-    close(): void;
-}
-export declare const getSharedMemoryPool: typeof SharedMemoryPool.getInstance;
-export {};
-//# sourceMappingURL=SharedMemoryPool.d.ts.map

package/dist/memory/SharedMemoryPool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SharedMemoryPool.d.ts","sourceRoot":"","sources":["../../src/memory/SharedMemoryPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAiB,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMxE,cAAM,gBAAgB;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAK3F,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAClC;AAOD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,WAAW,CAAkB;IAErC,OAAO;IAqCP;;OAEG;WACW,WAAW,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,gBAAgB;IAO5E;;OAEG;WACW,aAAa,IAAI,IAAI;IAOnC;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/C;;OAEG;IACI,WAAW,IAAI,gBAAgB;IAItC;;OAEG;IACI,WAAW,IAAI,gBAAgB;IAItC;;;;;OAKG;IACU,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBpE;;;;;;OAMG;IACI,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAE,MAAc,GAAG,IAAI;IAetE;;;;;OAKG;IACI,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAY9C;;OAEG;IACI,WAAW,IAAI,IAAI;IAK1B;;OAEG;IACI,QAAQ;;;;;;;;;;;;;;;;;;;;;;;IAgCf;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB;AAGD,eAAO,MAAM,mBAAmB,qCAA+B,CAAC"}

package/dist/memory/SharedMemoryPool.js

@@ -1,243 +0,0 @@
-/**
- * Shared Memory Pool for AgentDB
- *
- * Provides a singleton memory pool that multiple agents can share:
- * - Single SQLite database connection (reduces overhead)
- * - Single embedding model instance (saves ~150MB per agent)
- * - Shared query cache (LRU with TTL)
- * - Shared embedding cache (deduplication)
- *
- * Memory savings: ~300-500MB for 4+ concurrent agents
- *
- * @example
- * ```typescript
- * import { SharedMemoryPool } from 'agentic-flow/memory';
- *
- * const pool = SharedMemoryPool.getInstance();
- * const db = pool.getDatabase();
- * const embedder = pool.getEmbedder();
- * ```
- */
-// Use better-sqlite3 for local SQLite
-import Database from 'better-sqlite3';
-import * as path from 'path';
-import * as fs from 'fs';
-// Stub implementation for EmbeddingService
-// TODO: Replace with actual import when agentdb v3.x is released
-class EmbeddingService {
-    model;
-    dimension;
-    constructor(config) {
-        this.model = config.model || 'mock';
-        this.dimension = config.dimension || 384;
-    }
-    async embed(text) {
-        // Simple hash-based mock embedding
-        const embedding = new Float32Array(this.dimension);
-        let hash = 0;
-        for (let i = 0; i < text.length; i++) {
-            hash = (hash << 5) - hash + text.charCodeAt(i);
-            hash = hash & hash;
-        }
-        for (let i = 0; i < this.dimension; i++) {
-            const seed = hash + i * 2654435761;
-            const x = Math.sin(seed) * 10000;
-            embedding[i] = x - Math.floor(x);
-        }
-        // Normalize
-        const norm = Math.sqrt(embedding.reduce((sum, v) => sum + v * v, 0));
-        for (let i = 0; i < this.dimension; i++) {
-            embedding[i] /= norm;
-        }
-        return embedding;
-    }
-    async initialize() { }
-}
-export class SharedMemoryPool {
-    static instance;
-    db;
-    embedder;
-    queryCache;
-    embeddingCache;
-    config;
-    initialized = false;
-    constructor(config = {}) {
-        this.config = {
-            dbPath: config.dbPath || './agentdb.db',
-            cacheSize: config.cacheSize || 1000,
-            embeddingCacheSize: config.embeddingCacheSize || 10000,
-            embeddingModel: config.embeddingModel || 'Xenova/all-MiniLM-L6-v2',
-            embeddingDimension: config.embeddingDimension || 384
-        };
-        // Initialize SQLite with optimized settings
-        const dbDir = path.dirname(this.config.dbPath);
-        if (!fs.existsSync(dbDir)) {
-            fs.mkdirSync(dbDir, { recursive: true });
-        }
-        this.db = new Database(this.config.dbPath);
-        // Optimize SQLite for performance
-        this.db.pragma('journal_mode = WAL'); // Write-Ahead Logging
-        this.db.pragma('synchronous = NORMAL'); // Balanced safety/performance
-        this.db.pragma('cache_size = -65536'); // 64MB cache
-        this.db.pragma('mmap_size = 268435456'); // 256MB memory-mapped I/O
-        this.db.pragma('page_size = 8192'); // 8KB pages
-        this.db.pragma('temp_store = MEMORY'); // Keep temp tables in memory
-        // Initialize embedding service (will be lazy-loaded)
-        this.embedder = new EmbeddingService({
-            model: this.config.embeddingModel,
-            dimension: this.config.embeddingDimension,
-            provider: 'transformers'
-        });
-        // Initialize caches
-        this.queryCache = new Map();
-        this.embeddingCache = new Map();
-    }
-    /**
-     * Get singleton instance of SharedMemoryPool
-     */
-    static getInstance(config) {
-        if (!SharedMemoryPool.instance) {
-            SharedMemoryPool.instance = new SharedMemoryPool(config);
-        }
-        return SharedMemoryPool.instance;
-    }
-    /**
-     * Reset singleton instance (for testing)
-     */
-    static resetInstance() {
-        if (SharedMemoryPool.instance) {
-            SharedMemoryPool.instance.close();
-            SharedMemoryPool.instance = null;
-        }
-    }
-    /**
-     * Ensure embedding service is initialized
-     */
-    async ensureInitialized() {
-        if (!this.initialized) {
-            await this.embedder.initialize();
-            this.initialized = true;
-        }
-    }
-    /**
-     * Get shared database connection
-     */
-    getDatabase() {
-        return this.db;
-    }
-    /**
-     * Get shared embedding service
-     */
-    getEmbedder() {
-        return this.embedder;
-    }
-    /**
-     * Get or compute embedding with caching
-     *
-     * @param text Text to embed
-     * @returns Cached or newly computed embedding
-     */
-    async getCachedEmbedding(text) {
-        const cached = this.embeddingCache.get(text);
-        if (cached)
-            return cached;
-        await this.ensureInitialized();
-        const embedding = await this.embedder.embed(text);
-        // LRU eviction if cache too large
-        if (this.embeddingCache.size >= this.config.embeddingCacheSize) {
-            const firstKey = this.embeddingCache.keys().next().value;
-            if (firstKey) {
-                this.embeddingCache.delete(firstKey);
-            }
-        }
-        this.embeddingCache.set(text, embedding);
-        return embedding;
-    }
-    /**
-     * Cache query result with TTL
-     *
-     * @param key Cache key
-     * @param result Result to cache
-     * @param ttl Time-to-live in milliseconds (default: 60s)
-     */
-    cacheQuery(key, result, ttl = 60000) {
-        // LRU eviction if cache too large
-        if (this.queryCache.size >= this.config.cacheSize) {
-            const firstKey = this.queryCache.keys().next().value;
-            if (firstKey) {
-                this.queryCache.delete(firstKey);
-            }
-        }
-        this.queryCache.set(key, {
-            result,
-            expires: Date.now() + ttl
-        });
-    }
-    /**
-     * Get cached query result
-     *
-     * @param key Cache key
-     * @returns Cached result or null if expired/missing
-     */
-    getCachedQuery(key) {
-        const cached = this.queryCache.get(key);
-        if (!cached)
-            return null;
-        if (Date.now() > cached.expires) {
-            this.queryCache.delete(key);
-            return null;
-        }
-        return cached.result;
-    }
-    /**
-     * Clear all caches
-     */
-    clearCaches() {
-        this.queryCache.clear();
-        this.embeddingCache.clear();
-    }
-    /**
-     * Get memory pool statistics
-     */
-    getStats() {
-        const dbStats = this.db.prepare(`
-      SELECT
-        (SELECT COUNT(*) FROM sqlite_master WHERE type='table') as tables,
-        (SELECT page_count * page_size FROM pragma_page_count(), pragma_page_size()) as dbSize
-    `).get();
-        return {
-            database: {
-                path: this.config.dbPath,
-                size: dbStats.dbSize,
-                tables: dbStats.tables,
-                walMode: this.db.pragma('journal_mode', { simple: true }),
-            },
-            cache: {
-                queryCacheSize: this.queryCache.size,
-                queryCacheMax: this.config.cacheSize,
-                embeddingCacheSize: this.embeddingCache.size,
-                embeddingCacheMax: this.config.embeddingCacheSize,
-            },
-            embedder: {
-                model: this.config.embeddingModel,
-                dimension: this.config.embeddingDimension,
-                initialized: this.initialized,
-            },
-            memory: {
-                heapUsed: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
-                external: Math.round(process.memoryUsage().external / 1024 / 1024),
-            }
-        };
-    }
-    /**
-     * Close database connection and cleanup
-     */
-    close() {
-        this.clearCaches();
-        this.db.close();
-        this.initialized = false;
-    }
-}
-// Export singleton getter for convenience
-export const getSharedMemoryPool = SharedMemoryPool.getInstance;
-//# sourceMappingURL=SharedMemoryPool.js.map

package/dist/memory/SharedMemoryPool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SharedMemoryPool.js","sourceRoot":"","sources":["../../src/memory/SharedMemoryPool.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared Memory Pool for AgentDB\n *\n * Provides a singleton memory pool that multiple agents can share:\n * - Single SQLite database connection (reduces overhead)\n * - Single embedding model instance (saves ~150MB per agent)\n * - Shared query cache (LRU with TTL)\n * - Shared embedding cache (deduplication)\n *\n * Memory savings: ~300-500MB for 4+ concurrent agents\n *\n * @example\n * ```typescript\n * import { SharedMemoryPool } from 'agentic-flow/memory';\n *\n * const pool = SharedMemoryPool.getInstance();\n * const db = pool.getDatabase();\n * const embedder = pool.getEmbedder();\n * ```\n */\n\n// Use better-sqlite3 for local SQLite\nimport Database, { Database as DatabaseInstance } from 'better-sqlite3';\nimport * as path from 'path';\nimport * as fs from 'fs';\n\n// Stub implementation for EmbeddingService\n// TODO: Replace with actual import when agentdb v3.x is released\nclass EmbeddingService {\n  private model: string;\n  private dimension: number;\n\n  constructor(config: { model?: string; dimension?: number; cacheSize?: number; provider?: string }) {\n    this.model = config.model || 'mock';\n    this.dimension = config.dimension || 384;\n  }\n\n  async embed(text: string): Promise<Float32Array> {\n    // Simple hash-based mock embedding\n    const embedding = new Float32Array(this.dimension);\n    let hash = 0;\n    for (let i = 0; i < text.length; i++) {\n      hash = (hash << 5) - hash + text.charCodeAt(i);\n      hash = hash & hash;\n    }\n    for (let i = 0; i < this.dimension; i++) {\n      const seed = hash + i * 2654435761;\n      const x = Math.sin(seed) * 10000;\n      embedding[i] = x - Math.floor(x);\n    }\n    // Normalize\n    const norm = Math.sqrt(embedding.reduce((sum, v) => sum + v * v, 0));\n    for (let i = 0; i < this.dimension; i++) {\n      embedding[i] /= norm;\n    }\n    return embedding;\n  }\n\n  async initialize(): Promise<void> {}\n}\n\ninterface CachedQuery {\n  result: any;\n  expires: number;\n}\n\nexport interface SharedMemoryPoolConfig {\n  dbPath?: string;\n  cacheSize?: number;\n  embeddingCacheSize?: number;\n  embeddingModel?: string;\n  embeddingDimension?: number;\n}\n\nexport class SharedMemoryPool {\n  private static instance: SharedMemoryPool;\n  private db: DatabaseInstance;\n  private embedder: EmbeddingService;\n  private queryCache: Map<string, CachedQuery>;\n  private embeddingCache: Map<string, Float32Array>;\n  private config: Required<SharedMemoryPoolConfig>;\n  private initialized: boolean = false;\n\n  private constructor(config: SharedMemoryPoolConfig = {}) {\n    this.config = {\n      dbPath: config.dbPath || './agentdb.db',\n      cacheSize: config.cacheSize || 1000,\n      embeddingCacheSize: config.embeddingCacheSize || 10000,\n      embeddingModel: config.embeddingModel || 'Xenova/all-MiniLM-L6-v2',\n      embeddingDimension: config.embeddingDimension || 384\n    };\n\n    // Initialize SQLite with optimized settings\n    const dbDir = path.dirname(this.config.dbPath);\n    if (!fs.existsSync(dbDir)) {\n      fs.mkdirSync(dbDir, { recursive: true });\n    }\n\n    this.db = new Database(this.config.dbPath);\n\n    // Optimize SQLite for performance\n    this.db.pragma('journal_mode = WAL');          // Write-Ahead Logging\n    this.db.pragma('synchronous = NORMAL');        // Balanced safety/performance\n    this.db.pragma('cache_size = -65536');         // 64MB cache\n    this.db.pragma('mmap_size = 268435456');       // 256MB memory-mapped I/O\n    this.db.pragma('page_size = 8192');            // 8KB pages\n    this.db.pragma('temp_store = MEMORY');         // Keep temp tables in memory\n\n    // Initialize embedding service (will be lazy-loaded)\n    this.embedder = new EmbeddingService({\n      model: this.config.embeddingModel,\n      dimension: this.config.embeddingDimension,\n      provider: 'transformers'\n    });\n\n    // Initialize caches\n    this.queryCache = new Map();\n    this.embeddingCache = new Map();\n  }\n\n  /**\n   * Get singleton instance of SharedMemoryPool\n   */\n  public static getInstance(config?: SharedMemoryPoolConfig): SharedMemoryPool {\n    if (!SharedMemoryPool.instance) {\n      SharedMemoryPool.instance = new SharedMemoryPool(config);\n    }\n    return SharedMemoryPool.instance;\n  }\n\n  /**\n   * Reset singleton instance (for testing)\n   */\n  public static resetInstance(): void {\n    if (SharedMemoryPool.instance) {\n      SharedMemoryPool.instance.close();\n      SharedMemoryPool.instance = null as any;\n    }\n  }\n\n  /**\n   * Ensure embedding service is initialized\n   */\n  public async ensureInitialized(): Promise<void> {\n    if (!this.initialized) {\n      await this.embedder.initialize();\n      this.initialized = true;\n    }\n  }\n\n  /**\n   * Get shared database connection\n   */\n  public getDatabase(): DatabaseInstance {\n    return this.db;\n  }\n\n  /**\n   * Get shared embedding service\n   */\n  public getEmbedder(): EmbeddingService {\n    return this.embedder;\n  }\n\n  /**\n   * Get or compute embedding with caching\n   *\n   * @param text Text to embed\n   * @returns Cached or newly computed embedding\n   */\n  public async getCachedEmbedding(text: string): Promise<Float32Array> {\n    const cached = this.embeddingCache.get(text);\n    if (cached) return cached;\n\n    await this.ensureInitialized();\n    const embedding = await this.embedder.embed(text);\n\n    // LRU eviction if cache too large\n    if (this.embeddingCache.size >= this.config.embeddingCacheSize) {\n      const firstKey = this.embeddingCache.keys().next().value;\n      if (firstKey) {\n        this.embeddingCache.delete(firstKey);\n      }\n    }\n\n    this.embeddingCache.set(text, embedding);\n    return embedding;\n  }\n\n  /**\n   * Cache query result with TTL\n   *\n   * @param key Cache key\n   * @param result Result to cache\n   * @param ttl Time-to-live in milliseconds (default: 60s)\n   */\n  public cacheQuery(key: string, result: any, ttl: number = 60000): void {\n    // LRU eviction if cache too large\n    if (this.queryCache.size >= this.config.cacheSize) {\n      const firstKey = this.queryCache.keys().next().value;\n      if (firstKey) {\n        this.queryCache.delete(firstKey);\n      }\n    }\n\n    this.queryCache.set(key, {\n      result,\n      expires: Date.now() + ttl\n    });\n  }\n\n  /**\n   * Get cached query result\n   *\n   * @param key Cache key\n   * @returns Cached result or null if expired/missing\n   */\n  public getCachedQuery(key: string): any | null {\n    const cached = this.queryCache.get(key);\n    if (!cached) return null;\n\n    if (Date.now() > cached.expires) {\n      this.queryCache.delete(key);\n      return null;\n    }\n\n    return cached.result;\n  }\n\n  /**\n   * Clear all caches\n   */\n  public clearCaches(): void {\n    this.queryCache.clear();\n    this.embeddingCache.clear();\n  }\n\n  /**\n   * Get memory pool statistics\n   */\n  public getStats() {\n    const dbStats = this.db.prepare(`\n      SELECT\n        (SELECT COUNT(*) FROM sqlite_master WHERE type='table') as tables,\n        (SELECT page_count * page_size FROM pragma_page_count(), pragma_page_size()) as dbSize\n    `).get() as any;\n\n    return {\n      database: {\n        path: this.config.dbPath,\n        size: dbStats.dbSize,\n        tables: dbStats.tables,\n        walMode: this.db.pragma('journal_mode', { simple: true }),\n      },\n      cache: {\n        queryCacheSize: this.queryCache.size,\n        queryCacheMax: this.config.cacheSize,\n        embeddingCacheSize: this.embeddingCache.size,\n        embeddingCacheMax: this.config.embeddingCacheSize,\n      },\n      embedder: {\n        model: this.config.embeddingModel,\n        dimension: this.config.embeddingDimension,\n        initialized: this.initialized,\n      },\n      memory: {\n        heapUsed: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),\n        external: Math.round(process.memoryUsage().external / 1024 / 1024),\n      }\n    };\n  }\n\n  /**\n   * Close database connection and cleanup\n   */\n  public close(): void {\n    this.clearCaches();\n    this.db.close();\n    this.initialized = false;\n  }\n}\n\n// Export singleton getter for convenience\nexport const getSharedMemoryPool = SharedMemoryPool.getInstance;\n"]}

package/dist/memory/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Memory Management Exports
- *
- * Provides shared memory pool and optimization utilities
- */
-export { SharedMemoryPool, getSharedMemoryPool } from './SharedMemoryPool.js';
-export type { SharedMemoryPoolConfig } from './SharedMemoryPool.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/memory/index.js

@@ -1,7 +0,0 @@
-/**
- * Memory Management Exports
- *
- * Provides shared memory pool and optimization utilities
- */
-export { SharedMemoryPool, getSharedMemoryPool } from './SharedMemoryPool.js';
-//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * Memory Management Exports\n *\n * Provides shared memory pool and optimization utilities\n */\n\nexport { SharedMemoryPool, getSharedMemoryPool } from './SharedMemoryPool.js';\nexport type { SharedMemoryPoolConfig } from './SharedMemoryPool.js';\n"]}