@hiai-gg/hiai-opencode 0.1.5 → 0.1.6

package/assets/mcp/mempalace.mjs

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 
-import { mkdirSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawn, spawnSync } from "node:child_process";
+import { homedir } from "node:os";
+import { parse as parseJsonc } from "jsonc-parser";
 
 function resolveCacheRoot() {
   const xdgCache = process.env.XDG_CACHE_HOME?.trim();
@@ -27,14 +29,103 @@ function parsePalacePath(argv) {
     || join(resolveCacheRoot(), "hiai-opencode", "mempalace-palace");
 }
 
+function resolveEnvTemplate(value) {
+  if (typeof value !== "string") return "";
+  return value.replace(/\{env:([^}]+)\}/g, (_match, expression) => {
+    const [name, fallback] = String(expression).split(":-", 2);
+    return process.env[name] || fallback || "";
+  }).trim();
+}
+
+function candidateConfigPaths() {
+  const cwd = process.cwd();
+  const home = homedir();
+  const paths = [
+    join(cwd, "hiai-opencode.json"),
+    join(cwd, "hiai-opencode.jsonc"),
+    join(cwd, ".opencode", "hiai-opencode.json"),
+    join(cwd, ".opencode", "hiai-opencode.jsonc"),
+    join(home, ".config", "opencode", "hiai-opencode.json"),
+    join(home, ".config", "opencode", "hiai-opencode.jsonc"),
+  ];
+
+  if (process.platform === "win32" && process.env.APPDATA) {
+    paths.push(join(process.env.APPDATA, "opencode", "hiai-opencode.json"));
+    paths.push(join(process.env.APPDATA, "opencode", "hiai-opencode.jsonc"));
+  }
+
+  return paths;
+}
+
+function loadUserConfig() {
+  for (const path of candidateConfigPaths()) {
+    if (!existsSync(path)) continue;
+    try {
+      return parseJsonc(readFileSync(path, "utf-8")) ?? {};
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+
+function getConfiguredPythonPath() {
+  const config = loadUserConfig();
+  const value = config?.mcp?.mempalace?.pythonPath;
+  return resolveEnvTemplate(typeof value === "string" ? value : "");
+}
+
+function resolveVenvPythonCandidates(basePath) {
+  if (!basePath) return [];
+
+  if (process.platform === "win32") {
+    return [
+      join(basePath, ".venv", "Scripts", "python.exe"),
+      join(basePath, "venv", "Scripts", "python.exe"),
+    ];
+  }
+
+  return [
+    join(basePath, ".venv", "bin", "python"),
+    join(basePath, ".venv", "bin", "python3"),
+    join(basePath, "venv", "bin", "python"),
+    join(basePath, "venv", "bin", "python3"),
+  ];
+}
+
 function pythonCandidates() {
+  const configPython = getConfiguredPythonPath();
   const explicit = process.env.MEMPALACE_PYTHON?.trim();
+  const scriptDir = dirname(fileURLToPath(import.meta.url));
+  const pluginRoot = join(scriptDir, "..", "..");
   const candidates = [];
 
   if (explicit) {
     candidates.push({ command: explicit, args: [] });
   }
 
+  if (configPython) {
+    candidates.push({ command: configPython, args: [] });
+  }
+
+  for (const candidate of resolveVenvPythonCandidates(process.cwd())) {
+    if (existsSync(candidate)) {
+      candidates.push({ command: candidate, args: [] });
+    }
+  }
+
+  for (const candidate of resolveVenvPythonCandidates(pluginRoot)) {
+    if (existsSync(candidate)) {
+      candidates.push({ command: candidate, args: [] });
+    }
+  }
+
+  for (const candidate of resolveVenvPythonCandidates(join(homedir(), ".config", "opencode", "plugins", "hiai-opencode"))) {
+    if (existsSync(candidate)) {
+      candidates.push({ command: candidate, args: [] });
+    }
+  }
+
   if (process.platform === "win32") {
     candidates.push({ command: "py", args: ["-3"] });
   }
@@ -42,7 +133,13 @@ function pythonCandidates() {
   candidates.push({ command: "python3", args: [] });
   candidates.push({ command: "python", args: [] });
 
-  return candidates;
+  const seen = new Set();
+  return candidates.filter((candidate) => {
+    const key = `${candidate.command}\0${candidate.args.join("\0")}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
 }
 
 function hasUv() {
@@ -57,7 +154,7 @@ function hasUv() {
 function canRunModule(candidate, moduleName) {
   const probe = spawnSync(
     candidate.command,
-    [...candidate.args, "-c", `import importlib.util, sys; sys.exit(0 if importlib.util.find_spec("${moduleName}") else 1)`],
+    [...candidate.args, "-c", `import importlib, sys; importlib.import_module("${moduleName}")`],
     { stdio: "ignore", timeout: 10000 },
   );
 
@@ -105,6 +202,31 @@ function installMempalaceWithPip(candidate) {
   return result.status === 0 && canRunModule(candidate, "mempalace.mcp_server");
 }
 
+function spawnWithUv(uvBinary, palacePath) {
+  return spawn(
+    uvBinary,
+    [
+      "tool",
+      "run",
+      "--from",
+      "mempalace[all]>=3.3.0",
+      "python",
+      "-m",
+      "mempalace.mcp_server",
+      "--palace",
+      palacePath,
+    ],
+    {
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        UV_CACHE_DIR: resolveUvCacheRoot(),
+        MEMPALACE_PALACE_PATH: palacePath,
+      },
+    },
+  );
+}
+
 function resolveUvCacheRoot() {
   return process.env.UV_CACHE_DIR
     || join(resolveCacheRoot(), "hiai-opencode", "uv");
@@ -129,30 +251,30 @@ function main() {
   const palacePath = parsePalacePath(process.argv.slice(2));
   mkdirSync(palacePath, { recursive: true });
 
+  const configuredPython =
+    process.env.MEMPALACE_PYTHON?.trim() || getConfiguredPythonPath();
+  if (configuredPython) {
+    const configuredCandidate = { command: configuredPython, args: [] };
+    if (canRunModule(configuredCandidate, "mempalace.mcp_server")) {
+      const configuredChild = spawn(
+        configuredCandidate.command,
+        [...configuredCandidate.args, "-m", "mempalace.mcp_server", "--palace", palacePath],
+        {
+          stdio: "inherit",
+          env: {
+            ...process.env,
+            MEMPALACE_PALACE_PATH: palacePath,
+          },
+        },
+      );
+      forwardChildExit(configuredChild, "[hiai-opencode] mempalace launcher failed:");
+      return;
+    }
+  }
+
   const uvBinary = hasUv();
   if (uvBinary) {
-    const child = spawn(
-      uvBinary,
-      [
-        "tool",
-        "run",
-        "--from",
-        "mempalace[all]>=3.3.0",
-        "python",
-        "-m",
-        "mempalace.mcp_server",
-        "--palace",
-        palacePath,
-      ],
-      {
-        stdio: "inherit",
-        env: {
-          ...process.env,
-          UV_CACHE_DIR: resolveUvCacheRoot(),
-          MEMPALACE_PALACE_PATH: palacePath,
-        },
-      },
-    );
+    const child = spawnWithUv(uvBinary, palacePath);
 
     forwardChildExit(child, "[hiai-opencode] mempalace uv launcher failed:");
     return;
@@ -167,10 +289,22 @@ function main() {
         if (pipPython && installMempalaceWithPip(pipPython)) {
           return pipPython;
         }
+
+        const fallbackUv = hasUv();
+        if (fallbackUv) {
+          const uvChild = spawnWithUv(fallbackUv, palacePath);
+          forwardChildExit(uvChild, "[hiai-opencode] mempalace uv fallback failed:");
+          return "__uv_fallback_started__";
+        }
+
         return null;
       })()
       : null);
 
+  if (fallbackPython === "__uv_fallback_started__") {
+    return;
+  }
+
   if (!fallbackPython) {
     console.error(
       "[hiai-opencode] mempalace skipped: install uv or Python 3.9+ with `pip install --user mempalace`",

package/config/hiai-opencode.schema.json

@@ -37,7 +37,6 @@
       "type": "object",
       "additionalProperties": { "type": "string" },
       "properties": {
-        "googleSearch": { "type": "string" },
         "stitch": { "type": "string" },
         "firecrawl": { "type": "string" },
         "context7": { "type": "string" }
@@ -52,7 +51,7 @@
         "sequential-thinking": { "$ref": "#/definitions/toggle" },
         "firecrawl": { "$ref": "#/definitions/toggle" },
         "rag": { "$ref": "#/definitions/toggle" },
-        "mempalace": { "$ref": "#/definitions/toggle" },
+        "mempalace": { "$ref": "#/definitions/mempalaceToggle" },
         "context7": { "$ref": "#/definitions/toggle" }
       }
     },
@@ -112,6 +111,18 @@
       },
       "required": ["enabled"],
       "additionalProperties": false
+    },
+    "mempalaceToggle": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "pythonPath": {
+          "type": "string",
+          "description": "Optional explicit Python executable for MemPalace (for example: ./.venv/bin/python)."
+        }
+      },
+      "required": ["enabled"],
+      "additionalProperties": false
     }
   }
 }

package/dist/agents/dynamic-agent-core-sections.d.ts

@@ -8,7 +8,10 @@ import type { AvailableTool } from "./dynamic-agent-prompt-types";
  */
 export declare function buildAgentIdentitySection(agentName: string, roleDescription: string): string;
 export declare function buildKeyTriggersSection(agents: AvailableAgent[], _skills?: AvailableSkill[]): string;
-export declare function buildToolSelectionTable(agents: AvailableAgent[], tools?: AvailableTool[], _skills?: AvailableSkill[]): string;
+export declare function buildToolSelectionTable(agents: AvailableAgent[], tools?: AvailableTool[], _skills?: AvailableSkill[], options?: {
+    includeIntegrationPrimer?: boolean;
+}): string;
+export declare function buildHiaiIntegrationPrimerSection(): string;
 export declare function buildResearcherSection(agents: AvailableAgent[]): string;
 export declare function buildDelegationTable(agents: AvailableAgent[]): string;
 export declare function buildStrategistAndCriticSection(agents: AvailableAgent[]): string;

package/dist/agents/dynamic-agent-prompt-builder.d.ts

@@ -1,5 +1,5 @@
 export type { AvailableAgent, AvailableTool, AvailableSkill, AvailableCategory, } from "./dynamic-agent-prompt-types";
 export { categorizeTools } from "./dynamic-agent-tool-categorization";
-export { buildAgentIdentitySection, buildKeyTriggersSection, buildToolSelectionTable, buildResearcherSection, buildDelegationTable, buildStrategistAndCriticSection, buildNonClaudePlannerSection, buildParallelDelegationSection, } from "./dynamic-agent-core-sections";
+export { buildAgentIdentitySection, buildKeyTriggersSection, buildToolSelectionTable, buildResearcherSection, buildDelegationTable, buildHiaiIntegrationPrimerSection, buildStrategistAndCriticSection, buildNonClaudePlannerSection, buildParallelDelegationSection, } from "./dynamic-agent-core-sections";
 export { buildCategorySkillsDelegationGuide } from "./dynamic-agent-category-skills-guide";
 export { buildHardBlocksSection, buildAntiPatternsSection, buildHardRulesSection, buildToolCallFormatSection, buildUltraworkSection, buildAntiDuplicationSection, buildToolUsageRulesSection, } from "./dynamic-agent-policy-sections";

package/dist/config/platform-schema.d.ts

@@ -219,6 +219,7 @@ export declare const McpServerConfigSchema: z.ZodObject<{
     command: z.ZodOptional<z.ZodArray<z.ZodString>>;
     timeout: z.ZodOptional<z.ZodNumber>;
     environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    pythonPath: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const LspServerConfigSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
@@ -311,9 +312,6 @@ export declare const PermissionsConfigSchema: z.ZodObject<{
     }>>>;
 }, z.core.$strip>;
 export declare const AuthKeysSchema: z.ZodObject<{
-    googleSearch: z.ZodOptional<z.ZodString>;
-    openai: z.ZodOptional<z.ZodString>;
-    openrouter: z.ZodOptional<z.ZodString>;
     stitch: z.ZodOptional<z.ZodString>;
     firecrawl: z.ZodOptional<z.ZodString>;
     context7: z.ZodOptional<z.ZodString>;
@@ -1304,6 +1302,7 @@ export declare const HiaiOpencodeConfigSchema: z.ZodObject<{
         command: z.ZodOptional<z.ZodArray<z.ZodString>>;
         timeout: z.ZodOptional<z.ZodNumber>;
         environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        pythonPath: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     lsp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -1396,9 +1395,6 @@ export declare const HiaiOpencodeConfigSchema: z.ZodObject<{
         }>>>;
     }, z.core.$strip>>;
     auth: z.ZodOptional<z.ZodObject<{
-        googleSearch: z.ZodOptional<z.ZodString>;
-        openai: z.ZodOptional<z.ZodString>;
-        openrouter: z.ZodOptional<z.ZodString>;
         stitch: z.ZodOptional<z.ZodString>;
         firecrawl: z.ZodOptional<z.ZodString>;
         context7: z.ZodOptional<z.ZodString>;

package/dist/config/schema/commands.d.ts

@@ -9,5 +9,6 @@ export declare const BuiltinCommandNameSchema: z.ZodEnum<{
     "stop-continuation": "stop-continuation";
     "remove-ai-slops": "remove-ai-slops";
     "mcp-status": "mcp-status";
+    doctor: "doctor";
 }>;
 export type BuiltinCommandName = z.infer<typeof BuiltinCommandNameSchema>;

package/dist/config/schema/oh-my-opencode-config.d.ts

@@ -26,6 +26,7 @@ export declare const HiaiOpenCodeConfigSchema: z.ZodObject<{
         "stop-continuation": "stop-continuation";
         "remove-ai-slops": "remove-ai-slops";
         "mcp-status": "mcp-status";
+        doctor: "doctor";
     }>>>;
     disabled_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     mcp_env_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -4216,9 +4217,6 @@ export declare const HiaiOpenCodeConfigSchema: z.ZodObject<{
         timeout_ms: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     auth: z.ZodOptional<z.ZodObject<{
-        googleSearch: z.ZodOptional<z.ZodString>;
-        openai: z.ZodOptional<z.ZodString>;
-        openrouter: z.ZodOptional<z.ZodString>;
         stitch: z.ZodOptional<z.ZodString>;
         firecrawl: z.ZodOptional<z.ZodString>;
         context7: z.ZodOptional<z.ZodString>;

package/dist/config/types.d.ts

@@ -72,6 +72,7 @@ export interface McpServerConfig {
     command?: string[];
     timeout?: number;
     environment?: Record<string, string>;
+    pythonPath?: string;
 }
 export interface LspServerConfig {
     enabled?: boolean;
@@ -103,9 +104,6 @@ export interface PermissionsConfig {
     deny_paths?: string[];
 }
 export interface AuthKeys {
-    googleSearch?: string;
-    openai?: string;
-    openrouter?: string;
     stitch?: string;
     firecrawl?: string;
     context7?: string;

package/dist/features/builtin-commands/templates/doctor.d.ts

@@ -0,0 +1 @@
+export declare const DOCTOR_TEMPLATE = "# Hiai OpenCode Doctor Command\n\n## Purpose\n\nUse /doctor to run the hiai-opencode install/runtime diagnostic and report actionable setup issues.\n\n## Execute\n\nRun:\n\n```bash\nhiai-opencode doctor\n```\n\nIf the binary is not on PATH, try the package-local fallback:\n\n```bash\nnode ./node_modules/@hiai-gg/hiai-opencode/assets/cli/hiai-opencode.mjs doctor\n```\n\n## Report\n\nSummarize:\n\n- config path\n- enabled and disabled MCP servers\n- missing env vars by name only\n- static `.mcp.json` freshness and whether it is managed by hiai-opencode\n- OpenCode Connect visibility for configured model providers\n- OpenCode plugin registration sanity (including `plugin: [\"list\"]` misconfiguration warning)\n- skill materialization status from skill registry\n- agent count and naming summary\n- LSP runtime availability\n- MemPalace python source and selected interpreter (env/config/auto)\n- MCP tool probes (real connect + tools/list) for stdio and basic endpoint probes for remote MCP\n\nRules:\n\n- Do not print API key values.\n- Do not ask for model provider env vars such as OPENROUTER_API_KEY or OPENAI_API_KEY; normal model auth belongs to OpenCode Connect.\n- If `opencode mcp list` is empty but doctor/mcp-status sees servers, explain the runtime-vs-static config distinction and run `hiai-opencode export-mcp .mcp.json` if the user wants static visibility.\n- Do not run package installs unless the user explicitly asks.\n";

package/dist/features/builtin-commands/types.d.ts

@@ -1,5 +1,5 @@
 import type { CommandDefinition } from "../claude-code-command-loader";
-export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "remove-ai-slops" | "mcp-status";
+export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "remove-ai-slops" | "mcp-status" | "doctor";
 export interface BuiltinCommandConfig {
     disabled_commands?: BuiltinCommandName[];
 }

package/dist/features/builtin-skills/skills/hiai-opencode-setup.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinSkill } from "../types";
+export declare const hiaiOpencodeSetupSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/index.d.ts

@@ -5,3 +5,4 @@ export { gitMasterSkill } from "./git-master";
 export { devBrowserSkill } from "./dev-browser";
 export { reviewWorkSkill } from "./review-work";
 export { aiSlopRemoverSkill } from "./ai-slop-remover";
+export { hiaiOpencodeSetupSkill } from "./hiai-opencode-setup";