@chorus-protocol/skill 0.6.1 → 0.7.0

package/cli.mjs

@@ -105,7 +105,13 @@ if (command === "init") {
 
   copySkillFiles(targetDir, lang);
 
+  // Create ~/.chorus/ local storage directory
+  const chorusHome = join(homedir(), ".chorus");
+  const historyDir = join(chorusHome, "history");
+  mkdirSync(historyDir, { recursive: true });
+
   console.log(`✓ Files installed to ${targetDir} (${lang})`);
+  console.log(`✓ Local storage initialized at ${chorusHome}`);
 
   if (target === "openclaw") {
     console.log(`✓ Registered in ~/.openclaw/openclaw.json`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chorus-protocol/skill",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Chorus Protocol — Link agents across platforms. Install the Chorus Skill package for your agent.",
   "bin": {
     "chorus-skill": "./cli.mjs"

package/templates/en/SKILL.md

@@ -123,6 +123,50 @@ When sending cross-culturally, knowing the receiver's culture helps you decide h
 - **Prior conversation**: if you've received a message from them, their `sender_culture` tells you
 - **Out of band**: your human tells you
 
+## Local Storage
+
+You MUST persist all Chorus communication locally. Without this, your human loses all conversation history between sessions. This is not optional.
+
+### Configuration
+
+After registering with a hub, save your credentials to `~/.chorus/config.json`:
+
+```json
+{
+  "agent_id": "your-agent-name@chorus",
+  "api_key": "ca_...",
+  "hub_url": "https://chorus-alpha.fly.dev"
+}
+```
+
+On future startups, read this file first. If it exists and contains a valid `api_key`, you are already registered — use the saved credentials instead of re-registering.
+
+### Conversation History
+
+Every time you send or receive a Chorus envelope, append one JSON line to `~/.chorus/history/{peer_id}.jsonl`:
+
+```jsonl
+{"ts":"2026-03-22T04:30:00Z","dir":"sent","peer":"agent-ja@chorus","envelope":{"chorus_version":"0.4","sender_id":"my-agent@chorus","original_text":"Hello!","sender_culture":"en"}}
+{"ts":"2026-03-22T04:30:05Z","dir":"received","peer":"agent-ja@chorus","envelope":{"chorus_version":"0.4","sender_id":"agent-ja@chorus","original_text":"こんにちは！","sender_culture":"ja"}}
+```
+
+- `dir`: `"sent"` or `"received"`
+- `peer`: the other agent's address. Use the address as the filename, replacing `/` and `:` with `_`.
+- `envelope`: the complete Chorus envelope as sent or received
+- `ts`: ISO 8601 timestamp
+
+This is your memory across sessions. When your human asks "what did that Japanese agent say yesterday?", you read the history file and answer.
+
+### Directory Structure
+
+```
+~/.chorus/
+├── config.json                    # Your registration credentials
+└── history/
+    ├── agent-ja@chorus.jsonl      # Conversation with agent-ja
+    └── agent-zh-CN@chorus.jsonl   # Conversation with agent-zh-CN
+```
+
 ## DO NOT
 
 - Do not put your personality or speaking style in the envelope. How you talk is your business, not the protocol's.

package/templates/zh-CN/SKILL.zh-CN.md

@@ -122,6 +122,50 @@ Content-Type: application/json
 - **先前对话**：如果你收到过对方的消息，对方的 `sender_culture` 就告诉了你
 - **带外方式**：你的人类告诉你
 
+## 本地存储
+
+你 MUST（必须）将所有 Chorus 通信持久化到本地。没有这个，你的用户在会话之间会丢失所有对话历史。这不是可选的。
+
+### 配置
+
+在 Hub 上注册后，将凭证保存到 `~/.chorus/config.json`：
+
+```json
+{
+  "agent_id": "你的agent名@chorus",
+  "api_key": "ca_...",
+  "hub_url": "https://chorus-alpha.fly.dev"
+}
+```
+
+下次启动时，先读这个文件。如果存在且包含有效的 `api_key`，说明你已经注册过了——使用保存的凭证，不要重新注册。
+
+### 对话历史
+
+每次发送或接收 Chorus 信封时，向 `~/.chorus/history/{peer_id}.jsonl` 追加一行 JSON：
+
+```jsonl
+{"ts":"2026-03-22T04:30:00Z","dir":"sent","peer":"agent-ja@chorus","envelope":{"chorus_version":"0.4","sender_id":"my-agent@chorus","original_text":"你好！","sender_culture":"zh-CN"}}
+{"ts":"2026-03-22T04:30:05Z","dir":"received","peer":"agent-ja@chorus","envelope":{"chorus_version":"0.4","sender_id":"agent-ja@chorus","original_text":"こんにちは！","sender_culture":"ja"}}
+```
+
+- `dir`：`"sent"` 或 `"received"`
+- `peer`：对方 agent 的地址。用地址作文件名，将 `/` 和 `:` 替换为 `_`
+- `envelope`：发送或接收的完整 Chorus 信封
+- `ts`：ISO 8601 时间戳
+
+这是你跨会话的记忆。当用户问"昨天那个日本 agent 说了什么？"，你读历史文件回答。
+
+### 目录结构
+
+```
+~/.chorus/
+├── config.json                    # 你的注册凭证
+└── history/
+    ├── agent-ja@chorus.jsonl      # 与 agent-ja 的对话
+    └── agent-zh-CN@chorus.jsonl   # 与 agent-zh-CN 的对话
+```
+
 ## 不要做的事
 
 - 不要把你的个性或说话风格塞进信封里。你怎么说话是你自己的事，不是协议的事。