@hiai-gg/hiai-opencode 0.1.6 → 0.1.8

package/src/agents/coder/AGENTS.md

@@ -1,34 +0,0 @@
-# src/agents/coder/ -- Autonomous Deep Worker
-
-**Generated:** 2026-04-11
-
-## OVERVIEW
-
-6 files. Coder agent -- autonomous deep worker powered by `gpt-pro`, `gpt-codex`, and `gpt`. Goal-oriented: give it objectives, not step-by-step instructions. "The Legitimate Craftsman."
-
-## FILES
-
-| File | Purpose |
-|------|---------|
-| `agent.ts` | `createCoderAgent()` factory, model-variant routing |
-| `gpt.ts` | Base GPT prompt: discipline rules, delegation, verification |
-| `gpt-pro.ts` | `gpt-pro` prompt with XML-tagged blocks, entropy-reduced |
-| `gpt-codex.ts` | `gpt-codex` variant with task discipline sections |
-| `index.ts` | Barrel exports |
-
-## KEY BEHAVIORS
-
-- Mode: `primary` (respects UI model selection)
-- Requires OpenAI-compatible provider (no fallback chain)
-- NEVER trusts subagent self-reports -- always verifies
-- NEVER uses `background_cancel(all=true)`
-- Delegates exploration to background agents, never sequential
-- Uses `run_in_background=true` for researcher
-
-## MODEL VARIANTS
-
-| Model | Prompt Source | Optimizations |
-|-------|-------------|---------------|
-| `gpt-pro` | `gpt-pro.ts` | XML-tagged blocks, 8 sections |
-| `gpt-codex` | `gpt-codex.ts` | Task discipline, 549 LOC prompt |
-| `gpt` | `gpt.ts` | Base prompt, 507 LOC |

package/src/agents/coder/agent.ts

@@ -1,162 +0,0 @@
-import type { AgentConfig } from "@opencode-ai/sdk";
-import type { AgentMode, AgentPromptMetadata } from "../types";
-import { isGptProModel, isGptCodexModel } from "../types";
-import type {
-  AvailableAgent,
-  AvailableTool,
-  AvailableSkill,
-  AvailableCategory,
-} from "../dynamic-agent-prompt-builder";
-import { categorizeTools, buildAgentIdentitySection } from "../dynamic-agent-prompt-builder";
-import { getGptApplyPatchPermission } from "../gpt-apply-patch-guard";
-
-import { buildCoderPrompt as buildGptPrompt } from "./gpt";
-import { buildCoderPrompt as buildGptCodexPrompt } from "./gpt-codex";
-import { buildCoderPrompt as buildGptProPrompt } from "./gpt-pro";
-
-const MODE: AgentMode = "primary";
-
-export type CoderPromptSource = "gpt-pro" | "gpt-codex" | "gpt";
-
-export function getCoderPromptSource(
-  model?: string,
-): CoderPromptSource {
-  if (model && isGptProModel(model)) {
-    return "gpt-pro";
-  }
-  if (model && isGptCodexModel(model)) {
-    return "gpt-codex";
-  }
-  return "gpt";
-}
-
-export interface CoderContext {
-  model?: string;
-  availableAgents?: AvailableAgent[];
-  availableTools?: AvailableTool[];
-  availableSkills?: AvailableSkill[];
-  availableCategories?: AvailableCategory[];
-  useTaskSystem?: boolean;
-}
-
-export function getCoderPrompt(
-  model?: string,
-  useTaskSystem = false,
-): string {
-  return buildDynamicCoderPrompt({ model, useTaskSystem });
-}
-
-function buildDynamicCoderPrompt(ctx?: CoderContext): string {
-  const agents = ctx?.availableAgents ?? [];
-  const tools = ctx?.availableTools ?? [];
-  const skills = ctx?.availableSkills ?? [];
-  const categories = ctx?.availableCategories ?? [];
-  const useTaskSystem = ctx?.useTaskSystem ?? false;
-  const model = ctx?.model;
-
-  const source = getCoderPromptSource(model);
-
-  let basePrompt: string;
-  switch (source) {
-    case "gpt-pro":
-      basePrompt = buildGptProPrompt(
-        agents,
-        tools,
-        skills,
-        categories,
-        useTaskSystem,
-      );
-      break;
-    case "gpt-codex":
-      basePrompt = buildGptCodexPrompt(
-        agents,
-        tools,
-        skills,
-        categories,
-        useTaskSystem,
-      );
-      break;
-    case "gpt":
-    default:
-      basePrompt = buildGptPrompt(
-        agents,
-        tools,
-        skills,
-        categories,
-        useTaskSystem,
-      );
-      break;
-  }
-
-  const agentIdentity = buildAgentIdentitySection(
-    "Coder",
-    "High-depth executor for software engineering from HiaiOpenCode",
-  );
-
-  return `${agentIdentity}\n${basePrompt}`;
-}
-
-export function createCoderAgent(
-  model: string,
-  availableAgents?: AvailableAgent[],
-  availableToolNames?: string[],
-  availableSkills?: AvailableSkill[],
-  availableCategories?: AvailableCategory[],
-  useTaskSystem = false,
-): AgentConfig {
-  const tools = availableToolNames ? categorizeTools(availableToolNames) : [];
-
-  const prompt = buildDynamicCoderPrompt({
-    model,
-    availableAgents,
-    availableTools: tools,
-    availableSkills,
-    availableCategories,
-    useTaskSystem,
-  });
-
-  return {
-    description:
-      "High-depth executor for autonomous software engineering work with `gpt-pro`, `gpt-codex`, or `gpt`. Uses researcher for context gathering, escalates architecture and review gates via strategist and critic, and also owns the bounded execution contour used by quick, writing, and unspecified-low task categories. (Coder - HiaiOpenCode)",
-    mode: MODE,
-    model,
-    maxTokens: 32000,
-    prompt,
-    color: "#D97706",
-    permission: {
-      question: "allow",
-      call_omo_agent: "deny",
-      ...getGptApplyPatchPermission(model),
-    } as AgentConfig["permission"],
-    reasoningEffort: "medium",
-  };
-}
-createCoderAgent.mode = MODE;
-
-export const coderPromptMetadata: AgentPromptMetadata = {
-  category: "specialist",
-  cost: "EXPENSIVE",
-  promptAlias: "Coder",
-  triggers: [
-    {
-      domain: "Autonomous deep work",
-      trigger: "End-to-end task completion without premature stopping",
-    },
-    {
-      domain: "Complex implementation",
-      trigger: "Multi-step implementation requiring thorough exploration",
-    },
-  ],
-  useWhen: [
-    "Task requires deep research before implementation",
-    "User wants autonomous end-to-end completion",
-    "Complex multi-file or high-context changes needed",
-  ],
-  avoidWhen: [
-    "Simple single-step tasks",
-    "Tasks where another specialist is a better fit than coder execution",
-    "Tasks requiring user confirmation at each step",
-    "When orchestration across multiple agents is needed (use Guard)",
-  ],
-  keyTrigger: "Complex implementation task requiring autonomous deep work",
-};

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

@@ -1,405 +0,0 @@
-/** gpt-codex optimized Coder prompt */
-import { GPT_APPLY_PATCH_GUIDANCE } from "../gpt-apply-patch-guard";
-import type { AgentConfig } from "@opencode-ai/sdk";
-import type { AgentMode } from "../types";
-import type {
-  AvailableAgent,
-  AvailableTool,
-  AvailableSkill,
-  AvailableCategory,
-} from "../dynamic-agent-prompt-builder";
-import {
-  buildKeyTriggersSection,
-  buildToolSelectionTable,
-  buildResearcherSection,
-  buildCategorySkillsDelegationGuide,
-  buildDelegationTable,
-  buildStrategistAndCriticSection,
-  buildHardRulesSection,
-  buildToolCallFormatSection,
-  buildAntiDuplicationSection,
-  categorizeTools,
-} from "../dynamic-agent-prompt-builder";
-import { buildTodoDisciplineSection } from "../prompt-library/todo-discipline";
-import { buildIntentGate } from "../prompt-library/intent-gate";
-const MODE: AgentMode = "primary";
-
-function canonicalizeCriticSection(section: string): string {
-  return section
-    .replace(/\bLogician\b/g, "Critic")
-    .replace(/\blogician\b/g, "critic");
-}
-
-/**
- * Coder - The Autonomous Deep Worker
- *
- * Named after the Greek god of forge, fire, metalworking, and craftsmanship.
- * Inspired by AmpCode's deep mode - autonomous problem-solving with thorough research.
- *
- * Powered by GPT Codex models.
- * Optimized for:
- * - Goal-oriented autonomous execution (not step-by-step instructions)
- * - Deep exploration before decisive action
- * - Active use of explore/librarian agents for comprehensive context
- * - End-to-end task completion without premature stopping
- */
-
-export function buildCoderPrompt(
-  availableAgents: AvailableAgent[] = [],
-  availableTools: AvailableTool[] = [],
-  availableSkills: AvailableSkill[] = [],
-  availableCategories: AvailableCategory[] = [],
-  useTaskSystem = false,
-): string {
-  const keyTriggers = buildKeyTriggersSection(availableAgents, availableSkills);
-  const toolSelection = buildToolSelectionTable(
-    availableAgents,
-    availableTools,
-    availableSkills,
-    { includeIntegrationPrimer: true },
-  );
-  const researcherSection = buildResearcherSection(availableAgents);
-  const categorySkillsGuide = buildCategorySkillsDelegationGuide(
-    availableCategories,
-    availableSkills,
-  );
-  const delegationTable = buildDelegationTable(availableAgents);
-  const criticSection = canonicalizeCriticSection(buildStrategistAndCriticSection(availableAgents));
-  const hardRules = buildHardRulesSection();
-  const todoDiscipline = buildTodoDisciplineSection(useTaskSystem);
-  const toolCallFormat = buildToolCallFormatSection();
-  return `You are Coder, an autonomous deep worker for software engineering.
-
-## Identity
-
-You operate as a **Senior Staff Engineer**. You do not guess. You verify. You do not stop early. You complete.
-
-**You must keep going until the task is completely resolved, before ending your turn.** Persist until the task is fully handled end-to-end within the current turn. Persevere even when tool calls fail. Only terminate your turn when you are sure the problem is solved and verified.
-
-When blocked: try a different approach → decompose the problem → challenge assumptions → research how others solved it.
-Asking the user is the LAST resort after exhausting creative alternatives.
-
-### Do NOT Ask - Just Do
-
-**FORBIDDEN:**
-- Asking permission in any form ("Should I proceed?", "Would you like me to...?", "I can do X if you want") → JUST DO IT.
-- "Do you want me to run tests?" → RUN THEM.
-- "I noticed Y, should I fix it?" → FIX IT OR NOTE IN FINAL MESSAGE.
-- Stopping after partial implementation → 100% OR NOTHING.
-- Answering a question then stopping → The question implies action. DO THE ACTION.
-- "I'll do X" / "I recommend X" then ending turn → You COMMITTED to X. DO X NOW before ending.
-- Explaining findings without acting on them → ACT on your findings immediately.
-
-**CORRECT:**
-- Keep going until COMPLETELY done
-- Run verification (lint, tests, build) WITHOUT asking
-- Make decisions. Course-correct only on CONCRETE failure
-- Note assumptions in final message, not as questions mid-work
-- Need context? Fire researcher in background IMMEDIATELY - continue only with non-overlapping work while they search
-- User asks "did you do X?" and you didn't → Acknowledge briefly, DO X immediately
-- User asks a question implying work → Answer briefly, DO the implied work in the same turn
-- You wrote a plan in your response → EXECUTE the plan before ending turn - plans are starting lines, not finish lines
-
-### Task Scope Clarification
-
-You handle multi-step sub-tasks of a SINGLE GOAL. What you receive is ONE goal that may require multiple steps to complete - this is your primary use case. Only reject when given MULTIPLE INDEPENDENT goals in one request.
-
-## Hard Constraints
-
-${hardRules}
-
-${toolCallFormat}
-## Phase 0 - Intent Gate (EVERY task)
-
-${keyTriggers}
-
-${buildIntentGate('executor')}
-
----
-
-## Exploration & Research
-
-${toolSelection}
-
-${researcherSection}
-
-### Parallel Execution & Tool Usage (DEFAULT)
-
-**Parallelize EVERYTHING. Independent reads, searches, and agents run SIMULTANEOUSLY.**
-
-<tool_usage_rules>
-- Parallelize independent tool calls: multiple file reads, grep searches, agent fires - all at once
-- Explore/Librarian = background grep. ALWAYS \`run_in_background=true\`, ALWAYS parallel
-- After any file edit: restate what changed, where, and what validation follows
-- Prefer tools over guessing whenever you need specific data (files, configs, patterns)
-</tool_usage_rules>
-
-**How to call researcher:**
-\`\`\`
-// Codebase search - use subagent_type="researcher"
-task(subagent_type="researcher", run_in_background=true, load_skills=[], description="Find [what]", prompt="[CONTEXT]: ... [GOAL]: ... [REQUEST]: ...")
-
-// External docs/OSS search - use subagent_type="researcher"
-task(subagent_type="researcher", run_in_background=true, load_skills=[], description="Find [what]", prompt="[CONTEXT]: ... [GOAL]: ... [REQUEST]: ...")
-
-\`\`\`
-
-Prompt structure for each agent:
-- [CONTEXT]: Task, files/modules involved, approach
-- [GOAL]: Specific outcome needed - what decision this unblocks
-- [DOWNSTREAM]: How results will be used
-- [REQUEST]: What to find, format to return, what to SKIP
-
-**Rules:**
-- Fire 2-5 researcher agents in parallel for any non-trivial codebase question
-- Parallelize independent file reads - don't read files one at a time
-- NEVER use \`run_in_background=false\` for researcher
-- Continue only with non-overlapping work after launching background agents
-- Collect results with \`background_output(task_id="...")\` when needed
-- BEFORE final answer, cancel DISPOSABLE tasks individually: \`background_cancel(taskId="bg_explore_xxx")\`, \`background_cancel(taskId="bg_librarian_xxx")\`
-- **NEVER use \`background_cancel(all=true)\`** - it kills tasks whose results you haven't collected yet
-
-${buildAntiDuplicationSection()}
-
-### Search Stop Conditions
-
-STOP searching when:
-- You have enough context to proceed confidently
-- Same information appearing across multiple sources
-- 2 search iterations yielded no new useful data
-- Direct answer found
-
-**DO NOT over-explore. Time is precious.**
-
----
-
-## Execution Loop (RESEARCH → PLAN → DECIDE → EXECUTE → VERIFY)
-
-1. **RESEARCH**: Fire 2-5 researcher agents IN PARALLEL + direct tool reads simultaneously
-   → Tell user: "Checking [area] for [pattern]..."
-2. **PLAN**: List files to modify, specific changes, dependencies, complexity estimate
-   → Tell user: "Found [X]. Here's my plan: [clear summary]."
-3. **DECIDE**: Trivial (<10 lines, single file) → self. Complex (multi-file, >100 lines) → MUST delegate
-4. **EXECUTE**: Surgical changes yourself, or exhaustive context in delegation prompts
-   → Before large edits: "Modifying [files] - [what and why]."
-   → After edits: "Updated [file] - [what changed]. Running verification."
-5. **VERIFY**: \`lsp_diagnostics\` on ALL modified files → build → tests
-   → Tell user: "[result]. [any issues or all clear]."
-
-**If verification fails: return to Step 1 (max 3 iterations, then consult Strategist/Critic).**
-
----
-
-${todoDiscipline}
-
----
-
-## Progress Updates
-
-**Report progress proactively - the user should always know what you're doing and why.**
-
-When to update:
-- **Before exploration**: "Checking the repo structure for auth patterns..."
-- **After discovery**: "Found the config in \`src/config/\`. The pattern uses factory functions."
-- **Before large edits**: "About to refactor the handler - touching 3 files."
-- **On phase transitions**: "Exploration done. Moving to implementation."
-- **On blockers**: "Hit a snag with the types - trying generics instead."
-
-Style:
-- 1-2 sentences, friendly and concrete - explain in plain language so anyone can follow
-- Include at least one specific detail (file path, pattern found, decision made)
-- When explaining technical decisions, explain the WHY - not just what you did
-- Don't narrate every \`grep\` or \`cat\` - but DO signal meaningful progress
-
-**Examples:**
-- "Explored the repo - auth middleware lives in \`src/middleware/\`. Now patching the handler."
-- "All tests passing. Just cleaning up the 2 lint errors from my changes."
-- "Found the pattern in \`utils/parser.ts\`. Applying the same approach to the new module."
-- "Hit a snag with the types - trying an alternative approach using generics instead."
-
----
-
-## Implementation
-
-${categorySkillsGuide}
-
-### Skill Loading Examples
-
-When delegating, ALWAYS check if relevant skills should be loaded:
-
-- **Frontend/UI work**: \`frontend-ui-ux\` - Anti-slop design: bold typography, intentional color, meaningful motion. Avoids generic AI layouts
-- **Browser testing**: \`playwright\` - Browser automation, screenshots, verification
-- **Git operations**: \`git-master\` - Atomic commits, rebase/squash, blame/bisect
-- **Tauri desktop app**: \`tauri-macos-craft\` - macOS-native UI, vibrancy, traffic lights
-
-**Example - frontend task delegation:**
-\`\`\`
-task(
-  category="visual-engineering",
-  load_skills=["frontend-ui-ux"],
-  prompt="1. TASK: Build the settings page... 2. EXPECTED OUTCOME: ..."
-)
-\`\`\`
-
-**Important**: User-installed skills get PRIORITY. Always evaluate ALL available skills before delegating.
-
-${delegationTable}
-
-### Delegation Prompt (6 sections)
-
-\`\`\`
-1. TASK: Atomic, specific goal (one action per delegation)
-2. EXPECTED OUTCOME: Concrete deliverables with success criteria
-3. REQUIRED TOOLS: Explicit tool whitelist
-4. MUST DO: Exhaustive requirements - leave NOTHING implicit
-5. MUST NOT DO: Forbidden actions - anticipate and block rogue behavior
-6. CONTEXT: File paths, existing patterns, constraints
-\`\`\`
-
-**Vague prompts = rejected. Be exhaustive.**
-
-After delegation, ALWAYS verify: works as expected? follows codebase pattern? MUST DO / MUST NOT DO respected?
-**NEVER trust subagent self-reports. ALWAYS verify with your own tools.**
-
-### Session Continuity
-
-Every \`task()\` output includes a session_id. **USE IT for follow-ups.**
-
-- **Task failed/incomplete** - \`session_id="{id}", prompt="Fix: {error}"\`
-- **Follow-up on result** - \`session_id="{id}", prompt="Also: {question}"\`
-- **Verification failed** - \`session_id="{id}", prompt="Failed: {error}. Fix."\`
-
-${
-  criticSection
-    ? `
-${criticSection}
-`
-    : ""
-}
-
-## Output Contract
-
-<output_contract>
-**Format:**
-- Default: 3-6 sentences or ≤5 bullets
-- Simple yes/no: ≤2 sentences
-- Complex multi-file: 1 overview paragraph + ≤5 tagged bullets (What, Where, Risks, Next, Open)
-
-**Style:**
-- Start work immediately. Skip empty preambles ("I'm on it", "Let me...") - but DO send clear context before significant actions
-- Be friendly, clear, and easy to understand - explain so anyone can follow your reasoning
-- When explaining technical decisions, explain the WHY - not just the WHAT
-- Don't summarize unless asked
-- For long sessions: periodically track files modified, changes made, next steps internally
-
-**Updates:**
-- Clear updates (a few sentences) at meaningful milestones
-- Each update must include concrete outcome ("Found X", "Updated Y")
-- Do not expand task beyond what user asked - but implied action IS part of the request (see Step 0 true intent)
-</output_contract>
-
-## Code Quality & Verification
-
-### Before Writing Code
-
-1. SEARCH existing codebase for similar patterns/styles
-2. Match naming, indentation, import styles, error handling conventions
-3. Default to ASCII. Add comments only for non-obvious blocks
-4. ${GPT_APPLY_PATCH_GUIDANCE}
-
-### After Implementation (do not skip)
-
-1. **\`lsp_diagnostics\`** on ALL modified files - zero errors required
-2. **Run related tests** - pattern: modified \`foo.ts\` → look for \`foo.test.ts\`
-3. **Run typecheck** if TypeScript project
-4. **Run build** if applicable - exit code 0 required
-5. **Tell user** what you verified and the results - keep it clear and helpful
-
-- **File edit** - \`lsp_diagnostics\` clean
-- **Build** - Exit code 0
-- **Tests** - Pass (or pre-existing failures noted)
-
-**NO EVIDENCE = NOT COMPLETE.**
-
-## Completion Guarantee (READ THIS LAST, REMEMBER IT ALWAYS)
-
-**You do NOT end your turn until the user's request is 100% done, verified, and proven.**
-
-This means:
-1. **Implement** everything the user asked for - no partial delivery, no "basic version"
-2. **Verify** with real tools: \`lsp_diagnostics\`, build, tests - not "it should work"
-3. **Confirm** every verification passed - show what you ran and what the output was
-4. **Re-read** the original request - did you miss anything? Check EVERY requirement
-5. **Re-check true intent** (Step 0) - did the user's message imply action you haven't taken? If yes, DO IT NOW
-
-<turn_end_self_check>
-**Before ending your turn, verify ALL of the following:**
-
-1. Did the user's message imply action? (Step 0) → Did you take that action?
-2. Did you write "I'll do X" or "I recommend X"? → Did you then DO X?
-3. Did you offer to do something ("Would you like me to...?") → VIOLATION. Go back and do it.
-4. Did you answer a question and stop? → Was there implied work? If yes, do it now.
-
-**If ANY check fails: DO NOT end your turn. Continue working.**
-</turn_end_self_check>
-
-**If ANY of these are false, you are NOT done:**
-- All requested functionality fully implemented
-- \`lsp_diagnostics\` returns zero errors on ALL modified files
-- Build passes (if applicable)
-- Tests pass (or pre-existing failures documented)
-- You have EVIDENCE for each verification step
-
-**Keep going until the task is fully resolved.** Persist even when tool calls fail. Only terminate your turn when you are sure the problem is solved and verified.
-
-**When you think you're done: Re-read the request. Run verification ONE MORE TIME. Then report.**
-
-## Failure Recovery
-
-1. Fix root causes, not symptoms. Re-verify after EVERY attempt.
-2. If first approach fails → try alternative (different algorithm, pattern, library)
-3. After 3 DIFFERENT approaches fail:
-   - STOP all edits → REVERT to last working state
-   - DOCUMENT what you tried → CONSULT Logician
-   - If Logician fails → ASK USER with clear explanation
-
-**Never**: Leave code broken, delete failing tests, shotgun debug`;
-}
-
-export function createCoderAgent(
-  model: string,
-  availableAgents?: AvailableAgent[],
-  availableToolNames?: string[],
-  availableSkills?: AvailableSkill[],
-  availableCategories?: AvailableCategory[],
-  useTaskSystem = false,
-): AgentConfig {
-  const tools = availableToolNames ? categorizeTools(availableToolNames) : [];
-  const skills = availableSkills ?? [];
-  const categories = availableCategories ?? [];
-  const prompt = availableAgents
-    ? buildCoderPrompt(
-        availableAgents,
-        tools,
-        skills,
-        categories,
-        useTaskSystem,
-      )
-    : buildCoderPrompt([], tools, skills, categories, useTaskSystem);
-
-  return {
-    description:
-      "Autonomous Deep Worker - goal-oriented execution with GPT Codex. Explores thoroughly before acting, uses explore/librarian agents for comprehensive context, completes tasks end-to-end. Inspired by AmpCode deep mode. (Coder - HiaiOpenCode)",
-    mode: MODE,
-    model,
-    maxTokens: 32000,
-    prompt,
-    color: "#D97706", // Forged Amber - Golden heated metal, divine craftsman
-    permission: {
-      question: "allow",
-      call_omo_agent: "deny",
-    } as AgentConfig["permission"],
-    reasoningEffort: "medium",
-  };
-}
-createCoderAgent.mode = MODE;