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

feat(client): add server client stack (HTTP, sync, WebSocket, remote projects) #676

Closed
freemo wants to merge 4 commits from feature/m7-post-server into master
pull from: feature/m7-post-server
merge into: cleveragents:master
Conversation 2 Commits 4 Files Changed 30
+5038 -2

4 Commits

Author SHA1 Message Date
freemo bd291fbc4a feat(client): add remote project support
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 16s
Details
CI / build (pull_request) Successful in 15s
Details
CI / quality (pull_request) Successful in 18s
Details
CI / security (pull_request) Successful in 34s
Details
CI / typecheck (pull_request) Successful in 38s
Details
CI / unit_tests (pull_request) Successful in 2m33s
Details
CI / docker (pull_request) Successful in 41s
Details
CI / integration_tests (pull_request) Successful in 3m20s
Details
CI / coverage (pull_request) Successful in 5m6s
Details
CI / benchmark-regression (pull_request) Successful in 32m41s
Details 
Implement RemoteProjectClient for accessing and executing projects
hosted on a remote CleverAgents server:
- Remote resource selection and server execution request wiring
- Project-name resolution for remote namespaces and server aliases
- Resolve project with fallback from custom to default namespace
- Remote project caching with configurable TTL (default 5 min)
- Explicit ResourceNotFoundError when remote project not found
- Cache invalidation per-namespace or global
- RemoteProject dataclass with project_id, name, namespace, alias, description

ISSUES CLOSED: #338
 2026-03-10 17:23:33 +00:00
freemo f18f35d48f feat(client): add websocket updates 
Implement WebSocketClient for receiving real-time plan update events
from a CleverAgents server via WebSocket connection:
- Plan update subscription with reconnect/exponential backoff
- Event schema for plan status, progress, and log stream updates
- Heartbeat/ping handling that resets reconnect counter
- Resume from last event ID on reconnect
- Event version negotiation
- Event de-duplication by event_id via LRU-bounded EventDeduplicator
- Ordered delivery guarantees with thread-safe callback dispatch
- Configurable reconnect backoff parameters (base, max, max_reconnects)
- ConnectionState model tracking lifecycle state
- websockets library added to pyproject.toml dependencies

ISSUES CLOSED: #337
 2026-03-10 17:23:33 +00:00
freemo 5650e67099 feat(client): add plan sync and remote execution 
Implement PlanSyncClient for synchronizing local resources with a remote
CleverAgents server and submitting plans for remote execution:
- Sync actions, skills, tools, projects with configurable scope flags
- Conflict resolution policies (local_wins / server_wins)
- Remote plan execution, apply, and status query endpoints
- Server-side ID persistence in local item metadata
- Sync summary output (created/updated/skipped/errors)
- Dry-run mode that skips server mutations
- SyncScope, SyncSummary, ExecutionResult data models

ISSUES CLOSED: #336
 2026-03-10 17:23:32 +00:00
freemo 1ed28f3b69 feat(client): add server http client 
Implement ServerHttpClient with httpx for server communication including:
- Health check endpoint (GET /health)
- Version negotiation (GET /version, POST /version/negotiate)
- Pagination helpers for list endpoints
- Per-request timeout and retry policy with exponential backoff
- Request/response logging with auth header redaction
- TLS verification toggle with warning when disabled
- Server error responses mapped to domain errors (AcpNotAvailableError, etc.)
- Client-specific exceptions (ServerConnectionError, ServerTimeoutError, ServerVersionMismatchError)
- Settings fields: server_base_url, server_api_token, server_tls_verify, server_request_timeout
- Factory function create_client_from_settings wired to Settings
- httpx added to pyproject.toml dependencies

ISSUES CLOSED: #335
 2026-03-10 17:23:32 +00:00