agent-inspect 6.12.2 → 6.14.0

package/packages/cli/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createSafetyRawContentRule, createSafetyRedactionRule, createSafetySecretPatternRule, createSafetyOversizedAttributeRule, resolveTraceDir, parseDuration, buildSessionIndex, resolveBundleRunIds, getTraceFilePath, openTrace, sha256Hex, collectTraceSchemaVersions, aggregateBundleSafeStatus, bundleFailsOnSafety, bundleRunAssetRelativePath, buildPlaceholderArtifact, EVIDENCE_HTML_FILENAME, EVIDENCE_MANIFEST_FILENAME, buildBundleMetadata, buildBundleSummaryMarkdown, buildEvidenceHtmlShell, buildEvidenceProvenanceViewHtml, EVIDENCE_FORMAT_VERSION, inferEvidenceFileRole, buildEvidenceSafetyViewHtml, buildEvidenceDiffViewHtml, buildEvidenceCircuitViewHtml, buildEvidenceOutcomesViewHtml, buildEvidenceContractsViewHtml, buildEvidenceToolsLlmViewHtml, buildEvidenceCausalFailureViewHtml, buildEvidenceTimelineViewHtml, buildEvidenceTreeViewHtml, buildEvidenceManifest, serializeEvidenceManifest, buildZipArchive, assertBundlePathContained, enrichSessionRunRecord, normalizeBundleOutputPath, sanitizeBundleRunId, defaultBundleOutputPath, runTraceChecks, assertEvidenceRelativePath, TraceDirectory, loadTraceMetadataList, loadSessionRunRecords, TraceReadError, resolveRedactionProfile, applyProfileMetadataCaps, Redactor, flattenTree, escapeHtml, safeString, compactAttributes, stableJson, escapeMarkdown, truncateStringForProfile, extractMetadata, filterTraces, truncateName, buildRunSummary, formatDuration, formatTimestamp, isAgentInspectTrace, filterMetasBySessionScope, aggregateSessionCheckResults, createBaselineRegressionRule, buildEvidenceCiPackage, verifyEvidenceDirectory, diffTraceEvents, renderRunDiff, buildRunTimeline, renderTimeline, buildTraceStats, renderTraceStats, parseDurationFilter, searchTraces, buildActivitySummary, renderActivitySummaryHuman, buildRunWhatSummary, renderRunWhat, buildLocalExplanation, resolveSuiteTemplate, defaultSuiteConfigTemplate, loadSuiteConfig, validateSuiteConfig, runSuite, renderSuiteReport, analyzeCohort, renderCohortReport, gateHasThresholds, runGate, renderGateReport, persistedInspectEventsToTraceEvents, renderStepLine, renderErrorLine, getIndent, TreeBuilder, zeroKinds, validateEvent, traceEventToPersistedInspectEvent, isPersistedInspectEvent, createRunStatusRule, createStructureOrphanRule, createStructureCycleRule, createRunDurationRule, createMaxStepDurationRule, createRequireCompletedRule, createStallDetectionRule, createObservedOutcomeRule, createRunDepthRule, createToolUsageRule, createLlmUsageRule, createStructureRelationshipRule, createStructureParallelWidthRule, summarizeObservedOutcomes, extractOutcomesFromTraceEvents, renderObservedOutcomesMarkdown, renderObservedOutcomesHtml, DEFAULT_SUITE_ARTIFACTS_DIR, parseCohortMetricList, COHORT_METRIC_IDS, parseGateList, nanoid, diffRuns, manualTraceEventsToComparableRun } from './chunk-4WA7DQCM.mjs';
+import { createSafetyRawContentRule, createSafetyRedactionRule, createSafetySecretPatternRule, createSafetyOversizedAttributeRule, resolveTraceDir, parseDuration, buildSessionIndex, resolveBundleRunIds, getTraceFilePath, openTrace, sha256Hex, collectTraceSchemaVersions, aggregateBundleSafeStatus, bundleFailsOnSafety, bundleRunAssetRelativePath, buildPlaceholderArtifact, EVIDENCE_HTML_FILENAME, EVIDENCE_MANIFEST_FILENAME, buildBundleMetadata, buildBundleSummaryMarkdown, buildEvidenceHtmlShell, buildEvidenceProvenanceViewHtml, EVIDENCE_FORMAT_VERSION, inferEvidenceFileRole, buildEvidenceSafetyViewHtml, buildEvidenceDiffViewHtml, buildEvidenceCircuitViewHtml, buildEvidenceOutcomesViewHtml, buildEvidenceContractsViewHtml, buildEvidenceToolsLlmViewHtml, buildEvidenceCausalFailureViewHtml, buildEvidenceTimelineViewHtml, buildEvidenceTreeViewHtml, buildEvidenceManifest, serializeEvidenceManifest, buildZipArchive, assertBundlePathContained, enrichSessionRunRecord, normalizeBundleOutputPath, sanitizeBundleRunId, defaultBundleOutputPath, runTraceChecks, assertEvidenceRelativePath, TraceDirectory, loadTraceMetadataList, loadSessionRunRecords, TraceReadError, resolveRedactionProfile, applyProfileMetadataCaps, Redactor, flattenTree, escapeHtml, safeString, compactAttributes, stableJson, escapeMarkdown, truncateStringForProfile, extractMetadata, filterTraces, truncateName, buildRunSummary, formatDuration, formatTimestamp, isAgentInspectTrace, filterMetasBySessionScope, aggregateSessionCheckResults, createBaselineRegressionRule, summarizeSemanticParity, buildEvidenceCiPackage, verifyEvidenceDirectory, diffTraceEvents, renderRunDiff, buildRunTimeline, renderTimeline, buildTraceStats, renderTraceStats, parseDurationFilter, searchTraces, buildActivitySummary, renderActivitySummaryHuman, buildRunWhatSummary, renderRunWhat, buildLocalExplanation, resolveSuiteTemplate, defaultSuiteConfigTemplate, loadSuiteConfig, validateSuiteConfig, runSuite, renderSuiteReport, analyzeCohort, renderCohortReport, gateHasThresholds, runGate, renderGateReport, persistedInspectEventsToTraceEvents, renderStepLine, renderErrorLine, getIndent, TreeBuilder, zeroKinds, validateEvent, traceEventToPersistedInspectEvent, isPersistedInspectEvent, createRunStatusRule, createStructureOrphanRule, createStructureCycleRule, createRunDurationRule, createMaxStepDurationRule, createRequireCompletedRule, createStallDetectionRule, createObservedOutcomeRule, createRunDepthRule, createToolUsageRule, createLlmUsageRule, createStructureRelationshipRule, createStructureParallelWidthRule, summarizeObservedOutcomes, extractOutcomesFromTraceEvents, renderObservedOutcomesMarkdown, renderObservedOutcomesHtml, DEFAULT_SUITE_ARTIFACTS_DIR, parseCohortMetricList, COHORT_METRIC_IDS, parseGateList, nanoid, diffRuns, manualTraceEventsToComparableRun } from './chunk-MEO2Z3KE.mjs';
 import { realpathSync, constants as constants$1, existsSync, readFileSync } from 'fs';
 import path16 from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
@@ -11,7 +11,7 @@ import { createServer } from 'http';
 import { createRequire } from 'module';
 
 // package.json
-var version = "6.12.2";
+var version = "6.14.0";
 
 // packages/cli/src/trace-dir-scale.ts
 var TRACE_COUNT_WARN = 1e3;
@@ -3346,7 +3346,7 @@ async function newestTraceMtimeMs(traceDir) {
 }
 async function loadSessionRuns(traceDir) {
   try {
-    const mod = await import('./src-YAASTXGE.mjs');
+    const mod = await import('./src-6VZNGIF6.mjs');
     const dbPath = mod.resolveIndexDbPath(traceDir);
     const status = mod.indexStatus(dbPath);
     if (!status.healthy) {
@@ -8588,6 +8588,7 @@ async function artifactsCommand(target, options = {}, stdin = process.stdin) {
           findings: check.findings.length
         }))
       });
+      const parity = summarizeSemanticParity(read.events);
       const evidencePackage = buildEvidenceCiPackage({
         generatorVersion: version,
         runIds,
@@ -8596,7 +8597,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);
@@ -9677,11 +9689,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) {
@@ -9754,6 +9766,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;
@@ -9909,7 +9945,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(process2.versions.node.split(".")[0]);
@@ -10622,7 +10659,7 @@ function isModuleNotFound4(e) {
 }
 async function loadIndexSqlite() {
   try {
-    return await import('./src-YAASTXGE.mjs');
+    return await import('./src-6VZNGIF6.mjs');
   } catch (e) {
     if (isModuleNotFound4(e)) {
       console.error(
@@ -11725,6 +11762,7 @@ function createCliProgram() {
       "ai-sdk",
       "openai-agents",
       "langchain",
+      "langgraph",
       "custom"
     ])
   ).addOption(new 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) => {
@@ -11735,6 +11773,7 @@ function createCliProgram() {
       "ai-sdk",
       "openai-agents",
       "langchain",
+      "langgraph",
       "custom"
     ])
   ).action((opts) => {