@dcyfr/ai 1.0.3 → 2.1.0

package/dist/ai/mcp/servers/shared/utils.js

@@ -0,0 +1,233 @@
+/**
+ * Shared utilities for MCP servers
+ * Common functions used across Analytics, Design Token, and Content Manager MCPs
+ */
+// ============================================================================
+// Error Handling
+// ============================================================================
+export class MCPToolError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "MCPToolError";
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            details: this.details,
+        };
+    }
+}
+export function handleToolError(error) {
+    if (error instanceof MCPToolError) {
+        return `Error [${error.code}]: ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return `Unknown error: ${String(error)}`;
+}
+// ============================================================================
+// Environment Helpers
+// ============================================================================
+export function isProduction() {
+    return (process.env.NODE_ENV === "production" ||
+        process.env.VERCEL_ENV === "production");
+}
+export function isDevelopment() {
+    return (process.env.NODE_ENV === "development" ||
+        process.env.VERCEL_ENV === "development");
+}
+export function getEnvironment() {
+    if (process.env.VERCEL_ENV) {
+        return process.env.VERCEL_ENV;
+    }
+    if (process.env.NODE_ENV === "production")
+        return "production";
+    if (process.env.NODE_ENV === "development")
+        return "development";
+    return "development";
+}
+// ============================================================================
+// Data Filtering
+// ============================================================================
+/**
+ * Filters out test/demo data in production environments
+ */
+export function filterProductionData(items) {
+    if (!isProduction()) {
+        return items;
+    }
+    // In production, exclude test data
+    return items.filter((item) => !item.isTest);
+}
+/**
+ * Warns if using fallback/demo data in production
+ */
+export function warnProductionFallback(dataSource) {
+    if (isProduction()) {
+        console.error(`❌ CRITICAL: Using demo/fallback data in production (${dataSource})`);
+    }
+}
+// ============================================================================
+// Time Helpers
+// ============================================================================
+export function getTimeRangeMs(range) {
+    const now = Date.now();
+    switch (range) {
+        case "1h":
+            return 60 * 60 * 1000; // 1 hour
+        case "24h":
+            return 24 * 60 * 60 * 1000;
+        case "7d":
+            return 7 * 24 * 60 * 60 * 1000;
+        case "30d":
+            return 30 * 24 * 60 * 60 * 1000;
+        case "all":
+            return now; // All time
+        default:
+            return 7 * 24 * 60 * 60 * 1000; // Default to 7 days
+    }
+}
+export function isWithinTimeRange(timestamp, range) {
+    if (range === "all")
+        return true;
+    const now = Date.now();
+    const rangeMs = getTimeRangeMs(range);
+    return now - timestamp <= rangeMs;
+}
+// ============================================================================
+// String Helpers
+// ============================================================================
+export function sanitizePath(path) {
+    // Remove leading/trailing slashes, normalize
+    return path.replace(/^\/+|\/+$/g, "").toLowerCase();
+}
+export function extractSlug(filePath) {
+    // Extract slug from file path (e.g., "blog/my-post.mdx" -> "my-post")
+    const parts = filePath.split("/");
+    const fileName = parts[parts.length - 1] || "";
+    return fileName.replace(/\.(mdx?|tsx?)$/, "");
+}
+export function calculateReadingTime(wordCount) {
+    // Average reading speed: 200 words per minute
+    const wordsPerMinute = 200;
+    return Math.ceil(wordCount / wordsPerMinute);
+}
+// ============================================================================
+// Array Helpers
+// ============================================================================
+export function dedupe(items) {
+    return Array.from(new Set(items));
+}
+export function sortByProperty(items, property, direction = "desc") {
+    return [...items].sort((a, b) => {
+        const aVal = a[property];
+        const bVal = b[property];
+        if (typeof aVal === "number" && typeof bVal === "number") {
+            return direction === "asc" ? aVal - bVal : bVal - aVal;
+        }
+        if (typeof aVal === "string" && typeof bVal === "string") {
+            return direction === "asc"
+                ? aVal.localeCompare(bVal)
+                : bVal.localeCompare(aVal);
+        }
+        return 0;
+    });
+}
+export function limitResults(items, limit) {
+    if (!limit || limit <= 0)
+        return items;
+    return items.slice(0, limit);
+}
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+export function isValidUrl(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isValidPath(path) {
+    // Basic validation: starts with /, contains no special chars except - and _
+    return /^\/[\w\-\/]*$/.test(path);
+}
+// ============================================================================
+// Performance Helpers
+// ============================================================================
+export async function measurePerformance(operation, label) {
+    const start = performance.now();
+    const result = await operation();
+    const durationMs = performance.now() - start;
+    if (durationMs > 500) {
+        console.warn(`⚠️ Performance warning: ${label} took ${durationMs.toFixed(2)}ms`);
+    }
+    return { result, durationMs };
+}
+// ============================================================================
+// Logging Helpers
+// ============================================================================
+export function logToolExecution(toolName, params, success, durationMs, delegationContext) {
+    const status = success ? "✅" : "❌";
+    const duration = durationMs ? ` (${durationMs.toFixed(2)}ms)` : "";
+    const delegation = delegationContext
+        ? ` [Contract: ${delegationContext.contractId || 'none'}]`
+        : "";
+    console.warn(`${status} ${toolName}${delegation}`, params, duration);
+}
+// ============================================================================
+// Delegation Event Emission
+// ============================================================================
+export function emitDelegationEvent(eventType, toolName, delegationContext, metadata) {
+    if (!delegationContext?.contractId) {
+        return; // No delegation context, skip event
+    }
+    const event = {
+        type: eventType,
+        timestamp: Date.now(),
+        contract_id: delegationContext.contractId,
+        delegator_agent_id: delegationContext.delegatorAgentId,
+        task_id: delegationContext.taskId,
+        tool_name: toolName,
+        metadata,
+    };
+    // Always log to console for debugging
+    console.warn('🔗 Delegation Event:', JSON.stringify(event));
+    // Attempt to stream to dcyfr-labs observability API
+    streamDelegationToObservability(event).catch(error => {
+        // Fail silently - MCP servers should not break if observability is down
+        console.warn('Failed to stream delegation event to observability API:', error.message);
+    });
+}
+async function streamDelegationToObservability(event) {
+    // Default to localhost for development, can be overridden with env var
+    const apiUrl = process.env.DCYFR_LABS_API_URL || 'http://localhost:3000';
+    const endpoint = `${apiUrl}/api/delegation/events`;
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(event),
+            // Timeout after 5 seconds to avoid blocking MCP operations
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+    }
+    catch (error) {
+        // Re-throw for handling by caller
+        throw error;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/ai/mcp/servers/shared/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../packages/ai/mcp/servers/shared/utils.ts"],"names":[],"mappings":"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"}

package/dist/ai/memory/config.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Memory Layer Configuration Module
+ *
+ * Loads and validates environment variables for mem0 memory integration.
+ * Supports multiple vector database backends (Qdrant, Pinecone, Weaviate).
+ *
+ * @module @dcyfr/ai/memory/config
+ */
+/**
+ * Supported vector database providers
+ */
+export type VectorDBProvider = 'qdrant' | 'pinecone' | 'weaviate';
+/**
+ * Vector database configuration
+ */
+export interface VectorDBConfig {
+    provider: VectorDBProvider;
+    url?: string;
+    apiKey?: string;
+    environment?: string;
+    index?: string;
+}
+/**
+ * LLM configuration for mem0 embeddings
+ */
+export type LLMProvider = 'openai' | 'anthropic' | 'ollama' | 'google' | 'gemini' | 'groq' | 'mistral' | 'azure_openai' | 'langchain';
+/**
+ * Embedder providers supported by mem0 OSS
+ */
+export type EmbedderProvider = 'openai' | 'ollama' | 'google' | 'gemini' | 'azure_openai' | 'langchain';
+export interface LLMConfig {
+    provider: LLMProvider;
+    apiKey?: string;
+    model?: string;
+    baseURL?: string;
+    embeddingModel?: string;
+    embeddingProvider?: EmbedderProvider;
+    embeddingApiKey?: string;
+    embeddingBaseURL?: string;
+    embeddingDims?: number;
+}
+/**
+ * Complete memory system configuration
+ */
+export interface MemoryConfig {
+    vectorDB: VectorDBConfig;
+    llm: LLMConfig;
+    caching?: {
+        enabled: boolean;
+        ttl: number;
+        maxSize: number;
+    };
+}
+/**
+ * Default configuration for local development
+ */
+export declare const DEFAULT_CONFIG: MemoryConfig;
+/**
+ * Load memory configuration from environment variables
+ *
+ * Environment variables:
+ * - VECTOR_DB_PROVIDER: 'qdrant' | 'pinecone' | 'weaviate'
+ * - VECTOR_DB_URL: Database URL (for Qdrant, Weaviate)
+ * - VECTOR_DB_API_KEY: API key (for Pinecone, authenticated Qdrant)
+ * - VECTOR_DB_ENVIRONMENT: Pinecone environment
+ * - VECTOR_DB_INDEX: Index/collection name
+ * - LLM_PROVIDER: See LLMProvider type
+ * - LLM_API_KEY: LLM API key (defaults to provider-specific env key)
+ * - LLM_API_BASE: Optional base URL (useful for OpenAI-compatible proxies)
+ * - LLM_MODEL: Model name
+ * - LLM_EMBEDDING_MODEL: Embedding model name
+ * - LLM_EMBEDDING_PROVIDER: Optional embedder provider override
+ * - LLM_EMBEDDING_API_KEY: Optional embedder API key override
+ * - LLM_EMBEDDING_BASE_URL: Optional embedder base URL override
+ * - LLM_EMBEDDING_DIMS: Optional embedding dimensions override
+ * - MEMORY_CACHE_ENABLED: 'true' | 'false'
+ * - MEMORY_CACHE_TTL: Cache TTL in seconds
+ * - MEMORY_CACHE_MAX_SIZE: Max cache entries
+ *
+ * @returns Complete memory configuration
+ * @throws Error if required environment variables are missing
+ */
+export declare function loadMemoryConfig(): MemoryConfig;
+/**
+ * Validate memory configuration
+ *
+ * Ensures all required fields are present based on vector DB provider.
+ *
+ * @param config - Configuration to validate
+ * @throws Error if configuration is invalid or missing required fields
+ */
+export declare function validateMemoryConfig(config: MemoryConfig): void;
+/**
+ * Get validated memory configuration
+ *
+ * Convenience function that loads and validates configuration in one call.
+ *
+ * @returns Validated memory configuration
+ * @throws Error if configuration is invalid
+ */
+export declare function getMemoryConfig(): MemoryConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/ai/memory/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../packages/ai/memory/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,cAAc,GACd,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,WAAW,CAAC;AAEhB,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAgB5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAwF/C;AAqDD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAa/D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAI9C"}

package/dist/ai/memory/config.js

@@ -0,0 +1,200 @@
+/**
+ * Memory Layer Configuration Module
+ *
+ * Loads and validates environment variables for mem0 memory integration.
+ * Supports multiple vector database backends (Qdrant, Pinecone, Weaviate).
+ *
+ * @module @dcyfr/ai/memory/config
+ */
+/**
+ * Default configuration for local development
+ */
+export const DEFAULT_CONFIG = {
+    vectorDB: {
+        provider: 'qdrant',
+        url: 'http://localhost:6333',
+        index: 'dcyfr_memories',
+    },
+    llm: {
+        provider: 'openai',
+        model: 'gpt-4',
+        embeddingModel: 'text-embedding-3-small',
+    },
+    caching: {
+        enabled: true,
+        ttl: 300, // 5 minutes
+        maxSize: 1000, // 1000 recent searches
+    },
+};
+/**
+ * Load memory configuration from environment variables
+ *
+ * Environment variables:
+ * - VECTOR_DB_PROVIDER: 'qdrant' | 'pinecone' | 'weaviate'
+ * - VECTOR_DB_URL: Database URL (for Qdrant, Weaviate)
+ * - VECTOR_DB_API_KEY: API key (for Pinecone, authenticated Qdrant)
+ * - VECTOR_DB_ENVIRONMENT: Pinecone environment
+ * - VECTOR_DB_INDEX: Index/collection name
+ * - LLM_PROVIDER: See LLMProvider type
+ * - LLM_API_KEY: LLM API key (defaults to provider-specific env key)
+ * - LLM_API_BASE: Optional base URL (useful for OpenAI-compatible proxies)
+ * - LLM_MODEL: Model name
+ * - LLM_EMBEDDING_MODEL: Embedding model name
+ * - LLM_EMBEDDING_PROVIDER: Optional embedder provider override
+ * - LLM_EMBEDDING_API_KEY: Optional embedder API key override
+ * - LLM_EMBEDDING_BASE_URL: Optional embedder base URL override
+ * - LLM_EMBEDDING_DIMS: Optional embedding dimensions override
+ * - MEMORY_CACHE_ENABLED: 'true' | 'false'
+ * - MEMORY_CACHE_TTL: Cache TTL in seconds
+ * - MEMORY_CACHE_MAX_SIZE: Max cache entries
+ *
+ * @returns Complete memory configuration
+ * @throws Error if required environment variables are missing
+ */
+export function loadMemoryConfig() {
+    const env = process.env;
+    // Vector DB configuration
+    const vectorDBProvider = (env.VECTOR_DB_PROVIDER || 'qdrant');
+    const vectorDBConfig = {
+        provider: vectorDBProvider,
+        url: env.VECTOR_DB_URL,
+        apiKey: env.VECTOR_DB_API_KEY,
+        environment: env.VECTOR_DB_ENVIRONMENT,
+        index: env.VECTOR_DB_INDEX || 'dcyfr_memories',
+    };
+    // Apply defaults based on provider
+    if (vectorDBProvider === 'qdrant' && !vectorDBConfig.url) {
+        vectorDBConfig.url = DEFAULT_CONFIG.vectorDB.url;
+    }
+    // LLM configuration
+    const llmProvider = (env.LLM_PROVIDER || 'openai');
+    const providerEnvKeys = {
+        openai: 'OPENAI_API_KEY',
+        anthropic: 'ANTHROPIC_API_KEY',
+        groq: 'GROQ_API_KEY',
+        google: 'GOOGLE_API_KEY',
+        gemini: 'GOOGLE_API_KEY',
+        mistral: 'MISTRAL_API_KEY',
+        azure_openai: 'AZURE_OPENAI_API_KEY',
+    };
+    const providerBaseEnvKeys = {
+        openai: 'OPENAI_API_BASE',
+        anthropic: 'ANTHROPIC_API_BASE',
+    };
+    const llmApiKey = env.LLM_API_KEY ||
+        (providerEnvKeys[llmProvider]
+            ? env[providerEnvKeys[llmProvider]]
+            : undefined);
+    const llmBaseURL = env.LLM_API_BASE ||
+        (providerBaseEnvKeys[llmProvider]
+            ? env[providerBaseEnvKeys[llmProvider]]
+            : undefined);
+    const defaultEmbeddingProvider = llmProvider === 'anthropic' || llmProvider === 'groq' || llmProvider === 'mistral'
+        ? 'openai'
+        : llmProvider;
+    const embeddingProvider = env.LLM_EMBEDDING_PROVIDER || defaultEmbeddingProvider;
+    const embeddingApiKey = env.LLM_EMBEDDING_API_KEY ||
+        (providerEnvKeys[embeddingProvider]
+            ? env[providerEnvKeys[embeddingProvider]]
+            : undefined) ||
+        llmApiKey;
+    const llmConfig = {
+        provider: llmProvider,
+        apiKey: llmApiKey,
+        model: env.LLM_MODEL || DEFAULT_CONFIG.llm.model,
+        baseURL: llmBaseURL,
+        embeddingModel: env.LLM_EMBEDDING_MODEL || DEFAULT_CONFIG.llm.embeddingModel,
+        embeddingProvider,
+        embeddingApiKey,
+        embeddingBaseURL: env.LLM_EMBEDDING_BASE_URL,
+        embeddingDims: env.LLM_EMBEDDING_DIMS ? parseInt(env.LLM_EMBEDDING_DIMS, 10) : undefined,
+    };
+    // Caching configuration
+    const cachingConfig = {
+        enabled: env.MEMORY_CACHE_ENABLED !== 'false', // Default true
+        ttl: parseInt(env.MEMORY_CACHE_TTL || '300', 10),
+        maxSize: parseInt(env.MEMORY_CACHE_MAX_SIZE || '1000', 10),
+    };
+    return {
+        vectorDB: vectorDBConfig,
+        llm: llmConfig,
+        caching: cachingConfig,
+    };
+}
+function validateVectorDBConfig(vectorDB) {
+    if (!vectorDB.provider) {
+        throw new Error('VECTOR_DB_PROVIDER is required');
+    }
+    switch (vectorDB.provider) {
+        case 'qdrant':
+            if (!vectorDB.url) {
+                throw new Error('VECTOR_DB_URL is required for Qdrant');
+            }
+            break;
+        case 'pinecone':
+            if (!vectorDB.apiKey) {
+                throw new Error('VECTOR_DB_API_KEY is required for Pinecone');
+            }
+            if (!vectorDB.environment) {
+                throw new Error('VECTOR_DB_ENVIRONMENT is required for Pinecone');
+            }
+            break;
+        case 'weaviate':
+            if (!vectorDB.url) {
+                throw new Error('VECTOR_DB_URL is required for Weaviate');
+            }
+            break;
+        default:
+            throw new Error(`Unsupported vector DB provider: ${vectorDB.provider}`);
+    }
+}
+function validateLLMConfig(llm) {
+    if (!llm.provider) {
+        throw new Error('LLM_PROVIDER is required');
+    }
+    if (llm.provider === 'openai' && !llm.apiKey) {
+        throw new Error('LLM_API_KEY or OPENAI_API_KEY is required for OpenAI provider');
+    }
+    if (!llm.embeddingModel) {
+        throw new Error('LLM_EMBEDDING_MODEL is required');
+    }
+    const effectiveEmbeddingApiKey = llm.embeddingApiKey || llm.apiKey;
+    if ((llm.embeddingProvider || 'openai') === 'openai' && !effectiveEmbeddingApiKey) {
+        throw new Error('LLM_EMBEDDING_API_KEY or OPENAI_API_KEY is required for OpenAI embeddings');
+    }
+}
+/**
+ * Validate memory configuration
+ *
+ * Ensures all required fields are present based on vector DB provider.
+ *
+ * @param config - Configuration to validate
+ * @throws Error if configuration is invalid or missing required fields
+ */
+export function validateMemoryConfig(config) {
+    validateVectorDBConfig(config.vectorDB);
+    validateLLMConfig(config.llm);
+    // Validate caching configuration
+    if (config.caching) {
+        if (config.caching.ttl <= 0) {
+            throw new Error('MEMORY_CACHE_TTL must be greater than 0');
+        }
+        if (config.caching.maxSize <= 0) {
+            throw new Error('MEMORY_CACHE_MAX_SIZE must be greater than 0');
+        }
+    }
+}
+/**
+ * Get validated memory configuration
+ *
+ * Convenience function that loads and validates configuration in one call.
+ *
+ * @returns Validated memory configuration
+ * @throws Error if configuration is invalid
+ */
+export function getMemoryConfig() {
+    const config = loadMemoryConfig();
+    validateMemoryConfig(config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/ai/memory/config.js.map

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

package/dist/ai/memory/dcyfr-memory.d.ts

@@ -0,0 +1,67 @@
+/**
+ * DCYFR Memory implementation wrapping mem0 OSS client
+ */
+import type { DCYFRMemory, Memory, MemorySearchResult, MemoryContext } from './types.js';
+/**
+ * DCYFRMemory implementation using mem0 OSS as the backend
+ */
+export declare class DCYFRMemoryImpl implements DCYFRMemory {
+    private mem0ClientPromise;
+    /**
+     * Lazy initialization of mem0 client
+     */
+    private ensureInitialized;
+    /**
+     * Retry semantic search briefly to smooth over vector index eventual consistency.
+     */
+    private searchWithConsistencyRetries;
+    /**
+     * Add memory associated with a specific user
+     */
+    addUserMemory(userId: string, message: string, context?: MemoryContext): Promise<string>;
+    /**
+     * Search user memories using semantic search
+     */
+    searchUserMemories(userId: string, query: string, limit?: number): Promise<MemorySearchResult[]>;
+    /**
+     * Get all memories for a user
+     */
+    getUserMemories(userId: string, topic?: string): Promise<Memory[]>;
+    /**
+     * Delete all memories for a user
+     */
+    deleteUserMemories(userId: string): Promise<void>;
+    /**
+     * Store agent workflow state
+     */
+    addAgentMemory(agentId: string, sessionId: string, state: Record<string, unknown>): Promise<string>;
+    /**
+     * Search agent memories
+     */
+    searchAgentMemories(agentId: string, query: string, limit?: number): Promise<MemorySearchResult[]>;
+    /**
+     * Get agent workflow state for a specific session
+     */
+    getAgentState(agentId: string, sessionId: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Add temporary session context with TTL
+     */
+    addSessionMemory(sessionId: string, message: string, ttl?: number): Promise<string>;
+    /**
+     * Get concatenated session context (filters out expired memories)
+     */
+    getSessionContext(sessionId: string): Promise<string>;
+    /**
+     * Delete all memories for a session
+     */
+    deleteSessionMemories(sessionId: string): Promise<void>;
+}
+/**
+ * Get singleton DCYFRMemory instance
+ */
+export declare function getMemory(): DCYFRMemory;
+/**
+ * Reset memory instance (for testing)
+ */
+export declare function resetMemory(): void;
+//# sourceMappingURL=dcyfr-memory.d.ts.map

package/dist/ai/memory/dcyfr-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dcyfr-memory.d.ts","sourceRoot":"","sources":["../../../packages/ai/memory/dcyfr-memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,kBAAkB,EAClB,aAAa,EAEd,MAAM,YAAY,CAAC;AAiBpB;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,iBAAiB,CAA6B;IAEtD;;OAEG;YACW,iBAAiB;IAQ/B;;OAEG;YACW,4BAA4B;IA2B1C;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC;IAoClB;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAmC,GACzC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAyBhC;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyBxE;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC;IAuBlB;;OAEG;IACG,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAoC,GAC1C,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA0BhC;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAwB1C;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAa,GACjB,OAAO,CAAC,MAAM,CAAC;IAqBlB;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B3D;;OAEG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ9D;AAQD;;GAEG;AACH,wBAAgB,SAAS,IAAI,WAAW,CAKvC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}