@kalera/munin-sdk 1.0.0 → 1.0.2

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @kalera/munin-sdk@1.0.0 build /home/runner/work/munin-for-agents/munin-for-agents/packages/ts-sdk
+> @kalera/munin-sdk@1.0.2 build /home/runner/work/munin-for-agents/munin-for-agents/packages/ts-sdk
 > tsc -p tsconfig.json
 

package/dist/client.d.ts

@@ -5,12 +5,18 @@ export declare class MuninClient {
     private readonly timeoutMs;
     private readonly fetchImpl;
     private capabilitiesCache?;
-    constructor(config: MuninClientConfig);
+    constructor(config?: MuninClientConfig);
     capabilities(forceRefresh?: boolean): Promise<MuninCapabilities>;
     invoke<TPayload extends Record<string, unknown>, TData = unknown>(projectId: string, action: MuninAction, payload: TPayload, options?: {
         requestId?: string;
         ensureCapability?: boolean;
     }): Promise<MuninResponse<TData>>;
+    /**
+     * Cleans up raw Munin response for LLM context efficiency.
+     * Removes dense vector arrays and formats GraphRAG objects into readable structures.
+     */
+    private formatLlmResponse;
+    private formatGraph;
     store(projectId: string, payload: Record<string, unknown>): Promise<MuninResponse<unknown>>;
     retrieve(projectId: string, payload: Record<string, unknown>): Promise<MuninResponse<unknown>>;
     search(projectId: string, payload: Record<string, unknown>): Promise<MuninResponse<unknown>>;

package/dist/client.js

@@ -8,10 +8,10 @@ export class MuninClient {
     fetchImpl;
     capabilitiesCache;
     constructor(config) {
-        this.baseUrl = config.baseUrl.replace(/\/$/, "");
-        this.apiKey = config.apiKey;
-        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-        this.fetchImpl = config.fetchImpl ?? fetch;
+        this.baseUrl = (config?.baseUrl || "https://munin.kalera.dev").replace(/\/$/, "");
+        this.apiKey = config?.apiKey;
+        this.timeoutMs = config?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetchImpl = config?.fetchImpl ?? fetch;
     }
     async capabilities(forceRefresh = false) {
         if (this.capabilitiesCache && !forceRefresh) {
@@ -67,7 +67,56 @@ export class MuninClient {
                 message: `Unexpected failure invoking action '${action}'`,
             });
         }
-        return body;
+        return this.formatLlmResponse(body);
+    }
+    /**
+     * Cleans up raw Munin response for LLM context efficiency.
+     * Removes dense vector arrays and formats GraphRAG objects into readable structures.
+     */
+    formatLlmResponse(rawRes) {
+        if (!rawRes || !rawRes.data)
+            return rawRes;
+        const data = rawRes.data;
+        // Clean single memory retrieve
+        if (data.key && data.content) {
+            if (data.embedding)
+                delete data.embedding;
+            if (data.knowledge_graph) {
+                data.knowledge_graph = this.formatGraph(data.knowledge_graph);
+            }
+        }
+        // Clean search/list/recent results
+        if (Array.isArray(data.results)) {
+            data.results = data.results.map((mem) => {
+                if (mem.embedding)
+                    delete mem.embedding;
+                return mem;
+            });
+        }
+        // Clean graph in search
+        if (data.knowledge_graph) {
+            data.knowledge_graph = this.formatGraph(data.knowledge_graph);
+        }
+        return rawRes;
+    }
+    formatGraph(kg) {
+        if (!kg)
+            return kg;
+        const entities = (kg.entities || []).map((e) => {
+            if (e.embedding)
+                delete e.embedding;
+            return `${e.name} (${e.type}): ${e.description}`;
+        });
+        const relationships = (kg.relationships || []).map((r) => {
+            if (r.embedding)
+                delete r.embedding;
+            return `${r.source} -[${r.relation}]-> ${r.target}`;
+        });
+        return {
+            summary: "GraphRAG knowledge formatted for readability",
+            entities,
+            relationships
+        };
     }
     async store(projectId, payload) {
         return this.invoke(projectId, "store", payload, { ensureCapability: true });

package/dist/types.d.ts

@@ -37,7 +37,7 @@ export interface MuninResponse<TData = unknown> {
     requestId?: string;
 }
 export interface MuninClientConfig {
-    baseUrl: string;
+    baseUrl?: string;
     apiKey?: string;
     timeoutMs?: number;
     fetchImpl?: typeof fetch;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kalera/munin-sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/client.ts

@@ -20,11 +20,11 @@ export class MuninClient {
   private readonly fetchImpl: typeof fetch;
   private capabilitiesCache?: MuninCapabilities;
 
-  constructor(config: MuninClientConfig) {
-    this.baseUrl = config.baseUrl.replace(/\/$/, "");
-    this.apiKey = config.apiKey;
-    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    this.fetchImpl = config.fetchImpl ?? fetch;
+  constructor(config?: MuninClientConfig) {
+    this.baseUrl = (config?.baseUrl || "https://munin.kalera.dev").replace(/\/$/, "");
+    this.apiKey = config?.apiKey;
+    this.timeoutMs = config?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.fetchImpl = config?.fetchImpl ?? fetch;
   }
 
   async capabilities(forceRefresh = false): Promise<MuninCapabilities> {
@@ -104,7 +104,60 @@ export class MuninClient {
       );
     }
 
-    return body;
+    return this.formatLlmResponse(body);
+  }
+
+  /**
+   * Cleans up raw Munin response for LLM context efficiency.
+   * Removes dense vector arrays and formats GraphRAG objects into readable structures.
+   */
+  private formatLlmResponse(rawRes: any): any {
+    if (!rawRes || !rawRes.data) return rawRes;
+
+    const data = rawRes.data;
+
+    // Clean single memory retrieve
+    if (data.key && data.content) {
+      if (data.embedding) delete data.embedding;
+      if (data.knowledge_graph) {
+        data.knowledge_graph = this.formatGraph(data.knowledge_graph);
+      }
+    }
+
+    // Clean search/list/recent results
+    if (Array.isArray(data.results)) {
+      data.results = data.results.map((mem: any) => {
+        if (mem.embedding) delete mem.embedding;
+        return mem;
+      });
+    }
+
+    // Clean graph in search
+    if (data.knowledge_graph) {
+      data.knowledge_graph = this.formatGraph(data.knowledge_graph);
+    }
+
+    return rawRes;
+  }
+
+  private formatGraph(kg: any): any {
+    if (!kg) return kg;
+    
+    const entities = (kg.entities || []).map((e: any) => {
+      if (e.embedding) delete e.embedding;
+      return `${e.name} (${e.type}): ${e.description}`;
+    });
+
+    const relationships = (kg.relationships || []).map((r: any) => {
+      if (r.embedding) delete r.embedding;
+      return `${r.source} -[${r.relation}]-> ${r.target}`;
+    });
+
+    return {
+      summary: "GraphRAG knowledge formatted for readability",
+      entities,
+      relationships
+    };
   }
 
   async store(projectId: string, payload: Record<string, unknown>) {

package/src/types.ts

@@ -55,7 +55,7 @@ export interface MuninResponse<TData = unknown> {
 }
 
 export interface MuninClientConfig {
-  baseUrl: string;
+  baseUrl?: string;
   apiKey?: string;
   timeoutMs?: number;
   fetchImpl?: typeof fetch;