braintrust 0.0.166 → 0.0.168

package/dist/cli.js

@@ -1236,7 +1236,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "braintrust",
-      version: "0.0.166",
+      version: "0.0.168",
       description: "SDK for integrating Braintrust",
       repository: {
         type: "git",
@@ -1264,6 +1264,11 @@ var require_package = __commonJS({
           module: "./dist/index.mjs",
           require: "./dist/index.js"
         },
+        "./browser": {
+          import: "./dist/browser.mjs",
+          module: "./dist/browser.mjs",
+          require: "./dist/browser.js"
+        },
         "./ai-sdk": {
           types: "./ai-sdk/dist/index.d.ts",
           import: "./ai-sdk/dist/index.mjs",
@@ -1306,7 +1311,7 @@ var require_package = __commonJS({
       },
       dependencies: {
         "@ai-sdk/provider": "^0.0.11",
-        "@braintrust/core": "0.0.62",
+        "@braintrust/core": "0.0.64",
         "@next/env": "^14.2.3",
         "@vercel/functions": "^1.0.2",
         ai: "^3.2.16",
@@ -1714,6 +1719,9 @@ var NoopSpan = class {
   async export() {
     return "";
   }
+  async permalink() {
+    return "";
+  }
   async flush() {
   }
   close(args) {
@@ -1992,12 +2000,14 @@ var HTTPConnection = class _HTTPConnection {
         ([k, v]) => v !== void 0 ? typeof v === "string" ? [[k, v]] : v.map((x) => [k, x]) : []
       ) : []
     ).toString();
+    const this_fetch = this.fetch;
+    const this_headers = this.headers;
     return await checkResponse(
       // Using toString() here makes it work with isomorphic fetch
-      await this.fetch(url.toString(), {
+      await this_fetch(url.toString(), {
         headers: {
           Accept: "application/json",
-          ...this.headers,
+          ...this_headers,
           ...headers
         },
         keepalive: true,
@@ -2007,13 +2017,16 @@ var HTTPConnection = class _HTTPConnection {
   }
   async post(path9, params, config3) {
     const { headers, ...rest } = config3 || {};
+    const this_fetch = this.fetch;
+    const this_base_url = this.base_url;
+    const this_headers = this.headers;
     return await checkResponse(
-      await this.fetch((0, import_core._urljoin)(this.base_url, path9), {
+      await this_fetch((0, import_core._urljoin)(this_base_url, path9), {
         method: "POST",
         headers: {
           Accept: "application/json",
           "Content-Type": "application/json",
-          ...this.headers,
+          ...this_headers,
           ...headers
         },
         body: typeof params === "string" ? params : params ? JSON.stringify(params) : void 0,
@@ -2046,6 +2059,167 @@ var HTTPConnection = class _HTTPConnection {
     return await resp.json();
   }
 };
+var Attachment = class {
+  /**
+   * The object that replaces this `Attachment` at upload time.
+   */
+  reference;
+  uploader;
+  data;
+  state;
+  // For debug logging only.
+  dataDebugString;
+  /**
+   * Construct an attachment.
+   *
+   * @param data A string representing the path of the file on disk, or a
+   * `Blob`/`ArrayBuffer` with the file's contents. The caller is responsible
+   * for ensuring the file/blob/buffer is not modified until upload is complete.
+   *
+   * @param filename The desired name of the file in Braintrust after uploading.
+   * This parameter is for visualization purposes only and has no effect on
+   * attachment storage.
+   *
+   * @param contentType The MIME type of the file.
+   *
+   * @param state (Optional) For internal use.
+   */
+  constructor({ data, filename, contentType, state }) {
+    this.reference = {
+      type: import_typespecs2.BRAINTRUST_ATTACHMENT,
+      filename,
+      content_type: contentType,
+      key: newId()
+    };
+    this.state = state;
+    this.dataDebugString = typeof data === "string" ? data : "<in-memory data>";
+    this.data = this.initData(data);
+    this.uploader = this.initUploader();
+  }
+  /**
+   * On first access, (1) reads the attachment from disk if needed, (2)
+   * authenticates with the data plane to request a signed URL, (3) uploads to
+   * object store, and (4) updates the attachment.
+   *
+   * @returns The attachment status.
+   */
+  async upload() {
+    return await this.uploader.get();
+  }
+  /**
+   * A human-readable description for logging and debugging.
+   *
+   * @returns The debug object. The return type is not stable and may change in
+   * a future release.
+   */
+  debugInfo() {
+    return {
+      inputData: this.dataDebugString,
+      reference: this.reference,
+      state: this.state
+    };
+  }
+  initUploader() {
+    const doUpload = async (conn, orgId) => {
+      const requestParams = {
+        key: this.reference.key,
+        filename: this.reference.filename,
+        content_type: this.reference.content_type,
+        org_id: orgId
+      };
+      const [metadataPromiseResult, dataPromiseResult] = await Promise.allSettled([
+        conn.post("/attachment", requestParams),
+        this.data.get()
+      ]);
+      if (metadataPromiseResult.status === "rejected") {
+        const errorStr = JSON.stringify(metadataPromiseResult.reason);
+        throw new Error(
+          `Failed to request signed URL from API server: ${errorStr}`
+        );
+      }
+      if (dataPromiseResult.status === "rejected") {
+        const errorStr = JSON.stringify(dataPromiseResult.reason);
+        throw new Error(`Failed to read file: ${errorStr}`);
+      }
+      const metadataResponse = metadataPromiseResult.value;
+      const data = dataPromiseResult.value;
+      let signedUrl;
+      let headers;
+      try {
+        ({ signedUrl, headers } = import_zod2.z.object({
+          signedUrl: import_zod2.z.string().url(),
+          headers: import_zod2.z.record(import_zod2.z.string())
+        }).parse(await metadataResponse.json()));
+      } catch (error2) {
+        if (error2 instanceof import_zod2.ZodError) {
+          const errorStr = JSON.stringify(error2.flatten());
+          throw new Error(`Invalid response from API server: ${errorStr}`);
+        }
+        throw error2;
+      }
+      let objectStoreResponse;
+      try {
+        objectStoreResponse = await checkResponse(
+          await fetch(signedUrl, {
+            method: "PUT",
+            headers,
+            body: data
+          })
+        );
+      } catch (error2) {
+        if (error2 instanceof FailedHTTPResponse) {
+          throw new Error(
+            `Failed to upload attachment to object store: ${error2.status} ${error2.text} ${error2.data}`
+          );
+        }
+        throw error2;
+      }
+      return { signedUrl, metadataResponse, objectStoreResponse };
+    };
+    const errorWrapper = async () => {
+      const status = { upload_status: "done" };
+      const state = this.state ?? _globalState;
+      await state.login({});
+      const conn = state.apiConn();
+      const orgId = state.orgId ?? "";
+      try {
+        await doUpload(conn, orgId);
+      } catch (error2) {
+        status.upload_status = "error";
+        status.error_message = error2 instanceof Error ? error2.message : JSON.stringify(error2);
+      }
+      const requestParams = {
+        key: this.reference.key,
+        org_id: orgId,
+        status
+      };
+      const statusResponse = await conn.post(
+        "/attachment/status",
+        requestParams
+      );
+      if (!statusResponse.ok) {
+        const errorStr = JSON.stringify(statusResponse);
+        throw new Error(`Couldn't log attachment status: ${errorStr}`);
+      }
+      return status;
+    };
+    return new LazyValue(errorWrapper);
+  }
+  initData(data) {
+    if (typeof data === "string") {
+      const readFile3 = isomorph_default.readFile;
+      if (!readFile3) {
+        throw new Error(
+          `This platform does not support reading the filesystem. Construct the Attachment
+with a Blob/ArrayBuffer, or run the program on Node.js.`
+        );
+      }
+      return new LazyValue(async () => new Blob([await readFile3(data)]));
+    } else {
+      return new LazyValue(async () => new Blob([data]));
+    }
+  }
+};
 function logFeedbackImpl(state, parentObjectType, parentObjectId, {
   id,
   expected,
@@ -2070,7 +2244,7 @@ function logFeedbackImpl(state, parentObjectType, parentObjectId, {
     expected,
     tags
   });
-  let { metadata, ...updateEvent } = validatedEvent;
+  let { metadata, ...updateEvent } = deepCopyEvent(validatedEvent);
   updateEvent = Object.fromEntries(
     Object.entries(updateEvent).filter(([_, v]) => !isEmpty(v))
   );
@@ -2119,10 +2293,12 @@ function updateSpanImpl({
   id,
   event
 }) {
-  const updateEvent = validateAndSanitizeExperimentLogPartialArgs({
-    id,
-    ...event
-  });
+  const updateEvent = deepCopyEvent(
+    validateAndSanitizeExperimentLogPartialArgs({
+      id,
+      ...event
+    })
+  );
   const parentIds = async () => new import_core.SpanComponentsV3({
     object_type: parentObjectType,
     object_id: await parentObjectId.get()
@@ -2159,6 +2335,53 @@ function spanComponentsToObjectIdLambda(state, components) {
       throw new Error(`Unknown object type: ${x}`);
   }
 }
+async function spanComponentsToObjectId({
+  components,
+  state
+}) {
+  return await spanComponentsToObjectIdLambda(
+    state ?? _globalState,
+    components
+  )();
+}
+async function permalink(slug, opts) {
+  const state = opts?.state ?? _globalState;
+  const getOrgName = async () => {
+    if (opts?.orgName) {
+      return opts.orgName;
+    }
+    await state.login({});
+    if (!state.orgName) {
+      throw new Error(
+        "Must either provide orgName explicitly or be logged in to a specific org"
+      );
+    }
+    return state.orgName;
+  };
+  const getAppUrl = async () => {
+    if (opts?.appUrl) {
+      return opts.appUrl;
+    }
+    await state.login({});
+    if (!state.appUrl) {
+      throw new Error("Must either provide appUrl explicitly or be logged in");
+    }
+    return state.appUrl;
+  };
+  const components = import_core.SpanComponentsV3.fromStr(slug);
+  const object_type = (0, import_core.spanObjectTypeV3ToString)(components.data.object_type);
+  const [orgName, appUrl, object_id] = await Promise.all([
+    getOrgName(),
+    getAppUrl(),
+    spanComponentsToObjectId({ components, state })
+  ]);
+  const id = components.data.row_id;
+  if (!id) {
+    throw new Error("Span slug does not refer to an individual row");
+  }
+  const urlParams = new URLSearchParams({ object_type, object_id, id });
+  return `${appUrl}/app/${orgName}/object?${urlParams}`;
+}
 function startSpanParentArgs(args) {
   let argParentObjectId = void 0;
   let argParentSpanIds = void 0;
@@ -2256,7 +2479,7 @@ var Logger = class {
    * @param event.id: (Optional) a unique identifier for the event. If you don't provide one, BrainTrust will generate one for you.
    * @param options Additional logging options
    * @param options.allowConcurrentWithSpans in rare cases where you need to log at the top level separately from spans on the logger elsewhere, set this to true.
-   * :returns: The `id` of the logged event.
+   * @returns The `id` of the logged event.
    */
   log(event, options) {
     if (this.calledStartSpan && !options?.allowConcurrentWithSpans) {
@@ -2279,7 +2502,7 @@ var Logger = class {
   /**
    * Create a new toplevel span underneath the logger. The name defaults to "root".
    *
-   * See `Span.traced` for full details.
+   * See {@link Span.traced} for full details.
    */
   traced(callback, args) {
     const { setCurrent, ...argsRest } = args ?? {};
@@ -2313,7 +2536,7 @@ var Logger = class {
    * where you cannot use callbacks. However, spans started with `startSpan` will not be marked as the "current span",
    * so `currentSpan()` and `traced()` will be no-ops. If you want to mark a span as current, use `traced` instead.
    *
-   * See `traced` for full details.
+   * See {@link traced} for full details.
    */
   startSpan(args) {
     this.calledStartSpan = true;
@@ -2353,7 +2576,7 @@ var Logger = class {
    * Update a span in the experiment using its id. It is important that you only update a span once the original span has been fully written and flushed,
    * since otherwise updates to the span may conflict with the original span.
    *
-   * @param event The event data to update the span with. Must include `id`. See `Experiment.log` for a full list of valid fields.
+   * @param event The event data to update the span with. Must include `id`. See {@link Experiment.log} for a full list of valid fields.
    */
   updateSpan(event) {
     const { id, ...eventRest } = event;
@@ -2369,7 +2592,9 @@ var Logger = class {
     });
   }
   /**
-   * Return a serialized representation of the logger that can be used to start subspans in other places. See `Span.start_span` for more details.
+   * Return a serialized representation of the logger that can be used to start subspans in other places.
+   *
+   * See {@link Span.startSpan} for more details.
    */
   async export() {
     return new import_core.SpanComponentsV3({
@@ -2409,6 +2634,7 @@ var BackgroundLogger = class _BackgroundLogger {
   activeFlush = Promise.resolve();
   activeFlushResolved = true;
   activeFlushError = void 0;
+  onFlushError;
   syncFlush = false;
   // 6 MB for the AWS lambda gateway (from our own testing).
   maxRequestSize = 6 * 1024 * 1024;
@@ -2472,6 +2698,7 @@ var BackgroundLogger = class _BackgroundLogger {
         await this.flush();
       });
     }
+    this.onFlushError = opts.onFlushError;
   }
   log(items) {
     const [addedItems, droppedItems] = (() => {
@@ -2503,14 +2730,16 @@ var BackgroundLogger = class _BackgroundLogger {
     if (this.activeFlushError) {
       const err = this.activeFlushError;
       this.activeFlushError = void 0;
-      throw err;
+      if (this.syncFlush) {
+        throw err;
+      }
     }
   }
   async flushOnce(args) {
     const batchSize = args?.batchSize ?? this.defaultBatchSize;
     const wrappedItems = this.items;
     this.items = [];
-    const allItems = await this.unwrapLazyValues(wrappedItems);
+    const [allItems, attachments] = await this.unwrapLazyValues(wrappedItems);
     if (allItems.length === 0) {
       return;
     }
@@ -2542,6 +2771,23 @@ var BackgroundLogger = class _BackgroundLogger {
         );
       }
     }
+    const attachmentErrors = [];
+    for (const attachment of attachments) {
+      try {
+        const result = await attachment.upload();
+        if (result.upload_status === "error" && result.error_message) {
+          attachmentErrors.push(new Error(result.error_message));
+        }
+      } catch (error2) {
+        attachmentErrors.push(error2);
+      }
+    }
+    if (attachmentErrors.length > 0) {
+      throw new AggregateError(
+        attachmentErrors,
+        `Encountered the following errors while uploading attachments:`
+      );
+    }
     if (this.items.length > 0) {
       await this.flushOnce(args);
     }
@@ -2549,8 +2795,10 @@ var BackgroundLogger = class _BackgroundLogger {
   async unwrapLazyValues(wrappedItems) {
     for (let i = 0; i < this.numTries; ++i) {
       try {
-        const itemPromises = wrappedItems.map((x) => x.get());
-        return (0, import_core.mergeRowBatch)(await Promise.all(itemPromises));
+        const items = await Promise.all(wrappedItems.map((x) => x.get()));
+        const attachments = [];
+        items.forEach((item) => extractAttachments(item, attachments));
+        return [(0, import_core.mergeRowBatch)(items), attachments];
       } catch (e) {
         let errmsg = "Encountered error when constructing records to flush";
         const isRetrying = i + 1 < this.numTries;
@@ -2558,7 +2806,10 @@ var BackgroundLogger = class _BackgroundLogger {
           errmsg += ". Retrying";
         }
         console.warn(errmsg);
-        if (!isRetrying && this.syncFlush) {
+        if (!isRetrying) {
+          console.warn(
+            `Failed to construct log records to flush after ${this.numTries} attempts. Dropping batch`
+          );
           throw e;
         } else {
           console.warn(e);
@@ -2566,10 +2817,7 @@ var BackgroundLogger = class _BackgroundLogger {
         }
       }
     }
-    console.warn(
-      `Failed to construct log records to flush after ${this.numTries} attempts. Dropping batch`
-    );
-    return [];
+    throw new Error("Impossible");
   }
   async submitLogsRequest(items) {
     const conn = await this.apiConn.get();
@@ -2585,16 +2833,14 @@ var BackgroundLogger = class _BackgroundLogger {
       let error2 = void 0;
       try {
         await conn.post_json("logs3", dataStr);
-      } catch (e) {
+      } catch {
         try {
           const legacyDataS = (0, import_core.constructJsonArray)(
-            items.map(
-              (r) => JSON.stringify((0, import_core.makeLegacyEvent)(JSON.parse(r)))
-            )
+            items.map((r) => JSON.stringify((0, import_core.makeLegacyEvent)(JSON.parse(r))))
           );
           await conn.post_json("logs", legacyDataS);
-        } catch (e2) {
-          error2 = e2;
+        } catch (e) {
+          error2 = e;
         }
       }
       if (error2 === void 0) {
@@ -2618,7 +2864,10 @@ Error: ${errorText}`;
         });
         this.logFailedPayloadsDir();
       }
-      if (!isRetrying && this.syncFlush) {
+      if (!isRetrying) {
+        console.warn(
+          `log request failed after ${this.numTries} retries. Dropping batch`
+        );
         throw new Error(errMsg);
       } else {
         console.warn(errMsg);
@@ -2627,10 +2876,6 @@ Error: ${errorText}`;
         }
       }
     }
-    console.warn(
-      `log request failed after ${this.numTries} retries. Dropping batch`
-    );
-    return;
   }
   registerDroppedItemCount(numItems) {
     if (numItems <= 0) {
@@ -2658,15 +2903,17 @@ Error: ${errorText}`;
       return;
     }
     try {
-      const allItems = await this.unwrapLazyValues(wrappedItems);
+      const [allItems, allAttachments] = await this.unwrapLazyValues(wrappedItems);
       const dataStr = constructLogs3Data(
         allItems.map((x) => JSON.stringify(x))
       );
+      const attachmentStr = JSON.stringify(
+        allAttachments.map((a) => a.debugInfo())
+      );
+      const payload = `{"data": ${dataStr}, "attachments": ${attachmentStr}}
+`;
       for (const payloadDir of publishPayloadsDir) {
-        await _BackgroundLogger.writePayloadToDir({
-          payloadDir,
-          payload: dataStr
-        });
+        await _BackgroundLogger.writePayloadToDir({ payloadDir, payload });
       }
     } catch (e) {
       console.error(e);
@@ -2705,6 +2952,13 @@ Error: ${errorText}`;
         try {
           await this.flushOnce();
         } catch (err) {
+          if (err instanceof AggregateError) {
+            for (const e of err.errors) {
+              this.onFlushError?.(e);
+            }
+          } else {
+            this.onFlushError?.(err);
+          }
           this.activeFlushError = err;
         } finally {
           this.activeFlushResolved = true;
@@ -3163,6 +3417,47 @@ function validateAndSanitizeExperimentLogPartialArgs(event) {
     return { ...event };
   }
 }
+function deepCopyEvent(event) {
+  const attachments = [];
+  const IDENTIFIER = "_bt_internal_saved_attachment";
+  const savedAttachmentSchema = import_zod2.z.strictObject({ [IDENTIFIER]: import_zod2.z.number() });
+  const serialized = JSON.stringify(event, (_k, v) => {
+    if (v instanceof SpanImpl || v instanceof NoopSpan) {
+      return `<span>`;
+    } else if (v instanceof Experiment) {
+      return `<experiment>`;
+    } else if (v instanceof Dataset) {
+      return `<dataset>`;
+    } else if (v instanceof Logger) {
+      return `<logger>`;
+    } else if (v instanceof Attachment) {
+      const idx = attachments.push(v);
+      return { [IDENTIFIER]: idx - 1 };
+    }
+    return v;
+  });
+  const x = JSON.parse(serialized, (_k, v) => {
+    const parsedAttachment = savedAttachmentSchema.safeParse(v);
+    if (parsedAttachment.success) {
+      return attachments[parsedAttachment.data[IDENTIFIER]];
+    }
+    return v;
+  });
+  return x;
+}
+function extractAttachments(event, attachments) {
+  for (const [key, value] of Object.entries(event)) {
+    if (value instanceof Attachment) {
+      attachments.push(value);
+      event[key] = value.reference;
+      continue;
+    }
+    if (!(value instanceof Object)) {
+      continue;
+    }
+    extractAttachments(value, attachments);
+  }
+}
 function validateAndSanitizeExperimentLogFullArgs(event, hasDataset) {
   if ("input" in event && !isEmpty(event.input) && "inputs" in event && !isEmpty(event.inputs) || !("input" in event) && !("inputs" in event)) {
     throw new Error(
@@ -3293,10 +3588,9 @@ var Experiment = class extends ObjectFetcher {
    * @param event.metrics: (Optional) a dictionary of metrics to log. The following keys are populated automatically: "start", "end".
    * @param event.id: (Optional) a unique identifier for the event. If you don't provide one, BrainTrust will generate one for you.
    * @param event.dataset_record_id: (Optional) the id of the dataset record that this event is associated with. This field is required if and only if the experiment is associated with a dataset.
-   * @param event.inputs: (Deprecated) the same as `input` (will be removed in a future version).
    * @param options Additional logging options
    * @param options.allowConcurrentWithSpans in rare cases where you need to log at the top level separately from spans on the experiment elsewhere, set this to true.
-   * :returns: The `id` of the logged event.
+   * @returns The `id` of the logged event.
    */
   log(event, options) {
     if (this.calledStartSpan && !options?.allowConcurrentWithSpans) {
@@ -3312,7 +3606,7 @@ var Experiment = class extends ObjectFetcher {
   /**
    * Create a new toplevel span underneath the experiment. The name defaults to "root".
    *
-   * See `Span.traced` for full details.
+   * See {@link Span.traced} for full details.
    */
   traced(callback, args) {
     const { setCurrent, ...argsRest } = args ?? {};
@@ -3338,7 +3632,7 @@ var Experiment = class extends ObjectFetcher {
    * where you cannot use callbacks. However, spans started with `startSpan` will not be marked as the "current span",
    * so `currentSpan()` and `traced()` will be no-ops. If you want to mark a span as current, use `traced` instead.
    *
-   * See `traced` for full details.
+   * See {@link traced} for full details.
    */
   startSpan(args) {
     this.calledStartSpan = true;
@@ -3450,7 +3744,7 @@ var Experiment = class extends ObjectFetcher {
    * Update a span in the experiment using its id. It is important that you only update a span once the original span has been fully written and flushed,
    * since otherwise updates to the span may conflict with the original span.
    *
-   * @param event The event data to update the span with. Must include `id`. See `Experiment.log` for a full list of valid fields.
+   * @param event The event data to update the span with. Must include `id`. See {@link Experiment.log} for a full list of valid fields.
    */
   updateSpan(event) {
     const { id, ...eventRest } = event;
@@ -3466,7 +3760,9 @@ var Experiment = class extends ObjectFetcher {
     });
   }
   /**
-   * Return a serialized representation of the experiment that can be used to start subspans in other places. See `Span.start_span` for more details.
+   * Return a serialized representation of the experiment that can be used to start subspans in other places.
+   *
+   * See {@link Span.startSpan} for more details.
    */
   async export() {
     return new import_core.SpanComponentsV3({
@@ -3481,7 +3777,7 @@ var Experiment = class extends ObjectFetcher {
     return await this.state.bgLogger().flush();
   }
   /**
-   * This function is deprecated. You can simply remove it from your code.
+   * @deprecated This function is deprecated. You can simply remove it from your code.
    */
   async close() {
     console.warn(
@@ -3534,6 +3830,9 @@ var ReadonlyExperiment = class extends ObjectFetcher {
   }
 };
 var executionCounter = 0;
+function newId() {
+  return (0, import_uuid.v4)();
+}
 var SpanImpl = class _SpanImpl {
   state;
   isMerge;
@@ -3620,27 +3919,14 @@ var SpanImpl = class _SpanImpl {
       event,
       internalData
     });
-    let partialRecord = {
+    const partialRecord = deepCopyEvent({
       id: this.id,
       span_id: this.spanId,
       root_span_id: this.rootSpanId,
       span_parents: this.spanParents,
       ...serializableInternalData,
       [import_core.IS_MERGE_FIELD]: this.isMerge
-    };
-    const serializedPartialRecord = JSON.stringify(partialRecord, (_k, v) => {
-      if (v instanceof _SpanImpl) {
-        return `<span>`;
-      } else if (v instanceof Experiment) {
-        return `<experiment>`;
-      } else if (v instanceof Dataset) {
-        return `<dataset>`;
-      } else if (v instanceof Logger) {
-        return `<logger>`;
-      }
-      return v;
     });
-    partialRecord = JSON.parse(serializedPartialRecord);
     if (partialRecord.metrics?.end) {
       this.loggedEndTime = partialRecord.metrics?.end;
     }
@@ -3726,6 +4012,11 @@ var SpanImpl = class _SpanImpl {
       propagated_event: this.propagatedEvent
     }).toStr();
   }
+  async permalink() {
+    return await permalink(await this.export(), {
+      state: this.state
+    });
+  }
   async flush() {
     return await this.state.bgLogger().flush();
   }
@@ -3875,15 +4166,17 @@ var Dataset = class extends ObjectFetcher {
   }) {
     this.validateEvent({ metadata, expected, output, tags });
     const rowId = id || (0, import_uuid.v4)();
-    const args = this.createArgs({
-      id: rowId,
-      input,
-      expected,
-      metadata,
-      tags,
-      output,
-      isMerge: false
-    });
+    const args = this.createArgs(
+      deepCopyEvent({
+        id: rowId,
+        input,
+        expected,
+        metadata,
+        tags,
+        output,
+        isMerge: false
+      })
+    );
     this.state.bgLogger().log([args]);
     return rowId;
   }
@@ -3908,14 +4201,16 @@ var Dataset = class extends ObjectFetcher {
     id
   }) {
     this.validateEvent({ metadata, expected, tags });
-    const args = this.createArgs({
-      id,
-      input,
-      expected,
-      metadata,
-      tags,
-      isMerge: true
-    });
+    const args = this.createArgs(
+      deepCopyEvent({
+        id,
+        input,
+        expected,
+        metadata,
+        tags,
+        isMerge: true
+      })
+    );
     this.state.bgLogger().log([args]);
     return id;
   }
@@ -3970,7 +4265,7 @@ var Dataset = class extends ObjectFetcher {
     return await this.state.bgLogger().flush();
   }
   /**
-   * This function is deprecated. You can simply remove it from your code.
+   * @deprecated This function is deprecated. You can simply remove it from your code.
    */
   async close() {
     console.warn(
@@ -5371,7 +5666,10 @@ function parseFilters(filters) {
 function evaluateFilter(object, filter2) {
   const { path: path9, pattern } = filter2;
   const key = path9.reduce(
-    (acc, p) => typeof acc === "object" && acc !== null ? acc[p] : void 0,
+    (acc, p) => typeof acc === "object" && acc !== null ? (
+      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+      acc[p]
+    ) : void 0,
     object
   );
   if (key === void 0) {
@@ -5478,7 +5776,12 @@ async function runEvaluatorInternal(experiment, evaluator, progressReporter, fil
             }
           );
           rootSpan.log({ output, metadata });
-          const scoringArgs = { ...datum, metadata, output };
+          const scoringArgs = {
+            input: datum.input,
+            expected: "expected" in datum ? datum.expected : void 0,
+            metadata,
+            output
+          };
           const scorerNames = evaluator.scores.map(scorerName);
           const scoreResults = await Promise.all(
             evaluator.scores.map(async (score, score_idx) => {
@@ -5605,7 +5908,13 @@ async function runEvaluatorInternal(experiment, evaluator, progressReporter, fil
           event: {
             input: datum.input,
             expected: "expected" in datum ? datum.expected : void 0,
-            tags: datum.tags
+            tags: datum.tags,
+            origin: experiment.dataset && datum.id && datum._xact_id ? {
+              object_type: "dataset",
+              object_id: await experiment.dataset.id,
+              id: datum.id,
+              _xact_id: datum._xact_id
+            } : void 0
           }
         });
       }
@@ -5965,6 +6274,7 @@ function configureNode() {
   isomorph_default.pathDirname = path.dirname;
   isomorph_default.mkdir = fs.mkdir;
   isomorph_default.writeFile = fs.writeFile;
+  isomorph_default.readFile = fs.readFile;
   _internalSetInitialState();
 }
 
@@ -6221,7 +6531,7 @@ async function getTsModule() {
     } catch (e) {
       console.warn(
         warning(
-          "Failed to load TypeScript module. Will not use Typescript to derive previe."
+          "Failed to load TypeScript module. Will not use TypeScript to derive preview."
         )
       );
     }
@@ -6302,7 +6612,8 @@ async function uploadHandleBundles({
               }
             })
           );
-          prompt_data.tool_functions = resolvableToolFunctions;
+          prompt_data.tool_functions = // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+          resolvableToolFunctions;
         }
         prompts.push({
           project_id: await resolveProjectId(prompt.project),
@@ -6481,6 +6792,7 @@ async function uploadBundles({
   const sourceMapContext = await sourceMapContextPromise;
   const functionEntries = [
     ...prompts,
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     ...await Promise.all(
       bundleSpecs.map(async (spec) => ({
         project_id: spec.project_id,