@dcyfr/ai 1.0.3 → 1.0.4

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

@@ -0,0 +1,175 @@
+/**
+ * Memory Layer Type Definitions
+ *
+ * Core interfaces for DCYFR memory abstraction layer.
+ * Provides type safety for user, agent, and session memory operations.
+ *
+ * @module @dcyfr/ai/memory/types
+ */
+/**
+ * Base memory object
+ */
+export interface Memory {
+    /** Unique memory identifier */
+    id: string;
+    /** Memory content (text) */
+    content: string;
+    /** Owner (userId or agentId) */
+    owner: string;
+    /** Owner type */
+    ownerType: 'user' | 'agent' | 'session';
+    /** Importance score (0-1, higher = more important) */
+    importance?: number;
+    /** Topic/category for filtering */
+    topic?: string;
+    /** Timestamp when memory was created */
+    createdAt: Date;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Agent-specific memory (extends base Memory)
+ */
+export interface AgentMemory extends Memory {
+    ownerType: 'agent';
+    /** Agent identifier */
+    agentId: string;
+    /** Session identifier */
+    sessionId: string;
+    /** Agent workflow state */
+    state?: Record<string, any>;
+}
+/**
+ * Session-specific memory (temporary context)
+ */
+export interface SessionMemory extends Memory {
+    ownerType: 'session';
+    /** Session identifier */
+    sessionId: string;
+    /** Expiration timestamp (auto-delete after) */
+    expiresAt?: Date;
+}
+/**
+ * Memory search result (includes relevance score)
+ */
+export interface MemorySearchResult extends Memory {
+    /** Relevance score from vector search (0-1) */
+    relevance: number;
+}
+/**
+ * Memory addition context (optional metadata)
+ */
+export interface MemoryContext {
+    /** Topic/category for filtering */
+    topic?: string;
+    /** Importance score (0-1) */
+    importance?: number;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * DCYFRMemory interface - main API for memory operations
+ *
+ * This abstraction layer wraps mem0 (or other memory providers)
+ * to provide a consistent API for DCYFR applications.
+ */
+export interface DCYFRMemory {
+    /**
+     * Add a user-level memory (persistent across sessions)
+     *
+     * @param userId - Unique user identifier
+     * @param message - Memory content
+     * @param context - Optional metadata (topic, importance)
+     * @returns Memory ID
+     */
+    addUserMemory(userId: string, message: string, context?: MemoryContext): Promise<string>;
+    /**
+     * Search user memories by semantic query
+     *
+     * @param userId - Unique user identifier
+     * @param query - Search query (natural language)
+     * @param limit - Max results to return (default: 3)
+     * @returns Array of relevant memories
+     */
+    searchUserMemories(userId: string, query: string, limit?: number): Promise<MemorySearchResult[]>;
+    /**
+     * Get all memories for a user (optionally filtered by topic)
+     *
+     * @param userId - Unique user identifier
+     * @param topic - Optional topic filter
+     * @returns Array of user memories
+     */
+    getUserMemories(userId: string, topic?: string): Promise<Memory[]>;
+    /**
+     * Add agent workflow state (for multi-step tasks)
+     *
+     * @param agentId - Unique agent identifier
+     * @param sessionId - Current session ID
+     * @param state - Workflow state to persist
+     * @returns Memory ID
+     */
+    addAgentMemory(agentId: string, sessionId: string, state: Record<string, any>): Promise<string>;
+    /**
+     * Search agent memories (retrieve workflow state)
+     *
+     * @param agentId - Unique agent identifier
+     * @param query - Search query
+     * @param limit - Max results to return (default: 3)
+     * @returns Array of agent memories
+     */
+    searchAgentMemories(agentId: string, query: string, limit?: number): Promise<MemorySearchResult[]>;
+    /**
+     * Get full agent state for a session
+     *
+     * @param agentId - Unique agent identifier
+     * @param sessionId - Session identifier
+     * @returns Agent workflow state
+     */
+    getAgentState(agentId: string, sessionId: string): Promise<Record<string, any> | null>;
+    /**
+     * Add temporary session context (auto-expires)
+     *
+     * @param sessionId - Unique session identifier
+     * @param message - Context message
+     * @param ttl - Time-to-live in seconds (default: 3600)
+     * @returns Memory ID
+     */
+    addSessionMemory(sessionId: string, message: string, ttl?: number): Promise<string>;
+    /**
+     * Get full session context (for prompt injection)
+     *
+     * @param sessionId - Unique session identifier
+     * @returns Concatenated session context string
+     */
+    getSessionContext(sessionId: string): Promise<string>;
+    /**
+     * Delete all memories for a user (GDPR compliance)
+     *
+     * @param userId - Unique user identifier
+     */
+    deleteUserMemories(userId: string): Promise<void>;
+    /**
+     * Delete all session memories (cleanup)
+     *
+     * @param sessionId - Session identifier
+     */
+    deleteSessionMemories(sessionId: string): Promise<void>;
+}
+/**
+ * Memory provider interface (for swapping backends)
+ */
+export interface MemoryProvider {
+    /** Provider name (e.g., 'mem0', 'llamaindex') */
+    name: string;
+    /** Initialize provider with configuration */
+    initialize(config: any): Promise<void>;
+    /** Store a memory */
+    store(memory: Omit<Memory, 'id' | 'createdAt'>): Promise<string>;
+    /** Search memories */
+    search(owner: string, query: string, limit: number): Promise<MemorySearchResult[]>;
+    /** Retrieve memories */
+    retrieve(owner: string, filters?: Record<string, any>): Promise<Memory[]>;
+    /** Delete memories */
+    delete(owner: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/ai/memory/types.js

@@ -0,0 +1,10 @@
+/**
+ * Memory Layer Type Definitions
+ *
+ * Core interfaces for DCYFR memory abstraction layer.
+ * Provides type safety for user, agent, and session memory operations.
+ *
+ * @module @dcyfr/ai/memory/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../packages/ai/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -1,10 +1,20 @@
 {
   "name": "@dcyfr/ai",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Portable AI agent framework with plugin architecture",
   "main": "./dist/ai/index.js",
   "types": "./dist/ai/index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/ai/index.d.ts",
+      "import": "./dist/ai/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/ai/mcp/index.d.ts",
+      "import": "./dist/ai/mcp/index.js"
+    }
+  },
   "bin": {
     "dcyfr-ai": "./bin/dcyfr-ai.js",
     "dcyfr-ai-tui": "./bin/tui.js"
@@ -18,6 +28,14 @@
     "prepack": "npm run build",
     "cli": "node bin/cli.js",
     "tui": "node bin/tui.js",
+    "mcp:analytics": "tsx packages/ai/mcp/servers/analytics/index.ts",
+    "mcp:tokens": "tsx packages/ai/mcp/servers/design-tokens/index.ts",
+    "mcp:content": "tsx packages/ai/mcp/servers/content-manager/index.ts",
+    "mcp:promptintel": "tsx packages/ai/mcp/servers/promptintel/index.ts",
+    "mcp:dev:analytics": "npx fastmcp dev packages/ai/mcp/servers/analytics/index.ts",
+    "mcp:dev:tokens": "npx fastmcp dev packages/ai/mcp/servers/design-tokens/index.ts",
+    "mcp:dev:content": "npx fastmcp dev packages/ai/mcp/servers/content-manager/index.ts",
+    "mcp:dev:promptintel": "npx fastmcp dev packages/ai/mcp/servers/promptintel/index.ts",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "changeset:publish": "changeset publish",
@@ -47,9 +65,13 @@
   },
   "homepage": "https://github.com/dcyfr/dcyfr-ai#readme",
   "dependencies": {
+    "@upstash/redis": "^1.34.3",
     "chalk": "^4.1.2",
     "cli-table3": "^0.6.5",
+    "fastmcp": "^3.30.1",
+    "gray-matter": "^4.0.3",
     "inquirer": "^13.2.2",
+    "mem0ai": "^2.2.2",
     "ora": "^9.1.0",
     "yaml": "^2.3.4",
     "zod": "^3.22.4"
@@ -59,7 +81,7 @@
     "@changesets/cli": "^2.29.8",
     "@types/glob": "^8.1.0",
     "@types/node": "^20.0.0",
-    "eslint": "^8.55.0",
+    "eslint": "^9.39.2",
     "typescript": "^5.3.0",
     "vitest": "^4.0.18"
   },