From a8bdcc615d2d8ab3cf347594a63194854c628800 Mon Sep 17 00:00:00 2001 From: geobelsky Date: Sat, 21 Mar 2026 20:37:54 +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 | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/README.md b/README.md index 3a1a8b3..f47efa4 100644 --- a/README.md +++ b/README.md @@ -248,6 +248,34 @@ await client.updateIntentControls(intentId, { --- +## 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 + +```typescript +// Get org receive policy +const policy = await client.get(`/v1/organizations/${orgId}/receive-policy`); + +// Set to allowlist mode +await client.put(`/v1/organizations/${orgId}/receive-policy`, { + mode: "allowlist", + allowlist: ["org_id_of_trusted_partner"], +}); + +// Per-agent override +await client.put(`/v1/agents/${address}/receive-override`, { + 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. + +--- + ## Repository Structure ```