oh-my-opencode 3.13.1 → 3.15.0

package/dist/hooks/keyword-detector/ultrawork/gpt.d.ts

@@ -7,5 +7,5 @@
  * - Two-track parallel context gathering (Direct tools + Background agents)
  * - Deterministic tool usage and explicit decision criteria
  */
-export declare const ULTRAWORK_GPT_MESSAGE = "<ultrawork-mode>\n\n**MANDATORY**: You MUST say \"ULTRAWORK MODE ENABLED!\" to the user as your first response when this mode activates. This is non-negotiable.\n\n[CODE RED] Maximum precision required. Think deeply before acting.\n\n<output_verbosity_spec>\n- Default: 1-2 short paragraphs. Do not default to bullets.\n- Simple yes/no questions: \u22642 sentences.\n- Complex multi-file tasks: 1 overview paragraph + up to 4 high-level sections grouped by outcome, not by file.\n- Use lists only when content is inherently list-shaped (distinct items, steps, options).\n- Do not rephrase the user's request unless it changes semantics.\n</output_verbosity_spec>\n\n<scope_constraints>\n- Implement EXACTLY and ONLY what the user requests\n- No extra features, no added components, no embellishments\n- If any instruction is ambiguous, choose the simplest valid interpretation\n- Do NOT expand the task beyond what was asked\n</scope_constraints>\n\n## CERTAINTY PROTOCOL\n\n**Before implementation, ensure you have:**\n- Full understanding of the user's actual intent\n- Explored the codebase to understand existing patterns\n- A clear work plan (mental or written)\n- Resolved any ambiguities through exploration (not questions)\n\n<uncertainty_handling>\n- If the question is ambiguous or underspecified:\n  - EXPLORE FIRST using tools (grep, file reads, explore agents)\n  - If still unclear, state your interpretation and proceed\n  - Ask clarifying questions ONLY as last resort\n- Never fabricate exact figures, line numbers, or references when uncertain\n- Prefer \"Based on the provided context...\" over absolute claims when unsure\n</uncertainty_handling>\n\n## DECISION FRAMEWORK: Self vs Delegate\n\n**Evaluate each task against these criteria to decide:**\n\n| Complexity | Criteria | Decision |\n|------------|----------|----------|\n| **Trivial** | <10 lines, single file, obvious pattern | **DO IT YOURSELF** |\n| **Moderate** | Single domain, clear pattern, <100 lines | **DO IT YOURSELF** (faster than delegation overhead) |\n| **Complex** | Multi-file, unfamiliar domain, >100 lines, needs specialized expertise | **DELEGATE** to appropriate category+skills |\n| **Research** | Need broad codebase context or external docs | **DELEGATE** to explore/librarian (background, parallel) |\n\n**Decision Factors:**\n- Delegation overhead \u2248 10-15 seconds. If task takes less, do it yourself.\n- If you already have full context loaded, do it yourself.\n- If task requires specialized expertise (frontend-ui-ux, git operations), delegate.\n- If you need information from multiple sources, fire parallel background agents.\n\n## AVAILABLE RESOURCES\n\nUse these when they provide clear value based on the decision framework above:\n\n| Resource | When to Use | How to Use |\n|----------|-------------|------------|\n| explore agent | Need codebase patterns you don't have | `task(subagent_type=\"explore\", load_skills=[], run_in_background=true, ...)` |\n| librarian agent | External library docs, OSS examples | `task(subagent_type=\"librarian\", load_skills=[], run_in_background=true, ...)` |\n| oracle agent | Stuck on architecture/debugging after 2+ attempts | `task(subagent_type=\"oracle\", load_skills=[], ...)` |\n| plan agent | Complex multi-step with dependencies (5+ steps) | `task(subagent_type=\"plan\", load_skills=[], ...)` |\n| task category | Specialized work matching a category | `task(category=\"...\", load_skills=[...])` |\n\n<tool_usage_rules>\n- Prefer tools over internal knowledge for fresh or user-specific data\n- Parallelize independent reads (read_file, grep, explore, librarian) to reduce latency\n- After any write/update, briefly restate: What changed, Where (path), Follow-up needed\n</tool_usage_rules>\n\n## EXECUTION PATTERN\n\n**Context gathering uses TWO parallel tracks:**\n\n| Track | Tools | Speed | Purpose |\n|-------|-------|-------|---------|\n| **Direct** | Grep, Read, LSP, AST-grep | Instant | Quick wins, known locations |\n| **Background** | explore, librarian agents | Async | Deep search, external docs |\n\n**ALWAYS run both tracks in parallel:**\n```\n// Fire background agents for deep exploration\ntask(subagent_type=\"explore\", load_skills=[], prompt=\"I'm implementing [TASK] and need to understand [KNOWLEDGE GAP]. Find [X] patterns in the codebase \u2014 file paths, implementation approach, conventions used, and how modules connect. I'll use this to [DOWNSTREAM DECISION]. Focus on production code in src/. Return file paths with brief descriptions.\", run_in_background=true)\ntask(subagent_type=\"librarian\", load_skills=[], prompt=\"I'm working with [TECHNOLOGY] and need [SPECIFIC INFO]. Find official docs and production examples for [Y] \u2014 API reference, configuration, recommended patterns, and pitfalls. Skip tutorials. I'll use this to [DECISION THIS INFORMS].\", run_in_background=true)\n\n// WHILE THEY RUN - use direct tools for immediate context\ngrep(pattern=\"relevant_pattern\", path=\"src/\")\nread_file(filePath=\"known/important/file.ts\")\n\n// Collect background results when ready\ndeep_context = background_output(task_id=...)\n\n// Merge ALL findings for comprehensive understanding\n```\n\n**Plan agent (complex tasks only):**\n- Only if 5+ interdependent steps\n- Invoke AFTER gathering context from both tracks\n\n**Execute:**\n- Surgical, minimal changes matching existing patterns\n- If delegating: provide exhaustive context and success criteria\n\n**Verify:**\n- `lsp_diagnostics` on modified files\n- Run tests if available\n\n## ACCEPTANCE CRITERIA WORKFLOW\n\n**BEFORE implementation**, define what \"done\" means in concrete, binary terms:\n\n1. Write acceptance criteria as pass/fail conditions (not \"should work\" \u2014 specific observable outcomes)\n2. Record them in your TODO/Task items with a \"QA: [how to verify]\" field\n3. Work toward those criteria, not just \"finishing code\"\n\n## QUALITY STANDARDS\n\n| Phase | Action | Required Evidence |\n|-------|--------|-------------------|\n| Build | Run build command | Exit code 0 |\n| Test | Execute test suite | All tests pass |\n| Lint | Run lsp_diagnostics | Zero new errors |\n| **Manual QA** | **Execute the feature yourself** | **Actual output shown** |\n\n<MANUAL_QA_MANDATE>\n### MANUAL QA IS MANDATORY. lsp_diagnostics IS NOT ENOUGH.\n\nlsp_diagnostics catches type errors. It does NOT catch logic bugs, missing behavior, or broken features. After EVERY implementation, you MUST manually test the actual feature.\n\n**Execute ALL that apply:**\n\n| If your change... | YOU MUST... |\n|---|---|\n| Adds/modifies a CLI command | Run the command with Bash. Show the output. |\n| Changes build output | Run the build. Verify output files. |\n| Modifies API behavior | Call the endpoint. Show the response. |\n| Adds a new tool/hook/feature | Test it end-to-end in a real scenario. |\n| Modifies config handling | Load the config. Verify it parses correctly. |\n\n**\"This should work\" is NOT evidence. RUN IT. Show what happened. That is evidence.**\n</MANUAL_QA_MANDATE>\n\n## COMPLETION CRITERIA\n\nA task is complete when:\n1. Requested functionality is fully implemented (not partial, not simplified)\n2. lsp_diagnostics shows zero errors on modified files\n3. Tests pass (or pre-existing failures documented)\n4. Code matches existing codebase patterns\n5. **Manual QA executed \u2014 actual feature tested, output observed and reported**\n\n**Deliver exactly what was asked. No more, no less.**\n\n</ultrawork-mode>\n\n---\n\n";
+export declare const ULTRAWORK_GPT_MESSAGE = "<ultrawork-mode>\n\n**MANDATORY**: You MUST say \"ULTRAWORK MODE ENABLED!\" to the user as your first response when this mode activates. This is non-negotiable.\n\n[CODE RED] Maximum precision required. Think deeply before acting.\n\n<output_verbosity_spec>\n- Default: 1-2 short paragraphs. Do not default to bullets.\n- Simple yes/no questions: \u22642 sentences.\n- Complex multi-file tasks: 1 overview paragraph + up to 4 high-level sections grouped by outcome, not by file.\n- Use lists only when content is inherently list-shaped (distinct items, steps, options).\n- Do not rephrase the user's request unless it changes semantics.\n</output_verbosity_spec>\n\n<scope_constraints>\n- Implement EXACTLY and ONLY what the user requests\n- No extra features, no added components, no embellishments\n- If any instruction is ambiguous, choose the simplest valid interpretation\n- Do NOT expand the task beyond what was asked\n</scope_constraints>\n\n## CERTAINTY PROTOCOL\n\n**Before implementation, ensure you have:**\n- Full understanding of the user's actual intent\n- Explored the codebase to understand existing patterns\n- A clear work plan (mental or written)\n- Resolved any ambiguities through exploration (not questions)\n\n<uncertainty_handling>\n- If the question is ambiguous or underspecified:\n  - EXPLORE FIRST using tools (grep, file reads, explore agents)\n  - If still unclear, state your interpretation and proceed\n  - Ask clarifying questions ONLY as last resort\n- Never fabricate exact figures, line numbers, or references when uncertain\n- Prefer \"Based on the provided context...\" over absolute claims when unsure\n</uncertainty_handling>\n\n## DECISION FRAMEWORK: Self vs Delegate\n\n**Evaluate each task against these criteria to decide:**\n\n| Complexity | Criteria | Decision |\n|------------|----------|----------|\n| **Trivial** | <10 lines, single file, obvious pattern | **DO IT YOURSELF** |\n| **Moderate** | Single domain, clear pattern, <100 lines | **DO IT YOURSELF** (faster than delegation overhead) |\n| **Complex** | Multi-file, unfamiliar domain, >100 lines, needs specialized expertise | **DELEGATE** to appropriate category+skills |\n| **Research** | Need broad codebase context or external docs | **DELEGATE** to explore/librarian (background, parallel) |\n\n**Decision Factors:**\n- Delegation overhead \u2248 10-15 seconds. If task takes less, do it yourself.\n- If you already have full context loaded, do it yourself.\n- If task requires specialized expertise (frontend-ui-ux, git operations), delegate.\n- If you need information from multiple sources, fire parallel background agents.\n\n## AVAILABLE RESOURCES\n\nUse these when they provide clear value based on the decision framework above:\n\n| Resource | When to Use | How to Use |\n|----------|-------------|------------|\n| explore agent | Need codebase patterns you don't have | `task(subagent_type=\"explore\", load_skills=[], run_in_background=true, ...)` |\n| librarian agent | External library docs, OSS examples | `task(subagent_type=\"librarian\", load_skills=[], run_in_background=true, ...)` |\n| oracle agent | Stuck on architecture/debugging after 2+ attempts | `task(subagent_type=\"oracle\", load_skills=[], ...)` |\n| plan agent | Complex multi-step with dependencies (5+ steps) | `task(subagent_type=\"plan\", load_skills=[], ...)` |\n| task category | Specialized work matching a category | `task(category=\"...\", load_skills=[...])` |\n\n<tool_usage_rules>\n- Prefer tools over internal knowledge for fresh or user-specific data\n- Parallelize independent reads (read_file, grep, explore, librarian) to reduce latency\n- After any write/update, briefly restate: What changed, Where (path), Follow-up needed\n</tool_usage_rules>\n\n## EXECUTION PATTERN\n\n**Context gathering uses TWO parallel tracks:**\n\n| Track | Tools | Speed | Purpose |\n|-------|-------|-------|---------|\n| **Direct** | Grep, Read, LSP, AST-grep | Instant | Quick wins, known locations |\n| **Background** | explore, librarian agents | Async | Deep search, external docs |\n\n**ALWAYS run both tracks in parallel:**\n```\n// Fire background agents for deep exploration\ntask(subagent_type=\"explore\", load_skills=[], prompt=\"I'm implementing [TASK] and need to understand [KNOWLEDGE GAP]. Find [X] patterns in the codebase - file paths, implementation approach, conventions used, and how modules connect. I'll use this to [DOWNSTREAM DECISION]. Focus on production code in src/. Return file paths with brief descriptions.\", run_in_background=true)\ntask(subagent_type=\"librarian\", load_skills=[], prompt=\"I'm working with [TECHNOLOGY] and need [SPECIFIC INFO]. Find official docs and production examples for [Y] - API reference, configuration, recommended patterns, and pitfalls. Skip tutorials. I'll use this to [DECISION THIS INFORMS].\", run_in_background=true)\n\n// WHILE THEY RUN - use direct tools for immediate context\ngrep(pattern=\"relevant_pattern\", path=\"src/\")\nread_file(filePath=\"known/important/file.ts\")\n\n// Collect background results when ready\ndeep_context = background_output(task_id=...)\n\n// Merge ALL findings for comprehensive understanding\n```\n\n**Plan agent (complex tasks only):**\n- Only if 5+ interdependent steps\n- Invoke AFTER gathering context from both tracks\n\n**Execute:**\n- Surgical, minimal changes matching existing patterns\n- If delegating: provide exhaustive context and success criteria\n\n**Verify:**\n- `lsp_diagnostics` on modified files\n- Run tests if available\n\n## ACCEPTANCE CRITERIA WORKFLOW\n\n**BEFORE implementation**, define what \"done\" means in concrete, binary terms:\n\n1. Write acceptance criteria as pass/fail conditions (not \"should work\" - specific observable outcomes)\n2. Record them in your TODO/Task items with a \"QA: [how to verify]\" field\n3. Work toward those criteria, not just \"finishing code\"\n\n## QUALITY STANDARDS\n\n| Phase | Action | Required Evidence |\n|-------|--------|-------------------|\n| Build | Run build command | Exit code 0 |\n| Test | Execute test suite | All tests pass |\n| Lint | Run lsp_diagnostics | Zero new errors |\n| **Manual QA** | **Execute the feature yourself** | **Actual output shown** |\n\n<MANUAL_QA_MANDATE>\n### MANUAL QA IS MANDATORY. lsp_diagnostics IS NOT ENOUGH.\n\nlsp_diagnostics catches type errors. It does NOT catch logic bugs, missing behavior, or broken features. After EVERY implementation, you MUST manually test the actual feature.\n\n**Execute ALL that apply:**\n\n| If your change... | YOU MUST... |\n|---|---|\n| Adds/modifies a CLI command | Run the command with Bash. Show the output. |\n| Changes build output | Run the build. Verify output files. |\n| Modifies API behavior | Call the endpoint. Show the response. |\n| Adds a new tool/hook/feature | Test it end-to-end in a real scenario. |\n| Modifies config handling | Load the config. Verify it parses correctly. |\n\n**\"This should work\" is NOT evidence. RUN IT. Show what happened. That is evidence.**\n</MANUAL_QA_MANDATE>\n\n## COMPLETION CRITERIA\n\nA task is complete when:\n1. Requested functionality is fully implemented (not partial, not simplified)\n2. lsp_diagnostics shows zero errors on modified files\n3. Tests pass (or pre-existing failures documented)\n4. Code matches existing codebase patterns\n5. **Manual QA executed - actual feature tested, output observed and reported**\n\n**Deliver exactly what was asked. No more, no less.**\n\n</ultrawork-mode>\n\n";
 export declare function getGptUltraworkMessage(): string;

package/dist/hooks/legacy-plugin-toast/auto-migrate-runner.d.ts

@@ -0,0 +1,2 @@
+export { autoMigrateLegacyPluginEntry } from "./auto-migrate";
+export type { MigrationResult } from "./auto-migrate";

package/dist/hooks/legacy-plugin-toast/auto-migrate.d.ts

@@ -0,0 +1,7 @@
+export interface MigrationResult {
+    migrated: boolean;
+    from: string | null;
+    to: string | null;
+    configPath: string | null;
+}
+export declare function autoMigrateLegacyPluginEntry(overrideConfigDir?: string): MigrationResult;

package/dist/hooks/legacy-plugin-toast/hook.d.ts

@@ -0,0 +1,18 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { checkForLegacyPluginEntry } from "../../shared/legacy-plugin-warning";
+import { log } from "../../shared/logger";
+import { autoMigrateLegacyPluginEntry } from "./auto-migrate-runner";
+type LegacyPluginToastDeps = {
+    checkForLegacyPluginEntry?: typeof checkForLegacyPluginEntry;
+    log?: typeof log;
+    autoMigrateLegacyPluginEntry?: typeof autoMigrateLegacyPluginEntry;
+};
+export declare function createLegacyPluginToastHook(ctx: PluginInput, deps?: LegacyPluginToastDeps): {
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+};
+export {};

package/dist/hooks/legacy-plugin-toast/index.d.ts

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

package/dist/hooks/legacy-plugin-toast/plugin-entry-migrator.d.ts

@@ -0,0 +1 @@
+export { migrateLegacyPluginEntry } from "../../shared/migrate-legacy-plugin-entry";

package/dist/hooks/model-fallback/chat-message-fallback-handler.d.ts

@@ -0,0 +1,23 @@
+import type { ChatMessageHandlerOutput, ChatMessageInput } from "../../plugin/chat-message";
+export declare function applyFallbackToChatMessage(params: {
+    input: ChatMessageInput;
+    output: ChatMessageHandlerOutput;
+    fallback: {
+        providerID: string;
+        modelID: string;
+        variant?: string;
+    };
+    toast?: (input: {
+        title: string;
+        message: string;
+        variant?: "info" | "success" | "warning" | "error";
+        duration?: number;
+    }) => void | Promise<void>;
+    onApplied?: (input: {
+        sessionID: string;
+        providerID: string;
+        modelID: string;
+        variant?: string;
+    }) => void | Promise<void>;
+    lastToastKey: Map<string, string>;
+}): Promise<void>;

package/dist/hooks/model-fallback/hook.d.ts

@@ -57,4 +57,9 @@ export declare function createModelFallbackHook(args?: {
 }): {
     "chat.message": (input: ChatMessageInput, output: ChatMessageHandlerOutput) => Promise<void>;
 };
+/**
+ * Resets all module-global state for testing.
+ * Clears pending fallbacks, toast keys, and session chains.
+ */
+export declare function _resetForTesting(): void;
 export {};

package/dist/hooks/model-fallback/next-fallback.d.ts

@@ -0,0 +1,6 @@
+import type { ModelFallbackState } from "./hook";
+export declare function getNextReachableFallback(sessionID: string, state: ModelFallbackState): {
+    providerID: string;
+    modelID: string;
+    variant?: string;
+} | null;

package/dist/hooks/ralph-loop/completion-promise-detector-test-input.d.ts

@@ -0,0 +1,11 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export type SessionMessage = {
+    info?: {
+        role?: string;
+    };
+    parts?: Array<{
+        type: string;
+        text?: string;
+    }>;
+};
+export declare function createPluginInput(messages: SessionMessage[]): PluginInput;

package/dist/hooks/rules-injector/constants.d.ts

@@ -4,4 +4,5 @@ export declare const PROJECT_RULE_SUBDIRS: [string, string][];
 export declare const PROJECT_RULE_FILES: string[];
 export declare const GITHUB_INSTRUCTIONS_PATTERN: RegExp;
 export declare const USER_RULE_DIR = ".claude/rules";
+export declare const OPENCODE_USER_RULE_DIRS: string[];
 export declare const RULE_EXTENSIONS: string[];

package/dist/hooks/rules-injector/finder.d.ts

@@ -1,3 +1,3 @@
 export { findProjectRoot } from "./project-root-finder";
 export { calculateDistance } from "./rule-distance";
-export { findRuleFiles } from "./rule-file-finder";
+export { findRuleFiles, type FindRuleFilesOptions } from "./rule-file-finder";

package/dist/hooks/rules-injector/hook.d.ts

@@ -20,6 +20,8 @@ interface EventInput {
 }
 export declare function createRulesInjectorHook(ctx: PluginInput, modelCacheState?: {
     anthropicContext1MEnabled: boolean;
+}, options?: {
+    skipClaudeUserRules?: boolean;
 }): {
     "tool.execute.before": (input: ToolExecuteInput, output: ToolExecuteBeforeOutput) => Promise<void>;
     "tool.execute.after": (input: ToolExecuteInput, output: ToolExecuteOutput) => Promise<void>;

package/dist/hooks/rules-injector/injector.d.ts

@@ -1,3 +1,4 @@
+import type { FindRuleFilesOptions } from "./rule-file-finder";
 import type { SessionInjectedRulesCache } from "./cache";
 type ToolExecuteOutput = {
     title: string;
@@ -14,6 +15,7 @@ export declare function createRuleInjectionProcessor(deps: {
     workspaceDirectory: string;
     truncator: DynamicTruncator;
     getSessionCache: (sessionID: string) => SessionInjectedRulesCache;
+    ruleFinderOptions?: FindRuleFilesOptions;
 }): {
     processFilePathForInjection: (filePath: string, sessionID: string, output: ToolExecuteOutput) => Promise<void>;
 };

package/dist/hooks/rules-injector/rule-file-finder.d.ts

@@ -1,4 +1,12 @@
 import type { RuleFileCandidate } from "./types";
+export interface FindRuleFilesOptions {
+    /**
+     * When true, skip loading rules from ~/.claude/rules/.
+     * Use when claude_code integration is disabled to prevent
+     * Claude Code-specific instructions from leaking into non-Claude agents.
+     */
+    skipClaudeUserRules?: boolean;
+}
 /**
  * Find all rule files for a given context.
  * Searches from currentFile upward to projectRoot for rule directories,
@@ -12,4 +20,4 @@ import type { RuleFileCandidate } from "./types";
  * @param currentFile - Current file being edited (for distance calculation)
  * @returns Array of rule file candidates sorted by distance
  */
-export declare function findRuleFiles(projectRoot: string | null, homeDir: string, currentFile: string): RuleFileCandidate[];
+export declare function findRuleFiles(projectRoot: string | null, homeDir: string, currentFile: string, options?: FindRuleFilesOptions): RuleFileCandidate[];

package/dist/hooks/runtime-fallback/fallback-models.d.ts

@@ -1,2 +1,14 @@
 import type { OhMyOpenCodeConfig } from "../../config";
+import type { FallbackModelObject } from "../../config/schema/fallback-models";
+/**
+ * Returns fallback model strings for the runtime-fallback system.
+ * Object entries are flattened to "provider/model(variant)" strings so the
+ * string-based fallback state machine can work with them unchanged.
+ */
 export declare function getFallbackModelsForSession(sessionID: string, agent: string | undefined, pluginConfig: OhMyOpenCodeConfig | undefined): string[];
+/**
+ * Returns the raw fallback model entries (strings and objects) for a session.
+ * Use this when per-model settings (temperature, reasoningEffort, etc.) must be
+ * preserved - e.g. before passing to buildFallbackChainFromModels.
+ */
+export declare function getRawFallbackModels(sessionID: string, agent: string | undefined, pluginConfig: OhMyOpenCodeConfig | undefined): (string | FallbackModelObject)[] | undefined;

package/dist/hooks/runtime-fallback/retry-model-payload.d.ts

@@ -1,7 +1,11 @@
-export declare function buildRetryModelPayload(model: string): {
+export declare function buildRetryModelPayload(model: string, agentSettings?: {
+    variant?: string;
+    reasoningEffort?: string;
+}): {
     model: {
         providerID: string;
         modelID: string;
     };
     variant?: string;
+    reasoningEffort?: string;
 } | undefined;

package/dist/hooks/start-work/context-info-builder.d.ts

@@ -0,0 +1,12 @@
+import { readBoulderState } from "../../features/boulder-state";
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function buildStartWorkContextInfo(params: {
+    ctx: PluginInput;
+    explicitPlanName: string | null;
+    existingState: ReturnType<typeof readBoulderState>;
+    sessionId: string;
+    timestamp: string;
+    activeAgent: string;
+    worktreePath: string | undefined;
+    worktreeBlock: string;
+}): string;

package/dist/hooks/start-work/start-work-hook.d.ts

@@ -4,7 +4,13 @@ interface StartWorkHookInput {
     sessionID: string;
     messageID?: string;
 }
+interface StartWorkCommandExecuteBeforeInput {
+    sessionID: string;
+    command: string;
+    arguments: string;
+}
 interface StartWorkHookOutput {
+    message?: Record<string, unknown>;
     parts: Array<{
         type: string;
         text?: string;
@@ -12,5 +18,6 @@ interface StartWorkHookOutput {
 }
 export declare function createStartWorkHook(ctx: PluginInput): {
     "chat.message": (input: StartWorkHookInput, output: StartWorkHookOutput) => Promise<void>;
+    "command.execute.before": (input: StartWorkCommandExecuteBeforeInput, output: StartWorkHookOutput) => Promise<void>;
 };
 export {};

package/dist/hooks/start-work/worktree-block.d.ts

@@ -0,0 +1 @@
+export declare function createWorktreeActiveBlock(worktreePath: string): string;

package/dist/hooks/todo-continuation-enforcer/resolve-message-info.d.ts

@@ -1,3 +1,3 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-import type { ResolveLatestMessageInfoResult } from "./types";
-export declare function resolveLatestMessageInfo(ctx: PluginInput, sessionID: string): Promise<ResolveLatestMessageInfoResult>;
+import type { MessageWithInfo, ResolveLatestMessageInfoResult } from "./types";
+export declare function resolveLatestMessageInfo(ctx: PluginInput, sessionID: string, prefetchedMessages?: MessageWithInfo[]): Promise<ResolveLatestMessageInfoResult>;

package/dist/hooks/todo-continuation-enforcer/types.d.ts

@@ -27,6 +27,7 @@ export interface SessionState {
     countdownTimer?: ReturnType<typeof setTimeout>;
     countdownInterval?: ReturnType<typeof setInterval>;
     isRecovering?: boolean;
+    wasCancelled?: boolean;
     countdownStartedAt?: number;
     abortDetectedAt?: number;
     lastIncompleteCount?: number;
@@ -55,6 +56,9 @@ export interface MessageInfo {
     modelID?: string;
     tools?: Record<string, ToolPermission>;
 }
+export interface MessageWithInfo {
+    info?: MessageInfo;
+}
 export interface ResolvedMessageInfo {
     agent?: string;
     model?: {

package/dist/hooks/todo-description-override/description.d.ts

@@ -1 +1 @@
-export declare const TODOWRITE_DESCRIPTION = "Use this tool to create and manage a structured task list for tracking progress on multi-step work.\n\n## Todo Format (MANDATORY)\n\nEach todo title MUST encode four elements: WHERE, WHY, HOW, and EXPECTED RESULT.\n\nFormat: \"[WHERE] [HOW] to [WHY] \u2014 expect [RESULT]\"\n\nGOOD:\n- \"src/utils/validation.ts: Add validateEmail() for input sanitization \u2014 returns boolean\"\n- \"UserService.create(): Call validateEmail() before DB insert \u2014 rejects invalid emails with 400\"\n- \"validation.test.ts: Add test for missing @ sign \u2014 expect validateEmail('foo') to return false\"\n\nBAD:\n- \"Implement email validation\" (where? how? what result?)\n- \"Add dark mode\" (this is a feature, not a todo)\n- \"Fix auth\" (what file? what changes? what's expected?)\n\n## Granularity Rules\n\nEach todo MUST be a single atomic action completable in 1-3 tool calls. If it needs more, split it.\n\n**Size test**: Can you complete this todo by editing one file or running one command? If not, it's too big.\n\n## Task Management\n- One in_progress at a time. Complete it before starting the next.\n- Mark completed immediately after finishing each item.\n- Skip this tool for single trivial tasks (one-step, obvious action).";
+export declare const TODOWRITE_DESCRIPTION = "Use this tool to create and manage a structured task list for tracking progress on multi-step work.\n\n## Todo Format (MANDATORY)\n\nEach todo title MUST encode four elements: WHERE, WHY, HOW, and EXPECTED RESULT.\n\nFormat: \"[WHERE] [HOW] to [WHY] - expect [RESULT]\"\n\nGOOD:\n- \"src/utils/validation.ts: Add validateEmail() for input sanitization - returns boolean\"\n- \"UserService.create(): Call validateEmail() before DB insert - rejects invalid emails with 400\"\n- \"validation.test.ts: Add test for missing @ sign - expect validateEmail('foo') to return false\"\n\nBAD:\n- \"Implement email validation\" (where? how? what result?)\n- \"Add dark mode\" (feature, not a todo)\n- \"Fix auth\" (what file? what changes? what's expected?)\n\n## Granularity Rules\n\nEach todo MUST be a single atomic action completable in 1-3 tool calls. If it needs more, split it.\n\n**Size test**: Can you complete this todo by editing one file or running one command? If not, it's too big.\n\n## Task Management\n- One in_progress at a time. Complete it before starting the next.\n- Mark completed immediately after finishing each item.\n- Skip this tool for single trivial tasks (one-step, obvious action).";

package/dist/hooks/tool-pair-validator/hook.d.ts

@@ -0,0 +1,28 @@
+import type { Message, Part } from "@opencode-ai/sdk";
+type ToolUsePart = {
+    type: "tool_use";
+    id: string;
+    [key: string]: unknown;
+};
+type ToolResultPart = {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    [key: string]: unknown;
+};
+type TransformPart = Part | ToolUsePart | ToolResultPart;
+type TransformMessageInfo = Message | {
+    role: "user";
+    sessionID?: string;
+};
+interface MessageWithParts {
+    info: TransformMessageInfo;
+    parts: TransformPart[];
+}
+type MessagesTransformHook = {
+    "experimental.chat.messages.transform"?: (input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+export declare function createToolPairValidatorHook(): MessagesTransformHook;
+export {};

package/dist/hooks/tool-pair-validator/index.d.ts

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

package/dist/hooks/write-existing-file-guard/hook.d.ts

@@ -1,3 +1,15 @@
 import type { Hooks, PluginInput } from "@opencode-ai/plugin";
+export type GuardArgs = {
+    filePath?: string;
+    path?: string;
+    file_path?: string;
+    overwrite?: boolean | string;
+};
 export declare const MAX_TRACKED_PATHS_PER_SESSION = 1024;
+export declare function asRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function getPathFromArgs(args: GuardArgs | undefined): string | undefined;
+export declare function resolveInputPath(ctx: PluginInput, inputPath: string): string;
+export declare function isPathInsideDirectory(pathToCheck: string, directory: string): boolean;
+export declare function toCanonicalPath(absolutePath: string): string;
+export declare function isOverwriteEnabled(value: boolean | string | undefined): boolean;
 export declare function createWriteExistingFileGuardHook(ctx: PluginInput): Hooks;

package/dist/hooks/write-existing-file-guard/session-read-permissions.d.ts

@@ -0,0 +1,3 @@
+export declare function touchSession(sessionLastAccess: Map<string, number>, sessionID: string): void;
+export declare function evictLeastRecentlyUsedSession(readPermissionsBySession: Map<string, Set<string>>, sessionLastAccess: Map<string, number>): void;
+export declare function trimSessionReadSet(readSet: Set<string>, maxTrackedPathsPerSession: number): void;

package/dist/hooks/write-existing-file-guard/tool-execute-before-handler.d.ts

@@ -0,0 +1,15 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function handleWriteExistingFileGuardToolExecuteBefore(params: {
+    ctx: PluginInput;
+    input: {
+        tool?: string;
+        sessionID?: string;
+    };
+    output: {
+        args?: unknown;
+    };
+    readPermissionsBySession: Map<string, Set<string>>;
+    sessionLastAccess: Map<string, number>;
+    canonicalSessionRoot: string;
+    maxTrackedSessions: number;
+}): Promise<void>;