@providerprotocol/ai 0.0.31 → 0.0.32

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-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 } from './llm-DgDEy9il.js';
-export { S as AfterCallResult, o as AssistantContent, Z as AssistantMessage, Q as BeforeCallResult, B as BinaryBlock, aw as BoundEmbeddingModel, aV as BoundImageModel, aG as BoundLLMModel, C as ContentBlock, p as ContentBlockType, r as DocumentSourceType, aB as EmbeddingInput, au as EmbeddingProvider, ax as EmbeddingRequest, ay as EmbeddingResponse, aA as EmbeddingUsage, az as EmbeddingVector, g as ErrorCode, af as EventDelta, aL as GeneratedImage, f as Image, l as ImageBlock, aQ as ImageCapabilities, aJ as ImageEditInput, aS as ImageEditRequest, aK as ImageGenerateOptions, aI as ImageInput, aW as ImageModelInput, av as ImageProvider, aU as ImageProviderStreamResult, aR as ImageRequest, aT as ImageResponse, aN as ImageResult, m as ImageSource, q as ImageSourceType, aO as ImageStreamEvent, aP as ImageStreamResult, aM as ImageUsage, aH as InferenceInput, J as JSONSchema, j as JSONSchemaProperty, k as JSONSchemaPropertyType, ar as KeyStrategy, aC as LLMCapabilities, at as LLMProvider, aD as LLMRequest, aE as LLMResponse, aF as LLMStreamResult, X as Message, ad as MessageJSON, a4 as MessageMetadata, a5 as MessageOptions, $ as MessageRole, a3 as MessageType, i as Modality, h as ModalityType, aq as ProviderConfig, ap as ProviderIdentity, R as ReasoningBlock, as as RetryStrategy, ae as StreamEvent, ah as StreamEventType, ag as StreamResult, T as TextBlock, ab as Thread, ac as ThreadJSON, a7 as TokenUsage, G as Tool, H as ToolCall, W as ToolExecution, N as ToolMetadata, K as ToolResult, _ as ToolResultMessage, O as ToolUseStrategy, a6 as Turn, U as UPPError, n as UserContent, Y as UserMessage, aa as aggregateUsage, an as contentBlockStart, ao as contentBlockStop, ai as createStreamResult, a8 as createTurn, a9 as emptyUsage, a1 as isAssistantMessage, y as isAudioBlock, F as isBinaryBlock, x as isDocumentBlock, w as isImageBlock, v as isReasoningBlock, u as isTextBlock, a2 as isToolResultMessage, a0 as isUserMessage, z as isVideoBlock, al as messageStart, am as messageStop, s as reasoning, t as text, aj as textDelta, ak as toolCallDelta } from './llm-DgDEy9il.js';
-import { E as EmbeddingOptions, a as EmbeddingInstance } from './embedding-k7g-BcSY.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-k7g-BcSY.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-CyAwm_KZ.js';
+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';
 
 /**
  * @fileoverview LLM instance factory and streaming logic for the Universal Provider Protocol.
@@ -680,6 +680,118 @@ 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
  *
@@ -738,4 +850,4 @@ declare const ai: {
     image: typeof image;
 };
 
-export { Audio, AudioBlock, Document, DocumentBlock, DocumentSource, EmbeddingHandler, EmbeddingInstance, EmbeddingOptions, ImageHandler, ImageInstance, ImageOptions, LLMHandler, LLMInstance, LLMOptions, ModelReference, Provider, Video, VideoBlock, ai, createProvider, embedding, image, llm };
+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 };