@langchain/core 1.2.4 → 1.2.6

package/dist/tracers/run_collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_collector.d.ts","names":[],"sources":["../../src/tracers/run_collector.ts"],"mappings":";;;;;;AAOA;;cAAa,2BAAA,SAAoC,UAAA;EAQnC;EANZ,IAAA;EAsBgC;EAnBhC,SAAA;EAL+C;EAQ/C,UAAA,EAAY,GAAA;EAR6C;;;;EAczD,WAAA,CAAA;IAAc;EAAA;IAAe,SAAA;EAAA;EAAf;;;;EAAA,UAUE,UAAA,CAAW,GAAA,EAAK,OAAA,GAAU,OAAA;AAAA"}
+{"version":3,"file":"run_collector.d.ts","names":[],"sources":["../../src/tracers/run_collector.ts"],"mappings":";;;;;;;cAOa,oCAAoC;;EAE/C;;EAGA;;EAGA,YAAY;;;;;EAMZ,cAAc;IAAe;;;;;;YAUb,WAAW,KAAK,UAAU"}

package/dist/tracers/run_collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"run_collector.js","names":[],"sources":["../../src/tracers/run_collector.ts"],"sourcesContent":["import { BaseRun, Run } from \"langsmith/schemas\";\nimport { BaseTracer } from \"./base.js\";\n\n/**\n * A callback handler that collects traced runs and makes it easy to fetch the traced run object from calls through any langchain object.\n * For instance, it makes it easy to fetch the run ID and then do things with that, such as log feedback.\n */\nexport class RunCollectorCallbackHandler extends BaseTracer {\n  /** The name of the callback handler. */\n  name = \"run_collector\";\n\n  /** The ID of the example. */\n  exampleId?: string;\n\n  /** An array of traced runs. */\n  tracedRuns: Run[];\n\n  /**\n   * Creates a new instance of the RunCollectorCallbackHandler class.\n   * @param exampleId The ID of the example.\n   */\n  constructor({ exampleId }: { exampleId?: string } = {}) {\n    super({ _awaitHandler: true });\n    this.exampleId = exampleId;\n    this.tracedRuns = [];\n  }\n\n  /**\n   * Persists the given run object.\n   * @param run The run object to persist.\n   */\n  protected async persistRun(run: BaseRun): Promise<void> {\n    const run_ = { ...run } as Run;\n    run_.reference_example_id = this.exampleId;\n    this.tracedRuns.push(run_);\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,8BAAb,cAAiD,WAAW;;CAE1D,OAAO;;CAGP;;CAGA;;;;;CAMA,YAAY,EAAE,cAAsC,EAAE,EAAE;AACtD,QAAM,EAAE,eAAe,MAAM,CAAC;AAC9B,OAAK,YAAY;AACjB,OAAK,aAAa,EAAE;;;;;;CAOtB,MAAgB,WAAW,KAA6B;EACtD,MAAM,OAAO,EAAE,GAAG,KAAK;AACvB,OAAK,uBAAuB,KAAK;AACjC,OAAK,WAAW,KAAK,KAAK"}
+{"version":3,"file":"run_collector.js","names":[],"sources":["../../src/tracers/run_collector.ts"],"sourcesContent":["import { BaseRun, Run } from \"langsmith/schemas\";\nimport { BaseTracer } from \"./base.js\";\n\n/**\n * A callback handler that collects traced runs and makes it easy to fetch the traced run object from calls through any langchain object.\n * For instance, it makes it easy to fetch the run ID and then do things with that, such as log feedback.\n */\nexport class RunCollectorCallbackHandler extends BaseTracer {\n  /** The name of the callback handler. */\n  name = \"run_collector\";\n\n  /** The ID of the example. */\n  exampleId?: string;\n\n  /** An array of traced runs. */\n  tracedRuns: Run[];\n\n  /**\n   * Creates a new instance of the RunCollectorCallbackHandler class.\n   * @param exampleId The ID of the example.\n   */\n  constructor({ exampleId }: { exampleId?: string } = {}) {\n    super({ _awaitHandler: true });\n    this.exampleId = exampleId;\n    this.tracedRuns = [];\n  }\n\n  /**\n   * Persists the given run object.\n   * @param run The run object to persist.\n   */\n  protected async persistRun(run: BaseRun): Promise<void> {\n    const run_ = { ...run } as Run;\n    run_.reference_example_id = this.exampleId;\n    this.tracedRuns.push(run_);\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,8BAAb,cAAiD,WAAW;;CAE1D,OAAO;;CAGP;;CAGA;;;;;CAMA,YAAY,EAAE,cAAsC,CAAC,GAAG;EACtD,MAAM,EAAE,eAAe,KAAK,CAAC;EAC7B,KAAK,YAAY;EACjB,KAAK,aAAa,CAAC;CACrB;;;;;CAMA,MAAgB,WAAW,KAA6B;EACtD,MAAM,OAAO,EAAE,GAAG,IAAI;EACtB,KAAK,uBAAuB,KAAK;EACjC,KAAK,WAAW,KAAK,IAAI;CAC3B;AACF"}

package/dist/tracers/tracer_langchain.cjs

@@ -23,7 +23,7 @@ var tracer_langchain_exports = /* @__PURE__ */ require_runtime.__exportAll({
 * enclosing tracer config. Only keys that are strictly for LangSmith
 * tracing bookkeeping should be added.
 */
-const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = new Set(["ls_agent_type"]);
+const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = /* @__PURE__ */ new Set(["ls_agent_type"]);
 /**
 * Extract usage_metadata from chat generations.
 *
@@ -36,6 +36,7 @@ function _getUsageMetadataFromGenerations(generations) {
 	return output;
 }
 var LangChainTracer = class LangChainTracer extends require_tracers_base.BaseTracer {
+	fields;
 	name = "langchain_tracer";
 	projectName;
 	exampleId;
@@ -88,7 +89,7 @@ var LangChainTracer = class LangChainTracer extends require_tracers_base.BaseTra
 			mergedMetadata = { ...this.tracingMetadata };
 			for (const [key, value] of Object.entries(metadata)) if (!Object.prototype.hasOwnProperty.call(mergedMetadata, key) || OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)) mergedMetadata[key] = value;
 		}
-		const mergedTags = tags ? Array.from(new Set([...this.tracingTags, ...tags])) : [...this.tracingTags];
+		const mergedTags = tags ? Array.from(/* @__PURE__ */ new Set([...this.tracingTags, ...tags])) : [...this.tracingTags];
 		const copied = new LangChainTracer({
 			...this.fields,
 			metadata: mergedMetadata,
@@ -174,7 +175,7 @@ function _patchMissingTracingDefaults(tracer, run) {
 		}
 		if (didPatchMetadata) run.extra.metadata = metadata;
 	}
-	if (tracer.tracingTags.length > 0) run.tags = Array.from(new Set([...run.tags ?? [], ...tracer.tracingTags]));
+	if (tracer.tracingTags.length > 0) run.tags = Array.from(/* @__PURE__ */ new Set([...run.tags ?? [], ...tracer.tracingTags]));
 }
 //#endregion
 exports.LangChainTracer = LangChainTracer;

package/dist/tracers/tracer_langchain.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tracer_langchain.cjs","names":["AIMessage","mergeUsageMetadata","BaseTracer","getDefaultLangChainClientSingleton","RunTree"],"sources":["../../src/tracers/tracer_langchain.ts"],"sourcesContent":["import {\n  type Client,\n  type LangSmithTracingClientInterface,\n  getDefaultProjectName,\n} from \"langsmith\";\nimport { RunTree, type RunTreeConfig } from \"langsmith/run_trees\";\nimport { getCurrentRunTree } from \"langsmith/singletons/traceable\";\n\nimport {\n  BaseRun,\n  RunCreate,\n  RunUpdate as BaseRunUpdate,\n  KVMap,\n} from \"langsmith/schemas\";\nimport { BaseTracer, Run as BaseTracerRun } from \"./base.js\";\nimport { BaseCallbackHandlerInput } from \"../callbacks/base.js\";\nimport { getDefaultLangChainClientSingleton } from \"../singletons/tracer.js\";\nimport { ChatGeneration } from \"../outputs.js\";\nimport { AIMessage } from \"../messages/ai.js\";\nimport { mergeUsageMetadata, UsageMetadata } from \"../messages/metadata.js\";\n\nexport interface Run extends BaseRun {\n  id: string;\n  child_runs: this[];\n  child_execution_order: number;\n  dotted_order?: string;\n  trace_id?: string;\n}\n\nexport interface RunCreate2 extends RunCreate {\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface RunUpdate extends BaseRunUpdate {\n  events: BaseRun[\"events\"];\n  inputs: KVMap;\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface LangChainTracerFields extends BaseCallbackHandlerInput {\n  exampleId?: string;\n  projectName?: string;\n  client?: LangSmithTracingClientInterface;\n  replicas?: RunTreeConfig[\"replicas\"];\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n}\n\n/**\n * Keys that should be inherited from `tracerInheritableMetadata` even when\n * the run already has a value for them. This lets nested contexts\n * (e.g. a subagent invoked from inside a parent agent) override a\n * LangSmith-only tracing metadata value that was set by an ancestor.\n *\n * Keep this list very small: every key here loses the default\n * \"first wins\" protection and is always clobbered by the nearest\n * enclosing tracer config. Only keys that are strictly for LangSmith\n * tracing bookkeeping should be added.\n */\nexport const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = new Set<string>([\n  \"ls_agent_type\",\n]);\n\n/**\n * Extract usage_metadata from chat generations.\n *\n * Iterates through generations to find and aggregates all usage_metadata\n * found in chat messages. This is typically present in chat model outputs.\n */\nfunction _getUsageMetadataFromGenerations(\n  generations: ChatGeneration[][]\n): UsageMetadata | undefined {\n  let output: UsageMetadata | undefined = undefined;\n  for (const generationBatch of generations) {\n    for (const generation of generationBatch) {\n      if (\n        AIMessage.isInstance(generation.message) &&\n        generation.message.usage_metadata !== undefined\n      ) {\n        output = mergeUsageMetadata(output, generation.message.usage_metadata);\n      }\n    }\n  }\n  return output;\n}\n\nexport class LangChainTracer\n  extends BaseTracer\n  implements LangChainTracerFields\n{\n  name = \"langchain_tracer\";\n\n  projectName?: string;\n\n  exampleId?: string;\n\n  client: LangSmithTracingClientInterface;\n\n  replicas?: RunTreeConfig[\"replicas\"];\n\n  usesRunTreeMap = true;\n\n  tracingMetadata?: Record<string, unknown>;\n\n  tracingTags: string[] = [];\n\n  constructor(protected fields: LangChainTracerFields = {}) {\n    super(fields);\n    const { exampleId, projectName, client, replicas, metadata, tags } = fields;\n\n    this.projectName = projectName ?? getDefaultProjectName();\n    this.replicas = replicas;\n    this.exampleId = exampleId;\n    this.client = client ?? getDefaultLangChainClientSingleton();\n    this.tracingMetadata = metadata ? { ...metadata } : undefined;\n    this.tracingTags = tags ?? [];\n\n    const traceableTree = LangChainTracer.getTraceableRunTree();\n    if (traceableTree) {\n      this.updateFromRunTree(traceableTree);\n    }\n  }\n\n  protected async persistRun(_run: Run): Promise<void> {\n    // empty\n  }\n\n  async onRunCreate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    if (!run.extra?.lc_defers_inputs) {\n      const runTree = this.getRunTreeWithTracingConfig(run.id);\n      await runTree?.postRun();\n    }\n  }\n\n  async onRunUpdate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    const runTree = this.getRunTreeWithTracingConfig(run.id);\n    if (run.extra?.lc_defers_inputs) {\n      await runTree?.postRun();\n    } else {\n      await runTree?.patchRun();\n    }\n  }\n\n  onLLMEnd(run: BaseTracerRun): void {\n    // Extract usage_metadata from outputs and store in extra.metadata\n    const outputs = run.outputs as\n      | { generations?: ChatGeneration[][] }\n      | undefined;\n    if (outputs?.generations) {\n      const usageMetadata = _getUsageMetadataFromGenerations(\n        outputs.generations\n      );\n      if (usageMetadata !== undefined) {\n        run.extra = run.extra ?? {};\n        const metadata =\n          (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n        metadata.usage_metadata = usageMetadata;\n        run.extra.metadata = metadata;\n      }\n    }\n  }\n\n  copyWithTracingConfig({\n    metadata,\n    tags,\n  }: {\n    metadata?: Record<string, unknown>;\n    tags?: string[];\n  }): LangChainTracer {\n    let mergedMetadata: Record<string, unknown> | undefined;\n    if (metadata === undefined) {\n      mergedMetadata = this.tracingMetadata\n        ? { ...this.tracingMetadata }\n        : undefined;\n    } else if (this.tracingMetadata === undefined) {\n      mergedMetadata = { ...metadata };\n    } else {\n      mergedMetadata = { ...this.tracingMetadata };\n      for (const [key, value] of Object.entries(metadata)) {\n        // For allowlisted LangSmith-only inheritable metadata keys (e.g.\n        // `ls_agent_type`), nested callers are allowed to OVERRIDE the\n        // value inherited from an ancestor. For all other keys we keep\n        // the existing \"first wins\" behavior so that ancestor-provided\n        // tracing metadata is not accidentally clobbered by child runs.\n        if (\n          !Object.prototype.hasOwnProperty.call(mergedMetadata, key) ||\n          OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n        ) {\n          mergedMetadata[key] = value;\n        }\n      }\n    }\n\n    const mergedTags = tags\n      ? Array.from(new Set([...this.tracingTags, ...tags]))\n      : [...this.tracingTags];\n\n    const copied = new LangChainTracer({\n      ...this.fields,\n      metadata: mergedMetadata,\n      tags: mergedTags,\n    });\n    copied.runMap = this.runMap;\n    copied.runTreeMap = this.runTreeMap;\n    return copied;\n  }\n\n  /** @internal */\n  _getRunStoreKey(): object {\n    return this.runTreeMap;\n  }\n\n  getRun(id: string): Run | undefined {\n    return this.runTreeMap.get(id);\n  }\n\n  updateFromRunTree(runTree: RunTree) {\n    this.runTreeMap.set(runTree.id, runTree);\n    let rootRun: RunTree = runTree;\n    const visited = new Set<string>();\n    while (rootRun.parent_run) {\n      if (visited.has(rootRun.id)) break;\n      visited.add(rootRun.id);\n\n      if (!rootRun.parent_run) break;\n      rootRun = rootRun.parent_run as RunTree;\n    }\n    visited.clear();\n\n    const queue = [rootRun];\n    while (queue.length > 0) {\n      const current = queue.shift();\n      if (!current || visited.has(current.id)) continue;\n      visited.add(current.id);\n\n      this.runTreeMap.set(current.id, current);\n      if (current.child_runs) {\n        queue.push(...current.child_runs);\n      }\n    }\n\n    this.client = runTree.client ?? this.client;\n    this.replicas = runTree.replicas ?? this.replicas;\n    this.projectName = runTree.project_name ?? this.projectName;\n    this.exampleId = runTree.reference_example_id ?? this.exampleId;\n    this.fields = {\n      ...this.fields,\n      client: this.client,\n      replicas: this.replicas,\n      projectName: this.projectName,\n      exampleId: this.exampleId,\n    };\n  }\n\n  getRunTreeWithTracingConfig(id: string): RunTree | undefined {\n    const runTree = this.runTreeMap.get(id);\n    if (!runTree) return undefined;\n\n    return new RunTree({\n      ...runTree,\n      client: this.client as Client,\n      project_name: this.projectName,\n      replicas: this.replicas,\n      reference_example_id: this.exampleId,\n      tracingEnabled: true,\n    });\n  }\n\n  static getTraceableRunTree(): RunTree | undefined {\n    try {\n      return (\n        // The type cast here provides forward compatibility. Old versions of LangSmith will just\n        // ignore the permitAbsentRunTree arg.\n        (\n          getCurrentRunTree as (\n            permitAbsentRunTree: boolean\n          ) => ReturnType<typeof getCurrentRunTree> | undefined\n        )(true)\n      );\n    } catch {\n      return undefined;\n    }\n  }\n\n  static [Symbol.hasInstance](instance: unknown): boolean {\n    if (typeof instance !== \"object\" || instance === null) {\n      return false;\n    }\n    const candidate = instance as Record<string, unknown>;\n    return (\n      \"name\" in candidate &&\n      candidate.name === \"langchain_tracer\" &&\n      \"copyWithTracingConfig\" in candidate &&\n      typeof candidate.copyWithTracingConfig === \"function\" &&\n      \"getRunTreeWithTracingConfig\" in candidate &&\n      typeof candidate.getRunTreeWithTracingConfig === \"function\"\n    );\n  }\n}\n\nfunction _patchMissingTracingDefaults(tracer: LangChainTracer, run: Run): void {\n  if (tracer.tracingMetadata) {\n    run.extra ??= {};\n    const metadata: Record<string, unknown> =\n      (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n    let didPatchMetadata = false;\n    for (const [key, value] of Object.entries(tracer.tracingMetadata)) {\n      // `OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS` are a small, LangSmith-only\n      // allowlist that bypasses the \"first wins\" merge so a nested caller\n      // (e.g. a subagent) can override a parent-set value.\n      if (\n        !Object.prototype.hasOwnProperty.call(metadata, key) ||\n        OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n      ) {\n        if (metadata[key] !== value) {\n          metadata[key] = value;\n          didPatchMetadata = true;\n        }\n      }\n    }\n    if (didPatchMetadata) {\n      run.extra.metadata = metadata;\n    }\n  }\n\n  if (tracer.tracingTags.length > 0) {\n    run.tags = Array.from(\n      new Set([...(run.tags ?? []), ...tracer.tracingTags])\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"tracer_langchain.cjs","names":["AIMessage","mergeUsageMetadata","BaseTracer","getDefaultLangChainClientSingleton","RunTree"],"sources":["../../src/tracers/tracer_langchain.ts"],"sourcesContent":["import {\n  type Client,\n  type LangSmithTracingClientInterface,\n  getDefaultProjectName,\n} from \"langsmith\";\nimport { RunTree, type RunTreeConfig } from \"langsmith/run_trees\";\nimport { getCurrentRunTree } from \"langsmith/singletons/traceable\";\n\nimport {\n  BaseRun,\n  RunCreate,\n  RunUpdate as BaseRunUpdate,\n  KVMap,\n} from \"langsmith/schemas\";\nimport { BaseTracer, Run as BaseTracerRun } from \"./base.js\";\nimport { BaseCallbackHandlerInput } from \"../callbacks/base.js\";\nimport { getDefaultLangChainClientSingleton } from \"../singletons/tracer.js\";\nimport { ChatGeneration } from \"../outputs.js\";\nimport { AIMessage } from \"../messages/ai.js\";\nimport { mergeUsageMetadata, UsageMetadata } from \"../messages/metadata.js\";\n\nexport interface Run extends BaseRun {\n  id: string;\n  child_runs: this[];\n  child_execution_order: number;\n  dotted_order?: string;\n  trace_id?: string;\n}\n\nexport interface RunCreate2 extends RunCreate {\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface RunUpdate extends BaseRunUpdate {\n  events: BaseRun[\"events\"];\n  inputs: KVMap;\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface LangChainTracerFields extends BaseCallbackHandlerInput {\n  exampleId?: string;\n  projectName?: string;\n  client?: LangSmithTracingClientInterface;\n  replicas?: RunTreeConfig[\"replicas\"];\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n}\n\n/**\n * Keys that should be inherited from `tracerInheritableMetadata` even when\n * the run already has a value for them. This lets nested contexts\n * (e.g. a subagent invoked from inside a parent agent) override a\n * LangSmith-only tracing metadata value that was set by an ancestor.\n *\n * Keep this list very small: every key here loses the default\n * \"first wins\" protection and is always clobbered by the nearest\n * enclosing tracer config. Only keys that are strictly for LangSmith\n * tracing bookkeeping should be added.\n */\nexport const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = new Set<string>([\n  \"ls_agent_type\",\n]);\n\n/**\n * Extract usage_metadata from chat generations.\n *\n * Iterates through generations to find and aggregates all usage_metadata\n * found in chat messages. This is typically present in chat model outputs.\n */\nfunction _getUsageMetadataFromGenerations(\n  generations: ChatGeneration[][]\n): UsageMetadata | undefined {\n  let output: UsageMetadata | undefined = undefined;\n  for (const generationBatch of generations) {\n    for (const generation of generationBatch) {\n      if (\n        AIMessage.isInstance(generation.message) &&\n        generation.message.usage_metadata !== undefined\n      ) {\n        output = mergeUsageMetadata(output, generation.message.usage_metadata);\n      }\n    }\n  }\n  return output;\n}\n\nexport class LangChainTracer\n  extends BaseTracer\n  implements LangChainTracerFields\n{\n  name = \"langchain_tracer\";\n\n  projectName?: string;\n\n  exampleId?: string;\n\n  client: LangSmithTracingClientInterface;\n\n  replicas?: RunTreeConfig[\"replicas\"];\n\n  usesRunTreeMap = true;\n\n  tracingMetadata?: Record<string, unknown>;\n\n  tracingTags: string[] = [];\n\n  constructor(protected fields: LangChainTracerFields = {}) {\n    super(fields);\n    const { exampleId, projectName, client, replicas, metadata, tags } = fields;\n\n    this.projectName = projectName ?? getDefaultProjectName();\n    this.replicas = replicas;\n    this.exampleId = exampleId;\n    this.client = client ?? getDefaultLangChainClientSingleton();\n    this.tracingMetadata = metadata ? { ...metadata } : undefined;\n    this.tracingTags = tags ?? [];\n\n    const traceableTree = LangChainTracer.getTraceableRunTree();\n    if (traceableTree) {\n      this.updateFromRunTree(traceableTree);\n    }\n  }\n\n  protected async persistRun(_run: Run): Promise<void> {\n    // empty\n  }\n\n  async onRunCreate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    if (!run.extra?.lc_defers_inputs) {\n      const runTree = this.getRunTreeWithTracingConfig(run.id);\n      await runTree?.postRun();\n    }\n  }\n\n  async onRunUpdate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    const runTree = this.getRunTreeWithTracingConfig(run.id);\n    if (run.extra?.lc_defers_inputs) {\n      await runTree?.postRun();\n    } else {\n      await runTree?.patchRun();\n    }\n  }\n\n  onLLMEnd(run: BaseTracerRun): void {\n    // Extract usage_metadata from outputs and store in extra.metadata\n    const outputs = run.outputs as\n      | { generations?: ChatGeneration[][] }\n      | undefined;\n    if (outputs?.generations) {\n      const usageMetadata = _getUsageMetadataFromGenerations(\n        outputs.generations\n      );\n      if (usageMetadata !== undefined) {\n        run.extra = run.extra ?? {};\n        const metadata =\n          (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n        metadata.usage_metadata = usageMetadata;\n        run.extra.metadata = metadata;\n      }\n    }\n  }\n\n  copyWithTracingConfig({\n    metadata,\n    tags,\n  }: {\n    metadata?: Record<string, unknown>;\n    tags?: string[];\n  }): LangChainTracer {\n    let mergedMetadata: Record<string, unknown> | undefined;\n    if (metadata === undefined) {\n      mergedMetadata = this.tracingMetadata\n        ? { ...this.tracingMetadata }\n        : undefined;\n    } else if (this.tracingMetadata === undefined) {\n      mergedMetadata = { ...metadata };\n    } else {\n      mergedMetadata = { ...this.tracingMetadata };\n      for (const [key, value] of Object.entries(metadata)) {\n        // For allowlisted LangSmith-only inheritable metadata keys (e.g.\n        // `ls_agent_type`), nested callers are allowed to OVERRIDE the\n        // value inherited from an ancestor. For all other keys we keep\n        // the existing \"first wins\" behavior so that ancestor-provided\n        // tracing metadata is not accidentally clobbered by child runs.\n        if (\n          !Object.prototype.hasOwnProperty.call(mergedMetadata, key) ||\n          OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n        ) {\n          mergedMetadata[key] = value;\n        }\n      }\n    }\n\n    const mergedTags = tags\n      ? Array.from(new Set([...this.tracingTags, ...tags]))\n      : [...this.tracingTags];\n\n    const copied = new LangChainTracer({\n      ...this.fields,\n      metadata: mergedMetadata,\n      tags: mergedTags,\n    });\n    copied.runMap = this.runMap;\n    copied.runTreeMap = this.runTreeMap;\n    return copied;\n  }\n\n  /** @internal */\n  _getRunStoreKey(): object {\n    return this.runTreeMap;\n  }\n\n  getRun(id: string): Run | undefined {\n    return this.runTreeMap.get(id);\n  }\n\n  updateFromRunTree(runTree: RunTree) {\n    this.runTreeMap.set(runTree.id, runTree);\n    let rootRun: RunTree = runTree;\n    const visited = new Set<string>();\n    while (rootRun.parent_run) {\n      if (visited.has(rootRun.id)) break;\n      visited.add(rootRun.id);\n\n      if (!rootRun.parent_run) break;\n      rootRun = rootRun.parent_run as RunTree;\n    }\n    visited.clear();\n\n    const queue = [rootRun];\n    while (queue.length > 0) {\n      const current = queue.shift();\n      if (!current || visited.has(current.id)) continue;\n      visited.add(current.id);\n\n      this.runTreeMap.set(current.id, current);\n      if (current.child_runs) {\n        queue.push(...current.child_runs);\n      }\n    }\n\n    this.client = runTree.client ?? this.client;\n    this.replicas = runTree.replicas ?? this.replicas;\n    this.projectName = runTree.project_name ?? this.projectName;\n    this.exampleId = runTree.reference_example_id ?? this.exampleId;\n    this.fields = {\n      ...this.fields,\n      client: this.client,\n      replicas: this.replicas,\n      projectName: this.projectName,\n      exampleId: this.exampleId,\n    };\n  }\n\n  getRunTreeWithTracingConfig(id: string): RunTree | undefined {\n    const runTree = this.runTreeMap.get(id);\n    if (!runTree) return undefined;\n\n    return new RunTree({\n      ...runTree,\n      client: this.client as Client,\n      project_name: this.projectName,\n      replicas: this.replicas,\n      reference_example_id: this.exampleId,\n      tracingEnabled: true,\n    });\n  }\n\n  static getTraceableRunTree(): RunTree | undefined {\n    try {\n      return (\n        // The type cast here provides forward compatibility. Old versions of LangSmith will just\n        // ignore the permitAbsentRunTree arg.\n        (\n          getCurrentRunTree as (\n            permitAbsentRunTree: boolean\n          ) => ReturnType<typeof getCurrentRunTree> | undefined\n        )(true)\n      );\n    } catch {\n      return undefined;\n    }\n  }\n\n  static [Symbol.hasInstance](instance: unknown): boolean {\n    if (typeof instance !== \"object\" || instance === null) {\n      return false;\n    }\n    const candidate = instance as Record<string, unknown>;\n    return (\n      \"name\" in candidate &&\n      candidate.name === \"langchain_tracer\" &&\n      \"copyWithTracingConfig\" in candidate &&\n      typeof candidate.copyWithTracingConfig === \"function\" &&\n      \"getRunTreeWithTracingConfig\" in candidate &&\n      typeof candidate.getRunTreeWithTracingConfig === \"function\"\n    );\n  }\n}\n\nfunction _patchMissingTracingDefaults(tracer: LangChainTracer, run: Run): void {\n  if (tracer.tracingMetadata) {\n    run.extra ??= {};\n    const metadata: Record<string, unknown> =\n      (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n    let didPatchMetadata = false;\n    for (const [key, value] of Object.entries(tracer.tracingMetadata)) {\n      // `OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS` are a small, LangSmith-only\n      // allowlist that bypasses the \"first wins\" merge so a nested caller\n      // (e.g. a subagent) can override a parent-set value.\n      if (\n        !Object.prototype.hasOwnProperty.call(metadata, key) ||\n        OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n      ) {\n        if (metadata[key] !== value) {\n          metadata[key] = value;\n          didPatchMetadata = true;\n        }\n      }\n    }\n    if (didPatchMetadata) {\n      run.extra.metadata = metadata;\n    }\n  }\n\n  if (tracer.tracingTags.length > 0) {\n    run.tags = Array.from(\n      new Set([...(run.tags ?? []), ...tracer.tracingTags])\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/tracers/tracer_langchain.d.cts

@@ -3,7 +3,6 @@ import { BaseTracer, Run as Run$2 } from "./base.cjs";
 import { BaseRun, KVMap, RunCreate, RunUpdate as RunUpdate$1 } from "langsmith/schemas";
 import { RunTree, RunTreeConfig } from "langsmith/run_trees";
 import { LangSmithTracingClientInterface } from "langsmith";
-
 //#region src/tracers/tracer_langchain.d.ts
 interface Run extends BaseRun {
   id: string;
@@ -57,10 +56,7 @@ declare class LangChainTracer extends BaseTracer implements LangChainTracerField
   onRunCreate(run: Run): Promise<void>;
   onRunUpdate(run: Run): Promise<void>;
   onLLMEnd(run: Run$2): void;
-  copyWithTracingConfig({
-    metadata,
-    tags
-  }: {
+  copyWithTracingConfig({ metadata, tags }: {
     metadata?: Record<string, unknown>;
     tags?: string[];
   }): LangChainTracer;

package/dist/tracers/tracer_langchain.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"tracer_langchain.d.cts","names":[],"sources":["../../src/tracers/tracer_langchain.ts"],"mappings":";;;;;;;UAqBiB,GAAA,SAAY,OAAA;EAC3B,EAAA;EACA,UAAA;EACA,qBAAA;EACA,YAAA;EACA,QAAA;AAAA;AAAA,UAGe,UAAA,SAAmB,SAAA;EAClC,QAAA;EACA,YAAA;AAAA;AAAA,UAGe,SAAA,SAAkB,WAAA;EACjC,MAAA,EAAQ,OAAA;EACR,MAAA,EAAQ,KAAA;EACR,QAAA;EACA,YAAA;AAAA;AAAA,UAGe,qBAAA,SAA8B,wBAAA;EAC7C,SAAA;EACA,WAAA;EACA,MAAA,GAAS,+BAAA;EACT,QAAA,GAAW,aAAA;EACX,QAAA,GAAW,MAAA;EACX,IAAA;AAAA;;;;;;;;;;;;cAcW,+CAAA,EAA+C,GAAA;AAAA,cA2B/C,eAAA,SACH,UAAA,YACG,qBAAA;EAAA,UAkBW,MAAA,EAAQ,qBAAA;EAhB9B,IAAA;EAEA,WAAA;EAEA,SAAA;EAEA,MAAA,EAAQ,+BAAA;EAER,QAAA,GAAW,aAAA;EAEX,cAAA;EAEA,eAAA,GAAkB,MAAA;EAElB,WAAA;EAEA,WAAA,CAAsB,MAAA,GAAQ,qBAAA;EAAA,UAiBd,UAAA,CAAW,IAAA,EAAM,GAAA,GAAM,OAAA;EAIjC,WAAA,CAAY,GAAA,EAAK,GAAA,GAAM,OAAA;EAQvB,WAAA,CAAY,GAAA,EAAK,GAAA,GAAM,OAAA;EAU7B,QAAA,CAAS,GAAA,EAAK,KAAA;EAmBd,qBAAA,CAAA;IACE,QAAA;IACA;EAAA;IAEA,QAAA,GAAW,MAAA;IACX,IAAA;EAAA,IACE,eAAA;EA9HJ;EAsKA,eAAA,CAAA;EAIA,MAAA,CAAO,EAAA,WAAa,GAAA;EAIpB,iBAAA,CAAkB,OAAA,EAAS,OAAA;EAsC3B,2BAAA,CAA4B,EAAA,WAAa,OAAA;EAAA,OAclC,mBAAA,CAAA,GAAuB,OAAA;EAAA,QAgBtB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}
+{"version":3,"file":"tracer_langchain.d.cts","names":[],"sources":["../../src/tracers/tracer_langchain.ts"],"mappings":";;;;;;UAqBiB,YAAY;EAC3B;EACA;EACA;EACA;EACA;;UAGe,mBAAmB;EAClC;EACA;;UAGe,kBAAkB;EACjC,QAAQ;EACR,QAAQ;EACR;EACA;;UAGe,8BAA8B;EAC7C;EACA;EACA,SAAS;EACT,WAAW;EACX,WAAW;EACX;;;;;;;;;;;;;cAcW,iDAA+C;cA2B/C,wBACH,sBACG;YAkBW,QAAQ;EAhB9B;EAEA;EAEA;EAEA,QAAQ;EAER,WAAW;EAEX;EAEA,kBAAkB;EAElB;EAEA,YAAsB,SAAQ;YAiBd,WAAW,MAAM,MAAM;EAIjC,YAAY,KAAK,MAAM;EAQvB,YAAY,KAAK,MAAM;EAU7B,SAAS,KAAK;EAmBd,wBACE,UACA;IAEA,WAAW;IACX;MACE;;EAwCJ;EAIA,OAAO,aAAa;EAIpB,kBAAkB,SAAS;EAsC3B,4BAA4B,aAAa;SAclC,uBAAuB;UAgBtB,OAAO,aAAa"}

package/dist/tracers/tracer_langchain.d.ts

@@ -3,7 +3,6 @@ import { BaseTracer, Run as Run$2 } from "./base.js";
 import { RunTree, RunTreeConfig } from "langsmith/run_trees";
 import { LangSmithTracingClientInterface } from "langsmith";
 import { BaseRun, KVMap, RunCreate, RunUpdate as RunUpdate$1 } from "langsmith/schemas";
-
 //#region src/tracers/tracer_langchain.d.ts
 interface Run extends BaseRun {
   id: string;
@@ -57,10 +56,7 @@ declare class LangChainTracer extends BaseTracer implements LangChainTracerField
   onRunCreate(run: Run): Promise<void>;
   onRunUpdate(run: Run): Promise<void>;
   onLLMEnd(run: Run$2): void;
-  copyWithTracingConfig({
-    metadata,
-    tags
-  }: {
+  copyWithTracingConfig({ metadata, tags }: {
     metadata?: Record<string, unknown>;
     tags?: string[];
   }): LangChainTracer;

package/dist/tracers/tracer_langchain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracer_langchain.d.ts","names":[],"sources":["../../src/tracers/tracer_langchain.ts"],"mappings":";;;;;;;UAqBiB,GAAA,SAAY,OAAA;EAC3B,EAAA;EACA,UAAA;EACA,qBAAA;EACA,YAAA;EACA,QAAA;AAAA;AAAA,UAGe,UAAA,SAAmB,SAAA;EAClC,QAAA;EACA,YAAA;AAAA;AAAA,UAGe,SAAA,SAAkB,WAAA;EACjC,MAAA,EAAQ,OAAA;EACR,MAAA,EAAQ,KAAA;EACR,QAAA;EACA,YAAA;AAAA;AAAA,UAGe,qBAAA,SAA8B,wBAAA;EAC7C,SAAA;EACA,WAAA;EACA,MAAA,GAAS,+BAAA;EACT,QAAA,GAAW,aAAA;EACX,QAAA,GAAW,MAAA;EACX,IAAA;AAAA;;;;;;;;;;;;cAcW,+CAAA,EAA+C,GAAA;AAAA,cA2B/C,eAAA,SACH,UAAA,YACG,qBAAA;EAAA,UAkBW,MAAA,EAAQ,qBAAA;EAhB9B,IAAA;EAEA,WAAA;EAEA,SAAA;EAEA,MAAA,EAAQ,+BAAA;EAER,QAAA,GAAW,aAAA;EAEX,cAAA;EAEA,eAAA,GAAkB,MAAA;EAElB,WAAA;EAEA,WAAA,CAAsB,MAAA,GAAQ,qBAAA;EAAA,UAiBd,UAAA,CAAW,IAAA,EAAM,GAAA,GAAM,OAAA;EAIjC,WAAA,CAAY,GAAA,EAAK,GAAA,GAAM,OAAA;EAQvB,WAAA,CAAY,GAAA,EAAK,GAAA,GAAM,OAAA;EAU7B,QAAA,CAAS,GAAA,EAAK,KAAA;EAmBd,qBAAA,CAAA;IACE,QAAA;IACA;EAAA;IAEA,QAAA,GAAW,MAAA;IACX,IAAA;EAAA,IACE,eAAA;EA9HJ;EAsKA,eAAA,CAAA;EAIA,MAAA,CAAO,EAAA,WAAa,GAAA;EAIpB,iBAAA,CAAkB,OAAA,EAAS,OAAA;EAsC3B,2BAAA,CAA4B,EAAA,WAAa,OAAA;EAAA,OAclC,mBAAA,CAAA,GAAuB,OAAA;EAAA,QAgBtB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}
+{"version":3,"file":"tracer_langchain.d.ts","names":[],"sources":["../../src/tracers/tracer_langchain.ts"],"mappings":";;;;;;UAqBiB,YAAY;EAC3B;EACA;EACA;EACA;EACA;;UAGe,mBAAmB;EAClC;EACA;;UAGe,kBAAkB;EACjC,QAAQ;EACR,QAAQ;EACR;EACA;;UAGe,8BAA8B;EAC7C;EACA;EACA,SAAS;EACT,WAAW;EACX,WAAW;EACX;;;;;;;;;;;;;cAcW,iDAA+C;cA2B/C,wBACH,sBACG;YAkBW,QAAQ;EAhB9B;EAEA;EAEA;EAEA,QAAQ;EAER,WAAW;EAEX;EAEA,kBAAkB;EAElB;EAEA,YAAsB,SAAQ;YAiBd,WAAW,MAAM,MAAM;EAIjC,YAAY,KAAK,MAAM;EAQvB,YAAY,KAAK,MAAM;EAU7B,SAAS,KAAK;EAmBd,wBACE,UACA;IAEA,WAAW;IACX;MACE;;EAwCJ;EAIA,OAAO,aAAa;EAIpB,kBAAkB,SAAS;EAsC3B,4BAA4B,aAAa;SAclC,uBAAuB;UAgBtB,OAAO,aAAa"}

package/dist/tracers/tracer_langchain.js

@@ -22,7 +22,7 @@ var tracer_langchain_exports = /* @__PURE__ */ __exportAll({
 * enclosing tracer config. Only keys that are strictly for LangSmith
 * tracing bookkeeping should be added.
 */
-const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = new Set(["ls_agent_type"]);
+const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = /* @__PURE__ */ new Set(["ls_agent_type"]);
 /**
 * Extract usage_metadata from chat generations.
 *
@@ -35,6 +35,7 @@ function _getUsageMetadataFromGenerations(generations) {
 	return output;
 }
 var LangChainTracer = class LangChainTracer extends BaseTracer {
+	fields;
 	name = "langchain_tracer";
 	projectName;
 	exampleId;
@@ -87,7 +88,7 @@ var LangChainTracer = class LangChainTracer extends BaseTracer {
 			mergedMetadata = { ...this.tracingMetadata };
 			for (const [key, value] of Object.entries(metadata)) if (!Object.prototype.hasOwnProperty.call(mergedMetadata, key) || OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)) mergedMetadata[key] = value;
 		}
-		const mergedTags = tags ? Array.from(new Set([...this.tracingTags, ...tags])) : [...this.tracingTags];
+		const mergedTags = tags ? Array.from(/* @__PURE__ */ new Set([...this.tracingTags, ...tags])) : [...this.tracingTags];
 		const copied = new LangChainTracer({
 			...this.fields,
 			metadata: mergedMetadata,
@@ -173,7 +174,7 @@ function _patchMissingTracingDefaults(tracer, run) {
 		}
 		if (didPatchMetadata) run.extra.metadata = metadata;
 	}
-	if (tracer.tracingTags.length > 0) run.tags = Array.from(new Set([...run.tags ?? [], ...tracer.tracingTags]));
+	if (tracer.tracingTags.length > 0) run.tags = Array.from(/* @__PURE__ */ new Set([...run.tags ?? [], ...tracer.tracingTags]));
 }
 //#endregion
 export { LangChainTracer, OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS, tracer_langchain_exports };

package/dist/tracers/tracer_langchain.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracer_langchain.js","names":[],"sources":["../../src/tracers/tracer_langchain.ts"],"sourcesContent":["import {\n  type Client,\n  type LangSmithTracingClientInterface,\n  getDefaultProjectName,\n} from \"langsmith\";\nimport { RunTree, type RunTreeConfig } from \"langsmith/run_trees\";\nimport { getCurrentRunTree } from \"langsmith/singletons/traceable\";\n\nimport {\n  BaseRun,\n  RunCreate,\n  RunUpdate as BaseRunUpdate,\n  KVMap,\n} from \"langsmith/schemas\";\nimport { BaseTracer, Run as BaseTracerRun } from \"./base.js\";\nimport { BaseCallbackHandlerInput } from \"../callbacks/base.js\";\nimport { getDefaultLangChainClientSingleton } from \"../singletons/tracer.js\";\nimport { ChatGeneration } from \"../outputs.js\";\nimport { AIMessage } from \"../messages/ai.js\";\nimport { mergeUsageMetadata, UsageMetadata } from \"../messages/metadata.js\";\n\nexport interface Run extends BaseRun {\n  id: string;\n  child_runs: this[];\n  child_execution_order: number;\n  dotted_order?: string;\n  trace_id?: string;\n}\n\nexport interface RunCreate2 extends RunCreate {\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface RunUpdate extends BaseRunUpdate {\n  events: BaseRun[\"events\"];\n  inputs: KVMap;\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface LangChainTracerFields extends BaseCallbackHandlerInput {\n  exampleId?: string;\n  projectName?: string;\n  client?: LangSmithTracingClientInterface;\n  replicas?: RunTreeConfig[\"replicas\"];\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n}\n\n/**\n * Keys that should be inherited from `tracerInheritableMetadata` even when\n * the run already has a value for them. This lets nested contexts\n * (e.g. a subagent invoked from inside a parent agent) override a\n * LangSmith-only tracing metadata value that was set by an ancestor.\n *\n * Keep this list very small: every key here loses the default\n * \"first wins\" protection and is always clobbered by the nearest\n * enclosing tracer config. Only keys that are strictly for LangSmith\n * tracing bookkeeping should be added.\n */\nexport const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = new Set<string>([\n  \"ls_agent_type\",\n]);\n\n/**\n * Extract usage_metadata from chat generations.\n *\n * Iterates through generations to find and aggregates all usage_metadata\n * found in chat messages. This is typically present in chat model outputs.\n */\nfunction _getUsageMetadataFromGenerations(\n  generations: ChatGeneration[][]\n): UsageMetadata | undefined {\n  let output: UsageMetadata | undefined = undefined;\n  for (const generationBatch of generations) {\n    for (const generation of generationBatch) {\n      if (\n        AIMessage.isInstance(generation.message) &&\n        generation.message.usage_metadata !== undefined\n      ) {\n        output = mergeUsageMetadata(output, generation.message.usage_metadata);\n      }\n    }\n  }\n  return output;\n}\n\nexport class LangChainTracer\n  extends BaseTracer\n  implements LangChainTracerFields\n{\n  name = \"langchain_tracer\";\n\n  projectName?: string;\n\n  exampleId?: string;\n\n  client: LangSmithTracingClientInterface;\n\n  replicas?: RunTreeConfig[\"replicas\"];\n\n  usesRunTreeMap = true;\n\n  tracingMetadata?: Record<string, unknown>;\n\n  tracingTags: string[] = [];\n\n  constructor(protected fields: LangChainTracerFields = {}) {\n    super(fields);\n    const { exampleId, projectName, client, replicas, metadata, tags } = fields;\n\n    this.projectName = projectName ?? getDefaultProjectName();\n    this.replicas = replicas;\n    this.exampleId = exampleId;\n    this.client = client ?? getDefaultLangChainClientSingleton();\n    this.tracingMetadata = metadata ? { ...metadata } : undefined;\n    this.tracingTags = tags ?? [];\n\n    const traceableTree = LangChainTracer.getTraceableRunTree();\n    if (traceableTree) {\n      this.updateFromRunTree(traceableTree);\n    }\n  }\n\n  protected async persistRun(_run: Run): Promise<void> {\n    // empty\n  }\n\n  async onRunCreate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    if (!run.extra?.lc_defers_inputs) {\n      const runTree = this.getRunTreeWithTracingConfig(run.id);\n      await runTree?.postRun();\n    }\n  }\n\n  async onRunUpdate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    const runTree = this.getRunTreeWithTracingConfig(run.id);\n    if (run.extra?.lc_defers_inputs) {\n      await runTree?.postRun();\n    } else {\n      await runTree?.patchRun();\n    }\n  }\n\n  onLLMEnd(run: BaseTracerRun): void {\n    // Extract usage_metadata from outputs and store in extra.metadata\n    const outputs = run.outputs as\n      | { generations?: ChatGeneration[][] }\n      | undefined;\n    if (outputs?.generations) {\n      const usageMetadata = _getUsageMetadataFromGenerations(\n        outputs.generations\n      );\n      if (usageMetadata !== undefined) {\n        run.extra = run.extra ?? {};\n        const metadata =\n          (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n        metadata.usage_metadata = usageMetadata;\n        run.extra.metadata = metadata;\n      }\n    }\n  }\n\n  copyWithTracingConfig({\n    metadata,\n    tags,\n  }: {\n    metadata?: Record<string, unknown>;\n    tags?: string[];\n  }): LangChainTracer {\n    let mergedMetadata: Record<string, unknown> | undefined;\n    if (metadata === undefined) {\n      mergedMetadata = this.tracingMetadata\n        ? { ...this.tracingMetadata }\n        : undefined;\n    } else if (this.tracingMetadata === undefined) {\n      mergedMetadata = { ...metadata };\n    } else {\n      mergedMetadata = { ...this.tracingMetadata };\n      for (const [key, value] of Object.entries(metadata)) {\n        // For allowlisted LangSmith-only inheritable metadata keys (e.g.\n        // `ls_agent_type`), nested callers are allowed to OVERRIDE the\n        // value inherited from an ancestor. For all other keys we keep\n        // the existing \"first wins\" behavior so that ancestor-provided\n        // tracing metadata is not accidentally clobbered by child runs.\n        if (\n          !Object.prototype.hasOwnProperty.call(mergedMetadata, key) ||\n          OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n        ) {\n          mergedMetadata[key] = value;\n        }\n      }\n    }\n\n    const mergedTags = tags\n      ? Array.from(new Set([...this.tracingTags, ...tags]))\n      : [...this.tracingTags];\n\n    const copied = new LangChainTracer({\n      ...this.fields,\n      metadata: mergedMetadata,\n      tags: mergedTags,\n    });\n    copied.runMap = this.runMap;\n    copied.runTreeMap = this.runTreeMap;\n    return copied;\n  }\n\n  /** @internal */\n  _getRunStoreKey(): object {\n    return this.runTreeMap;\n  }\n\n  getRun(id: string): Run | undefined {\n    return this.runTreeMap.get(id);\n  }\n\n  updateFromRunTree(runTree: RunTree) {\n    this.runTreeMap.set(runTree.id, runTree);\n    let rootRun: RunTree = runTree;\n    const visited = new Set<string>();\n    while (rootRun.parent_run) {\n      if (visited.has(rootRun.id)) break;\n      visited.add(rootRun.id);\n\n      if (!rootRun.parent_run) break;\n      rootRun = rootRun.parent_run as RunTree;\n    }\n    visited.clear();\n\n    const queue = [rootRun];\n    while (queue.length > 0) {\n      const current = queue.shift();\n      if (!current || visited.has(current.id)) continue;\n      visited.add(current.id);\n\n      this.runTreeMap.set(current.id, current);\n      if (current.child_runs) {\n        queue.push(...current.child_runs);\n      }\n    }\n\n    this.client = runTree.client ?? this.client;\n    this.replicas = runTree.replicas ?? this.replicas;\n    this.projectName = runTree.project_name ?? this.projectName;\n    this.exampleId = runTree.reference_example_id ?? this.exampleId;\n    this.fields = {\n      ...this.fields,\n      client: this.client,\n      replicas: this.replicas,\n      projectName: this.projectName,\n      exampleId: this.exampleId,\n    };\n  }\n\n  getRunTreeWithTracingConfig(id: string): RunTree | undefined {\n    const runTree = this.runTreeMap.get(id);\n    if (!runTree) return undefined;\n\n    return new RunTree({\n      ...runTree,\n      client: this.client as Client,\n      project_name: this.projectName,\n      replicas: this.replicas,\n      reference_example_id: this.exampleId,\n      tracingEnabled: true,\n    });\n  }\n\n  static getTraceableRunTree(): RunTree | undefined {\n    try {\n      return (\n        // The type cast here provides forward compatibility. Old versions of LangSmith will just\n        // ignore the permitAbsentRunTree arg.\n        (\n          getCurrentRunTree as (\n            permitAbsentRunTree: boolean\n          ) => ReturnType<typeof getCurrentRunTree> | undefined\n        )(true)\n      );\n    } catch {\n      return undefined;\n    }\n  }\n\n  static [Symbol.hasInstance](instance: unknown): boolean {\n    if (typeof instance !== \"object\" || instance === null) {\n      return false;\n    }\n    const candidate = instance as Record<string, unknown>;\n    return (\n      \"name\" in candidate &&\n      candidate.name === \"langchain_tracer\" &&\n      \"copyWithTracingConfig\" in candidate &&\n      typeof candidate.copyWithTracingConfig === \"function\" &&\n      \"getRunTreeWithTracingConfig\" in candidate &&\n      typeof candidate.getRunTreeWithTracingConfig === \"function\"\n    );\n  }\n}\n\nfunction _patchMissingTracingDefaults(tracer: LangChainTracer, run: Run): void {\n  if (tracer.tracingMetadata) {\n    run.extra ??= {};\n    const metadata: Record<string, unknown> =\n      (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n    let didPatchMetadata = false;\n    for (const [key, value] of Object.entries(tracer.tracingMetadata)) {\n      // `OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS` are a small, LangSmith-only\n      // allowlist that bypasses the \"first wins\" merge so a nested caller\n      // (e.g. a subagent) can override a parent-set value.\n      if (\n        !Object.prototype.hasOwnProperty.call(metadata, key) ||\n        OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n      ) {\n        if (metadata[key] !== value) {\n          metadata[key] = value;\n          didPatchMetadata = true;\n        }\n      }\n    }\n    if (didPatchMetadata) {\n      run.extra.metadata = metadata;\n    }\n  }\n\n  if (tracer.tracingTags.length > 0) {\n    run.tags = Array.from(\n      new Set([...(run.tags ?? []), ...tracer.tracingTags])\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"tracer_langchain.js","names":[],"sources":["../../src/tracers/tracer_langchain.ts"],"sourcesContent":["import {\n  type Client,\n  type LangSmithTracingClientInterface,\n  getDefaultProjectName,\n} from \"langsmith\";\nimport { RunTree, type RunTreeConfig } from \"langsmith/run_trees\";\nimport { getCurrentRunTree } from \"langsmith/singletons/traceable\";\n\nimport {\n  BaseRun,\n  RunCreate,\n  RunUpdate as BaseRunUpdate,\n  KVMap,\n} from \"langsmith/schemas\";\nimport { BaseTracer, Run as BaseTracerRun } from \"./base.js\";\nimport { BaseCallbackHandlerInput } from \"../callbacks/base.js\";\nimport { getDefaultLangChainClientSingleton } from \"../singletons/tracer.js\";\nimport { ChatGeneration } from \"../outputs.js\";\nimport { AIMessage } from \"../messages/ai.js\";\nimport { mergeUsageMetadata, UsageMetadata } from \"../messages/metadata.js\";\n\nexport interface Run extends BaseRun {\n  id: string;\n  child_runs: this[];\n  child_execution_order: number;\n  dotted_order?: string;\n  trace_id?: string;\n}\n\nexport interface RunCreate2 extends RunCreate {\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface RunUpdate extends BaseRunUpdate {\n  events: BaseRun[\"events\"];\n  inputs: KVMap;\n  trace_id?: string;\n  dotted_order?: string;\n}\n\nexport interface LangChainTracerFields extends BaseCallbackHandlerInput {\n  exampleId?: string;\n  projectName?: string;\n  client?: LangSmithTracingClientInterface;\n  replicas?: RunTreeConfig[\"replicas\"];\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n}\n\n/**\n * Keys that should be inherited from `tracerInheritableMetadata` even when\n * the run already has a value for them. This lets nested contexts\n * (e.g. a subagent invoked from inside a parent agent) override a\n * LangSmith-only tracing metadata value that was set by an ancestor.\n *\n * Keep this list very small: every key here loses the default\n * \"first wins\" protection and is always clobbered by the nearest\n * enclosing tracer config. Only keys that are strictly for LangSmith\n * tracing bookkeeping should be added.\n */\nexport const OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS = new Set<string>([\n  \"ls_agent_type\",\n]);\n\n/**\n * Extract usage_metadata from chat generations.\n *\n * Iterates through generations to find and aggregates all usage_metadata\n * found in chat messages. This is typically present in chat model outputs.\n */\nfunction _getUsageMetadataFromGenerations(\n  generations: ChatGeneration[][]\n): UsageMetadata | undefined {\n  let output: UsageMetadata | undefined = undefined;\n  for (const generationBatch of generations) {\n    for (const generation of generationBatch) {\n      if (\n        AIMessage.isInstance(generation.message) &&\n        generation.message.usage_metadata !== undefined\n      ) {\n        output = mergeUsageMetadata(output, generation.message.usage_metadata);\n      }\n    }\n  }\n  return output;\n}\n\nexport class LangChainTracer\n  extends BaseTracer\n  implements LangChainTracerFields\n{\n  name = \"langchain_tracer\";\n\n  projectName?: string;\n\n  exampleId?: string;\n\n  client: LangSmithTracingClientInterface;\n\n  replicas?: RunTreeConfig[\"replicas\"];\n\n  usesRunTreeMap = true;\n\n  tracingMetadata?: Record<string, unknown>;\n\n  tracingTags: string[] = [];\n\n  constructor(protected fields: LangChainTracerFields = {}) {\n    super(fields);\n    const { exampleId, projectName, client, replicas, metadata, tags } = fields;\n\n    this.projectName = projectName ?? getDefaultProjectName();\n    this.replicas = replicas;\n    this.exampleId = exampleId;\n    this.client = client ?? getDefaultLangChainClientSingleton();\n    this.tracingMetadata = metadata ? { ...metadata } : undefined;\n    this.tracingTags = tags ?? [];\n\n    const traceableTree = LangChainTracer.getTraceableRunTree();\n    if (traceableTree) {\n      this.updateFromRunTree(traceableTree);\n    }\n  }\n\n  protected async persistRun(_run: Run): Promise<void> {\n    // empty\n  }\n\n  async onRunCreate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    if (!run.extra?.lc_defers_inputs) {\n      const runTree = this.getRunTreeWithTracingConfig(run.id);\n      await runTree?.postRun();\n    }\n  }\n\n  async onRunUpdate(run: Run): Promise<void> {\n    _patchMissingTracingDefaults(this, run);\n    const runTree = this.getRunTreeWithTracingConfig(run.id);\n    if (run.extra?.lc_defers_inputs) {\n      await runTree?.postRun();\n    } else {\n      await runTree?.patchRun();\n    }\n  }\n\n  onLLMEnd(run: BaseTracerRun): void {\n    // Extract usage_metadata from outputs and store in extra.metadata\n    const outputs = run.outputs as\n      | { generations?: ChatGeneration[][] }\n      | undefined;\n    if (outputs?.generations) {\n      const usageMetadata = _getUsageMetadataFromGenerations(\n        outputs.generations\n      );\n      if (usageMetadata !== undefined) {\n        run.extra = run.extra ?? {};\n        const metadata =\n          (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n        metadata.usage_metadata = usageMetadata;\n        run.extra.metadata = metadata;\n      }\n    }\n  }\n\n  copyWithTracingConfig({\n    metadata,\n    tags,\n  }: {\n    metadata?: Record<string, unknown>;\n    tags?: string[];\n  }): LangChainTracer {\n    let mergedMetadata: Record<string, unknown> | undefined;\n    if (metadata === undefined) {\n      mergedMetadata = this.tracingMetadata\n        ? { ...this.tracingMetadata }\n        : undefined;\n    } else if (this.tracingMetadata === undefined) {\n      mergedMetadata = { ...metadata };\n    } else {\n      mergedMetadata = { ...this.tracingMetadata };\n      for (const [key, value] of Object.entries(metadata)) {\n        // For allowlisted LangSmith-only inheritable metadata keys (e.g.\n        // `ls_agent_type`), nested callers are allowed to OVERRIDE the\n        // value inherited from an ancestor. For all other keys we keep\n        // the existing \"first wins\" behavior so that ancestor-provided\n        // tracing metadata is not accidentally clobbered by child runs.\n        if (\n          !Object.prototype.hasOwnProperty.call(mergedMetadata, key) ||\n          OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n        ) {\n          mergedMetadata[key] = value;\n        }\n      }\n    }\n\n    const mergedTags = tags\n      ? Array.from(new Set([...this.tracingTags, ...tags]))\n      : [...this.tracingTags];\n\n    const copied = new LangChainTracer({\n      ...this.fields,\n      metadata: mergedMetadata,\n      tags: mergedTags,\n    });\n    copied.runMap = this.runMap;\n    copied.runTreeMap = this.runTreeMap;\n    return copied;\n  }\n\n  /** @internal */\n  _getRunStoreKey(): object {\n    return this.runTreeMap;\n  }\n\n  getRun(id: string): Run | undefined {\n    return this.runTreeMap.get(id);\n  }\n\n  updateFromRunTree(runTree: RunTree) {\n    this.runTreeMap.set(runTree.id, runTree);\n    let rootRun: RunTree = runTree;\n    const visited = new Set<string>();\n    while (rootRun.parent_run) {\n      if (visited.has(rootRun.id)) break;\n      visited.add(rootRun.id);\n\n      if (!rootRun.parent_run) break;\n      rootRun = rootRun.parent_run as RunTree;\n    }\n    visited.clear();\n\n    const queue = [rootRun];\n    while (queue.length > 0) {\n      const current = queue.shift();\n      if (!current || visited.has(current.id)) continue;\n      visited.add(current.id);\n\n      this.runTreeMap.set(current.id, current);\n      if (current.child_runs) {\n        queue.push(...current.child_runs);\n      }\n    }\n\n    this.client = runTree.client ?? this.client;\n    this.replicas = runTree.replicas ?? this.replicas;\n    this.projectName = runTree.project_name ?? this.projectName;\n    this.exampleId = runTree.reference_example_id ?? this.exampleId;\n    this.fields = {\n      ...this.fields,\n      client: this.client,\n      replicas: this.replicas,\n      projectName: this.projectName,\n      exampleId: this.exampleId,\n    };\n  }\n\n  getRunTreeWithTracingConfig(id: string): RunTree | undefined {\n    const runTree = this.runTreeMap.get(id);\n    if (!runTree) return undefined;\n\n    return new RunTree({\n      ...runTree,\n      client: this.client as Client,\n      project_name: this.projectName,\n      replicas: this.replicas,\n      reference_example_id: this.exampleId,\n      tracingEnabled: true,\n    });\n  }\n\n  static getTraceableRunTree(): RunTree | undefined {\n    try {\n      return (\n        // The type cast here provides forward compatibility. Old versions of LangSmith will just\n        // ignore the permitAbsentRunTree arg.\n        (\n          getCurrentRunTree as (\n            permitAbsentRunTree: boolean\n          ) => ReturnType<typeof getCurrentRunTree> | undefined\n        )(true)\n      );\n    } catch {\n      return undefined;\n    }\n  }\n\n  static [Symbol.hasInstance](instance: unknown): boolean {\n    if (typeof instance !== \"object\" || instance === null) {\n      return false;\n    }\n    const candidate = instance as Record<string, unknown>;\n    return (\n      \"name\" in candidate &&\n      candidate.name === \"langchain_tracer\" &&\n      \"copyWithTracingConfig\" in candidate &&\n      typeof candidate.copyWithTracingConfig === \"function\" &&\n      \"getRunTreeWithTracingConfig\" in candidate &&\n      typeof candidate.getRunTreeWithTracingConfig === \"function\"\n    );\n  }\n}\n\nfunction _patchMissingTracingDefaults(tracer: LangChainTracer, run: Run): void {\n  if (tracer.tracingMetadata) {\n    run.extra ??= {};\n    const metadata: Record<string, unknown> =\n      (run.extra.metadata as Record<string, unknown> | undefined) ?? {};\n    let didPatchMetadata = false;\n    for (const [key, value] of Object.entries(tracer.tracingMetadata)) {\n      // `OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS` are a small, LangSmith-only\n      // allowlist that bypasses the \"first wins\" merge so a nested caller\n      // (e.g. a subagent) can override a parent-set value.\n      if (\n        !Object.prototype.hasOwnProperty.call(metadata, key) ||\n        OVERRIDABLE_LANGSMITH_INHERITABLE_METADATA_KEYS.has(key)\n      ) {\n        if (metadata[key] !== value) {\n          metadata[key] = value;\n          didPatchMetadata = true;\n        }\n      }\n    }\n    if (didPatchMetadata) {\n      run.extra.metadata = metadata;\n    }\n  }\n\n  if (tracer.tracingTags.length > 0) {\n    run.tags = Array.from(\n      new Set([...(run.tags ?? []), ...tracer.tracingTags])\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/types/_internal.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"_internal.d.cts","names":[],"sources":["../../src/types/_internal.ts"],"mappings":";KAGY,+BAAA,MAAqC,cAAA,CAAe,CAAA,IAC9D,aAAA,CAAc,CAAA"}
+{"version":3,"file":"_internal.d.cts","names":[],"sources":["../../src/types/_internal.ts"],"mappings":";KAGY,gCAAgC,KAAK,eAAe,KAC9D,cAAc"}

package/dist/types/_internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_internal.d.ts","names":[],"sources":["../../src/types/_internal.ts"],"mappings":";KAGY,+BAAA,MAAqC,cAAA,CAAe,CAAA,IAC9D,aAAA,CAAc,CAAA"}
+{"version":3,"file":"_internal.d.ts","names":[],"sources":["../../src/types/_internal.ts"],"mappings":";KAGY,gCAAgC,KAAK,eAAe,KAC9D,cAAc"}

package/dist/types/stream.d.cts

@@ -1,3 +1,3 @@
 import { IterableReadableStreamInterface } from "./_internal.cjs";
 import { StreamEvent, StreamEventData } from "../tracers/event_stream.cjs";
-export { type IterableReadableStreamInterface, type StreamEvent, type StreamEventData };
+export type { IterableReadableStreamInterface, StreamEvent, StreamEventData };

package/dist/types/stream.d.ts

@@ -1,3 +1,3 @@
 import { IterableReadableStreamInterface } from "./_internal.js";
 import { StreamEvent, StreamEventData } from "../tracers/event_stream.js";
-export { type IterableReadableStreamInterface, type StreamEvent, type StreamEventData };
+export type { IterableReadableStreamInterface, StreamEvent, StreamEventData };

package/dist/types/type-utils.d.cts

@@ -1,6 +1,6 @@
 //#region src/types/type-utils.d.ts
 type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-type DeepPartial<T> = { [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P] };
+type DeepPartial<T> = { [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P]; };
 //#endregion
 export { DeepPartial, Optional };
 //# sourceMappingURL=type-utils.d.cts.map

package/dist/types/type-utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"type-utils.d.cts","names":[],"sources":["../../src/types/type-utils.ts"],"mappings":";KAEY,QAAA,oBAA4B,CAAA,IAAK,IAAA,CAAK,CAAA,EAAG,CAAA,IAAK,OAAA,CAAQ,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,KAG9D,WAAA,oBACE,CAAA,IAAK,CAAA,CAAE,CAAA,mBAAoB,WAAA,CAAY,CAAA,CAAE,CAAA,KAAM,CAAA,CAAE,CAAA"}
+{"version":3,"file":"type-utils.d.cts","names":[],"sources":["../../src/types/type-utils.ts"],"mappings":";KAEY,SAAS,GAAG,gBAAgB,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAK,GAAG;KAG9D,YAAY,QACrB,WAAW,KAAK,EAAE,oBAAoB,YAAY,EAAE,MAAM,EAAE"}

package/dist/types/type-utils.d.ts

@@ -1,6 +1,6 @@
 //#region src/types/type-utils.d.ts
 type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-type DeepPartial<T> = { [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P] };
+type DeepPartial<T> = { [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P]; };
 //#endregion
 export { DeepPartial, Optional };
 //# sourceMappingURL=type-utils.d.ts.map

package/dist/types/type-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-utils.d.ts","names":[],"sources":["../../src/types/type-utils.ts"],"mappings":";KAEY,QAAA,oBAA4B,CAAA,IAAK,IAAA,CAAK,CAAA,EAAG,CAAA,IAAK,OAAA,CAAQ,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,KAG9D,WAAA,oBACE,CAAA,IAAK,CAAA,CAAE,CAAA,mBAAoB,WAAA,CAAY,CAAA,CAAE,CAAA,KAAM,CAAA,CAAE,CAAA"}
+{"version":3,"file":"type-utils.d.ts","names":[],"sources":["../../src/types/type-utils.ts"],"mappings":";KAEY,SAAS,GAAG,gBAAgB,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAK,GAAG;KAG9D,YAAY,QACrB,WAAW,KAAK,EAAE,oBAAoB,YAAY,EAAE,MAAM,EAAE"}

package/dist/utils/async_caller.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"async_caller.cjs","names":["PQueueMod","pRetry","getAbortSignalError"],"sources":["../../src/utils/async_caller.ts"],"sourcesContent":["import PQueueMod from \"p-queue\";\n\nimport { getAbortSignalError } from \"./signal.js\";\nimport pRetry from \"./p-retry/index.js\";\n\nconst STATUS_NO_RETRY = [\n  400, // Bad Request\n  401, // Unauthorized\n  402, // Payment Required\n  403, // Forbidden\n  404, // Not Found\n  405, // Method Not Allowed\n  406, // Not Acceptable\n  407, // Proxy Authentication Required\n  409, // Conflict\n];\n\nconst RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS = 60_000;\n\nconst QUOTA_EXHAUSTED_MESSAGE_PATTERNS = [\n  /insufficient[_ -]?quota/i,\n  /exceeded (?:your|the current|the available).+quota/i,\n  /usage quota/i,\n  /quota (?:has been )?exhausted/i,\n  /billing/i,\n  /credit balance/i,\n  /out of credits/i,\n  /will reset at/i,\n];\n\nconst RETRY_AFTER_MESSAGE_PATTERN =\n  /(?:try again in|retry after)\\s+(\\d+(?:\\.\\d+)?)\\s*(milliseconds?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h)\\b/i;\n\ntype RateLimitAction = \"wait\" | \"capacity\" | \"stop\";\n\ntype RateLimitClassification = {\n  action: RateLimitAction;\n  retryAfterMs?: number;\n  reason: string;\n};\n\nfunction getResponseStatus(error: unknown): number | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"response\" in error &&\n    typeof error.response === \"object\" &&\n    error.response !== null &&\n    \"status\" in error.response &&\n    typeof error.response.status === \"number\"\n    ? error.response.status\n    : undefined;\n}\n\nfunction getDirectStatus(error: unknown): number | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"status\" in error && typeof error.status === \"number\") {\n    return error.status;\n  }\n\n  if (\"statusCode\" in error && typeof error.statusCode === \"number\") {\n    return error.statusCode;\n  }\n\n  return undefined;\n}\n\nfunction getErrorMessage(error: unknown): string | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof error.message === \"string\"\n    ? error.message\n    : undefined;\n}\n\nfunction getErrorCode(error: unknown): string | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"code\" in error && typeof error.code === \"string\") {\n    return error.code;\n  }\n\n  return \"error\" in error &&\n    typeof error.error === \"object\" &&\n    error.error !== null &&\n    \"code\" in error.error &&\n    typeof error.error.code === \"string\"\n    ? error.error.code\n    : undefined;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction _getRetryAfterHeader(error: any): string | null | undefined {\n  if (error?.headers) {\n    if (typeof error.headers.get === \"function\") {\n      return error.headers.get(\"retry-after\");\n    }\n    return error.headers[\"retry-after\"] ?? error.headers[\"Retry-After\"];\n  }\n\n  if (error?.response?.headers) {\n    if (typeof error.response.headers.get === \"function\") {\n      return error.response.headers.get(\"retry-after\");\n    }\n    return (\n      error.response.headers[\"retry-after\"] ??\n      error.response.headers[\"Retry-After\"]\n    );\n  }\n\n  return undefined;\n}\n\nfunction parseRetryAfterFromMessageMs(\n  message: string | undefined\n): number | undefined {\n  if (message == null) {\n    return undefined;\n  }\n\n  const match = RETRY_AFTER_MESSAGE_PATTERN.exec(message);\n  if (!match) {\n    return undefined;\n  }\n\n  const rawValue = Number(match[1]);\n  const unit = match[2]?.toLowerCase();\n  if (Number.isNaN(rawValue) || !unit) {\n    return undefined;\n  }\n\n  if (unit === \"ms\" || unit.startsWith(\"millisecond\")) {\n    return rawValue;\n  }\n\n  if (unit === \"m\" || unit.startsWith(\"min\")) {\n    return rawValue * 60_000;\n  }\n\n  if (unit === \"h\" || unit.startsWith(\"hr\") || unit.startsWith(\"hour\")) {\n    return rawValue * 3_600_000;\n  }\n\n  return rawValue * 1000;\n}\n\nfunction coerceError(error: unknown, fallbackMessage: string): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  const coerced = new Error(fallbackMessage);\n  if (typeof error === \"object\" && error !== null) {\n    Object.assign(coerced, error);\n  }\n  return coerced;\n}\n\nfunction setRateLimitMetadata(\n  error: unknown,\n  classification: RateLimitClassification\n) {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  const mutableError = error as Record<string, unknown>;\n  mutableError.rateLimitType = classification.action;\n  mutableError.rateLimitReason = classification.reason;\n\n  if (classification.retryAfterMs !== undefined) {\n    mutableError.retryAfterMs = classification.retryAfterMs;\n  }\n}\n\nexport function parseRetryAfterMs(\n  headerValue: string | null | undefined\n): number | undefined {\n  if (headerValue == null) {\n    return undefined;\n  }\n\n  const trimmed = headerValue.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n\n  const seconds = Number(trimmed);\n  if (!Number.isNaN(seconds) && seconds >= 0) {\n    return seconds * 1000;\n  }\n\n  const date = Date.parse(trimmed);\n  if (!Number.isNaN(date)) {\n    const delayMs = date - Date.now();\n    return delayMs > 0 ? delayMs : 0;\n  }\n\n  return undefined;\n}\n\nexport function classifyRateLimitError(\n  error: unknown\n): RateLimitClassification | undefined {\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status !== 429) {\n    return undefined;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    return { action: \"stop\", reason: \"insufficient_quota\" };\n  }\n\n  const message = getErrorMessage(error);\n  if (\n    message &&\n    QUOTA_EXHAUSTED_MESSAGE_PATTERNS.some((pattern) => pattern.test(message))\n  ) {\n    return { action: \"stop\", reason: \"quota_message\" };\n  }\n\n  const retryAfterMs =\n    parseRetryAfterMs(_getRetryAfterHeader(error)) ??\n    parseRetryAfterFromMessageMs(message);\n\n  if (retryAfterMs !== undefined) {\n    if (retryAfterMs <= RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS) {\n      return {\n        action: \"wait\",\n        retryAfterMs,\n        reason: \"retry_after_hint\",\n      };\n    }\n\n    return {\n      action: \"capacity\",\n      retryAfterMs,\n      reason: \"retry_after_too_large\",\n    };\n  }\n\n  return { action: \"capacity\", reason: \"headerless_429\" };\n}\n\n/**\n * The default failed attempt handler for the AsyncCaller.\n * @param error - The error to handle.\n * @returns void\n */\nconst defaultFailedAttemptHandler = (error: unknown) => {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  if (\n    (\"message\" in error &&\n      typeof error.message === \"string\" &&\n      (error.message.startsWith(\"Cancel\") ||\n        error.message.startsWith(\"AbortError\"))) ||\n    (\"name\" in error &&\n      typeof error.name === \"string\" &&\n      error.name === \"AbortError\")\n  ) {\n    throw error;\n  }\n  if (\n    \"code\" in error &&\n    typeof error.code === \"string\" &&\n    error.code === \"ECONNABORTED\"\n  ) {\n    throw error;\n  }\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status && STATUS_NO_RETRY.includes(+status)) {\n    throw error;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Insufficient quota\"\n    );\n    err.name = \"InsufficientQuotaError\";\n    setRateLimitMetadata(err, {\n      action: \"stop\",\n      reason: \"insufficient_quota\",\n    });\n    throw err;\n  }\n\n  const rateLimitClassification = classifyRateLimitError(error);\n  if (rateLimitClassification) {\n    if (rateLimitClassification.action === \"wait\") {\n      setRateLimitMetadata(error, rateLimitClassification);\n      return;\n    }\n\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Rate limit exceeded\"\n    );\n    if (err.name === \"Error\") {\n      err.name =\n        rateLimitClassification.action === \"stop\"\n          ? \"RateLimitQuotaExhaustedError\"\n          : \"RateLimitCapacityError\";\n    }\n    setRateLimitMetadata(err, rateLimitClassification);\n    throw err;\n  }\n};\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport type FailedAttemptHandler = (error: any) => any;\n\nexport interface AsyncCallerParams {\n  /**\n   * The maximum number of concurrent calls that can be made.\n   * Defaults to `Infinity`, which means no limit.\n   */\n  maxConcurrency?: number;\n  /**\n   * The maximum number of retries that can be made for a single call,\n   * with an exponential backoff between each attempt. Defaults to 6.\n   */\n  maxRetries?: number;\n  /**\n   * Custom handler to handle failed attempts. Takes the originally thrown\n   * error object as input, and should itself throw an error if the input\n   * error is not retryable.\n   */\n  onFailedAttempt?: FailedAttemptHandler;\n}\n\nexport interface AsyncCallerCallOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * A class that can be used to make async calls with concurrency and retry logic.\n *\n * This is useful for making calls to any kind of \"expensive\" external resource,\n * be it because it's rate-limited, subject to network issues, etc.\n *\n * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults\n * to `Infinity`. This means that by default, all calls will be made in parallel.\n *\n * Retries are limited by the `maxRetries` parameter, which defaults to 6. This\n * means that by default, each call will be retried up to 6 times, with an\n * exponential backoff between each attempt.\n */\nexport class AsyncCaller {\n  protected maxConcurrency: AsyncCallerParams[\"maxConcurrency\"];\n\n  protected maxRetries: AsyncCallerParams[\"maxRetries\"];\n\n  protected onFailedAttempt: AsyncCallerParams[\"onFailedAttempt\"];\n\n  private queue: (typeof import(\"p-queue\"))[\"default\"][\"prototype\"];\n\n  constructor(params: AsyncCallerParams) {\n    this.maxConcurrency = params.maxConcurrency ?? Infinity;\n    this.maxRetries = params.maxRetries ?? 6;\n    this.onFailedAttempt =\n      params.onFailedAttempt ?? defaultFailedAttemptHandler;\n\n    const PQueue = (\n      \"default\" in PQueueMod ? PQueueMod.default : PQueueMod\n    ) as typeof PQueueMod;\n    this.queue = new PQueue({ concurrency: this.maxConcurrency });\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  async call<A extends any[], T extends (...args: A) => Promise<any>>(\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    return this.queue.add(\n      () =>\n        pRetry(\n          () =>\n            callable(...args).catch((error) => {\n              // oxlint-disable-next-line no-instanceof/no-instanceof\n              if (error instanceof Error) {\n                throw error;\n              } else {\n                throw new Error(error);\n              }\n            }),\n          {\n            onFailedAttempt: ({ error }) => this.onFailedAttempt?.(error),\n            retries: this.maxRetries,\n            randomize: true,\n            // If needed we can change some of the defaults here,\n            // but they're quite sensible.\n          }\n        ),\n      { throwOnTimeout: true }\n    );\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  callWithOptions<A extends any[], T extends (...args: A) => Promise<any>>(\n    options: AsyncCallerCallOptions,\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    // Note this doesn't cancel the underlying request,\n    // when available prefer to use the signal option of the underlying call\n    if (options.signal) {\n      let listener: (() => void) | undefined;\n      return Promise.race([\n        this.call<A, T>(callable, ...args),\n        new Promise<never>((_, reject) => {\n          listener = () => {\n            reject(getAbortSignalError(options.signal));\n          };\n          options.signal?.addEventListener(\"abort\", listener, { once: true });\n        }),\n      ]).finally(() => {\n        if (options.signal && listener) {\n          options.signal.removeEventListener(\"abort\", listener);\n        }\n      });\n    }\n    return this.call<A, T>(callable, ...args);\n  }\n\n  fetch(...args: Parameters<typeof fetch>): ReturnType<typeof fetch> {\n    return this.call(() =>\n      fetch(...args).then((res) => (res.ok ? res : Promise.reject(res)))\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"async_caller.cjs","names":["PQueueMod","pRetry","getAbortSignalError"],"sources":["../../src/utils/async_caller.ts"],"sourcesContent":["import PQueueMod from \"p-queue\";\n\nimport { getAbortSignalError } from \"./signal.js\";\nimport pRetry from \"./p-retry/index.js\";\n\nconst STATUS_NO_RETRY = [\n  400, // Bad Request\n  401, // Unauthorized\n  402, // Payment Required\n  403, // Forbidden\n  404, // Not Found\n  405, // Method Not Allowed\n  406, // Not Acceptable\n  407, // Proxy Authentication Required\n  409, // Conflict\n];\n\nconst RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS = 60_000;\n\nconst QUOTA_EXHAUSTED_MESSAGE_PATTERNS = [\n  /insufficient[_ -]?quota/i,\n  /exceeded (?:your|the current|the available).+quota/i,\n  /usage quota/i,\n  /quota (?:has been )?exhausted/i,\n  /billing/i,\n  /credit balance/i,\n  /out of credits/i,\n  /will reset at/i,\n];\n\nconst RETRY_AFTER_MESSAGE_PATTERN =\n  /(?:try again in|retry after)\\s+(\\d+(?:\\.\\d+)?)\\s*(milliseconds?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h)\\b/i;\n\ntype RateLimitAction = \"wait\" | \"capacity\" | \"stop\";\n\ntype RateLimitClassification = {\n  action: RateLimitAction;\n  retryAfterMs?: number;\n  reason: string;\n};\n\nfunction getResponseStatus(error: unknown): number | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"response\" in error &&\n    typeof error.response === \"object\" &&\n    error.response !== null &&\n    \"status\" in error.response &&\n    typeof error.response.status === \"number\"\n    ? error.response.status\n    : undefined;\n}\n\nfunction getDirectStatus(error: unknown): number | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"status\" in error && typeof error.status === \"number\") {\n    return error.status;\n  }\n\n  if (\"statusCode\" in error && typeof error.statusCode === \"number\") {\n    return error.statusCode;\n  }\n\n  return undefined;\n}\n\nfunction getErrorMessage(error: unknown): string | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof error.message === \"string\"\n    ? error.message\n    : undefined;\n}\n\nfunction getErrorCode(error: unknown): string | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"code\" in error && typeof error.code === \"string\") {\n    return error.code;\n  }\n\n  return \"error\" in error &&\n    typeof error.error === \"object\" &&\n    error.error !== null &&\n    \"code\" in error.error &&\n    typeof error.error.code === \"string\"\n    ? error.error.code\n    : undefined;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction _getRetryAfterHeader(error: any): string | null | undefined {\n  if (error?.headers) {\n    if (typeof error.headers.get === \"function\") {\n      return error.headers.get(\"retry-after\");\n    }\n    return error.headers[\"retry-after\"] ?? error.headers[\"Retry-After\"];\n  }\n\n  if (error?.response?.headers) {\n    if (typeof error.response.headers.get === \"function\") {\n      return error.response.headers.get(\"retry-after\");\n    }\n    return (\n      error.response.headers[\"retry-after\"] ??\n      error.response.headers[\"Retry-After\"]\n    );\n  }\n\n  return undefined;\n}\n\nfunction parseRetryAfterFromMessageMs(\n  message: string | undefined\n): number | undefined {\n  if (message == null) {\n    return undefined;\n  }\n\n  const match = RETRY_AFTER_MESSAGE_PATTERN.exec(message);\n  if (!match) {\n    return undefined;\n  }\n\n  const rawValue = Number(match[1]);\n  const unit = match[2]?.toLowerCase();\n  if (Number.isNaN(rawValue) || !unit) {\n    return undefined;\n  }\n\n  if (unit === \"ms\" || unit.startsWith(\"millisecond\")) {\n    return rawValue;\n  }\n\n  if (unit === \"m\" || unit.startsWith(\"min\")) {\n    return rawValue * 60_000;\n  }\n\n  if (unit === \"h\" || unit.startsWith(\"hr\") || unit.startsWith(\"hour\")) {\n    return rawValue * 3_600_000;\n  }\n\n  return rawValue * 1000;\n}\n\nfunction coerceError(error: unknown, fallbackMessage: string): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  const coerced = new Error(fallbackMessage);\n  if (typeof error === \"object\" && error !== null) {\n    Object.assign(coerced, error);\n  }\n  return coerced;\n}\n\nfunction setRateLimitMetadata(\n  error: unknown,\n  classification: RateLimitClassification\n) {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  const mutableError = error as Record<string, unknown>;\n  mutableError.rateLimitType = classification.action;\n  mutableError.rateLimitReason = classification.reason;\n\n  if (classification.retryAfterMs !== undefined) {\n    mutableError.retryAfterMs = classification.retryAfterMs;\n  }\n}\n\nexport function parseRetryAfterMs(\n  headerValue: string | null | undefined\n): number | undefined {\n  if (headerValue == null) {\n    return undefined;\n  }\n\n  const trimmed = headerValue.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n\n  const seconds = Number(trimmed);\n  if (!Number.isNaN(seconds) && seconds >= 0) {\n    return seconds * 1000;\n  }\n\n  const date = Date.parse(trimmed);\n  if (!Number.isNaN(date)) {\n    const delayMs = date - Date.now();\n    return delayMs > 0 ? delayMs : 0;\n  }\n\n  return undefined;\n}\n\nexport function classifyRateLimitError(\n  error: unknown\n): RateLimitClassification | undefined {\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status !== 429) {\n    return undefined;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    return { action: \"stop\", reason: \"insufficient_quota\" };\n  }\n\n  const message = getErrorMessage(error);\n  if (\n    message &&\n    QUOTA_EXHAUSTED_MESSAGE_PATTERNS.some((pattern) => pattern.test(message))\n  ) {\n    return { action: \"stop\", reason: \"quota_message\" };\n  }\n\n  const retryAfterMs =\n    parseRetryAfterMs(_getRetryAfterHeader(error)) ??\n    parseRetryAfterFromMessageMs(message);\n\n  if (retryAfterMs !== undefined) {\n    if (retryAfterMs <= RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS) {\n      return {\n        action: \"wait\",\n        retryAfterMs,\n        reason: \"retry_after_hint\",\n      };\n    }\n\n    return {\n      action: \"capacity\",\n      retryAfterMs,\n      reason: \"retry_after_too_large\",\n    };\n  }\n\n  return { action: \"capacity\", reason: \"headerless_429\" };\n}\n\n/**\n * The default failed attempt handler for the AsyncCaller.\n * @param error - The error to handle.\n * @returns void\n */\nconst defaultFailedAttemptHandler = (error: unknown) => {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  if (\n    (\"message\" in error &&\n      typeof error.message === \"string\" &&\n      (error.message.startsWith(\"Cancel\") ||\n        error.message.startsWith(\"AbortError\"))) ||\n    (\"name\" in error &&\n      typeof error.name === \"string\" &&\n      error.name === \"AbortError\")\n  ) {\n    throw error;\n  }\n  if (\n    \"code\" in error &&\n    typeof error.code === \"string\" &&\n    error.code === \"ECONNABORTED\"\n  ) {\n    throw error;\n  }\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status && STATUS_NO_RETRY.includes(+status)) {\n    throw error;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Insufficient quota\"\n    );\n    err.name = \"InsufficientQuotaError\";\n    setRateLimitMetadata(err, {\n      action: \"stop\",\n      reason: \"insufficient_quota\",\n    });\n    throw err;\n  }\n\n  const rateLimitClassification = classifyRateLimitError(error);\n  if (rateLimitClassification) {\n    if (rateLimitClassification.action === \"wait\") {\n      setRateLimitMetadata(error, rateLimitClassification);\n      return;\n    }\n\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Rate limit exceeded\"\n    );\n    if (err.name === \"Error\") {\n      err.name =\n        rateLimitClassification.action === \"stop\"\n          ? \"RateLimitQuotaExhaustedError\"\n          : \"RateLimitCapacityError\";\n    }\n    setRateLimitMetadata(err, rateLimitClassification);\n    throw err;\n  }\n};\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport type FailedAttemptHandler = (error: any) => any;\n\nexport interface AsyncCallerParams {\n  /**\n   * The maximum number of concurrent calls that can be made.\n   * Defaults to `Infinity`, which means no limit.\n   */\n  maxConcurrency?: number;\n  /**\n   * The maximum number of retries that can be made for a single call,\n   * with an exponential backoff between each attempt. Defaults to 6.\n   */\n  maxRetries?: number;\n  /**\n   * Custom handler to handle failed attempts. Takes the originally thrown\n   * error object as input, and should itself throw an error if the input\n   * error is not retryable.\n   */\n  onFailedAttempt?: FailedAttemptHandler;\n}\n\nexport interface AsyncCallerCallOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * A class that can be used to make async calls with concurrency and retry logic.\n *\n * This is useful for making calls to any kind of \"expensive\" external resource,\n * be it because it's rate-limited, subject to network issues, etc.\n *\n * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults\n * to `Infinity`. This means that by default, all calls will be made in parallel.\n *\n * Retries are limited by the `maxRetries` parameter, which defaults to 6. This\n * means that by default, each call will be retried up to 6 times, with an\n * exponential backoff between each attempt.\n */\nexport class AsyncCaller {\n  protected maxConcurrency: AsyncCallerParams[\"maxConcurrency\"];\n\n  protected maxRetries: AsyncCallerParams[\"maxRetries\"];\n\n  protected onFailedAttempt: AsyncCallerParams[\"onFailedAttempt\"];\n\n  private queue: (typeof import(\"p-queue\"))[\"default\"][\"prototype\"];\n\n  constructor(params: AsyncCallerParams) {\n    this.maxConcurrency = params.maxConcurrency ?? Infinity;\n    this.maxRetries = params.maxRetries ?? 6;\n    this.onFailedAttempt =\n      params.onFailedAttempt ?? defaultFailedAttemptHandler;\n\n    const PQueue = (\n      \"default\" in PQueueMod ? PQueueMod.default : PQueueMod\n    ) as typeof PQueueMod;\n    this.queue = new PQueue({ concurrency: this.maxConcurrency });\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  async call<A extends any[], T extends (...args: A) => Promise<any>>(\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    return this.queue.add(\n      () =>\n        pRetry(\n          () =>\n            callable(...args).catch((error) => {\n              // oxlint-disable-next-line no-instanceof/no-instanceof\n              if (error instanceof Error) {\n                throw error;\n              } else {\n                throw new Error(error);\n              }\n            }),\n          {\n            onFailedAttempt: ({ error }) => this.onFailedAttempt?.(error),\n            retries: this.maxRetries,\n            randomize: true,\n            // If needed we can change some of the defaults here,\n            // but they're quite sensible.\n          }\n        ),\n      { throwOnTimeout: true }\n    );\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  callWithOptions<A extends any[], T extends (...args: A) => Promise<any>>(\n    options: AsyncCallerCallOptions,\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    // Note this doesn't cancel the underlying request,\n    // when available prefer to use the signal option of the underlying call\n    if (options.signal) {\n      let listener: (() => void) | undefined;\n      return Promise.race([\n        this.call<A, T>(callable, ...args),\n        new Promise<never>((_, reject) => {\n          listener = () => {\n            reject(getAbortSignalError(options.signal));\n          };\n          options.signal?.addEventListener(\"abort\", listener, { once: true });\n        }),\n      ]).finally(() => {\n        if (options.signal && listener) {\n          options.signal.removeEventListener(\"abort\", listener);\n        }\n      });\n    }\n    return this.call<A, T>(callable, ...args);\n  }\n\n  fetch(...args: Parameters<typeof fetch>): ReturnType<typeof fetch> {\n    return this.call(() =>\n      fetch(...args).then((res) => (res.ok ? res : Promise.reject(res)))\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/utils/async_caller.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"async_caller.d.cts","names":[],"sources":["../../src/utils/async_caller.ts"],"mappings":";KAiCK,eAAA;AAAA,KAEA,uBAAA;EACH,MAAA,EAAQ,eAAA;EACR,YAAA;EACA,MAAA;AAAA;AAAA,iBA8Ic,iBAAA,CACd,WAAA;AAAA,iBAyBc,sBAAA,CACd,KAAA,YACC,uBAAA;AAAA,KAgHS,oBAAA,IAAwB,KAAA;AAAA,UAEnB,iBAAA;EA9Rf;;;;EAmSA,cAAA;EAjSM;AA8IR;;;EAwJE,UAAA;EAvJsC;AAyBxC;;;;EAoIE,eAAA,GAAkB,oBAAA;AAAA;AAAA,UAGH,sBAAA;EACf,MAAA,GAAS,WAAA;AAAA;;AApBX;;;;;;;;;;AAmBA;;cAiBa,WAAA;EAAA,UACD,cAAA,EAAgB,iBAAA;EAAA,UAEhB,UAAA,EAAY,iBAAA;EAAA,UAEZ,eAAA,EAAiB,iBAAA;EAAA,QAEnB,KAAA;EAER,WAAA,CAAY,MAAA,EAAQ,iBAAA;EAad,IAAA,gCAAoC,IAAA,EAAM,CAAA,KAAM,OAAA,MAAA,CACpD,QAAA,EAAU,CAAA,KACP,IAAA,EAAM,UAAA,CAAW,CAAA,IACnB,OAAA,CAAQ,OAAA,CAAQ,UAAA,CAAW,CAAA;EA0B9B,eAAA,gCAA+C,IAAA,EAAM,CAAA,KAAM,OAAA,MAAA,CACzD,OAAA,EAAS,sBAAA,EACT,QAAA,EAAU,CAAA,KACP,IAAA,EAAM,UAAA,CAAW,CAAA,IACnB,OAAA,CAAQ,OAAA,CAAQ,UAAA,CAAW,CAAA;EAsB9B,KAAA,CAAA,GAAS,IAAA,EAAM,UAAA,QAAkB,KAAA,IAAS,UAAA,QAAkB,KAAA;AAAA"}
+{"version":3,"file":"async_caller.d.cts","names":[],"sources":["../../src/utils/async_caller.ts"],"mappings":";KAiCK;KAEA;EACH,QAAQ;EACR;EACA;;iBA8Ic,kBACd;iBAyBc,uBACd,iBACC;KAgHS,wBAAwB;UAEnB;;;;;EAKf;;;;;EAKA;;;;;;EAMA,kBAAkB;;UAGH;EACf,SAAS;;;;;;;;;;;;;;;cAgBE;YACD,gBAAgB;YAEhB,YAAY;YAEZ,iBAAiB;UAEnB;EAER,YAAY,QAAQ;EAad,KAAK,iBAAiB,cAAc,MAAM,MAAM,cACpD,UAAU,MACP,MAAM,WAAW,KACnB,QAAQ,QAAQ,WAAW;EA0B9B,gBAAgB,iBAAiB,cAAc,MAAM,MAAM,cACzD,SAAS,wBACT,UAAU,MACP,MAAM,WAAW,KACnB,QAAQ,QAAQ,WAAW;EAsB9B,SAAS,MAAM,kBAAkB,SAAS,kBAAkB"}

package/dist/utils/async_caller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async_caller.d.ts","names":[],"sources":["../../src/utils/async_caller.ts"],"mappings":";KAiCK,eAAA;AAAA,KAEA,uBAAA;EACH,MAAA,EAAQ,eAAA;EACR,YAAA;EACA,MAAA;AAAA;AAAA,iBA8Ic,iBAAA,CACd,WAAA;AAAA,iBAyBc,sBAAA,CACd,KAAA,YACC,uBAAA;AAAA,KAgHS,oBAAA,IAAwB,KAAA;AAAA,UAEnB,iBAAA;EA9Rf;;;;EAmSA,cAAA;EAjSM;AA8IR;;;EAwJE,UAAA;EAvJsC;AAyBxC;;;;EAoIE,eAAA,GAAkB,oBAAA;AAAA;AAAA,UAGH,sBAAA;EACf,MAAA,GAAS,WAAA;AAAA;;AApBX;;;;;;;;;;AAmBA;;cAiBa,WAAA;EAAA,UACD,cAAA,EAAgB,iBAAA;EAAA,UAEhB,UAAA,EAAY,iBAAA;EAAA,UAEZ,eAAA,EAAiB,iBAAA;EAAA,QAEnB,KAAA;EAER,WAAA,CAAY,MAAA,EAAQ,iBAAA;EAad,IAAA,gCAAoC,IAAA,EAAM,CAAA,KAAM,OAAA,MAAA,CACpD,QAAA,EAAU,CAAA,KACP,IAAA,EAAM,UAAA,CAAW,CAAA,IACnB,OAAA,CAAQ,OAAA,CAAQ,UAAA,CAAW,CAAA;EA0B9B,eAAA,gCAA+C,IAAA,EAAM,CAAA,KAAM,OAAA,MAAA,CACzD,OAAA,EAAS,sBAAA,EACT,QAAA,EAAU,CAAA,KACP,IAAA,EAAM,UAAA,CAAW,CAAA,IACnB,OAAA,CAAQ,OAAA,CAAQ,UAAA,CAAW,CAAA;EAsB9B,KAAA,CAAA,GAAS,IAAA,EAAM,UAAA,QAAkB,KAAA,IAAS,UAAA,QAAkB,KAAA;AAAA"}
+{"version":3,"file":"async_caller.d.ts","names":[],"sources":["../../src/utils/async_caller.ts"],"mappings":";KAiCK;KAEA;EACH,QAAQ;EACR;EACA;;iBA8Ic,kBACd;iBAyBc,uBACd,iBACC;KAgHS,wBAAwB;UAEnB;;;;;EAKf;;;;;EAKA;;;;;;EAMA,kBAAkB;;UAGH;EACf,SAAS;;;;;;;;;;;;;;;cAgBE;YACD,gBAAgB;YAEhB,YAAY;YAEZ,iBAAiB;UAEnB;EAER,YAAY,QAAQ;EAad,KAAK,iBAAiB,cAAc,MAAM,MAAM,cACpD,UAAU,MACP,MAAM,WAAW,KACnB,QAAQ,QAAQ,WAAW;EA0B9B,gBAAgB,iBAAiB,cAAc,MAAM,MAAM,cACzD,SAAS,wBACT,UAAU,MACP,MAAM,WAAW,KACnB,QAAQ,QAAQ,WAAW;EAsB9B,SAAS,MAAM,kBAAkB,SAAS,kBAAkB"}

package/dist/utils/async_caller.js.map

@@ -1 +1 @@
-{"version":3,"file":"async_caller.js","names":[],"sources":["../../src/utils/async_caller.ts"],"sourcesContent":["import PQueueMod from \"p-queue\";\n\nimport { getAbortSignalError } from \"./signal.js\";\nimport pRetry from \"./p-retry/index.js\";\n\nconst STATUS_NO_RETRY = [\n  400, // Bad Request\n  401, // Unauthorized\n  402, // Payment Required\n  403, // Forbidden\n  404, // Not Found\n  405, // Method Not Allowed\n  406, // Not Acceptable\n  407, // Proxy Authentication Required\n  409, // Conflict\n];\n\nconst RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS = 60_000;\n\nconst QUOTA_EXHAUSTED_MESSAGE_PATTERNS = [\n  /insufficient[_ -]?quota/i,\n  /exceeded (?:your|the current|the available).+quota/i,\n  /usage quota/i,\n  /quota (?:has been )?exhausted/i,\n  /billing/i,\n  /credit balance/i,\n  /out of credits/i,\n  /will reset at/i,\n];\n\nconst RETRY_AFTER_MESSAGE_PATTERN =\n  /(?:try again in|retry after)\\s+(\\d+(?:\\.\\d+)?)\\s*(milliseconds?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h)\\b/i;\n\ntype RateLimitAction = \"wait\" | \"capacity\" | \"stop\";\n\ntype RateLimitClassification = {\n  action: RateLimitAction;\n  retryAfterMs?: number;\n  reason: string;\n};\n\nfunction getResponseStatus(error: unknown): number | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"response\" in error &&\n    typeof error.response === \"object\" &&\n    error.response !== null &&\n    \"status\" in error.response &&\n    typeof error.response.status === \"number\"\n    ? error.response.status\n    : undefined;\n}\n\nfunction getDirectStatus(error: unknown): number | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"status\" in error && typeof error.status === \"number\") {\n    return error.status;\n  }\n\n  if (\"statusCode\" in error && typeof error.statusCode === \"number\") {\n    return error.statusCode;\n  }\n\n  return undefined;\n}\n\nfunction getErrorMessage(error: unknown): string | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof error.message === \"string\"\n    ? error.message\n    : undefined;\n}\n\nfunction getErrorCode(error: unknown): string | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"code\" in error && typeof error.code === \"string\") {\n    return error.code;\n  }\n\n  return \"error\" in error &&\n    typeof error.error === \"object\" &&\n    error.error !== null &&\n    \"code\" in error.error &&\n    typeof error.error.code === \"string\"\n    ? error.error.code\n    : undefined;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction _getRetryAfterHeader(error: any): string | null | undefined {\n  if (error?.headers) {\n    if (typeof error.headers.get === \"function\") {\n      return error.headers.get(\"retry-after\");\n    }\n    return error.headers[\"retry-after\"] ?? error.headers[\"Retry-After\"];\n  }\n\n  if (error?.response?.headers) {\n    if (typeof error.response.headers.get === \"function\") {\n      return error.response.headers.get(\"retry-after\");\n    }\n    return (\n      error.response.headers[\"retry-after\"] ??\n      error.response.headers[\"Retry-After\"]\n    );\n  }\n\n  return undefined;\n}\n\nfunction parseRetryAfterFromMessageMs(\n  message: string | undefined\n): number | undefined {\n  if (message == null) {\n    return undefined;\n  }\n\n  const match = RETRY_AFTER_MESSAGE_PATTERN.exec(message);\n  if (!match) {\n    return undefined;\n  }\n\n  const rawValue = Number(match[1]);\n  const unit = match[2]?.toLowerCase();\n  if (Number.isNaN(rawValue) || !unit) {\n    return undefined;\n  }\n\n  if (unit === \"ms\" || unit.startsWith(\"millisecond\")) {\n    return rawValue;\n  }\n\n  if (unit === \"m\" || unit.startsWith(\"min\")) {\n    return rawValue * 60_000;\n  }\n\n  if (unit === \"h\" || unit.startsWith(\"hr\") || unit.startsWith(\"hour\")) {\n    return rawValue * 3_600_000;\n  }\n\n  return rawValue * 1000;\n}\n\nfunction coerceError(error: unknown, fallbackMessage: string): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  const coerced = new Error(fallbackMessage);\n  if (typeof error === \"object\" && error !== null) {\n    Object.assign(coerced, error);\n  }\n  return coerced;\n}\n\nfunction setRateLimitMetadata(\n  error: unknown,\n  classification: RateLimitClassification\n) {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  const mutableError = error as Record<string, unknown>;\n  mutableError.rateLimitType = classification.action;\n  mutableError.rateLimitReason = classification.reason;\n\n  if (classification.retryAfterMs !== undefined) {\n    mutableError.retryAfterMs = classification.retryAfterMs;\n  }\n}\n\nexport function parseRetryAfterMs(\n  headerValue: string | null | undefined\n): number | undefined {\n  if (headerValue == null) {\n    return undefined;\n  }\n\n  const trimmed = headerValue.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n\n  const seconds = Number(trimmed);\n  if (!Number.isNaN(seconds) && seconds >= 0) {\n    return seconds * 1000;\n  }\n\n  const date = Date.parse(trimmed);\n  if (!Number.isNaN(date)) {\n    const delayMs = date - Date.now();\n    return delayMs > 0 ? delayMs : 0;\n  }\n\n  return undefined;\n}\n\nexport function classifyRateLimitError(\n  error: unknown\n): RateLimitClassification | undefined {\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status !== 429) {\n    return undefined;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    return { action: \"stop\", reason: \"insufficient_quota\" };\n  }\n\n  const message = getErrorMessage(error);\n  if (\n    message &&\n    QUOTA_EXHAUSTED_MESSAGE_PATTERNS.some((pattern) => pattern.test(message))\n  ) {\n    return { action: \"stop\", reason: \"quota_message\" };\n  }\n\n  const retryAfterMs =\n    parseRetryAfterMs(_getRetryAfterHeader(error)) ??\n    parseRetryAfterFromMessageMs(message);\n\n  if (retryAfterMs !== undefined) {\n    if (retryAfterMs <= RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS) {\n      return {\n        action: \"wait\",\n        retryAfterMs,\n        reason: \"retry_after_hint\",\n      };\n    }\n\n    return {\n      action: \"capacity\",\n      retryAfterMs,\n      reason: \"retry_after_too_large\",\n    };\n  }\n\n  return { action: \"capacity\", reason: \"headerless_429\" };\n}\n\n/**\n * The default failed attempt handler for the AsyncCaller.\n * @param error - The error to handle.\n * @returns void\n */\nconst defaultFailedAttemptHandler = (error: unknown) => {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  if (\n    (\"message\" in error &&\n      typeof error.message === \"string\" &&\n      (error.message.startsWith(\"Cancel\") ||\n        error.message.startsWith(\"AbortError\"))) ||\n    (\"name\" in error &&\n      typeof error.name === \"string\" &&\n      error.name === \"AbortError\")\n  ) {\n    throw error;\n  }\n  if (\n    \"code\" in error &&\n    typeof error.code === \"string\" &&\n    error.code === \"ECONNABORTED\"\n  ) {\n    throw error;\n  }\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status && STATUS_NO_RETRY.includes(+status)) {\n    throw error;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Insufficient quota\"\n    );\n    err.name = \"InsufficientQuotaError\";\n    setRateLimitMetadata(err, {\n      action: \"stop\",\n      reason: \"insufficient_quota\",\n    });\n    throw err;\n  }\n\n  const rateLimitClassification = classifyRateLimitError(error);\n  if (rateLimitClassification) {\n    if (rateLimitClassification.action === \"wait\") {\n      setRateLimitMetadata(error, rateLimitClassification);\n      return;\n    }\n\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Rate limit exceeded\"\n    );\n    if (err.name === \"Error\") {\n      err.name =\n        rateLimitClassification.action === \"stop\"\n          ? \"RateLimitQuotaExhaustedError\"\n          : \"RateLimitCapacityError\";\n    }\n    setRateLimitMetadata(err, rateLimitClassification);\n    throw err;\n  }\n};\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport type FailedAttemptHandler = (error: any) => any;\n\nexport interface AsyncCallerParams {\n  /**\n   * The maximum number of concurrent calls that can be made.\n   * Defaults to `Infinity`, which means no limit.\n   */\n  maxConcurrency?: number;\n  /**\n   * The maximum number of retries that can be made for a single call,\n   * with an exponential backoff between each attempt. Defaults to 6.\n   */\n  maxRetries?: number;\n  /**\n   * Custom handler to handle failed attempts. Takes the originally thrown\n   * error object as input, and should itself throw an error if the input\n   * error is not retryable.\n   */\n  onFailedAttempt?: FailedAttemptHandler;\n}\n\nexport interface AsyncCallerCallOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * A class that can be used to make async calls with concurrency and retry logic.\n *\n * This is useful for making calls to any kind of \"expensive\" external resource,\n * be it because it's rate-limited, subject to network issues, etc.\n *\n * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults\n * to `Infinity`. This means that by default, all calls will be made in parallel.\n *\n * Retries are limited by the `maxRetries` parameter, which defaults to 6. This\n * means that by default, each call will be retried up to 6 times, with an\n * exponential backoff between each attempt.\n */\nexport class AsyncCaller {\n  protected maxConcurrency: AsyncCallerParams[\"maxConcurrency\"];\n\n  protected maxRetries: AsyncCallerParams[\"maxRetries\"];\n\n  protected onFailedAttempt: AsyncCallerParams[\"onFailedAttempt\"];\n\n  private queue: (typeof import(\"p-queue\"))[\"default\"][\"prototype\"];\n\n  constructor(params: AsyncCallerParams) {\n    this.maxConcurrency = params.maxConcurrency ?? Infinity;\n    this.maxRetries = params.maxRetries ?? 6;\n    this.onFailedAttempt =\n      params.onFailedAttempt ?? defaultFailedAttemptHandler;\n\n    const PQueue = (\n      \"default\" in PQueueMod ? PQueueMod.default : PQueueMod\n    ) as typeof PQueueMod;\n    this.queue = new PQueue({ concurrency: this.maxConcurrency });\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  async call<A extends any[], T extends (...args: A) => Promise<any>>(\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    return this.queue.add(\n      () =>\n        pRetry(\n          () =>\n            callable(...args).catch((error) => {\n              // oxlint-disable-next-line no-instanceof/no-instanceof\n              if (error instanceof Error) {\n                throw error;\n              } else {\n                throw new Error(error);\n              }\n            }),\n          {\n            onFailedAttempt: ({ error }) => this.onFailedAttempt?.(error),\n            retries: this.maxRetries,\n            randomize: true,\n            // If needed we can change some of the defaults here,\n            // but they're quite sensible.\n          }\n        ),\n      { throwOnTimeout: true }\n    );\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  callWithOptions<A extends any[], T extends (...args: A) => Promise<any>>(\n    options: AsyncCallerCallOptions,\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    // Note this doesn't cancel the underlying request,\n    // when available prefer to use the signal option of the underlying call\n    if (options.signal) {\n      let listener: (() => void) | undefined;\n      return Promise.race([\n        this.call<A, T>(callable, ...args),\n        new Promise<never>((_, reject) => {\n          listener = () => {\n            reject(getAbortSignalError(options.signal));\n          };\n          options.signal?.addEventListener(\"abort\", listener, { once: true });\n        }),\n      ]).finally(() => {\n        if (options.signal && listener) {\n          options.signal.removeEventListener(\"abort\", listener);\n        }\n      });\n    }\n    return this.call<A, T>(callable, ...args);\n  }\n\n  fetch(...args: Parameters<typeof fetch>): ReturnType<typeof fetch> {\n    return this.call(() =>\n      fetch(...args).then((res) => (res.ok ? res : Promise.reject(res)))\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"async_caller.js","names":[],"sources":["../../src/utils/async_caller.ts"],"sourcesContent":["import PQueueMod from \"p-queue\";\n\nimport { getAbortSignalError } from \"./signal.js\";\nimport pRetry from \"./p-retry/index.js\";\n\nconst STATUS_NO_RETRY = [\n  400, // Bad Request\n  401, // Unauthorized\n  402, // Payment Required\n  403, // Forbidden\n  404, // Not Found\n  405, // Method Not Allowed\n  406, // Not Acceptable\n  407, // Proxy Authentication Required\n  409, // Conflict\n];\n\nconst RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS = 60_000;\n\nconst QUOTA_EXHAUSTED_MESSAGE_PATTERNS = [\n  /insufficient[_ -]?quota/i,\n  /exceeded (?:your|the current|the available).+quota/i,\n  /usage quota/i,\n  /quota (?:has been )?exhausted/i,\n  /billing/i,\n  /credit balance/i,\n  /out of credits/i,\n  /will reset at/i,\n];\n\nconst RETRY_AFTER_MESSAGE_PATTERN =\n  /(?:try again in|retry after)\\s+(\\d+(?:\\.\\d+)?)\\s*(milliseconds?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h)\\b/i;\n\ntype RateLimitAction = \"wait\" | \"capacity\" | \"stop\";\n\ntype RateLimitClassification = {\n  action: RateLimitAction;\n  retryAfterMs?: number;\n  reason: string;\n};\n\nfunction getResponseStatus(error: unknown): number | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"response\" in error &&\n    typeof error.response === \"object\" &&\n    error.response !== null &&\n    \"status\" in error.response &&\n    typeof error.response.status === \"number\"\n    ? error.response.status\n    : undefined;\n}\n\nfunction getDirectStatus(error: unknown): number | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"status\" in error && typeof error.status === \"number\") {\n    return error.status;\n  }\n\n  if (\"statusCode\" in error && typeof error.statusCode === \"number\") {\n    return error.statusCode;\n  }\n\n  return undefined;\n}\n\nfunction getErrorMessage(error: unknown): string | undefined {\n  return typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof error.message === \"string\"\n    ? error.message\n    : undefined;\n}\n\nfunction getErrorCode(error: unknown): string | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  if (\"code\" in error && typeof error.code === \"string\") {\n    return error.code;\n  }\n\n  return \"error\" in error &&\n    typeof error.error === \"object\" &&\n    error.error !== null &&\n    \"code\" in error.error &&\n    typeof error.error.code === \"string\"\n    ? error.error.code\n    : undefined;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction _getRetryAfterHeader(error: any): string | null | undefined {\n  if (error?.headers) {\n    if (typeof error.headers.get === \"function\") {\n      return error.headers.get(\"retry-after\");\n    }\n    return error.headers[\"retry-after\"] ?? error.headers[\"Retry-After\"];\n  }\n\n  if (error?.response?.headers) {\n    if (typeof error.response.headers.get === \"function\") {\n      return error.response.headers.get(\"retry-after\");\n    }\n    return (\n      error.response.headers[\"retry-after\"] ??\n      error.response.headers[\"Retry-After\"]\n    );\n  }\n\n  return undefined;\n}\n\nfunction parseRetryAfterFromMessageMs(\n  message: string | undefined\n): number | undefined {\n  if (message == null) {\n    return undefined;\n  }\n\n  const match = RETRY_AFTER_MESSAGE_PATTERN.exec(message);\n  if (!match) {\n    return undefined;\n  }\n\n  const rawValue = Number(match[1]);\n  const unit = match[2]?.toLowerCase();\n  if (Number.isNaN(rawValue) || !unit) {\n    return undefined;\n  }\n\n  if (unit === \"ms\" || unit.startsWith(\"millisecond\")) {\n    return rawValue;\n  }\n\n  if (unit === \"m\" || unit.startsWith(\"min\")) {\n    return rawValue * 60_000;\n  }\n\n  if (unit === \"h\" || unit.startsWith(\"hr\") || unit.startsWith(\"hour\")) {\n    return rawValue * 3_600_000;\n  }\n\n  return rawValue * 1000;\n}\n\nfunction coerceError(error: unknown, fallbackMessage: string): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  const coerced = new Error(fallbackMessage);\n  if (typeof error === \"object\" && error !== null) {\n    Object.assign(coerced, error);\n  }\n  return coerced;\n}\n\nfunction setRateLimitMetadata(\n  error: unknown,\n  classification: RateLimitClassification\n) {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  const mutableError = error as Record<string, unknown>;\n  mutableError.rateLimitType = classification.action;\n  mutableError.rateLimitReason = classification.reason;\n\n  if (classification.retryAfterMs !== undefined) {\n    mutableError.retryAfterMs = classification.retryAfterMs;\n  }\n}\n\nexport function parseRetryAfterMs(\n  headerValue: string | null | undefined\n): number | undefined {\n  if (headerValue == null) {\n    return undefined;\n  }\n\n  const trimmed = headerValue.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n\n  const seconds = Number(trimmed);\n  if (!Number.isNaN(seconds) && seconds >= 0) {\n    return seconds * 1000;\n  }\n\n  const date = Date.parse(trimmed);\n  if (!Number.isNaN(date)) {\n    const delayMs = date - Date.now();\n    return delayMs > 0 ? delayMs : 0;\n  }\n\n  return undefined;\n}\n\nexport function classifyRateLimitError(\n  error: unknown\n): RateLimitClassification | undefined {\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status !== 429) {\n    return undefined;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    return { action: \"stop\", reason: \"insufficient_quota\" };\n  }\n\n  const message = getErrorMessage(error);\n  if (\n    message &&\n    QUOTA_EXHAUSTED_MESSAGE_PATTERNS.some((pattern) => pattern.test(message))\n  ) {\n    return { action: \"stop\", reason: \"quota_message\" };\n  }\n\n  const retryAfterMs =\n    parseRetryAfterMs(_getRetryAfterHeader(error)) ??\n    parseRetryAfterFromMessageMs(message);\n\n  if (retryAfterMs !== undefined) {\n    if (retryAfterMs <= RETRY_AFTER_AUTO_RETRY_THRESHOLD_MS) {\n      return {\n        action: \"wait\",\n        retryAfterMs,\n        reason: \"retry_after_hint\",\n      };\n    }\n\n    return {\n      action: \"capacity\",\n      retryAfterMs,\n      reason: \"retry_after_too_large\",\n    };\n  }\n\n  return { action: \"capacity\", reason: \"headerless_429\" };\n}\n\n/**\n * The default failed attempt handler for the AsyncCaller.\n * @param error - The error to handle.\n * @returns void\n */\nconst defaultFailedAttemptHandler = (error: unknown) => {\n  if (typeof error !== \"object\" || error === null) {\n    return;\n  }\n\n  if (\n    (\"message\" in error &&\n      typeof error.message === \"string\" &&\n      (error.message.startsWith(\"Cancel\") ||\n        error.message.startsWith(\"AbortError\"))) ||\n    (\"name\" in error &&\n      typeof error.name === \"string\" &&\n      error.name === \"AbortError\")\n  ) {\n    throw error;\n  }\n  if (\n    \"code\" in error &&\n    typeof error.code === \"string\" &&\n    error.code === \"ECONNABORTED\"\n  ) {\n    throw error;\n  }\n  const status = getResponseStatus(error) ?? getDirectStatus(error);\n  if (status && STATUS_NO_RETRY.includes(+status)) {\n    throw error;\n  }\n\n  const code = getErrorCode(error);\n  if (code === \"insufficient_quota\") {\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Insufficient quota\"\n    );\n    err.name = \"InsufficientQuotaError\";\n    setRateLimitMetadata(err, {\n      action: \"stop\",\n      reason: \"insufficient_quota\",\n    });\n    throw err;\n  }\n\n  const rateLimitClassification = classifyRateLimitError(error);\n  if (rateLimitClassification) {\n    if (rateLimitClassification.action === \"wait\") {\n      setRateLimitMetadata(error, rateLimitClassification);\n      return;\n    }\n\n    const err = coerceError(\n      error,\n      getErrorMessage(error) ?? \"Rate limit exceeded\"\n    );\n    if (err.name === \"Error\") {\n      err.name =\n        rateLimitClassification.action === \"stop\"\n          ? \"RateLimitQuotaExhaustedError\"\n          : \"RateLimitCapacityError\";\n    }\n    setRateLimitMetadata(err, rateLimitClassification);\n    throw err;\n  }\n};\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nexport type FailedAttemptHandler = (error: any) => any;\n\nexport interface AsyncCallerParams {\n  /**\n   * The maximum number of concurrent calls that can be made.\n   * Defaults to `Infinity`, which means no limit.\n   */\n  maxConcurrency?: number;\n  /**\n   * The maximum number of retries that can be made for a single call,\n   * with an exponential backoff between each attempt. Defaults to 6.\n   */\n  maxRetries?: number;\n  /**\n   * Custom handler to handle failed attempts. Takes the originally thrown\n   * error object as input, and should itself throw an error if the input\n   * error is not retryable.\n   */\n  onFailedAttempt?: FailedAttemptHandler;\n}\n\nexport interface AsyncCallerCallOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * A class that can be used to make async calls with concurrency and retry logic.\n *\n * This is useful for making calls to any kind of \"expensive\" external resource,\n * be it because it's rate-limited, subject to network issues, etc.\n *\n * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults\n * to `Infinity`. This means that by default, all calls will be made in parallel.\n *\n * Retries are limited by the `maxRetries` parameter, which defaults to 6. This\n * means that by default, each call will be retried up to 6 times, with an\n * exponential backoff between each attempt.\n */\nexport class AsyncCaller {\n  protected maxConcurrency: AsyncCallerParams[\"maxConcurrency\"];\n\n  protected maxRetries: AsyncCallerParams[\"maxRetries\"];\n\n  protected onFailedAttempt: AsyncCallerParams[\"onFailedAttempt\"];\n\n  private queue: (typeof import(\"p-queue\"))[\"default\"][\"prototype\"];\n\n  constructor(params: AsyncCallerParams) {\n    this.maxConcurrency = params.maxConcurrency ?? Infinity;\n    this.maxRetries = params.maxRetries ?? 6;\n    this.onFailedAttempt =\n      params.onFailedAttempt ?? defaultFailedAttemptHandler;\n\n    const PQueue = (\n      \"default\" in PQueueMod ? PQueueMod.default : PQueueMod\n    ) as typeof PQueueMod;\n    this.queue = new PQueue({ concurrency: this.maxConcurrency });\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  async call<A extends any[], T extends (...args: A) => Promise<any>>(\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    return this.queue.add(\n      () =>\n        pRetry(\n          () =>\n            callable(...args).catch((error) => {\n              // oxlint-disable-next-line no-instanceof/no-instanceof\n              if (error instanceof Error) {\n                throw error;\n              } else {\n                throw new Error(error);\n              }\n            }),\n          {\n            onFailedAttempt: ({ error }) => this.onFailedAttempt?.(error),\n            retries: this.maxRetries,\n            randomize: true,\n            // If needed we can change some of the defaults here,\n            // but they're quite sensible.\n          }\n        ),\n      { throwOnTimeout: true }\n    );\n  }\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  callWithOptions<A extends any[], T extends (...args: A) => Promise<any>>(\n    options: AsyncCallerCallOptions,\n    callable: T,\n    ...args: Parameters<T>\n  ): Promise<Awaited<ReturnType<T>>> {\n    // Note this doesn't cancel the underlying request,\n    // when available prefer to use the signal option of the underlying call\n    if (options.signal) {\n      let listener: (() => void) | undefined;\n      return Promise.race([\n        this.call<A, T>(callable, ...args),\n        new Promise<never>((_, reject) => {\n          listener = () => {\n            reject(getAbortSignalError(options.signal));\n          };\n          options.signal?.addEventListener(\"abort\", listener, { once: true });\n        }),\n      ]).finally(() => {\n        if (options.signal && listener) {\n          options.signal.removeEventListener(\"abort\", listener);\n        }\n      });\n    }\n    return this.call<A, T>(callable, ...args);\n  }\n\n  fetch(...args: Parameters<typeof fetch>): ReturnType<typeof fetch> {\n    return this.call(() =>\n      fetch(...args).then((res) => (res.ok ? res : Promise.reject(res)))\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/utils/callbacks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"callbacks.cjs","names":["getEnvironmentVariable"],"sources":["../../src/utils/callbacks.ts"],"sourcesContent":["import { getEnvironmentVariable } from \"./env.js\";\n\nexport const isTracingEnabled = (tracingEnabled?: boolean): boolean => {\n  if (tracingEnabled !== undefined) {\n    return tracingEnabled;\n  }\n  const envVars = [\n    \"LANGSMITH_TRACING_V2\",\n    \"LANGCHAIN_TRACING_V2\",\n    \"LANGSMITH_TRACING\",\n    \"LANGCHAIN_TRACING\",\n  ];\n  return !!envVars.find((envVar) => getEnvironmentVariable(envVar) === \"true\");\n};\n"],"mappings":";;AAEA,MAAa,oBAAoB,mBAAsC;AACrE,KAAI,mBAAmB,KAAA,EACrB,QAAO;AAQT,QAAO,CAAC,CAAC;EALP;EACA;EACA;EACA;EAEc,CAAC,MAAM,WAAWA,kBAAAA,uBAAuB,OAAO,KAAK,OAAO"}
+{"version":3,"file":"callbacks.cjs","names":["getEnvironmentVariable"],"sources":["../../src/utils/callbacks.ts"],"sourcesContent":["import { getEnvironmentVariable } from \"./env.js\";\n\nexport const isTracingEnabled = (tracingEnabled?: boolean): boolean => {\n  if (tracingEnabled !== undefined) {\n    return tracingEnabled;\n  }\n  const envVars = [\n    \"LANGSMITH_TRACING_V2\",\n    \"LANGCHAIN_TRACING_V2\",\n    \"LANGSMITH_TRACING\",\n    \"LANGCHAIN_TRACING\",\n  ];\n  return !!envVars.find((envVar) => getEnvironmentVariable(envVar) === \"true\");\n};\n"],"mappings":";;AAEA,MAAa,oBAAoB,mBAAsC;CACrE,IAAI,mBAAmB,KAAA,GACrB,OAAO;CAQT,OAAO,CAAC,CAAC;EALP;EACA;EACA;EACA;CAEa,CAAC,CAAC,MAAM,WAAWA,kBAAAA,uBAAuB,MAAM,MAAM,MAAM;AAC7E"}

package/dist/utils/callbacks.js.map

@@ -1 +1 @@
-{"version":3,"file":"callbacks.js","names":[],"sources":["../../src/utils/callbacks.ts"],"sourcesContent":["import { getEnvironmentVariable } from \"./env.js\";\n\nexport const isTracingEnabled = (tracingEnabled?: boolean): boolean => {\n  if (tracingEnabled !== undefined) {\n    return tracingEnabled;\n  }\n  const envVars = [\n    \"LANGSMITH_TRACING_V2\",\n    \"LANGCHAIN_TRACING_V2\",\n    \"LANGSMITH_TRACING\",\n    \"LANGCHAIN_TRACING\",\n  ];\n  return !!envVars.find((envVar) => getEnvironmentVariable(envVar) === \"true\");\n};\n"],"mappings":";;AAEA,MAAa,oBAAoB,mBAAsC;AACrE,KAAI,mBAAmB,KAAA,EACrB,QAAO;AAQT,QAAO,CAAC,CAAC;EALP;EACA;EACA;EACA;EAEc,CAAC,MAAM,WAAW,uBAAuB,OAAO,KAAK,OAAO"}
+{"version":3,"file":"callbacks.js","names":[],"sources":["../../src/utils/callbacks.ts"],"sourcesContent":["import { getEnvironmentVariable } from \"./env.js\";\n\nexport const isTracingEnabled = (tracingEnabled?: boolean): boolean => {\n  if (tracingEnabled !== undefined) {\n    return tracingEnabled;\n  }\n  const envVars = [\n    \"LANGSMITH_TRACING_V2\",\n    \"LANGCHAIN_TRACING_V2\",\n    \"LANGSMITH_TRACING\",\n    \"LANGCHAIN_TRACING\",\n  ];\n  return !!envVars.find((envVar) => getEnvironmentVariable(envVar) === \"true\");\n};\n"],"mappings":";;AAEA,MAAa,oBAAoB,mBAAsC;CACrE,IAAI,mBAAmB,KAAA,GACrB,OAAO;CAQT,OAAO,CAAC,CAAC;EALP;EACA;EACA;EACA;CAEa,CAAC,CAAC,MAAM,WAAW,uBAAuB,MAAM,MAAM,MAAM;AAC7E"}

package/dist/utils/chunk_array.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_array.cjs","names":[],"sources":["../../src/utils/chunk_array.ts"],"sourcesContent":["export const chunkArray = <T>(arr: T[], chunkSize: number) =>\n  arr.reduce((chunks, elem, index) => {\n    const chunkIndex = Math.floor(index / chunkSize);\n    const chunk = chunks[chunkIndex] || [];\n    chunks[chunkIndex] = chunk.concat([elem]);\n    return chunks;\n  }, [] as T[][]);\n"],"mappings":";;;AAAA,MAAa,cAAiB,KAAU,cACtC,IAAI,QAAQ,QAAQ,MAAM,UAAU;CAClC,MAAM,aAAa,KAAK,MAAM,QAAQ,UAAU;AAEhD,QAAO,eADO,OAAO,eAAe,EAAE,EACX,OAAO,CAAC,KAAK,CAAC;AACzC,QAAO;GACN,EAAE,CAAU"}
+{"version":3,"file":"chunk_array.cjs","names":[],"sources":["../../src/utils/chunk_array.ts"],"sourcesContent":["export const chunkArray = <T>(arr: T[], chunkSize: number) =>\n  arr.reduce((chunks, elem, index) => {\n    const chunkIndex = Math.floor(index / chunkSize);\n    const chunk = chunks[chunkIndex] || [];\n    chunks[chunkIndex] = chunk.concat([elem]);\n    return chunks;\n  }, [] as T[][]);\n"],"mappings":";;;AAAA,MAAa,cAAiB,KAAU,cACtC,IAAI,QAAQ,QAAQ,MAAM,UAAU;CAClC,MAAM,aAAa,KAAK,MAAM,QAAQ,SAAS;CAE/C,OAAO,eADO,OAAO,eAAe,CAAC,EAAA,CACV,OAAO,CAAC,IAAI,CAAC;CACxC,OAAO;AACT,GAAG,CAAC,CAAU"}

package/dist/utils/chunk_array.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_array.d.cts","names":[],"sources":["../../src/utils/chunk_array.ts"],"mappings":";cAAa,UAAA,MAAe,GAAA,EAAO,CAAA,IAAG,SAAA,aAAmB,CAAA"}
+{"version":3,"file":"chunk_array.d.cts","names":[],"sources":["../../src/utils/chunk_array.ts"],"mappings":";cAAa,aAAc,GAAC,KAAO,KAAG,sBAAmB"}

package/dist/utils/chunk_array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_array.d.ts","names":[],"sources":["../../src/utils/chunk_array.ts"],"mappings":";cAAa,UAAA,MAAe,GAAA,EAAO,CAAA,IAAG,SAAA,aAAmB,CAAA"}
+{"version":3,"file":"chunk_array.d.ts","names":[],"sources":["../../src/utils/chunk_array.ts"],"mappings":";cAAa,aAAc,GAAC,KAAO,KAAG,sBAAmB"}

package/dist/utils/chunk_array.js.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_array.js","names":[],"sources":["../../src/utils/chunk_array.ts"],"sourcesContent":["export const chunkArray = <T>(arr: T[], chunkSize: number) =>\n  arr.reduce((chunks, elem, index) => {\n    const chunkIndex = Math.floor(index / chunkSize);\n    const chunk = chunks[chunkIndex] || [];\n    chunks[chunkIndex] = chunk.concat([elem]);\n    return chunks;\n  }, [] as T[][]);\n"],"mappings":";;;AAAA,MAAa,cAAiB,KAAU,cACtC,IAAI,QAAQ,QAAQ,MAAM,UAAU;CAClC,MAAM,aAAa,KAAK,MAAM,QAAQ,UAAU;AAEhD,QAAO,eADO,OAAO,eAAe,EAAE,EACX,OAAO,CAAC,KAAK,CAAC;AACzC,QAAO;GACN,EAAE,CAAU"}
+{"version":3,"file":"chunk_array.js","names":[],"sources":["../../src/utils/chunk_array.ts"],"sourcesContent":["export const chunkArray = <T>(arr: T[], chunkSize: number) =>\n  arr.reduce((chunks, elem, index) => {\n    const chunkIndex = Math.floor(index / chunkSize);\n    const chunk = chunks[chunkIndex] || [];\n    chunks[chunkIndex] = chunk.concat([elem]);\n    return chunks;\n  }, [] as T[][]);\n"],"mappings":";;;AAAA,MAAa,cAAiB,KAAU,cACtC,IAAI,QAAQ,QAAQ,MAAM,UAAU;CAClC,MAAM,aAAa,KAAK,MAAM,QAAQ,SAAS;CAE/C,OAAO,eADO,OAAO,eAAe,CAAC,EAAA,CACV,OAAO,CAAC,IAAI,CAAC;CACxC,OAAO;AACT,GAAG,CAAC,CAAU"}