@arizeai/phoenix-client 6.4.0 → 6.5.0

package/dist/esm/types/semver.d.ts

@@ -0,0 +1,3 @@
+/** A semantic version triple: [major, minor, patch]. */
+export type SemanticVersion = [number, number, number];
+//# sourceMappingURL=semver.d.ts.map

package/dist/esm/types/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../../src/types/semver.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/esm/types/semver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=semver.js.map

package/dist/esm/types/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../../src/types/semver.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,39 @@
+/**
+ * Server capability requirements.
+ *
+ * A "capability" represents a specific server-side feature — such as an HTTP
+ * route or query parameter — that is gated behind a minimum Phoenix server
+ * version.  Each {@link CapabilityRequirement} declares *what* the capability
+ * is and *which* server version first introduced it.
+ *
+ * The client checks these requirements at call time via
+ * {@link ensureServerCapability} so that callers get a clear, actionable error
+ * instead of an opaque 404 or 400 from an older server.
+ */
+import type { SemanticVersion } from "./semver.js";
+export interface RouteRequirement {
+    kind: "route";
+    /** HTTP method (e.g. "GET", "POST", "DELETE"). */
+    method: string;
+    /** URL path template (e.g. "/v1/sessions/{session_id}"). */
+    path: string;
+    /** Minimum Phoenix server version as [major, minor, patch]. */
+    minServerVersion: SemanticVersion;
+    /** Optional human-readable description override. */
+    description?: string;
+}
+export interface ParameterRequirement {
+    kind: "parameter";
+    /** Name of the query/path/header parameter. */
+    parameterName: string;
+    /** Location of the parameter (e.g. "query", "path", "header"). */
+    parameterLocation: string;
+    /** The route this parameter belongs to (e.g. "GET /v1/projects/{id}/spans"). */
+    route: string;
+    /** Minimum Phoenix server version as [major, minor, patch]. */
+    minServerVersion: SemanticVersion;
+    /** Optional human-readable description override. */
+    description?: string;
+}
+export type CapabilityRequirement = RouteRequirement | ParameterRequirement;
+//# sourceMappingURL=serverRequirements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverRequirements.d.ts","sourceRoot":"","sources":["../../../src/types/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,gBAAgB,EAAE,eAAe,CAAC;IAClC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,gBAAgB,EAAE,eAAe,CAAC;IAClC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC"}

package/dist/esm/types/serverRequirements.js

@@ -0,0 +1,14 @@
+/**
+ * Server capability requirements.
+ *
+ * A "capability" represents a specific server-side feature — such as an HTTP
+ * route or query parameter — that is gated behind a minimum Phoenix server
+ * version.  Each {@link CapabilityRequirement} declares *what* the capability
+ * is and *which* server version first introduced it.
+ *
+ * The client checks these requirements at call time via
+ * {@link ensureServerCapability} so that callers get a clear, actionable error
+ * instead of an opaque 404 or 400 from an older server.
+ */
+export {};
+//# sourceMappingURL=serverRequirements.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverRequirements.js","sourceRoot":"","sources":["../../../src/types/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/esm/utils/formatPromptMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatPromptMessages.d.ts","sourceRoot":"","sources":["../../../src/utils/formatPromptMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGhF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,cAAc,EAAE,iBAAiB,EAAE,EACnC,SAAS,GAAE,SAAc;;;;;;;mBA4D6huG,uDAAsB;;;;;;;;;IAlB7kuG"}
+{"version":3,"file":"formatPromptMessages.d.ts","sourceRoot":"","sources":["../../../src/utils/formatPromptMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGhF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,cAAc,EAAE,iBAAiB,EAAE,EACnC,SAAS,GAAE,SAAc;;;;;;;mBA4DmsvG,uDAAsB;;;;;;;;;IAlBnvvG"}

package/dist/esm/utils/getPromptBySelector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPromptBySelector.d.ts","sourceRoot":"","sources":["../../../src/utils/getPromptBySelector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG;IACjD;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EAAE,OAAO,EACf,MAAM,GACP,EAAE,yBAAyB;;oBAkD+qsF,uDAAsB;;cAAkI,uDAAsB,yBAAwB,uDAAsB;mBAAoD,uDAAsB;qBAAoD,uDAAsB;2BAAqG,uDAAsB,uCAAsC,uDAAsB,4CAA2C,uDAAsB,0CAAyC,uDAAsB,uCAAsC,uDAAsB,yCAAwC,uDAAsB,oCAAmC,uDAAsB,uCAAsC,uDAAsB,oCAAmC,uDAAsB,yCAAwC,uDAAsB,0CAAyC,uDAAsB,qCAAoC,uDAAsB,yCAAwC,uDAAsB,2CAA0C,uDAAsB;YAA2D,uDAAsB;sBAAwF,uDAAsB;;UAD7ovF"}
+{"version":3,"file":"getPromptBySelector.d.ts","sourceRoot":"","sources":["../../../src/utils/getPromptBySelector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG;IACjD;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EAAE,OAAO,EACf,MAAM,GACP,EAAE,yBAAyB;;oBAkDq1tF,uDAAsB;;cAAkI,uDAAsB,yBAAwB,uDAAsB;mBAAoD,uDAAsB;qBAAoD,uDAAsB;2BAAqG,uDAAsB,uCAAsC,uDAAsB,4CAA2C,uDAAsB,0CAAyC,uDAAsB,uCAAsC,uDAAsB,yCAAwC,uDAAsB,oCAAmC,uDAAsB,uCAAsC,uDAAsB,oCAAmC,uDAAsB,yCAAwC,uDAAsB,0CAAyC,uDAAsB,qCAAoC,uDAAsB,yCAAwC,uDAAsB,2CAA0C,uDAAsB;YAA2D,uDAAsB;sBAAwF,uDAAsB;;UADnzwF"}

package/dist/esm/utils/semverUtils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Lightweight semantic version utilities.
+ */
+import type { SemanticVersion } from "../types/semver.js";
+/**
+ * Parse a semver-like version string (e.g. "13.14.0") into a triple.
+ * Returns `null` if the string is not a valid version.
+ */
+export declare function parseSemanticVersion(raw: string): SemanticVersion | null;
+/**
+ * Format a `SemanticVersion` as a `"major.minor.patch"` string.
+ */
+export declare function formatVersion(version: SemanticVersion): string;
+/**
+ * Returns `true` if `version` is greater than or equal to `minVersion`.
+ */
+export declare function satisfiesMinVersion({ version, minVersion, }: {
+    version: SemanticVersion;
+    minVersion: SemanticVersion;
+}): boolean;
+//# sourceMappingURL=semverUtils.d.ts.map

package/dist/esm/utils/semverUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semverUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/semverUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAiBxE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE9D;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,UAAU,GACX,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,eAAe,CAAC;CAC7B,GAAG,OAAO,CAQV"}

package/dist/esm/utils/semverUtils.js

@@ -0,0 +1,52 @@
+/**
+ * Lightweight semantic version utilities.
+ */
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a semver-like version string (e.g. "13.14.0") into a triple.
+ * Returns `null` if the string is not a valid version.
+ */
+export function parseSemanticVersion(raw) {
+    const parts = raw.trim().split(".");
+    if (parts.length < 3)
+        return null;
+    const major = parseInt(parts[0], 10);
+    const minor = parseInt(parts[1], 10);
+    const patch = parseInt(parts[2], 10);
+    if (Number.isNaN(major) ||
+        Number.isNaN(minor) ||
+        Number.isNaN(patch) ||
+        major < 0 ||
+        minor < 0 ||
+        patch < 0) {
+        return null;
+    }
+    return [major, minor, patch];
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format a `SemanticVersion` as a `"major.minor.patch"` string.
+ */
+export function formatVersion(version) {
+    return `${version[0]}.${version[1]}.${version[2]}`;
+}
+// ---------------------------------------------------------------------------
+// Comparison
+// ---------------------------------------------------------------------------
+/**
+ * Returns `true` if `version` is greater than or equal to `minVersion`.
+ */
+export function satisfiesMinVersion({ version, minVersion, }) {
+    const [serverVersionMajor, serverVersionMinor, serverVersionPatch] = version;
+    const [minVersionMajor, minVersionMinor, minVersionPatch] = minVersion;
+    if (serverVersionMajor !== minVersionMajor)
+        return serverVersionMajor > minVersionMajor;
+    if (serverVersionMinor !== minVersionMinor)
+        return serverVersionMinor > minVersionMinor;
+    return serverVersionPatch >= minVersionPatch;
+}
+//# sourceMappingURL=semverUtils.js.map

package/dist/esm/utils/semverUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semverUtils.js","sourceRoot":"","sources":["../../../src/utils/semverUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IACtC,IACE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QACnB,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC,EACT,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,OAAO,EACP,UAAU,GAIX;IACC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,OAAO,CAAC;IAC7E,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE,eAAe,CAAC,GAAG,UAAU,CAAC;IACvE,IAAI,kBAAkB,KAAK,eAAe;QACxC,OAAO,kBAAkB,GAAG,eAAe,CAAC;IAC9C,IAAI,kBAAkB,KAAK,eAAe;QACxC,OAAO,kBAAkB,GAAG,eAAe,CAAC;IAC9C,OAAO,kBAAkB,IAAI,eAAe,CAAC;AAC/C,CAAC"}

package/dist/esm/utils/serverVersionUtils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Phoenix server version utilities.
+ *
+ * Provides guards for capabilities that require a minimum Phoenix **server**
+ * version.  The server version is detected from the
+ * `x-phoenix-server-version` response header or by calling
+ * `GET /arize_phoenix_version`.
+ *
+ * ## Capability guard pattern
+ *
+ * Each server-side feature that was introduced after the initial release is
+ * represented by a {@link CapabilityRequirement} constant (defined in
+ * `constants/serverRequirements`).  Before calling such a feature, the client
+ * passes the requirement to {@link ensureServerCapability}, which compares the
+ * connected server's version against the requirement's minimum version and
+ * throws a descriptive error when the server is too old.  This lets callers
+ * see *exactly* which feature is unavailable and which version they need,
+ * rather than receiving an opaque HTTP 404 or 400 response.
+ */
+import type { PhoenixClient } from "../client.js";
+import type { CapabilityRequirement } from "../types/serverRequirements.js";
+/**
+ * Derive a human-readable label from a structured capability requirement.
+ * Uses `description` if provided, otherwise auto-derives from metadata.
+ */
+export declare function capabilityLabel(req: CapabilityRequirement): string;
+/**
+ * Check the **Phoenix server version** before allowing a capability to proceed.
+ *
+ * Throws if the connected Phoenix server is older than the minimum version
+ * required by the given capability. Also throws if the server version cannot
+ * be determined — this typically means the server is too old to report its
+ * version at all and is therefore incompatible with this client.
+ *
+ * @example
+ * ```ts
+ * import { ensureServerCapability } from "../utils/serverVersionUtils.js";
+ * import { GET_SESSION } from "../constants/serverRequirements.js";
+ *
+ * await ensureServerCapability({ client, requirement: GET_SESSION });
+ * ```
+ */
+export declare function ensureServerCapability({ client, requirement, }: {
+    client: PhoenixClient;
+    requirement: CapabilityRequirement;
+}): Promise<void>;
+//# sourceMappingURL=serverVersionUtils.d.ts.map

package/dist/esm/utils/serverVersionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverVersionUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/serverVersionUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAOzE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAQlE;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,WAAW,GACZ,EAAE;IACD,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,qBAAqB,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/dist/esm/utils/serverVersionUtils.js

@@ -0,0 +1,64 @@
+/**
+ * Phoenix server version utilities.
+ *
+ * Provides guards for capabilities that require a minimum Phoenix **server**
+ * version.  The server version is detected from the
+ * `x-phoenix-server-version` response header or by calling
+ * `GET /arize_phoenix_version`.
+ *
+ * ## Capability guard pattern
+ *
+ * Each server-side feature that was introduced after the initial release is
+ * represented by a {@link CapabilityRequirement} constant (defined in
+ * `constants/serverRequirements`).  Before calling such a feature, the client
+ * passes the requirement to {@link ensureServerCapability}, which compares the
+ * connected server's version against the requirement's minimum version and
+ * throws a descriptive error when the server is too old.  This lets callers
+ * see *exactly* which feature is unavailable and which version they need,
+ * rather than receiving an opaque HTTP 404 or 400 response.
+ */
+import { formatVersion, satisfiesMinVersion } from "./semverUtils.js";
+// ---------------------------------------------------------------------------
+// Capability label
+// ---------------------------------------------------------------------------
+/**
+ * Derive a human-readable label from a structured capability requirement.
+ * Uses `description` if provided, otherwise auto-derives from metadata.
+ */
+export function capabilityLabel(req) {
+    if (req.description)
+        return req.description;
+    switch (req.kind) {
+        case "route":
+            return `The ${req.method} ${req.path} route`;
+        case "parameter":
+            return `The '${req.parameterName}' ${req.parameterLocation} parameter on ${req.route}`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Guards
+// ---------------------------------------------------------------------------
+/**
+ * Check the **Phoenix server version** before allowing a capability to proceed.
+ *
+ * Throws if the connected Phoenix server is older than the minimum version
+ * required by the given capability. Also throws if the server version cannot
+ * be determined — this typically means the server is too old to report its
+ * version at all and is therefore incompatible with this client.
+ *
+ * @example
+ * ```ts
+ * import { ensureServerCapability } from "../utils/serverVersionUtils.js";
+ * import { GET_SESSION } from "../constants/serverRequirements.js";
+ *
+ * await ensureServerCapability({ client, requirement: GET_SESSION });
+ * ```
+ */
+export async function ensureServerCapability({ client, requirement, }) {
+    const version = await client.getServerVersion();
+    if (!satisfiesMinVersion({ version, minVersion: requirement.minServerVersion })) {
+        throw new Error(`${capabilityLabel(requirement)} requires Phoenix server >= ${formatVersion(requirement.minServerVersion)}, ` +
+            `but connected to server ${formatVersion(version)}. Please upgrade your Phoenix server.`);
+    }
+}
+//# sourceMappingURL=serverVersionUtils.js.map

package/dist/esm/utils/serverVersionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverVersionUtils.js","sourceRoot":"","sources":["../../../src/utils/serverVersionUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEnE,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAA0B;IACxD,IAAI,GAAG,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC;IAC5C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC;QAC/C,KAAK,WAAW;YACd,OAAO,QAAQ,GAAG,CAAC,aAAa,KAAK,GAAG,CAAC,iBAAiB,iBAAiB,GAAG,CAAC,KAAK,EAAE,CAAC;IAC3F,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAC3C,MAAM,EACN,WAAW,GAIZ;IACC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAChD,IACE,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,gBAAgB,EAAE,CAAC,EAC3E,CAAC;QACD,MAAM,IAAI,KAAK,CACb,GAAG,eAAe,CAAC,WAAW,CAAC,+BAA+B,aAAa,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAI;YAC3G,2BAA2B,aAAa,CAAC,OAAO,CAAC,uCAAuC,CAC3F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/__generated__/api/v1.d.ts

@@ -423,6 +423,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/projects/{project_identifier}/traces": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List traces for a project */
+        get: operations["listProjectTraces"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/trace_annotations": {
         parameters: {
             query?: never;
@@ -1561,6 +1578,13 @@ export interface components {
             /** Next Cursor */
             next_cursor: string | null;
         };
+        /** GetTracesResponseBody */
+        GetTracesResponseBody: {
+            /** Data */
+            data: components["schemas"]["TraceData"][];
+            /** Next Cursor */
+            next_cursor: string | null;
+        };
         /** GetUsersResponseBody */
         GetUsersResponseBody: {
             /** Data */
@@ -3209,6 +3233,52 @@ export interface components {
             /** Next Cursor */
             next_cursor: string | null;
         };
+        /** TraceData */
+        TraceData: {
+            /** Id */
+            id: string;
+            /** Trace Id */
+            trace_id: string;
+            /** Project Id */
+            project_id: string;
+            /**
+             * Start Time
+             * Format: date-time
+             */
+            start_time: string;
+            /**
+             * End Time
+             * Format: date-time
+             */
+            end_time: string;
+            /** Spans */
+            spans?: components["schemas"]["TraceSpanData"][] | null;
+        };
+        /** TraceSpanData */
+        TraceSpanData: {
+            /** Id */
+            id: string;
+            /** Span Id */
+            span_id: string;
+            /** Parent Id */
+            parent_id: string | null;
+            /** Name */
+            name: string;
+            /** Span Kind */
+            span_kind: string;
+            /** Status Code */
+            status_code: string;
+            /**
+             * Start Time
+             * Format: date-time
+             */
+            start_time: string;
+            /**
+             * End Time
+             * Format: date-time
+             */
+            end_time: string;
+        };
         /** UpdateAnnotationConfigResponseBody */
         UpdateAnnotationConfigResponseBody: {
             /** Data */
@@ -3937,6 +4007,8 @@ export interface operations {
                     "metadata_keys[]"?: string[];
                     /** @description Column names for auto-assigning examples to splits */
                     "split_keys[]"?: string[];
+                    /** @description Column names whose object values should be flattened into their selected bucket */
+                    "flatten_keys[]"?: string[];
                     /** @description Column name for span IDs to link examples back to spans */
                     span_id_key?: string;
                     /** Format: binary */
@@ -4743,6 +4815,73 @@ export interface operations {
             };
         };
     };
+    listProjectTraces: {
+        parameters: {
+            query?: {
+                /** @description Inclusive lower bound on trace start time (ISO 8601) */
+                start_time?: string | null;
+                /** @description Exclusive upper bound on trace start time (ISO 8601) */
+                end_time?: string | null;
+                /** @description Sort field */
+                sort?: "start_time" | "latency_ms";
+                /** @description Sort direction */
+                order?: "asc" | "desc";
+                /** @description Maximum number of traces to return */
+                limit?: number;
+                /** @description Pagination cursor (Trace GlobalID) */
+                cursor?: string | null;
+                /** @description If true, include full span details for each trace. This significantly increases response size and query latency, especially with large page sizes. Prefer fetching spans lazily for individual traces when possible. */
+                include_spans?: boolean;
+                /** @description List of session identifiers to filter traces by. Each value can be either a session_id string or a session GlobalID. Only traces belonging to the specified sessions will be returned. */
+                session_identifier?: string[] | null;
+            };
+            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"]["GetTracesResponseBody"];
+                };
+            };
+            /** @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;
+                };
+            };
+        };
+    };
     annotateTraces: {
         parameters: {
             query?: {
@@ -4860,6 +4999,10 @@ export interface operations {
                 trace_id?: string[] | null;
                 /** @description Filter by parent span ID. Use "null" to get root spans only. */
                 parent_id?: string | null;
+                /** @description Filter by span name(s) */
+                name?: string[] | null;
+                /** @description Filter by status code(s). Values: OK, ERROR, UNSET */
+                status_code?: string[] | null;
             };
             header?: never;
             path: {
@@ -4923,6 +5066,12 @@ export interface operations {
                 trace_id?: string[] | null;
                 /** @description Filter by parent span ID. Use "null" to get root spans only. */
                 parent_id?: string | null;
+                /** @description Filter by span name(s) */
+                name?: string[] | null;
+                /** @description Filter by span kind(s). Values: LLM, CHAIN, TOOL, RETRIEVER, EMBEDDING, AGENT, RERANKER, GUARDRAIL, EVALUATOR, UNKNOWN */
+                span_kind?: string[] | null;
+                /** @description Filter by status code(s). Values: OK, ERROR, UNSET */
+                status_code?: string[] | null;
             };
             header?: never;
             path: {