@hiai-gg/hiai-opencode 0.1.4 → 0.1.6

package/dist/mcp/types.d.ts

@@ -3,10 +3,10 @@ export declare const McpNameSchema: z.ZodEnum<{
     websearch: "websearch";
     stitch: "stitch";
     firecrawl: "firecrawl";
+    context7: "context7";
     playwright: "playwright";
     "sequential-thinking": "sequential-thinking";
     rag: "rag";
-    context7: "context7";
     mempalace: "mempalace";
     grep_app: "grep_app";
 }>;

package/dist/plugin/tool-registry.d.ts

@@ -1,5 +1,6 @@
 import type { AvailableCategory } from "../agents/dynamic-agent-prompt-builder";
 import type { HiaiOpenCodeConfig } from "../config";
+import type { McpServerConfig } from "../config/types";
 import type { PluginContext, ToolsRecord } from "./types";
 import { builtinTools, createBackgroundTools, createCallOmoAgent, createLookAt, createSkillMcpTool, createSkillTool, createGrepTools, createGlobTools, createAstGrepTools, createSessionManagerTools, createDelegateTask, discoverCommandsSync, interactive_bash, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, createHashlineEditTool } from "../tools";
 import type { Managers } from "../create-managers";
@@ -35,6 +36,7 @@ export declare function createToolRegistry(args: {
     managers: Pick<Managers, "backgroundManager" | "tmuxSessionManager" | "skillMcpManager">;
     skillContext: SkillContext;
     availableCategories: AvailableCategory[];
+    builtinMcp?: Record<string, McpServerConfig>;
     interactiveBashEnabled?: boolean;
     toolFactories?: Partial<ToolRegistryFactories>;
 }): ToolRegistryResult;

package/dist/shared/mcp-static-export.d.ts

@@ -0,0 +1,22 @@
+import type { HiaiOpencodeConfig } from "../config/types";
+type StaticMcpServer = {
+    type?: "http" | "stdio";
+    url?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+};
+export declare const MCP_EXPORT_MARKER = "hiai-opencode";
+type StaticMcpJsonPayload = {
+    mcpServers: Record<string, StaticMcpServer>;
+    _meta?: {
+        generatedBy: typeof MCP_EXPORT_MARKER;
+        version: 1;
+        generatedAt: string;
+    };
+};
+export declare function buildStaticMcpJson(config: HiaiOpencodeConfig): StaticMcpJsonPayload;
+export declare function isManagedStaticMcpFile(path: string): boolean;
+export declare function autoExportStaticMcpJson(directory: string, config: HiaiOpencodeConfig): void;
+export {};

package/dist/tools/ast-grep/constants.d.ts

@@ -1,5 +1,5 @@
 export type { EnvironmentCheckResult } from "./environment-check";
 export { checkEnvironment, formatEnvironmentCheck } from "./environment-check";
-export { CLI_LANGUAGES, NAPI_LANGUAGES, LANG_EXTENSIONS } from "./language-support";
+export { CLI_LANGUAGES, LANG_EXTENSIONS } from "./language-support";
 export { DEFAULT_TIMEOUT_MS, DEFAULT_MAX_OUTPUT_BYTES, DEFAULT_MAX_MATCHES } from "./language-support";
 export { findSgCliPathSync, getSgCliPath, setSgCliPath } from "./sg-cli-path";

package/dist/tools/ast-grep/environment-check.d.ts

@@ -4,13 +4,9 @@ export interface EnvironmentCheckResult {
         path: string;
         error?: string;
     };
-    napi: {
-        available: boolean;
-        error?: string;
-    };
 }
 /**
- * Check if ast-grep CLI and NAPI are available.
+ * Check if ast-grep CLI is available.
  * Call this at startup to provide early feedback about missing dependencies.
  */
 export declare function checkEnvironment(): EnvironmentCheckResult;

package/dist/tools/ast-grep/language-support.d.ts

@@ -1,5 +1,4 @@
 export declare const CLI_LANGUAGES: readonly ["bash", "c", "cpp", "csharp", "css", "elixir", "go", "haskell", "html", "java", "javascript", "json", "kotlin", "lua", "nix", "php", "python", "ruby", "rust", "scala", "solidity", "swift", "typescript", "tsx", "yaml"];
-export declare const NAPI_LANGUAGES: readonly ["html", "javascript", "tsx", "css", "typescript"];
 export declare const DEFAULT_TIMEOUT_MS = 300000;
 export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
 export declare const DEFAULT_MAX_MATCHES = 500;

package/dist/tools/ast-grep/types.d.ts

@@ -1,6 +1,5 @@
-import type { CLI_LANGUAGES, NAPI_LANGUAGES } from "./constants";
+import type { CLI_LANGUAGES } from "./constants";
 export type CliLanguage = (typeof CLI_LANGUAGES)[number];
-export type NapiLanguage = (typeof NAPI_LANGUAGES)[number];
 export interface Position {
     line: number;
     column: number;

package/dist/tools/skill-mcp/tools.d.ts

@@ -1,10 +1,12 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { McpServerConfig } from "../../config/types";
 import type { SkillMcpManager } from "../../features/skill-mcp-manager";
 import type { LoadedSkill } from "../../features/opencode-skill-loader/types";
 interface SkillMcpToolOptions {
     manager: SkillMcpManager;
     getLoadedSkills: () => LoadedSkill[];
     getSessionID?: () => string | undefined;
+    builtinMcp?: Record<string, McpServerConfig>;
 }
 export declare function applyGrepFilter(output: string, pattern: string | undefined): string;
 export declare function createSkillMcpTool(options: SkillMcpToolOptions): ToolDefinition;

package/hiai-opencode.json

@@ -1,170 +1,71 @@
 {
-  "_description": "Canonical hiai-opencode runtime config. Copy this file to .opencode/hiai-opencode.json and edit it there. This file is the user-facing source of truth for agent models, category models, MCP switches, LSP defaults, skill discovery, service auth placeholders, and local helper defaults. Model provider credentials are configured in OpenCode Connect; this file stores model IDs only.",
+  "_description": "hiai-opencode user config. Edit only this file in your project as .opencode/hiai-opencode.json. Model provider credentials are configured in OpenCode Connect; this file stores model IDs only.",
   "$schema": "./config/hiai-opencode.schema.json",
-  "agents": {
+  "models": {
     "bob": {
-      "model": "openrouter/anthropic/claude-3.5-opus",
-      "description": "Primary orchestrator for end-to-end task execution, delegation, and high-level workflow control."
+      "model": "openrouter/moonshotai/kimi-k2.6",
+      "recommended": "xhigh"
     },
     "coder": {
-      "model": "openrouter/anthropic/claude-3.5-sonnet",
-      "description": "High-depth executor for multi-file implementation, substantial refactors, and technical delivery."
+      "model": "openrouter/minimax/minimax-m2.7",
+      "recommended": "high"
     },
     "strategist": {
-      "model": "openrouter/z-ai/glm-5.1",
-      "description": "Planning and architecture agent for decomposition, sequencing, and decision framing before execution."
+      "model": "openrouter/anthropic/claude-opus-latest",
+      "recommended": "high"
     },
     "guard": {
-      "model": "openrouter/openai/gpt-4o",
-      "description": "Execution supervisor that routes work, enforces discipline, and keeps delegated flows on track."
+      "model": "openrouter/qwen/qwen3.6-plus",
+      "recommended": "middle"
     },
     "critic": {
-      "model": "openrouter/qwen/qwen2.5-72b-instruct",
-      "description": "High-accuracy review gate for implementation quality, correctness, and plan validation."
+      "model": "openrouter/xiaomi/mimo-v2.5-pro",
+      "recommended": "high"
     },
     "designer": {
-      "model": "openrouter/google/gemini-3.1-pro",
-      "description": "Creative visual problem-solver for high-touch UI, interaction, and brand-level interface direction."
+      "model": "openrouter/google/gemini-3.1-pro-preview",
+      "recommended": "design"
     },
     "researcher": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Codebase exploration and external documentation research."
+      "model": "openrouter/deepseek/deepseek-v4-flash",
+      "recommended": "fast"
     },
-    "platform-manager": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Manager. Unified platform management agent for session continuity, project initialization, and orchestration."
+    "manager": {
+      "model": "openrouter/qwen/qwen3.5-9b",
+      "recommended": "fast"
     },
     "brainstormer": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Idea exploration agent for divergent thinking, option generation, and concept shaping before execution."
+      "model": "openrouter/mistralai/mistral-small-2603",
+      "recommended": "writing"
     },
-    "multimodal": {
-      "model": "openrouter/google/gemini-3.1-pro",
-      "description": "Vision. Multimodal analysis agent for images, PDFs, diagrams, and other non-text inputs."
-    },
-    "sub": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Hidden compatibility executor. Primary subtask execution is handled by Coder."
-    },
-    "quality-guardian": {
-      "model": "openrouter/anthropic/claude-3.5-sonnet",
-      "description": "Hidden compatibility review agent. Primary review work is handled by Critic."
-    },
-    "agent-skills": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Hidden system agent for skill registry, discovery, and capability orchestration."
+    "vision": {
+      "model": "openrouter/google/gemma-4-26b-a4b-it",
+      "recommended": "vision"
     }
   },
-  "agentRequirements": {},
-  "categories": {
-    "visual-engineering": {
-      "model": "openrouter/google/gemini-2.0-pro-exp-02-05",
-      "variant": "high",
-      "description": "Frontend and UI systems work with design-system discipline. Uses Coder deep execution contour."
-    },
-    "artistry": {
-      "model": "openrouter/google/gemini-2.0-pro-exp-02-05",
-      "variant": "high",
-      "description": "High-effort creative problem solving beyond standard patterns. Uses Coder deep execution contour."
-    },
-    "ultrabrain": {
-      "model": "openrouter/openai/gpt-4o",
-      "variant": "xhigh",
-      "description": "Hard logic and architecture tasks. Uses Coder deep execution contour."
-    },
-    "deep": {
-      "model": "openrouter/openai/o1",
-      "variant": "medium",
-      "description": "Deep autonomous implementation with full context buildup. Uses Coder deep execution contour."
-    },
-    "quick": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Fast bounded execution: single-file fixes, typos, and simple modifications. Uses Coder fast execution contour."
-    },
-    "writing": {
-      "model": "openrouter/kimi/kimi-latest",
-      "description": "Documentation and prose tasks with bounded scope. Uses Coder fast execution contour."
-    },
-    "git": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Git, commit, diff, and repository hygiene tasks."
-    },
-    "unspecified-low": {
-      "model": "openrouter/anthropic/claude-3.5-sonnet",
-      "description": "Unclassifiable moderate tasks with bounded scope. Uses Coder fast execution contour."
-    },
-    "unspecified-high": {
-      "model": "openrouter/anthropic/claude-3.5-opus",
-      "variant": "max",
-      "description": "Unclassifiable substantial tasks across modules. Uses Coder deep execution contour."
-    }
-  },
-  "categoryRequirements": {},
-  "modelFamilies": [],
   "auth": {
-    "googleSearch": "{env:GOOGLE_SEARCH_API_KEY}",
     "stitch": "{env:STITCH_AI_API_KEY}",
     "firecrawl": "{env:FIRECRAWL_API_KEY}",
     "context7": "{env:CONTEXT7_API_KEY}"
   },
-  "ollama": {
-    "enabled": false,
-    "model": "{env:OLLAMA_MODEL:-qwen3.5:4b}",
-    "baseUrl": "{env:OLLAMA_BASE_URL:-http://localhost:11434}",
-    "purpose": "helper"
-  },
-  "fast_apply": {
-    "enabled": false,
-    "ollama_url": "{env:OLLAMA_BASE_URL:-http://localhost:11434}",
-    "model": "{env:OLLAMA_MODEL:-qwen3.5:4b}",
-    "timeout": 30000
-  },
   "mcp": {
-    "playwright": {
-      "enabled": true,
-      "command": ["node", "{pluginRoot}/assets/mcp/playwright.mjs"],
-      "timeout": 600000
-    },
-    "stitch": {
-      "enabled": true,
-      "type": "remote",
-      "url": "https://stitch.googleapis.com/mcp",
-      "headers": { "X-Goog-Api-Key": "{env:STITCH_AI_API_KEY}" },
-      "timeout": 600000
-    },
-    "sequential-thinking": {
-      "enabled": true,
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "@modelcontextprotocol/server-sequential-thinking"],
-      "timeout": 600000
-    },
-    "firecrawl": {
-      "enabled": true,
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "firecrawl-mcp"],
-      "environment": { "FIRECRAWL_API_KEY": "{env:FIRECRAWL_API_KEY}" },
-      "timeout": 600000
-    },
-    "rag": {
-      "enabled": true,
-      "type": "local",
-      "command": ["node", "{pluginRoot}/assets/mcp/rag.mjs"],
-      "environment": {
-        "OPENCODE_RAG_URL": "{env:OPENCODE_RAG_URL:-http://localhost:9002/tools/search}"
-      },
-      "timeout": 600000
-    },
+    "playwright": { "enabled": true },
+    "stitch": { "enabled": true },
+    "sequential-thinking": { "enabled": true },
+    "firecrawl": { "enabled": true },
+    "rag": { "enabled": true },
     "mempalace": {
       "enabled": true,
-      "type": "local",
-      "command": ["node", "{pluginRoot}/assets/mcp/mempalace.mjs", "--palace", "./.opencode/palace"],
-      "timeout": 600000
+      "pythonPath": "{env:MEMPALACE_PYTHON:-./.venv/bin/python}"
     },
-    "context7": {
-      "enabled": true,
-      "type": "remote",
-      "url": "https://mcp.context7.com/mcp",
-      "headers": { "X-API-KEY": "{env:CONTEXT7_API_KEY}" },
-      "timeout": 600000
-    }
+    "context7": { "enabled": true }
+  },
+  "lsp": {
+    "typescript": { "enabled": true },
+    "svelte": { "enabled": true },
+    "eslint": { "enabled": true },
+    "bash": { "enabled": true },
+    "pyright": { "enabled": true }
   },
   "skill_discovery": {
     "config_sources": true,
@@ -175,40 +76,7 @@
     "project_agents": false,
     "global_agents": false
   },
-  "skills": {
-    "enabled": true,
-    "disabled": []
-  },
-  "lsp": {
-    "typescript": {
-      "command": ["typescript-language-server", "--stdio"],
-      "extensions": [".ts", ".tsx", ".mts", ".cts"]
-    },
-    "svelte": {
-      "command": ["svelteserver", "--stdio"],
-      "extensions": [".svelte"]
-    },
-    "eslint": {
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "eslint-lsp", "--stdio"],
-      "extensions": [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".svelte"]
-    },
-    "bash": {
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "bash-language-server", "start"],
-      "extensions": [".sh", ".bash"]
-    },
-    "pyright": {
-      "command": ["pyright-langserver", "--stdio"],
-      "extensions": [".py"]
-    }
-  },
   "subtask2": {
-    "replace_generic": true,
-    "generic_return": null
-  },
-  "permissions": {
-    "read": { "*": "allow", "*.env": "deny", "*.env.*": "deny", "*.env.example": "allow" },
-    "edit": { "*": "allow" },
-    "bash": { "*": "allow" },
-    "deny_paths": ["**/backup/**", "**/secrets.*", "**/.env", "**/.env.*"]
+    "replace_generic": true
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiai-gg/hiai-opencode",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Unified OpenCode plugin — canonical 12-agent model with bundled skills, MCP integrations, LSP, and permissions in one install.",
   "type": "module",
   "main": "dist/index.js",
@@ -50,19 +50,21 @@
     "access": "public"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly",
+    "clean:dist": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "bun run clean:dist && bun build src/index.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly",
     "build:bundle": "bun build src/index.ts --outdir dist --target bun --format esm",
     "build:types": "tsc --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "pack:check": "npm pack --dry-run",
     "prepare": "bun run build",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run typecheck && bun run test && bun run build && bun run pack:check"
   },
   "dependencies": {
     "bun-pty": "^0.4.8",
     "@opencode-ai/plugin": "^1.4.0",
     "@opencode-ai/sdk": "^1.4.0",
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "@ast-grep/napi": "^0.37.0",
     "zod": "^4.3.0",
     "jsonc-parser": "^3.3.1",
     "js-yaml": "^4.1.0",

package/src/agents/bob/default.ts

@@ -36,7 +36,12 @@ export function buildDefaultBobPrompt(
   useTaskSystem = false,
 ): string {
   const keyTriggers = buildKeyTriggersSection(availableAgents, availableSkills)
-  const toolSelection = buildToolSelectionTable(availableAgents, availableTools, availableSkills)
+  const toolSelection = buildToolSelectionTable(
+    availableAgents,
+    availableTools,
+    availableSkills,
+    { includeIntegrationPrimer: true },
+  )
   const researcherSection = buildResearcherSection(availableAgents)
   const categorySkillsGuide = buildCategorySkillsDelegationGuide(availableCategories, availableSkills)
   const delegationTable = buildDelegationTable(availableAgents)

package/src/agents/bob/gpt-pro.ts

@@ -88,6 +88,7 @@ export function buildGptProBobPrompt(
     availableAgents,
     availableTools,
     availableSkills,
+    { includeIntegrationPrimer: true },
   );
   const researcherSection = buildResearcherSection(availableAgents);
   const categorySkillsGuide = buildCategorySkillsDelegationGuide(

package/src/agents/bob.ts

@@ -54,6 +54,7 @@ function buildDynamicBobPrompt(
     availableAgents,
     availableTools,
     availableSkills,
+    { includeIntegrationPrimer: true },
   );
   const researcherSection = buildResearcherSection(availableAgents);
   const categorySkillsGuide = buildCategorySkillsDelegationGuide(

package/src/agents/coder/gpt-codex.ts

@@ -56,6 +56,7 @@ export function buildCoderPrompt(
     availableAgents,
     availableTools,
     availableSkills,
+    { includeIntegrationPrimer: true },
   );
   const researcherSection = buildResearcherSection(availableAgents);
   const categorySkillsGuide = buildCategorySkillsDelegationGuide(

package/src/agents/coder/gpt-pro.ts

@@ -51,6 +51,7 @@ export function buildCoderPrompt(
     availableAgents,
     availableTools,
     availableSkills,
+    { includeIntegrationPrimer: true },
   );
   const researcherSection = buildResearcherSection(availableAgents);
   const categorySkillsGuide = buildCategorySkillsDelegationGuide(

package/src/agents/coder/gpt.ts

@@ -32,6 +32,7 @@ export function buildCoderPrompt(
     availableAgents,
     availableTools,
     availableSkills,
+    { includeIntegrationPrimer: true },
   );
   const researcherSection = buildResearcherSection(availableAgents);
   const categorySkillsGuide = buildCategorySkillsDelegationGuide(

package/src/agents/dynamic-agent-core-sections.ts

@@ -45,6 +45,7 @@ export function buildToolSelectionTable(
   agents: AvailableAgent[],
   tools: AvailableTool[] = [],
   _skills: AvailableSkill[] = [],
+  options: { includeIntegrationPrimer?: boolean } = {},
 ): string {
   const rows: string[] = ["### Tool & Agent Selection:", ""]
 
@@ -72,10 +73,45 @@ export function buildToolSelectionTable(
   rows.push(
     "**Default flow**: researcher (background) + tools → strategist (if required) → critic (high-risk gate)",
   )
+  if (options.includeIntegrationPrimer) {
+    rows.push("")
+    rows.push(buildHiaiIntegrationPrimerSection())
+  }
 
   return rows.join("\n")
 }
 
+export function buildHiaiIntegrationPrimerSection(): string {
+  return `<hiai-opencode-integration-primer>
+## hiai-opencode Architecture And Integration Rules
+
+This workspace may use hiai-opencode, an OpenCode plugin that wires agents, skills, MCP launchers, LSP, diagnostics, and compatibility helpers around external upstream tools.
+
+Core rules:
+- OpenCode plugins are not MCP servers. Keep \`@hiai-gg/hiai-opencode\` and optional \`@tarquinen/opencode-dcp\` in the OpenCode plugin list; never add MCP packages such as \`firecrawl-mcp\`, \`@playwright/mcp\`, or \`@modelcontextprotocol/server-sequential-thinking\` to the plugin list.
+- User-facing config lives in \`hiai-opencode.json\` or \`.opencode/hiai-opencode.json\`: 10 model slots, MCP enable flags, LSP enable flags, service auth placeholders, and skill discovery switches.
+- Model provider credentials are configured through OpenCode Connect. Do not ask for \`OPENROUTER_API_KEY\`, \`OPENAI_API_KEY\`, or \`ANTHROPIC_API_KEY\` for normal model usage.
+- Service keys are separate: \`FIRECRAWL_API_KEY\`, \`STITCH_AI_API_KEY\`, \`CONTEXT7_API_KEY\`, and \`OPENCODE_RAG_URL\` when those services are enabled.
+
+MCP usage:
+- Run \`hiai-opencode doctor\` or \`hiai-opencode mcp-status\` for effective runtime MCP status.
+- \`opencode mcp list\` often reads only static \`.mcp.json\`; plugin runtime MCP may work even when that list is empty.
+- The plugin auto-exports \`.mcp.json\` when missing. Run \`hiai-opencode export-mcp .mcp.json\` to refresh static visibility.
+- \`skill_mcp\` can call skill-embedded MCP and enabled hiai-opencode MCP. If an MCP is "not found", check whether the skill was loaded, whether \`hiai-opencode.json\` enables it, and whether static export is needed.
+
+Memory and retrieval:
+- MemPalace MCP is external. If enabled, use \`mempalace_status\` first, search before answering about remembered people/projects/past decisions, and write diary entries when appropriate. Never invent memories.
+- RAG MCP is external/local. Use it for project knowledge search when \`OPENCODE_RAG_URL\` is configured or the default \`http://localhost:9002/tools/search\` is reachable.
+- Sequential Thinking MCP is for complex planning/revision/branching, not for trivial edits.
+- Firecrawl/Stitch/Context7 are external web/docs/research services; missing service keys should be reported by env var name only.
+
+Installation/debugging:
+- Use \`/doctor\` or \`hiai-opencode doctor\` before changing config.
+- Prefer user-level or project-local installs. Do not use sudo/admin rights unless explicitly requested.
+- If DCP is requested, install it separately with \`opencode plugin @tarquinen/opencode-dcp@latest --global\`.
+</hiai-opencode-integration-primer>`
+}
+
 export function buildResearcherSection(agents: AvailableAgent[]): string {
   const researcherAgent = agents.find((agent) => agent.name === "researcher")
   if (!researcherAgent) {

package/src/agents/dynamic-agent-prompt-builder.ts

@@ -13,6 +13,7 @@ export {
   buildToolSelectionTable,
   buildResearcherSection,
   buildDelegationTable,
+  buildHiaiIntegrationPrimerSection,
   buildStrategistAndCriticSection,
   buildNonClaudePlannerSection,
   buildParallelDelegationSection,