@agent-inspect/vitest 6.14.0 → 6.14.2

package/README.md

@@ -1,14 +1,15 @@
 # @agent-inspect/vitest
 
-Vitest reporter — failed tests emit local trace artifacts; passing tests stay quiet.
+Vitest reporter for local AgentInspect failure artifacts, plus **experimental** TraceContract matchers.
 
 
-**Support level:** Supported — see [SUPPORT-LEVELS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md).
+**Support level:** Supported (reporter) · Experimental (matchers) — see [SUPPORT-LEVELS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md).
 
 ## When to use
 
 - Vitest suites that run instrumented agents
-- You want PR artifacts on failure without changing test assertions
+- PR artifacts on failure without changing assertion libraries
+- Experimental trajectory assertions via `toPassTraceContract` / `toHaveRequiredTool`
 
 ## When not to use
 
@@ -23,7 +24,7 @@ npm install agent-inspect @agent-inspect/vitest vitest
 
 **Peer:** `vitest@^2.1.0`
 
-## Example
+## Reporter example
 
 ```ts
 // vitest.config.ts
@@ -37,6 +38,20 @@ export default defineConfig({
 });
 ```
 
+## Experimental matchers
+
+```ts
+import { expect } from "vitest";
+import { agentInspectVitestMatchers } from "@agent-inspect/vitest";
+
+expect.extend(agentInspectVitestMatchers);
+
+expect(read).toPassTraceContract(contract);
+expect(read).toHaveRequiredTool("lookup_orders");
+```
+
+There is no `expectTrace(...).toSatisfyTraceContract` helper — use the matchers above.
+
 ## Privacy
 
 - Writes traces locally on failure only (by default)
@@ -44,7 +59,8 @@ export default defineConfig({
 
 ## API
 
-Default export: Vitest reporter factory.
+- Default export: Vitest reporter factory
+- `agentInspectVitestMatchers` — Experimental
 
 ## CLI
 
@@ -52,20 +68,20 @@ After failure: `npx agent-inspect report <run-id>`
 
 ## Limitations
 
-- This package is a **reporter** (failure artifacts). It does **not** ship Vitest TraceContract matchers such as `expectTrace(...).toSatisfyTraceContract`.
-- Use `agent-inspect check` / TraceContract APIs for trajectory assertions.
+- Matchers are **Experimental** and may evolve in minors
+- Prefer CLI / TraceContract APIs for deep CI gates when matchers are insufficient
 
 ## Docs
 
 - [CI artifacts](https://github.com/rajudandigam/agent-inspect/blob/main/docs/CI-ARTIFACTS.md)
 - [TRACE-CONTRACTS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-CONTRACTS.md)
+- [TRACE-FACTS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-FACTS.md)
 
 ## Troubleshooting
 
 - **No artifact:** Ensure trace was written during test and reporter `traceDir` matches
 - **Original errors preserved:** Reporter does not swallow Vitest failures
 
-
 ## Version
 
 Part of the fixed AgentInspect release line. See the npm badge / package manifest for the current version.

package/dist/index.d.cts

@@ -76,6 +76,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;
@@ -88,6 +96,7 @@ interface InspectRunTree {
         totalEvents: number;
         confidenceBreakdown: Record<AttributionConfidence, number>;
         kinds: Record<InspectKind, number>;
+        relationshipSummary?: RelationshipSummary;
     };
 }
 

package/dist/index.d.ts

@@ -76,6 +76,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;
@@ -88,6 +96,7 @@ interface InspectRunTree {
         totalEvents: number;
         confidenceBreakdown: Record<AttributionConfidence, number>;
         kinds: Record<InspectKind, number>;
+        relationshipSummary?: RelationshipSummary;
     };
 }
 

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@agent-inspect/vitest",
-  "version": "6.14.0",
+  "version": "6.14.2",
   "license": "MIT",
   "type": "module",
-  "description": "Optional Vitest reporter for AgentInspect local trace artifacts",
+  "description": "Vitest reporter and experimental TraceContract matchers for AgentInspect local evidence",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/rajudandigam/agent-inspect.git",
@@ -37,7 +37,7 @@
     "vitest": "^2.1.0"
   },
   "dependencies": {
-    "agent-inspect": "6.14.0"
+    "agent-inspect": "6.14.2"
   },
   "devDependencies": {
     "vitest": "^2.1.8"
@@ -45,6 +45,14 @@
   "publishConfig": {
     "access": "public"
   },
+  "keywords": [
+    "vitest",
+    "agent-inspect",
+    "tracecontract",
+    "trajectory-testing",
+    "typescript",
+    "ai-agents"
+  ],
   "scripts": {
     "build": "pnpm --workspace-root exec tsup --config tsup.vitest.config.ts",
     "test": "vitest run -c ../../vitest.config.ts"