@usewhisper/sdk 2.1.0 → 2.2.0

package/index.d.mts

@@ -239,6 +239,26 @@ declare class WhisperAgentMiddleware {
 }
 declare function createAgentMiddleware(config: AgentMiddlewareConfig): WhisperAgentMiddleware;
 
+interface MemoryGraphNode {
+    id: string;
+    label?: string;
+    memory_type?: string;
+}
+interface MemoryGraphEdge {
+    source: string;
+    target: string;
+    type?: string;
+}
+interface MemoryGraphPayload {
+    nodes: MemoryGraphNode[];
+    edges: MemoryGraphEdge[];
+}
+/**
+ * Convert memory graph payload to Mermaid flowchart syntax.
+ * Useful for quick visualization in docs/dashboards.
+ */
+declare function memoryGraphToMermaid(graph: MemoryGraphPayload): string;
+
 /**
  * Whisper Context SDK
  * TypeScript SDK for the Whisper Context API
@@ -519,6 +539,7 @@ declare class WhisperContext {
         include_inactive?: boolean;
         include_chunks?: boolean;
         include_relations?: boolean;
+        fast_mode?: boolean;
     }): Promise<any>;
     ingestSession(params: {
         project?: string;
@@ -576,6 +597,19 @@ declare class WhisperContext {
         relations: any[];
         count: number;
     }>;
+    getMemoryGraph(params: {
+        project?: string;
+        user_id?: string;
+        session_id?: string;
+        include_inactive?: boolean;
+        limit?: number;
+    }): Promise<any>;
+    getConversationGraph(params: {
+        project?: string;
+        session_id: string;
+        include_inactive?: boolean;
+        limit?: number;
+    }): Promise<any>;
     oracleSearch(params: {
         query: string;
         project?: string;
@@ -835,6 +869,8 @@ declare class WhisperContext {
             relations: any[];
             count: number;
         }>;
+        getGraph: (params: Parameters<WhisperContext["getMemoryGraph"]>[0]) => Promise<any>;
+        getConversationGraph: (params: Parameters<WhisperContext["getConversationGraph"]>[0]) => Promise<any>;
         consolidate: (params: Parameters<WhisperContext["consolidateMemories"]>[0]) => Promise<any>;
         updateDecay: (params: Parameters<WhisperContext["updateImportanceDecay"]>[0]) => Promise<{
             success: boolean;
@@ -919,4 +955,4 @@ declare class WhisperContext {
     };
 }
 
-export { type ExtractedMemory, type Memory, type MemoryExtractionResult, type MemoryKind, type Project, type QueryParams, type QueryResult, type Source, Whisper, WhisperAgentMiddleware, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, createAgentMiddleware, WhisperContext as default };
+export { type ExtractedMemory, type Memory, type MemoryExtractionResult, type MemoryKind, type Project, type QueryParams, type QueryResult, type Source, Whisper, WhisperAgentMiddleware, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, createAgentMiddleware, WhisperContext as default, memoryGraphToMermaid };

package/index.d.ts

@@ -239,6 +239,26 @@ declare class WhisperAgentMiddleware {
 }
 declare function createAgentMiddleware(config: AgentMiddlewareConfig): WhisperAgentMiddleware;
 
+interface MemoryGraphNode {
+    id: string;
+    label?: string;
+    memory_type?: string;
+}
+interface MemoryGraphEdge {
+    source: string;
+    target: string;
+    type?: string;
+}
+interface MemoryGraphPayload {
+    nodes: MemoryGraphNode[];
+    edges: MemoryGraphEdge[];
+}
+/**
+ * Convert memory graph payload to Mermaid flowchart syntax.
+ * Useful for quick visualization in docs/dashboards.
+ */
+declare function memoryGraphToMermaid(graph: MemoryGraphPayload): string;
+
 /**
  * Whisper Context SDK
  * TypeScript SDK for the Whisper Context API
@@ -519,6 +539,7 @@ declare class WhisperContext {
         include_inactive?: boolean;
         include_chunks?: boolean;
         include_relations?: boolean;
+        fast_mode?: boolean;
     }): Promise<any>;
     ingestSession(params: {
         project?: string;
@@ -576,6 +597,19 @@ declare class WhisperContext {
         relations: any[];
         count: number;
     }>;
+    getMemoryGraph(params: {
+        project?: string;
+        user_id?: string;
+        session_id?: string;
+        include_inactive?: boolean;
+        limit?: number;
+    }): Promise<any>;
+    getConversationGraph(params: {
+        project?: string;
+        session_id: string;
+        include_inactive?: boolean;
+        limit?: number;
+    }): Promise<any>;
     oracleSearch(params: {
         query: string;
         project?: string;
@@ -835,6 +869,8 @@ declare class WhisperContext {
             relations: any[];
             count: number;
         }>;
+        getGraph: (params: Parameters<WhisperContext["getMemoryGraph"]>[0]) => Promise<any>;
+        getConversationGraph: (params: Parameters<WhisperContext["getConversationGraph"]>[0]) => Promise<any>;
         consolidate: (params: Parameters<WhisperContext["consolidateMemories"]>[0]) => Promise<any>;
         updateDecay: (params: Parameters<WhisperContext["updateImportanceDecay"]>[0]) => Promise<{
             success: boolean;
@@ -919,4 +955,4 @@ declare class WhisperContext {
     };
 }
 
-export { type ExtractedMemory, type Memory, type MemoryExtractionResult, type MemoryKind, type Project, type QueryParams, type QueryResult, type Source, Whisper, WhisperAgentMiddleware, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, createAgentMiddleware, WhisperContext as default };
+export { type ExtractedMemory, type Memory, type MemoryExtractionResult, type MemoryKind, type Project, type QueryParams, type QueryResult, type Source, Whisper, WhisperAgentMiddleware, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, createAgentMiddleware, WhisperContext as default, memoryGraphToMermaid };

package/index.js

@@ -26,7 +26,8 @@ __export(index_exports, {
   WhisperDefault: () => whisper_agent_default,
   WhisperError: () => WhisperError,
   createAgentMiddleware: () => createAgentMiddleware,
-  default: () => index_default
+  default: () => index_default,
+  memoryGraphToMermaid: () => memoryGraphToMermaid
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -346,6 +347,31 @@ function createAgentMiddleware(config) {
   return new WhisperAgentMiddleware(config);
 }
 
+// ../src/sdk/graph-utils.ts
+function sanitizeId(id) {
+  return `n_${id.replace(/[^a-zA-Z0-9_]/g, "_")}`;
+}
+function shortLabel(input, max = 48) {
+  const text = (input || "").replace(/\s+/g, " ").trim();
+  if (text.length <= max) return text;
+  return `${text.slice(0, max - 3)}...`;
+}
+function memoryGraphToMermaid(graph) {
+  const lines = ["flowchart LR"];
+  for (const node of graph.nodes || []) {
+    const sid = sanitizeId(node.id);
+    const label = shortLabel(node.label || node.id);
+    lines.push(`  ${sid}["${label.replace(/"/g, '\\"')}"]`);
+  }
+  for (const edge of graph.edges || []) {
+    const s = sanitizeId(edge.source);
+    const t = sanitizeId(edge.target);
+    const rel = shortLabel(edge.type || "rel", 18).replace(/"/g, '\\"');
+    lines.push(`  ${s} -->|${rel}| ${t}`);
+  }
+  return lines.join("\n");
+}
+
 // ../src/sdk/index.ts
 var WhisperError = class extends Error {
   code;
@@ -847,6 +873,26 @@ var WhisperContext = class _WhisperContext {
   async getMemoryRelations(memoryId) {
     return this.request(`/v1/memory/${memoryId}/relations`);
   }
+  async getMemoryGraph(params) {
+    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
+    const query = new URLSearchParams({
+      project,
+      ...params.user_id && { user_id: params.user_id },
+      ...params.session_id && { session_id: params.session_id },
+      ...params.include_inactive !== void 0 && { include_inactive: String(params.include_inactive) },
+      ...params.limit !== void 0 && { limit: String(params.limit) }
+    });
+    return this.request(`/v1/memory/graph?${query}`);
+  }
+  async getConversationGraph(params) {
+    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
+    const query = new URLSearchParams({
+      project,
+      ...params.include_inactive !== void 0 && { include_inactive: String(params.include_inactive) },
+      ...params.limit !== void 0 && { limit: String(params.limit) }
+    });
+    return this.request(`/v1/memory/graph/conversation/${params.session_id}?${query}`);
+  }
   async oracleSearch(params) {
     const project = await this.resolveProjectId(this.getRequiredProject(params.project));
     return this.request("/v1/oracle/search", {
@@ -983,6 +1029,8 @@ var WhisperContext = class _WhisperContext {
     update: (memoryId, params) => this.updateMemory(memoryId, params),
     delete: (memoryId) => this.deleteMemory(memoryId),
     getRelations: (memoryId) => this.getMemoryRelations(memoryId),
+    getGraph: (params) => this.getMemoryGraph(params),
+    getConversationGraph: (params) => this.getConversationGraph(params),
     consolidate: (params) => this.consolidateMemories(params),
     updateDecay: (params) => this.updateImportanceDecay(params),
     getImportanceStats: (project) => this.getImportanceStats(project)
@@ -1017,5 +1065,6 @@ var index_default = WhisperContext;
   WhisperContext,
   WhisperDefault,
   WhisperError,
-  createAgentMiddleware
+  createAgentMiddleware,
+  memoryGraphToMermaid
 });

package/index.mjs

@@ -314,6 +314,31 @@ function createAgentMiddleware(config) {
   return new WhisperAgentMiddleware(config);
 }
 
+// ../src/sdk/graph-utils.ts
+function sanitizeId(id) {
+  return `n_${id.replace(/[^a-zA-Z0-9_]/g, "_")}`;
+}
+function shortLabel(input, max = 48) {
+  const text = (input || "").replace(/\s+/g, " ").trim();
+  if (text.length <= max) return text;
+  return `${text.slice(0, max - 3)}...`;
+}
+function memoryGraphToMermaid(graph) {
+  const lines = ["flowchart LR"];
+  for (const node of graph.nodes || []) {
+    const sid = sanitizeId(node.id);
+    const label = shortLabel(node.label || node.id);
+    lines.push(`  ${sid}["${label.replace(/"/g, '\\"')}"]`);
+  }
+  for (const edge of graph.edges || []) {
+    const s = sanitizeId(edge.source);
+    const t = sanitizeId(edge.target);
+    const rel = shortLabel(edge.type || "rel", 18).replace(/"/g, '\\"');
+    lines.push(`  ${s} -->|${rel}| ${t}`);
+  }
+  return lines.join("\n");
+}
+
 // ../src/sdk/index.ts
 var WhisperError = class extends Error {
   code;
@@ -815,6 +840,26 @@ var WhisperContext = class _WhisperContext {
   async getMemoryRelations(memoryId) {
     return this.request(`/v1/memory/${memoryId}/relations`);
   }
+  async getMemoryGraph(params) {
+    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
+    const query = new URLSearchParams({
+      project,
+      ...params.user_id && { user_id: params.user_id },
+      ...params.session_id && { session_id: params.session_id },
+      ...params.include_inactive !== void 0 && { include_inactive: String(params.include_inactive) },
+      ...params.limit !== void 0 && { limit: String(params.limit) }
+    });
+    return this.request(`/v1/memory/graph?${query}`);
+  }
+  async getConversationGraph(params) {
+    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
+    const query = new URLSearchParams({
+      project,
+      ...params.include_inactive !== void 0 && { include_inactive: String(params.include_inactive) },
+      ...params.limit !== void 0 && { limit: String(params.limit) }
+    });
+    return this.request(`/v1/memory/graph/conversation/${params.session_id}?${query}`);
+  }
   async oracleSearch(params) {
     const project = await this.resolveProjectId(this.getRequiredProject(params.project));
     return this.request("/v1/oracle/search", {
@@ -951,6 +996,8 @@ var WhisperContext = class _WhisperContext {
     update: (memoryId, params) => this.updateMemory(memoryId, params),
     delete: (memoryId) => this.deleteMemory(memoryId),
     getRelations: (memoryId) => this.getMemoryRelations(memoryId),
+    getGraph: (params) => this.getMemoryGraph(params),
+    getConversationGraph: (params) => this.getConversationGraph(params),
     consolidate: (params) => this.consolidateMemories(params),
     updateDecay: (params) => this.updateImportanceDecay(params),
     getImportanceStats: (project) => this.getImportanceStats(project)
@@ -985,5 +1032,6 @@ export {
   whisper_agent_default as WhisperDefault,
   WhisperError,
   createAgentMiddleware,
-  index_default as default
+  index_default as default,
+  memoryGraphToMermaid
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usewhisper/sdk",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "scripts": {
     "build": "tsup ../src/sdk/index.ts --format esm,cjs --dts --out-dir .",
     "prepublishOnly": "npm run build"