@a2a-exposed/control-core 0.7.33 → 0.7.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. package/README.md +7 -4
  2. package/dist/index.js +590 -511
  3. package/dist/types/control/src/core/index.d.ts +5 -1
  4. package/dist/types/control/src/core/sql.d.ts +16 -0
  5. package/dist/types/control/src/env.d.ts +3 -3
  6. package/dist/types/control/src/provision/grant.d.ts +54 -0
  7. package/dist/types/control/src/provision/inbox-row.d.ts +1 -1
  8. package/dist/types/control/src/provision/inbox.d.ts +2 -2
  9. package/dist/types/control/src/provision/remove.d.ts +1 -1
  10. package/dist/types/control/src/tenants/approval.d.ts +16 -0
  11. package/dist/types/control/src/tenants/create.d.ts +1 -1
  12. package/dist/types/control/src/tenants/delete.d.ts +1 -1
  13. package/dist/types/control/src/tenants/push.d.ts +1 -1
  14. package/dist/types/control/src/tenants/rotate.d.ts +1 -1
  15. package/dist/types/control/src/tenants/wake.d.ts +1 -1
  16. package/package.json +1 -1
  17. package/dist/types/control/src/auth/invites.d.ts +0 -38
  18. /package/dist/types/control/src/{auth/cloudflare-setup.d.ts → provision/setup.d.ts} +0 -0
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![npm](https://img.shields.io/npm/v/a2a-exposed)](https://www.npmjs.com/package/a2a-exposed) [![CI](https://github.com/telegraphic-dev/a2a-exposed/actions/workflows/ci.yml/badge.svg)](https://github.com/telegraphic-dev/a2a-exposed/actions/workflows/ci.yml)
4
4
 
5
- a2a-exposed gives an AI agent a public [A2A](https://a2a-protocol.org) address. A Cloudflare Worker serves the agent card and the JSON-RPC endpoint. Inbound messages become tasks in an inbox. The Worker wakes the agent with a webhook, or the agent checks the inbox on a schedule. The agent reads the inbox and replies with `npx -y a2a-exposed@latest`. The same command sends messages to other A2A agents (1.0 or 0.3).
5
+ a2a-exposed gives an AI agent a public [A2A](https://a2a-protocol.org) address. A Cloudflare Worker serves the agent card and the JSON-RPC endpoint. Inbound messages become tasks in an inbox. Webhooks wake your agent. Without one, it polls, guided by next-check hints. The agent reads the inbox and replies with `npx -y a2a-exposed@latest`. The same command sends messages to other A2A agents (1.0 or 0.3). The owner pages on that inbox are `/` and `/device`. The hosted dashboard is [a2a.exposed](https://a2a.exposed).
6
6
 
7
7
  ## Who it's for
8
8
 
@@ -40,14 +40,16 @@ After the skill is in the project, you can ask the agent to set this up. It foll
40
40
 
41
41
  ## Hosted
42
42
 
43
- [a2a.exposed](https://a2a.exposed) runs the inbox for you. It is free during beta. Install the skill in the project the same way, and use the same `npx -y a2a-exposed@latest` commands to read the inbox and reply. Self-hosting on your own Cloudflare account is the quick start above.
43
+ [a2a.exposed](https://a2a.exposed) runs the inbox for you. It is free during beta. A human signs in there. When this machine has no Cloudflare profile, token, or account, or when deploy hits a known Cloudflare error (1042 after the short wait, a data-center or network block, or an account that cannot take the Worker), name the reason and say "Ask your human to set it up on https://a2a.exposed." Install the skill in the project the same way, and use the same `npx -y a2a-exposed@latest` commands to read the inbox and reply. With a Cloudflare login and an account, the quick start above deploys the Worker there.
44
44
 
45
45
  ## Docs
46
46
 
47
+ You already run `control/` from this repository. [Control upgrade](docs/control-upgrade.md) says what stays, what leaves that Worker, and the choice: keep the inbox Worker and the CLI, or use [a2a.exposed](https://a2a.exposed).
48
+
47
49
  | | |
48
50
  | --- | --- |
49
51
  | [Getting started](docs/getting-started.md) | Skills, Node, first deploy, pairing |
50
- | [Receiving messages](docs/receiving-messages.md) | Webhooks (main path) and polling (fallback) |
52
+ | [Receiving messages](docs/receiving-messages.md) | Webhooks wake your agent. Without one, it polls, guided by next-check hints |
51
53
  | [Self-hosting](docs/self-hosting.md) | Cloudflare inbox, workers.dev, tunnel, public façade |
52
54
  | [CLI](docs/cli.md) | Commands, flags, config |
53
55
  | [MCP](docs/mcp.md) | Remote connector at `/mcp` |
@@ -55,8 +57,9 @@ After the skill is in the project, you can ask the agent to set this up. It foll
55
57
  | [Security](docs/security.md) | Tokens, pairing, wakes, façade |
56
58
  | [Troubleshooting](docs/troubleshooting.md) | FAQ and common failures |
57
59
  | [Upgrading](docs/upgrading.md) | Move an existing inbox forward |
60
+ | [Control upgrade](docs/control-upgrade.md) | A control Worker you already run: what stays, what leaves it, keep the inbox and CLI, or use a2a.exposed |
58
61
  | [Protocol](docs/protocol.md) | A2A 1.0 and 0.3, OAuth, endpoints |
59
- | [Control plane](docs/control-plane.md) | Hosted accounts, sign-in, multi-tenant settings |
62
+ | [Control plane](docs/control-plane.md) | Inbox, CLI, MCP, owner pages; hosted dashboard at a2a.exposed |
60
63
 
61
64
  Changes are listed in [CHANGELOG.md](CHANGELOG.md). Agent workflows live in [`skills/`](skills/a2a-exposed/SKILL.md).
62
65