oh-my-opencode 3.11.2 → 3.12.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/dev/assets/oh-my-opencode.schema.json",
+  "$id": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
   "title": "Oh My OpenCode Configuration",
   "description": "Configuration schema for oh-my-opencode plugin",
   "type": "object",
@@ -3678,6 +3678,16 @@
             "minimum": 0
           }
         },
+        "maxDepth": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "maxDescendants": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
         "staleTimeoutMs": {
           "type": "number",
           "minimum": 60000
@@ -3689,6 +3699,32 @@
         "syncPollTimeoutMs": {
           "type": "number",
           "minimum": 60000
+        },
+        "maxToolCalls": {
+          "type": "integer",
+          "minimum": 10,
+          "maximum": 9007199254740991
+        },
+        "circuitBreaker": {
+          "type": "object",
+          "properties": {
+            "maxToolCalls": {
+              "type": "integer",
+              "minimum": 10,
+              "maximum": 9007199254740991
+            },
+            "windowSize": {
+              "type": "integer",
+              "minimum": 5,
+              "maximum": 9007199254740991
+            },
+            "repetitionThresholdPercent": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 100
+            }
+          },
+          "additionalProperties": false
         }
       },
       "additionalProperties": false
@@ -3732,11 +3768,16 @@
         "include_co_authored_by": {
           "default": true,
           "type": "boolean"
+        },
+        "git_env_prefix": {
+          "default": "GIT_MASTER=1",
+          "type": "string"
         }
       },
       "required": [
         "commit_footer",
-        "include_co_authored_by"
+        "include_co_authored_by",
+        "git_env_prefix"
       ],
       "additionalProperties": false
     },

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

@@ -1,9 +1,10 @@
 import type { HookName, OhMyOpenCodeConfig } from "../../config";
 import type { BackgroundManager } from "../../features/background-agent";
 import type { PluginContext } from "../types";
-import { createTodoContinuationEnforcer, createBackgroundNotificationHook, createStopContinuationGuardHook, createCompactionContextInjector, createCompactionTodoPreserverHook, createAtlasHook } from "../../hooks";
+import { createGptPermissionContinuationHook, createTodoContinuationEnforcer, createBackgroundNotificationHook, createStopContinuationGuardHook, createCompactionContextInjector, createCompactionTodoPreserverHook, createAtlasHook } from "../../hooks";
 import { createUnstableAgentBabysitter } from "../unstable-agent-babysitter";
 export type ContinuationHooks = {
+    gptPermissionContinuation: ReturnType<typeof createGptPermissionContinuationHook> | null;
     stopContinuationGuard: ReturnType<typeof createStopContinuationGuardHook> | null;
     compactionContextInjector: ReturnType<typeof createCompactionContextInjector> | null;
     compactionTodoPreserver: ReturnType<typeof createCompactionTodoPreserverHook> | null;

package/dist/plugin/normalize-tool-arg-schemas.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+export declare function normalizeToolArgSchemas<TDefinition extends Pick<ToolDefinition, "args">>(toolDefinition: TDefinition): TDefinition;

package/dist/plugin/ultrawork-model-override.d.ts

@@ -5,10 +5,6 @@ export type UltraworkOverrideResult = {
     modelID?: string;
     variant?: string;
 };
-/**
- * Resolves the ultrawork model override config for the given agent and prompt text.
- * Returns null if no override should be applied.
- */
 export declare function resolveUltraworkOverride(pluginConfig: OhMyOpenCodeConfig, inputAgentName: string | undefined, output: {
     message: Record<string, unknown>;
     parts: Array<{
@@ -17,16 +13,6 @@ export declare function resolveUltraworkOverride(pluginConfig: OhMyOpenCodeConfi
         [key: string]: unknown;
     }>;
 }, sessionID?: string): UltraworkOverrideResult | null;
-/**
- * Applies ultrawork model override using a deferred DB update strategy.
- *
- * Instead of directly mutating output.message.model (which would cause the TUI
- * bottom bar to show the override model), this schedules a queueMicrotask that
- * updates the message model directly in SQLite AFTER Session.updateMessage()
- * saves the original model, but BEFORE loop() reads it for the API call.
- *
- * Result: API call uses opus, TUI bottom bar stays on sonnet.
- */
 export declare function applyUltraworkModelOverrideOnMessage(pluginConfig: OhMyOpenCodeConfig, inputAgentName: string | undefined, output: {
     message: Record<string, unknown>;
     parts: Array<{
@@ -34,4 +20,4 @@ export declare function applyUltraworkModelOverrideOnMessage(pluginConfig: OhMyO
         text?: string;
         [key: string]: unknown;
     }>;
-}, tui: unknown, sessionID?: string): void;
+}, tui: unknown, sessionID?: string, client?: unknown): void | Promise<void>;

package/dist/plugin/ultrawork-variant-availability.d.ts

@@ -0,0 +1,6 @@
+type ModelDescriptor = {
+    providerID: string;
+    modelID: string;
+};
+export declare function resolveValidUltraworkVariant(client: unknown, model: ModelDescriptor | undefined, variant: string | undefined): Promise<string | undefined>;
+export {};

package/dist/plugin-dispose.d.ts

@@ -0,0 +1,10 @@
+export type PluginDispose = () => Promise<void>;
+export declare function createPluginDispose(args: {
+    backgroundManager: {
+        shutdown: () => void | Promise<void>;
+    };
+    skillMcpManager: {
+        disconnectAll: () => Promise<void>;
+    };
+    disposeHooks: () => void;
+}): PluginDispose;

package/dist/plugin-handlers/agent-override-protection.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeProtectedAgentName(agentName: string): string;
+export declare function createProtectedAgentNameSet(agentNames: Iterable<string>): Set<string>;
+export declare function filterProtectedAgentOverrides<TAgent>(agents: Record<string, TAgent>, protectedAgentNames: ReadonlySet<string>): Record<string, TAgent>;

package/dist/plugin-state.d.ts

@@ -1,5 +1,10 @@
+export type VisionCapableModel = {
+    providerID: string;
+    modelID: string;
+};
 export interface ModelCacheState {
     modelContextLimitsCache: Map<string, number>;
+    visionCapableModelsCache?: Map<string, VisionCapableModel>;
     anthropicContext1MEnabled: boolean;
 }
 export declare function createModelCacheState(): ModelCacheState;

package/dist/shared/compaction-agent-config-checkpoint.d.ts

@@ -0,0 +1,11 @@
+export type CompactionAgentConfigCheckpoint = {
+    agent?: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+    tools?: Record<string, boolean>;
+};
+export declare function setCompactionAgentConfigCheckpoint(sessionID: string, checkpoint: CompactionAgentConfigCheckpoint): void;
+export declare function getCompactionAgentConfigCheckpoint(sessionID: string): CompactionAgentConfigCheckpoint | undefined;
+export declare function clearCompactionAgentConfigCheckpoint(sessionID: string): void;

package/dist/shared/context-limit-resolver.d.ts

@@ -0,0 +1,5 @@
+export type ContextLimitModelCacheState = {
+    anthropicContext1MEnabled: boolean;
+    modelContextLimitsCache?: Map<string, number>;
+};
+export declare function resolveActualContextLimit(providerID: string, modelID: string, modelCacheState?: ContextLimitModelCacheState): number | null;

package/dist/shared/dynamic-truncator.d.ts

@@ -1,7 +1,5 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-type ModelCacheStateLike = {
-    anthropicContext1MEnabled: boolean;
-};
+import { type ContextLimitModelCacheState } from "./context-limit-resolver";
 export interface TruncationResult {
     result: string;
     truncated: boolean;
@@ -13,13 +11,13 @@ export interface TruncationOptions {
     contextWindowLimit?: number;
 }
 export declare function truncateToTokenLimit(output: string, maxTokens: number, preserveHeaderLines?: number): TruncationResult;
-export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ModelCacheStateLike): Promise<{
+export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ContextLimitModelCacheState): Promise<{
     usedTokens: number;
     remainingTokens: number;
     usagePercentage: number;
 } | null>;
-export declare function dynamicTruncate(ctx: PluginInput, sessionID: string, output: string, options?: TruncationOptions, modelCacheState?: ModelCacheStateLike): Promise<TruncationResult>;
-export declare function createDynamicTruncator(ctx: PluginInput, modelCacheState?: ModelCacheStateLike): {
+export declare function dynamicTruncate(ctx: PluginInput, sessionID: string, output: string, options?: TruncationOptions, modelCacheState?: ContextLimitModelCacheState): Promise<TruncationResult>;
+export declare function createDynamicTruncator(ctx: PluginInput, modelCacheState?: ContextLimitModelCacheState): {
     truncate: (sessionID: string, output: string, options?: TruncationOptions) => Promise<TruncationResult>;
     getUsage: (sessionID: string) => Promise<{
         usedTokens: number;
@@ -28,4 +26,3 @@ export declare function createDynamicTruncator(ctx: PluginInput, modelCacheState
     } | null>;
     truncateSync: (output: string, maxTokens: number, preserveHeaderLines?: number) => TruncationResult;
 };
-export {};

package/dist/shared/fallback-chain-from-models.d.ts

@@ -0,0 +1,3 @@
+import type { FallbackEntry } from "./model-requirements";
+export declare function parseFallbackModelEntry(model: string, contextProviderID: string | undefined, defaultProviderID?: string): FallbackEntry | undefined;
+export declare function buildFallbackChainFromModels(fallbackModels: string | string[] | undefined, contextProviderID: string | undefined, defaultProviderID?: string): FallbackEntry[] | undefined;

package/dist/shared/index.d.ts

@@ -37,6 +37,7 @@ export type { ModelResolutionRequest, ModelResolutionProvenance, ModelResolution
 export * from "./model-availability";
 export * from "./fallback-model-availability";
 export * from "./connected-providers-cache";
+export * from "./context-limit-resolver";
 export * from "./session-utils";
 export * from "./tmux";
 export * from "./model-suggestion-retry";
@@ -48,9 +49,11 @@ export * from "./safe-create-hook";
 export * from "./truncate-description";
 export * from "./opencode-storage-paths";
 export * from "./opencode-message-dir";
+export * from "./opencode-command-dirs";
 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";
+export * from "./plugin-identity";

package/dist/shared/model-error-classifier.d.ts

@@ -26,6 +26,7 @@ export declare function hasMoreFallbacks(fallbackChain: FallbackEntry[], attempt
  * Selects the best provider for a fallback entry.
  * Priority:
  * 1) First connected provider in the entry's provider preference order
- * 2) First provider listed in the fallback entry (when cache is missing)
+ * 2) Preferred provider when connected (and entry providers are unavailable)
+ * 3) First provider listed in the fallback entry
  */
 export declare function selectFallbackProvider(providers: string[], preferredProviderID?: string): string;

package/dist/shared/opencode-command-dirs.d.ts

@@ -0,0 +1,3 @@
+import type { OpenCodeConfigDirOptions } from "./opencode-config-dir-types";
+export declare function getOpenCodeCommandDirs(options: OpenCodeConfigDirOptions): string[];
+export declare function getOpenCodeSkillDirs(options: OpenCodeConfigDirOptions): string[];

package/dist/shared/plugin-identity.d.ts

@@ -0,0 +1,5 @@
+export declare const PLUGIN_NAME = "oh-my-opencode";
+export declare const LEGACY_PLUGIN_NAME = "oh-my-openagent";
+export declare const CONFIG_BASENAME = "oh-my-opencode";
+export declare const LOG_FILENAME = "oh-my-opencode.log";
+export declare const CACHE_DIR_NAME = "oh-my-opencode";

package/dist/shared/question-denied-session-permission.d.ts

@@ -0,0 +1,6 @@
+export type SessionPermissionRule = {
+    permission: string;
+    action: "allow" | "deny";
+    pattern: string;
+};
+export declare const QUESTION_DENIED_SESSION_PERMISSION: SessionPermissionRule[];

package/dist/shared/retry-status-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeRetryStatusMessage(message: string): string;
+export declare function extractRetryAttempt(statusAttempt: unknown, message: string): string;

package/dist/shared/shell-env.d.ts

@@ -39,3 +39,30 @@ export declare function shellEscape(value: string, shellType: ShellType): string
  * ```
  */
 export declare function buildEnvPrefix(env: Record<string, string>, shellType: ShellType): string;
+/**
+ * Escape a value for use in a double-quoted shell -c command argument.
+ *
+ * In shell -c "..." strings, these characters have special meaning and must be escaped:
+ * - $ - variable expansion, command substitution $(...)
+ * - ` - command substitution `...`
+ * - \\ - escape character
+ * - " - end quote
+ * - ; | & - command separators
+ * - # - comment
+ * - () - grouping operators
+ *
+ * @param value - The value to escape
+ * @returns Escaped value safe for double-quoted shell -c argument
+ *
+ * @example
+ * ```ts
+ * // For malicious input
+ * const url = "http://localhost:3000'; cat /etc/passwd; echo '"
+ * const escaped = shellEscapeForDoubleQuotedCommand(url)
+ * // => "http://localhost:3000'\''; cat /etc/passwd; echo '"
+ *
+ * // Usage in command:
+ * const cmd = `/bin/sh -c "opencode attach ${escaped} --session ${sessionId}"`
+ * ```
+ */
+export declare function shellEscapeForDoubleQuotedCommand(value: string): string;

package/dist/shared/tmux/tmux-utils/environment.d.ts

@@ -1,3 +1,4 @@
 export type SplitDirection = "-h" | "-v";
+export declare function isInsideTmuxEnvironment(environment: Record<string, string | undefined>): boolean;
 export declare function isInsideTmux(): boolean;
 export declare function getCurrentPaneId(): string | undefined;

package/dist/shared/vision-capable-models-cache.d.ts

@@ -0,0 +1,4 @@
+import type { VisionCapableModel } from "../plugin-state";
+export declare function setVisionCapableModelsCache(cache: Map<string, VisionCapableModel>): void;
+export declare function readVisionCapableModelsCache(): VisionCapableModel[];
+export declare function clearVisionCapableModelsCache(): void;

package/dist/tools/call-omo-agent/background-executor.d.ts

@@ -1,6 +1,7 @@
 import type { CallOmoAgentArgs } from "./types";
 import type { BackgroundManager } from "../../features/background-agent";
 import type { PluginInput } from "@opencode-ai/plugin";
+import type { FallbackEntry } from "../../shared/model-requirements";
 export declare function executeBackground(args: CallOmoAgentArgs, toolContext: {
     sessionID: string;
     messageID: string;
@@ -10,4 +11,4 @@ export declare function executeBackground(args: CallOmoAgentArgs, toolContext: {
         title?: string;
         metadata?: Record<string, unknown>;
     }) => void;
-}, manager: BackgroundManager, client: PluginInput["client"]): Promise<string>;
+}, manager: BackgroundManager, client: PluginInput["client"], fallbackChain?: FallbackEntry[]): Promise<string>;

package/dist/tools/call-omo-agent/constants.d.ts

@@ -1,2 +1,2 @@
 export declare const ALLOWED_AGENTS: readonly ["explore", "librarian", "oracle", "hephaestus", "metis", "momus", "multimodal-looker"];
-export declare const CALL_OMO_AGENT_DESCRIPTION = "Spawn explore/librarian agent. run_in_background REQUIRED (true=async with task_id, false=sync).\n\nAvailable: {agents}\n\nPass `session_id=<id>` to continue previous agent with full context. Prompts MUST be in English. Use `background_output` for async results.";
+export declare const CALL_OMO_AGENT_DESCRIPTION = "Spawn explore/librarian agent. run_in_background REQUIRED (true=async with task_id, false=sync).\n\nAvailable: {agents}\n\nPass `session_id=<id>` to continue previous agent with full context. Nested subagent depth is tracked automatically and blocked past the configured limit. Prompts MUST be in English. Use `background_output` for async results.";

package/dist/tools/call-omo-agent/sync-executor.d.ts

@@ -1,12 +1,20 @@
 import type { CallOmoAgentArgs } from "./types";
 import type { PluginInput } from "@opencode-ai/plugin";
-import { createOrGetSession } from "./session-creator";
+import { clearSessionFallbackChain, setSessionFallbackChain } from "../../hooks/model-fallback/hook";
+import type { FallbackEntry } from "../../shared/model-requirements";
 import { waitForCompletion } from "./completion-poller";
 import { processMessages } from "./message-processor";
+import { createOrGetSession } from "./session-creator";
 type ExecuteSyncDeps = {
     createOrGetSession: typeof createOrGetSession;
     waitForCompletion: typeof waitForCompletion;
     processMessages: typeof processMessages;
+    setSessionFallbackChain: typeof setSessionFallbackChain;
+    clearSessionFallbackChain: typeof clearSessionFallbackChain;
+};
+type SpawnReservation = {
+    commit: () => number;
+    rollback: () => void;
 };
 export declare function executeSync(args: CallOmoAgentArgs, toolContext: {
     sessionID: string;
@@ -16,6 +24,6 @@ export declare function executeSync(args: CallOmoAgentArgs, toolContext: {
     metadata?: (input: {
         title?: string;
         metadata?: Record<string, unknown>;
-    }) => void;
-}, ctx: PluginInput, deps?: ExecuteSyncDeps): Promise<string>;
+    }) => void | Promise<void>;
+}, ctx: PluginInput, deps?: ExecuteSyncDeps, fallbackChain?: FallbackEntry[], spawnReservation?: SpawnReservation): Promise<string>;
 export {};

package/dist/tools/call-omo-agent/tools.d.ts

@@ -1,3 +1,4 @@
 import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
 import type { BackgroundManager } from "../../features/background-agent";
-export declare function createCallOmoAgent(ctx: PluginInput, backgroundManager: BackgroundManager, disabledAgents?: string[]): ToolDefinition;
+import type { CategoriesConfig, AgentOverrides } from "../../config/schema";
+export declare function createCallOmoAgent(ctx: PluginInput, backgroundManager: BackgroundManager, disabledAgents?: string[], agentOverrides?: AgentOverrides, userCategories?: CategoriesConfig): ToolDefinition;

package/dist/tools/delegate-task/cancel-unstable-agent-task.d.ts

@@ -0,0 +1,2 @@
+import type { ExecutorContext } from "./executor-types";
+export declare function cancelUnstableAgentTask(manager: ExecutorContext["manager"], taskID: string | undefined, reason: string): Promise<void>;

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

@@ -1,6 +1,7 @@
 import type { FallbackEntry } from "../../shared/model-requirements";
 export declare function resolveModelForDelegateTask(input: {
     userModel?: string;
+    userFallbackModels?: string[];
     categoryDefaultModel?: string;
     fallbackChain?: FallbackEntry[];
     availableModels: Set<string>;
@@ -8,4 +9,6 @@ export declare function resolveModelForDelegateTask(input: {
 }): {
     model: string;
     variant?: string;
+} | {
+    skipped: true;
 } | undefined;

package/dist/tools/delegate-task/model-string-parser.d.ts

@@ -1,7 +1,9 @@
-/**
- * Parse a model string in "provider/model" format.
- */
+export declare function parseVariantFromModelID(rawModelID: string): {
+    modelID: string;
+    variant?: string;
+};
 export declare function parseModelString(model: string): {
     providerID: string;
     modelID: string;
+    variant?: string;
 } | undefined;

package/dist/tools/hashline-edit/hash-computation.d.ts

@@ -1,4 +1,5 @@
 export declare function computeLineHash(lineNumber: number, content: string): string;
+export declare function computeLegacyLineHash(lineNumber: number, content: string): string;
 export declare function formatHashLine(lineNumber: number, content: string): string;
 export declare function formatHashLines(content: string): string;
 export interface HashlineStreamOptions {

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\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\n<must>\n- SNAPSHOT: All edits in one call reference the ORIGINAL file state. Do NOT adjust line numbers for prior edits in the same call \u2014 the system applies them bottom-up automatically.\n- replace removes lines pos..end (inclusive) and inserts lines in their place. Lines BEFORE pos and AFTER end are UNTOUCHED \u2014 do NOT include them in lines. If you do, they will appear twice.\n- lines must contain ONLY the content that belongs inside the consumed range. Content after end survives unchanged.\n- Tags MUST be copied exactly from read output or >>> mismatch output. NEVER guess tags.\n- Batch = multiple operations in edits[], NOT one big replace covering everything. Each operation targets the smallest possible change.\n- lines must contain plain replacement text only (no LINE#ID prefixes, no diff + markers).\n</must>\n\n<operations>\nLINE#ID FORMAT:\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\nOPERATION CHOICE:\n  replace with pos only -> replace one line at pos\n  replace with pos+end -> replace range pos..end inclusive 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 (also creates missing files)\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  lines: null or lines: [] with replace -> delete those lines.\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\nRULES:\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. Anchor to structural lines (function/class/brace), NEVER blank lines.\n  9. Re-read after each successful edit call before issuing another on the same file.\n</operations>\n\n<examples>\nGiven this file content after read:\n  10#VK|function hello() {\n  11#XJ|  console.log(\"hi\");\n  12#MB|  console.log(\"bye\");\n  13#QR|}\n  14#TN|\n  15#WS|function world() {\n\nSingle-line replace (change line 11):\n  { op: \"replace\", pos: \"11#XJ\", lines: [\"  console.log(\\\"hello\\\");\"] }\n  Result: line 11 replaced. Lines 10, 12-15 unchanged.\n\nRange replace (rewrite function body, lines 11-12):\n  { op: \"replace\", pos: \"11#XJ\", end: \"12#MB\", lines: [\"  return \\\"hello world\\\";\"] }\n  Result: lines 11-12 removed, replaced by 1 new line. Lines 10, 13-15 unchanged.\n\nDelete a line:\n  { op: \"replace\", pos: \"12#MB\", lines: null }\n  Result: line 12 removed. Lines 10-11, 13-15 unchanged.\n\nInsert after line 13 (between functions):\n  { op: \"append\", pos: \"13#QR\", lines: [\"\", \"function added() {\", \"  return true;\", \"}\"] }\n  Result: 4 new lines inserted after line 13. All existing lines unchanged.\n\nBAD \u2014 lines extend past end (DUPLICATES line 13):\n  { op: \"replace\", pos: \"11#XJ\", end: \"12#MB\", lines: [\"  return \\\"hi\\\";\", \"}\"] }\n  Line 13 is \"}\" which already exists after end. Including \"}\" in lines duplicates it.\n  CORRECT: { op: \"replace\", pos: \"11#XJ\", end: \"12#MB\", lines: [\"  return \\\"hi\\\";\"] }\n</examples>\n\n<auto>\nBuilt-in autocorrect (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  Boundary echo lines (duplicating adjacent surviving lines) are auto-stripped.\n</auto>\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.";

package/dist/tools/look-at/constants.d.ts

@@ -1,2 +1,2 @@
 export declare const MULTIMODAL_LOOKER_AGENT: "multimodal-looker";
-export declare const LOOK_AT_DESCRIPTION = "Analyze media files (PDFs, images, diagrams) that require interpretation beyond raw text. Extracts specific information or summaries from documents, describes visual content. Use when you need analyzed/extracted data rather than literal file contents.";
+export declare const LOOK_AT_DESCRIPTION = "Extract basic information from media files (PDFs, images, diagrams) when a quick summary suffices over precise reading. Good for simple text-based content extraction without using the Read tool. NEVER use for visual precision, aesthetic evaluation, or exact accuracy \u2014 use Read tool instead for those cases.";

package/dist/tools/look-at/multimodal-fallback-chain.d.ts

@@ -0,0 +1,4 @@
+import type { FallbackEntry } from "../../shared/model-requirements";
+import type { VisionCapableModel } from "../../plugin-state";
+export declare function isHardcodedMultimodalFallbackModel(model: VisionCapableModel): boolean;
+export declare function buildMultimodalLookerFallbackChain(visionCapableModels: VisionCapableModel[]): FallbackEntry[];

package/dist/tools/lsp/constants.d.ts

@@ -1,5 +1,6 @@
 export declare const DEFAULT_MAX_REFERENCES = 200;
 export declare const DEFAULT_MAX_SYMBOLS = 200;
 export declare const DEFAULT_MAX_DIAGNOSTICS = 200;
+export declare const DEFAULT_MAX_DIRECTORY_FILES = 50;
 export { SYMBOL_KIND_MAP, SEVERITY_MAP, EXT_TO_LANG } from "./language-mappings";
 export { BUILTIN_SERVERS, LSP_INSTALL_HINTS } from "./server-definitions";

package/dist/tools/lsp/directory-diagnostics.d.ts

@@ -0,0 +1 @@
+export declare function aggregateDiagnosticsForDirectory(directory: string, extension: string, severity?: "error" | "warning" | "information" | "hint" | "all", maxFiles?: number): Promise<string>;

package/dist/tools/lsp/lsp-client-transport.d.ts

@@ -13,8 +13,10 @@ export declare class LSPClientTransport {
     constructor(root: string, server: ResolvedServer);
     start(): Promise<void>;
     protected startStderrReading(): void;
-    protected sendRequest<T>(method: string, params?: unknown): Promise<T>;
-    protected sendNotification(method: string, params?: unknown): void;
+    protected sendRequest<T>(method: string): Promise<T>;
+    protected sendRequest<T>(method: string, params: unknown): Promise<T>;
+    protected sendNotification(method: string): void;
+    protected sendNotification(method: string, params: unknown): void;
     isAlive(): boolean;
     stop(): Promise<void>;
 }

package/dist/tools/lsp/lsp-client-wrapper.d.ts

@@ -1,7 +1,8 @@
 import { LSPClient } from "./client";
 import type { ServerLookupResult } from "./types";
-export declare function findWorkspaceRoot(filePath: string): string;
+export declare function isDirectoryPath(filePath: string): boolean;
 export declare function uriToPath(uri: string): string;
+export declare function findWorkspaceRoot(filePath: string): string;
 export declare function formatServerLookupError(result: Exclude<ServerLookupResult, {
     status: "found";
 }>): string;

package/dist/tools/lsp/server-path-bases.d.ts

@@ -0,0 +1 @@
+export declare function getLspServerAdditionalPathBases(workingDirectory: string): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "3.11.2",
+  "version": "3.12.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",
@@ -52,13 +52,13 @@
   },
   "homepage": "https://github.com/code-yeongyu/oh-my-openagent#readme",
   "dependencies": {
-    "@ast-grep/cli": "^0.40.0",
-    "@ast-grep/napi": "^0.40.0",
+    "@ast-grep/cli": "^0.41.1",
+    "@ast-grep/napi": "^0.41.1",
     "@clack/prompts": "^0.11.0",
     "@code-yeongyu/comment-checker": "^0.7.0",
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "@opencode-ai/plugin": "^1.2.16",
-    "@opencode-ai/sdk": "^1.2.17",
+    "@opencode-ai/plugin": "^1.2.24",
+    "@opencode-ai/sdk": "^1.2.24",
     "commander": "^14.0.2",
     "detect-libc": "^2.0.0",
     "diff": "^8.0.3",
@@ -72,24 +72,24 @@
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/picomatch": "^3.0.2",
-    "bun-types": "1.3.6",
+    "bun-types": "1.3.10",
     "typescript": "^5.7.3"
   },
   "optionalDependencies": {
-    "oh-my-opencode-darwin-arm64": "3.11.2",
-    "oh-my-opencode-darwin-x64": "3.11.2",
-    "oh-my-opencode-darwin-x64-baseline": "3.11.2",
-    "oh-my-opencode-linux-arm64": "3.11.2",
-    "oh-my-opencode-linux-arm64-musl": "3.11.2",
-    "oh-my-opencode-linux-x64": "3.11.2",
-    "oh-my-opencode-linux-x64-baseline": "3.11.2",
-    "oh-my-opencode-linux-x64-musl": "3.11.2",
-    "oh-my-opencode-linux-x64-musl-baseline": "3.11.2",
-    "oh-my-opencode-windows-x64": "3.11.2",
-    "oh-my-opencode-windows-x64-baseline": "3.11.2"
+    "oh-my-opencode-darwin-arm64": "3.12.0",
+    "oh-my-opencode-darwin-x64": "3.12.0",
+    "oh-my-opencode-darwin-x64-baseline": "3.12.0",
+    "oh-my-opencode-linux-arm64": "3.12.0",
+    "oh-my-opencode-linux-arm64-musl": "3.12.0",
+    "oh-my-opencode-linux-x64": "3.12.0",
+    "oh-my-opencode-linux-x64-baseline": "3.12.0",
+    "oh-my-opencode-linux-x64-musl": "3.12.0",
+    "oh-my-opencode-linux-x64-musl-baseline": "3.12.0",
+    "oh-my-opencode-windows-x64": "3.12.0",
+    "oh-my-opencode-windows-x64-baseline": "3.12.0"
   },
   "overrides": {
-    "@opencode-ai/sdk": "^1.2.17"
+    "@opencode-ai/sdk": "^1.2.24"
   },
   "trustedDependencies": [
     "@ast-grep/cli",