@opencow-ai/opencow-agent-sdk 0.4.6 → 0.4.7

package/dist/constants/tools.d.ts

@@ -6,7 +6,7 @@ export declare const ASYNC_AGENT_ALLOWED_TOOLS: Set<string>;
  * These are injected by inProcessRunner.ts and allowed through filterToolsForAgent
  * via isInProcessTeammate() check.
  */
-export declare const IN_PROCESS_TEAMMATE_ALLOWED_TOOLS: Set<any>;
+export declare const IN_PROCESS_TEAMMATE_ALLOWED_TOOLS: Set<string>;
 /**
  * Tools allowed in coordinator mode - only output and agent management tools for the coordinator
  */

package/dist/controller/hooks.d.ts

@@ -218,7 +218,10 @@ export declare function executeStopFailureHooks(lastMessage: AssistantMessage, t
  * @param messages Optional conversation history for prompt/function hooks
  * @returns Async generator that yields progress messages and blocking errors
  */
-export declare function executeStopHooks(permissionMode?: string, signal?: AbortSignal, timeoutMs?: number, stopHookActive?: boolean, subagentId?: AgentId, toolUseContext?: ToolRuntimeContext, messages?: Message[], agentType?: string, requestPrompt?: (sourceName: string, toolInputSummary?: string | null) => (request: PromptRequest) => Promise<PromptResponse>): AsyncGenerator<AggregatedHookResult>;
+export declare function executeStopHooks(permissionMode?: string, signal?: AbortSignal, timeoutMs?: number, stopHookActive?: boolean, subagentId?: AgentId, toolUseContext?: ToolRuntimeContext, messages?: Message[], agentType?: string, requestPrompt?: (sourceName: string, toolInputSummary?: string | null) => (request: PromptRequest) => Promise<PromptResponse>, terminal?: {
+    status: 'completed' | 'failed' | 'stopped';
+    errorMessage?: string;
+}): AsyncGenerator<AggregatedHookResult>;
 /**
  * Execute TeammateIdle hooks when a teammate is about to go idle.
  * If a hook blocks (exit code 2), the teammate should continue working instead of going idle.
@@ -296,7 +299,19 @@ export declare function executeSetupHooks(trigger: 'init' | 'maintenance', signa
  * @param timeoutMs Optional timeout in milliseconds for hook execution
  * @returns Async generator that yields progress messages and hook results
  */
-export declare function executeSubagentStartHooks(agentId: string, agentType: string, signal?: AbortSignal, timeoutMs?: number): AsyncGenerator<AggregatedHookResult>;
+export declare function executeSubagentStartHooks(agentId: string, agentType: string, signal?: AbortSignal, timeoutMs?: number, toolUseId?: string, isBackground?: boolean): AsyncGenerator<AggregatedHookResult>;
+/**
+ * Fire a SubagentProgress hook carrying one of a background sub-agent's
+ * completed messages (its content blocks, already simplified). Lets a host
+ * stream a background sub-agent's running sub-conversation (thinking / text /
+ * tool calls) into its UI out-of-band — i.e. while the main turn is idle —
+ * reusing the same per-message reduction it uses for foreground sub-agents.
+ *
+ * Fire-and-forget by design: callers must NOT await the per-message firing in
+ * the agent's hot loop. `blocks` is intentionally loosely typed (hook inputs
+ * are `any` in coreTypes) and mirrors the host's normalized event shapes.
+ */
+export declare function executeSubagentProgressHooks(agentId: string, agentType: string, messageId: string, parentToolUseId: string | undefined, blocks: Array<Record<string, unknown>>, signal?: AbortSignal): Promise<void>;
 /**
  * Execute pre-compact hooks if configured
  * @param compactData The compact data to pass to hooks

package/dist/controller/loop.d.ts

@@ -1,3 +1,4 @@
+import type { ProviderOverride } from '../providers/shared/routing.js';
 import type { BetaJSONOutputFormat, BetaMessage, BetaMessageStreamParams, BetaToolChoiceAuto, BetaToolChoiceTool, BetaToolUnion } from '@anthropic-ai/sdk/resources/beta/messages/messages.mjs';
 import { type QueryChainTracking, type ToolPermissionContext, type Tools } from '../Tool.js';
 import type { AgentDefinition } from '../capabilities/tools/AgentTool/loadAgentsDir.js';
@@ -54,11 +55,7 @@ export type Options = {
         total: number;
         remaining?: number;
     };
-    providerOverride?: {
-        model: string;
-        baseURL: string;
-        apiKey: string;
-    };
+    providerOverride?: ProviderOverride;
 };
 export declare function queryModelWithoutStreaming({ messages, systemPrompt, thinkingConfig, tools, signal, options, }: {
     messages: Message[];

package/dist/entrypoints/sdk/controlSchemas.d.ts

@@ -601,6 +601,8 @@ export declare const SDKHookCallbackRequestSchema: () => z.ZodObject<{
         hook_event_name: z.ZodLiteral<"SubagentStart">;
         agent_id: z.ZodString;
         agent_type: z.ZodString;
+        tool_use_id: z.ZodOptional<z.ZodString>;
+        is_background: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
         session_id: z.ZodString;
         transcript_path: z.ZodString;
@@ -615,6 +617,12 @@ export declare const SDKHookCallbackRequestSchema: () => z.ZodObject<{
         agent_transcript_path: z.ZodString;
         agent_type: z.ZodString;
         last_assistant_message: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+            stopped: "stopped";
+        }>>;
+        error_message: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
         session_id: z.ZodString;
         transcript_path: z.ZodString;
@@ -1458,6 +1466,8 @@ export declare const SDKControlRequestInnerSchema: () => z.ZodUnion<readonly [z.
         hook_event_name: z.ZodLiteral<"SubagentStart">;
         agent_id: z.ZodString;
         agent_type: z.ZodString;
+        tool_use_id: z.ZodOptional<z.ZodString>;
+        is_background: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
         session_id: z.ZodString;
         transcript_path: z.ZodString;
@@ -1472,6 +1482,12 @@ export declare const SDKControlRequestInnerSchema: () => z.ZodUnion<readonly [z.
         agent_transcript_path: z.ZodString;
         agent_type: z.ZodString;
         last_assistant_message: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+            stopped: "stopped";
+        }>>;
+        error_message: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
         session_id: z.ZodString;
         transcript_path: z.ZodString;
@@ -2218,6 +2234,8 @@ export declare const SDKControlRequestSchema: () => z.ZodObject<{
             hook_event_name: z.ZodLiteral<"SubagentStart">;
             agent_id: z.ZodString;
             agent_type: z.ZodString;
+            tool_use_id: z.ZodOptional<z.ZodString>;
+            is_background: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
             transcript_path: z.ZodString;
@@ -2232,6 +2250,12 @@ export declare const SDKControlRequestSchema: () => z.ZodObject<{
             agent_transcript_path: z.ZodString;
             agent_type: z.ZodString;
             last_assistant_message: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                completed: "completed";
+                stopped: "stopped";
+            }>>;
+            error_message: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
             transcript_path: z.ZodString;
@@ -2988,6 +3012,8 @@ export declare const ControlErrorResponseSchema: () => z.ZodObject<{
                 hook_event_name: z.ZodLiteral<"SubagentStart">;
                 agent_id: z.ZodString;
                 agent_type: z.ZodString;
+                tool_use_id: z.ZodOptional<z.ZodString>;
+                is_background: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                 session_id: z.ZodString;
                 transcript_path: z.ZodString;
@@ -3002,6 +3028,12 @@ export declare const ControlErrorResponseSchema: () => z.ZodObject<{
                 agent_transcript_path: z.ZodString;
                 agent_type: z.ZodString;
                 last_assistant_message: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodEnum<{
+                    failed: "failed";
+                    completed: "completed";
+                    stopped: "stopped";
+                }>>;
+                error_message: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                 session_id: z.ZodString;
                 transcript_path: z.ZodString;
@@ -3760,6 +3792,8 @@ export declare const SDKControlResponseSchema: () => z.ZodObject<{
                     hook_event_name: z.ZodLiteral<"SubagentStart">;
                     agent_id: z.ZodString;
                     agent_type: z.ZodString;
+                    tool_use_id: z.ZodOptional<z.ZodString>;
+                    is_background: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
                     transcript_path: z.ZodString;
@@ -3774,6 +3808,12 @@ export declare const SDKControlResponseSchema: () => z.ZodObject<{
                     agent_transcript_path: z.ZodString;
                     agent_type: z.ZodString;
                     last_assistant_message: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodEnum<{
+                        failed: "failed";
+                        completed: "completed";
+                        stopped: "stopped";
+                    }>>;
+                    error_message: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
                     transcript_path: z.ZodString;
@@ -4579,9 +4619,9 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
     summarizes_uuid: z.ZodString;
     status_category: z.ZodEnum<{
         failed: "failed";
+        completed: "completed";
         blocked: "blocked";
         waiting: "waiting";
-        completed: "completed";
         review_ready: "review_ready";
     }>;
     status_detail: z.ZodString;
@@ -4974,6 +5014,8 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
                     hook_event_name: z.ZodLiteral<"SubagentStart">;
                     agent_id: z.ZodString;
                     agent_type: z.ZodString;
+                    tool_use_id: z.ZodOptional<z.ZodString>;
+                    is_background: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
                     transcript_path: z.ZodString;
@@ -4988,6 +5030,12 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
                     agent_transcript_path: z.ZodString;
                     agent_type: z.ZodString;
                     last_assistant_message: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodEnum<{
+                        failed: "failed";
+                        completed: "completed";
+                        stopped: "stopped";
+                    }>>;
+                    error_message: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
                     transcript_path: z.ZodString;
@@ -5736,6 +5784,8 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
             hook_event_name: z.ZodLiteral<"SubagentStart">;
             agent_id: z.ZodString;
             agent_type: z.ZodString;
+            tool_use_id: z.ZodOptional<z.ZodString>;
+            is_background: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
             transcript_path: z.ZodString;
@@ -5750,6 +5800,12 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
             agent_transcript_path: z.ZodString;
             agent_type: z.ZodString;
             last_assistant_message: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                completed: "completed";
+                stopped: "stopped";
+            }>>;
+            error_message: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
             transcript_path: z.ZodString;
@@ -6516,6 +6572,8 @@ export declare const StdinMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<
             hook_event_name: z.ZodLiteral<"SubagentStart">;
             agent_id: z.ZodString;
             agent_type: z.ZodString;
+            tool_use_id: z.ZodOptional<z.ZodString>;
+            is_background: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
             transcript_path: z.ZodString;
@@ -6530,6 +6588,12 @@ export declare const StdinMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<
             agent_transcript_path: z.ZodString;
             agent_type: z.ZodString;
             last_assistant_message: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                completed: "completed";
+                stopped: "stopped";
+            }>>;
+            error_message: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
             transcript_path: z.ZodString;
@@ -7286,6 +7350,8 @@ export declare const StdinMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<
                     hook_event_name: z.ZodLiteral<"SubagentStart">;
                     agent_id: z.ZodString;
                     agent_type: z.ZodString;
+                    tool_use_id: z.ZodOptional<z.ZodString>;
+                    is_background: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
                     transcript_path: z.ZodString;
@@ -7300,6 +7366,12 @@ export declare const StdinMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<
                     agent_transcript_path: z.ZodString;
                     agent_type: z.ZodString;
                     last_assistant_message: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodEnum<{
+                        failed: "failed";
+                        completed: "completed";
+                        stopped: "stopped";
+                    }>>;
+                    error_message: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
                     transcript_path: z.ZodString;

package/dist/entrypoints/sdk/coreSchemas.d.ts

@@ -704,6 +704,8 @@ export declare const SubagentStartHookInputSchema: () => z.ZodIntersection<z.Zod
     hook_event_name: z.ZodLiteral<"SubagentStart">;
     agent_id: z.ZodString;
     agent_type: z.ZodString;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+    is_background: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
 export declare const SubagentStopHookInputSchema: () => z.ZodIntersection<z.ZodObject<{
     session_id: z.ZodString;
@@ -719,6 +721,12 @@ export declare const SubagentStopHookInputSchema: () => z.ZodIntersection<z.ZodO
     agent_transcript_path: z.ZodString;
     agent_type: z.ZodString;
     last_assistant_message: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        stopped: "stopped";
+    }>>;
+    error_message: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
 export declare const PreCompactHookInputSchema: () => z.ZodIntersection<z.ZodObject<{
     session_id: z.ZodString;
@@ -1117,6 +1125,8 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
     hook_event_name: z.ZodLiteral<"SubagentStart">;
     agent_id: z.ZodString;
     agent_type: z.ZodString;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+    is_background: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
     session_id: z.ZodString;
     transcript_path: z.ZodString;
@@ -1131,6 +1141,12 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
     agent_transcript_path: z.ZodString;
     agent_type: z.ZodString;
     last_assistant_message: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        stopped: "stopped";
+    }>>;
+    error_message: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
     session_id: z.ZodString;
     transcript_path: z.ZodString;
@@ -2515,9 +2531,9 @@ export declare const SDKPostTurnSummaryMessageSchema: () => z.ZodObject<{
     summarizes_uuid: z.ZodString;
     status_category: z.ZodEnum<{
         failed: "failed";
+        completed: "completed";
         blocked: "blocked";
         waiting: "waiting";
-        completed: "completed";
         review_ready: "review_ready";
     }>;
     status_detail: z.ZodString;

package/dist/entrypoints/sdk/runtimeTypes.d.ts

@@ -1,4 +1,6 @@
 import type { ChildProcessWithoutNullStreams } from 'node:child_process';
+import type { ModelProviders } from '../../providers/shared/routing.js';
+export type { ModelProviders, ModelProviderConfig } from '../../providers/shared/routing.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
 import type { z } from 'zod/v4';
@@ -15,6 +17,15 @@ export type Query = AsyncIterable<SDKMessage> & {
      * cancel a long turn without ending the whole query.
      */
     interrupt(): Promise<void> | void;
+    /**
+     * Abort a single in-flight run_in_background sub-agent by its agentId, without
+     * touching the main turn or other agents. The agent's AbortController is
+     * signalled (killAsyncAgent), so its in-flight tool calls unwind cleanly.
+     * No-op if the agent is unknown or already settled. Lets a host surface a
+     * per-agent "stop" affordance (desktop UI) on top of the model-facing
+     * TaskStop tool.
+     */
+    killAgent(agentId: string): void;
 };
 /** @internal */
 export type InternalQuery = Query;
@@ -271,6 +282,17 @@ export type Options = {
      *   Accepted at runtime with console.warn; remove call sites by 0.3.0.
      */
     transport?: ProviderTransport | DeprecatedProviderTransportName | 'auto';
+    /**
+     * Host model → provider-route catalog, keyed by model id. Consulted AFTER
+     * subagent model resolution (tier aliases / Agent tool `model` param), so
+     * a subagent whose model lives on a different wire or endpoint than the
+     * main session routes to its own baseURL/key/transport instead of
+     * inheriting the session's (which 404s for cross-protocol tier models).
+     * Models absent from the catalog use the session provider config as
+     * before. Entries may carry `providerSpecific.openaiResponses` extras
+     * applied when that model's request uses the openai_responses wire.
+     */
+    modelProviders?: ModelProviders;
     /**
      * Per-protocol passthrough channel for fields the wire supports but the
      * SDK does not surface as first-class options. The shim merges these

package/dist/lib/envDynamic.d.ts

@@ -23,7 +23,7 @@ export declare const envDynamic: {
     initJetBrainsDetection: typeof initJetBrainsDetection;
     hasInternetAccess: any;
     isCI: boolean;
-    platform: "win32" | "darwin" | "linux";
+    platform: "linux" | "win32" | "darwin";
     arch: NodeJS.Architecture;
     nodeVersion: string;
     isSSH: () => boolean;

package/dist/providers/anthropic/teleport/api.d.ts

@@ -68,9 +68,9 @@ export declare const CodeSessionSchema: () => z.ZodObject<{
     title: z.ZodString;
     description: z.ZodString;
     status: z.ZodEnum<{
+        completed: "completed";
         rejected: "rejected";
         waiting: "waiting";
-        completed: "completed";
         cancelled: "cancelled";
         idle: "idle";
         working: "working";

package/dist/providers/openai/shim.d.ts

@@ -20,6 +20,7 @@
  *   GITHUB_TOKEN or GH_TOKEN         — PAT with models access (mapped to Bearer auth)
  *   OPENAI_MODEL                     — optional; use github:copilot or openai/gpt-4.1 style IDs
  */
+import type { ProviderOverride } from '../shared/routing.js';
 import { type AnthropicStreamEvent, type ShimCreateParams } from '../../providers/codex/shim.js';
 interface OpenAIMessage {
     role: 'system' | 'user' | 'assistant' | 'tool';
@@ -199,10 +200,6 @@ export declare function createOpenAIShimClient(options: {
     maxRetries?: number;
     timeout?: number;
     reasoningEffort?: 'low' | 'medium' | 'high' | 'xhigh';
-    providerOverride?: {
-        model: string;
-        baseURL: string;
-        apiKey: string;
-    };
+    providerOverride?: ProviderOverride;
 }): unknown;
 export {};

package/dist/providers/provider.d.ts

@@ -1,4 +1,5 @@
 import type Anthropic from '@anthropic-ai/sdk';
+import type { ProviderOverride } from './shared/routing.js';
 import type { ClientOptions } from '@anthropic-ai/sdk';
 import type { ModelOutputTokenCap, NormalizedRequest, NormalizedResponse, ProviderError, ProviderFeature, ProviderId, ProviderProtocol, StreamEvent } from './types.js';
 /**
@@ -19,11 +20,7 @@ export interface CreateClientOptions {
      * without forcing hosts to rebuild a whole Provider object when
      * the swap is temporary.
      */
-    readonly providerOverride?: {
-        readonly model: string;
-        readonly baseURL: string;
-        readonly apiKey: string;
-    };
+    readonly providerOverride?: ProviderOverride;
 }
 export interface Provider {
     /** Stable id for logs / telemetry / per-session pinning. Not used for dispatch. */

package/dist/providers/shared/clientFactory.d.ts

@@ -1,4 +1,5 @@
 import Anthropic, { type ClientOptions } from '@anthropic-ai/sdk';
+import type { ProviderOverride } from './routing.js';
 /**
  * @internal γ.6c
  *
@@ -22,10 +23,6 @@ export declare function getNormalizedClient({ apiKey, maxRetries, model, fetchOv
     model?: string;
     fetchOverride?: ClientOptions['fetch'];
     source?: string;
-    providerOverride?: {
-        model: string;
-        baseURL: string;
-        apiKey: string;
-    };
+    providerOverride?: ProviderOverride;
 }): Promise<Anthropic>;
 export declare const CLIENT_REQUEST_ID_HEADER = "x-client-request-id";

package/dist/providers/shared/routing.d.ts

@@ -1,16 +1,47 @@
 import type { SettingsJson } from '../../session/settings/types.js';
+import type { ProviderTransport } from './config.js';
 /**
- * Provider override resolved from agent routing config.
- * When present, the API client should use these instead of global env vars.
+ * Provider override resolved for a specific agent/model.
+ * When present, the API client uses these instead of the session-global
+ * env-derived provider config (baseURL/key/transport).
  */
 export interface ProviderOverride {
     /** Model name to send to the API (e.g. "deepseek-chat", "gpt-4o") */
     model: string;
-    /** OpenAI-compatible base URL */
-    baseURL: string;
-    /** API key for this provider */
-    apiKey: string;
+    /** Base URL. Optional — falls back to the session's OPENAI_BASE_URL env. */
+    baseURL?: string;
+    /** API key. Optional — falls back to the session's env credential chain. */
+    apiKey?: string;
+    /**
+     * Wire transport for this override. Without it the session-level
+     * transport/sniff applies — which is exactly the cross-protocol subagent
+     * bug: a tier model living on a different wire (e.g. openai_responses)
+     * than the main session (chat_completions) hits the wrong endpoint and
+     * 404s. 'anthropic' routes to the native Anthropic client instead of the
+     * OpenAI shim.
+     */
+    transport?: ProviderTransport | 'anthropic';
+    /** Per-wire extras (e.g. openai-responses reasoning summary config). */
+    providerSpecific?: {
+        openaiResponses?: Record<string, unknown>;
+    };
 }
+/**
+ * Host-supplied model → provider-route catalog (`Options.modelProviders`).
+ * Key is the model id as it appears after subagent model resolution (tier
+ * env values / Agent tool `model` param). The host owns the model catalog
+ * (which channel/protocol each model lives on); the SDK consults this AFTER
+ * resolving a subagent's model so any resolution path — tier alias, explicit
+ * model param, inherit — lands on the right wire.
+ */
+export type ModelProviderConfig = Omit<ProviderOverride, 'model'>;
+export type ModelProviders = Record<string, ModelProviderConfig>;
+/**
+ * Resolve a model's provider route from the host catalog. Returns null when
+ * the catalog has no entry — the model is served by the session's default
+ * provider config (the common case: same wire as the main session).
+ */
+export declare function resolveModelProvider(model: string, modelProviders: ModelProviders | undefined): ProviderOverride | null;
 /**
  * Look up agent.routing by name or subagent_type, then resolve via agent.models.
  *