@quilltap/plugin-utils 1.0.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/tools/parsers.ts","../src/tools/converters.ts","../src/logging/plugin-logger.ts","../src/logging/index.ts"],"sourcesContent":["/**\n * @quilltap/plugin-utils\n *\n * Utility functions for Quilltap plugin development.\n *\n * This package provides runtime utilities that complement the type definitions\n * in @quilltap/plugin-types. It includes:\n *\n * - **Tool Parsing**: Parse tool calls from any LLM provider's response format\n * - **Tool Conversion**: Convert between OpenAI, Anthropic, and Google tool formats\n * - **Logger Bridge**: Logging that integrates with Quilltap's core or runs standalone\n *\n * @packageDocumentation\n * @module @quilltap/plugin-utils\n */\n\n// ============================================================================\n// Tool Utilities\n// ============================================================================\n\nexport {\n  // Parsers\n  parseToolCalls,\n  parseOpenAIToolCalls,\n  parseAnthropicToolCalls,\n  parseGoogleToolCalls,\n  detectToolCallFormat,\n  hasToolCalls,\n\n  // Converters\n  convertToAnthropicFormat,\n  convertToGoogleFormat,\n  convertFromAnthropicFormat,\n  convertFromGoogleFormat,\n  convertToolTo,\n  convertToolsTo,\n  applyDescriptionLimit,\n} from './tools';\n\nexport type {\n  // Tool types (re-exported from plugin-types)\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n\n  // Utility types\n  ToolCallFormat,\n  ToolConvertTarget,\n} from './tools';\n\n// ============================================================================\n// Logging Utilities\n// ============================================================================\n\nexport {\n  // Plugin logger factory\n  createPluginLogger,\n  hasCoreLogger,\n  getLogLevelFromEnv,\n\n  // Re-exported from plugin-types\n  createConsoleLogger,\n  createNoopLogger,\n\n  // Internal APIs for Quilltap core\n  __injectCoreLoggerFactory,\n  __clearCoreLoggerFactory,\n} from './logging';\n\nexport type {\n  // Logger types\n  PluginLoggerWithChild,\n  PluginLogger,\n  LogContext,\n  LogLevel,\n} from './logging';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-utils package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_UTILS_VERSION = '1.0.0';\n","/**\n * Tool Call Parsers\n *\n * Provider-specific parsers for extracting tool calls from LLM responses.\n * Each parser converts from a provider's native format to the standardized\n * ToolCallRequest format.\n *\n * @module @quilltap/plugin-utils/tools/parsers\n */\n\nimport type { ToolCallRequest } from '@quilltap/plugin-types';\n\n/**\n * Supported tool call response formats\n */\nexport type ToolCallFormat = 'openai' | 'anthropic' | 'google' | 'auto';\n\n/**\n * Parse OpenAI format tool calls from LLM response\n *\n * Extracts tool calls from OpenAI/Grok API responses which return\n * tool_calls in the message object.\n *\n * Expected response structures:\n * - `response.tool_calls` (direct)\n * - `response.choices[0].message.tool_calls` (nested)\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await openai.chat.completions.create({...});\n * const toolCalls = parseOpenAIToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseOpenAIToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n\n    // Handle direct tool_calls array\n    let toolCallsArray = resp?.tool_calls as unknown[] | undefined;\n\n    // Check nested structure from streaming responses\n    if (!toolCallsArray) {\n      const choices = resp?.choices as\n        | Array<{ message?: { tool_calls?: unknown[] } }>\n        | undefined;\n      toolCallsArray = choices?.[0]?.message?.tool_calls;\n    }\n\n    if (toolCallsArray && Array.isArray(toolCallsArray) && toolCallsArray.length > 0) {\n      for (const toolCall of toolCallsArray) {\n        const tc = toolCall as {\n          type?: string;\n          function?: { name: string; arguments: string };\n        };\n\n        if (tc.type === 'function' && tc.function) {\n          toolCalls.push({\n            name: tc.function.name,\n            arguments: JSON.parse(tc.function.arguments || '{}'),\n          });\n        }\n      }\n    }\n  } catch (error) {\n    // Log error but don't throw - return empty array\n    console.error('[plugin-utils] Error parsing OpenAI tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Parse Anthropic format tool calls from LLM response\n *\n * Extracts tool calls from Anthropic API responses which return\n * tool_use blocks in the content array.\n *\n * Expected response structure:\n * - `response.content` array with `{ type: 'tool_use', name, input }`\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await anthropic.messages.create({...});\n * const toolCalls = parseAnthropicToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseAnthropicToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n\n    if (!resp?.content || !Array.isArray(resp.content)) {\n      return toolCalls;\n    }\n\n    for (const block of resp.content) {\n      const b = block as { type?: string; name?: string; input?: Record<string, unknown> };\n\n      if (b.type === 'tool_use' && b.name) {\n        toolCalls.push({\n          name: b.name,\n          arguments: b.input || {},\n        });\n      }\n    }\n  } catch (error) {\n    console.error('[plugin-utils] Error parsing Anthropic tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Parse Google Gemini format tool calls from LLM response\n *\n * Extracts tool calls from Google Gemini API responses which return\n * functionCall objects in the parts array.\n *\n * Expected response structure:\n * - `response.candidates[0].content.parts` array with `{ functionCall: { name, args } }`\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await gemini.generateContent({...});\n * const toolCalls = parseGoogleToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseGoogleToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n    const candidates = resp?.candidates as\n      | Array<{ content?: { parts?: unknown[] } }>\n      | undefined;\n    const parts = candidates?.[0]?.content?.parts;\n\n    if (!parts || !Array.isArray(parts)) {\n      return toolCalls;\n    }\n\n    for (const part of parts) {\n      const p = part as {\n        functionCall?: { name: string; args?: Record<string, unknown> };\n      };\n\n      if (p.functionCall) {\n        toolCalls.push({\n          name: p.functionCall.name,\n          arguments: p.functionCall.args || {},\n        });\n      }\n    }\n  } catch (error) {\n    console.error('[plugin-utils] Error parsing Google tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Detect the format of a tool call response\n *\n * Analyzes the response structure to determine which provider format it uses.\n *\n * @param response - The raw response from a provider API\n * @returns The detected format, or null if unrecognized\n */\nexport function detectToolCallFormat(response: unknown): ToolCallFormat | null {\n  if (!response || typeof response !== 'object') {\n    return null;\n  }\n\n  const resp = response as Record<string, unknown>;\n\n  // OpenAI format: has tool_calls directly or in choices[0].message\n  if (resp.tool_calls && Array.isArray(resp.tool_calls)) {\n    return 'openai';\n  }\n\n  const choices = resp.choices as Array<{ message?: { tool_calls?: unknown[] } }> | undefined;\n  if (choices?.[0]?.message?.tool_calls) {\n    return 'openai';\n  }\n\n  // Anthropic format: has content array with tool_use type\n  if (resp.content && Array.isArray(resp.content)) {\n    const hasToolUse = (resp.content as Array<{ type?: string }>).some(\n      (block) => block.type === 'tool_use'\n    );\n    if (hasToolUse) {\n      return 'anthropic';\n    }\n  }\n\n  // Google format: has candidates[0].content.parts with functionCall\n  const candidates = resp.candidates as\n    | Array<{ content?: { parts?: Array<{ functionCall?: unknown }> } }>\n    | undefined;\n  if (candidates?.[0]?.content?.parts) {\n    const hasFunctionCall = candidates[0].content.parts.some((part) => part.functionCall);\n    if (hasFunctionCall) {\n      return 'google';\n    }\n  }\n\n  return null;\n}\n\n/**\n * Parse tool calls with auto-detection or explicit format\n *\n * A unified parser that can either auto-detect the response format\n * or use a specified format. This is useful when you're not sure\n * which provider's response you're handling.\n *\n * @param response - The raw response from a provider API\n * @param format - The format to use: 'openai', 'anthropic', 'google', or 'auto'\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * // Auto-detect format\n * const toolCalls = parseToolCalls(response, 'auto');\n *\n * // Or specify format explicitly\n * const toolCalls = parseToolCalls(response, 'openai');\n * ```\n */\nexport function parseToolCalls(\n  response: unknown,\n  format: ToolCallFormat = 'auto'\n): ToolCallRequest[] {\n  let actualFormat: ToolCallFormat | null = format;\n\n  if (format === 'auto') {\n    actualFormat = detectToolCallFormat(response);\n    if (!actualFormat) {\n      return [];\n    }\n  }\n\n  switch (actualFormat) {\n    case 'openai':\n      return parseOpenAIToolCalls(response);\n    case 'anthropic':\n      return parseAnthropicToolCalls(response);\n    case 'google':\n      return parseGoogleToolCalls(response);\n    default:\n      return [];\n  }\n}\n\n/**\n * Check if a response contains tool calls\n *\n * Quick check to determine if a response has any tool calls\n * without fully parsing them.\n *\n * @param response - The raw response from a provider API\n * @returns True if the response contains tool calls\n */\nexport function hasToolCalls(response: unknown): boolean {\n  const format = detectToolCallFormat(response);\n  return format !== null;\n}\n","/**\n * Tool Format Converters\n *\n * Utilities for converting between different provider tool formats.\n * The universal format (OpenAI-style) serves as the baseline for all conversions.\n *\n * @module @quilltap/plugin-utils/tools/converters\n */\n\nimport type {\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n} from '@quilltap/plugin-types';\n\n/**\n * Convert OpenAI/Universal format tool to Anthropic format\n *\n * Anthropic uses a tool_use format with:\n * - name: string\n * - description: string\n * - input_schema: JSON schema object\n *\n * @param tool - Universal tool in OpenAI format\n * @returns Tool formatted for Anthropic's tool_use\n *\n * @example\n * ```typescript\n * const anthropicTool = convertToAnthropicFormat(universalTool);\n * // Returns: {\n * //   name: 'search_web',\n * //   description: 'Search the web',\n * //   input_schema: {\n * //     type: 'object',\n * //     properties: { query: { type: 'string' } },\n * //     required: ['query']\n * //   }\n * // }\n * ```\n */\nexport function convertToAnthropicFormat(tool: UniversalTool): AnthropicToolDefinition {\n  return {\n    name: tool.function.name,\n    description: tool.function.description,\n    input_schema: {\n      type: 'object',\n      properties: tool.function.parameters.properties,\n      required: tool.function.parameters.required,\n    },\n  };\n}\n\n/**\n * Convert OpenAI/Universal format tool to Google Gemini format\n *\n * Google uses a function calling format with:\n * - name: string\n * - description: string\n * - parameters: JSON schema object\n *\n * @param tool - Universal tool in OpenAI format\n * @returns Tool formatted for Google's functionCall\n *\n * @example\n * ```typescript\n * const googleTool = convertToGoogleFormat(universalTool);\n * // Returns: {\n * //   name: 'search_web',\n * //   description: 'Search the web',\n * //   parameters: {\n * //     type: 'object',\n * //     properties: { query: { type: 'string' } },\n * //     required: ['query']\n * //   }\n * // }\n * ```\n */\nexport function convertToGoogleFormat(tool: UniversalTool): GoogleToolDefinition {\n  return {\n    name: tool.function.name,\n    description: tool.function.description,\n    parameters: {\n      type: 'object',\n      properties: tool.function.parameters.properties,\n      required: tool.function.parameters.required,\n    },\n  };\n}\n\n/**\n * Convert Anthropic format tool to Universal/OpenAI format\n *\n * @param tool - Anthropic format tool\n * @returns Tool in universal OpenAI format\n */\nexport function convertFromAnthropicFormat(tool: AnthropicToolDefinition): UniversalTool {\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description ?? '',\n      parameters: {\n        type: 'object',\n        properties: tool.input_schema.properties,\n        required: tool.input_schema.required ?? [],\n      },\n    },\n  };\n}\n\n/**\n * Convert Google format tool to Universal/OpenAI format\n *\n * @param tool - Google format tool\n * @returns Tool in universal OpenAI format\n */\nexport function convertFromGoogleFormat(tool: GoogleToolDefinition): UniversalTool {\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: {\n        type: 'object',\n        properties: tool.parameters.properties,\n        required: tool.parameters.required,\n      },\n    },\n  };\n}\n\n/**\n * Apply prompt/description length limit to a tool\n *\n * Modifies a tool's description if it exceeds maxBytes, appending a warning\n * that the description was truncated. This is useful for providers with\n * strict token limits.\n *\n * @param tool - Tool object (any format) with a description property\n * @param maxBytes - Maximum bytes allowed for description (including warning)\n * @returns Modified tool with truncated description if needed\n *\n * @example\n * ```typescript\n * const limitedTool = applyDescriptionLimit(tool, 500);\n * // If description > 500 bytes, truncates and adds warning\n * ```\n */\nexport function applyDescriptionLimit<T extends { description: string }>(\n  tool: T,\n  maxBytes: number\n): T {\n  if (!tool || !tool.description) {\n    return tool;\n  }\n\n  const warningText = ' [Note: description truncated due to length limit]';\n  const maxDescBytes = maxBytes - Buffer.byteLength(warningText);\n\n  if (maxDescBytes <= 0) {\n    console.warn('[plugin-utils] Length limit too small for warning text:', maxBytes);\n    return tool;\n  }\n\n  const descBytes = Buffer.byteLength(tool.description);\n\n  if (descBytes > maxBytes) {\n    // Truncate description to fit within the byte limit\n    let truncated = tool.description;\n    while (Buffer.byteLength(truncated) > maxDescBytes && truncated.length > 0) {\n      truncated = truncated.slice(0, -1);\n    }\n\n    return {\n      ...tool,\n      description: truncated + warningText,\n    };\n  }\n\n  return tool;\n}\n\n/**\n * Target format for tool conversion\n */\nexport type ToolConvertTarget = 'openai' | 'anthropic' | 'google';\n\n/**\n * Convert a universal tool to a specific provider format\n *\n * @param tool - Universal tool in OpenAI format\n * @param target - Target provider format\n * @returns Tool in the target format\n */\nexport function convertToolTo(\n  tool: UniversalTool,\n  target: ToolConvertTarget\n): UniversalTool | AnthropicToolDefinition | GoogleToolDefinition {\n  switch (target) {\n    case 'anthropic':\n      return convertToAnthropicFormat(tool);\n    case 'google':\n      return convertToGoogleFormat(tool);\n    case 'openai':\n    default:\n      return tool;\n  }\n}\n\n/**\n * Convert multiple tools to a specific provider format\n *\n * @param tools - Array of universal tools\n * @param target - Target provider format\n * @returns Array of tools in the target format\n */\nexport function convertToolsTo(\n  tools: UniversalTool[],\n  target: ToolConvertTarget\n): Array<UniversalTool | AnthropicToolDefinition | GoogleToolDefinition> {\n  return tools.map((tool) => convertToolTo(tool, target));\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  // eslint-disable-next-line no-var\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 QUILTTAP_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.QUILTTAP_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"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,313 @@
+// src/tools/parsers.ts
+function parseOpenAIToolCalls(response) {
+  const toolCalls = [];
+  try {
+    const resp = response;
+    let toolCallsArray = resp?.tool_calls;
+    if (!toolCallsArray) {
+      const choices = resp?.choices;
+      toolCallsArray = choices?.[0]?.message?.tool_calls;
+    }
+    if (toolCallsArray && Array.isArray(toolCallsArray) && toolCallsArray.length > 0) {
+      for (const toolCall of toolCallsArray) {
+        const tc = toolCall;
+        if (tc.type === "function" && tc.function) {
+          toolCalls.push({
+            name: tc.function.name,
+            arguments: JSON.parse(tc.function.arguments || "{}")
+          });
+        }
+      }
+    }
+  } catch (error) {
+    console.error("[plugin-utils] Error parsing OpenAI tool calls:", error);
+  }
+  return toolCalls;
+}
+function parseAnthropicToolCalls(response) {
+  const toolCalls = [];
+  try {
+    const resp = response;
+    if (!resp?.content || !Array.isArray(resp.content)) {
+      return toolCalls;
+    }
+    for (const block of resp.content) {
+      const b = block;
+      if (b.type === "tool_use" && b.name) {
+        toolCalls.push({
+          name: b.name,
+          arguments: b.input || {}
+        });
+      }
+    }
+  } catch (error) {
+    console.error("[plugin-utils] Error parsing Anthropic tool calls:", error);
+  }
+  return toolCalls;
+}
+function parseGoogleToolCalls(response) {
+  const toolCalls = [];
+  try {
+    const resp = response;
+    const candidates = resp?.candidates;
+    const parts = candidates?.[0]?.content?.parts;
+    if (!parts || !Array.isArray(parts)) {
+      return toolCalls;
+    }
+    for (const part of parts) {
+      const p = part;
+      if (p.functionCall) {
+        toolCalls.push({
+          name: p.functionCall.name,
+          arguments: p.functionCall.args || {}
+        });
+      }
+    }
+  } catch (error) {
+    console.error("[plugin-utils] Error parsing Google tool calls:", error);
+  }
+  return toolCalls;
+}
+function detectToolCallFormat(response) {
+  if (!response || typeof response !== "object") {
+    return null;
+  }
+  const resp = response;
+  if (resp.tool_calls && Array.isArray(resp.tool_calls)) {
+    return "openai";
+  }
+  const choices = resp.choices;
+  if (choices?.[0]?.message?.tool_calls) {
+    return "openai";
+  }
+  if (resp.content && Array.isArray(resp.content)) {
+    const hasToolUse = resp.content.some(
+      (block) => block.type === "tool_use"
+    );
+    if (hasToolUse) {
+      return "anthropic";
+    }
+  }
+  const candidates = resp.candidates;
+  if (candidates?.[0]?.content?.parts) {
+    const hasFunctionCall = candidates[0].content.parts.some((part) => part.functionCall);
+    if (hasFunctionCall) {
+      return "google";
+    }
+  }
+  return null;
+}
+function parseToolCalls(response, format = "auto") {
+  let actualFormat = format;
+  if (format === "auto") {
+    actualFormat = detectToolCallFormat(response);
+    if (!actualFormat) {
+      return [];
+    }
+  }
+  switch (actualFormat) {
+    case "openai":
+      return parseOpenAIToolCalls(response);
+    case "anthropic":
+      return parseAnthropicToolCalls(response);
+    case "google":
+      return parseGoogleToolCalls(response);
+    default:
+      return [];
+  }
+}
+function hasToolCalls(response) {
+  const format = detectToolCallFormat(response);
+  return format !== null;
+}
+
+// src/tools/converters.ts
+function convertToAnthropicFormat(tool) {
+  return {
+    name: tool.function.name,
+    description: tool.function.description,
+    input_schema: {
+      type: "object",
+      properties: tool.function.parameters.properties,
+      required: tool.function.parameters.required
+    }
+  };
+}
+function convertToGoogleFormat(tool) {
+  return {
+    name: tool.function.name,
+    description: tool.function.description,
+    parameters: {
+      type: "object",
+      properties: tool.function.parameters.properties,
+      required: tool.function.parameters.required
+    }
+  };
+}
+function convertFromAnthropicFormat(tool) {
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description ?? "",
+      parameters: {
+        type: "object",
+        properties: tool.input_schema.properties,
+        required: tool.input_schema.required ?? []
+      }
+    }
+  };
+}
+function convertFromGoogleFormat(tool) {
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description,
+      parameters: {
+        type: "object",
+        properties: tool.parameters.properties,
+        required: tool.parameters.required
+      }
+    }
+  };
+}
+function applyDescriptionLimit(tool, maxBytes) {
+  if (!tool || !tool.description) {
+    return tool;
+  }
+  const warningText = " [Note: description truncated due to length limit]";
+  const maxDescBytes = maxBytes - Buffer.byteLength(warningText);
+  if (maxDescBytes <= 0) {
+    console.warn("[plugin-utils] Length limit too small for warning text:", maxBytes);
+    return tool;
+  }
+  const descBytes = Buffer.byteLength(tool.description);
+  if (descBytes > maxBytes) {
+    let truncated = tool.description;
+    while (Buffer.byteLength(truncated) > maxDescBytes && truncated.length > 0) {
+      truncated = truncated.slice(0, -1);
+    }
+    return {
+      ...tool,
+      description: truncated + warningText
+    };
+  }
+  return tool;
+}
+function convertToolTo(tool, target) {
+  switch (target) {
+    case "anthropic":
+      return convertToAnthropicFormat(tool);
+    case "google":
+      return convertToGoogleFormat(tool);
+    case "openai":
+    default:
+      return tool;
+  }
+}
+function convertToolsTo(tools, target) {
+  return tools.map((tool) => convertToolTo(tool, target));
+}
+
+// src/logging/plugin-logger.ts
+function getCoreLoggerFactory() {
+  return globalThis.__quilltap_logger_factory ?? null;
+}
+function __injectCoreLoggerFactory(factory) {
+  globalThis.__quilltap_logger_factory = factory;
+}
+function __clearCoreLoggerFactory() {
+  globalThis.__quilltap_logger_factory = void 0;
+}
+function hasCoreLogger() {
+  return getCoreLoggerFactory() !== null;
+}
+function createConsoleLoggerWithChild(prefix, minLevel = "debug", baseContext = {}) {
+  const levels = ["debug", "info", "warn", "error"];
+  const shouldLog = (level) => levels.indexOf(level) >= levels.indexOf(minLevel);
+  const formatContext = (context) => {
+    const merged = { ...baseContext, ...context };
+    const entries = Object.entries(merged).filter(([key]) => key !== "context").map(([key, value]) => `${key}=${JSON.stringify(value)}`).join(" ");
+    return entries ? ` ${entries}` : "";
+  };
+  const logger = {
+    debug: (message, context) => {
+      if (shouldLog("debug")) {
+        console.debug(`[${prefix}] ${message}${formatContext(context)}`);
+      }
+    },
+    info: (message, context) => {
+      if (shouldLog("info")) {
+        console.info(`[${prefix}] ${message}${formatContext(context)}`);
+      }
+    },
+    warn: (message, context) => {
+      if (shouldLog("warn")) {
+        console.warn(`[${prefix}] ${message}${formatContext(context)}`);
+      }
+    },
+    error: (message, context, error) => {
+      if (shouldLog("error")) {
+        console.error(
+          `[${prefix}] ${message}${formatContext(context)}`,
+          error ? `
+${error.stack || error.message}` : ""
+        );
+      }
+    },
+    child: (additionalContext) => {
+      return createConsoleLoggerWithChild(prefix, minLevel, {
+        ...baseContext,
+        ...additionalContext
+      });
+    }
+  };
+  return logger;
+}
+function createPluginLogger(pluginName, minLevel = "debug") {
+  const coreFactory = getCoreLoggerFactory();
+  if (coreFactory) {
+    return coreFactory(pluginName);
+  }
+  return createConsoleLoggerWithChild(pluginName, minLevel);
+}
+function getLogLevelFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    const envLevel = process.env.LOG_LEVEL || process.env.QUILTTAP_LOG_LEVEL;
+    if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
+      return envLevel;
+    }
+  }
+  return "info";
+}
+
+// src/logging/index.ts
+import { createConsoleLogger, createNoopLogger } from "@quilltap/plugin-types";
+
+// src/index.ts
+var PLUGIN_UTILS_VERSION = "1.0.0";
+export {
+  PLUGIN_UTILS_VERSION,
+  __clearCoreLoggerFactory,
+  __injectCoreLoggerFactory,
+  applyDescriptionLimit,
+  convertFromAnthropicFormat,
+  convertFromGoogleFormat,
+  convertToAnthropicFormat,
+  convertToGoogleFormat,
+  convertToolTo,
+  convertToolsTo,
+  createConsoleLogger,
+  createNoopLogger,
+  createPluginLogger,
+  detectToolCallFormat,
+  getLogLevelFromEnv,
+  hasCoreLogger,
+  hasToolCalls,
+  parseAnthropicToolCalls,
+  parseGoogleToolCalls,
+  parseOpenAIToolCalls,
+  parseToolCalls
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/parsers.ts","../src/tools/converters.ts","../src/logging/plugin-logger.ts","../src/logging/index.ts","../src/index.ts"],"sourcesContent":["/**\n * Tool Call Parsers\n *\n * Provider-specific parsers for extracting tool calls from LLM responses.\n * Each parser converts from a provider's native format to the standardized\n * ToolCallRequest format.\n *\n * @module @quilltap/plugin-utils/tools/parsers\n */\n\nimport type { ToolCallRequest } from '@quilltap/plugin-types';\n\n/**\n * Supported tool call response formats\n */\nexport type ToolCallFormat = 'openai' | 'anthropic' | 'google' | 'auto';\n\n/**\n * Parse OpenAI format tool calls from LLM response\n *\n * Extracts tool calls from OpenAI/Grok API responses which return\n * tool_calls in the message object.\n *\n * Expected response structures:\n * - `response.tool_calls` (direct)\n * - `response.choices[0].message.tool_calls` (nested)\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await openai.chat.completions.create({...});\n * const toolCalls = parseOpenAIToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseOpenAIToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n\n    // Handle direct tool_calls array\n    let toolCallsArray = resp?.tool_calls as unknown[] | undefined;\n\n    // Check nested structure from streaming responses\n    if (!toolCallsArray) {\n      const choices = resp?.choices as\n        | Array<{ message?: { tool_calls?: unknown[] } }>\n        | undefined;\n      toolCallsArray = choices?.[0]?.message?.tool_calls;\n    }\n\n    if (toolCallsArray && Array.isArray(toolCallsArray) && toolCallsArray.length > 0) {\n      for (const toolCall of toolCallsArray) {\n        const tc = toolCall as {\n          type?: string;\n          function?: { name: string; arguments: string };\n        };\n\n        if (tc.type === 'function' && tc.function) {\n          toolCalls.push({\n            name: tc.function.name,\n            arguments: JSON.parse(tc.function.arguments || '{}'),\n          });\n        }\n      }\n    }\n  } catch (error) {\n    // Log error but don't throw - return empty array\n    console.error('[plugin-utils] Error parsing OpenAI tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Parse Anthropic format tool calls from LLM response\n *\n * Extracts tool calls from Anthropic API responses which return\n * tool_use blocks in the content array.\n *\n * Expected response structure:\n * - `response.content` array with `{ type: 'tool_use', name, input }`\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await anthropic.messages.create({...});\n * const toolCalls = parseAnthropicToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseAnthropicToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n\n    if (!resp?.content || !Array.isArray(resp.content)) {\n      return toolCalls;\n    }\n\n    for (const block of resp.content) {\n      const b = block as { type?: string; name?: string; input?: Record<string, unknown> };\n\n      if (b.type === 'tool_use' && b.name) {\n        toolCalls.push({\n          name: b.name,\n          arguments: b.input || {},\n        });\n      }\n    }\n  } catch (error) {\n    console.error('[plugin-utils] Error parsing Anthropic tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Parse Google Gemini format tool calls from LLM response\n *\n * Extracts tool calls from Google Gemini API responses which return\n * functionCall objects in the parts array.\n *\n * Expected response structure:\n * - `response.candidates[0].content.parts` array with `{ functionCall: { name, args } }`\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await gemini.generateContent({...});\n * const toolCalls = parseGoogleToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseGoogleToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n    const candidates = resp?.candidates as\n      | Array<{ content?: { parts?: unknown[] } }>\n      | undefined;\n    const parts = candidates?.[0]?.content?.parts;\n\n    if (!parts || !Array.isArray(parts)) {\n      return toolCalls;\n    }\n\n    for (const part of parts) {\n      const p = part as {\n        functionCall?: { name: string; args?: Record<string, unknown> };\n      };\n\n      if (p.functionCall) {\n        toolCalls.push({\n          name: p.functionCall.name,\n          arguments: p.functionCall.args || {},\n        });\n      }\n    }\n  } catch (error) {\n    console.error('[plugin-utils] Error parsing Google tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Detect the format of a tool call response\n *\n * Analyzes the response structure to determine which provider format it uses.\n *\n * @param response - The raw response from a provider API\n * @returns The detected format, or null if unrecognized\n */\nexport function detectToolCallFormat(response: unknown): ToolCallFormat | null {\n  if (!response || typeof response !== 'object') {\n    return null;\n  }\n\n  const resp = response as Record<string, unknown>;\n\n  // OpenAI format: has tool_calls directly or in choices[0].message\n  if (resp.tool_calls && Array.isArray(resp.tool_calls)) {\n    return 'openai';\n  }\n\n  const choices = resp.choices as Array<{ message?: { tool_calls?: unknown[] } }> | undefined;\n  if (choices?.[0]?.message?.tool_calls) {\n    return 'openai';\n  }\n\n  // Anthropic format: has content array with tool_use type\n  if (resp.content && Array.isArray(resp.content)) {\n    const hasToolUse = (resp.content as Array<{ type?: string }>).some(\n      (block) => block.type === 'tool_use'\n    );\n    if (hasToolUse) {\n      return 'anthropic';\n    }\n  }\n\n  // Google format: has candidates[0].content.parts with functionCall\n  const candidates = resp.candidates as\n    | Array<{ content?: { parts?: Array<{ functionCall?: unknown }> } }>\n    | undefined;\n  if (candidates?.[0]?.content?.parts) {\n    const hasFunctionCall = candidates[0].content.parts.some((part) => part.functionCall);\n    if (hasFunctionCall) {\n      return 'google';\n    }\n  }\n\n  return null;\n}\n\n/**\n * Parse tool calls with auto-detection or explicit format\n *\n * A unified parser that can either auto-detect the response format\n * or use a specified format. This is useful when you're not sure\n * which provider's response you're handling.\n *\n * @param response - The raw response from a provider API\n * @param format - The format to use: 'openai', 'anthropic', 'google', or 'auto'\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * // Auto-detect format\n * const toolCalls = parseToolCalls(response, 'auto');\n *\n * // Or specify format explicitly\n * const toolCalls = parseToolCalls(response, 'openai');\n * ```\n */\nexport function parseToolCalls(\n  response: unknown,\n  format: ToolCallFormat = 'auto'\n): ToolCallRequest[] {\n  let actualFormat: ToolCallFormat | null = format;\n\n  if (format === 'auto') {\n    actualFormat = detectToolCallFormat(response);\n    if (!actualFormat) {\n      return [];\n    }\n  }\n\n  switch (actualFormat) {\n    case 'openai':\n      return parseOpenAIToolCalls(response);\n    case 'anthropic':\n      return parseAnthropicToolCalls(response);\n    case 'google':\n      return parseGoogleToolCalls(response);\n    default:\n      return [];\n  }\n}\n\n/**\n * Check if a response contains tool calls\n *\n * Quick check to determine if a response has any tool calls\n * without fully parsing them.\n *\n * @param response - The raw response from a provider API\n * @returns True if the response contains tool calls\n */\nexport function hasToolCalls(response: unknown): boolean {\n  const format = detectToolCallFormat(response);\n  return format !== null;\n}\n","/**\n * Tool Format Converters\n *\n * Utilities for converting between different provider tool formats.\n * The universal format (OpenAI-style) serves as the baseline for all conversions.\n *\n * @module @quilltap/plugin-utils/tools/converters\n */\n\nimport type {\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n} from '@quilltap/plugin-types';\n\n/**\n * Convert OpenAI/Universal format tool to Anthropic format\n *\n * Anthropic uses a tool_use format with:\n * - name: string\n * - description: string\n * - input_schema: JSON schema object\n *\n * @param tool - Universal tool in OpenAI format\n * @returns Tool formatted for Anthropic's tool_use\n *\n * @example\n * ```typescript\n * const anthropicTool = convertToAnthropicFormat(universalTool);\n * // Returns: {\n * //   name: 'search_web',\n * //   description: 'Search the web',\n * //   input_schema: {\n * //     type: 'object',\n * //     properties: { query: { type: 'string' } },\n * //     required: ['query']\n * //   }\n * // }\n * ```\n */\nexport function convertToAnthropicFormat(tool: UniversalTool): AnthropicToolDefinition {\n  return {\n    name: tool.function.name,\n    description: tool.function.description,\n    input_schema: {\n      type: 'object',\n      properties: tool.function.parameters.properties,\n      required: tool.function.parameters.required,\n    },\n  };\n}\n\n/**\n * Convert OpenAI/Universal format tool to Google Gemini format\n *\n * Google uses a function calling format with:\n * - name: string\n * - description: string\n * - parameters: JSON schema object\n *\n * @param tool - Universal tool in OpenAI format\n * @returns Tool formatted for Google's functionCall\n *\n * @example\n * ```typescript\n * const googleTool = convertToGoogleFormat(universalTool);\n * // Returns: {\n * //   name: 'search_web',\n * //   description: 'Search the web',\n * //   parameters: {\n * //     type: 'object',\n * //     properties: { query: { type: 'string' } },\n * //     required: ['query']\n * //   }\n * // }\n * ```\n */\nexport function convertToGoogleFormat(tool: UniversalTool): GoogleToolDefinition {\n  return {\n    name: tool.function.name,\n    description: tool.function.description,\n    parameters: {\n      type: 'object',\n      properties: tool.function.parameters.properties,\n      required: tool.function.parameters.required,\n    },\n  };\n}\n\n/**\n * Convert Anthropic format tool to Universal/OpenAI format\n *\n * @param tool - Anthropic format tool\n * @returns Tool in universal OpenAI format\n */\nexport function convertFromAnthropicFormat(tool: AnthropicToolDefinition): UniversalTool {\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description ?? '',\n      parameters: {\n        type: 'object',\n        properties: tool.input_schema.properties,\n        required: tool.input_schema.required ?? [],\n      },\n    },\n  };\n}\n\n/**\n * Convert Google format tool to Universal/OpenAI format\n *\n * @param tool - Google format tool\n * @returns Tool in universal OpenAI format\n */\nexport function convertFromGoogleFormat(tool: GoogleToolDefinition): UniversalTool {\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: {\n        type: 'object',\n        properties: tool.parameters.properties,\n        required: tool.parameters.required,\n      },\n    },\n  };\n}\n\n/**\n * Apply prompt/description length limit to a tool\n *\n * Modifies a tool's description if it exceeds maxBytes, appending a warning\n * that the description was truncated. This is useful for providers with\n * strict token limits.\n *\n * @param tool - Tool object (any format) with a description property\n * @param maxBytes - Maximum bytes allowed for description (including warning)\n * @returns Modified tool with truncated description if needed\n *\n * @example\n * ```typescript\n * const limitedTool = applyDescriptionLimit(tool, 500);\n * // If description > 500 bytes, truncates and adds warning\n * ```\n */\nexport function applyDescriptionLimit<T extends { description: string }>(\n  tool: T,\n  maxBytes: number\n): T {\n  if (!tool || !tool.description) {\n    return tool;\n  }\n\n  const warningText = ' [Note: description truncated due to length limit]';\n  const maxDescBytes = maxBytes - Buffer.byteLength(warningText);\n\n  if (maxDescBytes <= 0) {\n    console.warn('[plugin-utils] Length limit too small for warning text:', maxBytes);\n    return tool;\n  }\n\n  const descBytes = Buffer.byteLength(tool.description);\n\n  if (descBytes > maxBytes) {\n    // Truncate description to fit within the byte limit\n    let truncated = tool.description;\n    while (Buffer.byteLength(truncated) > maxDescBytes && truncated.length > 0) {\n      truncated = truncated.slice(0, -1);\n    }\n\n    return {\n      ...tool,\n      description: truncated + warningText,\n    };\n  }\n\n  return tool;\n}\n\n/**\n * Target format for tool conversion\n */\nexport type ToolConvertTarget = 'openai' | 'anthropic' | 'google';\n\n/**\n * Convert a universal tool to a specific provider format\n *\n * @param tool - Universal tool in OpenAI format\n * @param target - Target provider format\n * @returns Tool in the target format\n */\nexport function convertToolTo(\n  tool: UniversalTool,\n  target: ToolConvertTarget\n): UniversalTool | AnthropicToolDefinition | GoogleToolDefinition {\n  switch (target) {\n    case 'anthropic':\n      return convertToAnthropicFormat(tool);\n    case 'google':\n      return convertToGoogleFormat(tool);\n    case 'openai':\n    default:\n      return tool;\n  }\n}\n\n/**\n * Convert multiple tools to a specific provider format\n *\n * @param tools - Array of universal tools\n * @param target - Target provider format\n * @returns Array of tools in the target format\n */\nexport function convertToolsTo(\n  tools: UniversalTool[],\n  target: ToolConvertTarget\n): Array<UniversalTool | AnthropicToolDefinition | GoogleToolDefinition> {\n  return tools.map((tool) => convertToolTo(tool, target));\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  // eslint-disable-next-line no-var\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 QUILTTAP_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.QUILTTAP_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/plugin-utils\n *\n * Utility functions for Quilltap plugin development.\n *\n * This package provides runtime utilities that complement the type definitions\n * in @quilltap/plugin-types. It includes:\n *\n * - **Tool Parsing**: Parse tool calls from any LLM provider's response format\n * - **Tool Conversion**: Convert between OpenAI, Anthropic, and Google tool formats\n * - **Logger Bridge**: Logging that integrates with Quilltap's core or runs standalone\n *\n * @packageDocumentation\n * @module @quilltap/plugin-utils\n */\n\n// ============================================================================\n// Tool Utilities\n// ============================================================================\n\nexport {\n  // Parsers\n  parseToolCalls,\n  parseOpenAIToolCalls,\n  parseAnthropicToolCalls,\n  parseGoogleToolCalls,\n  detectToolCallFormat,\n  hasToolCalls,\n\n  // Converters\n  convertToAnthropicFormat,\n  convertToGoogleFormat,\n  convertFromAnthropicFormat,\n  convertFromGoogleFormat,\n  convertToolTo,\n  convertToolsTo,\n  applyDescriptionLimit,\n} from './tools';\n\nexport type {\n  // Tool types (re-exported from plugin-types)\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n\n  // Utility types\n  ToolCallFormat,\n  ToolConvertTarget,\n} from './tools';\n\n// ============================================================================\n// Logging Utilities\n// ============================================================================\n\nexport {\n  // Plugin logger factory\n  createPluginLogger,\n  hasCoreLogger,\n  getLogLevelFromEnv,\n\n  // Re-exported from plugin-types\n  createConsoleLogger,\n  createNoopLogger,\n\n  // Internal APIs for Quilltap core\n  __injectCoreLoggerFactory,\n  __clearCoreLoggerFactory,\n} from './logging';\n\nexport type {\n  // Logger types\n  PluginLoggerWithChild,\n  PluginLogger,\n  LogContext,\n  LogLevel,\n} from './logging';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-utils package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_UTILS_VERSION = '1.0.0';\n"],"mappings":"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","names":[]}

package/dist/logging/index.d.mts

@@ -0,0 +1,109 @@
+import { PluginLogger, LogContext, LogLevel } from '@quilltap/plugin-types';
+export { LogContext, LogLevel, PluginLogger, createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';
+
+/**
+ * Plugin Logger Bridge
+ *
+ * Provides a logger factory for plugins that automatically bridges
+ * to Quilltap's core logging when running inside the host application,
+ * or falls back to console logging when running standalone.
+ *
+ * @module @quilltap/plugin-utils/logging/plugin-logger
+ */
+
+/**
+ * Extended logger interface with child logger support
+ */
+interface PluginLoggerWithChild extends PluginLogger {
+    /**
+     * Create a child logger with additional context
+     * @param additionalContext Context to merge with parent context
+     * @returns A new logger with combined context
+     */
+    child(additionalContext: LogContext): PluginLoggerWithChild;
+}
+/**
+ * Type for the global Quilltap logger bridge
+ * Stored on globalThis to work across different npm package copies
+ */
+declare global {
+    var __quilltap_logger_factory: ((pluginName: string) => PluginLoggerWithChild) | undefined;
+}
+/**
+ * Inject the core logger factory from Quilltap host
+ *
+ * This is called by Quilltap core when loading plugins to bridge
+ * plugin logging into the host's logging system. Uses globalThis
+ * to ensure it works even when plugins have their own copy of
+ * plugin-utils in their node_modules.
+ *
+ * **Internal API - not for plugin use**
+ *
+ * @param factory A function that creates a child logger for a plugin
+ */
+declare function __injectCoreLoggerFactory(factory: (pluginName: string) => PluginLoggerWithChild): void;
+/**
+ * Clear the injected core logger factory
+ *
+ * Useful for testing or when unloading the plugin system.
+ *
+ * **Internal API - not for plugin use**
+ */
+declare function __clearCoreLoggerFactory(): void;
+/**
+ * Check if a core logger has been injected
+ *
+ * @returns True if running inside Quilltap with core logging available
+ */
+declare function hasCoreLogger(): boolean;
+/**
+ * Create a plugin logger that bridges to Quilltap core logging
+ *
+ * When running inside Quilltap:
+ * - Routes all logs to the core logger
+ * - Tags logs with `{ plugin: pluginName, module: 'plugin' }`
+ * - Logs appear in Quilltap's combined.log and console
+ *
+ * When running standalone:
+ * - Falls back to console logging with `[pluginName]` prefix
+ * - Respects the specified minimum log level
+ *
+ * @param pluginName - The plugin identifier (e.g., 'qtap-plugin-openai')
+ * @param minLevel - Minimum log level when running standalone (default: 'debug')
+ * @returns A logger instance
+ *
+ * @example
+ * ```typescript
+ * // In your plugin's provider.ts
+ * import { createPluginLogger } from '@quilltap/plugin-utils';
+ *
+ * const logger = createPluginLogger('qtap-plugin-my-provider');
+ *
+ * export class MyProvider implements LLMProvider {
+ *   async sendMessage(params: LLMParams, apiKey: string): Promise<LLMResponse> {
+ *     logger.debug('Sending message', { model: params.model });
+ *
+ *     try {
+ *       const response = await this.client.chat({...});
+ *       logger.info('Received response', { tokens: response.usage?.total_tokens });
+ *       return response;
+ *     } catch (error) {
+ *       logger.error('Failed to send message', { model: params.model }, error as Error);
+ *       throw error;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare function createPluginLogger(pluginName: string, minLevel?: LogLevel): PluginLoggerWithChild;
+/**
+ * Get the minimum log level from environment
+ *
+ * Checks for LOG_LEVEL or QUILTTAP_LOG_LEVEL environment variables.
+ * Useful for configuring standalone plugin logging.
+ *
+ * @returns The configured log level, or 'info' as default
+ */
+declare function getLogLevelFromEnv(): LogLevel;
+
+export { type PluginLoggerWithChild, __clearCoreLoggerFactory, __injectCoreLoggerFactory, createPluginLogger, getLogLevelFromEnv, hasCoreLogger };