yams-blackboard 0.1.1 → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
 # YAMS Blackboard Plugin for OpenCode
 
-A **blackboard architecture** plugin enabling agent-to-agent communication through [YAMS](https://github.com/yams-project/yams) as shared memory.
+A **blackboard architecture** plugin enabling agent-to-agent communication through [YAMS](https://github.com/trvon/yams) as shared memory.
 
 ## Overview
 
@@ -24,7 +24,7 @@ This plugin implements the classic [blackboard pattern](https://en.wikipedia.org
 
 ## Prerequisites
 
-- **YAMS daemon** must be installed and running
+- **[YAMS](https://github.com/trvon/yams)** - must be installed and daemon running
 - **bun** (for local development/building)
 - **OpenCode** v1.1.0+ (for plugin support)
 
@@ -36,7 +36,8 @@ Add to your `opencode.json`:
 
 ```json
 {
-  "plugins": ["yams-blackboard"]
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["yams-blackboard"]
 }
 ```
 
@@ -255,7 +256,7 @@ YAMS must be installed and in your PATH. Check your installation.
 
 ### Plugin not loading
 
-1. Verify `opencode.json` has `"plugins": ["yams-blackboard"]`
+1. Verify `opencode.json` has `"plugin": ["yams-blackboard"]`
 2. Check OpenCode logs for plugin load errors
 3. Try clearing npm cache: `npm cache clean --force`
 

package/index.js

@@ -34,19 +34,17 @@ class YamsBlackboard {
       if (typeof result === "string") {
         return result.trim();
       }
-      if (this.isBufferLike(result)) {
-        return result.toString("utf-8").trim();
-      }
       if (result && typeof result === "object") {
-        const output = result.stdout ?? result.output ?? result.text;
-        if (typeof output === "string") {
-          return output.trim();
+        let raw = result.stdout ?? result.output ?? result.text;
+        if (raw instanceof Uint8Array || Buffer.isBuffer(raw)) {
+          return new TextDecoder().decode(raw).trim();
         }
-        if (this.isBufferLike(output)) {
-          return output.toString("utf-8").trim();
+        if (typeof raw === "string") {
+          return raw.trim();
         }
-        if (typeof output === "function") {
-          return (await output()).trim();
+        if (typeof raw === "function") {
+          const text = await raw();
+          return typeof text === "string" ? text.trim() : String(text).trim();
         }
       }
       return String(result ?? "").trim();
@@ -337,7 +335,7 @@ ${finding.content}
     }
   }
   async getReadyTasks(agentCapabilities) {
-    const pending = await this.queryTasks({ status: "pending", limit: 100 });
+    const pending = await this.queryTasks({ status: "pending", limit: 100, offset: 0 });
     const ready = [];
     for (const task of pending) {
       if (task.depends_on?.length) {
@@ -405,8 +403,8 @@ ${finding.content}
     }
   }
   async getContextSummary(contextId) {
-    const findings = await this.queryFindings({ context_id: contextId, limit: 100 });
-    const tasks = await this.queryTasks({ context_id: contextId, limit: 100 });
+    const findings = await this.queryFindings({ context_id: contextId, limit: 100, offset: 0 });
+    const tasks = await this.queryTasks({ context_id: contextId, limit: 100, offset: 0 });
     const agents = await this.listAgents();
     const activeAgents = agents.filter((a) => a.status === "active");
     const highSeverity = findings.filter((f) => f.severity === "high" || f.severity === "critical");
@@ -450,8 +448,8 @@ ${blockedTasks.length ? `- ${blockedTasks.length} tasks blocked` : ""}
   }
   async getStats() {
     const agents = await this.listAgents();
-    const findings = await this.queryFindings({ limit: 1000 });
-    const tasks = await this.queryTasks({ limit: 1000 });
+    const findings = await this.queryFindings({ limit: 1000, offset: 0 });
+    const tasks = await this.queryTasks({ limit: 1000, offset: 0 });
     const findingsByTopic = {};
     const findingsByStatus = {};
     const findingsBySeverity = {};
@@ -533,7 +531,7 @@ var FindingSchema = z.object({
   resolution: z.string().optional().describe("How it was resolved"),
   scope: FindingScope.default("persistent"),
   ttl: z.number().int().positive().optional().describe("TTL in seconds for session-scoped"),
-  metadata: z.record(z.string()).optional()
+  metadata: z.record(z.string(), z.string()).optional()
 });
 var CreateFindingSchema = FindingSchema.omit({
   id: true,
@@ -587,7 +585,7 @@ var TaskSchema = z.object({
   error: z.string().optional().describe("Error message if failed"),
   retry_count: z.number().int().nonnegative().optional(),
   max_retries: z.number().int().nonnegative().optional(),
-  metadata: z.record(z.string()).optional()
+  metadata: z.record(z.string(), z.string()).optional()
 });
 var CreateTaskSchema = TaskSchema.omit({
   id: true,
@@ -635,21 +633,18 @@ var TaskQuerySchema = z.object({
 
 // index.ts
 var YamsBlackboardPlugin = async ({ $, project, directory }) => {
-  let blackboard = new YamsBlackboard($, { defaultScope: "persistent" });
+  const blackboard = new YamsBlackboard($, { defaultScope: "persistent" });
   let currentContextId;
   return {
     "session.created": async () => {
-      const sessionName = await blackboard.startSession();
-      console.log(`[yams-blackboard] Session started: ${sessionName}`);
+      await blackboard.startSession();
     },
     "session.compacted": async (input, output) => {
       try {
         const contextId = currentContextId || "default";
         const summary = await blackboard.getContextSummary(contextId);
         output.context.push(summary);
-      } catch (e) {
-        console.error("[yams-blackboard] Failed to generate compaction summary:", e);
-      }
+      } catch {}
     },
     tool: {
       bb_register_agent: tool({
@@ -705,7 +700,7 @@ Registered at: ${agent.registered_at}`;
           context_id: z2.string().optional().describe("Group with related findings"),
           parent_id: z2.string().optional().describe("Reply to another finding"),
           scope: FindingScope.optional().describe("Persistence: 'persistent' (default) or 'session'"),
-          metadata: z2.record(z2.string()).optional().describe("Additional key-value metadata")
+          metadata: z2.record(z2.string(), z2.string()).optional().describe("Additional key-value metadata")
         },
         async execute(args) {
           const finding = await blackboard.postFinding({
@@ -1016,8 +1011,8 @@ ${args.set_current !== false ? "(Set as current context)" : ""}`;
         },
         async execute(args) {
           const limit = args.limit || 10;
-          const findings = await blackboard.queryFindings({ limit });
-          const tasks = await blackboard.queryTasks({ limit });
+          const findings = await blackboard.queryFindings({ limit, offset: 0 });
+          const tasks = await blackboard.queryTasks({ limit, offset: 0 });
           const output = [`## Recent Activity
 `];
           if (findings.length > 0) {

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "yams-blackboard",
-  "version": "0.1.1",
+  "version": "1.0.1",
   "description": "YAMS Blackboard plugin for OpenCode - agent-to-agent communication via shared memory",
   "main": "index.js",
   "types": "index.d.ts",
   "type": "module",
   "scripts": {
     "build": "bun build index.ts --outdir . --target node --external zod --external @opencode-ai/plugin",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "bun test __tests__/plugin.test.ts __tests__/blackboard.test.ts",
+    "test:integration": "YAMS_INTEGRATION=1 bun test __tests__/integration.test.ts",
+    "test:all": "bun test"
   },
   "files": [
     "index.js",
@@ -16,9 +19,10 @@
   ],
   "dependencies": {
     "@opencode-ai/plugin": "^1.1.0",
-    "zod": "^3.23.0"
+    "zod": "^4.1.8"
   },
   "devDependencies": {
+    "bun-types": "^1.1.0",
     "typescript": "^5.0.0"
   },
   "keywords": [