@quilltap/plugin-types 1.0.2 → 1.0.3

package/dist/index-yK-qJDls.d.ts

@@ -0,0 +1,496 @@
+import { ReactNode } from 'react';
+import { LLMProvider, ImageGenProvider, ToolFormatOptions, ToolCallRequest } from './llm/index.js';
+
+/**
+ * Provider Plugin Interface types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/plugins/provider
+ */
+
+/**
+ * Provider metadata for UI display and identification
+ */
+interface ProviderMetadata {
+    /** Internal identifier for the provider (e.g., 'OPENAI', 'ANTHROPIC') */
+    providerName: string;
+    /** Human-readable display name for UI (e.g., 'OpenAI', 'Anthropic') */
+    displayName: string;
+    /** Short description of the provider */
+    description: string;
+    /** Short abbreviation for icon display (e.g., 'OAI', 'ANT') */
+    abbreviation: string;
+    /** Tailwind CSS color classes for UI styling */
+    colors: {
+        /** Background color class (e.g., 'bg-green-100') */
+        bg: string;
+        /** Text color class (e.g., 'text-green-800') */
+        text: string;
+        /** Icon color class (e.g., 'text-green-600') */
+        icon: string;
+    };
+}
+/**
+ * Configuration requirements for the provider
+ */
+interface ProviderConfigRequirements {
+    /** Whether this provider requires an API key */
+    requiresApiKey: boolean;
+    /** Whether this provider requires a custom base URL */
+    requiresBaseUrl: boolean;
+    /** Label text for API key input field */
+    apiKeyLabel?: string;
+    /** Label text for base URL input field */
+    baseUrlLabel?: string;
+    /** Placeholder text for base URL input */
+    baseUrlPlaceholder?: string;
+    /** Default value for base URL */
+    baseUrlDefault?: string;
+    /** Deprecated: use baseUrlDefault instead */
+    defaultBaseUrl?: string;
+}
+/**
+ * Provider capability flags
+ */
+interface ProviderCapabilities {
+    /** Whether the provider supports chat completions */
+    chat: boolean;
+    /** Whether the provider supports image generation */
+    imageGeneration: boolean;
+    /** Whether the provider supports text embeddings */
+    embeddings: boolean;
+    /** Whether the provider supports web search functionality */
+    webSearch: boolean;
+}
+/**
+ * Attachment/file support configuration
+ */
+interface AttachmentSupport {
+    /** Whether this provider supports file attachments */
+    supportsAttachments: boolean;
+    /** Array of MIME types supported for attachments */
+    supportedMimeTypes: string[];
+    /** Human-readable description of attachment support */
+    description: string;
+    /** Additional notes about attachment support or limitations */
+    notes?: string;
+    /** Maximum file size in bytes */
+    maxFileSize?: number;
+    /** Maximum number of files per request */
+    maxFiles?: number;
+}
+/**
+ * Information about a specific model
+ */
+interface ModelInfo {
+    /** Unique identifier for the model */
+    id: string;
+    /** Human-readable name of the model */
+    name: string;
+    /** Context window size (tokens) */
+    contextWindow?: number;
+    /** Maximum output tokens for this model */
+    maxOutputTokens?: number;
+    /** Whether this model supports image attachments */
+    supportsImages?: boolean;
+    /** Whether this model supports tool/function calling */
+    supportsTools?: boolean;
+    /** Description of the model */
+    description?: string;
+    /** Pricing information */
+    pricing?: {
+        /** Price per 1M input tokens */
+        input: number;
+        /** Price per 1M output tokens */
+        output: number;
+    };
+}
+/**
+ * Information about an embedding model
+ */
+interface EmbeddingModelInfo {
+    /** Unique identifier for the embedding model */
+    id: string;
+    /** Human-readable name of the model */
+    name: string;
+    /** Dimensions of the embedding vector output */
+    dimensions?: number;
+    /** Description of the model's characteristics */
+    description?: string;
+}
+/**
+ * Information about an image generation model
+ */
+interface ImageGenerationModelInfo {
+    /** Unique identifier for the model */
+    id: string;
+    /** Human-readable name of the model */
+    name: string;
+    /** Supported aspect ratios (e.g., ['1:1', '16:9']) */
+    supportedAspectRatios?: string[];
+    /** Supported image sizes (e.g., ['1024x1024', '512x512']) */
+    supportedSizes?: string[];
+    /** Description of the model */
+    description?: string;
+}
+/**
+ * Constraints for image generation
+ */
+interface ImageProviderConstraints {
+    /** Maximum bytes allowed for image generation prompt */
+    maxPromptBytes?: number;
+    /** Warning message about prompt constraints */
+    promptConstraintWarning?: string;
+    /** Maximum images per request */
+    maxImagesPerRequest?: number;
+    /** Supported aspect ratios */
+    supportedAspectRatios?: string[];
+    /** Supported image sizes */
+    supportedSizes?: string[];
+}
+/**
+ * Icon component props
+ */
+interface IconProps {
+    /** CSS class for styling */
+    className?: string;
+}
+/**
+ * Message format support for multi-character chats
+ * Defines how the provider handles the 'name' field in messages
+ */
+interface MessageFormatSupport {
+    /** Whether the provider supports a name field on messages */
+    supportsNameField: boolean;
+    /** Which roles support the name field */
+    supportedRoles: ('user' | 'assistant')[];
+    /** Maximum length for name field (if limited) */
+    maxNameLength?: number;
+}
+/**
+ * Cheap model configuration for background tasks
+ * Used for memory extraction, summarization, titling, etc.
+ */
+interface CheapModelConfig {
+    /** The default cheap model for this provider */
+    defaultModel: string;
+    /** List of recommended cheap models */
+    recommendedModels: string[];
+}
+/**
+ * Tool format type for this provider
+ * Determines how tools are formatted for API calls
+ */
+type ToolFormatType = 'openai' | 'anthropic' | 'google';
+/**
+ * Main LLM Provider Plugin Interface
+ *
+ * Plugins implementing this interface can be dynamically loaded
+ * by Quilltap to provide LLM functionality from various providers.
+ *
+ * @example
+ * ```typescript
+ * import type { LLMProviderPlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: LLMProviderPlugin = {
+ *   metadata: {
+ *     providerName: 'MY_PROVIDER',
+ *     displayName: 'My Provider',
+ *     description: 'Custom LLM provider',
+ *     abbreviation: 'MYP',
+ *     colors: { bg: 'bg-blue-100', text: 'text-blue-800', icon: 'text-blue-600' },
+ *   },
+ *   config: {
+ *     requiresApiKey: true,
+ *     requiresBaseUrl: false,
+ *     apiKeyLabel: 'API Key',
+ *   },
+ *   capabilities: {
+ *     chat: true,
+ *     imageGeneration: false,
+ *     embeddings: false,
+ *     webSearch: false,
+ *   },
+ *   attachmentSupport: {
+ *     supportsAttachments: false,
+ *     supportedMimeTypes: [],
+ *     description: 'No file attachments supported',
+ *   },
+ *   createProvider: () => new MyProvider(),
+ *   getAvailableModels: async (apiKey) => [...],
+ *   validateApiKey: async (apiKey) => {...},
+ *   renderIcon: ({ className }) => <MyIcon className={className} />,
+ * };
+ * ```
+ */
+interface LLMProviderPlugin {
+    /** Provider metadata for UI display and identification */
+    metadata: ProviderMetadata;
+    /** Configuration requirements for this provider */
+    config: ProviderConfigRequirements;
+    /** Supported capabilities for this provider */
+    capabilities: ProviderCapabilities;
+    /** File attachment support information */
+    attachmentSupport: AttachmentSupport;
+    /**
+     * Factory method to create an LLMProvider instance
+     * @param baseUrl Optional base URL for the provider
+     */
+    createProvider: (baseUrl?: string) => LLMProvider;
+    /**
+     * Factory method to create an ImageGenProvider instance (optional)
+     * Only required if capabilities.imageGeneration is true
+     * @param baseUrl Optional base URL for the provider
+     */
+    createImageProvider?: (baseUrl?: string) => ImageGenProvider;
+    /**
+     * Factory method to create an embedding provider (optional)
+     * Only required if capabilities.embeddings is true
+     * @param baseUrl Optional base URL for the provider
+     */
+    createEmbeddingProvider?: (baseUrl?: string) => unknown;
+    /**
+     * Get list of available models for this provider
+     * @param apiKey API key for authentication
+     * @param baseUrl Optional base URL
+     */
+    getAvailableModels: (apiKey: string, baseUrl?: string) => Promise<string[]>;
+    /**
+     * Get static model information without API calls
+     */
+    getModelInfo?: () => ModelInfo[];
+    /**
+     * Get embedding models supported by this provider
+     */
+    getEmbeddingModels?: () => EmbeddingModelInfo[];
+    /**
+     * Get image generation models supported by this provider
+     */
+    getImageGenerationModels?: () => ImageGenerationModelInfo[];
+    /**
+     * Validate an API key for this provider
+     * @param apiKey API key to validate
+     * @param baseUrl Optional base URL
+     */
+    validateApiKey: (apiKey: string, baseUrl?: string) => Promise<boolean>;
+    /**
+     * Render the provider icon as a React component
+     * @param props Icon component props
+     */
+    renderIcon: (props: IconProps) => ReactNode;
+    /**
+     * Convert universal tool format to provider-specific format (optional)
+     * @param tool Tools in OpenAI format or generic objects
+     * @param options Formatting options
+     */
+    formatTools?: (tool: any, options?: ToolFormatOptions) => any;
+    /**
+     * Parse provider-specific tool calls from response (optional)
+     * @param response Raw API response
+     */
+    parseToolCalls?: (response: any) => ToolCallRequest[];
+    /**
+     * Get image provider constraints (optional)
+     * Only applicable for providers with imageGeneration capability
+     */
+    getImageProviderConstraints?: () => ImageProviderConstraints;
+    /**
+     * Message format support for multi-character contexts (optional)
+     * If not provided, defaults to no name field support
+     */
+    messageFormat?: MessageFormatSupport;
+    /**
+     * Token estimation multiplier (optional)
+     * Characters per token for this provider's tokenizer
+     * @default 3.5
+     */
+    charsPerToken?: number;
+    /**
+     * Tool format type for this provider (optional)
+     * Used for quick format detection without calling formatTools()
+     * @default 'openai'
+     */
+    toolFormat?: ToolFormatType;
+    /**
+     * Cheap model configuration for background tasks (optional)
+     * Used for memory extraction, summarization, titling, etc.
+     */
+    cheapModels?: CheapModelConfig;
+    /**
+     * Default context window when model is unknown (optional)
+     * Falls back to 8192 if not specified
+     */
+    defaultContextWindow?: number;
+}
+/**
+ * Standard export type for provider plugins
+ */
+interface ProviderPluginExport {
+    /** The provider plugin instance */
+    plugin: LLMProviderPlugin;
+}
+
+/**
+ * Plugin Manifest types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/plugins/manifest
+ */
+/**
+ * Plugin capability types
+ */
+type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'UTILITY';
+/**
+ * Plugin category
+ */
+type PluginCategory = 'PROVIDER' | 'AUTH' | 'STORAGE' | 'UI' | 'UTILITY';
+/**
+ * Plugin status
+ */
+type PluginStatus = 'STABLE' | 'BETA' | 'EXPERIMENTAL' | 'DEPRECATED';
+/**
+ * Author information
+ */
+interface PluginAuthor {
+    /** Author name */
+    name: string;
+    /** Author email */
+    email?: string;
+    /** Author website or profile URL */
+    url?: string;
+}
+/**
+ * Compatibility requirements
+ */
+interface PluginCompatibility {
+    /** Minimum Quilltap version (semver range) */
+    quilltapVersion: string;
+    /** Minimum Node.js version (semver range) */
+    nodeVersion?: string;
+}
+/**
+ * Provider-specific configuration (for LLM_PROVIDER plugins)
+ */
+interface ProviderConfig {
+    /** Internal provider name */
+    providerName: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Provider description */
+    description: string;
+    /** Short abbreviation */
+    abbreviation: string;
+    /** UI color configuration */
+    colors: {
+        bg: string;
+        text: string;
+        icon: string;
+    };
+    /** Whether the provider requires an API key */
+    requiresApiKey: boolean;
+    /** Whether the provider requires a base URL */
+    requiresBaseUrl: boolean;
+    /** Label for API key input */
+    apiKeyLabel?: string;
+    /** Provider capabilities */
+    capabilities: {
+        chat: boolean;
+        imageGeneration: boolean;
+        embeddings: boolean;
+        webSearch: boolean;
+    };
+    /** Attachment support configuration */
+    attachmentSupport: {
+        supported: boolean;
+        mimeTypes: string[];
+        description: string;
+    };
+}
+/**
+ * Required permissions for the plugin
+ */
+interface PluginPermissions {
+    /** Network domains the plugin may access */
+    network?: string[];
+    /** Whether the plugin accesses user data */
+    userData?: boolean;
+    /** Whether the plugin accesses the database */
+    database?: boolean;
+    /** Whether the plugin accesses the file system */
+    fileSystem?: boolean;
+}
+/**
+ * Plugin manifest schema
+ *
+ * This is the structure of the quilltap-manifest.json file
+ * that every Quilltap plugin must include.
+ */
+interface PluginManifest {
+    /** JSON schema reference */
+    $schema?: string;
+    /** Package name (must start with qtap-plugin-) */
+    name: string;
+    /** Human-readable title */
+    title: string;
+    /** Plugin description */
+    description: string;
+    /** Semantic version */
+    version: string;
+    /** Author information */
+    author: PluginAuthor;
+    /** License identifier (SPDX) */
+    license: string;
+    /** Compatibility requirements */
+    compatibility: PluginCompatibility;
+    /** Plugin capabilities */
+    capabilities: PluginCapability[];
+    /** Plugin category */
+    category: PluginCategory;
+    /** Main entry point (relative path) */
+    main: string;
+    /** Whether TypeScript source is available */
+    typescript?: boolean;
+    /** Frontend framework used */
+    frontend?: 'REACT' | 'NONE';
+    /** Styling approach used */
+    styling?: 'TAILWIND' | 'CSS' | 'NONE';
+    /** Whether to enable by default when installed */
+    enabledByDefault?: boolean;
+    /** Plugin status */
+    status: PluginStatus;
+    /** Search keywords */
+    keywords?: string[];
+    /** Provider-specific configuration (for LLM_PROVIDER plugins) */
+    providerConfig?: ProviderConfig;
+    /** Required permissions */
+    permissions?: PluginPermissions;
+    /** Repository URL */
+    repository?: string | {
+        type: string;
+        url: string;
+        directory?: string;
+    };
+    /** Homepage URL */
+    homepage?: string;
+    /** Bug tracker URL */
+    bugs?: string | {
+        url: string;
+        email?: string;
+    };
+}
+/**
+ * Installed plugin metadata
+ * Extended manifest with installation-specific information
+ */
+interface InstalledPluginInfo extends PluginManifest {
+    /** Whether the plugin is currently enabled */
+    enabled: boolean;
+    /** Installation timestamp */
+    installedAt?: string;
+    /** Last update timestamp */
+    updatedAt?: string;
+    /** Installation scope */
+    scope?: 'site' | 'user';
+    /** Path to installed plugin */
+    installPath?: string;
+}
+
+export type { AttachmentSupport as A, CheapModelConfig as C, EmbeddingModelInfo as E, ImageGenerationModelInfo as I, LLMProviderPlugin as L, ModelInfo as M, ProviderMetadata as P, 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 };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 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, UniversalTool } from './llm/index.mjs';
-export { AttachmentSupport, EmbeddingModelInfo, IconProps, ImageGenerationModelInfo, ImageProviderConstraints, InstalledPluginInfo, LLMProviderPlugin, ModelInfo, PluginAuthor, PluginCapability, PluginCategory, PluginCompatibility, PluginManifest, PluginPermissions, PluginStatus, ProviderCapabilities, ProviderConfig, ProviderConfigRequirements, ProviderMetadata, ProviderPluginExport } from './plugins/index.mjs';
+export { A as AttachmentSupport, C as CheapModelConfig, E as EmbeddingModelInfo, 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, T as ToolFormatType } from './index-BJ_sGB3K.mjs';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.mjs';
 import 'react';
 
@@ -20,6 +20,6 @@ import 'react';
  * Version of the plugin-types package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_TYPES_VERSION = "1.0.1";
+declare const PLUGIN_TYPES_VERSION = "1.0.3";
 
 export { PLUGIN_TYPES_VERSION };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 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, UniversalTool } from './llm/index.js';
-export { AttachmentSupport, EmbeddingModelInfo, IconProps, ImageGenerationModelInfo, ImageProviderConstraints, InstalledPluginInfo, LLMProviderPlugin, ModelInfo, PluginAuthor, PluginCapability, PluginCategory, PluginCompatibility, PluginManifest, PluginPermissions, PluginStatus, ProviderCapabilities, ProviderConfig, ProviderConfigRequirements, ProviderMetadata, ProviderPluginExport } from './plugins/index.js';
+export { A as AttachmentSupport, C as CheapModelConfig, E as EmbeddingModelInfo, 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, T as ToolFormatType } from './index-yK-qJDls.js';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.js';
 import 'react';
 
@@ -20,6 +20,6 @@ import 'react';
  * Version of the plugin-types package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_TYPES_VERSION = "1.0.1";
+declare const PLUGIN_TYPES_VERSION = "1.0.3";
 
 export { PLUGIN_TYPES_VERSION };

package/dist/index.js

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

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} 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\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.0.1';\n"]}
+{"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\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.0.3';\n"]}

package/dist/index.mjs

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