@envarai/envarpay 0.1.0-alpha.3 → 0.2.0-alpha.2

package/examples/envar-integration-policy.json

@@ -0,0 +1,18 @@
+{
+  "enabled": true,
+  "platformOrigin": "https://envar.ai",
+  "agentId": "54fe760a-4580-4258-9002-80f34c0d757a",
+  "runtimeAgentId": "hermes-researcher",
+  "acceptUpdates": true,
+  "allowedServices": ["research"],
+  "allowedUpstreamOrigins": ["http://hermes:9000"],
+  "allowedX402": [
+    {
+      "network": "eip155:84532",
+      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+      "payTo": "0x2222222222222222222222222222222222222222",
+      "facilitatorOrigin": "https://facilitator.example"
+    }
+  ],
+  "allowedMppAccounts": ["seller-stripe"]
+}

package/examples/seller.json

@@ -0,0 +1,52 @@
+{
+  "configVersion": 1,
+  "agent": {"id": "hermes-researcher", "name": "我的研究助手"},
+  "paymentProfiles": {
+    "base-usdc": {
+      "adapter": "x402", "scheme": "exact", "network": "eip155:84532",
+      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+      "payTo": "0x2222222222222222222222222222222222222222",
+      "facilitatorUrl": "https://facilitator.example"
+    },
+    "stripe-usd": {"adapter": "mpp", "method": "stripe", "intent": "charge", "currency": "usd", "accountRef": "seller-stripe"}
+  },
+  "services": [
+    {
+      "id": "research", "name": "竞品调研", "revision": 1,
+      "execution": {"type": "a2a", "cardUrl": "http://hermes:9000/research/agent-card.json"},
+      "contract": {
+        "inputSchema": {
+          "$schema": "https://json-schema.org/draft/2020-12/schema",
+          "type": "object", "additionalProperties": false, "required": ["topic", "competitors"],
+          "properties": {
+            "topic": {"type": "string", "minLength": 1, "maxLength": 500},
+            "competitors": {"type": "array", "minItems": 1, "maxItems": 3, "uniqueItems": true, "items": {"type": "string", "minLength": 1, "maxLength": 120}}
+          }
+        },
+        "deliverables": ["report.md", "comparison.csv"], "targetDurationSeconds": 600, "includedRevisions": 0
+      },
+      "offers": [
+        {"id": "usdc-once", "pricing": {"kind": "fixed", "amount": "3000000"}, "collection": {"kind": "upfront"}, "paymentProfile": "base-usdc"},
+        {"id": "card-once", "pricing": {"kind": "fixed", "amount": "300"}, "collection": {"kind": "upfront"}, "paymentProfile": "stripe-usd"}
+      ]
+    },
+    {
+      "id": "summary-preview", "name": "免费试读", "revision": 1,
+      "execution": {"type": "a2a", "cardUrl": "http://hermes:9000/preview/agent-card.json"},
+      "contract": {
+        "inputSchema": {"type": "object", "additionalProperties": false, "required": ["text"], "properties": {"text": {"type": "string", "minLength": 1, "maxLength": 500}}},
+        "deliverables": ["summary.txt"], "targetDurationSeconds": 60, "includedRevisions": 0
+      },
+      "offers": [{"id": "free", "pricing": {"kind": "free"}, "collection": {"kind": "none"}}]
+    },
+    {
+      "id": "translation", "name": "文档翻译", "revision": 1,
+      "execution": {"type": "a2a", "cardUrl": "http://openclaw:9000/translate/agent-card.json"},
+      "contract": {
+        "inputSchema": {"type": "object", "additionalProperties": false, "required": ["documents"], "properties": {"documents": {"type": "array", "minItems": 1, "maxItems": 20, "items": {"type": "string", "minLength": 1, "maxLength": 10000}}}},
+        "deliverables": ["translations.json"], "targetDurationSeconds": 600, "includedRevisions": 0
+      },
+      "offers": [{"id": "per-document", "pricing": {"kind": "quantity", "unit": "document", "unitAmount": "100000", "quantity": {"pointer": "/documents", "measure": "count", "min": 1, "max": 20}}, "collection": {"kind": "upfront"}, "paymentProfile": "base-usdc"}]
+    }
+  ]
+}

package/package.json

@@ -1,15 +1,80 @@
 {
   "name": "@envarai/envarpay",
-  "version": "0.1.0-alpha.3",
-  "description": "Typed MCP client for an operator-configured EnvarPay wallet service",
+  "version": "0.2.0-alpha.2",
+  "description": "Independent A2A service commerce, budgeted buyers and x402/MPP payments",
   "type": "module",
   "license": "MIT",
-  "engines": { "node": ">=22.14.0" },
-  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
-  "files": ["dist", "README.md", "LICENSE"],
-  "repository": { "type": "git", "url": "git+https://github.com/EnvarAI/EnvarPay.git", "directory": "packages/typescript" },
-  "publishConfig": { "access": "public", "tag": "next" },
-  "scripts": { "build": "tsc", "test": "npm run build && node --test test/client.test.mjs", "prepack": "npm run build" },
-  "dependencies": { "@modelcontextprotocol/sdk": "^1.31.0" },
-  "devDependencies": { "typescript": "~5.9.3", "@types/node": "^22.0.0" }
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/commerce/index.d.ts",
+      "import": "./dist/commerce/index.js"
+    },
+    "./commerce": {
+      "types": "./dist/commerce/index.d.ts",
+      "import": "./dist/commerce/index.js"
+    },
+    "./commerce/server": {
+      "types": "./dist/commerce/runtime.d.ts",
+      "import": "./dist/commerce/runtime.js"
+    },
+    "./client": {
+      "types": "./dist/commerce/client-runtime.d.ts",
+      "import": "./dist/commerce/client-runtime.js"
+    },
+    "./server": {
+      "types": "./dist/commerce/runtime.d.ts",
+      "import": "./dist/commerce/runtime.js"
+    },
+    "./mpp": {
+      "types": "./dist/commerce/mpp-runtime.d.ts",
+      "import": "./dist/commerce/mpp-runtime.js"
+    },
+    "./envar": {
+      "types": "./dist/commerce/envar.d.ts",
+      "import": "./dist/commerce/envar.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "schemas",
+    "examples"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EnvarAI/EnvarPay.git",
+    "directory": "packages/typescript"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "1.2.1",
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "@x402/core": "2.24.0",
+    "@x402/evm": "2.24.0",
+    "@x402/extensions": "2.24.0",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "canonicalize": "2.1.0",
+    "mppx": "0.13.1",
+    "viem": "2.57.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "~5.9.3"
+  },
+  "bin": {
+    "envarpay": "dist/commerce/cli.js"
+  }
 }

package/schemas/buyer-policy.schema.json

@@ -0,0 +1,253 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:envarpay:buyer-policy:1",
+  "title": "Local buyer permission policy; not supplied by the seller",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "policyVersion",
+    "paymentsEnabled",
+    "approval",
+    "peers",
+    "budgets"
+  ],
+  "properties": {
+    "policyVersion": {
+      "const": 1
+    },
+    "paymentsEnabled": {
+      "type": "boolean"
+    },
+    "approval": {
+      "enum": [
+        "per_purchase",
+        "within_preapproved_limits"
+      ]
+    },
+    "peers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "cardUrl",
+          "protocol",
+          "currency",
+          "recipient",
+          "maxPerPurchase"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]{0,63}$"
+          },
+          "cardUrl": {
+            "type": "string",
+            "format": "uri",
+            "pattern": "^https://"
+          },
+          "protocol": {
+            "enum": [
+              "x402",
+              "mpp",
+              "free"
+            ]
+          },
+          "currency": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "recipient": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "maxPerPurchase": {
+            "type": "string",
+            "pattern": "^(0|[1-9][0-9]{0,77})$"
+          },
+          "mode": {
+            "enum": [
+              "envarpay",
+              "standard-a2a"
+            ]
+          },
+          "endpoint": {
+            "type": "string",
+            "format": "uri",
+            "pattern": "^https://"
+          },
+          "authentication": {
+            "enum": [
+              "none",
+              "bearer"
+            ]
+          },
+          "localContract": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "revision",
+              "offerId",
+              "inputSchema",
+              "amount",
+              "paidOnly"
+            ],
+            "properties": {
+              "revision": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "offerId": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]{0,63}$"
+              },
+              "inputSchema": {
+                "type": "object"
+              },
+              "amount": {
+                "$ref": "#/$defs/amount"
+              },
+              "paidOnly": {
+                "const": true
+              }
+            }
+          }
+        },
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "protocol": {
+                  "const": "free"
+                }
+              }
+            },
+            "then": {
+              "properties": {
+                "currency": {
+                  "const": null
+                },
+                "recipient": {
+                  "const": null
+                },
+                "maxPerPurchase": {
+                  "const": "0"
+                }
+              }
+            },
+            "else": {
+              "properties": {
+                "currency": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "recipient": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "maxPerPurchase": {
+                  "$ref": "#/$defs/amount"
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "required": [
+                "mode"
+              ],
+              "properties": {
+                "mode": {
+                  "const": "standard-a2a"
+                }
+              }
+            },
+            "then": {
+              "required": [
+                "endpoint",
+                "authentication",
+                "localContract"
+              ],
+              "properties": {
+                "protocol": {
+                  "const": "x402"
+                },
+                "endpoint": {},
+                "authentication": {},
+                "localContract": {}
+              }
+            },
+            "else": {
+              "not": {
+                "anyOf": [
+                  {
+                    "required": [
+                      "endpoint"
+                    ],
+                    "properties": {
+                      "endpoint": {}
+                    }
+                  },
+                  {
+                    "required": [
+                      "authentication"
+                    ],
+                    "properties": {
+                      "authentication": {}
+                    }
+                  },
+                  {
+                    "required": [
+                      "localContract"
+                    ],
+                    "properties": {
+                      "localContract": {}
+                    }
+                  }
+                ]
+              }
+            }
+          }
+        ]
+      }
+    },
+    "budgets": {
+      "type": "array",
+      "minItems": 0,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "currency",
+          "maxTotal",
+          "period"
+        ],
+        "properties": {
+          "currency": {
+            "type": "string",
+            "minLength": 1
+          },
+          "maxTotal": {
+            "$ref": "#/$defs/amount"
+          },
+          "period": {
+            "const": "cumulative"
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "amount": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]{0,77}$"
+    }
+  }
+}