@originaryx/agent-auditor 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +69 -0
  2. package/package.json +4 -3
package/README.md ADDED
@@ -0,0 +1,69 @@
1
+ # Agent Auditor
2
+
3
+ Open a receipt or bundle. Verify it offline.
4
+
5
+ [![CI](https://github.com/originaryx/agent-auditor/actions/workflows/ci.yml/badge.svg)](https://github.com/originaryx/agent-auditor/actions/workflows/ci.yml)
6
+
7
+ Inspection and verification happen locally in your browser or CLI. No outbound verification or artifact fetches.
8
+
9
+ ## Install
10
+
11
+ ```bash
12
+ npm install -g @originaryx/agent-auditor
13
+ ```
14
+
15
+ ## Usage
16
+
17
+ ```bash
18
+ # See a sample receipt instantly
19
+ agent-auditor demo
20
+
21
+ # Inspect a receipt file
22
+ agent-auditor inspect ./receipt.jws
23
+
24
+ # Verify a receipt against a public key
25
+ agent-auditor verify ./receipt.jws --key ./public-key.bin
26
+
27
+ # Verify a dispute bundle (uses included keys)
28
+ agent-auditor verify ./bundle.zip
29
+
30
+ # Machine-readable JSON output
31
+ agent-auditor inspect ./receipt.jws --json
32
+ ```
33
+
34
+ ## Commands
35
+
36
+ | Command | Description | Exit Code |
37
+ |---------|-------------|-----------|
38
+ | `agent-auditor inspect <file>` | Decode and display receipt or bundle | 0 = decoded, 2 = error |
39
+ | `agent-auditor verify <file>` | Verify with key or included keys | 0 = valid, 1 = invalid, 2 = error |
40
+ | `agent-auditor demo` | Show a sample receipt | 0 |
41
+
42
+ ### Flags
43
+
44
+ | Flag | Used With | Description |
45
+ |------|-----------|-------------|
46
+ | `--json` | inspect, verify, demo | Machine-readable JSON (frozen contract) |
47
+ | `--key <path>` | verify | Ed25519 public key file (32-byte raw or base64url) |
48
+ | `--jwks <path>` | verify | JWKS file containing public keys |
49
+ | `--kid <id>` | verify | Select key by ID from JWKS |
50
+
51
+ ## What It Does Not Do
52
+
53
+ Agent Auditor is a read-only verifier. It does not issue or sign receipts, contact any server, store keys or state, or validate business logic. It checks cryptographic and structural validity only.
54
+
55
+ ## Web Inspector
56
+
57
+ **[originary.xyz/agent-auditor](https://www.originary.xyz/agent-auditor)**
58
+
59
+ Drop a receipt or bundle in the browser. No backend. No accounts.
60
+
61
+ ## License
62
+
63
+ Apache-2.0
64
+
65
+ ---
66
+
67
+ PEAC Protocol is an open source project stewarded by [Originary](https://www.originary.xyz).
68
+
69
+ [Docs](https://www.originary.xyz/agent-auditor) &nbsp;·&nbsp; [GitHub](https://github.com/originaryx/agent-auditor) &nbsp;·&nbsp; [Originary](https://www.originary.xyz) &nbsp;·&nbsp; [npm](https://www.npmjs.com/package/@originaryx/agent-auditor)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@originaryx/agent-auditor",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Inspect and verify signed agent receipts and evidence bundles",
5
5
  "type": "module",
6
6
  "files": [
@@ -26,7 +26,7 @@
26
26
  "url": "https://github.com/originaryx/agent-auditor.git",
27
27
  "directory": "packages/cli"
28
28
  },
29
- "homepage": "https://github.com/originaryx/agent-auditor#readme",
29
+ "homepage": "https://www.originary.xyz/agent-auditor",
30
30
  "bugs": {
31
31
  "url": "https://github.com/originaryx/agent-auditor/issues"
32
32
  },
@@ -38,7 +38,8 @@
38
38
  "inspect",
39
39
  "cryptography",
40
40
  "ed25519",
41
- "peac"
41
+ "peac",
42
+ "originary"
42
43
  ],
43
44
  "engines": {
44
45
  "node": ">=22.0.0"