@paysentry/protect 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,52 @@
+# @paysentry/protect
+
+Dispute resolution, provenance tracking, and recovery for AI agent payments. Know exactly what happened, prove it, and get your money back.
+
+Part of [PaySentry](https://github.com/mkmkkkkk/paysentry).
+
+## Install
+
+```bash
+npm install @paysentry/protect @paysentry/core
+```
+
+## Quick Start
+
+```typescript
+import { TransactionProvenance, DisputeManager, RecoveryEngine } from '@paysentry/protect';
+
+const provenance = new TransactionProvenance();
+const disputes = new DisputeManager({ provenance });
+
+// Record provenance chain: intent -> policy -> execution -> settlement
+provenance.recordIntent(tx, { originalPrompt: 'Buy market data' });
+provenance.recordPolicyCheck(tx.id, 'pass', { policyId: 'production' });
+provenance.recordExecution(tx.id, 'pass', { txHash: '0xabc...' });
+provenance.recordSettlement(tx.id, 'fail', { error: 'Service returned 500' });
+
+// File dispute with automatic evidence
+const dispute = disputes.file({
+  transactionId: tx.id,
+  agentId: tx.agentId,
+  reason: 'Service failed to deliver after payment',
+  requestedAmount: tx.amount,
+});
+
+// Resolve
+disputes.resolve(dispute.id, {
+  status: 'resolved_refunded',
+  liability: 'service_provider',
+  resolvedAmount: tx.amount,
+});
+```
+
+## Features
+
+- **TransactionProvenance** — Immutable chain: intent -> policy -> approval -> execution -> settlement
+- **DisputeManager** — File, track, and resolve disputes with auto-attached evidence
+- **RecoveryEngine** — Automated recovery workflows for failed transactions
+- **EU AI Act ready** — Full audit trails for autonomous financial decisions
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paysentry/protect",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Dispute resolution and recovery for AI agent payments",
   "type": "module",
   "main": "dist/index.js",
@@ -16,13 +16,16 @@
     "clean": "tsc --build --clean"
   },
   "dependencies": {
-    "@paysentry/core": "1.0.0"
+    "@paysentry/core": ">=1.0.0"
   },
   "license": "MIT",
-  "files": ["dist"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/paysentry/paysentry",
+    "url": "https://github.com/mkmkkkkk/paysentry",
     "directory": "packages/protect"
   }
 }