HAL9000
195fbac109
CI / lint (pull_request) Successful in 40s
CI / helm (pull_request) Successful in 38s
CI / build (pull_request) Successful in 48s
CI / quality (pull_request) Successful in 1m0s
CI / typecheck (pull_request) Successful in 1m29s
CI / security (pull_request) Successful in 1m28s
CI / push-validation (pull_request) Successful in 20s
CI / unit_tests (pull_request) Successful in 5m8s
CI / docker (pull_request) Successful in 1m27s
CI / integration_tests (pull_request) Successful in 8m39s
CI / coverage (pull_request) Successful in 11m1s
CI / status-check (pull_request) Successful in 3s
Add domain-scenario Gherkin tags to all A2A, session, and CLI feature files (30 files) so tests can be filtered individually via behave. - 8 A2A feature files: @a2a tag - 7 session feature files: @session tag - 15 CLI feature files: @cli tag ISSUES CLOSED: #9124
217 lines
11 KiB
Gherkin
217 lines
11 KiB
Gherkin
@a2a
|
|
Feature: A2A JSON-RPC 2.0 wire format compliance
|
|
As a developer maintaining the A2A protocol layer
|
|
I want A2aRequest and A2aResponse to use JSON-RPC 2.0 field names
|
|
So that external A2A-compliant clients can communicate with the server
|
|
|
|
# -------------------------------------------------------------------
|
|
# A2aRequest serialisation — JSON-RPC 2.0 field names
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: A2aRequest serialises with jsonrpc field set to "2.0"
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should contain key "jsonrpc" with value "2.0"
|
|
|
|
Scenario: A2aRequest serialises with id field
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should contain key "id"
|
|
|
|
Scenario: A2aRequest serialises with method field
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should contain key "method" with value "_cleveragents/plan/status"
|
|
|
|
Scenario: A2aRequest serialises with params field
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should contain key "params"
|
|
|
|
Scenario: A2aRequest does not contain non-standard field a2a_version
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should not contain key "a2a_version"
|
|
|
|
Scenario: A2aRequest does not contain non-standard field request_id
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should not contain key "request_id"
|
|
|
|
Scenario: A2aRequest does not contain non-standard field operation
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should not contain key "operation"
|
|
|
|
Scenario: A2aRequest does not contain non-standard field auth
|
|
Given a valid A2aRequest with method "_cleveragents/plan/status" and params {"plan_id": "P1"}
|
|
When I serialise the request to a dict
|
|
Then the serialised dict should not contain key "auth"
|
|
|
|
Scenario: A2aRequest auto-generates id when not provided
|
|
Given a valid A2aRequest with method "session.create" and params {}
|
|
Then the request id should be non-empty
|
|
|
|
Scenario: A2aRequest accepts explicit id
|
|
Given an A2aRequest with method "session.create" and id "my-custom-id"
|
|
Then the request id should equal "my-custom-id"
|
|
|
|
Scenario: A2aRequest rejects empty method
|
|
When I try to create an A2aRequest with empty method
|
|
Then a wire format ValidationError should be raised
|
|
|
|
Scenario: A2aRequest rejects non-2.0 jsonrpc version
|
|
When I try to create an A2aRequest with jsonrpc "1.0"
|
|
Then a wire format ValidationError should be raised
|
|
|
|
# -------------------------------------------------------------------
|
|
# A2aResponse serialisation — JSON-RPC 2.0 field names (success)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: A2aResponse success serialises with jsonrpc field set to "2.0"
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should contain key "jsonrpc" with value "2.0"
|
|
|
|
Scenario: A2aResponse success serialises with id field
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should contain key "id" with value "REQ-001"
|
|
|
|
Scenario: A2aResponse success serialises with result field
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should contain key "result"
|
|
|
|
Scenario: A2aResponse success does not contain non-standard field a2a_version
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should not contain key "a2a_version"
|
|
|
|
Scenario: A2aResponse success does not contain non-standard field request_id
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should not contain key "request_id"
|
|
|
|
Scenario: A2aResponse success does not contain non-standard field status
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should not contain key "status"
|
|
|
|
Scenario: A2aResponse success does not contain non-standard field data
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should not contain key "data"
|
|
|
|
Scenario: A2aResponse success does not contain non-standard field timing_ms
|
|
Given a successful A2aResponse with id "REQ-001" and result {"status": "ok"}
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should not contain key "timing_ms"
|
|
|
|
# -------------------------------------------------------------------
|
|
# A2aResponse serialisation — JSON-RPC 2.0 field names (error)
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: A2aResponse error serialises with error field
|
|
Given an error A2aResponse with id "REQ-002" and error code "NOT_FOUND"
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should contain key "error"
|
|
|
|
Scenario: A2aResponse error does not contain result field
|
|
Given an error A2aResponse with id "REQ-002" and error code "NOT_FOUND"
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should not contain key "result"
|
|
|
|
Scenario: A2aResponse error does not contain non-standard field status
|
|
Given an error A2aResponse with id "REQ-002" and error code "NOT_FOUND"
|
|
When I serialise the response to a dict
|
|
Then the serialised dict should not contain key "status"
|
|
|
|
# -------------------------------------------------------------------
|
|
# A2aResponse validation — mutual exclusion of result and error
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: A2aResponse requires either result or error
|
|
When I try to create an A2aResponse with neither result nor error
|
|
Then a wire format ValidationError should be raised
|
|
|
|
Scenario: A2aResponse rejects both result and error set simultaneously
|
|
When I try to create an A2aResponse with both result and error
|
|
Then a wire format ValidationError should be raised
|
|
|
|
# -------------------------------------------------------------------
|
|
# Deserialisation — inbound JSON-RPC 2.0 payloads
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: A2aRequest deserialises from JSON-RPC 2.0 compliant dict
|
|
Given a JSON-RPC 2.0 request dict with method "message/send" and id "42"
|
|
When I deserialise the dict into an A2aRequest
|
|
Then the request method should equal "message/send"
|
|
And the request id should equal "42"
|
|
And the request jsonrpc should equal "2.0"
|
|
|
|
Scenario: A2aResponse deserialises from JSON-RPC 2.0 success dict
|
|
Given a JSON-RPC 2.0 success response dict with id "42" and result {"plan_id": "P1"}
|
|
When I deserialise the dict into an A2aResponse
|
|
Then the response result should contain key "plan_id"
|
|
And the response error should be None
|
|
|
|
Scenario: A2aResponse deserialises from JSON-RPC 2.0 error dict
|
|
Given a JSON-RPC 2.0 error response dict with id "42" and error code "NOT_FOUND"
|
|
When I deserialise the dict into an A2aResponse
|
|
Then the response error should not be None
|
|
And the response result should be None
|
|
|
|
# -------------------------------------------------------------------
|
|
# Facade dispatch — produces JSON-RPC 2.0 compliant responses
|
|
# -------------------------------------------------------------------
|
|
|
|
Scenario: Facade dispatch produces response with jsonrpc "2.0"
|
|
Given a wire-format facade with no services
|
|
When I dispatch wire-format method "_cleveragents/health/check" with params {}
|
|
Then the wire-format response jsonrpc should equal "2.0"
|
|
|
|
Scenario: Facade dispatch success produces response with result field
|
|
Given a wire-format facade with no services
|
|
When I dispatch wire-format method "_cleveragents/health/check" with params {}
|
|
Then the wire-format response result should not be None
|
|
|
|
Scenario: Facade dispatch success produces response without error field
|
|
Given a wire-format facade with no services
|
|
When I dispatch wire-format method "_cleveragents/health/check" with params {}
|
|
Then the wire-format response error should be None
|
|
|
|
Scenario: Facade dispatch error produces response with error field
|
|
Given a wire-format facade with no services
|
|
When I dispatch wire-format method "unknown/method" with params {}
|
|
Then the wire-format response error should not be None
|
|
|
|
Scenario: Facade dispatch preserves request id in response
|
|
Given a wire-format facade with no services
|
|
When I dispatch wire-format method "_cleveragents/health/check" with id "test-id-123" and params {}
|
|
Then the wire-format response id should equal "test-id-123"
|
|
|
|
# -------------------------------------------------------------------
|
|
# A2aErrorDetail — JSON-RPC 2.0 field name compliance (issue #2745)
|
|
# -------------------------------------------------------------------
|
|
|
|
@tdd_issue @tdd_issue_4229 @tdd_expected_fail
|
|
Scenario: A2aErrorDetail serialises with data field not details
|
|
Given an A2aErrorDetail with code "NOT_FOUND" and message "gone" and data {"id": "x"}
|
|
When I serialise the error detail to a dict
|
|
Then the error detail dict should contain key "data"
|
|
And the error detail dict should not contain key "details"
|
|
|
|
@tdd_issue @tdd_issue_4229 @tdd_expected_fail
|
|
Scenario: A2aErrorDetail serialises with empty data by default
|
|
Given an A2aErrorDetail with code "ERR" and message "error" and no data
|
|
When I serialise the error detail to a dict
|
|
Then the error detail dict should contain key "data"
|
|
And the error detail dict should not contain key "details"
|
|
|
|
@tdd_issue @tdd_issue_4229 @tdd_expected_fail
|
|
Scenario: A2aErrorDetail data field preserves payload values
|
|
Given an A2aErrorDetail with code "NOT_FOUND" and message "gone" and data {"plan_id": "abc123"}
|
|
When I serialise the error detail to a dict
|
|
Then the error detail data should contain key "plan_id"
|