llmist 2.5.0 → 3.0.0

package/dist/{mock-stream-ga4KIiwX.d.ts → mock-stream-COHw8h9b.d.ts}

@@ -745,9 +745,9 @@ declare class ModelIdentifierParser {
  */
 
 /**
- * Options for quick execution methods.
+ * Options for text generation methods (complete/stream).
  */
-interface QuickOptions {
+interface TextGenerationOptions {
     /** Model to use (supports aliases like "gpt4", "sonnet", "flash") */
     model?: string;
     /** Temperature (0-1) */
@@ -772,7 +772,7 @@ interface QuickOptions {
  * console.log(answer); // "4" or "2+2 equals 4"
  * ```
  */
-declare function complete(client: LLMist, prompt: string, options?: QuickOptions): Promise<string>;
+declare function complete(client: LLMist, prompt: string, options?: TextGenerationOptions): Promise<string>;
 /**
  * Quick streaming - returns async generator of text chunks.
  *
@@ -790,7 +790,7 @@ declare function complete(client: LLMist, prompt: string, options?: QuickOptions
  * }
  * ```
  */
-declare function stream(client: LLMist, prompt: string, options?: QuickOptions): AsyncGenerator<string>;
+declare function stream(client: LLMist, prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
 
 /**
  * Example of gadget usage to help LLMs understand proper invocation.
@@ -819,6 +819,81 @@ interface GadgetExample<TParams = Record<string, unknown>> {
     /** Optional description explaining what this example demonstrates */
     comment?: string;
 }
+/**
+ * Supported media types for gadget output.
+ * Extensible via union - add new types as needed.
+ */
+type MediaKind = "image" | "audio" | "video" | "file";
+/**
+ * Type-specific metadata for media outputs.
+ * Extensible via index signature for future media types.
+ */
+interface MediaMetadata {
+    /** Width in pixels (images, video) */
+    width?: number;
+    /** Height in pixels (images, video) */
+    height?: number;
+    /** Duration in milliseconds (audio, video) */
+    durationMs?: number;
+    /** Allow additional metadata for future extensions */
+    [key: string]: unknown;
+}
+/**
+ * Media output from a gadget execution.
+ * Supports images, audio, video, and arbitrary files.
+ *
+ * @example
+ * ```typescript
+ * // Image output
+ * const imageOutput: GadgetMediaOutput = {
+ *   kind: "image",
+ *   data: base64EncodedPng,
+ *   mimeType: "image/png",
+ *   description: "Screenshot of webpage",
+ *   metadata: { width: 1920, height: 1080 }
+ * };
+ * ```
+ */
+interface GadgetMediaOutput {
+    /** Type of media (discriminator for type-specific handling) */
+    kind: MediaKind;
+    /** Base64-encoded media data */
+    data: string;
+    /** Full MIME type (e.g., "image/png", "audio/mp3", "video/mp4") */
+    mimeType: string;
+    /** Human-readable description of the media */
+    description?: string;
+    /** Type-specific metadata */
+    metadata?: MediaMetadata;
+    /** Optional filename to use when saving (if not provided, auto-generated) */
+    fileName?: string;
+}
+/**
+ * Stored media item with metadata and file path.
+ *
+ * Created by MediaStore when a gadget returns media outputs.
+ * Contains the abstract ID, file path, and metadata for display.
+ */
+interface StoredMedia {
+    /** Unique ID for this media item (e.g., "media_a1b2c3") */
+    id: string;
+    /** Type of media */
+    kind: MediaKind;
+    /** Actual file path on disk (internal use) */
+    path: string;
+    /** MIME type */
+    mimeType: string;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** Human-readable description */
+    description?: string;
+    /** Type-specific metadata */
+    metadata?: MediaMetadata;
+    /** Name of the gadget that created this media */
+    gadgetName: string;
+    /** When the media was stored */
+    createdAt: Date;
+}
 interface GadgetExecutionResult {
     gadgetName: string;
     invocationId: string;
@@ -829,6 +904,12 @@ interface GadgetExecutionResult {
     breaksLoop?: boolean;
     /** Cost of gadget execution in USD. Defaults to 0 if not provided by gadget. */
     cost?: number;
+    /** Media outputs from the gadget (images, audio, video, files) */
+    media?: GadgetMediaOutput[];
+    /** Abstract IDs for media outputs (e.g., ["media_a1b2c3"]) */
+    mediaIds?: string[];
+    /** Stored media with paths (for CLI display) */
+    storedMedia?: StoredMedia[];
 }
 /**
  * Result returned by gadget execute() method.
@@ -849,12 +930,41 @@ interface GadgetExecuteResult {
     /** Optional cost in USD (e.g., 0.001 for $0.001) */
     cost?: number;
 }
+/**
+ * Extended result type with media support.
+ * Use this when gadget returns images, audio, video, or files.
+ *
+ * @example
+ * ```typescript
+ * // Return with image
+ * execute: () => ({
+ *   result: "Screenshot captured",
+ *   media: [{
+ *     kind: "image",
+ *     data: base64EncodedPng,
+ *     mimeType: "image/png",
+ *     description: "Screenshot"
+ *   }],
+ *   cost: 0.001
+ * })
+ * ```
+ */
+interface GadgetExecuteResultWithMedia {
+    /** The execution result as a string */
+    result: string;
+    /** Media outputs (images, audio, video, files) */
+    media?: GadgetMediaOutput[];
+    /** Optional cost in USD (e.g., 0.001 for $0.001) */
+    cost?: number;
+}
 /**
  * Union type for backwards-compatible execute() return type.
- * Gadgets can return either a string (legacy, cost = 0) or
- * an object with result and optional cost.
+ * Gadgets can return:
+ * - string (legacy, cost = 0)
+ * - GadgetExecuteResult (result + optional cost)
+ * - GadgetExecuteResultWithMedia (result + optional media + optional cost)
  */
-type GadgetExecuteReturn = string | GadgetExecuteResult;
+type GadgetExecuteReturn = string | GadgetExecuteResult | GadgetExecuteResultWithMedia;
 interface ParsedGadgetCall {
     gadgetName: string;
     invocationId: string;
@@ -993,12 +1103,12 @@ interface CostReportingLLMist {
      * Quick completion - returns final text response.
      * Costs are automatically reported to the execution context.
      */
-    complete(prompt: string, options?: QuickOptions): Promise<string>;
+    complete(prompt: string, options?: TextGenerationOptions): Promise<string>;
     /**
      * Quick streaming - returns async generator of text chunks.
      * Costs are automatically reported when the stream completes.
      */
-    streamText(prompt: string, options?: QuickOptions): AsyncGenerator<string>;
+    streamText(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
     /**
      * Low-level stream access for full control.
      * Costs are automatically reported based on usage metadata in chunks.
@@ -1147,16 +1257,111 @@ interface ExecutionContext {
      * ```
      */
     signal: AbortSignal;
+    /**
+     * Parent agent configuration for subagents to inherit.
+     *
+     * Contains the model and settings of the agent that invoked this gadget.
+     * Subagent gadgets (like BrowseWeb) can use this to inherit the parent's
+     * model by default, rather than using hardcoded defaults.
+     *
+     * This is optional - it will be `undefined` for:
+     * - Gadgets executed via CLI `gadget run` command
+     * - Direct gadget testing without agent context
+     *
+     * @example
+     * ```typescript
+     * execute: async (params, ctx) => {
+     *   // Inherit parent model unless explicitly specified
+     *   const model = params.model ?? ctx.agentConfig?.model ?? "sonnet";
+     *
+     *   const agent = new AgentBuilder(new LLMist())
+     *     .withModel(model)
+     *     .build();
+     *   // ...
+     * }
+     * ```
+     */
+    agentConfig?: AgentContextConfig;
+    /**
+     * Subagent-specific configuration overrides from CLI config.
+     *
+     * Contains per-subagent settings defined in `[subagents.Name]` or
+     * `[profile.subagents.Name]` sections of cli.toml. Allows users to
+     * customize subagent behavior without modifying gadget parameters.
+     *
+     * Resolution priority (highest to lowest):
+     * 1. Runtime params (explicit gadget call)
+     * 2. Profile-level subagent config
+     * 3. Global subagent config
+     * 4. Parent model (if "inherit")
+     * 5. Package defaults
+     *
+     * @example
+     * ```typescript
+     * execute: async (params, ctx) => {
+     *   const subagentConfig = ctx.subagentConfig?.BrowseWeb ?? {};
+     *
+     *   const model = params.model
+     *     ?? subagentConfig.model
+     *     ?? ctx.agentConfig?.model
+     *     ?? "sonnet";
+     *
+     *   const maxIterations = params.maxIterations
+     *     ?? subagentConfig.maxIterations
+     *     ?? 15;
+     *   // ...
+     * }
+     * ```
+     */
+    subagentConfig?: SubagentConfigMap;
 }
+/**
+ * Parent agent configuration passed to gadgets.
+ * Contains settings that subagents can inherit.
+ */
+interface AgentContextConfig {
+    /** Model identifier used by the parent agent */
+    model: string;
+    /** Temperature setting used by the parent agent */
+    temperature?: number;
+}
+/**
+ * Configuration for a single subagent.
+ * Can be defined globally in `[subagents.Name]` or per-profile in `[profile.subagents.Name]`.
+ *
+ * @example
+ * ```toml
+ * [subagents.BrowseWeb]
+ * model = "inherit"      # Use parent agent's model
+ * maxIterations = 20
+ * headless = true
+ * ```
+ */
+interface SubagentConfig {
+    /**
+     * Model to use for this subagent.
+     * - "inherit": Use parent agent's model (default behavior)
+     * - Any model ID: Use specific model (e.g., "sonnet", "haiku", "gpt-4o")
+     */
+    model?: string;
+    /** Maximum iterations for the subagent loop */
+    maxIterations?: number;
+    /** Additional subagent-specific options */
+    [key: string]: unknown;
+}
+/**
+ * Map of subagent names to their configurations.
+ */
+type SubagentConfigMap = Record<string, SubagentConfig>;
 
 /**
- * Internal base class for gadgets. Most users should use the `Gadget` class
- * (formerly TypedGadget) or `createGadget()` function instead, as they provide
- * better type safety and simpler APIs.
+ * Abstract base class for gadgets. Most users should use the `Gadget()` factory
+ * or `createGadget()` function instead, as they provide better type safety
+ * and simpler APIs.
  *
- * @internal
+ * Extend this class directly only when you need advanced control over gadget behavior.
  */
-declare abstract class BaseGadget {
+declare abstract class AbstractGadget {
     /**
      * The name of the gadget. Used for identification when LLM calls it.
      * If not provided, defaults to the class name.
@@ -1222,14 +1427,14 @@ declare abstract class BaseGadget {
      */
     abstract execute(params: Record<string, unknown>, ctx?: ExecutionContext): GadgetExecuteReturn | Promise<GadgetExecuteReturn>;
     /**
-     * Throws an AbortError if the execution has been aborted.
+     * Throws an AbortException if the execution has been aborted.
      *
      * Call this at key checkpoints in long-running gadgets to allow early exit
      * when the gadget has been cancelled (e.g., due to timeout). This enables
      * resource cleanup and prevents unnecessary work after cancellation.
      *
      * @param ctx - The execution context containing the abort signal
-     * @throws AbortError if ctx.signal.aborted is true
+     * @throws AbortException if ctx.signal.aborted is true
      *
      * @example
      * ```typescript
@@ -1350,7 +1555,7 @@ type ImageMimeType = "image/jpeg" | "image/png" | "image/gif" | "image/webp";
  * Supported audio MIME types for input.
  * Currently only Gemini supports audio input.
  */
-type AudioMimeType = "audio/mp3" | "audio/mpeg" | "audio/wav" | "audio/webm" | "audio/ogg";
+type AudioMimeType = "audio/mp3" | "audio/mpeg" | "audio/wav" | "audio/webm" | "audio/ogg" | "audio/flac";
 /**
  * Base interface for all content parts.
  */
@@ -1587,7 +1792,7 @@ type HintTemplate = string | ((context: HintContext) => string);
  *
  * @example
  * ```typescript
- * const customConfig: PromptConfig = {
+ * const customConfig: PromptTemplateConfig = {
  *   mainInstruction: "USE ONLY THE GADGET MARKERS BELOW:",
  *   criticalUsage: "Important: Follow the exact format shown.",
  *   rules: (ctx) => [
@@ -1598,7 +1803,7 @@ type HintTemplate = string | ((context: HintContext) => string);
  * };
  * ```
  */
-interface PromptConfig {
+interface PromptTemplateConfig {
     /**
      * Main instruction block that appears at the start of the gadget system prompt.
      * Default emphasizes using text markers instead of function calling.
@@ -1652,7 +1857,7 @@ declare const DEFAULT_HINTS: {
 /**
  * Default prompt templates used by llmist.
  */
-declare const DEFAULT_PROMPTS: Required<Omit<PromptConfig, "rules" | "customExamples" | "parallelGadgetsHint" | "iterationProgressHint"> & {
+declare const DEFAULT_PROMPTS: Required<Omit<PromptTemplateConfig, "rules" | "customExamples" | "parallelGadgetsHint" | "iterationProgressHint"> & {
     rules: (context: PromptContext) => string[];
     customExamples: null;
 }>;
@@ -1663,7 +1868,7 @@ declare function resolvePromptTemplate(template: PromptTemplate | undefined, def
 /**
  * Resolve rules template to an array of strings.
  */
-declare function resolveRulesTemplate(rules: PromptConfig["rules"] | undefined, context: PromptContext): string[];
+declare function resolveRulesTemplate(rules: PromptTemplateConfig["rules"] | undefined, context: PromptContext): string[];
 /**
  * Resolve a hint template to a string using the given context.
  * Supports both function templates and string templates with placeholders.
@@ -1675,14 +1880,14 @@ declare function resolveRulesTemplate(rules: PromptConfig["rules"] | undefined,
  */
 declare function resolveHintTemplate(template: HintTemplate | undefined, defaultValue: string, context: HintContext): string;
 
-type LLMRole = "system" | "user" | "assistant";
+type MessageRole = "system" | "user" | "assistant";
 /**
  * Message content can be a simple string (text only) or an array of content parts (multimodal).
  * Using a string is simpler for text-only messages, while arrays support images and audio.
  */
 type MessageContent = string | ContentPart[];
 interface LLMMessage {
-    role: LLMRole;
+    role: MessageRole;
     content: MessageContent;
     name?: string;
     metadata?: Record<string, unknown>;
@@ -1694,7 +1899,7 @@ interface LLMMessage {
  * @param content - Message content (string or ContentPart[])
  * @returns Array of content parts
  */
-declare function normalizeContent(content: MessageContent): ContentPart[];
+declare function normalizeMessageContent(content: MessageContent): ContentPart[];
 /**
  * Extract text from message content.
  * Concatenates all text parts in the content.
@@ -1702,21 +1907,21 @@ declare function normalizeContent(content: MessageContent): ContentPart[];
  * @param content - Message content (string or ContentPart[])
  * @returns Combined text from all text parts
  */
-declare function extractText(content: MessageContent): string;
+declare function extractMessageText(content: MessageContent): string;
 declare class LLMMessageBuilder {
     private readonly messages;
     private startPrefix;
     private endPrefix;
     private argPrefix;
     private promptConfig;
-    constructor(promptConfig?: PromptConfig);
+    constructor(promptConfig?: PromptTemplateConfig);
     /**
      * Set custom prefixes for gadget markers.
      * Used to configure history builder to match system prompt markers.
      */
     withPrefixes(startPrefix: string, endPrefix: string, argPrefix?: string): this;
     addSystem(content: string, metadata?: Record<string, unknown>): this;
-    addGadgets(gadgets: BaseGadget[], options?: {
+    addGadgets(gadgets: AbstractGadget[], options?: {
         startPrefix?: string;
         endPrefix?: string;
         argPrefix?: string;
@@ -1811,7 +2016,17 @@ declare class LLMMessageBuilder {
      * ```
      */
     addUserMultimodal(parts: ContentPart[]): this;
-    addGadgetCall(gadget: string, parameters: Record<string, unknown>, result: string): this;
+    /**
+     * Record a gadget execution result in the message history.
+     * Creates an assistant message with the gadget invocation and a user message with the result.
+     *
+     * @param gadget - Name of the gadget that was executed
+     * @param parameters - Parameters that were passed to the gadget
+     * @param result - Text result from the gadget execution
+     * @param media - Optional media outputs from the gadget
+     * @param mediaIds - Optional IDs for the media outputs
+     */
+    addGadgetCallResult(gadget: string, parameters: Record<string, unknown>, result: string, media?: GadgetMediaOutput[], mediaIds?: string[]): this;
     /**
      * Format parameters as Block format with JSON Pointer paths.
      * Uses the configured argPrefix for consistency with system prompt.
@@ -2004,7 +2219,7 @@ declare class TextNamespace {
      * @param options - Optional configuration
      * @returns Complete text response
      */
-    complete(prompt: string, options?: QuickOptions): Promise<string>;
+    complete(prompt: string, options?: TextGenerationOptions): Promise<string>;
     /**
      * Stream text chunks.
      *
@@ -2012,7 +2227,7 @@ declare class TextNamespace {
      * @param options - Optional configuration
      * @returns Async generator yielding text chunks
      */
-    stream(prompt: string, options?: QuickOptions): AsyncGenerator<string>;
+    stream(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
 }
 
 /**
@@ -2235,7 +2450,7 @@ declare class LLMist {
      * });
      * ```
      */
-    static complete(prompt: string, options?: QuickOptions): Promise<string>;
+    static complete(prompt: string, options?: TextGenerationOptions): Promise<string>;
     /**
      * Quick streaming - returns async generator of text chunks.
      * Convenient for streaming responses without needing agent setup.
@@ -2259,7 +2474,7 @@ declare class LLMist {
      * }
      * ```
      */
-    static stream(prompt: string, options?: QuickOptions): AsyncGenerator<string>;
+    static stream(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
     /**
      * Instance method: Quick completion using this client instance.
      *
@@ -2267,7 +2482,7 @@ declare class LLMist {
      * @param options - Optional configuration
      * @returns Complete text response
      */
-    complete(prompt: string, options?: QuickOptions): Promise<string>;
+    complete(prompt: string, options?: TextGenerationOptions): Promise<string>;
     /**
      * Instance method: Quick streaming using this client instance.
      *
@@ -2275,7 +2490,7 @@ declare class LLMist {
      * @param options - Optional configuration
      * @returns Async generator yielding text chunks
      */
-    streamText(prompt: string, options?: QuickOptions): AsyncGenerator<string>;
+    streamText(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
     /**
      * Create a fluent agent builder.
      * Provides a chainable API for configuring and creating agents.
@@ -2322,8 +2537,8 @@ declare class LLMist {
     createAgent(): AgentBuilder;
 }
 
-type GadgetClass = new (...args: unknown[]) => BaseGadget;
-type GadgetOrClass = BaseGadget | GadgetClass;
+type GadgetClass = new (...args: unknown[]) => AbstractGadget;
+type GadgetOrClass = AbstractGadget | GadgetClass;
 declare class GadgetRegistry {
     private readonly gadgets;
     /**
@@ -2362,16 +2577,131 @@ declare class GadgetRegistry {
      * ```
      */
     registerMany(gadgets: GadgetOrClass[]): this;
-    register(name: string, gadget: BaseGadget): void;
-    registerByClass(gadget: BaseGadget): void;
-    get(name: string): BaseGadget | undefined;
+    register(name: string, gadget: AbstractGadget): void;
+    registerByClass(gadget: AbstractGadget): void;
+    get(name: string): AbstractGadget | undefined;
     has(name: string): boolean;
     getNames(): string[];
-    getAll(): BaseGadget[];
+    getAll(): AbstractGadget[];
     unregister(name: string): boolean;
     clear(): void;
 }
 
+/**
+ * MediaStore: Session-scoped storage for gadget media outputs.
+ *
+ * This module provides an abstraction layer between gadgets and the filesystem.
+ * Instead of exposing raw file paths, it assigns unique IDs to stored media
+ * that can be shared with the LLM and user.
+ *
+ * @example
+ * ```typescript
+ * const store = new MediaStore();
+ *
+ * // Store an image, get back ID
+ * const stored = await store.store({
+ *   kind: "image",
+ *   data: base64EncodedPng,
+ *   mimeType: "image/png",
+ *   description: "Screenshot"
+ * }, "Screenshot");
+ *
+ * console.log(stored.id); // "media_a1b2c3"
+ * console.log(stored.path); // "/tmp/llmist-media-xxx/Screenshot_001.png"
+ *
+ * // Later: retrieve by ID
+ * const retrieved = store.get("media_a1b2c3");
+ * ```
+ */
+
+/**
+ * Session-scoped media storage with ID abstraction.
+ *
+ * Each MediaStore instance manages media for a single agent session.
+ * Media files are stored in a temporary directory and referenced by
+ * short, unique IDs rather than file paths.
+ */
+declare class MediaStore {
+    private readonly items;
+    private readonly outputDir;
+    private counter;
+    private initialized;
+    /**
+     * Create a new MediaStore.
+     *
+     * @param sessionId - Optional session ID for the output directory.
+     *                    If not provided, a random ID is generated.
+     */
+    constructor(sessionId?: string);
+    /**
+     * Get the output directory path.
+     */
+    getOutputDir(): string;
+    /**
+     * Ensure the output directory exists.
+     * @throws Error if directory creation fails
+     */
+    private ensureDir;
+    /**
+     * Generate a unique media ID.
+     * Format: "media_" + 6 random alphanumeric characters
+     */
+    private generateId;
+    /**
+     * Get file extension from MIME type.
+     */
+    private getExtension;
+    /**
+     * Store media and return stored metadata with ID.
+     *
+     * @param media - The media output from a gadget
+     * @param gadgetName - Name of the gadget that created this media
+     * @returns Stored media information including generated ID
+     * @throws Error if file write fails
+     */
+    store(media: GadgetMediaOutput, gadgetName: string): Promise<StoredMedia>;
+    /**
+     * Get stored media by ID.
+     *
+     * @param id - The media ID (e.g., "media_a1b2c3")
+     * @returns The stored media or undefined if not found
+     */
+    get(id: string): StoredMedia | undefined;
+    /**
+     * Get the actual file path for a media ID.
+     * Convenience method for gadgets that need the raw path.
+     *
+     * @param id - The media ID
+     * @returns The file path or undefined if not found
+     */
+    getPath(id: string): string | undefined;
+    /**
+     * List all stored media, optionally filtered by kind.
+     *
+     * @param kind - Optional media kind to filter by
+     * @returns Array of stored media items
+     */
+    list(kind?: MediaKind): StoredMedia[];
+    /**
+     * Get the count of stored media items.
+     */
+    get size(): number;
+    /**
+     * Check if a media ID exists.
+     */
+    has(id: string): boolean;
+    /**
+     * Clear in-memory store without deleting files.
+     * Resets the counter but leaves files on disk.
+     */
+    clear(): void;
+    /**
+     * Delete all stored files and clear memory.
+     * Removes the entire session directory.
+     */
+    cleanup(): Promise<void>;
+}
+
 /**
  * Internal key for Agent instantiation.
  * This Symbol is used to ensure only AgentBuilder can create Agent instances.
@@ -3095,8 +3425,8 @@ interface AgentOptions {
     logger?: Logger<ILogObj>;
     /** Clean hooks system */
     hooks?: AgentHooks;
-    /** Callback for human input */
-    onHumanInputRequired?: (question: string) => Promise<string>;
+    /** Callback for requesting human input during execution */
+    requestHumanInput?: (question: string) => Promise<string>;
     /** Custom gadget start prefix */
     gadgetStartPrefix?: string;
     /** Custom gadget end prefix */
@@ -3124,8 +3454,8 @@ interface AgentOptions {
     };
     /** Stop on gadget error */
     stopOnGadgetError?: boolean;
-    /** Custom error continuation logic */
-    shouldContinueAfterError?: (context: {
+    /** Custom error recovery logic */
+    canRecoverFromGadgetError?: (context: {
         error: string;
         gadgetName: string;
         errorType: "parse" | "validation" | "execution";
@@ -3134,7 +3464,7 @@ interface AgentOptions {
     /** Default gadget timeout */
     defaultGadgetTimeoutMs?: number;
     /** Custom prompt configuration for gadget system prompts */
-    promptConfig?: PromptConfig;
+    promptConfig?: PromptTemplateConfig;
     /** Enable gadget output limiting (default: true) */
     gadgetOutputLimit?: boolean;
     /** Max gadget output as % of model context window (default: 15) */
@@ -3143,6 +3473,8 @@ interface AgentOptions {
     compactionConfig?: CompactionConfig;
     /** Optional abort signal for cancelling requests mid-flight */
     signal?: AbortSignal;
+    /** Subagent-specific configuration overrides (from CLI config) */
+    subagentConfig?: SubagentConfigMap;
 }
 /**
  * Agent: Lean orchestrator that delegates to StreamProcessor.
@@ -3171,19 +3503,22 @@ declare class Agent {
     private readonly gadgetStartPrefix?;
     private readonly gadgetEndPrefix?;
     private readonly gadgetArgPrefix?;
-    private readonly onHumanInputRequired?;
+    private readonly requestHumanInput?;
     private readonly textOnlyHandler;
     private readonly textWithGadgetsHandler?;
     private readonly stopOnGadgetError;
-    private readonly shouldContinueAfterError?;
+    private readonly canRecoverFromGadgetError?;
     private readonly defaultGadgetTimeoutMs?;
     private readonly defaultMaxTokens?;
-    private userPromptProvided;
+    private hasUserPrompt;
     private readonly outputStore;
     private readonly outputLimitEnabled;
     private readonly outputLimitCharLimit;
     private readonly compactionManager?;
+    private readonly mediaStore;
     private readonly signal?;
+    private readonly agentContextConfig;
+    private readonly subagentConfig?;
     /**
      * Creates a new Agent instance.
      * @internal This constructor is private. Use LLMist.createAgent() or AgentBuilder instead.
@@ -3208,6 +3543,34 @@ declare class Agent {
      * ```
      */
     getRegistry(): GadgetRegistry;
+    /**
+     * Get the media store for this agent session.
+     *
+     * The media store holds all media outputs (images, audio, etc.) produced by gadgets
+     * during this agent's execution. Use this to:
+     * - Access stored media files by ID
+     * - List all stored media
+     * - Clean up temporary files after execution
+     *
+     * @returns The MediaStore instance for this agent
+     *
+     * @example
+     * ```typescript
+     * const agent = new AgentBuilder()
+     *   .withModel("sonnet")
+     *   .build();
+     *
+     * // After execution, access stored media
+     * const store = agent.getMediaStore();
+     * for (const media of store.list()) {
+     *   console.log(`${media.id}: ${media.path}`);
+     * }
+     *
+     * // Clean up when done
+     * await store.cleanup();
+     * ```
+     */
+    getMediaStore(): MediaStore;
     /**
      * Manually trigger context compaction.
      *
@@ -3272,10 +3635,10 @@ declare class Agent {
      */
     private resolveMaxTokensFromCatalog;
     /**
-     * Merge the output limiter interceptor into user-provided hooks.
+     * Chain the output limiter interceptor with user-provided hooks.
      * The limiter runs first, then chains to any user interceptor.
      */
-    private mergeOutputLimiterHook;
+    private chainOutputLimiterWithUserHooks;
     /**
      * Run agent with named event handlers (syntactic sugar).
      *
@@ -3351,20 +3714,21 @@ declare class AgentBuilder {
     private promptConfig?;
     private gadgets;
     private initialMessages;
-    private onHumanInputRequired?;
+    private requestHumanInput?;
     private gadgetStartPrefix?;
     private gadgetEndPrefix?;
     private gadgetArgPrefix?;
     private textOnlyHandler?;
     private textWithGadgetsHandler?;
     private stopOnGadgetError?;
-    private shouldContinueAfterError?;
+    private canRecoverFromGadgetError?;
     private defaultGadgetTimeoutMs?;
     private gadgetOutputLimit?;
     private gadgetOutputLimitPercent?;
     private compactionConfig?;
     private signal?;
     private trailingMessage?;
+    private subagentConfig?;
     constructor(client?: LLMist);
     /**
      * Set the model to use.
@@ -3435,13 +3799,13 @@ declare class AgentBuilder {
      *
      * @example
      * ```typescript
-     * .withPromptConfig({
+     * .withPromptTemplateConfig({
      *   mainInstruction: "Use the gadget markers below:",
      *   rules: ["Always use markers", "Never use function calling"]
      * })
      * ```
      */
-    withPromptConfig(config: PromptConfig): this;
+    withPromptTemplateConfig(config: PromptTemplateConfig): this;
     /**
      * Add gadgets (classes or instances).
      * Can be called multiple times to add more gadgets.
@@ -3620,9 +3984,9 @@ declare class AgentBuilder {
      * Provides fine-grained control over whether to continue after different types of errors.
      * Overrides `stopOnGadgetError` when provided.
      *
-     * **Note:** This builder method configures the underlying `shouldContinueAfterError` option
+     * **Note:** This builder method configures the underlying `canRecoverFromGadgetError` option
      * in `AgentOptions`. The method is named `withErrorHandler` for better developer experience,
-     * but maps to the `shouldContinueAfterError` property internally.
+     * but maps to the `canRecoverFromGadgetError` property internally.
      *
      * @param handler - Function that decides whether to continue after an error.
      *                  Return `true` to continue execution, `false` to stop.
@@ -3762,6 +4126,24 @@ declare class AgentBuilder {
      * ```
      */
     withSignal(signal: AbortSignal): this;
+    /**
+     * Set subagent configuration overrides.
+     *
+     * Subagent gadgets (like BrowseWeb) can read these settings from ExecutionContext
+     * to inherit model and other options from the CLI configuration.
+     *
+     * @param config - Subagent configuration map keyed by gadget name
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * .withSubagentConfig({
+     *   BrowseWeb: { model: "inherit", maxIterations: 20, headless: true },
+     *   CodeAnalyzer: { model: "sonnet", maxIterations: 10 }
+     * })
+     * ```
+     */
+    withSubagentConfig(config: SubagentConfigMap): this;
     /**
      * Add an ephemeral trailing message that appears at the end of each LLM request.
      *
@@ -3981,8 +4363,9 @@ interface IConversationManager {
     addAssistantMessage(content: string): void;
     /**
      * Adds a gadget call and its result to the conversation.
+     * Optionally includes media outputs (images, audio, etc.) for multimodal results.
      */
-    addGadgetCall(gadgetName: string, parameters: Record<string, unknown>, result: string): void;
+    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, media?: GadgetMediaOutput[], mediaIds?: string[]): void;
     /**
      * Gets the complete conversation history including base messages (system prompts, gadget instructions).
      */
@@ -4718,4 +5101,4 @@ declare function createTextMockStream(text: string, options?: {
     usage?: MockResponse["usage"];
 }): LLMStream;
 
-export { type TrailingMessage as $, type AgentHooks as A, BaseGadget as B, type CompactionStrategy as C, type GadgetExecuteReturn as D, type ExecutionContext as E, type GadgetExample as F, GadgetRegistry as G, type HintTemplate as H, type IConversationManager as I, type GadgetExecutionResult as J, type ProviderAdapter as K, type LLMStream as L, MockProviderAdapter as M, type ModelDescriptor as N, type ModelSpec as O, type ParsedGadgetCall as P, type LLMGenerationOptions as Q, type ResolvedCompactionConfig as R, type StreamEvent as S, type TokenUsage as T, type ImageModelSpec as U, type ImageGenerationOptions as V, type ImageGenerationResult as W, type SpeechModelSpec as X, type SpeechGenerationOptions as Y, type SpeechGenerationResult as Z, type HistoryMessage as _, type LLMStreamChunk as a, type VisionAnalyzeOptions as a$, type TrailingMessageContext as a0, AgentBuilder as a1, type EventHandlers as a2, collectEvents as a3, collectText as a4, runWithHandlers as a5, type AfterGadgetExecutionAction as a6, type AfterGadgetExecutionControllerContext as a7, type AfterLLMCallAction as a8, type AfterLLMCallControllerContext as a9, type AudioMimeType as aA, type AudioSource as aB, type ContentPart as aC, type ImageBase64Source as aD, type ImageContentPart as aE, type ImageMimeType as aF, type ImageSource as aG, type ImageUrlSource as aH, type TextContentPart as aI, audioFromBase64 as aJ, audioFromBuffer as aK, detectAudioMimeType as aL, detectImageMimeType as aM, imageFromBase64 as aN, imageFromBuffer as aO, imageFromUrl as aP, isAudioPart as aQ, isDataUrl as aR, isImagePart as aS, isTextPart as aT, parseDataUrl as aU, text as aV, toBase64 as aW, type LLMRole as aX, extractText as aY, LLMMessageBuilder as aZ, normalizeContent as a_, type AfterLLMErrorAction as aa, type AgentOptions as ab, type BeforeGadgetExecutionAction as ac, type BeforeLLMCallAction as ad, type ChunkInterceptorContext as ae, type Controllers as af, type GadgetExecutionControllerContext as ag, type GadgetParameterInterceptorContext as ah, type GadgetResultInterceptorContext as ai, type Interceptors as aj, type LLMCallControllerContext as ak, type LLMErrorControllerContext as al, type MessageInterceptorContext as am, type ObserveChunkContext as an, type ObserveGadgetCompleteContext as ao, type ObserveGadgetStartContext as ap, type ObserveLLMCallContext as aq, type ObserveLLMCompleteContext as ar, type ObserveLLMErrorContext as as, type Observers as at, type MessageTurn as au, type ObserveCompactionContext as av, DEFAULT_COMPACTION_CONFIG as aw, DEFAULT_SUMMARIZATION_PROMPT as ax, type LLMistOptions as ay, type AudioContentPart as az, type LLMMessage as b, type VisionAnalyzeResult as b0, type CostEstimate as b1, type ModelFeatures as b2, type ModelLimits as b3, type ModelPricing as b4, type ProviderIdentifier as b5, ModelIdentifierParser as b6, type HintContext as b7, type PromptConfig as b8, type PromptContext as b9, type PromptTemplate as ba, DEFAULT_HINTS as bb, DEFAULT_PROMPTS as bc, resolveHintTemplate as bd, resolvePromptTemplate as be, resolveRulesTemplate as bf, type QuickOptions as bg, complete as bh, stream as bi, type GadgetClass as bj, type GadgetOrClass as bk, type CostReportingLLMist as bl, type GadgetExecuteResult as bm, type GadgetSkippedEvent as bn, type TextOnlyAction as bo, type TextOnlyContext as bp, type TextOnlyCustomHandler as bq, type TextOnlyGadgetConfig as br, type TextOnlyHandler as bs, type TextOnlyStrategy as bt, createMockAdapter as c, MockBuilder as d, createMockClient as e, MockManager as f, getMockManager as g, createMockStream as h, createTextMockStream as i, type MockAudioData as j, type MockImageData as k, type MockMatcher as l, mockLLM as m, type MockMatcherContext as n, type MockOptions as o, type MockRegistration as p, type MockResponse as q, type MockStats as r, ModelRegistry as s, type MessageContent as t, LLMist as u, type CompactionContext as v, type CompactionResult as w, type CompactionConfig as x, type CompactionEvent as y, type CompactionStats as z };
+export { type ImageModelSpec as $, AbstractGadget as A, type MessageContent as B, type CompactionConfig as C, GadgetRegistry as D, MediaStore as E, type AgentContextConfig as F, type GadgetMediaOutput as G, type HintTemplate as H, type IConversationManager as I, type SubagentConfigMap as J, type ExecutionContext as K, type LLMMessage as L, MockProviderAdapter as M, type GadgetExecuteReturn as N, type GadgetExample as O, type ParsedGadgetCall as P, type GadgetExecutionResult as Q, type ResolvedCompactionConfig as R, type StreamEvent as S, type TokenUsage as T, type MediaKind as U, type MediaMetadata as V, type GadgetExecuteResultWithMedia as W, type ProviderAdapter as X, type ModelDescriptor as Y, type ModelSpec as Z, type LLMGenerationOptions as _, type LLMStream as a, parseDataUrl as a$, type ImageGenerationOptions as a0, type ImageGenerationResult as a1, type SpeechModelSpec as a2, type SpeechGenerationOptions as a3, type SpeechGenerationResult as a4, type HistoryMessage as a5, type TrailingMessage as a6, type TrailingMessageContext as a7, AgentBuilder as a8, type EventHandlers as a9, type ObserveLLMCompleteContext as aA, type ObserveLLMErrorContext as aB, type Observers as aC, DEFAULT_COMPACTION_CONFIG as aD, DEFAULT_SUMMARIZATION_PROMPT as aE, type LLMistOptions as aF, type AudioContentPart as aG, type AudioMimeType as aH, type AudioSource as aI, type ContentPart as aJ, type ImageBase64Source as aK, type ImageContentPart as aL, type ImageMimeType as aM, type ImageSource as aN, type ImageUrlSource as aO, type TextContentPart as aP, audioFromBase64 as aQ, audioFromBuffer as aR, detectAudioMimeType as aS, detectImageMimeType as aT, imageFromBase64 as aU, imageFromBuffer as aV, imageFromUrl as aW, isAudioPart as aX, isDataUrl as aY, isImagePart as aZ, isTextPart as a_, collectEvents as aa, collectText as ab, runWithHandlers as ac, type AfterGadgetExecutionAction as ad, type AfterGadgetExecutionControllerContext as ae, type AfterLLMCallAction as af, type AfterLLMCallControllerContext as ag, type AfterLLMErrorAction as ah, type AgentOptions as ai, type BeforeGadgetExecutionAction as aj, type BeforeLLMCallAction as ak, type ChunkInterceptorContext as al, type Controllers as am, type GadgetExecutionControllerContext as an, type GadgetParameterInterceptorContext as ao, type GadgetResultInterceptorContext as ap, type Interceptors as aq, type LLMCallControllerContext as ar, type LLMErrorControllerContext as as, type MessageInterceptorContext as at, type MessageTurn as au, type ObserveChunkContext as av, type ObserveCompactionContext as aw, type ObserveGadgetCompleteContext as ax, type ObserveGadgetStartContext as ay, type ObserveLLMCallContext as az, type LLMStreamChunk as b, text as b0, toBase64 as b1, type MessageRole as b2, extractMessageText as b3, LLMMessageBuilder as b4, normalizeMessageContent as b5, type CostEstimate as b6, type ModelFeatures as b7, type ModelLimits as b8, type ModelPricing as b9, type TextOnlyHandler as bA, type TextOnlyStrategy as bB, type VisionAnalyzeOptions as ba, type VisionAnalyzeResult as bb, type ProviderIdentifier as bc, ModelIdentifierParser as bd, type HintContext as be, type PromptContext as bf, type PromptTemplate as bg, type PromptTemplateConfig as bh, DEFAULT_HINTS as bi, DEFAULT_PROMPTS as bj, resolveHintTemplate as bk, resolvePromptTemplate as bl, resolveRulesTemplate as bm, type TextGenerationOptions as bn, complete as bo, stream as bp, type GadgetClass as bq, type GadgetOrClass as br, type CostReportingLLMist as bs, type GadgetExecuteResult as bt, type GadgetSkippedEvent as bu, type StoredMedia as bv, type TextOnlyAction as bw, type TextOnlyContext as bx, type TextOnlyCustomHandler as by, type TextOnlyGadgetConfig as bz, createMockAdapter as c, MockBuilder as d, createMockClient as e, MockManager as f, getMockManager as g, createMockStream as h, createTextMockStream as i, type MockAudioData as j, type MockImageData as k, type MockMatcher as l, mockLLM as m, type MockMatcherContext as n, type MockOptions as o, type MockRegistration as p, type MockResponse as q, type MockStats as r, type AgentHooks as s, ModelRegistry as t, LLMist as u, type CompactionEvent as v, type CompactionStats as w, type CompactionStrategy as x, type CompactionContext as y, type CompactionResult as z };