langwatch 0.33.2 → 0.34.0

package/dist/chunk-OOXU4LFW.js

@@ -0,0 +1,65 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkHDA25KWZjs = require('./chunk-HDA25KWZ.js');
+
+// src/observability-sdk/features/data-capture/utils.ts
+function validateDataCaptureMode(mode) {
+  return ["none", "input", "output", "all"].includes(mode);
+}
+
+// src/observability-sdk/config.ts
+var observabilitySdkConfig = null;
+function initializeObservabilitySdkConfig(config) {
+  observabilitySdkConfig = config;
+}
+function getObservabilitySdkConfig(options) {
+  if (!observabilitySdkConfig) {
+    const message = "[LangWatch Observability SDK] Please call setupObservability() before using the Observability SDK";
+    if ((options == null ? void 0 : options.throwOnUninitialized) || process.env.NODE_ENV === "development") {
+      throw new Error(message);
+    }
+    return {
+      logger: new (0, _chunkHDA25KWZjs.NoOpLogger)()
+    };
+  }
+  return observabilitySdkConfig;
+}
+function getObservabilitySdkLogger() {
+  return getObservabilitySdkConfig().logger;
+}
+function getDataCaptureMode() {
+  const config = getObservabilitySdkConfig();
+  if (!config.dataCapture) {
+    return "all";
+  }
+  if (typeof config.dataCapture === "string") {
+    const validModes = ["none", "input", "output", "all"];
+    if (validModes.includes(config.dataCapture)) {
+      return config.dataCapture;
+    }
+    getObservabilitySdkLogger().warn(
+      `Invalid data capture mode: ${config.dataCapture}. Using default: "all"`
+    );
+    return "all";
+  }
+  if (typeof config.dataCapture === "object" && config.dataCapture.mode && validateDataCaptureMode(config.dataCapture.mode)) {
+    return config.dataCapture.mode;
+  }
+  return "all";
+}
+function shouldCaptureInput() {
+  const mode = getDataCaptureMode();
+  return mode === "input" || mode === "all";
+}
+function shouldCaptureOutput() {
+  const mode = getDataCaptureMode();
+  return mode === "output" || mode === "all";
+}
+
+
+
+
+
+
+exports.initializeObservabilitySdkConfig = initializeObservabilitySdkConfig; exports.getDataCaptureMode = getDataCaptureMode; exports.shouldCaptureInput = shouldCaptureInput; exports.shouldCaptureOutput = shouldCaptureOutput;
+//# sourceMappingURL=chunk-OOXU4LFW.js.map

package/dist/chunk-OOXU4LFW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-OOXU4LFW.js","../src/observability-sdk/features/data-capture/utils.ts","../src/observability-sdk/config.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACCO,SAAS,uBAAA,CAAwB,IAAA,EAAgC;AACtE,EAAA,OAAO,CAAC,MAAA,EAAQ,OAAA,EAAS,QAAA,EAAU,KAAK,CAAA,CAAE,QAAA,CAAS,IAAI,CAAA;AACzD;ADCA;AACA;AEmDA,IAAI,uBAAA,EAAqD,IAAA;AAkBlD,SAAS,gCAAA,CAAiC,MAAA,EAA6B;AAC5E,EAAA,uBAAA,EAAyB,MAAA;AAC3B;AA+BO,SAAS,yBAAA,CAA0B,OAAA,EAElB;AACtB,EAAA,GAAA,CAAI,CAAC,sBAAA,EAAwB;AAC3B,IAAA,MAAM,QAAA,EACJ,mGAAA;AAEF,IAAA,GAAA,CAAA,CACE,QAAA,GAAA,KAAA,EAAA,KAAA,EAAA,EAAA,OAAA,CAAS,oBAAA,EAAA,GACT,OAAA,CAAQ,GAAA,CAAI,SAAA,IAAa,aAAA,EACzB;AACA,MAAA,MAAM,IAAI,KAAA,CAAM,OAAO,CAAA;AAAA,IACzB;AAGA,IAAA,OAAO;AAAA,MACL,MAAA,EAAQ,IAAI,gCAAA,CAAW;AAAA,IACzB,CAAA;AAAA,EACF;AACA,EAAA,OAAO,sBAAA;AACT;AAaO,SAAS,yBAAA,CAAA,EAAoC;AAClD,EAAA,OAAO,yBAAA,CAA0B,CAAA,CAAE,MAAA;AACrC;AAeO,SAAS,kBAAA,CAAA,EAAsC;AACpD,EAAA,MAAM,OAAA,EAAS,yBAAA,CAA0B,CAAA;AAEzC,EAAA,GAAA,CAAI,CAAC,MAAA,CAAO,WAAA,EAAa;AACvB,IAAA,OAAO,KAAA;AAAA,EACT;AAGA,EAAA,GAAA,CAAI,OAAO,MAAA,CAAO,YAAA,IAAgB,QAAA,EAAU;AAC1C,IAAA,MAAM,WAAA,EAAgC,CAAC,MAAA,EAAQ,OAAA,EAAS,QAAA,EAAU,KAAK,CAAA;AACvE,IAAA,GAAA,CAAI,UAAA,CAAW,QAAA,CAAS,MAAA,CAAO,WAAW,CAAA,EAAG;AAC3C,MAAA,OAAO,MAAA,CAAO,WAAA;AAAA,IAChB;AAGA,IAAA,yBAAA,CAA0B,CAAA,CAAE,IAAA;AAAA,MAC1B,CAAA,2BAAA,EAA8B,MAAA,CAAO,WAAW,CAAA,sBAAA;AAAA,IAClD,CAAA;AAEA,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,GAAA,CAAI,OAAO,MAAA,CAAO,YAAA,IAAgB,SAAA,GAAY,MAAA,CAAO,WAAA,CAAY,KAAA,GAAO,uBAAA,CAAwB,MAAA,CAAO,WAAA,CAAY,IAAI,CAAA,EAAG;AACxH,IAAA,OAAO,MAAA,CAAO,WAAA,CAAY,IAAA;AAAA,EAC5B;AAEA,EAAA,OAAO,KAAA;AACT;AAcO,SAAS,kBAAA,CAAA,EAA8B;AAC5C,EAAA,MAAM,KAAA,EAAO,kBAAA,CAAmB,CAAA;AAChC,EAAA,OAAO,KAAA,IAAS,QAAA,GAAW,KAAA,IAAS,KAAA;AACtC;AAcO,SAAS,mBAAA,CAAA,EAA+B;AAC7C,EAAA,MAAM,KAAA,EAAO,kBAAA,CAAmB,CAAA;AAChC,EAAA,OAAO,KAAA,IAAS,SAAA,GAAY,KAAA,IAAS,KAAA;AACvC;AFrKA;AACA;AACE;AACA;AACA;AACA;AACF,iOAAC","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-OOXU4LFW.js","sourcesContent":[null,"import { type DataCaptureMode } from \"./types\";\n\n/**\n * Validates a data capture mode.\n */\nexport function validateDataCaptureMode(mode: DataCaptureMode): boolean {\n  return [\"none\", \"input\", \"output\", \"all\"].includes(mode);\n}\n","import { type Logger, NoOpLogger } from \"../logger/index.js\";\nimport {\n  type DataCaptureMode,\n  type DataCaptureOptions,\n} from \"./features/data-capture/types.js\";\nimport { validateDataCaptureMode } from \"./features/data-capture/utils.js\";\n\n/**\n * @module observability/config\n * @description\n * Provides configuration management for the LangWatch Observability SDK, including logger and data capture settings.\n *\n * @remarks\n * This module allows you to initialize, retrieve, and reset the global observability configuration. It also provides utilities for determining data capture behavior based on context and configuration.\n *\n * @see {@link ObservabilityConfig}\n * @see {@link initializeObservabilitySdkConfig}\n * @see {@link getObservabilitySdkConfig}\n * @see {@link resetObservabilitySdkConfig}\n * @see {@link getDataCaptureMode}\n * @see {@link shouldCaptureInput}\n * @see {@link shouldCaptureOutput}\n */\n/**\n * Configuration options for the LangWatch Observability SDK.\n *\n * @property logger - The logger instance to use for SDK logging.\n * @property dataCapture - Configuration for automatic data capture. Can be a string, function, or object.\n *\n * @example\n * ```ts\n * import { ObservabilityConfig, initializeObservabilitySdkConfig } from \"@langwatch/observability\";\n *\n * const config: ObservabilityConfig = {\n *   logger: new ConsoleLogger(),\n *   dataCapture: \"all\",\n * };\n *\n * initializeObservabilitySdkConfig(config);\n * ```\n */\nexport interface ObservabilityConfig {\n  /**\n   * The logger to use for the observability SDK.\n   *\n   * @default NoOpLogger\n   */\n  logger: Logger;\n\n  /**\n   * Configuration for automatic data capture.\n   *\n   * @default \"all\"\n   */\n  dataCapture?: DataCaptureOptions;\n}\n\n/**\n * The observability SDK config.\n */\nlet observabilitySdkConfig: ObservabilityConfig | null = null;\n\n/**\n * Initializes the global observability SDK configuration.\n *\n * @param config - The configuration object to use.\n *\n * @remarks\n * This function should be called once at application startup, before using any observability features.\n *\n * @warning\n * Calling this function will intentionally overwrite any existing configuration. This is by design to allow re-initialization in dynamic or testing environments. If you call this function multiple times, the most recent configuration will take effect.\n *\n * @example\n * ```ts\n * initializeObservabilitySdkConfig({ logger: new ConsoleLogger() });\n * ```\n */\nexport function initializeObservabilitySdkConfig(config: ObservabilityConfig) {\n  observabilitySdkConfig = config;\n}\n\n/**\n * Resets the global observability SDK configuration to its initial state (`null`).\n *\n * @remarks\n * Useful for testing or re-initializing the SDK in dynamic environments.\n *\n * @example\n * ```ts\n * resetObservabilitySdkConfig();\n * ```\n */\nexport function resetObservabilitySdkConfig() {\n  observabilitySdkConfig = null;\n}\n\n/**\n * Retrieves the current observability SDK configuration.\n *\n * @param options - Optional settings.\n * @param options.throwOnUninitialized - If true, throws an error if the config is not initialized. Defaults to `false` unless `NODE_ENV` is `development`.\n * @returns The current {@link ObservabilityConfig}.\n *\n * @throws {Error} If the config is uninitialized and `throwOnUninitialized` is true or in development mode.\n *\n * @example\n * ```ts\n * const config = getObservabilitySdkConfig();\n * ```\n */\nexport function getObservabilitySdkConfig(options?: {\n  throwOnUninitialized?: boolean;\n}): ObservabilityConfig {\n  if (!observabilitySdkConfig) {\n    const message =\n      \"[LangWatch Observability SDK] Please call setupObservability() before using the Observability SDK\";\n\n    if (\n      options?.throwOnUninitialized ||\n      process.env.NODE_ENV === \"development\"\n    ) {\n      throw new Error(message);\n    }\n\n    // Use a default logger that can be configured\n    return {\n      logger: new NoOpLogger(),\n    };\n  }\n  return observabilitySdkConfig;\n}\n\n/**\n * Gets the logger instance from the current observability SDK configuration.\n *\n * @returns The configured {@link Logger} instance.\n *\n * @example\n * ```ts\n * const logger = getObservabilitySdkLogger();\n * logger.info(\"Observability initialized\");\n * ```\n */\nexport function getObservabilitySdkLogger(): Logger {\n  return getObservabilitySdkConfig().logger;\n}\n\n/**\n * Determines the effective data capture mode.\n *\n * @returns The resolved {@link DataCaptureMode} (\"all\", \"input\", or \"output\").\n *\n * @remarks\n * The mode is determined by the configuration, which can be a string, function, or object. Defaults to \"all\" if not specified.\n *\n * @example\n * ```ts\n * const mode = getDataCaptureMode();\n * ```\n */\nexport function getDataCaptureMode(): DataCaptureMode {\n  const config = getObservabilitySdkConfig();\n\n  if (!config.dataCapture) {\n    return \"all\"; // Default: capture both input and output\n  }\n\n  // Handle different config formats\n  if (typeof config.dataCapture === \"string\") {\n    const validModes: DataCaptureMode[] = [\"none\", \"input\", \"output\", \"all\"];\n    if (validModes.includes(config.dataCapture)) {\n      return config.dataCapture;\n    }\n\n\n    getObservabilitySdkLogger().warn(\n      `Invalid data capture mode: ${config.dataCapture}. Using default: \"all\"`,\n    );\n\n    return \"all\";\n  }\n\n  if (typeof config.dataCapture === \"object\" && config.dataCapture.mode &&validateDataCaptureMode(config.dataCapture.mode)) {\n    return config.dataCapture.mode;\n  }\n\n  return \"all\"; // Default fallback\n}\n\n/**\n * Determines if input data should be captured.\n *\n * @returns `true` if input should be captured, otherwise `false`.\n *\n * @example\n * ```ts\n * if (shouldCaptureInput()) {\n *   // Capture input\n * }\n * ```\n */\nexport function shouldCaptureInput(): boolean {\n  const mode = getDataCaptureMode();\n  return mode === \"input\" || mode === \"all\";\n}\n\n/**\n * Determines if output data should be captured.\n *\n * @returns `true` if output should be captured, otherwise `false`.\n *\n * @example\n * ```ts\n * if (shouldCaptureOutput()) {\n *   // Capture output\n * }\n * ```\n */\nexport function shouldCaptureOutput(): boolean {\n  const mode = getDataCaptureMode();\n  return mode === \"output\" || mode === \"all\";\n}\n"]}

package/dist/chunk-OSAFGMGH.mjs

@@ -0,0 +1,85 @@
+import {
+  createLangWatchApiClient
+} from "./chunk-S2UWK4HL.mjs";
+import {
+  extractStatusFromResponse,
+  formatApiErrorForOperation
+} from "./chunk-J3KM7ZO7.mjs";
+
+// src/client-sdk/services/suites/suites-api.service.ts
+var SuitesApiError = class extends Error {
+  constructor(message, operation, originalError) {
+    super(message);
+    this.operation = operation;
+    this.originalError = originalError;
+    this.name = "SuitesApiError";
+  }
+};
+var SuitesApiService = class {
+  constructor(config) {
+    var _a;
+    this.apiClient = (_a = config == null ? void 0 : config.langwatchApiClient) != null ? _a : createLangWatchApiClient();
+  }
+  handleApiError(operation, error) {
+    const message = formatApiErrorForOperation({ operation, error, options: {
+      status: extractStatusFromResponse(error)
+    } });
+    throw new SuitesApiError(message, operation, error);
+  }
+  async getAll() {
+    const { data, error } = await this.apiClient.GET("/api/suites");
+    if (error) this.handleApiError("list suites", error);
+    return data;
+  }
+  async get(id) {
+    const { data, error } = await this.apiClient.GET("/api/suites/{id}", {
+      params: { path: { id } }
+    });
+    if (error) this.handleApiError(`get suite "${id}"`, error);
+    return data;
+  }
+  async create(params) {
+    const { data, error } = await this.apiClient.POST("/api/suites", {
+      body: params
+    });
+    if (error) this.handleApiError("create suite", error);
+    return data;
+  }
+  async update(id, params) {
+    const { data, error } = await this.apiClient.PATCH("/api/suites/{id}", {
+      params: { path: { id } },
+      body: params
+    });
+    if (error) this.handleApiError(`update suite "${id}"`, error);
+    return data;
+  }
+  async duplicate(id) {
+    const { data, error } = await this.apiClient.POST("/api/suites/{id}/duplicate", {
+      params: { path: { id } }
+    });
+    if (error) this.handleApiError(`duplicate suite "${id}"`, error);
+    return data;
+  }
+  async run(id, idempotencyKey) {
+    const { data, error } = await this.apiClient.POST("/api/suites/{id}/run", {
+      params: { path: { id } },
+      body: {
+        idempotencyKey: idempotencyKey != null ? idempotencyKey : `cli-${Date.now()}-${Math.random().toString(36).slice(2)}`
+      }
+    });
+    if (error) this.handleApiError(`run suite "${id}"`, error);
+    return data;
+  }
+  async delete(id) {
+    const { data, error } = await this.apiClient.DELETE("/api/suites/{id}", {
+      params: { path: { id } }
+    });
+    if (error) this.handleApiError(`delete suite "${id}"`, error);
+    return data;
+  }
+};
+
+export {
+  SuitesApiService
+};
+//# sourceMappingURL=chunk-OSAFGMGH.mjs.map

package/dist/chunk-OXULVOBF.mjs

@@ -0,0 +1,144 @@
+// src/client-sdk/services/experiments/platformErrors.ts
+var ExperimentsError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ExperimentsError";
+  }
+};
+var ExperimentNotFoundError = class extends ExperimentsError {
+  constructor(slug) {
+    super(`Experiment not found: ${slug}`);
+    this.name = "ExperimentNotFoundError";
+  }
+};
+var ExperimentTimeoutError = class extends ExperimentsError {
+  constructor(runId, progress, total) {
+    super(`Experiment run timed out: ${runId} (${progress}/${total} completed)`);
+    this.name = "ExperimentTimeoutError";
+    this.runId = runId;
+    this.progress = progress;
+    this.total = total;
+  }
+};
+var ExperimentRunFailedError = class extends ExperimentsError {
+  constructor(runId, errorMessage) {
+    super(`Experiment run failed: ${errorMessage}`);
+    this.name = "ExperimentRunFailedError";
+    this.runId = runId;
+    this.errorMessage = errorMessage;
+  }
+};
+var ExperimentsApiError = class extends ExperimentsError {
+  constructor(message, statusCode) {
+    super(message);
+    this.name = "ExperimentsApiError";
+    this.statusCode = statusCode;
+  }
+};
+
+// src/client-sdk/services/experiments/run-status.ts
+var INTERRUPTED_THRESHOLD_MS = 5 * 60 * 1e3;
+var deriveRunStatus = (timestamps, now = Date.now()) => {
+  if (timestamps.stoppedAt != null) return "stopped";
+  if (timestamps.finishedAt != null) return "completed";
+  if (timestamps.updatedAt != null && now - timestamps.updatedAt > INTERRUPTED_THRESHOLD_MS) {
+    return "interrupted";
+  }
+  return "running";
+};
+var isTerminalStatus = (status) => status === "completed" || status === "stopped";
+var DEFAULT_POLL_INTERVAL = 2e3;
+var DEFAULT_POLL_TIMEOUT = 6e5;
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var pollExperimentRun = async ({
+  runId,
+  getStatus,
+  pollInterval = DEFAULT_POLL_INTERVAL,
+  timeout = DEFAULT_POLL_TIMEOUT,
+  onProgress,
+  now = Date.now
+}) => {
+  var _a, _b, _c;
+  const startTime = now();
+  while (true) {
+    if (now() - startTime > timeout) {
+      const finalStatus = await getStatus(runId);
+      throw new ExperimentTimeoutError(
+        runId,
+        finalStatus.progress,
+        finalStatus.total
+      );
+    }
+    await sleep(pollInterval);
+    const status = await getStatus(runId);
+    onProgress == null ? void 0 : onProgress(status.progress, status.total);
+    if (status.status === "completed") {
+      return { status: "completed", summary: (_a = status.summary) != null ? _a : {} };
+    }
+    if (status.status === "failed") {
+      throw new ExperimentRunFailedError(runId, (_b = status.error) != null ? _b : "Unknown error");
+    }
+    if (status.status === "stopped") {
+      return {
+        status: "stopped",
+        summary: (_c = status.summary) != null ? _c : {
+          runId,
+          totalCells: status.total,
+          completedCells: status.progress,
+          failedCells: 0,
+          duration: now() - startTime
+        }
+      };
+    }
+  }
+};
+var rebaseUrlToEndpoint = (url, newBase) => {
+  if (!url) return url;
+  try {
+    const parsedUrl = new URL(url);
+    const parsedNewBase = new URL(newBase);
+    return `${parsedNewBase.origin}${parsedUrl.pathname}${parsedUrl.search}${parsedUrl.hash}`;
+  } catch (e) {
+    return url;
+  }
+};
+var fetchResultsWithRetry = async ({
+  getResults,
+  isEmpty,
+  expectsRows,
+  delay = DEFAULT_POLL_INTERVAL,
+  maxAttempts = 6
+}) => {
+  let lastError;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      const results = await getResults();
+      if (expectsRows && isEmpty(results) && attempt < maxAttempts) {
+        await sleep(delay);
+        continue;
+      }
+      return results;
+    } catch (error) {
+      lastError = error;
+      if (expectsRows && attempt < maxAttempts) {
+        await sleep(delay);
+        continue;
+      }
+      throw error;
+    }
+  }
+  throw lastError;
+};
+
+export {
+  ExperimentNotFoundError,
+  ExperimentTimeoutError,
+  ExperimentRunFailedError,
+  ExperimentsApiError,
+  deriveRunStatus,
+  isTerminalStatus,
+  pollExperimentRun,
+  rebaseUrlToEndpoint,
+  fetchResultsWithRetry
+};
+//# sourceMappingURL=chunk-OXULVOBF.mjs.map

package/dist/chunk-OXULVOBF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client-sdk/services/experiments/platformErrors.ts","../src/client-sdk/services/experiments/run-status.ts"],"sourcesContent":["/**\n * Error classes for platform experiments API (Experiments Workbench)\n */\n\n/**\n * Base error for experiment operations\n */\nexport class ExperimentsError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ExperimentsError\";\n  }\n}\n\n/**\n * Error when experiment is not found\n */\nexport class ExperimentNotFoundError extends ExperimentsError {\n  constructor(slug: string) {\n    super(`Experiment not found: ${slug}`);\n    this.name = \"ExperimentNotFoundError\";\n  }\n}\n\n/**\n * Error when experiment run times out\n */\nexport class ExperimentTimeoutError extends ExperimentsError {\n  readonly runId: string;\n  readonly progress: number;\n  readonly total: number;\n\n  constructor(runId: string, progress: number, total: number) {\n    super(`Experiment run timed out: ${runId} (${progress}/${total} completed)`);\n    this.name = \"ExperimentTimeoutError\";\n    this.runId = runId;\n    this.progress = progress;\n    this.total = total;\n  }\n}\n\n/**\n * Error when experiment run fails\n */\nexport class ExperimentRunFailedError extends ExperimentsError {\n  readonly runId: string;\n  readonly errorMessage: string;\n\n  constructor(runId: string, errorMessage: string) {\n    super(`Experiment run failed: ${errorMessage}`);\n    this.name = \"ExperimentRunFailedError\";\n    this.runId = runId;\n    this.errorMessage = errorMessage;\n  }\n}\n\n/**\n * Error from the experiments API\n */\nexport class ExperimentsApiError extends ExperimentsError {\n  readonly statusCode: number;\n\n  constructor(message: string, statusCode: number) {\n    super(message);\n    this.name = \"ExperimentsApiError\";\n    this.statusCode = statusCode;\n  }\n}\n","// Experiment runs are stored as a timestamp-driven state in ClickHouse: a run\n// is \"completed\" once finishedAt is set, \"stopped\" once stoppedAt is set, and\n// otherwise still \"running\". A run that stopped emitting updates a while ago\n// without ever finishing is reported as \"interrupted\": the SDK process likely\n// died before sending finished_at/stopped_at.\n\nimport type { ExperimentRunSummary } from \"./platformTypes\";\nimport {\n  ExperimentTimeoutError,\n  ExperimentRunFailedError,\n} from \"./platformErrors\";\n\nexport const INTERRUPTED_THRESHOLD_MS = 5 * 60 * 1000;\n\nexport type RunStatus = \"completed\" | \"stopped\" | \"running\" | \"interrupted\";\n\nexport interface RunTimestamps {\n  createdAt?: number | null;\n  updatedAt?: number | null;\n  finishedAt?: number | null;\n  stoppedAt?: number | null;\n}\n\nexport const deriveRunStatus = (\n  timestamps: RunTimestamps,\n  now: number = Date.now(),\n): RunStatus => {\n  if (timestamps.stoppedAt != null) return \"stopped\";\n  if (timestamps.finishedAt != null) return \"completed\";\n  if (\n    timestamps.updatedAt != null &&\n    now - timestamps.updatedAt > INTERRUPTED_THRESHOLD_MS\n  ) {\n    return \"interrupted\";\n  }\n  return \"running\";\n};\n\nexport const isTerminalStatus = (status: RunStatus): boolean =>\n  status === \"completed\" || status === \"stopped\";\n\nexport const DEFAULT_POLL_INTERVAL = 2000;\nexport const DEFAULT_POLL_TIMEOUT = 600000; // 10 minutes\n\n/**\n * Status payload returned by the polling endpoint\n * (`GET /api/evaluations/v3/runs/{runId}`).\n */\nexport interface PollRunStatus {\n  status: string;\n  progress: number;\n  total: number;\n  summary?: ExperimentRunSummary;\n  error?: string;\n}\n\nexport interface PollExperimentRunResult {\n  status: \"completed\" | \"stopped\";\n  summary: ExperimentRunSummary;\n}\n\nconst sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\n/**\n * Poll a run to completion.\n *\n * Calls `getStatus(runId)` every `pollInterval` ms until the run reports a\n * terminal status, mirroring the python SDK poll loop. Resolves on `completed`\n * or `stopped`, throws `ExperimentRunFailedError` on `failed`, and throws\n * `ExperimentTimeoutError` if `timeout` ms elapse first.\n *\n * The status fetcher is injected so both the experiment and workflow paths can\n * reuse the same loop.\n */\nexport const pollExperimentRun = async ({\n  runId,\n  getStatus,\n  pollInterval = DEFAULT_POLL_INTERVAL,\n  timeout = DEFAULT_POLL_TIMEOUT,\n  onProgress,\n  now = Date.now,\n}: {\n  runId: string;\n  getStatus: (runId: string) => Promise<PollRunStatus>;\n  pollInterval?: number;\n  timeout?: number;\n  onProgress?: (progress: number, total: number) => void;\n  now?: () => number;\n}): Promise<PollExperimentRunResult> => {\n  const startTime = now();\n\n  while (true) {\n    if (now() - startTime > timeout) {\n      const finalStatus = await getStatus(runId);\n      throw new ExperimentTimeoutError(\n        runId,\n        finalStatus.progress,\n        finalStatus.total,\n      );\n    }\n\n    await sleep(pollInterval);\n\n    const status = await getStatus(runId);\n    onProgress?.(status.progress, status.total);\n\n    if (status.status === \"completed\") {\n      return { status: \"completed\", summary: status.summary ?? {} };\n    }\n\n    if (status.status === \"failed\") {\n      throw new ExperimentRunFailedError(runId, status.error ?? \"Unknown error\");\n    }\n\n    if (status.status === \"stopped\") {\n      return {\n        status: \"stopped\",\n        summary: status.summary ?? {\n          runId,\n          totalCells: status.total,\n          completedCells: status.progress,\n          failedCells: 0,\n          duration: now() - startTime,\n        },\n      };\n    }\n  }\n};\n\n/**\n * Replace the domain of a URL with a new base, preserving path/query/fragment.\n *\n * The platform returns its own (cloud) URL for a run; rebasing it onto the\n * configured endpoint keeps a self-hosted run pointing at the local instance\n * instead of app.langwatch.ai. Returns the original string if either URL is\n * unparseable.\n */\nexport const rebaseUrlToEndpoint = (url: string, newBase: string): string => {\n  if (!url) return url;\n  try {\n    const parsedUrl = new URL(url);\n    const parsedNewBase = new URL(newBase);\n    return `${parsedNewBase.origin}${parsedUrl.pathname}${parsedUrl.search}${parsedUrl.hash}`;\n  } catch {\n    return url;\n  }\n};\n\n/**\n * Fetch a run's per-row results, retrying through the brief post-completion\n * window where the results endpoint 404s (\"not yet available\") or returns an\n * empty dataset because the ClickHouse projection has not caught up yet.\n *\n * Generic over the result shape: `getResults` performs one fetch and `isEmpty`\n * reports whether it came back without rows. When the run reported rows\n * (`expectsRows`), an empty or failed read is retried up to `maxAttempts` with a\n * fixed `delay`; otherwise the first read is returned. The same loop backs both\n * the experiment and workflow SDK paths and mirrors the python SDK.\n */\nexport const fetchResultsWithRetry = async <T>({\n  getResults,\n  isEmpty,\n  expectsRows,\n  delay = DEFAULT_POLL_INTERVAL,\n  maxAttempts = 6,\n}: {\n  getResults: () => Promise<T>;\n  isEmpty: (results: T) => boolean;\n  expectsRows: boolean;\n  delay?: number;\n  maxAttempts?: number;\n}): Promise<T> => {\n  let lastError: unknown;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      const results = await getResults();\n      if (expectsRows && isEmpty(results) && attempt < maxAttempts) {\n        await sleep(delay);\n        continue;\n      }\n      return results;\n    } catch (error) {\n      lastError = error;\n      // Only the rows-expected path waits out the post-completion projection\n      // lag (a 404 / \"not yet available\" right after the run finishes). With no\n      // rows expected a thrown error is terminal, so surface it immediately\n      // instead of delaying through every attempt.\n      if (expectsRows && attempt < maxAttempts) {\n        await sleep(delay);\n        continue;\n      }\n      throw error;\n    }\n  }\n  throw lastError;\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-PONU4KJX.mjs

@@ -0,0 +1,134 @@
+import {
+  __export
+} from "./chunk-BAX4W3AY.mjs";
+
+// src/logger/index.ts
+var logLevelOrder = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+var NoOpLogger = class {
+  constructor() {
+    this.debug = () => {
+    };
+    this.info = () => {
+    };
+    this.warn = () => {
+    };
+    this.error = () => {
+    };
+  }
+};
+var ConsoleLogger = class {
+  constructor(options = { level: "warn" }) {
+    this.debug = (message, ...args) => {
+      if (this.shouldLog("debug")) console.debug(this.format(message), ...args);
+    };
+    this.info = (message, ...args) => {
+      if (this.shouldLog("info")) console.info(this.format(message), ...args);
+    };
+    this.warn = (message, ...args) => {
+      if (this.shouldLog("warn")) console.warn(this.format(message), ...args);
+    };
+    this.error = (message, ...args) => {
+      if (this.shouldLog("error")) console.error(this.format(message), ...args);
+    };
+    this.level = options.level;
+    this.prefix = options.prefix;
+  }
+  shouldLog(level) {
+    return logLevelOrder[level] >= logLevelOrder[this.level];
+  }
+  format(message) {
+    return this.prefix ? `[${this.prefix}] ${message}` : message;
+  }
+};
+
+// src/observability-sdk/semconv/attributes.ts
+var attributes_exports = {};
+__export(attributes_exports, {
+  ATTR_LANGWATCH_CUSTOMER_ID: () => ATTR_LANGWATCH_CUSTOMER_ID,
+  ATTR_LANGWATCH_EVALUATION_CUSTOM: () => ATTR_LANGWATCH_EVALUATION_CUSTOM,
+  ATTR_LANGWATCH_INPUT: () => ATTR_LANGWATCH_INPUT,
+  ATTR_LANGWATCH_LABELS: () => ATTR_LANGWATCH_LABELS,
+  ATTR_LANGWATCH_LANGCHAIN_EVENT_NAME: () => ATTR_LANGWATCH_LANGCHAIN_EVENT_NAME,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_EXTRA_PARAMS: () => ATTR_LANGWATCH_LANGCHAIN_RUN_EXTRA_PARAMS,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_ID: () => ATTR_LANGWATCH_LANGCHAIN_RUN_ID,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_METADATA: () => ATTR_LANGWATCH_LANGCHAIN_RUN_METADATA,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_PARENT_ID: () => ATTR_LANGWATCH_LANGCHAIN_RUN_PARENT_ID,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_TAGS: () => ATTR_LANGWATCH_LANGCHAIN_RUN_TAGS,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_TYPE: () => ATTR_LANGWATCH_LANGCHAIN_RUN_TYPE,
+  ATTR_LANGWATCH_LANGCHAIN_TAGS: () => ATTR_LANGWATCH_LANGCHAIN_TAGS,
+  ATTR_LANGWATCH_METRICS: () => ATTR_LANGWATCH_METRICS,
+  ATTR_LANGWATCH_OUTPUT: () => ATTR_LANGWATCH_OUTPUT,
+  ATTR_LANGWATCH_PARAMS: () => ATTR_LANGWATCH_PARAMS,
+  ATTR_LANGWATCH_PROMPT_HANDLE: () => ATTR_LANGWATCH_PROMPT_HANDLE,
+  ATTR_LANGWATCH_PROMPT_ID: () => ATTR_LANGWATCH_PROMPT_ID,
+  ATTR_LANGWATCH_PROMPT_SELECTED_ID: () => ATTR_LANGWATCH_PROMPT_SELECTED_ID,
+  ATTR_LANGWATCH_PROMPT_VARIABLES: () => ATTR_LANGWATCH_PROMPT_VARIABLES,
+  ATTR_LANGWATCH_PROMPT_VERSION_ID: () => ATTR_LANGWATCH_PROMPT_VERSION_ID,
+  ATTR_LANGWATCH_PROMPT_VERSION_NUMBER: () => ATTR_LANGWATCH_PROMPT_VERSION_NUMBER,
+  ATTR_LANGWATCH_RAG_CONTEXTS: () => ATTR_LANGWATCH_RAG_CONTEXTS,
+  ATTR_LANGWATCH_SDK_LANGUAGE: () => ATTR_LANGWATCH_SDK_LANGUAGE,
+  ATTR_LANGWATCH_SDK_NAME: () => ATTR_LANGWATCH_SDK_NAME,
+  ATTR_LANGWATCH_SDK_VERSION: () => ATTR_LANGWATCH_SDK_VERSION,
+  ATTR_LANGWATCH_SPAN_TYPE: () => ATTR_LANGWATCH_SPAN_TYPE,
+  ATTR_LANGWATCH_STREAMING: () => ATTR_LANGWATCH_STREAMING,
+  ATTR_LANGWATCH_TAGS: () => ATTR_LANGWATCH_TAGS,
+  ATTR_LANGWATCH_THREAD_ID: () => ATTR_LANGWATCH_THREAD_ID,
+  ATTR_LANGWATCH_TIMESTAMPS: () => ATTR_LANGWATCH_TIMESTAMPS,
+  ATTR_LANGWATCH_USER_ID: () => ATTR_LANGWATCH_USER_ID
+});
+var ATTR_LANGWATCH_INPUT = "langwatch.input";
+var ATTR_LANGWATCH_OUTPUT = "langwatch.output";
+var ATTR_LANGWATCH_SPAN_TYPE = "langwatch.span.type";
+var ATTR_LANGWATCH_RAG_CONTEXTS = "langwatch.rag.contexts";
+var ATTR_LANGWATCH_METRICS = "langwatch.metrics";
+var ATTR_LANGWATCH_SDK_VERSION = "langwatch.sdk.version";
+var ATTR_LANGWATCH_SDK_NAME = "langwatch.sdk.name";
+var ATTR_LANGWATCH_SDK_LANGUAGE = "langwatch.sdk.language";
+var ATTR_LANGWATCH_TIMESTAMPS = "langwatch.timestamps";
+var ATTR_LANGWATCH_EVALUATION_CUSTOM = "langwatch.evaluation.custom";
+var ATTR_LANGWATCH_PARAMS = "langwatch.params";
+var ATTR_LANGWATCH_CUSTOMER_ID = "langwatch.customer.id";
+var ATTR_LANGWATCH_THREAD_ID = "langwatch.thread.id";
+var ATTR_LANGWATCH_USER_ID = "langwatch.user.id";
+var ATTR_LANGWATCH_LABELS = "langwatch.labels";
+var ATTR_LANGWATCH_TAGS = "langwatch.labels";
+var ATTR_LANGWATCH_STREAMING = "langwatch.gen_ai.streaming";
+var ATTR_LANGWATCH_PROMPT_ID = "langwatch.prompt.id";
+var ATTR_LANGWATCH_PROMPT_HANDLE = "langwatch.prompt.handle";
+var ATTR_LANGWATCH_PROMPT_VERSION_ID = "langwatch.prompt.version.id";
+var ATTR_LANGWATCH_PROMPT_VARIABLES = "langwatch.prompt.variables";
+var ATTR_LANGWATCH_PROMPT_SELECTED_ID = "langwatch.prompt.selected.id";
+var ATTR_LANGWATCH_PROMPT_VERSION_NUMBER = "langwatch.prompt.version.number";
+var ATTR_LANGWATCH_LANGCHAIN_TAGS = "langwatch.langchain.tags";
+var ATTR_LANGWATCH_LANGCHAIN_EVENT_NAME = "langwatch.langchain.event_name";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_ID = "langwatch.langchain.run.id";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_TAGS = "langwatch.langchain.run.tags";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_TYPE = "langwatch.langchain.run.type";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_METADATA = "langwatch.langchain.run.metadata";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_EXTRA_PARAMS = "langwatch.langchain.run.extra_params";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_PARENT_ID = "langwatch.langchain.run.parent.id";
+
+export {
+  NoOpLogger,
+  ConsoleLogger,
+  ATTR_LANGWATCH_INPUT,
+  ATTR_LANGWATCH_OUTPUT,
+  ATTR_LANGWATCH_SPAN_TYPE,
+  ATTR_LANGWATCH_RAG_CONTEXTS,
+  ATTR_LANGWATCH_METRICS,
+  ATTR_LANGWATCH_SDK_VERSION,
+  ATTR_LANGWATCH_SDK_NAME,
+  ATTR_LANGWATCH_SDK_LANGUAGE,
+  ATTR_LANGWATCH_EVALUATION_CUSTOM,
+  ATTR_LANGWATCH_PROMPT_ID,
+  ATTR_LANGWATCH_PROMPT_VERSION_ID,
+  ATTR_LANGWATCH_PROMPT_SELECTED_ID,
+  ATTR_LANGWATCH_PROMPT_VERSION_NUMBER,
+  attributes_exports
+};
+//# sourceMappingURL=chunk-PONU4KJX.mjs.map