oh-my-opencode 4.7.5 → 4.8.1

package/dist/plugin/tool-registry-factories.d.ts

@@ -0,0 +1,36 @@
+import { createTeamApproveShutdownTool, createTeamCreateTool, createTeamDeleteTool, createTeamRejectShutdownTool, createTeamShutdownRequestTool } from "../features/team-mode/tools/lifecycle";
+import { createTeamSendMessageTool } from "../features/team-mode/tools/messaging";
+import { createTeamListTool, createTeamStatusTool } from "../features/team-mode/tools/query";
+import { createTeamTaskCreateTool, createTeamTaskGetTool, createTeamTaskListTool, createTeamTaskUpdateTool } from "../features/team-mode/tools/tasks";
+import { createBackgroundTools, createCallOmoAgent, createDelegateTask, createGlobTools, createGrepTools, createHashlineEditTool, createLookAt, createSessionManagerTools, createSkillMcpTool, createSkillTool, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, discoverCommandsSync, interactive_bash } from "../tools";
+export type ToolRegistryFactories = {
+    createBackgroundTools: typeof createBackgroundTools;
+    createCallOmoAgent: typeof createCallOmoAgent;
+    createLookAt: typeof createLookAt;
+    createSkillMcpTool: typeof createSkillMcpTool;
+    createSkillTool: typeof createSkillTool;
+    createGrepTools: typeof createGrepTools;
+    createGlobTools: typeof createGlobTools;
+    createSessionManagerTools: typeof createSessionManagerTools;
+    createDelegateTask: typeof createDelegateTask;
+    discoverCommandsSync: typeof discoverCommandsSync;
+    interactive_bash: typeof interactive_bash;
+    createTaskCreateTool: typeof createTaskCreateTool;
+    createTaskGetTool: typeof createTaskGetTool;
+    createTaskList: typeof createTaskList;
+    createTaskUpdateTool: typeof createTaskUpdateTool;
+    createHashlineEditTool: typeof createHashlineEditTool;
+    createTeamApproveShutdownTool: typeof createTeamApproveShutdownTool;
+    createTeamCreateTool: typeof createTeamCreateTool;
+    createTeamDeleteTool: typeof createTeamDeleteTool;
+    createTeamRejectShutdownTool: typeof createTeamRejectShutdownTool;
+    createTeamShutdownRequestTool: typeof createTeamShutdownRequestTool;
+    createTeamSendMessageTool: typeof createTeamSendMessageTool;
+    createTeamTaskCreateTool: typeof createTeamTaskCreateTool;
+    createTeamTaskGetTool: typeof createTeamTaskGetTool;
+    createTeamTaskListTool: typeof createTeamTaskListTool;
+    createTeamTaskUpdateTool: typeof createTeamTaskUpdateTool;
+    createTeamStatusTool: typeof createTeamStatusTool;
+    createTeamListTool: typeof createTeamListTool;
+};
+export declare const defaultToolRegistryFactories: ToolRegistryFactories;

package/dist/plugin/tool-registry-gated-tools.d.ts

@@ -0,0 +1,16 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { OhMyOpenCodeConfig } from "../config";
+import type { PluginContext } from "./types";
+import type { ToolRegistryFactories } from "./tool-registry-factories";
+export declare function createTaskToolsRecord(args: {
+    readonly taskSystemEnabled: boolean;
+    readonly pluginConfig: OhMyOpenCodeConfig;
+    readonly ctx: PluginContext;
+    readonly factories: ToolRegistryFactories;
+}): Record<string, ToolDefinition>;
+export declare function createHashlineToolsRecord(args: {
+    readonly pluginConfig: OhMyOpenCodeConfig;
+    readonly ctx: PluginContext;
+    readonly factories: ToolRegistryFactories;
+}): Record<string, ToolDefinition>;
+export declare function getTaskSystemEnabled(pluginConfig: OhMyOpenCodeConfig): boolean;

package/dist/plugin/tool-registry-team-tools.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { OhMyOpenCodeConfig } from "../config";
+import type { Managers } from "../create-managers";
+import type { PluginContext } from "./types";
+import type { ToolRegistryFactories } from "./tool-registry-factories";
+export declare function getSisyphusJuniorModelOverride(agentOverride?: {
+    model?: string;
+}): string | undefined;
+export declare function createTeamModeToolsRecord(args: {
+    readonly pluginConfig: OhMyOpenCodeConfig;
+    readonly ctx: PluginContext;
+    readonly managers: Pick<Managers, "backgroundManager" | "tmuxSessionManager">;
+    readonly factories: ToolRegistryFactories;
+}): Record<string, ToolDefinition>;

package/dist/plugin/tool-registry-trimming.d.ts

@@ -0,0 +1,2 @@
+import type { ToolsRecord } from "./types";
+export declare function trimToolsToCap(filteredTools: ToolsRecord, maxTools: number): void;

package/dist/plugin/tool-registry.d.ts

@@ -1,48 +1,14 @@
 import type { AvailableCategory } from "../agents/dynamic-agent-prompt-builder";
 import type { OhMyOpenCodeConfig } from "../config";
-import { createTeamApproveShutdownTool, createTeamCreateTool, createTeamDeleteTool, createTeamRejectShutdownTool, createTeamShutdownRequestTool } from "../features/team-mode/tools/lifecycle";
-import { createTeamSendMessageTool } from "../features/team-mode/tools/messaging";
-import { createTeamListTool, createTeamStatusTool } from "../features/team-mode/tools/query";
-import { createTeamTaskCreateTool, createTeamTaskGetTool, createTeamTaskListTool, createTeamTaskUpdateTool } from "../features/team-mode/tools/tasks";
-import type { PluginContext, ToolsRecord } from "./types";
-import { createBackgroundTools, createCallOmoAgent, createLookAt, createSkillMcpTool, createSkillTool, createGrepTools, createGlobTools, createSessionManagerTools, createDelegateTask, discoverCommandsSync, interactive_bash, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, createHashlineEditTool } from "../tools";
 import type { Managers } from "../create-managers";
 import type { SkillContext } from "./skill-context";
-type ToolRegistryFactories = {
-    createBackgroundTools: typeof createBackgroundTools;
-    createCallOmoAgent: typeof createCallOmoAgent;
-    createLookAt: typeof createLookAt;
-    createSkillMcpTool: typeof createSkillMcpTool;
-    createSkillTool: typeof createSkillTool;
-    createGrepTools: typeof createGrepTools;
-    createGlobTools: typeof createGlobTools;
-    createSessionManagerTools: typeof createSessionManagerTools;
-    createDelegateTask: typeof createDelegateTask;
-    discoverCommandsSync: typeof discoverCommandsSync;
-    interactive_bash: typeof interactive_bash;
-    createTaskCreateTool: typeof createTaskCreateTool;
-    createTaskGetTool: typeof createTaskGetTool;
-    createTaskList: typeof createTaskList;
-    createTaskUpdateTool: typeof createTaskUpdateTool;
-    createHashlineEditTool: typeof createHashlineEditTool;
-    createTeamApproveShutdownTool: typeof createTeamApproveShutdownTool;
-    createTeamCreateTool: typeof createTeamCreateTool;
-    createTeamDeleteTool: typeof createTeamDeleteTool;
-    createTeamRejectShutdownTool: typeof createTeamRejectShutdownTool;
-    createTeamShutdownRequestTool: typeof createTeamShutdownRequestTool;
-    createTeamSendMessageTool: typeof createTeamSendMessageTool;
-    createTeamTaskCreateTool: typeof createTeamTaskCreateTool;
-    createTeamTaskGetTool: typeof createTeamTaskGetTool;
-    createTeamTaskListTool: typeof createTeamTaskListTool;
-    createTeamTaskUpdateTool: typeof createTeamTaskUpdateTool;
-    createTeamStatusTool: typeof createTeamStatusTool;
-    createTeamListTool: typeof createTeamListTool;
-};
+import type { PluginContext, ToolsRecord } from "./types";
+import type { ToolRegistryFactories } from "./tool-registry-factories";
+export { trimToolsToCap } from "./tool-registry-trimming";
 export type ToolRegistryResult = {
     filteredTools: ToolsRecord;
     taskSystemEnabled: boolean;
 };
-export declare function trimToolsToCap(filteredTools: ToolsRecord, maxTools: number): void;
 export declare function createToolRegistry(args: {
     ctx: PluginContext;
     pluginConfig: OhMyOpenCodeConfig;
@@ -52,4 +18,3 @@ export declare function createToolRegistry(args: {
     interactiveBashEnabled?: boolean;
     toolFactories?: Partial<ToolRegistryFactories>;
 }): ToolRegistryResult;
-export {};

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

@@ -8,4 +8,4 @@
 export declare function scheduleDeferredModelOverride(messageId: string, targetModel: {
     providerID: string;
     modelID: string;
-}, variant?: string): void;
+}, variant?: string): Promise<void>;

package/dist/plugin-config/agent-order-warnings.d.ts

@@ -0,0 +1 @@
+export declare function addAgentOrderWarnings(configPath: string, agentOrder: string[] | undefined): void;

package/dist/plugin-config/config-merger.d.ts

@@ -0,0 +1,2 @@
+import type { OhMyOpenCodeConfig } from "../config";
+export declare function mergeConfigs(base: OhMyOpenCodeConfig, override: Partial<OhMyOpenCodeConfig>): OhMyOpenCodeConfig;

package/dist/plugin-config/layered-config-loader.d.ts

@@ -0,0 +1,2 @@
+import { type OhMyOpenCodeConfig } from "../config";
+export declare function loadPluginConfig(directory: string, ctx: unknown): OhMyOpenCodeConfig;

package/dist/plugin-config/single-config-loader.d.ts

@@ -0,0 +1,4 @@
+import { type OhMyOpenCodeConfig } from "../config";
+export declare function loadExplicitGitMasterOverrides(configPath: string): Record<string, unknown> | undefined;
+export declare function parseConfigPartially(rawConfig: Record<string, unknown>): Partial<OhMyOpenCodeConfig> | null;
+export declare function loadConfigFromPath(configPath: string, _ctx: unknown): Partial<OhMyOpenCodeConfig> | null;

package/dist/plugin-config.d.ts

@@ -1,5 +1,3 @@
-import { type OhMyOpenCodeConfig } from "./config";
-export declare function parseConfigPartially(rawConfig: Record<string, unknown>): OhMyOpenCodeConfig | null;
-export declare function loadConfigFromPath(configPath: string, _ctx: unknown): OhMyOpenCodeConfig | null;
-export declare function mergeConfigs(base: OhMyOpenCodeConfig, override: OhMyOpenCodeConfig): OhMyOpenCodeConfig;
-export declare function loadPluginConfig(directory: string, ctx: unknown): OhMyOpenCodeConfig;
+export { loadPluginConfig } from "./plugin-config/layered-config-loader";
+export { mergeConfigs } from "./plugin-config/config-merger";
+export { loadConfigFromPath, parseConfigPartially, } from "./plugin-config/single-config-loader";

package/dist/plugin-handlers/agent-config-assembly.d.ts

@@ -0,0 +1,19 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { OhMyOpenCodeConfig } from "../config";
+import type { AgentSources } from "./agent-config-types";
+type BuiltinAgentMap = Record<string, AgentConfig | undefined>;
+type AssembleAgentConfigParams = {
+    config: Record<string, unknown>;
+    pluginConfig: OhMyOpenCodeConfig;
+    builtinAgents: BuiltinAgentMap;
+    sources: AgentSources;
+    currentModel: string | undefined;
+    useTaskSystem: boolean;
+    disabledAgentNames: ReadonlySet<string>;
+};
+type AssemblyResult = {
+    configuredDefaultAgent: string | undefined;
+};
+export declare function getConfiguredDefaultAgent(config: Record<string, unknown>): string | undefined;
+export declare function assembleAgentConfig(params: AssembleAgentConfigParams): Promise<AssemblyResult>;
+export {};

package/dist/plugin-handlers/agent-config-finalizer.d.ts

@@ -0,0 +1,4 @@
+import type { ApplyAgentConfigParams } from "./agent-config-types";
+export declare function finalizeAgentConfig(params: Pick<ApplyAgentConfigParams, "config" | "pluginConfig"> & {
+    configuredDefaultAgent: string | undefined;
+}): Record<string, unknown>;

package/dist/plugin-handlers/agent-config-handler.d.ts

@@ -1,11 +1,2 @@
-import type { OhMyOpenCodeConfig } from "../config";
-import type { PluginComponents } from "./plugin-components-loader";
-export declare function applyAgentConfig(params: {
-    config: Record<string, unknown>;
-    pluginConfig: OhMyOpenCodeConfig;
-    ctx: {
-        directory: string;
-        client?: any;
-    };
-    pluginComponents: PluginComponents;
-}): Promise<Record<string, unknown>>;
+import type { ApplyAgentConfigParams } from "./agent-config-types";
+export declare function applyAgentConfig(params: ApplyAgentConfigParams): Promise<Record<string, unknown>>;

package/dist/plugin-handlers/agent-config-types.d.ts

@@ -0,0 +1,30 @@
+import type { OhMyOpenCodeConfig } from "../config";
+import type { PluginComponents } from "./plugin-components-loader";
+export type AgentConfigRecord = Record<string, Record<string, unknown> | undefined> & {
+    build?: Record<string, unknown>;
+    plan?: Record<string, unknown>;
+};
+export type ApplyAgentConfigParams = {
+    config: Record<string, unknown>;
+    pluginConfig: OhMyOpenCodeConfig;
+    ctx: {
+        directory: string;
+        client?: unknown;
+    };
+    pluginComponents: PluginComponents;
+};
+export type AgentSourceMap = Record<string, Record<string, unknown> | undefined>;
+export type AgentSources = {
+    userAgents: AgentSourceMap;
+    projectAgents: AgentSourceMap;
+    opencodeGlobalAgents: AgentSourceMap;
+    opencodeProjectAgents: AgentSourceMap;
+    pluginAgents: AgentSourceMap;
+    agentDefinitionAgents: AgentSourceMap;
+    opencodeConfigAgents: AgentSourceMap;
+    configAgent: AgentConfigRecord | undefined;
+    customAgentSummaries: Array<{
+        name: string;
+        description: string;
+    }>;
+};

package/dist/plugin-handlers/agent-skill-discovery.d.ts

@@ -0,0 +1,3 @@
+import type { LoadedSkill } from "../features/opencode-skill-loader";
+import type { ApplyAgentConfigParams } from "./agent-config-types";
+export declare function discoverAgentSkills(params: Pick<ApplyAgentConfigParams, "config" | "pluginConfig" | "ctx">): Promise<LoadedSkill[]>;

package/dist/plugin-handlers/agent-source-loader.d.ts

@@ -0,0 +1,2 @@
+import type { AgentSources, ApplyAgentConfigParams } from "./agent-config-types";
+export declare function loadAgentSources(params: ApplyAgentConfigParams): AgentSources;

package/dist/plugin-handlers/hook-config-handler.d.ts

@@ -1,7 +1,4 @@
 import type { PluginComponents } from "./plugin-components-loader";
 export declare function applyHookConfig(params: {
     pluginComponents: PluginComponents;
-    ctx: {
-        directory: string;
-    };
 }): void;

package/dist/shared/context-window-usage.d.ts

@@ -0,0 +1,7 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type ContextLimitModelCacheState } from "./context-limit-resolver";
+import type { ContextWindowUsage } from "./dynamic-truncator-types";
+export declare const DEFAULT_CONTEXT_WINDOW_USAGE_FETCH_TIMEOUT_MS = 5000;
+export declare function _setContextWindowUsageFetchTimeoutMsForTesting(ms: number | undefined): void;
+export declare function invalidateContextWindowUsageCache(ctx: PluginInput, sessionID?: string): void;
+export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ContextLimitModelCacheState): Promise<ContextWindowUsage | null>;

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

@@ -0,0 +1,17 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export type ContextWindowUsage = {
+    usedTokens: number;
+    remainingTokens: number;
+    usagePercentage: number;
+};
+export type ContextWindowUsageClient = Pick<PluginInput["client"], "session">;
+export interface TruncationResult {
+    result: string;
+    truncated: boolean;
+    removedCount?: number;
+}
+export interface TruncationOptions {
+    targetMaxTokens?: number;
+    preserveHeaderLines?: number;
+    contextWindowLimit?: number;
+}

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

@@ -1,29 +1,14 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-import { type ContextLimitModelCacheState } from "./context-limit-resolver";
-export declare const DEFAULT_CONTEXT_WINDOW_USAGE_FETCH_TIMEOUT_MS = 5000;
-type ContextWindowUsage = {
-    usedTokens: number;
-    remainingTokens: number;
-    usagePercentage: number;
-};
-export declare function _setContextWindowUsageFetchTimeoutMsForTesting(ms: number | undefined): void;
-export declare function invalidateContextWindowUsageCache(ctx: PluginInput, sessionID?: string): void;
-export interface TruncationResult {
-    result: string;
-    truncated: boolean;
-    removedCount?: number;
-}
-export interface TruncationOptions {
-    targetMaxTokens?: number;
-    preserveHeaderLines?: number;
-    contextWindowLimit?: number;
-}
-export declare function truncateToTokenLimit(output: string, maxTokens: number, preserveHeaderLines?: number): TruncationResult;
-export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ContextLimitModelCacheState): Promise<ContextWindowUsage | null>;
+import type { ContextLimitModelCacheState } from "./context-limit-resolver";
+import { getContextWindowUsage, invalidateContextWindowUsageCache, _setContextWindowUsageFetchTimeoutMsForTesting, DEFAULT_CONTEXT_WINDOW_USAGE_FETCH_TIMEOUT_MS } from "./context-window-usage";
+import type { TruncationOptions, TruncationResult } from "./dynamic-truncator-types";
+import { truncateToTokenLimit } from "./token-limit-truncator";
+export { DEFAULT_CONTEXT_WINDOW_USAGE_FETCH_TIMEOUT_MS, getContextWindowUsage, invalidateContextWindowUsageCache, _setContextWindowUsageFetchTimeoutMsForTesting, };
+export { truncateToTokenLimit };
+export type { TruncationOptions, TruncationResult };
 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<ContextWindowUsage | null>;
+    getUsage: (sessionID: string) => Promise<import("./dynamic-truncator-types").ContextWindowUsage | null>;
     truncateSync: (output: string, maxTokens: number, preserveHeaderLines?: number) => TruncationResult;
 };
-export {};

package/dist/shared/migration/migrations-sidecar.d.ts

@@ -3,7 +3,7 @@
  * config file.
  *
  * Why this exists (#3263): users who revert an auto-migrated value (e.g.
- * `gpt-5.4` → `gpt-5.3-codex`) and then delete the `_migrations` field from
+ * `gpt-5.4` → `gpt-5.5`) and then delete the `_migrations` field from
  * their config would fall into an infinite migration loop — every startup
  * re-applied the migration because there was no memory of the previous
  * application. The sidecar remembers applied migrations even when the user
@@ -16,7 +16,7 @@
  *
  *     {
  *       "appliedMigrations": [
- *         "model-version:openai/gpt-5.3-codex->openai/gpt-5.4",
+ *         "model-version:openai/gpt-5.4->openai/gpt-5.5",
  *         "model-version:anthropic/claude-opus-4-5->anthropic/claude-opus-4-7"
  *       ]
  *     }

package/dist/shared/migration/model-versions.d.ts

@@ -6,10 +6,13 @@
  * Keys are full "provider/model" strings. Only openai and anthropic entries needed.
  *
  * Only include genuinely retired/superseded models here. Do NOT add mappings
- * for current, user-selectable variants — `gpt-5.3-codex` is the canonical
- * codex powerhouse referenced in docs/guide/agent-model-matching.md and is
- * NOT a deprecated alias for `gpt-5.4`. Auto-rewriting an explicit user
- * choice silently broke configurations (#3777).
+ * for current, user-selectable variants like `gpt-5.5`, the canonical
+ * codex powerhouse referenced in docs/guide/agent-model-matching.md. The
+ * same rule applies to top-level primary models like `openai/gpt-5.4`
+ * while they remain user-selectable:
+ * config migrations must not silently rewrite an explicit user choice to a
+ * newer default. Auto-rewriting current models broke configs in practice
+ * (#3777, #4527).
  */
 export declare const MODEL_VERSION_MAP: Record<string, string>;
 export declare function migrateModelVersions(configs: Record<string, unknown>, appliedMigrations?: Set<string>): {

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

@@ -14,7 +14,7 @@
  * If providers array is given, only models starting with "provider/" are considered.
  *
  * @example
- * const available = new Set(["openai/gpt-5.4", "openai/gpt-5.3-codex", "anthropic/claude-opus-4-7"])
+ * const available = new Set(["openai/gpt-5.4", "openai/gpt-5.5", "anthropic/claude-opus-4-7"])
  * fuzzyMatchModel("gpt-5.4", available) // → "openai/gpt-5.4"
  * fuzzyMatchModel("claude", available, ["openai"]) // → null (provider filter excludes anthropic)
  */

package/dist/shared/opencode-version.d.ts

@@ -1,8 +1,8 @@
 /**
  * Minimum OpenCode version required for this plugin.
- * This plugin only supports OpenCode 1.1.1+ which uses the permission system.
+ * This plugin only supports OpenCode 1.4.0+.
  */
-export declare const MINIMUM_OPENCODE_VERSION = "1.1.1";
+export declare const MINIMUM_OPENCODE_VERSION = "1.4.0";
 /**
  * OpenCode version that introduced native AGENTS.md injection.
  * PR #10678 merged on Jan 26, 2026 - OpenCode now dynamically resolves

package/dist/shared/sparkshell-awareness.d.ts

@@ -0,0 +1,5 @@
+type RuntimeEnv = Readonly<Record<string, string | undefined>>;
+export declare function isCodexAppServerActive(env?: RuntimeEnv): boolean;
+export declare function getSparkShellRuntimeAwareness(env?: RuntimeEnv): string;
+export declare function hasSparkShellRuntimeAwareness(value: string): boolean;
+export {};

package/dist/shared/spawn-with-windows-hide.d.ts

@@ -1,3 +1,4 @@
+import { type ChildProcess } from "node:child_process";
 export interface SpawnOptions {
     cwd?: string;
     env?: Record<string, string | undefined>;
@@ -12,4 +13,5 @@ export interface SpawnedProcess {
     readonly stderr: ReadableStream<Uint8Array> | undefined;
     kill(signal?: NodeJS.Signals): void;
 }
+export declare function wrapNodeProcess(proc: ChildProcess): SpawnedProcess;
 export declare function spawnWithWindowsHide(command: string[], options: SpawnOptions): SpawnedProcess;

package/dist/shared/token-limit-truncator.d.ts

@@ -0,0 +1,2 @@
+import type { TruncationResult } from "./dynamic-truncator-types";
+export declare function truncateToTokenLimit(output: string, maxTokens: number, preserveHeaderLines?: number): TruncationResult;

package/dist/testing/module-mock-lifecycle.d.ts

@@ -14,8 +14,16 @@ type ModuleMockLifecycleOptions = {
     getCallerUrl?: () => string;
     resolveSpecifier?: (specifier: string, callerUrl: string) => string;
     loadOriginalModule?: (specifier: string, callerUrl: string) => ModuleLoadResult;
+    shouldPreserveActiveMocksOnRestore?: () => boolean;
+    registerGlobalRestore?: boolean;
 };
+export declare function normalizeStackPath(rawPath: string): string;
+export declare function getCallerUrlFromStack(stack: string, fallbackUrl: string): string;
 export declare function installModuleMockLifecycle(mockApi: MockApi, options?: ModuleMockLifecycleOptions): {
+    preserveModuleMocksForTestFile: (callerUrl: string) => void;
     restoreModuleMocks: () => void;
+    restoreModuleMocksForTestFile: (callerUrl: string) => void;
 };
+export declare function preserveModuleMocksForTestFile(callerUrl: string): void;
+export declare function restoreModuleMocksForTestFile(callerUrl: string): void;
 export {};

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

@@ -1,6 +1,5 @@
 import type { BuiltinCategoryDefinition } from "./builtin-category-definition";
 export declare const DEEP_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on GOAL-ORIENTED AUTONOMOUS tasks.\n\nYou are NOT an interactive assistant. You are an autonomous problem-solver.\n\nBEFORE making ANY changes:\n1. Silently explore the codebase extensively (5-15 minutes of reading is normal)\n2. Read related files, trace dependencies, understand the full context\n3. Build a complete mental model of the problem space\n4. Do not ask clarifying questions - the goal is already defined\n\nYou receive a GOAL. When the goal includes numbered steps or phases, treat them as one atomic task broken into sub-steps, not as separate independent tasks. Figure out HOW to achieve it yourself. Thorough research before any action.\n\nSub-steps of ONE goal = execute all steps as phases of one atomic task.\nGenuinely independent tasks = flag and refuse, require separate delegations.\n\nApproach: explore extensively, understand deeply, then act decisively. Prefer comprehensive solutions over quick patches. If the goal is unclear, make reasonable assumptions and proceed.\n\nMinimal status updates. Focus on results, not play-by-play. Report completion with summary of changes.\n</Category_Context>";
-export declare const DEEP_CATEGORY_PROMPT_APPEND_GPT_5_3_CODEX = "<Category_Context name=\"deep\">\nYou are operating in DEEP mode on GPT-5.3-Codex. This category is reserved for goal-oriented autonomous coding work on hairy problems that reward depth over speed and a complete solution over a quick patch.\n\nThe orchestrator routed you here for autonomous execution. Do not stop to ask the orchestrator for permission, do not produce an upfront plan and wait for approval, do not stop at a proof of concept.\n\n# Autonomy and persistence\n\n- Once the goal is given, gather context, implement, verify, and explain outcomes within this turn whenever feasible.\n- Persist end-to-end: do not stop at analysis or partial fixes; carry changes through implementation, verification, and a clear explanation unless you hit a genuine blocker (missing secret, design decision only the user can make, three materially different attempts all failed).\n- Bias to action: default to implementing with reasonable assumptions. Do not end your turn with clarifying questions unless truly blocked. Document assumptions in the final message instead.\n- Avoid excessive looping. If you find yourself re-reading or re-editing the same files without clear progress, stop and end the turn with a concise summary and any clarifying questions needed.\n\n# Goal, not plan\n\nYou receive a GOAL describing the desired outcome. You figure out HOW. The orchestrator deliberately did not hand you a step-by-step plan; producing one and pausing for approval is not what was asked.\n\nWhen the goal contains numbered steps or phases, treat them as sub-steps of ONE atomic task and execute them all in this turn. Splitting them across turns is wrong unless they reveal an architectural blocker that requires the user's input. If the steps turn out to be genuinely independent tasks that should have been separate delegations, flag that in your final message and refuse the ones beyond scope.\n\n# Exploration\n\n- Think first. Before any tool call, decide ALL files and resources you will need.\n- Batch everything. If you need multiple files (even from different places), read them together using parallel tool calls.\n- Always maximize parallelism: never read files one-by-one unless logically unavoidable. For broader questions fire 2-5 explore/librarian sub-agents in parallel.\n- Workflow: (a) plan all needed reads, (b) issue one parallel batch, (c) analyze results, (d) repeat if new unpredictable reads arise. Sequential reads only when you truly cannot know the next file without seeing a prior result first.\n\nBuild a complete mental model before the first edit. Exploration is an investment, not overhead - the orchestrator routed depth tasks here specifically because rushing to implementation is the failure mode.\n\n# Code implementation\n\n- Discerning engineer mindset: optimize for correctness, clarity, and reliability over speed. Cover the root cause, not just a symptom or a narrow slice. Trace at least two levels up before settling - a null check around `foo()` is a symptom; fixing what causes `foo()` to return unexpected values is the root.\n- Conform to codebase conventions: follow existing patterns, helpers, naming, formatting, localization. If you must diverge, state why.\n- Behavior-safe defaults: preserve intended behavior and UX; gate or flag intentional changes; add tests when behavior shifts.\n- Tight error handling: no broad try/catch blocks, no success-shaped fallbacks; propagate or surface errors explicitly. No silent failures - do not early-return on invalid input without logging consistent with repo patterns.\n- Efficient, coherent edits: read enough context before changing a file; batch logical edits together rather than thrashing with many tiny patches.\n- Type safety: changes must pass build and type-check; avoid `as any` or `as unknown as ...`; prefer proper types and guards; reuse existing helpers.\n- Reuse / DRY: search for prior art before adding helpers; reuse or extract a shared helper instead of duplicating.\n- Ambition scaled to context: greenfield = strong defaults, avoid AI-slop, produce work you would hand to another senior engineer. Existing codebase = surgical, respect existing patterns. Depth does not mean invasiveness.\n\n# Completion bar\n\n\"Simplified version\", \"proof of concept\", and \"you can extend this later\" are not acceptable for a deep task. The orchestrator routed here specifically for a complete solution. If you hit a genuine blocker, document it and return; otherwise, finish the task.\n\n# Worktree safety\n\n- NEVER revert existing changes you did not make unless explicitly requested - those changes were made by the user.\n- If asked to commit and there are unrelated changes in those files, do not revert them.\n- If you notice unexpected changes you did not make in unrelated files, ignore them.\n- If you notice unexpected mid-rollout changes you did not make and are not sure how to proceed, stop and ask.\n- NEVER use destructive commands like `git reset --hard` or `git checkout --` unless explicitly requested.\n\n# Status cadence\n\nThe user is not on the other side of this conversation; the orchestrator is, and they will synthesize your progress. Send commentary only at meaningful phase transitions (starting exploration, starting implementation, starting verification, hitting a genuine blocker). Do not narrate every tool call; silence during focused work is expected.\n\nIf you used a planning tool, mark every previously stated intention as Done, Blocked (one-sentence reason + targeted question), or Cancelled (with reason) before finishing. Do not end with in_progress or pending items.\n\n# Final message\n\n- Be concise; pragmatic, not chatty. Higher actionable information per token; fewer social flourishes.\n- Lead with a quick explanation of the change, then context covering where and why. Do not start with \"Summary\"; jump in.\n- Reference paths only - do not dump file contents. Do not say \"save/copy this file\" - the user is on the same machine.\n- For substantial work, summarize clearly with high-level headings.\n- File references: inline code with standalone path. Examples: `src/app.ts`, `src/app.ts:42`. Do not use `file://`, `vscode://`, or `https://` URIs. Do not provide line ranges.\n- Suggest natural next steps (tests, commits, build) only if there are real ones; otherwise omit.\n</Category_Context>";
 export declare const DEEP_CATEGORY_PROMPT_APPEND_GPT_5_5 = "<Category_Context name=\"deep\">\nYou are operating in DEEP mode. This is the category reserved for goal-oriented autonomous work on hairy problems that reward thorough exploration and comprehensive solutions.\n\nThe orchestrator chose this category because the task benefits from depth over speed. You should feel empowered to spend the time needed: five to fifteen minutes of silent exploration before the first edit is normal and correct. Rushing to implementation on a deep task is a failure mode, not a feature.\n\n# How deep mode adjusts the base behavior\n\n**Exploration budget: generous.** Read the files you need, trace dependencies both directions, fire 2-5 explore/librarian sub-agents in parallel for broader questions. Build a complete mental model before the first `apply_patch`. Exploration here is an investment, not overhead.\n\n**Goal, not plan.** You receive a GOAL describing the desired outcome. You figure out HOW to achieve it. The orchestrator deliberately did not hand you a step-by-step plan; producing one and asking for approval is not what was asked. Execute.\n\n**Atomic task treatment.** When the goal contains numbered steps or phases, treat them as sub-steps of ONE task and execute them all in this turn. Splitting them across turns is wrong unless they reveal an architectural blocker that requires the user's input. If the \"steps\" turn out to be genuinely independent tasks that should have been separate delegations, flag that in your final message and refuse the ones beyond scope.\n\n**Root cause bias.** Prefer root-cause fixes over symptom fixes. A null check around `foo()` is a symptom fix; fixing whatever causes `foo()` to return unexpected values is the root fix. Trace at least two levels up before settling on an answer. In deep mode, you have permission (and the expectation) to do the deeper fix.\n\n**Ambition scaled to context.** For brand-new greenfield work, be ambitious. Choose strong defaults, avoid AI-slop aesthetics, produce something you would be proud to hand to another senior engineer. For changes in an existing codebase, be surgical and respect the existing patterns; depth does not mean invasiveness.\n\n**Completion bar: full delivery.** \"Simplified version\", \"proof of concept\", and \"you can extend this later\" are not acceptable deliveries for a deep task. The orchestrator routed here specifically for a complete solution. If you hit a genuine blocker (missing secret, design decision only the user can make, three materially different attempts all failed), document it and return; otherwise, finish the task.\n\n**Status cadence: sparse.** The user is not on the other side of this conversation; the orchestrator is, and they will synthesize your progress. Send commentary only at meaningful phase transitions (starting exploration, starting implementation, starting verification, hitting a genuine blocker). Do not narrate every tool call; silence during focused work is expected.\n</Category_Context>";
 export declare function resolveDeepCategoryPromptAppend(model: string | undefined): string;
 export declare const OPENAI_CATEGORIES: BuiltinCategoryDefinition[];

package/dist/tools/delegate-task/subagent-agent-match.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from "./executor-types";
+import type { ResolveSubagentExecutionOptions, SubagentAgentMatch } from "./subagent-resolution-types";
+export declare function resolveSubagentAgentMatch(requestedAgent: string, executorCtx: ExecutorContext, options: ResolveSubagentExecutionOptions): Promise<SubagentAgentMatch>;

package/dist/tools/delegate-task/subagent-model-resolution.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutorContext } from "./executor-types";
+import type { AgentInfo } from "./subagent-discovery";
+import type { ResolvedSubagentModel } from "./subagent-resolution-types";
+export declare function resolveSubagentModel(agentToUse: string, matchedAgent: AgentInfo, executorCtx: ExecutorContext): Promise<ResolvedSubagentModel>;

package/dist/tools/delegate-task/subagent-request-preflight.d.ts

@@ -0,0 +1,3 @@
+import type { DelegateTaskArgs } from "./types";
+import type { ResolveSubagentExecutionOptions, SubagentRequestPreflight } from "./subagent-resolution-types";
+export declare function validateSubagentRequest(args: DelegateTaskArgs, parentAgent: string | undefined, categoryExamples: string, options: ResolveSubagentExecutionOptions): SubagentRequestPreflight;

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

@@ -0,0 +1,32 @@
+import type { FallbackEntry } from "../../shared/model-requirements";
+import type { AgentInfo } from "./subagent-discovery";
+import type { DelegatedModelConfig } from "./types";
+export interface ResolveSubagentExecutionOptions {
+    allowSisyphusJuniorDirect?: boolean;
+    allowPrimaryAgentDelegation?: boolean;
+}
+export interface ResolveSubagentExecutionResult {
+    agentToUse: string;
+    categoryModel: DelegatedModelConfig | undefined;
+    fallbackChain?: FallbackEntry[];
+    error?: string;
+}
+export type SubagentRequestPreflight = {
+    readonly kind: "valid";
+    readonly agentName: string;
+} | {
+    readonly kind: "invalid";
+    readonly result: ResolveSubagentExecutionResult;
+};
+export type SubagentAgentMatch = {
+    readonly kind: "matched";
+    readonly agentToUse: string;
+    readonly matchedAgent: AgentInfo;
+} | {
+    readonly kind: "error";
+    readonly result: ResolveSubagentExecutionResult;
+};
+export interface ResolvedSubagentModel {
+    readonly categoryModel: DelegatedModelConfig | undefined;
+    readonly fallbackChain: FallbackEntry[] | undefined;
+}

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

@@ -1,14 +1,5 @@
 import type { DelegateTaskArgs } from "./types";
 import type { ExecutorContext } from "./executor-types";
-import type { DelegatedModelConfig } from "./types";
-import type { FallbackEntry } from "../../shared/model-requirements";
-export interface ResolveSubagentExecutionOptions {
-    allowSisyphusJuniorDirect?: boolean;
-    allowPrimaryAgentDelegation?: boolean;
-}
-export declare function resolveSubagentExecution(args: DelegateTaskArgs, executorCtx: ExecutorContext, parentAgent: string | undefined, categoryExamples: string, options?: ResolveSubagentExecutionOptions): Promise<{
-    agentToUse: string;
-    categoryModel: DelegatedModelConfig | undefined;
-    fallbackChain?: FallbackEntry[];
-    error?: string;
-}>;
+import type { ResolveSubagentExecutionOptions, ResolveSubagentExecutionResult } from "./subagent-resolution-types";
+export type { ResolveSubagentExecutionOptions, ResolveSubagentExecutionResult };
+export declare function resolveSubagentExecution(args: DelegateTaskArgs, executorCtx: ExecutorContext, parentAgent: string | undefined, categoryExamples: string, options?: ResolveSubagentExecutionOptions): Promise<ResolveSubagentExecutionResult>;

package/dist/tools/delegate-task/sync-completion-message.d.ts

@@ -0,0 +1,20 @@
+import type { ParentContext } from "./executor-types";
+import type { DelegatedModelConfig, DelegateTaskArgs } from "./types";
+export declare function buildRecoveredSyncTaskCompletion(input: {
+    readonly activeSessionID: string;
+    readonly agentToUse: string;
+    readonly args: DelegateTaskArgs;
+    readonly effectiveCategoryModel: DelegatedModelConfig | undefined;
+    readonly parentContext: ParentContext;
+    readonly startTime: Date;
+    readonly textContent: string;
+}): string;
+export declare function buildSyncTaskCompletion(input: {
+    readonly activeSessionID: string;
+    readonly agentToUse: string;
+    readonly args: DelegateTaskArgs;
+    readonly effectiveCategoryModel: DelegatedModelConfig | undefined;
+    readonly parentContext: ParentContext;
+    readonly startTime: Date;
+    readonly textContent: string;
+}): string;

package/dist/tools/delegate-task/sync-poll-error-recovery.d.ts

@@ -0,0 +1 @@
+export declare function shouldAttemptPollErrorRecovery(pollError: string): boolean;

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

@@ -0,0 +1,12 @@
+import type { ExecutorContext, ParentContext } from "./executor-types";
+import type { DelegateTaskArgs } from "./types";
+export declare function registerSyncSessionSideEffects(input: {
+    readonly args: DelegateTaskArgs;
+    readonly executorCtx: ExecutorContext;
+    readonly sessionID: string;
+    readonly parentContext: ParentContext;
+    readonly agentToUse: string;
+    readonly fallbackChain: import("../../shared/model-requirements").FallbackEntry[] | undefined;
+    readonly systemContent: string | undefined;
+}): Promise<void>;
+export declare function cleanupSyncSessionSideEffects(sessionID: string, executorCtx: Pick<ExecutorContext, "modelFallbackControllerAccessor">): void;

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

@@ -10,4 +10,6 @@ export declare function pollSyncSession(ctx: ToolContextWithMetadata, client: Op
     taskId: string | undefined;
     anchorMessageCount?: number;
     maxAssistantTurns?: number;
+    hasActiveChildBackgroundTasks?: (sessionID: string) => boolean;
+    childWakeGraceMs?: number;
 }, timeoutMs?: number): Promise<string | null>;

package/dist/tools/delegate-task/sync-spawn-reservation.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutorContext, ParentContext } from "./executor-types";
+export interface SyncSpawnReservation {
+    readonly spawnContext: {
+        readonly rootSessionID: string;
+        readonly parentDepth: number;
+        readonly childDepth: number;
+    };
+    readonly reservation: Awaited<ReturnType<ExecutorContext["manager"]["reserveSubagentSpawn"]>> | undefined;
+}
+export declare function reserveSyncSubagentSpawn(executorCtx: Pick<ExecutorContext, "manager">, parentContext: Pick<ParentContext, "sessionID">): Promise<SyncSpawnReservation>;

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

@@ -0,0 +1,11 @@
+import type { ParentContext } from "./executor-types";
+import type { DelegatedModelConfig, DelegateTaskArgs, ToolContextWithMetadata } from "./types";
+export declare function publishSyncTaskMetadata(input: {
+    readonly args: DelegateTaskArgs;
+    readonly ctx: ToolContextWithMetadata;
+    readonly currentSessionID: string;
+    readonly currentModel: DelegatedModelConfig | undefined;
+    readonly parentContext: ParentContext;
+    readonly agentToUse: string;
+    readonly spawnDepth: number;
+}): Promise<void>;