@agentmap/opencode 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+## 0.6.0
+
+1. **Error toast notifications** — plugin errors now surface as OpenCode TUI toast notifications instead of being silently swallowed or polluting the terminal UI.
+
+2. **Updated to use agentmap 0.9.0** — benefits from recursive submodule trees, symlink filtering, duplicate file detection, and compressed output.
+
+## 0.5.0
+
+- Update to use agentmap 0.8.0 with submodule support
+- Submodules now appear in the generated codebase map with branch and commit info
+
+## 0.4.0
+
+- Include git diff info in generated map by default
+- Update to use agentmap 0.7.0
+
+## 0.3.0
+
+- Show only exported symbols when truncating files with many definitions
+- Add `<agentmap-instructions>` section with guidance for maintaining file descriptions
+- Safety checks now handled by agentmap library (non-git repos, home directory)
+- Update to use agentmap 0.6.0
+
+## 0.2.0
+
+- Update to use agentmap 0.3.0 with new diff features
+- Improved system prompt description
+
+## 0.1.0
+
+- Initial release
+- OpenCode plugin that injects codebase map into system prompt
+- Uses `experimental.chat.system.transform` hook to inject map wrapped in `<agentmap>` tags

package/README.md

@@ -0,0 +1,19 @@
+# @agentmap/opencode
+
+OpenCode plugin that injects an `agentmap` codebase map into the system prompt at session time.
+
+## Install
+
+```bash
+bun add @agentmap/opencode
+```
+
+## OpenCode config
+
+```json
+{
+  "plugin": ["@agentmap/opencode"]
+}
+```
+
+Restart OpenCode after updating the plugin list.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAKjD,eAAO,MAAM,cAAc,EAAE,MAmD5B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAOjD,eAAO,MAAM,cAAc,EAAE,MAmE5B,CAAA"}

package/dist/index.js

@@ -1,9 +1,25 @@
 // OpenCode plugin that injects codebase map into system prompt.
-import { generateMapYaml } from 'agentmap';
+import { formatLogMessage } from 'agentmap/src/logger';
+import { generateMapYaml } from 'agentmap/src/index';
 const MAX_LINES = 1000;
-export const AgentMapPlugin = async ({ directory }) => {
+export const AgentMapPlugin = async ({ directory, client }) => {
     let cachedYaml;
     let lastSessionID;
+    const logger = {
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: (...args) => {
+            const message = formatLogMessage(args);
+            void client.tui.showToast({
+                body: {
+                    title: 'agentmap',
+                    message,
+                    variant: 'error',
+                },
+            }).catch(() => { });
+        },
+    };
     return {
         'chat.message': async ({ sessionID }) => {
             if (sessionID !== lastSessionID) {
@@ -17,7 +33,7 @@ export const AgentMapPlugin = async ({ directory }) => {
                 if (output.system.some((s) => s.includes('<agentmap>')))
                     return;
                 if (!cachedYaml) {
-                    let yaml = await generateMapYaml({ dir: directory, diff: true });
+                    let yaml = await generateMapYaml({ dir: directory, diff: true, logger });
                     // Truncate to max lines
                     const lines = yaml.split('\n');
                     if (lines.length > MAX_LINES) {
@@ -44,7 +60,7 @@ These descriptions appear in the agentmap XML at the start of every agent sessio
 </agentmap-instructions>`);
             }
             catch (err) {
-                console.error('[agentmap] Failed to generate map:', err);
+                logger.error('[agentmap] Failed to generate map:', err);
             }
         },
     };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,gEAAgE;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1C,MAAM,SAAS,GAAG,IAAI,CAAA;AAEtB,MAAM,CAAC,MAAM,cAAc,GAAW,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;IAC5D,IAAI,UAA8B,CAAA;IAClC,IAAI,aAAiC,CAAA;IAErC,OAAO;QACL,cAAc,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;YACtC,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;gBAChC,aAAa,GAAG,SAAS,CAAA;gBACzB,UAAU,GAAG,SAAS,CAAA;YACxB,CAAC;QACH,CAAC;QAED,oCAAoC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC7D,IAAI,CAAC;gBACH,mCAAmC;gBACnC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;oBAAE,OAAM;gBAE/D,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,IAAI,IAAI,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;oBAEhE,wBAAwB;oBACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;wBAC7B,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAA;oBACnE,CAAC;oBAED,UAAU,GAAG,IAAI,CAAA;gBACnB,CAAC;gBAED,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;oBAAE,OAAM;gBAE9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;EAKzB,UAAU;;;;;;;;;yBASa,CAAC,CAAA;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAA;YAC1D,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,gEAAgE;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD,MAAM,SAAS,GAAG,IAAI,CAAA;AAEtB,MAAM,CAAC,MAAM,cAAc,GAAW,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;IACpE,IAAI,UAA8B,CAAA;IAClC,IAAI,aAAiC,CAAA;IAErC,MAAM,MAAM,GAAW;QACrB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE;YACjB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;YACtC,KAAK,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;gBACxB,IAAI,EAAE;oBACJ,KAAK,EAAE,UAAU;oBACjB,OAAO;oBACP,OAAO,EAAE,OAAO;iBACjB;aACF,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACpB,CAAC;KACF,CAAA;IAED,OAAO;QACL,cAAc,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;YACtC,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;gBAChC,aAAa,GAAG,SAAS,CAAA;gBACzB,UAAU,GAAG,SAAS,CAAA;YACxB,CAAC;QACH,CAAC;QAED,oCAAoC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC7D,IAAI,CAAC;gBACH,mCAAmC;gBACnC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;oBAAE,OAAM;gBAE/D,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,IAAI,IAAI,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;oBAExE,wBAAwB;oBACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;wBAC7B,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAA;oBACnE,CAAC;oBAED,UAAU,GAAG,IAAI,CAAA;gBACnB,CAAC;gBAED,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;oBAAE,OAAM;gBAE9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;EAKzB,UAAU;;;;;;;;;yBASa,CAAC,CAAA;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAA;YACzD,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmap/opencode",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "OpenCode plugin that injects agentmap codebase map into system prompt",
   "type": "module",
   "repository": {
@@ -15,20 +15,32 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
+    "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./src": {
+      "types": "./dist/index.d.ts",
+      "default": "./src/index.ts"
+    },
+    "./src/*": {
+      "types": "./dist/*.d.ts",
+      "default": "./src/*.ts"
     }
   },
   "files": [
-    "dist"
+    "src",
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "agentmap": "0.7.0"
+    "agentmap": "^0.8.0"
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.0.224",

package/src/index.ts

@@ -0,0 +1,78 @@
+
+// OpenCode plugin that injects codebase map into system prompt.
+
+import type { Plugin } from '@opencode-ai/plugin'
+import { formatLogMessage } from 'agentmap/src/logger'
+import type { Logger } from 'agentmap/src/logger'
+import { generateMapYaml } from 'agentmap/src/index'
+
+const MAX_LINES = 1000
+
+export const AgentMapPlugin: Plugin = async ({ directory, client }) => {
+  let cachedYaml: string | undefined
+  let lastSessionID: string | undefined
+
+  const logger: Logger = {
+    debug: () => {},
+    info: () => {},
+    warn: () => {},
+    error: (...args) => {
+      const message = formatLogMessage(args)
+      void client.tui.showToast({
+        body: {
+          title: 'agentmap',
+          message,
+          variant: 'error',
+        },
+      }).catch(() => {})
+    },
+  }
+
+  return {
+    'chat.message': async ({ sessionID }) => {
+      if (sessionID !== lastSessionID) {
+        lastSessionID = sessionID
+        cachedYaml = undefined
+      }
+    },
+
+    'experimental.chat.system.transform': async (_input, output) => {
+      try {
+        // Skip if already has agentmap tag
+        if (output.system.some((s) => s.includes('<agentmap>'))) return
+
+        if (!cachedYaml) {
+          let yaml = await generateMapYaml({ dir: directory, diff: true, logger })
+
+          // Truncate to max lines
+          const lines = yaml.split('\n')
+          if (lines.length > MAX_LINES) {
+            yaml = lines.slice(0, MAX_LINES).join('\n') + '\n# ... truncated'
+          }
+
+          cachedYaml = yaml
+        }
+
+        if (!cachedYaml.trim()) return
+
+        output.system.push(`
+
+<agentmap>
+Tree of the most important files in the repo, showing descriptions and definitions:
+
+${cachedYaml}
+</agentmap>
+
+<agentmap-instructions>
+When creating new files, add a brief description comment at the top explaining the file's purpose. This makes the file discoverable in the agentmap.
+
+When making significant changes to a file's purpose or responsibilities, update its header comment to reflect the changes.
+
+These descriptions appear in the agentmap XML at the start of every agent session.
+</agentmap-instructions>`)
+      } catch (err) {
+        logger.error('[agentmap] Failed to generate map:', err)
+      }
+    },
+  }
+}