oh-my-opencode 3.9.0 → 3.11.0

package/dist/oh-my-opencode.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
+  "$id": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/dev/assets/oh-my-opencode.schema.json",
   "title": "Oh My OpenCode Configuration",
   "description": "Configuration schema for oh-my-opencode plugin",
   "type": "object",
@@ -3685,6 +3685,10 @@
         "messageStalenessTimeoutMs": {
           "type": "number",
           "minimum": 60000
+        },
+        "syncPollTimeoutMs": {
+          "type": "number",
+          "minimum": 60000
         }
       },
       "additionalProperties": false
@@ -3837,6 +3841,19 @@
       },
       "additionalProperties": false
     },
+    "start_work": {
+      "type": "object",
+      "properties": {
+        "auto_commit": {
+          "default": true,
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "auto_commit"
+      ],
+      "additionalProperties": false
+    },
     "_migrations": {
       "type": "array",
       "items": {

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -22,6 +22,7 @@ export declare function createCoreHooks(args: {
     writeExistingFileGuard: ReturnType<typeof import("../../hooks").createWriteExistingFileGuardHook> | null;
     hashlineReadEnhancer: ReturnType<typeof import("../../hooks").createHashlineReadEnhancerHook> | null;
     jsonErrorRecovery: ReturnType<typeof import("../../hooks").createJsonErrorRecoveryHook> | null;
+    readImageResizer: ReturnType<typeof import("../../hooks").createReadImageResizerHook> | null;
     contextWindowMonitor: ReturnType<typeof import("../../hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("../../hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("../../hooks").createSessionRecoveryHook> | null;

package/dist/plugin/hooks/create-skill-hooks.d.ts

@@ -1,5 +1,5 @@
 import type { AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
-import type { HookName } from "../../config";
+import type { HookName, OhMyOpenCodeConfig } from "../../config";
 import type { LoadedSkill } from "../../features/opencode-skill-loader/types";
 import type { PluginContext } from "../types";
 import { createAutoSlashCommandHook, createCategorySkillReminderHook } from "../../hooks";
@@ -9,6 +9,7 @@ export type SkillHooks = {
 };
 export declare function createSkillHooks(args: {
     ctx: PluginContext;
+    pluginConfig: OhMyOpenCodeConfig;
     isHookEnabled: (hookName: HookName) => boolean;
     safeHookEnabled: boolean;
     mergedSkills: LoadedSkill[];

package/dist/plugin/hooks/create-tool-guard-hooks.d.ts

@@ -1,7 +1,7 @@
 import type { HookName, OhMyOpenCodeConfig } from "../../config";
 import type { ModelCacheState } from "../../plugin-state";
 import type { PluginContext } from "../types";
-import { createCommentCheckerHooks, createToolOutputTruncatorHook, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createRulesInjectorHook, createTasksTodowriteDisablerHook, createWriteExistingFileGuardHook, createHashlineReadEnhancerHook, createJsonErrorRecoveryHook } from "../../hooks";
+import { createCommentCheckerHooks, createToolOutputTruncatorHook, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createRulesInjectorHook, createTasksTodowriteDisablerHook, createWriteExistingFileGuardHook, createHashlineReadEnhancerHook, createReadImageResizerHook, createJsonErrorRecoveryHook } from "../../hooks";
 export type ToolGuardHooks = {
     commentChecker: ReturnType<typeof createCommentCheckerHooks> | null;
     toolOutputTruncator: ReturnType<typeof createToolOutputTruncatorHook> | null;
@@ -13,6 +13,7 @@ export type ToolGuardHooks = {
     writeExistingFileGuard: ReturnType<typeof createWriteExistingFileGuardHook> | null;
     hashlineReadEnhancer: ReturnType<typeof createHashlineReadEnhancerHook> | null;
     jsonErrorRecovery: ReturnType<typeof createJsonErrorRecoveryHook> | null;
+    readImageResizer: ReturnType<typeof createReadImageResizerHook> | null;
 };
 export declare function createToolGuardHooks(args: {
     ctx: PluginContext;

package/dist/plugin/system-transform.d.ts

@@ -1,5 +1,10 @@
 export declare function createSystemTransformHandler(): (input: {
-    sessionID: string;
+    sessionID?: string;
+    model: {
+        id: string;
+        providerID: string;
+        [key: string]: unknown;
+    };
 }, output: {
     system: string[];
 }) => Promise<void>;

package/dist/plugin/tool-execute-after.d.ts

@@ -1,5 +1,7 @@
 import type { CreatedHooks } from "../create-hooks";
+import type { PluginContext } from "./types";
 export declare function createToolExecuteAfterHandler(args: {
+    ctx: PluginContext;
     hooks: CreatedHooks;
 }): (input: {
     tool: string;

package/dist/shared/index.d.ts

@@ -30,6 +30,7 @@ export * from "./system-directive";
 export * from "./agent-tool-restrictions";
 export * from "./model-requirements";
 export * from "./model-resolver";
+export { normalizeModel, normalizeModelID } from "./model-normalization";
 export { normalizeFallbackModels } from "./model-resolver";
 export { resolveModelPipeline } from "./model-resolution-pipeline";
 export type { ModelResolutionRequest, ModelResolutionProvenance, ModelResolutionResult, } from "./model-resolution-types";
@@ -51,4 +52,5 @@ export * from "./normalize-sdk-response";
 export * from "./session-directory-resolver";
 export * from "./prompt-tools";
 export * from "./internal-initiator-marker";
+export * from "./plugin-command-discovery";
 export { SessionCategoryRegistry } from "./session-category-registry";

package/dist/shared/model-format-normalizer.d.ts

@@ -0,0 +1,7 @@
+export declare function normalizeModelFormat(model: string | {
+    providerID: string;
+    modelID: string;
+}): {
+    providerID: string;
+    modelID: string;
+} | undefined;

package/dist/shared/model-normalization.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeModel(model?: string): string | undefined;
+export declare function normalizeModelID(modelID: string): string;

package/dist/shared/plugin-command-discovery.d.ts

@@ -0,0 +1,6 @@
+import type { CommandDefinition } from "../features/claude-code-command-loader/types";
+export interface PluginCommandDiscoveryOptions {
+    pluginsEnabled?: boolean;
+    enabledPluginsOverride?: Record<string, boolean>;
+}
+export declare function discoverPluginCommandDefinitions(options?: PluginCommandDiscoveryOptions): Record<string, CommandDefinition>;

package/dist/tools/background-task/constants.d.ts

@@ -1,3 +1,3 @@
 export declare const BACKGROUND_TASK_DESCRIPTION = "Run agent task in background. Returns task_id immediately; notifies on completion.\n\nUse `background_output` to get results. Prompts MUST be in English.";
-export declare const BACKGROUND_OUTPUT_DESCRIPTION = "Get output from background task. Use full_session=true to fetch session messages with filters. System notifies on completion, so block=true rarely needed.";
+export declare const BACKGROUND_OUTPUT_DESCRIPTION = "Get output from background task. Use full_session=true to fetch session messages with filters. System notifies on completion, so block=true rarely needed. - Timeout values are in milliseconds (ms), NOT seconds.";
 export declare const BACKGROUND_CANCEL_DESCRIPTION = "Cancel running background task(s). Use all=true to cancel ALL before final answer.";

package/dist/tools/delegate-task/constants.d.ts

@@ -1,6 +1,6 @@
 import type { CategoryConfig } from "../../config/schema";
 import type { AvailableCategory, AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
-export declare const VISUAL_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on VISUAL/UI tasks.\n\nDesign-first mindset:\n- Bold aesthetic choices over safe defaults\n- Unexpected layouts, asymmetry, grid-breaking elements\n- Distinctive typography (avoid: Arial, Inter, Roboto, Space Grotesk)\n- Cohesive color palettes with sharp accents\n- High-impact animations with staggered reveals\n- Atmosphere: gradient meshes, noise textures, layered transparencies\n\nAVOID: Generic fonts, purple gradients on white, predictable layouts, cookie-cutter patterns.\n</Category_Context>";
+export declare const VISUAL_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on VISUAL/UI tasks.\n\n<DESIGN_SYSTEM_WORKFLOW_MANDATE>\n## YOU ARE A VISUAL ENGINEER. FOLLOW THIS WORKFLOW OR YOUR OUTPUT IS REJECTED.\n\n**YOUR FAILURE MODE**: You skip design system analysis and jump straight to writing components with hardcoded colors, arbitrary spacing, and ad-hoc font sizes. The result is INCONSISTENT GARBAGE that looks like 5 different people built it. THIS STOPS NOW.\n\n**EVERY visual task follows this EXACT workflow. VIOLATION = BROKEN OUTPUT.**\n\n### PHASE 1: ANALYZE THE DESIGN SYSTEM (MANDATORY FIRST ACTION)\n\n**BEFORE writing a SINGLE line of CSS, HTML, JSX, Svelte, or component code \u2014 you MUST:**\n\n1. **SEARCH for the design system.** Use Grep, Glob, Read \u2014 actually LOOK:\n   - Design tokens: colors, spacing, typography, shadows, border-radii\n   - Theme files: CSS variables, Tailwind config, `theme.ts`, styled-components theme, design tokens file\n   - Shared/base components: Button, Card, Input, Layout primitives\n   - Existing UI patterns: How are pages structured? What spacing grid? What color usage?\n\n2. **READ at minimum 5-10 existing UI components.** Understand:\n   - Naming conventions (BEM? Atomic? Utility-first? Component-scoped?)\n   - Spacing system (4px grid? 8px? Tailwind scale? CSS variables?)\n   - Color usage (semantic tokens? Direct hex? Theme references?)\n   - Typography scale (heading levels, body, caption \u2014 how many? What font stack?)\n   - Component composition patterns (slots? children? compound components?)\n\n**DO NOT proceed to Phase 2 until you can answer ALL of these. If you cannot, you have not explored enough. EXPLORE MORE.**\n\n### PHASE 2: NO DESIGN SYSTEM? BUILD ONE. NOW.\n\nIf Phase 1 reveals NO coherent design system (or scattered, inconsistent patterns):\n\n1. **STOP. Do NOT build the requested UI yet.**\n2. **Extract what exists** \u2014 even inconsistent patterns have salvageable decisions.\n3. **Create a minimal design system FIRST:**\n   - Color palette: primary, secondary, neutral, semantic (success/warning/error/info)\n   - Typography scale: heading levels (h1-h4 minimum), body, small, caption\n   - Spacing scale: consistent increments (4px or 8px base)\n   - Border radii, shadows, transitions \u2014 systematic, not random\n   - Component primitives: the reusable building blocks\n4. **Commit/save the design system, THEN proceed to Phase 3.**\n\nA design system is NOT optional overhead. It is the FOUNDATION. Building UI without one is like building a house on sand. It WILL collapse into inconsistency.\n\n### PHASE 3: BUILD WITH THE SYSTEM. NEVER AROUND IT.\n\n**NOW and ONLY NOW** \u2014 implement the requested visual work:\n\n| Element | CORRECT | WRONG (WILL BE REJECTED) |\n|---------|---------|--------------------------|\n| Color | Design token / CSS variable | Hardcoded `#3b82f6`, `rgb(59,130,246)` |\n| Spacing | System value (`space-4`, `gap-md`, `var(--spacing-4)`) | Arbitrary `margin: 13px`, `padding: 7px` |\n| Typography | Scale value (`text-lg`, `heading-2`, token) | Ad-hoc `font-size: 17px` |\n| Component | Extend/compose from existing primitives | One-off div soup with inline styles |\n| Border radius | System token | Random `border-radius: 6px` |\n\n**IF the design requires something OUTSIDE the current system:**\n- **Extend the system FIRST** \u2014 add the new token/primitive\n- **THEN use the new token** in your component\n- **NEVER one-off override.** That is how design systems die.\n\n### PHASE 4: VERIFY BEFORE CLAIMING DONE\n\nBEFORE reporting visual work as complete, answer these:\n\n- [ ] Does EVERY color reference a design token or CSS variable?\n- [ ] Does EVERY spacing use the system scale?\n- [ ] Does EVERY component follow the existing composition pattern?\n- [ ] Would a designer see CONSISTENCY across old and new components?\n- [ ] Are there ZERO hardcoded magic numbers for visual properties?\n\n**If ANY answer is NO \u2014 FIX IT. You are NOT done.**\n\n</DESIGN_SYSTEM_WORKFLOW_MANDATE>\n\n<DESIGN_QUALITY>\nDesign-first mindset (AFTER design system is established):\n- Bold aesthetic choices over safe defaults\n- Unexpected layouts, asymmetry, grid-breaking elements\n- Distinctive typography (avoid: Arial, Inter, Roboto, Space Grotesk)\n- Cohesive color palettes with sharp accents\n- High-impact animations with staggered reveals\n- Atmosphere: gradient meshes, noise textures, layered transparencies\n\nAVOID: Generic fonts, purple gradients on white, predictable layouts, cookie-cutter patterns.\n</DESIGN_QUALITY>\n</Category_Context>";
 export declare const ULTRABRAIN_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on DEEP LOGICAL REASONING / COMPLEX ARCHITECTURE tasks.\n\n**CRITICAL - CODE STYLE REQUIREMENTS (NON-NEGOTIABLE)**:\n1. BEFORE writing ANY code, SEARCH the existing codebase to find similar patterns/styles\n2. Your code MUST match the project's existing conventions - blend in seamlessly\n3. Write READABLE code that humans can easily understand - no clever tricks\n4. If unsure about style, explore more files until you find the pattern\n\nStrategic advisor mindset:\n- Bias toward simplicity: least complex solution that fulfills requirements\n- Leverage existing code/patterns over new components\n- Prioritize developer experience and maintainability\n- One clear recommendation with effort estimate (Quick/Short/Medium/Large)\n- Signal when advanced approach warranted\n\nResponse format:\n- Bottom line (2-3 sentences)\n- Action plan (numbered steps)\n- Risks and mitigations (if relevant)\n</Category_Context>";
 export declare const ARTISTRY_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on HIGHLY CREATIVE / ARTISTIC tasks.\n\nArtistic genius mindset:\n- Push far beyond conventional boundaries\n- Explore radical, unconventional directions\n- Surprise and delight: unexpected twists, novel combinations\n- Rich detail and vivid expression\n- Break patterns deliberately when it serves the creative vision\n\nApproach:\n- Generate diverse, bold options first\n- Embrace ambiguity and wild experimentation\n- Balance novelty with coherence\n- This is for tasks requiring exceptional creativity\n</Category_Context>";
 export declare const QUICK_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on SMALL / QUICK tasks.\n\nEfficient execution mindset:\n- Fast, focused, minimal overhead\n- Get to the point immediately\n- No over-engineering\n- Simple solutions for simple problems\n\nApproach:\n- Minimal viable implementation\n- Skip unnecessary abstractions\n- Direct and concise\n</Category_Context>\n\n<Caller_Warning>\nTHIS CATEGORY USES A LESS CAPABLE MODEL (claude-haiku-4-5).\n\nThe model executing this task has LIMITED reasoning capacity. Your prompt MUST be:\n\n**EXHAUSTIVELY EXPLICIT** - Leave NOTHING to interpretation:\n1. MUST DO: List every required action as atomic, numbered steps\n2. MUST NOT DO: Explicitly forbid likely mistakes and deviations\n3. EXPECTED OUTPUT: Describe exact success criteria with concrete examples\n\n**WHY THIS MATTERS:**\n- Less capable models WILL deviate without explicit guardrails\n- Vague instructions \u2192 unpredictable results\n- Implicit expectations \u2192 missed requirements\n\n**PROMPT STRUCTURE (MANDATORY):**\n```\nTASK: [One-sentence goal]\n\nMUST DO:\n1. [Specific action with exact details]\n2. [Another specific action]\n...\n\nMUST NOT DO:\n- [Forbidden action + why]\n- [Another forbidden action]\n...\n\nEXPECTED OUTPUT:\n- [Exact deliverable description]\n- [Success criteria / verification method]\n```\n\nIf your prompt lacks this structure, REWRITE IT before delegating.\n</Caller_Warning>";

package/dist/tools/delegate-task/executor-types.d.ts

@@ -15,6 +15,7 @@ export interface ExecutorContext {
         parentID: string;
         title: string;
     }) => Promise<void>;
+    syncPollTimeoutMs?: number;
 }
 export interface ParentContext {
     sessionID: string;

package/dist/tools/delegate-task/index.d.ts

@@ -1,4 +1,4 @@
-export { createDelegateTask, resolveCategoryConfig, buildSystemContent } from "./tools";
+export { createDelegateTask, resolveCategoryConfig, buildSystemContent, buildTaskPrompt } from "./tools";
 export type { DelegateTaskToolOptions, SyncSessionCreatedEvent, BuildSystemContentInput } from "./tools";
 export type * from "./types";
 export * from "./constants";

package/dist/tools/delegate-task/prompt-builder.d.ts

@@ -4,3 +4,4 @@ import type { BuildSystemContentInput } from "./types";
  * Combines skill content, category prompt append, and plan agent system prepend.
  */
 export declare function buildSystemContent(input: BuildSystemContentInput): string | undefined;
+export declare function buildTaskPrompt(prompt: string, agentName: string | undefined): string;

package/dist/tools/delegate-task/sync-session-poller.d.ts

@@ -9,4 +9,4 @@ export declare function pollSyncSession(ctx: ToolContextWithMetadata, client: Op
     } | null | undefined;
     taskId: string | undefined;
     anchorMessageCount?: number;
-}): Promise<string | null>;
+}, timeoutMs?: number): Promise<string | null>;

package/dist/tools/delegate-task/timing.d.ts

@@ -1,3 +1,5 @@
+export declare const DEFAULT_SYNC_POLL_TIMEOUT_MS: number;
+export declare function getDefaultSyncPollTimeoutMs(): number;
 export declare function getTimingConfig(): {
     POLL_INTERVAL_MS: number;
     MIN_STABILITY_TIME_MS: number;

package/dist/tools/delegate-task/tools.d.ts

@@ -2,5 +2,5 @@ import { type ToolDefinition } from "@opencode-ai/plugin";
 import type { DelegateTaskToolOptions } from "./types";
 export { resolveCategoryConfig } from "./categories";
 export type { SyncSessionCreatedEvent, DelegateTaskToolOptions, BuildSystemContentInput } from "./types";
-export { buildSystemContent } from "./prompt-builder";
+export { buildSystemContent, buildTaskPrompt } from "./prompt-builder";
 export declare function createDelegateTask(options: DelegateTaskToolOptions): ToolDefinition;

package/dist/tools/delegate-task/types.d.ts

@@ -63,6 +63,7 @@ export interface DelegateTaskToolOptions {
     availableSkills?: AvailableSkill[];
     agentOverrides?: AgentOverrides;
     onSyncSessionCreated?: (event: SyncSessionCreatedEvent) => Promise<void>;
+    syncPollTimeoutMs?: number;
 }
 export interface BuildSystemContentInput {
     skillContent?: string;

package/dist/tools/hashline-edit/tool-description.d.ts

@@ -1 +1 @@
-export declare const HASHLINE_EDIT_DESCRIPTION = "Edit files using LINE#ID format for precise, safe modifications.\n\nWORKFLOW:\n1. Read target file/range and copy exact LINE#ID tags.\n2. Pick the smallest operation per logical mutation site.\n3. Submit one edit call per file with all related operations.\n4. If same file needs another call, re-read first.\n5. Use anchors as \"LINE#ID\" only (never include trailing \"|content\").\n\nVALIDATION:\n  Payload shape: { \"filePath\": string, \"edits\": [...], \"delete\"?: boolean, \"rename\"?: string }\n  Each edit must be one of: replace, append, prepend\n  Edit shape: { \"op\": \"replace\"|\"append\"|\"prepend\", \"pos\"?: \"LINE#ID\", \"end\"?: \"LINE#ID\", \"lines\": string|string[]|null }\n  lines must contain plain replacement text only (no LINE#ID prefixes, no diff + markers)\n  CRITICAL: all operations validate against the same pre-edit file snapshot and apply bottom-up. Refs/tags are interpreted against the last-read version of the file.\n\nLINE#ID FORMAT (CRITICAL):\n Each line reference must be in \"{line_number}#{hash_id}\" format where:\n {line_number}: 1-based line number\n {hash_id}: Two CID letters from the set ZPMQVRWSNKTXJBYH\n\nFILE MODES:\n delete=true deletes file and requires edits=[] with no rename\n rename moves final content to a new path and removes old path\n\nCONTENT FORMAT:\n  lines can be a string (single line) or string[] (multi-line, preferred).\n  If you pass a multi-line string, it is split by real newline characters.\n  Literal \"\\n\" is preserved as text.\n\nFILE CREATION:\n  append without anchors adds content at EOF. If file does not exist, creates it.\n  prepend without anchors adds content at BOF. If file does not exist, creates it.\n  CRITICAL: only unanchored append/prepend can create a missing file.\n\nOPERATION CHOICE:\n  replace with pos only -> replace one line at pos (MOST COMMON for single-line edits)\n  replace with pos+end -> replace ENTIRE range pos..end as a block (ranges MUST NOT overlap across edits)\n  append with pos/end anchor -> insert after that anchor\n  prepend with pos/end anchor -> insert before that anchor\n  append/prepend without anchors -> EOF/BOF insertion\n\nRULES (CRITICAL):\n 1. Minimize scope: one logical mutation site per operation.\n 2. Preserve formatting: keep indentation, punctuation, line breaks, trailing commas, brace style.\n 3. Prefer insertion over neighbor rewrites: anchor to structural boundaries (}, ], },), not interior property lines.\n 4. No no-ops: replacement content must differ from current content.\n 5. Touch only requested code: avoid incidental edits.\n 6. Use exact current tokens: NEVER rewrite approximately.\n 7. For swaps/moves: prefer one range operation over multiple single-line operations.\n 8. Output tool calls only; no prose or commentary between them.\n\nTAG CHOICE (ALWAYS):\n - Copy tags exactly from read output or >>> mismatch output.\n - NEVER guess tags.\n  - Anchor to structural lines (function/class/brace), NEVER blank lines.\n  - Anti-pattern warning: blank/whitespace anchors are fragile.\n  - Re-read after each successful edit call before issuing another on the same file.\n\nAUTOCORRECT (built-in - you do NOT need to handle these):\n Merged lines are auto-expanded back to original line count.\n Indentation is auto-restored from original lines.\n BOM and CRLF line endings are preserved automatically.\n Hashline prefixes and diff markers in text are auto-stripped.\n\nRECOVERY (when >>> mismatch error appears):\n Copy the updated LINE#ID tags shown in the error output directly.\n Re-read only if the needed tags are missing from the error snippet.\n ALWAYS batch all edits for one file in a single call.";
+export declare const HASHLINE_EDIT_DESCRIPTION = "Edit files using LINE#ID format for precise, safe modifications.\n\nWORKFLOW:\n1. Read target file/range and copy exact LINE#ID tags.\n2. Pick the smallest operation per logical mutation site.\n3. Submit one edit call per file with all related operations.\n4. If same file needs another call, re-read first.\n5. Use anchors as \"LINE#ID\" only (never include trailing \"|content\").\n\nVALIDATION:\n  Payload shape: { \"filePath\": string, \"edits\": [...], \"delete\"?: boolean, \"rename\"?: string }\n  Each edit must be one of: replace, append, prepend\n  Edit shape: { \"op\": \"replace\"|\"append\"|\"prepend\", \"pos\"?: \"LINE#ID\", \"end\"?: \"LINE#ID\", \"lines\": string|string[]|null }\n  lines must contain plain replacement text only (no LINE#ID prefixes, no diff + markers)\n  CRITICAL: all operations validate against the same pre-edit file snapshot and apply bottom-up. Refs/tags are interpreted against the last-read version of the file.\n\nLINE#ID FORMAT (CRITICAL):\n Each line reference must be in \"{line_number}#{hash_id}\" format where:\n {line_number}: 1-based line number\n {hash_id}: Two CID letters from the set ZPMQVRWSNKTXJBYH\n\nFILE MODES:\n delete=true deletes file and requires edits=[] with no rename\n rename moves final content to a new path and removes old path\n\nCONTENT FORMAT:\n  lines can be a string (single line) or string[] (multi-line, preferred).\n  If you pass a multi-line string, it is split by real newline characters.\n  Literal \"\\n\" is preserved as text.\n\nFILE CREATION:\n  append without anchors adds content at EOF. If file does not exist, creates it.\n  prepend without anchors adds content at BOF. If file does not exist, creates it.\n  CRITICAL: only unanchored append/prepend can create a missing file.\n\nOPERATION CHOICE:\n  replace with pos only -> replace one line at pos\n  replace with pos+end -> replace ENTIRE range pos..end as a block (ranges MUST NOT overlap across edits)\n  append with pos/end anchor -> insert after that anchor\n  prepend with pos/end anchor -> insert before that anchor\n  append/prepend without anchors -> EOF/BOF insertion\n\nRULES (CRITICAL):\n 1. Minimize scope: one logical mutation site per operation.\n 2. Preserve formatting: keep indentation, punctuation, line breaks, trailing commas, brace style.\n 3. Prefer insertion over neighbor rewrites: anchor to structural boundaries (}, ], },), not interior property lines.\n 4. No no-ops: replacement content must differ from current content.\n 5. Touch only requested code: avoid incidental edits.\n 6. Use exact current tokens: NEVER rewrite approximately.\n 7. For swaps/moves: prefer one range operation over multiple single-line operations.\n 8. Output tool calls only; no prose or commentary between them.\n\nTAG CHOICE (ALWAYS):\n - Copy tags exactly from read output or >>> mismatch output.\n - NEVER guess tags.\n  - Anchor to structural lines (function/class/brace), NEVER blank lines.\n  - Anti-pattern warning: blank/whitespace anchors are fragile.\n  - Re-read after each successful edit call before issuing another on the same file.\n\nAUTOCORRECT (built-in - you do NOT need to handle these):\n Merged lines are auto-expanded back to original line count.\n Indentation is auto-restored from original lines.\n BOM and CRLF line endings are preserved automatically.\n Hashline prefixes and diff markers in text are auto-stripped.\n\nRECOVERY (when >>> mismatch error appears):\n Copy the updated LINE#ID tags shown in the error output directly.\n Re-read only if the needed tags are missing from the error snippet.\n ALWAYS batch all edits for one file in a single call.";

package/dist/tools/look-at/image-converter.d.ts

@@ -0,0 +1,7 @@
+export declare function needsConversion(mimeType: string): boolean;
+export declare function convertImageToJpeg(inputPath: string, mimeType: string): string;
+export declare function cleanupConvertedImage(filePath: string): void;
+export declare function convertBase64ImageToJpeg(base64Data: string, mimeType: string): {
+    base64: string;
+    tempFiles: string[];
+};

package/dist/tools/skill/types.d.ts

@@ -30,4 +30,8 @@ export interface SkillLoadOptions {
     /** Git master configuration for watermark/co-author settings */
     gitMasterConfig?: GitMasterConfig;
     disabledSkills?: Set<string>;
+    /** Include Claude marketplace plugin commands in discovery (default: true) */
+    pluginsEnabled?: boolean;
+    /** Override plugin enablement from Claude settings by plugin key */
+    enabledPluginsOverride?: Record<string, boolean>;
 }

package/dist/tools/skill-mcp/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const SKILL_MCP_TOOL_NAME = "skill_mcp";
 export declare const SKILL_MCP_DESCRIPTION = "Invoke MCP server operations from skill-embedded MCPs. Requires mcp_name plus exactly one of: tool_name, resource_name, or prompt_name.";
+export declare const BUILTIN_MCP_TOOL_HINTS: Record<string, string[]>;

package/dist/tools/slashcommand/command-discovery.d.ts

@@ -1,2 +1,6 @@
 import type { CommandInfo } from "./types";
-export declare function discoverCommandsSync(directory?: string): CommandInfo[];
+export interface CommandDiscoveryOptions {
+    pluginsEnabled?: boolean;
+    enabledPluginsOverride?: Record<string, boolean>;
+}
+export declare function discoverCommandsSync(directory?: string, options?: CommandDiscoveryOptions): CommandInfo[];

package/dist/tools/slashcommand/types.d.ts

@@ -1,5 +1,5 @@
 import type { LazyContentLoader } from "../../features/opencode-skill-loader";
-export type CommandScope = "builtin" | "config" | "user" | "project" | "opencode" | "opencode-project";
+export type CommandScope = "builtin" | "config" | "user" | "project" | "opencode" | "opencode-project" | "plugin";
 export interface CommandMetadata {
     name: string;
     description: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "3.9.0",
+  "version": "3.11.0",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,6 +26,7 @@
     "build:binaries": "bun run script/build-binaries.ts",
     "build:schema": "bun run script/build-schema.ts",
     "clean": "rm -rf dist",
+    "prepare": "bun run build",
     "postinstall": "node postinstall.mjs",
     "prepublishOnly": "bun run clean && bun run build",
     "typecheck": "tsc --noEmit",
@@ -54,10 +55,10 @@
     "@ast-grep/cli": "^0.40.0",
     "@ast-grep/napi": "^0.40.0",
     "@clack/prompts": "^0.11.0",
-    "@code-yeongyu/comment-checker": "^0.6.1",
+    "@code-yeongyu/comment-checker": "^0.7.0",
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "@opencode-ai/plugin": "^1.1.19",
-    "@opencode-ai/sdk": "^1.1.19",
+    "@opencode-ai/plugin": "^1.2.16",
+    "@opencode-ai/sdk": "^1.2.17",
     "commander": "^14.0.2",
     "detect-libc": "^2.0.0",
     "diff": "^8.0.3",
@@ -75,17 +76,20 @@
     "typescript": "^5.7.3"
   },
   "optionalDependencies": {
-    "oh-my-opencode-darwin-arm64": "3.9.0",
-    "oh-my-opencode-darwin-x64": "3.9.0",
-    "oh-my-opencode-darwin-x64-baseline": "3.9.0",
-    "oh-my-opencode-linux-arm64": "3.9.0",
-    "oh-my-opencode-linux-arm64-musl": "3.9.0",
-    "oh-my-opencode-linux-x64": "3.9.0",
-    "oh-my-opencode-linux-x64-baseline": "3.9.0",
-    "oh-my-opencode-linux-x64-musl": "3.9.0",
-    "oh-my-opencode-linux-x64-musl-baseline": "3.9.0",
-    "oh-my-opencode-windows-x64": "3.9.0",
-    "oh-my-opencode-windows-x64-baseline": "3.9.0"
+    "oh-my-opencode-darwin-arm64": "3.11.0",
+    "oh-my-opencode-darwin-x64": "3.11.0",
+    "oh-my-opencode-darwin-x64-baseline": "3.11.0",
+    "oh-my-opencode-linux-arm64": "3.11.0",
+    "oh-my-opencode-linux-arm64-musl": "3.11.0",
+    "oh-my-opencode-linux-x64": "3.11.0",
+    "oh-my-opencode-linux-x64-baseline": "3.11.0",
+    "oh-my-opencode-linux-x64-musl": "3.11.0",
+    "oh-my-opencode-linux-x64-musl-baseline": "3.11.0",
+    "oh-my-opencode-windows-x64": "3.11.0",
+    "oh-my-opencode-windows-x64-baseline": "3.11.0"
+  },
+  "overrides": {
+    "@opencode-ai/sdk": "^1.2.17"
   },
   "trustedDependencies": [
     "@ast-grep/cli",

package/dist/agents/hephaestus.d.ts

@@ -1,6 +0,0 @@
-import type { AgentConfig } from "@opencode-ai/sdk";
-import type { AvailableAgent, AvailableSkill, AvailableCategory } from "./dynamic-agent-prompt-builder";
-export declare function createHephaestusAgent(model: string, availableAgents?: AvailableAgent[], availableToolNames?: string[], availableSkills?: AvailableSkill[], availableCategories?: AvailableCategory[], useTaskSystem?: boolean): AgentConfig;
-export declare namespace createHephaestusAgent {
-    var mode: "all";
-}

package/dist/cli/config-manager/add-provider-config.d.ts

@@ -1,2 +0,0 @@
-import type { ConfigMergeResult, InstallConfig } from "../types";
-export declare function addProviderConfig(config: InstallConfig): ConfigMergeResult;

package/dist/cli/config-manager/antigravity-provider-configuration.d.ts

@@ -1,122 +0,0 @@
-/**
- * Antigravity Provider Configuration
- *
- * IMPORTANT: Model names MUST use `antigravity-` prefix for stability.
- *
- * Since opencode-antigravity-auth v1.3.0, models use a variant system:
- * - `antigravity-gemini-3.1-pro` with variants: low, high
- * - `antigravity-gemini-3-flash` with variants: minimal, low, medium, high
- *
- * Legacy tier-suffixed names (e.g., `antigravity-gemini-3.1-pro-high`) still work
- * but variants are the recommended approach.
- *
- * @see https://github.com/NoeFabris/opencode-antigravity-auth#models
- */
-export declare const ANTIGRAVITY_PROVIDER_CONFIG: {
-    google: {
-        name: string;
-        models: {
-            "antigravity-gemini-3.1-pro": {
-                name: string;
-                limit: {
-                    context: number;
-                    output: number;
-                };
-                modalities: {
-                    input: string[];
-                    output: string[];
-                };
-                variants: {
-                    low: {
-                        thinkingLevel: string;
-                    };
-                    high: {
-                        thinkingLevel: string;
-                    };
-                };
-            };
-            "antigravity-gemini-3-flash": {
-                name: string;
-                limit: {
-                    context: number;
-                    output: number;
-                };
-                modalities: {
-                    input: string[];
-                    output: string[];
-                };
-                variants: {
-                    minimal: {
-                        thinkingLevel: string;
-                    };
-                    low: {
-                        thinkingLevel: string;
-                    };
-                    medium: {
-                        thinkingLevel: string;
-                    };
-                    high: {
-                        thinkingLevel: string;
-                    };
-                };
-            };
-            "antigravity-claude-sonnet-4-6": {
-                name: string;
-                limit: {
-                    context: number;
-                    output: number;
-                };
-                modalities: {
-                    input: string[];
-                    output: string[];
-                };
-            };
-            "antigravity-claude-sonnet-4-6-thinking": {
-                name: string;
-                limit: {
-                    context: number;
-                    output: number;
-                };
-                modalities: {
-                    input: string[];
-                    output: string[];
-                };
-                variants: {
-                    low: {
-                        thinkingConfig: {
-                            thinkingBudget: number;
-                        };
-                    };
-                    max: {
-                        thinkingConfig: {
-                            thinkingBudget: number;
-                        };
-                    };
-                };
-            };
-            "antigravity-claude-opus-4-5-thinking": {
-                name: string;
-                limit: {
-                    context: number;
-                    output: number;
-                };
-                modalities: {
-                    input: string[];
-                    output: string[];
-                };
-                variants: {
-                    low: {
-                        thinkingConfig: {
-                            thinkingBudget: number;
-                        };
-                    };
-                    max: {
-                        thinkingConfig: {
-                            thinkingBudget: number;
-                        };
-                    };
-                };
-            };
-        };
-    };
-};

package/dist/cli/config-manager/auth-plugins.d.ts

@@ -1,3 +0,0 @@
-import type { ConfigMergeResult, InstallConfig } from "../types";
-export declare function fetchLatestVersion(packageName: string): Promise<string | null>;
-export declare function addAuthPlugins(config: InstallConfig): Promise<ConfigMergeResult>;

package/dist/cli/config-manager/jsonc-provider-editor.d.ts

@@ -1 +0,0 @@
-export declare function modifyProviderInJsonc(content: string, newProviderValue: Record<string, unknown>): string;

package/dist/hooks/keyword-detector/ultrawork/gpt5.2.d.ts

@@ -1,15 +0,0 @@
-/**
- * Ultrawork message optimized for GPT 5.2 series models.
- *
- * Key characteristics (from GPT 5.2 Prompting Guide):
- * - "Stronger instruction adherence" - follows instructions more literally
- * - "Conservative grounding bias" - prefers correctness over speed
- * - "Parallelize independent reads to reduce latency" - official guidance
- *
- * Design principles:
- * - Two-track parallel context gathering (Direct tools + Background agents)
- * - Fire background agents, then use direct tools while waiting
- * - Explicit complexity-based 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: 3-6 sentences or \u22645 bullets for typical answers\n- Simple yes/no questions: \u22642 sentences\n- Complex multi-file tasks: 1 short overview paragraph + \u22645 bullets (What, Where, Risks, Next, Open)\n- Avoid long narrative paragraphs; prefer compact bullets\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## 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\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\n\n**Deliver exactly what was asked. No more, no less.**\n\n</ultrawork-mode>\n\n---\n\n";
-export declare function getGptUltraworkMessage(): string;

package/dist/shared/model-name-matcher.d.ts

@@ -1 +0,0 @@
-export declare function fuzzyMatchModel(target: string, available: Set<string>, providers?: string[]): string | null;