@dcyfr/ai 1.0.3 → 1.0.4

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

@@ -0,0 +1,183 @@
+/**
+ * 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) {
+    const status = success ? "✅" : "❌";
+    const duration = durationMs ? ` (${durationMs.toFixed(2)}ms)` : "";
+    console.warn(`${status} ${toolName}`, params, duration);
+}
+//# 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,87 @@
+/**
+ * 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 interface LLMConfig {
+    provider: 'openai' | 'anthropic' | 'custom';
+    apiKey?: string;
+    model?: string;
+    embeddingModel?: string;
+}
+/**
+ * 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: 'openai' | 'anthropic' | 'custom'
+ * - LLM_API_KEY: LLM API key (defaults to OPENAI_API_KEY if provider=openai)
+ * - LLM_MODEL: Model name
+ * - LLM_EMBEDDING_MODEL: Embedding model name
+ * - 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,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CA0C/C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwD/D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAI9C"}

package/dist/ai/memory/config.js

@@ -0,0 +1,154 @@
+/**
+ * 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: 'openai' | 'anthropic' | 'custom'
+ * - LLM_API_KEY: LLM API key (defaults to OPENAI_API_KEY if provider=openai)
+ * - LLM_MODEL: Model name
+ * - LLM_EMBEDDING_MODEL: Embedding model name
+ * - 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 llmApiKey = env.LLM_API_KEY || (llmProvider === 'openai' ? env.OPENAI_API_KEY : undefined);
+    const llmConfig = {
+        provider: llmProvider,
+        apiKey: llmApiKey,
+        model: env.LLM_MODEL || DEFAULT_CONFIG.llm.model,
+        embeddingModel: env.LLM_EMBEDDING_MODEL || DEFAULT_CONFIG.llm.embeddingModel,
+    };
+    // 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,
+    };
+}
+/**
+ * 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) {
+    const { vectorDB, llm } = config;
+    // Validate vector DB configuration
+    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}`);
+    }
+    // Validate LLM configuration
+    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');
+    }
+    // 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,63 @@
+/**
+ * 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;
+    /**
+     * 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;AAUpB;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,iBAAiB,CAA6B;IAEtD;;OAEG;YACW,iBAAiB;IAW/B;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC;IAoBlB;;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"}