Skip to content

Add apn CLI card with payment guardrails - #18

Open
Soldatovresult wants to merge 1 commit into
Ariestar:mainfrom
Soldatovresult:add-agent-payment-node
Open

Soldatovresult wants to merge 1 commit into
Ariestar:mainfrom
Soldatovresult:add-agent-payment-node

Conversation

@Soldatovresult

Copy link
Copy Markdown

Summary

Adds only data/tools/apn.yaml. APN is local buyer-side x402 payment tooling with a CLI and stdio MCP surface. The card marks risk high and destructive=true because authorized payment operations can move funds irreversibly; effects use only the repository whitelist. It does not invent a new payment-specific effect enum or imply general sandbox protection. Version detection uses the real apn version subcommand. No local workspace markers or provider credentials are invented.

Contribution Rules & Checklist

  • No manual README edits: only data/tools/apn.yaml is submitted
  • Exact file naming: name and filename are apn
  • Allowed effects: only listed whitelist values
  • Guardrails: explicit platform, wallet/custody, payment authority, recipient/network/asset/amount/fees/budget and secrets limits
  • Local validation passed: python scripts/lint_registry.py and python scripts/generate_readme.py

Validation used the complete current source archive (468 text files, no prior APN match). The unmodified linter passed the baseline 460 cards and then all 461 with APN added. The unmodified README generator was run twice locally and produced identical output. The generated README is not included in this PR; the existing workflow handles it after merge. All existing YAML cards and generator/validator scripts are unchanged. Validation checks card structure and deterministic rendering, not payment execution or independent security assessment.

Submitted on behalf of Nuanu AI. Source: https://github.com/nuanu-ai/agent-payment-node (MIT, TypeScript). APN is a local buyer-side x402 payment runtime with CLI and stdio MCP tooling for offer inspection, bounded preparation, status/receipts and recovery. Apple Silicon macOS and Node 24 only. Documented setup: brew install nuanu-ai/tap/apn, apn mcp config, apn mcp serve. No hosted endpoint, npm package or Linux/Windows/Docker support is claimed.

Direct transfers and EVM x402 signing require foreground owner approval; Solana exact x402 can operate under an owner-admitted policy. APN is spend-capable local software with custody and compromised-host limits, not a generic sandbox or read-only connector. Software is free; network/provider fees may apply. No live payment test, independent audit, production adoption or client-specific interoperability result is claimed.

Current full target list/data and applicable contribution rules, all-state issue/PR history and fresh pre-submit delta were checked for APN/name/slug/Nuanu. One product, no unrelated changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant