@engrama-ai/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Engrama Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,353 @@
+# Engrama TypeScript SDK
+
+Production-ready TypeScript SDK for Engrama - The Hippocampus for AI Agents.
+
+## Installation
+
+```bash
+npm install @engrama-ai/sdk
+# or
+yarn add @engrama-ai/sdk
+# or
+pnpm add @engrama-ai/sdk
+```
+
+## Quick Start
+
+```typescript
+import { createClient } from '@engrama-ai/sdk';
+
+// Initialize the client
+const client = createClient({
+  baseURL: 'http://localhost:3000',
+  apiKey: 'your-api-key', // optional
+  timeout: 30000,
+});
+
+// Store a memory
+const result = await client.remember(
+  'user-123',
+  'I love Python and React. I work at Google in Seattle.'
+);
+
+console.log(`Stored ${result.count} memories`);
+
+// Recall memories
+const recalled = await client.recall(
+  'user-123',
+  'What programming languages does the user like?'
+);
+
+console.log('Relevant memories:', recalled.memories);
+```
+
+## Features
+
+- ✅ Full TypeScript support with types
+- ✅ Promise-based async/await API
+- ✅ Automatic error handling
+- ✅ Request/response validation
+- ✅ Built-in retry logic
+- ✅ Production-ready
+
+## API Reference
+
+### Client Initialization
+
+```typescript
+import { MemoryEngineClient } from '@engrama-ai/sdk';
+
+const client = new MemoryEngineClient({
+  baseURL: 'http://localhost:3000',
+  apiKey: 'your-api-key',
+  timeout: 30000,
+});
+```
+
+### Memory Operations
+
+#### remember(userId, text, options?)
+
+Store new memories from text.
+
+```typescript
+const response = await client.remember(
+  'user-123',
+  'I love Python and React',
+  {
+    timestamp: new Date(),
+    metadata: { source: 'chat' }
+  }
+);
+```
+
+#### recall(userId, query, options?)
+
+Retrieve relevant memories.
+
+```typescript
+const response = await client.recall(
+  'user-123',
+  'What does the user like?',
+  {
+    k: 5,
+    tokenBudget: 1000,
+    filters: {
+      types: ['preference', 'profile'],
+      tags: ['technology']
+    }
+  }
+);
+```
+
+#### assemblePrompt(userId, agentInstructions, userInput, tokenBudget?)
+
+Build a prompt with memory context.
+
+```typescript
+const response = await client.assemblePrompt(
+  'user-123',
+  'You are a helpful assistant',
+  'Help me with Python',
+  2000
+);
+
+console.log(response.assembledPrompt);
+```
+
+#### listMemories(userId, options?)
+
+List all memories with filtering.
+
+```typescript
+const response = await client.listMemories('user-123', {
+  limit: 20,
+  offset: 0,
+  type: 'preference',
+  sortBy: 'createdAt',
+  sortOrder: 'desc'
+});
+```
+
+#### getMemory(memoryId, userId)
+
+Get a specific memory.
+
+```typescript
+const response = await client.getMemory('mem-123', 'user-123');
+console.log(response.memory);
+```
+
+#### deleteMemory(memoryId, userId)
+
+Delete a memory.
+
+```typescript
+await client.deleteMemory('mem-123', 'user-123');
+```
+
+#### mergeMemories(memoryIdA, memoryIdB, userId)
+
+Merge two memories.
+
+```typescript
+const result = await client.mergeMemories(
+  'mem-123',
+  'mem-456',
+  'user-123'
+);
+```
+
+### Knowledge Graph
+
+#### getGraph(userId, options?)
+
+Get the knowledge graph.
+
+```typescript
+const response = await client.getGraph('user-123', {
+  depth: 2,
+  limit: 50,
+  entityTypes: ['person', 'organization'],
+  relationshipTypes: ['related_to', 'contradicts']
+});
+
+console.log(response.graph.nodes);
+console.log(response.graph.edges);
+```
+
+### Analytics
+
+#### getPlatformAnalytics()
+
+Get platform-wide analytics.
+
+```typescript
+const response = await client.getPlatformAnalytics();
+console.log('Total memories:', response.metrics.totalMemories);
+console.log('Total users:', response.metrics.totalUsers);
+```
+
+#### getUserAnalytics(userId)
+
+Get analytics for a specific user.
+
+```typescript
+const response = await client.getUserAnalytics('user-123');
+console.log('User stats:', response.stats);
+```
+
+### Health Check
+
+#### healthCheck()
+
+Check if the API is running.
+
+```typescript
+const health = await client.healthCheck();
+console.log(health.status); // 'healthy'
+```
+
+## Complete Examples
+
+### AI Agent with Memory
+
+```typescript
+import { createClient } from '@engrama-ai/sdk';
+import OpenAI from 'openai';
+
+const memory = createClient({ baseURL: 'http://localhost:3000' });
+const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+async function chatWithMemory(userId: string, userMessage: string) {
+  // Assemble prompt with memory context
+  const { assembledPrompt } = await memory.assemblePrompt(
+    userId,
+    'You are a helpful assistant with memory of past conversations.',
+    userMessage,
+    2000
+  );
+
+  // Send to LLM
+  const completion = await openai.chat.completions.create({
+    model: 'gpt-4',
+    messages: [
+      { role: 'system', content: assembledPrompt },
+      { role: 'user', content: userMessage }
+    ]
+  });
+
+  const response = completion.choices[0].message.content;
+
+  // Store the conversation
+  await memory.remember(
+    userId,
+    `User said: ${userMessage}. Assistant responded: ${response}`
+  );
+
+  return response;
+}
+
+// Usage
+const response = await chatWithMemory('user-123', 'What do I like?');
+console.log(response);
+```
+
+### Personal Knowledge Base
+
+```typescript
+import { createClient } from '@engrama-ai/sdk';
+
+const memory = createClient({ baseURL: 'http://localhost:3000' });
+
+async function buildKnowledgeBase(userId: string) {
+  // Store various facts
+  await memory.remember(userId, 'I live in Seattle');
+  await memory.remember(userId, 'I work at Google as a software engineer');
+  await memory.remember(userId, 'I love Python, React, and Docker');
+  await memory.remember(userId, 'My goal is to build a SaaS product');
+
+  // Query the knowledge base
+  const work = await memory.recall(userId, 'Where does the user work?');
+  const skills = await memory.recall(userId, 'What technologies does the user know?');
+  const goals = await memory.recall(userId, 'What are the user\'s goals?');
+
+  return { work, skills, goals };
+}
+```
+
+### Analytics Dashboard
+
+```typescript
+import { createClient } from '@engrama-ai/sdk';
+
+const memory = createClient({ baseURL: 'http://localhost:3000' });
+
+async function showDashboard() {
+  const { metrics } = await memory.getPlatformAnalytics();
+
+  console.log('=== Engrama Dashboard ===');
+  console.log(`Total Memories: ${metrics.totalMemories}`);
+  console.log(`Total Users: ${metrics.totalUsers}`);
+  console.log(`Created Today: ${metrics.memoriesCreatedToday}`);
+  console.log(`Total Entities: ${metrics.totalEntities}`);
+  console.log(`Total Relationships: ${metrics.totalRelationships}`);
+  
+  console.log('\nTop Entities:');
+  metrics.topEntities.forEach((entity, i) => {
+    console.log(`${i + 1}. ${entity.name} (${entity.type}) - ${entity.count} connections`);
+  });
+}
+```
+
+## Error Handling
+
+```typescript
+try {
+  const result = await client.remember('user-123', 'Some text');
+} catch (error) {
+  if (error.message.includes('No response from server')) {
+    console.error('Server is down');
+  } else if (error.message.includes('API Error: 400')) {
+    console.error('Invalid request');
+  } else {
+    console.error('Unknown error:', error.message);
+  }
+}
+```
+
+## TypeScript Types
+
+All types are exported and fully documented:
+
+```typescript
+import {
+  Memory,
+  RememberResponse,
+  RecallResponse,
+  KnowledgeGraph,
+  AnalyticsMetrics,
+} from '@engrama-ai/sdk';
+```
+
+## Best Practices
+
+1. **Reuse the client instance** - Create one client and reuse it
+2. **Handle errors gracefully** - Always wrap API calls in try-catch
+3. **Use appropriate token budgets** - Don't exceed LLM context limits
+4. **Filter recalls** - Use filters to get relevant memories faster
+5. **Monitor analytics** - Track usage and performance
+
+## License
+
+MIT
+
+## Support
+
+- GitHub: https://github.com/yourusername/memory-engine
+- Issues: https://github.com/yourusername/memory-engine/issues
+- Documentation: https://memory-engine-docs.com
+
+## Contributing
+
+Contributions welcome! Please see CONTRIBUTING.md

package/dist/client.d.ts

@@ -0,0 +1,110 @@
+import { MemoryEngineConfig, RememberResponse, RecallResponse, AssemblePromptResponse, ListMemoriesResponse, Memory, GetGraphResponse, AnalyticsMetrics, UserStats } from './types';
+export declare class MemoryEngineClient {
+    private client;
+    private config;
+    constructor(config: MemoryEngineConfig);
+    private handleError;
+    remember(userId: string, text: string, options?: {
+        scope?: {
+            type: 'user' | 'task' | 'session' | 'agent';
+            id: string;
+        };
+        agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+        source?: 'user' | 'system' | 'environment' | 'ai';
+        agentId?: string;
+        timestamp?: Date;
+        metadata?: Record<string, any>;
+        confirmed?: boolean;
+        promote?: boolean;
+    }): Promise<RememberResponse>;
+    recall(userId: string, query: string, options?: {
+        scope?: {
+            type: 'user' | 'task' | 'session' | 'agent';
+            id: string;
+        };
+        scopes?: Array<{
+            type: 'user' | 'task' | 'session' | 'agent';
+            id: string;
+        }>;
+        agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+        k?: number;
+        tokenBudget?: number;
+        filters?: {
+            types?: string[];
+            sources?: ('user' | 'system' | 'environment' | 'ai')[];
+            dateRange?: {
+                start: Date;
+                end: Date;
+            };
+            tags?: string[];
+        };
+    }): Promise<RecallResponse>;
+    assemblePrompt(userId: string, agentInstructions: string, userInput: string, tokenBudget?: number): Promise<AssemblePromptResponse>;
+    listMemories(userId: string, options?: {
+        limit?: number;
+        offset?: number;
+        type?: string;
+        sortBy?: 'createdAt' | 'updatedAt' | 'confidence';
+        sortOrder?: 'asc' | 'desc';
+    }): Promise<ListMemoriesResponse>;
+    getMemory(memoryId: string, userId: string): Promise<{
+        success: boolean;
+        memory: Memory;
+    }>;
+    deleteMemory(memoryId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+    mergeMemories(memoryIdA: string, memoryIdB: string, userId: string): Promise<{
+        success: boolean;
+        result: any;
+    }>;
+    getGraph(userId: string, options?: {
+        depth?: number;
+        entityTypes?: string[];
+        relationshipTypes?: string[];
+        centerMemoryId?: string;
+        limit?: number;
+    }): Promise<GetGraphResponse>;
+    getPlatformAnalytics(): Promise<{
+        success: boolean;
+        metrics: AnalyticsMetrics;
+    }>;
+    getUserAnalytics(userId: string): Promise<{
+        success: boolean;
+        stats: UserStats;
+    }>;
+    healthCheck(): Promise<{
+        status: string;
+        timestamp: string;
+        version: string;
+    }>;
+    rememberProjectConfig(userId: string, projectId: string, config: {
+        framework?: string;
+        router?: string;
+        language?: string;
+        styling?: string;
+        backend?: string;
+        deployment?: string;
+        database?: string;
+        auth?: string;
+    }, options?: {
+        agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+    }): Promise<RememberResponse>;
+    rememberDecision(userId: string, taskId: string, decision: string, options?: {
+        confirmed?: boolean;
+        agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+    }): Promise<RememberResponse>;
+    recallProjectContext(userId: string, taskId: string, query: string, options?: {
+        k?: number;
+        includeUserPreferences?: boolean;
+        agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+    }): Promise<RecallResponse>;
+    rememberConstraint(userId: string, taskId: string, constraint: string, options?: {
+        agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+    }): Promise<RememberResponse>;
+    rememberUserPreference(userId: string, preference: string, options?: {
+        agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+    }): Promise<RememberResponse>;
+}
+export declare function createClient(config: MemoryEngineConfig): MemoryEngineClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,212 @@
+import axios from 'axios';
+export class MemoryEngineClient {
+    constructor(config) {
+        this.config = {
+            apiKey: config.apiKey,
+            baseURL: config.baseURL || 'http://localhost:3000',
+            timeout: config.timeout || 30000,
+        };
+        this.client = axios.create({
+            baseURL: this.config.baseURL,
+            timeout: this.config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                ...(this.config.apiKey && {
+                    'X-API-Key': this.config.apiKey,
+                }),
+            },
+        });
+        if (this.config.apiKey) {
+            if (this.config.apiKey.startsWith('eyJ')) {
+                this.client.defaults.headers.common['Authorization'] = `Bearer ${this.config.apiKey}`;
+            }
+            else {
+                this.client.defaults.headers.common['X-API-Key'] = this.config.apiKey;
+            }
+        }
+        this.client.interceptors.response.use((response) => response, (error) => {
+            throw this.handleError(error);
+        });
+    }
+    handleError(error) {
+        if (error.response) {
+            const data = error.response.data;
+            return new Error(data.error?.message || data.message || `API Error: ${error.response.status}`);
+        }
+        else if (error.request) {
+            return new Error('No response from server. Please check your connection.');
+        }
+        else {
+            return new Error(error.message || 'Unknown error occurred');
+        }
+    }
+    async remember(userId, text, options) {
+        const requestBody = {
+            userId,
+            text,
+            timestamp: options?.timestamp?.toISOString(),
+            metadata: options?.metadata,
+        };
+        if (options?.scope) {
+            requestBody.scope = options.scope;
+        }
+        if (options?.agentType) {
+            requestBody.agentType = options.agentType;
+        }
+        if (options?.source) {
+            requestBody.source = options.source;
+        }
+        if (options?.agentId) {
+            requestBody.agentId = options.agentId;
+        }
+        if (options?.confirmed !== undefined) {
+            requestBody.confirmed = options.confirmed;
+        }
+        if (options?.promote !== undefined) {
+            requestBody.promote = options.promote;
+        }
+        const response = await this.client.post('/api/remember', requestBody);
+        return response.data;
+    }
+    async recall(userId, query, options) {
+        const requestBody = {
+            userId,
+            query,
+            k: options?.k,
+            tokenBudget: options?.tokenBudget,
+            filters: options?.filters,
+        };
+        if (options?.scope) {
+            requestBody.scope = options.scope;
+        }
+        if (options?.scopes) {
+            requestBody.scopes = options.scopes;
+        }
+        if (options?.agentType) {
+            requestBody.agentType = options.agentType;
+        }
+        const response = await this.client.post('/api/recall', requestBody);
+        return response.data;
+    }
+    async assemblePrompt(userId, agentInstructions, userInput, tokenBudget) {
+        const response = await this.client.post('/api/assemble_prompt', {
+            userId,
+            agentInstructions,
+            userInput,
+            tokenBudget,
+        });
+        return response.data;
+    }
+    async listMemories(userId, options) {
+        const params = new URLSearchParams({
+            userId,
+            ...(options?.limit && { limit: options.limit.toString() }),
+            ...(options?.offset && { offset: options.offset.toString() }),
+            ...(options?.type && { type: options.type }),
+            ...(options?.sortBy && { sortBy: options.sortBy }),
+            ...(options?.sortOrder && { sortOrder: options.sortOrder }),
+        });
+        const response = await this.client.get(`/api/memories?${params.toString()}`);
+        return response.data;
+    }
+    async getMemory(memoryId, userId) {
+        const response = await this.client.get(`/api/memories/${memoryId}?userId=${userId}`);
+        return response.data;
+    }
+    async deleteMemory(memoryId, userId) {
+        const response = await this.client.delete(`/api/memories/${memoryId}?userId=${userId}`);
+        return response.data;
+    }
+    async mergeMemories(memoryIdA, memoryIdB, userId) {
+        const response = await this.client.post('/api/memories/merge', {
+            memoryIdA,
+            memoryIdB,
+            userId,
+        });
+        return response.data;
+    }
+    async getGraph(userId, options) {
+        const params = new URLSearchParams({
+            userId,
+            ...(options?.depth && { depth: options.depth.toString() }),
+            ...(options?.limit && { limit: options.limit.toString() }),
+            ...(options?.centerMemoryId && { centerMemoryId: options.centerMemoryId }),
+            ...(options?.entityTypes && { entityTypes: options.entityTypes.join(',') }),
+            ...(options?.relationshipTypes && { relationshipTypes: options.relationshipTypes.join(',') }),
+        });
+        const response = await this.client.get(`/api/graph?${params.toString()}`);
+        return response.data;
+    }
+    async getPlatformAnalytics() {
+        const response = await this.client.get('/api/analytics/platform');
+        return response.data;
+    }
+    async getUserAnalytics(userId) {
+        const response = await this.client.get(`/api/analytics/user/${userId}`);
+        return response.data;
+    }
+    async healthCheck() {
+        const response = await this.client.get('/health');
+        return response.data;
+    }
+    async rememberProjectConfig(userId, projectId, config, options) {
+        const configText = Object.entries(config)
+            .filter(([_, value]) => value)
+            .map(([key, value]) => `${key}: ${value}`)
+            .join(', ');
+        return this.remember(userId, `Project configuration: ${configText}`, {
+            scope: { type: 'task', id: projectId },
+            agentType: options?.agentType || 'coding',
+            source: 'user',
+            metadata: {
+                projectConfig: config,
+            },
+        });
+    }
+    async rememberDecision(userId, taskId, decision, options) {
+        const confirmed = options?.confirmed !== undefined ? options.confirmed : true;
+        if (!confirmed) {
+            throw new Error('Decisions must be confirmed before storing');
+        }
+        return this.remember(userId, `Decision: ${decision}`, {
+            scope: { type: 'task', id: taskId },
+            agentType: options?.agentType || 'general',
+            source: 'user',
+            confirmed: true,
+        });
+    }
+    async recallProjectContext(userId, taskId, query, options) {
+        const scopes = [
+            { type: 'task', id: taskId },
+        ];
+        if (options?.includeUserPreferences !== false) {
+            scopes.push({ type: 'user', id: userId });
+        }
+        return this.recall(userId, query, {
+            scopes,
+            agentType: options?.agentType,
+            k: options?.k || 10,
+            filters: {
+                types: ['preference', 'decision', 'constraint', 'fact', 'goal', 'context'],
+            },
+        });
+    }
+    async rememberConstraint(userId, taskId, constraint, options) {
+        return this.remember(userId, `Constraint: ${constraint}`, {
+            scope: { type: 'task', id: taskId },
+            agentType: options?.agentType || 'general',
+            source: 'user',
+        });
+    }
+    async rememberUserPreference(userId, preference, options) {
+        return this.remember(userId, `User preference: ${preference}`, {
+            scope: { type: 'user', id: userId },
+            agentType: options?.agentType || 'general',
+            source: 'user',
+        });
+    }
+}
+export function createClient(config) {
+    return new MemoryEngineClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { MemoryEngineClient, createClient } from './client';
+export * from './types';
+import { MemoryEngineClient } from './client';
+export default MemoryEngineClient;
+//# 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":"AAMA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,eAAe,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { MemoryEngineClient, createClient } from './client';
+export * from './types';
+import { MemoryEngineClient } from './client';
+export default MemoryEngineClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,eAAe,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,194 @@
+export interface MemoryEngineConfig {
+    apiKey?: string;
+    baseURL?: string;
+    timeout?: number;
+}
+export interface Memory {
+    id: string;
+    userId: string;
+    agentId?: string;
+    scope: {
+        type: 'user' | 'task' | 'session' | 'agent';
+        id: string;
+    };
+    category: string;
+    canonicalText: string;
+    type: string;
+    source: 'user' | 'system' | 'environment' | 'ai';
+    confidence: number;
+    tags: string[];
+    timestamp: string;
+    createdAt: string;
+    updatedAt: string;
+    version: number;
+    ttl?: string;
+    provenance: Provenance[];
+    linkedMemories: string[];
+    conflictStatus: 'none' | 'conflict' | 'resolved' | 'superseded';
+    visibility: 'private' | 'shared' | 'public';
+    metadata: Record<string, any>;
+    requiresConfirmation?: boolean;
+    confirmed?: boolean;
+    promoted?: boolean;
+    supersedesMemoryId?: string;
+    agentType?: 'coding' | 'healthcare' | 'support' | 'research' | 'general';
+}
+export interface Provenance {
+    source: string;
+    timestamp: string;
+    rawText: string;
+    confidence: number;
+}
+export interface RetrievalResult {
+    memory: Memory;
+    score: number;
+    similarityScore: number;
+    recencyScore: number;
+    confidenceScore: number;
+    typeScore: number;
+}
+export interface ContextBlock {
+    memories: Memory[];
+    memoryIds: string[];
+    contextText: string;
+    tokenCount: number;
+    timestamp: string;
+}
+export interface RememberRequest {
+    userId: string;
+    text: string;
+    timestamp?: string;
+    metadata?: Record<string, any>;
+}
+export interface RememberResponse {
+    success: boolean;
+    memories: Memory[];
+    count: number;
+}
+export interface RecallRequest {
+    userId: string;
+    query: string;
+    k?: number;
+    tokenBudget?: number;
+    filters?: {
+        types?: string[];
+        dateRange?: {
+            start: string;
+            end: string;
+        };
+        tags?: string[];
+    };
+}
+export interface RecallResponse {
+    success: boolean;
+    memories: RetrievalResult[];
+    count: number;
+}
+export interface AssemblePromptRequest {
+    userId: string;
+    agentInstructions: string;
+    userInput: string;
+    tokenBudget?: number;
+}
+export interface AssemblePromptResponse {
+    success: boolean;
+    assembledPrompt: string;
+    contextBlock: ContextBlock;
+    usedMemories: string[];
+}
+export interface ListMemoriesRequest {
+    userId: string;
+    limit?: number;
+    offset?: number;
+    type?: string;
+    sortBy?: 'createdAt' | 'updatedAt' | 'confidence';
+    sortOrder?: 'asc' | 'desc';
+}
+export interface ListMemoriesResponse {
+    success: boolean;
+    memories: Memory[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface GraphNode {
+    id: string;
+    label: string;
+    type: 'memory' | 'entity';
+    data: any;
+    size?: number;
+    color?: string;
+}
+export interface GraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    type: string;
+    label?: string;
+    confidence?: number;
+    data?: any;
+}
+export interface KnowledgeGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    metadata: {
+        totalNodes: number;
+        totalEdges: number;
+        entityTypes: Record<string, number>;
+        relationshipTypes: Record<string, number>;
+    };
+}
+export interface GetGraphRequest {
+    userId: string;
+    depth?: number;
+    entityTypes?: string[];
+    relationshipTypes?: string[];
+    centerMemoryId?: string;
+    limit?: number;
+}
+export interface GetGraphResponse {
+    success: boolean;
+    graph: KnowledgeGraph;
+}
+export interface AnalyticsMetrics {
+    totalMemories: number;
+    totalUsers: number;
+    memoriesCreatedToday: number;
+    memoriesCreatedThisWeek: number;
+    memoriesCreatedThisMonth: number;
+    averageMemoriesPerUser: number;
+    totalEntities: number;
+    totalRelationships: number;
+    memoryTypeDistribution: Record<string, number>;
+    entityTypeDistribution: Record<string, number>;
+    topEntities: Array<{
+        name: string;
+        type: string;
+        count: number;
+    }>;
+    userActivity: Array<{
+        date: string;
+        count: number;
+    }>;
+    averageConfidence: number;
+    storageUsed: number;
+}
+export interface UserStats {
+    userId: string;
+    totalMemories: number;
+    memoriesThisWeek: number;
+    totalEntities: number;
+    totalRelationships: number;
+    firstMemoryDate: string;
+    lastMemoryDate: string;
+    mostUsedTypes: Array<{
+        type: string;
+        count: number;
+    }>;
+    topEntities: Array<{
+        name: string;
+        type: string;
+        count: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,IAAI,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;IAChE,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,SAAS,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;CAC1E;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,EAAE;YACV,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAC;SACb,CAAC;QACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IAClD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC3C,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;CACvB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@engrama-ai/sdk",
+  "version": "0.1.0",
+  "description": "Production-ready TypeScript SDK for Engrama - The Hippocampus for AI Agents",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "jest",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "memory",
+    "ai",
+    "agent",
+    "llm",
+    "engrama",
+    "knowledge-graph",
+    "semantic-memory",
+    "long-term-memory"
+  ],
+  "author": "Engrama Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/engrama.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/engrama/issues"
+  },
+  "homepage": "https://github.com/yourusername/engrama#readme",
+  "dependencies": {
+    "axios": "^1.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.5",
+    "typescript": "^5.3.3",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.11"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}