@arizeai/phoenix-client 6.12.1 → 6.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-client",
-  "version": "6.12.1",
+  "version": "6.13.0",
   "description": "A client for the Phoenix API",
   "keywords": [
     "arize",
@@ -101,24 +101,24 @@
     "openapi-fetch": "^0.17.0",
     "tiny-invariant": "^1.3.3",
     "zod": "^4.4.3",
-    "@arizeai/phoenix-config": "0.2.0",
-    "@arizeai/phoenix-otel": "1.1.0"
+    "@arizeai/phoenix-otel": "1.2.0",
+    "@arizeai/phoenix-config": "0.4.0"
   },
   "devDependencies": {
-    "@ai-sdk/openai": "^3.0.80",
-    "@anthropic-ai/sdk": "^0.102.0",
+    "@ai-sdk/openai": "^3.0.83",
+    "@anthropic-ai/sdk": "^0.111.0",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-trace-node": "^2.9.0",
     "@types/async": "^3.2.25",
-    "@types/node": "^25.9.4",
-    "ai": "^6.0.219",
-    "dotenv": "^16.6.1",
-    "jest": "^29.7.0",
-    "openai": "^6.45.0",
+    "@types/node": "^26.1.1",
+    "ai": "^6.0.222",
+    "dotenv": "^17.4.2",
+    "jest": "^30.4.2",
+    "openai": "^6.46.0",
     "openapi-typescript": "^7.13.0",
-    "tsx": "^4.22.5",
-    "vitest": "^4.1.9",
-    "@arizeai/phoenix-evals": "1.1.0"
+    "tsx": "^4.23.0",
+    "vitest": "^4.1.10",
+    "@arizeai/phoenix-evals": "1.2.0"
   },
   "peerDependencies": {
     "@anthropic-ai/sdk": "^0.35.0",

package/src/__generated__/api/v1.ts

@@ -1679,9 +1679,15 @@ export interface components {
          * @description Wire schema for the chat stream's `message_metadata` payload.
          */
         AssistantMessageMetadata: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "assistant";
             /** Sessionid */
             sessionId: string;
             trace?: components["schemas"]["AssistantMessageMetadataTraceIds"] | null;
+            turnTraceContext?: components["schemas"]["TurnTraceContext"] | null;
             usage?: components["schemas"]["AssistantMessageMetadataUsage"] | null;
         };
         /** AssistantMessageMetadataTraceIds */
@@ -1712,22 +1718,6 @@ export interface components {
             /** Total */
             total: number;
         };
-        /**
-         * AssistantMetadataUIMessage
-         * @description `UIMessage` with `metadata` narrowed to `AssistantMessageMetadata`.
-         */
-        AssistantMetadataUIMessage: {
-            /** Id */
-            id: string;
-            /**
-             * Role
-             * @enum {string}
-             */
-            role: "system" | "user" | "assistant";
-            metadata?: components["schemas"]["AssistantMessageMetadata"] | null;
-            /** Parts */
-            parts: (components["schemas"]["TextUIPart"] | components["schemas"]["ReasoningUIPart"] | components["schemas"]["ToolInputStreamingPart"] | components["schemas"]["ToolInputAvailablePart"] | components["schemas"]["ToolOutputAvailablePart"] | components["schemas"]["ToolOutputErrorPart"] | components["schemas"]["ToolApprovalRequestedPart"] | components["schemas"]["ToolApprovalRespondedPart"] | components["schemas"]["ToolOutputDeniedPart"] | components["schemas"]["DynamicToolInputStreamingPart"] | components["schemas"]["DynamicToolInputAvailablePart"] | components["schemas"]["DynamicToolOutputAvailablePart"] | components["schemas"]["DynamicToolOutputErrorPart"] | components["schemas"]["DynamicToolApprovalRequestedPart"] | components["schemas"]["DynamicToolApprovalRespondedPart"] | components["schemas"]["DynamicToolOutputDeniedPart"] | components["schemas"]["SourceUrlUIPart"] | components["schemas"]["SourceDocumentUIPart"] | components["schemas"]["FileUIPart"] | components["schemas"]["DataUIPart"] | components["schemas"]["StepStartUIPart"])[];
-        };
         /**
          * BuiltInProviderModelSelection
          * @description Chat against a Phoenix built-in provider.
@@ -1810,7 +1800,7 @@ export interface components {
             /** Id */
             id: string;
             /** Messages */
-            messages: components["schemas"]["AssistantMetadataUIMessage"][];
+            messages: components["schemas"]["PhoenixUIMessage"][];
             /** Messageid */
             messageId?: string | null;
             /**
@@ -1844,6 +1834,7 @@ export interface components {
             requestedSkills?: string[];
             /** Model */
             model: components["schemas"]["CustomProviderModelSelection"] | components["schemas"]["BuiltInProviderModelSelection"];
+            turnTraceContext?: components["schemas"]["TurnTraceContext"] | null;
         } & {
             [key: string]: unknown;
         };
@@ -1865,7 +1856,7 @@ export interface components {
             /** Id */
             id: string;
             /** Messages */
-            messages: components["schemas"]["AssistantMetadataUIMessage"][];
+            messages: components["schemas"]["PhoenixUIMessage"][];
             /**
              * Ingesttraces
              * @default false
@@ -1897,6 +1888,7 @@ export interface components {
             requestedSkills?: string[];
             /** Model */
             model: components["schemas"]["CustomProviderModelSelection"] | components["schemas"]["BuiltInProviderModelSelection"];
+            turnTraceContext?: components["schemas"]["TurnTraceContext"] | null;
         } & {
             [key: string]: unknown;
         };
@@ -3404,6 +3396,23 @@ export interface components {
              */
             message?: string | null;
         };
+        /**
+         * PhoenixUIMessage
+         * @description `UIMessage` with `metadata` narrowed to the Phoenix wire shapes.
+         */
+        PhoenixUIMessage: {
+            /** Id */
+            id: string;
+            /**
+             * Role
+             * @enum {string}
+             */
+            role: "system" | "user" | "assistant";
+            /** Metadata */
+            metadata?: (components["schemas"]["AssistantMessageMetadata"] | components["schemas"]["UserMessageMetadata"]) | null;
+            /** Parts */
+            parts: (components["schemas"]["TextUIPart"] | components["schemas"]["ReasoningUIPart"] | components["schemas"]["ToolInputStreamingPart"] | components["schemas"]["ToolInputAvailablePart"] | components["schemas"]["ToolOutputAvailablePart"] | components["schemas"]["ToolOutputErrorPart"] | components["schemas"]["ToolApprovalRequestedPart"] | components["schemas"]["ToolApprovalRespondedPart"] | components["schemas"]["ToolOutputDeniedPart"] | components["schemas"]["DynamicToolInputStreamingPart"] | components["schemas"]["DynamicToolInputAvailablePart"] | components["schemas"]["DynamicToolOutputAvailablePart"] | components["schemas"]["DynamicToolOutputErrorPart"] | components["schemas"]["DynamicToolApprovalRequestedPart"] | components["schemas"]["DynamicToolApprovalRespondedPart"] | components["schemas"]["DynamicToolOutputDeniedPart"] | components["schemas"]["SourceUrlUIPart"] | components["schemas"]["SourceDocumentUIPart"] | components["schemas"]["FileUIPart"] | components["schemas"]["DataUIPart"] | components["schemas"]["StepStartUIPart"])[];
+        };
         /**
          * PlaygroundBuiltinModelContext
          * @description Built-in playground model selection.
@@ -5464,6 +5473,18 @@ export interface components {
              */
             end_time: string;
         };
+        /** TurnTraceContext */
+        TurnTraceContext: {
+            /** Traceid */
+            traceId: string;
+            /** Rootspanid */
+            rootSpanId: string;
+            /**
+             * Startedat
+             * Format: date-time
+             */
+            startedAt: string;
+        };
         /**
          * UIMessage
          * @description A message as displayed in the UI by Vercel AI Elements.
@@ -5644,6 +5665,21 @@ export interface components {
             /** Deleted Keys */
             deleted_keys: string[];
         };
+        /**
+         * UserMessageMetadata
+         * @description Wire schema for metadata the browser attaches to outgoing user messages.
+         */
+        UserMessageMetadata: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "user";
+            /** Currentdatetime */
+            currentDateTime: string;
+            /** Timezone */
+            timeZone: string;
+        };
         /** ValidationError */
         ValidationError: {
             /** Location */
@@ -5704,6 +5740,34 @@ export interface components {
             /** Summary */
             summary: string;
         };
+        /**
+         * ToolCallCallbackProviderMetadata
+         * @description Shape of the ``phoenix`` namespace the browser returns in
+         *     ``callProviderMetadata`` on resolved tool parts: the server-stamped fields
+         *     plus browser-recorded execution timings.
+         */
+        ToolCallCallbackProviderMetadata: {
+            /**
+             * Tool Execution Environment
+             * @enum {string}
+             */
+            tool_execution_environment: "client" | "server";
+            /**
+             * Tool Input Emitted At
+             * @default null
+             */
+            tool_input_emitted_at?: string | null;
+            /**
+             * Client Started At
+             * @default null
+             */
+            client_started_at?: string | null;
+            /**
+             * Client Ended At
+             * @default null
+             */
+            client_ended_at?: string | null;
+        };
         /**
          * ToolCallProviderMetadata
          * @description Payload Phoenix stamps under the ``phoenix`` namespace of Vercel AI
@@ -5716,6 +5780,11 @@ export interface components {
              * @enum {string}
              */
             tool_execution_environment: "client" | "server";
+            /**
+             * Tool Input Emitted At
+             * @default null
+             */
+            tool_input_emitted_at?: string | null;
         };
     };
     responses: never;

package/src/client.ts

@@ -12,6 +12,7 @@ import {
   defaultGetEnvironmentOptions,
   makeDefaultClientOptions,
 } from "./config";
+import { HttpError } from "./errors";
 import type { SemanticVersion } from "./types/semver";
 import { parseSemanticVersion } from "./utils/semverUtils";
 
@@ -66,10 +67,7 @@ export const getMergedOptions = ({
 const middleware: Middleware = {
   onResponse({ response }) {
     if (!response.ok) {
-      // Will produce error messages like "https://example.org/api/v1/example: 404 Not Found".
-      throw new Error(
-        `${response.url}: ${response.status} ${response.statusText}`
-      );
+      throw new HttpError(response);
     }
   },
 };

package/src/errors.ts

@@ -0,0 +1,20 @@
+/**
+ * Thrown when Phoenix answers a request with a non-2xx status.
+ *
+ * `status` is on the error so callers can branch on it: a status is frequently
+ * a legitimate answer rather than a bug — a 401 from an unauthenticated probe,
+ * for instance, is how a caller learns that auth is enabled on the deployment.
+ */
+export class HttpError extends Error {
+  readonly status: number;
+  readonly statusText: string;
+  readonly url: string;
+
+  constructor(response: Response) {
+    super(`${response.url}: ${response.status} ${response.statusText}`);
+    this.name = "HttpError";
+    this.status = response.status;
+    this.statusText = response.statusText;
+    this.url = response.url;
+  }
+}

package/src/index.ts

@@ -1 +1,2 @@
 export * from "./client";
+export * from "./errors";