llmist 6.0.0 → 6.1.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { ZodType, ZodTypeAny } from 'zod';
 export { z } from 'zod';
-import { s as AgentHooks, t as ModelRegistry, u as LLMist, C as CompactionConfig, I as IConversationManager, v as CompactionEvent, L as LLMMessage, w as CompactionStats, x as CompactionStrategy, R as ResolvedCompactionConfig, y as CompactionContext, z as CompactionResult, B as MessageContent, G as GadgetMediaOutput, H as HintTemplate, S as StreamEvent, T as TokenUsage, D as GadgetRegistry, E as MediaStore, F as AgentContextConfig, J as SubagentConfigMap, K as SubagentEvent, b as LLMStreamChunk, N as ExecutionContext, O as GadgetExecuteReturn, P as GadgetExample, A as AbstractGadget, Q as ParsedGadgetCall, U as GadgetExecutionResult, V as MediaKind, W as MediaMetadata, X as GadgetExecuteResultWithMedia, Y as ProviderAdapter, Z as ModelDescriptor, _ as ModelSpec, $ as LLMGenerationOptions, a as LLMStream, a0 as ImageModelSpec, a1 as ImageGenerationOptions, a2 as ImageGenerationResult, a3 as SpeechModelSpec, a4 as SpeechGenerationOptions, a5 as SpeechGenerationResult } from './mock-stream-CAY53Q6u.cjs';
-export { ae as AfterGadgetExecutionAction, af as AfterGadgetExecutionControllerContext, ag as AfterLLMCallAction, ah as AfterLLMCallControllerContext, ai as AfterLLMErrorAction, a9 as AgentBuilder, aj as AgentOptions, aI as AudioContentPart, aJ as AudioMimeType, aK as AudioSource, ak as BeforeGadgetExecutionAction, al as BeforeLLMCallAction, am as ChunkInterceptorContext, aL as ContentPart, an as Controllers, b8 as CostEstimate, bu as CostReportingLLMist, aF as DEFAULT_COMPACTION_CONFIG, bk as DEFAULT_HINTS, bl as DEFAULT_PROMPTS, aG as DEFAULT_SUMMARIZATION_PROMPT, aa as EventHandlers, bs as GadgetClass, bv as GadgetExecuteResult, ao as GadgetExecutionControllerContext, bt as GadgetOrClass, ap as GadgetParameterInterceptorContext, aq as GadgetResultInterceptorContext, bw as GadgetSkippedEvent, bg as HintContext, a6 as HistoryMessage, aM as ImageBase64Source, aN as ImageContentPart, aO as ImageMimeType, aP as ImageSource, aQ as ImageUrlSource, ar as Interceptors, as as LLMCallControllerContext, at as LLMErrorControllerContext, b6 as LLMMessageBuilder, aH as LLMistOptions, au as MessageInterceptorContext, b4 as MessageRole, av as MessageTurn, d as MockBuilder, f as MockManager, l as MockMatcher, n as MockMatcherContext, o as MockOptions, M as MockProviderAdapter, p as MockRegistration, q as MockResponse, r as MockStats, b9 as ModelFeatures, bf as ModelIdentifierParser, ba as ModelLimits, bb as ModelPricing, aw as ObserveChunkContext, ax as ObserveCompactionContext, ay as ObserveGadgetCompleteContext, az as ObserveGadgetStartContext, aA as ObserveLLMCallContext, aB as ObserveLLMCompleteContext, aC as ObserveLLMErrorContext, aD as Observers, bh as PromptContext, bi as PromptTemplate, bj as PromptTemplateConfig, be as ProviderIdentifier, bx as StoredMedia, aE as SubagentContext, by as SubagentStreamEvent, aR as TextContentPart, bp as TextGenerationOptions, bz as TextOnlyAction, bA as TextOnlyContext, bB as TextOnlyCustomHandler, bC as TextOnlyGadgetConfig, bD as TextOnlyHandler, bE as TextOnlyStrategy, a7 as TrailingMessage, a8 as TrailingMessageContext, bc as VisionAnalyzeOptions, bd as VisionAnalyzeResult, aS as audioFromBase64, aT as audioFromBuffer, ab as collectEvents, ac as collectText, bq as complete, c as createMockAdapter, e as createMockClient, h as createMockStream, i as createTextMockStream, aU as detectAudioMimeType, aV as detectImageMimeType, b5 as extractMessageText, g as getMockManager, aW as imageFromBase64, aX as imageFromBuffer, aY as imageFromUrl, aZ as isAudioPart, a_ as isDataUrl, a$ as isImagePart, b0 as isTextPart, m as mockLLM, b7 as normalizeMessageContent, b1 as parseDataUrl, bm as resolveHintTemplate, bn as resolvePromptTemplate, bo as resolveRulesTemplate, ad as runWithHandlers, br as stream, b2 as text, b3 as toBase64 } from './mock-stream-CAY53Q6u.cjs';
+import { s as AgentHooks, t as ModelRegistry, u as LLMist, C as CompactionConfig, I as IConversationManager, v as CompactionEvent, L as LLMMessage, w as CompactionStats, x as CompactionStrategy, R as ResolvedCompactionConfig, y as CompactionContext, z as CompactionResult, B as MessageContent, G as GadgetMediaOutput, H as HintTemplate, S as StreamEvent, T as TokenUsage, D as GadgetRegistry, E as MediaStore, F as AgentContextConfig, J as SubagentConfigMap, K as SubagentEvent, N as ExecutionTree, O as NodeId, b as LLMStreamChunk, P as ExecutionContext, Q as GadgetExecuteReturn, U as GadgetExample, A as AbstractGadget, V as ParsedGadgetCall, W as GadgetExecutionResult, X as MediaKind, Y as MediaMetadata, Z as GadgetExecuteResultWithMedia, _ as ProviderAdapter, $ as ModelDescriptor, a0 as ModelSpec, a1 as LLMGenerationOptions, a as LLMStream, a2 as ImageModelSpec, a3 as ImageGenerationOptions, a4 as ImageGenerationResult, a5 as SpeechModelSpec, a6 as SpeechGenerationOptions, a7 as SpeechGenerationResult } from './mock-stream-Cq1Sxezz.cjs';
+export { aK as AddGadgetParams, aL as AddLLMCallParams, ag as AfterGadgetExecutionAction, ah as AfterGadgetExecutionControllerContext, ai as AfterLLMCallAction, aj as AfterLLMCallControllerContext, ak as AfterLLMErrorAction, ab as AgentBuilder, al as AgentOptions, bh as AudioContentPart, bi as AudioMimeType, bj as AudioSource, aT as BaseExecutionEvent, am as BeforeGadgetExecutionAction, an as BeforeLLMCallAction, ao as ChunkInterceptorContext, aM as CompleteGadgetParams, aN as CompleteLLMCallParams, bk as ContentPart, ap as Controllers, bJ as CostEstimate, c3 as CostReportingLLMist, aH as DEFAULT_COMPACTION_CONFIG, bV as DEFAULT_HINTS, bW as DEFAULT_PROMPTS, aI as DEFAULT_SUMMARIZATION_PROMPT, ac as EventHandlers, aV as ExecutionEvent, aW as ExecutionEventType, aO as ExecutionNode, aP as ExecutionNodeType, aX as GadgetCallEvent, c1 as GadgetClass, aY as GadgetCompleteEvent, aZ as GadgetErrorEvent, a_ as GadgetEvent, c4 as GadgetExecuteResult, aq as GadgetExecutionControllerContext, aQ as GadgetNode, c2 as GadgetOrClass, ar as GadgetParameterInterceptorContext, as as GadgetResultInterceptorContext, c5 as GadgetSkippedEvent, b0 as GadgetStartEvent, aR as GadgetState, bR as HintContext, a8 as HistoryMessage, b1 as HumanInputRequiredEvent, bl as ImageBase64Source, bm as ImageContentPart, bn as ImageMimeType, bo as ImageSource, bp as ImageUrlSource, at as Interceptors, b2 as LLMCallCompleteEvent, au as LLMCallControllerContext, b3 as LLMCallErrorEvent, aS as LLMCallNode, b4 as LLMCallStartEvent, b5 as LLMCallStreamEvent, av as LLMErrorControllerContext, b6 as LLMEvent, bH as LLMMessageBuilder, aJ as LLMistOptions, aw as MessageInterceptorContext, bF as MessageRole, ax as MessageTurn, d as MockBuilder, f as MockManager, l as MockMatcher, n as MockMatcherContext, o as MockOptions, M as MockProviderAdapter, p as MockRegistration, q as MockResponse, r as MockStats, bK as ModelFeatures, bQ as ModelIdentifierParser, bL as ModelLimits, bM as ModelPricing, ay as ObserveChunkContext, az as ObserveCompactionContext, aA as ObserveGadgetCompleteContext, aB as ObserveGadgetStartContext, aC as ObserveLLMCallContext, aD as ObserveLLMCompleteContext, aE as ObserveLLMErrorContext, aF as Observers, bS as PromptContext, bT as PromptTemplate, bU as PromptTemplateConfig, bP as ProviderIdentifier, c6 as StoredMedia, b7 as StreamCompleteEvent, aG as SubagentContext, c7 as SubagentStreamEvent, bq as TextContentPart, b8 as TextEvent, b_ as TextGenerationOptions, c8 as TextOnlyAction, c9 as TextOnlyContext, ca as TextOnlyCustomHandler, cb as TextOnlyGadgetConfig, cc as TextOnlyHandler, cd as TextOnlyStrategy, a9 as TrailingMessage, aa as TrailingMessageContext, aU as TreeCompactionEvent, a$ as TreeGadgetSkippedEvent, bN as VisionAnalyzeOptions, bO as VisionAnalyzeResult, br as audioFromBase64, bs as audioFromBuffer, ad as collectEvents, ae as collectText, b$ as complete, c as createMockAdapter, e as createMockClient, h as createMockStream, i as createTextMockStream, bt as detectAudioMimeType, bu as detectImageMimeType, bG as extractMessageText, b9 as filterByDepth, ba as filterByParent, bb as filterRootEvents, g as getMockManager, bc as groupByParent, bv as imageFromBase64, bw as imageFromBuffer, bx as imageFromUrl, by as isAudioPart, bz as isDataUrl, bd as isGadgetEvent, bA as isImagePart, be as isLLMEvent, bf as isRootEvent, bg as isSubagentEvent, bB as isTextPart, m as mockLLM, bI as normalizeMessageContent, bC as parseDataUrl, bX as resolveHintTemplate, bY as resolvePromptTemplate, bZ as resolveRulesTemplate, af as runWithHandlers, c0 as stream, bD as text, bE as toBase64 } from './mock-stream-Cq1Sxezz.cjs';
 import { Logger, ILogObj } from 'tslog';
 import { MessageCreateParamsStreaming, MessageStreamEvent } from '@anthropic-ai/sdk/resources/messages';
 import OpenAI from 'openai';
@@ -888,7 +888,7 @@ declare class ConversationManager implements IConversationManager {
     constructor(baseMessages: LLMMessage[], initialMessages: LLMMessage[], options?: ConversationManagerOptions);
     addUserMessage(content: MessageContent): void;
     addAssistantMessage(content: string): void;
-    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, media?: GadgetMediaOutput[], mediaIds?: string[]): void;
+    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[]): void;
     getMessages(): LLMMessage[];
     getHistoryMessages(): LLMMessage[];
     getBaseMessages(): LLMMessage[];
@@ -1180,15 +1180,6 @@ interface StreamProcessorOptions {
     logger?: Logger<ILogObj>;
     /** Callback for requesting human input during execution */
     requestHumanInput?: (question: string) => Promise<string>;
-    /** Whether to stop on gadget errors */
-    stopOnGadgetError?: boolean;
-    /** Custom error recovery logic */
-    canRecoverFromGadgetError?: (context: {
-        error: string;
-        gadgetName: string;
-        errorType: "parse" | "validation" | "execution";
-        parameters?: Record<string, unknown>;
-    }) => boolean | Promise<boolean>;
     /** Default gadget timeout */
     defaultGadgetTimeoutMs?: number;
     /** LLMist client for ExecutionContext.llmist */
@@ -1201,6 +1192,12 @@ interface StreamProcessorOptions {
     subagentConfig?: SubagentConfigMap;
     /** Callback for subagent gadgets to report subagent events to parent */
     onSubagentEvent?: (event: SubagentEvent) => void;
+    /** Execution tree for tracking LLM calls and gadget executions */
+    tree?: ExecutionTree;
+    /** Parent node ID (for gadget nodes created by this processor) */
+    parentNodeId?: NodeId | null;
+    /** Base depth for nodes created by this processor */
+    baseDepth?: number;
 }
 /**
  * Result of stream processing.
@@ -1250,10 +1247,10 @@ declare class StreamProcessor {
     private readonly logger;
     private readonly parser;
     private readonly executor;
-    private readonly stopOnGadgetError;
-    private readonly canRecoverFromGadgetError?;
+    private readonly tree?;
+    private readonly parentNodeId;
+    private readonly baseDepth;
     private responseText;
-    private executionHalted;
     private observerFailureCount;
     /** Gadgets waiting for their dependencies to complete */
     private gadgetsAwaitingDependencies;
@@ -1263,6 +1260,8 @@ declare class StreamProcessor {
     private failedInvocations;
     /** Promises for independent gadgets currently executing (fire-and-forget) */
     private inFlightExecutions;
+    /** Queue of completed gadget results ready to be yielded (for real-time streaming) */
+    private completedResultsQueue;
     constructor(options: StreamProcessorOptions);
     /**
      * Process an LLM stream and yield events in real-time.
@@ -1275,14 +1274,8 @@ declare class StreamProcessor {
      * The final event is always a StreamCompletionEvent containing metadata.
      */
     process(stream: AsyncIterable<LLMStreamChunk>): AsyncGenerator<StreamEvent>;
-    /**
-     * Process a single parsed event (text or gadget call).
-     * @deprecated Use processEventGenerator for real-time streaming
-     */
-    private processEvent;
     /**
      * Process a single parsed event, yielding events in real-time.
-     * Generator version of processEvent for streaming support.
      */
     private processEventGenerator;
     /**
@@ -1316,17 +1309,26 @@ declare class StreamProcessor {
      */
     private executeGadgetGenerator;
     /**
-     * Execute a gadget and collect all events into an array (non-blocking).
+     * Execute a gadget and push events to the completed results queue (non-blocking).
      * Used for fire-and-forget parallel execution of independent gadgets.
+     * Results are pushed to completedResultsQueue for real-time streaming to the caller.
      */
     private executeGadgetAndCollect;
     /**
-     * Collect results from all fire-and-forget (in-flight) gadget executions.
-     * Called at stream end to await parallel independent gadgets.
-     * Clears the inFlightExecutions map after collection.
-     * @returns Array of all events from completed gadgets
+     * Drain all completed results from the queue.
+     * Used to yield results as they complete during stream processing.
+     * @returns Generator that yields all events currently in the queue
+     */
+    private drainCompletedResults;
+    /**
+     * Wait for all in-flight gadget executions to complete, yielding events in real-time.
+     * Called at stream end to ensure all parallel executions finish.
+     * Results and subagent events are pushed to completedResultsQueue during execution.
+     * This generator yields queued events while polling, enabling real-time display
+     * of subagent activity (LLM calls, nested gadgets) during long-running gadgets.
+     * Clears the inFlightExecutions map after all gadgets complete.
      */
-    private collectInFlightResults;
+    private waitForInFlightExecutions;
     /**
      * Handle a gadget that cannot execute because a dependency failed.
      * Calls the onDependencySkipped controller to allow customization.
@@ -1355,22 +1357,6 @@ declare class StreamProcessor {
      * All observers run concurrently and failures are tracked but don't crash.
      */
     private runObserversInParallel;
-    /**
-     * Check if execution can recover from an error.
-     *
-     * Returns true if we should continue processing subsequent gadgets, false if we should stop.
-     *
-     * Logic:
-     * - If custom canRecoverFromGadgetError is provided, use it
-     * - Otherwise, use stopOnGadgetError config:
-     *   - stopOnGadgetError=true → return false (stop execution)
-     *   - stopOnGadgetError=false → return true (continue execution)
-     */
-    private checkCanRecoverFromError;
-    /**
-     * Determine the type of error from a gadget execution.
-     */
-    private determineErrorType;
 }
 
 /**
@@ -1744,13 +1730,17 @@ declare class GadgetExecutor {
     private readonly agentConfig?;
     private readonly subagentConfig?;
     private readonly onSubagentEvent?;
+    private readonly tree?;
+    private readonly parentNodeId?;
+    private readonly baseDepth?;
     private readonly logger;
     private readonly errorFormatter;
     private readonly argPrefix;
-    constructor(registry: GadgetRegistry, requestHumanInput?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined, errorFormatterOptions?: ErrorFormatterOptions, client?: LLMist | undefined, mediaStore?: MediaStore | undefined, agentConfig?: AgentContextConfig | undefined, subagentConfig?: SubagentConfigMap | undefined, onSubagentEvent?: ((event: SubagentEvent) => void) | undefined);
+    constructor(registry: GadgetRegistry, requestHumanInput?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined, errorFormatterOptions?: ErrorFormatterOptions, client?: LLMist | undefined, mediaStore?: MediaStore | undefined, agentConfig?: AgentContextConfig | undefined, subagentConfig?: SubagentConfigMap | undefined, onSubagentEvent?: ((event: SubagentEvent) => void) | undefined, tree?: ExecutionTree | undefined, parentNodeId?: (NodeId | null) | undefined, baseDepth?: number | undefined);
     /**
      * Creates a promise that rejects with a TimeoutException after the specified timeout.
      * Aborts the provided AbortController before rejecting, allowing gadgets to clean up.
+     * Returns both the promise and a cancel function to clear the timeout when no longer needed.
      */
     private createTimeoutPromise;
     /**
@@ -2334,6 +2324,115 @@ declare function createLogger(options?: LoggerOptions): Logger<ILogObj>;
  */
 declare const defaultLogger: Logger<ILogObj>;
 
+/**
+ * Config resolution utility for subagent gadgets.
+ *
+ * Simplifies the common pattern of resolving configuration from multiple sources:
+ * 1. Runtime params (explicit gadget call parameters)
+ * 2. Subagent config (from CLI [subagents.Name] sections)
+ * 3. Parent agent config (model inheritance)
+ * 4. Package defaults
+ *
+ * @module utils/config-resolver
+ */
+
+/**
+ * Options for resolving a single config value.
+ */
+interface ResolveValueOptions<T> {
+    /** Runtime parameter value (highest priority) */
+    runtime?: T;
+    /** Subagent config key to check */
+    subagentKey?: string;
+    /** Parent config key to check (for inheritance) - "model" or "temperature" */
+    parentKey?: "model" | "temperature";
+    /** Default value (lowest priority) */
+    defaultValue: T;
+    /** Whether "inherit" string means use parent value */
+    handleInherit?: boolean;
+}
+/**
+ * Resolve a single configuration value through the priority chain.
+ *
+ * Priority (highest to lowest):
+ * 1. Runtime parameter (if provided and not undefined)
+ * 2. Subagent config (from ctx.subagentConfig[gadgetName][key])
+ * 3. Parent config (from ctx.agentConfig[key], if parentKey specified)
+ * 4. Default value
+ *
+ * Special handling for "inherit" string:
+ * - If handleInherit is true and value is "inherit", falls through to parent/default
+ *
+ * @param ctx - ExecutionContext from gadget execution
+ * @param gadgetName - Name of the subagent gadget (e.g., "BrowseWeb")
+ * @param options - Resolution options
+ * @returns Resolved value
+ *
+ * @example
+ * ```typescript
+ * const model = resolveValue(ctx, "BrowseWeb", {
+ *   runtime: params.model,
+ *   subagentKey: "model",
+ *   parentKey: "model",
+ *   defaultValue: "sonnet",
+ *   handleInherit: true,
+ * });
+ * ```
+ */
+declare function resolveValue<T>(ctx: ExecutionContext, gadgetName: string, options: ResolveValueOptions<T>): T;
+/**
+ * Bulk configuration resolution for subagent gadgets.
+ *
+ * Takes a map of config keys to their resolution options and returns
+ * a fully resolved configuration object.
+ *
+ * @param ctx - ExecutionContext from gadget execution
+ * @param gadgetName - Name of the subagent gadget (e.g., "BrowseWeb")
+ * @param config - Map of config keys to resolution options
+ * @returns Fully resolved configuration object
+ *
+ * @example
+ * ```typescript
+ * // Before: 27 lines of manual fallback logic
+ * const subagentConfig = ctx.subagentConfig?.Dhalsim ?? {};
+ * const parentModel = ctx.agentConfig?.model;
+ * const model = params.model ?? subagentConfig.model ?? parentModel ?? "sonnet";
+ * const maxIterations = params.maxIterations ?? subagentConfig.maxIterations ?? 15;
+ * const headless = params.headless ?? subagentConfig.headless ?? true;
+ *
+ * // After: One function call
+ * const { model, maxIterations, headless } = resolveConfig(ctx, "BrowseWeb", {
+ *   model: { runtime: params.model, subagentKey: "model", parentKey: "model", defaultValue: "sonnet", handleInherit: true },
+ *   maxIterations: { runtime: params.maxIterations, subagentKey: "maxIterations", defaultValue: 15 },
+ *   headless: { runtime: params.headless, subagentKey: "headless", defaultValue: true },
+ * });
+ * ```
+ */
+declare function resolveConfig<T extends Record<string, unknown>>(ctx: ExecutionContext, gadgetName: string, config: {
+    [K in keyof T]: ResolveValueOptions<T[K]>;
+}): T;
+/**
+ * Convenience function for resolving subagent model with "inherit" support.
+ *
+ * This is the most common resolution pattern for subagent gadgets:
+ * - Use runtime model if provided
+ * - Check subagent config for model override
+ * - Inherit parent model if configured
+ * - Fall back to default
+ *
+ * @param ctx - ExecutionContext from gadget execution
+ * @param gadgetName - Name of the subagent gadget
+ * @param runtimeModel - Model from gadget parameters
+ * @param defaultModel - Default model if nothing else specified
+ * @returns Resolved model string
+ *
+ * @example
+ * ```typescript
+ * const model = resolveSubagentModel(ctx, "BrowseWeb", params.model, "sonnet");
+ * ```
+ */
+declare function resolveSubagentModel(ctx: ExecutionContext, gadgetName: string, runtimeModel: string | undefined, defaultModel: string): string;
+
 /**
  * Base Provider Adapter
  *
@@ -2621,4 +2720,4 @@ declare class OpenAIChatProvider extends BaseProviderAdapter {
 }
 declare function createOpenAIProviderFromEnv(): OpenAIChatProvider | null;
 
-export { AbortException, AbstractGadget, AgentHooks, AnthropicMessagesProvider, CompactionConfig, CompactionContext, CompactionEvent, CompactionManager, CompactionResult, CompactionStats, CompactionStrategy, ConversationManager, type CreateGadgetConfig, ExecutionContext, Gadget, GadgetCallParser, type GadgetConfig, GadgetExample, GadgetExecuteResultWithMedia, GadgetExecuteReturn, GadgetExecutionResult, GadgetExecutor, GadgetMediaOutput, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HintTemplate, type HintsConfig, HookPresets, HumanInputRequiredException, HybridStrategy, IConversationManager, type IterationHintOptions, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, LLMist, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, MediaKind, MediaMetadata, MediaStore, MessageContent, ModelDescriptor, ModelRegistry, ModelSpec, OpenAIChatProvider, type ParallelGadgetHintOptions, ParsedGadgetCall, ProviderAdapter, ResolvedCompactionConfig, SlidingWindowStrategy, type StoredOutput, StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, SubagentEvent, SummarizationStrategy, TaskCompletionSignal, TimeoutException, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createHints, createLogger, createMediaOutput, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, iterationProgressHint, parallelGadgetHint, resolveModel, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, validateAndApplyDefaults, validateGadgetParams };
+export { AbortException, AbstractGadget, AgentHooks, AnthropicMessagesProvider, CompactionConfig, CompactionContext, CompactionEvent, CompactionManager, CompactionResult, CompactionStats, CompactionStrategy, ConversationManager, type CreateGadgetConfig, ExecutionContext, ExecutionTree, Gadget, GadgetCallParser, type GadgetConfig, GadgetExample, GadgetExecuteResultWithMedia, GadgetExecuteReturn, GadgetExecutionResult, GadgetExecutor, GadgetMediaOutput, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HintTemplate, type HintsConfig, HookPresets, HumanInputRequiredException, HybridStrategy, IConversationManager, type IterationHintOptions, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, LLMist, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, MediaKind, MediaMetadata, MediaStore, MessageContent, ModelDescriptor, ModelRegistry, ModelSpec, NodeId, OpenAIChatProvider, type ParallelGadgetHintOptions, ParsedGadgetCall, ProviderAdapter, type ResolveValueOptions, ResolvedCompactionConfig, SlidingWindowStrategy, type StoredOutput, StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, SubagentEvent, SummarizationStrategy, TaskCompletionSignal, TimeoutException, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createHints, createLogger, createMediaOutput, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, iterationProgressHint, parallelGadgetHint, resolveConfig, resolveModel, resolveSubagentModel, resolveValue, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, validateAndApplyDefaults, validateGadgetParams };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ZodType, ZodTypeAny } from 'zod';
 export { z } from 'zod';
-import { s as AgentHooks, t as ModelRegistry, u as LLMist, C as CompactionConfig, I as IConversationManager, v as CompactionEvent, L as LLMMessage, w as CompactionStats, x as CompactionStrategy, R as ResolvedCompactionConfig, y as CompactionContext, z as CompactionResult, B as MessageContent, G as GadgetMediaOutput, H as HintTemplate, S as StreamEvent, T as TokenUsage, D as GadgetRegistry, E as MediaStore, F as AgentContextConfig, J as SubagentConfigMap, K as SubagentEvent, b as LLMStreamChunk, N as ExecutionContext, O as GadgetExecuteReturn, P as GadgetExample, A as AbstractGadget, Q as ParsedGadgetCall, U as GadgetExecutionResult, V as MediaKind, W as MediaMetadata, X as GadgetExecuteResultWithMedia, Y as ProviderAdapter, Z as ModelDescriptor, _ as ModelSpec, $ as LLMGenerationOptions, a as LLMStream, a0 as ImageModelSpec, a1 as ImageGenerationOptions, a2 as ImageGenerationResult, a3 as SpeechModelSpec, a4 as SpeechGenerationOptions, a5 as SpeechGenerationResult } from './mock-stream-CAY53Q6u.js';
-export { ae as AfterGadgetExecutionAction, af as AfterGadgetExecutionControllerContext, ag as AfterLLMCallAction, ah as AfterLLMCallControllerContext, ai as AfterLLMErrorAction, a9 as AgentBuilder, aj as AgentOptions, aI as AudioContentPart, aJ as AudioMimeType, aK as AudioSource, ak as BeforeGadgetExecutionAction, al as BeforeLLMCallAction, am as ChunkInterceptorContext, aL as ContentPart, an as Controllers, b8 as CostEstimate, bu as CostReportingLLMist, aF as DEFAULT_COMPACTION_CONFIG, bk as DEFAULT_HINTS, bl as DEFAULT_PROMPTS, aG as DEFAULT_SUMMARIZATION_PROMPT, aa as EventHandlers, bs as GadgetClass, bv as GadgetExecuteResult, ao as GadgetExecutionControllerContext, bt as GadgetOrClass, ap as GadgetParameterInterceptorContext, aq as GadgetResultInterceptorContext, bw as GadgetSkippedEvent, bg as HintContext, a6 as HistoryMessage, aM as ImageBase64Source, aN as ImageContentPart, aO as ImageMimeType, aP as ImageSource, aQ as ImageUrlSource, ar as Interceptors, as as LLMCallControllerContext, at as LLMErrorControllerContext, b6 as LLMMessageBuilder, aH as LLMistOptions, au as MessageInterceptorContext, b4 as MessageRole, av as MessageTurn, d as MockBuilder, f as MockManager, l as MockMatcher, n as MockMatcherContext, o as MockOptions, M as MockProviderAdapter, p as MockRegistration, q as MockResponse, r as MockStats, b9 as ModelFeatures, bf as ModelIdentifierParser, ba as ModelLimits, bb as ModelPricing, aw as ObserveChunkContext, ax as ObserveCompactionContext, ay as ObserveGadgetCompleteContext, az as ObserveGadgetStartContext, aA as ObserveLLMCallContext, aB as ObserveLLMCompleteContext, aC as ObserveLLMErrorContext, aD as Observers, bh as PromptContext, bi as PromptTemplate, bj as PromptTemplateConfig, be as ProviderIdentifier, bx as StoredMedia, aE as SubagentContext, by as SubagentStreamEvent, aR as TextContentPart, bp as TextGenerationOptions, bz as TextOnlyAction, bA as TextOnlyContext, bB as TextOnlyCustomHandler, bC as TextOnlyGadgetConfig, bD as TextOnlyHandler, bE as TextOnlyStrategy, a7 as TrailingMessage, a8 as TrailingMessageContext, bc as VisionAnalyzeOptions, bd as VisionAnalyzeResult, aS as audioFromBase64, aT as audioFromBuffer, ab as collectEvents, ac as collectText, bq as complete, c as createMockAdapter, e as createMockClient, h as createMockStream, i as createTextMockStream, aU as detectAudioMimeType, aV as detectImageMimeType, b5 as extractMessageText, g as getMockManager, aW as imageFromBase64, aX as imageFromBuffer, aY as imageFromUrl, aZ as isAudioPart, a_ as isDataUrl, a$ as isImagePart, b0 as isTextPart, m as mockLLM, b7 as normalizeMessageContent, b1 as parseDataUrl, bm as resolveHintTemplate, bn as resolvePromptTemplate, bo as resolveRulesTemplate, ad as runWithHandlers, br as stream, b2 as text, b3 as toBase64 } from './mock-stream-CAY53Q6u.js';
+import { s as AgentHooks, t as ModelRegistry, u as LLMist, C as CompactionConfig, I as IConversationManager, v as CompactionEvent, L as LLMMessage, w as CompactionStats, x as CompactionStrategy, R as ResolvedCompactionConfig, y as CompactionContext, z as CompactionResult, B as MessageContent, G as GadgetMediaOutput, H as HintTemplate, S as StreamEvent, T as TokenUsage, D as GadgetRegistry, E as MediaStore, F as AgentContextConfig, J as SubagentConfigMap, K as SubagentEvent, N as ExecutionTree, O as NodeId, b as LLMStreamChunk, P as ExecutionContext, Q as GadgetExecuteReturn, U as GadgetExample, A as AbstractGadget, V as ParsedGadgetCall, W as GadgetExecutionResult, X as MediaKind, Y as MediaMetadata, Z as GadgetExecuteResultWithMedia, _ as ProviderAdapter, $ as ModelDescriptor, a0 as ModelSpec, a1 as LLMGenerationOptions, a as LLMStream, a2 as ImageModelSpec, a3 as ImageGenerationOptions, a4 as ImageGenerationResult, a5 as SpeechModelSpec, a6 as SpeechGenerationOptions, a7 as SpeechGenerationResult } from './mock-stream-Cq1Sxezz.js';
+export { aK as AddGadgetParams, aL as AddLLMCallParams, ag as AfterGadgetExecutionAction, ah as AfterGadgetExecutionControllerContext, ai as AfterLLMCallAction, aj as AfterLLMCallControllerContext, ak as AfterLLMErrorAction, ab as AgentBuilder, al as AgentOptions, bh as AudioContentPart, bi as AudioMimeType, bj as AudioSource, aT as BaseExecutionEvent, am as BeforeGadgetExecutionAction, an as BeforeLLMCallAction, ao as ChunkInterceptorContext, aM as CompleteGadgetParams, aN as CompleteLLMCallParams, bk as ContentPart, ap as Controllers, bJ as CostEstimate, c3 as CostReportingLLMist, aH as DEFAULT_COMPACTION_CONFIG, bV as DEFAULT_HINTS, bW as DEFAULT_PROMPTS, aI as DEFAULT_SUMMARIZATION_PROMPT, ac as EventHandlers, aV as ExecutionEvent, aW as ExecutionEventType, aO as ExecutionNode, aP as ExecutionNodeType, aX as GadgetCallEvent, c1 as GadgetClass, aY as GadgetCompleteEvent, aZ as GadgetErrorEvent, a_ as GadgetEvent, c4 as GadgetExecuteResult, aq as GadgetExecutionControllerContext, aQ as GadgetNode, c2 as GadgetOrClass, ar as GadgetParameterInterceptorContext, as as GadgetResultInterceptorContext, c5 as GadgetSkippedEvent, b0 as GadgetStartEvent, aR as GadgetState, bR as HintContext, a8 as HistoryMessage, b1 as HumanInputRequiredEvent, bl as ImageBase64Source, bm as ImageContentPart, bn as ImageMimeType, bo as ImageSource, bp as ImageUrlSource, at as Interceptors, b2 as LLMCallCompleteEvent, au as LLMCallControllerContext, b3 as LLMCallErrorEvent, aS as LLMCallNode, b4 as LLMCallStartEvent, b5 as LLMCallStreamEvent, av as LLMErrorControllerContext, b6 as LLMEvent, bH as LLMMessageBuilder, aJ as LLMistOptions, aw as MessageInterceptorContext, bF as MessageRole, ax as MessageTurn, d as MockBuilder, f as MockManager, l as MockMatcher, n as MockMatcherContext, o as MockOptions, M as MockProviderAdapter, p as MockRegistration, q as MockResponse, r as MockStats, bK as ModelFeatures, bQ as ModelIdentifierParser, bL as ModelLimits, bM as ModelPricing, ay as ObserveChunkContext, az as ObserveCompactionContext, aA as ObserveGadgetCompleteContext, aB as ObserveGadgetStartContext, aC as ObserveLLMCallContext, aD as ObserveLLMCompleteContext, aE as ObserveLLMErrorContext, aF as Observers, bS as PromptContext, bT as PromptTemplate, bU as PromptTemplateConfig, bP as ProviderIdentifier, c6 as StoredMedia, b7 as StreamCompleteEvent, aG as SubagentContext, c7 as SubagentStreamEvent, bq as TextContentPart, b8 as TextEvent, b_ as TextGenerationOptions, c8 as TextOnlyAction, c9 as TextOnlyContext, ca as TextOnlyCustomHandler, cb as TextOnlyGadgetConfig, cc as TextOnlyHandler, cd as TextOnlyStrategy, a9 as TrailingMessage, aa as TrailingMessageContext, aU as TreeCompactionEvent, a$ as TreeGadgetSkippedEvent, bN as VisionAnalyzeOptions, bO as VisionAnalyzeResult, br as audioFromBase64, bs as audioFromBuffer, ad as collectEvents, ae as collectText, b$ as complete, c as createMockAdapter, e as createMockClient, h as createMockStream, i as createTextMockStream, bt as detectAudioMimeType, bu as detectImageMimeType, bG as extractMessageText, b9 as filterByDepth, ba as filterByParent, bb as filterRootEvents, g as getMockManager, bc as groupByParent, bv as imageFromBase64, bw as imageFromBuffer, bx as imageFromUrl, by as isAudioPart, bz as isDataUrl, bd as isGadgetEvent, bA as isImagePart, be as isLLMEvent, bf as isRootEvent, bg as isSubagentEvent, bB as isTextPart, m as mockLLM, bI as normalizeMessageContent, bC as parseDataUrl, bX as resolveHintTemplate, bY as resolvePromptTemplate, bZ as resolveRulesTemplate, af as runWithHandlers, c0 as stream, bD as text, bE as toBase64 } from './mock-stream-Cq1Sxezz.js';
 import { Logger, ILogObj } from 'tslog';
 import { MessageCreateParamsStreaming, MessageStreamEvent } from '@anthropic-ai/sdk/resources/messages';
 import OpenAI from 'openai';
@@ -888,7 +888,7 @@ declare class ConversationManager implements IConversationManager {
     constructor(baseMessages: LLMMessage[], initialMessages: LLMMessage[], options?: ConversationManagerOptions);
     addUserMessage(content: MessageContent): void;
     addAssistantMessage(content: string): void;
-    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, media?: GadgetMediaOutput[], mediaIds?: string[]): void;
+    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[]): void;
     getMessages(): LLMMessage[];
     getHistoryMessages(): LLMMessage[];
     getBaseMessages(): LLMMessage[];
@@ -1180,15 +1180,6 @@ interface StreamProcessorOptions {
     logger?: Logger<ILogObj>;
     /** Callback for requesting human input during execution */
     requestHumanInput?: (question: string) => Promise<string>;
-    /** Whether to stop on gadget errors */
-    stopOnGadgetError?: boolean;
-    /** Custom error recovery logic */
-    canRecoverFromGadgetError?: (context: {
-        error: string;
-        gadgetName: string;
-        errorType: "parse" | "validation" | "execution";
-        parameters?: Record<string, unknown>;
-    }) => boolean | Promise<boolean>;
     /** Default gadget timeout */
     defaultGadgetTimeoutMs?: number;
     /** LLMist client for ExecutionContext.llmist */
@@ -1201,6 +1192,12 @@ interface StreamProcessorOptions {
     subagentConfig?: SubagentConfigMap;
     /** Callback for subagent gadgets to report subagent events to parent */
     onSubagentEvent?: (event: SubagentEvent) => void;
+    /** Execution tree for tracking LLM calls and gadget executions */
+    tree?: ExecutionTree;
+    /** Parent node ID (for gadget nodes created by this processor) */
+    parentNodeId?: NodeId | null;
+    /** Base depth for nodes created by this processor */
+    baseDepth?: number;
 }
 /**
  * Result of stream processing.
@@ -1250,10 +1247,10 @@ declare class StreamProcessor {
     private readonly logger;
     private readonly parser;
     private readonly executor;
-    private readonly stopOnGadgetError;
-    private readonly canRecoverFromGadgetError?;
+    private readonly tree?;
+    private readonly parentNodeId;
+    private readonly baseDepth;
     private responseText;
-    private executionHalted;
     private observerFailureCount;
     /** Gadgets waiting for their dependencies to complete */
     private gadgetsAwaitingDependencies;
@@ -1263,6 +1260,8 @@ declare class StreamProcessor {
     private failedInvocations;
     /** Promises for independent gadgets currently executing (fire-and-forget) */
     private inFlightExecutions;
+    /** Queue of completed gadget results ready to be yielded (for real-time streaming) */
+    private completedResultsQueue;
     constructor(options: StreamProcessorOptions);
     /**
      * Process an LLM stream and yield events in real-time.
@@ -1275,14 +1274,8 @@ declare class StreamProcessor {
      * The final event is always a StreamCompletionEvent containing metadata.
      */
     process(stream: AsyncIterable<LLMStreamChunk>): AsyncGenerator<StreamEvent>;
-    /**
-     * Process a single parsed event (text or gadget call).
-     * @deprecated Use processEventGenerator for real-time streaming
-     */
-    private processEvent;
     /**
      * Process a single parsed event, yielding events in real-time.
-     * Generator version of processEvent for streaming support.
      */
     private processEventGenerator;
     /**
@@ -1316,17 +1309,26 @@ declare class StreamProcessor {
      */
     private executeGadgetGenerator;
     /**
-     * Execute a gadget and collect all events into an array (non-blocking).
+     * Execute a gadget and push events to the completed results queue (non-blocking).
      * Used for fire-and-forget parallel execution of independent gadgets.
+     * Results are pushed to completedResultsQueue for real-time streaming to the caller.
      */
     private executeGadgetAndCollect;
     /**
-     * Collect results from all fire-and-forget (in-flight) gadget executions.
-     * Called at stream end to await parallel independent gadgets.
-     * Clears the inFlightExecutions map after collection.
-     * @returns Array of all events from completed gadgets
+     * Drain all completed results from the queue.
+     * Used to yield results as they complete during stream processing.
+     * @returns Generator that yields all events currently in the queue
+     */
+    private drainCompletedResults;
+    /**
+     * Wait for all in-flight gadget executions to complete, yielding events in real-time.
+     * Called at stream end to ensure all parallel executions finish.
+     * Results and subagent events are pushed to completedResultsQueue during execution.
+     * This generator yields queued events while polling, enabling real-time display
+     * of subagent activity (LLM calls, nested gadgets) during long-running gadgets.
+     * Clears the inFlightExecutions map after all gadgets complete.
      */
-    private collectInFlightResults;
+    private waitForInFlightExecutions;
     /**
      * Handle a gadget that cannot execute because a dependency failed.
      * Calls the onDependencySkipped controller to allow customization.
@@ -1355,22 +1357,6 @@ declare class StreamProcessor {
      * All observers run concurrently and failures are tracked but don't crash.
      */
     private runObserversInParallel;
-    /**
-     * Check if execution can recover from an error.
-     *
-     * Returns true if we should continue processing subsequent gadgets, false if we should stop.
-     *
-     * Logic:
-     * - If custom canRecoverFromGadgetError is provided, use it
-     * - Otherwise, use stopOnGadgetError config:
-     *   - stopOnGadgetError=true → return false (stop execution)
-     *   - stopOnGadgetError=false → return true (continue execution)
-     */
-    private checkCanRecoverFromError;
-    /**
-     * Determine the type of error from a gadget execution.
-     */
-    private determineErrorType;
 }
 
 /**
@@ -1744,13 +1730,17 @@ declare class GadgetExecutor {
     private readonly agentConfig?;
     private readonly subagentConfig?;
     private readonly onSubagentEvent?;
+    private readonly tree?;
+    private readonly parentNodeId?;
+    private readonly baseDepth?;
     private readonly logger;
     private readonly errorFormatter;
     private readonly argPrefix;
-    constructor(registry: GadgetRegistry, requestHumanInput?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined, errorFormatterOptions?: ErrorFormatterOptions, client?: LLMist | undefined, mediaStore?: MediaStore | undefined, agentConfig?: AgentContextConfig | undefined, subagentConfig?: SubagentConfigMap | undefined, onSubagentEvent?: ((event: SubagentEvent) => void) | undefined);
+    constructor(registry: GadgetRegistry, requestHumanInput?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined, errorFormatterOptions?: ErrorFormatterOptions, client?: LLMist | undefined, mediaStore?: MediaStore | undefined, agentConfig?: AgentContextConfig | undefined, subagentConfig?: SubagentConfigMap | undefined, onSubagentEvent?: ((event: SubagentEvent) => void) | undefined, tree?: ExecutionTree | undefined, parentNodeId?: (NodeId | null) | undefined, baseDepth?: number | undefined);
     /**
      * Creates a promise that rejects with a TimeoutException after the specified timeout.
      * Aborts the provided AbortController before rejecting, allowing gadgets to clean up.
+     * Returns both the promise and a cancel function to clear the timeout when no longer needed.
      */
     private createTimeoutPromise;
     /**
@@ -2334,6 +2324,115 @@ declare function createLogger(options?: LoggerOptions): Logger<ILogObj>;
  */
 declare const defaultLogger: Logger<ILogObj>;
 
+/**
+ * Config resolution utility for subagent gadgets.
+ *
+ * Simplifies the common pattern of resolving configuration from multiple sources:
+ * 1. Runtime params (explicit gadget call parameters)
+ * 2. Subagent config (from CLI [subagents.Name] sections)
+ * 3. Parent agent config (model inheritance)
+ * 4. Package defaults
+ *
+ * @module utils/config-resolver
+ */
+
+/**
+ * Options for resolving a single config value.
+ */
+interface ResolveValueOptions<T> {
+    /** Runtime parameter value (highest priority) */
+    runtime?: T;
+    /** Subagent config key to check */
+    subagentKey?: string;
+    /** Parent config key to check (for inheritance) - "model" or "temperature" */
+    parentKey?: "model" | "temperature";
+    /** Default value (lowest priority) */
+    defaultValue: T;
+    /** Whether "inherit" string means use parent value */
+    handleInherit?: boolean;
+}
+/**
+ * Resolve a single configuration value through the priority chain.
+ *
+ * Priority (highest to lowest):
+ * 1. Runtime parameter (if provided and not undefined)
+ * 2. Subagent config (from ctx.subagentConfig[gadgetName][key])
+ * 3. Parent config (from ctx.agentConfig[key], if parentKey specified)
+ * 4. Default value
+ *
+ * Special handling for "inherit" string:
+ * - If handleInherit is true and value is "inherit", falls through to parent/default
+ *
+ * @param ctx - ExecutionContext from gadget execution
+ * @param gadgetName - Name of the subagent gadget (e.g., "BrowseWeb")
+ * @param options - Resolution options
+ * @returns Resolved value
+ *
+ * @example
+ * ```typescript
+ * const model = resolveValue(ctx, "BrowseWeb", {
+ *   runtime: params.model,
+ *   subagentKey: "model",
+ *   parentKey: "model",
+ *   defaultValue: "sonnet",
+ *   handleInherit: true,
+ * });
+ * ```
+ */
+declare function resolveValue<T>(ctx: ExecutionContext, gadgetName: string, options: ResolveValueOptions<T>): T;
+/**
+ * Bulk configuration resolution for subagent gadgets.
+ *
+ * Takes a map of config keys to their resolution options and returns
+ * a fully resolved configuration object.
+ *
+ * @param ctx - ExecutionContext from gadget execution
+ * @param gadgetName - Name of the subagent gadget (e.g., "BrowseWeb")
+ * @param config - Map of config keys to resolution options
+ * @returns Fully resolved configuration object
+ *
+ * @example
+ * ```typescript
+ * // Before: 27 lines of manual fallback logic
+ * const subagentConfig = ctx.subagentConfig?.Dhalsim ?? {};
+ * const parentModel = ctx.agentConfig?.model;
+ * const model = params.model ?? subagentConfig.model ?? parentModel ?? "sonnet";
+ * const maxIterations = params.maxIterations ?? subagentConfig.maxIterations ?? 15;
+ * const headless = params.headless ?? subagentConfig.headless ?? true;
+ *
+ * // After: One function call
+ * const { model, maxIterations, headless } = resolveConfig(ctx, "BrowseWeb", {
+ *   model: { runtime: params.model, subagentKey: "model", parentKey: "model", defaultValue: "sonnet", handleInherit: true },
+ *   maxIterations: { runtime: params.maxIterations, subagentKey: "maxIterations", defaultValue: 15 },
+ *   headless: { runtime: params.headless, subagentKey: "headless", defaultValue: true },
+ * });
+ * ```
+ */
+declare function resolveConfig<T extends Record<string, unknown>>(ctx: ExecutionContext, gadgetName: string, config: {
+    [K in keyof T]: ResolveValueOptions<T[K]>;
+}): T;
+/**
+ * Convenience function for resolving subagent model with "inherit" support.
+ *
+ * This is the most common resolution pattern for subagent gadgets:
+ * - Use runtime model if provided
+ * - Check subagent config for model override
+ * - Inherit parent model if configured
+ * - Fall back to default
+ *
+ * @param ctx - ExecutionContext from gadget execution
+ * @param gadgetName - Name of the subagent gadget
+ * @param runtimeModel - Model from gadget parameters
+ * @param defaultModel - Default model if nothing else specified
+ * @returns Resolved model string
+ *
+ * @example
+ * ```typescript
+ * const model = resolveSubagentModel(ctx, "BrowseWeb", params.model, "sonnet");
+ * ```
+ */
+declare function resolveSubagentModel(ctx: ExecutionContext, gadgetName: string, runtimeModel: string | undefined, defaultModel: string): string;
+
 /**
  * Base Provider Adapter
  *
@@ -2621,4 +2720,4 @@ declare class OpenAIChatProvider extends BaseProviderAdapter {
 }
 declare function createOpenAIProviderFromEnv(): OpenAIChatProvider | null;
 
-export { AbortException, AbstractGadget, AgentHooks, AnthropicMessagesProvider, CompactionConfig, CompactionContext, CompactionEvent, CompactionManager, CompactionResult, CompactionStats, CompactionStrategy, ConversationManager, type CreateGadgetConfig, ExecutionContext, Gadget, GadgetCallParser, type GadgetConfig, GadgetExample, GadgetExecuteResultWithMedia, GadgetExecuteReturn, GadgetExecutionResult, GadgetExecutor, GadgetMediaOutput, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HintTemplate, type HintsConfig, HookPresets, HumanInputRequiredException, HybridStrategy, IConversationManager, type IterationHintOptions, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, LLMist, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, MediaKind, MediaMetadata, MediaStore, MessageContent, ModelDescriptor, ModelRegistry, ModelSpec, OpenAIChatProvider, type ParallelGadgetHintOptions, ParsedGadgetCall, ProviderAdapter, ResolvedCompactionConfig, SlidingWindowStrategy, type StoredOutput, StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, SubagentEvent, SummarizationStrategy, TaskCompletionSignal, TimeoutException, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createHints, createLogger, createMediaOutput, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, iterationProgressHint, parallelGadgetHint, resolveModel, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, validateAndApplyDefaults, validateGadgetParams };
+export { AbortException, AbstractGadget, AgentHooks, AnthropicMessagesProvider, CompactionConfig, CompactionContext, CompactionEvent, CompactionManager, CompactionResult, CompactionStats, CompactionStrategy, ConversationManager, type CreateGadgetConfig, ExecutionContext, ExecutionTree, Gadget, GadgetCallParser, type GadgetConfig, GadgetExample, GadgetExecuteResultWithMedia, GadgetExecuteReturn, GadgetExecutionResult, GadgetExecutor, GadgetMediaOutput, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HintTemplate, type HintsConfig, HookPresets, HumanInputRequiredException, HybridStrategy, IConversationManager, type IterationHintOptions, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, LLMist, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, MediaKind, MediaMetadata, MediaStore, MessageContent, ModelDescriptor, ModelRegistry, ModelSpec, NodeId, OpenAIChatProvider, type ParallelGadgetHintOptions, ParsedGadgetCall, ProviderAdapter, type ResolveValueOptions, ResolvedCompactionConfig, SlidingWindowStrategy, type StoredOutput, StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, SubagentEvent, SummarizationStrategy, TaskCompletionSignal, TimeoutException, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createHints, createLogger, createMediaOutput, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, iterationProgressHint, parallelGadgetHint, resolveConfig, resolveModel, resolveSubagentModel, resolveValue, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, validateAndApplyDefaults, validateGadgetParams };