@quilltap/plugin-types 1.9.3 → 1.9.4

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.9.4] - 2026-01-30
+
+### Added
+
+- New embedding provider types for building embedding plugins:
+  - `EmbeddingResult` - Result of an embedding operation (vector, model, dimensions, usage)
+  - `EmbeddingOptions` - Options for embedding generation (dimensions)
+  - `EmbeddingProvider` - Interface for API-based embedding providers (OpenAI, Ollama, etc.)
+  - `LocalEmbeddingProvider` - Extended interface for local/offline providers like TF-IDF
+  - `LocalEmbeddingProviderState` - Serializable state for local providers (vocabulary, IDF, etc.)
+  - `isLocalEmbeddingProvider` - Type guard function to detect local providers
+- Updated `createEmbeddingProvider` method on `LLMProviderPlugin` to return proper typed interface
+  - Now returns `EmbeddingProvider | LocalEmbeddingProvider` instead of `unknown`
+
 ## [1.9.2] - 2026-01-27
 
 ### Changed

package/dist/{index-DtgwAg2x.d.mts → index-BtYmDARk.d.mts}

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { LLMProvider, ImageGenProvider, ToolFormatOptions, ToolCallRequest } from './llm/index.mjs';
+import { LLMProvider, ImageGenProvider, EmbeddingProvider, LocalEmbeddingProvider, ToolFormatOptions, ToolCallRequest } from './llm/index.mjs';
 
 /**
  * Provider Plugin Interface types for Quilltap plugin development
@@ -254,8 +254,9 @@ interface LLMProviderPlugin {
      * Factory method to create an embedding provider (optional)
      * Only required if capabilities.embeddings is true
      * @param baseUrl Optional base URL for the provider
+     * @returns EmbeddingProvider for API-based providers, LocalEmbeddingProvider for local providers
      */
-    createEmbeddingProvider?: (baseUrl?: string) => unknown;
+    createEmbeddingProvider?: (baseUrl?: string) => EmbeddingProvider | LocalEmbeddingProvider;
     /**
      * Get list of available models for this provider
      * @param apiKey API key for authentication
@@ -1096,4 +1097,4 @@ interface RoleplayTemplatePluginExport {
     plugin: RoleplayTemplatePlugin;
 }
 
-export type { AttachmentSupport as A, AnnotationButton as B, CheapModelConfig as C, RenderingPattern as D, EmbeddingModelInfo as E, FontDefinition as F, DialogueDetection as G, ImageGenerationModelInfo as I, LLMProviderPlugin as L, ModelInfo as M, ProviderMetadata as P, RoleplayTemplateConfig as R, Spacing as S, ToolFormatType as T, ProviderConfigRequirements as a, ProviderCapabilities as b, ImageProviderConstraints as c, IconProps as d, ProviderPluginExport as e, MessageFormatSupport as f, PluginCapability as g, PluginCategory as h, PluginStatus as i, PluginAuthor as j, PluginCompatibility as k, ProviderConfig as l, PluginPermissions as m, PluginManifest as n, InstalledPluginInfo as o, ColorPalette as p, Typography as q, Effects as r, ThemeTokens as s, EmbeddedFont as t, ThemeMetadata as u, ThemePlugin as v, ThemePluginExport as w, RoleplayTemplateMetadata as x, RoleplayTemplatePlugin as y, RoleplayTemplatePluginExport as z };
+export type { AttachmentSupport as A, AnnotationButton as B, CheapModelConfig as C, DialogueDetection as D, Effects as E, FontDefinition as F, RenderingPattern as G, IconProps as I, 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, InstalledPluginInfo as f, ModelInfo as g, PluginCapability as h, PluginCategory as i, PluginCompatibility as j, PluginManifest as k, PluginPermissions as l, PluginStatus as m, ProviderCapabilities as n, ProviderConfig as o, ProviderConfigRequirements as p, ProviderMetadata as q, ProviderPluginExport as r, RoleplayTemplateMetadata as s, RoleplayTemplatePlugin as t, RoleplayTemplatePluginExport as u, ThemePlugin as v, ThemePluginExport as w, ThemeTokens as x, ToolFormatType as y, Typography as z };

package/dist/{index-3BT4ld_f.d.ts → index-CAtQduAS.d.ts}

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { LLMProvider, ImageGenProvider, ToolFormatOptions, ToolCallRequest } from './llm/index.js';
+import { LLMProvider, ImageGenProvider, EmbeddingProvider, LocalEmbeddingProvider, ToolFormatOptions, ToolCallRequest } from './llm/index.js';
 
 /**
  * Provider Plugin Interface types for Quilltap plugin development
@@ -254,8 +254,9 @@ interface LLMProviderPlugin {
      * Factory method to create an embedding provider (optional)
      * Only required if capabilities.embeddings is true
      * @param baseUrl Optional base URL for the provider
+     * @returns EmbeddingProvider for API-based providers, LocalEmbeddingProvider for local providers
      */
-    createEmbeddingProvider?: (baseUrl?: string) => unknown;
+    createEmbeddingProvider?: (baseUrl?: string) => EmbeddingProvider | LocalEmbeddingProvider;
     /**
      * Get list of available models for this provider
      * @param apiKey API key for authentication
@@ -1096,4 +1097,4 @@ interface RoleplayTemplatePluginExport {
     plugin: RoleplayTemplatePlugin;
 }
 
-export type { AttachmentSupport as A, AnnotationButton as B, CheapModelConfig as C, RenderingPattern as D, EmbeddingModelInfo as E, FontDefinition as F, DialogueDetection as G, ImageGenerationModelInfo as I, LLMProviderPlugin as L, ModelInfo as M, ProviderMetadata as P, RoleplayTemplateConfig as R, Spacing as S, ToolFormatType as T, ProviderConfigRequirements as a, ProviderCapabilities as b, ImageProviderConstraints as c, IconProps as d, ProviderPluginExport as e, MessageFormatSupport as f, PluginCapability as g, PluginCategory as h, PluginStatus as i, PluginAuthor as j, PluginCompatibility as k, ProviderConfig as l, PluginPermissions as m, PluginManifest as n, InstalledPluginInfo as o, ColorPalette as p, Typography as q, Effects as r, ThemeTokens as s, EmbeddedFont as t, ThemeMetadata as u, ThemePlugin as v, ThemePluginExport as w, RoleplayTemplateMetadata as x, RoleplayTemplatePlugin as y, RoleplayTemplatePluginExport as z };
+export type { AttachmentSupport as A, AnnotationButton as B, CheapModelConfig as C, DialogueDetection as D, Effects as E, FontDefinition as F, RenderingPattern as G, IconProps as I, 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, InstalledPluginInfo as f, ModelInfo as g, PluginCapability as h, PluginCategory as i, PluginCompatibility as j, PluginManifest as k, PluginPermissions as l, PluginStatus as m, ProviderCapabilities as n, ProviderConfig as o, ProviderConfigRequirements as p, ProviderMetadata as q, ProviderPluginExport as r, RoleplayTemplateMetadata as s, RoleplayTemplatePlugin as t, RoleplayTemplatePluginExport as u, ThemePlugin as v, ThemePluginExport as w, ThemeTokens as x, ToolFormatType as y, Typography as z };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { UniversalTool } from './llm/index.mjs';
-export { AnthropicToolDefinition, AttachmentResults, CacheUsage, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult } from './llm/index.mjs';
-export { A as AttachmentSupport, C as CheapModelConfig, p as ColorPalette, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, f as MessageFormatSupport, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, T as ToolFormatType, q as Typography } from './index-DtgwAg2x.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 InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, g as ModelInfo, P as PluginAuthor, h as PluginCapability, i as PluginCategory, j as PluginCompatibility, k as PluginManifest, l as PluginPermissions, m as PluginStatus, n as ProviderCapabilities, o as ProviderConfig, p as ProviderConfigRequirements, q as ProviderMetadata, r as ProviderPluginExport, R as RoleplayTemplateConfig, s as RoleplayTemplateMetadata, t as RoleplayTemplatePlugin, u as RoleplayTemplatePluginExport, S as Spacing, T as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, x as ThemeTokens, y as ToolFormatType, z as Typography } from './index-BtYmDARk.mjs';
 import { Readable } from 'stream';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.mjs';
 import 'react';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { UniversalTool } from './llm/index.js';
-export { AnthropicToolDefinition, AttachmentResults, CacheUsage, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult } from './llm/index.js';
-export { A as AttachmentSupport, C as CheapModelConfig, p as ColorPalette, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, f as MessageFormatSupport, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, T as ToolFormatType, q as Typography } from './index-3BT4ld_f.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 InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, g as ModelInfo, P as PluginAuthor, h as PluginCapability, i as PluginCategory, j as PluginCompatibility, k as PluginManifest, l as PluginPermissions, m as PluginStatus, n as ProviderCapabilities, o as ProviderConfig, p as ProviderConfigRequirements, q as ProviderMetadata, r as ProviderPluginExport, R as RoleplayTemplateConfig, s as RoleplayTemplateMetadata, t as RoleplayTemplatePlugin, u as RoleplayTemplatePluginExport, S as Spacing, T as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, x as ThemeTokens, y as ToolFormatType, z as Typography } from './index-CAtQduAS.js';
 import { Readable } from 'stream';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.js';
 import 'react';

package/dist/index.js

@@ -1,5 +1,10 @@
 'use strict';
 
+// src/llm/embeddings.ts
+function isLocalEmbeddingProvider(provider) {
+  return "fitCorpus" in provider && "loadState" in provider && "getState" in provider;
+}
+
 // src/common/errors.ts
 var PluginError = class extends Error {
   constructor(message, code, pluginName) {
@@ -120,5 +125,6 @@ exports.RateLimitError = RateLimitError;
 exports.ToolExecutionError = ToolExecutionError;
 exports.createConsoleLogger = createConsoleLogger;
 exports.createNoopLogger = createNoopLogger;
+exports.isLocalEmbeddingProvider = isLocalEmbeddingProvider;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\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\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  ImageProviderConstraints,\n  IconProps,\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  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.3.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  ImageProviderConstraints,\n  IconProps,\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  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.3.0';\n"]}

package/dist/index.mjs

@@ -1,3 +1,8 @@
+// src/llm/embeddings.ts
+function isLocalEmbeddingProvider(provider) {
+  return "fitCorpus" in provider && "loadState" in provider && "getState" in provider;
+}
+
 // src/common/errors.ts
 var PluginError = class extends Error {
   constructor(message, code, pluginName) {
@@ -107,6 +112,6 @@ function createNoopLogger() {
 // src/index.ts
 var PLUGIN_TYPES_VERSION = "1.3.0";
 
-export { ApiKeyError, AttachmentError, ConfigurationError, ModelNotFoundError, PLUGIN_TYPES_VERSION, PluginError, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger };
+export { ApiKeyError, AttachmentError, ConfigurationError, ModelNotFoundError, PLUGIN_TYPES_VERSION, PluginError, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger, isLocalEmbeddingProvider };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\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\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  ImageProviderConstraints,\n  IconProps,\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  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.3.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  ImageProviderConstraints,\n  IconProps,\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  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.3.0';\n"]}

package/dist/llm/index.d.mts

@@ -465,4 +465,165 @@ interface ImageGenProvider {
     getAvailableModels(apiKey?: string): Promise<string[]>;
 }
 
-export type { AnthropicToolDefinition, AttachmentResults, CacheUsage, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool };
+/**
+ * Embedding Provider Types for Quilltap plugin development
+ *
+ * Defines interfaces for embedding providers that can be implemented
+ * by plugins to provide text-to-vector embedding functionality.
+ *
+ * @module @quilltap/plugin-types/llm/embeddings
+ */
+/**
+ * Result of an embedding operation
+ */
+interface EmbeddingResult {
+    /** The embedding vector (array of floating point numbers) */
+    embedding: number[];
+    /** The model used to generate the embedding */
+    model: string;
+    /** Number of dimensions in the embedding vector */
+    dimensions: number;
+    /** Token usage information (if available) */
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+        cost?: number;
+    };
+}
+/**
+ * Options for embedding generation
+ */
+interface EmbeddingOptions {
+    /** Desired dimensions for the embedding (if model supports variable dimensions) */
+    dimensions?: number;
+}
+/**
+ * Standard embedding provider interface
+ *
+ * This is the base interface for all embedding providers that use
+ * external APIs (OpenAI, Ollama, OpenRouter, etc.)
+ */
+interface EmbeddingProvider {
+    /**
+     * Generate an embedding for a single text
+     *
+     * @param text The text to embed
+     * @param model The model to use
+     * @param apiKey The API key for authentication
+     * @param options Optional configuration
+     * @returns The embedding result
+     */
+    generateEmbedding(text: string, model: string, apiKey: string, options?: EmbeddingOptions): Promise<EmbeddingResult>;
+    /**
+     * Generate embeddings for multiple texts in a batch
+     *
+     * @param texts Array of texts to embed
+     * @param model The model to use
+     * @param apiKey The API key for authentication
+     * @param options Optional configuration
+     * @returns Array of embedding results
+     */
+    generateBatchEmbeddings?(texts: string[], model: string, apiKey: string, options?: EmbeddingOptions): Promise<EmbeddingResult[]>;
+    /**
+     * Get available embedding models
+     *
+     * @param apiKey The API key for authentication
+     * @returns Array of model IDs
+     */
+    getAvailableModels?(apiKey: string): Promise<string[]>;
+    /**
+     * Check if the provider is available and properly configured
+     *
+     * @param apiKey Optional API key to validate
+     * @returns True if the provider is ready to use
+     */
+    isAvailable?(apiKey?: string): Promise<boolean>;
+}
+/**
+ * Serializable state for local embedding providers
+ *
+ * Used by providers like TF-IDF that maintain vocabulary state
+ */
+interface LocalEmbeddingProviderState {
+    /** The vocabulary as an array of [term, index] pairs */
+    vocabulary: [string, number][];
+    /** The IDF (Inverse Document Frequency) weights */
+    idf: number[];
+    /** Average document length across the corpus */
+    avgDocLength: number;
+    /** Size of the vocabulary */
+    vocabularySize: number;
+    /** Whether bigrams are included in the vocabulary */
+    includeBigrams: boolean;
+    /** Timestamp when the vocabulary was fitted */
+    fittedAt: string;
+}
+/**
+ * Local embedding provider interface
+ *
+ * Extended interface for local/offline embedding providers that
+ * maintain vocabulary state (like TF-IDF). These providers don't
+ * require API keys and can work entirely offline.
+ */
+interface LocalEmbeddingProvider extends Omit<EmbeddingProvider, 'generateEmbedding' | 'generateBatchEmbeddings'> {
+    /**
+     * Generate an embedding for a single text
+     * Local providers don't need apiKey parameter
+     *
+     * @param text The text to embed
+     * @returns The embedding result
+     */
+    generateEmbedding(text: string): EmbeddingResult;
+    /**
+     * Generate embeddings for multiple texts in a batch
+     *
+     * @param texts Array of texts to embed
+     * @returns Array of embedding results
+     */
+    generateBatchEmbeddings(texts: string[]): EmbeddingResult[];
+    /**
+     * Fit the vocabulary on a corpus of documents
+     *
+     * This method analyzes the corpus to build vocabulary, calculate IDF weights,
+     * and other statistics needed for embedding generation.
+     *
+     * @param documents Array of text documents to analyze
+     */
+    fitCorpus(documents: string[]): void;
+    /**
+     * Check if the vocabulary has been fitted
+     *
+     * @returns True if fitCorpus has been called with documents
+     */
+    isFitted(): boolean;
+    /**
+     * Load state from a serialized representation
+     *
+     * @param state The serialized provider state
+     */
+    loadState(state: LocalEmbeddingProviderState): void;
+    /**
+     * Get the current state for serialization
+     *
+     * @returns The provider state, or null if not fitted
+     */
+    getState(): LocalEmbeddingProviderState | null;
+    /**
+     * Get the vocabulary size
+     *
+     * @returns Number of terms in the vocabulary
+     */
+    getVocabularySize(): number;
+    /**
+     * Get the embedding dimensions
+     *
+     * @returns Number of dimensions in generated embeddings
+     */
+    getDimensions(): number;
+}
+/**
+ * Type guard to check if a provider is a local embedding provider
+ */
+declare function isLocalEmbeddingProvider(provider: EmbeddingProvider | LocalEmbeddingProvider): provider is LocalEmbeddingProvider;
+
+export { type AnthropicToolDefinition, type AttachmentResults, type CacheUsage, type EmbeddingOptions, type EmbeddingProvider, type EmbeddingResult, type FileAttachment, type GeneratedImage, type GoogleToolDefinition, type ImageGenParams, type ImageGenProvider, type ImageGenResponse, type JSONSchemaDefinition, type LLMMessage, type LLMParams, type LLMProvider, type LLMResponse, type LocalEmbeddingProvider, type LocalEmbeddingProviderState, type ModelMetadata, type ModelWarning, type ModelWarningLevel, type OpenAIToolDefinition, type ResponseFormat, type StreamChunk, type TokenUsage, type ToolCall, type ToolCallRequest, type ToolFormatOptions, type ToolResult, type UniversalTool, isLocalEmbeddingProvider };

package/dist/llm/index.d.ts

@@ -465,4 +465,165 @@ interface ImageGenProvider {
     getAvailableModels(apiKey?: string): Promise<string[]>;
 }
 
-export type { AnthropicToolDefinition, AttachmentResults, CacheUsage, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool };
+/**
+ * Embedding Provider Types for Quilltap plugin development
+ *
+ * Defines interfaces for embedding providers that can be implemented
+ * by plugins to provide text-to-vector embedding functionality.
+ *
+ * @module @quilltap/plugin-types/llm/embeddings
+ */
+/**
+ * Result of an embedding operation
+ */
+interface EmbeddingResult {
+    /** The embedding vector (array of floating point numbers) */
+    embedding: number[];
+    /** The model used to generate the embedding */
+    model: string;
+    /** Number of dimensions in the embedding vector */
+    dimensions: number;
+    /** Token usage information (if available) */
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+        cost?: number;
+    };
+}
+/**
+ * Options for embedding generation
+ */
+interface EmbeddingOptions {
+    /** Desired dimensions for the embedding (if model supports variable dimensions) */
+    dimensions?: number;
+}
+/**
+ * Standard embedding provider interface
+ *
+ * This is the base interface for all embedding providers that use
+ * external APIs (OpenAI, Ollama, OpenRouter, etc.)
+ */
+interface EmbeddingProvider {
+    /**
+     * Generate an embedding for a single text
+     *
+     * @param text The text to embed
+     * @param model The model to use
+     * @param apiKey The API key for authentication
+     * @param options Optional configuration
+     * @returns The embedding result
+     */
+    generateEmbedding(text: string, model: string, apiKey: string, options?: EmbeddingOptions): Promise<EmbeddingResult>;
+    /**
+     * Generate embeddings for multiple texts in a batch
+     *
+     * @param texts Array of texts to embed
+     * @param model The model to use
+     * @param apiKey The API key for authentication
+     * @param options Optional configuration
+     * @returns Array of embedding results
+     */
+    generateBatchEmbeddings?(texts: string[], model: string, apiKey: string, options?: EmbeddingOptions): Promise<EmbeddingResult[]>;
+    /**
+     * Get available embedding models
+     *
+     * @param apiKey The API key for authentication
+     * @returns Array of model IDs
+     */
+    getAvailableModels?(apiKey: string): Promise<string[]>;
+    /**
+     * Check if the provider is available and properly configured
+     *
+     * @param apiKey Optional API key to validate
+     * @returns True if the provider is ready to use
+     */
+    isAvailable?(apiKey?: string): Promise<boolean>;
+}
+/**
+ * Serializable state for local embedding providers
+ *
+ * Used by providers like TF-IDF that maintain vocabulary state
+ */
+interface LocalEmbeddingProviderState {
+    /** The vocabulary as an array of [term, index] pairs */
+    vocabulary: [string, number][];
+    /** The IDF (Inverse Document Frequency) weights */
+    idf: number[];
+    /** Average document length across the corpus */
+    avgDocLength: number;
+    /** Size of the vocabulary */
+    vocabularySize: number;
+    /** Whether bigrams are included in the vocabulary */
+    includeBigrams: boolean;
+    /** Timestamp when the vocabulary was fitted */
+    fittedAt: string;
+}
+/**
+ * Local embedding provider interface
+ *
+ * Extended interface for local/offline embedding providers that
+ * maintain vocabulary state (like TF-IDF). These providers don't
+ * require API keys and can work entirely offline.
+ */
+interface LocalEmbeddingProvider extends Omit<EmbeddingProvider, 'generateEmbedding' | 'generateBatchEmbeddings'> {
+    /**
+     * Generate an embedding for a single text
+     * Local providers don't need apiKey parameter
+     *
+     * @param text The text to embed
+     * @returns The embedding result
+     */
+    generateEmbedding(text: string): EmbeddingResult;
+    /**
+     * Generate embeddings for multiple texts in a batch
+     *
+     * @param texts Array of texts to embed
+     * @returns Array of embedding results
+     */
+    generateBatchEmbeddings(texts: string[]): EmbeddingResult[];
+    /**
+     * Fit the vocabulary on a corpus of documents
+     *
+     * This method analyzes the corpus to build vocabulary, calculate IDF weights,
+     * and other statistics needed for embedding generation.
+     *
+     * @param documents Array of text documents to analyze
+     */
+    fitCorpus(documents: string[]): void;
+    /**
+     * Check if the vocabulary has been fitted
+     *
+     * @returns True if fitCorpus has been called with documents
+     */
+    isFitted(): boolean;
+    /**
+     * Load state from a serialized representation
+     *
+     * @param state The serialized provider state
+     */
+    loadState(state: LocalEmbeddingProviderState): void;
+    /**
+     * Get the current state for serialization
+     *
+     * @returns The provider state, or null if not fitted
+     */
+    getState(): LocalEmbeddingProviderState | null;
+    /**
+     * Get the vocabulary size
+     *
+     * @returns Number of terms in the vocabulary
+     */
+    getVocabularySize(): number;
+    /**
+     * Get the embedding dimensions
+     *
+     * @returns Number of dimensions in generated embeddings
+     */
+    getDimensions(): number;
+}
+/**
+ * Type guard to check if a provider is a local embedding provider
+ */
+declare function isLocalEmbeddingProvider(provider: EmbeddingProvider | LocalEmbeddingProvider): provider is LocalEmbeddingProvider;
+
+export { type AnthropicToolDefinition, type AttachmentResults, type CacheUsage, type EmbeddingOptions, type EmbeddingProvider, type EmbeddingResult, type FileAttachment, type GeneratedImage, type GoogleToolDefinition, type ImageGenParams, type ImageGenProvider, type ImageGenResponse, type JSONSchemaDefinition, type LLMMessage, type LLMParams, type LLMProvider, type LLMResponse, type LocalEmbeddingProvider, type LocalEmbeddingProviderState, type ModelMetadata, type ModelWarning, type ModelWarningLevel, type OpenAIToolDefinition, type ResponseFormat, type StreamChunk, type TokenUsage, type ToolCall, type ToolCallRequest, type ToolFormatOptions, type ToolResult, type UniversalTool, isLocalEmbeddingProvider };

package/dist/llm/index.js

@@ -1,4 +1,10 @@
 'use strict';
 
+// src/llm/embeddings.ts
+function isLocalEmbeddingProvider(provider) {
+  return "fitCorpus" in provider && "loadState" in provider && "getState" in provider;
+}
+
+exports.isLocalEmbeddingProvider = isLocalEmbeddingProvider;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/llm/embeddings.ts"],"names":[],"mappings":";;;AAyLO,SAAS,yBACd,QAAA,EACoC;AACpC,EAAA,OAAO,WAAA,IAAe,QAAA,IAAY,WAAA,IAAe,QAAA,IAAY,UAAA,IAAc,QAAA;AAC7E","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"]}

package/dist/llm/index.mjs

@@ -1,3 +1,8 @@
+// src/llm/embeddings.ts
+function isLocalEmbeddingProvider(provider) {
+  return "fitCorpus" in provider && "loadState" in provider && "getState" in provider;
+}
 
+export { isLocalEmbeddingProvider };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/llm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}
+{"version":3,"sources":["../../src/llm/embeddings.ts"],"names":[],"mappings":";AAyLO,SAAS,yBACd,QAAA,EACoC;AACpC,EAAA,OAAO,WAAA,IAAe,QAAA,IAAY,WAAA,IAAe,QAAA,IAAY,UAAA,IAAc,QAAA;AAC7E","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"]}

package/dist/plugins/index.d.mts

@@ -1,3 +1,3 @@
-export { B as AnnotationButton, A as AttachmentSupport, p as ColorPalette, G as DialogueDetection, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, D as RenderingPattern, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, q as Typography } from '../index-DtgwAg2x.mjs';
+export { B as AnnotationButton, A as AttachmentSupport, a as ColorPalette, D as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as InstalledPluginInfo, L as LLMProviderPlugin, g as ModelInfo, P as PluginAuthor, h as PluginCapability, i as PluginCategory, j as PluginCompatibility, k as PluginManifest, l as PluginPermissions, m as PluginStatus, n as ProviderCapabilities, o as ProviderConfig, p as ProviderConfigRequirements, q as ProviderMetadata, r as ProviderPluginExport, G as RenderingPattern, R as RoleplayTemplateConfig, s as RoleplayTemplateMetadata, t as RoleplayTemplatePlugin, u as RoleplayTemplatePluginExport, S as Spacing, T as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, x as ThemeTokens, z as Typography } from '../index-BtYmDARk.mjs';
 import 'react';
 import '../llm/index.mjs';

package/dist/plugins/index.d.ts

@@ -1,3 +1,3 @@
-export { B as AnnotationButton, A as AttachmentSupport, p as ColorPalette, G as DialogueDetection, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, D as RenderingPattern, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, q as Typography } from '../index-3BT4ld_f.js';
+export { B as AnnotationButton, A as AttachmentSupport, a as ColorPalette, D as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as InstalledPluginInfo, L as LLMProviderPlugin, g as ModelInfo, P as PluginAuthor, h as PluginCapability, i as PluginCategory, j as PluginCompatibility, k as PluginManifest, l as PluginPermissions, m as PluginStatus, n as ProviderCapabilities, o as ProviderConfig, p as ProviderConfigRequirements, q as ProviderMetadata, r as ProviderPluginExport, G as RenderingPattern, R as RoleplayTemplateConfig, s as RoleplayTemplateMetadata, t as RoleplayTemplatePlugin, u as RoleplayTemplatePluginExport, S as Spacing, T as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, x as ThemeTokens, z as Typography } from '../index-CAtQduAS.js';
 import 'react';
 import '../llm/index.js';

package/package.json

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