@providerprotocol/ai 0.0.39 → 0.0.40

package/dist/chunk-EY2LLDGY.js

@@ -0,0 +1,94 @@
+import {
+  ErrorCode,
+  UPPError
+} from "./chunk-COS4ON4G.js";
+
+// src/http/keys.ts
+function roundRobinKeys(keys) {
+  if (keys.length === 0) {
+    throw new Error("roundRobinKeys requires at least one key");
+  }
+  const snapshot = [...keys];
+  let index = 0;
+  return {
+    getKey() {
+      const key = snapshot[index];
+      index = (index + 1) % snapshot.length;
+      return key;
+    }
+  };
+}
+function weightedKeys(keys) {
+  if (keys.length === 0) {
+    throw new Error("weightedKeys requires at least one key");
+  }
+  const snapshot = keys.map((k) => ({ ...k }));
+  const totalWeight = snapshot.reduce((sum, k) => sum + k.weight, 0);
+  if (totalWeight <= 0) {
+    throw new Error("weightedKeys requires at least one key with a positive weight");
+  }
+  return {
+    getKey() {
+      const random = Math.random() * totalWeight;
+      let cumulative = 0;
+      for (const entry of snapshot) {
+        cumulative += entry.weight;
+        if (random <= cumulative) {
+          return entry.key;
+        }
+      }
+      return snapshot[snapshot.length - 1].key;
+    }
+  };
+}
+function dynamicKey(selector) {
+  return {
+    async getKey() {
+      return selector();
+    }
+  };
+}
+function maskApiKey(key) {
+  if (key.length <= 8) {
+    return "***";
+  }
+  return `${key.slice(0, 4)}...${key.slice(-4)}`;
+}
+function isKeyStrategy(value) {
+  return typeof value === "object" && value !== null && "getKey" in value && typeof value.getKey === "function";
+}
+async function resolveApiKey(config, envVar, provider = "unknown", modality = "llm") {
+  const { apiKey } = config;
+  if (apiKey !== void 0) {
+    if (typeof apiKey === "string") {
+      return apiKey;
+    }
+    if (typeof apiKey === "function") {
+      return apiKey();
+    }
+    if (isKeyStrategy(apiKey)) {
+      return apiKey.getKey();
+    }
+  }
+  if (envVar) {
+    const envValue = process.env[envVar];
+    if (envValue) {
+      return envValue;
+    }
+  }
+  throw new UPPError(
+    envVar ? `API key not found. Set ${envVar} environment variable or provide apiKey in config.` : "API key not found. Provide apiKey in config.",
+    ErrorCode.AuthenticationFailed,
+    provider,
+    modality
+  );
+}
+
+export {
+  roundRobinKeys,
+  weightedKeys,
+  dynamicKey,
+  maskApiKey,
+  resolveApiKey
+};
+//# sourceMappingURL=chunk-EY2LLDGY.js.map

package/dist/chunk-EY2LLDGY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http/keys.ts"],"sourcesContent":["/**\n * API key management strategies for load balancing and dynamic key selection.\n * @module http/keys\n */\n\nimport type { ProviderConfig, KeyStrategy } from '../types/provider.ts';\nimport { ErrorCode, UPPError, type Modality } from '../types/errors.ts';\n\n/**\n * Creates a key strategy that distributes API requests across multiple keys\n * using round-robin selection.\n *\n * Each call to `getKey()` returns the next key in sequence, cycling back to\n * the first key after reaching the end. This provides even distribution of requests\n * across all available keys, which is useful for:\n * - Spreading rate limits across multiple API keys\n * - Load balancing between different accounts\n * - Maximizing throughput when multiple keys are available\n *\n * @param keys - Array of API keys to rotate through\n * @returns A {@link KeyStrategy} that cycles through the provided keys\n * @throws {Error} When the keys array is empty\n *\n * @example\n * ```typescript\n * const keys = roundRobinKeys([\n *   'sk-key-1',\n *   'sk-key-2',\n *   'sk-key-3'\n * ]);\n *\n * keys.getKey(); // Returns 'sk-key-1'\n * keys.getKey(); // Returns 'sk-key-2'\n * keys.getKey(); // Returns 'sk-key-3'\n * keys.getKey(); // Returns 'sk-key-1' (cycles back)\n * ```\n */\nexport function roundRobinKeys(keys: string[]): KeyStrategy {\n  if (keys.length === 0) {\n    throw new Error('roundRobinKeys requires at least one key');\n  }\n  const snapshot = [...keys];\n  let index = 0;\n  return {\n    getKey(): string {\n      const key = snapshot[index]!;\n      index = (index + 1) % snapshot.length;\n      return key;\n    },\n  };\n}\n\n/**\n * Creates a key strategy that selects API keys using weighted random probability.\n *\n * Each key is assigned a weight that determines its probability of being selected.\n * Higher weights mean higher selection probability. This is useful for:\n * - Preferring higher-tier API keys with better rate limits\n * - Gradually migrating traffic between old and new keys\n * - A/B testing different API accounts\n * - Directing more traffic to keys with higher quotas\n *\n * The selection probability for each key is: weight / totalWeight\n *\n * @param keys - Array of key-weight pairs defining selection probabilities\n * @returns A {@link KeyStrategy} that selects keys by weighted probability\n * @throws {Error} When the keys array is empty\n *\n * @example\n * ```typescript\n * const keys = weightedKeys([\n *   { key: 'sk-premium', weight: 70 },   // 70% of requests\n *   { key: 'sk-standard', weight: 20 },  // 20% of requests\n *   { key: 'sk-backup', weight: 10 }     // 10% of requests\n * ]);\n *\n * // Configure provider with weighted key selection\n * const provider = createOpenAI({\n *   apiKey: keys\n * });\n * ```\n */\nexport function weightedKeys(keys: Array<{ key: string; weight: number }>): KeyStrategy {\n  if (keys.length === 0) {\n    throw new Error('weightedKeys requires at least one key');\n  }\n  const snapshot = keys.map((k) => ({ ...k }));\n  const totalWeight = snapshot.reduce((sum, k) => sum + k.weight, 0);\n  if (totalWeight <= 0) {\n    throw new Error('weightedKeys requires at least one key with a positive weight');\n  }\n  return {\n    getKey(): string {\n      const random = Math.random() * totalWeight;\n      let cumulative = 0;\n\n      for (const entry of snapshot) {\n        cumulative += entry.weight;\n        if (random <= cumulative) {\n          return entry.key;\n        }\n      }\n\n      return snapshot[snapshot.length - 1]!.key;\n    },\n  };\n}\n\n/**\n * Creates a key strategy that delegates key selection to a user-provided function,\n * enabling advanced scenarios such as:\n * - Fetching keys from a secrets manager (AWS Secrets Manager, HashiCorp Vault)\n * - Rotating keys based on external state or configuration\n * - Selecting keys based on request context or time of day\n * - Implementing custom load balancing algorithms\n *\n * The selector function can be synchronous or asynchronous.\n *\n * @param selector - Function that returns an API key (sync or async)\n * @returns A {@link KeyStrategy} that delegates to the selector function\n *\n * @example\n * ```typescript\n * // Fetch key from environment based on current mode\n * const envKey = dynamicKey(() => {\n *   return process.env.NODE_ENV === 'production'\n *     ? process.env.PROD_API_KEY!\n *     : process.env.DEV_API_KEY!;\n * });\n *\n * // Async key fetching from a secrets manager\n * const vaultKey = dynamicKey(async () => {\n *   const secret = await vault.read('secret/openai');\n *   return secret.data.apiKey;\n * });\n *\n * // Time-based key rotation\n * const timedKey = dynamicKey(() => {\n *   const hour = new Date().getHours();\n *   return hour < 12 ? morningKey : afternoonKey;\n * });\n * ```\n */\nexport function dynamicKey(selector: () => string | Promise<string>): KeyStrategy {\n  return {\n    async getKey(): Promise<string> {\n      return selector();\n    },\n  };\n}\n\n/**\n * Masks an API key for safe logging.\n * Shows first 4 and last 4 characters with ellipsis, or '***' for short keys.\n *\n * @param key - The API key to mask\n * @returns Masked key like \"sk-ab...yz12\" or \"***\" for short keys\n *\n * @example\n * ```typescript\n * maskApiKey('sk-abc123def456xyz789'); // 'sk-a...z789'\n * maskApiKey('short'); // '***'\n * ```\n */\nexport function maskApiKey(key: string): string {\n  if (key.length <= 8) {\n    return '***';\n  }\n  return `${key.slice(0, 4)}...${key.slice(-4)}`;\n}\n\n/**\n * Type guard to check if a value implements the KeyStrategy interface.\n *\n * @param value - The value to check\n * @returns True if the value has a getKey method\n */\nfunction isKeyStrategy(value: unknown): value is KeyStrategy {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'getKey' in value &&\n    typeof (value as KeyStrategy).getKey === 'function'\n  );\n}\n\n/**\n * Resolves an API key from provider configuration with multiple fallback options.\n *\n * This function handles various key specification methods in priority order:\n * 1. Direct string key in config.apiKey\n * 2. Function returning a key (sync or async) in config.apiKey\n * 3. KeyStrategy instance in config.apiKey (roundRobinKeys, weightedKeys, dynamicKey)\n * 4. Environment variable fallback (if envVar parameter is provided)\n *\n * @param config - Provider configuration containing the apiKey option\n * @param envVar - Optional environment variable name to check as fallback\n * @param provider - Provider identifier for error context (default: 'unknown')\n * @param modality - Request modality for error context (default: 'llm')\n * @returns The resolved API key string\n *\n * @throws {UPPError} AUTHENTICATION_FAILED - When no valid key is found\n *\n * @example\n * ```typescript\n * // Direct key in config\n * const key1 = await resolveApiKey({ apiKey: 'sk-...' }, 'OPENAI_API_KEY', 'openai');\n *\n * // Function-based key\n * const key2 = await resolveApiKey({ apiKey: () => getKeyFromVault() }, undefined, 'anthropic');\n *\n * // KeyStrategy instance\n * const key3 = await resolveApiKey({\n *   apiKey: roundRobinKeys(['sk-1', 'sk-2', 'sk-3'])\n * }, 'OPENAI_API_KEY', 'openai');\n *\n * // Environment variable fallback\n * const key4 = await resolveApiKey({}, 'ANTHROPIC_API_KEY', 'anthropic');\n * ```\n */\nexport async function resolveApiKey(\n  config: ProviderConfig,\n  envVar?: string,\n  provider = 'unknown',\n  modality: Modality = 'llm'\n): Promise<string> {\n  const { apiKey } = config;\n\n  if (apiKey !== undefined) {\n    if (typeof apiKey === 'string') {\n      return apiKey;\n    }\n\n    if (typeof apiKey === 'function') {\n      return apiKey();\n    }\n\n    if (isKeyStrategy(apiKey)) {\n      return apiKey.getKey();\n    }\n  }\n\n  if (envVar) {\n    const envValue = process.env[envVar];\n    if (envValue) {\n      return envValue;\n    }\n  }\n\n  throw new UPPError(\n    envVar\n      ? `API key not found. Set ${envVar} environment variable or provide apiKey in config.`\n      : 'API key not found. Provide apiKey in config.',\n    ErrorCode.AuthenticationFailed,\n    provider,\n    modality\n  );\n}\n"],"mappings":";;;;;;AAqCO,SAAS,eAAe,MAA6B;AAC1D,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AACA,QAAM,WAAW,CAAC,GAAG,IAAI;AACzB,MAAI,QAAQ;AACZ,SAAO;AAAA,IACL,SAAiB;AACf,YAAM,MAAM,SAAS,KAAK;AAC1B,eAAS,QAAQ,KAAK,SAAS;AAC/B,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAgCO,SAAS,aAAa,MAA2D;AACtF,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,IAAI,MAAM,wCAAwC;AAAA,EAC1D;AACA,QAAM,WAAW,KAAK,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAC3C,QAAM,cAAc,SAAS,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,QAAQ,CAAC;AACjE,MAAI,eAAe,GAAG;AACpB,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,SAAO;AAAA,IACL,SAAiB;AACf,YAAM,SAAS,KAAK,OAAO,IAAI;AAC/B,UAAI,aAAa;AAEjB,iBAAW,SAAS,UAAU;AAC5B,sBAAc,MAAM;AACpB,YAAI,UAAU,YAAY;AACxB,iBAAO,MAAM;AAAA,QACf;AAAA,MACF;AAEA,aAAO,SAAS,SAAS,SAAS,CAAC,EAAG;AAAA,IACxC;AAAA,EACF;AACF;AAqCO,SAAS,WAAW,UAAuD;AAChF,SAAO;AAAA,IACL,MAAM,SAA0B;AAC9B,aAAO,SAAS;AAAA,IAClB;AAAA,EACF;AACF;AAeO,SAAS,WAAW,KAAqB;AAC9C,MAAI,IAAI,UAAU,GAAG;AACnB,WAAO;AAAA,EACT;AACA,SAAO,GAAG,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;AAC9C;AAQA,SAAS,cAAc,OAAsC;AAC3D,SACE,OAAO,UAAU,YACjB,UAAU,QACV,YAAY,SACZ,OAAQ,MAAsB,WAAW;AAE7C;AAoCA,eAAsB,cACpB,QACA,QACA,WAAW,WACX,WAAqB,OACJ;AACjB,QAAM,EAAE,OAAO,IAAI;AAEnB,MAAI,WAAW,QAAW;AACxB,QAAI,OAAO,WAAW,UAAU;AAC9B,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,WAAW,YAAY;AAChC,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,cAAc,MAAM,GAAG;AACzB,aAAO,OAAO,OAAO;AAAA,IACvB;AAAA,EACF;AAEA,MAAI,QAAQ;AACV,UAAM,WAAW,QAAQ,IAAI,MAAM;AACnC,QAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,IAAI;AAAA,IACR,SACI,0BAA0B,MAAM,uDAChC;AAAA,IACJ,UAAU;AAAA,IACV;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-MJI74VEJ.js → chunk-F5ENANMJ.js}

@@ -18,6 +18,8 @@ var StreamEventType = {
   ToolExecutionStart: "tool_execution_start",
   /** Tool execution has completed */
   ToolExecutionEnd: "tool_execution_end",
+  /** Stream is being retried after an error */
+  StreamRetry: "stream_retry",
   /** Beginning of a message */
   MessageStart: "message_start",
   /** End of a message */
@@ -137,6 +139,19 @@ function toolExecutionEnd(toolCallId, toolName, result, isError, timestamp, inde
     delta: { toolCallId, toolName, result, isError, timestamp }
   };
 }
+function streamRetry(attempt, maxAttempts, error, timestamp) {
+  const serializedError = {
+    message: error.message
+  };
+  if ("code" in error && typeof error.code === "string") {
+    serializedError.code = error.code;
+  }
+  return {
+    type: StreamEventType.StreamRetry,
+    index: 0,
+    delta: { attempt, maxAttempts, error: serializedError, timestamp }
+  };
+}
 
 export {
   StreamEventType,
@@ -149,6 +164,7 @@ export {
   contentBlockStart,
   contentBlockStop,
   toolExecutionStart,
-  toolExecutionEnd
+  toolExecutionEnd,
+  streamRetry
 };
-//# sourceMappingURL=chunk-MJI74VEJ.js.map
+//# sourceMappingURL=chunk-F5ENANMJ.js.map

package/dist/chunk-F5ENANMJ.js.map

@@ -0,0 +1 @@
+{"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  /** Stream is being retried after an error */\n  StreamRetry: 'stream_retry',\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 * | `stream_retry` | `attempt`, `maxAttempts`, `error`, `timestamp` |\n * | `message_start` | (none) |\n * | `message_stop` | (none) |\n * | `content_block_start` | (none) |\n * | `content_block_stop` | (none) |\n *\n * Custom event types (via middleware) may extend EventDelta with additional fields.\n * See {@link @providerprotocol/ai/middleware/flow!FlowStageDelta} for an example.\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, stream_retry) */\n  timestamp?: number;\n\n  /** Current retry attempt number (stream_retry, 1-indexed) */\n  attempt?: number;\n\n  /** Maximum number of retry attempts configured (stream_retry) */\n  maxAttempts?: number;\n\n  /** Error that triggered the retry (stream_retry) - serialized for JSON transport */\n  error?: { message: string; code?: string };\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  /**\n   * Event type discriminator.\n   *\n   * Uses `StreamEventType | (string & Record<never, never>)` to allow custom\n   * event types (like 'flow_stage') while preserving autocomplete for known types.\n   * The `(string & Record<never, never>)` pattern is a TypeScript idiom that\n   * widens the type to accept any string without losing the literal type union\n   * in IDE autocomplete suggestions.\n   */\n  type: StreamEventType | (string & Record<never, never>);\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. Implements `PromiseLike<Turn>`\n * for direct awaiting with automatic stream consumption.\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 * // Option 1: Consume streaming events manually\n * for await (const event of stream) {\n *   if (event.type === StreamEventType.TextDelta) {\n *     process.stdout.write(event.delta.text ?? '');\n *   }\n * }\n * const turn = await stream.turn;\n *\n * // Option 2: Just await the turn (auto-drains the stream)\n * const turn = await instance.stream('Tell me a story');\n *\n * // Option 3: Fire-and-forget with callback\n * instance.stream('Tell me a story').then(turn => saveToDB(turn));\n * ```\n */\nexport interface StreamResult<TData = unknown>\n  extends AsyncIterable<StreamEvent>, PromiseLike<Turn<TData>> {\n  /**\n   * Promise that resolves to the complete Turn after streaming finishes.\n   * Rejects if the stream is aborted or terminated early.\n   *\n   * Accessing `turn` auto-drains the stream if it has not been iterated yet.\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 * // Can be awaited directly (auto-drains)\n * const turn = await stream;\n *\n * // Or iterated manually\n * for await (const event of stream) { ... }\n * const turn = await stream.turn;\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  let drainStarted = false;\n  let iteratorStarted = false;\n\n  const getTurn = (): Promise<Turn<TData>> => {\n    if (typeof turnPromiseOrFactory === 'function') {\n      if (!cachedTurn) {\n        cachedTurn = turnPromiseOrFactory();\n      }\n      return cachedTurn;\n    }\n    return turnPromiseOrFactory;\n  };\n\n  const drain = (): void => {\n    if (drainStarted) return;\n    drainStarted = true;\n    void (async () => {\n      try {\n        let done = false;\n        while (!done) {\n          const result = await generator.next();\n          done = result.done ?? false;\n        }\n      } catch {\n        // Errors are surfaced via turn promise\n      }\n    })();\n  };\n\n  return {\n    [Symbol.asyncIterator]() {\n      iteratorStarted = true;\n      return generator;\n    },\n    get turn() {\n      if (!iteratorStarted) {\n        drain();\n      }\n      return getTurn();\n    },\n    abort() {\n      abortController.abort();\n    },\n    then<TResult1 = Turn<TData>, TResult2 = never>(\n      onfulfilled?: ((value: Turn<TData>) => TResult1 | PromiseLike<TResult1>) | null,\n      onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n    ): Promise<TResult1 | TResult2> {\n      drain();\n      return getTurn().then(onfulfilled, onrejected);\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\n/**\n * Creates a stream retry event.\n *\n * Emitted when a streaming request is being retried after an error.\n * This allows consumers to reset UI state or notify users of retry attempts.\n *\n * @param attempt - Current retry attempt number (1-indexed)\n * @param maxAttempts - Maximum number of retry attempts configured\n * @param error - The error that triggered the retry\n * @param timestamp - Timestamp in milliseconds when retry was initiated\n * @returns A stream_retry StreamEvent\n */\nexport function streamRetry(\n  attempt: number,\n  maxAttempts: number,\n  error: Error,\n  timestamp: number\n): StreamEvent {\n  // Serialize error for JSON transport (Error properties are non-enumerable)\n  const serializedError: { message: string; code?: string } = {\n    message: error.message,\n  };\n  // Include error code if present (e.g., UPPError)\n  if ('code' in error && typeof error.code === 'string') {\n    serializedError.code = error.code;\n  }\n\n  return {\n    type: StreamEventType.StreamRetry,\n    index: 0,\n    delta: { attempt, maxAttempts, error: serializedError, timestamp },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-IKJH5ZSJ.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-IKJH5ZSJ.js.map

package/dist/chunk-IKJH5ZSJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{chunk-IIMTP3XC.js → chunk-KBI45OXI.js}

@@ -1,6 +1,6 @@
 import {
   runSubscriberStream
-} from "./chunk-U6M3MXNI.js";
+} from "./chunk-L6QWKFGE.js";
 
 // src/middleware/pubsub/server/h3.ts
 async function streamSubscriber(streamId, adapter, event) {
@@ -28,4 +28,4 @@ export {
   streamSubscriber,
   h3
 };
-//# sourceMappingURL=chunk-IIMTP3XC.js.map
+//# sourceMappingURL=chunk-KBI45OXI.js.map

package/dist/{chunk-SAMIK4WZ.js → chunk-KVUOTFYZ.js}

@@ -1,6 +1,6 @@
 import {
   runSubscriberStream
-} from "./chunk-U6M3MXNI.js";
+} from "./chunk-L6QWKFGE.js";
 
 // src/middleware/pubsub/server/express.ts
 async function streamSubscriber(streamId, adapter, res) {
@@ -27,4 +27,4 @@ export {
   streamSubscriber,
   express
 };
-//# sourceMappingURL=chunk-SAMIK4WZ.js.map
+//# sourceMappingURL=chunk-KVUOTFYZ.js.map

package/dist/{chunk-U6M3MXNI.js → chunk-L6QWKFGE.js}

@@ -79,11 +79,12 @@ async function runSubscriberStream(streamId, adapter, writer, options = {}) {
     });
     try {
       const events = await adapter.getEvents(streamId);
+      const cursorBase = adapter.getCursorBase(streamId);
       for (const event of events) {
         if (signal?.aborted) break;
         writer.write(formatSSE(event));
       }
-      lastSentCursor = events.length - 1;
+      lastSentCursor = cursorBase + events.length - 1;
       dropReplayDuplicates();
       if (signal?.aborted) {
         writer.end();
@@ -124,4 +125,4 @@ async function runSubscriberStream(streamId, adapter, writer, options = {}) {
 export {
   runSubscriberStream
 };
-//# sourceMappingURL=chunk-U6M3MXNI.js.map
+//# sourceMappingURL=chunk-L6QWKFGE.js.map

package/dist/chunk-L6QWKFGE.js.map

@@ -0,0 +1 @@
+{"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}\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 * Core subscriber stream logic shared across all adapters.\n *\n * Handles:\n * 1. Subscribing to live events and completion signal\n * 2. Replaying buffered events (empty if stream just started)\n * 3. Processing live events until completion signal\n * 4. Final cleanup\n * 5. 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 } = options;\n\n  if (signal?.aborted) {\n    writer.end();\n    return;\n  }\n\n  try {\n    if (signal?.aborted) {\n      writer.end();\n      return;\n    }\n\n    const queue: Array<{ event: StreamEvent; cursor: number | null }> = [];\n    let resolveWait: (() => void) | null = null;\n    let completed = false;\n    let lastSentCursor = -1;\n    let finalData: unknown = undefined;\n\n    const onEvent = (event: StreamEvent, cursor?: number): void => {\n      queue.push({ event, cursor: cursor ?? null });\n      resolveWait?.();\n    };\n\n    const onComplete = (): void => {\n      completed = true;\n      resolveWait?.();\n    };\n\n    const onFinalData = (data: unknown): void => {\n      finalData = data;\n    };\n\n    const unsubscribe = adapter.subscribe(streamId, onEvent, onComplete, onFinalData);\n\n    const onAbort = (): void => {\n      completed = 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) break;\n        const { event, cursor } = item;\n        if (cursor !== null && cursor <= lastSentCursor) continue;\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) return;\n      const filtered: Array<{ event: StreamEvent; cursor: number | null }> = [];\n      for (const item of queue) {\n        if (item.cursor !== null && item.cursor <= lastSentCursor) continue;\n        filtered.push(item);\n      }\n      queue.length = 0;\n      queue.push(...filtered);\n    };\n\n    const waitForSignal = (): Promise<void> => new Promise((resolve) => {\n      let settled = false;\n\n      const settle = (): void => {\n        if (settled) return;\n        settled = true;\n        resolveWait = null;\n        resolve();\n      };\n\n      resolveWait = settle;\n\n      if (completed || signal?.aborted || queue.length > 0) {\n        settle();\n      }\n    });\n\n    try {\n      const events = await adapter.getEvents(streamId);\n      const cursorBase = adapter.getCursorBase(streamId);\n\n      for (const event of events) {\n        if (signal?.aborted) break;\n        writer.write(formatSSE(event));\n      }\n\n      // Use cursor base to set lastSentCursor correctly after clear operations\n      // Events have cursors of cursorBase + index, so after replay the last cursor is cursorBase + length - 1\n      lastSentCursor = cursorBase + events.length - 1;\n      dropReplayDuplicates();\n\n      if (signal?.aborted) {\n        writer.end();\n        return;\n      }\n\n      // Wait for events or completion signal\n      while (!completed && !signal?.aborted) {\n        drainQueue();\n        if (completed || signal?.aborted) break;\n        await waitForSignal();\n      }\n\n      if (!signal?.aborted) {\n        drainQueue();\n      }\n    } finally {\n      signal?.removeEventListener('abort', onAbort);\n      unsubscribe();\n    }\n\n    if (!signal?.aborted) {\n      // Emit final data (Turn) if available before [DONE]\n      if (finalData !== undefined) {\n        writer.write(`data: ${JSON.stringify(finalData)}\\n\\n`);\n      }\n      writer.write('data: [DONE]\\n\\n');\n    }\n    writer.end();\n  } catch (error) {\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-RDC5GYST.js → chunk-N4LAFGLX.js}

@@ -1,15 +1,15 @@
+import {
+  webapi
+} from "./chunk-AC3VHSZJ.js";
 import {
   express
-} from "./chunk-O32SBS6S.js";
+} from "./chunk-XTWBAL42.js";
 import {
   h3
-} from "./chunk-KNBODIQU.js";
+} from "./chunk-DI47UY2H.js";
 import {
   fastify
-} from "./chunk-IDZR4ROP.js";
-import {
-  webapi
-} from "./chunk-5XPRVUOK.js";
+} from "./chunk-EHR3LIPS.js";
 
 // src/providers/proxy/server/index.ts
 var server = {
@@ -26,4 +26,4 @@ var server = {
 export {
   server
 };
-//# sourceMappingURL=chunk-RDC5GYST.js.map
+//# sourceMappingURL=chunk-N4LAFGLX.js.map

package/dist/{chunk-ZKNPQBIE.js → chunk-R3T2IYOU.js}

@@ -1,9 +1,11 @@
 import {
   AssistantMessage,
   ToolResultMessage,
-  UserMessage,
+  UserMessage
+} from "./chunk-6QCV4WXF.js";
+import {
   generateId
-} from "./chunk-WU4U6IHF.js";
+} from "./chunk-U2G5PHHL.js";
 
 // src/types/thread.ts
 var Thread = class _Thread {
@@ -262,4 +264,4 @@ var Thread = class _Thread {
 export {
   Thread
 };
-//# sourceMappingURL=chunk-ZKNPQBIE.js.map
+//# sourceMappingURL=chunk-R3T2IYOU.js.map

package/dist/{chunk-ZKNPQBIE.js.map → chunk-R3T2IYOU.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/types/thread.ts"],"sourcesContent":["/**\n * @fileoverview Thread class for managing conversation history.\n *\n * Provides a utility class for building and manipulating conversation\n * message sequences, with support for serialization and deserialization.\n *\n * @module types/thread\n */\n\nimport { generateId } from '../utils/id.ts';\nimport {\n  Message,\n  UserMessage,\n  AssistantMessage,\n  ToolResultMessage,\n  type MessageJSON,\n  type MessageType,\n} from './messages.ts';\nimport type { UserContent, AssistantContent } from './content.ts';\nimport type { Turn } from './turn.ts';\n\n/**\n * Thread serialized to JSON format.\n * Picks id from Thread, converts dates to strings.\n */\nexport type ThreadJSON = Pick<Thread, 'id'> & {\n  messages: MessageJSON[];\n  createdAt: string;\n  updatedAt: string;\n};\n\n/**\n * Thread - A utility class for managing conversation history.\n *\n * Provides methods for building, manipulating, and persisting\n * conversation message sequences. This class is optional; users\n * can also manage their own `Message[]` arrays directly.\n *\n * @example\n * ```typescript\n * // Create a new thread and add messages\n * const thread = new Thread();\n * thread.user('Hello!');\n * thread.assistant('Hi there! How can I help?');\n *\n * // Use with LLM inference\n * const turn = await instance.generate(thread, 'What is 2+2?');\n * thread.append(turn);\n *\n * // Serialize for storage\n * const json = thread.toJSON();\n * localStorage.setItem('chat', JSON.stringify(json));\n *\n * // Restore from storage\n * const restored = Thread.fromJSON(JSON.parse(localStorage.getItem('chat')));\n * ```\n */\nexport class Thread {\n  /** Unique thread identifier */\n  readonly id: string;\n\n  /** Internal message storage */\n  private _messages: Message[];\n\n  /** Creation timestamp */\n  private _createdAt: Date;\n\n  /** Last update timestamp */\n  private _updatedAt: Date;\n\n  /**\n   * Creates a new thread instance.\n   *\n   * @param messages - Optional initial messages to populate the thread\n   */\n  constructor(messages?: Message[]) {\n    this.id = generateId();\n    this._messages = messages ? [...messages] : [];\n    this._createdAt = new Date();\n    this._updatedAt = new Date();\n  }\n\n  /**\n   * All messages in the thread (readonly).\n   */\n  get messages(): readonly Message[] {\n    return this._messages;\n  }\n\n  /**\n   * Number of messages in the thread.\n   */\n  get length(): number {\n    return this._messages.length;\n  }\n\n  /**\n   * Appends all messages from a Turn to the thread.\n   *\n   * @param turn - The Turn containing messages to append\n   * @returns This thread instance for chaining\n   */\n  append(turn: Turn): this {\n    this._messages.push(...turn.messages);\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Adds raw messages to the thread.\n   *\n   * @param messages - Messages to add\n   * @returns This thread instance for chaining\n   */\n  push(...messages: Message[]): this {\n    this._messages.push(...messages);\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Adds a user message to the thread.\n   *\n   * @param content - String or array of content blocks\n   * @returns This thread instance for chaining\n   *\n   * @example\n   * ```typescript\n   * thread.user('Hello, world!');\n   * thread.user([\n   *   { type: 'text', text: 'Describe this image:' },\n   *   { type: 'image', source: { type: 'url', url: '...' }, mimeType: 'image/png' }\n   * ]);\n   * ```\n   */\n  user(content: string | UserContent[]): this {\n    this._messages.push(new UserMessage(content));\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Adds an assistant message to the thread.\n   *\n   * @param content - String or array of content blocks\n   * @returns This thread instance for chaining\n   *\n   * @example\n   * ```typescript\n   * thread.assistant('I can help with that!');\n   * ```\n   */\n  assistant(content: string | AssistantContent[]): this {\n    this._messages.push(new AssistantMessage(content));\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Filters messages by type.\n   *\n   * @param type - The message type to filter by\n   * @returns Array of messages matching the type\n   *\n   * @example\n   * ```typescript\n   * const userMessages = thread.filter('user');\n   * const assistantMessages = thread.filter('assistant');\n   * ```\n   */\n  filter(type: MessageType): Message[] {\n    return this._messages.filter((m) => m.type === type);\n  }\n\n  /**\n   * Returns the last N messages from the thread.\n   *\n   * @param count - Number of messages to return\n   * @returns Array of the last N messages\n   *\n   * @example\n   * ```typescript\n   * const recent = thread.tail(5);\n   * ```\n   */\n  tail(count: number): Message[] {\n    return this._messages.slice(-count);\n  }\n\n  /**\n   * Creates a new thread with a subset of messages.\n   *\n   * @param start - Start index (inclusive)\n   * @param end - End index (exclusive)\n   * @returns New Thread containing the sliced messages\n   *\n   * @example\n   * ```typescript\n   * const subset = thread.slice(0, 10);\n   * ```\n   */\n  slice(start?: number, end?: number): Thread {\n    return new Thread(this._messages.slice(start, end));\n  }\n\n  /**\n   * Removes all messages from the thread.\n   *\n   * @returns This thread instance for chaining\n   */\n  clear(): this {\n    this._messages = [];\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Converts the thread to a plain message array.\n   *\n   * @returns Copy of the internal message array\n   */\n  toMessages(): Message[] {\n    return [...this._messages];\n  }\n\n  /**\n   * Serializes the thread to JSON format.\n   *\n   * @returns JSON-serializable representation of the thread\n   *\n   * @example\n   * ```typescript\n   * const json = thread.toJSON();\n   * localStorage.setItem('thread', JSON.stringify(json));\n   * ```\n   */\n  toJSON(): ThreadJSON {\n    return {\n      id: this.id,\n      messages: this._messages.map((m) => this.messageToJSON(m)),\n      createdAt: this._createdAt.toISOString(),\n      updatedAt: this._updatedAt.toISOString(),\n    };\n  }\n\n  /**\n   * Deserializes a thread from JSON format.\n   *\n   * @param json - The JSON representation to deserialize\n   * @returns Reconstructed Thread instance\n   *\n   * @example\n   * ```typescript\n   * const json = JSON.parse(localStorage.getItem('thread'));\n   * const thread = Thread.fromJSON(json);\n   * ```\n   */\n  static fromJSON(json: ThreadJSON): Thread {\n    const messages = json.messages.map((m) => Thread.messageFromJSON(m));\n    const thread = new Thread(messages);\n    (thread as { id: string }).id = json.id;\n    thread._createdAt = new Date(json.createdAt);\n    thread._updatedAt = new Date(json.updatedAt);\n    return thread;\n  }\n\n  /**\n   * Enables iteration over messages with for...of loops.\n   *\n   * @returns Iterator over the thread's messages\n   *\n   * @example\n   * ```typescript\n   * for (const message of thread) {\n   *   console.log(message.text);\n   * }\n   * ```\n   */\n  [Symbol.iterator](): Iterator<Message> {\n    return this._messages[Symbol.iterator]();\n  }\n\n  /**\n   * Converts a message to JSON format.\n   */\n  private messageToJSON(m: Message): MessageJSON {\n    const base: MessageJSON = {\n      id: m.id,\n      type: m.type,\n      content: [],\n      metadata: m.metadata,\n      timestamp: m.timestamp.toISOString(),\n    };\n\n    if (m instanceof UserMessage) {\n      base.content = m.content;\n    } else if (m instanceof AssistantMessage) {\n      base.content = m.content;\n      base.toolCalls = m.toolCalls;\n    } else if (m instanceof ToolResultMessage) {\n      base.results = m.results;\n    }\n\n    return base;\n  }\n\n  /**\n   * Reconstructs a message from JSON format.\n   */\n  private static messageFromJSON(json: MessageJSON): Message {\n    const options = {\n      id: json.id,\n      metadata: json.metadata,\n      timestamp: new Date(json.timestamp),\n    };\n\n    switch (json.type) {\n      case 'user':\n        return new UserMessage(json.content as UserContent[], options);\n      case 'assistant':\n        return new AssistantMessage(\n          json.content as AssistantContent[],\n          json.toolCalls,\n          options\n        );\n      case 'tool_result':\n        return new ToolResultMessage(json.results ?? [], options);\n      default:\n        throw new Error(`Unknown message type: ${json.type}`);\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types/thread.ts"],"sourcesContent":["/**\n * @fileoverview Thread class for managing conversation history.\n *\n * Provides a utility class for building and manipulating conversation\n * message sequences, with support for serialization and deserialization.\n *\n * @module types/thread\n */\n\nimport { generateId } from '../utils/id.ts';\nimport {\n  Message,\n  UserMessage,\n  AssistantMessage,\n  ToolResultMessage,\n  type MessageJSON,\n  type MessageType,\n} from './messages.ts';\nimport type { UserContent, AssistantContent } from './content.ts';\nimport type { Turn } from './turn.ts';\n\n/**\n * Thread serialized to JSON format.\n * Picks id from Thread, converts dates to strings.\n */\nexport type ThreadJSON = Pick<Thread, 'id'> & {\n  messages: MessageJSON[];\n  createdAt: string;\n  updatedAt: string;\n};\n\n/**\n * Thread - A utility class for managing conversation history.\n *\n * Provides methods for building, manipulating, and persisting\n * conversation message sequences. This class is optional; users\n * can also manage their own `Message[]` arrays directly.\n *\n * @example\n * ```typescript\n * // Create a new thread and add messages\n * const thread = new Thread();\n * thread.user('Hello!');\n * thread.assistant('Hi there! How can I help?');\n *\n * // Use with LLM inference\n * const turn = await instance.generate(thread, 'What is 2+2?');\n * thread.append(turn);\n *\n * // Serialize for storage\n * const json = thread.toJSON();\n * localStorage.setItem('chat', JSON.stringify(json));\n *\n * // Restore from storage\n * const restored = Thread.fromJSON(JSON.parse(localStorage.getItem('chat')));\n * ```\n */\nexport class Thread {\n  /** Unique thread identifier */\n  readonly id: string;\n\n  /** Internal message storage */\n  private _messages: Message[];\n\n  /** Creation timestamp */\n  private _createdAt: Date;\n\n  /** Last update timestamp */\n  private _updatedAt: Date;\n\n  /**\n   * Creates a new thread instance.\n   *\n   * @param messages - Optional initial messages to populate the thread\n   */\n  constructor(messages?: Message[]) {\n    this.id = generateId();\n    this._messages = messages ? [...messages] : [];\n    this._createdAt = new Date();\n    this._updatedAt = new Date();\n  }\n\n  /**\n   * All messages in the thread (readonly).\n   */\n  get messages(): readonly Message[] {\n    return this._messages;\n  }\n\n  /**\n   * Number of messages in the thread.\n   */\n  get length(): number {\n    return this._messages.length;\n  }\n\n  /**\n   * Appends all messages from a Turn to the thread.\n   *\n   * @param turn - The Turn containing messages to append\n   * @returns This thread instance for chaining\n   */\n  append(turn: Turn): this {\n    this._messages.push(...turn.messages);\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Adds raw messages to the thread.\n   *\n   * @param messages - Messages to add\n   * @returns This thread instance for chaining\n   */\n  push(...messages: Message[]): this {\n    this._messages.push(...messages);\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Adds a user message to the thread.\n   *\n   * @param content - String or array of content blocks\n   * @returns This thread instance for chaining\n   *\n   * @example\n   * ```typescript\n   * thread.user('Hello, world!');\n   * thread.user([\n   *   { type: 'text', text: 'Describe this image:' },\n   *   { type: 'image', source: { type: 'url', url: '...' }, mimeType: 'image/png' }\n   * ]);\n   * ```\n   */\n  user(content: string | UserContent[]): this {\n    this._messages.push(new UserMessage(content));\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Adds an assistant message to the thread.\n   *\n   * @param content - String or array of content blocks\n   * @returns This thread instance for chaining\n   *\n   * @example\n   * ```typescript\n   * thread.assistant('I can help with that!');\n   * ```\n   */\n  assistant(content: string | AssistantContent[]): this {\n    this._messages.push(new AssistantMessage(content));\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Filters messages by type.\n   *\n   * @param type - The message type to filter by\n   * @returns Array of messages matching the type\n   *\n   * @example\n   * ```typescript\n   * const userMessages = thread.filter('user');\n   * const assistantMessages = thread.filter('assistant');\n   * ```\n   */\n  filter(type: MessageType): Message[] {\n    return this._messages.filter((m) => m.type === type);\n  }\n\n  /**\n   * Returns the last N messages from the thread.\n   *\n   * @param count - Number of messages to return\n   * @returns Array of the last N messages\n   *\n   * @example\n   * ```typescript\n   * const recent = thread.tail(5);\n   * ```\n   */\n  tail(count: number): Message[] {\n    return this._messages.slice(-count);\n  }\n\n  /**\n   * Creates a new thread with a subset of messages.\n   *\n   * @param start - Start index (inclusive)\n   * @param end - End index (exclusive)\n   * @returns New Thread containing the sliced messages\n   *\n   * @example\n   * ```typescript\n   * const subset = thread.slice(0, 10);\n   * ```\n   */\n  slice(start?: number, end?: number): Thread {\n    return new Thread(this._messages.slice(start, end));\n  }\n\n  /**\n   * Removes all messages from the thread.\n   *\n   * @returns This thread instance for chaining\n   */\n  clear(): this {\n    this._messages = [];\n    this._updatedAt = new Date();\n    return this;\n  }\n\n  /**\n   * Converts the thread to a plain message array.\n   *\n   * @returns Copy of the internal message array\n   */\n  toMessages(): Message[] {\n    return [...this._messages];\n  }\n\n  /**\n   * Serializes the thread to JSON format.\n   *\n   * @returns JSON-serializable representation of the thread\n   *\n   * @example\n   * ```typescript\n   * const json = thread.toJSON();\n   * localStorage.setItem('thread', JSON.stringify(json));\n   * ```\n   */\n  toJSON(): ThreadJSON {\n    return {\n      id: this.id,\n      messages: this._messages.map((m) => this.messageToJSON(m)),\n      createdAt: this._createdAt.toISOString(),\n      updatedAt: this._updatedAt.toISOString(),\n    };\n  }\n\n  /**\n   * Deserializes a thread from JSON format.\n   *\n   * @param json - The JSON representation to deserialize\n   * @returns Reconstructed Thread instance\n   *\n   * @example\n   * ```typescript\n   * const json = JSON.parse(localStorage.getItem('thread'));\n   * const thread = Thread.fromJSON(json);\n   * ```\n   */\n  static fromJSON(json: ThreadJSON): Thread {\n    const messages = json.messages.map((m) => Thread.messageFromJSON(m));\n    const thread = new Thread(messages);\n    (thread as { id: string }).id = json.id;\n    thread._createdAt = new Date(json.createdAt);\n    thread._updatedAt = new Date(json.updatedAt);\n    return thread;\n  }\n\n  /**\n   * Enables iteration over messages with for...of loops.\n   *\n   * @returns Iterator over the thread's messages\n   *\n   * @example\n   * ```typescript\n   * for (const message of thread) {\n   *   console.log(message.text);\n   * }\n   * ```\n   */\n  [Symbol.iterator](): Iterator<Message> {\n    return this._messages[Symbol.iterator]();\n  }\n\n  /**\n   * Converts a message to JSON format.\n   */\n  private messageToJSON(m: Message): MessageJSON {\n    const base: MessageJSON = {\n      id: m.id,\n      type: m.type,\n      content: [],\n      metadata: m.metadata,\n      timestamp: m.timestamp.toISOString(),\n    };\n\n    if (m instanceof UserMessage) {\n      base.content = m.content;\n    } else if (m instanceof AssistantMessage) {\n      base.content = m.content;\n      base.toolCalls = m.toolCalls;\n    } else if (m instanceof ToolResultMessage) {\n      base.results = m.results;\n    }\n\n    return base;\n  }\n\n  /**\n   * Reconstructs a message from JSON format.\n   */\n  private static messageFromJSON(json: MessageJSON): Message {\n    const options = {\n      id: json.id,\n      metadata: json.metadata,\n      timestamp: new Date(json.timestamp),\n    };\n\n    switch (json.type) {\n      case 'user':\n        return new UserMessage(json.content as UserContent[], options);\n      case 'assistant':\n        return new AssistantMessage(\n          json.content as AssistantContent[],\n          json.toolCalls,\n          options\n        );\n      case 'tool_result':\n        return new ToolResultMessage(json.results ?? [], options);\n      default:\n        throw new Error(`Unknown message type: ${json.type}`);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-U2G5PHHL.js

@@ -0,0 +1,25 @@
+// src/utils/id.ts
+function generateId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function generateShortId(prefix = "") {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let result = prefix;
+  for (let i = 0; i < 12; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length));
+  }
+  return result;
+}
+
+export {
+  generateId,
+  generateShortId
+};
+//# sourceMappingURL=chunk-U2G5PHHL.js.map

package/dist/chunk-U2G5PHHL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/id.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"],"mappings":";AAwBO,SAAS,aAAqB;AACnC,MAAI,OAAO,WAAW,eAAe,OAAO,YAAY;AACtD,WAAO,OAAO,WAAW;AAAA,EAC3B;AAEA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAoBO,SAAS,gBAAgB,SAAS,IAAY;AACnD,QAAM,QAAQ;AACd,MAAI,SAAS;AACb,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,cAAU,MAAM,OAAO,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,CAAC;AAAA,EACjE;AACA,SAAO;AACT;","names":[]}

package/dist/{chunk-SBGZJVTJ.js → chunk-VQZPADW6.js}

@@ -6,6 +6,82 @@ import {
   UPPError
 } from "./chunk-COS4ON4G.js";
 
+// src/http/retry.ts
+function isRetryable(error) {
+  return error.code === ErrorCode.RateLimited || error.code === ErrorCode.NetworkError || error.code === ErrorCode.Timeout || error.code === ErrorCode.ProviderError;
+}
+function exponentialBackoff(options = {}) {
+  const maxAttempts = options.maxAttempts ?? 3;
+  const baseDelay = options.baseDelay ?? 1e3;
+  const maxDelay = options.maxDelay ?? 3e4;
+  const jitter = options.jitter ?? true;
+  return () => ({
+    maxAttempts,
+    onRetry(error, attempt) {
+      if (attempt > maxAttempts) {
+        return null;
+      }
+      if (!isRetryable(error)) {
+        return null;
+      }
+      let delay = baseDelay * Math.pow(2, attempt - 1);
+      delay = Math.min(delay, maxDelay);
+      if (jitter) {
+        delay = delay * (0.5 + Math.random());
+      }
+      return Math.floor(delay);
+    }
+  });
+}
+function linearBackoff(options = {}) {
+  const maxAttempts = options.maxAttempts ?? 3;
+  const delay = options.delay ?? 1e3;
+  return () => ({
+    maxAttempts,
+    onRetry(error, attempt) {
+      if (attempt > maxAttempts) {
+        return null;
+      }
+      if (!isRetryable(error)) {
+        return null;
+      }
+      return delay * attempt;
+    }
+  });
+}
+function noRetry() {
+  return () => ({
+    maxAttempts: 0,
+    onRetry() {
+      return null;
+    }
+  });
+}
+function retryAfterStrategy(options = {}) {
+  const maxAttempts = options.maxAttempts ?? 3;
+  const fallbackDelay = options.fallbackDelay ?? 5e3;
+  return () => {
+    let lastRetryAfter;
+    return {
+      maxAttempts,
+      setRetryAfter(seconds) {
+        lastRetryAfter = seconds * 1e3;
+      },
+      onRetry(error, attempt) {
+        if (attempt > maxAttempts) {
+          return null;
+        }
+        if (error.code !== ErrorCode.RateLimited) {
+          return null;
+        }
+        const delay = lastRetryAfter ?? fallbackDelay;
+        lastRetryAfter = void 0;
+        return delay;
+      }
+    };
+  };
+}
+
 // src/http/errors.ts
 function statusToErrorCode(status) {
   switch (status) {
@@ -100,9 +176,6 @@ function warnInsecureUrl(url, provider) {
     );
   }
 }
-function hasFork(strategy) {
-  return !!strategy && typeof strategy.fork === "function";
-}
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -160,13 +233,12 @@ async function fetchWithTimeout(fetchFn, url, init, timeout, provider, modality)
 async function doFetch(url, init, config, provider, modality) {
   const fetchFn = config.fetch ?? fetch;
   const timeout = config.timeout ?? DEFAULT_TIMEOUT;
-  const baseStrategy = config.retryStrategy;
-  const strategy = hasFork(baseStrategy) ? baseStrategy.fork() : baseStrategy;
+  const strategy = (config.retryStrategy ?? noRetry())();
   warnInsecureUrl(url, provider);
   let attempt = 0;
   while (true) {
     attempt++;
-    if (strategy?.beforeRequest) {
+    if (strategy.beforeRequest) {
       const delay = await strategy.beforeRequest();
       if (delay > 0) {
         await sleep(delay);
@@ -184,22 +256,18 @@ async function doFetch(url, init, config, provider, modality) {
       );
     } catch (error) {
       if (error instanceof UPPError) {
-        if (strategy) {
-          const delay = await strategy.onRetry(error, attempt);
-          if (delay !== null) {
-            await sleep(delay);
-            continue;
-          }
+        const delay2 = await strategy.onRetry(error, attempt);
+        if (delay2 !== null) {
+          await sleep(delay2);
+          continue;
         }
         throw error;
       }
       const uppError = networkError(toError(error), provider, modality);
-      if (strategy) {
-        const delay = await strategy.onRetry(uppError, attempt);
-        if (delay !== null) {
-          await sleep(delay);
-          continue;
-        }
+      const delay = await strategy.onRetry(uppError, attempt);
+      if (delay !== null) {
+        await sleep(delay);
+        continue;
       }
       throw uppError;
     }
@@ -209,30 +277,25 @@ async function doFetch(url, init, config, provider, modality) {
         response.headers.get("Retry-After"),
         config.retryAfterMaxSeconds ?? MAX_RETRY_AFTER_SECONDS
       );
-      if (retryAfterSeconds !== null && strategy && "setRetryAfter" in strategy) {
-        strategy.setRetryAfter(
-          retryAfterSeconds
-        );
+      if (retryAfterSeconds !== null && strategy.setRetryAfter) {
+        strategy.setRetryAfter(retryAfterSeconds);
       }
-      if (strategy) {
-        const delay = await strategy.onRetry(error, attempt);
-        if (delay !== null) {
-          await sleep(delay);
-          continue;
-        }
+      const delay = await strategy.onRetry(error, attempt);
+      if (delay !== null) {
+        await sleep(delay);
+        continue;
       }
       throw error;
     }
-    strategy?.reset?.();
+    strategy.reset?.();
     return response;
   }
 }
 async function doStreamFetch(url, init, config, provider, modality) {
   const fetchFn = config.fetch ?? fetch;
   const timeout = config.timeout ?? DEFAULT_TIMEOUT;
-  const baseStrategy = config.retryStrategy;
-  const strategy = hasFork(baseStrategy) ? baseStrategy.fork() : baseStrategy;
-  if (strategy?.beforeRequest) {
+  const strategy = (config.retryStrategy ?? noRetry())();
+  if (strategy.beforeRequest) {
     const delay = await strategy.beforeRequest();
     if (delay > 0) {
       await sleep(delay);
@@ -257,6 +320,10 @@ async function doStreamFetch(url, init, config, provider, modality) {
 }
 
 export {
+  exponentialBackoff,
+  linearBackoff,
+  noRetry,
+  retryAfterStrategy,
   statusToErrorCode,
   normalizeHttpError,
   networkError,
@@ -266,4 +333,4 @@ export {
   doFetch,
   doStreamFetch
 };
-//# sourceMappingURL=chunk-SBGZJVTJ.js.map
+//# sourceMappingURL=chunk-VQZPADW6.js.map