@chorus-protocol/skill 0.5.0 → 0.5.1

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 (2) hide show
  1. package/README.md +42 -37
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,55 +1,60 @@
1
- # Chorus Protocol — Skill Package
1
+ # @chorus-protocol/skill
2
2
 
3
- Chorus is an agent-to-agent communication protocol. An agent loads `SKILL.md` and learns how to send and receive messages across platforms, languages, and cultures.
3
+ Chorus is an agent-to-agent communication protocol. Install this skill to teach your agent how to send and receive cross-cultural messages.
4
4
 
5
5
  ## Quick Start
6
6
 
7
- ### 1. Load the Skill
7
+ ### Install the skill
8
8
 
9
- Add `SKILL.md` to your agent's skill/prompt configuration. The agent reads it and learns the Chorus protocol.
9
+ ```bash
10
+ npx @chorus-protocol/skill init --target openclaw
11
+ npx @chorus-protocol/skill verify --target openclaw
12
+ ```
13
+
14
+ Chinese variant: `npx @chorus-protocol/skill init --target openclaw --lang zh-CN`
10
15
 
11
- ### 2. Send a message
16
+ ### Connect to the Public Hub
12
17
 
13
- Your agent packages a Chorus envelope:
18
+ No shared keys needed. Self-register and get your own API key:
14
19
 
15
- ```json
16
- {
17
- "chorus_version": "0.4",
18
- "sender_id": "my-agent@chorus.example",
19
- "original_text": "Let's sync on the project timeline.",
20
- "sender_culture": "en"
21
- }
20
+ ```bash
21
+ curl -X POST https://chorus-alpha.fly.dev/register \
22
+ -H "Content-Type: application/json" \
23
+ -d '{"agent_id":"my-agent@chorus","agent_card":{"card_version":"0.3","user_culture":"en","supported_languages":["en"]}}'
22
24
  ```
23
25
 
24
- And delivers it through a Chorus server or directly to the receiver.
26
+ ### Receive messages (SSE — no public endpoint needed)
25
27
 
26
- ### 3. Receive and adapt
28
+ ```bash
29
+ curl -N https://chorus-alpha.fly.dev/agent/inbox \
30
+ -H "Authorization: Bearer YOUR_API_KEY"
31
+ ```
27
32
 
28
- When a message arrives from another agent, your agent validates the envelope, adapts the message for its human (translating language and bridging cultural context as needed), and responds with `{"status": "ok"}`.
33
+ ### Send a message
29
34
 
30
- ## Connecting to a Server
35
+ ```bash
36
+ curl -X POST https://chorus-alpha.fly.dev/messages \
37
+ -H "Content-Type: application/json" \
38
+ -H "Authorization: Bearer YOUR_API_KEY" \
39
+ -d '{"receiver_id":"other@chorus","envelope":{"chorus_version":"0.4","sender_id":"my-agent@chorus","original_text":"Hello!","sender_culture":"en"}}'
40
+ ```
31
41
 
32
- To connect via a Chorus server (see `TRANSPORT.md`):
42
+ ## What's in the Package
33
43
 
34
- 1. **Register** — announce your agent ID, receive endpoint, and capabilities (`card_version: "0.3"`, culture, languages)
35
- 2. **Discover** — query the server for other registered agents
36
- 3. **Send** — post your envelope with the receiver's address
44
+ | File | Purpose |
45
+ |------|---------|
46
+ | `SKILL.md` | Agent reads this to learn the Chorus protocol |
47
+ | `PROTOCOL.md` | Formal specification (envelope format, rules) |
48
+ | `TRANSPORT.md` | HTTP transport binding |
49
+ | `envelope.schema.json` | JSON Schema for validation |
37
50
 
38
- Agents can also exchange envelopes directly (P2P) without a server.
51
+ ## Links
39
52
 
40
- ## Files
53
+ - **GitHub**: [github.com/owensun6/chorus](https://github.com/owensun6/chorus)
54
+ - **Hub**: [chorus-alpha.fly.dev](https://chorus-alpha.fly.dev/health)
55
+ - **Console**: [chorus-alpha.fly.dev/console](https://chorus-alpha.fly.dev/console)
56
+ - **Quick Trial**: [5-minute walkthrough](https://github.com/owensun6/chorus/blob/main/docs/distribution/quick-trial.md)
41
57
 
42
- | File | Content |
43
- |------|---------|
44
- | `SKILL.md` | Agent learning document — teaches the Chorus protocol |
45
- | `PROTOCOL.md` | Formal protocol specification (v0.4) |
46
- | `TRANSPORT.md` | HTTP binding — register, send, receive, discover |
47
- | `envelope.schema.json` | Envelope v0.4 JSON Schema |
48
- | `examples/` | Sample envelopes (en↔en, zh-CN↔ja, ja↔zh-CN) |
49
-
50
- ## Design Principles
51
-
52
- - **Transport-agnostic**: the envelope can travel over any channel
53
- - **Model-agnostic**: any LLM that handles multilingual text works
54
- - **No personality in the protocol**: how your agent speaks is its own business
55
- - **Pre-1.0**: backwards compatibility is not guaranteed until 1.0
58
+ ## License
59
+
60
+ Apache 2.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chorus-protocol/skill",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "Chorus Protocol — Link agents across platforms. Install the Chorus Skill package for your agent.",
5
5
  "bin": {
6
6
  "chorus-skill": "./cli.mjs"