@kalera/munin-gemini 0.1.0 → 1.0.1

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @kalera/munin-gemini@0.1.0 build /home/runner/work/munin-for-agents/munin-for-agents/adapters/gemini
+> @kalera/munin-gemini@1.0.1 build /home/runner/work/munin-for-agents/munin-for-agents/adapters/gemini
 > tsc -p tsconfig.json
 

package/README.md

@@ -11,10 +11,20 @@
 import { createGeminiCliMuninAdapter } from "@kalera/munin-gemini";
 
 const adapter = createGeminiCliMuninAdapter({
-  baseUrl: process.env.MUNIN_BASE_URL!,
   apiKey: process.env.MUNIN_API_KEY,
-  project: process.env.MUNIN_PROJECT ?? "default",
+  project: process.env.MUNIN_PROJECT ?? "default-core",
 });
 
-await adapter.callTool("list", { limit: 10 });
+await adapter.callTool("your-context-core-id", "list", { limit: 10 });
+```
+
+## Setup as Extension
+
+To use this adapter as an extension for Gemini CLI:
+
+1. Create a `gemini-extension.json` (see examples in this repo).
+2. Configure environment variables:
+```bash
+export MUNIN_API_KEY="your-api-key"
+export MUNIN_PROJECT="your-context-core-id"
 ```

package/dist/cli.js

@@ -7,14 +7,16 @@ async function main() {
         const adapter = createGeminiCliMuninAdapter({
             baseUrl: env.baseUrl,
             apiKey: env.apiKey,
-            project: env.project,
             timeoutMs: env.timeoutMs,
         });
         const result = await executeWithRetry(async () => {
             if (action === "capabilities") {
                 return { ok: true, data: await adapter.capabilities() };
             }
-            return adapter.callTool(action, payload);
+            const { projectId, ...p } = payload;
+            if (!projectId)
+                throw new Error("projectId required in payload");
+            return adapter.callTool(projectId, action, p);
         }, env.retries, env.backoffMs);
         console.log(JSON.stringify(result, null, 2));
     }

package/dist/index.d.ts

@@ -1,10 +1,9 @@
 export declare function createGeminiCliMuninAdapter(config: {
-    baseUrl: string;
+    baseUrl?: string;
     apiKey?: string;
-    project: string;
     timeoutMs?: number;
 }): {
-    callTool: (name: string, args: Record<string, unknown>) => Promise<import("@kalera/munin-sdk").MuninResponse<unknown>>;
+    callTool: (projectId: string, name: string, args: Record<string, unknown>) => Promise<import("@kalera/munin-sdk").MuninResponse<unknown>>;
     capabilities: () => Promise<import("@kalera/munin-sdk").MuninCapabilities>;
 };
 export declare const tools: ({
@@ -13,6 +12,10 @@ export declare const tools: ({
     parameters: {
         type: string;
         properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
             key: {
                 type: string;
                 description: string;
@@ -45,6 +48,10 @@ export declare const tools: ({
     parameters: {
         type: string;
         properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
             key: {
                 type: string;
                 description: string;
@@ -65,6 +72,10 @@ export declare const tools: ({
     parameters: {
         type: string;
         properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
             query: {
                 type: string;
                 description: string;
@@ -94,6 +105,10 @@ export declare const tools: ({
     parameters: {
         type: string;
         properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description?: undefined;
@@ -107,7 +122,7 @@ export declare const tools: ({
             tags?: undefined;
             query?: undefined;
         };
-        required?: undefined;
+        required: string[];
     };
     execute: (args: any) => Promise<import("@kalera/munin-sdk").MuninResponse<unknown>>;
 } | {
@@ -116,6 +131,10 @@ export declare const tools: ({
     parameters: {
         type: string;
         properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
             limit: {
                 type: string;
                 description?: undefined;
@@ -127,7 +146,7 @@ export declare const tools: ({
             query?: undefined;
             offset?: undefined;
         };
-        required?: undefined;
+        required: string[];
     };
     execute: (args: any) => Promise<import("@kalera/munin-sdk").MuninResponse<unknown>>;
 })[];

package/dist/index.js

@@ -2,15 +2,14 @@ import { MuninClient } from "@kalera/munin-sdk";
 export function createGeminiCliMuninAdapter(config) {
     const client = new MuninClient(config);
     return {
-        callTool: async (name, args) => client.invoke(name, args, { ensureCapability: true }),
+        callTool: async (projectId, name, args) => client.invoke(projectId, name, args, { ensureCapability: true }),
         capabilities: () => client.capabilities(),
     };
 }
 // Ensure defaults for Gemini CLI if run as an extension
-const baseUrl = process.env.MUNIN_BASE_URL || "http://127.0.0.1:3237";
-const project = process.env.MUNIN_PROJECT || "default";
+const baseUrl = process.env.MUNIN_BASE_URL || "https://munin.kalera.dev";
 const apiKey = process.env.MUNIN_API_KEY;
-const extensionClient = new MuninClient({ baseUrl, project, apiKey });
+const extensionClient = new MuninClient({ baseUrl, apiKey });
 export const tools = [
     {
         name: "munin_store_memory",
@@ -18,6 +17,7 @@ export const tools = [
         parameters: {
             type: "object",
             properties: {
+                projectId: { type: "string", description: "The Munin Project ID (get this from your instructions)" },
                 key: { type: "string", description: "Unique identifier for this memory" },
                 content: { type: "string", description: "The content to remember" },
                 title: { type: "string", description: "Optional title" },
@@ -27,9 +27,14 @@ export const tools = [
                     description: "List of tags, e.g. ['planning', 'frontend']"
                 }
             },
-            required: ["key", "content"],
+            required: ["projectId", "key", "content"],
+        },
+        execute: async (args) => {
+            const { projectId, ...payload } = args;
+            if (!projectId)
+                throw new Error("projectId is required");
+            return await extensionClient.store(projectId, payload);
         },
-        execute: async (args) => await extensionClient.store(args),
     },
     {
         name: "munin_retrieve_memory",
@@ -37,11 +42,17 @@ export const tools = [
         parameters: {
             type: "object",
             properties: {
+                projectId: { type: "string", description: "The Munin Project ID" },
                 key: { type: "string", description: "Unique identifier" },
             },
-            required: ["key"],
+            required: ["projectId", "key"],
+        },
+        execute: async (args) => {
+            const { projectId, ...payload } = args;
+            if (!projectId)
+                throw new Error("projectId is required");
+            return await extensionClient.retrieve(projectId, payload);
         },
-        execute: async (args) => await extensionClient.retrieve(args),
     },
     {
         name: "munin_search_memories",
@@ -49,13 +60,19 @@ export const tools = [
         parameters: {
             type: "object",
             properties: {
+                projectId: { type: "string", description: "The Munin Project ID" },
                 query: { type: "string", description: "Search query" },
                 tags: { type: "array", items: { type: "string" } },
                 limit: { type: "number", description: "Max results (default: 10)" },
             },
-            required: ["query"],
+            required: ["projectId", "query"],
+        },
+        execute: async (args) => {
+            const { projectId, ...payload } = args;
+            if (!projectId)
+                throw new Error("projectId is required");
+            return await extensionClient.search(projectId, payload);
         },
-        execute: async (args) => await extensionClient.search(args),
     },
     {
         name: "munin_list_memories",
@@ -63,11 +80,18 @@ export const tools = [
         parameters: {
             type: "object",
             properties: {
+                projectId: { type: "string", description: "The Munin Project ID" },
                 limit: { type: "number" },
                 offset: { type: "number" },
             },
+            required: ["projectId"]
+        },
+        execute: async (args) => {
+            const { projectId, ...payload } = args;
+            if (!projectId)
+                throw new Error("projectId is required");
+            return await extensionClient.list(projectId, payload);
         },
-        execute: async (args) => await extensionClient.list(args),
     },
     {
         name: "munin_recent_memories",
@@ -75,9 +99,16 @@ export const tools = [
         parameters: {
             type: "object",
             properties: {
+                projectId: { type: "string", description: "The Munin Project ID" },
                 limit: { type: "number" },
             },
+            required: ["projectId"]
+        },
+        execute: async (args) => {
+            const { projectId, ...payload } = args;
+            if (!projectId)
+                throw new Error("projectId is required");
+            return await extensionClient.recent(projectId, payload);
         },
-        execute: async (args) => await extensionClient.recent(args),
     },
 ];

package/gemini-extension.json

@@ -1,9 +1,31 @@
 {
   "name": "kalera-munin",
-  "version": "0.1.0",
-  "description": "Kalera Munin - Long-Term Memory extension for Gemini CLI",
+  "version": "1.0.3",
+  "description": "Kalera Munin - Long-Term Memory with GraphRAG Context Cores for Gemini CLI",
+  "topics": ["memory", "agent", "kalera", "context", "mcp"],
   "main": "dist/index.js",
   "permissions": {
-    "env": ["MUNIN_BASE_URL", "MUNIN_PROJECT", "MUNIN_API_KEY"]
+    "env": [
+      "MUNIN_PROJECT",
+      "MUNIN_API_KEY"
+    ]
+  },
+  "settings": [
+    {
+      "name": "API Key",
+      "description": "Munin API Key for authentication.",
+      "envVar": "MUNIN_API_KEY"
+    },
+    {
+      "name": "Project ID",
+      "description": "Default Context Core (Project) ID for Munin. (Optional)",
+      "envVar": "MUNIN_PROJECT"
+    }
+  ],
+  "mcpServers": {
+    "munin-mcp": {
+      "command": "node",
+      "args": ["${extensionPath}/mcp.js"]
+    }
   }
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@kalera/munin-gemini",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "type": "module",
   "bin": {
     "munin-gemini": "dist/cli.js"
   },
   "dependencies": {
-    "@kalera/munin-sdk": "0.1.0",
-    "@kalera/munin-runtime": "0.1.0"
+    "@kalera/munin-sdk": "1.0.1",
+    "@kalera/munin-runtime": "1.0.1"
   },
   "devDependencies": {
     "typescript": "^5.9.2"

package/src/cli.ts

@@ -17,7 +17,7 @@ async function main() {
     const adapter = createGeminiCliMuninAdapter({
       baseUrl: env.baseUrl,
       apiKey: env.apiKey,
-      project: env.project,
+      
       timeoutMs: env.timeoutMs,
     });
 
@@ -25,7 +25,7 @@ async function main() {
       if (action === "capabilities") {
         return { ok: true, data: await adapter.capabilities() };
       }
-      return adapter.callTool(action, payload);
+      const { projectId, ...p } = payload; if (!projectId) throw new Error("projectId required in payload"); return adapter.callTool(projectId as string, action, p);
     }, env.retries, env.backoffMs);
 
     console.log(JSON.stringify(result, null, 2));

package/src/index.ts

@@ -1,26 +1,24 @@
 import { MuninClient } from "@kalera/munin-sdk";
 
 export function createGeminiCliMuninAdapter(config: {
-  baseUrl: string;
+  baseUrl?: string;
   apiKey?: string;
-  project: string;
   timeoutMs?: number;
 }) {
   const client = new MuninClient(config);
 
   return {
-    callTool: async (name: string, args: Record<string, unknown>) =>
-      client.invoke(name as any, args, { ensureCapability: true }),
+    callTool: async (projectId: string, name: string, args: Record<string, unknown>) =>
+      client.invoke(projectId, name as any, args, { ensureCapability: true }),
     capabilities: () => client.capabilities(),
   };
 }
 
 // Ensure defaults for Gemini CLI if run as an extension
-const baseUrl = process.env.MUNIN_BASE_URL || "http://127.0.0.1:3237";
-const project = process.env.MUNIN_PROJECT || "default";
+const baseUrl = process.env.MUNIN_BASE_URL || "https://munin.kalera.dev";
 const apiKey = process.env.MUNIN_API_KEY;
 
-const extensionClient = new MuninClient({ baseUrl, project, apiKey });
+const extensionClient = new MuninClient({ baseUrl, apiKey });
 
 export const tools = [
   {
@@ -29,6 +27,7 @@ export const tools = [
     parameters: {
       type: "object",
       properties: {
+        projectId: { type: "string", description: "The Munin Project ID (get this from your instructions)" },
         key: { type: "string", description: "Unique identifier for this memory" },
         content: { type: "string", description: "The content to remember" },
         title: { type: "string", description: "Optional title" },
@@ -38,9 +37,13 @@ export const tools = [
           description: "List of tags, e.g. ['planning', 'frontend']"
         }
       },
-      required: ["key", "content"],
+      required: ["projectId", "key", "content"],
+    },
+    execute: async (args: any) => {
+      const { projectId, ...payload } = args;
+      if (!projectId) throw new Error("projectId is required");
+      return await extensionClient.store(projectId, payload);
     },
-    execute: async (args: any) => await extensionClient.store(args),
   },
   {
     name: "munin_retrieve_memory",
@@ -48,11 +51,16 @@ export const tools = [
     parameters: {
       type: "object",
       properties: {
+        projectId: { type: "string", description: "The Munin Project ID" },
         key: { type: "string", description: "Unique identifier" },
       },
-      required: ["key"],
+      required: ["projectId", "key"],
+    },
+    execute: async (args: any) => {
+      const { projectId, ...payload } = args;
+      if (!projectId) throw new Error("projectId is required");
+      return await extensionClient.retrieve(projectId, payload);
     },
-    execute: async (args: any) => await extensionClient.retrieve(args),
   },
   {
     name: "munin_search_memories",
@@ -60,13 +68,18 @@ export const tools = [
     parameters: {
       type: "object",
       properties: {
+        projectId: { type: "string", description: "The Munin Project ID" },
         query: { type: "string", description: "Search query" },
         tags: { type: "array", items: { type: "string" } },
         limit: { type: "number", description: "Max results (default: 10)" },
       },
-      required: ["query"],
+      required: ["projectId", "query"],
+    },
+    execute: async (args: any) => {
+      const { projectId, ...payload } = args;
+      if (!projectId) throw new Error("projectId is required");
+      return await extensionClient.search(projectId, payload);
     },
-    execute: async (args: any) => await extensionClient.search(args),
   },
   {
     name: "munin_list_memories",
@@ -74,11 +87,17 @@ export const tools = [
     parameters: {
       type: "object",
       properties: {
+        projectId: { type: "string", description: "The Munin Project ID" },
         limit: { type: "number" },
         offset: { type: "number" },
       },
+      required: ["projectId"]
+    },
+    execute: async (args: any) => {
+      const { projectId, ...payload } = args;
+      if (!projectId) throw new Error("projectId is required");
+      return await extensionClient.list(projectId, payload);
     },
-    execute: async (args: any) => await extensionClient.list(args),
   },
   {
     name: "munin_recent_memories",
@@ -86,9 +105,15 @@ export const tools = [
     parameters: {
       type: "object",
       properties: {
+        projectId: { type: "string", description: "The Munin Project ID" },
         limit: { type: "number" },
       },
+      required: ["projectId"]
+    },
+    execute: async (args: any) => {
+      const { projectId, ...payload } = args;
+      if (!projectId) throw new Error("projectId is required");
+      return await extensionClient.recent(projectId, payload);
     },
-    execute: async (args: any) => await extensionClient.recent(args),
   },
 ];