@providerprotocol/ai 0.0.26 → 0.0.28

package/dist/proxy/index.d.ts

@@ -1,5 +1,5 @@
-import { g as Provider, M as ModelReference } from '../provider-x4RocsnK.js';
-import { M as Message, b as MessageJSON, T as Turn, I as TurnJSON, f as StreamEvent, S as StreamResult, J as JSONSchema, k as ToolMetadata, c as Tool } from '../stream-ITNFNnO4.js';
+import { X as Message, ad as MessageJSON, a6 as Turn, aX as TurnJSON, ae as StreamEvent, aP as ImageStreamResult, aU as ImageProviderStreamResult, aN as ImageResult, ag as StreamResult, f as Image, J as JSONSchema, N as ToolMetadata, aB as EmbeddingInput, G as Tool, P as Provider, M as ModelReference } from '../llm-DgDEy9il.js';
+import { d as EmbeddingResult } from '../embedding-DtyOFIsS.js';
 
 /**
  * @fileoverview Proxy provider types.
@@ -19,6 +19,26 @@ interface ProxyLLMParams {
     /** Parameters are passed through to the backend */
     [key: string]: unknown;
 }
+/**
+ * Proxy-specific embedding parameters.
+ *
+ * These parameters are passed through to the backend server.
+ * The server decides how to interpret them based on its own provider.
+ */
+interface ProxyEmbeddingParams {
+    /** Parameters are passed through to the backend */
+    [key: string]: unknown;
+}
+/**
+ * Proxy-specific image parameters.
+ *
+ * These parameters are passed through to the backend server.
+ * The server decides how to interpret them based on its own provider.
+ */
+interface ProxyImageParams {
+    /** Parameters are passed through to the backend */
+    [key: string]: unknown;
+}
 /**
  * Configuration options for creating a proxy provider.
  */
@@ -72,6 +92,14 @@ declare function serializeStreamEvent(event: StreamEvent): StreamEvent;
  */
 declare function deserializeStreamEvent(event: StreamEvent): StreamEvent;
 
+/**
+ * @fileoverview Image stream helpers for proxy server adapters.
+ *
+ * @module providers/proxy/server/image-stream
+ */
+
+type ImageStreamLike = ImageStreamResult | ImageProviderStreamResult;
+
 /**
  * @fileoverview H3/Nitro/Nuxt adapter for proxy server.
  *
@@ -107,6 +135,22 @@ interface H3Event {
  * ```
  */
 declare function sendJSON$2(turn: Turn, event: H3Event): unknown;
+/**
+ * Send an EmbeddingResult as JSON response.
+ *
+ * @param result - The embedding result
+ * @param event - H3 event object
+ * @returns Serialized result data
+ */
+declare function sendEmbeddingJSON$2(result: EmbeddingResult, event: H3Event): unknown;
+/**
+ * Send an ImageResult as JSON response.
+ *
+ * @param result - The image result
+ * @param event - H3 event object
+ * @returns Serialized image result data
+ */
+declare function sendImageJSON$2(result: ImageResult, event: H3Event): unknown;
 /**
  * Stream a StreamResult as Server-Sent Events.
  *
@@ -120,6 +164,13 @@ declare function sendJSON$2(turn: Turn, event: H3Event): unknown;
  * ```
  */
 declare function streamSSE$2(stream: StreamResult, event: H3Event): void;
+/**
+ * Stream an ImageStreamResult as Server-Sent Events.
+ *
+ * @param stream - The ImageStreamResult or ImageProviderStreamResult from image().stream()
+ * @param event - H3 event object
+ */
+declare function streamImageSSE$2(stream: ImageStreamLike, event: H3Event): void;
 /**
  * Create a ReadableStream for H3's sendStream utility.
  *
@@ -133,6 +184,13 @@ declare function streamSSE$2(stream: StreamResult, event: H3Event): void;
  * @returns A ReadableStream of SSE data
  */
 declare function createSSEStream(stream: StreamResult): ReadableStream<Uint8Array>;
+/**
+ * Create a ReadableStream for image SSE data.
+ *
+ * @param stream - The ImageStreamResult or ImageProviderStreamResult from image().stream()
+ * @returns A ReadableStream of SSE data
+ */
+declare function createImageSSEStream(stream: ImageStreamLike): ReadableStream<Uint8Array>;
 /**
  * Send an error response.
  *
@@ -216,8 +274,12 @@ declare function sendError$2(message: string, status: number, event: H3Event): {
  */
 declare const h3: {
     sendJSON: typeof sendJSON$2;
+    sendEmbeddingJSON: typeof sendEmbeddingJSON$2;
+    sendImageJSON: typeof sendImageJSON$2;
     streamSSE: typeof streamSSE$2;
+    streamImageSSE: typeof streamImageSSE$2;
     createSSEStream: typeof createSSEStream;
+    createImageSSEStream: typeof createImageSSEStream;
     sendError: typeof sendError$2;
 };
 
@@ -255,6 +317,20 @@ interface FastifyReply {
  * ```
  */
 declare function sendJSON$1(turn: Turn, reply: FastifyReply): FastifyReply;
+/**
+ * Send an EmbeddingResult as JSON response.
+ *
+ * @param result - The embedding result
+ * @param reply - Fastify reply object
+ */
+declare function sendEmbeddingJSON$1(result: EmbeddingResult, reply: FastifyReply): FastifyReply;
+/**
+ * Send an ImageResult as JSON response.
+ *
+ * @param result - The image result
+ * @param reply - Fastify reply object
+ */
+declare function sendImageJSON$1(result: ImageResult, reply: FastifyReply): FastifyReply;
 /**
  * Stream a StreamResult as Server-Sent Events.
  *
@@ -268,6 +344,13 @@ declare function sendJSON$1(turn: Turn, reply: FastifyReply): FastifyReply;
  * ```
  */
 declare function streamSSE$1(stream: StreamResult, reply: FastifyReply): FastifyReply;
+/**
+ * Stream an ImageStreamResult as Server-Sent Events.
+ *
+ * @param stream - The ImageStreamResult or ImageProviderStreamResult from image().stream()
+ * @param reply - Fastify reply object
+ */
+declare function streamImageSSE$1(stream: ImageStreamLike, reply: FastifyReply): FastifyReply;
 /**
  * Send an error response.
  *
@@ -349,7 +432,10 @@ declare function sendError$1(message: string, status: number, reply: FastifyRepl
  */
 declare const fastify: {
     sendJSON: typeof sendJSON$1;
+    sendEmbeddingJSON: typeof sendEmbeddingJSON$1;
+    sendImageJSON: typeof sendImageJSON$1;
     streamSSE: typeof streamSSE$1;
+    streamImageSSE: typeof streamImageSSE$1;
     sendError: typeof sendError$1;
 };
 
@@ -385,6 +471,20 @@ interface ExpressResponse {
  * ```
  */
 declare function sendJSON(turn: Turn, res: ExpressResponse): void;
+/**
+ * Send an EmbeddingResult as JSON response.
+ *
+ * @param result - The embedding result
+ * @param res - Express response object
+ */
+declare function sendEmbeddingJSON(result: EmbeddingResult, res: ExpressResponse): void;
+/**
+ * Send an ImageResult as JSON response.
+ *
+ * @param result - The image result
+ * @param res - Express response object
+ */
+declare function sendImageJSON(result: ImageResult, res: ExpressResponse): void;
 /**
  * Stream a StreamResult as Server-Sent Events.
  *
@@ -398,6 +498,13 @@ declare function sendJSON(turn: Turn, res: ExpressResponse): void;
  * ```
  */
 declare function streamSSE(stream: StreamResult, res: ExpressResponse): void;
+/**
+ * Stream an ImageStreamResult as Server-Sent Events.
+ *
+ * @param stream - The ImageStreamResult or ImageProviderStreamResult from image().stream()
+ * @param res - Express response object
+ */
+declare function streamImageSSE(stream: ImageStreamLike, res: ExpressResponse): void;
 /**
  * Send an error response.
  *
@@ -480,10 +587,43 @@ declare function sendError(message: string, status: number, res: ExpressResponse
  */
 declare const express: {
     sendJSON: typeof sendJSON;
+    sendEmbeddingJSON: typeof sendEmbeddingJSON;
+    sendImageJSON: typeof sendImageJSON;
     streamSSE: typeof streamSSE;
+    streamImageSSE: typeof streamImageSSE;
     sendError: typeof sendError;
 };
 
+/**
+ * @fileoverview Media serialization utilities for proxy transport.
+ *
+ * Handles converting embedding inputs and image results/events to/from JSON
+ * for HTTP transport. These are pure functions with no side effects.
+ *
+ * @module providers/proxy/serialization.media
+ */
+
+type SerializedImageSource = {
+    type: 'base64';
+    data: string;
+} | {
+    type: 'url';
+    url: string;
+} | {
+    type: 'bytes';
+    data: number[] | string;
+};
+interface SerializedImage {
+    source: SerializedImageSource;
+    mimeType: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * Deserialize an Image from JSON transport.
+ */
+declare function deserializeImage(image: SerializedImage): Image;
+
 /**
  * @fileoverview Web API adapter for proxy server.
  *
@@ -504,6 +644,7 @@ interface ParsedRequest {
     messages: Message[];
     system?: string | unknown[];
     params?: Record<string, unknown>;
+    model?: string;
     tools?: Array<{
         name: string;
         description: string;
@@ -512,6 +653,24 @@ interface ParsedRequest {
     }>;
     structure?: JSONSchema;
 }
+/**
+ * Parsed request body for embedding endpoints.
+ */
+interface ParsedEmbeddingRequest {
+    inputs: EmbeddingInput[];
+    params?: Record<string, unknown>;
+    model?: string;
+}
+/**
+ * Parsed request body for image endpoints.
+ */
+interface ParsedImageRequest {
+    prompt: string;
+    params?: Record<string, unknown>;
+    model?: string;
+    image?: ReturnType<typeof deserializeImage>;
+    mask?: ReturnType<typeof deserializeImage>;
+}
 /**
  * Parse an HTTP request body into PP types.
  *
@@ -528,6 +687,20 @@ interface ParsedRequest {
  * ```
  */
 declare function parseBody(body: unknown): ParsedRequest;
+/**
+ * Parse an HTTP request body into embedding inputs.
+ *
+ * @param body - The JSON-parsed request body
+ * @returns Parsed embedding request data
+ */
+declare function parseEmbeddingBody(body: unknown): ParsedEmbeddingRequest;
+/**
+ * Parse an HTTP request body into image request data.
+ *
+ * @param body - The JSON-parsed request body
+ * @returns Parsed image request data
+ */
+declare function parseImageBody(body: unknown): ParsedImageRequest;
 /**
  * Create a JSON Response from a Turn.
  *
@@ -541,6 +714,20 @@ declare function parseBody(body: unknown): ParsedRequest;
  * ```
  */
 declare function toJSON(turn: Turn): Response;
+/**
+ * Create a JSON Response from an embedding result.
+ *
+ * @param result - The embedding result
+ * @returns HTTP Response with JSON body
+ */
+declare function toEmbeddingJSON(result: EmbeddingResult): Response;
+/**
+ * Create a JSON Response from an image result.
+ *
+ * @param result - The image result
+ * @returns HTTP Response with JSON body
+ */
+declare function toImageJSON(result: ImageResult): Response;
 /**
  * Create an SSE Response from a StreamResult.
  *
@@ -556,6 +743,15 @@ declare function toJSON(turn: Turn): Response;
  * ```
  */
 declare function toSSE(stream: StreamResult): Response;
+/**
+ * Create an SSE Response from an ImageStreamResult.
+ *
+ * Streams image events as SSE, then sends the final image result.
+ *
+ * @param stream - The ImageStreamResult or ImageProviderStreamResult from image().stream()
+ * @returns HTTP Response with SSE body
+ */
+declare function toImageSSE(stream: ImageStreamLike): Response;
 /**
  * Create an error Response.
  *
@@ -659,8 +855,13 @@ declare function bindTools(schemas: ParsedRequest['tools'], implementations: Rec
  */
 declare const webapi: {
     parseBody: typeof parseBody;
+    parseEmbeddingBody: typeof parseEmbeddingBody;
+    parseImageBody: typeof parseImageBody;
     toJSON: typeof toJSON;
+    toEmbeddingJSON: typeof toEmbeddingJSON;
+    toImageJSON: typeof toImageJSON;
     toSSE: typeof toSSE;
+    toImageSSE: typeof toImageSSE;
     toError: typeof toError;
     bindTools: typeof bindTools;
 };
@@ -678,6 +879,7 @@ interface ParsedBody {
     messages: Message[];
     system?: string | unknown[];
     params?: Record<string, unknown>;
+    model?: string;
     tools?: Array<{
         name: string;
         description: string;
@@ -760,28 +962,43 @@ declare const server: {
     /** Web API adapter (Bun, Deno, Next.js, Workers) */
     webapi: {
         parseBody: typeof parseBody;
+        parseEmbeddingBody: typeof parseEmbeddingBody;
+        parseImageBody: typeof parseImageBody;
         toJSON: typeof toJSON;
+        toEmbeddingJSON: typeof toEmbeddingJSON;
+        toImageJSON: typeof toImageJSON;
         toSSE: typeof toSSE;
+        toImageSSE: typeof toImageSSE;
         toError: typeof toError;
         bindTools: typeof bindTools;
     };
     /** Express/Connect adapter */
     express: {
         sendJSON: typeof sendJSON;
+        sendEmbeddingJSON: typeof sendEmbeddingJSON;
+        sendImageJSON: typeof sendImageJSON;
         streamSSE: typeof streamSSE;
+        streamImageSSE: typeof streamImageSSE;
         sendError: typeof sendError;
     };
     /** Fastify adapter */
     fastify: {
         sendJSON: typeof sendJSON$1;
+        sendEmbeddingJSON: typeof sendEmbeddingJSON$1;
+        sendImageJSON: typeof sendImageJSON$1;
         streamSSE: typeof streamSSE$1;
+        streamImageSSE: typeof streamImageSSE$1;
         sendError: typeof sendError$1;
     };
     /** H3/Nitro/Nuxt adapter */
     h3: {
         sendJSON: typeof sendJSON$2;
+        sendEmbeddingJSON: typeof sendEmbeddingJSON$2;
+        sendImageJSON: typeof sendImageJSON$2;
         streamSSE: typeof streamSSE$2;
+        streamImageSSE: typeof streamImageSSE$2;
         createSSEStream: typeof createSSEStream;
+        createImageSSEStream: typeof createImageSSEStream;
         sendError: typeof sendError$2;
     };
 };
@@ -831,4 +1048,4 @@ declare function proxy(options: ProxyProviderOptions): Provider<ProxyRequestOpti
  */
 declare function proxyModel(endpoint: string): ModelReference<ProxyRequestOptions>;
 
-export { type AdapterOptions, type ParsedBody, type ParsedRequest, type ProxyHandler, type ProxyLLMParams, type ProxyProviderOptions, type ProxyRequestOptions, type RequestMeta, TurnJSON, bindTools, deserializeMessage, deserializeStreamEvent, express, fastify, h3, parseBody, proxy, proxyModel, serializeMessage, serializeStreamEvent, serializeTurn, server, toError, toJSON, toSSE, webapi };
+export { type AdapterOptions, type ParsedBody, type ParsedEmbeddingRequest, type ParsedImageRequest, type ParsedRequest, type ProxyEmbeddingParams, type ProxyHandler, type ProxyImageParams, type ProxyLLMParams, type ProxyProviderOptions, type ProxyRequestOptions, type RequestMeta, TurnJSON, bindTools, deserializeMessage, deserializeStreamEvent, express, fastify, h3, parseBody, parseEmbeddingBody, parseImageBody, proxy, proxyModel, serializeMessage, serializeStreamEvent, serializeTurn, server, toEmbeddingJSON, toError, toImageJSON, toImageSSE, toJSON, toSSE, webapi };