{
  "markdown": "# WebCrypt v1.0.1\n\n**Zero-dependency Web Crypto & native AI Agent Tooling (MCP) for modern JavaScript.**\n\n[![npm version](https://img.shields.io/npm/v/webcrypt.svg)](https://www.npmjs.com/package/webcrypt)\n[![npm downloads](https://img.shields.io/npm/dm/webcrypt.svg)](https://www.npmjs.com/package/webcrypt)\n[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-3178C6.svg?logo=typescript&logoColor=white)](https://www.typescriptlang.org)\n[![MCP](https://img.shields.io/badge/MCP-Ready-blueviolet.svg?logo=json&logoColor=white)](https://modelcontextprotocol.io)\n[![Tests](https://img.shields.io/badge/tests-247%20passed-brightgreen.svg)](./__tests__)\n[![Coverage](https://img.shields.io/badge/coverage-93.8%25-success.svg)](./coverage)\n[![PuterVision Triad](https://img.shields.io/badge/PuterVision-Triad%20Standard-6366f1.svg)](https://putervision.com)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nAES-256-GCM symmetric encryption, RSA-4096 hybrid public keys, ECDH key agreement, ECDSA/HMAC digital signatures, and Post-Quantum KEM (Kyber/Dilithium) — zero runtime dependencies, pure Web Crypto API.\n\n---\n\n## ⚡ Quickstart (15 Seconds)\n\n### 1. Installation\n\n```bash\n# 📦 Install as project library (Node.js, TypeScript, Browser)\nnpm install webcrypt\n\n# 🌐 Install globally (CLI utilities & global MCP tools)\nnpm install -g webcrypt\n```\n\n```javascript\nimport { WebCrypt, WebCryptAsym } from \"webcrypt\";\n\n// 🔒 Symmetric AES-256-GCM (600k PBKDF2 iterations)\nconst wc = new WebCrypt();\nconst encrypted = await wc.encryptText(\"Secret payload\", \"password\");\nconst decrypted = await wc.decryptText(encrypted, \"password\");\n\n// 🔑 Asymmetric RSA-4096 Hybrid Encryption\nconst wca = new WebCryptAsym();\nconst keyPair = await wca.generateKeyPair(4096);\nconst cipher = await wca.encryptText(\"Secret payload\", keyPair.publicKey);\nconst plain = await wca.decryptText(cipher, keyPair.privateKey);\n```\n\n---\n\n### 2. Auto-Setup for AI Agents & IDEs (MCP Server)\n\n```bash\n# Initialize MCP server, agent skills, and rules across your project\nnpx webcrypt init  # or `webcrypt init` if installed globally\n```\n\n_Supports **Google Antigravity**, **Cursor**, **Claude Desktop**, **VS Code / Copilot**, **Windsurf**, **Cline**, and **Zed**._\n\n---\n\n## 🤖 Why AI Agents Need WebCrypt MCP\n\nEquip autonomous coding agents with an authenticated cryptographic vault directly in their toolbelt:\n\n- 🔐 **Confidential Local Vaulting (`encrypt_payload`)**: Encrypt API keys and state memory before writing to disk to prevent prompt log leaks.\n- 🛡️ **Tamper-Proof Provenance (`sign_verify`)**: Cryptographically sign test evidence packs, release binaries, and code diffs with ECDSA or HMAC.\n- 🤝 **Inter-Agent Key Exchange (`manage_keys`)**: Ephemeral JWK keypairs (RSA-4096, ECDH P-256/P-384) for private agent-to-agent messaging.\n- ⚛️ **Post-Quantum Guardrails (`pqc_kem_sign`)**: Built-in Kyber KEM and Dilithium signatures future-proof long-term agent artifacts.\n- ⚡ **Zero Dependencies**: 100% native `crypto.subtle` execution across Node.js 18+, Bun, browsers, and Edge runtimes.\n\n```\n┌───────────────────────────────────────────────────────────┐\n│              Autonomous AI Coding Agent                   │\n│     (Antigravity / Cursor / Claude / Copilot / Cline)     │\n└─────────┬───────────────────┬───────────────────┬─────────┘\n          │                   │                   │\n          ▼                   ▼                   ▼\n┌───────────────────┐┌───────────────────┐┌───────────────────┐\n│ state-memory-mcp  ││ vision-memory-mcp ││     webcrypt      │\n│  (Workflow State) ││  (Visual Cache)   ││  (Security Vault) │\n│  • Task Graph DAG ││  • UI Grounding   ││  • AES-256 Vault  │\n│  • Decisions & SDD││  • Layout Trees   ││  • RSA/ECDH Keys  │\n│  • Event Ledger   ││  • Visual History ││  • Digital Sigs   │\n└───────────────────┘└───────────────────┘└───────────────────┘\n```\n\n---\n\n## 🛠️ MCP Tools Reference (6 Core Tools)\n\n| Tool                  | Action / Mode                            | Description                                                                  |\n| :-------------------- | :--------------------------------------- | :--------------------------------------------------------------------------- |\n| **`encrypt_payload`** | `symmetric` \\| `asymmetric` \\| `data`    | Encrypt text, JSON objects, or files with AES-256-GCM or RSA-4096.           |\n| **`decrypt_payload`** | `symmetric` \\| `asymmetric` \\| `data`    | Decrypt ciphertext back to plaintext or structured JSON.                     |\n| **`manage_keys`**     | `generate` \\| `generate_random_password` | Generate JWK keypairs (RSA, ECDH, ECDSA, RSA-PSS) or high-entropy passwords. |\n| **`crypto_hash`**     | `SHA-256` \\| `SHA-512` \\| `SHA-3`        | Compute cryptographic hash digests in hex or base64.                         |\n| **`sign_verify`**     | `sign` \\| `verify`                       | Sign and verify messages, release hashes, and evidence packs.                |\n| **`pqc_kem_sign`**    | `kyber_*` \\| `dilithium_*` \\| `hybrid_*` | Post-quantum Kyber KEM encapsulation and Dilithium signatures.               |\n\n---\n\n## 📚 Technical Documentation Directory\n\nExplore dedicated guides in [`docs/`](docs/) and [`examples/`](examples/):\n\n| Guide                                                                         | Topic                                                         |\n| :---------------------------------------------------------------------------- | :------------------------------------------------------------ |\n| 🚀 **[Live Interactive Playground](https://putervision.github.io/webcrypt/)** | Test all crypto features in the browser demo.                 |\n| 💻 **[CLI Reference Guide](docs/CLI.md)**                                     | Scaffolding, global project scanning, and terminal utilities. |\n| ⚙️ **[Multi-IDE MCP Setup Guide](docs/MCP_IDE_SETUP.md)**                     | Step-by-step MCP JSON configs for all major IDEs.             |\n| 🔒 **[Symmetric Encryption API (`WebCrypt`)](docs/API_SYMMETRIC.md)**         | AES-256-GCM, streaming files, WebRTC E2EE, PBKDF2.            |\n| 🔑 **[Asymmetric Encryption API (`WebCryptAsym`)](docs/API_ASYMMETRIC.md)**   | RSA-4096 hybrid, ECDH key agreement, ECDSA/RSA-PSS.           |\n| ⚛️ **[Post-Quantum Cryptography Guide](docs/PQC.md)**                         | Kyber KEM, Dilithium signatures, and Hybrid KEM.              |\n| 🏗️ **[Architecture & MCP Specifications](docs/ARCHITECTURE.md)**              | Stdio JSON-RPC 2.0 protocol and chunk framing specs.          |\n| 🤖 **[Agent Skill Definition](.agents/skills/webcrypt-mcp/SKILL.md)**         | Custom agent skill with automated test runner script.         |\n| 📋 **[Project Instructions Template](PROJECT_INSTRUCTIONS_TEMPLATE.md)**      | Multi-agent rules template (`<!-- webcrypt-mcp:start -->`).   |\n| 💡 **[Code Examples Directory](examples/README.md)**                          | Ready-to-run Node.js & browser recipes.                       |\n\n---\n\n## 🌐 PuterVision Triad Standard\n\n- 📊 **[`@putervision/state-memory-mcp`](https://github.com/putervision/state-memory-mcp)**: Persistent SQLite graph for workflow states, task DAGs, and decision trails.\n- 👁️ **[`@putervision/vision-memory-mcp`](https://github.com/putervision/vision-memory-mcp)**: Multimodal visual layout cache, AX grounding, and video replay analysis.\n- 🔐 **[`webcrypt`](https://github.com/putervision/webcrypt)**: Zero-dependency cryptographic vault, payload encryption, key management, and digital signatures.\n\n---\n\n## 🧪 Testing & Diagnostics\n\n```bash\n# Run unit & integration test matrix (30 suites, 247 tests)\nnpm test\n\n# Run live MCP tool test runner (25 assertions, 100% verified)\nnode .agents/skills/webcrypt-mcp/scripts/exercise_tools.js\n\n# Audit environment & project configuration health\nwebcrypt doctor\n```\n\n---\n\n## ⚖️ License & Disclaimers\n\nDeveloped and maintained by [PuterVision](https://putervision.com). Released under the [MIT License](LICENSE).\n\n- **100% Local Execution Guarantee**: All cryptographic operations execute locally in memory via standard W3C Web Crypto API (`crypto.subtle`). Zero external API calls, telemetry, or network transmissions.\n- **Trademarks & Non-Affiliation**: Product names (Cursor, Claude, Google Antigravity, VS Code, GitHub Copilot, Windsurf, Cline, Zed) are property of their respective owners and used solely for compatibility identification.\n",
  "bytes": 8554,
  "sha": "624dd5575403788bba70b2299b83556b00a4708aab5931e845bcf18b655e0d8d",
  "repo_slug": "putervision/webcrypt",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_putervision_webcrypt_e631105b/readme"
}