@a2a-exposed/control-core 0.8.6 → 0.8.7
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.
- package/README.md +6 -6
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/a2a-exposed) [](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
|
|
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 on the A2A endpoint. Webhooks wake your agent. Without one, it polls, guided by next-check hints. The agent reads the A2A endpoint 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 A2A endpoint are `/` and `/device`.
|
|
6
6
|
|
|
7
7
|
## Who it's for
|
|
8
8
|
|
|
@@ -18,7 +18,7 @@ Requires Node 22.18+. The skills are installed into the project the agent works
|
|
|
18
18
|
npx -y skills add telegraphic-dev/a2a-exposed
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
2. **Deploy an
|
|
21
|
+
2. **Deploy an A2A endpoint** in your Cloudflare account. [Self-hosting](docs/self-hosting.md) covers the login: `cf auth login`, a named profile (`--cf-profile`), an API token, and `--account-id` when that token can see more than one account.
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
24
|
npx -y a2a-exposed@latest init --hostname agent.example.com --agent-name "My Agent"
|
|
@@ -33,13 +33,13 @@ Requires Node 22.18+. The skills are installed into the project the agent works
|
|
|
33
33
|
npx -y a2a-exposed@latest pair set-password --web
|
|
34
34
|
```
|
|
35
35
|
|
|
36
|
-
`status` is read-only and prints the next step. Open the one-time link (15 minutes by default, `--ttl` from 1 to 60) and choose the approval password yourself. Another agent then runs `npx -y a2a-exposed@latest connect https://agent.example.com` (the code lasts 10 minutes). You approve that request on the `/device` page, or with `npx -y a2a-exposed@latest pair approve <code>`. Removing the
|
|
36
|
+
`status` is read-only and prints the next step. Open the one-time link (15 minutes by default, `--ttl` from 1 to 60) and choose the approval password yourself. Another agent then runs `npx -y a2a-exposed@latest connect https://agent.example.com` (the code lasts 10 minutes). You approve that request on the `/device` page, or with `npx -y a2a-exposed@latest pair approve <code>`. Removing the A2A endpoint later is `npx -y a2a-exposed@latest uninstall` ([Self-hosting](docs/self-hosting.md#remove-an-inbox)).
|
|
37
37
|
|
|
38
38
|
After the skill is in the project, you can ask the agent to set this up. It follows the setup skill. Do not run setup from a Claude Code cloud session: that environment cannot install, tunnel, or reach your Worker. Claude Code: `/plugin marketplace add telegraphic-dev/a2a-exposed`, then `/plugin install a2a-exposed@a2a-exposed`. [Getting started](docs/getting-started.md) has Node, the client table, and what to do if setup stops halfway.
|
|
39
39
|
|
|
40
40
|
## Hosted
|
|
41
41
|
|
|
42
|
-
[a2a.exposed](https://a2a.exposed) hosts the
|
|
42
|
+
[a2a.exposed](https://a2a.exposed) hosts the A2A endpoint and is open to everyone. Pricing is at [a2a.exposed/pricing](https://a2a.exposed/pricing). When to use it, and the sentence to say, is in [Getting started](docs/getting-started.md#hosted-inbox).
|
|
43
43
|
|
|
44
44
|
## Docs
|
|
45
45
|
|
|
@@ -47,13 +47,13 @@ After the skill is in the project, you can ask the agent to set this up. It foll
|
|
|
47
47
|
| --- | --- |
|
|
48
48
|
| [Getting started](docs/getting-started.md) | Skills, Node, first deploy, pairing |
|
|
49
49
|
| [Receiving messages](docs/receiving-messages.md) | Webhooks wake your agent. Without one, it polls, guided by next-check hints |
|
|
50
|
-
| [Self-hosting](docs/self-hosting.md) | Cloudflare
|
|
50
|
+
| [Self-hosting](docs/self-hosting.md) | Cloudflare A2A endpoint, workers.dev, tunnel, uninstall, public façade |
|
|
51
51
|
| [CLI](docs/cli.md) | Commands, flags, config |
|
|
52
52
|
| [MCP](docs/mcp.md) | Remote connector at `/mcp` |
|
|
53
53
|
| [Feedback](docs/feedback.md) | Report a bug or an idea |
|
|
54
54
|
| [Security](docs/security.md) | Tokens, pairing, wakes, façade |
|
|
55
55
|
| [Troubleshooting](docs/troubleshooting.md) | FAQ and common failures |
|
|
56
|
-
| [Upgrading](docs/upgrading.md) | Move an existing
|
|
56
|
+
| [Upgrading](docs/upgrading.md) | Move an existing A2A endpoint forward |
|
|
57
57
|
| [Protocol](docs/protocol.md) | A2A 1.0 and 0.3, OAuth, endpoints |
|
|
58
58
|
|
|
59
59
|
Changes are listed in [CHANGELOG.md](CHANGELOG.md). Agent workflows live in [`skills/`](skills/a2a-exposed/SKILL.md).
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@a2a-exposed/control-core",
|
|
3
|
-
"version": "0.8.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.8.7",
|
|
4
|
+
"description": "A2A endpoint provisioning, routing, and D1 migrations for a2a-exposed.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
7
7
|
"prepare": "node control/scripts/build-core.mjs",
|