agent-inspect 6.14.1 → 6.15.0

package/packages/core/dist/index-B259NKkH.d.cts

@@ -0,0 +1,102 @@
+import { a as InspectRunTree } from './inspect-event-DRthdZlf.cjs';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-CVZWZldL.cjs';
+
+type TraceInput = {
+    type: "file";
+    path: string;
+} | {
+    type: "directory";
+    path: string;
+} | {
+    type: "string";
+    content: string;
+} | {
+    type: "buffer";
+    content: Buffer;
+} | {
+    type: "stdin";
+};
+type TraceReadWarningSeverity = "info" | "warning" | "error";
+interface TraceReadWarning {
+    code: string;
+    message: string;
+    severity?: TraceReadWarningSeverity;
+    sourceFile?: string;
+    line?: number;
+    field?: string;
+}
+interface TraceReadResult {
+    format: string;
+    events: PersistedInspectEvent[];
+    runs: InspectRunTree[];
+    warnings: TraceReadWarning[];
+    unsupportedFields: string[];
+    sourceFiles: string[];
+}
+interface TraceFormatCandidate {
+    format: string;
+    confidence: number;
+    readerName?: string;
+    description?: string;
+    warnings?: TraceReadWarning[];
+}
+type TraceFormatDetectionStatus = "detected" | "ambiguous" | "unsupported";
+interface TraceFormatDetectionResult {
+    status: TraceFormatDetectionStatus;
+    format?: string;
+    candidates: TraceFormatCandidate[];
+    warnings: TraceReadWarning[];
+}
+interface TraceReaderDetectOptions {
+    format?: string;
+}
+interface TraceReaderReadOptions {
+    format?: string;
+}
+interface TraceReader {
+    readonly format: string;
+    readonly name?: string;
+    detect(input: TraceInput, options?: TraceReaderDetectOptions): TraceFormatCandidate | undefined | Promise<TraceFormatCandidate | undefined>;
+    read(input: TraceInput, options?: TraceReaderReadOptions): TraceReadResult | Promise<TraceReadResult>;
+}
+interface TraceReadOptions {
+    format?: string;
+    readers?: readonly TraceReader[];
+}
+type TraceReadErrorCode = "unsupported_format" | "ambiguous_format" | "reader_failed" | "invalid_input";
+declare class TraceReadError extends Error {
+    readonly code: TraceReadErrorCode;
+    readonly warnings: TraceReadWarning[];
+    constructor(code: TraceReadErrorCode, message: string, warnings?: TraceReadWarning[]);
+}
+/**
+ * Runtime guard for structured TraceInput. Never throws WeakMap key errors for bare strings.
+ */
+declare function assertTraceInput(input: unknown): asserts input is TraceInput;
+declare const openInferenceJsonReader: TraceReader;
+declare const otlpJsonReader: TraceReader;
+declare const agentInspectJsonlReader: TraceReader;
+declare const DEFAULT_TRACE_READERS: readonly TraceReader[];
+declare function detectTraceFormat(input: TraceInput, options?: TraceReadOptions): Promise<TraceFormatDetectionResult>;
+declare function readTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
+declare function openTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
+/**
+ * Open a single local trace file. Prefer this over passing a bare path string to `openTrace`.
+ *
+ * @experimental Additive convenience over `openTrace({ type: "file", path })`.
+ */
+declare function openTraceFile(filePath: string, options?: TraceReadOptions): Promise<TraceReadResult>;
+/**
+ * Open all `*.jsonl` files in a local directory (sorted, concatenated).
+ *
+ * @experimental Additive convenience over `openTrace({ type: "directory", path })`.
+ */
+declare function openTraceDirectory(dirPath: string, options?: TraceReadOptions): Promise<TraceReadResult>;
+/**
+ * Open an in-memory JSONL / supported text payload.
+ *
+ * @experimental Additive convenience over `openTrace({ type: "string", content })`.
+ */
+declare function openTraceText(content: string, options?: TraceReadOptions): Promise<TraceReadResult>;
+
+export { DEFAULT_TRACE_READERS as D, type TraceReadResult as T, type TraceReadWarning as a, type TraceFormatCandidate as b, type TraceFormatDetectionResult as c, type TraceFormatDetectionStatus as d, type TraceInput as e, TraceReadError as f, type TraceReadErrorCode as g, type TraceReadOptions as h, type TraceReadWarningSeverity as i, type TraceReader as j, type TraceReaderDetectOptions as k, type TraceReaderReadOptions as l, agentInspectJsonlReader as m, assertTraceInput as n, detectTraceFormat as o, openInferenceJsonReader as p, openTrace as q, openTraceDirectory as r, openTraceFile as s, openTraceText as t, otlpJsonReader as u, readTrace as v };

package/packages/core/dist/index-B9ZGvUVL.d.ts

@@ -0,0 +1,102 @@
+import { a as InspectRunTree } from './inspect-event-DRthdZlf.js';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-BVucFVrP.js';
+
+type TraceInput = {
+    type: "file";
+    path: string;
+} | {
+    type: "directory";
+    path: string;
+} | {
+    type: "string";
+    content: string;
+} | {
+    type: "buffer";
+    content: Buffer;
+} | {
+    type: "stdin";
+};
+type TraceReadWarningSeverity = "info" | "warning" | "error";
+interface TraceReadWarning {
+    code: string;
+    message: string;
+    severity?: TraceReadWarningSeverity;
+    sourceFile?: string;
+    line?: number;
+    field?: string;
+}
+interface TraceReadResult {
+    format: string;
+    events: PersistedInspectEvent[];
+    runs: InspectRunTree[];
+    warnings: TraceReadWarning[];
+    unsupportedFields: string[];
+    sourceFiles: string[];
+}
+interface TraceFormatCandidate {
+    format: string;
+    confidence: number;
+    readerName?: string;
+    description?: string;
+    warnings?: TraceReadWarning[];
+}
+type TraceFormatDetectionStatus = "detected" | "ambiguous" | "unsupported";
+interface TraceFormatDetectionResult {
+    status: TraceFormatDetectionStatus;
+    format?: string;
+    candidates: TraceFormatCandidate[];
+    warnings: TraceReadWarning[];
+}
+interface TraceReaderDetectOptions {
+    format?: string;
+}
+interface TraceReaderReadOptions {
+    format?: string;
+}
+interface TraceReader {
+    readonly format: string;
+    readonly name?: string;
+    detect(input: TraceInput, options?: TraceReaderDetectOptions): TraceFormatCandidate | undefined | Promise<TraceFormatCandidate | undefined>;
+    read(input: TraceInput, options?: TraceReaderReadOptions): TraceReadResult | Promise<TraceReadResult>;
+}
+interface TraceReadOptions {
+    format?: string;
+    readers?: readonly TraceReader[];
+}
+type TraceReadErrorCode = "unsupported_format" | "ambiguous_format" | "reader_failed" | "invalid_input";
+declare class TraceReadError extends Error {
+    readonly code: TraceReadErrorCode;
+    readonly warnings: TraceReadWarning[];
+    constructor(code: TraceReadErrorCode, message: string, warnings?: TraceReadWarning[]);
+}
+/**
+ * Runtime guard for structured TraceInput. Never throws WeakMap key errors for bare strings.
+ */
+declare function assertTraceInput(input: unknown): asserts input is TraceInput;
+declare const openInferenceJsonReader: TraceReader;
+declare const otlpJsonReader: TraceReader;
+declare const agentInspectJsonlReader: TraceReader;
+declare const DEFAULT_TRACE_READERS: readonly TraceReader[];
+declare function detectTraceFormat(input: TraceInput, options?: TraceReadOptions): Promise<TraceFormatDetectionResult>;
+declare function readTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
+declare function openTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
+/**
+ * Open a single local trace file. Prefer this over passing a bare path string to `openTrace`.
+ *
+ * @experimental Additive convenience over `openTrace({ type: "file", path })`.
+ */
+declare function openTraceFile(filePath: string, options?: TraceReadOptions): Promise<TraceReadResult>;
+/**
+ * Open all `*.jsonl` files in a local directory (sorted, concatenated).
+ *
+ * @experimental Additive convenience over `openTrace({ type: "directory", path })`.
+ */
+declare function openTraceDirectory(dirPath: string, options?: TraceReadOptions): Promise<TraceReadResult>;
+/**
+ * Open an in-memory JSONL / supported text payload.
+ *
+ * @experimental Additive convenience over `openTrace({ type: "string", content })`.
+ */
+declare function openTraceText(content: string, options?: TraceReadOptions): Promise<TraceReadResult>;
+
+export { DEFAULT_TRACE_READERS as D, type TraceReadResult as T, type TraceReadWarning as a, type TraceFormatCandidate as b, type TraceFormatDetectionResult as c, type TraceFormatDetectionStatus as d, type TraceInput as e, TraceReadError as f, type TraceReadErrorCode as g, type TraceReadOptions as h, type TraceReadWarningSeverity as i, type TraceReader as j, type TraceReaderDetectOptions as k, type TraceReaderReadOptions as l, agentInspectJsonlReader as m, assertTraceInput as n, detectTraceFormat as o, openInferenceJsonReader as p, openTrace as q, openTraceDirectory as r, openTraceFile as s, openTraceText as t, otlpJsonReader as u, readTrace as v };

package/packages/core/dist/{index-Bu_vOjql.d.ts → index-BsCcOKxy.d.ts}

@@ -1,6 +1,6 @@
-import { TraceReadResult, TraceReadWarning } from './readers.js';
-import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DVg84S4v.js';
-import { P as PersistedInspectEvent } from './persisted-inspect-event-ChE7pGb7.js';
+import { T as TraceReadResult, a as TraceReadWarning } from './index-B9ZGvUVL.js';
+import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DRthdZlf.js';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-BVucFVrP.js';
 import { O as ObservedOutcomeStatus } from './types-B562HgN_.js';
 
 /**
@@ -19,7 +19,7 @@ import { O as ObservedOutcomeStatus } from './types-B562HgN_.js';
  * @experimental
  */
 interface LogicalProjectionDiagnostic {
-    code: "AI_LOGICAL_PAIR_AMBIGUOUS" | "AI_LOGICAL_PAIR_UNMATCHED_START" | "AI_LOGICAL_PAIR_UNMATCHED_COMPLETE" | "AI_LOGICAL_PARENT_REMAPPED" | "AI_LOGICAL_PARENT_UNRESOLVED";
+    code: "AI_LOGICAL_PAIR_AMBIGUOUS" | "AI_LOGICAL_PAIR_UNMATCHED_START" | "AI_LOGICAL_PAIR_UNMATCHED_COMPLETE" | "AI_LOGICAL_PARENT_REMAPPED" | "AI_LOGICAL_PARENT_UNRESOLVED" | "AI_LOGICAL_SELF_PARENT_REMOVED";
     message: string;
     eventIds?: readonly string[];
 }

package/packages/core/dist/{index-CmXMS-MF.d.cts → index-Xk9X-yjY.d.cts}

@@ -1,6 +1,6 @@
-import { TraceReadResult, TraceReadWarning } from './readers.cjs';
-import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DVg84S4v.cjs';
-import { P as PersistedInspectEvent } from './persisted-inspect-event-d-mSP8kd.cjs';
+import { T as TraceReadResult, a as TraceReadWarning } from './index-B259NKkH.cjs';
+import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DRthdZlf.cjs';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-CVZWZldL.cjs';
 import { O as ObservedOutcomeStatus } from './types-B562HgN_.cjs';
 
 /**
@@ -19,7 +19,7 @@ import { O as ObservedOutcomeStatus } from './types-B562HgN_.cjs';
  * @experimental
  */
 interface LogicalProjectionDiagnostic {
-    code: "AI_LOGICAL_PAIR_AMBIGUOUS" | "AI_LOGICAL_PAIR_UNMATCHED_START" | "AI_LOGICAL_PAIR_UNMATCHED_COMPLETE" | "AI_LOGICAL_PARENT_REMAPPED" | "AI_LOGICAL_PARENT_UNRESOLVED";
+    code: "AI_LOGICAL_PAIR_AMBIGUOUS" | "AI_LOGICAL_PAIR_UNMATCHED_START" | "AI_LOGICAL_PAIR_UNMATCHED_COMPLETE" | "AI_LOGICAL_PARENT_REMAPPED" | "AI_LOGICAL_PARENT_UNRESOLVED" | "AI_LOGICAL_SELF_PARENT_REMOVED";
     message: string;
     eventIds?: readonly string[];
 }

package/packages/core/dist/index.d.cts

@@ -1,10 +1,10 @@
-import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types-BLX3tiOW.cjs';
-export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, T as TokenMetadata, g as TraceCorrelationMetadata } from './types-BLX3tiOW.cjs';
-export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-BHAgRjOe.cjs';
+import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types-UnrNaTo2.cjs';
+export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, T as TokenMetadata, g as TraceCorrelationMetadata } from './types-UnrNaTo2.cjs';
+export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-Ca5yK8Cs.cjs';
 import { a as ObserveOutcomeOptions } from './types-B562HgN_.cjs';
-import './log-config-BG1WmWf2.cjs';
-import './inspect-event-DVg84S4v.cjs';
-import './persisted-inspect-event-d-mSP8kd.cjs';
+import './log-config-CFlIJHTf.cjs';
+import './inspect-event-DRthdZlf.cjs';
+import './persisted-inspect-event-CVZWZldL.cjs';
 import './writers.cjs';
 
 /**

package/packages/core/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types-MuwXSJ4b.js';
-export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, T as TokenMetadata, g as TraceCorrelationMetadata } from './types-MuwXSJ4b.js';
-export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-Blyjb5my.js';
+import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types--ainI31J.js';
+export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, T as TokenMetadata, g as TraceCorrelationMetadata } from './types--ainI31J.js';
+export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-D6cS4XIL.js';
 import { a as ObserveOutcomeOptions } from './types-B562HgN_.js';
-import './log-config-Ck0aT_Ou.js';
-import './inspect-event-DVg84S4v.js';
-import './persisted-inspect-event-ChE7pGb7.js';
+import './log-config-OZRfpHED.js';
+import './inspect-event-DRthdZlf.js';
+import './persisted-inspect-event-BVucFVrP.js';
 import './writers.js';
 
 /**

package/packages/core/dist/{inspect-event-DVg84S4v.d.cts → inspect-event-DRthdZlf.d.cts}

@@ -23,6 +23,14 @@ interface InspectNode {
     children: InspectNode[];
     depth: number;
 }
+/** Bounded parent/cycle summary for visibility-first tree building (6.14.2+). */
+interface RelationshipSummary {
+    rootCount: number;
+    selfParentCount: number;
+    cycleCount: number;
+    unresolvedParentCount: number;
+    normalizedEdgeCount: number;
+}
 interface InspectRunTree {
     runId: string;
     name?: string;
@@ -35,6 +43,7 @@ interface InspectRunTree {
         totalEvents: number;
         confidenceBreakdown: Record<AttributionConfidence, number>;
         kinds: Record<InspectKind, number>;
+        relationshipSummary?: RelationshipSummary;
     };
 }
 

package/packages/core/dist/{inspect-event-DVg84S4v.d.ts → inspect-event-DRthdZlf.d.ts}

@@ -23,6 +23,14 @@ interface InspectNode {
     children: InspectNode[];
     depth: number;
 }
+/** Bounded parent/cycle summary for visibility-first tree building (6.14.2+). */
+interface RelationshipSummary {
+    rootCount: number;
+    selfParentCount: number;
+    cycleCount: number;
+    unresolvedParentCount: number;
+    normalizedEdgeCount: number;
+}
 interface InspectRunTree {
     runId: string;
     name?: string;
@@ -35,6 +43,7 @@ interface InspectRunTree {
         totalEvents: number;
         confidenceBreakdown: Record<AttributionConfidence, number>;
         kinds: Record<InspectKind, number>;
+        relationshipSummary?: RelationshipSummary;
     };
 }
 

package/packages/core/dist/{log-config-BG1WmWf2.d.cts → log-config-CFlIJHTf.d.cts}

@@ -1,4 +1,4 @@
-import { I as InspectKind } from './inspect-event-DVg84S4v.cjs';
+import { I as InspectKind } from './inspect-event-DRthdZlf.cjs';
 
 interface LogEventMapping {
     kind?: InspectKind;

package/packages/core/dist/{log-config-Ck0aT_Ou.d.ts → log-config-OZRfpHED.d.ts}

@@ -1,4 +1,4 @@
-import { I as InspectKind } from './inspect-event-DVg84S4v.js';
+import { I as InspectKind } from './inspect-event-DRthdZlf.js';
 
 interface LogEventMapping {
     kind?: InspectKind;

package/packages/core/dist/logs.cjs

@@ -634,6 +634,20 @@ var EventNormalizer = class {
 function inc(map, key) {
   map[key] = (map[key] ?? 0) + 1;
 }
+function confidenceRank(confidence) {
+  switch (confidence) {
+    case "unknown":
+      return 0;
+    case "heuristic":
+      return 1;
+    case "correlated":
+      return 2;
+    case "explicit":
+      return 3;
+    default:
+      return 0;
+  }
+}
 function computeRunStatus(events) {
   let runTerminal;
   let sawRunEvent = false;
@@ -654,6 +668,84 @@ function computeRunStatus(events) {
   }
   return hasRunning ? "running" : "ok";
 }
+function linkNodesVisibilityFirst(nodes) {
+  let selfParentCount = 0;
+  let unresolvedParentCount = 0;
+  let normalizedEdgeCount = 0;
+  let cycleCount = 0;
+  const pending = [];
+  for (const node of nodes.values()) {
+    const parentId = node.event.parentId;
+    if (!parentId) continue;
+    if (parentId === node.event.eventId) {
+      selfParentCount += 1;
+      normalizedEdgeCount += 1;
+      continue;
+    }
+    if (!nodes.has(parentId)) {
+      unresolvedParentCount += 1;
+      continue;
+    }
+    pending.push({
+      childId: node.event.eventId,
+      parentId,
+      childTimestamp: node.event.timestamp,
+      childConfidence: node.event.confidence
+    });
+  }
+  pending.sort((a, b) => {
+    const conf = confidenceRank(b.childConfidence) - confidenceRank(a.childConfidence);
+    if (conf !== 0) return conf;
+    return a.childTimestamp - b.childTimestamp;
+  });
+  const parentOf = /* @__PURE__ */ new Map();
+  for (const edge of pending) {
+    parentOf.set(edge.childId, edge.parentId);
+    let cursor = edge.parentId;
+    const seen = /* @__PURE__ */ new Set([edge.childId]);
+    let cyclic = false;
+    while (cursor) {
+      if (seen.has(cursor)) {
+        cyclic = true;
+        break;
+      }
+      seen.add(cursor);
+      cursor = parentOf.get(cursor);
+    }
+    if (cyclic) {
+      parentOf.delete(edge.childId);
+      cycleCount += 1;
+      normalizedEdgeCount += 1;
+    }
+  }
+  for (const [childId, parentId] of parentOf) {
+    nodes.get(parentId).children.push(nodes.get(childId));
+  }
+  const roots = [];
+  for (const node of nodes.values()) {
+    if (!parentOf.has(node.event.eventId)) {
+      roots.push(node);
+    }
+  }
+  const assignDepth = (n, depth, stack) => {
+    if (stack.has(n.event.eventId)) return;
+    n.depth = depth;
+    stack.add(n.event.eventId);
+    for (const c of n.children) assignDepth(c, depth + 1, stack);
+    stack.delete(n.event.eventId);
+  };
+  for (const r of roots) assignDepth(r, 0, /* @__PURE__ */ new Set());
+  return {
+    roots,
+    summary: {
+      rootCount: roots.length,
+      selfParentCount,
+      cycleCount,
+      unresolvedParentCount,
+      normalizedEdgeCount
+    }
+  };
+}
 var TreeBuilder = class {
   constructor(options) {
     void options?.config;
@@ -671,20 +763,7 @@ var TreeBuilder = class {
       for (const e of sorted) {
         nodes.set(e.eventId, { event: e, children: [], depth: 0 });
       }
-      const roots = [];
-      for (const node of nodes.values()) {
-        const parentId = node.event.parentId;
-        if (parentId && nodes.has(parentId)) {
-          nodes.get(parentId).children.push(node);
-        } else {
-          roots.push(node);
-        }
-      }
-      const assignDepth = (n, depth) => {
-        n.depth = depth;
-        for (const c of n.children) assignDepth(c, depth + 1);
-      };
-      for (const r of roots) assignDepth(r, 0);
+      const { roots, summary } = linkNodesVisibilityFirst(nodes);
       const confidenceBreakdown = {
         explicit: 0,
         correlated: 0,
@@ -712,7 +791,8 @@ var TreeBuilder = class {
         metadata: {
           totalEvents: sorted.length,
           confidenceBreakdown,
-          kinds
+          kinds,
+          relationshipSummary: summary
         }
       });
     }