llmist 17.3.0 → 17.5.0

package/dist/index.d.cts

@@ -3,10 +3,119 @@ import { ZodType, ZodTypeAny } from 'zod';
 export { z } from 'zod';
 import { Logger, ILogObj } from 'tslog';
 export { ILogObj, Logger } from 'tslog';
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { MessageCreateParamsStreaming, MessageStreamEvent } from '@anthropic-ai/sdk/resources/messages';
 import OpenAI from 'openai';
 import { ChatCompletionMessageParam, ChatCompletionContentPart, ChatCompletionChunk } from 'openai/resources/chat/completions';
 
+/**
+ * Public types for the MCP integration.
+ *
+ * @module mcp/types
+ */
+/**
+ * User-supplied spec describing an MCP server to consume.
+ */
+type McpServerSpec = StdioMcpServerSpec | HttpMcpServerSpec;
+interface StdioMcpServerSpec {
+    /** Stable server name used for namespacing tools and surfacing in logs. */
+    name: string;
+    /** Stdio transport — server is spawned as a child process. */
+    transport: "stdio";
+    /** Executable to spawn. The basename is checked against the allowlist unless trust=true. */
+    command: string;
+    /** Arguments to pass to the executable. */
+    args?: string[];
+    /** Optional environment overrides for the spawned child process. */
+    env?: Record<string, string>;
+    /** Skip the allowlist check for this server. Default false. */
+    trust?: boolean;
+    /** Per-call timeout in milliseconds for tools/call. Default: no timeout. */
+    timeoutMs?: number;
+}
+interface HttpMcpServerSpec {
+    /** Stable server name. */
+    name: string;
+    /** Streamable HTTP transport (the modern, non-deprecated remote transport). */
+    transport: "http";
+    /** Server URL (must include scheme — http:// or https://). */
+    url: string;
+    /** Optional fixed headers (e.g. Authorization, X-API-Key). */
+    headers?: Record<string, string>;
+    /** Per-call timeout in milliseconds for tools/call. Default: no timeout. */
+    timeoutMs?: number;
+}
+/**
+ * Minimal subset of an MCP tool descriptor that this integration cares about.
+ */
+interface McpToolDescriptor {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+}
+/**
+ * Canonical MCP content block shape used by the SDK.
+ *
+ * The SDK uses larger union types; this is the subset the adapter handles.
+ */
+type McpContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+} | {
+    type: "audio";
+    data: string;
+    mimeType: string;
+} | {
+    type: string;
+    [k: string]: unknown;
+};
+/**
+ * Result shape returned from a tools/call.
+ */
+interface McpToolResult {
+    content: McpContentBlock[];
+    isError?: boolean;
+}
+interface McpPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+interface McpPromptDescriptor {
+    name: string;
+    description?: string;
+    arguments?: McpPromptArgument[];
+}
+interface McpPromptMessage {
+    role: "user" | "assistant";
+    content: McpContentBlock;
+}
+interface McpPromptResult {
+    description?: string;
+    messages: McpPromptMessage[];
+}
+/**
+ * Server capabilities advertised on initialize. Only the fields used by plan 1
+ * are typed; richer capabilities arrive in plan 2.
+ */
+interface McpServerCapabilities {
+    tools?: {
+        listChanged?: boolean;
+    };
+    prompts?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        listChanged?: boolean;
+        subscribe?: boolean;
+    };
+    [k: string]: unknown;
+}
+
 /**
  * Types and interfaces for multimodal input content.
  *
@@ -5056,10 +5165,6 @@ declare function collectEvents(agentGenerator: AsyncGenerator<StreamEvent>, coll
  */
 declare function collectText(agentGenerator: AsyncGenerator<StreamEvent>): Promise<string>;
 
-/**
- * Fluent builder for creating agents with delightful DX.
- */
-
 /**
  * Fluent builder for creating agents.
  *
@@ -5073,6 +5178,7 @@ declare class AgentBuilder {
     private subagents;
     private policies;
     private skills;
+    private mcp;
     constructor(client?: LLMist);
     /** Set the model to use. Supports aliases like "sonnet", "flash". */
     withModel(model: string): this;
@@ -5092,6 +5198,40 @@ declare class AgentBuilder {
     withPromptTemplateConfig(config: PromptTemplateConfig): this;
     /** Add gadgets (classes or instances). */
     withGadgets(...gadgets: GadgetOrClass[]): this;
+    /**
+     * Attach a Model Context Protocol (MCP) server.
+     *
+     * The agent connects to the server lazily at the start of `run()`,
+     * discovers its tools, and registers them as native gadgets so the LLM
+     * can call them through the standard streaming block format.
+     *
+     * Calling this multiple times accumulates servers. Tools across servers
+     * are merged into a single registry; in plan 1, conflicting tool names
+     * raise a registration warning. Plan 2 introduces deterministic
+     * `<server>__<tool>` prefixing for collisions.
+     *
+     * STDIO commands are gated by an allowlist (see allowlist.ts) — pass
+     * `trust: true` on the spec to opt in for non-allowlisted binaries.
+     *
+     * Zero-overhead invariant: if you never call this method, the MCP
+     * runtime module is never loaded. Agents without MCP pay nothing.
+     *
+     * @example
+     * ```typescript
+     * const agent = LLMist.createAgent()
+     *   .withModel("sonnet")
+     *   .withMcpServer({
+     *     name: "filesystem",
+     *     transport: "stdio",
+     *     command: "npx",
+     *     args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
+     *   })
+     *   .ask("list files in /tmp");
+     * ```
+     */
+    withMcpServer(spec: McpServerSpec): this;
+    /** Inspect the configured MCP server specs. Useful for tests. */
+    getMcpServerSpecs(): readonly McpServerSpec[];
     /** Add conversation history messages. */
     withHistory(messages: HistoryMessage[]): this;
     /** Add a single message to the conversation history. */
@@ -5912,13 +6052,6 @@ interface OutputLimitConfig {
     limitPercent?: number;
 }
 
-/**
- * Agent: Lean orchestrator using the clean hooks architecture.
- *
- * The Agent delegates ALL stream processing and hook coordination to StreamProcessor,
- * making it a simple loop orchestrator with clear responsibilities.
- */
-
 /**
  * Configuration for the execution tree context (shared tree model with subagents).
  */
@@ -6052,6 +6185,18 @@ interface AgentOptions {
      * settings instead of creating its own.
      */
     sharedRetryConfig?: ResolvedRetryConfig;
+    /**
+     * MCP server specs to attach to the agent.
+     *
+     * When non-empty, the agent connects to each server lazily at the start of
+     * `run()`, lists their tools, wraps them as native gadgets, and registers
+     * them on the registry alongside any explicitly-provided gadgets. The
+     * lifecycle teardown happens in the agent's `finally` block.
+     *
+     * When empty or omitted, the MCP module is never imported — agents that
+     * don't use MCP pay zero overhead at load time.
+     */
+    mcpSpecs?: McpServerSpec[];
 }
 /**
  * Agent: Lean orchestrator that delegates to StreamProcessor.
@@ -6097,6 +6242,9 @@ declare class Agent {
     private readonly parentNodeId;
     private readonly streamProcessorFactory;
     private readonly llmCallLifecycle;
+    private readonly mcpSpecs;
+    private mcpLifecycle;
+    private readonly mcpDiscoveredPrompts;
     /**
      * Creates a new Agent instance.
      * @internal This constructor is private. Use LLMist.createAgent() or AgentBuilder instead.
@@ -7486,7 +7634,7 @@ interface ConversationManagerOptions {
  * Manages conversation history by building on top of base messages (system prompt, gadget instructions).
  */
 declare class ConversationManager implements IConversationManager {
-    private readonly baseMessages;
+    private baseMessages;
     private readonly initialMessages;
     private historyBuilder;
     private readonly startPrefix?;
@@ -7499,6 +7647,14 @@ declare class ConversationManager implements IConversationManager {
     getMessages(): LLMMessage[];
     getHistoryMessages(): LLMMessage[];
     getBaseMessages(): LLMMessage[];
+    /**
+     * Replace the base (system + gadget catalog) messages.
+     *
+     * Used when async setup (e.g. MCP server connect-and-list) discovers
+     * additional gadgets after the agent was constructed. Conversation history
+     * is preserved; only the leading system block is swapped.
+     */
+    replaceBaseMessages(newBase: LLMMessage[]): void;
     replaceHistory(newHistory: LLMMessage[]): void;
     getConversationHistory(): LLMMessage[];
 }
@@ -8623,6 +8779,285 @@ declare class GadgetCallParser {
     reset(): void;
 }
 
+/**
+ * Default-safe allowlist for MCP STDIO server commands.
+ *
+ * Mitigates the CVE-2026-30623 family of stdio-spawn RCE vulnerabilities. The
+ * gate refuses to spawn any executable whose basename is not in the allowlist
+ * unless the spec is marked `trust: true` (library) / `trust = true` (TOML)
+ * / `--mcp-trust <name>` (CLI). It also rejects whole-string commands that
+ * embed args or shell metacharacters — callers must pass arguments as a
+ * separate array.
+ *
+ * @module mcp/allowlist
+ */
+/**
+ * Default allowlist of MCP stdio server runtimes that are safe to spawn
+ * without explicit user opt-in. Add entries to this list only when the
+ * basename is universally a runtime, not a tool that takes arbitrary code
+ * (e.g. don't add `bash` or `sh`).
+ */
+declare const DEFAULT_MCP_COMMAND_ALLOWLIST: ReadonlySet<string>;
+/**
+ * Throws McpUntrustedCommandError if `command` is not safe to spawn under
+ * the allowlist policy.
+ */
+declare function assertCommandAllowed(command: string, trusted: boolean, customAllowlist?: ReadonlySet<string>): void;
+
+/**
+ * Wraps the official MCP SDK's stdio Client into a small, llmist-flavored
+ * surface. Encapsulates the SDK so the rest of llmist depends on the typed
+ * shapes in `./types.ts` rather than vendor types.
+ *
+ * Lazy-imports the SDK so agents that don't use MCP pay zero overhead at
+ * load time.
+ *
+ * @module mcp/client
+ */
+
+interface McpClientOptions {
+    /**
+     * Inject a pre-built transport for testing. When omitted, the client
+     * builds a stdio transport from the spec at connect() time.
+     */
+    transport?: Transport;
+    /**
+     * Override the client identity sent during initialize.
+     */
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+declare class McpClient {
+    readonly spec: McpServerSpec;
+    private sdkClient;
+    private spawnedPid;
+    private closed;
+    private readonly injectedTransport?;
+    private readonly clientInfo;
+    constructor(spec: McpServerSpec, opts?: McpClientOptions);
+    get serverName(): string;
+    get pid(): number | null;
+    get serverCapabilities(): McpServerCapabilities | null;
+    connect(): Promise<void>;
+    listTools(): Promise<McpToolDescriptor[]>;
+    callTool(name: string, args: unknown): Promise<McpToolResult>;
+    listPrompts(): Promise<McpPromptDescriptor[]>;
+    getPrompt(name: string, args?: Record<string, unknown>): Promise<McpPromptResult>;
+    close(): Promise<void>;
+    private requireClient;
+    private withTimeout;
+}
+
+/**
+ * Typed errors raised by the MCP integration.
+ *
+ * These wrap underlying SDK and transport errors so the rest of llmist can
+ * react to MCP failures with stable, narrow types instead of catching the
+ * SDK's internal error classes.
+ *
+ * @module mcp/errors
+ */
+declare class McpError extends Error {
+    readonly serverName?: string;
+    constructor(message: string, serverName?: string);
+}
+declare class McpUntrustedCommandError extends McpError {
+    readonly command: string;
+    constructor(command: string, serverName?: string);
+}
+declare class McpConnectError extends McpError {
+    readonly cause?: unknown;
+    constructor(message: string, opts?: {
+        serverName?: string;
+        cause?: unknown;
+    });
+}
+declare class McpToolCallError extends McpError {
+    readonly toolName: string;
+    readonly cause?: unknown;
+    constructor(toolName: string, message: string, opts?: {
+        serverName?: string;
+        cause?: unknown;
+    });
+}
+declare class JsonSchemaConversionError extends Error {
+    readonly schemaFragment: unknown;
+    readonly reason: string;
+    constructor(reason: string, schemaFragment: unknown);
+}
+
+/**
+ * Convert native llmist gadgets into MCP tool descriptors and run them on
+ * behalf of an MCP server. The inverse of `tool-adapter.ts` (which converts
+ * MCP tools into native gadgets).
+ *
+ * @module mcp/gadget-exporter
+ */
+
+/** Convert a native gadget into an MCP tool descriptor. */
+declare function gadgetToMcpTool(gadget: AbstractGadget): McpToolDescriptor;
+/**
+ * Convert a gadget's execute() return value into MCP content blocks.
+ *
+ * Shapes handled:
+ *  - string → single `text` block
+ *  - { result, media[] } → `text` block + per-media block
+ *  - other (object) → JSON-stringified `text` block
+ */
+declare function gadgetResultToMcpContent(ret: GadgetExecuteReturn): McpContentBlock[];
+/**
+ * Validate params and run the gadget, converting both the success and error
+ * paths into MCP tool result shapes.
+ *
+ * Used by the McpServer's `tools/call` handler.
+ */
+declare function runGadgetForMcp(gadget: AbstractGadget, rawParams: unknown): Promise<McpToolResult>;
+
+/**
+ * Minimal JSON Schema → Zod converter for MCP tool input schemas.
+ *
+ * MCP tool descriptors expose `inputSchema` as JSON Schema (typically a
+ * subset of draft-2020-12 with `type`, `properties`, `required`, `items`,
+ * `enum`, `default`, `description`, `nullable`). This converter handles
+ * exactly that subset — anything richer ($ref, allOf, format-only schemas,
+ * non-primitive oneOf composition) throws so we surface the gap rather than
+ * silently coercing a wrong schema.
+ *
+ * @module mcp/json-schema-to-zod
+ */
+
+interface JSONSchemaLike {
+    type?: string | string[];
+    description?: string;
+    default?: unknown;
+    enum?: unknown[];
+    nullable?: boolean;
+    properties?: Record<string, JSONSchemaLike>;
+    required?: string[];
+    items?: JSONSchemaLike | JSONSchemaLike[];
+    oneOf?: JSONSchemaLike[];
+    anyOf?: JSONSchemaLike[];
+    allOf?: JSONSchemaLike[];
+    $ref?: string;
+    [k: string]: unknown;
+}
+/**
+ * Convert a JSON Schema fragment into a Zod schema.
+ *
+ * Throws JsonSchemaConversionError on features that have no clean Zod analog
+ * in the MCP subset.
+ */
+declare function jsonSchemaToZod(schema: JSONSchemaLike | undefined): ZodTypeAny;
+
+/**
+ * Tracks spawned MCP clients for an agent run and closes them all on
+ * teardown. Plan 1 ships the basics: register, closeAll, idempotent. Signal
+ * handling and graceful shutdown windows are added in plan 2.
+ *
+ * @module mcp/lifecycle
+ */
+
+declare class McpLifecycle {
+    private clients;
+    private closing;
+    private signalHandlersInstalled;
+    private sigtermHandler;
+    private sigintHandler;
+    get size(): number;
+    register(client: McpClient): void;
+    /**
+     * Attach SIGTERM/SIGINT handlers that close every registered client when
+     * the parent process is asked to exit. Idempotent (double install is a
+     * no-op) and removable via `removeSignalHandlers()`.
+     */
+    installSignalHandlers(): void;
+    removeSignalHandlers(): void;
+    /**
+     * Close every registered client in parallel. Errors from individual close()
+     * calls are swallowed (logged via console.warn) — a teardown path must not
+     * throw because that would mask the original reason the agent is shutting
+     * down. Idempotent: concurrent calls all return the same in-flight promise.
+     */
+    closeAll(): Promise<void>;
+}
+
+/**
+ * Wrap the MCP SDK's Server class with llmist semantics: register native
+ * gadgets as MCP tools and (optionally) llmist skills as MCP prompts.
+ *
+ * Lazy-imports the SDK so callers that don't expose anything pay no cost.
+ *
+ * @module mcp/server
+ */
+
+interface CreateMcpServerOptions {
+    gadgets: GadgetRegistry;
+    skills?: SkillRegistry;
+    /** Override the protocol version advertised. Defaults to 2025-06-18. */
+    protocolVersion?: string;
+    /** Server identity sent on initialize. */
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+}
+interface McpServerHandle {
+    /** Connect the server to a Transport (stdio, in-memory test transport, etc.). */
+    connect(transport: Transport): Promise<void>;
+    /** Close the underlying server cleanly. Idempotent. */
+    stop(): Promise<void>;
+    /** True between connect() and stop(). */
+    readonly running: boolean;
+}
+declare function createMcpServer(opts: CreateMcpServerOptions): McpServerHandle;
+
+/**
+ * Convert native llmist Skills into MCP prompt descriptors and render them
+ * on behalf of an MCP server.
+ *
+ * Plan 3 maps:
+ *  - Skill metadata.name → prompt name
+ *  - Skill metadata.description → prompt description
+ *  - argumentHint (when present) → a single optional `arguments` parameter
+ *    (the existing skill-substitution machinery handles `$ARGUMENTS`, `$0`,
+ *    `$1`, etc., from a single string)
+ *  - Skill body, after argument substitution, becomes a single user-role
+ *    text message in the prompt response
+ *
+ * @module mcp/skill-exporter
+ */
+
+declare function skillToMcpPrompt(skill: Skill): McpPromptDescriptor;
+/**
+ * Render a skill's body as a single MCP prompt message after argument
+ * substitution.
+ *
+ * `args.arguments` is a string interpreted by the existing skill activation
+ * pipeline ($ARGUMENTS, $0, $1, ...). We don't try to map MCP's per-argument
+ * named parameters into the existing positional substitution model — the
+ * skill author already chose the substitution shape.
+ */
+declare function renderSkillForMcpPrompt(skill: Skill, args: Record<string, unknown>): Promise<McpPromptResult>;
+
+/**
+ * Wraps an MCP tool descriptor as a native llmist gadget so the existing
+ * gadget executor consumes it without any awareness of MCP.
+ *
+ * @module mcp/tool-adapter
+ */
+
+interface McpToolAdapterOptions {
+    /** Prefix prepended to the gadget name. Used for multi-server name conflict resolution (plan 2). */
+    prefix?: string;
+}
+/**
+ * Convert an MCP tool descriptor into a native gadget that delegates to the
+ * supplied MCP client.
+ */
+declare function mcpToolToGadget(tool: McpToolDescriptor, client: McpClient, opts?: McpToolAdapterOptions): AbstractGadget;
+
 /**
  * Character-to-token ratio for fallback token estimation.
  *
@@ -10617,4 +11052,4 @@ declare const timing: {
  */
 declare function getHostExports(ctx: ExecutionContext): HostExports;
 
-export { AbortException, AbstractGadget, type AddGadgetParams, type AddLLMCallParams, type AfterGadgetExecutionAction, type AfterGadgetExecutionControllerContext, type AfterLLMCallAction, type AfterLLMCallControllerContext, type AfterLLMErrorAction, Agent, AgentBuilder, type AgentHooks, type AgentOptions, AnthropicMessagesProvider, type AudioContentPart, type AudioMimeType, type AudioSource, type BaseExecutionEvent, BaseSessionManager, type BeforeGadgetExecutionAction, type BeforeLLMCallAction, type BeforeSkillActivationAction, BudgetPricingUnavailableError, type CachingConfig, type CachingScope, type ChunkInterceptorContext, type CompactionConfig, type CompactionContext, type CompactionEvent, CompactionManager, type CompactionResult, type CompactionStats, type CompactionStrategy, type CompleteGadgetParams, type CompleteLLMCallParams, type ContentPart, type Controllers, ConversationManager, type CostEstimate, type CostReportingLLMist, type CreateGadgetConfig, DEFAULT_COMPACTION_CONFIG, DEFAULT_HINTS, DEFAULT_PROMPTS, DEFAULT_RATE_LIMIT_CONFIG, DEFAULT_RETRY_CONFIG, DEFAULT_SUMMARIZATION_PROMPT, type EventHandlers, type ExecutionContext, type ExecutionEvent, type ExecutionEventType, type ExecutionNode, type ExecutionNodeType, ExecutionTree, FALLBACK_CHARS_PER_TOKEN, type FileLoggingOptions, type FileLoggingState, type FileWrittenInfo, type FormatLLMErrorContext, GADGET_ARG_PREFIX, GADGET_END_PREFIX, GADGET_START_PREFIX, Gadget, type GadgetCallEvent, GadgetCallParser, type GadgetClass, type GadgetCompleteEvent, type GadgetConfig, type GadgetErrorEvent, type GadgetEvent, type GadgetExample, type GadgetExecuteResult, type GadgetExecuteResultWithMedia, type GadgetExecuteReturn, type GadgetExecutionControllerContext, type GadgetExecutionMode, type GadgetExecutionResult, GadgetExecutor, type GadgetExecutorOptions, type GadgetFactoryExports, type GadgetMediaOutput, type GadgetNode, type GadgetOrClass, GadgetOutputStore, type GadgetParameterInterceptorContext, GadgetRegistry, type GadgetResultInterceptorContext, type GadgetSkippedEvent, type GadgetStartEvent, type GadgetState, GeminiGenerativeProvider, type HintContext, type HintTemplate, type HintsConfig, type HistoryMessage, HookPresets, type HostExports, HuggingFaceProvider, type HumanInputRequiredEvent, HumanInputRequiredException, HybridStrategy, type IConversationManager, type ISessionManager, type ImageBase64Source, type ImageContentPart, type ImageGenerationOptions, type ImageGenerationResult, type ImageMimeType, type ImageModelSpec, type ImageSource, type ImageUrlSource, type Interceptors, type IterationHintOptions, type LLMCallCompleteEvent, type LLMCallControllerContext, type LLMCallErrorEvent, type LLMCallNode, type LLMCallStartEvent, type LLMCallStreamEvent, type LLMErrorControllerContext, type LLMEvent, type LLMGenerationOptions, type LLMMessage, LLMMessageBuilder, type LLMResponseEndEvent, type LLMStream, type LLMStreamChunk, LLMist, type LLMistOptions, type LLMistPackageManifest, LOAD_SKILL_GADGET_NAME, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, type MediaKind, type MediaMetadata, MediaStore, type MessageContent, type MessageInterceptorContext, type MessageRole, type MessageTurn, type ModelDescriptor, type ModelFeatures, ModelIdentifierParser, type ModelLimits, type ModelPricing, ModelRegistry, type ModelSpec, type NodeId, type ObserveChunkContext, type ObserveCompactionContext, type ObserveGadgetCompleteContext, type ObserveGadgetStartContext, type ObserveLLMCallContext, type ObserveLLMCompleteContext, type ObserveLLMErrorContext, type ObserveRateLimitThrottleContext, type ObserveRetryAttemptContext, type ObserveSkillActivatedContext, type Observers, OpenAIChatProvider, type OpenAICompatibleConfig, OpenAICompatibleProvider, type OpenRouterConfig, OpenRouterProvider, type OpenRouterRouting, type OutputLimitConfig, type ParallelGadgetHintOptions, type ParsedGadgetCall, type ParsedSkill, type PrefixConfig, type PresetDefinition, type PromptContext, type PromptTemplate, type PromptTemplateConfig, type ProviderAdapter, type ProviderIdentifier, type RateLimitConfig, type RateLimitStats, RateLimitTracker, type ReasoningConfig, type ReasoningEffort, type ResolveValueOptions, type ResolvedCompactionConfig, type ResolvedRateLimitConfig, type ResolvedRetryConfig, type RetryConfig, type RetryOptions, type SessionManifestEntry, SimpleSessionManager, Skill, type SkillActivation, type SkillActivationControllerContext, type SkillActivationOptions, type SkillInstructionInterceptorContext, type SkillMetadata, SkillRegistry, type SkillResource, type SkillSource, SlidingWindowStrategy, type SpeechGenerationOptions, type SpeechGenerationResult, type SpeechModelSpec, type StoredMedia, type StoredOutput, type StreamCompleteEvent, type StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, type SubagentConfig, type SubagentConfigMap, type SubagentContext, type SubagentManifestEntry, type SubagentOptions, SummarizationStrategy, TaskCompletionSignal, type TextContentPart, type TextEvent, type TextGenerationOptions, type TextOnlyAction, type TextOnlyContext, type TextOnlyCustomHandler, type TextOnlyGadgetConfig, type TextOnlyHandler, type TextOnlyStrategy, type ThinkingChunk, type ThinkingEvent, TimeoutException, type TokenUsage, type TrailingMessage, type TrailingMessageContext, type CompactionEvent$1 as TreeCompactionEvent, type TreeConfig, type GadgetSkippedEvent$1 as TreeGadgetSkippedEvent, type TriggeredLimitInfo, type ValidationIssue, type ValidationResult, type VisionAnalyzeOptions, type VisionAnalyzeResult, audioFromBase64, audioFromBuffer, collectEvents, collectText, complete, createAnthropicProviderFromEnv, createFileLoggingState, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createHints, createHuggingFaceProviderFromEnv, createLoadSkillGadget, createLogger, createMediaOutput, createOpenAIProviderFromEnv, createOpenRouterProviderFromEnv, createSubagent, defaultLogger, detectAudioMimeType, detectImageMimeType, discoverProviderAdapters, discoverSkills, extractMessageText, extractRetryAfterMs, filterByDepth, filterByParent, filterRootEvents, format, formatBytes, formatCallNumber, formatDate, formatDuration, formatLLMError, formatLlmRequest, gadgetError, gadgetSuccess, getErrorMessage, getHostExports, getModelId, getPresetGadgets, getProvider, getSubagent, groupByParent, hasHostExports, hasPreset, hasProviderPrefix, hasSubagents, humanDelay, imageFromBase64, imageFromBuffer, imageFromUrl, isAbortError, isAudioPart, isDataUrl, isGadgetEvent, isImagePart, isLLMEvent, isLikelyContextOverflow, isRetryableError, isRootEvent, isSubagentEvent, isTextPart, iterationProgressHint, listPresets, listSubagents, loadSkillsFromDirectory, normalizeMessageContent, parallelGadgetHint, parseDataUrl, parseFrontmatter, parseManifest, parseMetadata, parseRetryAfterHeader, parseSkillContent, parseSkillFile, randomDelay, resetFileLoggingState, resolveConfig, resolveHintTemplate, resolveInstructions, resolveModel, resolvePromptTemplate, resolveRateLimitConfig, resolveRetryConfig, resolveRulesTemplate, resolveSubagentModel, resolveSubagentTimeout, resolveValue, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, runWithHandlers, scanResources, schemaToJSONSchema, stream, stripProviderPrefix, substituteArguments, substituteVariables, text, timing, toBase64, truncate, validateAndApplyDefaults, validateGadgetParams, validateGadgetSchema, validateMetadata, withErrorHandling, withRetry, withTimeout };
+export { AbortException, AbstractGadget, type AddGadgetParams, type AddLLMCallParams, type AfterGadgetExecutionAction, type AfterGadgetExecutionControllerContext, type AfterLLMCallAction, type AfterLLMCallControllerContext, type AfterLLMErrorAction, Agent, AgentBuilder, type AgentHooks, type AgentOptions, AnthropicMessagesProvider, type AudioContentPart, type AudioMimeType, type AudioSource, type BaseExecutionEvent, BaseSessionManager, type BeforeGadgetExecutionAction, type BeforeLLMCallAction, type BeforeSkillActivationAction, BudgetPricingUnavailableError, type CachingConfig, type CachingScope, type ChunkInterceptorContext, type CompactionConfig, type CompactionContext, type CompactionEvent, CompactionManager, type CompactionResult, type CompactionStats, type CompactionStrategy, type CompleteGadgetParams, type CompleteLLMCallParams, type ContentPart, type Controllers, ConversationManager, type CostEstimate, type CostReportingLLMist, type CreateGadgetConfig, type CreateMcpServerOptions, DEFAULT_COMPACTION_CONFIG, DEFAULT_HINTS, DEFAULT_MCP_COMMAND_ALLOWLIST, DEFAULT_PROMPTS, DEFAULT_RATE_LIMIT_CONFIG, DEFAULT_RETRY_CONFIG, DEFAULT_SUMMARIZATION_PROMPT, type EventHandlers, type ExecutionContext, type ExecutionEvent, type ExecutionEventType, type ExecutionNode, type ExecutionNodeType, ExecutionTree, FALLBACK_CHARS_PER_TOKEN, type FileLoggingOptions, type FileLoggingState, type FileWrittenInfo, type FormatLLMErrorContext, GADGET_ARG_PREFIX, GADGET_END_PREFIX, GADGET_START_PREFIX, Gadget, type GadgetCallEvent, GadgetCallParser, type GadgetClass, type GadgetCompleteEvent, type GadgetConfig, type GadgetErrorEvent, type GadgetEvent, type GadgetExample, type GadgetExecuteResult, type GadgetExecuteResultWithMedia, type GadgetExecuteReturn, type GadgetExecutionControllerContext, type GadgetExecutionMode, type GadgetExecutionResult, GadgetExecutor, type GadgetExecutorOptions, type GadgetFactoryExports, type GadgetMediaOutput, type GadgetNode, type GadgetOrClass, GadgetOutputStore, type GadgetParameterInterceptorContext, GadgetRegistry, type GadgetResultInterceptorContext, type GadgetSkippedEvent, type GadgetStartEvent, type GadgetState, GeminiGenerativeProvider, type HintContext, type HintTemplate, type HintsConfig, type HistoryMessage, HookPresets, type HostExports, type HttpMcpServerSpec, HuggingFaceProvider, type HumanInputRequiredEvent, HumanInputRequiredException, HybridStrategy, type IConversationManager, type ISessionManager, type ImageBase64Source, type ImageContentPart, type ImageGenerationOptions, type ImageGenerationResult, type ImageMimeType, type ImageModelSpec, type ImageSource, type ImageUrlSource, type Interceptors, type IterationHintOptions, type JSONSchemaLike, JsonSchemaConversionError, type LLMCallCompleteEvent, type LLMCallControllerContext, type LLMCallErrorEvent, type LLMCallNode, type LLMCallStartEvent, type LLMCallStreamEvent, type LLMErrorControllerContext, type LLMEvent, type LLMGenerationOptions, type LLMMessage, LLMMessageBuilder, type LLMResponseEndEvent, type LLMStream, type LLMStreamChunk, LLMist, type LLMistOptions, type LLMistPackageManifest, LOAD_SKILL_GADGET_NAME, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, McpClient, type McpClientOptions, McpConnectError, type McpContentBlock, McpError, McpLifecycle, type McpServerCapabilities, type McpServerHandle, type McpServerSpec, type McpToolAdapterOptions, McpToolCallError, type McpToolDescriptor, type McpToolResult, McpUntrustedCommandError, type MediaKind, type MediaMetadata, MediaStore, type MessageContent, type MessageInterceptorContext, type MessageRole, type MessageTurn, type ModelDescriptor, type ModelFeatures, ModelIdentifierParser, type ModelLimits, type ModelPricing, ModelRegistry, type ModelSpec, type NodeId, type ObserveChunkContext, type ObserveCompactionContext, type ObserveGadgetCompleteContext, type ObserveGadgetStartContext, type ObserveLLMCallContext, type ObserveLLMCompleteContext, type ObserveLLMErrorContext, type ObserveRateLimitThrottleContext, type ObserveRetryAttemptContext, type ObserveSkillActivatedContext, type Observers, OpenAIChatProvider, type OpenAICompatibleConfig, OpenAICompatibleProvider, type OpenRouterConfig, OpenRouterProvider, type OpenRouterRouting, type OutputLimitConfig, type ParallelGadgetHintOptions, type ParsedGadgetCall, type ParsedSkill, type PrefixConfig, type PresetDefinition, type PromptContext, type PromptTemplate, type PromptTemplateConfig, type ProviderAdapter, type ProviderIdentifier, type RateLimitConfig, type RateLimitStats, RateLimitTracker, type ReasoningConfig, type ReasoningEffort, type ResolveValueOptions, type ResolvedCompactionConfig, type ResolvedRateLimitConfig, type ResolvedRetryConfig, type RetryConfig, type RetryOptions, type SessionManifestEntry, SimpleSessionManager, Skill, type SkillActivation, type SkillActivationControllerContext, type SkillActivationOptions, type SkillInstructionInterceptorContext, type SkillMetadata, SkillRegistry, type SkillResource, type SkillSource, SlidingWindowStrategy, type SpeechGenerationOptions, type SpeechGenerationResult, type SpeechModelSpec, type StdioMcpServerSpec, type StoredMedia, type StoredOutput, type StreamCompleteEvent, type StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, type SubagentConfig, type SubagentConfigMap, type SubagentContext, type SubagentManifestEntry, type SubagentOptions, SummarizationStrategy, TaskCompletionSignal, type TextContentPart, type TextEvent, type TextGenerationOptions, type TextOnlyAction, type TextOnlyContext, type TextOnlyCustomHandler, type TextOnlyGadgetConfig, type TextOnlyHandler, type TextOnlyStrategy, type ThinkingChunk, type ThinkingEvent, TimeoutException, type TokenUsage, type TrailingMessage, type TrailingMessageContext, type CompactionEvent$1 as TreeCompactionEvent, type TreeConfig, type GadgetSkippedEvent$1 as TreeGadgetSkippedEvent, type TriggeredLimitInfo, type ValidationIssue, type ValidationResult, type VisionAnalyzeOptions, type VisionAnalyzeResult, assertCommandAllowed, audioFromBase64, audioFromBuffer, collectEvents, collectText, complete, createAnthropicProviderFromEnv, createFileLoggingState, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createHints, createHuggingFaceProviderFromEnv, createLoadSkillGadget, createLogger, createMcpServer, createMediaOutput, createOpenAIProviderFromEnv, createOpenRouterProviderFromEnv, createSubagent, defaultLogger, detectAudioMimeType, detectImageMimeType, discoverProviderAdapters, discoverSkills, extractMessageText, extractRetryAfterMs, filterByDepth, filterByParent, filterRootEvents, format, formatBytes, formatCallNumber, formatDate, formatDuration, formatLLMError, formatLlmRequest, gadgetError, gadgetResultToMcpContent, gadgetSuccess, gadgetToMcpTool, getErrorMessage, getHostExports, getModelId, getPresetGadgets, getProvider, getSubagent, groupByParent, hasHostExports, hasPreset, hasProviderPrefix, hasSubagents, humanDelay, imageFromBase64, imageFromBuffer, imageFromUrl, isAbortError, isAudioPart, isDataUrl, isGadgetEvent, isImagePart, isLLMEvent, isLikelyContextOverflow, isRetryableError, isRootEvent, isSubagentEvent, isTextPart, iterationProgressHint, jsonSchemaToZod, listPresets, listSubagents, loadSkillsFromDirectory, mcpToolToGadget, normalizeMessageContent, parallelGadgetHint, parseDataUrl, parseFrontmatter, parseManifest, parseMetadata, parseRetryAfterHeader, parseSkillContent, parseSkillFile, randomDelay, renderSkillForMcpPrompt, resetFileLoggingState, resolveConfig, resolveHintTemplate, resolveInstructions, resolveModel, resolvePromptTemplate, resolveRateLimitConfig, resolveRetryConfig, resolveRulesTemplate, resolveSubagentModel, resolveSubagentTimeout, resolveValue, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, runGadgetForMcp, runWithHandlers, scanResources, schemaToJSONSchema, skillToMcpPrompt, stream, stripProviderPrefix, substituteArguments, substituteVariables, text, timing, toBase64, truncate, validateAndApplyDefaults, validateGadgetParams, validateGadgetSchema, validateMetadata, withErrorHandling, withRetry, withTimeout };