@arizeai/phoenix-client 6.12.2 → 6.14.0

package/README.md

@@ -63,6 +63,31 @@ const phoenix = createClient({
 });
 ```
 
+For credentials that can expire, create an authenticated fetch implementation
+and pass it to the client. The token provider controls storage and refresh-token
+rotation. Requests that receive a `401` share one refresh operation and are
+retried once.
+
+```ts
+import { createAuthFetch, createClient } from "@arizeai/phoenix-client";
+
+const authFetch = createAuthFetch({
+  getAccessToken: async ({ forceRefresh }) => {
+    if (forceRefresh) {
+      await refreshAndPersistTokens();
+    }
+    return loadTokens().accessToken;
+  },
+});
+
+const phoenix = createClient({
+  options: {
+    baseUrl: "http://localhost:6006",
+    fetch: authFetch,
+  },
+});
+```
+
 ## Prompts
 
 `@arizeai/phoenix-client` provides a `prompts` export that exposes utilities for working with prompts for LLMs.
@@ -128,6 +153,8 @@ The following LLM provider SDKs are supported:
 - OpenAI: `openai` [openai](https://www.npmjs.com/package/openai)
 - Anthropic: `anthropic` [@anthropic-ai/sdk](https://www.npmjs.com/package/@anthropic-ai/sdk)
 
+> **Note:** These provider SDKs are optional peer dependencies — installing `@arizeai/phoenix-client` does not pull them in. Install the one you convert to yourself, e.g. `npm install ai`, `npm install openai`, or `npm install @anthropic-ai/sdk`. Calling `toSDK({ sdk: "ai" | "openai" | "anthropic" })` without the matching SDK installed fails at runtime.
+
 ```ts
 import { generateText } from "ai";
 import { openai } from "@ai-sdk/openai";