@quilltap/plugin-types 1.13.0 → 1.14.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.14.0] - 2026-02-10
+
+### Added
+
+- New `SEARCH_PROVIDER` plugin capability type for pluggable web search backends
+- `SearchProviderPlugin` interface for implementing search provider plugins:
+  - `SearchProviderMetadata` — providerName, displayName, description, abbreviation, colors
+  - `SearchProviderConfigRequirements` — requiresApiKey, apiKeyLabel, requiresBaseUrl, baseUrlDefault
+  - `SearchResult` — title, url, snippet, publishedDate
+  - `SearchOutput` — success, results, error, totalFound, query
+  - `executeSearch()` — execute a web search query
+  - `formatResults()` — format results for LLM context
+  - `validateApiKey()` — optional API key validation
+  - `icon` — optional SVG icon data
+- `SearchProviderPluginExport` standard export type
+- `SearchProviderConfig` manifest configuration type for SEARCH_PROVIDER plugins
+- Exported all search provider types via `@quilltap/plugin-types` and `@quilltap/plugin-types/plugins`
+
 ## [1.12.0] - 2026-02-01
 
 ### Removed

package/dist/{index-Do00kvF1.d.ts → index-CaUSWXgG.d.ts}

@@ -457,7 +457,7 @@ interface ProviderPluginExport {
 /**
  * Plugin capability types
  */
-type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'TOOL_PROVIDER' | 'UTILITY';
+type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'TOOL_PROVIDER' | 'SEARCH_PROVIDER' | 'UTILITY';
 /**
  * Plugin category
  */
@@ -530,6 +530,33 @@ interface ProviderConfig {
         description: string;
     };
 }
+/**
+ * Search provider-specific configuration (for SEARCH_PROVIDER plugins)
+ */
+interface SearchProviderConfig {
+    /** Internal provider name (e.g., 'SERPER', 'BING') */
+    providerName: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Provider description */
+    description: string;
+    /** Short abbreviation (2-4 chars) */
+    abbreviation: string;
+    /** UI color configuration */
+    colors: {
+        bg: string;
+        text: string;
+        icon: string;
+    };
+    /** Whether the provider requires an API key */
+    requiresApiKey: boolean;
+    /** Label for API key input */
+    apiKeyLabel?: string;
+    /** Whether the provider requires a base URL */
+    requiresBaseUrl: boolean;
+    /** Default base URL */
+    baseUrlDefault?: string;
+}
 /**
  * Required permissions for the plugin
  */
@@ -586,6 +613,8 @@ interface PluginManifest {
     keywords?: string[];
     /** Provider-specific configuration (for LLM_PROVIDER plugins) */
     providerConfig?: ProviderConfig;
+    /** Search provider configuration (for SEARCH_PROVIDER plugins) */
+    searchProviderConfig?: SearchProviderConfig;
     /** Required permissions */
     permissions?: PluginPermissions;
     /** Repository URL */
@@ -1239,4 +1268,163 @@ interface RoleplayTemplatePluginExport {
     plugin: RoleplayTemplatePlugin;
 }
 
-export type { AttachmentSupport as A, ThemeTokens as B, CheapModelConfig as C, ToolFormatType as D, Effects as E, FontDefinition as F, Typography as G, AnnotationButton as H, IconProps as I, DialogueDetection as J, RenderingPattern as K, LLMProviderPlugin as L, MessageFormatSupport as M, PluginAuthor as P, RoleplayTemplateConfig as R, Spacing as S, ThemeMetadata as T, ColorPalette as a, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, PluginCapability as i, PluginCategory as j, PluginCompatibility as k, PluginIconData as l, PluginManifest as m, PluginPermissions as n, PluginStatus as o, ProviderCapabilities as p, ProviderConfig as q, ProviderConfigRequirements as r, ProviderMetadata as s, ProviderPluginExport as t, RoleplayTemplateMetadata as u, RoleplayTemplatePlugin as v, RoleplayTemplatePluginExport as w, SubsystemOverrides as x, ThemePlugin as y, ThemePluginExport as z };
+/**
+ * Search Provider Plugin types for Quilltap plugin development
+ *
+ * Defines the interfaces and types needed to create pluggable web search
+ * backends as Quilltap plugins (e.g., Serper, Bing, DuckDuckGo).
+ *
+ * @module @quilltap/plugin-types/plugins/search-provider
+ */
+
+/**
+ * Search provider metadata for UI display and identification
+ */
+interface SearchProviderMetadata {
+    /** Internal identifier for the search provider (e.g., 'SERPER', 'BING') */
+    providerName: string;
+    /** Human-readable display name for UI (e.g., 'Serper Web Search') */
+    displayName: string;
+    /** Short description of the search provider */
+    description: string;
+    /** Short abbreviation for icon display (e.g., 'SRP', 'BNG') */
+    abbreviation: string;
+    /** Tailwind CSS color classes for UI styling */
+    colors: {
+        /** Background color class (e.g., 'bg-blue-100') */
+        bg: string;
+        /** Text color class (e.g., 'text-blue-800') */
+        text: string;
+        /** Icon color class (e.g., 'text-blue-600') */
+        icon: string;
+    };
+}
+/**
+ * Configuration requirements for a search provider
+ */
+interface SearchProviderConfigRequirements {
+    /** Whether this search provider requires an API key */
+    requiresApiKey: boolean;
+    /** Label text for API key input field */
+    apiKeyLabel?: string;
+    /** Whether this search provider requires a custom base URL */
+    requiresBaseUrl: boolean;
+    /** Default value for base URL (if applicable) */
+    baseUrlDefault?: string;
+}
+/**
+ * A single web search result
+ */
+interface SearchResult {
+    /** Title of the search result */
+    title: string;
+    /** URL of the search result */
+    url: string;
+    /** Text snippet / summary of the result */
+    snippet: string;
+    /** Date the result was published (ISO string or human-readable) */
+    publishedDate?: string;
+}
+/**
+ * Output from a search provider execution
+ */
+interface SearchOutput {
+    /** Whether the search was successful */
+    success: boolean;
+    /** Array of search results (present when success is true) */
+    results?: SearchResult[];
+    /** Error message (present when success is false) */
+    error?: string;
+    /** Total number of results found */
+    totalFound: number;
+    /** The query that was searched */
+    query: string;
+}
+/**
+ * Main Search Provider Plugin Interface
+ *
+ * Plugins implementing this interface provide web search backends
+ * for Quilltap's `search_web` tool. The search tool remains a built-in
+ * tool, but its execution backend is pluggable via this interface.
+ *
+ * @example
+ * ```typescript
+ * import type { SearchProviderPlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: SearchProviderPlugin = {
+ *   metadata: {
+ *     providerName: 'SERPER',
+ *     displayName: 'Serper Web Search',
+ *     description: 'Google search via Serper.dev API',
+ *     abbreviation: 'SRP',
+ *     colors: { bg: 'bg-orange-100', text: 'text-orange-800', icon: 'text-orange-600' },
+ *   },
+ *   config: {
+ *     requiresApiKey: true,
+ *     apiKeyLabel: 'Serper API Key',
+ *     requiresBaseUrl: false,
+ *   },
+ *   executeSearch: async (query, maxResults, apiKey) => {
+ *     // ... call search API ...
+ *     return { success: true, results: [...], totalFound: 5, query };
+ *   },
+ *   formatResults: (results) => {
+ *     return results.map((r, i) => `[${i + 1}] ${r.title}: ${r.snippet}`).join('\n');
+ *   },
+ *   validateApiKey: async (apiKey) => {
+ *     // ... test API key ...
+ *     return true;
+ *   },
+ * };
+ * ```
+ */
+interface SearchProviderPlugin {
+    /** Search provider metadata for UI display and identification */
+    metadata: SearchProviderMetadata;
+    /** Configuration requirements for this search provider */
+    config: SearchProviderConfigRequirements;
+    /**
+     * Execute a web search query
+     *
+     * @param query The search query string
+     * @param maxResults Maximum number of results to return
+     * @param apiKey The API key for authentication
+     * @param baseUrl Optional base URL for the search API
+     * @returns Promise resolving to search output with results or error
+     */
+    executeSearch: (query: string, maxResults: number, apiKey: string, baseUrl?: string) => Promise<SearchOutput>;
+    /**
+     * Format search results for inclusion in LLM conversation context
+     *
+     * @param results Array of search results to format
+     * @returns Formatted string suitable for LLM context
+     */
+    formatResults: (results: SearchResult[]) => string;
+    /**
+     * Validate an API key for this search provider (optional)
+     *
+     * Should test the API key by making a minimal API call to verify
+     * that it is valid and has proper permissions.
+     *
+     * @param apiKey The API key to validate
+     * @param baseUrl Optional base URL for the search API
+     * @returns Promise resolving to true if valid, false otherwise
+     */
+    validateApiKey?: (apiKey: string, baseUrl?: string) => Promise<boolean>;
+    /**
+     * Search provider icon as SVG data (optional)
+     *
+     * Provides the icon as raw SVG data that Quilltap will render.
+     * If not provided, generates a default icon from the abbreviation.
+     */
+    icon?: PluginIconData;
+}
+/**
+ * Standard export type for search provider plugins
+ */
+interface SearchProviderPluginExport {
+    /** The search provider plugin instance */
+    plugin: SearchProviderPlugin;
+}
+
+export type { AttachmentSupport as A, SearchProviderPlugin as B, CheapModelConfig as C, SearchProviderPluginExport as D, Effects as E, FontDefinition as F, SearchResult as G, Spacing as H, IconProps as I, SubsystemOverrides as J, ThemePlugin as K, LLMProviderPlugin as L, MessageFormatSupport as M, ThemePluginExport as N, ThemeTokens as O, PluginAuthor as P, ToolFormatType as Q, RoleplayTemplateConfig as R, SearchOutput as S, ThemeMetadata as T, Typography as U, AnnotationButton as V, DialogueDetection as W, RenderingPattern as X, ColorPalette as a, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, PluginCapability as i, PluginCategory as j, PluginCompatibility as k, PluginIconData as l, PluginManifest as m, PluginPermissions as n, PluginStatus as o, ProviderCapabilities as p, ProviderConfig as q, ProviderConfigRequirements as r, ProviderMetadata as s, ProviderPluginExport as t, RoleplayTemplateMetadata as u, RoleplayTemplatePlugin as v, RoleplayTemplatePluginExport as w, SearchProviderConfig as x, SearchProviderConfigRequirements as y, SearchProviderMetadata as z };

package/dist/{index-CCXz-DhI.d.mts → index-xd0qDqzB.d.mts}

@@ -457,7 +457,7 @@ interface ProviderPluginExport {
 /**
  * Plugin capability types
  */
-type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'TOOL_PROVIDER' | 'UTILITY';
+type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'TOOL_PROVIDER' | 'SEARCH_PROVIDER' | 'UTILITY';
 /**
  * Plugin category
  */
@@ -530,6 +530,33 @@ interface ProviderConfig {
         description: string;
     };
 }
+/**
+ * Search provider-specific configuration (for SEARCH_PROVIDER plugins)
+ */
+interface SearchProviderConfig {
+    /** Internal provider name (e.g., 'SERPER', 'BING') */
+    providerName: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Provider description */
+    description: string;
+    /** Short abbreviation (2-4 chars) */
+    abbreviation: string;
+    /** UI color configuration */
+    colors: {
+        bg: string;
+        text: string;
+        icon: string;
+    };
+    /** Whether the provider requires an API key */
+    requiresApiKey: boolean;
+    /** Label for API key input */
+    apiKeyLabel?: string;
+    /** Whether the provider requires a base URL */
+    requiresBaseUrl: boolean;
+    /** Default base URL */
+    baseUrlDefault?: string;
+}
 /**
  * Required permissions for the plugin
  */
@@ -586,6 +613,8 @@ interface PluginManifest {
     keywords?: string[];
     /** Provider-specific configuration (for LLM_PROVIDER plugins) */
     providerConfig?: ProviderConfig;
+    /** Search provider configuration (for SEARCH_PROVIDER plugins) */
+    searchProviderConfig?: SearchProviderConfig;
     /** Required permissions */
     permissions?: PluginPermissions;
     /** Repository URL */
@@ -1239,4 +1268,163 @@ interface RoleplayTemplatePluginExport {
     plugin: RoleplayTemplatePlugin;
 }
 
-export type { AttachmentSupport as A, ThemeTokens as B, CheapModelConfig as C, ToolFormatType as D, Effects as E, FontDefinition as F, Typography as G, AnnotationButton as H, IconProps as I, DialogueDetection as J, RenderingPattern as K, LLMProviderPlugin as L, MessageFormatSupport as M, PluginAuthor as P, RoleplayTemplateConfig as R, Spacing as S, ThemeMetadata as T, ColorPalette as a, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, PluginCapability as i, PluginCategory as j, PluginCompatibility as k, PluginIconData as l, PluginManifest as m, PluginPermissions as n, PluginStatus as o, ProviderCapabilities as p, ProviderConfig as q, ProviderConfigRequirements as r, ProviderMetadata as s, ProviderPluginExport as t, RoleplayTemplateMetadata as u, RoleplayTemplatePlugin as v, RoleplayTemplatePluginExport as w, SubsystemOverrides as x, ThemePlugin as y, ThemePluginExport as z };
+/**
+ * Search Provider Plugin types for Quilltap plugin development
+ *
+ * Defines the interfaces and types needed to create pluggable web search
+ * backends as Quilltap plugins (e.g., Serper, Bing, DuckDuckGo).
+ *
+ * @module @quilltap/plugin-types/plugins/search-provider
+ */
+
+/**
+ * Search provider metadata for UI display and identification
+ */
+interface SearchProviderMetadata {
+    /** Internal identifier for the search provider (e.g., 'SERPER', 'BING') */
+    providerName: string;
+    /** Human-readable display name for UI (e.g., 'Serper Web Search') */
+    displayName: string;
+    /** Short description of the search provider */
+    description: string;
+    /** Short abbreviation for icon display (e.g., 'SRP', 'BNG') */
+    abbreviation: string;
+    /** Tailwind CSS color classes for UI styling */
+    colors: {
+        /** Background color class (e.g., 'bg-blue-100') */
+        bg: string;
+        /** Text color class (e.g., 'text-blue-800') */
+        text: string;
+        /** Icon color class (e.g., 'text-blue-600') */
+        icon: string;
+    };
+}
+/**
+ * Configuration requirements for a search provider
+ */
+interface SearchProviderConfigRequirements {
+    /** Whether this search provider requires an API key */
+    requiresApiKey: boolean;
+    /** Label text for API key input field */
+    apiKeyLabel?: string;
+    /** Whether this search provider requires a custom base URL */
+    requiresBaseUrl: boolean;
+    /** Default value for base URL (if applicable) */
+    baseUrlDefault?: string;
+}
+/**
+ * A single web search result
+ */
+interface SearchResult {
+    /** Title of the search result */
+    title: string;
+    /** URL of the search result */
+    url: string;
+    /** Text snippet / summary of the result */
+    snippet: string;
+    /** Date the result was published (ISO string or human-readable) */
+    publishedDate?: string;
+}
+/**
+ * Output from a search provider execution
+ */
+interface SearchOutput {
+    /** Whether the search was successful */
+    success: boolean;
+    /** Array of search results (present when success is true) */
+    results?: SearchResult[];
+    /** Error message (present when success is false) */
+    error?: string;
+    /** Total number of results found */
+    totalFound: number;
+    /** The query that was searched */
+    query: string;
+}
+/**
+ * Main Search Provider Plugin Interface
+ *
+ * Plugins implementing this interface provide web search backends
+ * for Quilltap's `search_web` tool. The search tool remains a built-in
+ * tool, but its execution backend is pluggable via this interface.
+ *
+ * @example
+ * ```typescript
+ * import type { SearchProviderPlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: SearchProviderPlugin = {
+ *   metadata: {
+ *     providerName: 'SERPER',
+ *     displayName: 'Serper Web Search',
+ *     description: 'Google search via Serper.dev API',
+ *     abbreviation: 'SRP',
+ *     colors: { bg: 'bg-orange-100', text: 'text-orange-800', icon: 'text-orange-600' },
+ *   },
+ *   config: {
+ *     requiresApiKey: true,
+ *     apiKeyLabel: 'Serper API Key',
+ *     requiresBaseUrl: false,
+ *   },
+ *   executeSearch: async (query, maxResults, apiKey) => {
+ *     // ... call search API ...
+ *     return { success: true, results: [...], totalFound: 5, query };
+ *   },
+ *   formatResults: (results) => {
+ *     return results.map((r, i) => `[${i + 1}] ${r.title}: ${r.snippet}`).join('\n');
+ *   },
+ *   validateApiKey: async (apiKey) => {
+ *     // ... test API key ...
+ *     return true;
+ *   },
+ * };
+ * ```
+ */
+interface SearchProviderPlugin {
+    /** Search provider metadata for UI display and identification */
+    metadata: SearchProviderMetadata;
+    /** Configuration requirements for this search provider */
+    config: SearchProviderConfigRequirements;
+    /**
+     * Execute a web search query
+     *
+     * @param query The search query string
+     * @param maxResults Maximum number of results to return
+     * @param apiKey The API key for authentication
+     * @param baseUrl Optional base URL for the search API
+     * @returns Promise resolving to search output with results or error
+     */
+    executeSearch: (query: string, maxResults: number, apiKey: string, baseUrl?: string) => Promise<SearchOutput>;
+    /**
+     * Format search results for inclusion in LLM conversation context
+     *
+     * @param results Array of search results to format
+     * @returns Formatted string suitable for LLM context
+     */
+    formatResults: (results: SearchResult[]) => string;
+    /**
+     * Validate an API key for this search provider (optional)
+     *
+     * Should test the API key by making a minimal API call to verify
+     * that it is valid and has proper permissions.
+     *
+     * @param apiKey The API key to validate
+     * @param baseUrl Optional base URL for the search API
+     * @returns Promise resolving to true if valid, false otherwise
+     */
+    validateApiKey?: (apiKey: string, baseUrl?: string) => Promise<boolean>;
+    /**
+     * Search provider icon as SVG data (optional)
+     *
+     * Provides the icon as raw SVG data that Quilltap will render.
+     * If not provided, generates a default icon from the abbreviation.
+     */
+    icon?: PluginIconData;
+}
+/**
+ * Standard export type for search provider plugins
+ */
+interface SearchProviderPluginExport {
+    /** The search provider plugin instance */
+    plugin: SearchProviderPlugin;
+}
+
+export type { AttachmentSupport as A, SearchProviderPlugin as B, CheapModelConfig as C, SearchProviderPluginExport as D, Effects as E, FontDefinition as F, SearchResult as G, Spacing as H, IconProps as I, SubsystemOverrides as J, ThemePlugin as K, LLMProviderPlugin as L, MessageFormatSupport as M, ThemePluginExport as N, ThemeTokens as O, PluginAuthor as P, ToolFormatType as Q, RoleplayTemplateConfig as R, SearchOutput as S, ThemeMetadata as T, Typography as U, AnnotationButton as V, DialogueDetection as W, RenderingPattern as X, ColorPalette as a, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, PluginCapability as i, PluginCategory as j, PluginCompatibility as k, PluginIconData as l, PluginManifest as m, PluginPermissions as n, PluginStatus as o, ProviderCapabilities as p, ProviderConfig as q, ProviderConfigRequirements as r, ProviderMetadata as s, ProviderPluginExport as t, RoleplayTemplateMetadata as u, RoleplayTemplatePlugin as v, RoleplayTemplatePluginExport as w, SearchProviderConfig as x, SearchProviderConfigRequirements as y, SearchProviderMetadata as z };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { UniversalTool } from './llm/index.mjs';
 export { AnthropicToolDefinition, AttachmentResults, CacheUsage, EmbeddingOptions, EmbeddingProvider, EmbeddingResult, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, LocalEmbeddingProvider, LocalEmbeddingProviderState, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, isLocalEmbeddingProvider } from './llm/index.mjs';
-export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, l as PluginIconData, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as Spacing, x as SubsystemOverrides, T as ThemeMetadata, y as ThemePlugin, z as ThemePluginExport, B as ThemeTokens, D as ToolFormatType, G as Typography } from './index-CCXz-DhI.mjs';
+export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, l as PluginIconData, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as SearchOutput, x as SearchProviderConfig, y as SearchProviderConfigRequirements, z as SearchProviderMetadata, B as SearchProviderPlugin, D as SearchProviderPluginExport, G as SearchResult, H as Spacing, J as SubsystemOverrides, T as ThemeMetadata, K as ThemePlugin, N as ThemePluginExport, O as ThemeTokens, Q as ToolFormatType, U as Typography } from './index-xd0qDqzB.mjs';
 import { Readable } from 'stream';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.mjs';
 
@@ -581,6 +581,6 @@ interface FileStoragePluginExport {
  * Version of the plugin-types package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_TYPES_VERSION = "1.13.0";
+declare const PLUGIN_TYPES_VERSION = "1.14.0";
 
 export { type FileBackendCapabilities, type FileBackendMetadata, type FileMetadata, type FileStorageBackend, type FileStorageConfigField, type FileStoragePluginExport, type FileStorageProviderPlugin, PLUGIN_TYPES_VERSION, type ToolExecutionContext, type ToolExecutionResult, type ToolHierarchyInfo, type ToolMetadata, type ToolPlugin, type ToolPluginExport, UniversalTool };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { UniversalTool } from './llm/index.js';
 export { AnthropicToolDefinition, AttachmentResults, CacheUsage, EmbeddingOptions, EmbeddingProvider, EmbeddingResult, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, LocalEmbeddingProvider, LocalEmbeddingProviderState, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, isLocalEmbeddingProvider } from './llm/index.js';
-export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, l as PluginIconData, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as Spacing, x as SubsystemOverrides, T as ThemeMetadata, y as ThemePlugin, z as ThemePluginExport, B as ThemeTokens, D as ToolFormatType, G as Typography } from './index-Do00kvF1.js';
+export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, l as PluginIconData, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as SearchOutput, x as SearchProviderConfig, y as SearchProviderConfigRequirements, z as SearchProviderMetadata, B as SearchProviderPlugin, D as SearchProviderPluginExport, G as SearchResult, H as Spacing, J as SubsystemOverrides, T as ThemeMetadata, K as ThemePlugin, N as ThemePluginExport, O as ThemeTokens, Q as ToolFormatType, U as Typography } from './index-CaUSWXgG.js';
 import { Readable } from 'stream';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.js';
 
@@ -581,6 +581,6 @@ interface FileStoragePluginExport {
  * Version of the plugin-types package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_TYPES_VERSION = "1.13.0";
+declare const PLUGIN_TYPES_VERSION = "1.14.0";
 
 export { type FileBackendCapabilities, type FileBackendMetadata, type FileMetadata, type FileStorageBackend, type FileStorageConfigField, type FileStoragePluginExport, type FileStorageProviderPlugin, PLUGIN_TYPES_VERSION, type ToolExecutionContext, type ToolExecutionResult, type ToolHierarchyInfo, type ToolMetadata, type ToolPlugin, type ToolPluginExport, UniversalTool };

package/dist/index.js

@@ -112,7 +112,7 @@ function createNoopLogger() {
 }
 
 // src/index.ts
-var PLUGIN_TYPES_VERSION = "1.13.0";
+var PLUGIN_TYPES_VERSION = "1.14.0";
 
 exports.ApiKeyError = ApiKeyError;
 exports.AttachmentError = AttachmentError;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/llm/embeddings.ts","../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Embedding Provider Types for Quilltap plugin development\n *\n * Defines interfaces for embedding providers that can be implemented\n * by plugins to provide text-to-vector embedding functionality.\n *\n * @module @quilltap/plugin-types/llm/embeddings\n */\n\n/**\n * Result of an embedding operation\n */\nexport interface EmbeddingResult {\n  /** The embedding vector (array of floating point numbers) */\n  embedding: number[];\n  /** The model used to generate the embedding */\n  model: string;\n  /** Number of dimensions in the embedding vector */\n  dimensions: number;\n  /** Token usage information (if available) */\n  usage?: {\n    promptTokens: number;\n    totalTokens: number;\n    cost?: number;\n  };\n}\n\n/**\n * Options for embedding generation\n */\nexport interface EmbeddingOptions {\n  /** Desired dimensions for the embedding (if model supports variable dimensions) */\n  dimensions?: number;\n}\n\n/**\n * Standard embedding provider interface\n *\n * This is the base interface for all embedding providers that use\n * external APIs (OpenAI, Ollama, OpenRouter, etc.)\n */\nexport interface EmbeddingProvider {\n  /**\n   * Generate an embedding for a single text\n   *\n   * @param text The text to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns The embedding result\n   */\n  generateEmbedding(\n    text: string,\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult>;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings?(\n    texts: string[],\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult[]>;\n\n  /**\n   * Get available embedding models\n   *\n   * @param apiKey The API key for authentication\n   * @returns Array of model IDs\n   */\n  getAvailableModels?(apiKey: string): Promise<string[]>;\n\n  /**\n   * Check if the provider is available and properly configured\n   *\n   * @param apiKey Optional API key to validate\n   * @returns True if the provider is ready to use\n   */\n  isAvailable?(apiKey?: string): Promise<boolean>;\n}\n\n/**\n * Serializable state for local embedding providers\n *\n * Used by providers like TF-IDF that maintain vocabulary state\n */\nexport interface LocalEmbeddingProviderState {\n  /** The vocabulary as an array of [term, index] pairs */\n  vocabulary: [string, number][];\n  /** The IDF (Inverse Document Frequency) weights */\n  idf: number[];\n  /** Average document length across the corpus */\n  avgDocLength: number;\n  /** Size of the vocabulary */\n  vocabularySize: number;\n  /** Whether bigrams are included in the vocabulary */\n  includeBigrams: boolean;\n  /** Timestamp when the vocabulary was fitted */\n  fittedAt: string;\n}\n\n/**\n * Local embedding provider interface\n *\n * Extended interface for local/offline embedding providers that\n * maintain vocabulary state (like TF-IDF). These providers don't\n * require API keys and can work entirely offline.\n */\nexport interface LocalEmbeddingProvider extends Omit<EmbeddingProvider, 'generateEmbedding' | 'generateBatchEmbeddings'> {\n  /**\n   * Generate an embedding for a single text\n   * Local providers don't need apiKey parameter\n   *\n   * @param text The text to embed\n   * @returns The embedding result\n   */\n  generateEmbedding(text: string): EmbeddingResult;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings(texts: string[]): EmbeddingResult[];\n\n  /**\n   * Fit the vocabulary on a corpus of documents\n   *\n   * This method analyzes the corpus to build vocabulary, calculate IDF weights,\n   * and other statistics needed for embedding generation.\n   *\n   * @param documents Array of text documents to analyze\n   */\n  fitCorpus(documents: string[]): void;\n\n  /**\n   * Check if the vocabulary has been fitted\n   *\n   * @returns True if fitCorpus has been called with documents\n   */\n  isFitted(): boolean;\n\n  /**\n   * Load state from a serialized representation\n   *\n   * @param state The serialized provider state\n   */\n  loadState(state: LocalEmbeddingProviderState): void;\n\n  /**\n   * Get the current state for serialization\n   *\n   * @returns The provider state, or null if not fitted\n   */\n  getState(): LocalEmbeddingProviderState | null;\n\n  /**\n   * Get the vocabulary size\n   *\n   * @returns Number of terms in the vocabulary\n   */\n  getVocabularySize(): number;\n\n  /**\n   * Get the embedding dimensions\n   *\n   * @returns Number of dimensions in generated embeddings\n   */\n  getDimensions(): number;\n}\n\n/**\n * Type guard to check if a provider is a local embedding provider\n */\nexport function isLocalEmbeddingProvider(\n  provider: EmbeddingProvider | LocalEmbeddingProvider\n): provider is LocalEmbeddingProvider {\n  return 'fitCorpus' in provider && 'loadState' in provider && 'getState' in provider;\n}\n","/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\nexport type {\n  // Embedding types\n  EmbeddingResult,\n  EmbeddingOptions,\n  EmbeddingProvider,\n  LocalEmbeddingProviderState,\n  LocalEmbeddingProvider,\n} from './llm/embeddings';\n\nexport { isLocalEmbeddingProvider } from './llm/embeddings';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageStyleInfo,\n  ImageProviderConstraints,\n  IconProps,\n  PluginIconData,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\nexport type {\n  // Theme plugin types\n  ColorPalette,\n  Typography,\n  Spacing,\n  Effects,\n  ThemeTokens,\n  FontDefinition,\n  EmbeddedFont,\n  ThemeMetadata,\n  SubsystemOverrides,\n  ThemePlugin,\n  ThemePluginExport,\n} from './plugins/theme';\n\nexport type {\n  // Roleplay template plugin types\n  RoleplayTemplateConfig,\n  RoleplayTemplateMetadata,\n  RoleplayTemplatePlugin,\n  RoleplayTemplatePluginExport,\n} from './plugins/roleplay-template';\n\nexport type {\n  // Tool plugin types\n  ToolMetadata,\n  ToolHierarchyInfo,\n  ToolExecutionContext,\n  ToolExecutionResult,\n  ToolPlugin,\n  ToolPluginExport,\n} from './plugins/tool';\n\nexport type {\n  // File storage plugin types\n  FileBackendCapabilities,\n  FileBackendMetadata,\n  FileMetadata,\n  FileStorageBackend,\n  FileStorageConfigField,\n  FileStorageProviderPlugin,\n  FileStoragePluginExport,\n} from './plugins/file-storage';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.13.0';\n"]}
+{"version":3,"sources":["../src/llm/embeddings.ts","../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Embedding Provider Types for Quilltap plugin development\n *\n * Defines interfaces for embedding providers that can be implemented\n * by plugins to provide text-to-vector embedding functionality.\n *\n * @module @quilltap/plugin-types/llm/embeddings\n */\n\n/**\n * Result of an embedding operation\n */\nexport interface EmbeddingResult {\n  /** The embedding vector (array of floating point numbers) */\n  embedding: number[];\n  /** The model used to generate the embedding */\n  model: string;\n  /** Number of dimensions in the embedding vector */\n  dimensions: number;\n  /** Token usage information (if available) */\n  usage?: {\n    promptTokens: number;\n    totalTokens: number;\n    cost?: number;\n  };\n}\n\n/**\n * Options for embedding generation\n */\nexport interface EmbeddingOptions {\n  /** Desired dimensions for the embedding (if model supports variable dimensions) */\n  dimensions?: number;\n}\n\n/**\n * Standard embedding provider interface\n *\n * This is the base interface for all embedding providers that use\n * external APIs (OpenAI, Ollama, OpenRouter, etc.)\n */\nexport interface EmbeddingProvider {\n  /**\n   * Generate an embedding for a single text\n   *\n   * @param text The text to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns The embedding result\n   */\n  generateEmbedding(\n    text: string,\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult>;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings?(\n    texts: string[],\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult[]>;\n\n  /**\n   * Get available embedding models\n   *\n   * @param apiKey The API key for authentication\n   * @returns Array of model IDs\n   */\n  getAvailableModels?(apiKey: string): Promise<string[]>;\n\n  /**\n   * Check if the provider is available and properly configured\n   *\n   * @param apiKey Optional API key to validate\n   * @returns True if the provider is ready to use\n   */\n  isAvailable?(apiKey?: string): Promise<boolean>;\n}\n\n/**\n * Serializable state for local embedding providers\n *\n * Used by providers like TF-IDF that maintain vocabulary state\n */\nexport interface LocalEmbeddingProviderState {\n  /** The vocabulary as an array of [term, index] pairs */\n  vocabulary: [string, number][];\n  /** The IDF (Inverse Document Frequency) weights */\n  idf: number[];\n  /** Average document length across the corpus */\n  avgDocLength: number;\n  /** Size of the vocabulary */\n  vocabularySize: number;\n  /** Whether bigrams are included in the vocabulary */\n  includeBigrams: boolean;\n  /** Timestamp when the vocabulary was fitted */\n  fittedAt: string;\n}\n\n/**\n * Local embedding provider interface\n *\n * Extended interface for local/offline embedding providers that\n * maintain vocabulary state (like TF-IDF). These providers don't\n * require API keys and can work entirely offline.\n */\nexport interface LocalEmbeddingProvider extends Omit<EmbeddingProvider, 'generateEmbedding' | 'generateBatchEmbeddings'> {\n  /**\n   * Generate an embedding for a single text\n   * Local providers don't need apiKey parameter\n   *\n   * @param text The text to embed\n   * @returns The embedding result\n   */\n  generateEmbedding(text: string): EmbeddingResult;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings(texts: string[]): EmbeddingResult[];\n\n  /**\n   * Fit the vocabulary on a corpus of documents\n   *\n   * This method analyzes the corpus to build vocabulary, calculate IDF weights,\n   * and other statistics needed for embedding generation.\n   *\n   * @param documents Array of text documents to analyze\n   */\n  fitCorpus(documents: string[]): void;\n\n  /**\n   * Check if the vocabulary has been fitted\n   *\n   * @returns True if fitCorpus has been called with documents\n   */\n  isFitted(): boolean;\n\n  /**\n   * Load state from a serialized representation\n   *\n   * @param state The serialized provider state\n   */\n  loadState(state: LocalEmbeddingProviderState): void;\n\n  /**\n   * Get the current state for serialization\n   *\n   * @returns The provider state, or null if not fitted\n   */\n  getState(): LocalEmbeddingProviderState | null;\n\n  /**\n   * Get the vocabulary size\n   *\n   * @returns Number of terms in the vocabulary\n   */\n  getVocabularySize(): number;\n\n  /**\n   * Get the embedding dimensions\n   *\n   * @returns Number of dimensions in generated embeddings\n   */\n  getDimensions(): number;\n}\n\n/**\n * Type guard to check if a provider is a local embedding provider\n */\nexport function isLocalEmbeddingProvider(\n  provider: EmbeddingProvider | LocalEmbeddingProvider\n): provider is LocalEmbeddingProvider {\n  return 'fitCorpus' in provider && 'loadState' in provider && 'getState' in provider;\n}\n","/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\nexport type {\n  // Embedding types\n  EmbeddingResult,\n  EmbeddingOptions,\n  EmbeddingProvider,\n  LocalEmbeddingProviderState,\n  LocalEmbeddingProvider,\n} from './llm/embeddings';\n\nexport { isLocalEmbeddingProvider } from './llm/embeddings';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageStyleInfo,\n  ImageProviderConstraints,\n  IconProps,\n  PluginIconData,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  SearchProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\nexport type {\n  // Theme plugin types\n  ColorPalette,\n  Typography,\n  Spacing,\n  Effects,\n  ThemeTokens,\n  FontDefinition,\n  EmbeddedFont,\n  ThemeMetadata,\n  SubsystemOverrides,\n  ThemePlugin,\n  ThemePluginExport,\n} from './plugins/theme';\n\nexport type {\n  // Roleplay template plugin types\n  RoleplayTemplateConfig,\n  RoleplayTemplateMetadata,\n  RoleplayTemplatePlugin,\n  RoleplayTemplatePluginExport,\n} from './plugins/roleplay-template';\n\nexport type {\n  // Tool plugin types\n  ToolMetadata,\n  ToolHierarchyInfo,\n  ToolExecutionContext,\n  ToolExecutionResult,\n  ToolPlugin,\n  ToolPluginExport,\n} from './plugins/tool';\n\nexport type {\n  // File storage plugin types\n  FileBackendCapabilities,\n  FileBackendMetadata,\n  FileMetadata,\n  FileStorageBackend,\n  FileStorageConfigField,\n  FileStorageProviderPlugin,\n  FileStoragePluginExport,\n} from './plugins/file-storage';\n\nexport type {\n  // Search provider plugin types\n  SearchProviderMetadata,\n  SearchProviderConfigRequirements,\n  SearchResult,\n  SearchOutput,\n  SearchProviderPlugin,\n  SearchProviderPluginExport,\n} from './plugins/search-provider';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.14.0';\n"]}

package/dist/index.mjs

@@ -110,7 +110,7 @@ function createNoopLogger() {
 }
 
 // src/index.ts
-var PLUGIN_TYPES_VERSION = "1.13.0";
+var PLUGIN_TYPES_VERSION = "1.14.0";
 
 export { ApiKeyError, AttachmentError, ConfigurationError, ModelNotFoundError, PLUGIN_TYPES_VERSION, PluginError, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger, isLocalEmbeddingProvider };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/llm/embeddings.ts","../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Embedding Provider Types for Quilltap plugin development\n *\n * Defines interfaces for embedding providers that can be implemented\n * by plugins to provide text-to-vector embedding functionality.\n *\n * @module @quilltap/plugin-types/llm/embeddings\n */\n\n/**\n * Result of an embedding operation\n */\nexport interface EmbeddingResult {\n  /** The embedding vector (array of floating point numbers) */\n  embedding: number[];\n  /** The model used to generate the embedding */\n  model: string;\n  /** Number of dimensions in the embedding vector */\n  dimensions: number;\n  /** Token usage information (if available) */\n  usage?: {\n    promptTokens: number;\n    totalTokens: number;\n    cost?: number;\n  };\n}\n\n/**\n * Options for embedding generation\n */\nexport interface EmbeddingOptions {\n  /** Desired dimensions for the embedding (if model supports variable dimensions) */\n  dimensions?: number;\n}\n\n/**\n * Standard embedding provider interface\n *\n * This is the base interface for all embedding providers that use\n * external APIs (OpenAI, Ollama, OpenRouter, etc.)\n */\nexport interface EmbeddingProvider {\n  /**\n   * Generate an embedding for a single text\n   *\n   * @param text The text to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns The embedding result\n   */\n  generateEmbedding(\n    text: string,\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult>;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings?(\n    texts: string[],\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult[]>;\n\n  /**\n   * Get available embedding models\n   *\n   * @param apiKey The API key for authentication\n   * @returns Array of model IDs\n   */\n  getAvailableModels?(apiKey: string): Promise<string[]>;\n\n  /**\n   * Check if the provider is available and properly configured\n   *\n   * @param apiKey Optional API key to validate\n   * @returns True if the provider is ready to use\n   */\n  isAvailable?(apiKey?: string): Promise<boolean>;\n}\n\n/**\n * Serializable state for local embedding providers\n *\n * Used by providers like TF-IDF that maintain vocabulary state\n */\nexport interface LocalEmbeddingProviderState {\n  /** The vocabulary as an array of [term, index] pairs */\n  vocabulary: [string, number][];\n  /** The IDF (Inverse Document Frequency) weights */\n  idf: number[];\n  /** Average document length across the corpus */\n  avgDocLength: number;\n  /** Size of the vocabulary */\n  vocabularySize: number;\n  /** Whether bigrams are included in the vocabulary */\n  includeBigrams: boolean;\n  /** Timestamp when the vocabulary was fitted */\n  fittedAt: string;\n}\n\n/**\n * Local embedding provider interface\n *\n * Extended interface for local/offline embedding providers that\n * maintain vocabulary state (like TF-IDF). These providers don't\n * require API keys and can work entirely offline.\n */\nexport interface LocalEmbeddingProvider extends Omit<EmbeddingProvider, 'generateEmbedding' | 'generateBatchEmbeddings'> {\n  /**\n   * Generate an embedding for a single text\n   * Local providers don't need apiKey parameter\n   *\n   * @param text The text to embed\n   * @returns The embedding result\n   */\n  generateEmbedding(text: string): EmbeddingResult;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings(texts: string[]): EmbeddingResult[];\n\n  /**\n   * Fit the vocabulary on a corpus of documents\n   *\n   * This method analyzes the corpus to build vocabulary, calculate IDF weights,\n   * and other statistics needed for embedding generation.\n   *\n   * @param documents Array of text documents to analyze\n   */\n  fitCorpus(documents: string[]): void;\n\n  /**\n   * Check if the vocabulary has been fitted\n   *\n   * @returns True if fitCorpus has been called with documents\n   */\n  isFitted(): boolean;\n\n  /**\n   * Load state from a serialized representation\n   *\n   * @param state The serialized provider state\n   */\n  loadState(state: LocalEmbeddingProviderState): void;\n\n  /**\n   * Get the current state for serialization\n   *\n   * @returns The provider state, or null if not fitted\n   */\n  getState(): LocalEmbeddingProviderState | null;\n\n  /**\n   * Get the vocabulary size\n   *\n   * @returns Number of terms in the vocabulary\n   */\n  getVocabularySize(): number;\n\n  /**\n   * Get the embedding dimensions\n   *\n   * @returns Number of dimensions in generated embeddings\n   */\n  getDimensions(): number;\n}\n\n/**\n * Type guard to check if a provider is a local embedding provider\n */\nexport function isLocalEmbeddingProvider(\n  provider: EmbeddingProvider | LocalEmbeddingProvider\n): provider is LocalEmbeddingProvider {\n  return 'fitCorpus' in provider && 'loadState' in provider && 'getState' in provider;\n}\n","/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\nexport type {\n  // Embedding types\n  EmbeddingResult,\n  EmbeddingOptions,\n  EmbeddingProvider,\n  LocalEmbeddingProviderState,\n  LocalEmbeddingProvider,\n} from './llm/embeddings';\n\nexport { isLocalEmbeddingProvider } from './llm/embeddings';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageStyleInfo,\n  ImageProviderConstraints,\n  IconProps,\n  PluginIconData,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\nexport type {\n  // Theme plugin types\n  ColorPalette,\n  Typography,\n  Spacing,\n  Effects,\n  ThemeTokens,\n  FontDefinition,\n  EmbeddedFont,\n  ThemeMetadata,\n  SubsystemOverrides,\n  ThemePlugin,\n  ThemePluginExport,\n} from './plugins/theme';\n\nexport type {\n  // Roleplay template plugin types\n  RoleplayTemplateConfig,\n  RoleplayTemplateMetadata,\n  RoleplayTemplatePlugin,\n  RoleplayTemplatePluginExport,\n} from './plugins/roleplay-template';\n\nexport type {\n  // Tool plugin types\n  ToolMetadata,\n  ToolHierarchyInfo,\n  ToolExecutionContext,\n  ToolExecutionResult,\n  ToolPlugin,\n  ToolPluginExport,\n} from './plugins/tool';\n\nexport type {\n  // File storage plugin types\n  FileBackendCapabilities,\n  FileBackendMetadata,\n  FileMetadata,\n  FileStorageBackend,\n  FileStorageConfigField,\n  FileStorageProviderPlugin,\n  FileStoragePluginExport,\n} from './plugins/file-storage';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.13.0';\n"]}
+{"version":3,"sources":["../src/llm/embeddings.ts","../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Embedding Provider Types for Quilltap plugin development\n *\n * Defines interfaces for embedding providers that can be implemented\n * by plugins to provide text-to-vector embedding functionality.\n *\n * @module @quilltap/plugin-types/llm/embeddings\n */\n\n/**\n * Result of an embedding operation\n */\nexport interface EmbeddingResult {\n  /** The embedding vector (array of floating point numbers) */\n  embedding: number[];\n  /** The model used to generate the embedding */\n  model: string;\n  /** Number of dimensions in the embedding vector */\n  dimensions: number;\n  /** Token usage information (if available) */\n  usage?: {\n    promptTokens: number;\n    totalTokens: number;\n    cost?: number;\n  };\n}\n\n/**\n * Options for embedding generation\n */\nexport interface EmbeddingOptions {\n  /** Desired dimensions for the embedding (if model supports variable dimensions) */\n  dimensions?: number;\n}\n\n/**\n * Standard embedding provider interface\n *\n * This is the base interface for all embedding providers that use\n * external APIs (OpenAI, Ollama, OpenRouter, etc.)\n */\nexport interface EmbeddingProvider {\n  /**\n   * Generate an embedding for a single text\n   *\n   * @param text The text to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns The embedding result\n   */\n  generateEmbedding(\n    text: string,\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult>;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @param model The model to use\n   * @param apiKey The API key for authentication\n   * @param options Optional configuration\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings?(\n    texts: string[],\n    model: string,\n    apiKey: string,\n    options?: EmbeddingOptions\n  ): Promise<EmbeddingResult[]>;\n\n  /**\n   * Get available embedding models\n   *\n   * @param apiKey The API key for authentication\n   * @returns Array of model IDs\n   */\n  getAvailableModels?(apiKey: string): Promise<string[]>;\n\n  /**\n   * Check if the provider is available and properly configured\n   *\n   * @param apiKey Optional API key to validate\n   * @returns True if the provider is ready to use\n   */\n  isAvailable?(apiKey?: string): Promise<boolean>;\n}\n\n/**\n * Serializable state for local embedding providers\n *\n * Used by providers like TF-IDF that maintain vocabulary state\n */\nexport interface LocalEmbeddingProviderState {\n  /** The vocabulary as an array of [term, index] pairs */\n  vocabulary: [string, number][];\n  /** The IDF (Inverse Document Frequency) weights */\n  idf: number[];\n  /** Average document length across the corpus */\n  avgDocLength: number;\n  /** Size of the vocabulary */\n  vocabularySize: number;\n  /** Whether bigrams are included in the vocabulary */\n  includeBigrams: boolean;\n  /** Timestamp when the vocabulary was fitted */\n  fittedAt: string;\n}\n\n/**\n * Local embedding provider interface\n *\n * Extended interface for local/offline embedding providers that\n * maintain vocabulary state (like TF-IDF). These providers don't\n * require API keys and can work entirely offline.\n */\nexport interface LocalEmbeddingProvider extends Omit<EmbeddingProvider, 'generateEmbedding' | 'generateBatchEmbeddings'> {\n  /**\n   * Generate an embedding for a single text\n   * Local providers don't need apiKey parameter\n   *\n   * @param text The text to embed\n   * @returns The embedding result\n   */\n  generateEmbedding(text: string): EmbeddingResult;\n\n  /**\n   * Generate embeddings for multiple texts in a batch\n   *\n   * @param texts Array of texts to embed\n   * @returns Array of embedding results\n   */\n  generateBatchEmbeddings(texts: string[]): EmbeddingResult[];\n\n  /**\n   * Fit the vocabulary on a corpus of documents\n   *\n   * This method analyzes the corpus to build vocabulary, calculate IDF weights,\n   * and other statistics needed for embedding generation.\n   *\n   * @param documents Array of text documents to analyze\n   */\n  fitCorpus(documents: string[]): void;\n\n  /**\n   * Check if the vocabulary has been fitted\n   *\n   * @returns True if fitCorpus has been called with documents\n   */\n  isFitted(): boolean;\n\n  /**\n   * Load state from a serialized representation\n   *\n   * @param state The serialized provider state\n   */\n  loadState(state: LocalEmbeddingProviderState): void;\n\n  /**\n   * Get the current state for serialization\n   *\n   * @returns The provider state, or null if not fitted\n   */\n  getState(): LocalEmbeddingProviderState | null;\n\n  /**\n   * Get the vocabulary size\n   *\n   * @returns Number of terms in the vocabulary\n   */\n  getVocabularySize(): number;\n\n  /**\n   * Get the embedding dimensions\n   *\n   * @returns Number of dimensions in generated embeddings\n   */\n  getDimensions(): number;\n}\n\n/**\n * Type guard to check if a provider is a local embedding provider\n */\nexport function isLocalEmbeddingProvider(\n  provider: EmbeddingProvider | LocalEmbeddingProvider\n): provider is LocalEmbeddingProvider {\n  return 'fitCorpus' in provider && 'loadState' in provider && 'getState' in provider;\n}\n","/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\nexport type {\n  // Embedding types\n  EmbeddingResult,\n  EmbeddingOptions,\n  EmbeddingProvider,\n  LocalEmbeddingProviderState,\n  LocalEmbeddingProvider,\n} from './llm/embeddings';\n\nexport { isLocalEmbeddingProvider } from './llm/embeddings';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageStyleInfo,\n  ImageProviderConstraints,\n  IconProps,\n  PluginIconData,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  SearchProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\nexport type {\n  // Theme plugin types\n  ColorPalette,\n  Typography,\n  Spacing,\n  Effects,\n  ThemeTokens,\n  FontDefinition,\n  EmbeddedFont,\n  ThemeMetadata,\n  SubsystemOverrides,\n  ThemePlugin,\n  ThemePluginExport,\n} from './plugins/theme';\n\nexport type {\n  // Roleplay template plugin types\n  RoleplayTemplateConfig,\n  RoleplayTemplateMetadata,\n  RoleplayTemplatePlugin,\n  RoleplayTemplatePluginExport,\n} from './plugins/roleplay-template';\n\nexport type {\n  // Tool plugin types\n  ToolMetadata,\n  ToolHierarchyInfo,\n  ToolExecutionContext,\n  ToolExecutionResult,\n  ToolPlugin,\n  ToolPluginExport,\n} from './plugins/tool';\n\nexport type {\n  // File storage plugin types\n  FileBackendCapabilities,\n  FileBackendMetadata,\n  FileMetadata,\n  FileStorageBackend,\n  FileStorageConfigField,\n  FileStorageProviderPlugin,\n  FileStoragePluginExport,\n} from './plugins/file-storage';\n\nexport type {\n  // Search provider plugin types\n  SearchProviderMetadata,\n  SearchProviderConfigRequirements,\n  SearchResult,\n  SearchOutput,\n  SearchProviderPlugin,\n  SearchProviderPluginExport,\n} from './plugins/search-provider';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.14.0';\n"]}

package/dist/plugins/index.d.mts

@@ -1,2 +1,2 @@
-export { H as AnnotationButton, A as AttachmentSupport, a as ColorPalette, J as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, K as RenderingPattern, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as Spacing, T as ThemeMetadata, y as ThemePlugin, z as ThemePluginExport, B as ThemeTokens, G as Typography } from '../index-CCXz-DhI.mjs';
+export { V as AnnotationButton, A as AttachmentSupport, a as ColorPalette, W as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, X as RenderingPattern, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as SearchOutput, x as SearchProviderConfig, y as SearchProviderConfigRequirements, z as SearchProviderMetadata, B as SearchProviderPlugin, D as SearchProviderPluginExport, G as SearchResult, H as Spacing, T as ThemeMetadata, K as ThemePlugin, N as ThemePluginExport, O as ThemeTokens, U as Typography } from '../index-xd0qDqzB.mjs';
 import '../llm/index.mjs';

package/dist/plugins/index.d.ts

@@ -1,2 +1,2 @@
-export { H as AnnotationButton, A as AttachmentSupport, a as ColorPalette, J as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, K as RenderingPattern, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as Spacing, T as ThemeMetadata, y as ThemePlugin, z as ThemePluginExport, B as ThemeTokens, G as Typography } from '../index-Do00kvF1.js';
+export { V as AnnotationButton, A as AttachmentSupport, a as ColorPalette, W as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, P as PluginAuthor, i as PluginCapability, j as PluginCategory, k as PluginCompatibility, m as PluginManifest, n as PluginPermissions, o as PluginStatus, p as ProviderCapabilities, q as ProviderConfig, r as ProviderConfigRequirements, s as ProviderMetadata, t as ProviderPluginExport, X as RenderingPattern, R as RoleplayTemplateConfig, u as RoleplayTemplateMetadata, v as RoleplayTemplatePlugin, w as RoleplayTemplatePluginExport, S as SearchOutput, x as SearchProviderConfig, y as SearchProviderConfigRequirements, z as SearchProviderMetadata, B as SearchProviderPlugin, D as SearchProviderPluginExport, G as SearchResult, H as Spacing, T as ThemeMetadata, K as ThemePlugin, N as ThemePluginExport, O as ThemeTokens, U as Typography } from '../index-CaUSWXgG.js';
 import '../llm/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quilltap/plugin-types",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Type definitions for Quilltap plugin development",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",