cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

feat(server): integrate LangGraph Platform with RemoteGraph for server execution #722

Closed
freemo wants to merge 4 commits from feature/m9-langgraph-platform into master
pull from: feature/m9-langgraph-platform
merge into: cleveragents:master
Conversation 6 Commits 4 Files Changed 70
+6387 -854

4 Commits

Author SHA1 Message Date
freemo e13308b322 feat(server): integrate LangGraph Platform with RemoteGraph for server execution
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 14s
Details
CI / quality (pull_request) Successful in 18s
Details
CI / build (pull_request) Successful in 18s
Details
CI / security (pull_request) Successful in 35s
Details
CI / typecheck (pull_request) Successful in 38s
Details
CI / unit_tests (pull_request) Successful in 4m48s
Details
CI / integration_tests (pull_request) Successful in 5m28s
Details
CI / docker (pull_request) Successful in 54s
Details
CI / coverage (pull_request) Successful in 5m35s
Details
CI / benchmark-regression (pull_request) Successful in 35m5s
Details 
Implement the server application module (ADR-048) with:

- FastAPI application factory (app.py) exposing the A2A JSON-RPC 2.0
  endpoint as the sole client-facing interface. Routes: POST /a2a
  (JSON-RPC dispatch), GET /.well-known/agent.json (Agent Card), and
  GET /health (container orchestration).

- RemoteGraph adapter (remote_graph.py) for invoking actor graphs
  via LangGraph Platform. Each actor graph deploys as a separate
  RemoteGraph enabling independent scaling. Includes health tracking,
  invocation counting, and a RemoteGraphRegistry for managing
  multiple graph deployments.

- Database configuration (database.py) supporting PostgreSQL for
  production and SQLite for development. Config-driven via
  CLEVERAGENTS_DATABASE_URL and CLEVERAGENTS_SERVER_ENV environment
  variables with validated Pydantic settings model.

- Docker deployment (docker/Dockerfile + docker-compose.yml) with
  multi-stage build, non-root user, health checks, and PostgreSQL
  service.

- FastAPI dependency added to pyproject.toml.

- 26 Behave BDD scenarios covering app factory, A2A dispatch, Agent
  Card, health endpoint, RemoteGraph config/adapter/registry, and
  database configuration.

- 10 Robot Framework integration tests with helper script verifying
  end-to-end server functionality.

ISSUES CLOSED: #693
 2026-03-12 03:05:00 +00:00
freemo 680cc8c352 feat(a2a): implement A2A stdio transport for local mode
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 15s
Details
CI / build (pull_request) Successful in 19s
Details
CI / quality (pull_request) Successful in 19s
Details
CI / security (pull_request) Successful in 36s
Details
CI / typecheck (pull_request) Successful in 38s
Details
CI / unit_tests (pull_request) Successful in 3m0s
Details
CI / integration_tests (pull_request) Successful in 3m27s
Details
CI / docker (pull_request) Successful in 41s
Details
CI / coverage (pull_request) Successful in 5m31s
Details
CI / benchmark-regression (pull_request) Successful in 35m39s
Details 
Add A2aStdioTransport class that manages subprocess lifecycle and
communicates via newline-delimited JSON-RPC 2.0 messages over
stdin/stdout. Add A2aTransport protocol (typing.Protocol) defining
the abstract transport interface. Add A2aTransportSelector that
picks A2aStdioTransport in local mode (no server URL) or
A2aHttpTransport in server mode.

New files:
- transport_protocol.py: A2aTransport Protocol
- stdio_transport.py: A2aStdioTransport with subprocess management
- transport_selector.py: A2aTransportSelector configuration-based
- echo_agent.py: Minimal echo agent fixture for tests

Tests:
- 20 Behave BDD scenarios covering protocol conformance, construction,
  subprocess lifecycle, send/receive, context manager, transport
  selector, and contract round-trip tests
- 7 Robot Framework integration tests with helper script

ISSUES CLOSED: #691
 2026-03-12 01:52:41 +00:00
freemo 33900eab03 feat(a2a): implement JSON-RPC 2.0 wire format and method routing
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 14s
Details
CI / build (pull_request) Successful in 16s
Details
CI / quality (pull_request) Successful in 18s
Details
CI / security (pull_request) Successful in 35s
Details
CI / typecheck (pull_request) Successful in 55s
Details
CI / unit_tests (pull_request) Successful in 2m57s
Details
CI / integration_tests (pull_request) Successful in 3m23s
Details
CI / docker (pull_request) Successful in 41s
Details
CI / coverage (pull_request) Successful in 5m36s
Details
CI / benchmark-regression (pull_request) Successful in 35m11s
Details 
Implement the JSON-RPC 2.0 wire format layer and method routing for the
A2A protocol, building on the ACP-to-A2A rename from #688.

New modules in src/cleveragents/a2a/:
- jsonrpc_models.py: Pydantic v2 models for JSON-RPC 2.0 request,
  response, error, and notification envelopes
- jsonrpc_router.py: Method router that dispatches JSON-RPC requests
  to registered handlers, with support for standard A2A methods and
  _cleveragents/ extension methods
- jsonrpc_handlers.py: Handlers for standard A2A methods (message/send,
  message/stream, tasks/get, tasks/cancel) and extension method factory
  that delegates to A2aLocalFacade
- jsonrpc_errors.py: Maps domain error taxonomy to JSON-RPC 2.0 error
  codes (standard -32700 to -32603, application -32001 to -32008)
- agent_card.py: Agent Card model and generation for the
  /.well-known/agent.json capability advertisement endpoint

Standard A2A methods:
- message/send: Create/update tasks via messages
- message/stream: Streaming variant with SSE event indicators
- tasks/get: Retrieve task by ID
- tasks/cancel: Cancel running tasks

CleverAgents extension methods (_cleveragents/ prefix):
- plan/use, execute, status, diff, apply, cancel
- registry/list_tools, list_resources
- context/show
- sync/status
- namespace/list
- health

Tests:
- Behave BDD: features/a2a_jsonrpc.feature (28 scenarios)
- Robot Framework: robot/a2a_jsonrpc.robot (9 integration tests)

ISSUES CLOSED: #690
 2026-03-12 01:00:37 +00:00
freemo 2fe95d1b38 refactor(a2a): rename ACP module and symbols to A2A standard
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 20s
Details
CI / build (pull_request) Successful in 16s
Details
CI / quality (pull_request) Successful in 35s
Details
CI / security (pull_request) Successful in 47s
Details
CI / typecheck (pull_request) Successful in 1m37s
Details
CI / integration_tests (pull_request) Successful in 3m38s
Details
CI / unit_tests (pull_request) Successful in 4m44s
Details
CI / docker (pull_request) Successful in 1m6s
Details
CI / coverage (pull_request) Successful in 5m30s
Details
CI / benchmark-regression (pull_request) Successful in 35m37s
Details 
Renamed src/cleveragents/acp/ to src/cleveragents/a2a/ and all 13
Acp* classes to A2a* per ADR-047 (A2A Standard Adoption). Updated
all imports, structlog event names (acp.* → a2a.*), field names
(acp_version → a2a_version), and test references across the entire
codebase. This is a cosmetic rename only — no behavioral changes.

ISSUES CLOSED: #688
 2026-03-11 22:10:25 +00:00