capiscio 1.2.2__py3-none-any.whl

capiscio/__init__.py

@@ -0,0 +1,10 @@
+"""
+Capiscio - A2A Protocol Validator and CLI Tool
+
+This package provides a Python wrapper around the Capiscio CLI tool,
+allowing easy installation and usage via pip.
+"""
+
+__version__ = "1.2.2"
+__author__ = "Capiscio Team"
+__email__ = "hello@capiscio.com"

capiscio/cli.py

@@ -0,0 +1,133 @@
+#!/usr/bin/env python3
+"""
+Capiscio CLI Wrapper
+
+This module provides a Python wrapper for the Capiscio CLI tool.
+It automatically detects the current platform and architecture,
+then executes the appropriate pre-built binary.
+"""
+
+import os
+import sys
+import platform
+import subprocess
+from pathlib import Path
+from typing import List, Optional
+
+
+def get_platform_binary() -> str:
+    """
+    Determine the correct binary name for the current platform and architecture.
+    
+    Returns:
+        str: The binary filename for this platform
+        
+    Raises:
+        RuntimeError: If the platform/architecture combination is not supported
+    """
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+    
+    # Normalize architecture names
+    if machine in ('x86_64', 'amd64'):
+        arch = 'x64'
+    elif machine in ('arm64', 'aarch64'):
+        arch = 'arm64'
+    else:
+        # Default to x64 for unknown architectures
+        arch = 'x64'
+    
+    # Map platform names
+    if system == 'linux':
+        return f'capiscio-linux-{arch}'
+    elif system == 'darwin':  # macOS
+        return f'capiscio-darwin-{arch}'
+    elif system == 'windows':
+        return f'capiscio-win-{arch}.exe'
+    else:
+        raise RuntimeError(f"Unsupported platform: {system} {machine}")
+
+
+def get_binary_path() -> Path:
+    """
+    Get the full path to the appropriate binary for this platform.
+    
+    Returns:
+        Path: Path to the binary file
+        
+    Raises:
+        FileNotFoundError: If the binary doesn't exist
+        RuntimeError: If the platform is not supported
+    """
+    binary_name = get_platform_binary()
+    
+    # Get the directory where this Python file is located
+    package_dir = Path(__file__).parent
+    binary_path = package_dir / 'binaries' / binary_name
+    
+    if not binary_path.exists():
+        available_binaries = list((package_dir / 'binaries').glob('*'))
+        available_names = [b.name for b in available_binaries if b.is_file()]
+        
+        raise FileNotFoundError(
+            f"Binary '{binary_name}' not found. "
+            f"Available binaries: {', '.join(available_names) or 'none'}"
+        )
+    
+    return binary_path
+
+
+def run_capiscio(args: Optional[List[str]] = None) -> int:
+    """
+    Execute the Capiscio CLI tool with the given arguments.
+    
+    Args:
+        args: Command line arguments to pass to capiscio (default: sys.argv[1:])
+        
+    Returns:
+        int: Exit code from the capiscio process
+        
+    Raises:
+        FileNotFoundError: If the binary doesn't exist
+        RuntimeError: If the platform is not supported
+    """
+    if args is None:
+        args = sys.argv[1:]
+    
+    binary_path = get_binary_path()
+    
+    # Make sure the binary is executable on Unix-like systems
+    if os.name != 'nt':  # Not Windows
+        os.chmod(binary_path, 0o755)
+    
+    try:
+        # Execute the binary with the provided arguments
+        result = subprocess.run([str(binary_path)] + args)
+        return result.returncode
+    except KeyboardInterrupt:
+        # Handle Ctrl+C gracefully
+        return 130
+    except Exception as e:
+        print(f"Error executing capiscio: {e}", file=sys.stderr)
+        return 1
+
+
+def main() -> int:
+    """
+    Main entry point for the capiscio command.
+    
+    This function is called when running `capiscio` from the command line
+    after installing the package via pip.
+    
+    Returns:
+        int: Exit code
+    """
+    try:
+        return run_capiscio()
+    except Exception as e:
+        print(f"capiscio: {e}", file=sys.stderr)
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())

capiscio-1.2.2.dist-info/METADATA

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: capiscio
+Version: 1.2.2
+Summary: A2A protocol validator and CLI tool
+Author-email: Capiscio Team <hello@capiscio.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/capiscio/capiscio-cli
+Project-URL: Bug Reports, https://github.com/capiscio/capiscio-cli/issues
+Project-URL: Source, https://github.com/capiscio/capiscio-cli
+Keywords: a2a,protocol,validation,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# Capiscio CLI - A2A Protocol Validator (Python Package)
+
+> **Validator & A2A Protocol Compliance CLI** | The only CLI that actually tests AI agent transport protocols. Validate agent-card.json files, A2A compliance across JSONRPC, GRPC, and REST with live endpoint testing.
+
+🌐 **[Learn more about Capiscio](https://capisc.io)** | **[Download Page](https://capisc.io/downloads)** | **[Web Validator](https://capisc.io/validator)**
+
+[![PyPI version](https://badge.fury.io/py/capiscio.svg)](https://badge.fury.io/py/capiscio)
+[![Downloads](https://img.shields.io/pypi/dm/capiscio)](https://pypi.org/project/capiscio/)
+[![Python](https://img.shields.io/badge/python-3.7+-blue.svg)](https://python.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/capiscio/capiscio-cli/blob/main/LICENSE)
+
+## Installation
+
+```bash
+pip install capiscio
+```
+
+**Zero dependencies required** - This package contains pre-built native binaries that work without Python runtime dependencies.
+
+## Quick Start
+
+**💡 Prefer a web interface?** Try our [online validator at capisc.io](https://capisc.io/validator) - no installation required!
+
+```bash
+# Validate your agent (with signature verification)
+capiscio validate ./agent-card.json
+
+# Test live endpoints with cryptographic verification  
+capiscio validate https://your-agent.com
+
+# Strict validation for production deployment
+capiscio validate ./agent-card.json --strict --json
+
+# Skip signature verification when not needed
+capiscio validate ./agent-card.json --skip-signature
+```
+
+## Key Features
+
+- **🚀 Transport Protocol Testing** - Actually tests JSONRPC, GRPC, and REST endpoints
+- **🔐 JWS Signature Verification** - Cryptographic validation of agent cards (RFC 7515 compliant)
+- **💻 Native Binaries** - No Node.js or runtime dependencies required
+- **🔍 Smart Discovery** - Finds agent cards automatically with multiple fallbacks
+- **⚡ Three Validation Modes** - Progressive, strict, and conservative
+- **🔧 CI/CD Ready** - JSON output with proper exit codes
+- **🌐 Live Endpoint Testing** - Validates real connectivity, not just schemas
+- **🛡️ Secure by Default** - Signature verification enabled automatically
+
+## Usage Examples
+
+### Basic Commands
+
+```bash
+capiscio validate [input] [options]
+
+# Examples
+capiscio validate                              # Auto-detect in current directory
+capiscio validate ./agent-card.json           # Validate local file (with signatures)
+capiscio validate https://agent.com           # Test live agent (with signatures)
+capiscio validate ./agent-card.json --skip-signature # Skip signature verification
+capiscio validate ./agent-card.json --verbose # Detailed output
+capiscio validate ./agent-card.json --registry-ready # Check registry readiness
+capiscio validate https://agent.com --errors-only    # Show only problems
+```
+
+### Key Options
+
+| Option | Description |
+|--------|-------------|
+| --strict | Strict A2A protocol compliance |
+| --json | JSON output for CI/CD |
+| --verbose | Detailed validation steps |
+| --timeout <ms> | Request timeout (default: 10000) |
+| --schema-only | Skip live endpoint testing |
+| --skip-signature | Skip JWS signature verification |
+| --registry-ready | Registry deployment validation |
+
+## Signature Verification (New in v1.2.0)
+
+**Secure by default** JWS signature verification for agent cards:
+
+### 🔐 Cryptographic Validation
+- **RFC 7515 compliant** JWS (JSON Web Signature) verification
+- **JWKS (JSON Web Key Set)** fetching from trusted sources
+- **Detached signature** support for agent card authentication
+- **HTTPS-only** JWKS endpoints for security
+
+### 🛡️ Security Benefits
+- **Authenticity** - Verify agent cards haven't been tampered with
+- **Trust** - Cryptographically confirm the publisher's identity  
+- **Security** - Prevent malicious agent card injection
+- **Compliance** - Meet security requirements for production deployments
+
+## Why Use Capiscio CLI?
+
+**Catch Integration Issues Before Production:**
+- ❌ Schema validators miss broken JSONRPC endpoints  
+- ❌ Manual testing doesn't cover all transport protocols
+- ❌ Integration failures happen at runtime
+- ❌ Unsigned agent cards can't be trusted
+- ✅ **Capiscio tests actual connectivity and protocol compliance**
+- ✅ **Capiscio verifies cryptographic signatures for authenticity**
+
+**Real Problems This Solves:**
+- JSONRPC methods return wrong error codes
+- GRPC services are unreachable or misconfigured  
+- REST endpoints don't match declared capabilities
+- Agent cards validate but agents don't work
+- Unsigned or tampered agent cards pose security risks
+
+## Transport Protocol Testing
+
+Unlike basic schema validators, Capiscio CLI actually tests your agent endpoints:
+
+- **JSONRPC** - Validates JSON-RPC 2.0 compliance and connectivity
+- **GRPC** - Tests gRPC endpoint accessibility
+- **REST** - Verifies HTTP+JSON endpoint patterns
+- **Consistency** - Ensures equivalent functionality across protocols
+
+Perfect for testing your own agents and evaluating third-party agents before integration.
+
+## CI/CD Integration
+
+### GitHub Actions Example:
+```yaml
+- name: Install and Validate Agent
+  run: |
+    pip install capiscio
+    capiscio validate ./agent-card.json --json --strict
+```
+
+### Docker Example:
+```dockerfile
+RUN pip install capiscio
+COPY agent-card.json .
+RUN capiscio validate ./agent-card.json --strict
+```
+
+Exit codes: 0 = success, 1 = validation failed
+
+## Platform Support
+
+This package contains pre-built binaries for multiple platforms:
+
+- **Linux**: x86_64, ARM64
+- **macOS**: Intel (x64), Apple Silicon (ARM64) 
+- **Windows**: x64 (ARM64 available via [direct download](https://capisc.io/downloads))
+- **Python**: 3.7+ (no runtime dependencies required)
+
+The Python wrapper automatically detects your platform and runs the appropriate native binary.
+
+## FAQ
+
+**Q: What is the A2A Protocol?**  
+A: The Agent-to-Agent (A2A) protocol v0.3.0 is a standardized specification for AI agent discovery, communication, and interoperability. [Learn more at capisc.io](https://capisc.io).
+
+**Q: How is this different from schema validators?**  
+A: We actually test live JSONRPC, GRPC, and REST endpoints with transport protocol validation, not just JSON schema structure. We also verify JWS signatures for cryptographic authenticity.
+
+**Q: Do I need Node.js installed?**  
+A: No! This Python package contains pre-built native binaries that work without any Node.js dependency.
+
+**Q: Can I validate LLM agent cards?**  
+A: Yes! Perfect for AI/LLM developers validating agent configurations and testing third-party agents before integration.
+
+## Development
+
+This package contains pre-built native binaries compiled for maximum performance and zero dependencies. The CLI provides the same functionality across all platforms without requiring any additional runtime installations.
+
+**Source code:** https://github.com/capiscio/capiscio-cli
+
+## License
+
+MIT License - see the [main repository](https://github.com/capiscio/capiscio-cli/blob/main/LICENSE) for details.
+
+---
+
+**Need help?** [Visit capisc.io](https://capisc.io) | [Open an issue](https://github.com/capiscio/capiscio-cli/issues) | [Documentation](https://capisc.io/cli) | [Web Validator](https://capisc.io/validator)
+
+**Keywords**: A2A protocol, AI agent validation, agent-card.json validator, Python CLI, agent-to-agent protocol, LLM agent cards, AI agent discovery, transport protocol testing, JSONRPC validation, GRPC testing, JWS signature verification

capiscio-1.2.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+capiscio/__init__.py,sha256=XO2PkB1ZSslNlud8F003eFA_mJuGmHs6XzebnuwFvEs,255
+capiscio/cli.py,sha256=bQ_BJVsthM1Bd7Y658Gjcj9xadl2zSWGIQjesARm0Tg,3650
+capiscio/binaries/capiscio-darwin-arm64,sha256=BvTrIGd-kfNMPm3ucBvOcB4juK9NGq-GxHbK6P3CSCA,50595728
+capiscio/binaries/capiscio-darwin-x64,sha256=bLNEYPHq9r0enkg6zDaYbTTgLdIxvN1kQYz1m6h22DQ,56817072
+capiscio/binaries/capiscio-linux-x64,sha256=aHpxH9sQWdp96ob-fOOfqoaA_D4V6_rrpM0P8ffF6so,52127941
+capiscio/binaries/capiscio-win-arm64.exe,sha256=nE2EaQd_T9cKnbWkkL_-CQ9ow44H1Wp7tZIlPRTQC6s,29917646
+capiscio/binaries/capiscio-win-x64.exe,sha256=fyO3JSqx0tkiJsviLXenuA7eBdd1cq13ynjCaAS3T-I,43340158
+capiscio-1.2.2.dist-info/METADATA,sha256=IqwKy_ySha49-LV79I6MARd1IHlx9KNPwYWJAqzFg5c,8672
+capiscio-1.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+capiscio-1.2.2.dist-info/entry_points.txt,sha256=VopPHB5eo2LBjOFiraE3JiEOzVmJJVwtUPVfXlYS_ns,47
+capiscio-1.2.2.dist-info/top_level.txt,sha256=Kuk2V-rnWre1x0tW87SRnlteIV1NhngUaXo6V1klMHk,9
+capiscio-1.2.2.dist-info/RECORD,,

capiscio-1.2.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

capiscio-1.2.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+capiscio = capiscio.cli:main

capiscio-1.2.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+capiscio