langgraph-ui-components 0.0.10 → 0.0.11-testing

package/dist/index.es121.js

@@ -1,283 +1,909 @@
-import { __export } from "./index.es52.js";
-import { _deepClone, PatchError, unescapePathComponent, isInteger, hasUndefined } from "./index.es239.js";
-var core_exports = {};
-__export(core_exports, {
-  JsonPatchError: () => JsonPatchError,
-  _areEquals: () => _areEquals,
-  applyOperation: () => applyOperation,
-  applyPatch: () => applyPatch,
-  applyReducer: () => applyReducer,
-  deepClone: () => deepClone,
-  getValueByPointer: () => getValueByPointer,
-  validate: () => validate,
-  validator: () => validator
-});
-const JsonPatchError = PatchError;
-const deepClone = _deepClone;
-function isDangerousKey(key) {
-  return Object.getOwnPropertyNames(Object.prototype).includes(key);
+import { Client } from "./index.es280.js";
+import { isTracingEnabled } from "./index.es292.js";
+import { isConflictingEndpointsError, ConflictingEndpointsError } from "./index.es289.js";
+import { _LC_CONTEXT_VARIABLES_KEY, _REPLICA_TRACE_ROOTS_KEY } from "./index.es293.js";
+import { getContextVar, setContextVar } from "./index.es294.js";
+import { getEnvironmentVariable, getRuntimeEnvironment, getLangSmithEnvironmentVariable } from "./index.es285.js";
+import { getDefaultProjectName } from "./index.es263.js";
+import { warnOnce } from "./index.es287.js";
+import { uuid7FromTime } from "./index.es286.js";
+import { v5 } from "uuid";
+const UUID_NAMESPACE_DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
+function getReplicaKey(replica) {
+  const sortedKeys = Object.keys(replica).sort();
+  const keyData = sortedKeys.map((key) => `${key}:${replica[key] ?? ""}`).join("|");
+  return v5(keyData, UUID_NAMESPACE_DNS);
 }
-const objOps = {
-  add: function(obj, key, document) {
-    if (isDangerousKey(key)) throw new TypeError("JSON-Patch: modifying `__proto__`, `constructor`, or `prototype` prop is banned for security reasons");
-    obj[key] = this.value;
-    return { newDocument: document };
-  },
-  remove: function(obj, key, document) {
-    if (isDangerousKey(key)) throw new TypeError("JSON-Patch: modifying `__proto__`, `constructor`, or `prototype` prop is banned for security reasons");
-    var removed = obj[key];
-    delete obj[key];
-    return {
-      newDocument: document,
-      removed
-    };
-  },
-  replace: function(obj, key, document) {
-    if (isDangerousKey(key)) throw new TypeError("JSON-Patch: modifying `__proto__`, `constructor`, or `prototype` prop is banned for security reasons");
-    var removed = obj[key];
-    obj[key] = this.value;
-    return {
-      newDocument: document,
-      removed
-    };
-  },
-  move: function(obj, key, document) {
-    let removed = getValueByPointer(document, this.path);
-    if (removed) removed = _deepClone(removed);
-    const originalValue = applyOperation(document, {
-      op: "remove",
-      path: this.from
-    }).removed;
-    applyOperation(document, {
-      op: "add",
-      path: this.path,
-      value: originalValue
+function stripNonAlphanumeric(input) {
+  return input.replace(/[-:.]/g, "");
+}
+function getMicrosecondPrecisionDatestring(epoch, executionOrder = 1) {
+  const paddedOrder = executionOrder.toFixed(0).slice(0, 3).padStart(3, "0");
+  return `${new Date(epoch).toISOString().slice(0, -1)}${paddedOrder}Z`;
+}
+function convertToDottedOrderFormat(epoch, runId, executionOrder = 1) {
+  const microsecondPrecisionDatestring = getMicrosecondPrecisionDatestring(epoch, executionOrder);
+  return {
+    dottedOrder: stripNonAlphanumeric(microsecondPrecisionDatestring) + runId,
+    microsecondPrecisionDatestring
+  };
+}
+const HEADER_SAFE_REPLICA_FIELDS = /* @__PURE__ */ new Set([
+  "projectName",
+  "updates",
+  "reroot"
+]);
+function filterReplicaForHeaders(replica) {
+  const filtered = {};
+  for (const key of Object.keys(replica)) {
+    if (HEADER_SAFE_REPLICA_FIELDS.has(key)) {
+      filtered[key] = replica[key];
+    }
+  }
+  return filtered;
+}
+class Baggage {
+  constructor(metadata, tags, project_name, replicas) {
+    Object.defineProperty(this, "metadata", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
     });
-    return {
-      newDocument: document,
-      removed
+    Object.defineProperty(this, "tags", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "project_name", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "replicas", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    this.metadata = metadata;
+    this.tags = tags;
+    this.project_name = project_name;
+    this.replicas = replicas;
+  }
+  static fromHeader(value) {
+    const items = value.split(",");
+    let metadata = {};
+    let tags = [];
+    let project_name;
+    let replicas;
+    for (const item of items) {
+      const [key, uriValue] = item.split("=");
+      const value2 = decodeURIComponent(uriValue);
+      if (key === "langsmith-metadata") {
+        metadata = JSON.parse(value2);
+      } else if (key === "langsmith-tags") {
+        tags = value2.split(",");
+      } else if (key === "langsmith-project") {
+        project_name = value2;
+      } else if (key === "langsmith-replicas") {
+        const parsed = JSON.parse(value2);
+        replicas = parsed.map((replica) => {
+          if (Array.isArray(replica)) {
+            return replica;
+          }
+          return filterReplicaForHeaders(replica);
+        });
+      }
+    }
+    return new Baggage(metadata, tags, project_name, replicas);
+  }
+  toHeader() {
+    const items = [];
+    if (this.metadata && Object.keys(this.metadata).length > 0) {
+      items.push(`langsmith-metadata=${encodeURIComponent(JSON.stringify(this.metadata))}`);
+    }
+    if (this.tags && this.tags.length > 0) {
+      items.push(`langsmith-tags=${encodeURIComponent(this.tags.join(","))}`);
+    }
+    if (this.project_name) {
+      items.push(`langsmith-project=${encodeURIComponent(this.project_name)}`);
+    }
+    return items.join(",");
+  }
+}
+class RunTree {
+  constructor(originalConfig) {
+    Object.defineProperty(this, "id", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "name", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "run_type", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "project_name", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "parent_run", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "parent_run_id", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "child_runs", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "start_time", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "end_time", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "extra", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "tags", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "error", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "serialized", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "inputs", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "outputs", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "reference_example_id", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "client", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "events", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "trace_id", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "dotted_order", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "tracingEnabled", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "execution_order", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "child_execution_order", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "attachments", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "replicas", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "distributedParentId", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "_serialized_start_time", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "_awaitInputsOnPost", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    if (isRunTree(originalConfig)) {
+      Object.assign(this, { ...originalConfig });
+      return;
+    }
+    const defaultConfig = RunTree.getDefaultConfig();
+    const { metadata, ...config } = originalConfig;
+    const client = config.client ?? RunTree.getSharedClient();
+    const dedupedMetadata = {
+      ...metadata,
+      ...config?.extra?.metadata
     };
-  },
-  copy: function(obj, key, document) {
-    const valueToCopy = getValueByPointer(document, this.from);
-    applyOperation(document, {
-      op: "add",
-      path: this.path,
-      value: _deepClone(valueToCopy)
-    });
-    return { newDocument: document };
-  },
-  test: function(obj, key, document) {
-    return {
-      newDocument: document,
-      test: _areEquals(obj[key], this.value)
+    config.extra = { ...config.extra, metadata: dedupedMetadata };
+    if ("id" in config && config.id == null) {
+      delete config.id;
+    }
+    Object.assign(this, { ...defaultConfig, ...config, client });
+    this.execution_order ??= 1;
+    this.child_execution_order ??= 1;
+    if (!this.dotted_order) {
+      this._serialized_start_time = getMicrosecondPrecisionDatestring(this.start_time, this.execution_order);
+    }
+    if (!this.id) {
+      this.id = uuid7FromTime(this._serialized_start_time ?? this.start_time);
+    }
+    if (!this.trace_id) {
+      if (this.parent_run) {
+        this.trace_id = this.parent_run.trace_id ?? this.id;
+      } else {
+        this.trace_id = this.id;
+      }
+    }
+    this.replicas = _ensureWriteReplicas(this.replicas);
+    if (!this.dotted_order) {
+      const { dottedOrder } = convertToDottedOrderFormat(this.start_time, this.id, this.execution_order);
+      if (this.parent_run) {
+        this.dotted_order = this.parent_run.dotted_order + "." + dottedOrder;
+      } else {
+        this.dotted_order = dottedOrder;
+      }
+    }
+  }
+  set metadata(metadata) {
+    this.extra = {
+      ...this.extra,
+      metadata: {
+        ...this.extra?.metadata,
+        ...metadata
+      }
     };
-  },
-  _get: function(obj, key, document) {
-    this.value = obj[key];
-    return { newDocument: document };
   }
-};
-var arrOps = {
-  add: function(arr, i, document) {
-    if (isInteger(i)) arr.splice(i, 0, this.value);
-    else arr[i] = this.value;
+  get metadata() {
+    return this.extra?.metadata;
+  }
+  static getDefaultConfig() {
+    const start_time = Date.now();
     return {
-      newDocument: document,
-      index: i
+      run_type: "chain",
+      project_name: getDefaultProjectName(),
+      child_runs: [],
+      api_url: getEnvironmentVariable("LANGCHAIN_ENDPOINT") ?? "http://localhost:1984",
+      api_key: getEnvironmentVariable("LANGCHAIN_API_KEY"),
+      caller_options: {},
+      start_time,
+      serialized: {},
+      inputs: {},
+      extra: {}
     };
-  },
-  remove: function(arr, i, document) {
-    var removedList = arr.splice(i, 1);
+  }
+  static getSharedClient() {
+    if (!RunTree.sharedClient) {
+      RunTree.sharedClient = new Client();
+    }
+    return RunTree.sharedClient;
+  }
+  createChild(config) {
+    const child_execution_order = this.child_execution_order + 1;
+    const inheritedReplicas = this.replicas?.map((replica) => {
+      const { reroot, ...rest } = replica;
+      return rest;
+    });
+    const childReplicas = config.replicas ?? inheritedReplicas;
+    const child = new RunTree({
+      ...config,
+      parent_run: this,
+      project_name: this.project_name,
+      replicas: childReplicas,
+      client: this.client,
+      tracingEnabled: this.tracingEnabled,
+      execution_order: child_execution_order,
+      child_execution_order
+    });
+    if (_LC_CONTEXT_VARIABLES_KEY in this) {
+      child[_LC_CONTEXT_VARIABLES_KEY] = this[_LC_CONTEXT_VARIABLES_KEY];
+    }
+    const LC_CHILD = /* @__PURE__ */ Symbol.for("lc:child_config");
+    const presentConfig = config.extra?.[LC_CHILD] ?? this.extra[LC_CHILD];
+    if (isRunnableConfigLike(presentConfig)) {
+      const newConfig = { ...presentConfig };
+      const callbacks = isCallbackManagerLike(newConfig.callbacks) ? newConfig.callbacks.copy?.() : void 0;
+      if (callbacks) {
+        Object.assign(callbacks, { _parentRunId: child.id });
+        callbacks.handlers?.find(isLangChainTracerLike)?.updateFromRunTree?.(child);
+        newConfig.callbacks = callbacks;
+      }
+      child.extra[LC_CHILD] = newConfig;
+    }
+    const visited = /* @__PURE__ */ new Set();
+    let current = this;
+    while (current != null && !visited.has(current.id)) {
+      visited.add(current.id);
+      current.child_execution_order = Math.max(current.child_execution_order, child_execution_order);
+      current = current.parent_run;
+    }
+    this.child_runs.push(child);
+    return child;
+  }
+  async end(outputs, error, endTime = Date.now(), metadata) {
+    this.outputs = this.outputs ?? outputs;
+    this.error = this.error ?? error;
+    this.end_time = this.end_time ?? endTime;
+    if (metadata && Object.keys(metadata).length > 0) {
+      this.extra = this.extra ? { ...this.extra, metadata: { ...this.extra.metadata, ...metadata } } : { metadata };
+    }
+  }
+  _convertToCreate(run, runtimeEnv, excludeChildRuns = true) {
+    const runExtra = run.extra ?? {};
+    if (runExtra?.runtime?.library === void 0) {
+      if (!runExtra.runtime) {
+        runExtra.runtime = {};
+      }
+      if (runtimeEnv) {
+        for (const [k, v] of Object.entries(runtimeEnv)) {
+          if (!runExtra.runtime[k]) {
+            runExtra.runtime[k] = v;
+          }
+        }
+      }
+    }
+    let child_runs;
+    let parent_run_id;
+    if (!excludeChildRuns) {
+      child_runs = run.child_runs.map((child_run) => this._convertToCreate(child_run, runtimeEnv, excludeChildRuns));
+      parent_run_id = void 0;
+    } else {
+      parent_run_id = run.parent_run?.id ?? run.parent_run_id;
+      child_runs = [];
+    }
     return {
-      newDocument: document,
-      removed: removedList[0]
+      id: run.id,
+      name: run.name,
+      start_time: run._serialized_start_time ?? run.start_time,
+      end_time: run.end_time,
+      run_type: run.run_type,
+      reference_example_id: run.reference_example_id,
+      extra: runExtra,
+      serialized: run.serialized,
+      error: run.error,
+      inputs: run.inputs,
+      outputs: run.outputs,
+      session_name: run.project_name,
+      child_runs,
+      parent_run_id,
+      trace_id: run.trace_id,
+      dotted_order: run.dotted_order,
+      tags: run.tags,
+      attachments: run.attachments,
+      events: run.events
     };
-  },
-  replace: function(arr, i, document) {
-    var removed = arr[i];
-    arr[i] = this.value;
+  }
+  _sliceParentId(parentId, run) {
+    if (run.dotted_order) {
+      const segs = run.dotted_order.split(".");
+      let startIdx = null;
+      for (let idx = 0; idx < segs.length; idx++) {
+        const segId = segs[idx].slice(-36);
+        if (segId === parentId) {
+          startIdx = idx;
+          break;
+        }
+      }
+      if (startIdx !== null) {
+        const trimmedSegs = segs.slice(startIdx + 1);
+        run.dotted_order = trimmedSegs.join(".");
+        if (trimmedSegs.length > 0) {
+          run.trace_id = trimmedSegs[0].slice(-36);
+        } else {
+          run.trace_id = run.id;
+        }
+      }
+    }
+    if (run.parent_run_id === parentId) {
+      run.parent_run_id = void 0;
+    }
+  }
+  _setReplicaTraceRoot(replicaKey, traceRootId) {
+    const replicaTraceRoots = getContextVar(this, _REPLICA_TRACE_ROOTS_KEY) ?? {};
+    replicaTraceRoots[replicaKey] = traceRootId;
+    setContextVar(this, _REPLICA_TRACE_ROOTS_KEY, replicaTraceRoots);
+    for (const child of this.child_runs) {
+      child._setReplicaTraceRoot(replicaKey, traceRootId);
+    }
+  }
+  _remapForProject(params) {
+    const { projectName, runtimeEnv, excludeChildRuns = true, reroot = false, distributedParentId, apiUrl, apiKey, workspaceId } = params;
+    const baseRun = this._convertToCreate(this, runtimeEnv, excludeChildRuns);
+    if (projectName === this.project_name) {
+      return {
+        ...baseRun,
+        session_name: projectName
+      };
+    }
+    if (reroot) {
+      if (distributedParentId) {
+        this._sliceParentId(distributedParentId, baseRun);
+      } else {
+        baseRun.parent_run_id = void 0;
+        if (baseRun.dotted_order) {
+          const segs = baseRun.dotted_order.split(".");
+          if (segs.length > 0) {
+            baseRun.dotted_order = segs[segs.length - 1];
+            baseRun.trace_id = baseRun.id;
+          }
+        }
+      }
+      const replicaKey = getReplicaKey({
+        projectName,
+        apiUrl,
+        apiKey,
+        workspaceId
+      });
+      this._setReplicaTraceRoot(replicaKey, baseRun.id);
+    }
+    let ancestorRerootedTraceId;
+    if (!reroot) {
+      const replicaTraceRoots = getContextVar(this, _REPLICA_TRACE_ROOTS_KEY) ?? {};
+      const replicaKey = getReplicaKey({
+        projectName,
+        apiUrl,
+        apiKey,
+        workspaceId
+      });
+      ancestorRerootedTraceId = replicaTraceRoots[replicaKey];
+      if (ancestorRerootedTraceId) {
+        baseRun.trace_id = ancestorRerootedTraceId;
+        if (baseRun.dotted_order) {
+          const segs = baseRun.dotted_order.split(".");
+          let rootIdx = null;
+          for (let idx = 0; idx < segs.length; idx++) {
+            const segId = segs[idx].slice(-36);
+            if (segId === ancestorRerootedTraceId) {
+              rootIdx = idx;
+              break;
+            }
+          }
+          if (rootIdx !== null) {
+            const trimmedSegs = segs.slice(rootIdx);
+            baseRun.dotted_order = trimmedSegs.join(".");
+          }
+        }
+      }
+    }
+    const oldId = baseRun.id;
+    const newId = v5(`${oldId}:${projectName}`, UUID_NAMESPACE_DNS);
+    let newTraceId;
+    if (baseRun.trace_id) {
+      newTraceId = v5(`${baseRun.trace_id}:${projectName}`, UUID_NAMESPACE_DNS);
+    } else {
+      newTraceId = newId;
+    }
+    let newParentId;
+    if (baseRun.parent_run_id) {
+      newParentId = v5(`${baseRun.parent_run_id}:${projectName}`, UUID_NAMESPACE_DNS);
+    }
+    let newDottedOrder;
+    if (baseRun.dotted_order) {
+      const segs = baseRun.dotted_order.split(".");
+      const remappedSegs = segs.map((seg) => {
+        const segId = seg.slice(-36);
+        const remappedId = v5(`${segId}:${projectName}`, UUID_NAMESPACE_DNS);
+        return seg.slice(0, -36) + remappedId;
+      });
+      newDottedOrder = remappedSegs.join(".");
+    }
     return {
-      newDocument: document,
-      removed
+      ...baseRun,
+      id: newId,
+      trace_id: newTraceId,
+      parent_run_id: newParentId,
+      dotted_order: newDottedOrder,
+      session_name: projectName
     };
-  },
-  move: objOps.move,
-  copy: objOps.copy,
-  test: objOps.test,
-  _get: objOps._get
-};
-function getValueByPointer(document, pointer) {
-  if (pointer == "") return document;
-  var getOriginalDestination = {
-    op: "_get",
-    path: pointer
-  };
-  applyOperation(document, getOriginalDestination);
-  return getOriginalDestination.value;
-}
-function applyOperation(document, operation, validateOperation = false, mutateDocument = true, banPrototypeModifications = true, index = 0) {
-  if (validateOperation) if (typeof validateOperation == "function") validateOperation(operation, 0, document, operation.path);
-  else validator(operation, 0);
-  if (operation.path === "") {
-    let returnValue = { newDocument: document };
-    if (operation.op === "add") {
-      returnValue.newDocument = operation.value;
-      return returnValue;
-    } else if (operation.op === "replace") {
-      returnValue.newDocument = operation.value;
-      returnValue.removed = document;
-      return returnValue;
-    } else if (operation.op === "move" || operation.op === "copy") {
-      returnValue.newDocument = getValueByPointer(document, operation.from);
-      if (operation.op === "move") returnValue.removed = document;
-      return returnValue;
-    } else if (operation.op === "test") {
-      returnValue.test = _areEquals(document, operation.value);
-      if (returnValue.test === false) throw new JsonPatchError("Test operation failed", "TEST_OPERATION_FAILED", index, operation, document);
-      returnValue.newDocument = document;
-      return returnValue;
-    } else if (operation.op === "remove") {
-      returnValue.removed = document;
-      returnValue.newDocument = null;
-      return returnValue;
-    } else if (operation.op === "_get") {
-      operation.value = document;
-      return returnValue;
-    } else if (validateOperation) throw new JsonPatchError("Operation `op` property is not one of operations defined in RFC-6902", "OPERATION_OP_INVALID", index, operation, document);
-    else return returnValue;
-  } else {
-    if (!mutateDocument) document = _deepClone(document);
-    const path = operation.path || "";
-    const keys = path.split("/");
-    let obj = document;
-    let t = 1;
-    let len = keys.length;
-    let existingPathFragment = void 0;
-    let key;
-    let validateFunction;
-    if (typeof validateOperation == "function") validateFunction = validateOperation;
-    else validateFunction = validator;
-    while (true) {
-      key = keys[t];
-      if (key && key.indexOf("~") != -1) key = unescapePathComponent(key);
-      if (banPrototypeModifications && (key == "__proto__" || key == "prototype" && t > 0 && keys[t - 1] == "constructor")) throw new TypeError("JSON-Patch: modifying `__proto__` or `constructor/prototype` prop is banned for security reasons, if this was on purpose, please set `banPrototypeModifications` flag false and pass it to this function. More info in fast-json-patch README");
-      if (validateOperation) {
-        if (existingPathFragment === void 0) {
-          if (obj[key] === void 0) existingPathFragment = keys.slice(0, t).join("/");
-          else if (t == len - 1) existingPathFragment = operation.path;
-          if (existingPathFragment !== void 0) validateFunction(operation, 0, document, existingPathFragment);
+  }
+  async postRun(excludeChildRuns = true) {
+    if (this._awaitInputsOnPost) {
+      this.inputs = await this.inputs;
+    }
+    try {
+      const runtimeEnv = getRuntimeEnvironment();
+      if (this.replicas && this.replicas.length > 0) {
+        for (const { projectName, apiKey, apiUrl, workspaceId, reroot } of this.replicas) {
+          const runCreate = this._remapForProject({
+            projectName: projectName ?? this.project_name,
+            runtimeEnv,
+            excludeChildRuns: true,
+            reroot,
+            distributedParentId: this.distributedParentId,
+            apiUrl,
+            apiKey,
+            workspaceId
+          });
+          await this.client.createRun(runCreate, {
+            apiKey,
+            apiUrl,
+            workspaceId
+          });
         }
+      } else {
+        const runCreate = this._convertToCreate(this, runtimeEnv, excludeChildRuns);
+        await this.client.createRun(runCreate);
       }
-      t++;
-      if (Array.isArray(obj)) {
-        if (key === "-") key = obj.length;
-        else if (validateOperation && !isInteger(key)) throw new JsonPatchError("Expected an unsigned base-10 integer value, making the new referenced value the array element with the zero-based index", "OPERATION_PATH_ILLEGAL_ARRAY_INDEX", index, operation, document);
-        else if (isInteger(key)) key = ~~key;
-        if (t >= len) {
-          if (validateOperation && operation.op === "add" && key > obj.length) throw new JsonPatchError("The specified index MUST NOT be greater than the number of elements in the array", "OPERATION_VALUE_OUT_OF_BOUNDS", index, operation, document);
-          const returnValue = arrOps[operation.op].call(operation, obj, key, document);
-          if (returnValue.test === false) throw new JsonPatchError("Test operation failed", "TEST_OPERATION_FAILED", index, operation, document);
-          return returnValue;
+      if (!excludeChildRuns) {
+        warnOnce("Posting with excludeChildRuns=false is deprecated and will be removed in a future version.");
+        for (const childRun of this.child_runs) {
+          await childRun.postRun(false);
         }
-      } else if (t >= len) {
-        const returnValue = objOps[operation.op].call(operation, obj, key, document);
-        if (returnValue.test === false) throw new JsonPatchError("Test operation failed", "TEST_OPERATION_FAILED", index, operation, document);
-        return returnValue;
       }
-      obj = obj[key];
-      if (validateOperation && t < len && (!obj || typeof obj !== "object")) throw new JsonPatchError("Cannot perform operation at the desired path", "OPERATION_PATH_UNRESOLVABLE", index, operation, document);
+      this.child_runs = [];
+    } catch (error) {
+      console.error(`Error in postRun for run ${this.id}:`, error);
     }
   }
-}
-function applyPatch(document, patch, validateOperation, mutateDocument = true, banPrototypeModifications = true) {
-  if (validateOperation) {
-    if (!Array.isArray(patch)) throw new JsonPatchError("Patch sequence must be an array", "SEQUENCE_NOT_AN_ARRAY");
+  async patchRun(options) {
+    if (this.replicas && this.replicas.length > 0) {
+      for (const { projectName, apiKey, apiUrl, workspaceId, updates, reroot } of this.replicas) {
+        const runData = this._remapForProject({
+          projectName: projectName ?? this.project_name,
+          runtimeEnv: void 0,
+          excludeChildRuns: true,
+          reroot,
+          distributedParentId: this.distributedParentId,
+          apiUrl,
+          apiKey,
+          workspaceId
+        });
+        const updatePayload = {
+          id: runData.id,
+          name: runData.name,
+          run_type: runData.run_type,
+          start_time: runData.start_time,
+          outputs: runData.outputs,
+          error: runData.error,
+          parent_run_id: runData.parent_run_id,
+          session_name: runData.session_name,
+          reference_example_id: runData.reference_example_id,
+          end_time: runData.end_time,
+          dotted_order: runData.dotted_order,
+          trace_id: runData.trace_id,
+          events: runData.events,
+          tags: runData.tags,
+          extra: runData.extra,
+          attachments: this.attachments,
+          ...updates
+        };
+        if (!options?.excludeInputs) {
+          updatePayload.inputs = runData.inputs;
+        }
+        await this.client.updateRun(runData.id, updatePayload, {
+          apiKey,
+          apiUrl,
+          workspaceId
+        });
+      }
+    } else {
+      try {
+        const runUpdate = {
+          name: this.name,
+          run_type: this.run_type,
+          start_time: this._serialized_start_time ?? this.start_time,
+          end_time: this.end_time,
+          error: this.error,
+          outputs: this.outputs,
+          parent_run_id: this.parent_run?.id ?? this.parent_run_id,
+          reference_example_id: this.reference_example_id,
+          extra: this.extra,
+          events: this.events,
+          dotted_order: this.dotted_order,
+          trace_id: this.trace_id,
+          tags: this.tags,
+          attachments: this.attachments,
+          session_name: this.project_name
+        };
+        if (!options?.excludeInputs) {
+          runUpdate.inputs = this.inputs;
+        }
+        await this.client.updateRun(this.id, runUpdate);
+      } catch (error) {
+        console.error(`Error in patchRun for run ${this.id}`, error);
+      }
+    }
+    this.child_runs = [];
   }
-  if (!mutateDocument) document = _deepClone(document);
-  const results = new Array(patch.length);
-  for (let i = 0, length = patch.length; i < length; i++) {
-    results[i] = applyOperation(document, patch[i], validateOperation, true, banPrototypeModifications, i);
-    document = results[i].newDocument;
+  toJSON() {
+    return this._convertToCreate(this, void 0, false);
   }
-  results.newDocument = document;
-  return results;
-}
-function applyReducer(document, operation, index) {
-  const operationResult = applyOperation(document, operation);
-  if (operationResult.test === false) throw new JsonPatchError("Test operation failed", "TEST_OPERATION_FAILED", index, operation, document);
-  return operationResult.newDocument;
-}
-function validator(operation, index, document, existingPathFragment) {
-  if (typeof operation !== "object" || operation === null || Array.isArray(operation)) throw new JsonPatchError("Operation is not an object", "OPERATION_NOT_AN_OBJECT", index, operation, document);
-  else if (!objOps[operation.op]) throw new JsonPatchError("Operation `op` property is not one of operations defined in RFC-6902", "OPERATION_OP_INVALID", index, operation, document);
-  else if (typeof operation.path !== "string") throw new JsonPatchError("Operation `path` property is not a string", "OPERATION_PATH_INVALID", index, operation, document);
-  else if (operation.path.indexOf("/") !== 0 && operation.path.length > 0) throw new JsonPatchError('Operation `path` property must start with "/"', "OPERATION_PATH_INVALID", index, operation, document);
-  else if ((operation.op === "move" || operation.op === "copy") && typeof operation.from !== "string") throw new JsonPatchError("Operation `from` property is not present (applicable in `move` and `copy` operations)", "OPERATION_FROM_REQUIRED", index, operation, document);
-  else if ((operation.op === "add" || operation.op === "replace" || operation.op === "test") && operation.value === void 0) throw new JsonPatchError("Operation `value` property is not present (applicable in `add`, `replace` and `test` operations)", "OPERATION_VALUE_REQUIRED", index, operation, document);
-  else if ((operation.op === "add" || operation.op === "replace" || operation.op === "test") && hasUndefined(operation.value)) throw new JsonPatchError("Operation `value` property is not present (applicable in `add`, `replace` and `test` operations)", "OPERATION_VALUE_CANNOT_CONTAIN_UNDEFINED", index, operation, document);
-  else if (document) {
-    if (operation.op == "add") {
-      var pathLen = operation.path.split("/").length;
-      var existingPathLen = existingPathFragment.split("/").length;
-      if (pathLen !== existingPathLen + 1 && pathLen !== existingPathLen) throw new JsonPatchError("Cannot perform an `add` operation at the desired path", "OPERATION_PATH_CANNOT_ADD", index, operation, document);
-    } else if (operation.op === "replace" || operation.op === "remove" || operation.op === "_get") {
-      if (operation.path !== existingPathFragment) throw new JsonPatchError("Cannot perform the operation at a path that does not exist", "OPERATION_PATH_UNRESOLVABLE", index, operation, document);
-    } else if (operation.op === "move" || operation.op === "copy") {
-      var existingValue = {
-        op: "_get",
-        path: operation.from,
-        value: void 0
-      };
-      var error = validate([existingValue], document);
-      if (error && error.name === "OPERATION_PATH_UNRESOLVABLE") throw new JsonPatchError("Cannot perform the operation from a path that does not exist", "OPERATION_FROM_UNRESOLVABLE", index, operation, document);
+  /**
+   * Add an event to the run tree.
+   * @param event - A single event or string to add
+   */
+  addEvent(event) {
+    if (!this.events) {
+      this.events = [];
+    }
+    if (typeof event === "string") {
+      this.events.push({
+        name: "event",
+        time: (/* @__PURE__ */ new Date()).toISOString(),
+        message: event
+      });
+    } else {
+      this.events.push({
+        ...event,
+        time: event.time ?? (/* @__PURE__ */ new Date()).toISOString()
+      });
     }
   }
+  static fromRunnableConfig(parentConfig, props) {
+    const callbackManager = parentConfig?.callbacks;
+    let parentRun;
+    let projectName;
+    let client;
+    let tracingEnabled = isTracingEnabled();
+    if (callbackManager) {
+      const parentRunId = callbackManager?.getParentRunId?.() ?? "";
+      const langChainTracer = callbackManager?.handlers?.find((handler) => handler?.name == "langchain_tracer");
+      parentRun = langChainTracer?.getRun?.(parentRunId);
+      projectName = langChainTracer?.projectName;
+      client = langChainTracer?.client;
+      tracingEnabled = tracingEnabled || !!langChainTracer;
+    }
+    if (!parentRun) {
+      return new RunTree({
+        ...props,
+        client,
+        tracingEnabled,
+        project_name: projectName
+      });
+    }
+    const parentRunTree = new RunTree({
+      name: parentRun.name,
+      id: parentRun.id,
+      trace_id: parentRun.trace_id,
+      dotted_order: parentRun.dotted_order,
+      client,
+      tracingEnabled,
+      project_name: projectName,
+      tags: [
+        ...new Set((parentRun?.tags ?? []).concat(parentConfig?.tags ?? []))
+      ],
+      extra: {
+        metadata: {
+          ...parentRun?.extra?.metadata,
+          ...parentConfig?.metadata
+        }
+      }
+    });
+    return parentRunTree.createChild(props);
+  }
+  static fromDottedOrder(dottedOrder) {
+    return this.fromHeaders({ "langsmith-trace": dottedOrder });
+  }
+  static fromHeaders(headers, inheritArgs) {
+    const rawHeaders = "get" in headers && typeof headers.get === "function" ? {
+      "langsmith-trace": headers.get("langsmith-trace"),
+      baggage: headers.get("baggage")
+    } : headers;
+    const headerTrace = rawHeaders["langsmith-trace"];
+    if (!headerTrace || typeof headerTrace !== "string")
+      return void 0;
+    const parentDottedOrder = headerTrace.trim();
+    const parsedDottedOrder = parentDottedOrder.split(".").map((part) => {
+      const [strTime, uuid] = part.split("Z");
+      return { strTime, time: Date.parse(strTime + "Z"), uuid };
+    });
+    const traceId = parsedDottedOrder[0].uuid;
+    const config = {
+      ...inheritArgs,
+      name: inheritArgs?.["name"] ?? "parent",
+      run_type: inheritArgs?.["run_type"] ?? "chain",
+      start_time: inheritArgs?.["start_time"] ?? Date.now(),
+      id: parsedDottedOrder.at(-1)?.uuid,
+      trace_id: traceId,
+      dotted_order: parentDottedOrder
+    };
+    if (rawHeaders["baggage"] && typeof rawHeaders["baggage"] === "string") {
+      const baggage = Baggage.fromHeader(rawHeaders["baggage"]);
+      config.metadata = baggage.metadata;
+      config.tags = baggage.tags;
+      config.project_name = baggage.project_name;
+      config.replicas = baggage.replicas;
+    }
+    const runTree = new RunTree(config);
+    runTree.distributedParentId = runTree.id;
+    return runTree;
+  }
+  toHeaders(headers) {
+    const result = {
+      "langsmith-trace": this.dotted_order,
+      baggage: new Baggage(this.extra?.metadata, this.tags, this.project_name, this.replicas).toHeader()
+    };
+    if (headers) {
+      for (const [key, value] of Object.entries(result)) {
+        headers.set(key, value);
+      }
+    }
+    return result;
+  }
+}
+Object.defineProperty(RunTree, "sharedClient", {
+  enumerable: true,
+  configurable: true,
+  writable: true,
+  value: null
+});
+function isRunTree(x) {
+  return x != null && typeof x.createChild === "function" && typeof x.postRun === "function";
+}
+function isLangChainTracerLike(x) {
+  return typeof x === "object" && x != null && typeof x.name === "string" && x.name === "langchain_tracer";
+}
+function containsLangChainTracerLike(x) {
+  return Array.isArray(x) && x.some((callback) => isLangChainTracerLike(callback));
 }
-function validate(sequence, document, externalValidator) {
+function isCallbackManagerLike(x) {
+  return typeof x === "object" && x != null && Array.isArray(x.handlers);
+}
+function isRunnableConfigLike(x) {
+  const callbacks = x?.callbacks;
+  return x != null && typeof callbacks === "object" && // Callback manager with a langchain tracer
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  (containsLangChainTracerLike(callbacks?.handlers) || // Or it's an array with a LangChainTracerLike object within it
+  containsLangChainTracerLike(callbacks));
+}
+function _getWriteReplicasFromEnv() {
+  const envVar = getEnvironmentVariable("LANGSMITH_RUNS_ENDPOINTS");
+  if (!envVar)
+    return [];
   try {
-    if (!Array.isArray(sequence)) throw new JsonPatchError("Patch sequence must be an array", "SEQUENCE_NOT_AN_ARRAY");
-    if (document) applyPatch(_deepClone(document), _deepClone(sequence), externalValidator || true);
-    else {
-      externalValidator = externalValidator || validator;
-      for (var i = 0; i < sequence.length; i++) externalValidator(sequence[i], i, document, void 0);
+    const parsed = JSON.parse(envVar);
+    if (Array.isArray(parsed)) {
+      const replicas = [];
+      for (const item of parsed) {
+        if (typeof item !== "object" || item === null) {
+          console.warn(`Invalid item type in LANGSMITH_RUNS_ENDPOINTS: expected object, got ${typeof item}`);
+          continue;
+        }
+        if (typeof item.api_url !== "string") {
+          console.warn(`Invalid api_url type in LANGSMITH_RUNS_ENDPOINTS: expected string, got ${typeof item.api_url}`);
+          continue;
+        }
+        if (typeof item.api_key !== "string") {
+          console.warn(`Invalid api_key type in LANGSMITH_RUNS_ENDPOINTS: expected string, got ${typeof item.api_key}`);
+          continue;
+        }
+        replicas.push({
+          apiUrl: item.api_url.replace(/\/$/, ""),
+          apiKey: item.api_key
+        });
+      }
+      return replicas;
+    } else if (typeof parsed === "object" && parsed !== null) {
+      _checkEndpointEnvUnset(parsed);
+      const replicas = [];
+      for (const [url, key] of Object.entries(parsed)) {
+        const cleanUrl = url.replace(/\/$/, "");
+        if (typeof key === "string") {
+          replicas.push({
+            apiUrl: cleanUrl,
+            apiKey: key
+          });
+        } else {
+          console.warn(`Invalid value type in LANGSMITH_RUNS_ENDPOINTS for URL ${url}: expected string, got ${typeof key}`);
+          continue;
+        }
+      }
+      return replicas;
+    } else {
+      console.warn(`Invalid LANGSMITH_RUNS_ENDPOINTS – must be valid JSON array of objects with api_url and api_key properties, or object mapping url->apiKey, got ${typeof parsed}`);
+      return [];
     }
   } catch (e) {
-    if (e instanceof JsonPatchError) return e;
-    else throw e;
+    if (isConflictingEndpointsError(e)) {
+      throw e;
+    }
+    console.warn("Invalid LANGSMITH_RUNS_ENDPOINTS – must be valid JSON array of objects with api_url and api_key properties, or object mapping url->apiKey");
+    return [];
+  }
+}
+function _ensureWriteReplicas(replicas) {
+  if (replicas) {
+    return replicas.map((replica) => {
+      if (Array.isArray(replica)) {
+        return {
+          projectName: replica[0],
+          updates: replica[1]
+        };
+      }
+      return replica;
+    });
   }
+  return _getWriteReplicasFromEnv();
 }
-function _areEquals(a, b) {
-  if (a === b) return true;
-  if (a && b && typeof a == "object" && typeof b == "object") {
-    var arrA = Array.isArray(a), arrB = Array.isArray(b), i, length, key;
-    if (arrA && arrB) {
-      length = a.length;
-      if (length != b.length) return false;
-      for (i = length; i-- !== 0; ) if (!_areEquals(a[i], b[i])) return false;
-      return true;
-    }
-    if (arrA != arrB) return false;
-    var keys = Object.keys(a);
-    length = keys.length;
-    if (length !== Object.keys(b).length) return false;
-    for (i = length; i-- !== 0; ) if (!b.hasOwnProperty(keys[i])) return false;
-    for (i = length; i-- !== 0; ) {
-      key = keys[i];
-      if (!_areEquals(a[key], b[key])) return false;
-    }
-    return true;
+function _checkEndpointEnvUnset(parsed) {
+  if (Object.keys(parsed).length > 0 && getLangSmithEnvironmentVariable("ENDPOINT")) {
+    throw new ConflictingEndpointsError();
   }
-  return a !== a && b !== b;
 }
 export {
-  _areEquals,
-  applyOperation,
-  applyPatch,
-  applyReducer,
-  core_exports,
-  getValueByPointer,
-  validate,
-  validator
+  RunTree,
+  convertToDottedOrderFormat,
+  isRunTree,
+  isRunnableConfigLike
 };
 //# sourceMappingURL=index.es121.js.map