@providerprotocol/ai 0.0.34 → 0.0.36

package/dist/proxy/index.d.ts

@@ -1,5 +1,12 @@
-import { _ as Message, ag as MessageJSON, a9 as Turn, b4 as TurnJSON, S as StreamEvent, aT as ImageStreamResult, aY as ImageProviderStreamResult, aR as ImageResult, ah as StreamResult, h as Image, J as JSONSchema, Q as ToolMetadata, aF as EmbeddingInput, K as Tool, P as Provider, M as ModelReference } from '../llm-BQJZj3cD.js';
-import { d as EmbeddingResult } from '../embedding-D2BYIehX.js';
+import { d as Provider, g as ModelReference } from '../llm-ByUFPcFH.js';
+export { AdapterOptions, ParsedBody, ProxyHandler, RequestMeta, server } from './server/index.js';
+import { M as Message, a as MessageJSON, T as Turn, b as TurnJSON, S as StreamEvent } from '../stream-S7nwQRqM.js';
+export { ParsedEmbeddingRequest, ParsedImageRequest, ParsedRequest, bindTools, parseBody, parseEmbeddingBody, parseImageBody, toEmbeddingJSON, toError, toImageJSON, toImageSSE, toJSON, toSSE, webapi } from './server/webapi/index.js';
+export { express } from './server/express/index.js';
+export { fastify } from './server/fastify/index.js';
+export { h3 } from './server/h3/index.js';
+import '../embedding-BXA72PlJ.js';
+import '../image-stream-CCgwB7ve.js';
 
 /**
  * @fileoverview Proxy provider types.
@@ -92,917 +99,6 @@ 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.
- *
- * Provides utilities for using PP proxy with H3-based servers
- * (Nuxt, Nitro, or standalone H3).
- *
- * @module providers/proxy/server/h3
- */
-
-/**
- * H3 Event interface (minimal type to avoid dependency).
- */
-interface H3Event {
-    node: {
-        res: {
-            setHeader(name: string, value: string): void;
-            write(chunk: string): boolean;
-            end(): void;
-        };
-    };
-}
-/**
- * Send a Turn as JSON response.
- *
- * @param turn - The completed inference turn
- * @param event - H3 event object
- * @returns Serialized turn data
- *
- * @example
- * ```typescript
- * const turn = await instance.generate(messages);
- * return h3Adapter.sendJSON(turn, event);
- * ```
- */
-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.
- *
- * @param stream - The StreamResult from instance.stream()
- * @param event - H3 event object
- *
- * @example
- * ```typescript
- * const stream = instance.stream(messages);
- * return h3Adapter.streamSSE(stream, event);
- * ```
- */
-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.
- *
- * Use this with H3's sendStream for better integration:
- * ```typescript
- * import { sendStream } from 'h3';
- * return sendStream(event, h3Adapter.createSSEStream(stream));
- * ```
- *
- * @param stream - The StreamResult from instance.stream()
- * @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.
- *
- * @param message - Error message
- * @param status - HTTP status code
- * @param event - H3 event object
- * @returns Error object for H3 to serialize
- */
-declare function sendError$2(message: string, status: number, event: H3Event): {
-    error: string;
-    statusCode: number;
-};
-/**
- * H3/Nitro/Nuxt adapter utilities.
- *
- * @example Basic usage
- * ```typescript
- * // Nuxt server route: server/api/ai.post.ts
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { parseBody } from '@providerprotocol/ai/proxy';
- * import { h3 as h3Adapter } from '@providerprotocol/ai/proxy/server';
- *
- * export default defineEventHandler(async (event) => {
- *   const body = await readBody(event);
- *   const { messages, system, params } = parseBody(body);
- *   const instance = llm({ model: anthropic('claude-sonnet-4-20250514'), system });
- *
- *   const wantsStream = getHeader(event, 'accept')?.includes('text/event-stream');
- *   if (wantsStream) {
- *     return h3Adapter.streamSSE(instance.stream(messages), event);
- *   } else {
- *     const turn = await instance.generate(messages);
- *     return h3Adapter.sendJSON(turn, event);
- *   }
- * });
- * ```
- *
- * @example API Gateway with authentication (Nuxt)
- * ```typescript
- * // server/api/ai.post.ts
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { ExponentialBackoff, RoundRobinKeys } from '@providerprotocol/ai/http';
- * import { parseBody } from '@providerprotocol/ai/proxy';
- * import { h3 as h3Adapter } from '@providerprotocol/ai/proxy/server';
- *
- * // Server manages AI provider keys - users never see them
- * const claude = llm({
- *   model: anthropic('claude-sonnet-4-20250514'),
- *   config: {
- *     apiKey: new RoundRobinKeys([
- *       process.env.ANTHROPIC_KEY_1!,
- *       process.env.ANTHROPIC_KEY_2!,
- *     ]),
- *     retryStrategy: new ExponentialBackoff({ maxAttempts: 3 }),
- *   },
- * });
- *
- * export default defineEventHandler(async (event) => {
- *   // Authenticate with your platform credentials
- *   const token = getHeader(event, 'authorization')?.replace('Bearer ', '');
- *   const user = await validatePlatformToken(token);
- *   if (!user) {
- *     throw createError({ statusCode: 401, message: 'Unauthorized' });
- *   }
- *
- *   // Track usage per user
- *   // await trackUsage(user.id);
- *
- *   const body = await readBody(event);
- *   const { messages, system, params } = parseBody(body);
- *
- *   if (params?.stream) {
- *     return h3Adapter.streamSSE(claude.stream(messages, { system }), event);
- *   }
- *   const turn = await claude.generate(messages, { system });
- *   return h3Adapter.sendJSON(turn, event);
- * });
- * ```
- */
-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;
-};
-
-/**
- * @fileoverview Fastify adapter for proxy server.
- *
- * Provides utilities for using PP proxy with Fastify servers.
- * These adapters convert PP types to Fastify-compatible responses.
- *
- * @module providers/proxy/server/fastify
- */
-
-/**
- * Fastify Reply interface (minimal type to avoid dependency).
- */
-interface FastifyReply {
-    header(name: string, value: string): FastifyReply;
-    status(code: number): FastifyReply;
-    send(payload: unknown): FastifyReply;
-    raw: {
-        write(chunk: string): boolean;
-        end(): void;
-    };
-}
-/**
- * Send a Turn as JSON response.
- *
- * @param turn - The completed inference turn
- * @param reply - Fastify reply object
- *
- * @example
- * ```typescript
- * const turn = await instance.generate(messages);
- * return fastifyAdapter.sendJSON(turn, reply);
- * ```
- */
-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.
- *
- * @param stream - The StreamResult from instance.stream()
- * @param reply - Fastify reply object
- *
- * @example
- * ```typescript
- * const stream = instance.stream(messages);
- * return fastifyAdapter.streamSSE(stream, reply);
- * ```
- */
-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.
- *
- * @param message - Error message
- * @param status - HTTP status code
- * @param reply - Fastify reply object
- */
-declare function sendError$1(message: string, status: number, reply: FastifyReply): FastifyReply;
-/**
- * Fastify adapter utilities.
- *
- * @example Basic usage
- * ```typescript
- * import Fastify from 'fastify';
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { parseBody } from '@providerprotocol/ai/proxy';
- * import { fastify as fastifyAdapter } from '@providerprotocol/ai/proxy/server';
- *
- * const app = Fastify();
- *
- * app.post('/api/ai', async (request, reply) => {
- *   const { messages, system, params } = parseBody(request.body);
- *   const instance = llm({ model: anthropic('claude-sonnet-4-20250514'), system });
- *
- *   if (request.headers.accept?.includes('text/event-stream')) {
- *     return fastifyAdapter.streamSSE(instance.stream(messages), reply);
- *   } else {
- *     const turn = await instance.generate(messages);
- *     return fastifyAdapter.sendJSON(turn, reply);
- *   }
- * });
- * ```
- *
- * @example API Gateway with authentication
- * ```typescript
- * import Fastify from 'fastify';
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { ExponentialBackoff, RoundRobinKeys } from '@providerprotocol/ai/http';
- * import { parseBody } from '@providerprotocol/ai/proxy';
- * import { fastify as fastifyAdapter } from '@providerprotocol/ai/proxy/server';
- *
- * const app = Fastify();
- *
- * // Server manages AI provider keys - users never see them
- * const claude = llm({
- *   model: anthropic('claude-sonnet-4-20250514'),
- *   config: {
- *     apiKey: new RoundRobinKeys([process.env.ANTHROPIC_KEY_1!, process.env.ANTHROPIC_KEY_2!]),
- *     retryStrategy: new ExponentialBackoff({ maxAttempts: 3 }),
- *   },
- * });
- *
- * // Auth hook for your platform
- * app.addHook('preHandler', async (request, reply) => {
- *   const token = request.headers.authorization?.replace('Bearer ', '');
- *   const user = await validatePlatformToken(token);
- *   if (!user) {
- *     reply.status(401).send({ error: 'Unauthorized' });
- *     return;
- *   }
- *   request.user = user;
- * });
- *
- * app.post('/api/ai', async (request, reply) => {
- *   // Track usage per user
- *   // await trackUsage(request.user.id);
- *
- *   const { messages, system, params } = parseBody(request.body);
- *
- *   if (params?.stream) {
- *     return fastifyAdapter.streamSSE(claude.stream(messages, { system }), reply);
- *   }
- *   const turn = await claude.generate(messages, { system });
- *   return fastifyAdapter.sendJSON(turn, reply);
- * });
- * ```
- */
-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;
-};
-
-/**
- * @fileoverview Express/Connect adapter for proxy server.
- *
- * Provides utilities for using PP proxy with Express.js or Connect-based servers.
- * These adapters convert PP types to Express-compatible responses.
- *
- * @module providers/proxy/server/express
- */
-
-/**
- * Express Response interface (minimal type to avoid dependency).
- */
-interface ExpressResponse {
-    setHeader(name: string, value: string): void;
-    status(code: number): ExpressResponse;
-    write(chunk: string): boolean;
-    end(): void;
-    json(body: unknown): void;
-}
-/**
- * Send a Turn as JSON response.
- *
- * @param turn - The completed inference turn
- * @param res - Express response object
- *
- * @example
- * ```typescript
- * const turn = await instance.generate(messages);
- * expressAdapter.sendJSON(turn, res);
- * ```
- */
-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.
- *
- * @param stream - The StreamResult from instance.stream()
- * @param res - Express response object
- *
- * @example
- * ```typescript
- * const stream = instance.stream(messages);
- * expressAdapter.streamSSE(stream, res);
- * ```
- */
-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.
- *
- * @param message - Error message
- * @param status - HTTP status code
- * @param res - Express response object
- */
-declare function sendError(message: string, status: number, res: ExpressResponse): void;
-/**
- * Express adapter utilities.
- *
- * @example Basic usage
- * ```typescript
- * import express from 'express';
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { parseBody } from '@providerprotocol/ai/proxy';
- * import { express as expressAdapter } from '@providerprotocol/ai/proxy/server';
- *
- * const app = express();
- * app.use(express.json());
- *
- * app.post('/api/ai', async (req, res) => {
- *   const { messages, system, params } = parseBody(req.body);
- *   const instance = llm({ model: anthropic('claude-sonnet-4-20250514'), system });
- *
- *   if (req.headers.accept?.includes('text/event-stream')) {
- *     expressAdapter.streamSSE(instance.stream(messages), res);
- *   } else {
- *     const turn = await instance.generate(messages);
- *     expressAdapter.sendJSON(turn, res);
- *   }
- * });
- * ```
- *
- * @example API Gateway with authentication
- * ```typescript
- * import express from 'express';
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { ExponentialBackoff, RoundRobinKeys } from '@providerprotocol/ai/http';
- * import { parseBody } from '@providerprotocol/ai/proxy';
- * import { express as expressAdapter } from '@providerprotocol/ai/proxy/server';
- *
- * const app = express();
- * app.use(express.json());
- *
- * // Your platform's auth middleware
- * async function authMiddleware(req, res, next) {
- *   const token = req.headers.authorization?.replace('Bearer ', '');
- *   const user = await validatePlatformToken(token);
- *   if (!user) return res.status(401).json({ error: 'Unauthorized' });
- *   req.user = user;
- *   next();
- * }
- *
- * // Server manages AI provider keys - users never see them
- * const claude = llm({
- *   model: anthropic('claude-sonnet-4-20250514'),
- *   config: {
- *     apiKey: new RoundRobinKeys([process.env.ANTHROPIC_KEY_1!, process.env.ANTHROPIC_KEY_2!]),
- *     retryStrategy: new ExponentialBackoff({ maxAttempts: 3 }),
- *   },
- * });
- *
- * app.post('/api/ai', authMiddleware, async (req, res) => {
- *   // Track usage per user
- *   // await trackUsage(req.user.id);
- *
- *   const { messages, system, params } = parseBody(req.body);
- *
- *   if (params?.stream) {
- *     expressAdapter.streamSSE(claude.stream(messages, { system }), res);
- *   } else {
- *     const turn = await claude.generate(messages, { system });
- *     expressAdapter.sendJSON(turn, res);
- *   }
- * });
- * ```
- */
-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.
- *
- * Provides utilities for using PP proxy with Web API native frameworks
- * (Bun, Deno, Next.js App Router, Cloudflare Workers).
- *
- * These utilities return standard Web API Response objects that work
- * directly with modern runtimes.
- *
- * @module providers/proxy/server/webapi
- */
-
-/**
- * Parsed request body from a proxy HTTP request.
- * This is just the deserialized PP data from the request body.
- */
-interface ParsedRequest {
-    messages: Message[];
-    system?: string | unknown[];
-    params?: Record<string, unknown>;
-    model?: string;
-    tools?: Array<{
-        name: string;
-        description: string;
-        parameters: JSONSchema;
-        metadata?: ToolMetadata;
-    }>;
-    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.
- *
- * @param body - The JSON-parsed request body
- * @returns Deserialized PP data
- *
- * @example
- * ```typescript
- * const body = await req.json();
- * const { messages, system, params } = parseBody(body);
- *
- * const instance = llm({ model: anthropic('...'), system, params });
- * const turn = await instance.generate(messages);
- * ```
- */
-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.
- *
- * @param turn - The completed inference turn
- * @returns HTTP Response with JSON body
- *
- * @example
- * ```typescript
- * const turn = await instance.generate(messages);
- * return toJSON(turn);
- * ```
- */
-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.
- *
- * Streams PP StreamEvents as SSE, then sends the final Turn data.
- *
- * @param stream - The StreamResult from instance.stream()
- * @returns HTTP Response with SSE body
- *
- * @example
- * ```typescript
- * const stream = instance.stream(messages);
- * return toSSE(stream);
- * ```
- */
-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.
- *
- * @param message - Error message
- * @param status - HTTP status code (default: 500)
- * @returns HTTP Response with error body
- */
-declare function toError(message: string, status?: number): Response;
-/**
- * Bind tool schemas to implementation functions.
- *
- * Takes tool schemas from the request and binds them to your
- * server-side implementations.
- *
- * @param schemas - Tool schemas from the request
- * @param implementations - Map of tool name to implementation
- * @returns Array of complete Tool objects
- *
- * @example
- * ```typescript
- * const { tools: schemas } = parseBody(body);
- *
- * const tools = bindTools(schemas, {
- *   get_weather: async ({ location }) => fetchWeather(location),
- *   search: async ({ query }) => searchDB(query),
- * });
- *
- * const instance = llm({ model, tools });
- * ```
- */
-declare function bindTools(schemas: ParsedRequest['tools'], implementations: Record<string, (params: unknown) => unknown | Promise<unknown>>): Tool[];
-/**
- * Web API adapter utilities.
- *
- * For use with Bun, Deno, Next.js App Router, Cloudflare Workers,
- * and other frameworks that support Web API Response.
- *
- * **Security Note:** The proxy works without configuration, meaning no
- * authentication by default. Always add your own auth layer in production.
- *
- * @example Basic usage
- * ```typescript
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { parseBody, toJSON, toSSE } from '@providerprotocol/ai/proxy';
- *
- * // Bun.serve / Deno.serve / Next.js App Router
- * export async function POST(req: Request) {
- *   const { messages, system } = parseBody(await req.json());
- *   const instance = llm({ model: anthropic('claude-sonnet-4-20250514'), system });
- *
- *   if (req.headers.get('accept')?.includes('text/event-stream')) {
- *     return toSSE(instance.stream(messages));
- *   }
- *   return toJSON(await instance.generate(messages));
- * }
- * ```
- *
- * @example API Gateway with authentication
- * ```typescript
- * import { llm } from '@providerprotocol/ai';
- * import { anthropic } from '@providerprotocol/ai/anthropic';
- * import { ExponentialBackoff, RoundRobinKeys } from '@providerprotocol/ai/http';
- * import { parseBody, toJSON, toSSE, toError } from '@providerprotocol/ai/proxy';
- *
- * // Your platform's user validation
- * async function validateToken(token: string): Promise<{ id: string } | null> {
- *   // Verify JWT, check database, etc.
- *   return token ? { id: 'user-123' } : null;
- * }
- *
- * // Server manages AI provider keys - users never see them
- * const claude = llm({
- *   model: anthropic('claude-sonnet-4-20250514'),
- *   config: {
- *     apiKey: new RoundRobinKeys([process.env.ANTHROPIC_KEY_1!, process.env.ANTHROPIC_KEY_2!]),
- *     retryStrategy: new ExponentialBackoff({ maxAttempts: 3 }),
- *   },
- * });
- *
- * Bun.serve({
- *   port: 3000,
- *   async fetch(req) {
- *     // Authenticate with YOUR platform credentials
- *     const token = req.headers.get('Authorization')?.replace('Bearer ', '');
- *     const user = await validateToken(token ?? '');
- *     if (!user) return toError('Unauthorized', 401);
- *
- *     // Rate limit, track usage, bill user, etc.
- *     // await trackUsage(user.id);
- *
- *     const { messages, system, params } = parseBody(await req.json());
- *
- *     if (params?.stream) {
- *       return toSSE(claude.stream(messages, { system }));
- *     }
- *     return toJSON(await claude.generate(messages, { system }));
- *   },
- * });
- * ```
- */
-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;
-};
-
-/**
- * @fileoverview Shared types for proxy server adapters.
- *
- * @module providers/proxy/server/types
- */
-
-/**
- * Parsed request body from a proxy HTTP request.
- */
-interface ParsedBody {
-    messages: Message[];
-    system?: string | unknown[];
-    params?: Record<string, unknown>;
-    model?: string;
-    tools?: Array<{
-        name: string;
-        description: string;
-        parameters: JSONSchema;
-        metadata?: ToolMetadata;
-    }>;
-    structure?: JSONSchema;
-}
-/**
- * Handler function signature for proxy endpoints.
- * Takes parsed request data and returns either a Turn or StreamResult.
- */
-type ProxyHandler = (body: ParsedBody, meta: RequestMeta) => Promise<Turn> | StreamResult | Promise<StreamResult>;
-/**
- * Metadata about the incoming request.
- */
-interface RequestMeta {
-    /** Whether the client wants a streaming response */
-    wantsStream: boolean;
-    /** Raw headers from the request */
-    headers: Record<string, string | undefined>;
-}
-/**
- * Options for adapter middleware.
- */
-interface AdapterOptions {
-    /** Custom error handler */
-    onError?: (error: Error) => {
-        message: string;
-        status: number;
-    };
-}
-
-/**
- * Server adapters namespace.
- *
- * Contains framework-specific adapters for Web API, Express, Fastify, and H3.
- *
- * @example Express
- * ```typescript
- * import { express } from '@providerprotocol/ai/proxy/server';
- *
- * app.post('/api/ai', async (req, res) => {
- *   const { messages } = parseBody(req.body);
- *   if (req.headers.accept?.includes('text/event-stream')) {
- *     express.streamSSE(instance.stream(messages), res);
- *   } else {
- *     express.sendJSON(await instance.generate(messages), res);
- *   }
- * });
- * ```
- *
- * @example Fastify
- * ```typescript
- * import { fastify } from '@providerprotocol/ai/proxy/server';
- *
- * app.post('/api/ai', async (request, reply) => {
- *   const { messages } = parseBody(request.body);
- *   if (request.headers.accept?.includes('text/event-stream')) {
- *     return fastify.streamSSE(instance.stream(messages), reply);
- *   }
- *   return fastify.sendJSON(await instance.generate(messages), reply);
- * });
- * ```
- *
- * @example H3/Nuxt
- * ```typescript
- * import { h3 } from '@providerprotocol/ai/proxy/server';
- *
- * export default defineEventHandler(async (event) => {
- *   const { messages } = parseBody(await readBody(event));
- *   if (getHeader(event, 'accept')?.includes('text/event-stream')) {
- *     return h3.streamSSE(instance.stream(messages), event);
- *   }
- *   return h3.sendJSON(await instance.generate(messages), event);
- * });
- * ```
- */
-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;
-    };
-};
-
 /**
  * Creates a proxy provider that transports PP requests over HTTP to a backend server.
  *
@@ -1048,4 +144,4 @@ declare function proxy(options: ProxyProviderOptions): Provider<ProxyRequestOpti
  */
 declare function proxyModel(endpoint: string): ModelReference<ProxyRequestOptions>;
 
-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 };
+export { type ProxyEmbeddingParams, type ProxyImageParams, type ProxyLLMParams, type ProxyProviderOptions, type ProxyRequestOptions, TurnJSON, deserializeMessage, deserializeStreamEvent, proxy, proxyModel, serializeMessage, serializeStreamEvent, serializeTurn };