capiscio 1.2.5__tar.gz → 2.0.0__tar.gz
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.
- {capiscio-1.2.5/capiscio.egg-info → capiscio-2.0.0}/PKG-INFO +90 -8
- capiscio-1.2.5/PKG-INFO → capiscio-2.0.0/README.md +70 -30
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio/__init__.py +1 -1
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio/binaries/capiscio-darwin-arm64 +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio/binaries/capiscio-darwin-x64 +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio/binaries/capiscio-linux-x64 +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio/binaries/capiscio-win-x64.exe +0 -0
- capiscio-1.2.5/README.md → capiscio-2.0.0/capiscio.egg-info/PKG-INFO +112 -3
- capiscio-2.0.0/pyproject.toml +67 -0
- capiscio-1.2.5/pyproject.toml +0 -46
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio/cli.py +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio.egg-info/SOURCES.txt +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio.egg-info/dependency_links.txt +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio.egg-info/entry_points.txt +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/capiscio.egg-info/top_level.txt +0 -0
- {capiscio-1.2.5 → capiscio-2.0.0}/setup.cfg +0 -0
|
@@ -1,15 +1,24 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: capiscio
|
|
3
|
-
Version:
|
|
4
|
-
Summary: A2A protocol validator and
|
|
3
|
+
Version: 2.0.0
|
|
4
|
+
Summary: The definitive A2A protocol validator with live endpoint testing, JWS signature verification, and transport protocol compliance checking
|
|
5
5
|
Author-email: Capiscio Team <hello@capiscio.com>
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
Maintainer-email: Capiscio Team <hello@capiscio.com>
|
|
7
|
+
License: MIT
|
|
8
|
+
Project-URL: Homepage, https://capisc.io
|
|
9
|
+
Project-URL: Documentation, https://capisc.io/cli
|
|
10
|
+
Project-URL: Repository, https://github.com/capiscio/capiscio-cli
|
|
8
11
|
Project-URL: Bug Reports, https://github.com/capiscio/capiscio-cli/issues
|
|
12
|
+
Project-URL: Changelog, https://github.com/capiscio/capiscio-cli/releases
|
|
13
|
+
Project-URL: Download, https://capisc.io/downloads
|
|
14
|
+
Project-URL: Web Validator, https://capisc.io/validator
|
|
9
15
|
Project-URL: Source, https://github.com/capiscio/capiscio-cli
|
|
10
|
-
Keywords: a2a,protocol,validation,cli
|
|
16
|
+
Keywords: a2a,protocol,validation,cli,agent,ai,jsonrpc,grpc,rest,jws,signature,verification,transport,testing,compliance,agent-card,llm,agent-to-agent,cryptography,security,endpoint
|
|
11
17
|
Classifier: Development Status :: 4 - Beta
|
|
12
18
|
Classifier: Intended Audience :: Developers
|
|
19
|
+
Classifier: Intended Audience :: System Administrators
|
|
20
|
+
Classifier: Intended Audience :: Information Technology
|
|
21
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
13
22
|
Classifier: Programming Language :: Python :: 3
|
|
14
23
|
Classifier: Programming Language :: Python :: 3.7
|
|
15
24
|
Classifier: Programming Language :: Python :: 3.8
|
|
@@ -19,13 +28,19 @@ Classifier: Programming Language :: Python :: 3.11
|
|
|
19
28
|
Classifier: Programming Language :: Python :: 3.12
|
|
20
29
|
Classifier: Programming Language :: Python :: 3.13
|
|
21
30
|
Classifier: Operating System :: OS Independent
|
|
31
|
+
Classifier: Environment :: Console
|
|
22
32
|
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
23
|
-
Classifier: Topic ::
|
|
33
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
24
34
|
Classifier: Topic :: Software Development :: Testing
|
|
35
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
36
|
+
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
|
|
37
|
+
Classifier: Topic :: Security :: Cryptography
|
|
38
|
+
Classifier: Topic :: System :: Networking
|
|
39
|
+
Classifier: Topic :: System :: Distributed Computing
|
|
25
40
|
Requires-Python: >=3.7
|
|
26
41
|
Description-Content-Type: text/markdown
|
|
27
42
|
|
|
28
|
-
# Capiscio CLI - A2A Protocol Validator
|
|
43
|
+
# Capiscio CLI - A2A Protocol Validator
|
|
29
44
|
|
|
30
45
|
> **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.
|
|
31
46
|
|
|
@@ -35,6 +50,8 @@ Description-Content-Type: text/markdown
|
|
|
35
50
|
[](https://pypi.org/project/capiscio/)
|
|
36
51
|
[](https://python.org/)
|
|
37
52
|
[](https://github.com/capiscio/capiscio-cli/blob/main/LICENSE)
|
|
53
|
+
[](https://capisc.io)
|
|
54
|
+
[](https://capisc.io)
|
|
38
55
|
|
|
39
56
|
## Installation
|
|
40
57
|
|
|
@@ -62,6 +79,21 @@ capiscio validate ./agent-card.json --strict --json
|
|
|
62
79
|
capiscio validate ./agent-card.json --skip-signature
|
|
63
80
|
```
|
|
64
81
|
|
|
82
|
+
## Security & Trust 🔐
|
|
83
|
+
|
|
84
|
+
**Industry-grade cryptographic validation:**
|
|
85
|
+
- ✅ **RFC 7515 compliant** JWS signature verification
|
|
86
|
+
- ✅ **HTTPS-only** JWKS endpoint fetching
|
|
87
|
+
- ✅ **Secure by default** - signatures checked automatically
|
|
88
|
+
- ✅ **Zero trust** - verify before you trust any agent card
|
|
89
|
+
- ✅ **Production ready** - meets enterprise security standards
|
|
90
|
+
|
|
91
|
+
**Why signature verification matters:**
|
|
92
|
+
- **Prevent tampering** - Detect modified or malicious agent cards
|
|
93
|
+
- **Establish authenticity** - Cryptographically verify publisher identity
|
|
94
|
+
- **Enable trust networks** - Build secure agent ecosystems
|
|
95
|
+
- **Regulatory compliance** - Meet security audit requirements
|
|
96
|
+
|
|
65
97
|
## Key Features
|
|
66
98
|
|
|
67
99
|
- **🚀 Transport Protocol Testing** - Actually tests JSONRPC, GRPC, and REST endpoints
|
|
@@ -100,7 +132,57 @@ capiscio validate https://agent.com --errors-only # Show only problems
|
|
|
100
132
|
| --timeout <ms> | Request timeout (default: 10000) |
|
|
101
133
|
| --schema-only | Skip live endpoint testing |
|
|
102
134
|
| --skip-signature | Skip JWS signature verification |
|
|
103
|
-
| --
|
|
135
|
+
| --test-live | Test agent endpoint with real messages |
|
|
136
|
+
|
|
137
|
+
### Three-Dimensional Scoring
|
|
138
|
+
|
|
139
|
+
Capiscio CLI automatically provides detailed quality scoring across three independent dimensions:
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
# Scoring is shown by default
|
|
143
|
+
capiscio validate agent.json
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
**Three Quality Dimensions:**
|
|
147
|
+
- **Spec Compliance (0-100)** - How well does the agent conform to A2A v0.3.0?
|
|
148
|
+
- **Trust (0-100)** - How trustworthy and secure is this agent? (includes confidence multiplier)
|
|
149
|
+
- **Availability (0-100)** - Is the endpoint operational? (requires `--test-live`)
|
|
150
|
+
|
|
151
|
+
Each score includes a detailed breakdown showing exactly what contributed to the result. **Learn more:** [Scoring System Documentation](https://github.com/capiscio/capiscio-cli/blob/main/docs/scoring-system.md)
|
|
152
|
+
|
|
153
|
+
### Live Agent Testing
|
|
154
|
+
|
|
155
|
+
The `--test-live` flag tests your agent endpoint with real A2A protocol messages:
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
# Test agent endpoint
|
|
159
|
+
capiscio validate https://agent.com --test-live
|
|
160
|
+
|
|
161
|
+
# Test with custom timeout
|
|
162
|
+
capiscio validate ./agent-card.json --test-live --timeout 5000
|
|
163
|
+
|
|
164
|
+
# Full validation for production
|
|
165
|
+
capiscio validate https://agent.com --test-live --strict --json
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
**What it validates:**
|
|
169
|
+
- ✅ Endpoint connectivity
|
|
170
|
+
- ✅ JSONRPC and HTTP+JSON transport protocols
|
|
171
|
+
- ✅ A2A message structure (Message, Task, StatusUpdate, ArtifactUpdate)
|
|
172
|
+
- ✅ Response timing metrics
|
|
173
|
+
|
|
174
|
+
**Exit codes for automation:**
|
|
175
|
+
- `0` = Success
|
|
176
|
+
- `1` = Schema validation failed
|
|
177
|
+
- `2` = Network error (timeout, connection refused, DNS)
|
|
178
|
+
- `3` = Protocol violation (invalid A2A response)
|
|
179
|
+
|
|
180
|
+
**Use cases:**
|
|
181
|
+
- CI/CD post-deployment verification
|
|
182
|
+
- Cron-based health monitoring
|
|
183
|
+
- Pre-production testing
|
|
184
|
+
- Third-party agent evaluation
|
|
185
|
+
- Multi-environment validation
|
|
104
186
|
|
|
105
187
|
## Signature Verification (New in v1.2.0)
|
|
106
188
|
|
|
@@ -1,31 +1,4 @@
|
|
|
1
|
-
|
|
2
|
-
Name: capiscio
|
|
3
|
-
Version: 1.2.5
|
|
4
|
-
Summary: A2A protocol validator and CLI tool
|
|
5
|
-
Author-email: Capiscio Team <hello@capiscio.com>
|
|
6
|
-
License-Expression: MIT
|
|
7
|
-
Project-URL: Homepage, https://github.com/capiscio/capiscio-cli
|
|
8
|
-
Project-URL: Bug Reports, https://github.com/capiscio/capiscio-cli/issues
|
|
9
|
-
Project-URL: Source, https://github.com/capiscio/capiscio-cli
|
|
10
|
-
Keywords: a2a,protocol,validation,cli
|
|
11
|
-
Classifier: Development Status :: 4 - Beta
|
|
12
|
-
Classifier: Intended Audience :: Developers
|
|
13
|
-
Classifier: Programming Language :: Python :: 3
|
|
14
|
-
Classifier: Programming Language :: Python :: 3.7
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.8
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
21
|
-
Classifier: Operating System :: OS Independent
|
|
22
|
-
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
23
|
-
Classifier: Topic :: Internet :: WWW/HTTP
|
|
24
|
-
Classifier: Topic :: Software Development :: Testing
|
|
25
|
-
Requires-Python: >=3.7
|
|
26
|
-
Description-Content-Type: text/markdown
|
|
27
|
-
|
|
28
|
-
# Capiscio CLI - A2A Protocol Validator (Python Package)
|
|
1
|
+
# Capiscio CLI - A2A Protocol Validator
|
|
29
2
|
|
|
30
3
|
> **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.
|
|
31
4
|
|
|
@@ -35,6 +8,8 @@ Description-Content-Type: text/markdown
|
|
|
35
8
|
[](https://pypi.org/project/capiscio/)
|
|
36
9
|
[](https://python.org/)
|
|
37
10
|
[](https://github.com/capiscio/capiscio-cli/blob/main/LICENSE)
|
|
11
|
+
[](https://capisc.io)
|
|
12
|
+
[](https://capisc.io)
|
|
38
13
|
|
|
39
14
|
## Installation
|
|
40
15
|
|
|
@@ -62,6 +37,21 @@ capiscio validate ./agent-card.json --strict --json
|
|
|
62
37
|
capiscio validate ./agent-card.json --skip-signature
|
|
63
38
|
```
|
|
64
39
|
|
|
40
|
+
## Security & Trust 🔐
|
|
41
|
+
|
|
42
|
+
**Industry-grade cryptographic validation:**
|
|
43
|
+
- ✅ **RFC 7515 compliant** JWS signature verification
|
|
44
|
+
- ✅ **HTTPS-only** JWKS endpoint fetching
|
|
45
|
+
- ✅ **Secure by default** - signatures checked automatically
|
|
46
|
+
- ✅ **Zero trust** - verify before you trust any agent card
|
|
47
|
+
- ✅ **Production ready** - meets enterprise security standards
|
|
48
|
+
|
|
49
|
+
**Why signature verification matters:**
|
|
50
|
+
- **Prevent tampering** - Detect modified or malicious agent cards
|
|
51
|
+
- **Establish authenticity** - Cryptographically verify publisher identity
|
|
52
|
+
- **Enable trust networks** - Build secure agent ecosystems
|
|
53
|
+
- **Regulatory compliance** - Meet security audit requirements
|
|
54
|
+
|
|
65
55
|
## Key Features
|
|
66
56
|
|
|
67
57
|
- **🚀 Transport Protocol Testing** - Actually tests JSONRPC, GRPC, and REST endpoints
|
|
@@ -100,7 +90,57 @@ capiscio validate https://agent.com --errors-only # Show only problems
|
|
|
100
90
|
| --timeout <ms> | Request timeout (default: 10000) |
|
|
101
91
|
| --schema-only | Skip live endpoint testing |
|
|
102
92
|
| --skip-signature | Skip JWS signature verification |
|
|
103
|
-
| --
|
|
93
|
+
| --test-live | Test agent endpoint with real messages |
|
|
94
|
+
|
|
95
|
+
### Three-Dimensional Scoring
|
|
96
|
+
|
|
97
|
+
Capiscio CLI automatically provides detailed quality scoring across three independent dimensions:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
# Scoring is shown by default
|
|
101
|
+
capiscio validate agent.json
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
**Three Quality Dimensions:**
|
|
105
|
+
- **Spec Compliance (0-100)** - How well does the agent conform to A2A v0.3.0?
|
|
106
|
+
- **Trust (0-100)** - How trustworthy and secure is this agent? (includes confidence multiplier)
|
|
107
|
+
- **Availability (0-100)** - Is the endpoint operational? (requires `--test-live`)
|
|
108
|
+
|
|
109
|
+
Each score includes a detailed breakdown showing exactly what contributed to the result. **Learn more:** [Scoring System Documentation](https://github.com/capiscio/capiscio-cli/blob/main/docs/scoring-system.md)
|
|
110
|
+
|
|
111
|
+
### Live Agent Testing
|
|
112
|
+
|
|
113
|
+
The `--test-live` flag tests your agent endpoint with real A2A protocol messages:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
# Test agent endpoint
|
|
117
|
+
capiscio validate https://agent.com --test-live
|
|
118
|
+
|
|
119
|
+
# Test with custom timeout
|
|
120
|
+
capiscio validate ./agent-card.json --test-live --timeout 5000
|
|
121
|
+
|
|
122
|
+
# Full validation for production
|
|
123
|
+
capiscio validate https://agent.com --test-live --strict --json
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
**What it validates:**
|
|
127
|
+
- ✅ Endpoint connectivity
|
|
128
|
+
- ✅ JSONRPC and HTTP+JSON transport protocols
|
|
129
|
+
- ✅ A2A message structure (Message, Task, StatusUpdate, ArtifactUpdate)
|
|
130
|
+
- ✅ Response timing metrics
|
|
131
|
+
|
|
132
|
+
**Exit codes for automation:**
|
|
133
|
+
- `0` = Success
|
|
134
|
+
- `1` = Schema validation failed
|
|
135
|
+
- `2` = Network error (timeout, connection refused, DNS)
|
|
136
|
+
- `3` = Protocol violation (invalid A2A response)
|
|
137
|
+
|
|
138
|
+
**Use cases:**
|
|
139
|
+
- CI/CD post-deployment verification
|
|
140
|
+
- Cron-based health monitoring
|
|
141
|
+
- Pre-production testing
|
|
142
|
+
- Third-party agent evaluation
|
|
143
|
+
- Multi-environment validation
|
|
104
144
|
|
|
105
145
|
## Signature Verification (New in v1.2.0)
|
|
106
146
|
|
|
@@ -204,4 +244,4 @@ MIT License - see the [main repository](https://github.com/capiscio/capiscio-cli
|
|
|
204
244
|
|
|
205
245
|
**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)
|
|
206
246
|
|
|
207
|
-
**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
|
|
247
|
+
**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
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -1,4 +1,46 @@
|
|
|
1
|
-
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: capiscio
|
|
3
|
+
Version: 2.0.0
|
|
4
|
+
Summary: The definitive A2A protocol validator with live endpoint testing, JWS signature verification, and transport protocol compliance checking
|
|
5
|
+
Author-email: Capiscio Team <hello@capiscio.com>
|
|
6
|
+
Maintainer-email: Capiscio Team <hello@capiscio.com>
|
|
7
|
+
License: MIT
|
|
8
|
+
Project-URL: Homepage, https://capisc.io
|
|
9
|
+
Project-URL: Documentation, https://capisc.io/cli
|
|
10
|
+
Project-URL: Repository, https://github.com/capiscio/capiscio-cli
|
|
11
|
+
Project-URL: Bug Reports, https://github.com/capiscio/capiscio-cli/issues
|
|
12
|
+
Project-URL: Changelog, https://github.com/capiscio/capiscio-cli/releases
|
|
13
|
+
Project-URL: Download, https://capisc.io/downloads
|
|
14
|
+
Project-URL: Web Validator, https://capisc.io/validator
|
|
15
|
+
Project-URL: Source, https://github.com/capiscio/capiscio-cli
|
|
16
|
+
Keywords: a2a,protocol,validation,cli,agent,ai,jsonrpc,grpc,rest,jws,signature,verification,transport,testing,compliance,agent-card,llm,agent-to-agent,cryptography,security,endpoint
|
|
17
|
+
Classifier: Development Status :: 4 - Beta
|
|
18
|
+
Classifier: Intended Audience :: Developers
|
|
19
|
+
Classifier: Intended Audience :: System Administrators
|
|
20
|
+
Classifier: Intended Audience :: Information Technology
|
|
21
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
22
|
+
Classifier: Programming Language :: Python :: 3
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.7
|
|
24
|
+
Classifier: Programming Language :: Python :: 3.8
|
|
25
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
26
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
27
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
28
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
29
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
30
|
+
Classifier: Operating System :: OS Independent
|
|
31
|
+
Classifier: Environment :: Console
|
|
32
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
33
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
34
|
+
Classifier: Topic :: Software Development :: Testing
|
|
35
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
36
|
+
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
|
|
37
|
+
Classifier: Topic :: Security :: Cryptography
|
|
38
|
+
Classifier: Topic :: System :: Networking
|
|
39
|
+
Classifier: Topic :: System :: Distributed Computing
|
|
40
|
+
Requires-Python: >=3.7
|
|
41
|
+
Description-Content-Type: text/markdown
|
|
42
|
+
|
|
43
|
+
# Capiscio CLI - A2A Protocol Validator
|
|
2
44
|
|
|
3
45
|
> **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.
|
|
4
46
|
|
|
@@ -8,6 +50,8 @@
|
|
|
8
50
|
[](https://pypi.org/project/capiscio/)
|
|
9
51
|
[](https://python.org/)
|
|
10
52
|
[](https://github.com/capiscio/capiscio-cli/blob/main/LICENSE)
|
|
53
|
+
[](https://capisc.io)
|
|
54
|
+
[](https://capisc.io)
|
|
11
55
|
|
|
12
56
|
## Installation
|
|
13
57
|
|
|
@@ -35,6 +79,21 @@ capiscio validate ./agent-card.json --strict --json
|
|
|
35
79
|
capiscio validate ./agent-card.json --skip-signature
|
|
36
80
|
```
|
|
37
81
|
|
|
82
|
+
## Security & Trust 🔐
|
|
83
|
+
|
|
84
|
+
**Industry-grade cryptographic validation:**
|
|
85
|
+
- ✅ **RFC 7515 compliant** JWS signature verification
|
|
86
|
+
- ✅ **HTTPS-only** JWKS endpoint fetching
|
|
87
|
+
- ✅ **Secure by default** - signatures checked automatically
|
|
88
|
+
- ✅ **Zero trust** - verify before you trust any agent card
|
|
89
|
+
- ✅ **Production ready** - meets enterprise security standards
|
|
90
|
+
|
|
91
|
+
**Why signature verification matters:**
|
|
92
|
+
- **Prevent tampering** - Detect modified or malicious agent cards
|
|
93
|
+
- **Establish authenticity** - Cryptographically verify publisher identity
|
|
94
|
+
- **Enable trust networks** - Build secure agent ecosystems
|
|
95
|
+
- **Regulatory compliance** - Meet security audit requirements
|
|
96
|
+
|
|
38
97
|
## Key Features
|
|
39
98
|
|
|
40
99
|
- **🚀 Transport Protocol Testing** - Actually tests JSONRPC, GRPC, and REST endpoints
|
|
@@ -73,7 +132,57 @@ capiscio validate https://agent.com --errors-only # Show only problems
|
|
|
73
132
|
| --timeout <ms> | Request timeout (default: 10000) |
|
|
74
133
|
| --schema-only | Skip live endpoint testing |
|
|
75
134
|
| --skip-signature | Skip JWS signature verification |
|
|
76
|
-
| --
|
|
135
|
+
| --test-live | Test agent endpoint with real messages |
|
|
136
|
+
|
|
137
|
+
### Three-Dimensional Scoring
|
|
138
|
+
|
|
139
|
+
Capiscio CLI automatically provides detailed quality scoring across three independent dimensions:
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
# Scoring is shown by default
|
|
143
|
+
capiscio validate agent.json
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
**Three Quality Dimensions:**
|
|
147
|
+
- **Spec Compliance (0-100)** - How well does the agent conform to A2A v0.3.0?
|
|
148
|
+
- **Trust (0-100)** - How trustworthy and secure is this agent? (includes confidence multiplier)
|
|
149
|
+
- **Availability (0-100)** - Is the endpoint operational? (requires `--test-live`)
|
|
150
|
+
|
|
151
|
+
Each score includes a detailed breakdown showing exactly what contributed to the result. **Learn more:** [Scoring System Documentation](https://github.com/capiscio/capiscio-cli/blob/main/docs/scoring-system.md)
|
|
152
|
+
|
|
153
|
+
### Live Agent Testing
|
|
154
|
+
|
|
155
|
+
The `--test-live` flag tests your agent endpoint with real A2A protocol messages:
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
# Test agent endpoint
|
|
159
|
+
capiscio validate https://agent.com --test-live
|
|
160
|
+
|
|
161
|
+
# Test with custom timeout
|
|
162
|
+
capiscio validate ./agent-card.json --test-live --timeout 5000
|
|
163
|
+
|
|
164
|
+
# Full validation for production
|
|
165
|
+
capiscio validate https://agent.com --test-live --strict --json
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
**What it validates:**
|
|
169
|
+
- ✅ Endpoint connectivity
|
|
170
|
+
- ✅ JSONRPC and HTTP+JSON transport protocols
|
|
171
|
+
- ✅ A2A message structure (Message, Task, StatusUpdate, ArtifactUpdate)
|
|
172
|
+
- ✅ Response timing metrics
|
|
173
|
+
|
|
174
|
+
**Exit codes for automation:**
|
|
175
|
+
- `0` = Success
|
|
176
|
+
- `1` = Schema validation failed
|
|
177
|
+
- `2` = Network error (timeout, connection refused, DNS)
|
|
178
|
+
- `3` = Protocol violation (invalid A2A response)
|
|
179
|
+
|
|
180
|
+
**Use cases:**
|
|
181
|
+
- CI/CD post-deployment verification
|
|
182
|
+
- Cron-based health monitoring
|
|
183
|
+
- Pre-production testing
|
|
184
|
+
- Third-party agent evaluation
|
|
185
|
+
- Multi-environment validation
|
|
77
186
|
|
|
78
187
|
## Signature Verification (New in v1.2.0)
|
|
79
188
|
|
|
@@ -177,4 +286,4 @@ MIT License - see the [main repository](https://github.com/capiscio/capiscio-cli
|
|
|
177
286
|
|
|
178
287
|
**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)
|
|
179
288
|
|
|
180
|
-
**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
|
|
289
|
+
**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
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=61.0", "wheel"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "capiscio"
|
|
7
|
+
version = "2.0.0"
|
|
8
|
+
description = "The definitive A2A protocol validator with live endpoint testing, JWS signature verification, and transport protocol compliance checking"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.7"
|
|
11
|
+
license = {text = "MIT"}
|
|
12
|
+
authors = [
|
|
13
|
+
{name = "Capiscio Team", email = "hello@capiscio.com"}
|
|
14
|
+
]
|
|
15
|
+
maintainers = [
|
|
16
|
+
{name = "Capiscio Team", email = "hello@capiscio.com"}
|
|
17
|
+
]
|
|
18
|
+
keywords = [
|
|
19
|
+
"a2a", "protocol", "validation", "cli", "agent", "ai", "jsonrpc", "grpc", "rest",
|
|
20
|
+
"jws", "signature", "verification", "transport", "testing", "compliance",
|
|
21
|
+
"agent-card", "llm", "agent-to-agent", "cryptography", "security", "endpoint"
|
|
22
|
+
]
|
|
23
|
+
classifiers = [
|
|
24
|
+
"Development Status :: 4 - Beta",
|
|
25
|
+
"Intended Audience :: Developers",
|
|
26
|
+
"Intended Audience :: System Administrators",
|
|
27
|
+
"Intended Audience :: Information Technology",
|
|
28
|
+
"License :: OSI Approved :: MIT License",
|
|
29
|
+
"Programming Language :: Python :: 3",
|
|
30
|
+
"Programming Language :: Python :: 3.7",
|
|
31
|
+
"Programming Language :: Python :: 3.8",
|
|
32
|
+
"Programming Language :: Python :: 3.9",
|
|
33
|
+
"Programming Language :: Python :: 3.10",
|
|
34
|
+
"Programming Language :: Python :: 3.11",
|
|
35
|
+
"Programming Language :: Python :: 3.12",
|
|
36
|
+
"Programming Language :: Python :: 3.13",
|
|
37
|
+
"Operating System :: OS Independent",
|
|
38
|
+
"Environment :: Console",
|
|
39
|
+
"Topic :: Software Development :: Libraries :: Python Modules",
|
|
40
|
+
"Topic :: Software Development :: Quality Assurance",
|
|
41
|
+
"Topic :: Software Development :: Testing",
|
|
42
|
+
"Topic :: Internet :: WWW/HTTP",
|
|
43
|
+
"Topic :: Internet :: WWW/HTTP :: HTTP Servers",
|
|
44
|
+
"Topic :: Security :: Cryptography",
|
|
45
|
+
"Topic :: System :: Networking",
|
|
46
|
+
"Topic :: System :: Distributed Computing",
|
|
47
|
+
]
|
|
48
|
+
|
|
49
|
+
[project.urls]
|
|
50
|
+
"Homepage" = "https://capisc.io"
|
|
51
|
+
"Documentation" = "https://capisc.io/cli"
|
|
52
|
+
"Repository" = "https://github.com/capiscio/capiscio-cli"
|
|
53
|
+
"Bug Reports" = "https://github.com/capiscio/capiscio-cli/issues"
|
|
54
|
+
"Changelog" = "https://github.com/capiscio/capiscio-cli/releases"
|
|
55
|
+
"Download" = "https://capisc.io/downloads"
|
|
56
|
+
"Web Validator" = "https://capisc.io/validator"
|
|
57
|
+
"Source" = "https://github.com/capiscio/capiscio-cli"
|
|
58
|
+
|
|
59
|
+
[project.scripts]
|
|
60
|
+
capiscio = "capiscio.cli:main"
|
|
61
|
+
|
|
62
|
+
[tool.setuptools.packages.find]
|
|
63
|
+
where = ["."]
|
|
64
|
+
include = ["capiscio*"]
|
|
65
|
+
|
|
66
|
+
[tool.setuptools.package-data]
|
|
67
|
+
capiscio = ["binaries/*"]
|
capiscio-1.2.5/pyproject.toml
DELETED
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
[build-system]
|
|
2
|
-
requires = ["setuptools>=61.0", "wheel"]
|
|
3
|
-
build-backend = "setuptools.build_meta"
|
|
4
|
-
|
|
5
|
-
[project]
|
|
6
|
-
name = "capiscio"
|
|
7
|
-
version = "1.2.5"
|
|
8
|
-
description = "A2A protocol validator and CLI tool"
|
|
9
|
-
readme = "README.md"
|
|
10
|
-
requires-python = ">=3.7"
|
|
11
|
-
license = "MIT"
|
|
12
|
-
authors = [
|
|
13
|
-
{name = "Capiscio Team", email = "hello@capiscio.com"}
|
|
14
|
-
]
|
|
15
|
-
keywords = ["a2a", "protocol", "validation", "cli"]
|
|
16
|
-
classifiers = [
|
|
17
|
-
"Development Status :: 4 - Beta",
|
|
18
|
-
"Intended Audience :: Developers",
|
|
19
|
-
"Programming Language :: Python :: 3",
|
|
20
|
-
"Programming Language :: Python :: 3.7",
|
|
21
|
-
"Programming Language :: Python :: 3.8",
|
|
22
|
-
"Programming Language :: Python :: 3.9",
|
|
23
|
-
"Programming Language :: Python :: 3.10",
|
|
24
|
-
"Programming Language :: Python :: 3.11",
|
|
25
|
-
"Programming Language :: Python :: 3.12",
|
|
26
|
-
"Programming Language :: Python :: 3.13",
|
|
27
|
-
"Operating System :: OS Independent",
|
|
28
|
-
"Topic :: Software Development :: Libraries :: Python Modules",
|
|
29
|
-
"Topic :: Internet :: WWW/HTTP",
|
|
30
|
-
"Topic :: Software Development :: Testing",
|
|
31
|
-
]
|
|
32
|
-
|
|
33
|
-
[project.urls]
|
|
34
|
-
"Homepage" = "https://github.com/capiscio/capiscio-cli"
|
|
35
|
-
"Bug Reports" = "https://github.com/capiscio/capiscio-cli/issues"
|
|
36
|
-
"Source" = "https://github.com/capiscio/capiscio-cli"
|
|
37
|
-
|
|
38
|
-
[project.scripts]
|
|
39
|
-
capiscio = "capiscio.cli:main"
|
|
40
|
-
|
|
41
|
-
[tool.setuptools.packages.find]
|
|
42
|
-
where = ["."]
|
|
43
|
-
include = ["capiscio*"]
|
|
44
|
-
|
|
45
|
-
[tool.setuptools.package-data]
|
|
46
|
-
capiscio = ["binaries/*"]
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|