@arizeai/phoenix-client 7.6.0 → 7.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +27 -3
  3. package/dist/esm/__generated__/api/v1.d.ts +1 -1
  4. package/dist/esm/__generated__/api/v1.d.ts.map +1 -1
  5. package/dist/esm/constants/serverRequirements.d.ts +1 -0
  6. package/dist/esm/constants/serverRequirements.d.ts.map +1 -1
  7. package/dist/esm/constants/serverRequirements.js +7 -0
  8. package/dist/esm/constants/serverRequirements.js.map +1 -1
  9. package/dist/esm/experiments/resumeEvaluation.d.ts +0 -60
  10. package/dist/esm/experiments/resumeEvaluation.d.ts.map +1 -1
  11. package/dist/esm/experiments/resumeEvaluation.js +44 -37
  12. package/dist/esm/experiments/resumeEvaluation.js.map +1 -1
  13. package/dist/esm/experiments/resumeExperiment.d.ts +0 -52
  14. package/dist/esm/experiments/resumeExperiment.d.ts.map +1 -1
  15. package/dist/esm/experiments/resumeExperiment.js +42 -35
  16. package/dist/esm/experiments/resumeExperiment.js.map +1 -1
  17. package/dist/esm/experiments/runExperiment.d.ts.map +1 -1
  18. package/dist/esm/experiments/runExperiment.js +152 -123
  19. package/dist/esm/experiments/runExperiment.js.map +1 -1
  20. package/dist/esm/projects/index.d.ts +1 -0
  21. package/dist/esm/projects/index.d.ts.map +1 -1
  22. package/dist/esm/projects/index.js +1 -0
  23. package/dist/esm/projects/index.js.map +1 -1
  24. package/dist/esm/projects/setProjectRetentionPolicy.d.ts +49 -0
  25. package/dist/esm/projects/setProjectRetentionPolicy.d.ts.map +1 -0
  26. package/dist/esm/projects/setProjectRetentionPolicy.js +52 -0
  27. package/dist/esm/projects/setProjectRetentionPolicy.js.map +1 -0
  28. package/dist/esm/prompts/sdks/toOpenAI.d.ts.map +1 -1
  29. package/dist/esm/prompts/sdks/toOpenAI.js +49 -58
  30. package/dist/esm/prompts/sdks/toOpenAI.js.map +1 -1
  31. package/dist/esm/sessions/sessionUtils.d.ts.map +1 -1
  32. package/dist/esm/sessions/sessionUtils.js +3 -0
  33. package/dist/esm/sessions/sessionUtils.js.map +1 -1
  34. package/dist/esm/spans/getSpans.d.ts +0 -70
  35. package/dist/esm/spans/getSpans.d.ts.map +1 -1
  36. package/dist/esm/spans/getSpans.js +42 -93
  37. package/dist/esm/spans/getSpans.js.map +1 -1
  38. package/dist/esm/testing/phoenix-test-tracking.d.ts.map +1 -1
  39. package/dist/esm/testing/phoenix-test-tracking.js +109 -78
  40. package/dist/esm/testing/phoenix-test-tracking.js.map +1 -1
  41. package/dist/esm/traces/getTraces.d.ts +1 -1
  42. package/dist/esm/traces/getTraces.d.ts.map +1 -1
  43. package/dist/esm/traces/index.d.ts +1 -0
  44. package/dist/esm/traces/index.d.ts.map +1 -1
  45. package/dist/esm/traces/index.js +1 -0
  46. package/dist/esm/traces/index.js.map +1 -1
  47. package/dist/esm/traces/transferTraces.d.ts +56 -0
  48. package/dist/esm/traces/transferTraces.d.ts.map +1 -0
  49. package/dist/esm/traces/transferTraces.js +56 -0
  50. package/dist/esm/traces/transferTraces.js.map +1 -0
  51. package/dist/esm/tsconfig.esm.tsbuildinfo +1 -1
  52. package/dist/esm/types/sessions.d.ts +6 -0
  53. package/dist/esm/types/sessions.d.ts.map +1 -1
  54. package/dist/esm/users/getCurrentUser.d.ts +25 -0
  55. package/dist/esm/users/getCurrentUser.d.ts.map +1 -0
  56. package/dist/esm/users/getCurrentUser.js +30 -0
  57. package/dist/esm/users/getCurrentUser.js.map +1 -0
  58. package/dist/esm/users/index.d.ts +2 -0
  59. package/dist/esm/users/index.d.ts.map +1 -0
  60. package/dist/esm/users/index.js +2 -0
  61. package/dist/esm/users/index.js.map +1 -0
  62. package/dist/src/__generated__/api/v1.d.ts +1 -1
  63. package/dist/src/__generated__/api/v1.d.ts.map +1 -1
  64. package/dist/src/constants/serverRequirements.d.ts +1 -0
  65. package/dist/src/constants/serverRequirements.d.ts.map +1 -1
  66. package/dist/src/constants/serverRequirements.js +8 -1
  67. package/dist/src/constants/serverRequirements.js.map +1 -1
  68. package/dist/src/experiments/resumeEvaluation.d.ts +0 -60
  69. package/dist/src/experiments/resumeEvaluation.d.ts.map +1 -1
  70. package/dist/src/experiments/resumeEvaluation.js +44 -37
  71. package/dist/src/experiments/resumeEvaluation.js.map +1 -1
  72. package/dist/src/experiments/resumeExperiment.d.ts +0 -52
  73. package/dist/src/experiments/resumeExperiment.d.ts.map +1 -1
  74. package/dist/src/experiments/resumeExperiment.js +42 -35
  75. package/dist/src/experiments/resumeExperiment.js.map +1 -1
  76. package/dist/src/experiments/runExperiment.d.ts.map +1 -1
  77. package/dist/src/experiments/runExperiment.js +148 -116
  78. package/dist/src/experiments/runExperiment.js.map +1 -1
  79. package/dist/src/projects/index.d.ts +1 -0
  80. package/dist/src/projects/index.d.ts.map +1 -1
  81. package/dist/src/projects/index.js +1 -0
  82. package/dist/src/projects/index.js.map +1 -1
  83. package/dist/src/projects/setProjectRetentionPolicy.d.ts +49 -0
  84. package/dist/src/projects/setProjectRetentionPolicy.d.ts.map +1 -0
  85. package/dist/src/projects/setProjectRetentionPolicy.js +59 -0
  86. package/dist/src/projects/setProjectRetentionPolicy.js.map +1 -0
  87. package/dist/src/prompts/sdks/toOpenAI.d.ts.map +1 -1
  88. package/dist/src/prompts/sdks/toOpenAI.js +56 -63
  89. package/dist/src/prompts/sdks/toOpenAI.js.map +1 -1
  90. package/dist/src/sessions/sessionUtils.d.ts.map +1 -1
  91. package/dist/src/sessions/sessionUtils.js +3 -0
  92. package/dist/src/sessions/sessionUtils.js.map +1 -1
  93. package/dist/src/spans/getSpans.d.ts +0 -70
  94. package/dist/src/spans/getSpans.d.ts.map +1 -1
  95. package/dist/src/spans/getSpans.js +43 -94
  96. package/dist/src/spans/getSpans.js.map +1 -1
  97. package/dist/src/testing/phoenix-test-tracking.d.ts.map +1 -1
  98. package/dist/src/testing/phoenix-test-tracking.js +117 -84
  99. package/dist/src/testing/phoenix-test-tracking.js.map +1 -1
  100. package/dist/src/traces/getTraces.d.ts +1 -1
  101. package/dist/src/traces/getTraces.d.ts.map +1 -1
  102. package/dist/src/traces/index.d.ts +1 -0
  103. package/dist/src/traces/index.d.ts.map +1 -1
  104. package/dist/src/traces/index.js +1 -0
  105. package/dist/src/traces/index.js.map +1 -1
  106. package/dist/src/traces/transferTraces.d.ts +56 -0
  107. package/dist/src/traces/transferTraces.d.ts.map +1 -0
  108. package/dist/src/traces/transferTraces.js +59 -0
  109. package/dist/src/traces/transferTraces.js.map +1 -0
  110. package/dist/src/types/sessions.d.ts +6 -0
  111. package/dist/src/types/sessions.d.ts.map +1 -1
  112. package/dist/src/users/getCurrentUser.d.ts +25 -0
  113. package/dist/src/users/getCurrentUser.d.ts.map +1 -0
  114. package/dist/src/users/getCurrentUser.js +36 -0
  115. package/dist/src/users/getCurrentUser.js.map +1 -0
  116. package/dist/src/users/index.d.ts +2 -0
  117. package/dist/src/users/index.d.ts.map +1 -0
  118. package/dist/src/users/index.js +18 -0
  119. package/dist/src/users/index.js.map +1 -0
  120. package/dist/tsconfig.tsbuildinfo +1 -1
  121. package/docs/overview.mdx +8 -4
  122. package/docs/projects.mdx +71 -0
  123. package/docs/sessions.mdx +10 -1
  124. package/docs/traces.mdx +28 -2
  125. package/docs/users.mdx +44 -0
  126. package/package.json +6 -2
  127. package/src/__generated__/api/v1.ts +1 -1
  128. package/src/constants/serverRequirements.ts +8 -0
  129. package/src/experiments/resumeEvaluation.ts +78 -48
  130. package/src/experiments/resumeExperiment.ts +73 -46
  131. package/src/experiments/runExperiment.ts +235 -129
  132. package/src/projects/index.ts +1 -0
  133. package/src/projects/setProjectRetentionPolicy.ts +80 -0
  134. package/src/prompts/sdks/toOpenAI.ts +58 -61
  135. package/src/sessions/sessionUtils.ts +3 -0
  136. package/src/spans/getSpans.ts +84 -48
  137. package/src/testing/phoenix-test-tracking.ts +154 -90
  138. package/src/traces/getTraces.ts +1 -1
  139. package/src/traces/index.ts +1 -0
  140. package/src/traces/transferTraces.ts +89 -0
  141. package/src/types/sessions.ts +6 -0
  142. package/src/users/getCurrentUser.ts +39 -0
  143. package/src/users/index.ts +1 -0
@@ -22,6 +22,12 @@ export interface Session extends Node {
22
22
  startTime: string;
23
23
  /** ISO 8601 timestamp of when the last trace in the session ended */
24
24
  endTime: string;
25
+ /** Cumulative prompt token count across all spans in the session */
26
+ tokenCountPrompt?: number;
27
+ /** Cumulative completion token count across all spans in the session */
28
+ tokenCountCompletion?: number;
29
+ /** Cumulative total token count across all spans in the session */
30
+ tokenCountTotal?: number;
25
31
  /** The traces that belong to this session */
26
32
  traces: SessionTrace[];
27
33
  }
@@ -1 +1 @@
1
- {"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/types/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI;IACxC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,IAAI;IACnC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB"}
1
+ {"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/types/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI;IACxC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,IAAI;IACnC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB"}
@@ -0,0 +1,25 @@
1
+ import type { components } from "../__generated__/api/v1.js";
2
+ import type { ClientFn } from "../types/core.js";
3
+ /** The user profile returned for the current Phoenix client credentials. */
4
+ export type CurrentUser = components["schemas"]["GetViewerResponseBody"]["data"];
5
+ /**
6
+ * Get the currently authenticated user.
7
+ *
8
+ * When authentication is disabled, Phoenix returns an anonymous user with
9
+ * `auth_method: "ANONYMOUS"`.
10
+ *
11
+ * @param params - The parameters for fetching the current user.
12
+ * @param params.client - An optional Phoenix client instance.
13
+ * @returns The current user's generated API profile shape.
14
+ * @throws {HttpError} If the request is not authenticated or is forbidden.
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * import { getCurrentUser } from "@arizeai/phoenix-client/users";
19
+ *
20
+ * const user = await getCurrentUser();
21
+ * console.log(user.auth_method);
22
+ * ```
23
+ */
24
+ export declare function getCurrentUser({ client: _client, }?: ClientFn): Promise<CurrentUser>;
25
+ //# sourceMappingURL=getCurrentUser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getCurrentUser.d.ts","sourceRoot":"","sources":["../../../src/users/getCurrentUser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GACrB,UAAU,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,GAChB,GAAE,QAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAOtC"}
@@ -0,0 +1,30 @@
1
+ import invariant from "tiny-invariant";
2
+ import { createClient } from "../client.js";
3
+ /**
4
+ * Get the currently authenticated user.
5
+ *
6
+ * When authentication is disabled, Phoenix returns an anonymous user with
7
+ * `auth_method: "ANONYMOUS"`.
8
+ *
9
+ * @param params - The parameters for fetching the current user.
10
+ * @param params.client - An optional Phoenix client instance.
11
+ * @returns The current user's generated API profile shape.
12
+ * @throws {HttpError} If the request is not authenticated or is forbidden.
13
+ *
14
+ * @example
15
+ * ```ts
16
+ * import { getCurrentUser } from "@arizeai/phoenix-client/users";
17
+ *
18
+ * const user = await getCurrentUser();
19
+ * console.log(user.auth_method);
20
+ * ```
21
+ */
22
+ export async function getCurrentUser({ client: _client, } = {}) {
23
+ const client = _client ?? createClient();
24
+ const { data, error } = await client.GET("/v1/user");
25
+ if (error)
26
+ throw error;
27
+ invariant(data?.data, "Failed to get current user");
28
+ return data.data;
29
+ }
30
+ //# sourceMappingURL=getCurrentUser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getCurrentUser.js","sourceRoot":"","sources":["../../../src/users/getCurrentUser.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAOzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,GAChB,GAAa,EAAE;IACd,MAAM,MAAM,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAErD,IAAI,KAAK;QAAE,MAAM,KAAK,CAAC;IACvB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,4BAA4B,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export * from "./getCurrentUser.js";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/users/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export * from "./getCurrentUser.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/users/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}
@@ -9986,7 +9986,7 @@ export interface operations {
9986
9986
  order?: "asc" | "desc";
9987
9987
  /** @description Maximum number of traces to return */
9988
9988
  limit?: number;
9989
- /** @description Pagination cursor (Trace GlobalID) */
9989
+ /** @description Pagination cursor returned by a previous request */
9990
9990
  cursor?: string | null;
9991
9991
  /** @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. */
9992
9992
  include_spans?: boolean;