@arizeai/phoenix-client 5.2.1 → 5.4.0

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 (151) hide show
  1. package/README.md +3 -3
  2. package/dist/esm/__generated__/api/v1.d.ts +321 -9
  3. package/dist/esm/__generated__/api/v1.d.ts.map +1 -1
  4. package/dist/esm/experiments/createExperiment.d.ts +39 -0
  5. package/dist/esm/experiments/createExperiment.d.ts.map +1 -0
  6. package/dist/esm/experiments/createExperiment.js +43 -0
  7. package/dist/esm/experiments/createExperiment.js.map +1 -0
  8. package/dist/esm/experiments/deleteExperiment.d.ts +36 -0
  9. package/dist/esm/experiments/deleteExperiment.d.ts.map +1 -0
  10. package/dist/esm/experiments/deleteExperiment.js +49 -0
  11. package/dist/esm/experiments/deleteExperiment.js.map +1 -0
  12. package/dist/esm/experiments/getExperimentInfo.d.ts.map +1 -1
  13. package/dist/esm/experiments/getExperimentInfo.js +9 -2
  14. package/dist/esm/experiments/getExperimentInfo.js.map +1 -1
  15. package/dist/esm/experiments/helpers/asExperimentEvaluator.d.ts +19 -0
  16. package/dist/esm/experiments/helpers/asExperimentEvaluator.d.ts.map +1 -0
  17. package/dist/esm/experiments/helpers/asExperimentEvaluator.js +19 -0
  18. package/dist/esm/experiments/helpers/asExperimentEvaluator.js.map +1 -0
  19. package/dist/esm/experiments/helpers/fromPhoenixLLMEvaluator.d.ts +9 -0
  20. package/dist/esm/experiments/helpers/fromPhoenixLLMEvaluator.d.ts.map +1 -0
  21. package/dist/esm/experiments/helpers/fromPhoenixLLMEvaluator.js +18 -0
  22. package/dist/esm/experiments/helpers/fromPhoenixLLMEvaluator.js.map +1 -0
  23. package/dist/esm/experiments/helpers/getExperimentEvaluators.d.ts +6 -0
  24. package/dist/esm/experiments/helpers/getExperimentEvaluators.d.ts.map +1 -0
  25. package/dist/esm/experiments/helpers/getExperimentEvaluators.js +58 -0
  26. package/dist/esm/experiments/helpers/getExperimentEvaluators.js.map +1 -0
  27. package/dist/esm/experiments/helpers/index.d.ts +4 -0
  28. package/dist/esm/experiments/helpers/index.d.ts.map +1 -0
  29. package/dist/esm/experiments/helpers/index.js +4 -0
  30. package/dist/esm/experiments/helpers/index.js.map +1 -0
  31. package/dist/esm/experiments/index.d.ts +6 -0
  32. package/dist/esm/experiments/index.d.ts.map +1 -1
  33. package/dist/esm/experiments/index.js +6 -0
  34. package/dist/esm/experiments/index.js.map +1 -1
  35. package/dist/esm/experiments/listExperiments.d.ts +29 -0
  36. package/dist/esm/experiments/listExperiments.d.ts.map +1 -0
  37. package/dist/esm/experiments/listExperiments.js +59 -0
  38. package/dist/esm/experiments/listExperiments.js.map +1 -0
  39. package/dist/esm/experiments/resumeEvaluation.d.ts +105 -0
  40. package/dist/esm/experiments/resumeEvaluation.d.ts.map +1 -0
  41. package/dist/esm/experiments/resumeEvaluation.js +559 -0
  42. package/dist/esm/experiments/resumeEvaluation.js.map +1 -0
  43. package/dist/esm/experiments/resumeExperiment.d.ts +102 -0
  44. package/dist/esm/experiments/resumeExperiment.d.ts.map +1 -0
  45. package/dist/esm/experiments/resumeExperiment.js +517 -0
  46. package/dist/esm/experiments/resumeExperiment.js.map +1 -0
  47. package/dist/esm/experiments/runExperiment.d.ts +4 -3
  48. package/dist/esm/experiments/runExperiment.d.ts.map +1 -1
  49. package/dist/esm/experiments/runExperiment.js +32 -3
  50. package/dist/esm/experiments/runExperiment.js.map +1 -1
  51. package/dist/esm/prompts/createPrompt.d.ts +19 -1
  52. package/dist/esm/prompts/createPrompt.d.ts.map +1 -1
  53. package/dist/esm/prompts/createPrompt.js +14 -1
  54. package/dist/esm/prompts/createPrompt.js.map +1 -1
  55. package/dist/esm/tsconfig.esm.tsbuildinfo +1 -1
  56. package/dist/esm/types/experiments.d.ts +66 -3
  57. package/dist/esm/types/experiments.d.ts.map +1 -1
  58. package/dist/esm/utils/channel.d.ts +229 -0
  59. package/dist/esm/utils/channel.d.ts.map +1 -0
  60. package/dist/esm/utils/channel.js +352 -0
  61. package/dist/esm/utils/channel.js.map +1 -0
  62. package/dist/esm/utils/formatPromptMessages.d.ts.map +1 -1
  63. package/dist/esm/utils/getPromptBySelector.d.ts.map +1 -1
  64. package/dist/esm/utils/isHttpError.d.ts +21 -0
  65. package/dist/esm/utils/isHttpError.d.ts.map +1 -0
  66. package/dist/esm/utils/isHttpError.js +33 -0
  67. package/dist/esm/utils/isHttpError.js.map +1 -0
  68. package/dist/src/__generated__/api/v1.d.ts +321 -9
  69. package/dist/src/__generated__/api/v1.d.ts.map +1 -1
  70. package/dist/src/experiments/createExperiment.d.ts +39 -0
  71. package/dist/src/experiments/createExperiment.d.ts.map +1 -0
  72. package/dist/src/experiments/createExperiment.js +43 -0
  73. package/dist/src/experiments/createExperiment.js.map +1 -0
  74. package/dist/src/experiments/deleteExperiment.d.ts +36 -0
  75. package/dist/src/experiments/deleteExperiment.d.ts.map +1 -0
  76. package/dist/src/experiments/deleteExperiment.js +52 -0
  77. package/dist/src/experiments/deleteExperiment.js.map +1 -0
  78. package/dist/src/experiments/getExperimentInfo.d.ts.map +1 -1
  79. package/dist/src/experiments/getExperimentInfo.js +9 -2
  80. package/dist/src/experiments/getExperimentInfo.js.map +1 -1
  81. package/dist/src/experiments/helpers/asExperimentEvaluator.d.ts +19 -0
  82. package/dist/src/experiments/helpers/asExperimentEvaluator.d.ts.map +1 -0
  83. package/dist/src/experiments/helpers/asExperimentEvaluator.js +22 -0
  84. package/dist/src/experiments/helpers/asExperimentEvaluator.js.map +1 -0
  85. package/dist/src/experiments/helpers/fromPhoenixLLMEvaluator.d.ts +9 -0
  86. package/dist/src/experiments/helpers/fromPhoenixLLMEvaluator.d.ts.map +1 -0
  87. package/dist/src/experiments/helpers/fromPhoenixLLMEvaluator.js +21 -0
  88. package/dist/src/experiments/helpers/fromPhoenixLLMEvaluator.js.map +1 -0
  89. package/dist/src/experiments/helpers/getExperimentEvaluators.d.ts +6 -0
  90. package/dist/src/experiments/helpers/getExperimentEvaluators.d.ts.map +1 -0
  91. package/dist/src/experiments/helpers/getExperimentEvaluators.js +61 -0
  92. package/dist/src/experiments/helpers/getExperimentEvaluators.js.map +1 -0
  93. package/dist/src/experiments/helpers/index.d.ts +4 -0
  94. package/dist/src/experiments/helpers/index.d.ts.map +1 -0
  95. package/dist/src/experiments/helpers/index.js +20 -0
  96. package/dist/src/experiments/helpers/index.js.map +1 -0
  97. package/dist/src/experiments/index.d.ts +6 -0
  98. package/dist/src/experiments/index.d.ts.map +1 -1
  99. package/dist/src/experiments/index.js +6 -0
  100. package/dist/src/experiments/index.js.map +1 -1
  101. package/dist/src/experiments/listExperiments.d.ts +29 -0
  102. package/dist/src/experiments/listExperiments.d.ts.map +1 -0
  103. package/dist/src/experiments/listExperiments.js +66 -0
  104. package/dist/src/experiments/listExperiments.js.map +1 -0
  105. package/dist/src/experiments/resumeEvaluation.d.ts +105 -0
  106. package/dist/src/experiments/resumeEvaluation.d.ts.map +1 -0
  107. package/dist/src/experiments/resumeEvaluation.js +585 -0
  108. package/dist/src/experiments/resumeEvaluation.js.map +1 -0
  109. package/dist/src/experiments/resumeExperiment.d.ts +102 -0
  110. package/dist/src/experiments/resumeExperiment.d.ts.map +1 -0
  111. package/dist/src/experiments/resumeExperiment.js +540 -0
  112. package/dist/src/experiments/resumeExperiment.js.map +1 -0
  113. package/dist/src/experiments/runExperiment.d.ts +4 -3
  114. package/dist/src/experiments/runExperiment.d.ts.map +1 -1
  115. package/dist/src/experiments/runExperiment.js +32 -3
  116. package/dist/src/experiments/runExperiment.js.map +1 -1
  117. package/dist/src/prompts/createPrompt.d.ts +19 -1
  118. package/dist/src/prompts/createPrompt.d.ts.map +1 -1
  119. package/dist/src/prompts/createPrompt.js +14 -1
  120. package/dist/src/prompts/createPrompt.js.map +1 -1
  121. package/dist/src/types/experiments.d.ts +66 -3
  122. package/dist/src/types/experiments.d.ts.map +1 -1
  123. package/dist/src/utils/channel.d.ts +229 -0
  124. package/dist/src/utils/channel.d.ts.map +1 -0
  125. package/dist/src/utils/channel.js +385 -0
  126. package/dist/src/utils/channel.js.map +1 -0
  127. package/dist/src/utils/formatPromptMessages.d.ts.map +1 -1
  128. package/dist/src/utils/getPromptBySelector.d.ts.map +1 -1
  129. package/dist/src/utils/isHttpError.d.ts +21 -0
  130. package/dist/src/utils/isHttpError.d.ts.map +1 -0
  131. package/dist/src/utils/isHttpError.js +37 -0
  132. package/dist/src/utils/isHttpError.js.map +1 -0
  133. package/dist/tsconfig.tsbuildinfo +1 -1
  134. package/package.json +6 -5
  135. package/src/__generated__/api/v1.ts +321 -9
  136. package/src/experiments/createExperiment.ts +90 -0
  137. package/src/experiments/deleteExperiment.ts +67 -0
  138. package/src/experiments/getExperimentInfo.ts +9 -2
  139. package/src/experiments/helpers/asExperimentEvaluator.ts +29 -0
  140. package/src/experiments/helpers/fromPhoenixLLMEvaluator.ts +24 -0
  141. package/src/experiments/helpers/getExperimentEvaluators.ts +74 -0
  142. package/src/experiments/helpers/index.ts +3 -0
  143. package/src/experiments/index.ts +6 -0
  144. package/src/experiments/listExperiments.ts +83 -0
  145. package/src/experiments/resumeEvaluation.ts +804 -0
  146. package/src/experiments/resumeExperiment.ts +745 -0
  147. package/src/experiments/runExperiment.ts +37 -5
  148. package/src/prompts/createPrompt.ts +19 -1
  149. package/src/types/experiments.ts +72 -3
  150. package/src/utils/channel.ts +397 -0
  151. package/src/utils/isHttpError.ts +45 -0
@@ -0,0 +1,102 @@
1
+ import { type DiagLogLevel } from "@arizeai/phoenix-otel";
2
+ import { ClientFn } from "../types/core";
3
+ import type { ExperimentEvaluatorLike, ExperimentTask } from "../types/experiments";
4
+ import { type Logger } from "../types/logger";
5
+ export type ResumeExperimentParams = ClientFn & {
6
+ /**
7
+ * The ID of the experiment to resume
8
+ */
9
+ readonly experimentId: string;
10
+ /**
11
+ * The task to run on incomplete examples
12
+ */
13
+ readonly task: ExperimentTask;
14
+ /**
15
+ * Optional evaluators to run on completed task runs
16
+ * @default undefined
17
+ */
18
+ readonly evaluators?: readonly ExperimentEvaluatorLike[];
19
+ /**
20
+ * The logger to use
21
+ * @default console
22
+ */
23
+ readonly logger?: Logger;
24
+ /**
25
+ * The number of concurrent task executions
26
+ * @default 5
27
+ */
28
+ readonly concurrency?: number;
29
+ /**
30
+ * Whether to set the global tracer provider when running the task.
31
+ * @default true
32
+ */
33
+ readonly setGlobalTracerProvider?: boolean;
34
+ /**
35
+ * Whether to use batch span processor for tracing.
36
+ * @default true
37
+ */
38
+ readonly useBatchSpanProcessor?: boolean;
39
+ /**
40
+ * Log level to set for the default DiagConsoleLogger when tracing.
41
+ */
42
+ readonly diagLogLevel?: DiagLogLevel;
43
+ /**
44
+ * Stop processing and exit as soon as any task fails.
45
+ * @default false
46
+ */
47
+ readonly stopOnFirstError?: boolean;
48
+ };
49
+ /**
50
+ * Resume an incomplete experiment by running only the missing or failed runs.
51
+ *
52
+ * This function identifies which (example, repetition) pairs have not been completed
53
+ * (either missing or failed) and re-runs the task only for those pairs. Optionally,
54
+ * evaluators can be run on the completed runs after task execution.
55
+ *
56
+ * The function processes incomplete runs in batches using pagination to minimize memory usage.
57
+ *
58
+ * @throws {Error} Throws different error types based on failure:
59
+ * - "TaskFetchError": Unable to fetch incomplete runs from the server.
60
+ * Always thrown regardless of stopOnFirstError, as it indicates critical infrastructure failure.
61
+ * - "TaskAbortedError": stopOnFirstError=true and a task failed.
62
+ * Original error preserved in `cause` property.
63
+ * - Generic Error: Other task execution errors or unexpected failures.
64
+ *
65
+ * @example
66
+ * ```ts
67
+ * import { resumeExperiment } from "@arizeai/phoenix-client/experiments";
68
+ *
69
+ * // Resume an interrupted experiment
70
+ * try {
71
+ * await resumeExperiment({
72
+ * experimentId: "exp_123",
73
+ * task: myTask,
74
+ * });
75
+ * } catch (error) {
76
+ * // Handle by error name (no instanceof needed)
77
+ * if (error.name === "TaskFetchError") {
78
+ * console.error("Failed to connect to server:", error.cause);
79
+ * } else if (error.name === "TaskAbortedError") {
80
+ * console.error("Task stopped due to error:", error.cause);
81
+ * } else {
82
+ * console.error("Unexpected error:", error);
83
+ * }
84
+ * }
85
+ *
86
+ * // Resume with evaluators
87
+ * await resumeExperiment({
88
+ * experimentId: "exp_123",
89
+ * task: myTask,
90
+ * evaluators: [correctnessEvaluator, relevanceEvaluator],
91
+ * });
92
+ *
93
+ * // Stop on first error (useful for debugging)
94
+ * await resumeExperiment({
95
+ * experimentId: "exp_123",
96
+ * task: myTask,
97
+ * stopOnFirstError: true, // Exit immediately on first task failure
98
+ * });
99
+ * ```
100
+ */
101
+ export declare function resumeExperiment({ client: _client, experimentId, task, evaluators, logger, concurrency, setGlobalTracerProvider, useBatchSpanProcessor, diagLogLevel, stopOnFirstError, }: ResumeExperimentParams): Promise<void>;
102
+ //# sourceMappingURL=resumeExperiment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resumeExperiment.d.ts","sourceRoot":"","sources":["../../../src/experiments/resumeExperiment.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,YAAY,EAMlB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAsC9C,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG;IAC9C;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACzD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAgIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,MAAM,EAAE,OAAO,EACf,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,MAAgB,EAChB,WAAe,EACf,uBAA8B,EAC9B,qBAA4B,EAC5B,YAAY,EACZ,gBAAwB,GACzB,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqSxC"}
@@ -0,0 +1,540 @@
1
+ "use strict";
2
+ var __asyncValues = (this && this.__asyncValues) || function (o) {
3
+ if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
4
+ var m = o[Symbol.asyncIterator], i;
5
+ return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
6
+ function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
7
+ function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
8
+ };
9
+ var __importDefault = (this && this.__importDefault) || function (mod) {
10
+ return (mod && mod.__esModule) ? mod : { "default": mod };
11
+ };
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.resumeExperiment = resumeExperiment;
14
+ const openinference_semantic_conventions_1 = require("@arizeai/openinference-semantic-conventions");
15
+ const phoenix_otel_1 = require("@arizeai/phoenix-otel");
16
+ const client_1 = require("../client");
17
+ const channel_1 = require("../utils/channel");
18
+ const ensureString_1 = require("../utils/ensureString");
19
+ const isHttpError_1 = require("../utils/isHttpError");
20
+ const toObjectHeaders_1 = require("../utils/toObjectHeaders");
21
+ const urlUtils_1 = require("../utils/urlUtils");
22
+ const getExperimentInfo_js_1 = require("./getExperimentInfo.js");
23
+ const resumeEvaluation_1 = require("./resumeEvaluation");
24
+ const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
25
+ /**
26
+ * Error thrown when task is aborted due to a failure in stopOnFirstError mode.
27
+ * This provides semantic context that the abort was intentional, not an infrastructure failure.
28
+ * @internal - Not exported to minimize API surface area
29
+ */
30
+ class TaskAbortedError extends Error {
31
+ constructor(message, cause) {
32
+ super(message);
33
+ this.name = "TaskAbortedError";
34
+ this.cause = cause;
35
+ }
36
+ }
37
+ /**
38
+ * Error thrown when the producer fails to fetch incomplete runs from the server.
39
+ * This is a critical error that should always be surfaced, even in stopOnFirstError=false mode.
40
+ * @internal - Not exported to minimize API surface area
41
+ */
42
+ class TaskFetchError extends Error {
43
+ constructor(message, cause) {
44
+ super(message);
45
+ this.name = "TaskFetchError";
46
+ this.cause = cause;
47
+ }
48
+ }
49
+ const DEFAULT_PAGE_SIZE = 50;
50
+ /**
51
+ * Channel capacity multiplier for producer-consumer buffering.
52
+ * A value of 2 enables pipeline efficiency: workers process batch N while
53
+ * the producer fetches batch N+1, eliminating idle time without excessive
54
+ * memory usage. The channel blocks when full, providing natural backpressure.
55
+ */
56
+ const CHANNEL_CAPACITY_MULTIPLIER = 2;
57
+ /**
58
+ * Transforms API incomplete run response to ExampleWithId
59
+ */
60
+ function buildExampleFromApiResponse(apiExample) {
61
+ return {
62
+ id: apiExample.id,
63
+ input: apiExample.input,
64
+ output: apiExample.output || null,
65
+ metadata: apiExample.metadata || {},
66
+ updatedAt: new Date(apiExample.updated_at),
67
+ };
68
+ }
69
+ /**
70
+ * Handles fetch errors with helpful version information for unsupported features
71
+ */
72
+ async function handleFetchError(error, client, featureName) {
73
+ // Check if this is a JSON parse error (likely 404 HTML response from old server)
74
+ const isJsonError = error instanceof SyntaxError &&
75
+ error.message.toLowerCase().includes("json");
76
+ if (isJsonError) {
77
+ // Fetch server version to provide helpful context
78
+ let versionInfo = "";
79
+ try {
80
+ const baseUrl = client.config.baseUrl || "";
81
+ const versionRes = await fetch(`${baseUrl}/arize_phoenix_version`);
82
+ if (versionRes.ok) {
83
+ const version = await versionRes.text();
84
+ versionInfo = ` Your current server version is ${version}.`;
85
+ }
86
+ }
87
+ catch (_a) {
88
+ // Ignore errors fetching version
89
+ }
90
+ throw new Error(`The ${featureName} feature is not available on this Phoenix server. ` +
91
+ "Please upgrade your Phoenix server to use this feature." +
92
+ versionInfo);
93
+ }
94
+ throw error;
95
+ }
96
+ /**
97
+ * Sets up OpenTelemetry tracer for experiment tracing
98
+ */
99
+ function setupTracer({ projectName, baseUrl, headers, useBatchSpanProcessor, diagLogLevel, setGlobalTracerProvider, }) {
100
+ if (!projectName) {
101
+ return null;
102
+ }
103
+ const provider = (0, phoenix_otel_1.register)({
104
+ projectName,
105
+ url: baseUrl,
106
+ headers,
107
+ batch: useBatchSpanProcessor,
108
+ diagLogLevel,
109
+ global: setGlobalTracerProvider,
110
+ });
111
+ const tracer = provider.getTracer(projectName);
112
+ return { provider, tracer };
113
+ }
114
+ /**
115
+ * Prints experiment summary to logger
116
+ */
117
+ function printExperimentSummary({ logger, experimentId, totalProcessed, totalCompleted, }) {
118
+ logger.info("\n" + "=".repeat(70));
119
+ logger.info("📊 Experiment Resume Summary");
120
+ logger.info("=".repeat(70));
121
+ logger.info(`Experiment ID: ${experimentId}`);
122
+ logger.info(`Incomplete runs processed: ${totalProcessed}`);
123
+ logger.info(`Successfully completed: ${totalCompleted}`);
124
+ logger.info("=".repeat(70));
125
+ }
126
+ /**
127
+ * Resume an incomplete experiment by running only the missing or failed runs.
128
+ *
129
+ * This function identifies which (example, repetition) pairs have not been completed
130
+ * (either missing or failed) and re-runs the task only for those pairs. Optionally,
131
+ * evaluators can be run on the completed runs after task execution.
132
+ *
133
+ * The function processes incomplete runs in batches using pagination to minimize memory usage.
134
+ *
135
+ * @throws {Error} Throws different error types based on failure:
136
+ * - "TaskFetchError": Unable to fetch incomplete runs from the server.
137
+ * Always thrown regardless of stopOnFirstError, as it indicates critical infrastructure failure.
138
+ * - "TaskAbortedError": stopOnFirstError=true and a task failed.
139
+ * Original error preserved in `cause` property.
140
+ * - Generic Error: Other task execution errors or unexpected failures.
141
+ *
142
+ * @example
143
+ * ```ts
144
+ * import { resumeExperiment } from "@arizeai/phoenix-client/experiments";
145
+ *
146
+ * // Resume an interrupted experiment
147
+ * try {
148
+ * await resumeExperiment({
149
+ * experimentId: "exp_123",
150
+ * task: myTask,
151
+ * });
152
+ * } catch (error) {
153
+ * // Handle by error name (no instanceof needed)
154
+ * if (error.name === "TaskFetchError") {
155
+ * console.error("Failed to connect to server:", error.cause);
156
+ * } else if (error.name === "TaskAbortedError") {
157
+ * console.error("Task stopped due to error:", error.cause);
158
+ * } else {
159
+ * console.error("Unexpected error:", error);
160
+ * }
161
+ * }
162
+ *
163
+ * // Resume with evaluators
164
+ * await resumeExperiment({
165
+ * experimentId: "exp_123",
166
+ * task: myTask,
167
+ * evaluators: [correctnessEvaluator, relevanceEvaluator],
168
+ * });
169
+ *
170
+ * // Stop on first error (useful for debugging)
171
+ * await resumeExperiment({
172
+ * experimentId: "exp_123",
173
+ * task: myTask,
174
+ * stopOnFirstError: true, // Exit immediately on first task failure
175
+ * });
176
+ * ```
177
+ */
178
+ async function resumeExperiment({ client: _client, experimentId, task, evaluators, logger = console, concurrency = 5, setGlobalTracerProvider = true, useBatchSpanProcessor = true, diagLogLevel, stopOnFirstError = false, }) {
179
+ var _a, _b;
180
+ const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
181
+ const pageSize = DEFAULT_PAGE_SIZE;
182
+ // Get experiment info
183
+ logger.info(`🔍 Fetching experiment info...`);
184
+ const experiment = await (0, getExperimentInfo_js_1.getExperimentInfo)({ client, experimentId });
185
+ // Check if there are incomplete runs
186
+ const totalExpected = experiment.exampleCount * experiment.repetitions;
187
+ const incompleteCount = totalExpected - experiment.successfulRunCount;
188
+ if (incompleteCount === 0) {
189
+ logger.info("✅ No incomplete runs found. Experiment is already complete.");
190
+ return;
191
+ }
192
+ logger.info(`🧪 Resuming experiment with ${incompleteCount} incomplete runs...`);
193
+ // Get base URL for tracing and URL generation
194
+ const baseUrl = client.config.baseUrl;
195
+ (0, tiny_invariant_1.default)(baseUrl, "Phoenix base URL not found. Please set PHOENIX_HOST or set baseUrl on the client.");
196
+ // Initialize tracer (only if experiment has a project_name)
197
+ const tracerSetup = setupTracer({
198
+ projectName: experiment.projectName,
199
+ baseUrl,
200
+ headers: client.config.headers
201
+ ? (0, toObjectHeaders_1.toObjectHeaders)(client.config.headers)
202
+ : undefined,
203
+ useBatchSpanProcessor,
204
+ diagLogLevel,
205
+ setGlobalTracerProvider,
206
+ });
207
+ const provider = (_a = tracerSetup === null || tracerSetup === void 0 ? void 0 : tracerSetup.provider) !== null && _a !== void 0 ? _a : null;
208
+ const taskTracer = (_b = tracerSetup === null || tracerSetup === void 0 ? void 0 : tracerSetup.tracer) !== null && _b !== void 0 ? _b : null;
209
+ // Display URLs
210
+ const datasetExperimentsUrl = (0, urlUtils_1.getDatasetExperimentsUrl)({
211
+ baseUrl,
212
+ datasetId: experiment.datasetId,
213
+ });
214
+ const experimentUrl = (0, urlUtils_1.getExperimentUrl)({
215
+ baseUrl,
216
+ datasetId: experiment.datasetId,
217
+ experimentId: experiment.id,
218
+ });
219
+ logger.info(`📺 View dataset experiments: ${datasetExperimentsUrl}`);
220
+ logger.info(`🔗 View this experiment: ${experimentUrl}`);
221
+ // Create a CSP-style bounded buffer for task distribution
222
+ const taskChannel = new channel_1.Channel(pageSize * CHANNEL_CAPACITY_MULTIPLIER);
223
+ // Abort controller for stopOnFirstError coordination
224
+ const abortController = new AbortController();
225
+ const { signal } = abortController;
226
+ let totalProcessed = 0;
227
+ let totalCompleted = 0;
228
+ let totalFailed = 0;
229
+ // Producer: Fetch incomplete runs and send to channel
230
+ async function fetchIncompleteRuns() {
231
+ var _a, _b, _c;
232
+ let cursor = null;
233
+ try {
234
+ do {
235
+ // Stop fetching if abort signal received
236
+ if (signal.aborted) {
237
+ logger.info("🛑 Stopping fetch due to error in task");
238
+ break;
239
+ }
240
+ let res;
241
+ try {
242
+ res = await client.GET("/v1/experiments/{experiment_id}/incomplete-runs", {
243
+ params: {
244
+ path: {
245
+ experiment_id: experimentId,
246
+ },
247
+ query: {
248
+ cursor,
249
+ limit: pageSize,
250
+ },
251
+ },
252
+ });
253
+ }
254
+ catch (error) {
255
+ // Check for version compatibility issues and throw helpful error
256
+ try {
257
+ await handleFetchError(error, client, "resume_experiment");
258
+ // TypeScript: handleFetchError never returns, but add throw for safety
259
+ throw new Error("handleFetchError should never return");
260
+ }
261
+ catch (handledError) {
262
+ // Wrap the error (from handleFetchError or original) in semantic error type
263
+ throw new TaskFetchError("Failed to fetch incomplete runs from server", handledError instanceof Error ? handledError : undefined);
264
+ }
265
+ }
266
+ cursor = (_b = (_a = res.data) === null || _a === void 0 ? void 0 : _a.next_cursor) !== null && _b !== void 0 ? _b : null;
267
+ const batchIncomplete = (_c = res.data) === null || _c === void 0 ? void 0 : _c.data;
268
+ (0, tiny_invariant_1.default)(batchIncomplete, "Failed to fetch incomplete runs");
269
+ if (batchIncomplete.length === 0) {
270
+ break;
271
+ }
272
+ // Send tasks to channel (blocks if channel is full - natural backpressure!)
273
+ let batchCount = 0;
274
+ for (const incomplete of batchIncomplete) {
275
+ // Stop sending items if abort signal received
276
+ if (signal.aborted) {
277
+ break;
278
+ }
279
+ const example = buildExampleFromApiResponse(incomplete.dataset_example);
280
+ for (const repNum of incomplete.repetition_numbers) {
281
+ // Stop sending items if abort signal received
282
+ if (signal.aborted) {
283
+ break;
284
+ }
285
+ await taskChannel.send({ example, repetitionNumber: repNum });
286
+ batchCount++;
287
+ totalProcessed++;
288
+ }
289
+ }
290
+ logger.info(`Fetched batch of ${batchCount} incomplete runs (channel buffer: ${taskChannel.length})`);
291
+ } while (cursor !== null && !signal.aborted);
292
+ }
293
+ catch (error) {
294
+ // Re-throw with context preservation
295
+ if (error instanceof TaskFetchError) {
296
+ throw error;
297
+ }
298
+ // ChannelError from blocked send() should bubble up naturally
299
+ // (happens when channel closes while producer is blocked)
300
+ if (error instanceof channel_1.ChannelError) {
301
+ throw error;
302
+ }
303
+ // Wrap any unexpected errors from channel operations
304
+ throw new TaskFetchError("Unexpected error during task fetch", error instanceof Error ? error : undefined);
305
+ }
306
+ finally {
307
+ taskChannel.close(); // Signal workers we're done
308
+ }
309
+ }
310
+ // Worker: Process tasks from channel
311
+ async function processTasksFromChannel() {
312
+ var _a, e_1, _b, _c;
313
+ try {
314
+ for (var _d = true, taskChannel_1 = __asyncValues(taskChannel), taskChannel_1_1; taskChannel_1_1 = await taskChannel_1.next(), _a = taskChannel_1_1.done, !_a; _d = true) {
315
+ _c = taskChannel_1_1.value;
316
+ _d = false;
317
+ const item = _c;
318
+ // Stop processing if abort signal received
319
+ if (signal.aborted) {
320
+ break;
321
+ }
322
+ try {
323
+ await runSingleTask({
324
+ client,
325
+ experimentId,
326
+ task,
327
+ example: item.example,
328
+ repetitionNumber: item.repetitionNumber,
329
+ tracer: taskTracer,
330
+ });
331
+ totalCompleted++;
332
+ }
333
+ catch (error) {
334
+ totalFailed++;
335
+ logger.error(`Failed to run task for example ${item.example.id}, repetition ${item.repetitionNumber}: ${error}`);
336
+ // If stopOnFirstError is enabled, abort and re-throw
337
+ if (stopOnFirstError) {
338
+ logger.error("🛑 Stopping on first error");
339
+ abortController.abort();
340
+ throw error;
341
+ }
342
+ }
343
+ }
344
+ }
345
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
346
+ finally {
347
+ try {
348
+ if (!_d && !_a && (_b = taskChannel_1.return)) await _b.call(taskChannel_1);
349
+ }
350
+ finally { if (e_1) throw e_1.error; }
351
+ }
352
+ }
353
+ // Start concurrent execution
354
+ // Wrap in try-finally to ensure channel is always closed, even if Promise.all throws
355
+ let executionError = null;
356
+ try {
357
+ const producerTask = fetchIncompleteRuns();
358
+ const workerTasks = Array.from({ length: concurrency }, () => processTasksFromChannel());
359
+ // Wait for producer and all workers to finish
360
+ await Promise.all([producerTask, ...workerTasks]);
361
+ }
362
+ catch (error) {
363
+ // Classify and handle errors based on their nature
364
+ const err = error instanceof Error ? error : new Error(String(error));
365
+ // Always surface producer/infrastructure errors
366
+ if (error instanceof TaskFetchError) {
367
+ // Producer failed - this is ALWAYS critical regardless of stopOnFirstError
368
+ logger.error(`❌ Critical: Failed to fetch incomplete runs from server`);
369
+ executionError = err;
370
+ }
371
+ else if (error instanceof channel_1.ChannelError && signal.aborted) {
372
+ // Channel closed due to intentional abort - wrap in semantic error
373
+ executionError = new TaskAbortedError("Task execution stopped due to error in concurrent worker", err);
374
+ }
375
+ else if (stopOnFirstError) {
376
+ // Worker error in stopOnFirstError mode - already logged by worker
377
+ executionError = err;
378
+ }
379
+ else {
380
+ // Unexpected error (not from worker, not from producer fetch)
381
+ // This could be a bug in our code or infrastructure failure
382
+ logger.error(`❌ Unexpected error during task execution: ${err.message}`);
383
+ executionError = err;
384
+ }
385
+ }
386
+ finally {
387
+ // Ensure channel is closed even if there are unexpected errors
388
+ // This is a safety net in case producer's finally block didn't execute
389
+ if (!taskChannel.isClosed) {
390
+ taskChannel.close();
391
+ }
392
+ }
393
+ // Only show completion message if we didn't stop on error
394
+ if (!executionError) {
395
+ logger.info(`✅ Task runs completed.`);
396
+ }
397
+ if (totalFailed > 0 && !executionError) {
398
+ logger.info(`⚠️ Warning: ${totalFailed} out of ${totalProcessed} runs failed.`);
399
+ }
400
+ // Run evaluators if provided (only on runs missing evaluations)
401
+ // Skip evaluators if we stopped on error
402
+ if (evaluators && evaluators.length > 0 && !executionError) {
403
+ logger.info(`\n🔬 Running evaluators...`);
404
+ await (0, resumeEvaluation_1.resumeEvaluation)({
405
+ experimentId,
406
+ evaluators: [...evaluators],
407
+ client,
408
+ logger,
409
+ concurrency,
410
+ setGlobalTracerProvider,
411
+ useBatchSpanProcessor,
412
+ diagLogLevel,
413
+ stopOnFirstError,
414
+ });
415
+ }
416
+ // Print summary
417
+ printExperimentSummary({
418
+ logger,
419
+ experimentId: experiment.id,
420
+ totalProcessed,
421
+ totalCompleted,
422
+ });
423
+ // Flush spans (if tracer was initialized)
424
+ if (provider) {
425
+ await provider.forceFlush();
426
+ }
427
+ // Re-throw error if stopOnFirstError was triggered
428
+ if (executionError) {
429
+ throw executionError;
430
+ }
431
+ }
432
+ /**
433
+ * Record task result to API (without executing the task).
434
+ */
435
+ async function recordTaskResult({ client, experimentId, example, repetitionNumber, output, error, startTime, endTime, traceId = null, }) {
436
+ try {
437
+ await client.POST("/v1/experiments/{experiment_id}/runs", {
438
+ params: {
439
+ path: {
440
+ experiment_id: experimentId,
441
+ },
442
+ },
443
+ body: {
444
+ dataset_example_id: example.id,
445
+ repetition_number: repetitionNumber,
446
+ output: output,
447
+ start_time: startTime.toISOString(),
448
+ end_time: endTime.toISOString(),
449
+ error: error ? (0, ensureString_1.ensureString)(error) : undefined,
450
+ trace_id: traceId,
451
+ },
452
+ });
453
+ }
454
+ catch (err) {
455
+ // Ignore 409 Conflict - result already exists (idempotency)
456
+ if ((0, isHttpError_1.isHttpErrorWithStatus)(err, 409)) {
457
+ return;
458
+ }
459
+ throw err; // Re-throw other errors
460
+ }
461
+ }
462
+ /**
463
+ * Run a single task and record the result with optional tracing.
464
+ */
465
+ async function runSingleTask({ client, experimentId, task, example, repetitionNumber, tracer, }) {
466
+ const startTime = new Date();
467
+ // If no tracer (no project_name), execute without tracing
468
+ if (!tracer) {
469
+ let output = null; // Initialize to null for failed tasks
470
+ let error;
471
+ try {
472
+ output = await Promise.resolve(task(example));
473
+ }
474
+ catch (err) {
475
+ error = err instanceof Error ? err.message : String(err);
476
+ throw err;
477
+ }
478
+ finally {
479
+ const endTime = new Date();
480
+ await recordTaskResult({
481
+ client,
482
+ experimentId,
483
+ example,
484
+ repetitionNumber,
485
+ output,
486
+ error,
487
+ startTime,
488
+ endTime,
489
+ });
490
+ }
491
+ return;
492
+ }
493
+ // With tracer: wrap execution in a span for observability
494
+ return tracer.startActiveSpan(`Task: ${task.name || "anonymous"}`, async (span) => {
495
+ // Set span attributes
496
+ span.setAttributes(Object.assign({ [openinference_semantic_conventions_1.SemanticConventions.OPENINFERENCE_SPAN_KIND]: openinference_semantic_conventions_1.OpenInferenceSpanKind.CHAIN, [openinference_semantic_conventions_1.SemanticConventions.INPUT_VALUE]: (0, ensureString_1.ensureString)(example.input), [openinference_semantic_conventions_1.SemanticConventions.INPUT_MIME_TYPE]: openinference_semantic_conventions_1.MimeType.JSON }, (0, phoenix_otel_1.objectAsAttributes)({
497
+ experiment_id: experimentId,
498
+ dataset_example_id: example.id,
499
+ repetition_number: repetitionNumber,
500
+ })));
501
+ let output = null; // Initialize to null for failed tasks
502
+ let error;
503
+ try {
504
+ // Execute the task (only once!)
505
+ output = await Promise.resolve(task(example));
506
+ // Set output attributes
507
+ span.setAttributes({
508
+ [openinference_semantic_conventions_1.SemanticConventions.OUTPUT_VALUE]: (0, ensureString_1.ensureString)(output),
509
+ [openinference_semantic_conventions_1.SemanticConventions.OUTPUT_MIME_TYPE]: openinference_semantic_conventions_1.MimeType.JSON,
510
+ });
511
+ span.setStatus({ code: phoenix_otel_1.SpanStatusCode.OK });
512
+ }
513
+ catch (err) {
514
+ error = err instanceof Error ? err.message : String(err);
515
+ span.setStatus({
516
+ code: phoenix_otel_1.SpanStatusCode.ERROR,
517
+ message: error,
518
+ });
519
+ span.recordException(err);
520
+ throw err;
521
+ }
522
+ finally {
523
+ const endTime = new Date();
524
+ span.end();
525
+ // Record result to API
526
+ await recordTaskResult({
527
+ client,
528
+ experimentId,
529
+ example,
530
+ repetitionNumber,
531
+ output,
532
+ error,
533
+ startTime,
534
+ endTime,
535
+ traceId: span.spanContext().traceId,
536
+ });
537
+ }
538
+ });
539
+ }
540
+ //# sourceMappingURL=resumeExperiment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resumeExperiment.js","sourceRoot":"","sources":["../../../src/experiments/resumeExperiment.ts"],"names":[],"mappings":";;;;;;;;;;;;AA2RA,4CAgTC;AA3kBD,oGAIqD;AACrD,wDAO+B;AAG/B,sCAA6D;AAQ7D,8CAAyD;AACzD,wDAAqD;AACrD,sDAA6D;AAC7D,8DAA2D;AAC3D,gDAA+E;AAE/E,iEAA2D;AAC3D,yDAAsD;AAEtD,oEAAuC;AAEvC;;;;GAIG;AACH,MAAM,gBAAiB,SAAQ,KAAK;IAClC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,cAAe,SAAQ,KAAK;IAChC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AA+CD,MAAM,iBAAiB,GAAG,EAAW,CAAC;AACtC;;;;;GAKG;AACH,MAAM,2BAA2B,GAAG,CAAU,CAAC;AAU/C;;GAEG;AACH,SAAS,2BAA2B,CAClC,UAAmD;IAEnD,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,IAAI;QACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,EAAE;QACnC,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAC7B,KAAc,EACd,MAAqB,EACrB,WAAmB;IAEnB,iFAAiF;IACjF,MAAM,WAAW,GACf,KAAK,YAAY,WAAW;QAC5B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,WAAW,EAAE,CAAC;QAChB,kDAAkD;QAClD,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,wBAAwB,CAAC,CAAC;YACnE,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;gBACxC,WAAW,GAAG,mCAAmC,OAAO,GAAG,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,WAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;QAED,MAAM,IAAI,KAAK,CACb,OAAO,WAAW,oDAAoD;YACpE,yDAAyD;YACzD,WAAW,CACd,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,EACnB,WAAW,EACX,OAAO,EACP,OAAO,EACP,qBAAqB,EACrB,YAAY,EACZ,uBAAuB,GAQxB;IACC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,uBAAQ,EAAC;QACxB,WAAW;QACX,GAAG,EAAE,OAAO;QACZ,OAAO;QACP,KAAK,EAAE,qBAAqB;QAC5B,YAAY;QACZ,MAAM,EAAE,uBAAuB;KAChC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,EAC9B,MAAM,EACN,YAAY,EACZ,cAAc,EACd,cAAc,GAMf;IACC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,kBAAkB,YAAY,EAAE,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,CAAC,8BAA8B,cAAc,EAAE,CAAC,CAAC;IAC5D,MAAM,CAAC,IAAI,CAAC,2BAA2B,cAAc,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACI,KAAK,UAAU,gBAAgB,CAAC,EACrC,MAAM,EAAE,OAAO,EACf,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,MAAM,GAAG,OAAO,EAChB,WAAW,GAAG,CAAC,EACf,uBAAuB,GAAG,IAAI,EAC9B,qBAAqB,GAAG,IAAI,EAC5B,YAAY,EACZ,gBAAgB,GAAG,KAAK,GACD;;IACvB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,iBAAiB,CAAC;IAEnC,sBAAsB;IACtB,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,IAAA,wCAAiB,EAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAErE,qCAAqC;IACrC,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC;IACvE,MAAM,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAEtE,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CACT,+BAA+B,eAAe,qBAAqB,CACpE,CAAC;IAEF,8CAA8C;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;IACtC,IAAA,wBAAS,EACP,OAAO,EACP,mFAAmF,CACpF,CAAC;IAEF,4DAA4D;IAC5D,MAAM,WAAW,GAAG,WAAW,CAAC;QAC9B,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,OAAO;QACP,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;YAC5B,CAAC,CAAC,IAAA,iCAAe,EAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YACxC,CAAC,CAAC,SAAS;QACb,qBAAqB;QACrB,YAAY;QACZ,uBAAuB;KACxB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,QAAQ,mCAAI,IAAI,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,mCAAI,IAAI,CAAC;IAE/C,eAAe;IACf,MAAM,qBAAqB,GAAG,IAAA,mCAAwB,EAAC;QACrD,OAAO;QACP,SAAS,EAAE,UAAU,CAAC,SAAS;KAChC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,IAAA,2BAAgB,EAAC;QACrC,OAAO;QACP,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,YAAY,EAAE,UAAU,CAAC,EAAE;KAC5B,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,gCAAgC,qBAAqB,EAAE,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,CAAC,4BAA4B,aAAa,EAAE,CAAC,CAAC;IAEzD,0DAA0D;IAC1D,MAAM,WAAW,GAAG,IAAI,iBAAO,CAC7B,QAAQ,GAAG,2BAA2B,CACvC,CAAC;IAEF,qDAAqD;IACrD,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;IAEnC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,sDAAsD;IACtD,KAAK,UAAU,mBAAmB;;QAChC,IAAI,MAAM,GAAkB,IAAI,CAAC;QAEjC,IAAI,CAAC;YACH,GAAG,CAAC;gBACF,yCAAyC;gBACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;oBACtD,MAAM;gBACR,CAAC;gBAED,IAAI,GAEH,CAAC;gBAEF,IAAI,CAAC;oBACH,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CACpB,iDAAiD,EACjD;wBACE,MAAM,EAAE;4BACN,IAAI,EAAE;gCACJ,aAAa,EAAE,YAAY;6BAC5B;4BACD,KAAK,EAAE;gCACL,MAAM;gCACN,KAAK,EAAE,QAAQ;6BAChB;yBACF;qBACF,CACF,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,iEAAiE;oBACjE,IAAI,CAAC;wBACH,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;wBAC3D,uEAAuE;wBACvE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;oBAC1D,CAAC;oBAAC,OAAO,YAAY,EAAE,CAAC;wBACtB,4EAA4E;wBAC5E,MAAM,IAAI,cAAc,CACtB,6CAA6C,EAC7C,YAAY,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CACzD,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,MAAM,GAAG,MAAA,MAAA,GAAG,CAAC,IAAI,0CAAE,WAAW,mCAAI,IAAI,CAAC;gBACvC,MAAM,eAAe,GAAG,MAAA,GAAG,CAAC,IAAI,0CAAE,IAAI,CAAC;gBACvC,IAAA,wBAAS,EAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;gBAE9D,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACjC,MAAM;gBACR,CAAC;gBAED,4EAA4E;gBAC5E,IAAI,UAAU,GAAG,CAAC,CAAC;gBACnB,KAAK,MAAM,UAAU,IAAI,eAAe,EAAE,CAAC;oBACzC,8CAA8C;oBAC9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;wBACnB,MAAM;oBACR,CAAC;oBAED,MAAM,OAAO,GAAG,2BAA2B,CACzC,UAAU,CAAC,eAAe,CAC3B,CAAC;oBACF,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,CAAC;wBACnD,8CAA8C;wBAC9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;4BACnB,MAAM;wBACR,CAAC;wBAED,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;wBAC9D,UAAU,EAAE,CAAC;wBACb,cAAc,EAAE,CAAC;oBACnB,CAAC;gBACH,CAAC;gBAED,MAAM,CAAC,IAAI,CACT,oBAAoB,UAAU,qCAAqC,WAAW,CAAC,MAAM,GAAG,CACzF,CAAC;YACJ,CAAC,QAAQ,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qCAAqC;YACrC,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;gBACpC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,8DAA8D;YAC9D,0DAA0D;YAC1D,IAAI,KAAK,YAAY,sBAAY,EAAE,CAAC;gBAClC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,qDAAqD;YACrD,MAAM,IAAI,cAAc,CACtB,oCAAoC,EACpC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,4BAA4B;QACnD,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,KAAK,UAAU,uBAAuB;;;YACpC,KAAyB,eAAA,gBAAA,cAAA,WAAW,CAAA,iBAAA,2FAAE,CAAC;gBAAd,2BAAW;gBAAX,WAAW;gBAAzB,MAAM,IAAI,KAAA,CAAA;gBACnB,2CAA2C;gBAC3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM;gBACR,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,aAAa,CAAC;wBAClB,MAAM;wBACN,YAAY;wBACZ,IAAI;wBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;wBACvC,MAAM,EAAE,UAAU;qBACnB,CAAC,CAAC;oBACH,cAAc,EAAE,CAAC;gBACnB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,WAAW,EAAE,CAAC;oBACd,MAAM,CAAC,KAAK,CACV,kCAAkC,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,IAAI,CAAC,gBAAgB,KAAK,KAAK,EAAE,CACnG,CAAC;oBAEF,qDAAqD;oBACrD,IAAI,gBAAgB,EAAE,CAAC;wBACrB,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;wBAC3C,eAAe,CAAC,KAAK,EAAE,CAAC;wBACxB,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;;;;;;;;;IACH,CAAC;IAED,6BAA6B;IAC7B,qFAAqF;IACrF,IAAI,cAAc,GAAiB,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAC3D,uBAAuB,EAAE,CAC1B,CAAC;QAEF,8CAA8C;QAC9C,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mDAAmD;QACnD,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEtE,gDAAgD;QAChD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,2EAA2E;YAC3E,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;YACxE,cAAc,GAAG,GAAG,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,YAAY,sBAAY,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3D,mEAAmE;YACnE,cAAc,GAAG,IAAI,gBAAgB,CACnC,0DAA0D,EAC1D,GAAG,CACJ,CAAC;QACJ,CAAC;aAAM,IAAI,gBAAgB,EAAE,CAAC;YAC5B,mEAAmE;YACnE,cAAc,GAAG,GAAG,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,8DAA8D;YAC9D,4DAA4D;YAC5D,MAAM,CAAC,KAAK,CAAC,6CAA6C,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,cAAc,GAAG,GAAG,CAAC;QACvB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,+DAA+D;QAC/D,uEAAuE;QACvE,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC1B,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CACT,gBAAgB,WAAW,WAAW,cAAc,eAAe,CACpE,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,yCAAyC;IACzC,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC1C,MAAM,IAAA,mCAAgB,EAAC;YACrB,YAAY;YACZ,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC;YAC3B,MAAM;YACN,MAAM;YACN,WAAW;YACX,uBAAuB;YACvB,qBAAqB;YACrB,YAAY;YACZ,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,sBAAsB,CAAC;QACrB,MAAM;QACN,YAAY,EAAE,UAAU,CAAC,EAAE;QAC3B,cAAc;QACd,cAAc;KACf,CAAC,CAAC;IAEH,0CAA0C;IAC1C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,mDAAmD;IACnD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,cAAc,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,EAC9B,MAAM,EACN,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,MAAM,EACN,KAAK,EACL,SAAS,EACT,OAAO,EACP,OAAO,GAAG,IAAI,GAWf;IACC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;YACxD,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,aAAa,EAAE,YAAY;iBAC5B;aACF;YACD,IAAI,EAAE;gBACJ,kBAAkB,EAAE,OAAO,CAAC,EAAE;gBAC9B,iBAAiB,EAAE,gBAAgB;gBACnC,MAAM,EAAE,MAAiC;gBACzC,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE;gBACnC,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE;gBAC/B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAA,2BAAY,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9C,QAAQ,EAAE,OAAO;aAClB;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,4DAA4D;QAC5D,IAAI,IAAA,mCAAqB,EAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,GAAG,CAAC,CAAC,wBAAwB;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAAC,EAC3B,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,gBAAgB,EAChB,MAAM,GAQP;IACC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAE7B,0DAA0D;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,MAAM,GAAY,IAAI,CAAC,CAAC,sCAAsC;QAClE,IAAI,KAAyB,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzD,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YAC3B,MAAM,gBAAgB,CAAC;gBACrB,MAAM;gBACN,YAAY;gBACZ,OAAO;gBACP,gBAAgB;gBAChB,MAAM;gBACN,KAAK;gBACL,SAAS;gBACT,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IAED,0DAA0D;IAC1D,OAAO,MAAM,CAAC,eAAe,CAC3B,SAAS,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,EACnC,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,sBAAsB;QACtB,IAAI,CAAC,aAAa,iBAChB,CAAC,wDAAmB,CAAC,uBAAuB,CAAC,EAC3C,0DAAqB,CAAC,KAAK,EAC7B,CAAC,wDAAmB,CAAC,WAAW,CAAC,EAAE,IAAA,2BAAY,EAAC,OAAO,CAAC,KAAK,CAAC,EAC9D,CAAC,wDAAmB,CAAC,eAAe,CAAC,EAAE,6CAAQ,CAAC,IAAI,IACjD,IAAA,iCAAkB,EAAC;YACpB,aAAa,EAAE,YAAY;YAC3B,kBAAkB,EAAE,OAAO,CAAC,EAAE;YAC9B,iBAAiB,EAAE,gBAAgB;SACpC,CAAC,EACF,CAAC;QAEH,IAAI,MAAM,GAAY,IAAI,CAAC,CAAC,sCAAsC;QAClE,IAAI,KAAyB,CAAC;QAE9B,IAAI,CAAC;YACH,gCAAgC;YAChC,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAE9C,wBAAwB;YACxB,IAAI,CAAC,aAAa,CAAC;gBACjB,CAAC,wDAAmB,CAAC,YAAY,CAAC,EAAE,IAAA,2BAAY,EAAC,MAAM,CAAC;gBACxD,CAAC,wDAAmB,CAAC,gBAAgB,CAAC,EAAE,6CAAQ,CAAC,IAAI;aACtD,CAAC,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,6BAAc,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEzD,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,6BAAc,CAAC,KAAK;gBAC1B,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;YAEnC,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YAEX,uBAAuB;YACvB,MAAM,gBAAgB,CAAC;gBACrB,MAAM;gBACN,YAAY;gBACZ,OAAO;gBACP,gBAAgB;gBAChB,MAAM;gBACN,KAAK;gBACL,SAAS;gBACT,OAAO;gBACP,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}