@arizeai/phoenix-client 6.5.0 → 6.5.2

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

@@ -0,0 +1,11 @@
+import type { OpenInferenceSpanKind } from "@arizeai/openinference-semantic-conventions";
+/**
+ * Status codes for spans.
+ */
+export type SpanStatusCode = "OK" | "ERROR" | "UNSET";
+/**
+ * Span kind filter value. Accepts well-known OpenInference span kinds
+ * as well as arbitrary strings for forward-compatibility.
+ */
+export type SpanKindFilter = OpenInferenceSpanKind | (string & {});
+//# sourceMappingURL=spans.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spans.d.ts","sourceRoot":"","sources":["../../../src/types/spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC"}

package/dist/esm/types/spans.js

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

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

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

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

@@ -18,6 +18,8 @@ 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;
+export declare const GET_SPANS_FILTERS: ParameterRequirement;
+export declare const LIST_PROJECT_TRACES: RouteRequirement;
 /**
  * Aggregate list of every known capability requirement.
  *

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

@@ -1 +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"}
+{"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,eAAO,MAAM,iBAAiB,EAAE,oBAM/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,qBAAqB,EASnD,CAAC"}

package/dist/src/constants/serverRequirements.js

@@ -13,7 +13,7 @@
  * 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.ALL_REQUIREMENTS = exports.LIST_PROJECT_TRACES = exports.GET_SPANS_FILTERS = 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",
@@ -51,6 +51,19 @@ exports.GET_SPANS_TRACE_IDS = {
     route: "GET /v1/projects/{id}/spans",
     minServerVersion: [13, 9, 0],
 };
+exports.GET_SPANS_FILTERS = {
+    kind: "parameter",
+    parameterName: "span_kind",
+    parameterLocation: "query",
+    route: "GET /v1/projects/{id}/spans",
+    minServerVersion: [13, 15, 0],
+};
+exports.LIST_PROJECT_TRACES = {
+    kind: "route",
+    method: "GET",
+    path: "/v1/projects/{project_identifier}/traces",
+    minServerVersion: [13, 15, 0],
+};
 /**
  * Aggregate list of every known capability requirement.
  *
@@ -64,5 +77,7 @@ exports.ALL_REQUIREMENTS = [
     exports.LIST_PROJECT_SESSIONS,
     exports.ANNOTATE_SESSIONS,
     exports.GET_SPANS_TRACE_IDS,
+    exports.GET_SPANS_FILTERS,
+    exports.LIST_PROJECT_TRACES,
 ];
 //# sourceMappingURL=serverRequirements.js.map

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

@@ -1 +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"}
+{"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;AAEW,QAAA,iBAAiB,GAAyB;IACrD,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,WAAW;IAC1B,iBAAiB,EAAE,OAAO;IAC1B,KAAK,EAAE,6BAA6B;IACpC,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEW,QAAA,mBAAmB,GAAqB;IACnD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,0CAA0C;IAChD,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACU,QAAA,gBAAgB,GAAqC;IAChE,mBAAW;IACX,sBAAc;IACd,uBAAe;IACf,6BAAqB;IACrB,yBAAiB;IACjB,2BAAmB;IACnB,yBAAiB;IACjB,2BAAmB;CACX,CAAC"}

package/dist/src/prompts/sdks/toAI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toAI.d.ts","sourceRoot":"","sources":["../../../../src/prompts/sdks/toAI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAK5D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB;;QAEI;IACJ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;SAEK;IACL,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,SAAS,EAAE,wBAGvC,UAAU,CAAC,CAAC,CAAC,KAAG,eAAe,GAAG,IAyDpC,CAAC"}
+{"version":3,"file":"toAI.d.ts","sourceRoot":"","sources":["../../../../src/prompts/sdks/toAI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAU5D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB;;QAEI;IACJ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;SAEK;IACL,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,SAAS,EAAE,wBAGvC,UAAU,CAAC,CAAC,CAAC,KAAG,eAAe,GAAG,IA8EpC,CAAC"}

package/dist/src/prompts/sdks/toAI.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toAI = void 0;
 const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
 const converters_1 = require("../../schemas/llm/converters");
+const utils_1 = require("../../schemas/llm/utils");
 const formatPromptMessages_1 = require("../../utils/formatPromptMessages");
 /**
  * Converts a Phoenix prompt to Vercel AI sdk params.
@@ -14,7 +15,7 @@ const formatPromptMessages_1 = require("../../utils/formatPromptMessages");
  *   via `jsonSchema()`, through the `schema` argument.
  */
 const toAI = ({ prompt, variables, }) => {
-    var _a, _b;
+    var _a, _b, _c;
     // eslint-disable-next-line no-console
     console.warn("Prompt invocation parameters not currently supported in AI SDK, falling back to default invocation parameters");
     try {
@@ -37,14 +38,34 @@ const toAI = ({ prompt, variables, }) => {
             (0, tiny_invariant_1.default)(vercelAIMessage, "Message is not valid");
             return vercelAIMessage;
         });
-        const tools = undefined;
-        if (((_a = prompt.tools) === null || _a === void 0 ? void 0 : _a.tools) && ((_b = prompt.tools) === null || _b === void 0 ? void 0 : _b.tools.length)) {
-            // eslint-disable-next-line no-console
-            console.warn("Phoenix client does not automatically convert tools to AI SDK tools, please manually convert them.");
+        let tools;
+        if (((_a = prompt.tools) === null || _a === void 0 ? void 0 : _a.tools) && prompt.tools.tools.length > 0) {
+            const toolsRecord = {};
+            for (const tool of prompt.tools.tools) {
+                const name = (0, utils_1.findToolDefinitionName)(tool);
+                (0, tiny_invariant_1.default)(name, "Tool definition name is not valid");
+                const converted = (0, converters_1.safelyConvertToolDefinitionToProvider)({
+                    toolDefinition: tool,
+                    targetProvider: "VERCEL_AI",
+                });
+                (0, tiny_invariant_1.default)(converted, "Tool definition is not valid");
+                toolsRecord[name] = converted;
+            }
+            tools =
+                Object.keys(toolsRecord).length > 0
+                    ? toolsRecord
+                    : undefined;
+        }
+        let toolChoice;
+        if (tools && ((_b = prompt.tools) === null || _b === void 0 ? void 0 : _b.tool_choice)) {
+            toolChoice =
+                (_c = (0, converters_1.safelyConvertToolChoiceToProvider)({
+                    toolChoice: prompt.tools.tool_choice,
+                    targetProvider: "VERCEL_AI",
+                })) !== null && _c !== void 0 ? _c : undefined;
         }
         // combine base and computed params
-        const completionParams = Object.assign(Object.assign({}, baseCompletionParams), { messages,
-            tools });
+        const completionParams = Object.assign(Object.assign(Object.assign(Object.assign({}, baseCompletionParams), { messages }), (tools !== undefined && { tools })), (toolChoice !== undefined && { toolChoice }));
         return completionParams;
     }
     catch (error) {

package/dist/src/prompts/sdks/toAI.js.map

@@ -1 +1 @@
-{"version":3,"file":"toAI.js","sourceRoot":"","sources":["../../../../src/prompts/sdks/toAI.ts"],"names":[],"mappings":";;;;;;AACA,oEAAuC;AAEvC,6DAA8E;AAC9E,2EAAwE;AAiBxE;;;;;GAKG;AACI,MAAM,IAAI,GAAG,CAAsB,EACxC,MAAM,EACN,SAAS,GACK,EAA0B,EAAE;;IAC1C,sCAAsC;IACtC,OAAO,CAAC,IAAI,CACV,+GAA+G,CAChH,CAAC;IACF,IAAI,CAAC;QACH,sEAAsE;QACtE,MAAM,oBAAoB,GAA6B;QACrD,0DAA0D;SAC3D,CAAC;QAEF,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAEjD,IAAI,SAAS,EAAE,CAAC;YACd,iBAAiB,GAAG,IAAA,2CAAoB,EACtC,MAAM,CAAC,eAAe,EACtB,iBAAiB,EACjB,SAAS,CACV,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAmB,iBAAiB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACjE,MAAM,eAAe,GAAG,IAAA,2CAA8B,EAAC;gBACrD,OAAO;gBACP,cAAc,EAAE,WAAW;aAC5B,CAAC,CAAC;YACH,IAAA,wBAAS,EAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC;YACnD,OAAO,eAAe,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,SAAS,CAAC;QACxB,IAAI,CAAA,MAAA,MAAM,CAAC,KAAK,0CAAE,KAAK,MAAI,MAAA,MAAM,CAAC,KAAK,0CAAE,KAAK,CAAC,MAAM,CAAA,EAAE,CAAC;YACtD,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACV,oGAAoG,CACrG,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,MAAM,gBAAgB,mCACjB,oBAAoB,KACvB,QAAQ;YACR,KAAK,GACN,CAAC;QAEF,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACtD,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AA5DW,QAAA,IAAI,QA4Df"}
+{"version":3,"file":"toAI.js","sourceRoot":"","sources":["../../../../src/prompts/sdks/toAI.ts"],"names":[],"mappings":"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"}

package/dist/src/spans/getSpans.d.ts

@@ -1,6 +1,7 @@
 import type { operations } from "../__generated__/api/v1";
 import type { ClientFn } from "../types/core";
 import type { ProjectIdentifier } from "../types/projects";
+import type { SpanKindFilter, SpanStatusCode } from "../types/spans";
 /**
  * Parameters to get spans from a project using auto-generated types
  */
@@ -19,6 +20,12 @@ export interface GetSpansParams extends ClientFn {
     traceIds?: string[] | null;
     /** Filter by parent span ID. Use `null` or the string `"null"` to get root spans only. */
     parentId?: string | null;
+    /** Filter by span name(s) */
+    name?: string | string[] | null;
+    /** Filter by span kind(s) (LLM, CHAIN, TOOL, RETRIEVER, etc.) */
+    spanKind?: SpanKindFilter | SpanKindFilter[] | null;
+    /** Filter by status code(s) (OK, ERROR, UNSET) */
+    statusCode?: SpanStatusCode | SpanStatusCode[] | null;
 }
 export type GetSpansResponse = operations["getSpans"]["responses"]["200"];
 export type GetSpansResult = {
@@ -86,5 +93,5 @@ export type GetSpansResult = {
  * } while (cursor);
  * ```
  */
-export declare function getSpans({ client: _client, project, cursor, limit, startTime, endTime, traceIds, parentId, }: GetSpansParams): Promise<GetSpansResult>;
+export declare function getSpans({ client: _client, project, cursor, limit, startTime, endTime, traceIds, parentId, name, spanKind, statusCode, }: GetSpansParams): Promise<GetSpansResult>;
 //# sourceMappingURL=getSpans.d.ts.map

package/dist/src/spans/getSpans.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getSpans.d.ts","sourceRoot":"","sources":["../../../src/spans/getSpans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,oCAAoC;IACpC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kFAAkF;IAClF,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,kFAAkF;IAClF,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;AAE1E,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/D,UAAU,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,aAAa,CAAC,CAAC;CAC5E,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAsB,QAAQ,CAAC,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,MAAM,EACN,KAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAiD1C"}
+{"version":3,"file":"getSpans.d.ts","sourceRoot":"","sources":["../../../src/spans/getSpans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,oCAAoC;IACpC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kFAAkF;IAClF,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,kFAAkF;IAClF,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC;IACpD,kDAAkD;IAClD,UAAU,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;AAE1E,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/D,UAAU,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,aAAa,CAAC,CAAC;CAC5E,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAsB,QAAQ,CAAC,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,MAAM,EACN,KAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,UAAU,GACX,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAgE1C"}

package/dist/src/spans/getSpans.js

@@ -66,12 +66,15 @@ const serverVersionUtils_1 = require("../utils/serverVersionUtils");
  * } while (cursor);
  * ```
  */
-async function getSpans({ client: _client, project, cursor, limit = 100, startTime, endTime, traceIds, parentId, }) {
+async function getSpans({ client: _client, project, cursor, limit = 100, startTime, endTime, traceIds, parentId, name, spanKind, statusCode, }) {
     var _a, _b;
     const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
     if (traceIds) {
         await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.GET_SPANS_TRACE_IDS });
     }
+    if (name != null || spanKind != null || statusCode != null) {
+        await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.GET_SPANS_FILTERS });
+    }
     const projectIdentifier = (0, projects_1.resolveProjectIdentifier)(project);
     const params = {
         limit,
@@ -92,6 +95,15 @@ async function getSpans({ client: _client, project, cursor, limit = 100, startTi
     if (parentId !== undefined) {
         params.parent_id = parentId === null ? "null" : parentId;
     }
+    if (name) {
+        params.name = Array.isArray(name) ? name : [name];
+    }
+    if (spanKind) {
+        params.span_kind = Array.isArray(spanKind) ? spanKind : [spanKind];
+    }
+    if (statusCode) {
+        params.status_code = Array.isArray(statusCode) ? statusCode : [statusCode];
+    }
     const { data, error } = await client.GET("/v1/projects/{project_identifier}/spans", {
         params: {
             path: {

package/dist/src/spans/getSpans.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSpans.js","sourceRoot":"","sources":["../../../src/spans/getSpans.ts"],"names":[],"mappings":";;AAgGA,4BA0DC;AAzJD,sCAAyC;AACzC,wEAAsE;AAGtE,gDAA6D;AAC7D,oEAAqE;AA6BrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACI,KAAK,UAAU,QAAQ,CAAC,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,MAAM,EACN,KAAK,GAAG,GAAG,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,GACO;;IACf,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,wCAAmB,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,iBAAiB,GAAG,IAAA,mCAAwB,EAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,MAAM,GAA+D;QACzE,KAAK;KACN,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,UAAU;YACf,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,QAAQ,GAAG,OAAO,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9E,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3D,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACtC,yCAAyC,EACzC;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,iBAAiB;aACtC;YACD,KAAK,EAAE,MAAM;SACd;KACF,CACF,CAAC;IAEF,IAAI,KAAK;QAAE,MAAM,KAAK,CAAC;IACvB,OAAO;QACL,KAAK,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,mCAAI,EAAE;QACvB,UAAU,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,mCAAI,IAAI;KACtC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getSpans.js","sourceRoot":"","sources":["../../../src/spans/getSpans.ts"],"names":[],"mappings":";;AA0GA,4BA4EC;AArLD,sCAAyC;AACzC,wEAGyC;AAGzC,gDAA6D;AAE7D,oEAAqE;AAmCrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACI,KAAK,UAAU,QAAQ,CAAC,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,MAAM,EACN,KAAK,GAAG,GAAG,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,UAAU,GACK;;IACf,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,wCAAmB,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QAC3D,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,sCAAiB,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,iBAAiB,GAAG,IAAA,mCAAwB,EAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,MAAM,GAA+D;QACzE,KAAK;KACN,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,UAAU;YACf,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,QAAQ,GAAG,OAAO,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9E,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3D,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACtC,yCAAyC,EACzC;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,iBAAiB;aACtC;YACD,KAAK,EAAE,MAAM;SACd;KACF,CACF,CAAC;IAEF,IAAI,KAAK;QAAE,MAAM,KAAK,CAAC;IACvB,OAAO;QACL,KAAK,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,mCAAI,EAAE;QACvB,UAAU,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,mCAAI,IAAI;KACtC,CAAC;AACJ,CAAC"}

package/dist/src/spans/index.d.ts

@@ -4,6 +4,7 @@ export * from "./logSpanAnnotations";
 export * from "./addDocumentAnnotation";
 export * from "./logDocumentAnnotations";
 export * from "./getSpans";
+export type { SpanKindFilter, SpanStatusCode } from "../types/spans";
 export * from "./getSpanAnnotations";
 export * from "./deleteSpan";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/spans/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spans/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spans/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spans/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,gDAA8B;AAC9B,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,6CAA2B;AAC3B,uDAAqC;AACrC,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spans/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,gDAA8B;AAC9B,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,6CAA2B;AAE3B,uDAAqC;AACrC,+CAA6B"}

package/dist/src/traces/getTraces.d.ts

@@ -0,0 +1,78 @@
+import type { operations } from "../__generated__/api/v1";
+import type { ClientFn } from "../types/core";
+import type { ProjectIdentifier } from "../types/projects";
+/**
+ * Parameters for getting traces from a project.
+ */
+export interface GetTracesParams extends ClientFn {
+    /** The project to get traces from */
+    project: ProjectIdentifier;
+    /** Inclusive lower bound time. Must be a valid ISO 8601 string or Date object. */
+    startTime?: Date | string | null;
+    /** Exclusive upper bound time. Must be a valid ISO 8601 string or Date object. */
+    endTime?: Date | string | null;
+    /** Sort field */
+    sort?: "start_time" | "latency_ms";
+    /** Sort direction */
+    order?: "asc" | "desc";
+    /** Maximum number of traces to return */
+    limit?: number;
+    /** Pagination cursor (Trace GlobalID) */
+    cursor?: string | null;
+    /** If true, include full span details for each trace */
+    includeSpans?: boolean;
+    /** Filter traces by session identifier(s) (session_id strings or GlobalIDs) */
+    sessionId?: string | string[] | null;
+}
+export type GetTracesResponse = operations["listProjectTraces"]["responses"]["200"];
+export type GetTracesResult = {
+    traces: GetTracesResponse["content"]["application/json"]["data"];
+    nextCursor: GetTracesResponse["content"]["application/json"]["next_cursor"];
+};
+/**
+ * Get traces from a project with filtering and sorting options.
+ *
+ * This method fetches traces from a project with support for time range filtering,
+ * sorting, session filtering, and cursor-based pagination.
+ *
+ * @requires Phoenix server >= 13.15.0
+ *
+ * @param params - The parameters to get traces
+ * @returns A paginated response containing traces and optional next cursor
+ *
+ * @example
+ * ```ts
+ * // Get recent traces from a project
+ * const result = await getTraces({
+ *   client,
+ *   project: { projectName: "my-project" },
+ *   limit: 50,
+ * });
+ *
+ * // Get traces in a time range with spans included
+ * const result = await getTraces({
+ *   client,
+ *   project: { projectName: "my-project" },
+ *   startTime: new Date("2024-01-01"),
+ *   endTime: new Date("2024-01-02"),
+ *   includeSpans: true,
+ * });
+ *
+ * // Paginate through results
+ * let cursor: string | undefined;
+ * do {
+ *   const result = await getTraces({
+ *     client,
+ *     project: { projectName: "my-project" },
+ *     cursor,
+ *     limit: 100,
+ *   });
+ *   result.traces.forEach(trace => {
+ *     console.log(`Trace: ${trace.trace_id}`);
+ *   });
+ *   cursor = result.nextCursor || undefined;
+ * } while (cursor);
+ * ```
+ */
+export declare function getTraces({ client: _client, project, cursor, limit, startTime, endTime, sort, order, includeSpans, sessionId, }: GetTracesParams): Promise<GetTracesResult>;
+//# sourceMappingURL=getTraces.d.ts.map

package/dist/src/traces/getTraces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTraces.d.ts","sourceRoot":"","sources":["../../../src/traces/getTraces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C,qCAAqC;IACrC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kFAAkF;IAClF,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,kFAAkF;IAClF,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB;IACjB,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;IACnC,qBAAqB;IACrB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,iBAAiB,GAC3B,UAAU,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IACjE,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,aAAa,CAAC,CAAC;CAC7E,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAsB,SAAS,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,MAAM,EACN,KAAW,EACX,SAAS,EACT,OAAO,EACP,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,SAAS,GACV,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CA2D5C"}

package/dist/src/traces/getTraces.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTraces = getTraces;
+const client_1 = require("../client");
+const serverRequirements_1 = require("../constants/serverRequirements");
+const projects_1 = require("../types/projects");
+const serverVersionUtils_1 = require("../utils/serverVersionUtils");
+/**
+ * Get traces from a project with filtering and sorting options.
+ *
+ * This method fetches traces from a project with support for time range filtering,
+ * sorting, session filtering, and cursor-based pagination.
+ *
+ * @requires Phoenix server >= 13.15.0
+ *
+ * @param params - The parameters to get traces
+ * @returns A paginated response containing traces and optional next cursor
+ *
+ * @example
+ * ```ts
+ * // Get recent traces from a project
+ * const result = await getTraces({
+ *   client,
+ *   project: { projectName: "my-project" },
+ *   limit: 50,
+ * });
+ *
+ * // Get traces in a time range with spans included
+ * const result = await getTraces({
+ *   client,
+ *   project: { projectName: "my-project" },
+ *   startTime: new Date("2024-01-01"),
+ *   endTime: new Date("2024-01-02"),
+ *   includeSpans: true,
+ * });
+ *
+ * // Paginate through results
+ * let cursor: string | undefined;
+ * do {
+ *   const result = await getTraces({
+ *     client,
+ *     project: { projectName: "my-project" },
+ *     cursor,
+ *     limit: 100,
+ *   });
+ *   result.traces.forEach(trace => {
+ *     console.log(`Trace: ${trace.trace_id}`);
+ *   });
+ *   cursor = result.nextCursor || undefined;
+ * } while (cursor);
+ * ```
+ */
+async function getTraces({ client: _client, project, cursor, limit = 100, startTime, endTime, sort, order, includeSpans, sessionId, }) {
+    var _a, _b;
+    const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
+    await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.LIST_PROJECT_TRACES });
+    const projectIdentifier = (0, projects_1.resolveProjectIdentifier)(project);
+    const params = {
+        limit,
+    };
+    if (cursor) {
+        params.cursor = cursor;
+    }
+    if (startTime) {
+        params.start_time =
+            startTime instanceof Date ? startTime.toISOString() : startTime;
+    }
+    if (endTime) {
+        params.end_time = endTime instanceof Date ? endTime.toISOString() : endTime;
+    }
+    if (sort) {
+        params.sort = sort;
+    }
+    if (order) {
+        params.order = order;
+    }
+    if (includeSpans) {
+        params.include_spans = true;
+    }
+    if (sessionId) {
+        params.session_identifier = Array.isArray(sessionId)
+            ? sessionId
+            : [sessionId];
+    }
+    const { data, error } = await client.GET("/v1/projects/{project_identifier}/traces", {
+        params: {
+            path: {
+                project_identifier: projectIdentifier,
+            },
+            query: params,
+        },
+    });
+    if (error)
+        throw error;
+    return {
+        traces: (_a = data === null || data === void 0 ? void 0 : data.data) !== null && _a !== void 0 ? _a : [],
+        nextCursor: (_b = data === null || data === void 0 ? void 0 : data.next_cursor) !== null && _b !== void 0 ? _b : null,
+    };
+}
+//# sourceMappingURL=getTraces.js.map

package/dist/src/traces/getTraces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTraces.js","sourceRoot":"","sources":["../../../src/traces/getTraces.ts"],"names":[],"mappings":";;AAqFA,8BAsEC;AA1JD,sCAAyC;AACzC,wEAAsE;AAGtE,gDAA6D;AAC7D,oEAAqE;AAkCrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACI,KAAK,UAAU,SAAS,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,OAAO,EACP,MAAM,EACN,KAAK,GAAG,GAAG,EACX,SAAS,EACT,OAAO,EACP,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,SAAS,GACO;;IAChB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,wCAAmB,EAAE,CAAC,CAAC;IAC3E,MAAM,iBAAiB,GAAG,IAAA,mCAAwB,EAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,MAAM,GAER;QACF,KAAK;KACN,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,UAAU;YACf,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,QAAQ,GAAG,OAAO,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9E,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YAClD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACtC,0CAA0C,EAC1C;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,kBAAkB,EAAE,iBAAiB;aACtC;YACD,KAAK,EAAE,MAAM;SACd;KACF,CACF,CAAC;IAEF,IAAI,KAAK;QAAE,MAAM,KAAK,CAAC;IACvB,OAAO;QACL,MAAM,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,mCAAI,EAAE;QACxB,UAAU,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,mCAAI,IAAI;KACtC,CAAC;AACJ,CAAC"}

package/dist/src/traces/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./getTraces";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/traces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/traces/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/src/traces/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./getTraces"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B"}

package/dist/src/types/spans.d.ts

@@ -0,0 +1,11 @@
+import type { OpenInferenceSpanKind } from "@arizeai/openinference-semantic-conventions";
+/**
+ * Status codes for spans.
+ */
+export type SpanStatusCode = "OK" | "ERROR" | "UNSET";
+/**
+ * Span kind filter value. Accepts well-known OpenInference span kinds
+ * as well as arbitrary strings for forward-compatibility.
+ */
+export type SpanKindFilter = OpenInferenceSpanKind | (string & {});
+//# sourceMappingURL=spans.d.ts.map

package/dist/src/types/spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.d.ts","sourceRoot":"","sources":["../../../src/types/spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC"}

package/dist/src/types/spans.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=spans.js.map

package/dist/src/types/spans.js.map

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