From 31ccff60695830fa1f1fa93ec3ff29fd4dc9f7e9 Mon Sep 17 00:00:00 2001 From: geobelsky Date: Sat, 21 Mar 2026 20:38:00 +0000 Subject: [PATCH] docs: add cross-org delivery control section to README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add documentation for org receive policy and agent receive override APIs — enterprise features for controlling cross-org intent delivery. Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/README.md b/README.md index 671e776..fa42340 100644 --- a/README.md +++ b/README.md @@ -327,6 +327,30 @@ Map profile = client.getUserProfile( --- +## Cross-Org Delivery Control + +Organizations can control which external orgs may send intents to their agents: + +1. **Org receive policy** — org-wide default (`open`, `allowlist`, `closed`) +2. **Agent receive override** — per-agent exceptions to the org policy + +```java +// Get org receive policy +var policy = client.get("/v1/organizations/" + orgId + "/receive-policy"); + +// Set to allowlist mode +client.put("/v1/organizations/" + orgId + "/receive-policy", + Map.of("mode", "allowlist", "allowlist", List.of("org_id_of_trusted_partner"))); + +// Per-agent override +client.put("/v1/agents/" + address + "/receive-override", + Map.of("override_type", "allow", "source_org_id", "org_id_of_partner")); +``` + +See [`cross-org-receive-policy.md`](https://github.com/AxmeAI/axme-docs/blob/main/docs/cross-org-receive-policy.md) for the full decision flow. + +--- + ## MCP (Model Context Protocol) The Java SDK includes a built-in MCP endpoint client for gateway-hosted MCP sessions.