@providerprotocol/ai 0.0.34 → 0.0.35

package/dist/groq/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/groq/transform.ts","../../src/providers/groq/llm.ts","../../src/providers/groq/index.ts"],"sourcesContent":["/**\n * @fileoverview Groq API Message Transformers\n *\n * This module provides transformation functions for converting between the\n * Universal Provider Protocol (UPP) message format and Groq's Chat Completions\n * API format (OpenAI-compatible). It handles both request transformation (UPP -> Groq)\n * and response transformation (Groq -> UPP), including streaming event transformation.\n *\n * @module providers/groq/transform\n */\n\nimport type { LLMRequest, LLMResponse } from '../../types/llm.ts';\nimport type { Message } from '../../types/messages.ts';\nimport type { StreamEvent } from '../../types/stream.ts';\nimport { StreamEventType } from '../../types/stream.ts';\nimport type { Tool, ToolCall } from '../../types/tool.ts';\nimport type { TokenUsage } from '../../types/turn.ts';\nimport type { ContentBlock, TextBlock, ImageBlock } from '../../types/content.ts';\nimport {\n  AssistantMessage,\n  isUserMessage,\n  isAssistantMessage,\n  isToolResultMessage,\n} from '../../types/messages.ts';\nimport { UPPError, ErrorCode, ModalityType } from '../../types/errors.ts';\nimport { generateId } from '../../utils/id.ts';\nimport type {\n  GroqLLMParams,\n  GroqRequest,\n  GroqMessage,\n  GroqUserContent,\n  GroqTool,\n  GroqResponse,\n  GroqStreamChunk,\n  GroqToolCall,\n} from './types.ts';\n\n/**\n * Normalizes system prompt to string.\n */\nfunction normalizeSystem(system: string | unknown[] | undefined): string | undefined {\n  if (system === undefined || system === null) return undefined;\n  if (typeof system === 'string') return system;\n  if (!Array.isArray(system)) {\n    throw new UPPError(\n      'System prompt must be a string or an array of text blocks',\n      ErrorCode.InvalidRequest,\n      'groq',\n      ModalityType.LLM\n    );\n  }\n\n  const texts: string[] = [];\n  for (const block of system) {\n    if (!block || typeof block !== 'object' || !('text' in block)) {\n      throw new UPPError(\n        'System prompt array must contain objects with a text field',\n        ErrorCode.InvalidRequest,\n        'groq',\n        ModalityType.LLM\n      );\n    }\n    const textValue = (block as { text?: unknown }).text;\n    if (typeof textValue !== 'string') {\n      throw new UPPError(\n        'System prompt text must be a string',\n        ErrorCode.InvalidRequest,\n        'groq',\n        ModalityType.LLM\n      );\n    }\n    if (textValue.length > 0) {\n      texts.push(textValue);\n    }\n  }\n\n  return texts.length > 0 ? texts.join('\\n\\n') : undefined;\n}\n\n/**\n * Filters content blocks to only include those with a valid type property.\n */\nfunction filterValidContent<T extends { type?: string }>(content: T[]): T[] {\n  return content.filter((c) => c && typeof c.type === 'string');\n}\n\n/**\n * Transforms a UPP content block to Groq user content format.\n */\nfunction transformContentBlock(block: ContentBlock): GroqUserContent {\n  switch (block.type) {\n    case 'text':\n      return { type: 'text', text: block.text };\n\n    case 'image': {\n      const imageBlock = block as ImageBlock;\n      let url: string;\n\n      if (imageBlock.source.type === 'base64') {\n        url = `data:${imageBlock.mimeType};base64,${imageBlock.source.data}`;\n      } else if (imageBlock.source.type === 'url') {\n        url = imageBlock.source.url;\n      } else if (imageBlock.source.type === 'bytes') {\n        const base64 = Buffer.from(imageBlock.source.data).toString('base64');\n        url = `data:${imageBlock.mimeType};base64,${base64}`;\n      } else {\n        throw new UPPError(\n          'Unknown image source type',\n          ErrorCode.InvalidRequest,\n          'groq',\n          ModalityType.LLM\n        );\n      }\n\n      return {\n        type: 'image_url',\n        image_url: { url },\n      };\n    }\n\n    case 'document':\n      throw new UPPError(\n        'Groq does not support document input',\n        ErrorCode.InvalidRequest,\n        'groq',\n        ModalityType.LLM\n      );\n\n    default:\n      throw new UPPError(\n        `Unsupported content type: ${block.type}`,\n        ErrorCode.InvalidRequest,\n        'groq',\n        ModalityType.LLM\n      );\n  }\n}\n\n/**\n * Transforms a single UPP message to Groq format.\n */\nfunction transformMessage(message: Message): GroqMessage | null {\n  if (isUserMessage(message)) {\n    const validContent = filterValidContent(message.content);\n    if (validContent.length === 1 && validContent[0]?.type === 'text') {\n      return {\n        role: 'user',\n        content: (validContent[0] as TextBlock).text,\n      };\n    }\n    return {\n      role: 'user',\n      content: validContent.map(transformContentBlock),\n    };\n  }\n\n  if (isAssistantMessage(message)) {\n    const validContent = filterValidContent(message.content);\n    const textContent = validContent\n      .filter((c): c is TextBlock => c.type === 'text')\n      .map((c) => c.text)\n      .join('');\n\n    const assistantMessage: GroqMessage = {\n      role: 'assistant',\n      content: textContent || null,\n    };\n\n    if (message.toolCalls && message.toolCalls.length > 0) {\n      (assistantMessage as { tool_calls?: GroqToolCall[] }).tool_calls =\n        message.toolCalls.map((call) => ({\n          id: call.toolCallId,\n          type: 'function' as const,\n          function: {\n            name: call.toolName,\n            arguments: JSON.stringify(call.arguments),\n          },\n        }));\n    }\n\n    return assistantMessage;\n  }\n\n  if (isToolResultMessage(message)) {\n    const results = message.results.map((result) => ({\n      role: 'tool' as const,\n      tool_call_id: result.toolCallId,\n      content:\n        typeof result.result === 'string'\n          ? result.result\n          : JSON.stringify(result.result),\n    }));\n\n    return results[0] ?? null;\n  }\n\n  return null;\n}\n\n/**\n * Transforms tool result messages into multiple Groq tool messages.\n */\nexport function transformToolResults(message: Message): GroqMessage[] {\n  if (!isToolResultMessage(message)) {\n    const single = transformMessage(message);\n    return single ? [single] : [];\n  }\n\n  return message.results.map((result) => ({\n    role: 'tool' as const,\n    tool_call_id: result.toolCallId,\n    content:\n      typeof result.result === 'string'\n        ? result.result\n        : JSON.stringify(result.result),\n  }));\n}\n\n/**\n * Transforms UPP messages to Groq message format.\n *\n * @param messages - Array of UPP messages to transform\n * @param system - Optional system prompt\n * @returns Array of Groq-formatted messages\n */\nfunction transformMessages(\n  messages: Message[],\n  system?: string | unknown[]\n): GroqMessage[] {\n  const result: GroqMessage[] = [];\n  const normalizedSystem = normalizeSystem(system);\n\n  if (normalizedSystem) {\n    result.push({\n      role: 'system',\n      content: normalizedSystem,\n    });\n  }\n\n  for (const message of messages) {\n    if (isToolResultMessage(message)) {\n      const toolMessages = transformToolResults(message);\n      result.push(...toolMessages);\n    } else {\n      const transformed = transformMessage(message);\n      if (transformed) {\n        result.push(transformed);\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Extracts Groq-specific options from tool metadata.\n */\nfunction extractToolOptions(tool: Tool): { strict?: boolean } {\n  const groqMeta = tool.metadata?.groq as { strict?: boolean } | undefined;\n  return { strict: groqMeta?.strict };\n}\n\n/**\n * Transforms a UPP tool definition to Groq function tool format.\n */\nfunction transformTool(tool: Tool): GroqTool {\n  const { strict } = extractToolOptions(tool);\n\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        ...(tool.parameters.additionalProperties !== undefined\n          ? { additionalProperties: tool.parameters.additionalProperties }\n          : {}),\n      },\n      ...(strict !== undefined ? { strict } : {}),\n    },\n  };\n}\n\n/**\n * Transforms a UPP LLM request into Groq Chat Completions API format.\n *\n * @param request - The UPP LLM request containing messages, tools, and configuration\n * @param modelId - The Groq model identifier (e.g., 'llama-3.3-70b-versatile')\n * @returns A Groq Chat Completions API request body\n */\nexport function transformRequest(\n  request: LLMRequest<GroqLLMParams>,\n  modelId: string\n): GroqRequest {\n  const params = request.params ?? ({} as GroqLLMParams);\n\n  const groqRequest: GroqRequest = {\n    ...params,\n    model: modelId,\n    messages: transformMessages(request.messages, request.system),\n  };\n\n  if (request.tools && request.tools.length > 0) {\n    groqRequest.tools = request.tools.map(transformTool);\n  }\n\n  if (request.structure) {\n    const schema: Record<string, unknown> = {\n      type: 'object',\n      properties: request.structure.properties,\n      required: request.structure.required,\n      ...(request.structure.additionalProperties !== undefined\n        ? { additionalProperties: request.structure.additionalProperties }\n        : { additionalProperties: false }),\n    };\n    if (request.structure.description) {\n      schema.description = request.structure.description;\n    }\n\n    groqRequest.response_format = {\n      type: 'json_schema',\n      json_schema: {\n        name: 'json_response',\n        description: request.structure.description,\n        schema,\n        strict: true,\n      },\n    };\n  }\n\n  return groqRequest;\n}\n\n/**\n * Transforms a Groq response to UPP LLMResponse format.\n */\nexport function transformResponse(data: GroqResponse): LLMResponse {\n  const choice = data.choices[0];\n  if (!choice) {\n    throw new UPPError(\n      'No choices in Groq response',\n      ErrorCode.InvalidResponse,\n      'groq',\n      ModalityType.LLM\n    );\n  }\n\n  const textContent: TextBlock[] = [];\n  let structuredData: unknown;\n  if (choice.message.content) {\n    textContent.push({ type: 'text', text: choice.message.content });\n    try {\n      structuredData = JSON.parse(choice.message.content);\n    } catch {\n      // Not JSON - expected for non-structured responses\n    }\n  }\n\n  const toolCalls: ToolCall[] = [];\n  if (choice.message.tool_calls) {\n    for (const call of choice.message.tool_calls) {\n      let args: Record<string, unknown> = {};\n      try {\n        args = JSON.parse(call.function.arguments);\n      } catch {\n        // Invalid JSON - use empty object\n      }\n      toolCalls.push({\n        toolCallId: call.id,\n        toolName: call.function.name,\n        arguments: args,\n      });\n    }\n  }\n\n  const message = new AssistantMessage(\n    textContent,\n    toolCalls.length > 0 ? toolCalls : undefined,\n    {\n      id: data.id || generateId(),\n      metadata: {\n        groq: {\n          model: data.model,\n          finish_reason: choice.finish_reason,\n          system_fingerprint: data.system_fingerprint,\n        },\n      },\n    }\n  );\n\n  const usage: TokenUsage = {\n    inputTokens: data.usage.prompt_tokens,\n    outputTokens: data.usage.completion_tokens,\n    totalTokens: data.usage.total_tokens,\n    cacheReadTokens: data.usage.prompt_tokens_details?.cached_tokens ?? 0,\n    cacheWriteTokens: 0,\n  };\n\n  let stopReason = 'end_turn';\n  switch (choice.finish_reason) {\n    case 'stop':\n      stopReason = 'end_turn';\n      break;\n    case 'length':\n      stopReason = 'max_tokens';\n      break;\n    case 'tool_calls':\n      stopReason = 'tool_use';\n      break;\n    case 'content_filter':\n      stopReason = 'content_filter';\n      break;\n  }\n\n  return {\n    message,\n    usage,\n    stopReason,\n    data: structuredData,\n  };\n}\n\n/**\n * Mutable state object for accumulating data during streaming responses.\n */\nexport interface GroqStreamState {\n  /** Response ID from the first chunk */\n  id: string;\n  /** Model identifier */\n  model: string;\n  /** Accumulated text content */\n  text: string;\n  /** Map of tool call index to accumulated tool call data */\n  toolCalls: Map<number, { id: string; name: string; arguments: string }>;\n  /** The finish reason when streaming completes */\n  finishReason: string | null;\n  /** Input token count (from usage chunk) */\n  inputTokens: number;\n  /** Output token count (from usage chunk) */\n  outputTokens: number;\n  /** Number of tokens read from cache */\n  cacheReadTokens: number;\n}\n\n/**\n * Creates a fresh stream state object for a new streaming session.\n */\nexport function createStreamState(): GroqStreamState {\n  return {\n    id: '',\n    model: '',\n    text: '',\n    toolCalls: new Map(),\n    finishReason: null,\n    inputTokens: 0,\n    outputTokens: 0,\n    cacheReadTokens: 0,\n  };\n}\n\n/**\n * Transforms a Groq streaming chunk into UPP stream events.\n */\nexport function transformStreamEvent(\n  chunk: GroqStreamChunk,\n  state: GroqStreamState\n): StreamEvent[] {\n  const events: StreamEvent[] = [];\n\n  if (chunk.id && !state.id) {\n    state.id = chunk.id;\n    events.push({ type: StreamEventType.MessageStart, index: 0, delta: {} });\n  }\n  if (chunk.model) {\n    state.model = chunk.model;\n  }\n\n  const choice = chunk.choices[0];\n  if (choice) {\n    if (choice.delta.content) {\n      state.text += choice.delta.content;\n      events.push({\n        type: StreamEventType.TextDelta,\n        index: 0,\n        delta: { text: choice.delta.content },\n      });\n    }\n\n    if (choice.delta.tool_calls) {\n      for (const toolCallDelta of choice.delta.tool_calls) {\n        const index = toolCallDelta.index;\n        let toolCall = state.toolCalls.get(index);\n\n        if (!toolCall) {\n          toolCall = { id: '', name: '', arguments: '' };\n          state.toolCalls.set(index, toolCall);\n        }\n\n        if (toolCallDelta.id) {\n          toolCall.id = toolCallDelta.id;\n        }\n        if (toolCallDelta.function?.name) {\n          toolCall.name = toolCallDelta.function.name;\n        }\n        if (toolCallDelta.function?.arguments) {\n          toolCall.arguments += toolCallDelta.function.arguments;\n          events.push({\n            type: StreamEventType.ToolCallDelta,\n            index: index,\n            delta: {\n              toolCallId: toolCall.id,\n              toolName: toolCall.name,\n              argumentsJson: toolCallDelta.function.arguments,\n            },\n          });\n        }\n      }\n    }\n\n    if (choice.finish_reason) {\n      state.finishReason = choice.finish_reason;\n      events.push({ type: StreamEventType.MessageStop, index: 0, delta: {} });\n    }\n  }\n\n  // Handle usage - can be in chunk.usage or chunk.x_groq.usage\n  const usageData = chunk.usage ?? chunk.x_groq?.usage;\n  if (usageData) {\n    state.inputTokens = usageData.prompt_tokens;\n    state.outputTokens = usageData.completion_tokens;\n    state.cacheReadTokens = usageData.prompt_tokens_details?.cached_tokens ?? 0;\n  }\n\n  return events;\n}\n\n/**\n * Builds a complete LLMResponse from accumulated streaming state.\n */\nexport function buildResponseFromState(state: GroqStreamState): LLMResponse {\n  const textContent: TextBlock[] = [];\n  let structuredData: unknown;\n  if (state.text) {\n    textContent.push({ type: 'text', text: state.text });\n    try {\n      structuredData = JSON.parse(state.text);\n    } catch {\n      // Not JSON - expected for non-structured responses\n    }\n  }\n\n  const toolCalls: ToolCall[] = [];\n  for (const [, toolCall] of state.toolCalls) {\n    let args: Record<string, unknown> = {};\n    if (toolCall.arguments) {\n      try {\n        args = JSON.parse(toolCall.arguments);\n      } catch {\n        // Invalid JSON - use empty object\n      }\n    }\n    toolCalls.push({\n      toolCallId: toolCall.id,\n      toolName: toolCall.name,\n      arguments: args,\n    });\n  }\n\n  const messageId = state.id || generateId();\n  const message = new AssistantMessage(\n    textContent,\n    toolCalls.length > 0 ? toolCalls : undefined,\n    {\n      id: messageId,\n      metadata: {\n        groq: {\n          model: state.model,\n          finish_reason: state.finishReason,\n        },\n      },\n    }\n  );\n\n  const usage: TokenUsage = {\n    inputTokens: state.inputTokens,\n    outputTokens: state.outputTokens,\n    totalTokens: state.inputTokens + state.outputTokens,\n    cacheReadTokens: state.cacheReadTokens,\n    cacheWriteTokens: 0,\n  };\n\n  let stopReason = 'end_turn';\n  switch (state.finishReason) {\n    case 'stop':\n      stopReason = 'end_turn';\n      break;\n    case 'length':\n      stopReason = 'max_tokens';\n      break;\n    case 'tool_calls':\n      stopReason = 'tool_use';\n      break;\n    case 'content_filter':\n      stopReason = 'content_filter';\n      break;\n  }\n\n  return {\n    message,\n    usage,\n    stopReason,\n    data: structuredData,\n  };\n}\n","/**\n * @fileoverview Groq Chat Completions API Handler\n *\n * This module implements the LLM handler for Groq's Chat Completions API\n * (OpenAI-compatible at `/openai/v1/chat/completions`).\n *\n * @see {@link https://console.groq.com/docs/api-reference Groq API Reference}\n * @module providers/groq/llm\n */\n\nimport type { BoundLLMModel, LLMRequest, LLMResponse, LLMStreamResult, LLMCapabilities } from '../../types/llm.ts';\nimport type { LLMHandler } from '../../types/provider.ts';\nimport type { StreamEvent } from '../../types/stream.ts';\nimport { StreamEventType, objectDelta } from '../../types/stream.ts';\nimport type { LLMProvider } from '../../types/provider.ts';\nimport { UPPError, ErrorCode, ModalityType } from '../../types/errors.ts';\nimport { resolveApiKey } from '../../http/keys.ts';\nimport { doFetch, doStreamFetch } from '../../http/fetch.ts';\nimport { parseSSEStream } from '../../http/sse.ts';\nimport { normalizeHttpError } from '../../http/errors.ts';\nimport { parseJsonResponse } from '../../http/json.ts';\nimport { toError } from '../../utils/error.ts';\nimport type { GroqLLMParams, GroqResponse, GroqStreamChunk } from './types.ts';\nimport {\n  transformRequest,\n  transformResponse,\n  transformStreamEvent,\n  createStreamState,\n  buildResponseFromState,\n} from './transform.ts';\n\n/** Base URL for Groq's Chat Completions API endpoint */\nconst GROQ_API_URL = 'https://api.groq.com/openai/v1/chat/completions';\n\n/**\n * Capability declaration for the Groq Chat Completions API.\n *\n * Defines what features are supported by this handler:\n * - Streaming: Real-time token-by-token response streaming via SSE\n * - Tools: Function calling for structured interactions\n * - Structured Output: JSON schema-based response formatting\n * - Image Input: Vision capabilities on select models (Llama 4 preview)\n */\nconst GROQ_CAPABILITIES: LLMCapabilities = {\n  streaming: true,\n  tools: true,\n  structuredOutput: true,\n  imageInput: true,\n  documentInput: false,\n  videoInput: false,\n  audioInput: false,\n};\n\n/**\n * Creates an LLM handler for Groq's Chat Completions API.\n *\n * This factory function creates a handler that communicates with the\n * `/openai/v1/chat/completions` endpoint. The handler supports both synchronous\n * completion requests and streaming responses.\n *\n * @returns An LLM handler configured for the Groq API\n *\n * @example\n * ```typescript\n * const handler = createLLMHandler();\n * const model = handler.bind('llama-3.3-70b-versatile');\n *\n * // Synchronous completion\n * const response = await model.complete({\n *   messages: [{ role: 'user', content: 'Hello!' }],\n *   config: { apiKey: 'gsk_...' }\n * });\n *\n * // Streaming completion\n * const stream = model.stream({\n *   messages: [{ role: 'user', content: 'Tell me a story' }],\n *   config: { apiKey: 'gsk_...' }\n * });\n *\n * for await (const event of stream) {\n *   if (event.type === StreamEventType.TextDelta) {\n *     process.stdout.write(event.delta.text);\n *   }\n * }\n * ```\n */\nexport function createLLMHandler(): LLMHandler<GroqLLMParams> {\n  let providerRef: LLMProvider<GroqLLMParams> | null = null;\n\n  return {\n    _setProvider(provider: LLMProvider<GroqLLMParams>) {\n      providerRef = provider;\n    },\n\n    bind(modelId: string): BoundLLMModel<GroqLLMParams> {\n      if (!providerRef) {\n        throw new UPPError(\n          'Provider reference not set. Handler must be used with createProvider() or have _setProvider called.',\n          ErrorCode.InvalidRequest,\n          'groq',\n          ModalityType.LLM\n        );\n      }\n\n      const model: BoundLLMModel<GroqLLMParams> = {\n        modelId,\n        capabilities: GROQ_CAPABILITIES,\n\n        get provider(): LLMProvider<GroqLLMParams> {\n          return providerRef!;\n        },\n\n        async complete(request: LLMRequest<GroqLLMParams>): Promise<LLMResponse> {\n          const apiKey = await resolveApiKey(\n            request.config,\n            'GROQ_API_KEY',\n            'groq',\n            'llm'\n          );\n\n          const baseUrl = request.config.baseUrl ?? GROQ_API_URL;\n          const body = transformRequest(request, modelId);\n\n          const headers: Record<string, string> = {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${apiKey}`,\n          };\n\n          if (request.config.headers) {\n            for (const [key, value] of Object.entries(request.config.headers)) {\n              if (value !== undefined) {\n                headers[key] = value;\n              }\n            }\n          }\n\n          const response = await doFetch(\n            baseUrl,\n            {\n              method: 'POST',\n              headers,\n              body: JSON.stringify(body),\n              signal: request.signal,\n            },\n            request.config,\n            'groq',\n            'llm'\n          );\n\n          const data = await parseJsonResponse<GroqResponse>(response, 'groq', 'llm');\n          return transformResponse(data);\n        },\n\n        stream(request: LLMRequest<GroqLLMParams>): LLMStreamResult {\n          const state = createStreamState();\n          let responseResolve: (value: LLMResponse) => void;\n          let responseReject: (error: Error) => void;\n\n          const responsePromise = new Promise<LLMResponse>((resolve, reject) => {\n            responseResolve = resolve;\n            responseReject = reject;\n          });\n\n          async function* generateEvents(): AsyncGenerator<StreamEvent, void, unknown> {\n            try {\n              const apiKey = await resolveApiKey(\n                request.config,\n                'GROQ_API_KEY',\n                'groq',\n                'llm'\n              );\n\n              const baseUrl = request.config.baseUrl ?? GROQ_API_URL;\n              const body = transformRequest(request, modelId);\n              body.stream = true;\n              body.stream_options = { include_usage: true };\n\n              const headers: Record<string, string> = {\n                'Content-Type': 'application/json',\n                Authorization: `Bearer ${apiKey}`,\n                Accept: 'text/event-stream',\n              };\n\n              if (request.config.headers) {\n                for (const [key, value] of Object.entries(request.config.headers)) {\n                  if (value !== undefined) {\n                    headers[key] = value;\n                  }\n                }\n              }\n\n              const response = await doStreamFetch(\n                baseUrl,\n                {\n                  method: 'POST',\n                  headers,\n                  body: JSON.stringify(body),\n                  signal: request.signal,\n                },\n                request.config,\n                'groq',\n                'llm'\n              );\n\n              if (!response.ok) {\n                const error = await normalizeHttpError(response, 'groq', 'llm');\n                responseReject(error);\n                throw error;\n              }\n\n              if (!response.body) {\n                const error = new UPPError(\n                  'No response body for streaming request',\n                  ErrorCode.ProviderError,\n                  'groq',\n                  ModalityType.LLM\n                );\n                responseReject(error);\n                throw error;\n              }\n\n              for await (const data of parseSSEStream(response.body)) {\n                // Skip [DONE] marker\n                if (data === '[DONE]') {\n                  continue;\n                }\n\n                // Check for Groq error event\n                if (typeof data === 'object' && data !== null) {\n                  const chunk = data as GroqStreamChunk;\n\n                  // Check for error in chunk\n                  if ('error' in chunk && chunk.error) {\n                    const errorData = chunk.error as { message?: string; type?: string };\n                    const error = new UPPError(\n                      errorData.message ?? 'Unknown error',\n                      ErrorCode.ProviderError,\n                      'groq',\n                      ModalityType.LLM\n                    );\n                    responseReject(error);\n                    throw error;\n                  }\n\n                  const uppEvents = transformStreamEvent(chunk, state);\n                  for (const event of uppEvents) {\n                    yield event;\n                    // Also emit ObjectDelta for structured output - gives developers explicit hook\n                    if (request.structure && event.type === StreamEventType.TextDelta) {\n                      yield objectDelta(event.delta.text ?? '', event.index);\n                    }\n                  }\n                }\n              }\n\n              // Build final response\n              responseResolve(buildResponseFromState(state));\n            } catch (error) {\n              const err = toError(error);\n              responseReject(err);\n              throw err;\n            }\n          }\n\n          return {\n            [Symbol.asyncIterator]() {\n              return generateEvents();\n            },\n            response: responsePromise,\n          };\n        },\n      };\n\n      return model;\n    },\n  };\n}\n","/**\n * @fileoverview Groq Provider Factory\n *\n * This module provides the main Groq provider implementation for the\n * OpenAI-compatible Chat Completions API.\n *\n * @module providers/groq\n */\n\nimport { createProvider } from '../../core/provider.ts';\nimport { createLLMHandler } from './llm.ts';\n\n/**\n * Configuration options for the Groq provider.\n *\n * Currently Groq only supports one API endpoint (Chat Completions),\n * so no additional options are needed.\n */\nexport interface GroqProviderOptions {\n  // Reserved for future use (e.g., if Groq adds multiple API modes)\n}\n\n/**\n * The Groq provider instance.\n *\n * Use this provider to create model references for Groq models like\n * Llama 3.3, Llama 3.1, Gemma 2, and other models available on Groq.\n *\n * @example Basic usage\n * ```typescript\n * import { groq } from './providers/groq';\n * import { llm } from './core/llm';\n *\n * const model = llm({\n *   model: groq('llama-3.3-70b-versatile'),\n *   params: { max_tokens: 1000 }\n * });\n *\n * const turn = await model.generate('Hello!');\n * console.log(turn.response.text);\n * ```\n *\n * @example With streaming\n * ```typescript\n * const stream = model.stream('Tell me a story');\n *\n * for await (const event of stream) {\n *   if (event.type === StreamEventType.TextDelta) {\n *     process.stdout.write(event.delta.text ?? '');\n *   }\n * }\n *\n * const turn = await stream.turn;\n * console.log('Tokens used:', turn.usage.totalTokens);\n * ```\n *\n * @example With tools\n * ```typescript\n * const calculator = {\n *   name: 'calculate',\n *   description: 'Calculate a math expression',\n *   parameters: {\n *     type: 'object',\n *     properties: {\n *       expression: { type: 'string' }\n *     },\n *     required: ['expression']\n *   },\n *   run: async (params: { expression: string }) => {\n *     return eval(params.expression);\n *   }\n * };\n *\n * const model = llm({\n *   model: groq('llama-3.3-70b-versatile'),\n *   tools: [calculator]\n * });\n *\n * const turn = await model.generate('What is 15 + 27?');\n * ```\n *\n * @example Available models\n * Production models:\n * - `llama-3.3-70b-versatile` - Versatile model with tool use support\n * - `llama-3.1-8b-instant` - Fast, efficient model\n * - `llama-guard-4-12b` - Content moderation model\n * - `gemma2-9b-it` - Google's Gemma 2 model\n *\n * Preview models:\n * - `meta-llama/llama-4-scout-17b-16e-instruct` - Vision + tool use\n * - `qwen/qwen3-32b` - Qwen 3 model\n */\nexport const groq = createProvider<GroqProviderOptions>({\n  name: 'groq',\n  version: '1.0.0',\n  handlers: {\n    llm: createLLMHandler(),\n  },\n});\n\nexport type {\n  GroqLLMParams,\n  GroqHeaders,\n  GroqResponseFormat,\n  GroqMessage,\n  GroqRequest,\n  GroqResponse,\n  GroqStreamChunk,\n  GroqTool,\n  GroqToolCall,\n  GroqToolChoice,\n  GroqUsage,\n  GroqSearchSettings,\n  GroqDocument,\n  GroqCitationOptions,\n} from './types.ts';\n"],"mappings":"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","names":[]}

package/dist/http/index.d.ts

@@ -1,5 +1,6 @@
-export { D as DynamicKey, E as ExponentialBackoff, L as LinearBackoff, N as NoRetry, a as RetryAfterStrategy, R as RoundRobinKeys, T as TokenBucket, W as WeightedKeys, m as maskApiKey, r as resolveApiKey } from '../retry-8Ch-WWgX.js';
-import { au as ProviderConfig, k as Modality, U as UPPError, i as ErrorCode } from '../llm-BQJZj3cD.js';
+export { D as DynamicKey, E as ExponentialBackoff, L as LinearBackoff, N as NoRetry, a as RetryAfterStrategy, R as RoundRobinKeys, T as TokenBucket, W as WeightedKeys, m as maskApiKey, r as resolveApiKey } from '../retry-YayV42GV.js';
+import { b as ProviderConfig, e as Modality, U as UPPError, f as ErrorCode } from '../llm-DwbUK7un.js';
+import '../stream-CecfVCPO.js';
 
 /**
  * HTTP fetch utilities with retry, timeout, and error normalization.

package/dist/http/index.js

@@ -4,18 +4,18 @@ import {
   NoRetry,
   RetryAfterStrategy,
   TokenBucket
-} from "../chunk-KUPF5KHT.js";
+} from "../chunk-Y5H7C5J4.js";
 import {
   parseSSEStream,
   parseSimpleTextStream
-} from "../chunk-TOJCZMVU.js";
+} from "../chunk-PMK5LZ5Z.js";
 import {
   DynamicKey,
   RoundRobinKeys,
   WeightedKeys,
   maskApiKey,
   resolveApiKey
-} from "../chunk-3D6XGGVG.js";
+} from "../chunk-ARVM24K2.js";
 import {
   cancelledError,
   doFetch,
@@ -25,7 +25,8 @@ import {
   statusToErrorCode,
   timeoutError,
   warnInsecureUrl
-} from "../chunk-4J6OFUKX.js";
+} from "../chunk-AY55T37A.js";
+import "../chunk-COS4ON4G.js";
 export {
   DynamicKey,
   ExponentialBackoff,

package/dist/image-stream-C0ciACM2.d.ts

@@ -0,0 +1,11 @@
+import { I as ImageStreamResult, a as ImageProviderStreamResult } from './llm-DwbUK7un.js';
+
+/**
+ * @fileoverview Image stream helpers for proxy server adapters.
+ *
+ * @module providers/proxy/server/image-stream
+ */
+
+type ImageStreamLike = ImageStreamResult | ImageProviderStreamResult;
+
+export type { ImageStreamLike as I };

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-import { L as LLMOptions, a as LLMInstance, I as ImageOptions, b as ImageInstance, c as LLMHandler, E as EmbeddingHandler, d as ImageHandler, P as Provider, M as ModelReference, D as DocumentSource, e as DocumentBlock, A as AudioBlock, V as VideoBlock, f as Middleware, g as EventDelta, S as StreamEvent } from './llm-BQJZj3cD.js';
-export { Y as AfterCallResult, b2 as AnyRequest, b3 as AnyResponse, q as AssistantContent, a0 as AssistantMessage, X as BeforeCallResult, B as BinaryBlock, aA as BoundEmbeddingModel, aZ as BoundImageModel, aK as BoundLLMModel, C as ContentBlock, r as ContentBlockType, t as DocumentSourceType, aF as EmbeddingInput, ay as EmbeddingProvider, aB as EmbeddingRequest, aC as EmbeddingResponse, aE as EmbeddingUsage, aD as EmbeddingVector, i as ErrorCode, aP as GeneratedImage, h as Image, n as ImageBlock, aU as ImageCapabilities, aN as ImageEditInput, aW as ImageEditRequest, aO as ImageGenerateOptions, aM as ImageInput, a_ as ImageModelInput, az as ImageProvider, aY as ImageProviderStreamResult, aV as ImageRequest, aX as ImageResponse, aR as ImageResult, o as ImageSource, s as ImageSourceType, aS as ImageStreamEvent, aT as ImageStreamResult, aQ as ImageUsage, aL as InferenceInput, J as JSONSchema, l as JSONSchemaProperty, m as JSONSchemaPropertyType, av as KeyStrategy, aG as LLMCapabilities, ax as LLMProvider, aH as LLMRequest, aI as LLMResponse, aJ as LLMStreamResult, _ as Message, ag as MessageJSON, a7 as MessageMetadata, a8 as MessageOptions, a2 as MessageRole, a6 as MessageType, a$ as MiddlewareContext, b1 as MiddlewareModality, k as Modality, j as ModalityType, au as ProviderConfig, at as ProviderIdentity, R as ReasoningBlock, aw as RetryStrategy, b0 as StreamContext, ai as StreamEventType, ah as StreamResult, T as TextBlock, ae as Thread, af as ThreadJSON, aa as TokenUsage, K as Tool, N as ToolCall, Z as ToolExecution, Q as ToolMetadata, O as ToolResult, a1 as ToolResultMessage, W as ToolUseStrategy, a9 as Turn, U as UPPError, p as UserContent, $ as UserMessage, ad as aggregateUsage, ap as contentBlockStart, aq as contentBlockStop, aj as createStreamResult, ab as createTurn, ac as emptyUsage, a4 as isAssistantMessage, F as isAudioBlock, H as isBinaryBlock, z as isDocumentBlock, y as isImageBlock, x as isReasoningBlock, w as isTextBlock, a5 as isToolResultMessage, a3 as isUserMessage, G as isVideoBlock, an as messageStart, ao as messageStop, am as objectDelta, v as reasoning, u as text, ak as textDelta, al as toolCallDelta, as as toolExecutionEnd, ar as toolExecutionStart } from './llm-BQJZj3cD.js';
-import { E as EmbeddingOptions, a as EmbeddingInstance } from './embedding-D2BYIehX.js';
-export { b as EmbedOptions, c as Embedding, h as EmbeddingInputType, g as EmbeddingModelInput, e as EmbeddingProgress, d as EmbeddingResult, f as EmbeddingStream } from './embedding-D2BYIehX.js';
-export { D as DynamicKey, E as ExponentialBackoff, L as LinearBackoff, N as NoRetry, a as RetryAfterStrategy, R as RoundRobinKeys, T as TokenBucket, W as WeightedKeys } from './retry-8Ch-WWgX.js';
+import { L as LLMOptions, h as LLMInstance, i as ImageOptions, j as ImageInstance, k as LLMHandler, l as EmbeddingHandler, m as ImageHandler, d as Provider, g as ModelReference } from './llm-DwbUK7un.js';
+export { a0 as AnyRequest, a1 as AnyResponse, B as BoundEmbeddingModel, X as BoundImageModel, A as BoundLLMModel, E as EmbeddingInput, r as EmbeddingProvider, t as EmbeddingRequest, u as EmbeddingResponse, c as EmbeddingUsage, v as EmbeddingVector, f as ErrorCode, H as GeneratedImage, n as Image, Q as ImageCapabilities, F as ImageEditInput, V as ImageEditRequest, G as ImageGenerateOptions, D as ImageInput, Y as ImageModelInput, s as ImageProvider, a as ImageProviderStreamResult, S as ImageRequest, W as ImageResponse, N as ImageResult, O as ImageStreamEvent, I as ImageStreamResult, J as ImageUsage, C as InferenceInput, K as KeyStrategy, w as LLMCapabilities, q as LLMProvider, x as LLMRequest, y as LLMResponse, z as LLMStreamResult, M as Middleware, Z as MiddlewareContext, $ as MiddlewareModality, e as Modality, o as ModalityType, b as ProviderConfig, P as ProviderIdentity, R as RetryStrategy, _ as StreamContext, T as Thread, p as ThreadJSON, U as UPPError } from './llm-DwbUK7un.js';
+import { E as EmbeddingOptions, a as EmbeddingInstance } from './embedding-CW6SaOOz.js';
+export { b as EmbedOptions, c as Embedding, h as EmbeddingInputType, g as EmbeddingModelInput, e as EmbeddingProgress, d as EmbeddingResult, f as EmbeddingStream } from './embedding-CW6SaOOz.js';
+import { D as DocumentSource, j as DocumentBlock, k as AudioBlock, V as VideoBlock } from './stream-CecfVCPO.js';
+export { L as AfterCallResult, A as AssistantContent, g as AssistantMessage, K as BeforeCallResult, B as BinaryBlock, C as ContentBlock, o as ContentBlockType, q as DocumentSourceType, E as EventDelta, c as ImageBlock, I as ImageSource, p as ImageSourceType, J as JSONSchema, l as JSONSchemaProperty, m as JSONSchemaPropertyType, M as Message, a as MessageJSON, Z as MessageMetadata, _ as MessageOptions, Q as MessageRole, e as MessageType, R as ReasoningBlock, S as StreamEvent, a2 as StreamEventType, i as StreamResult, n as TextBlock, h as TokenUsage, d as Tool, F as ToolCall, N as ToolExecution, H as ToolMetadata, G as ToolResult, P as ToolResultMessage, f as ToolUseStrategy, T as Turn, U as UserContent, O as UserMessage, a1 as aggregateUsage, a9 as contentBlockStart, aa as contentBlockStop, a3 as createStreamResult, $ as createTurn, a0 as emptyUsage, X as isAssistantMessage, x as isAudioBlock, z as isBinaryBlock, w as isDocumentBlock, v as isImageBlock, u as isReasoningBlock, s as isTextBlock, Y as isToolResultMessage, W as isUserMessage, y as isVideoBlock, a7 as messageStart, a8 as messageStop, a6 as objectDelta, r as reasoning, t as text, a4 as textDelta, a5 as toolCallDelta, ac as toolExecutionEnd, ab as toolExecutionStart } from './stream-CecfVCPO.js';
+export { D as DynamicKey, E as ExponentialBackoff, L as LinearBackoff, N as NoRetry, a as RetryAfterStrategy, R as RoundRobinKeys, T as TokenBucket, W as WeightedKeys } from './retry-YayV42GV.js';
 
 /**
  * @fileoverview LLM instance factory and streaming logic for the Universal Provider Protocol.
@@ -680,118 +682,6 @@ declare class Video {
     static fromBlock(block: VideoBlock): Video;
 }
 
-/**
- * @fileoverview Parsed object middleware for incremental JSON parsing.
- *
- * This middleware parses partial JSON from ObjectDelta and ToolCallDelta
- * stream events, providing incremental structured data during streaming.
- *
- * @module middleware/parsed-object
- */
-
-/**
- * Event delta with parsed JSON data.
- * Extended by parsedObjectMiddleware when parsing is enabled.
- */
-interface ParsedEventDelta extends EventDelta {
-    /** Incrementally parsed JSON value */
-    parsed?: unknown;
-}
-/**
- * Stream event with parsed JSON data.
- * Returned by parsedObjectMiddleware for ObjectDelta and ToolCallDelta events.
- */
-interface ParsedStreamEvent extends Omit<StreamEvent, 'delta'> {
-    delta: ParsedEventDelta;
-}
-/**
- * Options for parsed object middleware.
- */
-interface ParsedObjectOptions {
-    /**
-     * Parse ObjectDelta events (structured output responses).
-     * @default true
-     */
-    parseObjects?: boolean;
-    /**
-     * Parse ToolCallDelta events (tool call arguments).
-     * @default true
-     */
-    parseToolCalls?: boolean;
-}
-declare function parsedObjectMiddleware(options?: ParsedObjectOptions): Middleware;
-
-/**
- * @fileoverview Logging middleware for request/response visibility.
- *
- * Provides configurable logging for LLM, embedding, and image operations,
- * including timing, error tracking, and optional event logging.
- *
- * @module middleware/logging
- */
-
-/**
- * Log levels for filtering output.
- */
-type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-/**
- * Options for logging middleware.
- */
-interface LoggingOptions {
-    /**
-     * Minimum log level to output.
-     * @default 'info'
-     */
-    level?: LogLevel;
-    /**
-     * Log individual stream events.
-     * @default false
-     */
-    logStreamEvents?: boolean;
-    /**
-     * Log tool calls and results.
-     * @default true
-     */
-    logToolCalls?: boolean;
-    /**
-     * Custom logger function. If not provided, uses console.log.
-     * @param level - The log level
-     * @param message - The log message
-     * @param data - Optional additional data
-     */
-    logger?(level: LogLevel, message: string, data?: Record<string, unknown>): void;
-    /**
-     * Prefix for all log messages.
-     * @default '[PP]'
-     */
-    prefix?: string;
-}
-/**
- * Creates a logging middleware for visibility into request lifecycle.
- *
- * This middleware logs the start, end, and errors of requests,
- * with optional logging of stream events and tool calls.
- *
- * @param options - Configuration options
- * @returns A middleware that logs request lifecycle events
- *
- * @example
- * ```typescript
- * import { llm, loggingMiddleware } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- *
- * const model = llm({
- *   model: anthropic('claude-sonnet-4-20250514'),
- *   middleware: [loggingMiddleware({ level: 'debug' })],
- * });
- *
- * // Logs: [PP] [anthropic] Starting llm request (streaming)
- * // Logs: [PP] [anthropic] Completed in 1234ms
- * const result = await model.generate('Hello');
- * ```
- */
-declare function loggingMiddleware(options?: LoggingOptions): Middleware;
-
 /**
  * @fileoverview Unified Provider Protocol (UPP) - A unified interface for AI model inference
  *
@@ -850,4 +740,4 @@ declare const ai: {
     image: typeof image;
 };
 
-export { Audio, AudioBlock, Document, DocumentBlock, DocumentSource, EmbeddingHandler, EmbeddingInstance, EmbeddingOptions, EventDelta, ImageHandler, ImageInstance, ImageOptions, LLMHandler, LLMInstance, LLMOptions, type LogLevel, type LoggingOptions, Middleware, ModelReference, type ParsedEventDelta, type ParsedObjectOptions, type ParsedStreamEvent, Provider, StreamEvent, Video, VideoBlock, ai, createProvider, embedding, image, llm, loggingMiddleware, parsedObjectMiddleware };
+export { Audio, AudioBlock, Document, DocumentBlock, DocumentSource, EmbeddingHandler, EmbeddingInstance, EmbeddingOptions, ImageHandler, ImageInstance, ImageOptions, LLMHandler, LLMInstance, LLMOptions, ModelReference, Provider, Video, VideoBlock, ai, createProvider, embedding, image, llm };