agent-inspect 6.12.2 → 6.13.0

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

@@ -7,7 +7,7 @@ import { P as PersistedInspectEvent } from './persisted-inspect-event-d-mSP8kd.c
 import { Stats } from 'node:fs';
 import { b as ObservedOutcome } from './types-B562HgN_.cjs';
 export { O as ObservedOutcomeStatus } from './types-B562HgN_.cjs';
-import { a as TraceCheckResult, J as TraceCheckStatus } from './index-BOP33T4O.cjs';
+import { b as TraceCheckResult, J as TraceCheckStatus } from './index-CmXMS-MF.cjs';
 import './writers.cjs';
 import './log-config-BG1WmWf2.cjs';
 import './readers.cjs';

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

@@ -7,7 +7,7 @@ import { P as PersistedInspectEvent } from './persisted-inspect-event-ChE7pGb7.j
 import { Stats } from 'node:fs';
 import { b as ObservedOutcome } from './types-B562HgN_.js';
 export { O as ObservedOutcomeStatus } from './types-B562HgN_.js';
-import { a as TraceCheckResult, J as TraceCheckStatus } from './index-CgCH8NE9.js';
+import { b as TraceCheckResult, J as TraceCheckStatus } from './index-Bu_vOjql.js';
 import './writers.js';
 import './log-config-Ck0aT_Ou.js';
 import './readers.js';

package/packages/core/dist/advanced.mjs

@@ -1,4 +1,4 @@
-import { runTraceChecks, createRunStatusRule, createToolUsageRule, createRunDurationRule, createLlmUsageRule, createObservedOutcomeRule } from './chunk-KJICERSD.mjs';
+import { runTraceChecks, createRunStatusRule, createToolUsageRule, createRunDurationRule, createLlmUsageRule, createObservedOutcomeRule } from './chunk-BS2QCAJX.mjs';
 export { MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, TERMINAL_INDENT, TraceDirectory, createInspector, createInspectorRuntime, formatTerminalName, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getIndent, getParentStepId, getTraceDirFromContext, getTraceSafetyFromContext, hasActiveContext, isAgentInspectEnabled, isSilentContext, maybeInspectRun, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveTraceDir, runWithContext, runWithStepContext } from './chunk-ZWA5RWMV.mjs';
 import { buildRunTimeline, filterTraces, extractMetadata, buildRunSummary } from './chunk-LFWZEO2L.mjs';
 export { buildRunSummary, buildRunTimeline, buildRunWhatSummary, buildTraceStats, extractMetadata, filterTraces, renderRunWhat, renderTimeline, renderTraceStats } from './chunk-LFWZEO2L.mjs';

package/packages/core/dist/checks.cjs

@@ -260,11 +260,16 @@ function projectLogicalEvents(events) {
     }
     if (!remapped) {
       if (!logicalById.has(originalParentId) && !logicalByRawId.has(originalParentId)) {
-        diagnostics.push({
-          code: "AI_LOGICAL_PARENT_UNRESOLVED",
-          message: `Parent ${originalParentId} unresolved for ${event.eventId}.`,
-          eventIds: [event.eventId]
-        });
+        const mapping = event.attributes?.parentMapping;
+        const unresolved = mapping === "unresolved" || event.attributes?.parentUnresolved === true || event.attributes?.unresolvedParent === true || // LangGraph/framework scaffolding sentinel labels are not event ids.
+        /^LangGraph$/i.test(originalParentId) || originalParentId.startsWith("unresolved:");
+        if (!unresolved) {
+          diagnostics.push({
+            code: "AI_LOGICAL_PARENT_UNRESOLVED",
+            message: `Parent ${originalParentId} unresolved for ${event.eventId}.`,
+            eventIds: [event.eventId]
+          });
+        }
       }
       normalized.push(event);
       continue;
@@ -318,6 +323,62 @@ function pickString(record, keys) {
   return void 0;
 }
 
+// packages/core/src/checks/trace-facts.ts
+function summarizeSemanticParity(events) {
+  const projection = projectLogicalEvents(events);
+  const logical = projection.logicalEvents;
+  const finishedTools = logical.filter(
+    (event) => event.kind === "TOOL" && event.status !== "running"
+  );
+  const finishedToolNames = Object.freeze(
+    finishedTools.map((event) => resolveCanonicalToolName(event)).sort((a, b) => a.localeCompare(b))
+  );
+  return {
+    rawEventCount: events.length,
+    logicalEventCount: logical.length,
+    runningLogicalCount: logical.filter((event) => event.status === "running").length,
+    finishedToolNames,
+    finishedToolCount: finishedTools.length,
+    pairedCount: logical.filter((event) => event.projection.paired).length,
+    parentRemapCount: projection.diagnostics.filter(
+      (item) => item.code === "AI_LOGICAL_PARENT_REMAPPED"
+    ).length,
+    diagnostics: projection.diagnostics
+  };
+}
+function buildTraceFacts(events) {
+  const projection = projectLogicalEvents(events);
+  const toolsByName = /* @__PURE__ */ new Map();
+  const llmEvents = [];
+  const outcomeEvents = [];
+  for (const event of projection.logicalEvents) {
+    if (event.kind === "TOOL" && event.status !== "running") {
+      const name = resolveCanonicalToolName(event);
+      const list = toolsByName.get(name) ?? [];
+      list.push(event);
+      toolsByName.set(name, list);
+    }
+    if (event.kind === "LLM" && event.status !== "running") {
+      llmEvents.push(event);
+    }
+    if (event.kind === "OUTCOME") {
+      outcomeEvents.push(event);
+    }
+  }
+  for (const [name, list] of [...toolsByName.entries()]) {
+    toolsByName.set(name, Object.freeze([...list]));
+  }
+  return {
+    rawEvents: Object.freeze([...events]),
+    logicalEvents: projection.logicalEvents,
+    diagnostics: projection.diagnostics,
+    toolsByName,
+    llmEvents: Object.freeze(llmEvents),
+    outcomeEvents: Object.freeze(outcomeEvents),
+    summary: summarizeSemanticParity(events)
+  };
+}
+
 // packages/core/src/checks/contract.ts
 function contractFailFinding(ruleId, message, evidence, expected, actual) {
   return {
@@ -409,10 +470,18 @@ function contractToRules(contract) {
     rules.push(createStructureIncompleteRule({ requireEndedAtForStarted: true }));
   }
   if (contract.tools) {
+    const required = [
+      ...contract.tools.required ?? [],
+      ...contract.tools.requiredTools ?? []
+    ];
+    const forbidden = [
+      ...contract.tools.forbidden ?? [],
+      ...contract.tools.forbiddenTools ?? []
+    ];
     rules.push(
       createToolUsageRule({
-        ...contract.tools.required ? { required: contract.tools.required } : {},
-        ...contract.tools.forbidden ? { forbidden: contract.tools.forbidden } : {},
+        ...required.length > 0 ? { required } : {},
+        ...forbidden.length > 0 ? { forbidden } : {},
         ...contract.tools.allowed ? { allowed: contract.tools.allowed } : {},
         ...contract.tools.maxCalls !== void 0 ? { maxCount: contract.tools.maxCalls } : {}
       })
@@ -2226,6 +2295,7 @@ function runTraceChecks(input, options = {}) {
   };
 }
 
+exports.buildTraceFacts = buildTraceFacts;
 exports.createBaselineRegressionRule = createBaselineRegressionRule;
 exports.createDecisionRule = createDecisionRule;
 exports.createGuardrailRule = createGuardrailRule;
@@ -2256,5 +2326,6 @@ exports.evaluateTraceContract = evaluateTraceContract;
 exports.projectLogicalEvents = projectLogicalEvents;
 exports.resolveCanonicalToolName = resolveCanonicalToolName;
 exports.runTraceChecks = runTraceChecks;
+exports.summarizeSemanticParity = summarizeSemanticParity;
 //# sourceMappingURL=checks.cjs.map
 //# sourceMappingURL=checks.cjs.map