@agent-inspect/langchain 6.14.2 → 6.15.0

package/dist/index.d.cts

@@ -99,6 +99,7 @@ declare class AgentInspectCallback extends BaseCallbackHandler {
         knownRelationshipCount: number;
         syntheticGroupCount: number;
         selfParentRejectedCount: number;
+        ambiguousRelationshipCount: number;
         envelopeStarted: boolean;
         finalized: boolean;
         completionGeneration: number;
@@ -172,6 +173,7 @@ interface AdapterPersistenceDiagnostics {
     readonly knownRelationshipCount: number;
     readonly syntheticGroupCount: number;
     readonly selfParentRejectedCount: number;
+    readonly ambiguousRelationshipCount: number;
     readonly envelopeStarted: boolean;
     readonly finalized: boolean;
     readonly completionGeneration: number;

package/dist/index.d.ts

@@ -99,6 +99,7 @@ declare class AgentInspectCallback extends BaseCallbackHandler {
         knownRelationshipCount: number;
         syntheticGroupCount: number;
         selfParentRejectedCount: number;
+        ambiguousRelationshipCount: number;
         envelopeStarted: boolean;
         finalized: boolean;
         completionGeneration: number;
@@ -172,6 +173,7 @@ interface AdapterPersistenceDiagnostics {
     readonly knownRelationshipCount: number;
     readonly syntheticGroupCount: number;
     readonly selfParentRejectedCount: number;
+    readonly ambiguousRelationshipCount: number;
     readonly envelopeStarted: boolean;
     readonly finalized: boolean;
     readonly completionGeneration: number;

package/dist/index.mjs

@@ -563,6 +563,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 };
@@ -577,6 +578,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;
@@ -638,6 +649,7 @@ var LangChainTracePersistence = class {
   #semanticParentCounts = /* @__PURE__ */ new Map();
   #lateEventCount = 0;
   #selfParentRejectedCount = 0;
+  #ambiguousRelationshipCount = 0;
   constructor(options = {}) {
     const inContext = hasActiveContext();
     this.#standalone = !inContext;
@@ -676,6 +688,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,
@@ -691,6 +704,8 @@ var LangChainTracePersistence = class {
     );
     if (guarded.rejected) {
       this.#selfParentRejectedCount += 1;
+    } else if (applyAmbiguousScaffoldingDiagnostic(resolution, metadata)) {
+      this.#ambiguousRelationshipCount += 1;
     }
     return guarded.parentStepId;
   }
@@ -707,6 +722,7 @@ var LangChainTracePersistence = class {
         this.#clearStepIndexes();
         this.#lateEventCount = 0;
         this.#selfParentRejectedCount = 0;
+        this.#ambiguousRelationshipCount = 0;
         return;
       }
     }
@@ -715,12 +731,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();
@@ -1279,6 +1297,7 @@ var AgentInspectCallback = class extends BaseCallbackHandler {
       knownRelationshipCount: 0,
       syntheticGroupCount: 0,
       selfParentRejectedCount: 0,
+      ambiguousRelationshipCount: 0,
       envelopeStarted: false,
       finalized: false,
       completionGeneration: 0,