agent-inspect 6.12.2 → 6.14.0

package/packages/cli/dist/index.cjs

@@ -4346,6 +4346,7 @@ function buildEvidenceManifest(parts) {
       verificationPolicy: parts.verificationPolicy ?? parts.redactionProfile
     },
     assessment,
+    ...parts.semantics !== void 0 ? { semantics: { ...parts.semantics } } : {},
     files: buildEvidenceFileEntries(parts.files)
   };
 }
@@ -5986,7 +5987,8 @@ function buildEvidenceCiPackage(input3) {
     sourceStatus: input3.sourceStatus,
     files: packaged,
     createdAt,
-    note: EVIDENCE_ASSESSMENT_NOTE
+    note: EVIDENCE_ASSESSMENT_NOTE,
+    ...input3.semantics !== void 0 ? { semantics: input3.semantics } : {}
   });
   return {
     "evidence.html": evidenceHtml,
@@ -6548,11 +6550,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;
@@ -6610,6 +6617,35 @@ var init_logical_events = __esm({
   }
 });
 
+// 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
+  };
+}
+var init_trace_facts = __esm({
+  "packages/core/src/checks/trace-facts.ts"() {
+    init_logical_events();
+  }
+});
+
 // packages/core/src/checks/contract.ts
 var init_contract = __esm({
   "packages/core/src/checks/contract.ts"() {
@@ -8026,6 +8062,7 @@ var init_checks2 = __esm({
     init_outcomes();
     init_logical_events();
     init_logical_events();
+    init_trace_facts();
     init_contract();
     SEVERITY_RANK = {
       error: 0,
@@ -12156,7 +12193,7 @@ var init_src = __esm({
 });
 
 // package.json
-var version = "6.12.2";
+var version = "6.14.0";
 
 // packages/cli/src/list.ts
 init_advanced();
@@ -20841,6 +20878,7 @@ async function artifactsCommand(target, options = {}, stdin = process.stdin) {
           findings: check.findings.length
         }))
       });
+      const parity = summarizeSemanticParity(read.events);
       const evidencePackage = buildEvidenceCiPackage({
         generatorVersion: version,
         runIds,
@@ -20849,7 +20887,18 @@ async function artifactsCommand(target, options = {}, stdin = process.stdin) {
         redactionProfile: "strict",
         assessmentStatus: toEvidenceStatus(status),
         checkResultsJson,
-        summaryText: renderMarkdown(trace, check, diff)
+        summaryText: renderMarkdown(trace, check, diff),
+        semantics: {
+          projectionVersion: "logical-lifecycle-0.1",
+          rawEventCount: parity.rawEventCount,
+          logicalEventCount: parity.logicalEventCount,
+          runningLogicalCount: parity.runningLogicalCount,
+          finishedToolCount: parity.finishedToolCount,
+          finishedToolNames: [...parity.finishedToolNames],
+          pairedCount: parity.pairedCount,
+          parentRemapCount: parity.parentRemapCount,
+          contractStatus: check.status === "pass" ? "pass" : check.status === "fail" ? "fail" : "error"
+        }
       });
       await writeArtifact(outputDir, "evidence.html", evidencePackage["evidence.html"], files);
       await writeArtifact(outputDir, "evidence.json", evidencePackage["evidence.json"], files);
@@ -21936,11 +21985,11 @@ var TRACE_DIR = ".agent-inspect";
 var GITKEEP = ".agent-inspect/.gitkeep";
 function normalizeFramework(value) {
   const raw = (value ?? "custom").trim();
-  if (raw === "ai-sdk" || raw === "openai-agents" || raw === "langchain" || raw === "custom") {
+  if (raw === "ai-sdk" || raw === "openai-agents" || raw === "langchain" || raw === "langgraph" || raw === "custom") {
     return raw;
   }
   throw new Error(
-    "Unsupported --framework value. Use ai-sdk, openai-agents, langchain, or custom."
+    "Unsupported --framework value. Use ai-sdk, openai-agents, langchain, langgraph, or custom."
   );
 }
 function configTemplate(framework) {
@@ -22013,6 +22062,30 @@ async function main() {
   console.log("Trace written to .agent-inspect/");
 }
 
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+`;
+    case "langgraph":
+      return `/**
+ * LangGraph onboarding starter \u2014 no provider keys.
+ * Prefer @agent-inspect/langchain callbacks with your StateGraph in app code.
+ * This demo writes a bridged tool lifecycle you can check/gate locally.
+ */
+import { inspectRun, step } from "agent-inspect";
+
+async function main() {
+  await inspectRun("langgraph-demo", async () => {
+    await step("chain:agent", async () => {
+      await step.tool("lookup_orders", async () => ({ orders: 0 }));
+      return { ok: true };
+    });
+  }, { traceDir: ".agent-inspect", silent: true });
+  console.log("Trace written to .agent-inspect/");
+  console.log("Next: npx agent-inspect check <run-id> --required-tool lookup_orders");
+}
+
 main().catch((error) => {
   console.error(error);
   process.exitCode = 1;
@@ -22168,7 +22241,8 @@ var OPTIONAL_PACKAGES = {
   custom: [],
   "ai-sdk": ["@agent-inspect/ai-sdk"],
   "openai-agents": ["@agent-inspect/openai-agents"],
-  langchain: ["@agent-inspect/langchain"]
+  langchain: ["@agent-inspect/langchain"],
+  langgraph: ["@agent-inspect/langchain"]
 };
 function nodeVersionCheck() {
   const major = Number(process3__default.default.versions.node.split(".")[0]);
@@ -23998,6 +24072,7 @@ function createCliProgram() {
       "ai-sdk",
       "openai-agents",
       "langchain",
+      "langgraph",
       "custom"
     ])
   ).addOption(new commander.Option("--ci <provider>", "optional CI snippet").choices(["github"])).option("--dry-run", "print planned files without writing").option("--yes", "non-interactive; skip existing files").option("--json", "print deterministic JSON plan/result").action((opts) => {
@@ -24008,6 +24083,7 @@ function createCliProgram() {
       "ai-sdk",
       "openai-agents",
       "langchain",
+      "langgraph",
       "custom"
     ])
   ).action((opts) => {