@hiai-gg/hiai-opencode 0.1.7 → 0.1.8

package/src/hooks/delegate-task-retry/guidance.ts

@@ -1,45 +0,0 @@
-import { DELEGATE_TASK_ERROR_PATTERNS, type DetectedError } from "./patterns"
-
-function extractAvailableList(output: string): string | null {
-  const availableMatch = output.match(/Available[^:]*:\s*(.+)$/m)
-  return availableMatch ? availableMatch[1].trim() : null
-}
-
-export function buildRetryGuidance(errorInfo: DetectedError): string {
-  const pattern = DELEGATE_TASK_ERROR_PATTERNS.find(
-    (p) => p.errorType === errorInfo.errorType
-  )
-
-  if (!pattern) {
-    return `[task ERROR] Fix the error and retry with correct parameters.`
-  }
-
-  let guidance = `
- [task CALL FAILED - IMMEDIATE RETRY REQUIRED]
- 
- **Error Type**: ${errorInfo.errorType}
- **Fix**: ${pattern.fixHint}
- `
-
-  const availableList = extractAvailableList(errorInfo.originalOutput)
-  if (availableList) {
-    guidance += `\n**Available Options**: ${availableList}\n`
-  }
-
-  guidance += `
- **Action**: Retry task NOW with corrected parameters.
- 
- Example of CORRECT call:
- \`\`\`
- task(
-   description="Task description",
-   prompt="Detailed prompt...",
-   category="unspecified-low",  // OR subagent_type="researcher"
-   run_in_background=false,
-   load_skills=[]
- )
- \`\`\`
- `
-
-  return guidance
-}

package/src/hooks/delegate-task-retry/hook.ts

@@ -1,22 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin"
-
-import { buildRetryGuidance } from "./guidance"
-import { detectDelegateTaskError } from "./patterns"
-
-export function createDelegateTaskRetryHook(_ctx: PluginInput) {
-  return {
-    "tool.execute.after": async (
-      input: { tool: string; sessionID: string; callID: string },
-      output: { title: string; output: string; metadata: unknown }
-    ) => {
-      if (input.tool.toLowerCase() !== "task") return
-      if (typeof output.output !== "string") return
-
-      const errorInfo = detectDelegateTaskError(output.output)
-      if (errorInfo) {
-        const guidance = buildRetryGuidance(errorInfo)
-        output.output += `\n${guidance}`
-      }
-    },
-  }
-}

package/src/hooks/delegate-task-retry/index.ts

@@ -1,4 +0,0 @@
-export type { DelegateTaskErrorPattern, DetectedError } from "./patterns"
-export { DELEGATE_TASK_ERROR_PATTERNS, detectDelegateTaskError } from "./patterns"
-export { buildRetryGuidance } from "./guidance"
-export { createDelegateTaskRetryHook } from "./hook"

package/src/hooks/delegate-task-retry/patterns.ts

@@ -1,77 +0,0 @@
-export interface DelegateTaskErrorPattern {
-  pattern: string
-  errorType: string
-  fixHint: string
-}
-
-export const DELEGATE_TASK_ERROR_PATTERNS: DelegateTaskErrorPattern[] = [
-  {
-    pattern: "run_in_background",
-    errorType: "missing_run_in_background",
-    fixHint:
-      "Add run_in_background=false (for delegation) or run_in_background=true (for parallel exploration)",
-  },
-  {
-    pattern: "load_skills",
-    errorType: "missing_load_skills",
-    fixHint:
-      "Add load_skills=[] parameter (empty array if no skills needed). Note: Calling Skill tool does NOT populate this.",
-  },
-  {
-    pattern: "category OR subagent_type",
-    errorType: "mutual_exclusion",
-    fixHint:
-      "Provide ONLY one of: category (e.g., 'general', 'quick') OR subagent_type (e.g., 'researcher', 'strategist')",
-  },
-  {
-    pattern: "Must provide either category or subagent_type",
-    errorType: "missing_category_or_agent",
-    fixHint: "Add either category='general' OR subagent_type='researcher'",
-  },
-  {
-    pattern: "Unknown category",
-    errorType: "unknown_category",
-    fixHint: "Use a valid category from the Available list in the error message",
-  },
-  {
-    pattern: "Agent name cannot be empty",
-    errorType: "empty_agent",
-    fixHint: "Provide a non-empty subagent_type value",
-  },
-  {
-    pattern: "Unknown agent",
-    errorType: "unknown_agent",
-    fixHint: "Use a valid agent from the Available agents list in the error message",
-  },
-  {
-    pattern: "Cannot call primary agent",
-    errorType: "primary_agent",
-    fixHint:
-      "Primary agents cannot be called via task. Use a delegated agent like 'researcher', 'strategist', or 'critic'",
-  },
-  {
-    pattern: "Skills not found",
-    errorType: "unknown_skills",
-    fixHint: "Use valid skill names from the Available list in the error message",
-  },
-]
-
-export interface DetectedError {
-  errorType: string
-  originalOutput: string
-}
-
-export function detectDelegateTaskError(output: string): DetectedError | null {
-  if (!output.includes("[ERROR]") && !output.includes("Invalid arguments")) return null
-
-  for (const errorPattern of DELEGATE_TASK_ERROR_PATTERNS) {
-    if (output.includes(errorPattern.pattern)) {
-      return {
-        errorType: errorPattern.errorType,
-        originalOutput: output,
-      }
-    }
-  }
-
-  return null
-}

package/src/hooks/directory-agents-injector/constants.ts

@@ -1,7 +0,0 @@
-import { join } from "node:path";
-import { OPENCODE_STORAGE } from "../../shared";
-export const AGENTS_INJECTOR_STORAGE = join(
-  OPENCODE_STORAGE,
-  "directory-agents",
-);
-export const AGENTS_FILENAME = "AGENTS.md";

package/src/hooks/directory-agents-injector/finder.ts

@@ -1,38 +0,0 @@
-import { existsSync } from "node:fs";
-import { dirname, isAbsolute, join, resolve } from "node:path";
-
-import { AGENTS_FILENAME } from "./constants";
-
-export function resolveFilePath(rootDirectory: string, path: string): string | null {
-  if (!path) return null;
-  if (isAbsolute(path)) return path;
-  return resolve(rootDirectory, path);
-}
-
-export function findAgentsMdUp(input: {
-  startDir: string;
-  rootDir: string;
-}): string[] {
-  const found: string[] = [];
-  let current = input.startDir;
-
-  while (true) {
-    // Skip root AGENTS.md - OpenCode's system.ts already loads it via custom()
-    // See: https://github.com/code-yeongyu/hiai-opencode/issues/379
-    const isRootDir = current === input.rootDir;
-    if (!isRootDir) {
-      const agentsPath = join(current, AGENTS_FILENAME);
-      if (existsSync(agentsPath)) {
-        found.push(agentsPath);
-      }
-    }
-
-    if (isRootDir) break;
-    const parent = dirname(current);
-    if (parent === current) break;
-    if (!parent.startsWith(input.rootDir)) break;
-    current = parent;
-  }
-
-  return found.reverse();
-}

package/src/hooks/directory-agents-injector/hook.ts

@@ -1,80 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-
-import { createDynamicTruncator } from "../../shared/dynamic-truncator";
-import { processFilePathForAgentsInjection } from "./injector";
-import { clearInjectedPaths } from "./storage";
-
-interface ToolExecuteInput {
-  tool: string;
-  sessionID: string;
-  callID: string;
-}
-
-interface ToolExecuteOutput {
-  title: string;
-  output: string;
-  metadata: unknown;
-}
-
-interface DirectoryAgentsInjectorHook {
-  "tool.execute.before"?: (input: ToolExecuteInput, output: { args: unknown }) => Promise<void>;
-  "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
-  event: (input: EventInput) => Promise<void>;
-}
-
-interface EventInput {
-  event: {
-    type: string;
-    properties?: unknown;
-  };
-}
-
-export function createDirectoryAgentsInjectorHook(
-  ctx: PluginInput,
-  modelCacheState?: { anthropicContext1MEnabled: boolean },
-): DirectoryAgentsInjectorHook {
-  const sessionCaches = new Map<string, Set<string>>();
-  const truncator = createDynamicTruncator(ctx, modelCacheState);
-
-  const toolExecuteAfter = async (input: ToolExecuteInput, output: ToolExecuteOutput) => {
-    const toolName = input.tool.toLowerCase();
-
-    if (toolName === "read") {
-      await processFilePathForAgentsInjection({
-        ctx,
-        truncator,
-        sessionCaches,
-        filePath: output.title,
-        sessionID: input.sessionID,
-        output,
-      });
-      return;
-    }
-  };
-
-  const eventHandler = async ({ event }: EventInput) => {
-    const props = event.properties as Record<string, unknown> | undefined;
-
-    if (event.type === "session.deleted") {
-      const sessionInfo = props?.info as { id?: string } | undefined;
-      if (sessionInfo?.id) {
-        sessionCaches.delete(sessionInfo.id);
-        clearInjectedPaths(sessionInfo.id);
-      }
-    }
-
-    if (event.type === "session.compacted") {
-      const sessionID = (props?.sessionID ??
-        (props?.info as { id?: string } | undefined)?.id) as string | undefined;
-      if (sessionID) {
-        sessionCaches.delete(sessionID);
-        clearInjectedPaths(sessionID);
-      }
-    }
-  };
-
-  return {
-    "tool.execute.after": toolExecuteAfter,
-    event: eventHandler,
-  };
-}

package/src/hooks/directory-agents-injector/index.ts

@@ -1 +0,0 @@
-export { createDirectoryAgentsInjectorHook } from "./hook";

package/src/hooks/directory-agents-injector/injector.ts

@@ -1,59 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import { readFileSync } from "node:fs";
-import { dirname } from "node:path";
-
-import type { createDynamicTruncator } from "../../shared/dynamic-truncator";
-import { findAgentsMdUp, resolveFilePath } from "./finder";
-import { loadInjectedPaths, saveInjectedPaths } from "./storage";
-
-type DynamicTruncator = ReturnType<typeof createDynamicTruncator>;
-
-function getSessionCache(
-  sessionCaches: Map<string, Set<string>>,
-  sessionID: string,
-): Set<string> {
-  if (!sessionCaches.has(sessionID)) {
-    sessionCaches.set(sessionID, loadInjectedPaths(sessionID));
-  }
-  return sessionCaches.get(sessionID)!;
-}
-
-export async function processFilePathForAgentsInjection(input: {
-  ctx: PluginInput;
-  truncator: DynamicTruncator;
-  sessionCaches: Map<string, Set<string>>;
-  filePath: string;
-  sessionID: string;
-  output: { title: string; output: string; metadata: unknown };
-}): Promise<void> {
-  const resolved = resolveFilePath(input.ctx.directory, input.filePath);
-  if (!resolved) return;
-
-  const dir = dirname(resolved);
-  const cache = getSessionCache(input.sessionCaches, input.sessionID);
-  const agentsPaths = findAgentsMdUp({ startDir: dir, rootDir: input.ctx.directory });
-
-  let dirty = false;
-  for (const agentsPath of agentsPaths) {
-    const agentsDir = dirname(agentsPath);
-    if (cache.has(agentsDir)) continue;
-
-    try {
-      const content = readFileSync(agentsPath, "utf-8");
-      const { result, truncated } = await input.truncator.truncate(
-        input.sessionID,
-        content,
-      );
-      const truncationNotice = truncated
-        ? `\n\n[Note: Content was truncated to save context window space. For full context, please read the file directly: ${agentsPath}]`
-        : "";
-      input.output.output += `\n\n[Directory Context: ${agentsPath}]\n${result}${truncationNotice}`;
-      cache.add(agentsDir);
-      dirty = true;
-    } catch {}
-  }
-
-  if (dirty) {
-    saveInjectedPaths(input.sessionID, cache);
-  }
-}

package/src/hooks/directory-agents-injector/storage.ts

@@ -1,8 +0,0 @@
-import { AGENTS_INJECTOR_STORAGE } from "./constants";
-import { createInjectedPathsStorage } from "../../shared/session-injected-paths";
-
-export const {
-  loadInjectedPaths,
-  saveInjectedPaths,
-  clearInjectedPaths,
-} = createInjectedPathsStorage(AGENTS_INJECTOR_STORAGE);

package/src/hooks/directory-readme-injector/constants.ts

@@ -1,7 +0,0 @@
-import { join } from "node:path";
-import { OPENCODE_STORAGE } from "../../shared";
-export const README_INJECTOR_STORAGE = join(
-  OPENCODE_STORAGE,
-  "directory-readme",
-);
-export const README_FILENAME = "README.md";

package/src/hooks/directory-readme-injector/finder.ts

@@ -1,33 +0,0 @@
-import { existsSync } from "node:fs";
-import { dirname, isAbsolute, join, resolve } from "node:path";
-
-import { README_FILENAME } from "./constants";
-
-export function resolveFilePath(rootDirectory: string, path: string): string | null {
-  if (!path) return null;
-  if (isAbsolute(path)) return path;
-  return resolve(rootDirectory, path);
-}
-
-export function findReadmeMdUp(input: {
-  startDir: string;
-  rootDir: string;
-}): string[] {
-  const found: string[] = [];
-  let current = input.startDir;
-
-  while (true) {
-    const readmePath = join(current, README_FILENAME);
-    if (existsSync(readmePath)) {
-      found.push(readmePath);
-    }
-
-    if (current === input.rootDir) break;
-    const parent = dirname(current);
-    if (parent === current) break;
-    if (!parent.startsWith(input.rootDir)) break;
-    current = parent;
-  }
-
-  return found.reverse();
-}

package/src/hooks/directory-readme-injector/hook.ts

@@ -1,80 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-
-import { createDynamicTruncator } from "../../shared/dynamic-truncator";
-import { processFilePathForReadmeInjection } from "./injector";
-import { clearInjectedPaths } from "./storage";
-
-interface ToolExecuteInput {
-  tool: string;
-  sessionID: string;
-  callID: string;
-}
-
-interface ToolExecuteOutput {
-  title: string;
-  output: string;
-  metadata: unknown;
-}
-
-interface DirectoryReadmeInjectorHook {
-  "tool.execute.before"?: (input: ToolExecuteInput, output: { args: unknown }) => Promise<void>;
-  "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;
-  event: (input: EventInput) => Promise<void>;
-}
-
-interface EventInput {
-  event: {
-    type: string;
-    properties?: unknown;
-  };
-}
-
-export function createDirectoryReadmeInjectorHook(
-  ctx: PluginInput,
-  modelCacheState?: { anthropicContext1MEnabled: boolean },
-): DirectoryReadmeInjectorHook {
-  const sessionCaches = new Map<string, Set<string>>();
-  const truncator = createDynamicTruncator(ctx, modelCacheState);
-
-  const toolExecuteAfter = async (input: ToolExecuteInput, output: ToolExecuteOutput) => {
-    const toolName = input.tool.toLowerCase();
-
-    if (toolName === "read") {
-      await processFilePathForReadmeInjection({
-        ctx,
-        truncator,
-        sessionCaches,
-        filePath: output.title,
-        sessionID: input.sessionID,
-        output,
-      });
-      return;
-    }
-  };
-
-  const eventHandler = async ({ event }: EventInput) => {
-    const props = event.properties as Record<string, unknown> | undefined;
-
-    if (event.type === "session.deleted") {
-      const sessionInfo = props?.info as { id?: string } | undefined;
-      if (sessionInfo?.id) {
-        sessionCaches.delete(sessionInfo.id);
-        clearInjectedPaths(sessionInfo.id);
-      }
-    }
-
-    if (event.type === "session.compacted") {
-      const sessionID = (props?.sessionID ??
-        (props?.info as { id?: string } | undefined)?.id) as string | undefined;
-      if (sessionID) {
-        sessionCaches.delete(sessionID);
-        clearInjectedPaths(sessionID);
-      }
-    }
-  };
-
-  return {
-    "tool.execute.after": toolExecuteAfter,
-    event: eventHandler,
-  };
-}

package/src/hooks/directory-readme-injector/index.ts

@@ -1 +0,0 @@
-export { createDirectoryReadmeInjectorHook } from "./hook";

package/src/hooks/directory-readme-injector/injector.ts

@@ -1,59 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import { readFileSync } from "node:fs";
-import { dirname } from "node:path";
-
-import type { createDynamicTruncator } from "../../shared/dynamic-truncator";
-import { findReadmeMdUp, resolveFilePath } from "./finder";
-import { loadInjectedPaths, saveInjectedPaths } from "./storage";
-
-type DynamicTruncator = ReturnType<typeof createDynamicTruncator>;
-
-function getSessionCache(
-  sessionCaches: Map<string, Set<string>>,
-  sessionID: string,
-): Set<string> {
-  if (!sessionCaches.has(sessionID)) {
-    sessionCaches.set(sessionID, loadInjectedPaths(sessionID));
-  }
-  return sessionCaches.get(sessionID)!;
-}
-
-export async function processFilePathForReadmeInjection(input: {
-  ctx: PluginInput;
-  truncator: DynamicTruncator;
-  sessionCaches: Map<string, Set<string>>;
-  filePath: string;
-  sessionID: string;
-  output: { title: string; output: string; metadata: unknown };
-}): Promise<void> {
-  const resolved = resolveFilePath(input.ctx.directory, input.filePath);
-  if (!resolved) return;
-
-  const dir = dirname(resolved);
-  const cache = getSessionCache(input.sessionCaches, input.sessionID);
-  const readmePaths = findReadmeMdUp({ startDir: dir, rootDir: input.ctx.directory });
-
-  let dirty = false;
-  for (const readmePath of readmePaths) {
-    const readmeDir = dirname(readmePath);
-    if (cache.has(readmeDir)) continue;
-
-    try {
-      const content = readFileSync(readmePath, "utf-8");
-      const { result, truncated } = await input.truncator.truncate(
-        input.sessionID,
-        content,
-      );
-      const truncationNotice = truncated
-        ? `\n\n[Note: Content was truncated to save context window space. For full context, please read the file directly: ${readmePath}]`
-        : "";
-      input.output.output += `\n\n[Project README: ${readmePath}]\n${result}${truncationNotice}`;
-      cache.add(readmeDir);
-      dirty = true;
-    } catch {}
-  }
-
-  if (dirty) {
-    saveInjectedPaths(input.sessionID, cache);
-  }
-}

package/src/hooks/directory-readme-injector/storage.ts

@@ -1,8 +0,0 @@
-import { README_INJECTOR_STORAGE } from "./constants";
-import { createInjectedPathsStorage } from "../../shared/session-injected-paths";
-
-export const {
-  loadInjectedPaths,
-  saveInjectedPaths,
-  clearInjectedPaths,
-} = createInjectedPathsStorage(README_INJECTOR_STORAGE);

package/src/hooks/edit-error-recovery/hook.ts

@@ -1,58 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin"
-
-/**
- * Known Edit tool error patterns that indicate the AI made a mistake
- */
-export const EDIT_ERROR_PATTERNS = [
-  "oldString and newString must be different",
-  "oldString not found",
-  "oldString found multiple times",
-] as const
-
-/**
- * System reminder injected when Edit tool fails due to AI mistake
- * Short, direct, and commanding - forces immediate corrective action
- */
-export const EDIT_ERROR_REMINDER = `
-[EDIT ERROR - IMMEDIATE ACTION REQUIRED]
-
-You made an Edit mistake. STOP and do this NOW:
-
-1. READ the file immediately to see its ACTUAL current state
-2. VERIFY what the content really looks like (your assumption was wrong)
-3. APOLOGIZE briefly to the user for the error
-4. CONTINUE with corrected action based on the real file content
-
-DO NOT attempt another edit until you've read and verified the file state.
-`
-
-/**
- * Detects Edit tool errors caused by AI mistakes and injects a recovery reminder
- *
- * This hook catches common Edit tool failures:
- * - oldString and newString must be different (trying to "edit" to same content)
- * - oldString not found (wrong assumption about file content)
- * - oldString found multiple times (ambiguous match, need more context)
- *
- * @see https://github.com/sst/opencode/issues/4718
- */
-export function createEditErrorRecoveryHook(_ctx: PluginInput) {
-  return {
-    "tool.execute.after": async (
-      input: { tool: string; sessionID: string; callID: string },
-      output: { title: string; output: string; metadata: unknown }
-    ) => {
-      if (input.tool.toLowerCase() !== "edit") return
-      if (typeof output.output !== "string") return
-
-      const outputLower = (output.output ?? "").toLowerCase()
-      const hasEditError = EDIT_ERROR_PATTERNS.some((pattern) =>
-        outputLower.includes(pattern.toLowerCase())
-      )
-
-      if (hasEditError) {
-        output.output += `\n${EDIT_ERROR_REMINDER}`
-      }
-    },
-  }
-}

package/src/hooks/edit-error-recovery/index.ts

@@ -1,5 +0,0 @@
-export {
-  createEditErrorRecoveryHook,
-  EDIT_ERROR_PATTERNS,
-  EDIT_ERROR_REMINDER,
-} from "./hook";

package/src/hooks/empty-task-response-detector.ts

@@ -1,27 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin"
-
-const EMPTY_RESPONSE_WARNING = `[Task Empty Response Warning]
-
-Task invocation completed but returned no response. This indicates the agent either:
-- Failed to execute properly
-- Did not terminate correctly
-- Returned an empty result
-
-Note: The call has already completed - you are NOT waiting for a response. Proceed accordingly.`
-
-export function createEmptyTaskResponseDetectorHook(_ctx: PluginInput) {
-  return {
-    "tool.execute.after": async (
-      input: { tool: string; sessionID: string; callID: string },
-      output: { title: string; output: string; metadata: unknown }
-    ) => {
-      if (input.tool !== "Task" && input.tool !== "task") return
-
-      const responseText = output.output?.trim() ?? ""
-
-      if (responseText === "") {
-        output.output = EMPTY_RESPONSE_WARNING
-      }
-    },
-  }
-}

package/src/hooks/fast-apply/hook.ts

@@ -1,11 +0,0 @@
-import type { Hooks, PluginInput } from "@opencode-ai/plugin"
-import type { FastApplyConfig } from "../../config"
-import { handleFastApplyToolExecuteBefore } from "./tool-execute-before-handler"
-
-export function createFastApplyHook(config: FastApplyConfig): Hooks {
-  return {
-    "tool.execute.before": async (input, output) => {
-      await handleFastApplyToolExecuteBefore({ input, output, config })
-    },
-  }
-}

package/src/hooks/fast-apply/index.ts

@@ -1 +0,0 @@
-export { createFastApplyHook } from "./hook"