agentic-payments 0.1.0 → 0.1.2

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 (7) hide show
  1. package/README.md +11 -11
  2. package/bin/cli.js +38 -12
  3. package/dist/mcp/tools/consensus.d.ts +11 -1
  4. package/dist/mcp/tools/consensus.d.ts.map +1 -1
  5. package/dist/mcp/tools/consensus.js +66 -17
  6. package/dist/mcp/tools/consensus.js.map +1 -1
  7. package/package.json +1 -1
package/README.md CHANGED
@@ -53,10 +53,10 @@ npm install agentic-payments
53
53
 
54
54
  ```bash
55
55
  # Run stdio transport (local - for Claude Desktop, Cline)
56
- npx agentic-payments-mcp
56
+ npx -y agentic-payments mcp
57
57
 
58
58
  # Run HTTP transport (remote - for web integrations)
59
- npx agentic-payments-mcp --transport http --port 3000
59
+ npx -y agentic-payments mcp --transport http --port 3000
60
60
  ```
61
61
 
62
62
  ## 🚀 Quick Start
@@ -108,7 +108,7 @@ The `agentic-payments` MCP server supports two transport modes:
108
108
  **Stdio Transport** (recommended for local development):
109
109
  ```bash
110
110
  # Start the server in stdio mode (default)
111
- npx agentic-payments-mcp
111
+ npx -y agentic-payments mcp
112
112
 
113
113
  # The server is now listening on stdin/stdout
114
114
  # Perfect for Claude Desktop, Cline, and other local integrations
@@ -117,7 +117,7 @@ npx agentic-payments-mcp
117
117
  **HTTP/SSE Transport** (for remote or web-based integrations):
118
118
  ```bash
119
119
  # Start the HTTP server on port 3000
120
- npx agentic-payments-mcp --transport http --port 3000
120
+ npx -y agentic-payments mcp --transport http --port 3000
121
121
 
122
122
  # Server endpoints:
123
123
  # - http://localhost:3000/health (health check)
@@ -135,7 +135,7 @@ curl http://localhost:3000/health
135
135
  # {
136
136
  # "status": "healthy",
137
137
  # "version": "0.1.0",
138
- # "server": "agentic-payments-mcp",
138
+ # "server": "agentic-payments", "mcp",
139
139
  # "transport": "http/sse",
140
140
  # "activeSessions": 0
141
141
  # }
@@ -155,7 +155,7 @@ curl http://localhost:3000/health
155
155
  "mcpServers": {
156
156
  "agentic-payments": {
157
157
  "command": "npx",
158
- "args": ["agentic-payments-mcp"]
158
+ "args": ["-y", "agentic-payments", "mcp"]
159
159
  }
160
160
  }
161
161
  }
@@ -166,7 +166,7 @@ curl http://localhost:3000/health
166
166
  **Claude Code** (local integration via stdio):
167
167
  ```bash
168
168
  # Add the MCP server to Claude Code
169
- claude mcp add agentic-payments npx agentic-payments-mcp
169
+ claude mcp add agentic-payments npx -y agentic-payments mcp
170
170
 
171
171
  # Verify it's connected
172
172
  claude mcp list
@@ -182,7 +182,7 @@ claude mcp list
182
182
  {
183
183
  "agentic-payments": {
184
184
  "command": "npx",
185
- "args": ["agentic-payments-mcp"]
185
+ "args": ["-y", "agentic-payments", "mcp"]
186
186
  }
187
187
  }
188
188
  ```
@@ -360,7 +360,7 @@ Result:
360
360
  **Test stdio integration**:
361
361
  ```bash
362
362
  # Test that AI can access the tools
363
- echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx agentic-payments-mcp
363
+ echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y agentic-payments mcp
364
364
  ```
365
365
 
366
366
  **Test HTTP integration**:
@@ -399,10 +399,10 @@ curl http://localhost:3000/sessions
399
399
  lsof -i :3000
400
400
 
401
401
  # Kill existing process
402
- pkill -f "agentic-payments-mcp"
402
+ pkill -f "agentic-payments", "mcp"
403
403
 
404
404
  # Try again
405
- npx agentic-payments-mcp --transport http --port 3000
405
+ npx -y agentic-payments mcp --transport http --port 3000
406
406
  ```
407
407
 
408
408
  **AI can't see the tools**:
package/bin/cli.js CHANGED
@@ -2,17 +2,43 @@
2
2
 
3
3
  /**
4
4
  * Agentic Payments CLI
5
- * Command-line interface for AP2 and ACP operations
5
+ * Command-line interface for AP2, ACP, and MCP operations
6
6
  */
7
7
 
8
- console.log('Agentic Payments CLI - Coming soon!');
9
- console.log('Usage: agentic-payments <command> [options]');
10
- console.log('');
11
- console.log('Commands:');
12
- console.log(' generate-key Generate new Ed25519 keypair');
13
- console.log(' verify-signature Verify Ed25519 signature');
14
- console.log(' create-mandate Create AP2 intent mandate');
15
- console.log(' checkout Create ACP checkout session');
16
- console.log(' webhook-verify Verify ACP webhook signature');
17
- console.log('');
18
- console.log('Run: agentic-payments <command> --help for more information');
8
+ const args = process.argv.slice(2);
9
+ const command = args[0];
10
+
11
+ if (command === 'mcp') {
12
+ // Remove 'mcp' from args and delegate to MCP server
13
+ process.argv.splice(2, 1);
14
+ import('../dist/mcp/index.js').catch(err => {
15
+ console.error('Failed to start MCP server:', err);
16
+ process.exit(1);
17
+ });
18
+ } else {
19
+ // Show help
20
+ console.log('Agentic Payments CLI v0.1.0');
21
+ console.log('Multi-agent payment authorization for autonomous AI commerce');
22
+ console.log('');
23
+ console.log('Usage: agentic-payments <command> [options]');
24
+ console.log('');
25
+ console.log('Commands:');
26
+ console.log(' mcp Start MCP server (stdio or HTTP transport)');
27
+ console.log(' active-mandate Manage Active Mandates (create, sign, verify, revoke)');
28
+ console.log(' generate Generate Ed25519 agent identity');
29
+ console.log(' verify Verify payment with multi-agent consensus');
30
+ console.log(' system System status and diagnostics');
31
+ console.log('');
32
+ console.log('MCP Server:');
33
+ console.log(' agentic-payments mcp # Start stdio transport');
34
+ console.log(' agentic-payments mcp --transport http # Start HTTP/SSE server');
35
+ console.log('');
36
+ console.log('Examples:');
37
+ console.log(' agentic-payments mcp --transport http --port 3000');
38
+ console.log(' agentic-payments active-mandate create --agent bot@ai --holder user@example.com');
39
+ console.log(' agentic-payments generate --format json');
40
+ console.log('');
41
+ console.log('Documentation: https://github.com/agentic-catalog/agentic-payments');
42
+ console.log('');
43
+ console.log('Run: agentic-payments <command> --help for more information');
44
+ }
package/dist/mcp/tools/consensus.d.ts CHANGED
@@ -3,7 +3,17 @@
3
3
  */
4
4
  import type { ToolResult, VerifyConsensusArgs } from './types.js';
5
5
  /**
6
- * Verify payment signature with multi-agent consensus
6
+ * Verify payment signature with multi-agent Byzantine consensus
7
+ *
8
+ * Implements cryptographic multi-agent verification where:
9
+ * - Each agent independently verifies the signature
10
+ * - Consensus threshold determines approval (e.g., 13 of 20 agents = 65%)
11
+ * - Byzantine fault tolerance: system remains secure even if f < n/3 agents are compromised
12
+ *
13
+ * Example: $50K vendor contract with 20 agents (procurement, finance, legal, audit, etc.)
14
+ * - Requires 13 signatures (65% consensus)
15
+ * - Can tolerate up to 6 compromised agents (7 would be 35% < required 65%)
16
+ * - No single agent or small group can authorize fraudulent transactions
7
17
  */
8
18
  export declare function verifyConsensusTool(args: VerifyConsensusArgs): Promise<ToolResult>;
9
19
  //# sourceMappingURL=consensus.d.ts.map
package/dist/mcp/tools/consensus.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"consensus.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/consensus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,UAAU,CAAC,CAoCrB"}
1
+ {"version":3,"file":"consensus.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/consensus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,UAAU,CAAC,CAmFrB"}
package/dist/mcp/tools/consensus.js CHANGED
@@ -2,30 +2,79 @@
2
2
  * Consensus verification MCP tools
3
3
  */
4
4
  import { VerificationSystemBuilder } from '../../verification.js';
5
+ import { AgentIdentity } from '../../identity.js';
5
6
  /**
6
- * Verify payment signature with multi-agent consensus
7
+ * Verify payment signature with multi-agent Byzantine consensus
8
+ *
9
+ * Implements cryptographic multi-agent verification where:
10
+ * - Each agent independently verifies the signature
11
+ * - Consensus threshold determines approval (e.g., 13 of 20 agents = 65%)
12
+ * - Byzantine fault tolerance: system remains secure even if f < n/3 agents are compromised
13
+ *
14
+ * Example: $50K vendor contract with 20 agents (procurement, finance, legal, audit, etc.)
15
+ * - Requires 13 signatures (65% consensus)
16
+ * - Can tolerate up to 6 compromised agents (7 would be 35% < required 65%)
17
+ * - No single agent or small group can authorize fraudulent transactions
7
18
  */
8
19
  export async function verifyConsensusTool(args) {
9
20
  try {
10
- const { agent_public_keys, consensus_threshold = 0.67, } = args;
11
- // Create verification system with agent pool
12
- const builder = new VerificationSystemBuilder()
21
+ const { message, signature, public_key, agent_public_keys, consensus_threshold = 0.67, } = args;
22
+ // Decode inputs from hex strings
23
+ const messageBytes = Buffer.from(message, 'hex');
24
+ const signatureBytes = Buffer.from(signature, 'hex');
25
+ const publicKeyBytes = Buffer.from(public_key, 'hex');
26
+ // Create agent identities from public keys
27
+ const agents = [];
28
+ for (const agentPubKey of agent_public_keys) {
29
+ const agentPubKeyBytes = Buffer.from(agentPubKey, 'hex');
30
+ // Create identity with public key only (no private key for verification)
31
+ const identity = await AgentIdentity.fromPublicKey(agentPubKeyBytes);
32
+ agents.push(identity);
33
+ }
34
+ if (agents.length === 0) {
35
+ return {
36
+ success: false,
37
+ error: 'No agents provided for consensus verification',
38
+ };
39
+ }
40
+ // Calculate minimum required agents based on threshold
41
+ const minRequired = Math.ceil(agents.length * consensus_threshold);
42
+ // Build verification system with Byzantine fault tolerance
43
+ const system = new VerificationSystemBuilder()
13
44
  .consensusThreshold(consensus_threshold)
14
- .minAgents(Math.ceil(agent_public_keys.length * consensus_threshold));
15
- // Build system (in real implementation, you'd add agents and use system.verifyWithConsensus)
16
- builder.build();
17
- // Note: This is a simplified implementation
18
- // In production, you would:
19
- // 1. Reconstruct AgentIdentity instances from public keys
20
- // 2. Use system.verifyWithConsensus() method
21
- // 3. Return actual consensus voting results
45
+ .minAgents(minRequired)
46
+ .maxAgents(agents.length)
47
+ .timeout(5000)
48
+ .parallel(true) // Parallel verification for performance
49
+ .addAgents(agents)
50
+ .build();
51
+ // Verify with multi-agent consensus
52
+ const result = await system.verifyWithConsensus(signatureBytes, messageBytes, publicKeyBytes);
53
+ // Return detailed consensus results
22
54
  return {
23
55
  success: true,
24
- verified: true,
25
- consensus_reached: true,
26
- threshold: consensus_threshold,
27
- agent_count: agent_public_keys.length,
28
- message: 'Consensus verification requires full agent pool implementation',
56
+ verified: result.isValid,
57
+ consensus_reached: result.consensusReached,
58
+ votes_for: result.votesFor,
59
+ votes_against: result.votesAgainst,
60
+ total_votes: result.totalVotes,
61
+ consensus_percentage: Math.round(result.consensusPercentage * 100),
62
+ threshold_percentage: Math.round(consensus_threshold * 100),
63
+ required_votes: minRequired,
64
+ agent_count: agents.length,
65
+ total_latency_ms: result.totalLatencyMs,
66
+ avg_latency_ms: Math.round(result.avgLatencyMs * 100) / 100,
67
+ agent_votes: result.agentVotes.map(v => ({
68
+ agent_id: v.agentId,
69
+ vote: v.vote ? 'approve' : 'reject',
70
+ timestamp: v.timestamp,
71
+ latency_ms: v.latencyMs,
72
+ })),
73
+ byzantine_fault_tolerance: {
74
+ max_compromised_agents: Math.floor(agents.length / 3) - 1,
75
+ security_margin: result.votesFor - minRequired,
76
+ is_byzantine_secure: result.votesFor >= minRequired,
77
+ },
29
78
  };
30
79
  }
31
80
  catch (error) {
package/dist/mcp/tools/consensus.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"consensus.js","sourceRoot":"","sources":["../../../src/mcp/tools/consensus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGlE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,EACJ,iBAAiB,EACjB,mBAAmB,GAAG,IAAI,GAC3B,GAAG,IAAI,CAAC;QAET,6CAA6C;QAC7C,MAAM,OAAO,GAAG,IAAI,yBAAyB,EAAE;aAC5C,kBAAkB,CAAC,mBAAmB,CAAC;aACvC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC;QAExE,6FAA6F;QAC7F,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhB,4CAA4C;QAC5C,4BAA4B;QAC5B,0DAA0D;QAC1D,6CAA6C;QAC7C,4CAA4C;QAE5C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,iBAAiB,EAAE,IAAI;YACvB,SAAS,EAAE,mBAAmB;YAC9B,WAAW,EAAE,iBAAiB,CAAC,MAAM;YACrC,OAAO,EACL,gEAAgE;SACnE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"consensus.js","sourceRoot":"","sources":["../../../src/mcp/tools/consensus.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-payments",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Dual-protocol payment infrastructure for autonomous AI commerce (AP2 + ACP)",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",