@agentskit/adapters 0.12.0 → 0.13.0

package/dist/utils-ddwu4MN4.d.cts

@@ -0,0 +1,66 @@
+import { StreamSource } from '@agentskit/core';
+
+/**
+ * Retry knobs for adapter fetches. Tunable per call to createStreamSource.
+ *
+ * Default behavior:
+ *   - 3 attempts total (1 initial + 2 retries)
+ *   - exponential backoff: 500ms, 1000ms, 2000ms ... (capped at maxDelayMs)
+ *   - full jitter on each delay
+ *   - retry on HTTP 408, 429, 500, 502, 503, 504
+ *   - retry on network errors (fetch throws)
+ *   - DO NOT retry on 4xx other than 408/429 (those are bad requests / auth)
+ *   - retries only the initial fetch — never mid-stream
+ *   - respects Retry-After header when present
+ */
+interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: boolean;
+    retryOn?: (info: {
+        error?: unknown;
+        response?: Response;
+        attempt: number;
+    }) => boolean;
+    /** Hook for tests + logging. Called after every failed attempt. */
+    onRetry?: (info: {
+        attempt: number;
+        delayMs: number;
+        reason: string;
+    }) => void;
+    /** Sleep override for tests. Defaults to setTimeout. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Run a fetch with retries on transient failures. Returns the final
+ * Response (whether successful or not — caller decides), or throws if
+ * the AbortSignal fires or all attempts fail with a thrown error.
+ */
+declare function fetchWithRetry(doFetch: (signal: AbortSignal) => Promise<Response>, signal: AbortSignal, retryOpt?: RetryOptions): Promise<Response>;
+/**
+ * Chunk-splitter that turns one large string into N streamable text chunks.
+ * Useful when a provider returns the full response in one shot and you
+ * want to feed it to a UI that expects streaming.
+ *
+ * Default splits by whitespace boundaries with a target chunk size of ~32
+ * characters.
+ */
+declare function chunkText(text: string, targetSize?: number): string[];
+/**
+ * Build a StreamSource from a non-streaming fetch. The adapter is
+ * auto-completing: it fetches once, then yields the text as a sequence
+ * of chunks so UIs see the same streaming shape they'd see from a
+ * native streaming provider.
+ *
+ * Use this when you're wiring a provider that only has a non-streaming
+ * endpoint but you want consumers (useChat, the runtime) to get
+ * identical ergonomics.
+ */
+declare function simulateStream(doFetch: (signal: AbortSignal) => Promise<Response>, extractText: (response: Response) => Promise<string>, errorLabel: string, options?: {
+    chunkSize?: number;
+    delayMs?: number;
+    retry?: RetryOptions;
+}): StreamSource;
+
+export { type RetryOptions as R, chunkText as c, fetchWithRetry as f, simulateStream as s };

package/dist/utils-ddwu4MN4.d.ts

@@ -0,0 +1,66 @@
+import { StreamSource } from '@agentskit/core';
+
+/**
+ * Retry knobs for adapter fetches. Tunable per call to createStreamSource.
+ *
+ * Default behavior:
+ *   - 3 attempts total (1 initial + 2 retries)
+ *   - exponential backoff: 500ms, 1000ms, 2000ms ... (capped at maxDelayMs)
+ *   - full jitter on each delay
+ *   - retry on HTTP 408, 429, 500, 502, 503, 504
+ *   - retry on network errors (fetch throws)
+ *   - DO NOT retry on 4xx other than 408/429 (those are bad requests / auth)
+ *   - retries only the initial fetch — never mid-stream
+ *   - respects Retry-After header when present
+ */
+interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: boolean;
+    retryOn?: (info: {
+        error?: unknown;
+        response?: Response;
+        attempt: number;
+    }) => boolean;
+    /** Hook for tests + logging. Called after every failed attempt. */
+    onRetry?: (info: {
+        attempt: number;
+        delayMs: number;
+        reason: string;
+    }) => void;
+    /** Sleep override for tests. Defaults to setTimeout. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Run a fetch with retries on transient failures. Returns the final
+ * Response (whether successful or not — caller decides), or throws if
+ * the AbortSignal fires or all attempts fail with a thrown error.
+ */
+declare function fetchWithRetry(doFetch: (signal: AbortSignal) => Promise<Response>, signal: AbortSignal, retryOpt?: RetryOptions): Promise<Response>;
+/**
+ * Chunk-splitter that turns one large string into N streamable text chunks.
+ * Useful when a provider returns the full response in one shot and you
+ * want to feed it to a UI that expects streaming.
+ *
+ * Default splits by whitespace boundaries with a target chunk size of ~32
+ * characters.
+ */
+declare function chunkText(text: string, targetSize?: number): string[];
+/**
+ * Build a StreamSource from a non-streaming fetch. The adapter is
+ * auto-completing: it fetches once, then yields the text as a sequence
+ * of chunks so UIs see the same streaming shape they'd see from a
+ * native streaming provider.
+ *
+ * Use this when you're wiring a provider that only has a non-streaming
+ * endpoint but you want consumers (useChat, the runtime) to get
+ * identical ergonomics.
+ */
+declare function simulateStream(doFetch: (signal: AbortSignal) => Promise<Response>, extractText: (response: Response) => Promise<string>, errorLabel: string, options?: {
+    chunkSize?: number;
+    delayMs?: number;
+    retry?: RetryOptions;
+}): StreamSource;
+
+export { type RetryOptions as R, chunkText as c, fetchWithRetry as f, simulateStream as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/adapters",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Provider adapters for AgentsKit.",
   "keywords": [
     "agentskit",
@@ -25,6 +25,7 @@
     "provider-adapter"
   ],
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -33,20 +34,32 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./createAdapter": {
+      "types": "./dist/createAdapter.d.ts",
+      "import": "./dist/createAdapter.js",
+      "require": "./dist/createAdapter.cjs"
+    },
+    "./catalog": {
+      "types": "./dist/catalog/index.d.ts",
+      "import": "./dist/catalog/index.js",
+      "require": "./dist/catalog/index.cjs"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@agentskit/core": "1.7.1"
+    "@agentskit/core": "1.8.0"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
-    "msw": "^2.14.2",
-    "tsup": "^8.5.0",
+    "@types/json-schema": "^7.0.15",
+    "@types/node": "^25.9.2",
+    "msw": "^2.14.6",
+    "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.8",
+    "@agentskit/validation": "0.2.0"
   },
   "peerDependencies": {
     "@aws-sdk/client-bedrock-runtime": "^3.0.0"