langwatch 1.8.0 → 1.9.0

package/dist/index.mjs

@@ -9,7 +9,7 @@ import {
 import {
   ensureSetup,
   resolveEndpoint
-} from "./chunk-YEKLDVGO.mjs";
+} from "./chunk-A52LX4C4.mjs";
 import {
   LANGWATCH_SDK_LANGUAGE,
   LANGWATCH_SDK_NAME_CLIENT,
@@ -20,7 +20,7 @@ import {
   buildAuthHeaders,
   getLangWatchLogger,
   version
-} from "./chunk-W6NUS5XK.mjs";
+} from "./chunk-4XQHESU7.mjs";
 import {
   ConsoleLogger,
   NoOpLogger,
@@ -51,6 +51,9 @@ function currentHolder() {
 function scopedApiKey() {
   return currentHolder().apiKey;
 }
+function scopedProjectId() {
+  return currentHolder().projectId;
+}
 
 // src/cli/utils/responseFormat.ts
 var DEFAULT_TEXT_OUTPUT = {
@@ -424,7 +427,7 @@ var asSuggestions = (value) => {
   return suggestions.length > 0 ? suggestions : void 0;
 };
 var asErrorBody = (value) => {
-  var _a, _b, _d;
+  var _a, _b, _c, _e, _g;
   const record = asRecord(value);
   if (!record) return null;
   if (isSystemError(record)) return null;
@@ -443,9 +446,23 @@ var asErrorBody = (value) => {
       docUrl: typeof serialized.docsUrl === "string" ? serialized.docsUrl : typeof serialized.docUrl === "string" ? serialized.docUrl : void 0
     };
   }
+  const canonical = asRecord(record.error);
+  if (canonical && !isSystemError(canonical) && (typeof canonical.code === "string" || typeof canonical.type === "string")) {
+    const code2 = typeof canonical.code === "string" ? canonical.code : canonical.type;
+    const _d = (_c = asRecord(canonical.meta)) != null ? _c : {}, { reasons: metaReasons } = _d, meta = __objRest(_d, ["reasons"]);
+    return {
+      code: code2,
+      message: typeof canonical.message === "string" && canonical.message !== code2 ? canonical.message : void 0,
+      meta,
+      traceId: typeof canonical.trace_id === "string" ? canonical.trace_id : void 0,
+      reasons: asReasons(metaReasons),
+      suggestions: (_e = asSuggestions(canonical.tips)) != null ? _e : asSuggestions(canonical.suggestions),
+      docUrl: typeof canonical.docs_url === "string" ? canonical.docs_url : void 0
+    };
+  }
   const named = typeof record.kind === "string" ? typeof record.code === "string" ? record.code : typeof record.type === "string" ? record.type : record.kind : typeof record.error === "string" ? record.error : looksLikeErrorEnvelope(record) ? typeof record.code === "string" ? record.code : typeof record.type === "string" ? record.type : null : null;
   if (named === null) return null;
-  const _c = record, {
+  const _f = record, {
     error,
     message,
     kind,
@@ -464,7 +481,7 @@ var asErrorBody = (value) => {
     tips: tips,
     docsUrl,
     fault: fault
-  } = _c, rest = __objRest(_c, [
+  } = _f, rest = __objRest(_f, [
     "error",
     "message",
     "kind",
@@ -503,7 +520,7 @@ var asErrorBody = (value) => {
     traceUrl: typeof traceUrl === "string" ? traceUrl : typeof (traceRecord == null ? void 0 : traceRecord.traceUrl) === "string" ? traceRecord.traceUrl : void 0,
     logsUrl: typeof logsUrl === "string" ? logsUrl : typeof (traceRecord == null ? void 0 : traceRecord.logsUrl) === "string" ? traceRecord.logsUrl : void 0,
     reasons: asReasons(reasons),
-    suggestions: (_d = asSuggestions(tips)) != null ? _d : asSuggestions(suggestions),
+    suggestions: (_g = asSuggestions(tips)) != null ? _g : asSuggestions(suggestions),
     docUrl: typeof docsUrl === "string" ? docsUrl : typeof docUrl === "string" ? docUrl : void 0
   };
 };
@@ -657,7 +674,7 @@ var handledErrorMiddleware = {
     if (handledError) throw handledError;
   }
 };
-var createLangWatchApiClient = (apiKey = ((_b) => (_b = ((_a) => (_a = scopedApiKey()) != null ? _a : process.env.LANGWATCH_API_KEY)()) != null ? _b : "")(), endpoint, projectId = process.env.LANGWATCH_PROJECT_ID) => {
+var createLangWatchApiClient = (apiKey = ((_b) => (_b = ((_a) => (_a = scopedApiKey()) != null ? _a : process.env.LANGWATCH_API_KEY)()) != null ? _b : "")(), endpoint, projectId = ((_c) => (_c = scopedProjectId()) != null ? _c : process.env.LANGWATCH_PROJECT_ID)()) => {
   const client = openApiCreateClient({
     baseUrl: resolveEndpoint(endpoint),
     headers: __spreadProps(__spreadValues({}, buildAuthHeaders({ apiKey, projectId })), {
@@ -3993,6 +4010,107 @@ var ExperimentsApiService = class {
     if (error) this.handleApiError(`start experiment run for "${slug}"`, error);
     return data;
   }
+  /**
+   * Create an experiment.
+   *
+   * Sending no state creates a blank workbench with one inline dataset, so a
+   * caller that only wants somewhere to put its setup does not have to build
+   * one first.
+   */
+  async create({
+    name,
+    state
+  } = {}) {
+    const { data, error } = await this.apiClient.POST("/api/experiments", {
+      body: __spreadValues(__spreadValues({}, name !== void 0 ? { name } : {}), state !== void 0 ? { state } : {})
+    });
+    if (error) this.handleApiError("create experiment", error);
+    return data;
+  }
+  async getWorkbenchState({
+    slug,
+    fields
+  }) {
+    const { data, error } = await this.apiClient.GET(
+      "/api/experiments/{slug}/workbench-state",
+      {
+        params: __spreadValues({
+          path: { slug }
+        }, fields !== void 0 ? { query: { fields } } : {})
+      }
+    );
+    if (error) {
+      this.handleApiError(`get workbench state for "${slug}"`, error);
+    }
+    return data;
+  }
+  /**
+   * Save an experiment's setup.
+   *
+   * Send `expectedVersion` with the version you read and the platform refuses
+   * the save with a 409 when someone else wrote first, instead of overwriting
+   * their work.
+   */
+  async setWorkbenchState({
+    slug,
+    state,
+    expectedVersion,
+    commitMessage
+  }) {
+    const { data, error } = await this.apiClient.PUT(
+      "/api/experiments/{slug}/workbench-state",
+      {
+        params: { path: { slug } },
+        body: __spreadValues(__spreadValues({
+          state
+        }, expectedVersion !== void 0 ? { expectedVersion } : {}), commitMessage !== void 0 ? { commitMessage } : {})
+      }
+    );
+    if (error) {
+      this.handleApiError(`save workbench state for "${slug}"`, error);
+    }
+    return data;
+  }
+  /** The experiment's saved versions, newest first. */
+  async listVersions({
+    slug,
+    limit,
+    cursor
+  }) {
+    const { data, error } = await this.apiClient.GET(
+      "/api/experiments/{slug}/versions",
+      {
+        params: {
+          path: { slug },
+          query: __spreadValues(__spreadValues({}, limit !== void 0 ? { limit } : {}), cursor !== void 0 ? { cursor } : {})
+        }
+      }
+    );
+    if (error) {
+      this.handleApiError(`list versions for experiment "${slug}"`, error);
+    }
+    return data;
+  }
+  /**
+   * Bring an old version back by writing it forward as a new save. History is
+   * never rewritten: the version restored from stays in the list.
+   */
+  async restoreVersion({
+    slug,
+    version: version2
+  }) {
+    const { data, error } = await this.apiClient.POST(
+      "/api/experiments/{slug}/versions/{version}/restore",
+      { params: { path: { slug, version: version2 } } }
+    );
+    if (error) {
+      this.handleApiError(
+        `restore version ${version2} of experiment "${slug}"`,
+        error
+      );
+    }
+    return data;
+  }
   async getRunStatus(runId) {
     const { data, error } = await this.apiClient.GET(
       "/api/experiments/runs/{runId}",
@@ -6934,10 +7052,11 @@ _request = new WeakMap();
 
 // src/client-sdk/services/projects/projects-api.service.ts
 var ProjectsApiError = class extends Error {
-  constructor(message, operation, originalError) {
+  constructor(message, operation, originalError, status) {
     super(message);
     this.operation = operation;
     this.originalError = originalError;
+    this.status = status;
     this.name = "ProjectsApiError";
   }
 };
@@ -6947,6 +7066,13 @@ var ProjectsApiService = class {
     this.endpoint = resolveEndpoint(config == null ? void 0 : config.endpoint);
     this.apiKey = (_c = (_b = (_a = config == null ? void 0 : config.apiKey) != null ? _a : scopedApiKey()) != null ? _b : process.env.LANGWATCH_API_KEY) != null ? _c : "";
   }
+  /**
+   * Bearer, never the project-pinned Basic shape the data routes use. The
+   * listing is the question "which projects can this credential see?", so
+   * naming one project in the header would scope the answer to that project
+   * and defeat the call — including the `--project <slug>` lookup, which reads
+   * the listing precisely because it does not know the id yet.
+   */
   headers() {
     return {
       Authorization: `Bearer ${this.apiKey}`,
@@ -6976,7 +7102,12 @@ var ProjectsApiService = class {
         status: response.status,
         message
       });
-      throw new ProjectsApiError(message, operation, parsedBody);
+      throw new ProjectsApiError(
+        message,
+        operation,
+        parsedBody,
+        response.status
+      );
     }
     return await response.json();
   }