Skip to content

apcore-a2a Feature Specs Overview

This directory contains implementation-level feature specifications for apcore-a2a — the automatic A2A protocol adapter for the apcore module registry.

Feature Map

Feature Priority Depends On Description
adapters P0 None (foundation) Pure-logic converters: AgentCardBuilder, SkillMapper, MessageAdapter, ResultMapper, ErrorMapper
storage P0 None Pluggable task persistence — TaskStore protocol + InMemoryTaskStore
server-core P0 adapters, storage Core server: A2AServerFactory, ExecutionRouter, TaskManager, TransportManager
streaming P0 server-core SSE streaming for message/stream and tasks/resubscribe
push-notifications P1 storage, server-core Webhook-based async delivery of task state changes
auth P1 None (standalone) JWT/Bearer authentication middleware
client P0 None (standalone) HTTP client: A2AClient + AgentCardFetcher
public-api P0 All above Top-level entry: serve(), async_serve(), re-exports
cli P1 public-api CLI entry point for launching A2A servers
explorer P2 server-core Browser-based interactive UI for testing agents
ops P2 server-core Health, metrics, and dynamic module registration

Dependency Graph

adapters ─┐
           ├─→ server-core ─┬─→ streaming ──────┐
storage ──┘                 ├─→ push-notifications│
                            ├─→ explorer          ├─→ public-api ─→ cli
                            ├─→ ops               │
auth ───────────────────────┘                     │
client ───────────────────────────────────────────┘
  • Getting Started — Installation & usage guide (Python & TypeScript)
  • PRD — Product Requirements Document
  • SRS — Software Requirements Specification
  • Tech Design — Technical Design Document
  • Test Plan — Test Plan