@quilltap/plugin-utils 1.7.0 → 2.0.0

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/index.ts","../../src/providers/openai-compatible.ts","../../src/logging/plugin-logger.ts","../../src/logging/index.ts","../../src/version.ts"],"sourcesContent":["/**\n * Provider Base Classes\n *\n * Reusable base classes for building LLM provider plugins.\n * External plugins can extend these classes to create custom providers\n * with minimal boilerplate.\n *\n * @packageDocumentation\n */\n\nexport {\n  OpenAICompatibleProvider,\n  type OpenAICompatibleProviderConfig,\n} from './openai-compatible';\n","/**\n * OpenAI-Compatible Provider Base Class\n *\n * A reusable base class for building LLM providers that use OpenAI-compatible APIs.\n * This includes services like:\n * - Local LLM servers (LM Studio, vLLM, Text Generation Web UI, Ollama with OpenAI compat)\n * - Cloud services with OpenAI-compatible APIs (Gab AI, Together AI, Fireworks, etc.)\n *\n * External plugins can extend this class to create custom providers with minimal code:\n *\n * @example\n * ```typescript\n * import { OpenAICompatibleProvider } from '@quilltap/plugin-utils';\n *\n * export class MyCustomProvider extends OpenAICompatibleProvider {\n *   constructor() {\n *     super({\n *       baseUrl: 'https://api.my-service.com/v1',\n *       providerName: 'MyService',\n *       requireApiKey: true,\n *       attachmentErrorMessage: 'MyService does not support file attachments',\n *     });\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport OpenAI from 'openai';\nimport type {\n  LLMProvider,\n  LLMParams,\n  LLMResponse,\n  StreamChunk,\n  ImageGenParams,\n  ImageGenResponse,\n  PluginLogger,\n} from '@quilltap/plugin-types';\nimport { createPluginLogger } from '../logging';\nimport { getQuilltapUserAgent } from '../version';\n\n/**\n * Configuration options for OpenAI-compatible providers.\n *\n * Use this interface when extending OpenAICompatibleProvider to customize\n * the provider's behavior for your specific service.\n */\nexport interface OpenAICompatibleProviderConfig {\n  /**\n   * Base URL for the API endpoint.\n   * Should include the version path (e.g., 'https://api.example.com/v1')\n   */\n  baseUrl: string;\n\n  /**\n   * Provider name used for logging context.\n   * This appears in log messages to identify which provider generated them.\n   * @default 'OpenAICompatible'\n   */\n  providerName?: string;\n\n  /**\n   * Whether an API key is required for this provider.\n   * If true, requests will fail with an error when no API key is provided.\n   * If false, requests will use 'not-needed' as the API key (for local servers).\n   * @default false\n   */\n  requireApiKey?: boolean;\n\n  /**\n   * Custom error message shown when file attachments are attempted.\n   * @default 'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)'\n   */\n  attachmentErrorMessage?: string;\n}\n\n/**\n * Base provider class for OpenAI-compatible APIs.\n *\n * This class implements the full LLMProvider interface using the OpenAI SDK,\n * allowing subclasses to create custom providers with just configuration.\n *\n * Features:\n * - Streaming and non-streaming chat completions\n * - API key validation\n * - Model listing\n * - Configurable API key requirements\n * - Dynamic logging with provider name context\n *\n * @remarks\n * File attachments and image generation are not supported by default,\n * as support varies across OpenAI-compatible implementations.\n */\nexport class OpenAICompatibleProvider implements LLMProvider {\n  /** File attachments are not supported by default */\n  readonly supportsFileAttachments = false;\n  /** No MIME types are supported for attachments */\n  readonly supportedMimeTypes: string[] = [];\n  /** Image generation is not supported by default */\n  readonly supportsImageGeneration = false;\n  /** Web search is not supported */\n  readonly supportsWebSearch = false;\n\n  /** Base URL for the API endpoint */\n  protected readonly baseUrl: string;\n  /** Provider name for logging */\n  protected readonly providerName: string;\n  /** Whether API key is required */\n  protected readonly requireApiKey: boolean;\n  /** Error message for attachment failures */\n  protected readonly attachmentErrorMessage: string;\n  /** Logger instance */\n  protected readonly logger: PluginLogger;\n\n  /**\n   * Creates a new OpenAI-compatible provider instance.\n   *\n   * @param config - Configuration object or base URL string (for backward compatibility)\n   */\n  constructor(config: string | OpenAICompatibleProviderConfig) {\n    // Support both legacy string baseUrl and new config object\n    if (typeof config === 'string') {\n      this.baseUrl = config;\n      this.providerName = 'OpenAICompatible';\n      this.requireApiKey = false;\n      this.attachmentErrorMessage =\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    } else {\n      this.baseUrl = config.baseUrl;\n      this.providerName = config.providerName ?? 'OpenAICompatible';\n      this.requireApiKey = config.requireApiKey ?? false;\n      this.attachmentErrorMessage =\n        config.attachmentErrorMessage ??\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    }\n\n    this.logger = createPluginLogger(`${this.providerName}Provider`);\n  }\n\n  /**\n   * Collects attachment failures for messages with attachments.\n   * Since attachments are not supported, all attachments are marked as failed.\n   *\n   * @param params - LLM parameters containing messages\n   * @returns Object with empty sent array and failed attachments\n   */\n  protected collectAttachmentFailures(\n    params: LLMParams\n  ): { sent: string[]; failed: { id: string; error: string }[] } {\n    const failed: { id: string; error: string }[] = [];\n    for (const msg of params.messages) {\n      if (msg.attachments) {\n        for (const attachment of msg.attachments) {\n          failed.push({\n            id: attachment.id,\n            error: this.attachmentErrorMessage,\n          });\n        }\n      }\n    }\n    return { sent: [], failed };\n  }\n\n  /**\n   * Validates that an API key is provided when required.\n   * @throws Error if API key is required but not provided\n   */\n  protected validateApiKeyRequirement(apiKey: string): void {\n    if (this.requireApiKey && !apiKey) {\n      throw new Error(`${this.providerName} provider requires an API key`);\n    }\n  }\n\n  /**\n   * Gets the effective API key to use for requests.\n   * Returns 'not-needed' for providers that don't require keys.\n   */\n  protected getEffectiveApiKey(apiKey: string): string {\n    return this.requireApiKey ? apiKey : apiKey || 'not-needed';\n  }\n\n  /**\n   * Creates an OpenAI client configured with the provider's base URL,\n   * API key, and Quilltap User-Agent header.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Configured OpenAI client instance\n   */\n  protected createClient(apiKey: string): OpenAI {\n    return new OpenAI({\n      apiKey: this.getEffectiveApiKey(apiKey),\n      baseURL: this.baseUrl,\n      defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n    });\n  }\n\n  /**\n   * Sends a message and returns the complete response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @returns Complete LLM response with content and usage statistics\n   */\n  async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const response = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stop: params.stop,\n      });\n\n      const choice = response.choices[0];\n      return {\n        content: choice.message.content ?? '',\n        finishReason: choice.finish_reason,\n        usage: {\n          promptTokens: response.usage?.prompt_tokens ?? 0,\n          completionTokens: response.usage?.completion_tokens ?? 0,\n          totalTokens: response.usage?.total_tokens ?? 0,\n        },\n        raw: response,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in sendMessage`,\n        { context: `${this.providerName}Provider.sendMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Sends a message and streams the response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @yields Stream chunks with content and final usage statistics\n   */\n  async *streamMessage(params: LLMParams, apiKey: string): AsyncGenerator<StreamChunk> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const stream = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stream: true,\n        stream_options: { include_usage: true },\n      });\n\n      let chunkCount = 0;\n\n      // Track usage - it may come in a separate final chunk\n      let accumulatedUsage: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number } | null = null;\n\n      for await (const chunk of stream) {\n        chunkCount++;\n        const content = chunk.choices[0]?.delta?.content;\n        const hasUsage = chunk.usage;\n\n        // Track usage when we get it (may come in a separate final chunk)\n        if (hasUsage) {\n          accumulatedUsage = {\n            prompt_tokens: chunk.usage?.prompt_tokens,\n            completion_tokens: chunk.usage?.completion_tokens,\n            total_tokens: chunk.usage?.total_tokens,\n          };\n        }\n\n        // Yield content chunks\n        if (content) {\n          yield {\n            content,\n            done: false,\n          };\n        }\n      }\n\n      // After stream ends, yield final chunk with accumulated usage\n      yield {\n        content: '',\n        done: true,\n        usage: accumulatedUsage ? {\n          promptTokens: accumulatedUsage.prompt_tokens ?? 0,\n          completionTokens: accumulatedUsage.completion_tokens ?? 0,\n          totalTokens: accumulatedUsage.total_tokens ?? 0,\n        } : undefined,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in streamMessage`,\n        { context: `${this.providerName}Provider.streamMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Validates an API key by attempting to list models.\n   *\n   * @param apiKey - API key to validate\n   * @returns true if the API key is valid, false otherwise\n   */\n  async validateApiKey(apiKey: string): Promise<boolean> {\n    // For providers that require API key, return false if not provided\n    if (this.requireApiKey && !apiKey) {\n      return false;\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      await client.models.list();\n      return true;\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API validation failed`,\n        { context: `${this.providerName}Provider.validateApiKey`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return false;\n    }\n  }\n\n  /**\n   * Fetches available models from the API.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Sorted array of model IDs, or empty array on failure\n   */\n  async getAvailableModels(apiKey: string): Promise<string[]> {\n    // For providers that require API key, return empty if not provided\n    if (this.requireApiKey && !apiKey) {\n      this.logger.error(`${this.providerName} provider requires an API key to fetch models`, {\n        context: `${this.providerName}Provider.getAvailableModels`,\n      });\n      return [];\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      const models = await client.models.list();\n      const modelList = models.data.map((m) => m.id).sort();\n      return modelList;\n    } catch (error) {\n      this.logger.error(\n        `Failed to fetch ${this.providerName} models`,\n        { context: `${this.providerName}Provider.getAvailableModels`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return [];\n    }\n  }\n\n  /**\n   * Image generation is not supported by default.\n   * @throws Error indicating image generation is not supported\n   */\n  async generateImage(_params: ImageGenParams, _apiKey: string): Promise<ImageGenResponse> {\n    throw new Error(\n      `${this.providerName} image generation support varies by implementation (not yet implemented)`\n    );\n  }\n}\n","/**\n * Plugin Logger Bridge\n *\n * Provides a logger factory for plugins that automatically bridges\n * to Quilltap's core logging when running inside the host application,\n * or falls back to console logging when running standalone.\n *\n * @module @quilltap/plugin-utils/logging/plugin-logger\n */\n\nimport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n/**\n * Extended logger interface with child logger support\n */\nexport interface PluginLoggerWithChild extends PluginLogger {\n  /**\n   * Create a child logger with additional context\n   * @param additionalContext Context to merge with parent context\n   * @returns A new logger with combined context\n   */\n  child(additionalContext: LogContext): PluginLoggerWithChild;\n}\n\n/**\n * Type for the global Quilltap logger bridge\n * Stored on globalThis to work across different npm package copies\n */\ndeclare global {\n   \n  var __quilltap_logger_factory:\n    | ((pluginName: string) => PluginLoggerWithChild)\n    | undefined;\n}\n\n/**\n * Get the core logger factory from global namespace\n *\n * @returns The injected factory or null if not in Quilltap environment\n */\nfunction getCoreLoggerFactory(): ((pluginName: string) => PluginLoggerWithChild) | null {\n  return globalThis.__quilltap_logger_factory ?? null;\n}\n\n/**\n * Inject the core logger factory from Quilltap host\n *\n * This is called by Quilltap core when loading plugins to bridge\n * plugin logging into the host's logging system. Uses globalThis\n * to ensure it works even when plugins have their own copy of\n * plugin-utils in their node_modules.\n *\n * **Internal API - not for plugin use**\n *\n * @param factory A function that creates a child logger for a plugin\n */\nexport function __injectCoreLoggerFactory(\n  factory: (pluginName: string) => PluginLoggerWithChild\n): void {\n  globalThis.__quilltap_logger_factory = factory;\n}\n\n/**\n * Clear the injected core logger factory\n *\n * Useful for testing or when unloading the plugin system.\n *\n * **Internal API - not for plugin use**\n */\nexport function __clearCoreLoggerFactory(): void {\n  globalThis.__quilltap_logger_factory = undefined;\n}\n\n/**\n * Check if a core logger has been injected\n *\n * @returns True if running inside Quilltap with core logging available\n */\nexport function hasCoreLogger(): boolean {\n  return getCoreLoggerFactory() !== null;\n}\n\n/**\n * Create a console logger with child support\n *\n * @param prefix Logger prefix\n * @param minLevel Minimum log level\n * @param baseContext Base context to include in all logs\n */\nfunction createConsoleLoggerWithChild(\n  prefix: string,\n  minLevel: LogLevel = 'debug',\n  baseContext: LogContext = {}\n): PluginLoggerWithChild {\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    const merged = { ...baseContext, ...context };\n    const entries = Object.entries(merged)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  const logger: PluginLoggerWithChild = {\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    child: (additionalContext: LogContext): PluginLoggerWithChild => {\n      return createConsoleLoggerWithChild(prefix, minLevel, {\n        ...baseContext,\n        ...additionalContext,\n      });\n    },\n  };\n\n  return logger;\n}\n\n/**\n * Create a plugin logger that bridges to Quilltap core logging\n *\n * When running inside Quilltap:\n * - Routes all logs to the core logger\n * - Tags logs with `{ plugin: pluginName, module: 'plugin' }`\n * - Logs appear in Quilltap's combined.log and console\n *\n * When running standalone:\n * - Falls back to console logging with `[pluginName]` prefix\n * - Respects the specified minimum log level\n *\n * @param pluginName - The plugin identifier (e.g., 'qtap-plugin-openai')\n * @param minLevel - Minimum log level when running standalone (default: 'debug')\n * @returns A logger instance\n *\n * @example\n * ```typescript\n * // In your plugin's provider.ts\n * import { createPluginLogger } from '@quilltap/plugin-utils';\n *\n * const logger = createPluginLogger('qtap-plugin-my-provider');\n *\n * export class MyProvider implements LLMProvider {\n *   async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n *     logger.debug('Sending message', { model: params.model });\n *\n *     try {\n *       const response = await this.client.chat({...});\n *       logger.info('Received response', { tokens: response.usage?.total_tokens });\n *       return response;\n *     } catch (error) {\n *       logger.error('Failed to send message', { model: params.model }, error as Error);\n *       throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport function createPluginLogger(\n  pluginName: string,\n  minLevel: LogLevel = 'debug'\n): PluginLoggerWithChild {\n  // Check for core logger factory from global namespace\n  const coreFactory = getCoreLoggerFactory();\n  if (coreFactory) {\n    return coreFactory(pluginName);\n  }\n\n  // Standalone mode: use enhanced console logger\n  return createConsoleLoggerWithChild(pluginName, minLevel);\n}\n\n/**\n * Get the minimum log level from environment\n *\n * Checks for LOG_LEVEL or QUILLTAP_LOG_LEVEL environment variables.\n * Useful for configuring standalone plugin logging.\n *\n * @returns The configured log level, or 'info' as default\n */\nexport function getLogLevelFromEnv(): LogLevel {\n  if (typeof process !== 'undefined' && process.env) {\n    const envLevel = process.env.LOG_LEVEL || process.env.QUILLTAP_LOG_LEVEL;\n    if (envLevel && ['debug', 'info', 'warn', 'error'].includes(envLevel)) {\n      return envLevel as LogLevel;\n    }\n  }\n  return 'info';\n}\n","/**\n * Logging Utilities\n *\n * Exports the plugin logger bridge and related utilities.\n *\n * @module @quilltap/plugin-utils/logging\n */\n\nexport {\n  createPluginLogger,\n  hasCoreLogger,\n  getLogLevelFromEnv,\n  __injectCoreLoggerFactory,\n  __clearCoreLoggerFactory,\n} from './plugin-logger';\n\nexport type { PluginLoggerWithChild } from './plugin-logger';\n\n// Re-export logger types from plugin-types\nexport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n// Re-export logger utilities from plugin-types for convenience\nexport { createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';\n","/**\n * Quilltap Version Management\n *\n * Provides access to the Quilltap application version for plugins.\n * Uses the same globalThis injection pattern as the logger factory,\n * allowing the host app to inject its version at startup.\n *\n * @module @quilltap/plugin-utils/version\n */\n\n/**\n * Global key used to store the injected Quilltap version.\n * Must match the key used by the host app's injection code.\n */\nconst GLOBAL_VERSION_KEY = '__quilltap_app_version';\n\n/**\n * Inject the Quilltap application version into the global namespace.\n *\n * This should be called early in plugin initialization (alongside the\n * logger factory injection), before any plugins are loaded. Plugins\n * can then retrieve the version via `getQuilltapVersion()`.\n *\n * @param version - The Quilltap application version string (e.g., '3.3.0')\n *\n * @example\n * ```typescript\n * import { __injectQuilltapVersion } from '@quilltap/plugin-utils';\n * import packageJson from './package.json';\n *\n * __injectQuilltapVersion(packageJson.version);\n * ```\n */\nexport function __injectQuilltapVersion(version: string): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = version;\n}\n\n/**\n * Clear the injected Quilltap version from the global namespace.\n *\n * Useful for testing or cleanup.\n */\nexport function __clearQuilltapVersion(): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = undefined;\n}\n\n/**\n * Get the Quilltap application version.\n *\n * Returns the version injected by the host app, or 'unknown' if\n * no version has been injected (e.g., running outside of Quilltap).\n *\n * @returns The Quilltap version string (e.g., '3.3.0') or 'unknown'\n */\nexport function getQuilltapVersion(): string {\n  const version = (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY];\n  return typeof version === 'string' ? version : 'unknown';\n}\n\n/**\n * Get the Quilltap User-Agent string for API requests.\n *\n * Returns a string in the format `Quilltap/{version}` suitable for\n * use as a User-Agent header or app identifier in API calls.\n *\n * @returns User-Agent string (e.g., 'Quilltap/3.3.0')\n *\n * @example\n * ```typescript\n * import { getQuilltapUserAgent } from '@quilltap/plugin-utils';\n *\n * const client = new OpenAI({\n *   apiKey,\n *   defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n * });\n * ```\n */\nexport function getQuilltapUserAgent(): string {\n  return `Quilltap/${getQuilltapVersion()}`;\n}\n"],"mappings":"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","names":["OpenAI"]}
+{"version":3,"sources":["../../src/providers/index.ts","../../src/providers/openai-compatible.ts","../../src/logging/plugin-logger.ts","../../src/logging/index.ts","../../src/version.ts"],"sourcesContent":["/**\n * Provider Base Classes\n *\n * Reusable base classes for building LLM provider plugins.\n * External plugins can extend these classes to create custom providers\n * with minimal boilerplate.\n *\n * @packageDocumentation\n */\n\nexport {\n  OpenAICompatibleProvider,\n  type OpenAICompatibleProviderConfig,\n} from './openai-compatible';\n","/**\n * OpenAI-Compatible Provider Base Class\n *\n * A reusable base class for building LLM providers that use OpenAI-compatible APIs.\n * This includes services like:\n * - Local LLM servers (LM Studio, vLLM, Text Generation Web UI, Ollama with OpenAI compat)\n * - Cloud services with OpenAI-compatible APIs (Gab AI, Together AI, Fireworks, etc.)\n *\n * External plugins can extend this class to create custom providers with minimal code:\n *\n * @example\n * ```typescript\n * import { OpenAICompatibleProvider } from '@quilltap/plugin-utils';\n *\n * export class MyCustomProvider extends OpenAICompatibleProvider {\n *   constructor() {\n *     super({\n *       baseUrl: 'https://api.my-service.com/v1',\n *       providerName: 'MyService',\n *       requireApiKey: true,\n *       attachmentErrorMessage: 'MyService does not support file attachments',\n *     });\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport OpenAI from 'openai';\nimport type {\n  TextProvider,\n  LLMParams,\n  LLMResponse,\n  StreamChunk,\n  PluginLogger,\n} from '@quilltap/plugin-types';\nimport { createPluginLogger } from '../logging';\nimport { getQuilltapUserAgent } from '../version';\n\n/**\n * Configuration options for OpenAI-compatible providers.\n *\n * Use this interface when extending OpenAICompatibleProvider to customize\n * the provider's behavior for your specific service.\n */\nexport interface OpenAICompatibleProviderConfig {\n  /**\n   * Base URL for the API endpoint.\n   * Should include the version path (e.g., 'https://api.example.com/v1')\n   */\n  baseUrl: string;\n\n  /**\n   * Provider name used for logging context.\n   * This appears in log messages to identify which provider generated them.\n   * @default 'OpenAICompatible'\n   */\n  providerName?: string;\n\n  /**\n   * Whether an API key is required for this provider.\n   * If true, requests will fail with an error when no API key is provided.\n   * If false, requests will use 'not-needed' as the API key (for local servers).\n   * @default false\n   */\n  requireApiKey?: boolean;\n\n  /**\n   * Custom error message shown when file attachments are attempted.\n   * @default 'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)'\n   */\n  attachmentErrorMessage?: string;\n}\n\n/**\n * Base provider class for OpenAI-compatible APIs.\n *\n * This class implements the full LLMProvider interface using the OpenAI SDK,\n * allowing subclasses to create custom providers with just configuration.\n *\n * Features:\n * - Streaming and non-streaming chat completions\n * - API key validation\n * - Model listing\n * - Configurable API key requirements\n * - Dynamic logging with provider name context\n *\n * @remarks\n * File attachments and image generation are not supported by default,\n * as support varies across OpenAI-compatible implementations.\n */\nexport class OpenAICompatibleProvider implements TextProvider {\n  /** File attachments are not supported by default */\n  readonly supportsFileAttachments = false;\n  /** No MIME types are supported for attachments */\n  readonly supportedMimeTypes: string[] = [];\n  /** Web search is not supported */\n  readonly supportsWebSearch = false;\n\n  /** Base URL for the API endpoint */\n  protected readonly baseUrl: string;\n  /** Provider name for logging */\n  protected readonly providerName: string;\n  /** Whether API key is required */\n  protected readonly requireApiKey: boolean;\n  /** Error message for attachment failures */\n  protected readonly attachmentErrorMessage: string;\n  /** Logger instance */\n  protected readonly logger: PluginLogger;\n\n  /**\n   * Creates a new OpenAI-compatible provider instance.\n   *\n   * @param config - Configuration object or base URL string (for backward compatibility)\n   */\n  constructor(config: string | OpenAICompatibleProviderConfig) {\n    // Support both legacy string baseUrl and new config object\n    if (typeof config === 'string') {\n      this.baseUrl = config;\n      this.providerName = 'OpenAICompatible';\n      this.requireApiKey = false;\n      this.attachmentErrorMessage =\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    } else {\n      this.baseUrl = config.baseUrl;\n      this.providerName = config.providerName ?? 'OpenAICompatible';\n      this.requireApiKey = config.requireApiKey ?? false;\n      this.attachmentErrorMessage =\n        config.attachmentErrorMessage ??\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    }\n\n    this.logger = createPluginLogger(`${this.providerName}Provider`);\n  }\n\n  /**\n   * Collects attachment failures for messages with attachments.\n   * Since attachments are not supported, all attachments are marked as failed.\n   *\n   * @param params - LLM parameters containing messages\n   * @returns Object with empty sent array and failed attachments\n   */\n  protected collectAttachmentFailures(\n    params: LLMParams\n  ): { sent: string[]; failed: { id: string; error: string }[] } {\n    const failed: { id: string; error: string }[] = [];\n    for (const msg of params.messages) {\n      if (msg.attachments) {\n        for (const attachment of msg.attachments) {\n          failed.push({\n            id: attachment.id,\n            error: this.attachmentErrorMessage,\n          });\n        }\n      }\n    }\n    return { sent: [], failed };\n  }\n\n  /**\n   * Validates that an API key is provided when required.\n   * @throws Error if API key is required but not provided\n   */\n  protected validateApiKeyRequirement(apiKey: string): void {\n    if (this.requireApiKey && !apiKey) {\n      throw new Error(`${this.providerName} provider requires an API key`);\n    }\n  }\n\n  /**\n   * Gets the effective API key to use for requests.\n   * Returns 'not-needed' for providers that don't require keys.\n   */\n  protected getEffectiveApiKey(apiKey: string): string {\n    return this.requireApiKey ? apiKey : apiKey || 'not-needed';\n  }\n\n  /**\n   * Creates an OpenAI client configured with the provider's base URL,\n   * API key, and Quilltap User-Agent header.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Configured OpenAI client instance\n   */\n  protected createClient(apiKey: string): OpenAI {\n    return new OpenAI({\n      apiKey: this.getEffectiveApiKey(apiKey),\n      baseURL: this.baseUrl,\n      defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n    });\n  }\n\n  /**\n   * Sends a message and returns the complete response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @returns Complete LLM response with content and usage statistics\n   */\n  async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const response = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stop: params.stop,\n      });\n\n      const choice = response.choices[0];\n      return {\n        content: choice.message.content ?? '',\n        finishReason: choice.finish_reason,\n        usage: {\n          promptTokens: response.usage?.prompt_tokens ?? 0,\n          completionTokens: response.usage?.completion_tokens ?? 0,\n          totalTokens: response.usage?.total_tokens ?? 0,\n        },\n        raw: response,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in sendMessage`,\n        { context: `${this.providerName}Provider.sendMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Sends a message and streams the response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @yields Stream chunks with content and final usage statistics\n   */\n  async *streamMessage(params: LLMParams, apiKey: string): AsyncGenerator<StreamChunk> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const stream = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stream: true,\n        stream_options: { include_usage: true },\n      });\n\n      let chunkCount = 0;\n\n      // Track usage - it may come in a separate final chunk\n      let accumulatedUsage: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number } | null = null;\n\n      for await (const chunk of stream) {\n        chunkCount++;\n        const content = chunk.choices[0]?.delta?.content;\n        const hasUsage = chunk.usage;\n\n        // Track usage when we get it (may come in a separate final chunk)\n        if (hasUsage) {\n          accumulatedUsage = {\n            prompt_tokens: chunk.usage?.prompt_tokens,\n            completion_tokens: chunk.usage?.completion_tokens,\n            total_tokens: chunk.usage?.total_tokens,\n          };\n        }\n\n        // Yield content chunks\n        if (content) {\n          yield {\n            content,\n            done: false,\n          };\n        }\n      }\n\n      // After stream ends, yield final chunk with accumulated usage\n      yield {\n        content: '',\n        done: true,\n        usage: accumulatedUsage ? {\n          promptTokens: accumulatedUsage.prompt_tokens ?? 0,\n          completionTokens: accumulatedUsage.completion_tokens ?? 0,\n          totalTokens: accumulatedUsage.total_tokens ?? 0,\n        } : undefined,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in streamMessage`,\n        { context: `${this.providerName}Provider.streamMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Validates an API key by attempting to list models.\n   *\n   * @param apiKey - API key to validate\n   * @returns true if the API key is valid, false otherwise\n   */\n  async validateApiKey(apiKey: string): Promise<boolean> {\n    // For providers that require API key, return false if not provided\n    if (this.requireApiKey && !apiKey) {\n      return false;\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      await client.models.list();\n      return true;\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API validation failed`,\n        { context: `${this.providerName}Provider.validateApiKey`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return false;\n    }\n  }\n\n  /**\n   * Fetches available models from the API.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Sorted array of model IDs, or empty array on failure\n   */\n  async getAvailableModels(apiKey: string): Promise<string[]> {\n    // For providers that require API key, return empty if not provided\n    if (this.requireApiKey && !apiKey) {\n      this.logger.error(`${this.providerName} provider requires an API key to fetch models`, {\n        context: `${this.providerName}Provider.getAvailableModels`,\n      });\n      return [];\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      const models = await client.models.list();\n      const modelList = models.data.map((m) => m.id).sort();\n      return modelList;\n    } catch (error) {\n      this.logger.error(\n        `Failed to fetch ${this.providerName} models`,\n        { context: `${this.providerName}Provider.getAvailableModels`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return [];\n    }\n  }\n\n}\n","/**\n * Plugin Logger Bridge\n *\n * Provides a logger factory for plugins that automatically bridges\n * to Quilltap's core logging when running inside the host application,\n * or falls back to console logging when running standalone.\n *\n * @module @quilltap/plugin-utils/logging/plugin-logger\n */\n\nimport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n/**\n * Extended logger interface with child logger support\n */\nexport interface PluginLoggerWithChild extends PluginLogger {\n  /**\n   * Create a child logger with additional context\n   * @param additionalContext Context to merge with parent context\n   * @returns A new logger with combined context\n   */\n  child(additionalContext: LogContext): PluginLoggerWithChild;\n}\n\n/**\n * Type for the global Quilltap logger bridge\n * Stored on globalThis to work across different npm package copies\n */\ndeclare global {\n   \n  var __quilltap_logger_factory:\n    | ((pluginName: string) => PluginLoggerWithChild)\n    | undefined;\n}\n\n/**\n * Get the core logger factory from global namespace\n *\n * @returns The injected factory or null if not in Quilltap environment\n */\nfunction getCoreLoggerFactory(): ((pluginName: string) => PluginLoggerWithChild) | null {\n  return globalThis.__quilltap_logger_factory ?? null;\n}\n\n/**\n * Inject the core logger factory from Quilltap host\n *\n * This is called by Quilltap core when loading plugins to bridge\n * plugin logging into the host's logging system. Uses globalThis\n * to ensure it works even when plugins have their own copy of\n * plugin-utils in their node_modules.\n *\n * **Internal API - not for plugin use**\n *\n * @param factory A function that creates a child logger for a plugin\n */\nexport function __injectCoreLoggerFactory(\n  factory: (pluginName: string) => PluginLoggerWithChild\n): void {\n  globalThis.__quilltap_logger_factory = factory;\n}\n\n/**\n * Clear the injected core logger factory\n *\n * Useful for testing or when unloading the plugin system.\n *\n * **Internal API - not for plugin use**\n */\nexport function __clearCoreLoggerFactory(): void {\n  globalThis.__quilltap_logger_factory = undefined;\n}\n\n/**\n * Check if a core logger has been injected\n *\n * @returns True if running inside Quilltap with core logging available\n */\nexport function hasCoreLogger(): boolean {\n  return getCoreLoggerFactory() !== null;\n}\n\n/**\n * Create a console logger with child support\n *\n * @param prefix Logger prefix\n * @param minLevel Minimum log level\n * @param baseContext Base context to include in all logs\n */\nfunction createConsoleLoggerWithChild(\n  prefix: string,\n  minLevel: LogLevel = 'debug',\n  baseContext: LogContext = {}\n): PluginLoggerWithChild {\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    const merged = { ...baseContext, ...context };\n    const entries = Object.entries(merged)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  const logger: PluginLoggerWithChild = {\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    child: (additionalContext: LogContext): PluginLoggerWithChild => {\n      return createConsoleLoggerWithChild(prefix, minLevel, {\n        ...baseContext,\n        ...additionalContext,\n      });\n    },\n  };\n\n  return logger;\n}\n\n/**\n * Create a plugin logger that bridges to Quilltap core logging\n *\n * When running inside Quilltap:\n * - Routes all logs to the core logger\n * - Tags logs with `{ plugin: pluginName, module: 'plugin' }`\n * - Logs appear in Quilltap's combined.log and console\n *\n * When running standalone:\n * - Falls back to console logging with `[pluginName]` prefix\n * - Respects the specified minimum log level\n *\n * @param pluginName - The plugin identifier (e.g., 'qtap-plugin-openai')\n * @param minLevel - Minimum log level when running standalone (default: 'debug')\n * @returns A logger instance\n *\n * @example\n * ```typescript\n * // In your plugin's provider.ts\n * import { createPluginLogger } from '@quilltap/plugin-utils';\n *\n * const logger = createPluginLogger('qtap-plugin-my-provider');\n *\n * export class MyProvider implements LLMProvider {\n *   async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n *     logger.debug('Sending message', { model: params.model });\n *\n *     try {\n *       const response = await this.client.chat({...});\n *       logger.info('Received response', { tokens: response.usage?.total_tokens });\n *       return response;\n *     } catch (error) {\n *       logger.error('Failed to send message', { model: params.model }, error as Error);\n *       throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport function createPluginLogger(\n  pluginName: string,\n  minLevel: LogLevel = 'debug'\n): PluginLoggerWithChild {\n  // Check for core logger factory from global namespace\n  const coreFactory = getCoreLoggerFactory();\n  if (coreFactory) {\n    return coreFactory(pluginName);\n  }\n\n  // Standalone mode: use enhanced console logger\n  return createConsoleLoggerWithChild(pluginName, minLevel);\n}\n\n/**\n * Get the minimum log level from environment\n *\n * Checks for LOG_LEVEL or QUILLTAP_LOG_LEVEL environment variables.\n * Useful for configuring standalone plugin logging.\n *\n * @returns The configured log level, or 'info' as default\n */\nexport function getLogLevelFromEnv(): LogLevel {\n  if (typeof process !== 'undefined' && process.env) {\n    const envLevel = process.env.LOG_LEVEL || process.env.QUILLTAP_LOG_LEVEL;\n    if (envLevel && ['debug', 'info', 'warn', 'error'].includes(envLevel)) {\n      return envLevel as LogLevel;\n    }\n  }\n  return 'info';\n}\n","/**\n * Logging Utilities\n *\n * Exports the plugin logger bridge and related utilities.\n *\n * @module @quilltap/plugin-utils/logging\n */\n\nexport {\n  createPluginLogger,\n  hasCoreLogger,\n  getLogLevelFromEnv,\n  __injectCoreLoggerFactory,\n  __clearCoreLoggerFactory,\n} from './plugin-logger';\n\nexport type { PluginLoggerWithChild } from './plugin-logger';\n\n// Re-export logger types from plugin-types\nexport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n// Re-export logger utilities from plugin-types for convenience\nexport { createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';\n","/**\n * Quilltap Version Management\n *\n * Provides access to the Quilltap application version for plugins.\n * Uses the same globalThis injection pattern as the logger factory,\n * allowing the host app to inject its version at startup.\n *\n * @module @quilltap/plugin-utils/version\n */\n\n/**\n * Global key used to store the injected Quilltap version.\n * Must match the key used by the host app's injection code.\n */\nconst GLOBAL_VERSION_KEY = '__quilltap_app_version';\n\n/**\n * Inject the Quilltap application version into the global namespace.\n *\n * This should be called early in plugin initialization (alongside the\n * logger factory injection), before any plugins are loaded. Plugins\n * can then retrieve the version via `getQuilltapVersion()`.\n *\n * @param version - The Quilltap application version string (e.g., '3.3.0')\n *\n * @example\n * ```typescript\n * import { __injectQuilltapVersion } from '@quilltap/plugin-utils';\n * import packageJson from './package.json';\n *\n * __injectQuilltapVersion(packageJson.version);\n * ```\n */\nexport function __injectQuilltapVersion(version: string): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = version;\n}\n\n/**\n * Clear the injected Quilltap version from the global namespace.\n *\n * Useful for testing or cleanup.\n */\nexport function __clearQuilltapVersion(): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = undefined;\n}\n\n/**\n * Get the Quilltap application version.\n *\n * Returns the version injected by the host app, or 'unknown' if\n * no version has been injected (e.g., running outside of Quilltap).\n *\n * @returns The Quilltap version string (e.g., '3.3.0') or 'unknown'\n */\nexport function getQuilltapVersion(): string {\n  const version = (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY];\n  return typeof version === 'string' ? version : 'unknown';\n}\n\n/**\n * Get the Quilltap User-Agent string for API requests.\n *\n * Returns a string in the format `Quilltap/{version}` suitable for\n * use as a User-Agent header or app identifier in API calls.\n *\n * @returns User-Agent string (e.g., 'Quilltap/3.3.0')\n *\n * @example\n * ```typescript\n * import { getQuilltapUserAgent } from '@quilltap/plugin-utils';\n *\n * const client = new OpenAI({\n *   apiKey,\n *   defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n * });\n * ```\n */\nexport function getQuilltapUserAgent(): string {\n  return `Quilltap/${getQuilltapVersion()}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC6BA,oBAAmB;;;ACWnB,SAAS,uBAA+E;AACtF,SAAO,WAAW,6BAA6B;AACjD;AA+CA,SAAS,6BACP,QACA,WAAqB,SACrB,cAA0B,CAAC,GACJ;AACvB,QAAM,SAAqB,CAAC,SAAS,QAAQ,QAAQ,OAAO;AAC5D,QAAM,YAAY,CAAC,UACjB,OAAO,QAAQ,KAAK,KAAK,OAAO,QAAQ,QAAQ;AAElD,QAAM,gBAAgB,CAAC,YAAiC;AACtD,UAAM,SAAS,EAAE,GAAG,aAAa,GAAG,QAAQ;AAC5C,UAAM,UAAU,OAAO,QAAQ,MAAM,EAClC,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,SAAS,EACnC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,GAAG,GAAG,IAAI,KAAK,UAAU,KAAK,CAAC,EAAE,EACvD,KAAK,GAAG;AACX,WAAO,UAAU,IAAI,OAAO,KAAK;AAAA,EACnC;AAEA,QAAM,SAAgC;AAAA,IACpC,OAAO,CAAC,SAAiB,YAA+B;AACtD,UAAI,UAAU,OAAO,GAAG;AACtB,gBAAQ,MAAM,IAAI,MAAM,KAAK,OAAO,GAAG,cAAc,OAAO,CAAC,EAAE;AAAA,MACjE;AAAA,IACF;AAAA,IAEA,MAAM,CAAC,SAAiB,YAA+B;AACrD,UAAI,UAAU,MAAM,GAAG;AACrB,gBAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,GAAG,cAAc,OAAO,CAAC,EAAE;AAAA,MAChE;AAAA,IACF;AAAA,IAEA,MAAM,CAAC,SAAiB,YAA+B;AACrD,UAAI,UAAU,MAAM,GAAG;AACrB,gBAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,GAAG,cAAc,OAAO,CAAC,EAAE;AAAA,MAChE;AAAA,IACF;AAAA,IAEA,OAAO,CAAC,SAAiB,SAAsB,UAAwB;AACrE,UAAI,UAAU,OAAO,GAAG;AACtB,gBAAQ;AAAA,UACN,IAAI,MAAM,KAAK,OAAO,GAAG,cAAc,OAAO,CAAC;AAAA,UAC/C,QAAQ;AAAA,EAAK,MAAM,SAAS,MAAM,OAAO,KAAK;AAAA,QAChD;AAAA,MACF;AAAA,IACF;AAAA,IAEA,OAAO,CAAC,sBAAyD;AAC/D,aAAO,6BAA6B,QAAQ,UAAU;AAAA,QACpD,GAAG;AAAA,QACH,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;AAyCO,SAAS,mBACd,YACA,WAAqB,SACE;AAEvB,QAAM,cAAc,qBAAqB;AACzC,MAAI,aAAa;AACf,WAAO,YAAY,UAAU;AAAA,EAC/B;AAGA,SAAO,6BAA6B,YAAY,QAAQ;AAC1D;;;AC/KA,0BAAsD;;;ACRtD,IAAM,qBAAqB;AAwCpB,SAAS,qBAA6B;AAC3C,QAAM,UAAW,WAAuC,kBAAkB;AAC1E,SAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAoBO,SAAS,uBAA+B;AAC7C,SAAO,YAAY,mBAAmB,CAAC;AACzC;;;AHaO,IAAM,2BAAN,MAAuD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwB5D,YAAY,QAAiD;AAtB7D;AAAA,SAAS,0BAA0B;AAEnC;AAAA,SAAS,qBAA+B,CAAC;AAEzC;AAAA,SAAS,oBAAoB;AAoB3B,QAAI,OAAO,WAAW,UAAU;AAC9B,WAAK,UAAU;AACf,WAAK,eAAe;AACpB,WAAK,gBAAgB;AACrB,WAAK,yBACH;AAAA,IACJ,OAAO;AACL,WAAK,UAAU,OAAO;AACtB,WAAK,eAAe,OAAO,gBAAgB;AAC3C,WAAK,gBAAgB,OAAO,iBAAiB;AAC7C,WAAK,yBACH,OAAO,0BACP;AAAA,IACJ;AAEA,SAAK,SAAS,mBAAmB,GAAG,KAAK,YAAY,UAAU;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASU,0BACR,QAC6D;AAC7D,UAAM,SAA0C,CAAC;AACjD,eAAW,OAAO,OAAO,UAAU;AACjC,UAAI,IAAI,aAAa;AACnB,mBAAW,cAAc,IAAI,aAAa;AACxC,iBAAO,KAAK;AAAA,YACV,IAAI,WAAW;AAAA,YACf,OAAO,KAAK;AAAA,UACd,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AACA,WAAO,EAAE,MAAM,CAAC,GAAG,OAAO;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,0BAA0B,QAAsB;AACxD,QAAI,KAAK,iBAAiB,CAAC,QAAQ;AACjC,YAAM,IAAI,MAAM,GAAG,KAAK,YAAY,+BAA+B;AAAA,IACrE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,mBAAmB,QAAwB;AACnD,WAAO,KAAK,gBAAgB,SAAS,UAAU;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASU,aAAa,QAAwB;AAC7C,WAAO,IAAI,cAAAA,QAAO;AAAA,MAChB,QAAQ,KAAK,mBAAmB,MAAM;AAAA,MACtC,SAAS,KAAK;AAAA,MACd,gBAAgB,EAAE,cAAc,qBAAqB,EAAE;AAAA,IACzD,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,YAAY,QAAmB,QAAsC;AACzE,SAAK,0BAA0B,MAAM;AACrC,UAAM,oBAAoB,KAAK,0BAA0B,MAAM;AAE/D,UAAM,SAAS,KAAK,aAAa,MAAM;AAGvC,UAAM,WAAW,OAAO,SACrB,OAAO,CAAC,MAAM;AAEb,UAAI,EAAE,SAAS,UAAU,CAAC,EAAE,WAAY,QAAO;AAC/C,aAAO;AAAA,IACT,CAAC,EACA,IAAI,CAAC,MAAM;AAEV,UAAI,EAAE,SAAS,UAAU,EAAE,YAAY;AACrC,eAAO;AAAA,UACL,MAAM;AAAA,UACN,cAAc,EAAE;AAAA,UAChB,SAAS,EAAE;AAAA,QACb;AAAA,MACF;AAEA,UAAI,EAAE,SAAS,eAAe,EAAE,aAAa,EAAE,UAAU,SAAS,GAAG;AACnE,eAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS,EAAE,WAAW;AAAA,UACtB,YAAY,EAAE,UAAU,IAAI,CAAC,QAAa;AAAA,YACxC,IAAI,GAAG;AAAA,YACP,MAAM,GAAG;AAAA,YACT,UAAU,GAAG;AAAA,UACf,EAAE;AAAA,QACJ;AAAA,MACF;AAEA,aAAO;AAAA,QACL,MAAM,EAAE;AAAA,QACR,SAAS,EAAE;AAAA,MACb;AAAA,IACF,CAAC;AAEH,QAAI;AACF,YAAM,WAAW,MAAM,OAAO,KAAK,YAAY,OAAO;AAAA,QACpD,OAAO,OAAO;AAAA,QACd;AAAA,QACA,aAAa,OAAO,eAAe;AAAA,QACnC,YAAY,OAAO,aAAa;AAAA,QAChC,OAAO,OAAO,QAAQ;AAAA,QACtB,MAAM,OAAO;AAAA,MACf,CAAC;AAED,YAAM,SAAS,SAAS,QAAQ,CAAC;AACjC,aAAO;AAAA,QACL,SAAS,OAAO,QAAQ,WAAW;AAAA,QACnC,cAAc,OAAO;AAAA,QACrB,OAAO;AAAA,UACL,cAAc,SAAS,OAAO,iBAAiB;AAAA,UAC/C,kBAAkB,SAAS,OAAO,qBAAqB;AAAA,UACvD,aAAa,SAAS,OAAO,gBAAgB;AAAA,QAC/C;AAAA,QACA,KAAK;AAAA,QACL;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,WAAK,OAAO;AAAA,QACV,GAAG,KAAK,YAAY;AAAA,QACpB,EAAE,SAAS,GAAG,KAAK,YAAY,wBAAwB,SAAS,KAAK,QAAQ;AAAA,QAC7E,iBAAiB,QAAQ,QAAQ;AAAA,MACnC;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,cAAc,QAAmB,QAA6C;AACnF,SAAK,0BAA0B,MAAM;AACrC,UAAM,oBAAoB,KAAK,0BAA0B,MAAM;AAE/D,UAAM,SAAS,KAAK,aAAa,MAAM;AAGvC,UAAM,WAAW,OAAO,SACrB,OAAO,CAAC,MAAM;AAEb,UAAI,EAAE,SAAS,UAAU,CAAC,EAAE,WAAY,QAAO;AAC/C,aAAO;AAAA,IACT,CAAC,EACA,IAAI,CAAC,MAAM;AAEV,UAAI,EAAE,SAAS,UAAU,EAAE,YAAY;AACrC,eAAO;AAAA,UACL,MAAM;AAAA,UACN,cAAc,EAAE;AAAA,UAChB,SAAS,EAAE;AAAA,QACb;AAAA,MACF;AAEA,UAAI,EAAE,SAAS,eAAe,EAAE,aAAa,EAAE,UAAU,SAAS,GAAG;AACnE,eAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS,EAAE,WAAW;AAAA,UACtB,YAAY,EAAE,UAAU,IAAI,CAAC,QAAa;AAAA,YACxC,IAAI,GAAG;AAAA,YACP,MAAM,GAAG;AAAA,YACT,UAAU,GAAG;AAAA,UACf,EAAE;AAAA,QACJ;AAAA,MACF;AAEA,aAAO;AAAA,QACL,MAAM,EAAE;AAAA,QACR,SAAS,EAAE;AAAA,MACb;AAAA,IACF,CAAC;AAEH,QAAI;AACF,YAAM,SAAS,MAAM,OAAO,KAAK,YAAY,OAAO;AAAA,QAClD,OAAO,OAAO;AAAA,QACd;AAAA,QACA,aAAa,OAAO,eAAe;AAAA,QACnC,YAAY,OAAO,aAAa;AAAA,QAChC,OAAO,OAAO,QAAQ;AAAA,QACtB,QAAQ;AAAA,QACR,gBAAgB,EAAE,eAAe,KAAK;AAAA,MACxC,CAAC;AAED,UAAI,aAAa;AAGjB,UAAI,mBAAyG;AAE7G,uBAAiB,SAAS,QAAQ;AAChC;AACA,cAAM,UAAU,MAAM,QAAQ,CAAC,GAAG,OAAO;AACzC,cAAM,WAAW,MAAM;AAGvB,YAAI,UAAU;AACZ,6BAAmB;AAAA,YACjB,eAAe,MAAM,OAAO;AAAA,YAC5B,mBAAmB,MAAM,OAAO;AAAA,YAChC,cAAc,MAAM,OAAO;AAAA,UAC7B;AAAA,QACF;AAGA,YAAI,SAAS;AACX,gBAAM;AAAA,YACJ;AAAA,YACA,MAAM;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAGA,YAAM;AAAA,QACJ,SAAS;AAAA,QACT,MAAM;AAAA,QACN,OAAO,mBAAmB;AAAA,UACxB,cAAc,iBAAiB,iBAAiB;AAAA,UAChD,kBAAkB,iBAAiB,qBAAqB;AAAA,UACxD,aAAa,iBAAiB,gBAAgB;AAAA,QAChD,IAAI;AAAA,QACJ;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,WAAK,OAAO;AAAA,QACV,GAAG,KAAK,YAAY;AAAA,QACpB,EAAE,SAAS,GAAG,KAAK,YAAY,0BAA0B,SAAS,KAAK,QAAQ;AAAA,QAC/E,iBAAiB,QAAQ,QAAQ;AAAA,MACnC;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,eAAe,QAAkC;AAErD,QAAI,KAAK,iBAAiB,CAAC,QAAQ;AACjC,aAAO;AAAA,IACT;AAEA,QAAI;AACF,YAAM,SAAS,KAAK,aAAa,MAAM;AACvC,YAAM,OAAO,OAAO,KAAK;AACzB,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,OAAO;AAAA,QACV,GAAG,KAAK,YAAY;AAAA,QACpB,EAAE,SAAS,GAAG,KAAK,YAAY,2BAA2B,SAAS,KAAK,QAAQ;AAAA,QAChF,iBAAiB,QAAQ,QAAQ;AAAA,MACnC;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,mBAAmB,QAAmC;AAE1D,QAAI,KAAK,iBAAiB,CAAC,QAAQ;AACjC,WAAK,OAAO,MAAM,GAAG,KAAK,YAAY,iDAAiD;AAAA,QACrF,SAAS,GAAG,KAAK,YAAY;AAAA,MAC/B,CAAC;AACD,aAAO,CAAC;AAAA,IACV;AAEA,QAAI;AACF,YAAM,SAAS,KAAK,aAAa,MAAM;AACvC,YAAM,SAAS,MAAM,OAAO,OAAO,KAAK;AACxC,YAAM,YAAY,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK;AACpD,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,OAAO;AAAA,QACV,mBAAmB,KAAK,YAAY;AAAA,QACpC,EAAE,SAAS,GAAG,KAAK,YAAY,+BAA+B,SAAS,KAAK,QAAQ;AAAA,QACpF,iBAAiB,QAAQ,QAAQ;AAAA,MACnC;AACA,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAEF;","names":["OpenAI"]}

package/dist/providers/index.mjs

@@ -80,8 +80,6 @@ var OpenAICompatibleProvider = class {
     this.supportsFileAttachments = false;
     /** No MIME types are supported for attachments */
     this.supportedMimeTypes = [];
-    /** Image generation is not supported by default */
-    this.supportsImageGeneration = false;
     /** Web search is not supported */
     this.supportsWebSearch = false;
     if (typeof config === "string") {
@@ -353,15 +351,6 @@ var OpenAICompatibleProvider = class {
       return [];
     }
   }
-  /**
-   * Image generation is not supported by default.
-   * @throws Error indicating image generation is not supported
-   */
-  async generateImage(_params, _apiKey) {
-    throw new Error(
-      `${this.providerName} image generation support varies by implementation (not yet implemented)`
-    );
-  }
 };
 export {
   OpenAICompatibleProvider

package/dist/providers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/openai-compatible.ts","../../src/logging/plugin-logger.ts","../../src/logging/index.ts","../../src/version.ts"],"sourcesContent":["/**\n * OpenAI-Compatible Provider Base Class\n *\n * A reusable base class for building LLM providers that use OpenAI-compatible APIs.\n * This includes services like:\n * - Local LLM servers (LM Studio, vLLM, Text Generation Web UI, Ollama with OpenAI compat)\n * - Cloud services with OpenAI-compatible APIs (Gab AI, Together AI, Fireworks, etc.)\n *\n * External plugins can extend this class to create custom providers with minimal code:\n *\n * @example\n * ```typescript\n * import { OpenAICompatibleProvider } from '@quilltap/plugin-utils';\n *\n * export class MyCustomProvider extends OpenAICompatibleProvider {\n *   constructor() {\n *     super({\n *       baseUrl: 'https://api.my-service.com/v1',\n *       providerName: 'MyService',\n *       requireApiKey: true,\n *       attachmentErrorMessage: 'MyService does not support file attachments',\n *     });\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport OpenAI from 'openai';\nimport type {\n  LLMProvider,\n  LLMParams,\n  LLMResponse,\n  StreamChunk,\n  ImageGenParams,\n  ImageGenResponse,\n  PluginLogger,\n} from '@quilltap/plugin-types';\nimport { createPluginLogger } from '../logging';\nimport { getQuilltapUserAgent } from '../version';\n\n/**\n * Configuration options for OpenAI-compatible providers.\n *\n * Use this interface when extending OpenAICompatibleProvider to customize\n * the provider's behavior for your specific service.\n */\nexport interface OpenAICompatibleProviderConfig {\n  /**\n   * Base URL for the API endpoint.\n   * Should include the version path (e.g., 'https://api.example.com/v1')\n   */\n  baseUrl: string;\n\n  /**\n   * Provider name used for logging context.\n   * This appears in log messages to identify which provider generated them.\n   * @default 'OpenAICompatible'\n   */\n  providerName?: string;\n\n  /**\n   * Whether an API key is required for this provider.\n   * If true, requests will fail with an error when no API key is provided.\n   * If false, requests will use 'not-needed' as the API key (for local servers).\n   * @default false\n   */\n  requireApiKey?: boolean;\n\n  /**\n   * Custom error message shown when file attachments are attempted.\n   * @default 'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)'\n   */\n  attachmentErrorMessage?: string;\n}\n\n/**\n * Base provider class for OpenAI-compatible APIs.\n *\n * This class implements the full LLMProvider interface using the OpenAI SDK,\n * allowing subclasses to create custom providers with just configuration.\n *\n * Features:\n * - Streaming and non-streaming chat completions\n * - API key validation\n * - Model listing\n * - Configurable API key requirements\n * - Dynamic logging with provider name context\n *\n * @remarks\n * File attachments and image generation are not supported by default,\n * as support varies across OpenAI-compatible implementations.\n */\nexport class OpenAICompatibleProvider implements LLMProvider {\n  /** File attachments are not supported by default */\n  readonly supportsFileAttachments = false;\n  /** No MIME types are supported for attachments */\n  readonly supportedMimeTypes: string[] = [];\n  /** Image generation is not supported by default */\n  readonly supportsImageGeneration = false;\n  /** Web search is not supported */\n  readonly supportsWebSearch = false;\n\n  /** Base URL for the API endpoint */\n  protected readonly baseUrl: string;\n  /** Provider name for logging */\n  protected readonly providerName: string;\n  /** Whether API key is required */\n  protected readonly requireApiKey: boolean;\n  /** Error message for attachment failures */\n  protected readonly attachmentErrorMessage: string;\n  /** Logger instance */\n  protected readonly logger: PluginLogger;\n\n  /**\n   * Creates a new OpenAI-compatible provider instance.\n   *\n   * @param config - Configuration object or base URL string (for backward compatibility)\n   */\n  constructor(config: string | OpenAICompatibleProviderConfig) {\n    // Support both legacy string baseUrl and new config object\n    if (typeof config === 'string') {\n      this.baseUrl = config;\n      this.providerName = 'OpenAICompatible';\n      this.requireApiKey = false;\n      this.attachmentErrorMessage =\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    } else {\n      this.baseUrl = config.baseUrl;\n      this.providerName = config.providerName ?? 'OpenAICompatible';\n      this.requireApiKey = config.requireApiKey ?? false;\n      this.attachmentErrorMessage =\n        config.attachmentErrorMessage ??\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    }\n\n    this.logger = createPluginLogger(`${this.providerName}Provider`);\n  }\n\n  /**\n   * Collects attachment failures for messages with attachments.\n   * Since attachments are not supported, all attachments are marked as failed.\n   *\n   * @param params - LLM parameters containing messages\n   * @returns Object with empty sent array and failed attachments\n   */\n  protected collectAttachmentFailures(\n    params: LLMParams\n  ): { sent: string[]; failed: { id: string; error: string }[] } {\n    const failed: { id: string; error: string }[] = [];\n    for (const msg of params.messages) {\n      if (msg.attachments) {\n        for (const attachment of msg.attachments) {\n          failed.push({\n            id: attachment.id,\n            error: this.attachmentErrorMessage,\n          });\n        }\n      }\n    }\n    return { sent: [], failed };\n  }\n\n  /**\n   * Validates that an API key is provided when required.\n   * @throws Error if API key is required but not provided\n   */\n  protected validateApiKeyRequirement(apiKey: string): void {\n    if (this.requireApiKey && !apiKey) {\n      throw new Error(`${this.providerName} provider requires an API key`);\n    }\n  }\n\n  /**\n   * Gets the effective API key to use for requests.\n   * Returns 'not-needed' for providers that don't require keys.\n   */\n  protected getEffectiveApiKey(apiKey: string): string {\n    return this.requireApiKey ? apiKey : apiKey || 'not-needed';\n  }\n\n  /**\n   * Creates an OpenAI client configured with the provider's base URL,\n   * API key, and Quilltap User-Agent header.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Configured OpenAI client instance\n   */\n  protected createClient(apiKey: string): OpenAI {\n    return new OpenAI({\n      apiKey: this.getEffectiveApiKey(apiKey),\n      baseURL: this.baseUrl,\n      defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n    });\n  }\n\n  /**\n   * Sends a message and returns the complete response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @returns Complete LLM response with content and usage statistics\n   */\n  async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const response = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stop: params.stop,\n      });\n\n      const choice = response.choices[0];\n      return {\n        content: choice.message.content ?? '',\n        finishReason: choice.finish_reason,\n        usage: {\n          promptTokens: response.usage?.prompt_tokens ?? 0,\n          completionTokens: response.usage?.completion_tokens ?? 0,\n          totalTokens: response.usage?.total_tokens ?? 0,\n        },\n        raw: response,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in sendMessage`,\n        { context: `${this.providerName}Provider.sendMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Sends a message and streams the response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @yields Stream chunks with content and final usage statistics\n   */\n  async *streamMessage(params: LLMParams, apiKey: string): AsyncGenerator<StreamChunk> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const stream = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stream: true,\n        stream_options: { include_usage: true },\n      });\n\n      let chunkCount = 0;\n\n      // Track usage - it may come in a separate final chunk\n      let accumulatedUsage: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number } | null = null;\n\n      for await (const chunk of stream) {\n        chunkCount++;\n        const content = chunk.choices[0]?.delta?.content;\n        const hasUsage = chunk.usage;\n\n        // Track usage when we get it (may come in a separate final chunk)\n        if (hasUsage) {\n          accumulatedUsage = {\n            prompt_tokens: chunk.usage?.prompt_tokens,\n            completion_tokens: chunk.usage?.completion_tokens,\n            total_tokens: chunk.usage?.total_tokens,\n          };\n        }\n\n        // Yield content chunks\n        if (content) {\n          yield {\n            content,\n            done: false,\n          };\n        }\n      }\n\n      // After stream ends, yield final chunk with accumulated usage\n      yield {\n        content: '',\n        done: true,\n        usage: accumulatedUsage ? {\n          promptTokens: accumulatedUsage.prompt_tokens ?? 0,\n          completionTokens: accumulatedUsage.completion_tokens ?? 0,\n          totalTokens: accumulatedUsage.total_tokens ?? 0,\n        } : undefined,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in streamMessage`,\n        { context: `${this.providerName}Provider.streamMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Validates an API key by attempting to list models.\n   *\n   * @param apiKey - API key to validate\n   * @returns true if the API key is valid, false otherwise\n   */\n  async validateApiKey(apiKey: string): Promise<boolean> {\n    // For providers that require API key, return false if not provided\n    if (this.requireApiKey && !apiKey) {\n      return false;\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      await client.models.list();\n      return true;\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API validation failed`,\n        { context: `${this.providerName}Provider.validateApiKey`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return false;\n    }\n  }\n\n  /**\n   * Fetches available models from the API.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Sorted array of model IDs, or empty array on failure\n   */\n  async getAvailableModels(apiKey: string): Promise<string[]> {\n    // For providers that require API key, return empty if not provided\n    if (this.requireApiKey && !apiKey) {\n      this.logger.error(`${this.providerName} provider requires an API key to fetch models`, {\n        context: `${this.providerName}Provider.getAvailableModels`,\n      });\n      return [];\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      const models = await client.models.list();\n      const modelList = models.data.map((m) => m.id).sort();\n      return modelList;\n    } catch (error) {\n      this.logger.error(\n        `Failed to fetch ${this.providerName} models`,\n        { context: `${this.providerName}Provider.getAvailableModels`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return [];\n    }\n  }\n\n  /**\n   * Image generation is not supported by default.\n   * @throws Error indicating image generation is not supported\n   */\n  async generateImage(_params: ImageGenParams, _apiKey: string): Promise<ImageGenResponse> {\n    throw new Error(\n      `${this.providerName} image generation support varies by implementation (not yet implemented)`\n    );\n  }\n}\n","/**\n * Plugin Logger Bridge\n *\n * Provides a logger factory for plugins that automatically bridges\n * to Quilltap's core logging when running inside the host application,\n * or falls back to console logging when running standalone.\n *\n * @module @quilltap/plugin-utils/logging/plugin-logger\n */\n\nimport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n/**\n * Extended logger interface with child logger support\n */\nexport interface PluginLoggerWithChild extends PluginLogger {\n  /**\n   * Create a child logger with additional context\n   * @param additionalContext Context to merge with parent context\n   * @returns A new logger with combined context\n   */\n  child(additionalContext: LogContext): PluginLoggerWithChild;\n}\n\n/**\n * Type for the global Quilltap logger bridge\n * Stored on globalThis to work across different npm package copies\n */\ndeclare global {\n   \n  var __quilltap_logger_factory:\n    | ((pluginName: string) => PluginLoggerWithChild)\n    | undefined;\n}\n\n/**\n * Get the core logger factory from global namespace\n *\n * @returns The injected factory or null if not in Quilltap environment\n */\nfunction getCoreLoggerFactory(): ((pluginName: string) => PluginLoggerWithChild) | null {\n  return globalThis.__quilltap_logger_factory ?? null;\n}\n\n/**\n * Inject the core logger factory from Quilltap host\n *\n * This is called by Quilltap core when loading plugins to bridge\n * plugin logging into the host's logging system. Uses globalThis\n * to ensure it works even when plugins have their own copy of\n * plugin-utils in their node_modules.\n *\n * **Internal API - not for plugin use**\n *\n * @param factory A function that creates a child logger for a plugin\n */\nexport function __injectCoreLoggerFactory(\n  factory: (pluginName: string) => PluginLoggerWithChild\n): void {\n  globalThis.__quilltap_logger_factory = factory;\n}\n\n/**\n * Clear the injected core logger factory\n *\n * Useful for testing or when unloading the plugin system.\n *\n * **Internal API - not for plugin use**\n */\nexport function __clearCoreLoggerFactory(): void {\n  globalThis.__quilltap_logger_factory = undefined;\n}\n\n/**\n * Check if a core logger has been injected\n *\n * @returns True if running inside Quilltap with core logging available\n */\nexport function hasCoreLogger(): boolean {\n  return getCoreLoggerFactory() !== null;\n}\n\n/**\n * Create a console logger with child support\n *\n * @param prefix Logger prefix\n * @param minLevel Minimum log level\n * @param baseContext Base context to include in all logs\n */\nfunction createConsoleLoggerWithChild(\n  prefix: string,\n  minLevel: LogLevel = 'debug',\n  baseContext: LogContext = {}\n): PluginLoggerWithChild {\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    const merged = { ...baseContext, ...context };\n    const entries = Object.entries(merged)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  const logger: PluginLoggerWithChild = {\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    child: (additionalContext: LogContext): PluginLoggerWithChild => {\n      return createConsoleLoggerWithChild(prefix, minLevel, {\n        ...baseContext,\n        ...additionalContext,\n      });\n    },\n  };\n\n  return logger;\n}\n\n/**\n * Create a plugin logger that bridges to Quilltap core logging\n *\n * When running inside Quilltap:\n * - Routes all logs to the core logger\n * - Tags logs with `{ plugin: pluginName, module: 'plugin' }`\n * - Logs appear in Quilltap's combined.log and console\n *\n * When running standalone:\n * - Falls back to console logging with `[pluginName]` prefix\n * - Respects the specified minimum log level\n *\n * @param pluginName - The plugin identifier (e.g., 'qtap-plugin-openai')\n * @param minLevel - Minimum log level when running standalone (default: 'debug')\n * @returns A logger instance\n *\n * @example\n * ```typescript\n * // In your plugin's provider.ts\n * import { createPluginLogger } from '@quilltap/plugin-utils';\n *\n * const logger = createPluginLogger('qtap-plugin-my-provider');\n *\n * export class MyProvider implements LLMProvider {\n *   async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n *     logger.debug('Sending message', { model: params.model });\n *\n *     try {\n *       const response = await this.client.chat({...});\n *       logger.info('Received response', { tokens: response.usage?.total_tokens });\n *       return response;\n *     } catch (error) {\n *       logger.error('Failed to send message', { model: params.model }, error as Error);\n *       throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport function createPluginLogger(\n  pluginName: string,\n  minLevel: LogLevel = 'debug'\n): PluginLoggerWithChild {\n  // Check for core logger factory from global namespace\n  const coreFactory = getCoreLoggerFactory();\n  if (coreFactory) {\n    return coreFactory(pluginName);\n  }\n\n  // Standalone mode: use enhanced console logger\n  return createConsoleLoggerWithChild(pluginName, minLevel);\n}\n\n/**\n * Get the minimum log level from environment\n *\n * Checks for LOG_LEVEL or QUILLTAP_LOG_LEVEL environment variables.\n * Useful for configuring standalone plugin logging.\n *\n * @returns The configured log level, or 'info' as default\n */\nexport function getLogLevelFromEnv(): LogLevel {\n  if (typeof process !== 'undefined' && process.env) {\n    const envLevel = process.env.LOG_LEVEL || process.env.QUILLTAP_LOG_LEVEL;\n    if (envLevel && ['debug', 'info', 'warn', 'error'].includes(envLevel)) {\n      return envLevel as LogLevel;\n    }\n  }\n  return 'info';\n}\n","/**\n * Logging Utilities\n *\n * Exports the plugin logger bridge and related utilities.\n *\n * @module @quilltap/plugin-utils/logging\n */\n\nexport {\n  createPluginLogger,\n  hasCoreLogger,\n  getLogLevelFromEnv,\n  __injectCoreLoggerFactory,\n  __clearCoreLoggerFactory,\n} from './plugin-logger';\n\nexport type { PluginLoggerWithChild } from './plugin-logger';\n\n// Re-export logger types from plugin-types\nexport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n// Re-export logger utilities from plugin-types for convenience\nexport { createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';\n","/**\n * Quilltap Version Management\n *\n * Provides access to the Quilltap application version for plugins.\n * Uses the same globalThis injection pattern as the logger factory,\n * allowing the host app to inject its version at startup.\n *\n * @module @quilltap/plugin-utils/version\n */\n\n/**\n * Global key used to store the injected Quilltap version.\n * Must match the key used by the host app's injection code.\n */\nconst GLOBAL_VERSION_KEY = '__quilltap_app_version';\n\n/**\n * Inject the Quilltap application version into the global namespace.\n *\n * This should be called early in plugin initialization (alongside the\n * logger factory injection), before any plugins are loaded. Plugins\n * can then retrieve the version via `getQuilltapVersion()`.\n *\n * @param version - The Quilltap application version string (e.g., '3.3.0')\n *\n * @example\n * ```typescript\n * import { __injectQuilltapVersion } from '@quilltap/plugin-utils';\n * import packageJson from './package.json';\n *\n * __injectQuilltapVersion(packageJson.version);\n * ```\n */\nexport function __injectQuilltapVersion(version: string): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = version;\n}\n\n/**\n * Clear the injected Quilltap version from the global namespace.\n *\n * Useful for testing or cleanup.\n */\nexport function __clearQuilltapVersion(): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = undefined;\n}\n\n/**\n * Get the Quilltap application version.\n *\n * Returns the version injected by the host app, or 'unknown' if\n * no version has been injected (e.g., running outside of Quilltap).\n *\n * @returns The Quilltap version string (e.g., '3.3.0') or 'unknown'\n */\nexport function getQuilltapVersion(): string {\n  const version = (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY];\n  return typeof version === 'string' ? version : 'unknown';\n}\n\n/**\n * Get the Quilltap User-Agent string for API requests.\n *\n * Returns a string in the format `Quilltap/{version}` suitable for\n * use as a User-Agent header or app identifier in API calls.\n *\n * @returns User-Agent string (e.g., 'Quilltap/3.3.0')\n *\n * @example\n * ```typescript\n * import { getQuilltapUserAgent } from '@quilltap/plugin-utils';\n *\n * const client = new OpenAI({\n *   apiKey,\n *   defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n * });\n * ```\n */\nexport function getQuilltapUserAgent(): string {\n  return `Quilltap/${getQuilltapVersion()}`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/providers/openai-compatible.ts","../../src/logging/plugin-logger.ts","../../src/logging/index.ts","../../src/version.ts"],"sourcesContent":["/**\n * OpenAI-Compatible Provider Base Class\n *\n * A reusable base class for building LLM providers that use OpenAI-compatible APIs.\n * This includes services like:\n * - Local LLM servers (LM Studio, vLLM, Text Generation Web UI, Ollama with OpenAI compat)\n * - Cloud services with OpenAI-compatible APIs (Gab AI, Together AI, Fireworks, etc.)\n *\n * External plugins can extend this class to create custom providers with minimal code:\n *\n * @example\n * ```typescript\n * import { OpenAICompatibleProvider } from '@quilltap/plugin-utils';\n *\n * export class MyCustomProvider extends OpenAICompatibleProvider {\n *   constructor() {\n *     super({\n *       baseUrl: 'https://api.my-service.com/v1',\n *       providerName: 'MyService',\n *       requireApiKey: true,\n *       attachmentErrorMessage: 'MyService does not support file attachments',\n *     });\n *   }\n * }\n * ```\n *\n * @packageDocumentation\n */\n\nimport OpenAI from 'openai';\nimport type {\n  TextProvider,\n  LLMParams,\n  LLMResponse,\n  StreamChunk,\n  PluginLogger,\n} from '@quilltap/plugin-types';\nimport { createPluginLogger } from '../logging';\nimport { getQuilltapUserAgent } from '../version';\n\n/**\n * Configuration options for OpenAI-compatible providers.\n *\n * Use this interface when extending OpenAICompatibleProvider to customize\n * the provider's behavior for your specific service.\n */\nexport interface OpenAICompatibleProviderConfig {\n  /**\n   * Base URL for the API endpoint.\n   * Should include the version path (e.g., 'https://api.example.com/v1')\n   */\n  baseUrl: string;\n\n  /**\n   * Provider name used for logging context.\n   * This appears in log messages to identify which provider generated them.\n   * @default 'OpenAICompatible'\n   */\n  providerName?: string;\n\n  /**\n   * Whether an API key is required for this provider.\n   * If true, requests will fail with an error when no API key is provided.\n   * If false, requests will use 'not-needed' as the API key (for local servers).\n   * @default false\n   */\n  requireApiKey?: boolean;\n\n  /**\n   * Custom error message shown when file attachments are attempted.\n   * @default 'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)'\n   */\n  attachmentErrorMessage?: string;\n}\n\n/**\n * Base provider class for OpenAI-compatible APIs.\n *\n * This class implements the full LLMProvider interface using the OpenAI SDK,\n * allowing subclasses to create custom providers with just configuration.\n *\n * Features:\n * - Streaming and non-streaming chat completions\n * - API key validation\n * - Model listing\n * - Configurable API key requirements\n * - Dynamic logging with provider name context\n *\n * @remarks\n * File attachments and image generation are not supported by default,\n * as support varies across OpenAI-compatible implementations.\n */\nexport class OpenAICompatibleProvider implements TextProvider {\n  /** File attachments are not supported by default */\n  readonly supportsFileAttachments = false;\n  /** No MIME types are supported for attachments */\n  readonly supportedMimeTypes: string[] = [];\n  /** Web search is not supported */\n  readonly supportsWebSearch = false;\n\n  /** Base URL for the API endpoint */\n  protected readonly baseUrl: string;\n  /** Provider name for logging */\n  protected readonly providerName: string;\n  /** Whether API key is required */\n  protected readonly requireApiKey: boolean;\n  /** Error message for attachment failures */\n  protected readonly attachmentErrorMessage: string;\n  /** Logger instance */\n  protected readonly logger: PluginLogger;\n\n  /**\n   * Creates a new OpenAI-compatible provider instance.\n   *\n   * @param config - Configuration object or base URL string (for backward compatibility)\n   */\n  constructor(config: string | OpenAICompatibleProviderConfig) {\n    // Support both legacy string baseUrl and new config object\n    if (typeof config === 'string') {\n      this.baseUrl = config;\n      this.providerName = 'OpenAICompatible';\n      this.requireApiKey = false;\n      this.attachmentErrorMessage =\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    } else {\n      this.baseUrl = config.baseUrl;\n      this.providerName = config.providerName ?? 'OpenAICompatible';\n      this.requireApiKey = config.requireApiKey ?? false;\n      this.attachmentErrorMessage =\n        config.attachmentErrorMessage ??\n        'OpenAI-compatible provider file attachment support varies by implementation (not yet implemented)';\n    }\n\n    this.logger = createPluginLogger(`${this.providerName}Provider`);\n  }\n\n  /**\n   * Collects attachment failures for messages with attachments.\n   * Since attachments are not supported, all attachments are marked as failed.\n   *\n   * @param params - LLM parameters containing messages\n   * @returns Object with empty sent array and failed attachments\n   */\n  protected collectAttachmentFailures(\n    params: LLMParams\n  ): { sent: string[]; failed: { id: string; error: string }[] } {\n    const failed: { id: string; error: string }[] = [];\n    for (const msg of params.messages) {\n      if (msg.attachments) {\n        for (const attachment of msg.attachments) {\n          failed.push({\n            id: attachment.id,\n            error: this.attachmentErrorMessage,\n          });\n        }\n      }\n    }\n    return { sent: [], failed };\n  }\n\n  /**\n   * Validates that an API key is provided when required.\n   * @throws Error if API key is required but not provided\n   */\n  protected validateApiKeyRequirement(apiKey: string): void {\n    if (this.requireApiKey && !apiKey) {\n      throw new Error(`${this.providerName} provider requires an API key`);\n    }\n  }\n\n  /**\n   * Gets the effective API key to use for requests.\n   * Returns 'not-needed' for providers that don't require keys.\n   */\n  protected getEffectiveApiKey(apiKey: string): string {\n    return this.requireApiKey ? apiKey : apiKey || 'not-needed';\n  }\n\n  /**\n   * Creates an OpenAI client configured with the provider's base URL,\n   * API key, and Quilltap User-Agent header.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Configured OpenAI client instance\n   */\n  protected createClient(apiKey: string): OpenAI {\n    return new OpenAI({\n      apiKey: this.getEffectiveApiKey(apiKey),\n      baseURL: this.baseUrl,\n      defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n    });\n  }\n\n  /**\n   * Sends a message and returns the complete response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @returns Complete LLM response with content and usage statistics\n   */\n  async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const response = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stop: params.stop,\n      });\n\n      const choice = response.choices[0];\n      return {\n        content: choice.message.content ?? '',\n        finishReason: choice.finish_reason,\n        usage: {\n          promptTokens: response.usage?.prompt_tokens ?? 0,\n          completionTokens: response.usage?.completion_tokens ?? 0,\n          totalTokens: response.usage?.total_tokens ?? 0,\n        },\n        raw: response,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in sendMessage`,\n        { context: `${this.providerName}Provider.sendMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Sends a message and streams the response.\n   *\n   * @param params - LLM parameters including messages, model, and settings\n   * @param apiKey - API key for authentication\n   * @yields Stream chunks with content and final usage statistics\n   */\n  async *streamMessage(params: LLMParams, apiKey: string): AsyncGenerator<StreamChunk> {\n    this.validateApiKeyRequirement(apiKey);\n    const attachmentResults = this.collectAttachmentFailures(params);\n\n    const client = this.createClient(apiKey);\n\n    // Map messages to OpenAI Chat Completions format, including tool messages\n    const messages = params.messages\n      .filter((m) => {\n        // Skip tool messages without toolCallId (backward compat)\n        if (m.role === 'tool' && !m.toolCallId) return false;\n        return true;\n      })\n      .map((m) => {\n        // Tool result messages\n        if (m.role === 'tool' && m.toolCallId) {\n          return {\n            role: 'tool' as const,\n            tool_call_id: m.toolCallId as string,\n            content: m.content,\n          };\n        }\n        // Assistant messages with tool calls\n        if (m.role === 'assistant' && m.toolCalls && m.toolCalls.length > 0) {\n          return {\n            role: 'assistant' as const,\n            content: m.content || null,\n            tool_calls: m.toolCalls.map((tc: any) => ({\n              id: tc.id,\n              type: tc.type,\n              function: tc.function,\n            })),\n          };\n        }\n        // Standard messages (strip attachments)\n        return {\n          role: m.role as 'system' | 'user' | 'assistant',\n          content: m.content,\n        };\n      });\n\n    try {\n      const stream = await client.chat.completions.create({\n        model: params.model,\n        messages,\n        temperature: params.temperature ?? 0.7,\n        max_tokens: params.maxTokens ?? 4096,\n        top_p: params.topP ?? 1,\n        stream: true,\n        stream_options: { include_usage: true },\n      });\n\n      let chunkCount = 0;\n\n      // Track usage - it may come in a separate final chunk\n      let accumulatedUsage: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number } | null = null;\n\n      for await (const chunk of stream) {\n        chunkCount++;\n        const content = chunk.choices[0]?.delta?.content;\n        const hasUsage = chunk.usage;\n\n        // Track usage when we get it (may come in a separate final chunk)\n        if (hasUsage) {\n          accumulatedUsage = {\n            prompt_tokens: chunk.usage?.prompt_tokens,\n            completion_tokens: chunk.usage?.completion_tokens,\n            total_tokens: chunk.usage?.total_tokens,\n          };\n        }\n\n        // Yield content chunks\n        if (content) {\n          yield {\n            content,\n            done: false,\n          };\n        }\n      }\n\n      // After stream ends, yield final chunk with accumulated usage\n      yield {\n        content: '',\n        done: true,\n        usage: accumulatedUsage ? {\n          promptTokens: accumulatedUsage.prompt_tokens ?? 0,\n          completionTokens: accumulatedUsage.completion_tokens ?? 0,\n          totalTokens: accumulatedUsage.total_tokens ?? 0,\n        } : undefined,\n        attachmentResults,\n      };\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API error in streamMessage`,\n        { context: `${this.providerName}Provider.streamMessage`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Validates an API key by attempting to list models.\n   *\n   * @param apiKey - API key to validate\n   * @returns true if the API key is valid, false otherwise\n   */\n  async validateApiKey(apiKey: string): Promise<boolean> {\n    // For providers that require API key, return false if not provided\n    if (this.requireApiKey && !apiKey) {\n      return false;\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      await client.models.list();\n      return true;\n    } catch (error) {\n      this.logger.error(\n        `${this.providerName} API validation failed`,\n        { context: `${this.providerName}Provider.validateApiKey`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return false;\n    }\n  }\n\n  /**\n   * Fetches available models from the API.\n   *\n   * @param apiKey - API key for authentication\n   * @returns Sorted array of model IDs, or empty array on failure\n   */\n  async getAvailableModels(apiKey: string): Promise<string[]> {\n    // For providers that require API key, return empty if not provided\n    if (this.requireApiKey && !apiKey) {\n      this.logger.error(`${this.providerName} provider requires an API key to fetch models`, {\n        context: `${this.providerName}Provider.getAvailableModels`,\n      });\n      return [];\n    }\n\n    try {\n      const client = this.createClient(apiKey);\n      const models = await client.models.list();\n      const modelList = models.data.map((m) => m.id).sort();\n      return modelList;\n    } catch (error) {\n      this.logger.error(\n        `Failed to fetch ${this.providerName} models`,\n        { context: `${this.providerName}Provider.getAvailableModels`, baseUrl: this.baseUrl },\n        error instanceof Error ? error : undefined\n      );\n      return [];\n    }\n  }\n\n}\n","/**\n * Plugin Logger Bridge\n *\n * Provides a logger factory for plugins that automatically bridges\n * to Quilltap's core logging when running inside the host application,\n * or falls back to console logging when running standalone.\n *\n * @module @quilltap/plugin-utils/logging/plugin-logger\n */\n\nimport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n/**\n * Extended logger interface with child logger support\n */\nexport interface PluginLoggerWithChild extends PluginLogger {\n  /**\n   * Create a child logger with additional context\n   * @param additionalContext Context to merge with parent context\n   * @returns A new logger with combined context\n   */\n  child(additionalContext: LogContext): PluginLoggerWithChild;\n}\n\n/**\n * Type for the global Quilltap logger bridge\n * Stored on globalThis to work across different npm package copies\n */\ndeclare global {\n   \n  var __quilltap_logger_factory:\n    | ((pluginName: string) => PluginLoggerWithChild)\n    | undefined;\n}\n\n/**\n * Get the core logger factory from global namespace\n *\n * @returns The injected factory or null if not in Quilltap environment\n */\nfunction getCoreLoggerFactory(): ((pluginName: string) => PluginLoggerWithChild) | null {\n  return globalThis.__quilltap_logger_factory ?? null;\n}\n\n/**\n * Inject the core logger factory from Quilltap host\n *\n * This is called by Quilltap core when loading plugins to bridge\n * plugin logging into the host's logging system. Uses globalThis\n * to ensure it works even when plugins have their own copy of\n * plugin-utils in their node_modules.\n *\n * **Internal API - not for plugin use**\n *\n * @param factory A function that creates a child logger for a plugin\n */\nexport function __injectCoreLoggerFactory(\n  factory: (pluginName: string) => PluginLoggerWithChild\n): void {\n  globalThis.__quilltap_logger_factory = factory;\n}\n\n/**\n * Clear the injected core logger factory\n *\n * Useful for testing or when unloading the plugin system.\n *\n * **Internal API - not for plugin use**\n */\nexport function __clearCoreLoggerFactory(): void {\n  globalThis.__quilltap_logger_factory = undefined;\n}\n\n/**\n * Check if a core logger has been injected\n *\n * @returns True if running inside Quilltap with core logging available\n */\nexport function hasCoreLogger(): boolean {\n  return getCoreLoggerFactory() !== null;\n}\n\n/**\n * Create a console logger with child support\n *\n * @param prefix Logger prefix\n * @param minLevel Minimum log level\n * @param baseContext Base context to include in all logs\n */\nfunction createConsoleLoggerWithChild(\n  prefix: string,\n  minLevel: LogLevel = 'debug',\n  baseContext: LogContext = {}\n): PluginLoggerWithChild {\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    const merged = { ...baseContext, ...context };\n    const entries = Object.entries(merged)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  const logger: PluginLoggerWithChild = {\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    child: (additionalContext: LogContext): PluginLoggerWithChild => {\n      return createConsoleLoggerWithChild(prefix, minLevel, {\n        ...baseContext,\n        ...additionalContext,\n      });\n    },\n  };\n\n  return logger;\n}\n\n/**\n * Create a plugin logger that bridges to Quilltap core logging\n *\n * When running inside Quilltap:\n * - Routes all logs to the core logger\n * - Tags logs with `{ plugin: pluginName, module: 'plugin' }`\n * - Logs appear in Quilltap's combined.log and console\n *\n * When running standalone:\n * - Falls back to console logging with `[pluginName]` prefix\n * - Respects the specified minimum log level\n *\n * @param pluginName - The plugin identifier (e.g., 'qtap-plugin-openai')\n * @param minLevel - Minimum log level when running standalone (default: 'debug')\n * @returns A logger instance\n *\n * @example\n * ```typescript\n * // In your plugin's provider.ts\n * import { createPluginLogger } from '@quilltap/plugin-utils';\n *\n * const logger = createPluginLogger('qtap-plugin-my-provider');\n *\n * export class MyProvider implements LLMProvider {\n *   async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {\n *     logger.debug('Sending message', { model: params.model });\n *\n *     try {\n *       const response = await this.client.chat({...});\n *       logger.info('Received response', { tokens: response.usage?.total_tokens });\n *       return response;\n *     } catch (error) {\n *       logger.error('Failed to send message', { model: params.model }, error as Error);\n *       throw error;\n *     }\n *   }\n * }\n * ```\n */\nexport function createPluginLogger(\n  pluginName: string,\n  minLevel: LogLevel = 'debug'\n): PluginLoggerWithChild {\n  // Check for core logger factory from global namespace\n  const coreFactory = getCoreLoggerFactory();\n  if (coreFactory) {\n    return coreFactory(pluginName);\n  }\n\n  // Standalone mode: use enhanced console logger\n  return createConsoleLoggerWithChild(pluginName, minLevel);\n}\n\n/**\n * Get the minimum log level from environment\n *\n * Checks for LOG_LEVEL or QUILLTAP_LOG_LEVEL environment variables.\n * Useful for configuring standalone plugin logging.\n *\n * @returns The configured log level, or 'info' as default\n */\nexport function getLogLevelFromEnv(): LogLevel {\n  if (typeof process !== 'undefined' && process.env) {\n    const envLevel = process.env.LOG_LEVEL || process.env.QUILLTAP_LOG_LEVEL;\n    if (envLevel && ['debug', 'info', 'warn', 'error'].includes(envLevel)) {\n      return envLevel as LogLevel;\n    }\n  }\n  return 'info';\n}\n","/**\n * Logging Utilities\n *\n * Exports the plugin logger bridge and related utilities.\n *\n * @module @quilltap/plugin-utils/logging\n */\n\nexport {\n  createPluginLogger,\n  hasCoreLogger,\n  getLogLevelFromEnv,\n  __injectCoreLoggerFactory,\n  __clearCoreLoggerFactory,\n} from './plugin-logger';\n\nexport type { PluginLoggerWithChild } from './plugin-logger';\n\n// Re-export logger types from plugin-types\nexport type { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';\n\n// Re-export logger utilities from plugin-types for convenience\nexport { createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';\n","/**\n * Quilltap Version Management\n *\n * Provides access to the Quilltap application version for plugins.\n * Uses the same globalThis injection pattern as the logger factory,\n * allowing the host app to inject its version at startup.\n *\n * @module @quilltap/plugin-utils/version\n */\n\n/**\n * Global key used to store the injected Quilltap version.\n * Must match the key used by the host app's injection code.\n */\nconst GLOBAL_VERSION_KEY = '__quilltap_app_version';\n\n/**\n * Inject the Quilltap application version into the global namespace.\n *\n * This should be called early in plugin initialization (alongside the\n * logger factory injection), before any plugins are loaded. Plugins\n * can then retrieve the version via `getQuilltapVersion()`.\n *\n * @param version - The Quilltap application version string (e.g., '3.3.0')\n *\n * @example\n * ```typescript\n * import { __injectQuilltapVersion } from '@quilltap/plugin-utils';\n * import packageJson from './package.json';\n *\n * __injectQuilltapVersion(packageJson.version);\n * ```\n */\nexport function __injectQuilltapVersion(version: string): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = version;\n}\n\n/**\n * Clear the injected Quilltap version from the global namespace.\n *\n * Useful for testing or cleanup.\n */\nexport function __clearQuilltapVersion(): void {\n  (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY] = undefined;\n}\n\n/**\n * Get the Quilltap application version.\n *\n * Returns the version injected by the host app, or 'unknown' if\n * no version has been injected (e.g., running outside of Quilltap).\n *\n * @returns The Quilltap version string (e.g., '3.3.0') or 'unknown'\n */\nexport function getQuilltapVersion(): string {\n  const version = (globalThis as Record<string, unknown>)[GLOBAL_VERSION_KEY];\n  return typeof version === 'string' ? version : 'unknown';\n}\n\n/**\n * Get the Quilltap User-Agent string for API requests.\n *\n * Returns a string in the format `Quilltap/{version}` suitable for\n * use as a User-Agent header or app identifier in API calls.\n *\n * @returns User-Agent string (e.g., 'Quilltap/3.3.0')\n *\n * @example\n * ```typescript\n * import { getQuilltapUserAgent } from '@quilltap/plugin-utils';\n *\n * const client = new OpenAI({\n *   apiKey,\n *   defaultHeaders: { 'User-Agent': getQuilltapUserAgent() },\n * });\n * ```\n */\nexport function getQuilltapUserAgent(): string {\n  return `Quilltap/${getQuilltapVersion()}`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quilltap/plugin-utils",
-  "version": "1.7.0",
+  "version": "2.0.0",
   "description": "Utility functions for Quilltap plugin development",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -54,7 +54,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@quilltap/plugin-types": "^1.18.0"
+    "@quilltap/plugin-types": "^2.0.0"
   },
   "peerDependencies": {
     "openai": "^4.0.0 || ^5.0.0 || ^6.0.0"
@@ -68,7 +68,7 @@
     }
   },
   "devDependencies": {
-    "openai": "^6.32.0",
+    "openai": "^6.33.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },