Agentic architecture in plain Java. No magic.

AraRuntime runtime = AraRuntime.builder().llmClient(llm).build();
runtime.start();

AraAgent agent = runtime.createAgent(AgentConfig.defaults()
        .agentId(AgentId.of("research-agent"))
        .agentType("research")
        .name("Research Agent")
        .build());

AraGateway gateway = AraGateway.builder(runtime)
        .port(8090)
        .expose(Surface.AGENTOS)          // Agno-compatible wire format
        .build();
gateway.start();
// -> http://localhost:8090/agentos

from agno.agent import RemoteAgent

remote = RemoteAgent(
    base_url="http://localhost:8090/agentos",
    agent_id="research-agent",
    protocol="agentos",
)

response = remote.run("Summarize the latest ARA release notes")
print(response.content)

class AgnoAgentTool implements AraTool {
    private final HttpClient http = HttpClient.newHttpClient();
    private final String agnoBaseUrl;   // e.g. an Agno AgentOS instance
    private final String agnoAgentId;

    @Override public String toolId()      { return "ask_agno_specialist"; }
    @Override public String description() { return "Delegates a question to a specialist hosted on Agno."; }
    @Override public String argumentSchema() {
        return """
               {"type":"object","properties":{"question":{"type":"string"}},"required":["question"]}
               """;
    }

    @Override
    public ToolResult execute(String argumentJson) {
        String question = JsonFieldExtractor.field(argumentJson, "question");
        String body = "message=" + URLEncoder.encode(question, UTF_8) + "&stream=false";
        HttpRequest req = HttpRequest.newBuilder(
                        URI.create(agnoBaseUrl + "/agents/" + agnoAgentId + "/runs"))
                .header("Content-Type", "application/x-www-form-urlencoded")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();
        HttpResponse resp = http.send(req, HttpResponse.BodyHandlers.ofString());
        return ToolResult.success(toolId(), resp.body());
    }
}

// Register it like any other tool — the ARA agent can now call Agno.
AgentConfig config = AgentConfig.defaults()
        .agentType("coordinator")
        .enabledTools(List.of("ask_agno_specialist"))
        .build();

curl -X POST http://localhost:8080/agents/research-agent/runs \
  -H "Authorization: Bearer $ARA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": "Summarize the latest ARA release notes"}'

curl -N -X POST "http://localhost:8080/agents/research-agent/runs?stream=true" \
  -H "Authorization: Bearer $ARA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": "Summarize the latest ARA release notes", "sessionId": "s-1"}'
# event: token       {"text":"ARA"}
# event: token       {"text":" is"}
# event: tool_call   {"toolId":"web_search"}
# event: final       {"content":"...", "tokensUsed":...}

curl -X POST http://localhost:8080/.well-known/a2a \
  -H "Authorization: Bearer $ARA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "message": {
        "parts": [{"kind": "text", "text": "Summarize the latest ARA release notes"}],
        "metadata": {"agentId": "research-agent"}
      }
    }
  }'