@mojoaar/opencode-mimir 0.20.0 → 0.22.0

package/dist/index.js

@@ -12,7 +12,8 @@ export const NUDGE_HEADER = '## Memory check (Mimir)\n\n';
  */
 const NUDGE_EVERY = 20;
 const NUDGE = 'If this session settled a decision, a convention or a gotcha that is not in Mimir yet, ' +
-    'call memory_write now at one clear path, before the detail is compacted away.';
+    'call memory_write now at one clear path, or hand the conversation over with mimir_learn, ' +
+    'before the detail is compacted away.';
 /**
  * One injection point and two tools. The hook is what puts the project's
  * digest in front of the model before the first turn, so a session starts

package/dist/tools.js

@@ -12,6 +12,8 @@ export async function registerTools(ctx, config, repo) {
     return ctx.tool.transform((editor) => {
         editor.add(digestTool(repo));
         editor.add(rememberTool(repo));
+        editor.add(searchTool(repo));
+        editor.add(learnTool(repo));
     });
 }
 const IDLE = { dispose: async () => { } };
@@ -70,7 +72,10 @@ function rememberTool(repo) {
             properties: {
                 path: { type: 'string', description: 'Slash-separated memory path, e.g. deploy/rollback' },
                 body: { type: 'string', description: 'What to remember, written so it reads without the conversation' },
-                kind: { type: 'string', enum: ['note', 'fact', 'decision', 'gotcha', 'snippet'] },
+                kind: {
+                    type: 'string',
+                    enum: ['note', 'fact', 'decision', 'gotcha', 'procedure', 'snippet', 'import'],
+                },
             },
             required: ['path', 'body'],
             additionalProperties: false,
@@ -84,3 +89,57 @@ function rememberTool(repo) {
         },
     };
 }
+function searchTool(repo) {
+    return {
+        name: 'mimir_search',
+        description: 'Search what this project has already settled in Mimir. Returns paths, titles and summaries; read a path with the MCP server if you need the body.',
+        input: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'What to look for, in plain words' },
+                path_prefix: { type: 'string', description: 'Scope to a directory, e.g. auth' },
+            },
+            required: ['query'],
+            additionalProperties: false,
+        },
+        async execute(input) {
+            const result = await callTool('memory_search', { query: input?.query, path_prefix: input?.path_prefix, repo: repo ?? undefined }, { timeoutMs: 8000 });
+            if (!result.ok)
+                return { content: `Mimir is unavailable (${result.error}). Carry on without it.` };
+            const hits = result.result;
+            if (!Array.isArray(hits) || hits.length === 0)
+                return { content: 'Nothing matches that in Mimir.' };
+            return {
+                content: hits
+                    .map((hit) => `${hit.path}\n${hit.summary ?? hit.title}`)
+                    .join('\n\n'),
+            };
+        },
+    };
+}
+function learnTool(repo) {
+    return {
+        name: 'mimir_learn',
+        description: 'Hand the part of this conversation worth keeping to Mimir. The project model writes at most three memories, in the background, so this answers at once.',
+        input: {
+            type: 'object',
+            properties: {
+                transcript: { type: 'string', description: 'The conversation excerpt, verbatim. Up to 32 KB.' },
+                hint: { type: 'string', description: 'What to look for, e.g. "the deploy rollback"' },
+            },
+            required: ['transcript'],
+            additionalProperties: false,
+        },
+        async execute(input) {
+            const result = await callTool('memory_learn', { transcript: input?.transcript, hint: input?.hint, repo: repo ?? undefined }, { timeoutMs: 8000 });
+            if (!result.ok)
+                return { content: `Could not hand that over (${result.error}).` };
+            const queued = result.result;
+            return {
+                content: queued.queued
+                    ? 'Queued. The model writes the memories in the background.'
+                    : 'Mimir took no job: its queue is not running.',
+            };
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojoaar/opencode-mimir",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Mimir long-term memory for OpenCode sessions",
   "type": "module",
   "main": "src/index.ts",

package/src/index.ts

@@ -15,7 +15,8 @@ export const NUDGE_HEADER = '## Memory check (Mimir)\n\n'
 const NUDGE_EVERY = 20
 const NUDGE =
   'If this session settled a decision, a convention or a gotcha that is not in Mimir yet, ' +
-  'call memory_write now at one clear path, before the detail is compacted away.'
+  'call memory_write now at one clear path, or hand the conversation over with mimir_learn, ' +
+  'before the detail is compacted away.'
 
 /**
  * One injection point and two tools. The hook is what puts the project's

package/src/tools.ts

@@ -36,6 +36,8 @@ export async function registerTools(
   return ctx.tool.transform((editor) => {
     editor.add(digestTool(repo))
     editor.add(rememberTool(repo))
+    editor.add(searchTool(repo))
+    editor.add(learnTool(repo))
   })
 }
 
@@ -104,7 +106,10 @@ function rememberTool(repo: string | null): ToolDefinition {
       properties: {
         path: { type: 'string', description: 'Slash-separated memory path, e.g. deploy/rollback' },
         body: { type: 'string', description: 'What to remember, written so it reads without the conversation' },
-        kind: { type: 'string', enum: ['note', 'fact', 'decision', 'gotcha', 'snippet'] },
+        kind: {
+          type: 'string',
+          enum: ['note', 'fact', 'decision', 'gotcha', 'procedure', 'snippet', 'import'],
+        },
       },
       required: ['path', 'body'],
       additionalProperties: false,
@@ -121,3 +126,66 @@ function rememberTool(repo: string | null): ToolDefinition {
     },
   }
 }
+
+function searchTool(repo: string | null): ToolDefinition {
+  return {
+    name: 'mimir_search',
+    description:
+      'Search what this project has already settled in Mimir. Returns paths, titles and summaries; read a path with the MCP server if you need the body.',
+    input: {
+      type: 'object',
+      properties: {
+        query: { type: 'string', description: 'What to look for, in plain words' },
+        path_prefix: { type: 'string', description: 'Scope to a directory, e.g. auth' },
+      },
+      required: ['query'],
+      additionalProperties: false,
+    },
+    async execute(input) {
+      const result = await callTool(
+        'memory_search',
+        { query: input?.query, path_prefix: input?.path_prefix, repo: repo ?? undefined },
+        { timeoutMs: 8000 },
+      )
+      if (!result.ok) return { content: `Mimir is unavailable (${result.error}). Carry on without it.` }
+      const hits = result.result as { path: string; title: string; summary: string | null }[]
+      if (!Array.isArray(hits) || hits.length === 0) return { content: 'Nothing matches that in Mimir.' }
+      return {
+        content: hits
+          .map((hit) => `${hit.path}\n${hit.summary ?? hit.title}`)
+          .join('\n\n'),
+      }
+    },
+  }
+}
+
+function learnTool(repo: string | null): ToolDefinition {
+  return {
+    name: 'mimir_learn',
+    description:
+      'Hand the part of this conversation worth keeping to Mimir. The project model writes at most three memories, in the background, so this answers at once.',
+    input: {
+      type: 'object',
+      properties: {
+        transcript: { type: 'string', description: 'The conversation excerpt, verbatim. Up to 32 KB.' },
+        hint: { type: 'string', description: 'What to look for, e.g. "the deploy rollback"' },
+      },
+      required: ['transcript'],
+      additionalProperties: false,
+    },
+    async execute(input) {
+      const result = await callTool(
+        'memory_learn',
+        { transcript: input?.transcript, hint: input?.hint, repo: repo ?? undefined },
+        { timeoutMs: 8000 },
+      )
+      if (!result.ok) return { content: `Could not hand that over (${result.error}).` }
+      const queued = result.result as { queued?: boolean }
+      return {
+        content: queued.queued
+          ? 'Queued. The model writes the memories in the background.'
+          : 'Mimir took no job: its queue is not running.',
+      }
+    },
+  }
+}