opencodekit 0.15.10 → 0.15.12

package/dist/template/.opencode/memory/research/opencode-mcp-bug-report.md

@@ -0,0 +1,126 @@
+# OpenCode MCP Bug Report
+
+## Title
+
+MCP tool calls fail with `TypeError: undefined is not an object (evaluating 'output.output.includes')` despite successful connection
+
+## Environment
+
+- **OpenCode version**: 1.1.36
+- **OS**: macOS (darwin)
+- **Node version**: (run `node --version` to fill in)
+
+## MCP Servers Affected
+
+- `context7` (https://mcp.context7.com/mcp)
+- `gh_grep` (https://mcp.grep.app)
+
+## Description
+
+MCP tool calls from the AI agent fail with a TypeError, even though the MCP servers connect successfully and respond with HTTP 200 OK.
+
+## Steps to Reproduce
+
+1. Configure MCP servers in `opencode.json`:
+
+```json
+{
+  "mcp": {
+    "context7": {
+      "type": "remote",
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
+      }
+    },
+    "gh_grep": {
+      "type": "remote",
+      "url": "https://mcp.grep.app"
+    }
+  }
+}
+```
+
+2. Set the `CONTEXT7_API_KEY` environment variable
+
+3. Verify MCP servers are connected:
+
+```bash
+$ opencode mcp list
+✓ context7 connected - https://mcp.context7.com/mcp
+✓ gh_grep connected - https://mcp.grep.app
+```
+
+4. Debug shows successful connection:
+
+```bash
+$ opencode mcp debug context7
+HTTP response: 200 OK
+Server info: name=Context7, version=2.0.2
+
+$ opencode mcp debug gh_grep
+HTTP response: 200 OK
+```
+
+5. Use the AI agent to call a tool:
+
+```
+context7_resolve-library-id(query="React hooks", libraryName="react")
+```
+
+## Expected Behavior
+
+The tool should return library information from Context7.
+
+## Actual Behavior
+
+```
+TypeError: undefined is not an object (evaluating 'output.output.includes')
+```
+
+## Analysis
+
+The error `output.output.includes` suggests there's code in OpenCode that does something like:
+
+```javascript
+if (output.output.includes(...)) { ... }
+```
+
+When `output` is undefined or doesn't have an `output` property, this crashes.
+
+The bug is in **OpenCode's tool response handler**, not the MCP connection layer, because:
+
+1. `opencode mcp list` shows both servers as "connected"
+2. `opencode mcp debug` shows HTTP 200 OK responses
+3. The error happens only when the AI agent calls the tool
+
+## Workaround
+
+Use alternative tools that don't go through MCP:
+
+- `codesearch` (Exa Code API) - works
+- `websearch` (Exa Web Search) - works
+
+## Related Issues
+
+- #6972 - May be related to Accept header issues
+- #834 - SSE transport issues
+
+## Additional Context
+
+Log entries show benign errors that don't cause the crash:
+
+```
+ERROR service=mcp clientName=context7 error=MCP error -32601: Method not found failed to get prompts
+```
+
+This is expected (prompts method not implemented), but the TypeError happens later in the response processing pipeline.
+
+---
+
+## How to File
+
+1. Go to: https://github.com/anomalyco/opencode/issues/new
+2. Title: `MCP tool calls fail with TypeError: output.output.includes despite successful connection`
+3. Copy the content above
+4. Add labels: `bug`, `mcp`

package/dist/template/.opencode/opencode.json

@@ -10,11 +10,11 @@
     },
     "explore": {
       "description": "Fast codebase search specialist",
-      "model": "opencode/grok-code"
+      "model": "opencode/big-pickle"
     },
     "general": {
       "description": "General-purpose subagent for fast, well-defined tasks; delegates complexity quickly",
-      "model": "opencode/grok-code"
+      "model": "opencode/big-pickle"
     },
     "looker": {
       "description": "Media extraction specialist for images, PDFs, diagrams",
@@ -49,22 +49,53 @@
   "experimental": {},
   "formatter": {
     "biome": {
-      "command": ["npx", "@biomejs/biome", "check", "--write", "$FILE"],
-      "extensions": [".js", ".jsx", ".ts", ".tsx", ".json", ".jsonc"]
+      "command": [
+        "npx",
+        "@biomejs/biome",
+        "check",
+        "--write",
+        "$FILE"
+      ],
+      "extensions": [
+        ".js",
+        ".jsx",
+        ".ts",
+        ".tsx",
+        ".json",
+        ".jsonc"
+      ]
     },
     "cargo-fmt": {
-      "command": ["cargo", "fmt", "--", "$FILE"],
-      "extensions": [".rs"]
+      "command": [
+        "cargo",
+        "fmt",
+        "--",
+        "$FILE"
+      ],
+      "extensions": [
+        ".rs"
+      ]
     },
     "java-formatter": {
-      "command": ["google-java-format", "--replace", "$FILE"],
+      "command": [
+        "google-java-format",
+        "--replace",
+        "$FILE"
+      ],
       "environment": {
         "JAVA_HOME": "{env:JAVA_HOME}"
       },
-      "extensions": [".java"]
+      "extensions": [
+        ".java"
+      ]
     },
     "oxfmt": {
-      "command": ["npx", "oxfmt", "--write", "$FILE"],
+      "command": [
+        "npx",
+        "oxfmt",
+        "--write",
+        "$FILE"
+      ],
       "extensions": [
         ".js",
         ".jsx",
@@ -83,11 +114,22 @@
       ]
     },
     "laravel-pint": {
-      "command": ["npx", "laravel-pint", "--preset", "psr12", "$FILE"],
-      "extensions": [".php"]
+      "command": [
+        "npx",
+        "laravel-pint",
+        "--preset",
+        "psr12",
+        "$FILE"
+      ],
+      "extensions": [
+        ".php"
+      ]
     }
   },
-  "instructions": [".opencode/memory/user.md", ".opencode/memory/project/*.md"],
+  "instructions": [
+    ".opencode/memory/user.md",
+    ".opencode/memory/project/*.md"
+  ],
   "keybinds": {
     "command_list": ";",
     "leader": "`",
@@ -97,18 +139,13 @@
   },
   "mcp": {
     "context7": {
-      "command": [
-        "npx",
-        "-y",
-        "@upstash/context7-mcp",
-        "--api-key",
-        "{env:CONTEXT7_API_KEY}"
-      ],
-      "enabled": true,
-      "type": "local"
+      "type": "remote",
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
+      }
     },
     "gh_grep": {
-      "enabled": true,
       "type": "remote",
       "url": "https://mcp.grep.app"
     },
@@ -301,13 +338,17 @@
               "disabled": true
             },
             "high": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "high",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
             },
             "medium": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "medium",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
@@ -320,13 +361,17 @@
               "disabled": true
             },
             "high": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "high",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
             },
             "medium": {
-              "include": ["reasoning.encrypted_content"],
+              "include": [
+                "reasoning.encrypted_content"
+              ],
               "reasoningEffort": "medium",
               "reasoningSummary": "auto",
               "textVerbosity": "low"
@@ -357,8 +402,14 @@
           },
           "name": "Gemini 2 5 Computer Use Preview 10 2025",
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           }
         },
         "gemini-2.5-flash": {
@@ -368,8 +419,14 @@
           },
           "name": "Gemini 2 5 Flash",
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           }
         },
         "gemini-2.5-flash-lite": {
@@ -379,8 +436,14 @@
           },
           "name": "Gemini 2 5 Flash Lite",
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           }
         },
         "gemini-2.5-pro": {
@@ -390,8 +453,14 @@
           },
           "name": "Gemini 2 5 Pro",
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           }
         },
         "gemini-3-flash-preview": {
@@ -401,8 +470,14 @@
           },
           "name": "Gemini 3 Flash Preview",
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "variants": {
             "low": {
@@ -424,8 +499,14 @@
           },
           "name": "Gemini 3 Pro Image Preview",
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           }
         },
         "gemini-3-pro-preview": {
@@ -435,8 +516,14 @@
           },
           "name": "Gemini 3 Pro Preview",
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "variants": {
             "low": {
@@ -454,8 +541,14 @@
             "output": 64000
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini Claude Opus 4 5 Thinking",
           "variants": {
@@ -478,8 +571,14 @@
             "output": 64000
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini Claude Sonnet 4 5"
         },
@@ -489,8 +588,14 @@
             "output": 64000
           },
           "modalities": {
-            "input": ["text", "image", "pdf"],
-            "output": ["text"]
+            "input": [
+              "text",
+              "image",
+              "pdf"
+            ],
+            "output": [
+              "text"
+            ]
           },
           "name": "Gemini Claude Sonnet 4 5 Thinking",
           "variants": {

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.1.34"
+    "@opencode-ai/plugin": "1.1.39"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",

package/dist/template/.opencode/plans/swarm-protocol.md

@@ -0,0 +1,123 @@
+# Swarm Protocol (Beads-as-Board)
+
+## Goal
+
+Use `.beads/` as the single source of truth for task state + dependencies, while agents coordinate through structured artifacts (not freeform chatter) and verification gates.
+
+## Roles (Strict)
+
+- Lead: Owns scope, prioritization, and all Beads state transitions.
+- Planner: Turns intent into Beads tasks + dependency DAG; no code changes.
+- Worker: Executes exactly one claimed task; posts a structured report.
+- Verifier: Independently validates acceptance checks; blocks close on missing evidence.
+
+## Board = Beads
+
+Canonical state lives in `.beads/issues.jsonl` (tasks) and `.beads/artifacts/<id>/` (task artifacts).
+
+- Create tasks: `bd create "Title" -p <1-3>`
+- See unblocked work: `bd ready`
+- Inspect context: `bd show <id>`
+- Claim work: `bd update <id> --status=in_progress`
+- Close work: `bd close <id> --reason="..."` then `bd sync`
+
+## Task Artifact Contract
+
+Every task MUST have `.beads/artifacts/<id>/spec.md`.
+
+Optional supporting files:
+
+- `.beads/artifacts/<id>/plan.md`: multi-step implementation plan, files touched, and gates
+- `.beads/artifacts/<id>/review.md`: verifier notes + evidence summary
+
+### spec.md (Minimum Template)
+
+- Context: why this exists
+- Scope: in / out
+- Constraints: MUST / MUST NOT (security, deps, dist/, etc.)
+- Acceptance Criteria: checkboxes, each with a verification method
+- Evidence Required: exact commands and expected signals (e.g. "typecheck command passes")
+
+#### Verification Defaults (Language-Agnostic)
+
+Do NOT assume npm/bun/pytest/etc. Prefer this pattern:
+
+- `typecheck`: `<command>`
+- `lint`: `<command>`
+- `test`: `<command>`
+- `build` (optional): `<command>`
+
+If the repository has a canonical list of commands, reference it (e.g. `.opencode/memory/project/commands.md`).
+
+Common stacks (examples only):
+
+| Stack   | typecheck                                  | lint                         | test                     |
+| ------- | ------------------------------------------ | ---------------------------- | ------------------------ |
+| Node/TS | `npm run typecheck` or `bun run typecheck` | `npm run lint`               | `bun test` or `npm test` |
+| Python  | `python -m mypy .`                         | `ruff check .`               | `pytest`                 |
+| Go      | `go test ./...` (compile+test)             | `golangci-lint run`          | `go test ./...`          |
+| Rust    | `cargo check`                              | `cargo fmt --check` (format) | `cargo test`             |
+
+## Delegation Packet (Worker Input)
+
+Every delegated task MUST include the following envelope:
+
+- TASK: `<id> - <title>`
+- EXPECTED OUTCOME: measurable end state
+- REQUIRED TOOLS: e.g. `read`, `grep`, `lsp`, `bash`
+- MUST DO: e.g. LSP-before-edits, run typecheck, run lint
+- MUST NOT DO: e.g. no new deps, no dist/ edits, no git push
+- ACCEPTANCE CHECKS: list of commands + pass criteria
+- CONTEXT: links to `.beads/artifacts/<id>/spec.md` + relevant files
+
+### Helper Tool
+
+If available, use the custom tool `swarm-delegate` to generate (and optionally write) a delegation packet:
+
+```ts
+swarm -
+  delegate({
+    bead_id: "opencodekit-template-xyz",
+    expected_outcome: "<measurable end state>",
+    required_tools: "read, grep, lsp, bash",
+    must_do: "LSP before edits, run project verification commands",
+    must_not_do: "no new deps, don't edit dist/",
+    acceptance_checks: "typecheck: <command>, lint: <command>, test: <command>",
+    context: "See .beads/artifacts/<id>/spec.md",
+    write: true,
+  });
+```
+
+## Worker Report (Worker Output)
+
+Workers MUST respond with a structured report:
+
+- Result: done / blocked / needs replan
+- Changes: file list + what changed (with file references)
+- Verification: commands run + pass/fail summary
+- Risks/Notes: edge cases, follow-ups
+- Confidence: high / medium / low
+
+## Gates (Non-Negotiable)
+
+- Planning gate: `.beads/artifacts/<id>/spec.md` exists with acceptance criteria BEFORE implementation starts
+- Execution gate: worker provides verification evidence BEFORE close
+- Review gate (risk-based): verifier signs off in `review.md` BEFORE close
+
+## Replan Triggers
+
+Immediately stop execution and return to planning if:
+
+- Scope expands to 4+ files unexpectedly
+- Requirement ambiguity changes implementation choice
+- Two-strike tool failures
+- New dependency or `.opencode/` structure change would be needed
+
+## Lead Checklist
+
+1. `bd ready` -> pick task -> `bd show <id>`
+2. Ensure `.beads/artifacts/<id>/spec.md` has acceptance checks
+3. `bd update <id> --status=in_progress`
+4. Delegate with the packet format
+5. Require worker report + evidence
+6. `bd close <id> --reason="..."` + `bd sync`

package/dist/template/.opencode/plugin/README.md

@@ -80,6 +80,16 @@ Session 3: read_session("previous") → Tests (90k) → close
 - High-priority or in-progress TODOs → Inject continuation prompt
 - Low-priority pending TODOs → OS notification only (no forced continuation)
 
+### swarm-enforcer.ts
+
+**Swarm protocol guardrails (Beads-as-board)** - nudges agents to follow the Beads-first workflow.
+
+- Treats `.beads/` as the single source of truth for the swarm task board
+- If user expresses implementation intent and no task is `in_progress`, injects a nudge to use `bd ready/show/update`
+- If there are `in_progress` tasks but `.beads/artifacts/<id>/spec.md` is missing, nudges to create it before implementation
+- On `file.edited`, warns if code is being changed without a claimed task or with missing `spec.md`
+- On `session.idle`, reminds to `bd close` + `bd sync` when work is done
+
 ### notification.ts
 
 **Session completion alerts** - sends native notifications when AI finishes.