@hiai-gg/hiai-opencode 0.1.7 → 0.1.8

package/src/internals/plugins/subtask2/utils/config.ts

@@ -1,100 +0,0 @@
-/// <reference types="bun-types" />
-
-import { mkdirSync } from "fs";
-import { dirname, join } from "path";
-import { getOpenCodeConfigDir } from "../../../../shared/opencode-config-dir";
-import type { Subtask2Config } from "../types";
-
-// Re-export from prompts.ts for backwards compatibility
-export { DEFAULT_RETURN_PROMPT as DEFAULT_PROMPT } from "./prompts";
-
-const CONFIG_PATH = join(
-  getOpenCodeConfigDir({ binary: "opencode" }),
-  "subtask2.jsonc"
-);
-
-/**
- * Cached README content
- */
-let cachedReadmeContent: string | null = null;
-
-/**
- * Reset the README cache (for testing)
- */
-export function _resetReadmeCache(): void {
-  cachedReadmeContent = null;
-}
-
-/**
- * Load README.md content from plugin root
- */
-export async function loadReadmeContent(): Promise<string> {
-  if (cachedReadmeContent !== null) {
-    return cachedReadmeContent;
-  }
-
-  try {
-    // Navigate from src/utils/config.ts to plugin root
-    const pluginRoot = join(dirname(import.meta.path), "..", "..");
-    const readmePath = join(pluginRoot, "README.md");
-    const file = Bun.file(readmePath);
-
-    if (await file.exists()) {
-      cachedReadmeContent = await file.text();
-      return cachedReadmeContent;
-    }
-  } catch {
-    // Fall through to fallback
-  }
-
-  // Fallback if README can't be loaded
-  cachedReadmeContent = `[README could not be loaded - see https://github.com/spoons-and-mirrors/subtask2 for documentation]`;
-  return cachedReadmeContent;
-}
-
-function isValidConfig(obj: unknown): obj is Subtask2Config {
-  if (typeof obj !== "object" || obj === null) return false;
-  const cfg = obj as Record<string, unknown>;
-  if (typeof cfg.replace_generic !== "boolean") return false;
-  if (
-    cfg.generic_return !== undefined &&
-    typeof cfg.generic_return !== "string"
-  )
-    return false;
-  return true;
-}
-
-export async function loadConfig(): Promise<Subtask2Config> {
-  const defaultConfig: Subtask2Config = {
-    replace_generic: true,
-  };
-
-  try {
-    const file = Bun.file(CONFIG_PATH);
-    if (await file.exists()) {
-      const text = await file.text();
-      const stripped = text
-        .replace(/\/\/.*$/gm, "")
-        .replace(/\/\*[\s\S]*?\*\//g, "")
-        .replace(/,\s*([}\]])/g, "$1");
-      const parsed = JSON.parse(stripped);
-      if (isValidConfig(parsed)) {
-        return parsed;
-      }
-    }
-  } catch {}
-
-  mkdirSync(dirname(CONFIG_PATH), { recursive: true });
-  await Bun.write(
-    CONFIG_PATH,
-    `{
-  // Replace OpenCode's generic "Summarize..." prompt when no return is specified
-  "replace_generic": true,
-
-  // Custom prompt to use when replace_generic: true | optional
-  //\"generic_return\": \"Review, challenge and verify the task tool output above against the codebase. Then validate or revise it, before continuing with the next logical step.\"
-}
-`
-  );
-  return defaultConfig;
-}

package/src/internals/plugins/subtask2/utils/index.ts

@@ -1,7 +0,0 @@
-/**
- * Utils module - re-exports all utility functionality
- */
-
-export * from "./config";
-export * from "./logger";
-export * from "./prompts";

package/src/internals/plugins/subtask2/utils/logger.ts

@@ -1,67 +0,0 @@
-import * as fs from "fs";
-import * as path from "path";
-
-const LOG_DIR = path.join(process.cwd(), ".logs");
-const LOG_FILE = path.join(LOG_DIR, "subtask2.log");
-const WRITE_INTERVAL_MS = 100;
-
-let logBuffer: string[] = [];
-let writeScheduled = false;
-let initialized = false;
-
-function ensureInitialized(): boolean {
-  if (initialized) return true;
-
-  try {
-    if (!fs.existsSync(LOG_DIR)) {
-      fs.mkdirSync(LOG_DIR, { recursive: true });
-    }
-    fs.writeFileSync(LOG_FILE, "");
-    initialized = true;
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function formatTimestamp(): string {
-  return new Date().toISOString();
-}
-
-async function flushLogs(): Promise<void> {
-  if (logBuffer.length === 0) {
-    writeScheduled = false;
-    return;
-  }
-
-  const toWrite = logBuffer.join("");
-  logBuffer = [];
-  writeScheduled = false;
-
-  try {
-    await fs.promises.appendFile(LOG_FILE, toWrite);
-  } catch {}
-}
-
-function scheduleFlush(): void {
-  if (!writeScheduled) {
-    writeScheduled = true;
-    setTimeout(flushLogs, WRITE_INTERVAL_MS);
-  }
-}
-
-export function log(...args: unknown[]) {
-  if (!ensureInitialized()) return;
-
-  const timestamp = formatTimestamp();
-  const message = args
-    .map(a => (typeof a === "object" ? JSON.stringify(a, null, 2) : String(a)))
-    .join(" ");
-  logBuffer.push(`[${timestamp}] ${message}\n`);
-  scheduleFlush();
-}
-
-export function clearLog() {
-  if (!ensureInitialized()) return;
-  fs.writeFileSync(LOG_FILE, "");
-}

package/src/internals/plugins/subtask2/utils/prompts.ts

@@ -1,117 +0,0 @@
-/**
- * All prompts used by subtask2 plugin - centralized for easy editing
- */
-
-import { loadReadmeContent } from "./config";
-
-// Re-export for backwards compatibility
-export { _resetReadmeCache } from "./config";
-
-/**
- * Default return prompt when no return is specified and replace_generic is true
- */
-export const DEFAULT_RETURN_PROMPT =
-  "Review, challenge and verify the task tool output above against the codebase. Then validate or revise it, before continuing with the next logical step.";
-
-//export const DEFAULT_RETURN_PROMPT = "SAY BANANANANANA AND NOTHING ELSE!";
-
-/**
- * Placeholder for README content in auto workflow prompt
- */
-const README_PLACEHOLDER = "{{SUBTASK2_README}}";
-
-/**
- * Instruction for /subtask inline subtask - makes LLM say minimal response while subtask runs
- */
-export const S2_INLINE_INSTRUCTION = `<system>The user has queued a tool for execution, please yield back now and say: "Running subagent..."</system>`;
-
-/**
- * Loop evaluation prompt - used as subtask return
- */
-export function loopEvaluationPrompt(
-  condition: string,
-  iteration: number,
-  max: number
-): string {
-  return `<instructions subtask2=loop-evaluation>
-The user chose to loop the subtask that was just executed.
-Current loop progress: ${iteration}/${max} iterations.
-
-**You are now tasked with evaluating the previous work done in context of this conversation and verify if the current codebase state satisfies the user conditions.**
-
-<user-condition>
-${condition}
-</user-condition>
-
-You may read files, check git diff/status, run tests, or do whatever verification is needed.
-
-> DO NOT WRITE OR EDIT ANY FILES - YOU ARE ONLY TO EVALUATE AND REPORT
-
-After evaluation:
-- If the condition IS satisfied: respond with <subtask2 loop=break/> to exit the loop
-- If not, the loop will re-run after you yield back
-
-You may now proceed with the evaluation.
-</instructions>`;
-}
-
-/**
- * Unconditional loop yield prompt - tells main session to yield so loop can continue
- * Used when loop has no until condition (just {loop:N})
- */
-export function loopYieldPrompt(iteration: number, max: number): string {
-  return `<instructions subtask2=loop-yield>
-Loop progress: ${iteration}/${max} iterations.
-Please yield back now to allow the next loop iteration to run.
-</instructions>`;
-}
-
-/**
- * Auto workflow generation prompt (POC) - teaches LLM to generate subtask2 inline syntax
- * Contains {{SUBTASK2_README}} placeholder that gets replaced with actual README content
- */
-export const AUTO_WORKFLOW_PROMPT_TEMPLATE = `You are tasked with creating a subtask2 command workflow to fulfill the user's request.
-
-## Subtask2 Plugin Documentation
-
-The following is the complete documentation for the subtask2 plugin. Study it carefully to understand all available features.
-
-<subtask2-readme>
-${README_PLACEHOLDER}
-</subtask2-readme>
-
-## Your Task
-
-Using the subtask2 inline syntax documented above, create a workflow to fulfill the user's request.
-
-### Output Format
-
-1. Output your reasoning first - analyze what the user needs and how to best structure the workflow
-2. Then output the workflow inside: <subtask2 auto="true">...</subtask2>
-3. The workflow must be a single /subtask {...} command with inline syntax
-4. Do NOT create files - the workflow executes in memory
-5. Use returns to chain multiple steps
-6. Use parallel for concurrent independent tasks
-
-USER INPUT:
-`;
-
-/**
- * Get the auto workflow prompt with README content injected
- */
-export async function getAutoWorkflowPrompt(): Promise<string> {
-  const readmeContent = await loadReadmeContent();
-  return AUTO_WORKFLOW_PROMPT_TEMPLATE.replace(
-    README_PLACEHOLDER,
-    readmeContent
-  );
-}
-
-/**
- * @deprecated Use getAutoWorkflowPrompt() instead - this is kept for backwards compatibility
- * but will use a static fallback without the full README
- */
-export const AUTO_WORKFLOW_PROMPT = AUTO_WORKFLOW_PROMPT_TEMPLATE.replace(
-  README_PLACEHOLDER,
-  "[Use getAutoWorkflowPrompt() to get full documentation]"
-);

package/src/lsp/index.ts

@@ -1,16 +0,0 @@
-import type { LspServerConfig } from "../config/types.js";
-
-export function buildLspConfig(lsp: Record<string, LspServerConfig>): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-
-  for (const [name, server] of Object.entries(lsp)) {
-    if (server.enabled === false) continue;
-    result[name] = {
-      command: server.command,
-      extensions: server.extensions,
-      ...(server.initialization ? { initialization: server.initialization } : {}),
-    };
-  }
-
-  return result;
-}

package/src/mcp/context7.ts

@@ -1,9 +0,0 @@
-export const context7 = {
-  type: "remote" as const,
-  url: "https://mcp.context7.com/mcp",
-  enabled: true,
-  headers: process.env.CONTEXT7_API_KEY
-    ? { Authorization: `Bearer ${process.env.CONTEXT7_API_KEY}` }
-    : undefined,
-  oauth: false as const,
-}

package/src/mcp/index.ts

@@ -1,53 +0,0 @@
-export { McpNameSchema, type McpName, type AnyMcpName } from "./types"
-
-import type { McpServerConfig } from "../config/types.js";
-import { resolveEnvVars } from "../config/loader.js";
-
-export function buildMcpConfig(mcp: Record<string, McpServerConfig>): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-
-  for (const [name, server] of Object.entries(mcp)) {
-    if (!server.enabled) continue;
-
-    const entry: Record<string, unknown> = { enabled: true };
-
-    if (server.type === "remote") {
-      entry.type = "remote";
-      entry.url = server.url;
-      if (server.headers) {
-        const headers: Record<string, string> = {};
-        for (const [k, v] of Object.entries(server.headers)) {
-          headers[k] = resolveEnvVars(v);
-        }
-        entry.headers = headers;
-      }
-    } else {
-      entry.type = "local";
-      if (server.command) {
-        entry.command = server.command;
-      }
-    }
-
-    if (server.timeout) entry.timeout = server.timeout;
-
-    if (server.environment) {
-      const env: Record<string, string> = {};
-      for (const [k, v] of Object.entries(server.environment)) {
-        env[k] = resolveEnvVars(v);
-      }
-      entry.environment = env;
-    }
-
-    result[name] = entry;
-  }
-
-  return result;
-}
-
-export function buildMcpPermissions(mcp: Record<string, McpServerConfig>): Record<string, string> {
-  const perms: Record<string, string> = {};
-  for (const name of Object.keys(mcp)) {
-    perms[`${name}_*`] = "allow";
-  }
-  return perms;
-}

package/src/mcp/registry.ts

@@ -1,164 +0,0 @@
-import { join } from "node:path"
-import { existsSync } from "node:fs"
-import type { McpServerConfig } from "../config/types.js"
-
-export type HiaiMcpName =
-  | "playwright"
-  | "stitch"
-  | "sequential-thinking"
-  | "firecrawl"
-  | "rag"
-  | "context7"
-  | "mempalace"
-  | "websearch"
-  | "grep_app"
-
-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 {
-  const candidates = [
-    join(import.meta.dirname, "..", "assets", ...segments),
-    join(import.meta.dirname, "..", "..", "assets", ...segments),
-  ]
-  return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0]
-}
-
-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,
-    },
-  },
-  websearch: {
-    name: "websearch",
-    enabledByDefault: true,
-    install: "remote",
-    optionalEnv: ["EXA_API_KEY", "TAVILY_API_KEY"],
-    config: {
-      enabled: true,
-      type: "remote",
-      url: "https://mcp.exa.ai/mcp?tools=web_search_exa",
-      headers: { "x-api-key": "{env:EXA_API_KEY}" },
-      timeout: 600000,
-      provider: "exa",
-    },
-  },
-  grep_app: {
-    name: "grep_app",
-    enabledByDefault: true,
-    install: "remote",
-    config: {
-      enabled: true,
-      type: "remote",
-      url: "https://mcp.grep.app",
-      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,19 +0,0 @@
-import { z } from "zod"
-
-export const McpNameSchema = z.enum([
-  "playwright",
-  "stitch",
-  "sequential-thinking",
-  "firecrawl",
-  "rag",
-  "context7",
-  "mempalace",
-  "websearch",
-  "grep_app",
-])
-
-export type McpName = z.infer<typeof McpNameSchema>
-
-export const AnyMcpNameSchema = z.string().min(1)
-
-export type AnyMcpName = z.infer<typeof AnyMcpNameSchema>

package/src/permissions/index.ts

@@ -1,25 +0,0 @@
-import type { PermissionsConfig } from "../config/types.js";
-import { buildMcpPermissions } from "../mcp/index.js";
-import type { McpServerConfig } from "../config/types.js";
-
-export function buildPermissions(
-  perms: PermissionsConfig,
-  mcp: Record<string, McpServerConfig>,
-): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-
-  if (perms.read) result.read = perms.read;
-  if (perms.edit) result.edit = perms.edit;
-  if (perms.bash) result.bash = perms.bash;
-
-  const mcpPerms = buildMcpPermissions(mcp);
-  if (Object.keys(mcpPerms).length > 0) {
-    result.bash = { ...(result.bash as Record<string, string> || {}), ...mcpPerms };
-  }
-
-  if (perms.deny_paths && perms.deny_paths.length > 0) {
-    result.deny_paths = perms.deny_paths;
-  }
-
-  return result;
-}

package/src/plugin/AGENTS.md

@@ -1,54 +0,0 @@
-# src/plugin/ — 10 OpenCode Hook Handlers + Hook Composition
-
-**Generated:** 2026-04-11
-
-## OVERVIEW
-
-Core glue layer. 20 source files assembling the 10 OpenCode hook handlers and composing 50 hooks into the PluginInterface. Every handler file corresponds to one OpenCode hook type.
-
-## HANDLER FILES
-
-| File | OpenCode Hook | Purpose |
-|------|---------------|---------|
-| `config.ts` | `config` | 6-phase config loading pipeline |
-| `tool-registry.ts` | `tool` | 26 tools assembled from factories |
-| `chat-message.ts` | `chat.message` | First-message variant, session setup, keyword detection |
-| `chat-params.ts` | `chat.params` | Anthropic effort level, think mode |
-| `chat-headers.ts` | `chat.headers` | Copilot x-initiator header injection |
-| `event.ts` | `event` | Session lifecycle (created, deleted, idle, error) |
-| `tool-execute-before.ts` | `tool.execute.before` | Pre-tool guards (file guard, label truncator, rules injector) |
-| `tool-execute-after.ts` | `tool.execute.after` | Post-tool hooks (output truncation, comment checker, metadata) |
-| `messages-transform.ts` | `experimental.chat.messages.transform` | Context injection, thinking block validation |
-| `session-compacting.ts` | `experimental.session.compacting` | Context + todo preservation during compaction |
-| `skill-context.ts` | — | Skill/browser/category context for tool creation |
-
-## HOOK COMPOSITION (hooks/ subdir)
-
-| File | Tier | Count |
-|------|------|-------|
-| `create-session-hooks.ts` | Session | 23 |
-| `create-tool-guard-hooks.ts` | Tool Guard | 14 |
-| `create-transform-hooks.ts` | Transform | 5 |
-| `create-skill-hooks.ts` | Skill | 2 |
-| `create-core-hooks.ts` | Aggregator | Session + Guard + Transform = 42 |
-
-## SUPPORT FILES
-
-| File | Purpose |
-|------|---------|
-| `available-categories.ts` | Build `AvailableCategory[]` for agent prompt injection |
-| `session-agent-resolver.ts` | Resolve which agent owns a session |
-| `session-status-normalizer.ts` | Normalize session status across OpenCode versions |
-| `recent-synthetic-idles.ts` | Dedup rapid idle events |
-| `unstable-agent-babysitter.ts` | Track unstable agent behavior across sessions |
-| `types.ts` | `PluginContext`, `PluginInterface`, `ToolsRecord`, `TmuxConfig` |
-| `ultrawork-model-override.ts` | Ultrawork mode model override logic |
-| `ultrawork-db-model-override.ts` | DB-level model override for ultrawork |
-| `config-handler.ts` | Runtime config loading and caching |
-
-## KEY PATTERNS
-
-- Each handler exports a function receiving `(hookRecord, ctx, pluginConfig, managers)` → returns OpenCode hook function
-- Handlers iterate over hook records, calling each hook with `(input, output)` in sequence
-- `safeHook()` wrapper in composition files catches errors per-hook without breaking the chain
-- Tool registry uses `filterDisabledTools()` before returning

package/src/plugin/available-categories.ts

@@ -1,24 +0,0 @@
-import type { AvailableCategory } from "../agents/dynamic-agent-prompt-builder"
-import type { HiaiOpenCodeConfig } from "../config"
-import { CATEGORY_DESCRIPTIONS } from "../tools/delegate-task/constants"
-import { mergeCategories } from "../shared/merge-categories"
-
-export function createAvailableCategories(
-  pluginConfig: HiaiOpenCodeConfig,
-): AvailableCategory[] {
-  const categories = mergeCategories(pluginConfig.categories)
-
-  return Object.entries(categories).map(([name, categoryConfig]) => {
-    const model =
-      typeof categoryConfig.model === "string" ? categoryConfig.model : undefined
-
-    return {
-      name,
-      description:
-        pluginConfig.categories?.[name]?.description ??
-        CATEGORY_DESCRIPTIONS[name] ??
-        "General tasks",
-      model,
-    }
-  })
-}