llmist 16.0.3 → 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.
      */
@@ -7143,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
@@ -7320,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)
@@ -7381,6 +7384,8 @@ declare class HookPresets {
     /**
      * Tracks context compaction events.
      *
+     * @public
+     *
      * **Output:**
      * - Compaction events with 🗜️ emoji
      * - Strategy name, tokens before/after, and savings
@@ -7474,6 +7479,8 @@ declare class HookPresets {
     /**
      * Returns empty hook configuration for clean output without any logging.
      *
+     * @public
+     *
      * **Output:**
      * - None. Returns {} (empty object).
      *
@@ -7600,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.
      *
@@ -8213,7 +8222,6 @@ interface StreamProcessingResult {
  */
 declare class StreamProcessor {
     private readonly iteration;
-    private readonly registry;
     private readonly hooks;
     private readonly logger;
     private readonly parser;
@@ -8223,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;
@@ -8277,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,
@@ -8324,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.
@@ -8358,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.

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.
      */
@@ -7143,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
@@ -7320,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)
@@ -7381,6 +7384,8 @@ declare class HookPresets {
     /**
      * Tracks context compaction events.
      *
+     * @public
+     *
      * **Output:**
      * - Compaction events with 🗜️ emoji
      * - Strategy name, tokens before/after, and savings
@@ -7474,6 +7479,8 @@ declare class HookPresets {
     /**
      * Returns empty hook configuration for clean output without any logging.
      *
+     * @public
+     *
      * **Output:**
      * - None. Returns {} (empty object).
      *
@@ -7600,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.
      *
@@ -8213,7 +8222,6 @@ interface StreamProcessingResult {
  */
 declare class StreamProcessor {
     private readonly iteration;
-    private readonly registry;
     private readonly hooks;
     private readonly logger;
     private readonly parser;
@@ -8223,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;
@@ -8277,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,
@@ -8324,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.
@@ -8358,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.