micode 0.4.1 → 0.5.1

package/dist/index.js

@@ -16,14 +16,12 @@ var brainstormerAgent = {
   mode: "primary",
   model: "anthropic/claude-opus-4-5",
   temperature: 0.7,
-  tools: { ask: true },
   prompt: `<purpose>
 Turn ideas into fully formed designs through natural collaborative dialogue.
 This is DESIGN ONLY. The planner agent handles detailed implementation plans.
 </purpose>
 
 <critical-rules>
-  <rule>ASK TOOL: Use the ask tool for EVERY question to the user. Never ask in plain text.</rule>
   <rule>NO CODE: Never write code. Never provide code examples. Design only.</rule>
   <rule>SUBAGENTS: Spawn multiple in parallel for codebase analysis.</rule>
   <rule>TOOLS (grep, read, etc.): Do NOT use directly - use subagents instead.</rule>
@@ -54,8 +52,6 @@ This is DESIGN ONLY. The planner agent handles detailed implementation plans.
     - codebase-analyzer: "Analyze existing [related feature]"
     - pattern-finder: "Find patterns for [similar functionality]"
   </spawn-example>
-  <rule>Use the ask tool for EVERY question - never plain text</rule>
-  <rule>Always provide MULTIPLE CHOICE options in the ask tool</rule>
   <focus>purpose, constraints, success criteria</focus>
 </phase>
 
@@ -91,9 +87,7 @@ This is DESIGN ONLY. The planner agent handles detailed implementation plans.
   <principle name="design-only">NO CODE. Describe components, not implementations. Planner writes code.</principle>
   <principle name="subagents-first">ALWAYS use subagents for code analysis, NEVER tools directly</principle>
   <principle name="parallel-spawn">Spawn multiple subagents in a SINGLE message</principle>
-  <principle name="ask-tool-always">ALWAYS use the ask tool for questions - never plain text</principle>
-  <principle name="one-question">Ask ONE question at a time via ask tool. Wait for answer.</principle>
-  <principle name="multiple-choice">Present 3-5 options in ask tool questions</principle>
+  <principle name="one-question">Ask ONE question at a time. Wait for answer.</principle>
   <principle name="yagni">Remove unnecessary features from ALL designs</principle>
   <principle name="explore-alternatives">ALWAYS propose 2-3 approaches before settling</principle>
   <principle name="incremental-validation">Present in sections, validate each before proceeding</principle>
@@ -373,6 +367,12 @@ Your research is IMPLEMENTATION-LEVEL only:
 All research must serve the design - never second-guess design decisions.
 </research-scope>
 
+<library-research description="For external library/framework APIs">
+<tool name="context7">Use context7_resolve-library-id then context7_query-docs for API documentation.</tool>
+<tool name="btca_ask">Use for understanding library internals when docs aren't enough.</tool>
+<rule>Use these directly - no subagent needed for library research.</rule>
+</library-research>
+
 <available-subagents>
   <subagent name="codebase-locator" spawn="parallel">
     Find exact file paths needed for implementation.
@@ -865,10 +865,6 @@ If you want exception to ANY rule, STOP and get explicit permission first.
 Breaking the letter or spirit of the rules is failure.
 </rule>
 
-<rule priority="critical">
-ALWAYS use the ask tool when you need user input. Never ask questions in plain text.
-</rule>
-
 <values>
 <value>Honesty. If you lie, you'll be replaced.</value>
 <value>Do it right, not fast. Never skip steps or take shortcuts.</value>
@@ -884,8 +880,6 @@ ALWAYS use the ask tool when you need user input. Never ask questions in plain t
 <rule>If uncomfortable pushing back, say "Strange things are afoot at the Circle K"</rule>
 <rule>STOP and ask for clarification rather than making assumptions</rule>
 <rule>STOP and ask for help when human input would be valuable</rule>
-<rule>ALWAYS use the ask tool when asking questions - never plain text</rule>
-<rule>Provide multiple-choice options in the ask tool whenever possible</rule>
 </relationship>
 
 <proactiveness>
@@ -952,6 +946,15 @@ Just do it - including obvious follow-up actions.
 </parallelization>
 </agents>
 
+<library-research description="For external library/framework questions">
+<tool name="context7">Documentation lookup. Use context7_resolve-library-id then context7_query-docs.</tool>
+<tool name="btca_ask">Source code search. Use for implementation details, internals, debugging.</tool>
+<when-to-use>
+<use tool="context7">API usage, examples, guides - "How do I use X?"</use>
+<use tool="btca_ask">Implementation details - "How does X work internally?"</use>
+</when-to-use>
+</library-research>
+
 <tracking>
 <rule>Use TodoWrite to track what you're doing</rule>
 <rule>Never discard tasks without explicit approval</rule>
@@ -967,8 +970,7 @@ var primaryAgent = {
     budgetTokens: 32000
   },
   maxTokens: 64000,
-  prompt: PROMPT,
-  tools: { ask: true }
+  prompt: PROMPT
 };
 var PRIMARY_AGENT_NAME = process.env.OPENCODE_AGENT_NAME || "commander";
 
@@ -13838,6 +13840,69 @@ ${output}`;
   }
 });
 
+// src/tools/btca/index.ts
+var {spawn: spawn2, which: which2 } = globalThis.Bun;
+async function checkBtcaAvailable() {
+  const btcaPath = which2("btca");
+  if (btcaPath) {
+    return { available: true };
+  }
+  return {
+    available: false,
+    message: `btca CLI not found. Library source code search will not work.
+` + `Install from: https://github.com/anthropics/btca
+` + "  cargo install btca"
+  };
+}
+var BTCA_TIMEOUT_MS = 120000;
+async function runBtca(args) {
+  try {
+    const proc = spawn2(["btca", ...args], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const timeoutPromise = new Promise((_, reject) => {
+      setTimeout(() => {
+        proc.kill();
+        reject(new Error("btca command timed out after 2 minutes"));
+      }, BTCA_TIMEOUT_MS);
+    });
+    const [stdout, stderr, exitCode] = await Promise.race([
+      Promise.all([new Response(proc.stdout).text(), new Response(proc.stderr).text(), proc.exited]),
+      timeoutPromise
+    ]);
+    if (exitCode !== 0) {
+      const errorMsg = stderr.trim() || `Exit code ${exitCode}`;
+      return { output: "", error: errorMsg };
+    }
+    return { output: stdout.trim() };
+  } catch (e) {
+    const err = e;
+    if (err.message?.includes("ENOENT")) {
+      return {
+        output: "",
+        error: `btca CLI not found. Install from: https://github.com/anthropics/btca
+` + "  cargo install btca"
+      };
+    }
+    return { output: "", error: err.message };
+  }
+}
+var btca_ask = tool({
+  description: "Ask questions about library/framework source code using btca. " + "Clones repos locally and searches source code to answer questions. " + "Use for understanding library internals, finding implementation details, or debugging.",
+  args: {
+    tech: tool.schema.string().describe("Resource name configured in btca (e.g., 'react', 'express')"),
+    question: tool.schema.string().describe("Question to ask about the library source code")
+  },
+  execute: async (args) => {
+    const result = await runBtca(["ask", "-t", args.tech, "-q", args.question]);
+    if (result.error) {
+      return `Error: ${result.error}`;
+    }
+    return result.output || "No answer found";
+  }
+});
+
 // src/tools/look-at.ts
 import { readFileSync, statSync } from "fs";
 import { extname, basename } from "path";
@@ -14862,20 +14927,22 @@ function createTokenAwareTruncationHook(ctx) {
   };
 }
 
-// src/hooks/context-window-monitor.ts
-var WARNING_THRESHOLD = 0.7;
-var CRITICAL_THRESHOLD = 0.85;
-var DEFAULT_CONTEXT_LIMIT2 = 200000;
+// src/utils/model-limits.ts
 var MODEL_CONTEXT_LIMITS = {
   "claude-opus": 200000,
   "claude-sonnet": 200000,
   "claude-haiku": 200000,
+  "claude-3": 200000,
+  "claude-4": 200000,
+  "gpt-4o": 128000,
+  "gpt-4-turbo": 128000,
   "gpt-4": 128000,
   "gpt-5": 200000,
   o1: 200000,
   o3: 200000,
   gemini: 1e6
 };
+var DEFAULT_CONTEXT_LIMIT2 = 200000;
 function getContextLimit(modelID) {
   const modelLower = modelID.toLowerCase();
   for (const [pattern, limit] of Object.entries(MODEL_CONTEXT_LIMITS)) {
@@ -14885,6 +14952,10 @@ function getContextLimit(modelID) {
   }
   return DEFAULT_CONTEXT_LIMIT2;
 }
+
+// src/hooks/context-window-monitor.ts
+var WARNING_THRESHOLD = 0.7;
+var CRITICAL_THRESHOLD = 0.85;
 var WARNING_COOLDOWN_MS = 120000;
 function createContextWindowMonitorHook(ctx) {
   const state = {
@@ -15163,33 +15234,9 @@ function createFileOpsTrackerHook(_ctx) {
 }
 
 // src/hooks/auto-clear-ledger.ts
-var MODEL_CONTEXT_LIMITS2 = {
-  "claude-opus": 200000,
-  "claude-sonnet": 200000,
-  "claude-haiku": 200000,
-  "claude-3": 200000,
-  "claude-4": 200000,
-  "gpt-4o": 128000,
-  "gpt-4-turbo": 128000,
-  "gpt-4": 128000,
-  "gpt-5": 200000,
-  o1: 200000,
-  o3: 200000,
-  gemini: 1e6
-};
-var DEFAULT_CONTEXT_LIMIT3 = 200000;
 var DEFAULT_THRESHOLD = 0.8;
 var MIN_TOKENS_FOR_CLEAR = 50000;
 var CLEAR_COOLDOWN_MS = 60000;
-function getContextLimit2(modelID) {
-  const modelLower = modelID.toLowerCase();
-  for (const [pattern, limit] of Object.entries(MODEL_CONTEXT_LIMITS2)) {
-    if (modelLower.includes(pattern)) {
-      return limit;
-    }
-  }
-  return DEFAULT_CONTEXT_LIMIT3;
-}
 function createAutoClearLedgerHook(ctx) {
   const state = {
     lastClearTime: new Map,
@@ -15224,7 +15271,7 @@ function createAutoClearLedgerHook(ctx) {
       if (totalUsed < MIN_TOKENS_FOR_CLEAR)
         return;
       const model = modelID || info?.modelID || "";
-      const contextLimit = getContextLimit2(model);
+      const contextLimit = getContextLimit(model);
       const usageRatio = totalUsed / contextLimit;
       if (usageRatio < DEFAULT_THRESHOLD)
         return;
@@ -15923,6 +15970,10 @@ var OpenCodeConfigPlugin = async (ctx) => {
   if (!astGrepStatus.available) {
     console.warn(`[micode] ${astGrepStatus.message}`);
   }
+  const btcaStatus = await checkBtcaAvailable();
+  if (!btcaStatus.available) {
+    console.warn(`[micode] ${btcaStatus.message}`);
+  }
   const userConfig = await loadMicodeConfig();
   if (userConfig?.agents) {
     console.log(`[micode] Loaded model overrides for: ${Object.keys(userConfig.agents).join(", ")}`);
@@ -15944,6 +15995,7 @@ var OpenCodeConfigPlugin = async (ctx) => {
     tool: {
       ast_grep_search,
       ast_grep_replace,
+      btca_ask,
       look_at,
       artifact_search,
       ...backgroundTaskTools

package/dist/tools/btca/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check if btca CLI is available on the system.
+ * Returns installation instructions if not found.
+ */
+export declare function checkBtcaAvailable(): Promise<{
+    available: boolean;
+    message?: string;
+}>;
+export declare const btca_ask: {
+    description: string;
+    args: {
+        tech: import("zod").ZodString;
+        question: import("zod").ZodString;
+    };
+    execute(args: {
+        tech: string;
+        question: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};

package/dist/utils/model-limits.d.ts

@@ -0,0 +1,7 @@
+export declare const MODEL_CONTEXT_LIMITS: Record<string, number>;
+export declare const DEFAULT_CONTEXT_LIMIT = 200000;
+/**
+ * Get the context window limit for a given model ID.
+ * Matches against known patterns and falls back to default.
+ */
+export declare function getContextLimit(modelID: string): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micode",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "OpenCode plugin with Brainstorm-Research-Plan-Implement workflow",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",