llmist 16.0.2 → 16.0.4

package/dist/index.d.cts

@@ -2058,12 +2058,13 @@ interface Interceptors {
      */
     interceptGadgetParameters?: (parameters: Readonly<Record<string, unknown>>, context: GadgetParameterInterceptorContext) => Record<string, unknown>;
     /**
-     * Intercept and transform gadget results after execution.
+     * Intercept and transform gadget results and error messages after execution.
      * This affects what gets sent back to the LLM and stored in history.
+     * Called for both successful results (result.result) and errors (result.error).
      *
-     * @param result - The gadget result text
+     * @param result - The gadget result or error text
      * @param context - Context information including parameters and execution time
-     * @returns Transformed result text (cannot be suppressed)
+     * @returns Transformed text (cannot be suppressed)
      */
     interceptGadgetResult?: (result: string, context: GadgetResultInterceptorContext) => string;
 }
@@ -5519,7 +5520,9 @@ declare class AgentBuilder {
      */
     /**
      * Build AgentOptions with the given user prompt.
-     * Centralizes options construction for ask(), askWithImage(), and askWithContent().
+     * Centralizes options construction for ask(), askWithImage(), askWithContent(), and build().
+     *
+     * @param userPrompt - Optional user prompt (omitted for build() which has no prompt)
      */
     private buildAgentOptions;
     ask(userPrompt: string): Agent;
@@ -6633,10 +6636,6 @@ declare class Agent {
      * Handle text-only response (no gadgets called).
      */
     private handleTextOnlyResponse;
-    /**
-     * Safely execute an observer, catching and logging any errors.
-     */
-    private safeObserve;
     /**
      * Resolve max tokens from model catalog.
      */
@@ -6744,6 +6743,56 @@ declare class Agent {
  * ```
  */
 
+/**
+ * State container for file logging session.
+ * Encapsulates all mutable state to enable session isolation and proper
+ * handling of concurrent subagents.
+ *
+ * @remarks
+ * Using a state object instead of module-level globals provides:
+ * - **Session isolation**: Multiple agent sessions don't interfere with each other
+ * - **Testability**: Tests can inject fresh state without needing to reset globals
+ * - **Concurrent subagent support**: Context-based keys prevent race conditions
+ */
+interface FileLoggingState {
+    /** Counter per directory path (normalized) */
+    readonly counters: Map<string, number>;
+    /**
+     * Subagent context key -> assigned directory path.
+     * Key format: `${parentDir}:${parentGadgetInvocationId}`
+     */
+    readonly subagentDirectories: Map<string, string>;
+    /**
+     * Context key -> active directory for that execution context.
+     * Key format: `${parentGadgetInvocationId}:${depth}` (or "root:0" for main agent)
+     *
+     * This replaces the previous depth-only keying which caused race conditions
+     * when multiple subagents at the same depth ran concurrently.
+     */
+    readonly activeDirectoryByContext: Map<string, string>;
+}
+/**
+ * Creates a fresh file logging state container.
+ *
+ * Use this to create isolated state for testing or when running multiple
+ * independent agent sessions that shouldn't share counters.
+ *
+ * @example
+ * ```typescript
+ * // For testing with isolated state:
+ * const state = createFileLoggingState();
+ * const hooks = createFileLoggingHooks({ directory: './logs' }, state);
+ *
+ * // For production (uses default shared state):
+ * const hooks = createFileLoggingHooks({ directory: './logs' });
+ * ```
+ */
+declare function createFileLoggingState(): FileLoggingState;
+/**
+ * Resets the default global state. For testing only.
+ * @internal
+ */
+declare function resetFileLoggingState(): void;
 /**
  * Options for configuring file-based LLM logging.
  */
@@ -6786,10 +6835,14 @@ interface FileWrittenInfo {
     filePath: string;
     /** Type of log file */
     type: "request" | "response";
-    /** LLM call number (1-indexed) */
+    /** LLM call number (1-indexed) within the current directory */
     callNumber: number;
     /** Length of the written content in characters */
     contentLength: number;
+    /** Gadget invocation ID that spawned this subagent (undefined for main agent) */
+    parentGadgetInvocationId?: string;
+    /** Subagent depth (undefined for main agent) */
+    depth?: number;
 }
 /**
  * Formats LLM messages as plain text for debugging.
@@ -7089,6 +7142,8 @@ declare class HookPresets {
     /**
      * Tracks cumulative token usage across all LLM calls.
      *
+     * @public
+     *
      * **Output:**
      * - Per-call token count with 📊 emoji
      * - Cumulative total across all calls
@@ -7266,6 +7321,8 @@ declare class HookPresets {
     /**
      * Logs detailed error information for debugging and troubleshooting.
      *
+     * @public
+     *
      * **Output:**
      * - LLM errors with ❌ emoji, including model and recovery status
      * - Gadget errors with full context (parameters, error message)
@@ -7327,6 +7384,8 @@ declare class HookPresets {
     /**
      * Tracks context compaction events.
      *
+     * @public
+     *
      * **Output:**
      * - Compaction events with 🗜️ emoji
      * - Strategy name, tokens before/after, and savings
@@ -7420,6 +7479,8 @@ declare class HookPresets {
     /**
      * Returns empty hook configuration for clean output without any logging.
      *
+     * @public
+     *
      * **Output:**
      * - None. Returns {} (empty object).
      *
@@ -7546,6 +7607,8 @@ declare class HookPresets {
     /**
      * Composite preset combining logging, timing, tokenTracking, and errorLogging.
      *
+     * @public
+     *
      * This is the recommended preset for development and initial production deployments,
      * providing comprehensive observability with a single method call.
      *
@@ -8159,7 +8222,6 @@ interface StreamProcessingResult {
  */
 declare class StreamProcessor {
     private readonly iteration;
-    private readonly registry;
     private readonly hooks;
     private readonly logger;
     private readonly parser;
@@ -8169,29 +8231,10 @@ declare class StreamProcessor {
     private readonly baseDepth;
     private readonly gadgetExecutionMode;
     private responseText;
-    private observerFailureCount;
-    /** Gadgets waiting for their dependencies to complete */
-    private gadgetsAwaitingDependencies;
-    /** Completed gadget results, keyed by invocation ID */
-    private completedResults;
-    /** Invocation IDs of gadgets that have failed (error or skipped due to dependency) */
-    private failedInvocations;
-    /** Promises for independent gadgets currently executing (fire-and-forget) */
-    private inFlightExecutions;
+    private readonly dependencyResolver;
+    private readonly concurrencyManager;
     /** Queue of completed gadget results ready to be yielded (for real-time streaming) */
     private completedResultsQueue;
-    /** Subagent configuration map for checking maxConcurrent limits */
-    private readonly subagentConfig?;
-    /** Track active execution count per gadget name */
-    private activeCountByGadget;
-    /** Queue of gadgets waiting for a concurrency slot (per gadget name) */
-    private concurrencyQueue;
-    /** Queue of exclusive gadgets deferred until in-flight gadgets complete */
-    private exclusiveQueue;
-    /** Invocation IDs completed in previous iterations (read-only reference from Agent) */
-    private readonly priorCompletedInvocations;
-    /** Invocation IDs that failed in previous iterations (read-only reference from Agent) */
-    private readonly priorFailedInvocations;
     private readonly parentObservers?;
     private readonly maxGadgetsPerResponse;
     private gadgetStartedCount;
@@ -8223,26 +8266,11 @@ declare class StreamProcessor {
      * enabling real-time UI feedback.
      */
     private processGadgetCallGenerator;
-    /**
-     * Get the effective concurrency limit for a gadget.
-     * Uses "most restrictive wins" strategy: the lowest non-zero value from
-     * external config (SubagentConfig) and gadget's intrinsic maxConcurrent.
-     *
-     * This ensures gadget authors can set safety floors (e.g., maxConcurrent: 1
-     * for file writers) that cannot be weakened by external configuration.
-     *
-     * @returns 0 if unlimited, otherwise the effective limit
-     */
-    private getConcurrencyLimit;
     /**
      * Start a gadget execution with concurrency tracking.
-     * Increments active count, starts execution, and schedules queue processing on completion.
+     * Delegates tracking to GadgetConcurrencyManager; schedules queue processing on completion.
      */
     private startGadgetWithConcurrencyTracking;
-    /**
-     * Process the next queued gadget for a given gadget name if a slot is available.
-     */
-    private processQueuedGadget;
     /**
      * Execute a gadget through the full hook lifecycle and yield events.
      * Handles parameter interception, before/after controllers, observers,
@@ -8270,19 +8298,6 @@ declare class StreamProcessor {
      * Clears the inFlightExecutions map after all gadgets complete.
      */
     private waitForInFlightExecutions;
-    /**
-     * Check if there are any gadgets waiting in concurrency queues.
-     */
-    private hasQueuedGadgets;
-    /**
-     * Get total count of queued gadgets across all queues.
-     */
-    private getQueuedGadgetCount;
-    /**
-     * Get total count of actively executing gadgets across all types.
-     * Used to know when all work is truly complete (not just when allDone resolves).
-     */
-    private getTotalActiveGadgetCount;
     /**
      * Handle a gadget that cannot execute because a dependency failed.
      * Calls the onDependencySkipped controller to allow customization.
@@ -8304,11 +8319,6 @@ declare class StreamProcessor {
      * but results are yielded as they become available.
      */
     private processPendingGadgetsGenerator;
-    /**
-     * Safely execute an observer, catching and logging any errors.
-     * Observers are non-critical, so errors are logged but don't crash the system.
-     */
-    private safeObserve;
     /**
      * Execute multiple observers in parallel.
      * All observers run concurrently and failures are tracked but don't crash.
@@ -10859,4 +10869,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 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 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 ParallelGadgetHintOptions, type ParsedGadgetCall, 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 GadgetSkippedEvent$1 as TreeGadgetSkippedEvent, type TriggeredLimitInfo, type ValidationIssue, type ValidationResult, type VisionAnalyzeOptions, type VisionAnalyzeResult, audioFromBase64, audioFromBuffer, collectEvents, collectText, complete, createAnthropicProviderFromEnv, 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, resolveConfig, resolveHintTemplate, resolveModel, resolvePromptTemplate, resolveRateLimitConfig, resolveRetryConfig, resolveRulesTemplate, resolveSubagentModel, resolveSubagentTimeout, resolveValue, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, runWithHandlers, schemaToJSONSchema, stream, 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, 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 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 ParallelGadgetHintOptions, type ParsedGadgetCall, 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 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, text, timing, toBase64, truncate, validateAndApplyDefaults, validateGadgetParams, validateGadgetSchema, withErrorHandling, withRetry, withTimeout };

package/dist/index.d.ts

@@ -2058,12 +2058,13 @@ interface Interceptors {
      */
     interceptGadgetParameters?: (parameters: Readonly<Record<string, unknown>>, context: GadgetParameterInterceptorContext) => Record<string, unknown>;
     /**
-     * Intercept and transform gadget results after execution.
+     * Intercept and transform gadget results and error messages after execution.
      * This affects what gets sent back to the LLM and stored in history.
+     * Called for both successful results (result.result) and errors (result.error).
      *
-     * @param result - The gadget result text
+     * @param result - The gadget result or error text
      * @param context - Context information including parameters and execution time
-     * @returns Transformed result text (cannot be suppressed)
+     * @returns Transformed text (cannot be suppressed)
      */
     interceptGadgetResult?: (result: string, context: GadgetResultInterceptorContext) => string;
 }
@@ -5519,7 +5520,9 @@ declare class AgentBuilder {
      */
     /**
      * Build AgentOptions with the given user prompt.
-     * Centralizes options construction for ask(), askWithImage(), and askWithContent().
+     * Centralizes options construction for ask(), askWithImage(), askWithContent(), and build().
+     *
+     * @param userPrompt - Optional user prompt (omitted for build() which has no prompt)
      */
     private buildAgentOptions;
     ask(userPrompt: string): Agent;
@@ -6633,10 +6636,6 @@ declare class Agent {
      * Handle text-only response (no gadgets called).
      */
     private handleTextOnlyResponse;
-    /**
-     * Safely execute an observer, catching and logging any errors.
-     */
-    private safeObserve;
     /**
      * Resolve max tokens from model catalog.
      */
@@ -6744,6 +6743,56 @@ declare class Agent {
  * ```
  */
 
+/**
+ * State container for file logging session.
+ * Encapsulates all mutable state to enable session isolation and proper
+ * handling of concurrent subagents.
+ *
+ * @remarks
+ * Using a state object instead of module-level globals provides:
+ * - **Session isolation**: Multiple agent sessions don't interfere with each other
+ * - **Testability**: Tests can inject fresh state without needing to reset globals
+ * - **Concurrent subagent support**: Context-based keys prevent race conditions
+ */
+interface FileLoggingState {
+    /** Counter per directory path (normalized) */
+    readonly counters: Map<string, number>;
+    /**
+     * Subagent context key -> assigned directory path.
+     * Key format: `${parentDir}:${parentGadgetInvocationId}`
+     */
+    readonly subagentDirectories: Map<string, string>;
+    /**
+     * Context key -> active directory for that execution context.
+     * Key format: `${parentGadgetInvocationId}:${depth}` (or "root:0" for main agent)
+     *
+     * This replaces the previous depth-only keying which caused race conditions
+     * when multiple subagents at the same depth ran concurrently.
+     */
+    readonly activeDirectoryByContext: Map<string, string>;
+}
+/**
+ * Creates a fresh file logging state container.
+ *
+ * Use this to create isolated state for testing or when running multiple
+ * independent agent sessions that shouldn't share counters.
+ *
+ * @example
+ * ```typescript
+ * // For testing with isolated state:
+ * const state = createFileLoggingState();
+ * const hooks = createFileLoggingHooks({ directory: './logs' }, state);
+ *
+ * // For production (uses default shared state):
+ * const hooks = createFileLoggingHooks({ directory: './logs' });
+ * ```
+ */
+declare function createFileLoggingState(): FileLoggingState;
+/**
+ * Resets the default global state. For testing only.
+ * @internal
+ */
+declare function resetFileLoggingState(): void;
 /**
  * Options for configuring file-based LLM logging.
  */
@@ -6786,10 +6835,14 @@ interface FileWrittenInfo {
     filePath: string;
     /** Type of log file */
     type: "request" | "response";
-    /** LLM call number (1-indexed) */
+    /** LLM call number (1-indexed) within the current directory */
     callNumber: number;
     /** Length of the written content in characters */
     contentLength: number;
+    /** Gadget invocation ID that spawned this subagent (undefined for main agent) */
+    parentGadgetInvocationId?: string;
+    /** Subagent depth (undefined for main agent) */
+    depth?: number;
 }
 /**
  * Formats LLM messages as plain text for debugging.
@@ -7089,6 +7142,8 @@ declare class HookPresets {
     /**
      * Tracks cumulative token usage across all LLM calls.
      *
+     * @public
+     *
      * **Output:**
      * - Per-call token count with 📊 emoji
      * - Cumulative total across all calls
@@ -7266,6 +7321,8 @@ declare class HookPresets {
     /**
      * Logs detailed error information for debugging and troubleshooting.
      *
+     * @public
+     *
      * **Output:**
      * - LLM errors with ❌ emoji, including model and recovery status
      * - Gadget errors with full context (parameters, error message)
@@ -7327,6 +7384,8 @@ declare class HookPresets {
     /**
      * Tracks context compaction events.
      *
+     * @public
+     *
      * **Output:**
      * - Compaction events with 🗜️ emoji
      * - Strategy name, tokens before/after, and savings
@@ -7420,6 +7479,8 @@ declare class HookPresets {
     /**
      * Returns empty hook configuration for clean output without any logging.
      *
+     * @public
+     *
      * **Output:**
      * - None. Returns {} (empty object).
      *
@@ -7546,6 +7607,8 @@ declare class HookPresets {
     /**
      * Composite preset combining logging, timing, tokenTracking, and errorLogging.
      *
+     * @public
+     *
      * This is the recommended preset for development and initial production deployments,
      * providing comprehensive observability with a single method call.
      *
@@ -8159,7 +8222,6 @@ interface StreamProcessingResult {
  */
 declare class StreamProcessor {
     private readonly iteration;
-    private readonly registry;
     private readonly hooks;
     private readonly logger;
     private readonly parser;
@@ -8169,29 +8231,10 @@ declare class StreamProcessor {
     private readonly baseDepth;
     private readonly gadgetExecutionMode;
     private responseText;
-    private observerFailureCount;
-    /** Gadgets waiting for their dependencies to complete */
-    private gadgetsAwaitingDependencies;
-    /** Completed gadget results, keyed by invocation ID */
-    private completedResults;
-    /** Invocation IDs of gadgets that have failed (error or skipped due to dependency) */
-    private failedInvocations;
-    /** Promises for independent gadgets currently executing (fire-and-forget) */
-    private inFlightExecutions;
+    private readonly dependencyResolver;
+    private readonly concurrencyManager;
     /** Queue of completed gadget results ready to be yielded (for real-time streaming) */
     private completedResultsQueue;
-    /** Subagent configuration map for checking maxConcurrent limits */
-    private readonly subagentConfig?;
-    /** Track active execution count per gadget name */
-    private activeCountByGadget;
-    /** Queue of gadgets waiting for a concurrency slot (per gadget name) */
-    private concurrencyQueue;
-    /** Queue of exclusive gadgets deferred until in-flight gadgets complete */
-    private exclusiveQueue;
-    /** Invocation IDs completed in previous iterations (read-only reference from Agent) */
-    private readonly priorCompletedInvocations;
-    /** Invocation IDs that failed in previous iterations (read-only reference from Agent) */
-    private readonly priorFailedInvocations;
     private readonly parentObservers?;
     private readonly maxGadgetsPerResponse;
     private gadgetStartedCount;
@@ -8223,26 +8266,11 @@ declare class StreamProcessor {
      * enabling real-time UI feedback.
      */
     private processGadgetCallGenerator;
-    /**
-     * Get the effective concurrency limit for a gadget.
-     * Uses "most restrictive wins" strategy: the lowest non-zero value from
-     * external config (SubagentConfig) and gadget's intrinsic maxConcurrent.
-     *
-     * This ensures gadget authors can set safety floors (e.g., maxConcurrent: 1
-     * for file writers) that cannot be weakened by external configuration.
-     *
-     * @returns 0 if unlimited, otherwise the effective limit
-     */
-    private getConcurrencyLimit;
     /**
      * Start a gadget execution with concurrency tracking.
-     * Increments active count, starts execution, and schedules queue processing on completion.
+     * Delegates tracking to GadgetConcurrencyManager; schedules queue processing on completion.
      */
     private startGadgetWithConcurrencyTracking;
-    /**
-     * Process the next queued gadget for a given gadget name if a slot is available.
-     */
-    private processQueuedGadget;
     /**
      * Execute a gadget through the full hook lifecycle and yield events.
      * Handles parameter interception, before/after controllers, observers,
@@ -8270,19 +8298,6 @@ declare class StreamProcessor {
      * Clears the inFlightExecutions map after all gadgets complete.
      */
     private waitForInFlightExecutions;
-    /**
-     * Check if there are any gadgets waiting in concurrency queues.
-     */
-    private hasQueuedGadgets;
-    /**
-     * Get total count of queued gadgets across all queues.
-     */
-    private getQueuedGadgetCount;
-    /**
-     * Get total count of actively executing gadgets across all types.
-     * Used to know when all work is truly complete (not just when allDone resolves).
-     */
-    private getTotalActiveGadgetCount;
     /**
      * Handle a gadget that cannot execute because a dependency failed.
      * Calls the onDependencySkipped controller to allow customization.
@@ -8304,11 +8319,6 @@ declare class StreamProcessor {
      * but results are yielded as they become available.
      */
     private processPendingGadgetsGenerator;
-    /**
-     * Safely execute an observer, catching and logging any errors.
-     * Observers are non-critical, so errors are logged but don't crash the system.
-     */
-    private safeObserve;
     /**
      * Execute multiple observers in parallel.
      * All observers run concurrently and failures are tracked but don't crash.
@@ -10859,4 +10869,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 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 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 ParallelGadgetHintOptions, type ParsedGadgetCall, 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 GadgetSkippedEvent$1 as TreeGadgetSkippedEvent, type TriggeredLimitInfo, type ValidationIssue, type ValidationResult, type VisionAnalyzeOptions, type VisionAnalyzeResult, audioFromBase64, audioFromBuffer, collectEvents, collectText, complete, createAnthropicProviderFromEnv, 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, resolveConfig, resolveHintTemplate, resolveModel, resolvePromptTemplate, resolveRateLimitConfig, resolveRetryConfig, resolveRulesTemplate, resolveSubagentModel, resolveSubagentTimeout, resolveValue, resultWithAudio, resultWithFile, resultWithImage, resultWithImages, resultWithMedia, runWithHandlers, schemaToJSONSchema, stream, 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, 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 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 ParallelGadgetHintOptions, type ParsedGadgetCall, 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 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, text, timing, toBase64, truncate, validateAndApplyDefaults, validateGadgetParams, validateGadgetSchema, withErrorHandling, withRetry, withTimeout };