@arizeai/phoenix-client 6.3.0 → 6.5.0

package/dist/esm/client.js

@@ -1,5 +1,10 @@
 import createOpenApiClient from "openapi-fetch";
 import { defaultGetEnvironmentOptions, makeDefaultClientOptions, } from "./config.js";
+import { parseSemanticVersion } from "./utils/semverUtils.js";
+/**
+ * The HTTP response header that carries the Phoenix server version string.
+ */
+export const PHOENIX_SERVER_VERSION_HEADER = "x-phoenix-server-version";
 /**
  * Merge all configuration options according to priority:
  * defaults < environment < explicit options
@@ -55,10 +60,60 @@ const middleware = {
 export const createClient = (config = {}) => {
     const mergedOptions = getMergedOptions(config);
     const openApiClient = createOpenApiClient(mergedOptions);
+    // Lazily populated by versionMiddleware from the x-phoenix-server-version
+    // response header on the first successful API call. Read via getServerVersion().
+    let serverVersion;
+    const versionMiddleware = {
+        onResponse({ response }) {
+            if (serverVersion === undefined) {
+                const header = response.headers.get(PHOENIX_SERVER_VERSION_HEADER);
+                if (header) {
+                    serverVersion = parseSemanticVersion(header);
+                }
+            }
+        },
+    };
+    openApiClient.use(versionMiddleware);
     openApiClient.use(middleware);
     return {
         ...openApiClient,
         config: mergedOptions,
+        /**
+         * Get the Phoenix server version, returning a cached value if available.
+         *
+         * The version is first populated from the `x-phoenix-server-version`
+         * response header on any API call. If no version has been seen yet,
+         * this method fetches `GET /arize_phoenix_version` to populate the cache.
+         *
+         * @throws {Error} If the server version cannot be determined (e.g. the
+         * server is unreachable or returned an unparseable version string).
+         */
+        getServerVersion: async () => {
+            if (serverVersion != null)
+                return serverVersion;
+            try {
+                const baseUrl = mergedOptions.baseUrl ?? "";
+                const headers = mergedOptions.headers
+                    ? { ...mergedOptions.headers }
+                    : {};
+                const resp = await fetch(`${baseUrl}/arize_phoenix_version`, {
+                    headers,
+                });
+                if (resp.ok) {
+                    const text = await resp.text();
+                    const parsed = parseSemanticVersion(text);
+                    if (parsed) {
+                        serverVersion = parsed;
+                        return serverVersion;
+                    }
+                }
+            }
+            catch {
+                // fall through to throw below
+            }
+            throw new Error("Phoenix server version could not be determined. " +
+                "Please ensure you are connecting to a supported Phoenix server.");
+        },
     };
 };
 //# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,mBAGN,MAAM,eAAe,CAAC;AAOvB,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAiBlB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,OAAO,GAAG,EAAE,EACZ,qBAAqB,GAAG,4BAA4B,MAIlD,EAAE,EAAiB,EAAE;IACvB,MAAM,cAAc,GAAG,wBAAwB,EAAE,CAAC;IAClD,MAAM,kBAAkB,GAAG,qBAAqB,EAAE,CAAC;IACnD,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,kBAAkB;QACrB,GAAG,OAAO;KACX,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,GAAe;IAC7B,UAAU,CAAC,EAAE,QAAQ,EAAE;QACrB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,wFAAwF;YACxF,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC7D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAGI,EAAE,EACN,EAAE;IACF,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,mBAAmB,CAAU,aAAa,CAAC,CAAC;IAClE,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,OAAO;QACL,GAAG,aAAa;QAChB,MAAM,EAAE,aAAa;KACtB,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/constants/serverRequirements.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Known server capability requirements.
+ *
+ * Each constant below describes a single Phoenix server capability — an HTTP
+ * route or query parameter — together with the minimum server version that
+ * supports it.  These constants are passed to
+ * {@link ensureServerCapability} at call time to produce a clear error when
+ * the connected server is too old.
+ *
+ * When a new version-gated capability is added to the Phoenix REST API, add a
+ * corresponding requirement constant here and reference it from the client
+ * function that uses it.
+ */
+import type { CapabilityRequirement, ParameterRequirement, RouteRequirement } from "../types/serverRequirements.js";
+export declare const GET_SESSION: RouteRequirement;
+export declare const DELETE_SESSION: RouteRequirement;
+export declare const DELETE_SESSIONS: RouteRequirement;
+export declare const LIST_PROJECT_SESSIONS: RouteRequirement;
+export declare const ANNOTATE_SESSIONS: RouteRequirement;
+export declare const GET_SPANS_TRACE_IDS: ParameterRequirement;
+/**
+ * Aggregate list of every known capability requirement.
+ *
+ * Useful for manifest scanning or startup diagnostics — iterate over this
+ * array to check which capabilities the connected server supports.
+ */
+export declare const ALL_REQUIREMENTS: readonly CapabilityRequirement[];
+//# sourceMappingURL=serverRequirements.d.ts.map

package/dist/esm/constants/serverRequirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverRequirements.d.ts","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,WAAW,EAAE,gBAKzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAK7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAKnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAK/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAMjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,qBAAqB,EAOnD,CAAC"}

package/dist/esm/constants/serverRequirements.js

@@ -0,0 +1,65 @@
+/**
+ * Known server capability requirements.
+ *
+ * Each constant below describes a single Phoenix server capability — an HTTP
+ * route or query parameter — together with the minimum server version that
+ * supports it.  These constants are passed to
+ * {@link ensureServerCapability} at call time to produce a clear error when
+ * the connected server is too old.
+ *
+ * When a new version-gated capability is added to the Phoenix REST API, add a
+ * corresponding requirement constant here and reference it from the client
+ * function that uses it.
+ */
+export const GET_SESSION = {
+    kind: "route",
+    method: "GET",
+    path: "/v1/sessions/{session_id}",
+    minServerVersion: [13, 5, 0],
+};
+export const DELETE_SESSION = {
+    kind: "route",
+    method: "DELETE",
+    path: "/v1/sessions/{session_id}",
+    minServerVersion: [13, 13, 0],
+};
+export const DELETE_SESSIONS = {
+    kind: "route",
+    method: "POST",
+    path: "/v1/sessions/delete",
+    minServerVersion: [13, 13, 0],
+};
+export const LIST_PROJECT_SESSIONS = {
+    kind: "route",
+    method: "GET",
+    path: "/v1/projects/{project_id}/sessions",
+    minServerVersion: [13, 5, 0],
+};
+export const ANNOTATE_SESSIONS = {
+    kind: "route",
+    method: "POST",
+    path: "/v1/session_annotations",
+    minServerVersion: [12, 0, 0],
+};
+export const GET_SPANS_TRACE_IDS = {
+    kind: "parameter",
+    parameterName: "trace_id",
+    parameterLocation: "query",
+    route: "GET /v1/projects/{id}/spans",
+    minServerVersion: [13, 9, 0],
+};
+/**
+ * Aggregate list of every known capability requirement.
+ *
+ * Useful for manifest scanning or startup diagnostics — iterate over this
+ * array to check which capabilities the connected server supports.
+ */
+export const ALL_REQUIREMENTS = [
+    GET_SESSION,
+    DELETE_SESSION,
+    DELETE_SESSIONS,
+    LIST_PROJECT_SESSIONS,
+    ANNOTATE_SESSIONS,
+    GET_SPANS_TRACE_IDS,
+];
+//# sourceMappingURL=serverRequirements.js.map

package/dist/esm/constants/serverRequirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverRequirements.js","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,2BAA2B;IACjC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,2BAA2B;IACjC,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,qBAAqB;IAC3B,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,oCAAoC;IAC1C,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,yBAAyB;IAC/B,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACvD,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,UAAU;IACzB,iBAAiB,EAAE,OAAO;IAC1B,KAAK,EAAE,6BAA6B;IACpC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,WAAW;IACX,cAAc;IACd,eAAe;IACf,qBAAqB;IACrB,iBAAiB;IACjB,mBAAmB;CACX,CAAC"}

package/dist/esm/sessions/addSessionAnnotation.d.ts

@@ -21,6 +21,8 @@ export interface AddSessionAnnotationParams extends ClientFn {
  * @param params - The parameters to add a span annotation
  * @returns The ID of the created or updated annotation
  *
+ * @requires Phoenix server >= 12.0.0
+ *
  * @example
  * ```ts
  * const result = await addSessionAnnotation({

package/dist/esm/sessions/addSessionAnnotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addSessionAnnotation.d.ts","sourceRoot":"","sources":["../../../src/sessions/addSessionAnnotation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,QAAQ;IAC1D,iBAAiB,EAAE,iBAAiB,CAAC;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,iBAAiB,EACjB,IAAY,GACb,EAAE,0BAA0B,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiB7D"}
+{"version":3,"file":"addSessionAnnotation.d.ts","sourceRoot":"","sources":["../../../src/sessions/addSessionAnnotation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,QAAQ;IAC1D,iBAAiB,EAAE,iBAAiB,CAAC;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,iBAAiB,EACjB,IAAY,GACb,EAAE,0BAA0B,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAkB7D"}

package/dist/esm/sessions/addSessionAnnotation.js

@@ -1,4 +1,6 @@
 import { createClient } from "../client.js";
+import { ANNOTATE_SESSIONS } from "../constants/serverRequirements.js";
+import { ensureServerCapability } from "../utils/serverVersionUtils.js";
 import { toSessionAnnotationData } from "./types.js";
 /**
  * Add an annotation to a session.
@@ -9,6 +11,8 @@ import { toSessionAnnotationData } from "./types.js";
  * @param params - The parameters to add a span annotation
  * @returns The ID of the created or updated annotation
  *
+ * @requires Phoenix server >= 12.0.0
+ *
  * @example
  * ```ts
  * const result = await addSessionAnnotation({
@@ -28,6 +32,7 @@ import { toSessionAnnotationData } from "./types.js";
  */
 export async function addSessionAnnotation({ client: _client, sessionAnnotation, sync = false, }) {
     const client = _client ?? createClient();
+    await ensureServerCapability({ client, requirement: ANNOTATE_SESSIONS });
     const { data, error } = await client.POST("/v1/session_annotations", {
         params: {
             query: { sync },

package/dist/esm/sessions/addSessionAnnotation.js.map

@@ -1 +1 @@
-{"version":3,"file":"addSessionAnnotation.js","sourceRoot":"","sources":["../../../src/sessions/addSessionAnnotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAelD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,iBAAiB,EACjB,IAAI,GAAG,KAAK,GACe;IAC3B,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IAEzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;QACnE,MAAM,EAAE;YACN,KAAK,EAAE,EAAE,IAAI,EAAE;SAChB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;SACnD;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACjC,CAAC"}
+{"version":3,"file":"addSessionAnnotation.js","sourceRoot":"","sources":["../../../src/sessions/addSessionAnnotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAelD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,iBAAiB,EACjB,IAAI,GAAG,KAAK,GACe;IAC3B,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAEzE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;QACnE,MAAM,EAAE;YACN,KAAK,EAAE,EAAE,IAAI,EAAE;SAChB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;SACnD;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACjC,CAAC"}

package/dist/esm/sessions/deleteSession.d.ts

@@ -22,6 +22,8 @@ export interface DeleteSessionParams extends ClientFn {
  * @returns Promise that resolves when the session is successfully deleted
  * @throws Error if the session is not found or deletion fails
  *
+ * @requires Phoenix server >= 13.13.0
+ *
  * @example
  * ```ts
  * // Delete by user-provided session ID

package/dist/esm/sessions/deleteSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleteSession.d.ts","sourceRoot":"","sources":["../../../src/sessions/deleteSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,aAAa,CAAC,EAClC,MAAM,EAAE,OAAO,EACf,SAAS,GACV,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrC"}
+{"version":3,"file":"deleteSession.d.ts","sourceRoot":"","sources":["../../../src/sessions/deleteSession.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,aAAa,CAAC,EAClC,MAAM,EAAE,OAAO,EACf,SAAS,GACV,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BrC"}

package/dist/esm/sessions/deleteSession.js

@@ -1,4 +1,6 @@
 import { createClient } from "../client.js";
+import { DELETE_SESSION } from "../constants/serverRequirements.js";
+import { ensureServerCapability } from "../utils/serverVersionUtils.js";
 /**
  * Delete a single session by ID.
  *
@@ -11,6 +13,8 @@ import { createClient } from "../client.js";
  * @returns Promise that resolves when the session is successfully deleted
  * @throws Error if the session is not found or deletion fails
  *
+ * @requires Phoenix server >= 13.13.0
+ *
  * @example
  * ```ts
  * // Delete by user-provided session ID
@@ -28,6 +32,7 @@ import { createClient } from "../client.js";
  */
 export async function deleteSession({ client: _client, sessionId, }) {
     const client = _client ?? createClient();
+    await ensureServerCapability({ client, requirement: DELETE_SESSION });
     const { error } = await client.DELETE("/v1/sessions/{session_identifier}", {
         params: {
             path: {

package/dist/esm/sessions/deleteSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"deleteSession.js","sourceRoot":"","sources":["../../../src/sessions/deleteSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAezC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAClC,MAAM,EAAE,OAAO,EACf,SAAS,GACW;IACpB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IAEzC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,mCAAmC,EAAE;QACzE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,SAAS;aAC9B;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,UAAU,GACd,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,QAAQ,IAAI,KAAK;YACjB,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC;QACvB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,YAAY,GAChB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YACzC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}
+{"version":3,"file":"deleteSession.js","sourceRoot":"","sources":["../../../src/sessions/deleteSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAcrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAClC,MAAM,EAAE,OAAO,EACf,SAAS,GACW;IACpB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAAC;IAEtE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,mCAAmC,EAAE;QACzE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,SAAS;aAC9B;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,UAAU,GACd,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,QAAQ,IAAI,KAAK;YACjB,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC;QACvB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,YAAY,GAChB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YACzC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/esm/sessions/deleteSessions.d.ts

@@ -25,6 +25,8 @@ export interface DeleteSessionsParams extends ClientFn {
  * @returns Promise that resolves when the sessions are successfully deleted
  * @throws Error if identifiers are mixed types or deletion fails
  *
+ * @requires Phoenix server >= 13.13.0
+ *
  * @example
  * ```ts
  * // Delete by user-provided session IDs

package/dist/esm/sessions/deleteSessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleteSessions.d.ts","sourceRoot":"","sources":["../../../src/sessions/deleteSessions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,QAAQ;IACpD;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,UAAU,GACX,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtC"}
+{"version":3,"file":"deleteSessions.d.ts","sourceRoot":"","sources":["../../../src/sessions/deleteSessions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,QAAQ;IACpD;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,UAAU,GACX,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtC"}

package/dist/esm/sessions/deleteSessions.js

@@ -1,4 +1,6 @@
 import { createClient } from "../client.js";
+import { DELETE_SESSIONS } from "../constants/serverRequirements.js";
+import { ensureServerCapability } from "../utils/serverVersionUtils.js";
 /**
  * Delete multiple sessions by their identifiers.
  *
@@ -12,6 +14,8 @@ import { createClient } from "../client.js";
  * @returns Promise that resolves when the sessions are successfully deleted
  * @throws Error if identifiers are mixed types or deletion fails
  *
+ * @requires Phoenix server >= 13.13.0
+ *
  * @example
  * ```ts
  * // Delete by user-provided session IDs
@@ -29,6 +33,7 @@ import { createClient } from "../client.js";
  */
 export async function deleteSessions({ client: _client, sessionIds, }) {
     const client = _client ?? createClient();
+    await ensureServerCapability({ client, requirement: DELETE_SESSIONS });
     const { error } = await client.POST("/v1/sessions/delete", {
         body: {
             session_identifiers: sessionIds,

package/dist/esm/sessions/deleteSessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"deleteSessions.js","sourceRoot":"","sources":["../../../src/sessions/deleteSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAiBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,UAAU,GACW;IACrB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IAEzC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;QACzD,IAAI,EAAE;YACJ,mBAAmB,EAAE,UAAU;SAChC;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,YAAY,GAChB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YACzC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}
+{"version":3,"file":"deleteSessions.js","sourceRoot":"","sources":["../../../src/sessions/deleteSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAgBrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,UAAU,GACW;IACrB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC;IAEvE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;QACzD,IAAI,EAAE;YACJ,mBAAmB,EAAE,UAAU;SAChC;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,YAAY,GAChB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YACzC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/esm/sessions/getSession.d.ts

@@ -9,6 +9,8 @@ export type GetSessionParams = ClientFn & {
 /**
  * Fetch a single session by its GlobalID or user-provided session_id string.
  *
+ * @requires Phoenix server >= 13.5.0
+ *
  * @example
  * ```ts
  * import { getSession } from "@arizeai/phoenix-client/sessions";

package/dist/esm/sessions/getSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getSession.d.ts","sourceRoot":"","sources":["../../../src/sessions/getSession.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,SAAS,GACV,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAerC"}
+{"version":3,"file":"getSession.d.ts","sourceRoot":"","sources":["../../../src/sessions/getSession.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,SAAS,GACV,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrC"}

package/dist/esm/sessions/getSession.js

@@ -1,9 +1,13 @@
 import invariant from "tiny-invariant";
 import { createClient } from "../client.js";
+import { GET_SESSION } from "../constants/serverRequirements.js";
+import { ensureServerCapability } from "../utils/serverVersionUtils.js";
 import { toSession } from "./sessionUtils.js";
 /**
  * Fetch a single session by its GlobalID or user-provided session_id string.
  *
+ * @requires Phoenix server >= 13.5.0
+ *
  * @example
  * ```ts
  * import { getSession } from "@arizeai/phoenix-client/sessions";
@@ -14,6 +18,7 @@ import { toSession } from "./sessionUtils.js";
  */
 export async function getSession({ client: _client, sessionId, }) {
     const client = _client || createClient();
+    await ensureServerCapability({ client, requirement: GET_SESSION });
     const { data, error } = await client.GET("/v1/sessions/{session_identifier}", {
         params: {
             path: {

package/dist/esm/sessions/getSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSession.js","sourceRoot":"","sources":["../../../src/sessions/getSession.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,SAAS,GACQ;IACjB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACtC,mCAAmC,EACnC;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,SAAS;aAC9B;SACF;KACF,CACF,CAAC;IACF,IAAI,KAAK;QAAE,MAAM,KAAK,CAAC;IACvB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"getSession.js","sourceRoot":"","sources":["../../../src/sessions/getSession.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAG9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,SAAS,GACQ;IACjB,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;IACnE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACtC,mCAAmC,EACnC;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,SAAS;aAC9B;SACF;KACF,CACF,CAAC;IACF,IAAI,KAAK;QAAE,MAAM,KAAK,CAAC;IACvB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/esm/sessions/getSessionTurns.d.ts

@@ -0,0 +1,72 @@
+import type { components } from "../__generated__/api/v1.js";
+import type { ClientFn } from "../types/core.js";
+type Span = components["schemas"]["Span"];
+/**
+ * Input or output extracted from a root span's attributes.
+ *
+ * @experimental this interface is experimental and may change in the future
+ */
+export interface SessionTurnIO {
+    /** The string value of the input or output */
+    value: string;
+    /** Optional MIME type (e.g. "text/plain", "application/json") */
+    mimeType?: string;
+}
+/**
+ * A single turn in a session, representing one trace's root span input/output.
+ *
+ * **Note:** A "turn" is derived from a trace's root span. For input/output to appear,
+ * the root span must have `input.value` and `output.value` attributes set
+ * (per OpenInference semantic conventions). This typically requires instrumentation
+ * that records these attributes on the top-level span.
+ *
+ * @experimental this interface is experimental and may change in the future
+ */
+export interface SessionTurn {
+    /** The trace ID for this turn */
+    traceId: string;
+    /** ISO 8601 timestamp of when the trace started */
+    startTime: string;
+    /** ISO 8601 timestamp of when the trace ended */
+    endTime: string;
+    /** Input extracted from the root span's attributes */
+    input?: SessionTurnIO;
+    /** Output extracted from the root span's attributes */
+    output?: SessionTurnIO;
+    /** The full root span, if found */
+    rootSpan?: Span;
+}
+/**
+ * @experimental this interface is experimental and may change in the future
+ */
+export interface GetSessionTurnsParams extends ClientFn {
+    /** The session identifier: either a GlobalID or user-provided session_id string. */
+    sessionId: string;
+}
+/**
+ * Get the turns (root span I/O) for a session.
+ *
+ * Returns input/output extracted from root spans for each trace, along with
+ * the full root span. Turns are ordered by trace start_time.
+ *
+ * **Note:** A "turn" is derived from a trace's root span. For input/output to appear,
+ * the root span must have `input.value` and `output.value` attributes set
+ * (per OpenInference semantic conventions). This typically requires instrumentation
+ * that records these attributes on the top-level span.
+ *
+ * @experimental this function is experimental and may change in the future
+ *
+ * @example
+ * ```ts
+ * import { getSessionTurns } from "@arizeai/phoenix-client/sessions";
+ *
+ * const turns = await getSessionTurns({ sessionId: "my-session" });
+ * for (const turn of turns) {
+ *   console.log(`[${turn.startTime}] Input: ${turn.input?.value}`);
+ *   console.log(`[${turn.startTime}] Output: ${turn.output?.value}`);
+ * }
+ * ```
+ */
+export declare function getSessionTurns({ client: _client, sessionId, }: GetSessionTurnsParams): Promise<SessionTurn[]>;
+export {};
+//# sourceMappingURL=getSessionTurns.d.ts.map

package/dist/esm/sessions/getSessionTurns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSessionTurns.d.ts","sourceRoot":"","sources":["../../../src/sessions/getSessionTurns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,KAAK,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAI1C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,uDAAuD;IACvD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,QAAQ;IACrD,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,EACpC,MAAM,EAAE,OAAO,EACf,SAAS,GACV,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAkChD"}

package/dist/esm/sessions/getSessionTurns.js

@@ -0,0 +1,127 @@
+import { SemanticConventions } from "@arizeai/openinference-semantic-conventions";
+import { createClient } from "../client.js";
+import { getSpans } from "../spans/getSpans.js";
+import { getSession } from "./getSession.js";
+const MAX_TRACE_IDS_PER_BATCH = 50;
+/**
+ * Get the turns (root span I/O) for a session.
+ *
+ * Returns input/output extracted from root spans for each trace, along with
+ * the full root span. Turns are ordered by trace start_time.
+ *
+ * **Note:** A "turn" is derived from a trace's root span. For input/output to appear,
+ * the root span must have `input.value` and `output.value` attributes set
+ * (per OpenInference semantic conventions). This typically requires instrumentation
+ * that records these attributes on the top-level span.
+ *
+ * @experimental this function is experimental and may change in the future
+ *
+ * @example
+ * ```ts
+ * import { getSessionTurns } from "@arizeai/phoenix-client/sessions";
+ *
+ * const turns = await getSessionTurns({ sessionId: "my-session" });
+ * for (const turn of turns) {
+ *   console.log(`[${turn.startTime}] Input: ${turn.input?.value}`);
+ *   console.log(`[${turn.startTime}] Output: ${turn.output?.value}`);
+ * }
+ * ```
+ */
+export async function getSessionTurns({ client: _client, sessionId, }) {
+    const client = _client ?? createClient();
+    // getSession already calls ensureSessionsApi internally
+    const session = await getSession({ client, sessionId });
+    const traces = session.traces;
+    if (traces.length === 0) {
+        return [];
+    }
+    const projectId = session.projectId;
+    const traceInfo = new Map(traces.map((t) => [t.traceId, t]));
+    const allTraceIds = [...traceInfo.keys()];
+    // Fetch root spans in batches
+    const rootSpansByTrace = new Map();
+    for (let i = 0; i < allTraceIds.length; i += MAX_TRACE_IDS_PER_BATCH) {
+        const traceIdBatch = allTraceIds.slice(i, i + MAX_TRACE_IDS_PER_BATCH);
+        const spans = await getAllRootSpansForBatch({
+            client,
+            projectId,
+            traceIdBatch,
+        });
+        for (const span of spans) {
+            const traceId = span.context.trace_id;
+            if (!rootSpansByTrace.has(traceId)) {
+                rootSpansByTrace.set(traceId, span);
+            }
+        }
+    }
+    return buildSessionTurns({ allTraceIds, traceInfo, rootSpansByTrace });
+}
+/**
+ * Fetch all root spans for a batch of trace IDs, handling pagination.
+ */
+async function getAllRootSpansForBatch({ client, projectId, traceIdBatch, }) {
+    const allSpans = [];
+    let cursor = null;
+    do {
+        const result = await getSpans({
+            client,
+            project: { projectId },
+            traceIds: traceIdBatch,
+            parentId: null,
+            limit: traceIdBatch.length,
+            ...(cursor ? { cursor } : {}),
+        });
+        allSpans.push(...result.spans);
+        cursor = result.nextCursor;
+    } while (cursor != null);
+    return allSpans;
+}
+/**
+ * Extract a SessionTurnIO from span attributes for a given prefix.
+ */
+function extractIO({ attrs, valueKey, mimeTypeKey, }) {
+    const value = attrs[valueKey];
+    if (value == null)
+        return undefined;
+    const io = { value: String(value) };
+    const mimeType = attrs[mimeTypeKey];
+    if (mimeType != null) {
+        io.mimeType = String(mimeType);
+    }
+    return io;
+}
+/**
+ * Build session turns from trace info and root spans, ordered by start_time.
+ */
+function buildSessionTurns({ allTraceIds, traceInfo, rootSpansByTrace, }) {
+    const turns = [];
+    for (const traceId of allTraceIds) {
+        const info = traceInfo.get(traceId);
+        if (!info)
+            continue;
+        const turn = {
+            traceId,
+            startTime: info.startTime,
+            endTime: info.endTime,
+        };
+        const rootSpan = rootSpansByTrace.get(traceId);
+        if (rootSpan) {
+            turn.rootSpan = rootSpan;
+            const attrs = rootSpan.attributes ?? {};
+            turn.input = extractIO({
+                attrs,
+                valueKey: SemanticConventions.INPUT_VALUE,
+                mimeTypeKey: SemanticConventions.INPUT_MIME_TYPE,
+            });
+            turn.output = extractIO({
+                attrs,
+                valueKey: SemanticConventions.OUTPUT_VALUE,
+                mimeTypeKey: SemanticConventions.OUTPUT_MIME_TYPE,
+            });
+        }
+        turns.push(turn);
+    }
+    turns.sort((a, b) => a.startTime.localeCompare(b.startTime));
+    return turns;
+}
+//# sourceMappingURL=getSessionTurns.js.map

package/dist/esm/sessions/getSessionTurns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSessionTurns.js","sourceRoot":"","sources":["../../../src/sessions/getSessionTurns.ts"],"names":[],"mappings":"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"}

package/dist/esm/sessions/index.d.ts

@@ -2,6 +2,7 @@ export * from "./addSessionAnnotation.js";
 export * from "./deleteSession.js";
 export * from "./deleteSessions.js";
 export * from "./getSession.js";
+export * from "./getSessionTurns.js";
 export * from "./listSessions.js";
 export * from "./logSessionAnnotations.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/sessions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}

package/dist/esm/sessions/index.js

@@ -2,6 +2,7 @@ export * from "./addSessionAnnotation.js";
 export * from "./deleteSession.js";
 export * from "./deleteSessions.js";
 export * from "./getSession.js";
+export * from "./getSessionTurns.js";
 export * from "./listSessions.js";
 export * from "./logSessionAnnotations.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/sessions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}

package/dist/esm/sessions/listSessions.d.ts

@@ -5,6 +5,8 @@ export type ListSessionsParams = ClientFn & ProjectIdentifier;
 /**
  * List all sessions for a project with automatic pagination handling.
  *
+ * @requires Phoenix server >= 13.5.0
+ *
  * @example
  * ```ts
  * import { listSessions } from "@arizeai/phoenix-client/sessions";

package/dist/esm/sessions/listSessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listSessions.d.ts","sourceRoot":"","sources":["../../../src/sessions/listSessions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAM9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CA6BpB"}
+{"version":3,"file":"listSessions.d.ts","sourceRoot":"","sources":["../../../src/sessions/listSessions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAM9D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CA8BpB"}