@meetsmore-oss/use-ai-server 1.15.0 → 1.17.0

package/dist/agents/AISDKAgent.d.ts

@@ -3,81 +3,141 @@ import type { Agent, AgentInput, EventEmitter, AgentResult } from './types';
 import type { ToolDefinition } from '../types';
 import { type CacheBreakpointFn } from './anthropicCache';
 /**
- * Configuration for AISDKAgent.
+ * The generation configuration for a single run(), returned by
+ * {@link AISDKAgentHooks.loadConfig}.
+ *
+ * Because `loadConfig` is called once per run, returning different values here
+ * changes the model / parameters for the next run without a server restart
+ * (e.g. values fetched from Langfuse prompt config).
+ *
+ * Only `model` is required. Omitted optional fields use library defaults.
  */
-export interface AISDKAgentConfig {
+export interface AISDKRunConfig {
     /**
-     * AI SDK Language Model (works with any provider).
+     * AI SDK Language Model (works with any provider). Accepts a model instance
+     * or a gateway model ID string.
+     *
+     * Required: use-ai is provider-agnostic and cannot pick a default model.
      *
      * @example
      * ```typescript
      * import { anthropic } from '@ai-sdk/anthropic';
-     * import { openai } from '@ai-sdk/openai';
-     * import { google } from '@ai-sdk/google';
-     *
-     * // With Anthropic Claude
-     * { model: anthropic('claude-3-5-sonnet-20241022') }
-     *
-     * // With OpenAI GPT
-     * { model: openai('gpt-4-turbo') }
-     *
-     * // With Google Gemini
-     * { model: google('gemini-pro') }
+     * { model: anthropic('claude-3-5-sonnet-20241022') }   // model instance
+     * { model: 'anthropic/claude-3-5-sonnet-20241022' }    // gateway model ID
      * ```
      */
     model: LanguageModel;
     /**
-     * Agent name for identification (defaults to 'ai-sdk').
-     * Use this to differentiate multiple AI SDK agents.
+     * System prompt for this run, set on the backend and not exposed to the
+     * frontend (suitable for sensitive instructions). An empty string is treated
+     * as absent. When the request also carries a system prompt (AgentInput), the
+     * two are sent as separate system messages with this one first.
      */
-    name?: string;
+    systemPrompt?: string;
     /**
-     * Optional annotation/description for the agent.
-     * Displayed in the use-ai agent selector UI to help users understand
-     * the agent's capabilities or purpose.
+     * Temperature for model responses. Lower (e.g. 0) is more deterministic.
+     * @default undefined (uses the model's default)
+     */
+    temperature?: number;
+    /**
+     * Maximum number of tokens the model can output per response.
+     * @default 4096
+     */
+    maxOutputTokens?: number;
+    /**
+     * Maximum number of model step iterations per run. Each iteration performs
+     * one model invocation and may include tool calls.
+     * @default 10
+     */
+    maxSteps?: number;
+    /**
+     * Provider-specific options passed directly to `streamText`.
+     * Used for AI Gateway features like model fallbacks and provider routing.
      *
      * @example
      * ```typescript
-     * { annotation: 'Fast responses for simple tasks' }
-     * { annotation: 'Deep thinking mode for complex reasoning' }
+     * {
+     *   providerOptions: {
+     *     gateway: {
+     *       models: ['anthropic/claude-opus-4.6', 'google/gemini-3.1-pro-preview'],
+     *       order: ['azure', 'openai'],
+     *     },
+     *   },
+     * }
      * ```
      */
-    annotation?: string;
+    providerOptions?: Record<string, Record<string, JSONValue>>;
+}
+/**
+ * Function-valued configuration points for {@link AISDKAgent}.
+ *
+ * Anything that can change at runtime is supplied through a hook rather than a
+ * static config field, so there is a single source of truth and no "static
+ * value vs. override" ambiguity.
+ */
+export interface AISDKAgentHooks {
     /**
-     * Optional system prompt to configure the agent's behavior.
-     * This prompt is set on the backend and not exposed to the frontend,
-     * making it suitable for sensitive instructions.
+     * Loads the generation config for a run.
+     *
+     * Called once at the start of every run(), so a value fetched from an external
+     * source (e.g. Langfuse prompt config) takes effect on the next request
+     * without a server restart. The agent does not cache the result.
      *
-     * Can be a string, a function returning a string, or an async function
-     * returning a Promise<string>. Use a function when the prompt needs to
-     * be dynamically resolved (e.g., fetched from Langfuse or other external
-     * sources) so updates take effect immediately without server restart.
+     * Required, because it is the only source of the model. For a static setup,
+     * return a constant object.
      *
-     * When both this and the runtime systemPrompt (from AgentInput) are provided,
-     * they are combined with this config prompt coming first.
+     * If it throws, the run fails with RUN_ERROR — there is no static fallback.
+     * Implement resilience (e.g. return a default on a Langfuse outage) inside the
+     * hook itself.
      *
      * @example
      * ```typescript
-     * // Static prompt
-     * {
-     *   systemPrompt: 'You are a helpful assistant.'
-     * }
+     * // Static
+     * { loadConfig: () => ({ model: anthropic('claude-3-5-sonnet-20241022') }) }
      *
-     * // Sync function (e.g., reading from cache)
+     * // Dynamic, fetched from Langfuse (with a fallback owned by the host)
      * {
-     *   systemPrompt: () => promptCache.get('my-prompt')
+     *   loadConfig: async () => {
+     *     try {
+     *       const prompt = await langfuse.prompt.get('my-prompt', { type: 'text' });
+     *       return { model: prompt.config.model, systemPrompt: prompt.prompt };
+     *     } catch {
+     *       return { model: 'anthropic/claude-3-5-sonnet-20241022' };
+     *     }
+     *   },
      * }
+     * ```
+     */
+    loadConfig: () => AISDKRunConfig | Promise<AISDKRunConfig>;
+}
+/**
+ * Configuration for AISDKAgent.
+ *
+ * Structural settings (name, tool filtering, cache breakpoints) live here;
+ * everything that can vary per run is supplied via {@link AISDKAgentHooks}.
+ */
+export interface AISDKAgentConfig {
+    /**
+     * Function-valued configuration. `hooks.loadConfig` (required) supplies the
+     * model and generation parameters for each run.
+     */
+    hooks: AISDKAgentHooks;
+    /**
+     * Agent name for identification (defaults to 'ai-sdk').
+     * Use this to differentiate multiple AI SDK agents.
+     */
+    name?: string;
+    /**
+     * Optional annotation/description for the agent.
+     * Displayed in the use-ai agent selector UI to help users understand
+     * the agent's capabilities or purpose.
      *
-     * // Async function (e.g., fetching from Langfuse)
-     * {
-     *   systemPrompt: async () => {
-     *     const prompt = await langfuse.getPrompt('my-prompt');
-     *     return prompt.compile();
-     *   }
-     * }
+     * @example
+     * ```typescript
+     * { annotation: 'Fast responses for simple tasks' }
      * ```
      */
-    systemPrompt?: string | (() => string | Promise<string>);
+    annotation?: string;
     /**
      * Optional filter function for tools.
      * Use this to control which tools are available to this agent.
@@ -86,17 +146,7 @@ export interface AISDKAgentConfig {
      * @example
      * ```typescript
      * // Only allow MCP tools starting with 'db_'
-     * {
-     *   toolFilter: (tool) =>
-     *     !tool._remote || tool.name.startsWith('db_')
-     * }
-     *
-     * // Block dangerous MCP tools
-     * {
-     *   toolFilter: (tool) =>
-     *     !tool._remote ||
-     *     (!tool.name.includes('delete') && !tool.name.includes('drop'))
-     * }
+     * { toolFilter: (tool) => !tool._remote || tool.name.startsWith('db_') }
      * ```
      */
     toolFilter?: (tool: ToolDefinition) => boolean;
@@ -105,36 +155,16 @@ export interface AISDKAgentConfig {
      * Only applies when using Anthropic models (Claude).
      *
      * Prompt caching reduces costs and latency by caching message prefixes.
-     * Cache breakpoints mark where the cacheable prefix ends.
-     *
      * The function receives each message with positional context and returns
-     * true to add a cache breakpoint after that message.
-     *
-     * System prompt is included as role: 'system' at index 0 when present.
+     * true to add a cache breakpoint after that message. System prompt is
+     * included as role: 'system' at index 0 when present.
      *
      * @see https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching
      *
      * @example
      * ```typescript
      * // Cache system prompt + last message (most common pattern)
-     * {
-     *   cacheBreakpoint: (msg) => msg.role === 'system' || msg.isLast
-     * }
-     *
-     * // Cache only the last message
-     * {
-     *   cacheBreakpoint: (msg) => msg.isLast
-     * }
-     *
-     * // Cache system prompt only
-     * {
-     *   cacheBreakpoint: (msg) => msg.role === 'system'
-     * }
-     *
-     * // Cache first 3 messages + last
-     * {
-     *   cacheBreakpoint: (msg) => msg.index < 3 || msg.isLast
-     * }
+     * { cacheBreakpoint: (msg) => msg.role === 'system' || msg.isLast }
      *
      * // System prompt with 1h TTL, last message with 5m TTL
      * {
@@ -147,52 +177,6 @@ export interface AISDKAgentConfig {
      * ```
      */
     cacheBreakpoint?: CacheBreakpointFn;
-    /**
-     * Provider-specific options passed directly to `streamText`.
-     * Can be used for AI Gateway features like model fallbacks, provider routing, etc.
-     *
-     * @example
-     * ```typescript
-     * // Model fallbacks via AI Gateway
-     * {
-     *   providerOptions: {
-     *     gateway: {
-     *       models: ['anthropic/claude-opus-4.6', 'google/gemini-3.1-pro-preview'],
-     *     },
-     *   },
-     * }
-     *
-     * // Model fallbacks + provider routing
-     * {
-     *   providerOptions: {
-     *     gateway: {
-     *       models: ['openai/gpt-5-nano', 'anthropic/claude-opus-4.6'],
-     *       order: ['azure', 'openai'],
-     *     },
-     *   },
-     * }
-     * ```
-     */
-    providerOptions?: Record<string, Record<string, JSONValue>>;
-    /**
-     * Maximum number of tokens the model can output per response.
-     * @default 4096
-     */
-    maxOutputTokens?: number;
-    /**
-     * Temperature for model responses.
-     * Lower values (e.g., 0) make responses more deterministic.
-     * Higher values (e.g., 1) make responses more creative/random.
-     * Useful for testing where deterministic behavior is desired.
-     * @default undefined (uses model's default)
-     */
-    temperature?: number;
-    /**
-     * Maximum number of model step iterations per run.
-     * Each iteration performs one model invocation and may include tool calls.
-     * @default 10
-     */
-    maxSteps?: number;
 }
 /**
  * Agent implementation for AI SDK models (Anthropic, OpenAI, Google, etc.).
@@ -226,12 +210,12 @@ export interface AISDKAgentConfig {
  * // With Claude
  * const anthropic = createAnthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
  * const claudeAgent = new AISDKAgent({
- *   model: anthropic('claude-3-5-sonnet-20241022'),
+ *   hooks: { loadConfig: () => ({ model: anthropic('claude-3-5-sonnet-20241022') }) },
  * });
  *
  * // With GPT-4
  * const gptAgent = new AISDKAgent({
- *   model: openai('gpt-4-turbo'),
+ *   hooks: { loadConfig: () => ({ model: openai('gpt-4-turbo') }) },
  * });
  *
  * // Agent names come from agents object keys, not from agent config
@@ -245,16 +229,11 @@ export interface AISDKAgentConfig {
  * ```
  */
 export declare class AISDKAgent implements Agent {
-    private model;
-    private providerOptions?;
     private name;
     private annotation?;
     private toolFilter?;
-    private systemPrompt?;
     private cacheBreakpoint?;
-    private maxOutputTokens;
-    private temperature?;
-    private maxSteps;
+    private loadConfig;
     constructor(config: AISDKAgentConfig);
     getName(): string;
     getAnnotation(): string | undefined;
@@ -265,10 +244,17 @@ export declare class AISDKAgent implements Agent {
     flushTelemetry(): Promise<void>;
     run(input: AgentInput, events: EventEmitter): Promise<AgentResult>;
     /**
-     * Creates the RunContext for a single run() invocation.
-     * Resolves system prompt and initializes all mutable state.
+     * Creates the RunContext for a single run() invocation from the loaded run
+     * config. Builds the system messages and initializes all mutable state.
      */
     private createRunContext;
+    /**
+     * Handles a failure of the `hooks.loadConfig` hook, which runs before the
+     * RunContext exists. Emits a well-formed lifecycle (RUN_STARTED then
+     * RUN_ERROR) built from the input so the client is not left hanging, and
+     * returns a failed AgentResult.
+     */
+    private handleConfigLoadError;
     /**
      * Emits initial lifecycle events: RUN_STARTED, MESSAGES_SNAPSHOT, STATE_SNAPSHOT.
      */
@@ -359,18 +345,11 @@ export declare class AISDKAgent implements Agent {
      * emits RUN_ERROR, and returns the AgentResult.
      */
     private handleRunError;
-    /**
-     * Resolves the systemPrompt configuration value.
-     * Handles string, sync function, and async function cases.
-     *
-     * @returns The resolved system prompt string, or undefined if not configured or empty
-     */
-    private resolveSystemPrompt;
     /**
      * Builds an array of static system messages from config and runtime prompts.
      * These are built once per run and remain constant across steps (cacheable prefix).
      *
-     * @param configPrompt - Resolved system prompt from agent config (already resolved via resolveSystemPrompt)
+     * @param configPrompt - Resolved system prompt from the run config (empty string already normalized to undefined)
      * @param runtimePrompt - System prompt from AgentInput (static instructions from server)
      * @returns Array of SystemModelMessage objects, or undefined if both are empty
      */

package/dist/agents/AISDKAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AISDKAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/AISDKAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.d.ts

@@ -3,7 +3,7 @@
  * Provides pluggable AI agent backends that emit AG-UI protocol events.
  */
 export type { Agent, AgentInput, EventEmitter, AgentResult, ClientSession } from './types';
-export { AISDKAgent, type AISDKAgentConfig } from './AISDKAgent';
+export { AISDKAgent, type AISDKAgentConfig, type AISDKAgentHooks, type AISDKRunConfig } from './AISDKAgent';
 export { createMockReasoningModel } from './testing/MockReasoningModel';
 export { applyCacheBreakpoints, isAnthropicModel, type MessageWithCacheContext, type CacheTtl, type CacheBreakpointResult, type CacheBreakpointFn, } from './anthropicCache';
 export { toolNeedsApproval, createApprovalWrapper, waitForApproval, type ToolArguments, type ToolResult, type ToolExecutor, } from './toolApproval';

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/agents/testing/MockReasoningModel.d.ts

@@ -14,8 +14,8 @@
  *   import { createMockReasoningModel, AISDKAgent } from '@meetsmore-oss/use-ai-server';
  *
  *   const agent = new AISDKAgent({
- *     model: createMockReasoningModel(),
  *     name: 'Mock (Reasoning)',
+ *     hooks: { loadConfig: () => ({ model: createMockReasoningModel() }) },
  *   });
  *
  * Enable in server-app with: USE_AI_ENABLE_MOCK_AGENT=true

package/dist/agents/testing/MockReasoningModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockReasoningModel.d.ts","sourceRoot":"","sources":["../../../../src/agents/testing/MockReasoningModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,mBAAmB,EAA0B,MAAM,SAAS,CAAC;AAuItE;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,mBAAmB,CAqE9D"}
+{"version":3,"file":"MockReasoningModel.d.ts","sourceRoot":"","sources":["../../../../src/agents/testing/MockReasoningModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAwI9C;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,mBAAmB,CAqE9D"}

package/dist/attachmentResolution.d.ts

@@ -0,0 +1,22 @@
+import type { Message, ResolveAttachments, ResolveAttachmentsContext } from '@meetsmore-oss/use-ai-core';
+/**
+ * Counts the `image_ref` / `file_ref` parts left in the history, for observability.
+ * After resolution these become `image_url` / `file_url`; any that remain were not
+ * resolved and are dropped during conversion (the attachment never reaches the model).
+ */
+export declare function countRefParts(messages: Message[]): number;
+/**
+ * Collects ref-bearing attachment parts across the run's whole message history,
+ * calls the host's `resolve` once, and puts the returned parts back in place.
+ * The input is not mutated. See core's {@link ResolveAttachments} for the
+ * details of the resolve contract.
+ *
+ * Returns the original `messages` reference as-is when there are no refs. When
+ * there are, it returns a new array but clones only the messages and content
+ * arrays it actually touches, so the caller's input is left unchanged.
+ *
+ * @throws When `resolve` returns a different number of parts than it was given
+ *   (a contract violation; the host must return one replacement per input).
+ */
+export declare function resolveAttachmentParts(messages: Message[], resolve: ResolveAttachments, context: ResolveAttachmentsContext): Promise<Message[]>;
+//# sourceMappingURL=attachmentResolution.d.ts.map

package/dist/attachmentResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentResolution.d.ts","sourceRoot":"","sources":["../../src/attachmentResolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,4BAA4B,CAAC;AAkBpC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAWzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,OAAO,EAAE,CAAC,CA2CpB"}

package/dist/attachmentResolution.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attachmentResolution.test.d.ts.map

package/dist/attachmentResolution.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentResolution.test.d.ts","sourceRoot":"","sources":["../../src/attachmentResolution.test.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export { UseAIServer } from './server';
 export type { UseAIServerConfig, McpEndpointConfig, ToolDefinition, CorsOptions } from './types';
 export type { ClientSession } from './server';
+export { resolveAttachmentParts } from './attachmentResolution';
+export type { ResolveAttachments, ResolveAttachmentsContext, MultimodalContent } from './types';
 export type { Agent, AgentInput, EventEmitter, AgentResult } from './agents';
-export { AISDKAgent, type AISDKAgentConfig, type MessageWithCacheContext, type CacheTtl, type CacheBreakpointResult, type CacheBreakpointFn, createMockReasoningModel } from './agents';
+export { AISDKAgent, type AISDKAgentConfig, type AISDKAgentHooks, type AISDKRunConfig, type MessageWithCacheContext, type CacheTtl, type CacheBreakpointResult, type CacheBreakpointFn, createMockReasoningModel } from './agents';
 export type { UseAIServerPlugin, MessageHandler, BeforeRunAgentResult } from './plugins';
 export { FeedbackPlugin } from './plugins';
 export type { SpanProcessor } from './instrumentation';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,QAAQ,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAGxL,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGzF,OAAO,EACL,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,yBAAyB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,GAAG,EACH,EAAE,EACF,GAAG,GACJ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGhG,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,uBAAuB,EAAE,KAAK,QAAQ,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAGnO,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGzF,OAAO,EACL,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,yBAAyB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,GAAG,EACH,EAAE,EACF,GAAG,GACJ,MAAM,SAAS,CAAC"}