@agent-inspect/langchain 6.31.35 → 6.31.36

package/dist/index.cjs

@@ -1,1995 +0,0 @@
-'use strict';
-
-var path = require('path');
-var base = require('@langchain/core/callbacks/base');
-var advanced = require('agent-inspect/advanced');
-var logs = require('agent-inspect/logs');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var path__default = /*#__PURE__*/_interopDefault(path);
-
-// packages/langchain/src/agent-inspect-callback.ts
-function isRecord(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-function num(v) {
-  if (typeof v === "number" && Number.isFinite(v)) return v;
-  if (typeof v === "string" && v.trim() !== "") {
-    const n = Number(v);
-    if (Number.isFinite(n)) return n;
-  }
-  return void 0;
-}
-function normalizeTokenShape(raw) {
-  const input = num(raw.promptTokens) ?? num(raw.inputTokens) ?? num(raw.input_tokens) ?? num(raw.prompt_tokens);
-  const output = num(raw.completionTokens) ?? num(raw.outputTokens) ?? num(raw.output_tokens) ?? num(raw.completion_tokens);
-  let total = num(raw.totalTokens) ?? num(raw.total_tokens);
-  if (total === void 0 && input !== void 0 && output !== void 0) {
-    total = input + output;
-  }
-  const inputDetails = isRecord(raw.input_token_details) ? raw.input_token_details : isRecord(raw.inputTokenDetails) ? raw.inputTokenDetails : void 0;
-  const outputDetails = isRecord(raw.output_token_details) ? raw.output_token_details : isRecord(raw.outputTokenDetails) ? raw.outputTokenDetails : void 0;
-  const cached = num(raw.cached) ?? num(raw.cache_read) ?? num(raw.cacheRead) ?? (inputDetails ? num(inputDetails.cache_read) ?? num(inputDetails.cacheRead) : void 0);
-  const cacheWrite = num(raw.cacheWrite) ?? num(raw.cache_write) ?? num(raw.cache_creation) ?? (inputDetails ? num(inputDetails.cache_creation) ?? num(inputDetails.cache_write) ?? num(inputDetails.cacheWrite) : void 0);
-  const reasoning = num(raw.reasoning) ?? num(raw.reasoning_tokens) ?? (outputDetails ? num(outputDetails.reasoning) ?? num(outputDetails.reasoning_tokens) : void 0);
-  if (input === void 0 && output === void 0 && total === void 0 && cached === void 0 && cacheWrite === void 0 && reasoning === void 0) {
-    return void 0;
-  }
-  const out = {};
-  if (input !== void 0) out.input = input;
-  if (output !== void 0) out.output = output;
-  if (total !== void 0) out.total = total;
-  if (cached !== void 0) out.cached = cached;
-  if (cacheWrite !== void 0) out.cacheWrite = cacheWrite;
-  if (reasoning !== void 0) out.reasoning = reasoning;
-  return out;
-}
-function extractTokenUsage(output) {
-  try {
-    if (!isRecord(output)) return void 0;
-    const candidates = [
-      isRecord(output.llmOutput) ? output.llmOutput.tokenUsage : void 0,
-      isRecord(output.llmOutput) ? output.llmOutput.estimatedTokenUsage : void 0,
-      output.usage_metadata,
-      isRecord(output.response_metadata) ? output.response_metadata.tokenUsage : void 0,
-      isRecord(output.response_metadata) ? output.response_metadata.token_usage : void 0
-    ];
-    for (const c of candidates) {
-      if (!isRecord(c)) continue;
-      const norm = normalizeTokenShape(c);
-      if (norm) return norm;
-    }
-    return void 0;
-  } catch {
-    return void 0;
-  }
-}
-function readLcKwargs(serializedOrOutput) {
-  if (!isRecord(serializedOrOutput)) return void 0;
-  const lc = serializedOrOutput.lc_kwargs ?? serializedOrOutput.kwargs;
-  return isRecord(lc) ? lc : void 0;
-}
-function extractModelName(serializedOrOutput) {
-  try {
-    const lc = readLcKwargs(serializedOrOutput);
-    const fromLc = lc?.model ?? lc?.modelName ?? lc?.model_name;
-    if (typeof fromLc === "string" && fromLc.trim()) return fromLc;
-    if (isRecord(serializedOrOutput)) {
-      for (const k of ["model", "modelName", "model_name"]) {
-        const v = serializedOrOutput[k];
-        if (typeof v === "string" && v.trim()) return v;
-      }
-      const rm = serializedOrOutput.response_metadata;
-      if (isRecord(rm)) {
-        const m = rm.model_name ?? rm.model;
-        if (typeof m === "string" && m.trim()) return m;
-      }
-      const lo = serializedOrOutput.llmOutput;
-      if (isRecord(lo)) {
-        const m = lo.model_name;
-        if (typeof m === "string" && m.trim()) return m;
-      }
-    }
-    return void 0;
-  } catch {
-    return void 0;
-  }
-}
-function safePreview(value, maxChars) {
-  return advanced.serializeAdapterPreview(value, maxChars);
-}
-var MAX_METADATA_KEYS = 40;
-var LANGGRAPH_ALIASES = [
-  { out: "graphId", aliases: ["graphId", "graph_id", "langgraph_graph_id"] },
-  { out: "graphName", aliases: ["graphName", "graph_name", "langgraph_graph_name"] },
-  { out: "nodeId", aliases: ["nodeId", "node_id", "langgraph_node_id"] },
-  { out: "nodeName", aliases: ["nodeName", "node_name", "langgraph_node"] },
-  { out: "subgraphId", aliases: ["subgraphId", "subgraph_id", "langgraph_subgraph_id"] },
-  { out: "subgraphName", aliases: ["subgraphName", "subgraph_name", "langgraph_subgraph"] },
-  { out: "taskId", aliases: ["taskId", "task_id", "langgraph_task_id"] },
-  { out: "taskName", aliases: ["taskName", "task_name", "langgraph_task"] },
-  { out: "graphStep", aliases: ["graphStep", "graph_step", "langgraph_step"] },
-  { out: "streamMode", aliases: ["streamMode", "stream_mode", "langgraph_stream_mode"] },
-  { out: "branch", aliases: ["branch", "branchName", "branch_name", "langgraph_branch"] },
-  { out: "branchPath", aliases: ["branchPath", "branch_path", "langgraph_path"] },
-  { out: "branchIndex", aliases: ["branchIndex", "branch_index", "langgraph_branch_index"] },
-  {
-    out: "parallelGroupId",
-    aliases: ["parallelGroupId", "parallel_group_id", "langgraph_parallel_group_id"]
-  },
-  { out: "checkpointId", aliases: ["checkpointId", "checkpoint_id", "langgraph_checkpoint_id"] },
-  {
-    out: "checkpointNamespace",
-    aliases: ["checkpointNamespace", "checkpoint_ns", "langgraph_checkpoint_ns"]
-  },
-  { out: "threadId", aliases: ["threadId", "thread_id", "langgraph_thread_id"] },
-  { out: "sessionId", aliases: ["sessionId", "session_id", "langgraph_session_id"] },
-  { out: "retryAttempt", aliases: ["retryAttempt", "retry_attempt", "attempt"] },
-  { out: "handoffFrom", aliases: ["handoffFrom", "handoff_from", "langgraph_handoff_from"] },
-  { out: "handoffTo", aliases: ["handoffTo", "handoff_to", "langgraph_handoff_to"] }
-];
-var LANGGRAPH_SUMMARY_ALIASES = [
-  { out: "checkpointSummary", aliases: ["checkpoint", "langgraph_checkpoint"] },
-  { out: "branchSummary", aliases: ["branches", "langgraph_branches", "langgraph_triggers"] },
-  { out: "subgraphSummary", aliases: ["subgraphs", "langgraph_subgraphs"] },
-  { out: "taskSummary", aliases: ["tasks", "langgraph_tasks"] }
-];
-function boundedValue(value) {
-  if (value === null) return null;
-  if (typeof value === "string") return value.length <= 200 ? value : `${value.slice(0, 200)}\u2026`;
-  if (typeof value === "number" || typeof value === "boolean") return value;
-  if (typeof value === "bigint") return value.toString();
-  if (Array.isArray(value)) {
-    const items = value.slice(0, 10).map((item) => {
-      if (item === null) return null;
-      if (typeof item === "string" || typeof item === "number" || typeof item === "boolean") {
-        return item;
-      }
-      if (typeof item === "bigint") return item.toString();
-      return summarizeValue(item);
-    });
-    return {
-      type: "array",
-      itemCount: value.length,
-      items,
-      truncated: value.length > items.length ? true : void 0
-    };
-  }
-  return summarizeValue(value);
-}
-function summarizeValue(value) {
-  if (Array.isArray(value)) return { type: "array", itemCount: value.length };
-  if (isRecord(value)) return { type: "object", keyCount: Object.keys(value).length };
-  return { type: typeof value };
-}
-function getAliasValue(sources, aliases) {
-  for (const source of sources) {
-    for (const alias of aliases) {
-      if (Object.prototype.hasOwnProperty.call(source, alias)) {
-        return source[alias];
-      }
-    }
-  }
-  return void 0;
-}
-function toPlainMetadata(value) {
-  try {
-    if (!isRecord(value)) return {};
-    const out = {};
-    let n = 0;
-    for (const [k, v] of Object.entries(value)) {
-      if (n >= MAX_METADATA_KEYS) break;
-      if (typeof v === "function" || typeof v === "symbol") continue;
-      if (v === null || typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
-        out[k] = v;
-        n++;
-        continue;
-      }
-      if (typeof v === "bigint") {
-        out[k] = v.toString();
-        n++;
-        continue;
-      }
-      if (Array.isArray(v)) {
-        out[k] = `array(${v.length})`;
-        n++;
-        continue;
-      }
-      if (isRecord(v)) {
-        out[k] = "[object]";
-        n++;
-        continue;
-      }
-      out[k] = String(v);
-      n++;
-    }
-    return out;
-  } catch {
-    return {};
-  }
-}
-function extractLangGraphMetadata(value) {
-  try {
-    if (!isRecord(value)) return void 0;
-    const sources = [value];
-    for (const key of ["langgraph", "configurable"]) {
-      const nested = value[key];
-      if (isRecord(nested)) sources.push(nested);
-    }
-    const langGraph = value.langgraph;
-    if (isRecord(langGraph)) {
-      const configurable = langGraph.configurable;
-      if (isRecord(configurable)) sources.push(configurable);
-      const nestedConfig = langGraph.config;
-      if (isRecord(nestedConfig) && isRecord(nestedConfig.configurable)) {
-        sources.push(nestedConfig.configurable);
-      }
-    }
-    const config = value.config;
-    if (isRecord(config) && isRecord(config.configurable)) {
-      sources.push(config.configurable);
-    }
-    const out = {};
-    for (const { out: outKey, aliases } of LANGGRAPH_ALIASES) {
-      const raw = getAliasValue(sources, aliases);
-      if (raw !== void 0) out[outKey] = boundedValue(raw);
-    }
-    for (const { out: outKey, aliases } of LANGGRAPH_SUMMARY_ALIASES) {
-      const raw = getAliasValue(sources, aliases);
-      if (raw !== void 0) out[outKey] = summarizeValue(raw);
-    }
-    return Object.keys(out).length > 0 ? out : void 0;
-  } catch {
-    return void 0;
-  }
-}
-
-// packages/langchain/src/streaming-metadata.ts
-function createLlmStreamState() {
-  return {
-    chunkCount: 0,
-    streamedCharCount: 0,
-    previewChars: "",
-    previewTruncated: false
-  };
-}
-function recordLlmStreamToken(state, token, now, maxPreviewChars) {
-  state.chunkCount += 1;
-  if (state.firstChunkAt === void 0) {
-    state.firstChunkAt = now;
-  }
-  state.lastChunkAt = now;
-  if (typeof token === "string" && token.length > 0) {
-    state.streamedCharCount += token.length;
-    if (maxPreviewChars > 0) {
-      const remaining = maxPreviewChars - state.previewChars.length;
-      if (remaining > 0) {
-        const slice = token.slice(0, remaining);
-        state.previewChars += slice;
-        if (token.length > remaining) {
-          state.previewTruncated = true;
-        }
-      } else {
-        state.previewTruncated = true;
-      }
-    }
-  }
-}
-function streamMetadataFromState(state, options) {
-  if (!state || state.chunkCount === 0) {
-    return void 0;
-  }
-  const out = {
-    stream: true,
-    chunkCount: state.chunkCount,
-    streamedCharCount: state.streamedCharCount
-  };
-  if (state.firstChunkAt !== void 0) {
-    out.firstChunkAt = state.firstChunkAt;
-  }
-  if (state.lastChunkAt !== void 0) {
-    out.lastChunkAt = state.lastChunkAt;
-  }
-  if (state.firstChunkAt !== void 0 && state.lastChunkAt !== void 0 && state.lastChunkAt >= state.firstChunkAt) {
-    out.streamDurationMs = state.lastChunkAt - state.firstChunkAt;
-  }
-  if (state.previewTruncated) {
-    out.previewTruncated = true;
-  }
-  if (options.capturePreview && state.previewChars.length > 0) {
-    const preview = state.previewChars.length <= options.maxPreviewChars ? state.previewChars : `${state.previewChars.slice(0, options.maxPreviewChars)}\u2026`;
-    out.streamPreview = preview;
-    if (state.previewChars.length > options.maxPreviewChars) {
-      out.previewTruncated = true;
-    }
-  }
-  return out;
-}
-
-// packages/langchain/src/tool-identity.ts
-function serializedLabel(s) {
-  if (typeof s.name === "string" && s.name.trim()) return s.name.trim();
-  if (Array.isArray(s.id) && s.id.length > 0) {
-    const last = s.id[s.id.length - 1];
-    if (typeof last === "string" && last.trim()) return last.trim();
-  }
-  return typeof s.type === "string" && s.type.trim() ? s.type.trim() : void 0;
-}
-function nonEmpty(value) {
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-function resolveToolIdentity(tool, runName, metadata, toolCallId) {
-  const frameworkRunName = nonEmpty(runName);
-  const metaToolName = nonEmpty(metadata?.toolName);
-  const metaTool = nonEmpty(metadata?.tool);
-  const classLabel = serializedLabel(tool);
-  const callId = nonEmpty(toolCallId) ?? nonEmpty(metadata?.toolCallId) ?? nonEmpty(metadata?.tool_call_id);
-  const displayName = frameworkRunName ?? metaToolName ?? metaTool ?? classLabel ?? "unknown-tool";
-  return {
-    displayName,
-    toolName: displayName,
-    ...classLabel && classLabel !== displayName ? { toolClass: classLabel } : {},
-    ...callId ? { toolCallId: callId } : {},
-    ...frameworkRunName ? { frameworkRunName } : {}
-  };
-}
-function applyToolIdentityAttributes(attrs, identity) {
-  attrs.tool = identity.displayName;
-  attrs.toolName = identity.toolName;
-  if (identity.toolClass) attrs.toolClass = identity.toolClass;
-  if (identity.toolCallId) attrs.toolCallId = identity.toolCallId;
-  if (identity.frameworkRunName) attrs.frameworkRunName = identity.frameworkRunName;
-}
-
-// packages/langchain/src/persist-intent.ts
-function resolvePersistIntent(input) {
-  const hasTraceDir = typeof input.traceDir === "string" && input.traceDir.trim().length > 0;
-  const explicit = input.persist;
-  if (explicit === false) {
-    return { persist: false, contradictory: hasTraceDir };
-  }
-  if (explicit === true) {
-    return { persist: true, contradictory: false };
-  }
-  return { persist: hasTraceDir, contradictory: false };
-}
-
-// packages/langchain/src/invocation-state.ts
-function createInvocationState(envelopeRunId) {
-  return {
-    envelopeRunId,
-    activeRuns: /* @__PURE__ */ new Map(),
-    endedRuns: /* @__PURE__ */ new Set(),
-    knownRelationships: /* @__PURE__ */ new Map(),
-    pendingRelationships: [],
-    completionGeneration: 0,
-    envelopeStarted: false,
-    finalized: false
-  };
-}
-function isObservedCallbackRun(state, parentLcRunId) {
-  return state.activeRuns.has(parentLcRunId) || state.endedRuns.has(parentLcRunId);
-}
-function beginCallbackRun(state, input) {
-  state.completionGeneration += 1;
-  const run = {
-    lcRunId: input.lcRunId,
-    ...input.parentLcRunId !== void 0 ? { parentLcRunId: input.parentLcRunId } : {},
-    startedAt: input.startedAt,
-    ...input.kind !== void 0 ? { kind: input.kind } : {},
-    ...input.stepId !== void 0 ? { stepId: input.stepId } : {}
-  };
-  state.activeRuns.set(input.lcRunId, run);
-  if (input.parentLcRunId !== void 0) {
-    if (isObservedCallbackRun(state, input.parentLcRunId)) {
-      state.knownRelationships.set(input.lcRunId, input.parentLcRunId);
-    } else {
-      state.pendingRelationships.push({
-        childLcRunId: input.lcRunId,
-        parentLcRunId: input.parentLcRunId,
-        reason: "unobserved-parent"
-      });
-    }
-  }
-  return run;
-}
-function endCallbackRun(state, lcRunId) {
-  const active = state.activeRuns.get(lcRunId);
-  if (active === void 0) {
-    if (state.endedRuns.has(lcRunId) || state.finalized) {
-      return { ended: false, late: true };
-    }
-    return { ended: false, late: true };
-  }
-  state.completionGeneration += 1;
-  state.activeRuns.delete(lcRunId);
-  state.endedRuns.add(lcRunId);
-  return { ended: true, late: false };
-}
-function markEnvelopeStarted(state, startTime) {
-  if (state.envelopeStarted) return false;
-  state.envelopeStarted = true;
-  state.runStartTime = startTime;
-  return true;
-}
-function markFinalized(state) {
-  if (state.finalized) return false;
-  if (!state.envelopeStarted) return false;
-  state.finalized = true;
-  return true;
-}
-function noteTerminalError(state, message) {
-  state.terminalError = { message };
-}
-function canScheduleFinalize(state) {
-  return state.envelopeStarted && !state.finalized && state.activeRuns.size === 0;
-}
-function bumpCompletionGeneration(state) {
-  state.completionGeneration += 1;
-  return state.completionGeneration;
-}
-function resetInvocationState(state, nextEnvelopeRunId) {
-  state.activeRuns.clear();
-  state.endedRuns.clear();
-  state.knownRelationships.clear();
-  state.pendingRelationships.length = 0;
-  state.terminalError = void 0;
-  state.completionGeneration += 1;
-  state.envelopeStarted = false;
-  state.finalized = false;
-  state.runStartTime = void 0;
-  if (nextEnvelopeRunId !== void 0) {
-    state.envelopeRunId = nextEnvelopeRunId;
-  }
-}
-
-// packages/langchain/src/parent-reconciliation.ts
-var WELL_KNOWN_SEMANTIC_PARENTS = /* @__PURE__ */ new Set([
-  "LangGraph",
-  "__start__",
-  "__end__"
-]);
-function isSemanticParentLabel(parentLcRunId) {
-  if (WELL_KNOWN_SEMANTIC_PARENTS.has(parentLcRunId)) return true;
-  return parentLcRunId.startsWith("__") && parentLcRunId.endsWith("__");
-}
-function excludeSelf(stepId, excludeStepId) {
-  if (!stepId) return void 0;
-  if (excludeStepId && stepId === excludeStepId) return void 0;
-  return stepId;
-}
-var LANGGRAPH_PARENT_KEYS = [
-  "handoffFrom",
-  "taskId",
-  "nodeId",
-  "nodeName",
-  "checkpointNamespace"
-];
-function langGraphRecord(attributes) {
-  const lg = attributes?.langGraph;
-  if (typeof lg !== "object" || lg === null || Array.isArray(lg)) return void 0;
-  return lg;
-}
-function resolveParentRelationship(input, lookup, context = {}) {
-  const parentLcRunId = input.parentLcRunId;
-  const excludeStepId = context.excludeStepId;
-  if (parentLcRunId) {
-    const exact = excludeSelf(lookup.exactStepByLcRunId(parentLcRunId), excludeStepId);
-    if (exact) {
-      return {
-        parentStepId: exact,
-        confidence: "explicit",
-        parentMapping: "exact"
-      };
-    }
-  }
-  const lg = langGraphRecord(input.attributes);
-  if (lg) {
-    for (const key of LANGGRAPH_PARENT_KEYS) {
-      if (key !== "handoffFrom" && key !== "checkpointNamespace") continue;
-      const raw = lg[key];
-      if (typeof raw !== "string" || !raw.trim()) continue;
-      const stepId = excludeSelf(
-        lookup.uniqueStepByLangGraphKey(key === "handoffFrom" ? "taskId" : key, raw),
-        excludeStepId
-      );
-      const matched = stepId ?? excludeSelf(
-        key === "handoffFrom" ? lookup.uniqueStepByLangGraphKey("nodeName", raw) ?? lookup.uniqueStepByLangGraphKey("nodeId", raw) : void 0,
-        excludeStepId
-      );
-      if (matched) {
-        return {
-          parentStepId: matched,
-          confidence: "correlated",
-          parentMapping: "langgraph-metadata",
-          correlatedVia: key
-        };
-      }
-    }
-  }
-  if (parentLcRunId && isSemanticParentLabel(parentLcRunId)) {
-    const semantic = excludeSelf(
-      lookup.uniqueStepBySemanticLabel(parentLcRunId),
-      excludeStepId
-    );
-    if (semantic) {
-      return {
-        parentStepId: semantic,
-        confidence: "correlated",
-        parentMapping: "semantic-name",
-        semanticParentLabel: parentLcRunId
-      };
-    }
-    return {
-      confidence: "unresolved",
-      parentMapping: "unresolved",
-      semanticParentLabel: parentLcRunId,
-      unresolvedParentRunId: parentLcRunId
-    };
-  }
-  if (parentLcRunId) {
-    return {
-      confidence: "unresolved",
-      parentMapping: "unresolved",
-      unresolvedParentRunId: parentLcRunId
-    };
-  }
-  return {
-    confidence: "explicit",
-    parentMapping: "exact"
-  };
-}
-function rejectSelfParentResolution(resolution, stepId, parentLcRunId) {
-  if (resolution.parentStepId !== stepId) return resolution;
-  return {
-    confidence: "unresolved",
-    parentMapping: "unresolved",
-    unresolvedParentRunId: parentLcRunId ?? resolution.unresolvedParentRunId,
-    ...resolution.semanticParentLabel ? { semanticParentLabel: resolution.semanticParentLabel } : {}
-  };
-}
-var AI_LANGGRAPH_SELF_PARENT_REJECTED = "AI_LANGGRAPH_SELF_PARENT_REJECTED";
-var AI_LANGGRAPH_RELATIONSHIP_AMBIGUOUS = "AI_LANGGRAPH_RELATIONSHIP_AMBIGUOUS";
-function applySelfParentCaptureInvariant(stepId, parentStepId, metadata, originalParentRunId) {
-  if (!parentStepId || parentStepId !== stepId) {
-    return { parentStepId, rejected: false };
-  }
-  metadata.parentMapping = "self-parent-rejected";
-  metadata.parentConfidence = "unresolved";
-  metadata.relationshipWarning = "self-parent";
-  metadata.diagnosticCode = AI_LANGGRAPH_SELF_PARENT_REJECTED;
-  if (originalParentRunId && originalParentRunId.trim()) {
-    metadata.originalParentRunId = originalParentRunId.slice(0, 128);
-  }
-  delete metadata.parentCorrelatedVia;
-  return { parentStepId: void 0, rejected: true };
-}
-function applyAmbiguousScaffoldingDiagnostic(resolution, metadata) {
-  if (resolution.parentStepId) return false;
-  if (resolution.parentMapping !== "unresolved") return false;
-  if (metadata.diagnosticCode === AI_LANGGRAPH_SELF_PARENT_REJECTED) return false;
-  metadata.diagnosticCode = AI_LANGGRAPH_RELATIONSHIP_AMBIGUOUS;
-  if (typeof metadata.relationshipWarning !== "string") {
-    metadata.relationshipWarning = "ambiguous-root";
-  }
-  return true;
-}
-function applyParentResolutionMetadata(metadata, resolution) {
-  const hasParentSignal = Boolean(resolution.parentStepId) || Boolean(resolution.unresolvedParentRunId) || Boolean(resolution.semanticParentLabel) || Boolean(resolution.correlatedVia);
-  if (!hasParentSignal) return;
-  metadata.parentMapping = resolution.parentMapping;
-  metadata.parentConfidence = resolution.confidence;
-  if (resolution.semanticParentLabel) {
-    metadata.semanticParentLabel = resolution.semanticParentLabel;
-  }
-  if (resolution.unresolvedParentRunId) {
-    metadata.unresolvedParentRunId = resolution.unresolvedParentRunId;
-  }
-  if (resolution.correlatedVia) {
-    metadata.parentCorrelatedVia = resolution.correlatedVia;
-  }
-  if (resolution.parentMapping === "synthetic-group") {
-    metadata.synthetic = true;
-  }
-}
-
-// packages/langchain/src/trace-persistence.ts
-function kindToStepType(kind) {
-  switch (kind) {
-    case "LLM":
-      return "llm";
-    case "TOOL":
-      return "tool";
-    case "DECISION":
-      return "decision";
-    default:
-      return "logic";
-  }
-}
-function toStepMetadata(attrs) {
-  const out = {
-    adapter: "langchain",
-    confidence: "explicit"
-  };
-  for (const [k, v] of Object.entries(attrs)) {
-    out[k] = v;
-  }
-  return out;
-}
-var LangChainTracePersistence = class {
-  #traceDir;
-  #runId;
-  #runName;
-  #standalone;
-  #silent;
-  #safety;
-  #lifecycle;
-  #lcToStepId = /* @__PURE__ */ new Map();
-  /** `${field}\0${value}` → stepId, or null when ambiguous. */
-  #langGraphIndex = /* @__PURE__ */ new Map();
-  /** Semantic / display label → stepId, or null when ambiguous. */
-  #semanticLabelIndex = /* @__PURE__ */ new Map();
-  /** Semantic label → synthetic step id (created once ≥2 siblings share the label). */
-  #syntheticByLabel = /* @__PURE__ */ new Map();
-  /** Count of unresolved semantic-parent children seen per label (this invocation). */
-  #semanticParentCounts = /* @__PURE__ */ new Map();
-  #lateEventCount = 0;
-  #selfParentRejectedCount = 0;
-  #ambiguousRelationshipCount = 0;
-  constructor(options = {}) {
-    const inContext = advanced.hasActiveContext();
-    this.#standalone = !inContext;
-    this.#silent = options.silent ?? false;
-    this.#traceDir = inContext ? advanced.getTraceDirFromContext() ?? advanced.resolveTraceDir({ dir: options.traceDir }) : advanced.resolveTraceDir({ dir: options.traceDir });
-    const contextRunId = inContext ? advanced.getCurrentRunId() : void 0;
-    this.#runId = contextRunId ?? options.runId ?? advanced.createRunId();
-    this.#runName = options.runName ?? "langchain-agent";
-    this.#safety = advanced.resolveTraceSafetyOptions({
-      redact: options.redact ? { rules: options.redact } : true,
-      maxPreviewLength: options.maxPreviewChars,
-      ...options.redactionProfile ? { redactionProfile: options.redactionProfile } : {}
-    });
-    this.#lifecycle = createInvocationState(this.#runId);
-  }
-  get runId() {
-    return this.#runId;
-  }
-  get traceDir() {
-    return this.#traceDir;
-  }
-  /** @internal Test / diagnostics access to per-invocation lifecycle. */
-  get lifecycle() {
-    return this.#lifecycle;
-  }
-  /** Count of end/start events ignored after finalize (diagnostics). */
-  get lateEventCount() {
-    return this.#lateEventCount;
-  }
-  /** Bounded adapter diagnostics for CLI/MCP summaries (no filesystem paths). */
-  getDiagnostics() {
-    return {
-      lateEventCount: this.#lateEventCount,
-      activeRunCount: this.#lifecycle.activeRuns.size,
-      endedRunCount: this.#lifecycle.endedRuns.size,
-      pendingRelationshipCount: this.#lifecycle.pendingRelationships.length,
-      knownRelationshipCount: this.#lifecycle.knownRelationships.size,
-      syntheticGroupCount: this.#syntheticByLabel.size,
-      selfParentRejectedCount: this.#selfParentRejectedCount,
-      ambiguousRelationshipCount: this.#ambiguousRelationshipCount,
-      envelopeStarted: this.#lifecycle.envelopeStarted,
-      finalized: this.#lifecycle.finalized,
-      completionGeneration: this.#lifecycle.completionGeneration,
-      hasTerminalError: Boolean(this.#lifecycle.terminalError)
-    };
-  }
-  #parentIdForPersist(stepId, resolution, metadata, originalParentRunId) {
-    const guarded = applySelfParentCaptureInvariant(
-      stepId,
-      resolution.parentStepId,
-      metadata,
-      originalParentRunId ?? resolution.unresolvedParentRunId
-    );
-    if (guarded.rejected) {
-      this.#selfParentRejectedCount += 1;
-    } else if (applyAmbiguousScaffoldingDiagnostic(resolution, metadata)) {
-      this.#ambiguousRelationshipCount += 1;
-    }
-    return guarded.parentStepId;
-  }
-  /**
-   * Start a fresh envelope after a prior invocation finalized (callback reuse).
-   * Allocates a new run id unless still nested in an inspectRun context.
-   */
-  beginNewInvocation() {
-    if (advanced.hasActiveContext()) {
-      const ctxId = advanced.getCurrentRunId();
-      if (ctxId) {
-        this.#runId = ctxId;
-        resetInvocationState(this.#lifecycle, this.#runId);
-        this.#clearStepIndexes();
-        this.#lateEventCount = 0;
-        this.#selfParentRejectedCount = 0;
-        this.#ambiguousRelationshipCount = 0;
-        return;
-      }
-    }
-    this.#runId = advanced.createRunId();
-    resetInvocationState(this.#lifecycle, this.#runId);
-    this.#clearStepIndexes();
-    this.#lateEventCount = 0;
-    this.#selfParentRejectedCount = 0;
-    this.#ambiguousRelationshipCount = 0;
-  }
-  reset() {
-    resetInvocationState(this.#lifecycle);
-    this.#clearStepIndexes();
-    this.#lateEventCount = 0;
-    this.#selfParentRejectedCount = 0;
-    this.#ambiguousRelationshipCount = 0;
-  }
-  #clearStepIndexes() {
-    this.#lcToStepId.clear();
-    this.#langGraphIndex.clear();
-    this.#semanticLabelIndex.clear();
-    this.#syntheticByLabel.clear();
-    this.#semanticParentCounts.clear();
-  }
-  #registerUnique(index, key, stepId) {
-    if (!index.has(key)) {
-      index.set(key, stepId);
-      return;
-    }
-    if (index.get(key) !== stepId) {
-      index.set(key, null);
-    }
-  }
-  #langGraphIndexKey(field, value) {
-    return `${field}\0${value}`;
-  }
-  #registerStepIndexes(stepId, name, attributes) {
-    const labels = /* @__PURE__ */ new Set([name]);
-    const stripped = name.replace(/^(chain|tool|llm|retriever|agent):/, "");
-    if (stripped) labels.add(stripped);
-    for (const label of labels) {
-      this.#registerUnique(this.#semanticLabelIndex, label, stepId);
-    }
-    const lg = attributes.langGraph;
-    if (typeof lg === "object" && lg !== null && !Array.isArray(lg)) {
-      const record = lg;
-      for (const field of [
-        "taskId",
-        "nodeId",
-        "nodeName",
-        "checkpointNamespace"
-      ]) {
-        const raw = record[field];
-        if (typeof raw === "string" && raw.trim()) {
-          this.#registerUnique(
-            this.#langGraphIndex,
-            this.#langGraphIndexKey(field, raw),
-            stepId
-          );
-        }
-      }
-    }
-  }
-  #resolveParent(parentLcRunId, attributes, excludeStepId) {
-    const resolution = resolveParentRelationship(
-      { parentLcRunId, attributes },
-      {
-        exactStepByLcRunId: (lcRunId) => this.#lcToStepId.get(lcRunId),
-        uniqueStepByLangGraphKey: (key, value) => {
-          const hit = this.#langGraphIndex.get(this.#langGraphIndexKey(key, value));
-          return hit === null || hit === void 0 ? void 0 : hit;
-        },
-        uniqueStepBySemanticLabel: (label) => {
-          const hit = this.#semanticLabelIndex.get(label);
-          return hit === null || hit === void 0 ? void 0 : hit;
-        }
-      },
-      excludeStepId ? { excludeStepId } : {}
-    );
-    return excludeStepId ? rejectSelfParentResolution(resolution, excludeStepId, parentLcRunId) : resolution;
-  }
-  /**
-   * When ≥2 steps share the same unresolved semantic parent label, emit one
-   * synthetic grouping node and attach this (and later) siblings under it.
-   * The first sibling remains unresolved (append-only JSONL cannot rewrite it).
-   */
-  async #maybeAttachSyntheticGroup(resolution, startTime) {
-    const label = resolution.semanticParentLabel;
-    if (resolution.parentMapping !== "unresolved" || !label || resolution.parentStepId) {
-      return resolution;
-    }
-    const existing = this.#syntheticByLabel.get(label);
-    if (existing) {
-      return {
-        parentStepId: existing,
-        confidence: "synthetic",
-        parentMapping: "synthetic-group",
-        semanticParentLabel: label,
-        unresolvedParentRunId: label
-      };
-    }
-    const nextCount = (this.#semanticParentCounts.get(label) ?? 0) + 1;
-    this.#semanticParentCounts.set(label, nextCount);
-    if (nextCount < 2) {
-      return resolution;
-    }
-    const syntheticStepId = advanced.createStepId();
-    this.#syntheticByLabel.set(label, syntheticStepId);
-    const metadata = {
-      adapter: "langchain",
-      confidence: "synthetic",
-      synthetic: true,
-      parentMapping: "synthetic-group",
-      parentConfidence: "synthetic",
-      semanticParentLabel: label,
-      unresolvedParentRunId: label
-    };
-    const event = {
-      schemaVersion: "0.1",
-      event: "step_started",
-      timestamp: startTime,
-      runId: this.#runId,
-      stepId: syntheticStepId,
-      name: `synthetic:${label}`,
-      type: "logic",
-      startTime,
-      metadata
-    };
-    await this.#write(event);
-    return {
-      parentStepId: syntheticStepId,
-      confidence: "synthetic",
-      parentMapping: "synthetic-group",
-      semanticParentLabel: label,
-      unresolvedParentRunId: label
-    };
-  }
-  /** Rotate when a prior standalone invocation already finalized. */
-  #prepareForStart() {
-    if (this.#standalone && this.#lifecycle.finalized) {
-      this.beginNewInvocation();
-    }
-  }
-  /**
-   * @deprecated Root-ID heuristics are no longer used for envelope completion.
-   * Retained as a no-op for call-site compatibility during the v6.8 train.
-   */
-  noteRoot(_lcRunId, _parentRunId) {
-  }
-  resolveParentId(lcParentRunId) {
-    if (!lcParentRunId) return void 0;
-    return this.#lcToStepId.get(lcParentRunId);
-  }
-  async onStepStart(params) {
-    try {
-      this.#prepareForStart();
-      const stepId = advanced.createStepId();
-      const resolution = await this.#maybeAttachSyntheticGroup(
-        this.#resolveParent(params.lcParentRunId, params.attributes, stepId),
-        params.startTime
-      );
-      beginCallbackRun(this.#lifecycle, {
-        lcRunId: params.lcRunId,
-        parentLcRunId: params.lcParentRunId,
-        startedAt: params.startTime,
-        kind: params.kind,
-        stepId
-      });
-      if (this.#standalone && !this.#lifecycle.envelopeStarted) {
-        await this.#ensureRunStarted(params.startTime, params.attributes);
-      }
-      const metadata = toStepMetadata(params.attributes);
-      applyParentResolutionMetadata(metadata, resolution);
-      const parentId = this.#parentIdForPersist(
-        stepId,
-        resolution,
-        metadata,
-        params.lcParentRunId
-      );
-      const event = {
-        schemaVersion: "0.1",
-        event: "step_started",
-        timestamp: params.startTime,
-        runId: this.#runId,
-        stepId,
-        ...parentId ? { parentId } : {},
-        name: params.name,
-        type: kindToStepType(params.kind),
-        startTime: params.startTime,
-        metadata
-      };
-      this.#lcToStepId.set(params.lcRunId, stepId);
-      await this.#write(event);
-      this.#registerStepIndexes(stepId, params.name, params.attributes);
-    } catch (err) {
-      this.#warn(err);
-    }
-  }
-  async onStepEnd(params) {
-    try {
-      if (this.#lifecycle.finalized && !this.#lifecycle.activeRuns.has(params.lcRunId) && !this.#lcToStepId.has(params.lcRunId)) {
-        this.#lateEventCount += 1;
-        return;
-      }
-      let stepId = this.#lcToStepId.get(params.lcRunId);
-      if (!stepId && params.completionAttributes) {
-        if (this.#lifecycle.finalized) {
-          this.#lateEventCount += 1;
-          return;
-        }
-        stepId = advanced.createStepId();
-        const synthName = String(params.completionAttributes.name ?? "llm:llm");
-        const startTime = params.endTime - (params.durationMs ?? 0);
-        const resolution = await this.#maybeAttachSyntheticGroup(
-          this.#resolveParent(
-            params.lcParentRunId,
-            params.completionAttributes,
-            stepId
-          ),
-          startTime
-        );
-        beginCallbackRun(this.#lifecycle, {
-          lcRunId: params.lcRunId,
-          parentLcRunId: params.lcParentRunId,
-          startedAt: startTime,
-          kind: params.completionAttributes.kind ?? "LLM",
-          stepId
-        });
-        const metadata = toStepMetadata(params.completionAttributes);
-        applyParentResolutionMetadata(metadata, resolution);
-        const parentId = this.#parentIdForPersist(
-          stepId,
-          resolution,
-          metadata,
-          params.lcParentRunId
-        );
-        const started = {
-          schemaVersion: "0.1",
-          event: "step_started",
-          timestamp: startTime,
-          runId: this.#runId,
-          stepId,
-          ...parentId ? { parentId } : {},
-          name: synthName,
-          type: kindToStepType(
-            params.completionAttributes.kind ?? "LLM"
-          ),
-          startTime,
-          metadata
-        };
-        if (this.#standalone && !this.#lifecycle.envelopeStarted) {
-          await this.#ensureRunStarted(startTime, params.completionAttributes);
-        }
-        this.#lcToStepId.set(params.lcRunId, stepId);
-        await this.#write(started);
-        this.#registerStepIndexes(stepId, synthName, params.completionAttributes);
-      }
-      if (!stepId) return;
-      const durationMs = typeof params.durationMs === "number" && Number.isFinite(params.durationMs) ? Math.max(0, Math.floor(params.durationMs)) : Math.max(
-        0,
-        params.endTime - (this.#lifecycle.runStartTime ?? params.endTime)
-      );
-      const event = {
-        schemaVersion: "0.1",
-        event: "step_completed",
-        timestamp: params.endTime,
-        runId: this.#runId,
-        stepId,
-        status: params.status,
-        endTime: params.endTime,
-        durationMs,
-        ...params.status === "error" && params.errorMessage ? { error: { message: params.errorMessage } } : {}
-      };
-      await this.#write(event);
-      if (params.status === "error") {
-        noteTerminalError(
-          this.#lifecycle,
-          params.errorMessage ?? "adapter step error"
-        );
-      }
-      endCallbackRun(this.#lifecycle, params.lcRunId);
-      await this.#scheduleStandaloneFinalization(params.endTime);
-    } catch (err) {
-      this.#warn(err);
-    }
-  }
-  /** Point-in-time adapter events (e.g. agent action) — writes start + completed pair. */
-  async onInstantStep(params) {
-    try {
-      this.#prepareForStart();
-      const stepId = advanced.createStepId();
-      const resolution = await this.#maybeAttachSyntheticGroup(
-        this.#resolveParent(params.lcParentRunId, params.attributes, stepId),
-        params.timestamp
-      );
-      beginCallbackRun(this.#lifecycle, {
-        lcRunId: params.lcRunId,
-        parentLcRunId: params.lcParentRunId,
-        startedAt: params.timestamp,
-        kind: params.kind,
-        stepId
-      });
-      if (this.#standalone && !this.#lifecycle.envelopeStarted) {
-        await this.#ensureRunStarted(params.timestamp, params.attributes);
-      }
-      const metadata = toStepMetadata(params.attributes);
-      applyParentResolutionMetadata(metadata, resolution);
-      const parentId = this.#parentIdForPersist(
-        stepId,
-        resolution,
-        metadata,
-        params.lcParentRunId
-      );
-      const started = {
-        schemaVersion: "0.1",
-        event: "step_started",
-        timestamp: params.timestamp,
-        runId: this.#runId,
-        stepId,
-        ...parentId ? { parentId } : {},
-        name: params.name,
-        type: kindToStepType(params.kind),
-        startTime: params.timestamp,
-        metadata
-      };
-      this.#lcToStepId.set(params.lcRunId, stepId);
-      await this.#write(started);
-      this.#registerStepIndexes(stepId, params.name, params.attributes);
-      const completed = {
-        schemaVersion: "0.1",
-        event: "step_completed",
-        timestamp: params.timestamp,
-        runId: this.#runId,
-        stepId,
-        status: params.status,
-        endTime: params.timestamp,
-        durationMs: 0,
-        ...params.status === "error" && params.errorMessage ? { error: { message: params.errorMessage } } : {}
-      };
-      await this.#write(completed);
-      if (params.status === "error") {
-        noteTerminalError(
-          this.#lifecycle,
-          params.errorMessage ?? "adapter step error"
-        );
-      }
-      endCallbackRun(this.#lifecycle, params.lcRunId);
-      await this.#scheduleStandaloneFinalization(params.timestamp);
-    } catch (err) {
-      this.#warn(err);
-    }
-  }
-  /**
-   * Drain deferred microtask finalization. Idempotent; never throws to callers.
-   * @experimental
-   */
-  async flush() {
-    try {
-      await Promise.resolve();
-      await Promise.resolve();
-    } catch (err) {
-      this.#warn(err);
-    }
-  }
-  /**
-   * Force-complete the standalone envelope when safe/started.
-   * Works even if active callback runs remain (unusual framework shapes / serverless).
-   * Idempotent; never throws to callers.
-   * @experimental
-   */
-  async finalize(options = {}) {
-    try {
-      if (!this.#standalone) return false;
-      if (this.#lifecycle.finalized) return false;
-      if (!this.#lifecycle.envelopeStarted) return false;
-      bumpCompletionGeneration(this.#lifecycle);
-      const status = options.status ?? (this.#lifecycle.terminalError ? "error" : "success");
-      if (status === "error") {
-        noteTerminalError(
-          this.#lifecycle,
-          options.errorMessage ?? this.#lifecycle.terminalError?.message ?? "adapter finalize error"
-        );
-      }
-      await this.#ensureRunCompleted(
-        options.endTime ?? Date.now(),
-        status,
-        status === "error" ? options.errorMessage ?? this.#lifecycle.terminalError?.message : void 0
-      );
-      return this.#lifecycle.finalized;
-    } catch (err) {
-      this.#warn(err);
-      return false;
-    }
-  }
-  /**
-   * Flush + finalize. Idempotent; never throws to callers.
-   * @experimental
-   */
-  async close() {
-    try {
-      await this.flush();
-      await this.finalize();
-    } catch (err) {
-      this.#warn(err);
-    }
-  }
-  /**
-   * When the last active LangChain callback ends, yield one microtask so a
-   * same-turn sibling start can cancel finalization, then write run_completed
-   * before the callback promise settles. Unresolved external parents do not
-   * block the envelope.
-   */
-  async #scheduleStandaloneFinalization(endTime) {
-    if (!this.#standalone || !canScheduleFinalize(this.#lifecycle)) return;
-    const generation = this.#lifecycle.completionGeneration;
-    await Promise.resolve();
-    if (this.#lifecycle.completionGeneration !== generation) return;
-    if (!this.#standalone || !canScheduleFinalize(this.#lifecycle)) return;
-    const status = this.#lifecycle.terminalError ? "error" : "success";
-    await this.#ensureRunCompleted(
-      endTime,
-      status,
-      status === "error" ? this.#lifecycle.terminalError?.message : void 0
-    );
-  }
-  async #ensureRunStarted(startTime, attrs) {
-    if (!markEnvelopeStarted(this.#lifecycle, startTime)) return;
-    await advanced.initializeTraceFile(this.#runId, this.#traceDir);
-    const metadata = {
-      adapter: "langchain",
-      confidence: "explicit"
-    };
-    if (attrs.langchainRunId) metadata.langchainRunId = attrs.langchainRunId;
-    if (attrs.adapterRunName) metadata.adapterRunName = attrs.adapterRunName;
-    const event = {
-      schemaVersion: "0.1",
-      event: "run_started",
-      timestamp: startTime,
-      runId: this.#runId,
-      name: this.#runName,
-      startTime,
-      metadata
-    };
-    await this.#write(event);
-  }
-  async #ensureRunCompleted(endTime, stepStatus, errorMessage) {
-    if (!markFinalized(this.#lifecycle)) return;
-    for (const [, syntheticStepId] of this.#syntheticByLabel) {
-      const completed = {
-        schemaVersion: "0.1",
-        event: "step_completed",
-        timestamp: endTime,
-        runId: this.#runId,
-        stepId: syntheticStepId,
-        status: "success",
-        endTime,
-        durationMs: Math.max(0, endTime - (this.#lifecycle.runStartTime ?? endTime))
-      };
-      await this.#write(completed);
-    }
-    const startTime = this.#lifecycle.runStartTime ?? endTime;
-    const durationMs = Math.max(0, endTime - startTime);
-    const runStatus = stepStatus === "error" ? "error" : "success";
-    const event = {
-      schemaVersion: "0.1",
-      event: "run_completed",
-      timestamp: endTime,
-      runId: this.#runId,
-      status: runStatus,
-      endTime,
-      durationMs,
-      ...runStatus === "error" && errorMessage ? { error: { message: errorMessage } } : {}
-    };
-    await this.#write(event);
-  }
-  async #write(event) {
-    const safe = advanced.prepareTraceEventForDisk(event, this.#safety);
-    await advanced.writeTraceEvent(safe, this.#traceDir);
-  }
-  #warn(err) {
-    if (!this.#silent) {
-      console.error("[agent-inspect:langchain]", err);
-    }
-  }
-};
-
-// packages/langchain/src/agent-inspect-callback.ts
-function isRecord2(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-function serializedLabel2(s) {
-  if (typeof s.name === "string" && s.name.trim()) return s.name;
-  if (Array.isArray(s.id) && s.id.length > 0) return s.id[s.id.length - 1];
-  return s.type;
-}
-function errorShape(err) {
-  if (err instanceof Error) {
-    return { errorName: err.name, errorMessage: err.message };
-  }
-  return { errorMessage: String(err) };
-}
-var AgentInspectCallback = class extends base.BaseCallbackHandler {
-  name = "agent-inspect";
-  /**
-   * Ensure LangGraph/LangChain awaits async handler work (persistence) before
-   * invoke/stream settles. Required for deterministic standalone envelopes.
-   */
-  awaitHandlers = true;
-  #opts;
-  #redactor;
-  #capture;
-  #persistence;
-  #events = [];
-  #starts = /* @__PURE__ */ new Map();
-  #streamState = /* @__PURE__ */ new Map();
-  #deferredPersistStart = /* @__PURE__ */ new Map();
-  #rootRunId;
-  constructor(options = {}) {
-    super({});
-    const intent = resolvePersistIntent(options);
-    this.#opts = {
-      capture: options.capture ?? "metadata-only",
-      silent: options.silent ?? false,
-      maxPreviewChars: options.maxPreviewChars ?? 200,
-      runName: options.runName ?? "langchain-agent",
-      ...options,
-      persist: intent.persist
-    };
-    this.#redactor = new logs.Redactor({ rules: this.#opts.redact });
-    this.#capture = advanced.createAdapterPreviewCapture({
-      capture: this.#opts.capture === "preview" ? "preview" : "metadata-only",
-      redactionProfile: this.#opts.redactionProfile,
-      maxPreviewChars: this.#opts.maxPreviewChars,
-      redact: this.#opts.redact,
-      onDiagnostic: this.#opts.onDiagnostic
-    });
-    if (intent.contradictory && !this.#opts.silent) {
-      console.error(
-        "[agent-inspect:langchain] persist:false with traceDir set \u2014 traces stay in-memory; remove traceDir or set persist:true"
-      );
-    }
-    if (intent.persist) {
-      this.#persistence = new LangChainTracePersistence({
-        runName: this.#opts.runName,
-        traceDir: this.#opts.traceDir,
-        runId: this.#opts.runId,
-        redact: this.#opts.redact,
-        silent: this.#opts.silent,
-        maxPreviewChars: this.#capture.maxPreviewChars,
-        redactionProfile: this.#opts.redactionProfile
-      });
-    }
-  }
-  getEvents() {
-    return this.#events.map((e) => ({
-      ...e,
-      attributes: e.attributes ? { ...e.attributes } : void 0,
-      source: { ...e.source }
-    }));
-  }
-  clear() {
-    this.#events = [];
-    this.#starts.clear();
-    this.#streamState.clear();
-    this.#deferredPersistStart.clear();
-    this.#rootRunId = void 0;
-    this.#persistence?.reset();
-  }
-  /**
-   * Bounded adapter diagnostics for the current invocation (counts only).
-   * Safe for CLI/MCP summaries — no absolute paths or payloads.
-   *
-   * @experimental
-   */
-  getDiagnostics() {
-    const base = this.#persistence?.getDiagnostics() ?? {
-      lateEventCount: 0,
-      activeRunCount: 0,
-      endedRunCount: 0,
-      pendingRelationshipCount: 0,
-      knownRelationshipCount: 0,
-      syntheticGroupCount: 0,
-      selfParentRejectedCount: 0,
-      ambiguousRelationshipCount: 0,
-      envelopeStarted: false,
-      finalized: false,
-      completionGeneration: 0,
-      hasTerminalError: false
-    };
-    return {
-      ...base,
-      inMemoryEventCount: this.#events.length,
-      deferredPersistStartCount: this.#deferredPersistStart.size,
-      capture: this.#capture.getDiagnostics()
-    };
-  }
-  /**
-   * Drain deferred completion work (microtask finalization).
-   * Idempotent. Failures are isolated and never thrown to user code.
-   *
-   * @experimental Additive finalization API for serverless / unusual callback shapes.
-   */
-  async flush() {
-    try {
-      await this.#persistence?.flush();
-    } catch (err) {
-      if (!this.#opts.silent) {
-        console.error("[agent-inspect:langchain]", err);
-      }
-    }
-  }
-  /**
-   * Complete the standalone envelope when started. Fallback when automatic
-   * completion cannot run (e.g. process shutdown). Idempotent.
-   * Failures are isolated and never thrown to user code.
-   *
-   * @experimental Additive finalization API for serverless / unusual callback shapes.
-   */
-  async finalize(options) {
-    try {
-      await this.#persistence?.finalize(options);
-    } catch (err) {
-      if (!this.#opts.silent) {
-        console.error("[agent-inspect:langchain]", err);
-      }
-    }
-  }
-  /**
-   * `flush()` then `finalize()`. Idempotent. Failures are isolated.
-   *
-   * @experimental Additive finalization API for serverless / unusual callback shapes.
-   */
-  async close() {
-    try {
-      await this.flush();
-      await this.finalize();
-    } catch (err) {
-      if (!this.#opts.silent) {
-        console.error("[agent-inspect:langchain]", err);
-      }
-    }
-  }
-  /**
-   * When persist mode has already finalized an envelope, rotate to a new
-   * invocation before the next start so reused handlers do not mix runs.
-   */
-  #prepareCallbackInvocation() {
-    const persistence = this.#persistence;
-    if (!persistence?.lifecycle.finalized) return;
-    this.#events = [];
-    this.#starts.clear();
-    this.#streamState.clear();
-    this.#deferredPersistStart.clear();
-    this.#rootRunId = void 0;
-    persistence.beginNewInvocation();
-  }
-  #streamPreviewLimit() {
-    if (!this.#capture.previewEnabled) return 0;
-    return this.#opts.maxStreamPreviewChars ?? this.#capture.maxPreviewChars;
-  }
-  #attachStreamMetadata(attrs, lcRunId) {
-    const meta = streamMetadataFromState(this.#streamState.get(lcRunId), {
-      capturePreview: this.#opts.capture === "preview",
-      maxPreviewChars: this.#streamPreviewLimit()
-    });
-    if (meta) {
-      Object.assign(attrs, meta);
-    }
-  }
-  #clearStreamState(lcRunId) {
-    this.#streamState.delete(lcRunId);
-    this.#deferredPersistStart.delete(lcRunId);
-  }
-  #mergeCorrelation(attrs) {
-    if (this.#opts.capture === "none") return;
-    try {
-      const corr = advanced.getCurrentCorrelationMetadata();
-      if (!corr) return;
-      for (const [key, value] of Object.entries(corr)) {
-        if (typeof value === "string" && value.length > 0) {
-          attrs[key] = value;
-        }
-      }
-    } catch {
-    }
-  }
-  async #persistLlmStepStart(lcRunId, lcParentRunId, name, kind, startTime, attributes) {
-    if (this.#opts.stream && this.#opts.persist) {
-      this.#deferredPersistStart.set(lcRunId, {
-        lcParentRunId,
-        name,
-        kind,
-        startTime,
-        attributes: { ...attributes }
-      });
-      return;
-    }
-    await this.#persistStepStart(lcRunId, lcParentRunId, name, kind, attributes, startTime);
-  }
-  async #flushDeferredPersistStart(lcRunId, completionAttributes) {
-    const pending = this.#deferredPersistStart.get(lcRunId);
-    if (!pending || !this.#opts.persist) return;
-    const merged = {
-      ...pending.attributes,
-      ...completionAttributes
-    };
-    await this.#persistStepStart(
-      lcRunId,
-      pending.lcParentRunId,
-      pending.name,
-      pending.kind,
-      merged,
-      pending.startTime
-    );
-    this.#deferredPersistStart.delete(lcRunId);
-  }
-  #ensureRoot(lcRunId, parentRunId) {
-    if (parentRunId) return;
-    if (!this.#rootRunId) this.#rootRunId = lcRunId;
-  }
-  #traceRunId(lcRunId) {
-    return this.#rootRunId ?? lcRunId;
-  }
-  #durationFor(lcRunId) {
-    const s = this.#starts.get(lcRunId);
-    if (!s) return void 0;
-    return Date.now() - s.ts;
-  }
-  #rememberStart(lcRunId, kind) {
-    this.#starts.set(lcRunId, { ts: Date.now(), kind });
-  }
-  #rememberStartMetadata(lcRunId, attrs) {
-    const start = this.#starts.get(lcRunId);
-    if (!start || !isRecord2(attrs.langGraph)) return;
-    this.#starts.set(lcRunId, { ...start, langGraph: { ...attrs.langGraph } });
-  }
-  #attachStartMetadata(attrs, lcRunId) {
-    const langGraph = this.#starts.get(lcRunId)?.langGraph;
-    if (langGraph && !attrs.langGraph) attrs.langGraph = { ...langGraph };
-  }
-  #clearStart(lcRunId) {
-    this.#starts.delete(lcRunId);
-  }
-  #baseAttrs(lcRunId, parentRunId, tags, runNameArg) {
-    const out = {
-      langchainRunId: lcRunId
-    };
-    if (parentRunId) out.parentRunId = parentRunId;
-    if (this.#opts.runName) out.adapterRunName = this.#opts.runName;
-    if (runNameArg) out.runName = runNameArg;
-    if (this.#opts.persist) out.traceStorage = "local";
-    const configuredTraceDir = this.#opts.traceDir?.trim();
-    if (configuredTraceDir && !path__default.default.isAbsolute(configuredTraceDir) && !/^[A-Za-z]:[\\/]/.test(configuredTraceDir)) {
-      out.workspaceRelativeTraceDir = configuredTraceDir;
-    }
-    const cap = this.#opts.capture;
-    if (cap !== "none" && tags?.length) out.tags = [...tags];
-    return out;
-  }
-  #mergeMetadata(attrs, metadata) {
-    if (this.#opts.capture === "none" || !metadata) return;
-    attrs.metadata = this.#redactor.redactRecord(toPlainMetadata(metadata));
-    const langGraph = extractLangGraphMetadata(metadata);
-    if (langGraph) attrs.langGraph = this.#redactor.redactRecord(langGraph);
-  }
-  #applyPreview(attrs, previews) {
-    this.#capture.applyPreviewFields(attrs, previews);
-  }
-  #pushEvent(ev) {
-    try {
-      const attributes = ev.attributes ? this.#redactor.redactRecord({ ...ev.attributes }) : void 0;
-      this.#events.push({ ...ev, attributes });
-    } catch (err) {
-      if (!this.#opts.silent) {
-        console.error("[agent-inspect:langchain]", err);
-      }
-    }
-  }
-  async #persistStepStart(lcRunId, lcParentRunId, name, kind, attrs, startTime) {
-    await this.#persistence?.onStepStart({
-      lcRunId,
-      lcParentRunId,
-      name,
-      kind,
-      startTime,
-      attributes: attrs
-    });
-  }
-  async #persistStepEnd(lcRunId, lcParentRunId, status, endTime, durationMs, errorMessage, completionAttributes) {
-    await this.#persistence?.onStepEnd({
-      lcRunId,
-      lcParentRunId,
-      endTime,
-      durationMs,
-      status,
-      errorMessage,
-      completionAttributes
-    });
-  }
-  async #persistInstant(lcRunId, lcParentRunId, name, kind, attrs, status, errorMessage) {
-    await this.#persistence?.onInstantStep({
-      lcRunId,
-      lcParentRunId,
-      name,
-      kind,
-      timestamp: Date.now(),
-      attributes: attrs,
-      status,
-      errorMessage
-    });
-  }
-  /**
-   * Match CallbackManager's runtime call order (parentRunId 4th), same as
-   * handleLLMStart / handleToolStart — not the declared CallbackHandlerMethods
-   * TypeScript order that puts runType 4th and parentRunId 8th.
-   */
-  async handleChainStart(chain, inputs, runId, parentRunId, tags, metadata, runType, runName, _extra) {
-    this.#prepareCallbackInvocation();
-    this.#ensureRoot(runId, parentRunId);
-    this.#rememberStart(runId, "CHAIN");
-    const label = serializedLabel2(chain) ?? "chain";
-    const previews = {};
-    if (this.#opts.capture === "preview") previews.inputPreview = inputs;
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, runName)
-    };
-    this.#mergeMetadata(attrs, metadata);
-    this.#applyPreview(attrs, previews);
-    this.#rememberStartMetadata(runId, attrs);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:CHAIN:start`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: `chain:${runName ?? label}`,
-      kind: "CHAIN",
-      timestamp: ts,
-      status: "running",
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepStart(runId, parentRunId, `chain:${runName ?? label}`, "CHAIN", attrs, ts);
-  }
-  async handleChainEnd(outputs, runId, parentRunId, tags, _kwargs) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const previews = {};
-    if (this.#opts.capture === "preview") previews.outputPreview = outputs;
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0)
-    };
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    this.#applyPreview(attrs, previews);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:CHAIN:end`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "chain:end",
-      kind: "CHAIN",
-      timestamp: ts,
-      status: "ok",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepEnd(runId, parentRunId, "success", ts, durationMs);
-  }
-  async handleChainError(err, runId, parentRunId, tags, _kwargs) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const { errorName, errorMessage } = errorShape(err);
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0),
-      errorName,
-      errorMessage
-    };
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:CHAIN:error`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "chain:error",
-      kind: "CHAIN",
-      timestamp: ts,
-      status: "error",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepEnd(runId, parentRunId, "error", ts, durationMs, errorMessage);
-  }
-  async handleLLMStart(llm, prompts, runId, parentRunId, _extraParams, tags, metadata, runName) {
-    this.#prepareCallbackInvocation();
-    this.#ensureRoot(runId, parentRunId);
-    this.#rememberStart(runId, "LLM");
-    const model = extractModelName(llm);
-    const previews = {};
-    if (this.#opts.capture === "preview") {
-      previews.promptPreview = prompts.length === 1 ? prompts[0] : prompts;
-    }
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, runName)
-    };
-    if (model && this.#opts.capture !== "none") attrs.model = model;
-    this.#mergeMetadata(attrs, metadata);
-    this.#mergeCorrelation(attrs);
-    this.#applyPreview(attrs, previews);
-    this.#rememberStartMetadata(runId, attrs);
-    const ts = Date.now();
-    const stepName = `llm:${model ?? "llm"}`;
-    this.#pushEvent({
-      eventId: `${runId}:LLM:start`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: stepName,
-      kind: "LLM",
-      timestamp: ts,
-      status: "running",
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistLlmStepStart(runId, parentRunId, stepName, "LLM", ts, attrs);
-  }
-  async handleChatModelStart(llm, messages, runId, parentRunId, _extraParams, tags, metadata, runName) {
-    this.#prepareCallbackInvocation();
-    this.#ensureRoot(runId, parentRunId);
-    this.#rememberStart(runId, "LLM");
-    const model = extractModelName(llm);
-    const previews = {};
-    if (this.#opts.capture === "preview") previews.inputPreview = messages;
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, runName)
-    };
-    if (model && this.#opts.capture !== "none") attrs.model = model;
-    this.#mergeMetadata(attrs, metadata);
-    this.#mergeCorrelation(attrs);
-    this.#applyPreview(attrs, previews);
-    this.#rememberStartMetadata(runId, attrs);
-    const ts = Date.now();
-    const stepName = `llm:${model ?? "llm"}`;
-    this.#pushEvent({
-      eventId: `${runId}:CHAT:start`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: stepName,
-      kind: "LLM",
-      timestamp: ts,
-      status: "running",
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistLlmStepStart(runId, parentRunId, stepName, "LLM", ts, attrs);
-  }
-  handleLLMNewToken(token, _idx, runId, _parentRunId, _tags, _fields) {
-    try {
-      if (!this.#opts.stream) return;
-      let state = this.#streamState.get(runId);
-      if (!state) {
-        state = createLlmStreamState();
-        this.#streamState.set(runId, state);
-      }
-      recordLlmStreamToken(state, token, Date.now(), this.#streamPreviewLimit());
-    } catch (err) {
-      if (!this.#opts.silent) {
-        console.error("[agent-inspect:langchain]", err);
-      }
-    }
-  }
-  async handleLLMEnd(output, runId, parentRunId, tags, _extraParams) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const tokens = extractTokenUsage(output);
-    const model = extractModelName(output);
-    const previews = {};
-    if (this.#opts.capture === "preview") previews.outputPreview = output;
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0)
-    };
-    if (model && this.#opts.capture !== "none") attrs.model = model;
-    if (tokens && this.#opts.capture !== "none") attrs.tokens = tokens;
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    this.#attachStreamMetadata(attrs, runId);
-    this.#mergeCorrelation(attrs);
-    this.#applyPreview(attrs, previews);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:LLM:end`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: `llm:${model ?? "llm"}`,
-      kind: "LLM",
-      timestamp: ts,
-      status: "ok",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#flushDeferredPersistStart(runId, attrs);
-    await this.#persistStepEnd(runId, parentRunId, "success", ts, durationMs, void 0, {
-      ...attrs,
-      name: `llm:${model ?? "llm"}`,
-      kind: "LLM"
-    });
-    this.#clearStreamState(runId);
-  }
-  async handleLLMError(err, runId, parentRunId, tags, _extraParams) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const { errorName, errorMessage } = errorShape(err);
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0),
-      errorName,
-      errorMessage
-    };
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    this.#attachStreamMetadata(attrs, runId);
-    this.#mergeCorrelation(attrs);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:LLM:error`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "llm:error",
-      kind: "LLM",
-      timestamp: ts,
-      status: "error",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#flushDeferredPersistStart(runId, attrs);
-    await this.#persistStepEnd(runId, parentRunId, "error", ts, durationMs, errorMessage, {
-      ...attrs,
-      name: "llm:error",
-      kind: "LLM"
-    });
-    this.#clearStreamState(runId);
-  }
-  async handleToolStart(tool, input, runId, parentRunId, tags, metadata, runName, toolCallId) {
-    this.#prepareCallbackInvocation();
-    this.#ensureRoot(runId, parentRunId);
-    this.#rememberStart(runId, "TOOL");
-    const identity = resolveToolIdentity(tool, runName, metadata, toolCallId);
-    const previews = {};
-    if (this.#opts.capture === "preview") previews.inputPreview = input;
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, runName)
-    };
-    applyToolIdentityAttributes(attrs, identity);
-    this.#mergeMetadata(attrs, metadata);
-    this.#applyPreview(attrs, previews);
-    this.#rememberStartMetadata(runId, attrs);
-    const ts = Date.now();
-    const stepName = `tool:${identity.displayName}`;
-    this.#pushEvent({
-      eventId: `${runId}:TOOL:start`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: stepName,
-      kind: "TOOL",
-      timestamp: ts,
-      status: "running",
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepStart(runId, parentRunId, stepName, "TOOL", attrs, ts);
-  }
-  async handleToolEnd(output, runId, parentRunId, tags) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const previews = {};
-    if (this.#opts.capture === "preview") previews.outputPreview = output;
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0)
-    };
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    this.#applyPreview(attrs, previews);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:TOOL:end`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "tool:end",
-      kind: "TOOL",
-      timestamp: ts,
-      status: "ok",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepEnd(runId, parentRunId, "success", ts, durationMs);
-  }
-  async handleToolError(err, runId, parentRunId, tags) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const { errorName, errorMessage } = errorShape(err);
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0),
-      errorName,
-      errorMessage
-    };
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:TOOL:error`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "tool:error",
-      kind: "TOOL",
-      timestamp: ts,
-      status: "error",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepEnd(runId, parentRunId, "error", ts, durationMs, errorMessage);
-  }
-  async handleRetrieverStart(retriever, _query, runId, parentRunId, tags, metadata, name) {
-    this.#prepareCallbackInvocation();
-    this.#ensureRoot(runId, parentRunId);
-    this.#rememberStart(runId, "RETRIEVER");
-    const rname = name ?? serializedLabel2(retriever) ?? "retriever";
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0),
-      retriever: rname
-    };
-    this.#mergeMetadata(attrs, metadata);
-    this.#rememberStartMetadata(runId, attrs);
-    const ts = Date.now();
-    const stepName = `retriever:${rname}`;
-    this.#pushEvent({
-      eventId: `${runId}:RETRIEVER:start`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: stepName,
-      kind: "RETRIEVER",
-      timestamp: ts,
-      status: "running",
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepStart(runId, parentRunId, stepName, "RETRIEVER", attrs, ts);
-  }
-  async handleRetrieverEnd(documents, runId, parentRunId, tags) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const previews = {};
-    if (this.#opts.capture === "preview" && documents.length > 0) {
-      previews.documentPreview = documents.slice(0, 3);
-    }
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0),
-      documentCount: documents.length
-    };
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    this.#applyPreview(attrs, previews);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:RETRIEVER:end`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "retriever:end",
-      kind: "RETRIEVER",
-      timestamp: ts,
-      status: "ok",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepEnd(runId, parentRunId, "success", ts, durationMs);
-  }
-  async handleRetrieverError(err, runId, parentRunId, tags) {
-    this.#ensureRoot(runId, parentRunId);
-    const durationMs = this.#durationFor(runId);
-    const { errorName, errorMessage } = errorShape(err);
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0),
-      errorName,
-      errorMessage
-    };
-    this.#attachStartMetadata(attrs, runId);
-    this.#clearStart(runId);
-    const ts = Date.now();
-    this.#pushEvent({
-      eventId: `${runId}:RETRIEVER:error`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "retriever:error",
-      kind: "RETRIEVER",
-      timestamp: ts,
-      status: "error",
-      durationMs,
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistStepEnd(runId, parentRunId, "error", ts, durationMs, errorMessage);
-  }
-  async handleAgentAction(action, runId, parentRunId, tags) {
-    this.#prepareCallbackInvocation();
-    this.#ensureRoot(runId, parentRunId);
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0),
-      tool: action.tool
-    };
-    if (this.#opts.capture === "preview") {
-      this.#applyPreview(attrs, {
-        toolInputPreview: action.toolInput,
-        logPreview: action.log
-      });
-    }
-    this.#pushEvent({
-      eventId: `${runId}:AGENT:action:${Date.now()}`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "agent:action",
-      kind: "DECISION",
-      timestamp: Date.now(),
-      status: "ok",
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistInstant(runId, parentRunId, "agent:action", "DECISION", attrs, "success");
-  }
-  async handleAgentEnd(finish, runId, parentRunId, tags) {
-    this.#ensureRoot(runId, parentRunId);
-    const attrs = {
-      ...this.#baseAttrs(runId, parentRunId, tags, void 0)
-    };
-    if (this.#opts.capture === "preview") {
-      this.#applyPreview(attrs, {
-        outputPreview: finish.returnValues,
-        logPreview: finish.log
-      });
-    }
-    this.#pushEvent({
-      eventId: `${runId}:AGENT:end:${Date.now()}`,
-      runId: this.#traceRunId(runId),
-      parentId: parentRunId,
-      name: "agent:end",
-      kind: "AGENT",
-      timestamp: Date.now(),
-      status: "ok",
-      attributes: attrs,
-      confidence: "explicit",
-      source: { type: "adapter" }
-    });
-    await this.#persistInstant(runId, parentRunId, "agent:end", "AGENT", attrs, "success");
-  }
-};
-
-exports.AgentInspectCallback = AgentInspectCallback;
-exports.extractModelName = extractModelName;
-exports.extractTokenUsage = extractTokenUsage;
-exports.safePreview = safePreview;
-exports.toPlainMetadata = toPlainMetadata;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map