@arizeai/phoenix-client 5.8.2 → 6.0.0

package/package.json

@@ -1,7 +1,32 @@
 {
   "name": "@arizeai/phoenix-client",
-  "version": "5.8.2",
+  "version": "6.0.0",
   "description": "A client for the Phoenix API",
+  "keywords": [
+    "arize",
+    "datasets",
+    "evaluation",
+    "experiments",
+    "llm",
+    "phoenix",
+    "prompts",
+    "tracing"
+  ],
+  "homepage": "https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-client",
+  "bugs": {
+    "url": "https://github.com/Arize-ai/phoenix/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "oss@arize.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Arize-ai/phoenix.git"
+  },
+  "files": [
+    "dist",
+    "src",
+    "package.json"
+  ],
   "main": "dist/src/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/src/index.d.ts",
@@ -39,71 +64,44 @@
       "require": "./dist/src/types/*.d.ts"
     }
   },
-  "files": [
-    "dist",
-    "src",
-    "package.json"
-  ],
-  "keywords": [
-    "phoenix",
-    "arize",
-    "llm",
-    "tracing",
-    "evaluation",
-    "prompts",
-    "datasets",
-    "experiments"
-  ],
-  "author": "oss@arize.com",
-  "license": "Apache-2.0",
-  "homepage": "https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-client",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Arize-ai/phoenix.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Arize-ai/phoenix/issues"
+  "dependencies": {
+    "@arizeai/openinference-semantic-conventions": "^1.1.0",
+    "@arizeai/openinference-vercel": "^2.7.0",
+    "async": "^3.2.6",
+    "openapi-fetch": "^0.12.5",
+    "tiny-invariant": "^1.3.3",
+    "zod": "^4.0.14",
+    "@arizeai/phoenix-config": "0.1.1",
+    "@arizeai/phoenix-otel": "0.4.2"
   },
   "devDependencies": {
-    "@ai-sdk/openai": "^2.0.27",
+    "@ai-sdk/openai": "^3.0.29",
     "@anthropic-ai/sdk": "^0.35.0",
     "@types/async": "^3.2.24",
     "@types/node": "^20.17.22",
-    "ai": "^5.0.38",
+    "ai": "^6.0.90",
     "openai": "^6.10.0",
     "openapi-typescript": "^7.6.1",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
     "vitest": "^4.0.10",
-    "@arizeai/phoenix-evals": "0.9.0"
-  },
-  "dependencies": {
-    "@arizeai/openinference-semantic-conventions": "^1.1.0",
-    "@arizeai/openinference-vercel": "^2.7.0",
-    "async": "^3.2.6",
-    "openapi-fetch": "^0.12.5",
-    "tiny-invariant": "^1.3.3",
-    "zod": "^3.24.3",
-    "zod-to-json-schema": "^3.24.3",
-    "@arizeai/phoenix-otel": "0.4.1",
-    "@arizeai/phoenix-config": "0.1.0"
-  },
-  "engines": {
-    "node": ">=18"
+    "@arizeai/phoenix-evals": "1.0.0"
   },
   "optionalDependencies": {
     "@anthropic-ai/sdk": "^0.35.0",
-    "ai": "^5.0.76",
+    "ai": "^6.0.90",
     "openai": "^6.10.0"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
+    "build": "tsc --build tsconfig.json tsconfig.esm.json && tsc-alias -p tsconfig.esm.json",
     "clean": "rimraf dist",
-    "prebuild": "pnpm run clean && pnpm run generate",
     "generate": "openapi-typescript --empty-objects-unknown=true --default-non-nullable=false ../../../schemas/openapi.json -o ./src/__generated__/api/v1.ts",
-    "build": "tsc --build tsconfig.json tsconfig.esm.json && tsc-alias -p tsconfig.esm.json",
     "postbuild": "echo '{\"type\": \"module\"}' > ./dist/esm/package.json",
-    "type:check": "tsc --noEmit",
+    "prebuild": "pnpm run clean && pnpm run generate",
     "test": "vitest run",
-    "test:watch": "vitest watch"
+    "test:watch": "vitest watch",
+    "typecheck": "tsc --noEmit"
   }
 }

package/src/__generated__/api/v1.ts

@@ -776,6 +776,40 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/sessions/{session_identifier}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get session by ID or session_id */
+        get: operations["getSession"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/projects/{project_identifier}/sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List sessions for a project */
+        get: operations["listProjectSessions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/session_annotations": {
         parameters: {
             query?: never;
@@ -1481,6 +1515,17 @@ export interface components {
             /** Next Cursor */
             next_cursor: string | null;
         };
+        /** GetSessionResponseBody */
+        GetSessionResponseBody: {
+            data: components["schemas"]["SessionData"];
+        };
+        /** GetSessionsResponseBody */
+        GetSessionsResponseBody: {
+            /** Data */
+            data: components["schemas"]["SessionData"][];
+            /** Next Cursor */
+            next_cursor: string | null;
+        };
         /** GetUsersResponseBody */
         GetUsersResponseBody: {
             /** Data */
@@ -2515,6 +2560,44 @@ export interface components {
             /** Next Cursor */
             next_cursor: string | null;
         };
+        /** SessionData */
+        SessionData: {
+            /** Id */
+            id: string;
+            /** Session Id */
+            session_id: string;
+            /** Project Id */
+            project_id: string;
+            /**
+             * Start Time
+             * Format: date-time
+             */
+            start_time: string;
+            /**
+             * End Time
+             * Format: date-time
+             */
+            end_time: string;
+            /** Traces */
+            traces: components["schemas"]["SessionTraceData"][];
+        };
+        /** SessionTraceData */
+        SessionTraceData: {
+            /** Id */
+            id: string;
+            /** Trace Id */
+            trace_id: string;
+            /**
+             * Start Time
+             * Format: date-time
+             */
+            start_time: string;
+            /**
+             * End Time
+             * Format: date-time
+             */
+            end_time: string;
+        };
         /** Span */
         Span: {
             /**
@@ -4015,7 +4098,10 @@ export interface operations {
     };
     deleteExperiment: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description If true, also delete the project associated with the experiment that contains traces and spans for the experiment tasks. */
+                delete_project?: boolean;
+            };
             header?: never;
             path: {
                 experiment_id: string;
@@ -5615,6 +5701,113 @@ export interface operations {
             };
         };
     };
+    getSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The session identifier: either a GlobalID or user-provided session_id string. */
+                session_identifier: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetSessionResponseBody"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    listProjectSessions: {
+        parameters: {
+            query?: {
+                /** @description Cursor for pagination (session ID) */
+                cursor?: string | null;
+                /** @description The max number of sessions to return at a time. */
+                limit?: number;
+                /** @description Sort order by ID: 'asc' (ascending) or 'desc' (descending). */
+                order?: "asc" | "desc";
+            };
+            header?: never;
+            path: {
+                /** @description The project identifier: either project ID or project name. */
+                project_identifier: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetSessionsResponseBody"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
     annotateSessions: {
         parameters: {
             query?: {

package/src/client.ts

@@ -1,3 +1,8 @@
+import createOpenApiClient, {
+  type ClientOptions,
+  type Middleware,
+} from "openapi-fetch";
+
 import type {
   components as oapiComponentsV1,
   operations as oapiOperationsV1,
@@ -8,11 +13,6 @@ import {
   makeDefaultClientOptions,
 } from "./config";
 
-import createOpenApiClient, {
-  type ClientOptions,
-  type Middleware,
-} from "openapi-fetch";
-
 export type pathsV1 = oapiPathsV1;
 export type componentsV1 = oapiComponentsV1;
 export type operationsV1 = oapiOperationsV1;

package/src/config.ts

@@ -1,9 +1,8 @@
+import type { EnvironmentConfig } from "@arizeai/phoenix-config";
 import {
   DEFAULT_PHOENIX_BASE_URL,
-  EnvironmentConfig,
   getEnvironmentConfig,
 } from "@arizeai/phoenix-config";
-
 import type { ClientOptions } from "openapi-fetch";
 
 /**

package/src/datasets/appendDatasetExamples.ts

@@ -1,11 +1,10 @@
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { DatasetSelector, Example } from "../types/datasets";
+import invariant from "tiny-invariant";
 
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { DatasetSelector, Example } from "../types/datasets";
 import { getDatasetInfo } from "./getDatasetInfo";
 
-import invariant from "tiny-invariant";
-
 export type AppendDatasetExamplesParams = ClientFn & {
   /**
    * The dataset to append examples to

package/src/datasets/createDataset.ts

@@ -1,9 +1,9 @@
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { Example } from "../types/datasets";
-
 import invariant from "tiny-invariant";
 
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { Example } from "../types/datasets";
+
 export type CreateDatasetParams = ClientFn & {
   /**
    * The name of the dataset

package/src/datasets/createOrGetDataset.ts

@@ -1,6 +1,6 @@
 import { createClient } from "../client";
-
-import { createDataset, CreateDatasetParams } from "./createDataset";
+import type { CreateDatasetParams } from "./createDataset";
+import { createDataset } from "./createDataset";
 import { getDatasetInfoByName } from "./getDatasetInfoByName";
 
 export type CreateOrGetDatasetParams = CreateDatasetParams;

package/src/datasets/getDataset.ts

@@ -1,7 +1,6 @@
 import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { Dataset, DatasetSelector } from "../types/datasets";
-
+import type { ClientFn } from "../types/core";
+import type { Dataset, DatasetSelector } from "../types/datasets";
 import { getDatasetExamples } from "./getDatasetExamples";
 import { getDatasetInfo } from "./getDatasetInfo";
 

package/src/datasets/getDatasetExamples.ts

@@ -1,11 +1,10 @@
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { DatasetExamples, DatasetSelector } from "../types/datasets";
+import invariant from "tiny-invariant";
 
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { DatasetExamples, DatasetSelector } from "../types/datasets";
 import { getDatasetInfoByName } from "./getDatasetInfoByName";
 
-import invariant from "tiny-invariant";
-
 export type GetDatasetExamplesParams = ClientFn & {
   /** Dataset selector (ID, name, or version ID) */
   dataset: DatasetSelector;

package/src/datasets/getDatasetInfo.ts

@@ -1,11 +1,10 @@
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { DatasetInfo, DatasetSelector } from "../types/datasets";
+import invariant from "tiny-invariant";
 
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { DatasetInfo, DatasetSelector } from "../types/datasets";
 import { getDatasetInfoByName } from "./getDatasetInfoByName";
 
-import invariant from "tiny-invariant";
-
 export type GetDatasetInfoParams = ClientFn & {
   dataset: DatasetSelector;
 };

package/src/datasets/getDatasetInfoByName.ts

@@ -1,6 +1,6 @@
 import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { DatasetInfo } from "../types/datasets";
+import type { ClientFn } from "../types/core";
+import type { DatasetInfo } from "../types/datasets";
 
 export type GetDatasetParams = ClientFn & {
   datasetName: string;

package/src/datasets/listDatasets.ts

@@ -1,9 +1,9 @@
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { DatasetInfo } from "../types/datasets";
-
 import invariant from "tiny-invariant";
 
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { DatasetInfo } from "../types/datasets";
+
 export type ListDatasetsParams = ClientFn;
 
 export type FullDatasetInfo = DatasetInfo & {

package/src/experiments/createExperiment.ts

@@ -1,9 +1,9 @@
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { ExperimentInfo } from "../types/experiments";
-
 import invariant from "tiny-invariant";
 
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { ExperimentInfo } from "../types/experiments";
+
 export type CreateExperimentParams = ClientFn & {
   /**
    * The dataset ID to create the experiment for

package/src/experiments/deleteExperiment.ts

@@ -1,5 +1,5 @@
 import { createClient } from "../client";
-import { ClientFn } from "../types/core";
+import type { ClientFn } from "../types/core";
 import { ensureString } from "../utils/ensureString";
 
 /**
@@ -10,6 +10,11 @@ export interface DeleteExperimentParams extends ClientFn {
    * The ID of the experiment to delete
    */
   experimentId: string;
+  /**
+   * If true, also delete the project associated with the experiment.
+   * Defaults to false.
+   */
+  deleteProject?: boolean;
 }
 
 /**
@@ -33,12 +38,14 @@ export interface DeleteExperimentParams extends ClientFn {
  *
  * await deleteExperiment({
  *   experimentId: "exp_123",
+ *   deleteProject: true,
  * });
  * ```
  */
 export async function deleteExperiment({
   client: _client,
   experimentId,
+  deleteProject,
 }: DeleteExperimentParams): Promise<void> {
   const client = _client ?? createClient();
 
@@ -47,6 +54,9 @@ export async function deleteExperiment({
       path: {
         experiment_id: experimentId,
       },
+      ...(deleteProject !== undefined && {
+        query: { delete_project: deleteProject },
+      }),
     },
   });
 

package/src/experiments/getExperiment.ts

@@ -1,7 +1,6 @@
 import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { ExperimentRunsMap, RanExperiment } from "../types/experiments";
-
+import type { ClientFn } from "../types/core";
+import type { ExperimentRunsMap, RanExperiment } from "../types/experiments";
 import { getExperimentInfo } from "./getExperimentInfo";
 import { getExperimentRuns } from "./getExperimentRuns";
 

package/src/experiments/getExperimentInfo.ts

@@ -1,9 +1,9 @@
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { type ExperimentInfo } from "../types/experiments";
-
 import invariant from "tiny-invariant";
 
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { ExperimentInfo } from "../types/experiments";
+
 export type GetExperimentParams = ClientFn & {
   /**
    * The experiment ID

package/src/experiments/getExperimentRuns.ts

@@ -1,10 +1,10 @@
-import { components } from "../__generated__/api/v1";
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { ExperimentRun } from "../types/experiments";
-
 import invariant from "tiny-invariant";
 
+import type { components } from "../__generated__/api/v1";
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { ExperimentRun } from "../types/experiments";
+
 export type GetExperimentRunsParams = ClientFn & {
   /**
    * The experiment ID.

package/src/experiments/helpers/asExperimentEvaluator.ts

@@ -1,5 +1,5 @@
-import { AnnotatorKind } from "../../types/annotations";
-import { Evaluator } from "../../types/experiments";
+import type { AnnotatorKind } from "../../types/annotations";
+import type { Evaluator } from "../../types/experiments";
 
 /**
  * Wrap an evaluator function in an object with a name property.

package/src/experiments/helpers/fromPhoenixLLMEvaluator.ts

@@ -1,7 +1,6 @@
 import type { LLMEvaluator } from "@arizeai/phoenix-evals";
 
-import { Evaluator } from "../../types/experiments";
-
+import type { Evaluator } from "../../types/experiments";
 import { asExperimentEvaluator } from "./asExperimentEvaluator";
 
 /**

package/src/experiments/helpers/getExperimentEvaluators.ts

@@ -1,7 +1,6 @@
 import type { LLMEvaluator } from "@arizeai/phoenix-evals";
 
-import { Evaluator } from "../../types/experiments";
-
+import type { Evaluator } from "../../types/experiments";
 import { fromPhoenixLLMEvaluator } from "./fromPhoenixLLMEvaluator";
 
 /**

package/src/experiments/listExperiments.ts

@@ -1,10 +1,10 @@
-import { components } from "../__generated__/api/v1";
-import { createClient } from "../client";
-import { ClientFn } from "../types/core";
-import { ExperimentInfo } from "../types/experiments";
-
 import invariant from "tiny-invariant";
 
+import type { components } from "../__generated__/api/v1";
+import { createClient } from "../client";
+import type { ClientFn } from "../types/core";
+import type { ExperimentInfo } from "../types/experiments";
+
 export type ListExperimentsParams = ClientFn & {
   /**
    * The dataset ID to list experiments for