@paysentry/observe 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,56 @@
+# @paysentry/observe
+
+Payment observability for AI agents. Track what agents spend, where, and why — across x402, ACP, AP2, and Visa TAP.
+
+Part of [PaySentry](https://github.com/mkmkkkkk/paysentry).
+
+## Install
+
+```bash
+npm install @paysentry/observe @paysentry/core
+```
+
+## Quick Start
+
+```typescript
+import { SpendTracker, SpendAnalytics, SpendAlerts } from '@paysentry/observe';
+
+const tracker = new SpendTracker();
+const analytics = new SpendAnalytics(tracker);
+const alerts = new SpendAlerts(tracker);
+
+// Track a transaction
+tracker.record(tx);
+
+// Get per-agent analytics
+const report = analytics.getAgentAnalytics('my-agent');
+console.log(report.spendByProtocol);
+// Map { 'x402:USDC' => { totalAmount: 12.50, transactionCount: 250 } }
+
+// Alert when daily spend exceeds 80% of budget
+alerts.addRule({
+  id: 'daily-budget',
+  type: 'budget_threshold',
+  severity: 'warning',
+  config: {
+    threshold: 500,
+    currency: 'USDC',
+    windowMs: 86400000,
+    alertAtPercent: 0.8,
+  },
+});
+
+alerts.onAlert((alert) => {
+  console.log(`[${alert.severity}] ${alert.message}`);
+});
+```
+
+## Features
+
+- **SpendTracker** — Real-time transaction indexing by agent, service, protocol
+- **SpendAnalytics** — Time-series analytics, per-agent breakdowns, anomaly detection (z-score)
+- **SpendAlerts** — Budget thresholds, rate spike detection, new recipient alerts
+
+## License
+
+MIT

package/package.json

@@ -1,28 +1,32 @@
 {
   "name": "@paysentry/observe",
-  "version": "1.0.0",
-  "description": "Payment observability for AI agents — track what agents spend, where, and why",
+  "version": "1.0.2",
+  "description": "Payment observability for AI agents \u2014 track what agents spend, where, and why",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc --build",
     "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/observe"
   }
 }