@hiai-gg/hiai-opencode 0.1.2 → 0.1.3

package/dist/mcp/registry.d.ts

@@ -0,0 +1,14 @@
+import type { McpServerConfig } from "../config/types.js";
+export type HiaiMcpName = "playwright" | "stitch" | "sequential-thinking" | "firecrawl" | "rag" | "context7" | "mempalace";
+export type HiaiMcpInstallKind = "bundled" | "npm" | "python" | "remote" | "user-service";
+export interface HiaiMcpRegistryEntry {
+    name: HiaiMcpName;
+    enabledByDefault: boolean;
+    install: HiaiMcpInstallKind;
+    requiredEnv?: string[];
+    optionalEnv?: string[];
+    config: McpServerConfig;
+}
+export declare const HIAI_MCP_REGISTRY: Record<HiaiMcpName, HiaiMcpRegistryEntry>;
+export declare function createDefaultMcpConfig(): Record<HiaiMcpName, McpServerConfig>;
+export declare function getKnownMcpNames(): HiaiMcpName[];

package/dist/mcp/types.d.ts

@@ -1,7 +1,13 @@
 import { z } from "zod";
 export declare const McpNameSchema: z.ZodEnum<{
     websearch: "websearch";
+    stitch: "stitch";
+    firecrawl: "firecrawl";
+    playwright: "playwright";
+    "sequential-thinking": "sequential-thinking";
+    rag: "rag";
     context7: "context7";
+    mempalace: "mempalace";
     grep_app: "grep_app";
 }>;
 export type McpName = z.infer<typeof McpNameSchema>;

package/hiai-opencode.json

@@ -1,5 +1,5 @@
 {
-  "_description": "hiai-opencode user configuration template. Public display names (shown to users): Bob, Coder, Strategist, Guard, Critic, Designer, Researcher, Manager, Brainstormer, Vision. Config keys (used in this file and in code) are: bob, coder, strategist, guard, critic, designer, researcher, manager, brainstormer, vision. Internal-only keys (hidden from normal users): sub, agent-skills. Source defaults: src/config/defaults.ts and src/config/models.ts.",
+  "_description": "hiai-opencode user configuration template. Public display names (shown to users): Bob, Coder, Strategist, Guard, Critic, Designer, Researcher, Manager, Brainstormer, Vision. Config keys (used in this file and in code) are: bob, coder, strategist, guard, critic, designer, researcher, manager, brainstormer, vision. Internal-only keys (hidden from normal users): sub, agent-skills. MCP enable/disable lives in the mcp object below; default MCP definitions live in src/mcp/registry.ts. Source model defaults: src/config/defaults.ts and src/config/models.ts.",
   "$schema": "./config/hiai-opencode.schema.json",
   "agents": {
     "bob": { "model": "openrouter/anthropic/claude-3.5-opus" },
@@ -55,4 +55,4 @@
   "subtask2": {
     "replace_generic": true
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiai-gg/hiai-opencode",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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",

package/src/config/defaults.ts

@@ -1,25 +1,10 @@
 /**
  * Default config values for hiai-opencode
  */
-import { join } from "node:path";
 import type { HiaiOpencodeConfig } from "./types.js";
 import { MODEL_PRESETS } from "./models.js";
-
-function resolveAssetScript(...segments: string[]): string {
-  return join(import.meta.dirname, "..", "assets", ...segments);
-}
-
-function createNpmPackageCommand(pkg: string, ...args: string[]): string[] {
-  return ["node", resolveAssetScript("runtime", "npm-package-runner.mjs"), pkg, ...args];
-}
-
-function createUpstreamNpxCommand(pkg: string, ...args: string[]): string[] {
-  if (process.platform === "win32") {
-    return ["cmd", "/c", "npx", "-y", pkg, ...args];
-  }
-
-  return ["npx", "-y", pkg, ...args];
-}
+import { createDefaultMcpConfig } from "../mcp/registry.js";
+import { join } from "node:path";
 
 export const defaultConfig: HiaiOpencodeConfig = {
   agents: {
@@ -54,49 +39,7 @@ export const defaultConfig: HiaiOpencodeConfig = {
   },
   categoryRequirements: {},
 
-  mcp: {
-    playwright: {
-      enabled: true,
-      command: createNpmPackageCommand("@playwright/mcp@latest"),
-      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: createUpstreamNpxCommand("@modelcontextprotocol/server-sequential-thinking"),
-      timeout: 600000,
-    },
-    firecrawl: {
-      enabled: true,
-      command: createUpstreamNpxCommand("firecrawl-mcp"),
-      timeout: 600000,
-      environment: { FIRECRAWL_API_KEY: "{env:FIRECRAWL_API_KEY}" },
-    },
-    rag: {
-      enabled: true,
-      type: "remote",
-      url: "http://localhost:9002",
-      timeout: 600000,
-    },
-    context7: {
-      enabled: true,
-      type: "remote",
-      url: "https://mcp.context7.com/mcp",
-      headers: { "X-API-KEY": "{env:CONTEXT7_API_KEY}" },
-      timeout: 600000,
-    },
-    mempalace: {
-      enabled: true,
-      command: ["node", resolveAssetScript("mcp", "mempalace.mjs"), "--palace", "./.opencode/palace"],
-      timeout: 600000,
-    },
-  },
+  mcp: createDefaultMcpConfig(),
 
   lsp: {
     typescript: {
@@ -108,11 +51,11 @@ export const defaultConfig: HiaiOpencodeConfig = {
       extensions: [".svelte"],
     },
     eslint: {
-      command: createNpmPackageCommand("eslint-lsp", "--stdio"),
+      command: ["node", join(import.meta.dirname, "..", "assets", "runtime", "npm-package-runner.mjs"), "eslint-lsp", "--stdio"],
       extensions: [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".svelte"],
     },
     bash: {
-      command: createNpmPackageCommand("bash-language-server", "start"),
+      command: ["node", join(import.meta.dirname, "..", "assets", "runtime", "npm-package-runner.mjs"), "bash-language-server", "start"],
       extensions: [".sh", ".bash"],
     },
     pyright: {

package/src/config/loader.ts

@@ -164,7 +164,10 @@ export function loadConfig(projectDir: string): HiaiOpencodeConfig {
 }
 
 export function resolveEnvVars(value: string): string {
-  return value.replace(/\{env:([^}]+)\}/g, (_, key) => process.env[key] || "");
+  return value.replace(/\{env:([^}]+)\}/g, (_, expression) => {
+    const [key, fallback] = String(expression).split(":-", 2);
+    return process.env[key] || fallback || "";
+  });
 }
 
 export function resolveMcpEnv(config: HiaiOpencodeConfig): HiaiOpencodeConfig {

package/src/config/platform-schema.ts

@@ -41,6 +41,7 @@ export const McpServerConfigSchema = z.object({
   enabled: z.boolean().default(true),
   type: z.enum(["remote", "local"]).optional(),
   url: z.string().optional(),
+  headers: z.record(z.string(), z.string()).optional(),
   command: z.array(z.string()).optional(),
   timeout: z.number().optional(),
   environment: z.record(z.string(), z.string()).optional(),

package/src/index.ts

@@ -56,6 +56,7 @@ function configureBundledBunPtyLibrary(): void {
   const candidates = [
     join(import.meta.dirname, "..", "node_modules", "bun-pty", "rust-pty", "target", "release", libraryName),
     join(import.meta.dirname, "..", "..", "bun-pty", "rust-pty", "target", "release", libraryName),
+    join(import.meta.dirname, "..", "..", "..", "bun-pty", "rust-pty", "target", "release", libraryName),
   ]
 
   const resolved = candidates.find((candidate) => existsSync(candidate))

package/src/mcp/index.ts

@@ -1,45 +1,12 @@
 export { createBuiltinMcps } from "./omo-mcp-index"
 export { McpNameSchema, type McpName, type AnyMcpName } from "./types"
 
-import { existsSync } from "node:fs";
-import { join } from "node:path";
 import type { McpServerConfig } from "../config/types.js";
 import { resolveEnvVars } from "../config/loader.js";
 
-const ASSETS_DIR = join(import.meta.dirname || __dirname, "..", "assets", "mcp");
-
-function resolveBundledMcp(name: string): string {
-  const script = join(ASSETS_DIR, name);
-  if (existsSync(script)) return script;
-  return "";
-}
-
 export function buildMcpConfig(mcp: Record<string, McpServerConfig>): Record<string, unknown> {
   const result: Record<string, unknown> = {};
 
-  const defaults: Record<string, McpServerConfig> = {
-    rag: {
-      enabled: true,
-      type: "local",
-      command: ["node", resolveBundledMcp("rag.mjs")].filter(Boolean),
-      environment: {
-        OPENCODE_RAG_URL: "http://localhost:9002/tools/search",
-      },
-    },
-    mempalace: {
-      enabled: true,
-      type: "local",
-      command: ["node", resolveBundledMcp("mempalace.mjs"), "--palace", "./.opencode/palace"].filter(Boolean),
-      timeout: 60000,
-    },
-  };
-
-  for (const [name, server] of Object.entries(defaults)) {
-    if (!(name in mcp) && server.command && server.command.length >= 2) {
-      mcp[name] = server;
-    }
-  }
-
   for (const [name, server] of Object.entries(mcp)) {
     if (!server.enabled) continue;
 

package/src/mcp/omo-mcp-index.ts

@@ -1,5 +1,4 @@
 import { createWebsearchConfig } from "./websearch"
-import { context7 } from "./context7"
 import { grep_app } from "./grep-app"
 import type { HiaiOpenCodeConfig } from "../config/schema"
 
@@ -23,10 +22,6 @@ export function createBuiltinMcps(disabledMcps: string[] = [], config?: HiaiOpen
     }
   }
 
-  if (!disabledMcps.includes("context7")) {
-    mcps.context7 = context7
-  }
-
   if (!disabledMcps.includes("grep_app")) {
     mcps.grep_app = grep_app
   }

package/src/mcp/registry.ts

@@ -0,0 +1,132 @@
+import { join } from "node:path"
+import type { McpServerConfig } from "../config/types.js"
+
+export type HiaiMcpName =
+  | "playwright"
+  | "stitch"
+  | "sequential-thinking"
+  | "firecrawl"
+  | "rag"
+  | "context7"
+  | "mempalace"
+
+export type HiaiMcpInstallKind = "bundled" | "npm" | "python" | "remote" | "user-service"
+
+export interface HiaiMcpRegistryEntry {
+  name: HiaiMcpName
+  enabledByDefault: boolean
+  install: HiaiMcpInstallKind
+  requiredEnv?: string[]
+  optionalEnv?: string[]
+  config: McpServerConfig
+}
+
+function resolveAssetScript(...segments: string[]): string {
+  return join(import.meta.dirname, "..", "assets", ...segments)
+}
+
+function createNpmPackageCommand(pkg: string, ...args: string[]): string[] {
+  return ["node", resolveAssetScript("runtime", "npm-package-runner.mjs"), pkg, ...args]
+}
+
+export const HIAI_MCP_REGISTRY: Record<HiaiMcpName, HiaiMcpRegistryEntry> = {
+  playwright: {
+    name: "playwright",
+    enabledByDefault: true,
+    install: "npm",
+    optionalEnv: ["HIAI_PLAYWRIGHT_INSTALL_BROWSERS"],
+    config: {
+      enabled: true,
+      command: ["node", resolveAssetScript("mcp", "playwright.mjs")],
+      timeout: 600000,
+    },
+  },
+  stitch: {
+    name: "stitch",
+    enabledByDefault: true,
+    install: "remote",
+    requiredEnv: ["STITCH_AI_API_KEY"],
+    config: {
+      enabled: true,
+      type: "remote",
+      url: "https://stitch.googleapis.com/mcp",
+      headers: { "X-Goog-Api-Key": "{env:STITCH_AI_API_KEY}" },
+      timeout: 600000,
+    },
+  },
+  "sequential-thinking": {
+    name: "sequential-thinking",
+    enabledByDefault: true,
+    install: "npm",
+    config: {
+      enabled: true,
+      command: createNpmPackageCommand("@modelcontextprotocol/server-sequential-thinking"),
+      timeout: 600000,
+    },
+  },
+  firecrawl: {
+    name: "firecrawl",
+    enabledByDefault: true,
+    install: "npm",
+    requiredEnv: ["FIRECRAWL_API_KEY"],
+    config: {
+      enabled: true,
+      command: createNpmPackageCommand("firecrawl-mcp"),
+      timeout: 600000,
+      environment: { FIRECRAWL_API_KEY: "{env:FIRECRAWL_API_KEY}" },
+    },
+  },
+  rag: {
+    name: "rag",
+    enabledByDefault: true,
+    install: "user-service",
+    optionalEnv: ["OPENCODE_RAG_URL"],
+    config: {
+      enabled: true,
+      type: "local",
+      command: ["node", resolveAssetScript("mcp", "rag.mjs")],
+      environment: {
+        OPENCODE_RAG_URL: "{env:OPENCODE_RAG_URL:-http://localhost:9002/tools/search}",
+      },
+      timeout: 600000,
+    },
+  },
+  context7: {
+    name: "context7",
+    enabledByDefault: true,
+    install: "remote",
+    optionalEnv: ["CONTEXT7_API_KEY"],
+    config: {
+      enabled: true,
+      type: "remote",
+      url: "https://mcp.context7.com/mcp",
+      headers: { "X-API-KEY": "{env:CONTEXT7_API_KEY}" },
+      timeout: 600000,
+    },
+  },
+  mempalace: {
+    name: "mempalace",
+    enabledByDefault: true,
+    install: "python",
+    optionalEnv: ["MEMPALACE_PYTHON", "MEMPALACE_PALACE_PATH", "HIAI_MCP_AUTO_INSTALL"],
+    config: {
+      enabled: true,
+      type: "local",
+      command: ["node", resolveAssetScript("mcp", "mempalace.mjs"), "--palace", "./.opencode/palace"],
+      timeout: 600000,
+    },
+  },
+}
+
+export function createDefaultMcpConfig(): Record<HiaiMcpName, McpServerConfig> {
+  return Object.fromEntries(
+    Object.entries(HIAI_MCP_REGISTRY).map(([name, entry]) => [
+      name,
+      { ...entry.config, enabled: entry.enabledByDefault },
+    ]),
+  ) as Record<HiaiMcpName, McpServerConfig>
+}
+
+export function getKnownMcpNames(): HiaiMcpName[] {
+  return Object.keys(HIAI_MCP_REGISTRY) as HiaiMcpName[]
+}

package/src/mcp/types.ts

@@ -1,6 +1,16 @@
 import { z } from "zod"
 
-export const McpNameSchema = z.enum(["websearch", "context7", "grep_app"])
+export const McpNameSchema = z.enum([
+  "playwright",
+  "stitch",
+  "sequential-thinking",
+  "firecrawl",
+  "rag",
+  "context7",
+  "mempalace",
+  "websearch",
+  "grep_app",
+])
 
 export type McpName = z.infer<typeof McpNameSchema>