@arizeai/phoenix-client 6.3.0 → 6.5.0

package/dist/src/client.js

@@ -3,9 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createClient = exports.getMergedOptions = void 0;
+exports.createClient = exports.getMergedOptions = exports.PHOENIX_SERVER_VERSION_HEADER = void 0;
 const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
 const config_1 = require("./config");
+const semverUtils_1 = require("./utils/semverUtils");
+/**
+ * The HTTP response header that carries the Phoenix server version string.
+ */
+exports.PHOENIX_SERVER_VERSION_HEADER = "x-phoenix-server-version";
 /**
  * Merge all configuration options according to priority:
  * defaults < environment < explicit options
@@ -58,8 +63,58 @@ const middleware = {
 const createClient = (config = {}) => {
     const mergedOptions = (0, exports.getMergedOptions)(config);
     const openApiClient = (0, openapi_fetch_1.default)(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(exports.PHOENIX_SERVER_VERSION_HEADER);
+                if (header) {
+                    serverVersion = (0, semverUtils_1.parseSemanticVersion)(header);
+                }
+            }
+        },
+    };
+    openApiClient.use(versionMiddleware);
     openApiClient.use(middleware);
-    return Object.assign(Object.assign({}, openApiClient), { config: mergedOptions });
+    return Object.assign(Object.assign({}, 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 () => {
+            var _a;
+            if (serverVersion != null)
+                return serverVersion;
+            try {
+                const baseUrl = (_a = mergedOptions.baseUrl) !== null && _a !== void 0 ? _a : "";
+                const headers = mergedOptions.headers
+                    ? Object.assign({}, mergedOptions.headers) : {};
+                const resp = await fetch(`${baseUrl}/arize_phoenix_version`, {
+                    headers,
+                });
+                if (resp.ok) {
+                    const text = await resp.text();
+                    const parsed = (0, semverUtils_1.parseSemanticVersion)(text);
+                    if (parsed) {
+                        serverVersion = parsed;
+                        return serverVersion;
+                    }
+                }
+            }
+            catch (_b) {
+                // 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.");
+        } });
 };
 exports.createClient = createClient;
 //# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;;;;;AAAA,kEAGuB;AAOvB,qCAGkB;AAiBlB;;;;;;;;GAQG;AACI,MAAM,gBAAgB,GAAG,CAAC,EAC/B,OAAO,GAAG,EAAE,EACZ,qBAAqB,GAAG,qCAA4B,MAIlD,EAAE,EAAiB,EAAE;IACvB,MAAM,cAAc,GAAG,IAAA,iCAAwB,GAAE,CAAC;IAClD,MAAM,kBAAkB,GAAG,qBAAqB,EAAE,CAAC;IACnD,qDACK,cAAc,GACd,kBAAkB,GAClB,OAAO,EACV;AACJ,CAAC,CAAC;AAdW,QAAA,gBAAgB,oBAc3B;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;AACI,MAAM,YAAY,GAAG,CAC1B,SAGI,EAAE,EACN,EAAE;IACF,MAAM,aAAa,GAAG,IAAA,wBAAgB,EAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,IAAA,uBAAmB,EAAU,aAAa,CAAC,CAAC;IAClE,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,uCACK,aAAa,KAChB,MAAM,EAAE,aAAa,IACrB;AACJ,CAAC,CAAC;AAbW,QAAA,YAAY,gBAavB"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/src/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";
+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/src/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/src/constants/serverRequirements.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_REQUIREMENTS = exports.GET_SPANS_TRACE_IDS = exports.ANNOTATE_SESSIONS = exports.LIST_PROJECT_SESSIONS = exports.DELETE_SESSIONS = exports.DELETE_SESSION = exports.GET_SESSION = void 0;
+exports.GET_SESSION = {
+    kind: "route",
+    method: "GET",
+    path: "/v1/sessions/{session_id}",
+    minServerVersion: [13, 5, 0],
+};
+exports.DELETE_SESSION = {
+    kind: "route",
+    method: "DELETE",
+    path: "/v1/sessions/{session_id}",
+    minServerVersion: [13, 13, 0],
+};
+exports.DELETE_SESSIONS = {
+    kind: "route",
+    method: "POST",
+    path: "/v1/sessions/delete",
+    minServerVersion: [13, 13, 0],
+};
+exports.LIST_PROJECT_SESSIONS = {
+    kind: "route",
+    method: "GET",
+    path: "/v1/projects/{project_id}/sessions",
+    minServerVersion: [13, 5, 0],
+};
+exports.ANNOTATE_SESSIONS = {
+    kind: "route",
+    method: "POST",
+    path: "/v1/session_annotations",
+    minServerVersion: [12, 0, 0],
+};
+exports.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.
+ */
+exports.ALL_REQUIREMENTS = [
+    exports.GET_SESSION,
+    exports.DELETE_SESSION,
+    exports.DELETE_SESSIONS,
+    exports.LIST_PROJECT_SESSIONS,
+    exports.ANNOTATE_SESSIONS,
+    exports.GET_SPANS_TRACE_IDS,
+];
+//# sourceMappingURL=serverRequirements.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverRequirements.js","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAQU,QAAA,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;AAEW,QAAA,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;AAEW,QAAA,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;AAEW,QAAA,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;AAEW,QAAA,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;AAEW,QAAA,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;AACU,QAAA,gBAAgB,GAAqC;IAChE,mBAAW;IACX,sBAAc;IACd,uBAAe;IACf,6BAAqB;IACrB,yBAAiB;IACjB,2BAAmB;CACX,CAAC"}

package/dist/src/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/src/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/src/sessions/addSessionAnnotation.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addSessionAnnotation = addSessionAnnotation;
 const client_1 = require("../client");
+const serverRequirements_1 = require("../constants/serverRequirements");
+const serverVersionUtils_1 = require("../utils/serverVersionUtils");
 const types_1 = require("./types");
 /**
  * Add an annotation to a session.
@@ -12,6 +14,8 @@ const types_1 = require("./types");
  * @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({
@@ -32,6 +36,7 @@ const types_1 = require("./types");
 async function addSessionAnnotation({ client: _client, sessionAnnotation, sync = false, }) {
     var _a;
     const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
+    await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.ANNOTATE_SESSIONS });
     const { data, error } = await client.POST("/v1/session_annotations", {
         params: {
             query: { sync },

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

@@ -1 +1 @@
-{"version":3,"file":"addSessionAnnotation.js","sourceRoot":"","sources":["../../../src/sessions/addSessionAnnotation.ts"],"names":[],"mappings":";;AA4CA,oDAqBC;AAjED,sCAAyC;AAGzC,mCAAkD;AAelD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,iBAAiB,EACjB,IAAI,GAAG,KAAK,GACe;;IAC3B,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,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,IAAA,+BAAuB,EAAC,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,CAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,0CAAG,CAAC,CAAC,KAAI,IAAI,CAAC;AACjC,CAAC"}
+{"version":3,"file":"addSessionAnnotation.js","sourceRoot":"","sources":["../../../src/sessions/addSessionAnnotation.ts"],"names":[],"mappings":";;AAgDA,oDAsBC;AAtED,sCAAyC;AACzC,wEAAoE;AAEpE,oEAAqE;AAErE,mCAAkD;AAelD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACI,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,iBAAiB,EACjB,IAAI,GAAG,KAAK,GACe;;IAC3B,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,sCAAiB,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,IAAA,+BAAuB,EAAC,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,CAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,0CAAG,CAAC,CAAC,KAAI,IAAI,CAAC;AACjC,CAAC"}

package/dist/src/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/src/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/src/sessions/deleteSession.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deleteSession = deleteSession;
 const client_1 = require("../client");
+const serverRequirements_1 = require("../constants/serverRequirements");
+const serverVersionUtils_1 = require("../utils/serverVersionUtils");
 /**
  * Delete a single session by ID.
  *
@@ -14,6 +16,8 @@ const client_1 = require("../client");
  * @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
@@ -31,6 +35,7 @@ const client_1 = require("../client");
  */
 async function deleteSession({ client: _client, sessionId, }) {
     const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
+    await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.DELETE_SESSION });
     const { error } = await client.DELETE("/v1/sessions/{session_identifier}", {
         params: {
             path: {

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

@@ -1 +1 @@
-{"version":3,"file":"deleteSession.js","sourceRoot":"","sources":["../../../src/sessions/deleteSession.ts"],"names":[],"mappings":";;AA0CA,sCA8BC;AAxED,sCAAyC;AAezC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,aAAa,CAAC,EAClC,MAAM,EAAE,OAAO,EACf,SAAS,GACW;IACpB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,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":";;AA8CA,sCA+BC;AA7ED,sCAAyC;AACzC,wEAAiE;AAEjE,oEAAqE;AAcrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACI,KAAK,UAAU,aAAa,CAAC,EAClC,MAAM,EAAE,OAAO,EACf,SAAS,GACW;IACpB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,mCAAc,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/src/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/src/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/src/sessions/deleteSessions.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deleteSessions = deleteSessions;
 const client_1 = require("../client");
+const serverRequirements_1 = require("../constants/serverRequirements");
+const serverVersionUtils_1 = require("../utils/serverVersionUtils");
 /**
  * Delete multiple sessions by their identifiers.
  *
@@ -15,6 +17,8 @@ const client_1 = require("../client");
  * @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
@@ -32,6 +36,7 @@ const client_1 = require("../client");
  */
 async function deleteSessions({ client: _client, sessionIds, }) {
     const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
+    await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.DELETE_SESSIONS });
     const { error } = await client.POST("/v1/sessions/delete", {
         body: {
             session_identifiers: sessionIds,

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

@@ -1 +1 @@
-{"version":3,"file":"deleteSessions.js","sourceRoot":"","sources":["../../../src/sessions/deleteSessions.ts"],"names":[],"mappings":";;AA6CA,wCAmBC;AAhED,sCAAyC;AAiBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACI,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,UAAU,GACW;IACrB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,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":";;AAiDA,wCAoBC;AArED,sCAAyC;AACzC,wEAAkE;AAElE,oEAAqE;AAgBrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACI,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,UAAU,GACW;IACrB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,oCAAe,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/src/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/src/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/src/sessions/getSession.js

@@ -6,10 +6,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSession = getSession;
 const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
 const client_1 = require("../client");
+const serverRequirements_1 = require("../constants/serverRequirements");
+const serverVersionUtils_1 = require("../utils/serverVersionUtils");
 const sessionUtils_1 = require("./sessionUtils");
 /**
  * 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";
@@ -20,6 +24,7 @@ const sessionUtils_1 = require("./sessionUtils");
  */
 async function getSession({ client: _client, sessionId, }) {
     const client = _client || (0, client_1.createClient)();
+    await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.GET_SESSION });
     const { data, error } = await client.GET("/v1/sessions/{session_identifier}", {
         params: {
             path: {

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

@@ -1 +1 @@
-{"version":3,"file":"getSession.js","sourceRoot":"","sources":["../../../src/sessions/getSession.ts"],"names":[],"mappings":";;;;;AAyBA,gCAkBC;AA3CD,oEAAuC;AAEvC,sCAAyC;AAGzC,iDAA2C;AAS3C;;;;;;;;;;GAUG;AACI,KAAK,UAAU,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,SAAS,GACQ;IACjB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,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,IAAA,wBAAS,EAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC/C,OAAO,IAAA,wBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"getSession.js","sourceRoot":"","sources":["../../../src/sessions/getSession.ts"],"names":[],"mappings":";;;;;AA6BA,gCAmBC;AAhDD,oEAAuC;AAEvC,sCAAyC;AACzC,wEAA8D;AAG9D,oEAAqE;AACrE,iDAA2C;AAS3C;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,UAAU,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,SAAS,GACQ;IACjB,MAAM,MAAM,GAAG,OAAO,IAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,gCAAW,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,IAAA,wBAAS,EAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC/C,OAAO,IAAA,wBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,72 @@
+import type { components } from "../__generated__/api/v1";
+import type { ClientFn } from "../types/core";
+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/src/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/src/sessions/getSessionTurns.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionTurns = getSessionTurns;
+const openinference_semantic_conventions_1 = require("@arizeai/openinference-semantic-conventions");
+const client_1 = require("../client");
+const getSpans_1 = require("../spans/getSpans");
+const getSession_1 = require("./getSession");
+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}`);
+ * }
+ * ```
+ */
+async function getSessionTurns({ client: _client, sessionId, }) {
+    const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
+    // getSession already calls ensureSessionsApi internally
+    const session = await (0, getSession_1.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 (0, getSpans_1.getSpans)(Object.assign({ 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, }) {
+    var _a;
+    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 = (_a = rootSpan.attributes) !== null && _a !== void 0 ? _a : {};
+            turn.input = extractIO({
+                attrs,
+                valueKey: openinference_semantic_conventions_1.SemanticConventions.INPUT_VALUE,
+                mimeTypeKey: openinference_semantic_conventions_1.SemanticConventions.INPUT_MIME_TYPE,
+            });
+            turn.output = extractIO({
+                attrs,
+                valueKey: openinference_semantic_conventions_1.SemanticConventions.OUTPUT_VALUE,
+                mimeTypeKey: openinference_semantic_conventions_1.SemanticConventions.OUTPUT_MIME_TYPE,
+            });
+        }
+        turns.push(turn);
+    }
+    turns.sort((a, b) => a.startTime.localeCompare(b.startTime));
+    return turns;
+}
+//# sourceMappingURL=getSessionTurns.js.map

package/dist/src/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/src/sessions/index.d.ts

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

package/dist/src/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/src/sessions/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./addSessionAnnotation"), exports);
 __exportStar(require("./deleteSession"), exports);
 __exportStar(require("./deleteSessions"), exports);
 __exportStar(require("./getSession"), exports);
+__exportStar(require("./getSessionTurns"), exports);
 __exportStar(require("./listSessions"), exports);
 __exportStar(require("./logSessionAnnotations"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sessions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,kDAAgC;AAChC,mDAAiC;AACjC,+CAA6B;AAC7B,iDAA+B;AAC/B,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sessions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,kDAAgC;AAChC,mDAAiC;AACjC,+CAA6B;AAC7B,oDAAkC;AAClC,iDAA+B;AAC/B,0DAAwC"}

package/dist/src/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";