@agent-inspect/langchain 6.14.2 → 6.15.0

package/dist/index.cjs

@@ -569,6 +569,7 @@ function rejectSelfParentResolution(resolution, stepId, parentLcRunId) {
   };
 }
 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 };
@@ -583,6 +584,16 @@ function applySelfParentCaptureInvariant(stepId, parentStepId, metadata, origina
   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;
@@ -644,6 +655,7 @@ var LangChainTracePersistence = class {
   #semanticParentCounts = /* @__PURE__ */ new Map();
   #lateEventCount = 0;
   #selfParentRejectedCount = 0;
+  #ambiguousRelationshipCount = 0;
   constructor(options = {}) {
     const inContext = advanced.hasActiveContext();
     this.#standalone = !inContext;
@@ -682,6 +694,7 @@ var LangChainTracePersistence = class {
       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,
@@ -697,6 +710,8 @@ var LangChainTracePersistence = class {
     );
     if (guarded.rejected) {
       this.#selfParentRejectedCount += 1;
+    } else if (applyAmbiguousScaffoldingDiagnostic(resolution, metadata)) {
+      this.#ambiguousRelationshipCount += 1;
     }
     return guarded.parentStepId;
   }
@@ -713,6 +728,7 @@ var LangChainTracePersistence = class {
         this.#clearStepIndexes();
         this.#lateEventCount = 0;
         this.#selfParentRejectedCount = 0;
+        this.#ambiguousRelationshipCount = 0;
         return;
       }
     }
@@ -721,12 +737,14 @@ var LangChainTracePersistence = class {
     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();
@@ -1285,6 +1303,7 @@ var AgentInspectCallback = class extends base.BaseCallbackHandler {
       knownRelationshipCount: 0,
       syntheticGroupCount: 0,
       selfParentRejectedCount: 0,
+      ambiguousRelationshipCount: 0,
       envelopeStarted: false,
       finalized: false,
       completionGeneration: 0,