llmist 0.1.1

package/dist/index.js

@@ -0,0 +1,421 @@
+import {
+  createGadget
+} from "./chunk-JEBGLCDW.js";
+import {
+  MockBuilder,
+  MockManager,
+  MockProviderAdapter,
+  createMockAdapter,
+  createMockClient,
+  createMockStream,
+  createTextMockStream,
+  getMockManager,
+  mockLLM,
+  validateAndApplyDefaults,
+  validateGadgetParams
+} from "./chunk-DCW33WV7.js";
+import {
+  AgentBuilder,
+  AnthropicMessagesProvider,
+  BaseGadget,
+  BreakLoopException,
+  ConversationManager,
+  DEFAULT_PROMPTS,
+  GadgetExecutor,
+  GadgetRegistry,
+  GeminiGenerativeProvider,
+  HumanInputException,
+  LLMMessageBuilder,
+  LLMist,
+  MODEL_ALIASES,
+  ModelIdentifierParser,
+  ModelRegistry,
+  OpenAIChatProvider,
+  StreamParser,
+  StreamProcessor,
+  collectEvents,
+  collectText,
+  complete,
+  createAnthropicProviderFromEnv,
+  createGeminiProviderFromEnv,
+  createLogger,
+  createOpenAIProviderFromEnv,
+  defaultLogger,
+  discoverProviderAdapters,
+  getModelId,
+  getProvider,
+  hasProviderPrefix,
+  init_anthropic,
+  init_builder,
+  init_client,
+  init_conversation_manager,
+  init_discovery,
+  init_event_handlers,
+  init_exceptions,
+  init_executor,
+  init_gemini,
+  init_logger,
+  init_messages,
+  init_model_registry,
+  init_model_shortcuts,
+  init_openai,
+  init_options,
+  init_parser,
+  init_prompt_config,
+  init_quick_methods,
+  init_registry,
+  init_stream_processor,
+  resolveModel,
+  resolvePromptTemplate,
+  resolveRulesTemplate,
+  runWithHandlers,
+  stream
+} from "./chunk-TP7HE3MN.js";
+
+// src/index.ts
+init_builder();
+init_event_handlers();
+import { z } from "zod";
+
+// src/agent/hook-presets.ts
+var HookPresets = class _HookPresets {
+  /**
+   * Preset: Basic logging of all events.
+   *
+   * Logs LLM calls and gadget executions to console.
+   *
+   * @param options - Logging options
+   * @returns Hook configuration
+   *
+   * @example
+   * ```typescript
+   * .withHooks(HookPresets.logging())
+   * .withHooks(HookPresets.logging({ verbose: true }))
+   * ```
+   */
+  static logging(options = {}) {
+    return {
+      observers: {
+        onLLMCallStart: async (ctx) => {
+          console.log(`[LLM] Starting call (iteration ${ctx.iteration})`);
+        },
+        onLLMCallComplete: async (ctx) => {
+          const tokens = ctx.usage?.totalTokens ?? "unknown";
+          console.log(`[LLM] Completed (tokens: ${tokens})`);
+          if (options.verbose && ctx.finalMessage) {
+            console.log(`[LLM] Response: ${ctx.finalMessage}`);
+          }
+        },
+        onGadgetExecutionStart: async (ctx) => {
+          console.log(`[GADGET] Executing ${ctx.gadgetName}`);
+          if (options.verbose) {
+            console.log(`[GADGET] Parameters:`, JSON.stringify(ctx.parameters, null, 2));
+          }
+        },
+        onGadgetExecutionComplete: async (ctx) => {
+          console.log(`[GADGET] Completed ${ctx.gadgetName}`);
+          if (options.verbose) {
+            const display = ctx.error ?? ctx.finalResult ?? "(no result)";
+            console.log(`[GADGET] Result: ${display}`);
+          }
+        }
+      }
+    };
+  }
+  /**
+   * Preset: Performance timing for all operations.
+   *
+   * Measures and logs execution time for LLM calls and gadgets.
+   *
+   * @returns Hook configuration
+   *
+   * @example
+   * ```typescript
+   * .withHooks(HookPresets.timing())
+   * ```
+   */
+  static timing() {
+    const timings = /* @__PURE__ */ new Map();
+    return {
+      observers: {
+        onLLMCallStart: async (ctx) => {
+          timings.set(`llm-${ctx.iteration}`, Date.now());
+        },
+        onLLMCallComplete: async (ctx) => {
+          const start = timings.get(`llm-${ctx.iteration}`);
+          if (start) {
+            const duration = Date.now() - start;
+            console.log(`\u23F1\uFE0F  LLM call took ${duration}ms`);
+            timings.delete(`llm-${ctx.iteration}`);
+          }
+        },
+        onGadgetExecutionStart: async (ctx) => {
+          const key = `gadget-${ctx.gadgetName}-${Date.now()}`;
+          timings.set(key, Date.now());
+          ctx._timingKey = key;
+        },
+        onGadgetExecutionComplete: async (ctx) => {
+          const key = ctx._timingKey;
+          if (key) {
+            const start = timings.get(key);
+            if (start) {
+              const duration = Date.now() - start;
+              console.log(`\u23F1\uFE0F  Gadget ${ctx.gadgetName} took ${duration}ms`);
+              timings.delete(key);
+            }
+          }
+        }
+      }
+    };
+  }
+  /**
+   * Preset: Token usage tracking.
+   *
+   * Tracks and logs cumulative token usage across all LLM calls.
+   *
+   * @returns Hook configuration
+   *
+   * @example
+   * ```typescript
+   * .withHooks(HookPresets.tokenTracking())
+   * ```
+   */
+  static tokenTracking() {
+    let totalTokens = 0;
+    let totalCalls = 0;
+    return {
+      observers: {
+        onLLMCallComplete: async (ctx) => {
+          totalCalls++;
+          if (ctx.usage?.totalTokens) {
+            totalTokens += ctx.usage.totalTokens;
+            console.log(`\u{1F4CA} Tokens this call: ${ctx.usage.totalTokens}`);
+            console.log(`\u{1F4CA} Total tokens: ${totalTokens} (across ${totalCalls} calls)`);
+          }
+        }
+      }
+    };
+  }
+  /**
+   * Preset: Error logging.
+   *
+   * Logs detailed error information for debugging.
+   *
+   * @returns Hook configuration
+   *
+   * @example
+   * ```typescript
+   * .withHooks(HookPresets.errorLogging())
+   * ```
+   */
+  static errorLogging() {
+    return {
+      observers: {
+        onLLMCallError: async (ctx) => {
+          console.error(`\u274C LLM Error (iteration ${ctx.iteration}):`, ctx.error.message);
+          console.error(`   Model: ${ctx.options.model}`);
+          console.error(`   Recovered: ${ctx.recovered}`);
+        },
+        onGadgetExecutionComplete: async (ctx) => {
+          if (ctx.error) {
+            console.error(`\u274C Gadget Error: ${ctx.gadgetName}`);
+            console.error(`   Error: ${ctx.error}`);
+            console.error(`   Parameters:`, JSON.stringify(ctx.parameters, null, 2));
+          }
+        }
+      }
+    };
+  }
+  /**
+   * Preset: Silent (no output).
+   *
+   * Useful for testing or when you want complete control.
+   *
+   * @returns Empty hook configuration
+   *
+   * @example
+   * ```typescript
+   * .withHooks(HookPresets.silent())
+   * ```
+   */
+  static silent() {
+    return {};
+  }
+  /**
+   * Merge multiple hook configurations.
+   *
+   * Combines hook presets or custom configurations into a single object.
+   * When multiple hooks target the same lifecycle event, they are composed
+   * to run sequentially (all handlers will execute).
+   *
+   * @param hookSets - Array of hook configurations to merge
+   * @returns Merged hook configuration with composed handlers
+   *
+   * @example
+   * ```typescript
+   * .withHooks(HookPresets.merge(
+   *   HookPresets.logging({ verbose: true }),
+   *   HookPresets.timing(),
+   *   HookPresets.tokenTracking(),
+   *   {
+   *     // Custom hook
+   *     observers: {
+   *       onLLMCallComplete: async (ctx) => {
+   *         saveToDatabase(ctx);
+   *       }
+   *     }
+   *   }
+   * ))
+   * // All onLLMCallComplete handlers from logging, timing, tokenTracking,
+   * // and the custom hook will execute in order
+   * ```
+   */
+  static merge(...hookSets) {
+    const merged = {
+      observers: {},
+      interceptors: {},
+      controllers: {}
+    };
+    for (const hooks of hookSets) {
+      if (hooks.observers) {
+        for (const [key, handler] of Object.entries(hooks.observers)) {
+          const typedKey = key;
+          if (merged.observers[typedKey]) {
+            const existing = merged.observers[typedKey];
+            merged.observers[typedKey] = async (ctx) => {
+              await existing(ctx);
+              await handler(ctx);
+            };
+          } else {
+            merged.observers[typedKey] = handler;
+          }
+        }
+      }
+      if (hooks.interceptors) {
+        Object.assign(merged.interceptors, hooks.interceptors);
+      }
+      if (hooks.controllers) {
+        Object.assign(merged.controllers, hooks.controllers);
+      }
+    }
+    return merged;
+  }
+  /**
+   * Preset: Complete monitoring suite.
+   *
+   * Combines logging, timing, and token tracking.
+   *
+   * @param options - Options for monitoring
+   * @returns Merged hook configuration
+   *
+   * @example
+   * ```typescript
+   * .withHooks(HookPresets.monitoring())
+   * .withHooks(HookPresets.monitoring({ verbose: true }))
+   * ```
+   */
+  static monitoring(options = {}) {
+    return _HookPresets.merge(
+      _HookPresets.logging(options),
+      _HookPresets.timing(),
+      _HookPresets.tokenTracking(),
+      _HookPresets.errorLogging()
+    );
+  }
+};
+
+// src/agent/index.ts
+init_conversation_manager();
+init_stream_processor();
+
+// src/index.ts
+init_client();
+init_messages();
+init_model_registry();
+init_model_shortcuts();
+init_options();
+init_prompt_config();
+init_quick_methods();
+init_exceptions();
+init_executor();
+init_parser();
+init_registry();
+
+// src/gadgets/typed-gadget.ts
+function Gadget(config) {
+  class GadgetBase extends BaseGadget {
+    description = config.description;
+    parameterSchema = config.schema;
+    name = config.name;
+    timeoutMs = config.timeoutMs;
+    /**
+     * Type helper property for accessing inferred parameter type.
+     * This is used in the execute method signature: `execute(params: this['params'])`
+     *
+     * Note: This is just for type inference - the actual params in execute()
+     * will be Record<string, unknown> which you can safely cast to this['params']
+     */
+    params;
+  }
+  return GadgetBase;
+}
+
+// src/index.ts
+init_logger();
+init_anthropic();
+init_discovery();
+init_gemini();
+init_openai();
+export {
+  AgentBuilder,
+  AnthropicMessagesProvider,
+  BaseGadget,
+  BreakLoopException,
+  ConversationManager,
+  DEFAULT_PROMPTS,
+  Gadget,
+  GadgetExecutor,
+  GadgetRegistry,
+  GeminiGenerativeProvider,
+  HookPresets,
+  HumanInputException,
+  LLMMessageBuilder,
+  LLMist,
+  MODEL_ALIASES,
+  MockBuilder,
+  MockManager,
+  MockProviderAdapter,
+  ModelIdentifierParser,
+  ModelRegistry,
+  OpenAIChatProvider,
+  StreamParser,
+  StreamProcessor,
+  collectEvents,
+  collectText,
+  complete,
+  createAnthropicProviderFromEnv,
+  createGadget,
+  createGeminiProviderFromEnv,
+  createLogger,
+  createMockAdapter,
+  createMockClient,
+  createMockStream,
+  createOpenAIProviderFromEnv,
+  createTextMockStream,
+  defaultLogger,
+  discoverProviderAdapters,
+  getMockManager,
+  getModelId,
+  getProvider,
+  hasProviderPrefix,
+  mockLLM,
+  resolveModel,
+  resolvePromptTemplate,
+  resolveRulesTemplate,
+  runWithHandlers,
+  stream,
+  validateAndApplyDefaults,
+  validateGadgetParams,
+  z
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/agent/hook-presets.ts","../src/agent/index.ts","../src/gadgets/typed-gadget.ts"],"sourcesContent":["// Re-export Zod's z for schema definitions\n// Using llmist's z ensures .describe() metadata is preserved in JSON schemas\nexport { z } from \"zod\";\n// Syntactic sugar: Agent builder and event handlers\nexport type { HistoryMessage } from \"./agent/builder.js\";\nexport { AgentBuilder } from \"./agent/builder.js\";\nexport type { EventHandlers } from \"./agent/event-handlers.js\";\nexport { collectEvents, collectText, runWithHandlers } from \"./agent/event-handlers.js\";\n// Syntactic sugar: Hook presets\nexport type { LoggingOptions } from \"./agent/hook-presets.js\";\nexport { HookPresets } from \"./agent/hook-presets.js\";\n// Agent infrastructure\n// New clean hooks system\nexport type {\n  AfterGadgetExecutionAction,\n  AfterGadgetExecutionControllerContext,\n  AfterLLMCallAction,\n  AfterLLMCallControllerContext,\n  AfterLLMErrorAction,\n  AgentHooks,\n  AgentOptions,\n  BeforeGadgetExecutionAction,\n  BeforeLLMCallAction,\n  // Interceptor contexts\n  ChunkInterceptorContext,\n  Controllers,\n  GadgetExecutionControllerContext,\n  GadgetParameterInterceptorContext,\n  GadgetResultInterceptorContext,\n  IConversationManager,\n  Interceptors,\n  // Controller contexts and actions\n  LLMCallControllerContext,\n  LLMErrorControllerContext,\n  MessageInterceptorContext,\n  ObserveChunkContext,\n  ObserveGadgetCompleteContext,\n  ObserveGadgetStartContext,\n  // Observer contexts\n  ObserveLLMCallContext,\n  ObserveLLMCompleteContext,\n  ObserveLLMErrorContext,\n  Observers,\n  StreamProcessingResult,\n  StreamProcessorOptions,\n} from \"./agent/index.js\";\nexport { ConversationManager, StreamProcessor } from \"./agent/index.js\";\nexport type { LLMistOptions } from \"./core/client.js\";\nexport { LLMist } from \"./core/client.js\";\nexport type { LLMMessage, LLMRole } from \"./core/messages.js\";\nexport { LLMMessageBuilder } from \"./core/messages.js\";\n// Model catalog\nexport type {\n  CostEstimate,\n  ModelFeatures,\n  ModelLimits,\n  ModelPricing,\n  ModelSpec,\n} from \"./core/model-catalog.js\";\nexport { ModelRegistry } from \"./core/model-registry.js\";\n\n// Syntactic sugar: Model shortcuts and quick methods\nexport {\n  getModelId,\n  getProvider,\n  hasProviderPrefix,\n  MODEL_ALIASES,\n  resolveModel,\n} from \"./core/model-shortcuts.js\";\nexport type {\n  LLMGenerationOptions,\n  LLMStream,\n  LLMStreamChunk,\n  ModelDescriptor,\n  ProviderIdentifier,\n  TokenUsage,\n} from \"./core/options.js\";\nexport { ModelIdentifierParser } from \"./core/options.js\";\nexport type { PromptConfig, PromptContext, PromptTemplate } from \"./core/prompt-config.js\";\nexport {\n  DEFAULT_PROMPTS,\n  resolvePromptTemplate,\n  resolveRulesTemplate,\n} from \"./core/prompt-config.js\";\nexport type { QuickOptions } from \"./core/quick-methods.js\";\nexport { complete, stream } from \"./core/quick-methods.js\";\nexport type { CreateGadgetConfig } from \"./gadgets/create-gadget.js\";\nexport { createGadget } from \"./gadgets/create-gadget.js\";\n// Gadget infrastructure\nexport { BreakLoopException, HumanInputException } from \"./gadgets/exceptions.js\";\nexport { GadgetExecutor } from \"./gadgets/executor.js\";\nexport { BaseGadget } from \"./gadgets/gadget.js\";\nexport { StreamParser } from \"./gadgets/parser.js\";\nexport type { GadgetClass, GadgetOrClass } from \"./gadgets/registry.js\";\nexport { GadgetRegistry } from \"./gadgets/registry.js\";\n\n// Syntactic sugar: Typed gadgets and helpers\nexport type { GadgetConfig } from \"./gadgets/typed-gadget.js\";\nexport { Gadget } from \"./gadgets/typed-gadget.js\";\nexport type {\n  GadgetExecutionResult,\n  ParsedGadgetCall,\n  StreamEvent,\n  TextOnlyAction,\n  TextOnlyContext,\n  TextOnlyCustomHandler,\n  TextOnlyGadgetConfig,\n  TextOnlyHandler,\n  TextOnlyStrategy,\n} from \"./gadgets/types.js\";\nexport type { ValidationIssue, ValidationResult } from \"./gadgets/validation.js\";\nexport { validateAndApplyDefaults, validateGadgetParams } from \"./gadgets/validation.js\";\nexport type { LoggerOptions } from \"./logging/logger.js\";\nexport { createLogger, defaultLogger } from \"./logging/logger.js\";\nexport {\n  AnthropicMessagesProvider,\n  createAnthropicProviderFromEnv,\n} from \"./providers/anthropic.js\";\nexport { discoverProviderAdapters } from \"./providers/discovery.js\";\nexport { createGeminiProviderFromEnv, GeminiGenerativeProvider } from \"./providers/gemini.js\";\nexport { createOpenAIProviderFromEnv, OpenAIChatProvider } from \"./providers/openai.js\";\nexport type { ProviderAdapter } from \"./providers/provider.js\";\n\n// Testing/Mock infrastructure\nexport type {\n  MockMatcher,\n  MockMatcherContext,\n  MockOptions,\n  MockRegistration,\n  MockResponse,\n  MockStats,\n} from \"./testing/index.js\";\nexport {\n  createMockAdapter,\n  createMockClient,\n  createMockStream,\n  createTextMockStream,\n  getMockManager,\n  MockBuilder,\n  MockManager,\n  MockProviderAdapter,\n  mockLLM,\n} from \"./testing/index.js\";\n","/**\n * Common hook presets for logging, timing, and monitoring.\n *\n * @example\n * ```typescript\n * import { HookPresets } from 'llmist/hooks';\n *\n * const agent = LLMist.createAgent()\n *   .withHooks(HookPresets.logging())\n *   .ask(\"...\");\n *\n * // Or combine multiple presets\n * const agent = LLMist.createAgent()\n *   .withHooks(HookPresets.merge(\n *     HookPresets.logging({ verbose: true }),\n *     HookPresets.timing(),\n *     HookPresets.tokenTracking()\n *   ))\n *   .ask(\"...\");\n * ```\n */\n\nimport type { AgentHooks } from \"./hooks.js\";\n\n/**\n * Options for logging preset.\n */\nexport interface LoggingOptions {\n  /** Include verbose details like parameters and results */\n  verbose?: boolean;\n}\n\n/**\n * Common hook presets.\n */\nexport class HookPresets {\n  /**\n   * Preset: Basic logging of all events.\n   *\n   * Logs LLM calls and gadget executions to console.\n   *\n   * @param options - Logging options\n   * @returns Hook configuration\n   *\n   * @example\n   * ```typescript\n   * .withHooks(HookPresets.logging())\n   * .withHooks(HookPresets.logging({ verbose: true }))\n   * ```\n   */\n  static logging(options: LoggingOptions = {}): AgentHooks {\n    return {\n      observers: {\n        onLLMCallStart: async (ctx) => {\n          console.log(`[LLM] Starting call (iteration ${ctx.iteration})`);\n        },\n        onLLMCallComplete: async (ctx) => {\n          const tokens = ctx.usage?.totalTokens ?? \"unknown\";\n          console.log(`[LLM] Completed (tokens: ${tokens})`);\n          if (options.verbose && ctx.finalMessage) {\n            console.log(`[LLM] Response: ${ctx.finalMessage}`);\n          }\n        },\n        onGadgetExecutionStart: async (ctx) => {\n          console.log(`[GADGET] Executing ${ctx.gadgetName}`);\n          if (options.verbose) {\n            console.log(`[GADGET] Parameters:`, JSON.stringify(ctx.parameters, null, 2));\n          }\n        },\n        onGadgetExecutionComplete: async (ctx) => {\n          console.log(`[GADGET] Completed ${ctx.gadgetName}`);\n          if (options.verbose) {\n            const display = ctx.error ?? ctx.finalResult ?? \"(no result)\";\n            console.log(`[GADGET] Result: ${display}`);\n          }\n        },\n      },\n    };\n  }\n\n  /**\n   * Preset: Performance timing for all operations.\n   *\n   * Measures and logs execution time for LLM calls and gadgets.\n   *\n   * @returns Hook configuration\n   *\n   * @example\n   * ```typescript\n   * .withHooks(HookPresets.timing())\n   * ```\n   */\n  static timing(): AgentHooks {\n    const timings = new Map<string, number>();\n\n    return {\n      observers: {\n        onLLMCallStart: async (ctx) => {\n          timings.set(`llm-${ctx.iteration}`, Date.now());\n        },\n        onLLMCallComplete: async (ctx) => {\n          const start = timings.get(`llm-${ctx.iteration}`);\n          if (start) {\n            const duration = Date.now() - start;\n            console.log(`⏱️  LLM call took ${duration}ms`);\n            timings.delete(`llm-${ctx.iteration}`);\n          }\n        },\n        onGadgetExecutionStart: async (ctx) => {\n          const key = `gadget-${ctx.gadgetName}-${Date.now()}`;\n          timings.set(key, Date.now());\n          // Store key for lookup in complete handler\n          (ctx as any)._timingKey = key;\n        },\n        onGadgetExecutionComplete: async (ctx) => {\n          const key = (ctx as any)._timingKey;\n          if (key) {\n            const start = timings.get(key);\n            if (start) {\n              const duration = Date.now() - start;\n              console.log(`⏱️  Gadget ${ctx.gadgetName} took ${duration}ms`);\n              timings.delete(key);\n            }\n          }\n        },\n      },\n    };\n  }\n\n  /**\n   * Preset: Token usage tracking.\n   *\n   * Tracks and logs cumulative token usage across all LLM calls.\n   *\n   * @returns Hook configuration\n   *\n   * @example\n   * ```typescript\n   * .withHooks(HookPresets.tokenTracking())\n   * ```\n   */\n  static tokenTracking(): AgentHooks {\n    let totalTokens = 0;\n    let totalCalls = 0;\n\n    return {\n      observers: {\n        onLLMCallComplete: async (ctx) => {\n          totalCalls++;\n          if (ctx.usage?.totalTokens) {\n            totalTokens += ctx.usage.totalTokens;\n            console.log(`📊 Tokens this call: ${ctx.usage.totalTokens}`);\n            console.log(`📊 Total tokens: ${totalTokens} (across ${totalCalls} calls)`);\n          }\n        },\n      },\n    };\n  }\n\n  /**\n   * Preset: Error logging.\n   *\n   * Logs detailed error information for debugging.\n   *\n   * @returns Hook configuration\n   *\n   * @example\n   * ```typescript\n   * .withHooks(HookPresets.errorLogging())\n   * ```\n   */\n  static errorLogging(): AgentHooks {\n    return {\n      observers: {\n        onLLMCallError: async (ctx) => {\n          console.error(`❌ LLM Error (iteration ${ctx.iteration}):`, ctx.error.message);\n          console.error(`   Model: ${ctx.options.model}`);\n          console.error(`   Recovered: ${ctx.recovered}`);\n        },\n        onGadgetExecutionComplete: async (ctx) => {\n          if (ctx.error) {\n            console.error(`❌ Gadget Error: ${ctx.gadgetName}`);\n            console.error(`   Error: ${ctx.error}`);\n            console.error(`   Parameters:`, JSON.stringify(ctx.parameters, null, 2));\n          }\n        },\n      },\n    };\n  }\n\n  /**\n   * Preset: Silent (no output).\n   *\n   * Useful for testing or when you want complete control.\n   *\n   * @returns Empty hook configuration\n   *\n   * @example\n   * ```typescript\n   * .withHooks(HookPresets.silent())\n   * ```\n   */\n  static silent(): AgentHooks {\n    return {};\n  }\n\n  /**\n   * Merge multiple hook configurations.\n   *\n   * Combines hook presets or custom configurations into a single object.\n   * When multiple hooks target the same lifecycle event, they are composed\n   * to run sequentially (all handlers will execute).\n   *\n   * @param hookSets - Array of hook configurations to merge\n   * @returns Merged hook configuration with composed handlers\n   *\n   * @example\n   * ```typescript\n   * .withHooks(HookPresets.merge(\n   *   HookPresets.logging({ verbose: true }),\n   *   HookPresets.timing(),\n   *   HookPresets.tokenTracking(),\n   *   {\n   *     // Custom hook\n   *     observers: {\n   *       onLLMCallComplete: async (ctx) => {\n   *         saveToDatabase(ctx);\n   *       }\n   *     }\n   *   }\n   * ))\n   * // All onLLMCallComplete handlers from logging, timing, tokenTracking,\n   * // and the custom hook will execute in order\n   * ```\n   */\n  static merge(...hookSets: AgentHooks[]): AgentHooks {\n    const merged: AgentHooks = {\n      observers: {},\n      interceptors: {},\n      controllers: {},\n    };\n\n    // Compose observers: run all handlers for the same event\n    for (const hooks of hookSets) {\n      if (hooks.observers) {\n        for (const [key, handler] of Object.entries(hooks.observers)) {\n          const typedKey = key as keyof typeof hooks.observers;\n          if (merged.observers![typedKey]) {\n            // Compose: run both existing and new handler\n            const existing = merged.observers![typedKey];\n            merged.observers![typedKey] = async (ctx: any) => {\n              await existing(ctx);\n              await handler(ctx);\n            };\n          } else {\n            merged.observers![typedKey] = handler as any;\n          }\n        }\n      }\n\n      // Interceptors: last one wins (complex signatures make composition impractical)\n      // Each interceptor has different parameters (chunk, message, parameters, etc.)\n      // so we can't meaningfully compose them like we do with observers\n      if (hooks.interceptors) {\n        Object.assign(merged.interceptors!, hooks.interceptors);\n      }\n\n      // Controllers: last one wins (can't meaningfully compose boolean returns)\n      if (hooks.controllers) {\n        Object.assign(merged.controllers!, hooks.controllers);\n      }\n    }\n\n    return merged;\n  }\n\n  /**\n   * Preset: Complete monitoring suite.\n   *\n   * Combines logging, timing, and token tracking.\n   *\n   * @param options - Options for monitoring\n   * @returns Merged hook configuration\n   *\n   * @example\n   * ```typescript\n   * .withHooks(HookPresets.monitoring())\n   * .withHooks(HookPresets.monitoring({ verbose: true }))\n   * ```\n   */\n  static monitoring(options: LoggingOptions = {}): AgentHooks {\n    return HookPresets.merge(\n      HookPresets.logging(options),\n      HookPresets.timing(),\n      HookPresets.tokenTracking(),\n      HookPresets.errorLogging(),\n    );\n  }\n}\n","/**\n * Agent module - Composable, single-responsibility architecture for LLM agents.\n * This module provides a cleaner alternative to the monolithic AgentLoop.\n */\n\nexport type { AgentOptions } from \"./agent.js\";\nexport { ConversationManager } from \"./conversation-manager.js\";\n// New clean hooks system\nexport type {\n  AfterGadgetExecutionAction,\n  AfterGadgetExecutionControllerContext,\n  AfterLLMCallAction,\n  AfterLLMCallControllerContext,\n  AfterLLMErrorAction,\n  AgentHooks,\n  BeforeGadgetExecutionAction,\n  BeforeLLMCallAction,\n  // Interceptor contexts\n  ChunkInterceptorContext,\n  Controllers,\n  GadgetExecutionControllerContext,\n  GadgetParameterInterceptorContext,\n  GadgetResultInterceptorContext,\n  Interceptors,\n  // Controller contexts and actions\n  LLMCallControllerContext,\n  LLMErrorControllerContext,\n  MessageInterceptorContext,\n  ObserveChunkContext,\n  ObserveGadgetCompleteContext,\n  ObserveGadgetStartContext,\n  // Observer contexts\n  ObserveLLMCallContext,\n  ObserveLLMCompleteContext,\n  ObserveLLMErrorContext,\n  Observers,\n} from \"./hooks.js\";\nexport type { IConversationManager } from \"./interfaces.js\";\n\n// StreamProcessor for advanced use cases\nexport {\n  type StreamProcessingResult,\n  StreamProcessor,\n  type StreamProcessorOptions,\n} from \"./stream-processor.js\";\n","/**\n * Type-safe gadget factory with automatic parameter inference.\n *\n * Gadget eliminates the need for manual type assertions\n * by automatically inferring parameter types from the Zod schema.\n *\n * @example\n * ```typescript\n * class Calculator extends Gadget({\n *   description: \"Performs arithmetic operations\",\n *   schema: z.object({\n *     operation: z.enum([\"add\", \"subtract\"]),\n *     a: z.number(),\n *     b: z.number(),\n *   }),\n * }) {\n *   // ✨ params is automatically typed!\n *   execute(params: this['params']): string {\n *     const { operation, a, b } = params; // All typed!\n *     return operation === \"add\" ? String(a + b) : String(a - b);\n *   }\n * }\n * ```\n */\n\nimport type { ZodType } from \"zod\";\nimport { BaseGadget } from \"./gadget.js\";\n\n/**\n * Infer the TypeScript type from a Zod schema.\n */\ntype InferSchema<T> = T extends ZodType<infer U> ? U : never;\n\n/**\n * Configuration for creating a typed gadget.\n */\nexport interface GadgetConfig<TSchema extends ZodType> {\n  /** Human-readable description of what the gadget does */\n  description: string;\n\n  /** Zod schema for parameter validation */\n  schema: TSchema;\n\n  /** Optional custom name (defaults to class name) */\n  name?: string;\n\n  /** Optional timeout in milliseconds */\n  timeoutMs?: number;\n}\n\n/**\n * Factory function to create a typed gadget base class.\n *\n * The returned class automatically infers parameter types from the Zod schema,\n * eliminating the need for manual type assertions in the execute method.\n *\n * @param config - Configuration with description and schema\n * @returns Base class to extend with typed execute method\n *\n * @example\n * ```typescript\n * import { z } from 'zod';\n * import { Gadget } from 'llmist';\n *\n * class Calculator extends Gadget({\n *   description: \"Performs arithmetic operations\",\n *   schema: z.object({\n *     operation: z.enum([\"add\", \"subtract\", \"multiply\", \"divide\"]),\n *     a: z.number().describe(\"First number\"),\n *     b: z.number().describe(\"Second number\"),\n *   }),\n * }) {\n *   execute(params: this['params']): string {\n *     // params is automatically typed as:\n *     // { operation: \"add\" | \"subtract\" | \"multiply\" | \"divide\"; a: number; b: number }\n *     const { operation, a, b } = params;\n *\n *     switch (operation) {\n *       case \"add\": return String(a + b);\n *       case \"subtract\": return String(a - b);\n *       case \"multiply\": return String(a * b);\n *       case \"divide\": return String(a / b);\n *     }\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // With async execution\n * class WeatherGadget extends Gadget({\n *   description: \"Fetches weather for a city\",\n *   schema: z.object({\n *     city: z.string().min(1).describe(\"City name\"),\n *   }),\n *   timeoutMs: 10000,\n * }) {\n *   async execute(params: this['params']): Promise<string> {\n *     const { city } = params; // Automatically typed as { city: string }\n *     const weather = await fetchWeather(city);\n *     return `Weather in ${city}: ${weather}`;\n *   }\n * }\n * ```\n */\nexport function Gadget<TSchema extends ZodType>(config: GadgetConfig<TSchema>) {\n  abstract class GadgetBase extends BaseGadget {\n    description = config.description;\n    parameterSchema = config.schema;\n    name = config.name;\n    timeoutMs = config.timeoutMs;\n\n    /**\n     * Type helper property for accessing inferred parameter type.\n     * This is used in the execute method signature: `execute(params: this['params'])`\n     *\n     * Note: This is just for type inference - the actual params in execute()\n     * will be Record<string, unknown> which you can safely cast to this['params']\n     */\n    readonly params!: InferSchema<TSchema>;\n\n    /**\n     * Execute the gadget. Subclasses should cast params to this['params'].\n     *\n     * @param params - Validated parameters from the LLM\n     * @returns Result as a string (or Promise<string> for async gadgets)\n     *\n     * @example\n     * ```typescript\n     * execute(params: Record<string, unknown>): string {\n     *   const typed = params as this['params'];\n     *   // Now 'typed' is fully typed!\n     *   return String(typed.a + typed.b);\n     * }\n     * ```\n     */\n    abstract execute(params: Record<string, unknown>): string | Promise<string>;\n  }\n\n  return GadgetBase as {\n    new (): GadgetBase & { params: InferSchema<TSchema> };\n  };\n}\n"],"mappings":"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","names":[]}