@providerprotocol/ai 0.0.35 → 0.0.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@providerprotocol/ai",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "description": "UPP: Unified Provider Protocol for AI inference",
   "license": "MIT",
   "homepage": "https://providerprotocol.org",
@@ -82,6 +82,11 @@
       "import": "./dist/middleware/parsed-object/index.js",
       "default": "./dist/middleware/parsed-object/index.js"
     },
+    "./middleware/persistence": {
+      "types": "./dist/middleware/persistence/index.d.ts",
+      "import": "./dist/middleware/persistence/index.js",
+      "default": "./dist/middleware/persistence/index.js"
+    },
     "./middleware/pubsub": {
       "types": "./dist/middleware/pubsub/index.d.ts",
       "import": "./dist/middleware/pubsub/index.js",

package/dist/chunk-3GWM5GR3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware/pubsub/server/shared.ts"],"sourcesContent":["/**\n * @fileoverview Shared utilities for pub-sub server adapters.\n *\n * @module middleware/pubsub/server/shared\n * @internal\n */\n\nimport type { StreamEvent } from '../../../types/stream.ts';\nimport type { PubSubAdapter } from '../types.ts';\nimport { serializeStreamEvent } from '../../../stream/serialization.ts';\n\n/**\n * Writer interface for abstracting how data is written to responses.\n * @internal\n */\nexport interface StreamWriter {\n  write(data: string): void;\n  end(): void;\n}\n\n/**\n * Options for runSubscriberStream.\n * @internal\n */\nexport interface StreamOptions {\n  signal?: AbortSignal;\n  /** Max time to wait for stream creation (ms). @default 5000 */\n  creationTimeout?: number;\n}\n\nconst DEFAULT_CREATION_TIMEOUT = 5000;\nconst CREATION_POLL_INTERVAL = 50;\n\n/**\n * Formats a stream event as an SSE data line.\n */\nexport function formatSSE(event: StreamEvent): string {\n  const serialized = serializeStreamEvent(event);\n  return `data: ${JSON.stringify(serialized)}\\n\\n`;\n}\n\n/**\n * Waits for a stream to be created, with timeout.\n * Returns true if stream exists, false if timed out.\n */\nasync function waitForStream(\n  streamId: string,\n  adapter: PubSubAdapter,\n  timeout: number,\n  signal?: AbortSignal\n): Promise<boolean> {\n  const deadline = Date.now() + timeout;\n\n  while (Date.now() < deadline) {\n    if (signal?.aborted) return false;\n\n    const exists = await adapter.exists(streamId);\n    if (exists) return true;\n\n    await new Promise((resolve) => setTimeout(resolve, CREATION_POLL_INTERVAL));\n  }\n\n  return false;\n}\n\n/**\n * Core subscriber stream logic shared across all adapters.\n *\n * Handles:\n * 1. Waiting for stream creation (with timeout)\n * 2. Subscribing to live events FIRST (to prevent event loss)\n * 3. Replaying buffered events\n * 4. Checking if already completed\n * 5. Processing live events until completion\n * 6. Final cleanup\n * 7. Client disconnect via AbortSignal\n *\n * @internal\n */\nexport async function runSubscriberStream(\n  streamId: string,\n  adapter: PubSubAdapter,\n  writer: StreamWriter,\n  options: StreamOptions = {}\n): Promise<void> {\n  const { signal, creationTimeout = DEFAULT_CREATION_TIMEOUT } = options;\n\n  // Early exit if already aborted\n  if (signal?.aborted) {\n    writer.end();\n    return;\n  }\n\n  try {\n    // 1. Wait for stream to be created (handles race with background generation)\n    const streamExists = await waitForStream(streamId, adapter, creationTimeout, signal);\n\n    if (signal?.aborted) {\n      writer.end();\n      return;\n    }\n\n    if (!streamExists) {\n      writer.write(`data: ${JSON.stringify({ error: 'Stream not found' })}\\n\\n`);\n      writer.end();\n      return;\n    }\n\n    // 2. Subscribe FIRST to prevent event loss during replay\n    // Any events emitted while we replay will queue up\n    const queue: Array<{ event: StreamEvent; cursor: number | null }> = [];\n    let resolveWait: (() => void) | null = null;\n    let done = false;\n    let lastSentCursor = -1;\n\n    const unsubscribe = adapter.subscribe(streamId, (event: StreamEvent, cursor?: number) => {\n      queue.push({ event, cursor: cursor ?? null });\n      resolveWait?.();\n    });\n\n    // Handle client disconnect\n    const onAbort = (): void => {\n      done = true;\n      resolveWait?.();\n    };\n    signal?.addEventListener('abort', onAbort);\n\n    const drainQueue = (): void => {\n      while (queue.length > 0 && !signal?.aborted) {\n        const item = queue.shift();\n        if (!item) {\n          break;\n        }\n        const { event, cursor } = item;\n        if (cursor !== null && cursor <= lastSentCursor) {\n          continue;\n        }\n        writer.write(formatSSE(event));\n        if (cursor !== null && cursor > lastSentCursor) {\n          lastSentCursor = cursor;\n        }\n      }\n    };\n\n    const dropReplayDuplicates = (): void => {\n      if (queue.length === 0) {\n        return;\n      }\n      const filtered: Array<{ event: StreamEvent; cursor: number | null }> = [];\n      for (const item of queue) {\n        if (item.cursor !== null && item.cursor <= lastSentCursor) {\n          continue;\n        }\n        filtered.push(item);\n      }\n      queue.length = 0;\n      queue.push(...filtered);\n    };\n\n    const waitForNewEvents = (): Promise<void> => new Promise<void>((resolve) => {\n      resolveWait = resolve;\n      setTimeout(resolve, 500);\n    });\n\n    try {\n      // 3. Replay buffered events (subscription is already active)\n      const events = await adapter.getEvents(streamId);\n\n      if (!events) {\n        writer.write(`data: ${JSON.stringify({ error: 'Stream not found' })}\\n\\n`);\n        writer.end();\n        return;\n      }\n\n      for (const event of events) {\n        if (signal?.aborted) break;\n        writer.write(formatSSE(event));\n      }\n\n      lastSentCursor = events.length - 1;\n\n      // Drop queued events that are already included in the replay (cursor-aware)\n      dropReplayDuplicates();\n\n      // Check abort after replay\n      if (signal?.aborted) {\n        writer.end();\n        return;\n      }\n\n      // 4. Check if already completed\n      const completed = await adapter.isCompleted(streamId).catch(() => false);\n      if (completed) {\n        // Drain any queued events first (these are post-replay events)\n        drainQueue();\n        writer.write('data: [DONE]\\n\\n');\n        writer.end();\n        return;\n      }\n\n      // 5. Process live events until completion\n      while (!done) {\n        // Check abort\n        if (signal?.aborted) break;\n\n        // Drain queue (all events here are post-replay, no duplicates)\n        drainQueue();\n\n        // Check abort again\n        if (signal?.aborted) break;\n\n        // Check completion\n        const isComplete = await adapter.isCompleted(streamId).catch(() => false);\n        if (isComplete) {\n          done = true;\n          break;\n        }\n\n        // Wait for new events\n        await waitForNewEvents();\n        resolveWait = null;\n      }\n\n      // Final drain (only if not aborted)\n      if (!signal?.aborted) {\n        drainQueue();\n      }\n    } finally {\n      signal?.removeEventListener('abort', onAbort);\n      unsubscribe();\n    }\n\n    // Only send DONE if not aborted\n    if (!signal?.aborted) {\n      writer.write('data: [DONE]\\n\\n');\n    }\n    writer.end();\n  } catch (error) {\n    // Don't send error if client disconnected\n    if (!signal?.aborted) {\n      const errorMsg = error instanceof Error ? error.message : String(error);\n      writer.write(`data: ${JSON.stringify({ error: errorMsg })}\\n\\n`);\n    }\n    writer.end();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-6S222DHN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/stream.ts"],"sourcesContent":["/**\n * @fileoverview Streaming types for real-time LLM responses.\n *\n * Defines the event types and interfaces for streaming LLM inference,\n * including text deltas, tool call deltas, and control events.\n *\n * @module types/stream\n */\n\nimport type { Turn } from './turn.ts';\n\n/**\n * Stream event type constants.\n *\n * Use these constants instead of raw strings for type-safe event handling:\n *\n * @example\n * ```typescript\n * import { StreamEventType } from 'upp';\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 const StreamEventType = {\n  /** Incremental text output */\n  TextDelta: 'text_delta',\n  /** Incremental reasoning/thinking output */\n  ReasoningDelta: 'reasoning_delta',\n  /** Incremental image data */\n  ImageDelta: 'image_delta',\n  /** Incremental audio data */\n  AudioDelta: 'audio_delta',\n  /** Incremental video data */\n  VideoDelta: 'video_delta',\n  /** Incremental tool call data (arguments being streamed) */\n  ToolCallDelta: 'tool_call_delta',\n  /** Incremental structured object data (for structured output responses) */\n  ObjectDelta: 'object_delta',\n  /** Tool execution has started (may be emitted after completion in some implementations) */\n  ToolExecutionStart: 'tool_execution_start',\n  /** Tool execution has completed */\n  ToolExecutionEnd: 'tool_execution_end',\n  /** Beginning of a message */\n  MessageStart: 'message_start',\n  /** End of a message */\n  MessageStop: 'message_stop',\n  /** Beginning of a content block */\n  ContentBlockStart: 'content_block_start',\n  /** End of a content block */\n  ContentBlockStop: 'content_block_stop',\n} as const;\n\n/**\n * Stream event type discriminator union.\n *\n * This type is derived from {@link StreamEventType} constants. Use `StreamEventType.TextDelta`\n * for constants or `type MyType = StreamEventType` for type annotations.\n */\nexport type StreamEventType = (typeof StreamEventType)[keyof typeof StreamEventType];\n\n/**\n * Event delta data payload.\n *\n * Contains the type-specific data for a streaming event.\n * Different fields are populated depending on the event type:\n *\n * | Event Type | Fields |\n * |------------|--------|\n * | `text_delta` | `text` |\n * | `reasoning_delta` | `text` |\n * | `object_delta` | `text` |\n * | `image_delta` | `data` |\n * | `audio_delta` | `data` |\n * | `video_delta` | `data` |\n * | `tool_call_delta` | `toolCallId`, `toolName`, `argumentsJson` |\n * | `tool_execution_start` | `toolCallId`, `toolName`, `timestamp` |\n * | `tool_execution_end` | `toolCallId`, `toolName`, `result`, `isError`, `timestamp` |\n * | `message_start` | (none) |\n * | `message_stop` | (none) |\n * | `content_block_start` | (none) |\n * | `content_block_stop` | (none) |\n */\nexport interface EventDelta {\n  /** Incremental text content (text_delta, reasoning_delta, object_delta) */\n  text?: string;\n\n  /** Incremental binary data (image_delta, audio_delta, video_delta) */\n  data?: Uint8Array;\n\n  /** Tool call identifier (tool_call_delta, tool_execution_start/end) */\n  toolCallId?: string;\n\n  /** Tool name (tool_call_delta, tool_execution_start/end) */\n  toolName?: string;\n\n  /** Incremental JSON arguments string (tool_call_delta) */\n  argumentsJson?: string;\n\n  /** Tool execution result (tool_execution_end) */\n  result?: unknown;\n\n  /** Whether tool execution resulted in an error (tool_execution_end) */\n  isError?: boolean;\n\n  /** Timestamp in milliseconds (tool_execution_start/end) */\n  timestamp?: number;\n}\n\n/**\n * A single streaming event from the LLM.\n *\n * Events are emitted in order as the model generates output,\n * allowing for real-time display of responses.\n *\n * @example\n * ```typescript\n * import { StreamEventType } from 'upp';\n *\n * for await (const event of stream) {\n *   if (event.type === StreamEventType.TextDelta) {\n *     process.stdout.write(event.delta.text ?? '');\n *   } else if (event.type === StreamEventType.ToolCallDelta) {\n *     console.log('Tool:', event.delta.toolName);\n *   }\n * }\n * ```\n */\nexport interface StreamEvent {\n  /** Event type discriminator */\n  type: StreamEventType;\n\n  /** Index of the content block this event belongs to */\n  index: number;\n\n  /** Event-specific data payload */\n  delta: EventDelta;\n}\n\n/**\n * Stream result - an async iterable that also provides the final turn.\n *\n * Allows consuming streaming events while also awaiting the complete\n * Turn result after streaming finishes.\n *\n * @typeParam TData - Type of the structured output data\n *\n * @example\n * ```typescript\n * import { StreamEventType } from 'upp';\n *\n * const stream = instance.stream('Tell me a story');\n *\n * // Consume streaming events\n * for await (const event of stream) {\n *   if (event.type === StreamEventType.TextDelta) {\n *     process.stdout.write(event.delta.text ?? '');\n *   }\n * }\n *\n * // Get the complete turn after streaming\n * const turn = await stream.turn;\n * console.log('\\n\\nTokens used:', turn.usage.totalTokens);\n * ```\n */\nexport interface StreamResult<TData = unknown>\n  extends AsyncIterable<StreamEvent> {\n  /**\n   * Promise that resolves to the complete Turn after streaming finishes.\n   * Rejects if the stream is aborted or terminated early.\n   */\n  readonly turn: Promise<Turn<TData>>;\n\n  /**\n   * Aborts the stream, stopping further events and cancelling the request.\n   * This will cause {@link StreamResult.turn} to reject.\n   */\n  abort(): void;\n}\n\n/**\n * Creates a StreamResult from an async generator and completion promise.\n *\n * @typeParam TData - Type of the structured output data\n * @param generator - Async generator that yields stream events\n * @param turnPromiseOrFactory - Promise or factory that resolves to the complete Turn\n * @param abortController - Controller for aborting the stream\n * @returns A StreamResult that can be iterated and awaited\n *\n * @example\n * ```typescript\n * const abortController = new AbortController();\n * const stream = createStreamResult(\n *   eventGenerator(),\n *   turnPromise,\n *   abortController\n * );\n * ```\n */\nexport function createStreamResult<TData = unknown>(\n  generator: AsyncGenerator<StreamEvent, void, unknown>,\n  turnPromiseOrFactory: Promise<Turn<TData>> | (() => Promise<Turn<TData>>),\n  abortController: AbortController\n): StreamResult<TData> {\n  let cachedTurn: Promise<Turn<TData>> | null = null;\n\n  const getTurn = (): Promise<Turn<TData>> => {\n    // Lazily build the turn promise to avoid work (or rejections) when unused.\n    if (typeof turnPromiseOrFactory === 'function') {\n      if (!cachedTurn) {\n        cachedTurn = turnPromiseOrFactory();\n      }\n      return cachedTurn;\n    }\n\n    return turnPromiseOrFactory;\n  };\n\n  return {\n    [Symbol.asyncIterator]() {\n      return generator;\n    },\n    get turn() {\n      return getTurn();\n    },\n    abort() {\n      abortController.abort();\n    },\n  };\n}\n\n/**\n * Creates a text delta stream event.\n *\n * @param text - The incremental text content\n * @param index - Content block index (default: 0)\n * @returns A text_delta StreamEvent\n */\nexport function textDelta(text: string, index = 0): StreamEvent {\n  return {\n    type: StreamEventType.TextDelta,\n    index,\n    delta: { text },\n  };\n}\n\n/**\n * Creates a tool call delta stream event.\n *\n * @param toolCallId - Unique identifier for the tool call\n * @param toolName - Name of the tool being called\n * @param argumentsJson - Incremental JSON arguments string\n * @param index - Content block index (default: 0)\n * @returns A tool_call_delta StreamEvent\n */\nexport function toolCallDelta(\n  toolCallId: string,\n  toolName: string,\n  argumentsJson: string,\n  index = 0\n): StreamEvent {\n  return {\n    type: StreamEventType.ToolCallDelta,\n    index,\n    delta: { toolCallId, toolName, argumentsJson },\n  };\n}\n\n/**\n * Creates an object delta stream event for structured output responses.\n *\n * @param text - The incremental text content\n * @param index - Content block index (default: 0)\n * @returns An object_delta StreamEvent\n */\nexport function objectDelta(text: string, index = 0): StreamEvent {\n  return {\n    type: StreamEventType.ObjectDelta,\n    index,\n    delta: { text },\n  };\n}\n\n/**\n * Creates a message start stream event.\n *\n * @returns A message_start StreamEvent\n */\nexport function messageStart(): StreamEvent {\n  return {\n    type: StreamEventType.MessageStart,\n    index: 0,\n    delta: {},\n  };\n}\n\n/**\n * Creates a message stop stream event.\n *\n * @returns A message_stop StreamEvent\n */\nexport function messageStop(): StreamEvent {\n  return {\n    type: StreamEventType.MessageStop,\n    index: 0,\n    delta: {},\n  };\n}\n\n/**\n * Creates a content block start stream event.\n *\n * @param index - The content block index starting\n * @returns A content_block_start StreamEvent\n */\nexport function contentBlockStart(index: number): StreamEvent {\n  return {\n    type: StreamEventType.ContentBlockStart,\n    index,\n    delta: {},\n  };\n}\n\n/**\n * Creates a content block stop stream event.\n *\n * @param index - The content block index stopping\n * @returns A content_block_stop StreamEvent\n */\nexport function contentBlockStop(index: number): StreamEvent {\n  return {\n    type: StreamEventType.ContentBlockStop,\n    index,\n    delta: {},\n  };\n}\n\n/**\n * Creates a tool execution start stream event.\n *\n * @param toolCallId - Unique identifier for the tool call\n * @param toolName - Name of the tool being executed\n * @param timestamp - Start timestamp in milliseconds\n * @param index - Content block index (default: 0)\n * @returns A tool_execution_start StreamEvent\n */\nexport function toolExecutionStart(\n  toolCallId: string,\n  toolName: string,\n  timestamp: number,\n  index = 0\n): StreamEvent {\n  return {\n    type: StreamEventType.ToolExecutionStart,\n    index,\n    delta: { toolCallId, toolName, timestamp },\n  };\n}\n\n/**\n * Creates a tool execution end stream event.\n *\n * @param toolCallId - Unique identifier for the tool call\n * @param toolName - Name of the tool that was executed\n * @param result - The result from the tool execution\n * @param isError - Whether the execution resulted in an error\n * @param timestamp - End timestamp in milliseconds\n * @param index - Content block index (default: 0)\n * @returns A tool_execution_end StreamEvent\n */\nexport function toolExecutionEnd(\n  toolCallId: string,\n  toolName: string,\n  result: unknown,\n  isError: boolean,\n  timestamp: number,\n  index = 0\n): StreamEvent {\n  return {\n    type: StreamEventType.ToolExecutionEnd,\n    index,\n    delta: { toolCallId, toolName, result, isError, timestamp },\n  };\n}\n"],"mappings":";AA2BO,IAAM,kBAAkB;AAAA;AAAA,EAE7B,WAAW;AAAA;AAAA,EAEX,gBAAgB;AAAA;AAAA,EAEhB,YAAY;AAAA;AAAA,EAEZ,YAAY;AAAA;AAAA,EAEZ,YAAY;AAAA;AAAA,EAEZ,eAAe;AAAA;AAAA,EAEf,aAAa;AAAA;AAAA,EAEb,oBAAoB;AAAA;AAAA,EAEpB,kBAAkB;AAAA;AAAA,EAElB,cAAc;AAAA;AAAA,EAEd,aAAa;AAAA;AAAA,EAEb,mBAAmB;AAAA;AAAA,EAEnB,kBAAkB;AACpB;AAoJO,SAAS,mBACd,WACA,sBACA,iBACqB;AACrB,MAAI,aAA0C;AAE9C,QAAM,UAAU,MAA4B;AAE1C,QAAI,OAAO,yBAAyB,YAAY;AAC9C,UAAI,CAAC,YAAY;AACf,qBAAa,qBAAqB;AAAA,MACpC;AACA,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,CAAC,OAAO,aAAa,IAAI;AACvB,aAAO;AAAA,IACT;AAAA,IACA,IAAI,OAAO;AACT,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,QAAQ;AACN,sBAAgB,MAAM;AAAA,IACxB;AAAA,EACF;AACF;AASO,SAAS,UAAU,MAAc,QAAQ,GAAgB;AAC9D,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB;AAAA,IACA,OAAO,EAAE,KAAK;AAAA,EAChB;AACF;AAWO,SAAS,cACd,YACA,UACA,eACA,QAAQ,GACK;AACb,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB;AAAA,IACA,OAAO,EAAE,YAAY,UAAU,cAAc;AAAA,EAC/C;AACF;AASO,SAAS,YAAY,MAAc,QAAQ,GAAgB;AAChE,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB;AAAA,IACA,OAAO,EAAE,KAAK;AAAA,EAChB;AACF;AAOO,SAAS,eAA4B;AAC1C,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB,OAAO;AAAA,IACP,OAAO,CAAC;AAAA,EACV;AACF;AAOO,SAAS,cAA2B;AACzC,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB,OAAO;AAAA,IACP,OAAO,CAAC;AAAA,EACV;AACF;AAQO,SAAS,kBAAkB,OAA4B;AAC5D,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB;AAAA,IACA,OAAO,CAAC;AAAA,EACV;AACF;AAQO,SAAS,iBAAiB,OAA4B;AAC3D,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB;AAAA,IACA,OAAO,CAAC;AAAA,EACV;AACF;AAWO,SAAS,mBACd,YACA,UACA,WACA,QAAQ,GACK;AACb,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB;AAAA,IACA,OAAO,EAAE,YAAY,UAAU,UAAU;AAAA,EAC3C;AACF;AAaO,SAAS,iBACd,YACA,UACA,QACA,SACA,WACA,QAAQ,GACK;AACb,SAAO;AAAA,IACL,MAAM,gBAAgB;AAAA,IACtB;AAAA,IACA,OAAO,EAAE,YAAY,UAAU,QAAQ,SAAS,UAAU;AAAA,EAC5D;AACF;","names":[]}

package/dist/chunk-7DXVRILR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware/pubsub/server/webapi.ts"],"sourcesContent":["/**\n * @fileoverview Web API adapter for pub-sub stream resumption.\n *\n * Provides utilities for Web API native frameworks (Bun, Deno, Next.js App Router,\n * Cloudflare Workers) to handle stream reconnections.\n *\n * @module middleware/pubsub/server/webapi\n */\n\nimport type { PubSubAdapter } from '../types.ts';\nimport { runSubscriberStream } from './shared.ts';\n\n/**\n * Creates a ReadableStream that replays buffered events and subscribes to live events.\n *\n * This utility handles the reconnection pattern for server routes:\n * 1. Replays all buffered events from the adapter\n * 2. If stream is already completed, closes immediately\n * 3. Otherwise, subscribes to live events until completion\n *\n * Works with any framework that supports web standard ReadableStream.\n *\n * @param streamId - The stream ID to subscribe to\n * @param adapter - The pub-sub adapter instance\n * @returns A ReadableStream of SSE-formatted data\n *\n * @example\n * ```typescript\n * import { createSubscriberStream } from '@providerprotocol/ai/middleware/pubsub/server/webapi';\n *\n * // Next.js App Router\n * export async function POST(req: Request) {\n *   const { streamId } = await req.json();\n *\n *   return new Response(createSubscriberStream(streamId, adapter), {\n *     headers: {\n *       'Content-Type': 'text/event-stream',\n *       'Cache-Control': 'no-cache',\n *       'Connection': 'keep-alive',\n *     },\n *   });\n * }\n * ```\n */\nexport function createSubscriberStream(\n  streamId: string,\n  adapter: PubSubAdapter\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder();\n  const abortController = new AbortController();\n  let closed = false;\n\n  return new ReadableStream({\n    async start(controller) {\n      await runSubscriberStream(\n        streamId,\n        adapter,\n        {\n          write: (data: string) => {\n            if (closed) {\n              return;\n            }\n            controller.enqueue(encoder.encode(data));\n          },\n          end: () => {\n            if (closed) {\n              return;\n            }\n            closed = true;\n            try {\n              controller.close();\n            } catch {\n              // Ignore close errors after cancellation\n            }\n          },\n        },\n        { signal: abortController.signal }\n      );\n    },\n    cancel() {\n      abortController.abort();\n    },\n  });\n}\n\n/**\n * Web API adapter namespace for pub-sub server utilities.\n */\nexport const webapi = {\n  createSubscriberStream,\n};\n"],"mappings":";;;;;AA4CO,SAAS,uBACd,UACA,SAC4B;AAC5B,QAAM,UAAU,IAAI,YAAY;AAChC,QAAM,kBAAkB,IAAI,gBAAgB;AAC5C,MAAI,SAAS;AAEb,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,MAAM,YAAY;AACtB,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,UACE,OAAO,CAAC,SAAiB;AACvB,gBAAI,QAAQ;AACV;AAAA,YACF;AACA,uBAAW,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,UACzC;AAAA,UACA,KAAK,MAAM;AACT,gBAAI,QAAQ;AACV;AAAA,YACF;AACA,qBAAS;AACT,gBAAI;AACF,yBAAW,MAAM;AAAA,YACnB,QAAQ;AAAA,YAER;AAAA,UACF;AAAA,QACF;AAAA,QACA,EAAE,QAAQ,gBAAgB,OAAO;AAAA,MACnC;AAAA,IACF;AAAA,IACA,SAAS;AACP,sBAAgB,MAAM;AAAA,IACxB;AAAA,EACF,CAAC;AACH;AAKO,IAAM,SAAS;AAAA,EACpB;AACF;","names":[]}

package/dist/chunk-AY55T37A.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/error.ts","../src/http/errors.ts","../src/http/fetch.ts"],"sourcesContent":["/**\n * @fileoverview Error normalization utilities.\n *\n * @module utils/error\n */\n\nimport { ErrorCode, UPPError } from '../types/errors.ts';\n\n/**\n * Converts an unknown thrown value into an Error instance.\n *\n * @param value - Unknown error value\n * @returns An Error instance\n */\nexport function toError(value: unknown): Error {\n  if (value instanceof Error) {\n    return value;\n  }\n  if (typeof value === 'string') {\n    return new Error(value);\n  }\n  if (typeof value === 'object' && value !== null && 'message' in value) {\n    const message = (value as { message?: unknown }).message;\n    if (typeof message === 'string') {\n      return new Error(message);\n    }\n  }\n  return new Error(String(value));\n}\n\n/**\n * Checks whether an error represents a cancellation.\n *\n * @param value - Unknown error value\n * @returns True if the error indicates cancellation\n */\nexport function isCancelledError(value: unknown): boolean {\n  if (value instanceof UPPError) {\n    return value.code === ErrorCode.Cancelled;\n  }\n\n  if (value && typeof value === 'object' && 'name' in value) {\n    const name = (value as { name?: unknown }).name;\n    return name === 'AbortError';\n  }\n\n  return false;\n}\n","/**\n * HTTP error handling and normalization utilities.\n * @module http/errors\n */\n\nimport {\n  UPPError,\n  ErrorCode,\n  type Modality,\n} from '../types/errors.ts';\nimport { toError } from '../utils/error.ts';\n\n/**\n * Maps HTTP status codes to standardized UPP error codes.\n *\n * This function provides consistent error categorization across all providers:\n * - 400 -> INVALID_REQUEST (bad request format or parameters)\n * - 401, 403 -> AUTHENTICATION_FAILED (invalid or missing credentials)\n * - 404 -> MODEL_NOT_FOUND (requested model does not exist)\n * - 408 -> TIMEOUT (request timed out)\n * - 413 -> CONTEXT_LENGTH_EXCEEDED (input too long)\n * - 429 -> RATE_LIMITED (too many requests)\n * - 5xx -> PROVIDER_ERROR (server-side issues)\n *\n * @param status - HTTP status code from the response\n * @returns The corresponding UPP ErrorCode\n *\n * @example\n * ```typescript\n * const errorCode = statusToErrorCode(429);\n * // Returns 'RATE_LIMITED'\n *\n * const serverError = statusToErrorCode(503);\n * // Returns 'PROVIDER_ERROR'\n * ```\n */\nexport function statusToErrorCode(status: number): ErrorCode {\n  switch (status) {\n    case 400:\n      return ErrorCode.InvalidRequest;\n    case 402:\n      return ErrorCode.QuotaExceeded;\n    case 401:\n    case 403:\n      return ErrorCode.AuthenticationFailed;\n    case 404:\n      return ErrorCode.ModelNotFound;\n    case 408:\n      return ErrorCode.Timeout;\n    case 409:\n      return ErrorCode.InvalidRequest;\n    case 422:\n      return ErrorCode.InvalidRequest;\n    case 413:\n      return ErrorCode.ContextLengthExceeded;\n    case 451:\n      return ErrorCode.ContentFiltered;\n    case 429:\n      return ErrorCode.RateLimited;\n    case 500:\n    case 502:\n    case 503:\n    case 504:\n      return ErrorCode.ProviderError;\n    default:\n      return ErrorCode.ProviderError;\n  }\n}\n\n/**\n * Normalizes HTTP error responses into standardized UPPError objects.\n *\n * This function performs several operations:\n * 1. Maps the HTTP status code to an appropriate ErrorCode\n * 2. Attempts to extract a meaningful error message from the response body\n * 3. Handles various provider-specific error response formats\n *\n * Supported error message formats:\n * - `{ error: { message: \"...\" } }` (OpenAI, Anthropic)\n * - `{ message: \"...\" }` (simple format)\n * - `{ error: { error: { message: \"...\" } } }` (nested format)\n * - `{ detail: \"...\" }` (FastAPI style)\n * - Plain text body (if under 200 characters)\n *\n * @param response - The HTTP Response object with non-2xx status\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with normalized code and message\n *\n * @example\n * ```typescript\n * if (!response.ok) {\n *   const error = await normalizeHttpError(response, 'openai', 'llm');\n *   // error.code might be 'RATE_LIMITED' for 429\n *   // error.message contains provider's error message\n *   throw error;\n * }\n * ```\n */\nexport async function normalizeHttpError(\n  response: Response,\n  provider: string,\n  modality: Modality\n): Promise<UPPError> {\n  const code = statusToErrorCode(response.status);\n  let message = `HTTP ${response.status}: ${response.statusText}`;\n  let bodyReadError: Error | undefined;\n\n  try {\n    const body = await response.text();\n    if (body) {\n      try {\n        const json = JSON.parse(body);\n        const extractedMessage =\n          json.error?.message ||\n          json.message ||\n          json.error?.error?.message ||\n          json.detail;\n\n        if (extractedMessage) {\n          message = extractedMessage;\n        }\n      } catch {\n        if (body.length < 200) {\n          message = body;\n        }\n      }\n    }\n  } catch (error) {\n    bodyReadError = toError(error);\n  }\n\n  return new UPPError(message, code, provider, modality, response.status, bodyReadError);\n}\n\n/**\n * Creates a UPPError for network failures (DNS, connection, etc.).\n *\n * Use this when the request fails before receiving any HTTP response,\n * such as DNS resolution failures, connection refused, or network unreachable.\n *\n * @param error - The underlying Error that caused the failure\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with NETWORK_ERROR code and the original error attached\n */\nexport function networkError(\n  error: Error,\n  provider: string,\n  modality: Modality\n): UPPError {\n  return new UPPError(\n    `Network error: ${error.message}`,\n    ErrorCode.NetworkError,\n    provider,\n    modality,\n    undefined,\n    error\n  );\n}\n\n/**\n * Creates a UPPError for request timeout.\n *\n * Use this when the request exceeds the configured timeout duration\n * and is aborted by the AbortController.\n *\n * @param timeout - The timeout duration in milliseconds that was exceeded\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with TIMEOUT code\n */\nexport function timeoutError(\n  timeout: number,\n  provider: string,\n  modality: Modality\n): UPPError {\n  return new UPPError(\n    `Request timed out after ${timeout}ms`,\n    ErrorCode.Timeout,\n    provider,\n    modality\n  );\n}\n\n/**\n * Creates a UPPError for user-initiated request cancellation.\n *\n * Use this when the request is aborted via a user-provided AbortSignal,\n * distinct from timeout-based cancellation.\n *\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with CANCELLED code\n */\nexport function cancelledError(provider: string, modality: Modality): UPPError {\n  return new UPPError(\n    'Request was cancelled',\n    ErrorCode.Cancelled,\n    provider,\n    modality\n  );\n}\n","/**\n * HTTP fetch utilities with retry, timeout, and error normalization.\n * @module http/fetch\n */\n\nimport type { ProviderConfig, RetryStrategy } from '../types/provider.ts';\nimport type { Modality } from '../types/errors.ts';\nimport { UPPError } from '../types/errors.ts';\nimport {\n  normalizeHttpError,\n  networkError,\n  timeoutError,\n  cancelledError,\n} from './errors.ts';\nimport { toError } from '../utils/error.ts';\n\n/** Default request timeout in milliseconds (2 minutes). */\nconst DEFAULT_TIMEOUT = 120000;\nconst MAX_RETRY_AFTER_SECONDS = 3600;\n\n/**\n * Warns when a non-TLS URL is used with a provider.\n * Only warns in non-production, excludes localhost for local development.\n */\nexport function warnInsecureUrl(url: string, provider: string): void {\n  if (\n    process.env.NODE_ENV !== 'production' &&\n    url.startsWith('http://') &&\n    !url.includes('localhost') &&\n    !url.includes('127.0.0.1') &&\n    !url.includes('[::1]')\n  ) {\n    console.warn(\n      `[UPP] Provider \"${provider}\" using non-TLS URL: ${url}. ` +\n      'API keys may be exposed to network interception.'\n    );\n  }\n}\n\ntype ForkableRetryStrategy = RetryStrategy & {\n  fork: () => RetryStrategy | undefined;\n};\n\nfunction hasFork(strategy: RetryStrategy | undefined): strategy is ForkableRetryStrategy {\n  return !!strategy && typeof (strategy as { fork?: unknown }).fork === 'function';\n}\n\n/**\n * Delays execution for a specified duration.\n *\n * @param ms - Duration to sleep in milliseconds\n * @returns Promise that resolves after the specified delay\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Parses Retry-After header values into seconds.\n *\n * Supports both delta-seconds and HTTP-date formats.\n */\nfunction parseRetryAfter(headerValue: string | null, maxSeconds: number): number | null {\n  if (!headerValue) {\n    return null;\n  }\n\n  const seconds = parseInt(headerValue, 10);\n  if (!Number.isNaN(seconds)) {\n    return Math.min(maxSeconds, Math.max(0, seconds));\n  }\n\n  const dateMillis = Date.parse(headerValue);\n  if (Number.isNaN(dateMillis)) {\n    return null;\n  }\n\n  const deltaMs = dateMillis - Date.now();\n  if (deltaMs <= 0) {\n    return 0;\n  }\n\n  const deltaSeconds = Math.ceil(deltaMs / 1000);\n  return Math.min(maxSeconds, Math.max(0, deltaSeconds));\n}\n\n/**\n * Executes a fetch request with configurable timeout.\n *\n * Creates an AbortController to cancel the request if it exceeds the timeout.\n * Properly handles both user-provided abort signals and timeout-based cancellation,\n * throwing appropriate error types for each case.\n *\n * @param fetchFn - The fetch function to use (allows custom implementations)\n * @param url - The URL to fetch\n * @param init - Standard fetch RequestInit options\n * @param timeout - Maximum time in milliseconds before aborting\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns The Response from the fetch call\n *\n * @throws {UPPError} TIMEOUT - When the timeout is exceeded\n * @throws {UPPError} CANCELLED - When cancelled via user-provided signal\n * @throws {Error} Network errors are passed through unchanged\n */\nasync function fetchWithTimeout(\n  fetchFn: typeof fetch,\n  url: string,\n  init: RequestInit,\n  timeout: number,\n  provider: string,\n  modality: Modality\n): Promise<Response> {\n  const existingSignal = init.signal;\n\n  // Check if already aborted before starting\n  if (existingSignal?.aborted) {\n    throw cancelledError(provider, modality);\n  }\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const onAbort = () => controller.abort();\n  if (existingSignal) {\n    existingSignal.addEventListener('abort', onAbort, { once: true });\n  }\n\n  try {\n    const response = await fetchFn(url, {\n      ...init,\n      signal: controller.signal,\n    });\n    return response;\n  } catch (error) {\n    if (toError(error).name === 'AbortError') {\n      if (existingSignal?.aborted) {\n        throw cancelledError(provider, modality);\n      }\n      throw timeoutError(timeout, provider, modality);\n    }\n    throw error;\n  } finally {\n    clearTimeout(timeoutId);\n    if (existingSignal) {\n      existingSignal.removeEventListener('abort', onAbort);\n    }\n  }\n}\n\n/**\n * Executes an HTTP fetch request with automatic retry, timeout handling, and error normalization.\n *\n * This function wraps the standard fetch API with additional capabilities:\n * - Configurable timeout with automatic request cancellation (per attempt)\n * - Retry strategy support (exponential backoff, linear, token bucket, etc.)\n * - Pre-request delay support for rate limiting strategies\n * - Automatic Retry-After header parsing and handling\n * - Error normalization to UPPError format\n *\n * @param url - The URL to fetch\n * @param init - Standard fetch RequestInit options (method, headers, body, etc.)\n * @param config - Provider configuration containing fetch customization, timeout, and retry strategy\n * @param provider - Provider identifier for error context (e.g., 'openai', 'anthropic')\n * @param modality - Request modality for error context (e.g., 'llm', 'embedding', 'image')\n * @returns The successful Response object\n *\n * @throws {UPPError} RATE_LIMITED - When rate limited and retries exhausted\n * @throws {UPPError} NETWORK_ERROR - When a network failure occurs\n * @throws {UPPError} TIMEOUT - When the request times out\n * @throws {UPPError} CANCELLED - When the request is aborted via signal\n * @throws {UPPError} Various codes based on HTTP status (see statusToErrorCode)\n *\n * @example\n * ```typescript\n * const response = await doFetch(\n *   'https://api.openai.com/v1/chat/completions',\n *   {\n *     method: 'POST',\n *     headers: { 'Authorization': 'Bearer sk-...' },\n *     body: JSON.stringify({ model: 'gpt-4', messages: [] })\n *   },\n *   { timeout: 30000, retryStrategy: new ExponentialBackoff() },\n *   'openai',\n *   'llm'\n * );\n * ```\n */\nexport async function doFetch(\n  url: string,\n  init: RequestInit,\n  config: ProviderConfig,\n  provider: string,\n  modality: Modality\n): Promise<Response> {\n  const fetchFn = config.fetch ?? fetch;\n  const timeout = config.timeout ?? DEFAULT_TIMEOUT;\n  const baseStrategy = config.retryStrategy;\n  const strategy = hasFork(baseStrategy) ? baseStrategy.fork() : baseStrategy;\n\n  // Warn about potential security issue with non-TLS URLs\n  warnInsecureUrl(url, provider);\n\n  let attempt = 0;\n\n  while (true) {\n    attempt++;\n\n    if (strategy?.beforeRequest) {\n      const delay = await strategy.beforeRequest();\n      if (delay > 0) {\n        await sleep(delay);\n      }\n    }\n\n    let response: Response;\n    try {\n      response = await fetchWithTimeout(\n        fetchFn,\n        url,\n        init,\n        timeout,\n        provider,\n        modality\n      );\n    } catch (error) {\n      if (error instanceof UPPError) {\n        if (strategy) {\n          const delay = await strategy.onRetry(error, attempt);\n          if (delay !== null) {\n            await sleep(delay);\n            continue;\n          }\n        }\n        throw error;\n      }\n\n      const uppError = networkError(toError(error), provider, modality);\n\n      if (strategy) {\n        const delay = await strategy.onRetry(uppError, attempt);\n        if (delay !== null) {\n          await sleep(delay);\n          continue;\n        }\n      }\n\n      throw uppError;\n    }\n\n    if (!response.ok) {\n      const error = await normalizeHttpError(response, provider, modality);\n\n      const retryAfterSeconds = parseRetryAfter(\n        response.headers.get('Retry-After'),\n        config.retryAfterMaxSeconds ?? MAX_RETRY_AFTER_SECONDS\n      );\n      if (retryAfterSeconds !== null && strategy && 'setRetryAfter' in strategy) {\n        (strategy as { setRetryAfter: (s: number) => void }).setRetryAfter(\n          retryAfterSeconds\n        );\n      }\n\n      if (strategy) {\n        const delay = await strategy.onRetry(error, attempt);\n        if (delay !== null) {\n          await sleep(delay);\n          continue;\n        }\n      }\n\n      throw error;\n    }\n\n    strategy?.reset?.();\n\n    return response;\n  }\n}\n\n/**\n * Executes an HTTP fetch request for streaming responses.\n *\n * Unlike {@link doFetch}, this function returns the response immediately without\n * checking the HTTP status. This is necessary for Server-Sent Events (SSE) and\n * other streaming protocols where error information may be embedded in the stream.\n *\n * The caller is responsible for:\n * - Checking response.ok and handling HTTP errors\n * - Parsing the response stream (e.g., using parseSSEStream)\n * - Handling stream-specific error conditions\n *\n * Retries are not performed for streaming requests since partial data may have\n * already been consumed by the caller.\n *\n * @param url - The URL to fetch\n * @param init - Standard fetch RequestInit options\n * @param config - Provider configuration containing fetch customization and timeout\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns The Response object (may have non-2xx status)\n *\n * @throws {UPPError} NETWORK_ERROR - When a network failure occurs\n * @throws {UPPError} TIMEOUT - When the request times out\n * @throws {UPPError} CANCELLED - When the request is aborted via signal\n *\n * @example\n * ```typescript\n * const response = await doStreamFetch(\n *   'https://api.openai.com/v1/chat/completions',\n *   {\n *     method: 'POST',\n *     headers: { 'Authorization': 'Bearer sk-...' },\n *     body: JSON.stringify({ model: 'gpt-4', messages: [], stream: true })\n *   },\n *   { timeout: 120000 },\n *   'openai',\n *   'llm'\n * );\n *\n * if (!response.ok) {\n *   throw await normalizeHttpError(response, 'openai', 'llm');\n * }\n *\n * for await (const event of parseSSEStream(response.body!)) {\n *   console.log(event);\n * }\n * ```\n */\nexport async function doStreamFetch(\n  url: string,\n  init: RequestInit,\n  config: ProviderConfig,\n  provider: string,\n  modality: Modality\n): Promise<Response> {\n  const fetchFn = config.fetch ?? fetch;\n  const timeout = config.timeout ?? DEFAULT_TIMEOUT;\n  const baseStrategy = config.retryStrategy;\n  const strategy = hasFork(baseStrategy) ? baseStrategy.fork() : baseStrategy;\n\n  if (strategy?.beforeRequest) {\n    const delay = await strategy.beforeRequest();\n    if (delay > 0) {\n      await sleep(delay);\n    }\n  }\n\n  try {\n    const response = await fetchWithTimeout(\n      fetchFn,\n      url,\n      init,\n      timeout,\n      provider,\n      modality\n    );\n    return response;\n  } catch (error) {\n    if (error instanceof UPPError) {\n      throw error;\n    }\n    throw networkError(toError(error), provider, modality);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-BRP5XJ6Q.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/id.ts","../src/types/messages.ts"],"sourcesContent":["/**\n * @fileoverview ID generation utilities for the Universal Provider Protocol.\n *\n * Provides functions for generating unique identifiers used throughout UPP,\n * including message IDs, tool call IDs, and other internal references.\n *\n * @module utils/id\n */\n\n/**\n * Generates a unique UUID v4 identifier.\n *\n * Uses the native `crypto.randomUUID()` when available for cryptographically\n * secure randomness. Falls back to a Math.random-based implementation for\n * environments without Web Crypto API support.\n *\n * @returns A UUID v4 string in the format `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`\n *\n * @example\n * ```typescript\n * const messageId = generateId();\n * // => \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n * ```\n */\nexport function generateId(): string {\n  if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Generates a short alphanumeric identifier.\n *\n * Creates a 12-character random string using alphanumeric characters (a-z, A-Z, 0-9).\n * Useful for tool call IDs and other cases where a full UUID is not required.\n *\n * @param prefix - Optional prefix to prepend to the generated ID\n * @returns A string containing the prefix followed by 12 random alphanumeric characters\n *\n * @example\n * ```typescript\n * const toolCallId = generateShortId('call_');\n * // => \"call_aB3xY9mK2pQr\"\n *\n * const simpleId = generateShortId();\n * // => \"Tz4wN8vL1sHj\"\n * ```\n */\nexport function generateShortId(prefix = ''): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  let result = prefix;\n  for (let i = 0; i < 12; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n","/**\n * @fileoverview Message types for conversation history.\n *\n * Defines the message classes used to represent conversation turns\n * between users and assistants, including support for multimodal\n * content and tool calls.\n *\n * @module types/messages\n */\n\nimport { generateId } from '../utils/id.ts';\nimport type {\n  ContentBlock,\n  TextBlock,\n  ReasoningBlock,\n  ImageBlock,\n  DocumentBlock,\n  AudioBlock,\n  VideoBlock,\n  UserContent,\n  AssistantContent,\n} from './content.ts';\nimport type { ToolCall, ToolResult } from './tool.ts';\n\n/**\n * Message serialized to JSON format.\n * Picks common fields from Message, converts timestamp to string.\n */\nexport type MessageJSON = Pick<Message, 'id' | 'type' | 'metadata'> & {\n  timestamp: string;\n  content: ContentBlock[];\n  toolCalls?: ToolCall[];\n  results?: ToolResult[];\n};\n\n/**\n * Message role/type constants.\n *\n * Use these constants instead of raw strings for type-safe message handling:\n *\n * @example\n * ```typescript\n * import { MessageRole, isUserMessage } from 'upp';\n *\n * if (message.type === MessageRole.User) {\n *   console.log('User said:', message.text);\n * } else if (message.type === MessageRole.Assistant) {\n *   console.log('Assistant replied:', message.text);\n * }\n * ```\n */\nexport const MessageRole = {\n  /** User message */\n  User: 'user',\n  /** Assistant/model response */\n  Assistant: 'assistant',\n  /** Tool execution result */\n  ToolResult: 'tool_result',\n} as const;\n\n/**\n * Message type discriminator union.\n *\n * This type is derived from {@link MessageRole} constants. The name `MessageType`\n * is kept for backward compatibility; `MessageRole` works as both the const\n * object and this type.\n */\nexport type MessageType = (typeof MessageRole)[keyof typeof MessageRole];\n\n/**\n * Type alias for MessageType, allowing `MessageRole` to work as both const and type.\n */\nexport type MessageRole = MessageType;\n\n/**\n * Provider-namespaced metadata for messages.\n *\n * Each provider can attach its own metadata under its namespace,\n * preventing conflicts between different providers.\n *\n * @example\n * ```typescript\n * const metadata: MessageMetadata = {\n *   openai: { model: 'gpt-4', finishReason: 'stop' },\n *   anthropic: { model: 'claude-3', stopReason: 'end_turn' }\n * };\n * ```\n */\nexport interface MessageMetadata {\n  [provider: string]: Record<string, unknown> | undefined;\n}\n\n/**\n * Options for constructing messages.\n */\nexport interface MessageOptions {\n  /** Custom message ID (auto-generated if not provided) */\n  id?: string;\n\n  /** Provider-specific metadata */\n  metadata?: MessageMetadata;\n}\n\n/**\n * Abstract base class for all message types.\n *\n * Provides common functionality for user, assistant, and tool result\n * messages, including content accessors and metadata handling.\n *\n * @example\n * ```typescript\n * // Access text content from any message\n * const text = message.text;\n *\n * // Access images\n * const images = message.images;\n * ```\n */\nexport abstract class Message {\n  /** Unique message identifier */\n  readonly id: string;\n\n  /** Timestamp when the message was created */\n  readonly timestamp: Date;\n\n  /** Provider-specific metadata, namespaced by provider name */\n  readonly metadata?: MessageMetadata;\n\n  /** Message type discriminator (implemented by subclasses) */\n  abstract readonly type: MessageType;\n\n  /**\n   * Returns the content blocks for this message.\n   * Implemented by subclasses to provide type-specific content.\n   */\n  protected abstract getContent(): ContentBlock[];\n\n  /**\n   * Creates a new message instance.\n   *\n   * @param options - Optional message ID and metadata\n   */\n  constructor(options?: MessageOptions) {\n    this.id = options?.id ?? generateId();\n    this.timestamp = new Date();\n    this.metadata = options?.metadata;\n  }\n\n  /**\n   * Concatenated text content from all text blocks.\n   * Blocks are joined with double newlines.\n   */\n  get text(): string {\n    return this.getContent()\n      .filter((block): block is TextBlock => block.type === 'text')\n      .map((block) => block.text)\n      .join('\\n\\n');\n  }\n\n  /**\n   * All image content blocks in this message.\n   */\n  get images(): ImageBlock[] {\n    return this.getContent().filter((block): block is ImageBlock => block.type === 'image');\n  }\n\n  /**\n   * All document content blocks in this message.\n   */\n  get documents(): DocumentBlock[] {\n    return this.getContent().filter((block): block is DocumentBlock => block.type === 'document');\n  }\n\n  /**\n   * All audio content blocks in this message.\n   */\n  get audio(): AudioBlock[] {\n    return this.getContent().filter((block): block is AudioBlock => block.type === 'audio');\n  }\n\n  /**\n   * All video content blocks in this message.\n   */\n  get video(): VideoBlock[] {\n    return this.getContent().filter((block): block is VideoBlock => block.type === 'video');\n  }\n\n  /**\n   * All reasoning/thinking content blocks in this message.\n   * Available when using extended thinking models.\n   */\n  get reasoning(): ReasoningBlock[] {\n    return this.getContent().filter((block): block is ReasoningBlock => block.type === 'reasoning');\n  }\n}\n\n/**\n * User input message.\n *\n * Represents a message from the user, which can contain text and/or\n * multimodal content like images, audio, or video.\n *\n * @example\n * ```typescript\n * // Simple text message\n * const msg = new UserMessage('Hello, world!');\n *\n * // Multimodal message\n * const msg = new UserMessage([\n *   { type: 'text', text: 'What is in this image?' },\n *   { type: 'image', source: { type: 'url', url: '...' }, mimeType: 'image/png' }\n * ]);\n * ```\n */\nexport class UserMessage extends Message {\n  /** Message type discriminator */\n  readonly type = 'user' as const;\n\n  /** Content blocks in this message */\n  readonly content: UserContent[];\n\n  /**\n   * Creates a new user message.\n   *\n   * @param content - String (converted to TextBlock) or array of content blocks\n   * @param options - Optional message ID and metadata\n   */\n  constructor(content: string | UserContent[], options?: MessageOptions) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n}\n\n/**\n * Assistant response message.\n *\n * Represents a response from the AI assistant, which may contain\n * text, media content, and/or tool call requests.\n *\n * @example\n * ```typescript\n * // Simple text response\n * const msg = new AssistantMessage('Hello! How can I help?');\n *\n * // Response with tool calls\n * const msg = new AssistantMessage(\n *   'Let me check the weather...',\n *   [{ toolCallId: 'call_1', toolName: 'get_weather', arguments: { location: 'NYC' } }]\n * );\n * ```\n */\nexport class AssistantMessage extends Message {\n  /** Message type discriminator */\n  readonly type = 'assistant' as const;\n\n  /** Content blocks in this message */\n  readonly content: AssistantContent[];\n\n  /** Tool calls requested by the model (if any) */\n  readonly toolCalls?: ToolCall[];\n\n  /**\n   * Creates a new assistant message.\n   *\n   * @param content - String (converted to TextBlock) or array of content blocks\n   * @param toolCalls - Tool calls requested by the model\n   * @param options - Optional message ID and metadata\n   */\n  constructor(\n    content: string | AssistantContent[],\n    toolCalls?: ToolCall[],\n    options?: MessageOptions\n  ) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n    this.toolCalls = toolCalls;\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n\n  /**\n   * Whether this message contains tool call requests.\n   */\n  get hasToolCalls(): boolean {\n    return this.toolCalls !== undefined && this.toolCalls.length > 0;\n  }\n}\n\n/**\n * Tool execution result message.\n *\n * Contains the results of executing one or more tool calls,\n * sent back to the model for further processing.\n *\n * @example\n * ```typescript\n * const msg = new ToolResultMessage([\n *   { toolCallId: 'call_1', result: { temperature: 72, conditions: 'sunny' } },\n *   { toolCallId: 'call_2', result: 'File not found', isError: true }\n * ]);\n * ```\n */\nexport class ToolResultMessage extends Message {\n  /** Message type discriminator */\n  readonly type = 'tool_result' as const;\n\n  /** Results from tool executions */\n  readonly results: ToolResult[];\n\n  /**\n   * Creates a new tool result message.\n   *\n   * @param results - Array of tool execution results\n   * @param options - Optional message ID and metadata\n   */\n  constructor(results: ToolResult[], options?: MessageOptions) {\n    super(options);\n    this.results = results;\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.results.map((result) => ({\n      type: 'text' as const,\n      text:\n        typeof result.result === 'string'\n          ? result.result\n          : JSON.stringify(result.result),\n    }));\n  }\n}\n\n/**\n * Type guard for UserMessage.\n *\n * @param msg - The message to check\n * @returns True if the message is a UserMessage\n *\n * @example\n * ```typescript\n * if (isUserMessage(msg)) {\n *   console.log('User said:', msg.text);\n * }\n * ```\n */\nexport function isUserMessage(msg: Message): msg is UserMessage {\n  return msg.type === MessageRole.User;\n}\n\n/**\n * Type guard for AssistantMessage.\n *\n * @param msg - The message to check\n * @returns True if the message is an AssistantMessage\n *\n * @example\n * ```typescript\n * if (isAssistantMessage(msg)) {\n *   console.log('Assistant said:', msg.text);\n *   if (msg.hasToolCalls) {\n *     console.log('Tool calls:', msg.toolCalls);\n *   }\n * }\n * ```\n */\nexport function isAssistantMessage(msg: Message): msg is AssistantMessage {\n  return msg.type === MessageRole.Assistant;\n}\n\n/**\n * Type guard for ToolResultMessage.\n *\n * @param msg - The message to check\n * @returns True if the message is a ToolResultMessage\n *\n * @example\n * ```typescript\n * if (isToolResultMessage(msg)) {\n *   for (const result of msg.results) {\n *     console.log(`Tool ${result.toolCallId}:`, result.result);\n *   }\n * }\n * ```\n */\nexport function isToolResultMessage(msg: Message): msg is ToolResultMessage {\n  return msg.type === MessageRole.ToolResult;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-HB4ZIH3T.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware/pubsub/server/h3.ts"],"sourcesContent":["/**\n * @fileoverview H3/Nitro/Nuxt adapter for pub-sub stream resumption.\n *\n * Provides utilities for H3-based servers (Nuxt, Nitro, or standalone H3)\n * to handle stream reconnections.\n *\n * @module middleware/pubsub/server/h3\n */\n\nimport type { PubSubAdapter } from '../types.ts';\nimport { runSubscriberStream } from './shared.ts';\n\n/**\n * H3 Event interface (minimal type to avoid dependency).\n */\ninterface H3Event {\n  node: {\n    res: {\n      setHeader(name: string, value: string): void;\n      write(chunk: string): boolean;\n      end(): void;\n      on(event: 'close', listener: () => void): void;\n    };\n  };\n}\n\n/**\n * Stream buffered and live events to an H3 event response.\n *\n * This utility handles the reconnection pattern for H3/Nuxt routes:\n * 1. Replays all buffered events from the adapter\n * 2. If stream is already completed, ends immediately\n * 3. Otherwise, subscribes to live events until completion\n *\n * @param streamId - The stream ID to subscribe to\n * @param adapter - The pub-sub adapter instance\n * @param event - H3 event object\n *\n * @example\n * ```typescript\n * import { streamSubscriber } from '@providerprotocol/ai/middleware/pubsub/server/h3';\n *\n * export default defineEventHandler(async (event) => {\n *   const { streamId } = await readBody(event);\n *   return streamSubscriber(streamId, adapter, event);\n * });\n * ```\n */\nexport async function streamSubscriber(\n  streamId: string,\n  adapter: PubSubAdapter,\n  event: H3Event\n): Promise<void> {\n  const res = event.node.res;\n  res.setHeader('Content-Type', 'text/event-stream');\n  res.setHeader('Cache-Control', 'no-cache');\n  res.setHeader('Connection', 'keep-alive');\n\n  const abortController = new AbortController();\n  res.on('close', () => abortController.abort());\n\n  await runSubscriberStream(\n    streamId,\n    adapter,\n    {\n      write: (data: string) => res.write(data),\n      end: () => res.end(),\n    },\n    { signal: abortController.signal }\n  );\n}\n\n/**\n * H3 adapter namespace for pub-sub server utilities.\n */\nexport const h3 = {\n  streamSubscriber,\n};\n"],"mappings":";;;;;AAgDA,eAAsB,iBACpB,UACA,SACA,OACe;AACf,QAAM,MAAM,MAAM,KAAK;AACvB,MAAI,UAAU,gBAAgB,mBAAmB;AACjD,MAAI,UAAU,iBAAiB,UAAU;AACzC,MAAI,UAAU,cAAc,YAAY;AAExC,QAAM,kBAAkB,IAAI,gBAAgB;AAC5C,MAAI,GAAG,SAAS,MAAM,gBAAgB,MAAM,CAAC;AAE7C,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,MACE,OAAO,CAAC,SAAiB,IAAI,MAAM,IAAI;AAAA,MACvC,KAAK,MAAM,IAAI,IAAI;AAAA,IACrB;AAAA,IACA,EAAE,QAAQ,gBAAgB,OAAO;AAAA,EACnC;AACF;AAKO,IAAM,KAAK;AAAA,EAChB;AACF;","names":[]}

package/dist/chunk-VOEWHQUB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware/pubsub/server/fastify.ts"],"sourcesContent":["/**\n * @fileoverview Fastify adapter for pub-sub stream resumption.\n *\n * Provides utilities for Fastify servers to handle stream reconnections.\n *\n * @module middleware/pubsub/server/fastify\n */\n\nimport type { PubSubAdapter } from '../types.ts';\nimport { runSubscriberStream } from './shared.ts';\n\n/**\n * Fastify Reply interface (minimal type to avoid dependency).\n */\ninterface FastifyReply {\n  raw: {\n    setHeader(name: string, value: string): void;\n    write(chunk: string): boolean;\n    end(): void;\n    on(event: 'close', listener: () => void): void;\n  };\n}\n\n/**\n * Stream buffered and live events to a Fastify reply.\n *\n * This utility handles the reconnection pattern for Fastify routes:\n * 1. Replays all buffered events from the adapter\n * 2. If stream is already completed, ends immediately\n * 3. Otherwise, subscribes to live events until completion\n *\n * @param streamId - The stream ID to subscribe to\n * @param adapter - The pub-sub adapter instance\n * @param reply - Fastify reply object\n *\n * @example\n * ```typescript\n * import { streamSubscriber } from '@providerprotocol/ai/middleware/pubsub/server/fastify';\n *\n * app.post('/api/ai/reconnect', async (request, reply) => {\n *   const { streamId } = request.body;\n *   return streamSubscriber(streamId, adapter, reply);\n * });\n * ```\n */\nexport async function streamSubscriber(\n  streamId: string,\n  adapter: PubSubAdapter,\n  reply: FastifyReply\n): Promise<void> {\n  const res = reply.raw;\n  res.setHeader('Content-Type', 'text/event-stream');\n  res.setHeader('Cache-Control', 'no-cache');\n  res.setHeader('Connection', 'keep-alive');\n\n  const abortController = new AbortController();\n  res.on('close', () => abortController.abort());\n\n  await runSubscriberStream(\n    streamId,\n    adapter,\n    {\n      write: (data: string) => res.write(data),\n      end: () => res.end(),\n    },\n    { signal: abortController.signal }\n  );\n}\n\n/**\n * Fastify adapter namespace for pub-sub server utilities.\n */\nexport const fastify = {\n  streamSubscriber,\n};\n"],"mappings":";;;;;AA6CA,eAAsB,iBACpB,UACA,SACA,OACe;AACf,QAAM,MAAM,MAAM;AAClB,MAAI,UAAU,gBAAgB,mBAAmB;AACjD,MAAI,UAAU,iBAAiB,UAAU;AACzC,MAAI,UAAU,cAAc,YAAY;AAExC,QAAM,kBAAkB,IAAI,gBAAgB;AAC5C,MAAI,GAAG,SAAS,MAAM,gBAAgB,MAAM,CAAC;AAE7C,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,MACE,OAAO,CAAC,SAAiB,IAAI,MAAM,IAAI;AAAA,MACvC,KAAK,MAAM,IAAI,IAAI;AAAA,IACrB;AAAA,IACA,EAAE,QAAQ,gBAAgB,OAAO;AAAA,EACnC;AACF;AAKO,IAAM,UAAU;AAAA,EACrB;AACF;","names":[]}

package/dist/chunk-ZI67WIQS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/middleware/pubsub/server/express.ts"],"sourcesContent":["/**\n * @fileoverview Express/Connect adapter for pub-sub stream resumption.\n *\n * Provides utilities for Express.js or Connect-based servers\n * to handle stream reconnections.\n *\n * @module middleware/pubsub/server/express\n */\n\nimport type { PubSubAdapter } from '../types.ts';\nimport { runSubscriberStream } from './shared.ts';\n\n/**\n * Express Response interface (minimal type to avoid dependency).\n */\ninterface ExpressResponse {\n  setHeader(name: string, value: string): void;\n  write(chunk: string): boolean;\n  end(): void;\n  on(event: 'close', listener: () => void): void;\n}\n\n/**\n * Stream buffered and live events to an Express response.\n *\n * This utility handles the reconnection pattern for Express routes:\n * 1. Replays all buffered events from the adapter\n * 2. If stream is already completed, ends immediately\n * 3. Otherwise, subscribes to live events until completion\n *\n * @param streamId - The stream ID to subscribe to\n * @param adapter - The pub-sub adapter instance\n * @param res - Express response object\n *\n * @example\n * ```typescript\n * import { streamSubscriber } from '@providerprotocol/ai/middleware/pubsub/server/express';\n *\n * app.post('/api/ai/reconnect', async (req, res) => {\n *   const { streamId } = req.body;\n *   streamSubscriber(streamId, adapter, res);\n * });\n * ```\n */\nexport async function streamSubscriber(\n  streamId: string,\n  adapter: PubSubAdapter,\n  res: ExpressResponse\n): Promise<void> {\n  res.setHeader('Content-Type', 'text/event-stream');\n  res.setHeader('Cache-Control', 'no-cache');\n  res.setHeader('Connection', 'keep-alive');\n\n  const abortController = new AbortController();\n  res.on('close', () => abortController.abort());\n\n  await runSubscriberStream(\n    streamId,\n    adapter,\n    {\n      write: (data: string) => res.write(data),\n      end: () => res.end(),\n    },\n    { signal: abortController.signal }\n  );\n}\n\n/**\n * Express adapter namespace for pub-sub server utilities.\n */\nexport const express = {\n  streamSubscriber,\n};\n"],"mappings":";;;;;AA4CA,eAAsB,iBACpB,UACA,SACA,KACe;AACf,MAAI,UAAU,gBAAgB,mBAAmB;AACjD,MAAI,UAAU,iBAAiB,UAAU;AACzC,MAAI,UAAU,cAAc,YAAY;AAExC,QAAM,kBAAkB,IAAI,gBAAgB;AAC5C,MAAI,GAAG,SAAS,MAAM,gBAAgB,MAAM,CAAC;AAE7C,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,MACE,OAAO,CAAC,SAAiB,IAAI,MAAM,IAAI;AAAA,MACvC,KAAK,MAAM,IAAI,IAAI;AAAA,IACrB;AAAA,IACA,EAAE,QAAQ,gBAAgB,OAAO;AAAA,EACnC;AACF;AAKO,IAAM,UAAU;AAAA,EACrB;AACF;","names":[]}

package/dist/types-C8Gciizr.d.ts

@@ -1,168 +0,0 @@
-import { S as StreamEvent } from './stream-CecfVCPO.js';
-
-/**
- * @fileoverview Pub-sub middleware types for stream resumption.
- *
- * Defines interfaces for temporary stream storage, replay, and
- * multi-client broadcast during active generation.
- *
- * @module middleware/pubsub/types
- */
-
-/**
- * Stored stream state.
- */
-interface StoredStream {
-    readonly streamId: string;
-    readonly modelId: string;
-    readonly provider: string;
-    readonly createdAt: number;
-    readonly updatedAt: number;
-    readonly completed: boolean;
-    readonly events: readonly StreamEvent[];
-}
-/**
- * Subscription callback for live events.
- *
- * @param event - Stream event payload
- * @param cursor - Zero-based event index when adapter supports cursors
- */
-type SubscriptionCallback = (event: StreamEvent, cursor?: number) => void;
-/**
- * Unsubscribe function returned by subscribe.
- */
-type Unsubscribe = () => void;
-/**
- * Storage adapter interface for pub-sub middleware.
- *
- * Implement this interface for custom backends (Redis, etc.).
- *
- * @example
- * ```typescript
- * const redisAdapter: PubSubAdapter = {
- *   async create(streamId, metadata) {
- *     await redis.hset(`stream:${streamId}`, metadata);
- *   },
- *   // ... other methods
- * };
- * ```
- */
-interface PubSubAdapter {
-    /**
-     * Checks if a stream exists.
-     *
-     * @param streamId - Stream identifier to check
-     * @returns True if the stream exists
-     */
-    exists(streamId: string): Promise<boolean>;
-    /**
-     * Creates a stream entry.
-     *
-     * @param streamId - Unique stream identifier
-     * @param metadata - Stream metadata (modelId, provider)
-     */
-    create(streamId: string, metadata: {
-        modelId: string;
-        provider: string;
-    }): Promise<void>;
-    /**
-     * Appends an event to the stream.
-     *
-     * @param streamId - Stream to append to
-     * @param event - Stream event to store
-     */
-    append(streamId: string, event: StreamEvent): Promise<void>;
-    /**
-     * Marks stream as completed.
-     *
-     * @param streamId - Stream to mark complete
-     */
-    markCompleted(streamId: string): Promise<void>;
-    /**
-     * Checks if stream is completed.
-     *
-     * @param streamId - Stream to check
-     * @returns True if stream is completed
-     */
-    isCompleted(streamId: string): Promise<boolean>;
-    /**
-     * Fetches all events for replay.
-     *
-     * @param streamId - Stream to fetch events from
-     * @returns Array of events or null if stream doesn't exist
-     */
-    getEvents(streamId: string): Promise<StreamEvent[] | null>;
-    /**
-     * Gets stream metadata.
-     *
-     * @param streamId - Stream to get
-     * @returns Stream metadata or null if not found
-     */
-    getStream(streamId: string): Promise<StoredStream | null>;
-    /**
-     * Subscribes to live events for a stream.
-     *
-     * @param streamId - Stream to subscribe to
-     * @param callback - Function called for each new event
-     * @param callback.cursor - Zero-based index of the event when supported
-     * @returns Unsubscribe function
-     */
-    subscribe(streamId: string, callback: SubscriptionCallback): Unsubscribe;
-    /**
-     * Publishes event to all subscribers.
-     *
-     * @param streamId - Stream to publish to
-     * @param event - Event to broadcast
-     */
-    publish(streamId: string, event: StreamEvent): void;
-    /**
-     * Removes a stream (cleanup).
-     *
-     * @param streamId - Stream to remove
-     */
-    remove(streamId: string): Promise<void>;
-    /**
-     * Removes streams older than maxAge.
-     *
-     * @param maxAge - Maximum age in milliseconds
-     */
-    cleanup(maxAge: number): Promise<void>;
-}
-/**
- * Options for pub-sub middleware.
- */
-interface PubSubOptions {
-    /**
-     * Storage adapter instance.
-     * @default memoryAdapter()
-     */
-    adapter?: PubSubAdapter;
-    /**
-     * Stream identifier for reconnection support.
-     *
-     * When provided:
-     * - If stream exists in adapter → Reconnection, replay buffered events
-     * - If stream doesn't exist → New request, create entry and proceed
-     *
-     * When not provided:
-     * - No pub/sub behavior, middleware is effectively disabled
-     */
-    streamId?: string;
-    /**
-     * TTL for stored streams in milliseconds.
-     * @default 600000 (10 minutes)
-     */
-    ttl?: number;
-}
-/**
- * Options for memory adapter.
- */
-interface MemoryAdapterOptions {
-    /**
-     * Max streams to keep (LRU eviction).
-     * @default 1000
-     */
-    maxStreams?: number;
-}
-
-export type { MemoryAdapterOptions as M, PubSubAdapter as P, StoredStream as S, Unsubscribe as U, PubSubOptions as a, SubscriptionCallback as b };