llmist 16.1.0 → 16.2.1

package/dist/index.d.ts

@@ -1896,6 +1896,8 @@ interface Observers {
     onRateLimitThrottle?: (context: ObserveRateLimitThrottleContext) => void | Promise<void>;
     /** Called when a retry attempt is made after a failed LLM call */
     onRetryAttempt?: (context: ObserveRetryAttemptContext) => void | Promise<void>;
+    /** Called when a skill is activated (via UseSkill gadget or pre-activation) */
+    onSkillActivated?: (context: ObserveSkillActivatedContext) => void | Promise<void>;
 }
 /**
  * Context provided when context compaction occurs.
@@ -1963,6 +1965,53 @@ interface ObserveRetryAttemptContext {
     /** Present when event is from a subagent (undefined for top-level agent) */
     subagentContext?: SubagentContext;
 }
+/**
+ * Context provided when a skill is activated.
+ * Read-only observation point.
+ */
+interface ObserveSkillActivatedContext {
+    /** Name of the activated skill */
+    skillName: string;
+    /** Arguments passed to the skill (if any) */
+    arguments?: string;
+    /** Current iteration when activation occurred */
+    iteration: number;
+    /** Logger instance */
+    logger: Logger<ILogObj>;
+}
+/**
+ * Context for skill activation controller.
+ */
+interface SkillActivationControllerContext {
+    /** Name of the skill being activated */
+    skillName: string;
+    /** Arguments passed to the skill */
+    arguments?: string;
+    /** Current iteration */
+    iteration: number;
+    /** Logger instance */
+    logger: Logger<ILogObj>;
+}
+/**
+ * Action returned by beforeSkillActivation controller.
+ */
+type BeforeSkillActivationAction = {
+    action: "proceed";
+} | {
+    action: "skip";
+    reason?: string;
+};
+/**
+ * Context for skill instruction interception.
+ */
+interface SkillInstructionInterceptorContext {
+    /** Name of the skill being activated */
+    skillName: string;
+    /** Arguments passed to the skill */
+    arguments?: string;
+    /** Logger instance */
+    logger: Logger<ILogObj>;
+}
 /**
  * Context for chunk interception.
  */
@@ -2055,6 +2104,14 @@ interface Interceptors {
      * @returns Transformed text (cannot be suppressed)
      */
     interceptGadgetResult?: (result: string, context: GadgetResultInterceptorContext) => string;
+    /**
+     * Intercept and transform skill instructions before they are returned to the LLM.
+     *
+     * @param instructions - The resolved skill instructions
+     * @param context - Context including skill name and arguments
+     * @returns Transformed instructions, or null to suppress the skill activation
+     */
+    interceptSkillInstructions?: (instructions: string, context: SkillInstructionInterceptorContext) => string | null;
 }
 /**
  * Context for LLM call controller.
@@ -2248,6 +2305,11 @@ interface Controllers {
      * Can override the default skip behavior to execute anyway or provide a fallback.
      */
     onDependencySkipped?: (context: DependencySkipControllerContext) => Promise<DependencySkipAction>;
+    /**
+     * Called before activating a skill.
+     * Can skip the activation (e.g., for permission checks or cost limits).
+     */
+    beforeSkillActivation?: (context: SkillActivationControllerContext) => Promise<BeforeSkillActivationAction>;
 }
 /**
  * Clean hooks system with three distinct categories:
@@ -4598,6 +4660,258 @@ declare class GadgetRegistry {
     clear(): void;
 }
 
+/**
+ * Core type definitions for the Skills system.
+ *
+ * Skills follow the Agent Skills open standard (agentskills.io) — markdown-based
+ * instruction packages that extend agent capabilities through prompt injection
+ * and context management, not code execution.
+ *
+ * Three-tier progressive disclosure:
+ * - Tier 1 (metadata): ~100 tokens, always loaded for discovery
+ * - Tier 2 (instructions): <5K tokens, loaded on activation
+ * - Tier 3 (resources): unlimited, loaded on demand
+ *
+ * @module skills/types
+ */
+
+/**
+ * Parsed YAML frontmatter from a SKILL.md file.
+ * Follows the Agent Skills open standard with llmist-specific extensions.
+ */
+interface SkillMetadata {
+    /** Skill identifier. Lowercase letters, numbers, hyphens only. Max 64 chars. */
+    name: string;
+    /** What the skill does and when to use it. Max 1024 chars. Used for auto-triggering. */
+    description: string;
+    /** Hint shown during autocomplete, e.g., "[issue-number]" or "<filename> [format]". */
+    argumentHint?: string;
+    /** Tools the agent can use when this skill is active. */
+    allowedTools?: string[];
+    /** Model override when skill is active, e.g., "sonnet", "flash". */
+    model?: string;
+    /** Execution context. "fork" runs in an isolated subagent. */
+    context?: "fork" | "inline";
+    /** Subagent type for fork mode, e.g., "Explore", "Plan", "general-purpose". */
+    agent?: string;
+    /** Glob patterns for auto-activation based on files being worked on. */
+    paths?: string[];
+    /** Bundled gadget specifiers loaded when skill activates. */
+    gadgets?: string[];
+    /** If true, only the user can invoke this skill (LLM cannot auto-trigger). */
+    disableModelInvocation?: boolean;
+    /** If false, skill is background knowledge only — hidden from user invocation. */
+    userInvocable?: boolean;
+    /** Shell for !`command` preprocessing. */
+    shell?: "bash" | "powershell";
+    /** Semantic version number. */
+    version?: string;
+}
+/**
+ * A resource file within a skill's directory (Tier 3).
+ */
+interface SkillResource {
+    /** Path relative to the skill directory. */
+    relativePath: string;
+    /** Absolute path on disk. */
+    absolutePath: string;
+    /** Category based on parent directory. */
+    category: "scripts" | "references" | "assets";
+}
+/**
+ * Where a skill was discovered from.
+ */
+type SkillSource = {
+    type: "project";
+    path: string;
+} | {
+    type: "user";
+    path: string;
+} | {
+    type: "npm";
+    package: string;
+} | {
+    type: "git";
+    url: string;
+} | {
+    type: "directory";
+    path: string;
+};
+/**
+ * Fully parsed skill representation (all three tiers).
+ */
+interface ParsedSkill {
+    /** Tier 1: Always-loaded metadata from frontmatter. */
+    metadata: SkillMetadata;
+    /** Tier 2: Full SKILL.md body. null if not yet loaded. */
+    instructions: string | null;
+    /** Tier 3: Discovered resource manifests. */
+    resources: SkillResource[];
+    /** Absolute path to the SKILL.md file. */
+    sourcePath: string;
+    /** Directory containing the skill. */
+    sourceDir: string;
+    /** Origin for debugging and priority resolution. */
+    source: SkillSource;
+}
+/**
+ * Result of activating a skill.
+ */
+interface SkillActivation {
+    /** The skill that was activated. */
+    skillName: string;
+    /** Resolved instructions after $ARGUMENTS substitution and !`command` preprocessing. */
+    resolvedInstructions: string;
+    /** Gadgets made available by this skill (if any). */
+    gadgets: AbstractGadget[];
+    /** Resources loaded for this activation (Tier 3). Keyed by relative path. */
+    loadedResources: Map<string, string>;
+}
+/**
+ * Options for skill activation.
+ */
+interface SkillActivationOptions {
+    /** Arguments passed to the skill (substituted into $ARGUMENTS, $0, $1, etc.). */
+    arguments?: string;
+    /** Whether to load Tier 3 resources eagerly. Default: false. */
+    eagerResources?: boolean;
+    /** Working directory for !`command` preprocessing. */
+    cwd?: string;
+    /** Whether to execute !`command` preprocessing. Default: true. */
+    enableShellPreprocessing?: boolean;
+    /** Timeout for !`command` execution in milliseconds. Default: 10000. */
+    shellTimeoutMs?: number;
+}
+
+/**
+ * Skill class with lazy-loading progressive disclosure.
+ *
+ * Tier 1 (metadata) is always available after construction.
+ * Tier 2 (instructions) and Tier 3 (resources) are loaded on demand.
+ *
+ * @module skills/skill
+ */
+
+declare class Skill {
+    readonly metadata: SkillMetadata;
+    readonly sourcePath: string;
+    readonly sourceDir: string;
+    readonly source: SkillSource;
+    private _instructions;
+    private _resources;
+    private readonly _resourceCache;
+    private readonly _resourceLoading;
+    constructor(parsed: ParsedSkill);
+    /** Skill name for registry lookup. */
+    get name(): string;
+    /** Skill description for LLM matching. */
+    get description(): string;
+    /** Whether the LLM can auto-trigger this skill. */
+    get isModelInvocable(): boolean;
+    /** Whether the user can invoke this skill via /skill-name. */
+    get isUserInvocable(): boolean;
+    /**
+     * Load and cache Tier 2 instructions.
+     * If instructions were loaded during parsing, returns the cached value.
+     */
+    getInstructions(): Promise<string>;
+    /**
+     * List Tier 3 resources.
+     * Resources are discovered at parse time but content is loaded on demand.
+     */
+    getResources(): SkillResource[];
+    /**
+     * Load a specific Tier 3 resource by relative path.
+     * Results are cached for the lifetime of this Skill instance.
+     * Concurrent calls for the same resource share a single read.
+     */
+    getResource(relativePath: string): Promise<string>;
+    /**
+     * Activate this skill with optional arguments.
+     *
+     * Performs:
+     * 1. Variable substitution (${SKILL_DIR}, etc.)
+     * 2. Argument substitution ($ARGUMENTS, $0, $1)
+     * 3. Shell preprocessing (!`command`)
+     * 4. Resource loading (if eagerResources is true)
+     */
+    activate(options?: SkillActivationOptions): Promise<SkillActivation>;
+    /**
+     * Create a Skill from a SKILL.md content string.
+     * Useful for testing or dynamic skill creation.
+     */
+    static fromContent(content: string, sourcePath: string, source?: SkillSource): Skill;
+}
+
+/**
+ * SkillRegistry — manages skill discovery, lookup, and metadata summaries.
+ *
+ * Parallel to GadgetRegistry but with different semantics: skills are not
+ * executable tools registered with the LLM directly. They are available
+ * for activation by the agent or user, surfaced via metadata summaries.
+ *
+ * @module skills/registry
+ */
+
+declare class SkillRegistry {
+    private readonly skills;
+    /**
+     * Register a skill. Overwrites any existing skill with the same name.
+     *
+     * Unlike GadgetRegistry (which throws on duplicates), SkillRegistry allows
+     * overwriting because skills are loaded from multiple sources with intentional
+     * priority ordering (project > user > default).
+     */
+    register(skill: Skill): void;
+    /** Register multiple skills. */
+    registerMany(skills: Skill[]): void;
+    /** Remove a skill by name (case-insensitive). Returns true if removed. */
+    remove(name: string): boolean;
+    /** Remove all registered skills. */
+    clear(): void;
+    /** Get a skill by name (case-insensitive). */
+    get(name: string): Skill | undefined;
+    /** Check if a skill exists by name (case-insensitive). */
+    has(name: string): boolean;
+    /** Get all registered skills. */
+    getAll(): Skill[];
+    /** Get all skill names. */
+    getNames(): string[];
+    /** Number of registered skills. */
+    get size(): number;
+    /**
+     * Get skills that are visible to the LLM for auto-triggering.
+     * Excludes skills with disableModelInvocation: true.
+     */
+    getModelInvocable(): Skill[];
+    /**
+     * Get skills that the user can invoke via /skill-name.
+     * Excludes skills with userInvocable: false.
+     */
+    getUserInvocable(): Skill[];
+    /**
+     * Generate metadata summaries for system prompt injection (Tier 1).
+     *
+     * Each skill contributes a one-line summary: "name — description".
+     * Output is truncated to fit the character budget.
+     *
+     * @param charBudget - Maximum characters for all summaries combined.
+     */
+    getMetadataSummaries(charBudget?: number): string;
+    /**
+     * Find skills whose `paths` patterns match a given file path.
+     * Used for auto-activation when the user is working on specific files.
+     */
+    findByFilePath(filePath: string): Skill[];
+    /**
+     * Merge another registry into this one.
+     * Skills from the other registry overwrite existing skills with the same name.
+     */
+    merge(other: SkillRegistry): void;
+    /** Create a registry from an array of skills. */
+    static from(skills: Skill[]): SkillRegistry;
+}
+
 /**
  * Context available to trailing message functions.
  * Provides iteration information for dynamic message generation.
@@ -4746,6 +5060,7 @@ declare class AgentBuilder {
     private retry;
     private subagents;
     private policies;
+    private skills;
     constructor(client?: LLMist);
     /** Set the model to use. Supports aliases like "sonnet", "flash". */
     withModel(model: string): this;
@@ -4803,6 +5118,20 @@ declare class AgentBuilder {
     withCompaction(config: CompactionConfig): this;
     /** Disable context compaction. */
     withoutCompaction(): this;
+    /** Register a skill registry for this agent. */
+    withSkills(registry: SkillRegistry): this;
+    /**
+     * Pre-activate a specific skill before the agent starts.
+     * Instructions are injected into the system prompt.
+     *
+     * Note: each call replaces (not appends) the pre-activated skill for that name.
+     * This is safe for REPL loops where the same builder is reused.
+     */
+    withSkill(name: string, args?: string): this;
+    /** Clear all pre-activated skills. Call between REPL iterations. */
+    clearPreActivatedSkills(): this;
+    /** Add a directory to scan for skills. */
+    withSkillsFrom(dir: string): this;
     /** Configure retry behavior for LLM API calls. */
     withRetry(config: RetryConfig): this;
     /** Disable automatic retry for LLM API calls. */
@@ -4828,6 +5157,12 @@ declare class AgentBuilder {
     /** Add a synthetic gadget call to the conversation history for in-context learning. */
     withSyntheticGadgetCall(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string): this;
     private composeHooks;
+    private resolveSkillRegistry;
+    /**
+     * Resolve pre-activated skill instructions synchronously.
+     * Reads SKILL.md from disk via readFileSync (skills are local files).
+     */
+    private resolvePreActivatedInstructions;
     private buildAgentOptions;
     /** Create agent and start with a user prompt. */
     ask(userPrompt: string): Agent;
@@ -7341,6 +7676,8 @@ interface StreamProcessorOptions {
     requestHumanInput?: (question: string) => Promise<string>;
     /** Default gadget timeout */
     defaultGadgetTimeoutMs?: number;
+    /** Maximum time (ms) to wait for in-flight gadgets to complete. Default: 300s. */
+    inFlightTimeoutMs?: number;
     /** Gadget execution mode ('parallel' | 'sequential') */
     gadgetExecutionMode?: GadgetExecutionMode;
     /** LLMist client for ExecutionContext.llmist */
@@ -8235,8 +8572,9 @@ declare class GadgetCallParser {
      * - `GadgetName` - Auto-generate ID, no dependencies
      * - `GadgetName:my_id` - Explicit ID, no dependencies
      * - `GadgetName:my_id:dep1,dep2` - Explicit ID with dependencies
+     * - `GadgetName:my_id:dep1:dep2:dep3` - Colons treated as dep separators (LLM resilience)
      *
-     * Dependencies must be comma-separated invocation IDs.
+     * Dependencies can be comma-separated or colon-separated invocation IDs.
      */
     private parseInvocationMetadata;
     /**
@@ -8756,6 +9094,12 @@ interface LLMistPackageManifest {
      * Session factory metadata.
      */
     session?: SessionManifestEntry;
+    /**
+     * Skills directory relative to package root.
+     * Contains subdirectories with SKILL.md files.
+     * @example "./skills"
+     */
+    skills?: string;
 }
 /**
  * Factory function types that packages can export.
@@ -9653,6 +9997,146 @@ declare class SimpleSessionManager<TSession> extends BaseSessionManager<TSession
     setSession(id: string, data: TSession): void;
 }
 
+/**
+ * Skill activation logic.
+ *
+ * Handles $ARGUMENTS substitution and !`command` shell preprocessing
+ * to resolve skill instructions before injection into agent context.
+ *
+ * @module skills/activation
+ */
+/**
+ * Substitute $ARGUMENTS and positional $0, $1, etc. in skill instructions.
+ */
+declare function substituteArguments(instructions: string, args?: string): string;
+/**
+ * Substitute ${VARIABLE} environment-style variables in skill instructions.
+ *
+ * Supported variables:
+ * - ${CLAUDE_SKILL_DIR} / ${SKILL_DIR} - directory containing SKILL.md
+ * - ${CLAUDE_SESSION_ID} / ${SESSION_ID} - current session ID (if provided)
+ */
+declare function substituteVariables(instructions: string, variables: Record<string, string>): string;
+/**
+ * Full activation pipeline: variables -> arguments -> shell preprocessing.
+ */
+declare function resolveInstructions(instructions: string, options?: {
+    arguments?: string;
+    variables?: Record<string, string>;
+    cwd?: string;
+    shell?: "bash" | "powershell";
+    shellTimeoutMs?: number;
+    enableShellPreprocessing?: boolean;
+}): string;
+
+/**
+ * Filesystem-based skill discovery and loading.
+ *
+ * Scans directories for subdirectories containing SKILL.md files.
+ * Supports standard discovery locations and custom directories.
+ *
+ * @module skills/loader
+ */
+
+/**
+ * Load skills from a directory.
+ *
+ * Recursively scans for subdirectories containing a SKILL.md file.
+ * Each such directory is treated as a single skill.
+ *
+ * @param dir - Directory to scan
+ * @param source - Origin for all discovered skills
+ */
+declare function loadSkillsFromDirectory(dir: string, source: SkillSource, onWarning?: (msg: string) => void): Skill[];
+/**
+ * Discover skills from standard locations.
+ *
+ * Discovery order (later sources overwrite earlier on name collision):
+ * 1. User skills: ~/.llmist/skills/
+ * 2. Project skills: <projectDir>/.llmist/skills/
+ * 3. Additional directories (explicit)
+ */
+declare function discoverSkills(options?: {
+    projectDir?: string;
+    userDir?: string;
+    additionalDirs?: string[];
+}): SkillRegistry;
+
+/**
+ * SKILL.md parser for the Agent Skills open standard.
+ *
+ * Parses YAML frontmatter (between --- markers) and markdown body.
+ * Scans skill directories for Tier 3 resources (scripts/, references/, assets/).
+ *
+ * @module skills/parser
+ */
+
+/**
+ * Parse YAML frontmatter from SKILL.md content.
+ *
+ * Extracts the YAML block between the first pair of `---` markers
+ * and the remaining markdown body.
+ */
+declare function parseFrontmatter(content: string): {
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+/**
+ * Convert raw frontmatter to validated SkillMetadata.
+ *
+ * Maps kebab-case YAML keys to camelCase TypeScript properties.
+ * Falls back to directory name for missing name field.
+ */
+declare function parseMetadata(frontmatter: Record<string, unknown>, fallbackName?: string): SkillMetadata;
+/**
+ * Scan a skill directory for Tier 3 resource files.
+ */
+declare function scanResources(skillDir: string): SkillResource[];
+/**
+ * Parse a SKILL.md file from disk.
+ *
+ * This performs Tier 1 parsing (metadata) and optionally Tier 2 (instructions).
+ * Resources are discovered but not loaded.
+ *
+ * @param skillMdPath - Absolute path to SKILL.md
+ * @param source - Where this skill was discovered from
+ * @param loadInstructions - Whether to load Tier 2 body (default: false for lazy loading)
+ */
+declare function parseSkillFile(skillMdPath: string, source: SkillSource, loadInstructions?: boolean): ParsedSkill;
+/**
+ * Parse SKILL.md content from a string.
+ *
+ * Useful for testing without filesystem access.
+ */
+declare function parseSkillContent(content: string, sourcePath: string, source: SkillSource, loadInstructions?: boolean): ParsedSkill;
+/**
+ * Validate skill metadata.
+ * Returns an array of validation issues (empty if valid).
+ */
+declare function validateMetadata(metadata: SkillMetadata): string[];
+
+/**
+ * UseSkill meta-gadget — bridges the skill system into the gadget execution pipeline.
+ *
+ * When skills are registered with an agent, this gadget is auto-created and added
+ * to the gadget registry. The LLM can invoke it like any other gadget, and the
+ * skill's instructions are returned as the gadget result.
+ *
+ * This approach requires zero changes to the stream processor or agent loop.
+ *
+ * @module skills/use-skill-gadget
+ */
+
+/** Name for the auto-generated UseSkill gadget. */
+declare const USE_SKILL_GADGET_NAME = "UseSkill";
+/**
+ * Create the UseSkill meta-gadget from a skill registry.
+ *
+ * The gadget description includes a summary of all available skills,
+ * so the LLM knows what skills exist and when to use them.
+ */
+declare function createUseSkillGadget(registry: SkillRegistry): AbstractGadget;
+
 /**
  * Config resolution utility for subagent gadgets.
  *
@@ -10082,4 +10566,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, 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, 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 Observers, OpenAIChatProvider, type OpenAICompatibleConfig, OpenAICompatibleProvider, type OpenRouterConfig, OpenRouterProvider, type OpenRouterRouting, type OutputLimitConfig, type ParallelGadgetHintOptions, type ParsedGadgetCall, 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, 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, createLogger, createMediaOutput, createOpenAIProviderFromEnv, createOpenRouterProviderFromEnv, createSubagent, defaultLogger, detectAudioMimeType, detectImageMimeType, discoverProviderAdapters, 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, isRetryableError, isRootEvent, isSubagentEvent, isTextPart, iterationProgressHint, listPresets, listSubagents, normalizeMessageContent, parallelGadgetHint, parseDataUrl, parseManifest, parseRetryAfterHeader, randomDelay, resetFileLoggingState, resolveConfig, resolveHintTemplate, resolveModel, resolvePromptTemplate, resolveRateLimitConfig, resolveRetryConfig, resolveRulesTemplate, resolveSubagentModel, resolveSubagentTimeout, resolveValue, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, runWithHandlers, schemaToJSONSchema, stream, stripProviderPrefix, text, timing, toBase64, truncate, validateAndApplyDefaults, validateGadgetParams, validateGadgetSchema, 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, 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, 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, USE_SKILL_GADGET_NAME, type ValidationIssue, type ValidationResult, type VisionAnalyzeOptions, type VisionAnalyzeResult, audioFromBase64, audioFromBuffer, collectEvents, collectText, complete, createAnthropicProviderFromEnv, createFileLoggingState, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createHints, createHuggingFaceProviderFromEnv, createLogger, createMediaOutput, createOpenAIProviderFromEnv, createOpenRouterProviderFromEnv, createSubagent, createUseSkillGadget, 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, 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 };