axme-sdk-java

Java SDK for AXME - send intents, poll for deliveries, resume workflows. Java 11+, clean exception hierarchy, no third-party HTTP dependencies.

Quick Start · Docs · Examples

---

Install

<dependency>
    <groupId>ai.axme</groupId>
    <artifactId>axme</artifactId>
    <version>0.1.2</version>
</dependency>

Maven Central publication is in progress. Build locally until then:

git clone https://github.com/AxmeAI/axme-sdk-java.git
cd axme-sdk-java && mvn -q -DskipTests install

---

Quick Start

import dev.axme.sdk.AxmeClient;
import dev.axme.sdk.AxmeClientConfig;
import dev.axme.sdk.RequestOptions;
import java.util.Map;

AxmeClient client = new AxmeClient(
    AxmeClientConfig.forCloud("axme_sa_...", null)
);

// Send an intent - survives crashes, retries, timeouts
Map<String, Object> intent = client.createIntent(
    Map.of(
        "intent_type", "order.fulfillment.v1",
        "to_agent",    "agent://myorg/production/fulfillment-service",
        "payload",     Map.of("order_id", "ord_123")
    ),
    new RequestOptions("fulfill-ord-123-001", null)
);
System.out.println(intent.get("intent_id") + " " + intent.get("status"));

---

Human Approvals

var result = client.createIntent(Map.of(
    "intent_type", "intent.budget.approval.v1",
    "to_agent",    "agent://myorg/prod/agent_core",
    "payload",     Map.of("amount", 32000),
    "human_task",  Map.of(
        "task_type",        "approval",
        "notify_email",     "approver@example.com",
        "allowed_outcomes", List.of("approved", "rejected")
    )
), new RequestOptions(null, null));

8 task types: approval, confirmation, review, assignment, form, clarification, manual_action, override. Full reference: axme-docs.

---

Observe Lifecycle Events

Map<String, Object> events = client.listIntentEvents(intentId, null, RequestOptions.none());

---

Examples

See examples/BasicSubmit.java. More: axme-examples

---

Development

mvn test

---

Related

axme-docs	API reference and integration guides
axme-examples	Runnable examples
axp-spec	Protocol specification
axme-cli	CLI tool
axme-conformance	Conformance suite

---

hello@axme.ai · Security · License