mengram-ai 2.3.2 → 2.5.0

package/index.d.ts

@@ -69,6 +69,49 @@ export interface JobStatus {
   error?: string;
 }
 
+export interface CognitiveProfile {
+  user_id: string;
+  system_prompt: string;
+  facts_used: number;
+  last_updated: string | null;
+  status: 'ok' | 'no_data' | 'no_facts' | 'no_llm_key' | 'error';
+  error?: string;
+}
+
+export interface Episode {
+  id: string;
+  summary: string;
+  context: string | null;
+  outcome: string | null;
+  participants: string[];
+  emotional_valence: 'positive' | 'negative' | 'neutral' | 'mixed';
+  importance: number;
+  score?: number;
+  created_at: string | null;
+  memory_type?: 'episodic';
+}
+
+export interface Procedure {
+  id: string;
+  name: string;
+  trigger_condition: string | null;
+  steps: Array<{ step: number; action: string; detail: string }>;
+  entity_names: string[];
+  success_count: number;
+  fail_count: number;
+  score?: number;
+  last_used: string | null;
+  created_at?: string | null;
+  updated_at: string | null;
+  memory_type?: 'procedural';
+}
+
+export interface UnifiedSearchResult {
+  semantic: SearchResult[];
+  episodic: Episode[];
+  procedural: Procedure[];
+}
+
 export interface Webhook {
   id: number;
   url: string;
@@ -98,8 +141,19 @@ export declare class MengramClient {
   delete(name: string): Promise<boolean>;
   stats(): Promise<Stats>;
   graph(): Promise<{ nodes: any[]; edges: any[] }>;
+  getProfile(userId?: string, options?: { force?: boolean }): Promise<CognitiveProfile>;
   timeline(options?: { after?: string; before?: string; limit?: number }): Promise<any[]>;
 
+  // Episodic Memory
+  episodes(options?: { query?: string; limit?: number; after?: string; before?: string }): Promise<Episode[]>;
+
+  // Procedural Memory
+  procedures(options?: { query?: string; limit?: number }): Promise<Procedure[]>;
+  procedureFeedback(procedureId: string, options?: { success?: boolean }): Promise<any>;
+
+  // Unified Search
+  searchAll(query: string, options?: { limit?: number }): Promise<UnifiedSearchResult>;
+
   // Agents
   runAgents(options?: { agent?: string; autoFix?: boolean }): Promise<any>;
   agentHistory(options?: { agent?: string; limit?: number }): Promise<any[]>;

package/index.js

@@ -208,6 +208,99 @@ class MengramClient {
     return this._request('GET', '/v1/graph');
   }
 
+  // ---- Cognitive Profile ----
+
+  /**
+   * Generate a Cognitive Profile — a ready-to-use system prompt from user memory.
+   * @param {string} userId - User to generate profile for
+   * @param {object} [options]
+   * @param {boolean} [options.force] - Regenerate even if cached
+   * @returns {Promise<{user_id: string, system_prompt: string, facts_used: number, status: string}>}
+   */
+  async getProfile(userId = 'default', options = {}) {
+    const params = {};
+    if (options.force) params.force = 'true';
+    return this._request('GET', `/v1/profile/${userId}`, null, params);
+  }
+
+  // ---- Episodic Memory ----
+
+  /**
+   * Get or search episodic memories (events, interactions, experiences).
+   * @param {object} [options]
+   * @param {string} [options.query] - Search query (if omitted, returns recent episodes)
+   * @param {number} [options.limit] - Max results (default 20)
+   * @param {string} [options.after] - ISO datetime filter start
+   * @param {string} [options.before] - ISO datetime filter end
+   * @returns {Promise<Array>}
+   */
+  async episodes(options = {}) {
+    if (options.query) {
+      const params = { query: options.query, limit: options.limit || 5 };
+      if (options.after) params.after = options.after;
+      if (options.before) params.before = options.before;
+      const data = await this._request('GET', '/v1/episodes/search', null, params);
+      return data.results || [];
+    } else {
+      const params = { limit: options.limit || 20 };
+      if (options.after) params.after = options.after;
+      if (options.before) params.before = options.before;
+      const data = await this._request('GET', '/v1/episodes', null, params);
+      return data.episodes || [];
+    }
+  }
+
+  // ---- Procedural Memory ----
+
+  /**
+   * Get or search procedural memories (learned workflows, skills).
+   * @param {object} [options]
+   * @param {string} [options.query] - Search query (if omitted, returns all procedures)
+   * @param {number} [options.limit] - Max results (default 20)
+   * @returns {Promise<Array>}
+   */
+  async procedures(options = {}) {
+    if (options.query) {
+      const params = { query: options.query, limit: options.limit || 5 };
+      const data = await this._request('GET', '/v1/procedures/search', null, params);
+      return data.results || [];
+    } else {
+      const params = { limit: options.limit || 20 };
+      const data = await this._request('GET', '/v1/procedures', null, params);
+      return data.procedures || [];
+    }
+  }
+
+  /**
+   * Record success/failure feedback for a procedure.
+   * @param {string} procedureId - UUID of the procedure
+   * @param {object} [options]
+   * @param {boolean} [options.success] - true if worked, false if failed (default true)
+   * @returns {Promise<object>}
+   */
+  async procedureFeedback(procedureId, options = {}) {
+    const success = options.success !== false;
+    return this._request('PATCH', `/v1/procedures/${procedureId}/feedback`, null, {
+      success: success ? 'true' : 'false',
+    });
+  }
+
+  // ---- Unified Search ----
+
+  /**
+   * Search across all 3 memory types: semantic, episodic, procedural.
+   * @param {string} query - Search query
+   * @param {object} [options]
+   * @param {number} [options.limit] - Max results per type (default 5)
+   * @returns {Promise<{semantic: Array, episodic: Array, procedural: Array}>}
+   */
+  async searchAll(query, options = {}) {
+    return this._request('POST', '/v1/search/all', {
+      query,
+      limit: options.limit || 5,
+    });
+  }
+
   /**
    * Timeline search.
    * @param {object} [options]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mengram-ai",
-  "version": "2.3.2",
+  "version": "2.5.0",
   "description": "AI Memory Layer with Autonomous Agents — JavaScript SDK",
   "main": "index.js",
   "types": "index.d.ts",