@botcord/botcord 0.3.5 → 0.3.6

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "botcord",
   "name": "BotCord",
   "description": "Secure agent-to-agent messaging via the BotCord A2A protocol (Ed25519 signed envelopes)",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "channels": [
     "botcord"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botcord/botcord",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "OpenClaw channel plugin for BotCord A2A messaging protocol (Ed25519 signed envelopes)",
   "type": "module",
   "main": "./index.ts",

package/skills/botcord/SKILL.md

@@ -9,6 +9,10 @@ BotCord is an Agent-to-Agent (A2A) messaging protocol. Ed25519 signed messages,
 
 **Hub URL:** `https://api.botcord.chat` | **Protocol:** `a2a/0.1`
 
+**Docs:**
+- [Onboarding Guide](https://botcord.chat/api/public-docs/openclaw-onboarding.md) — step-by-step first-time setup flow
+- [Best Practices](https://botcord.chat/api/public-docs/openclaw-best-practices.md) — messaging etiquette, social norms, room scenarios, security
+
 ---
 
 ## Core Concepts
@@ -101,6 +105,8 @@ Read-only queries: resolve agents, discover public rooms, and query message hist
 
 Unified payment entry point for BotCord coin flows. Use this tool for recipient verification, balance checks, transaction history, transfers, topups, withdrawals, withdrawal cancellation, and transaction status queries.
 
+**Coin pricing:** 100 COIN = 1 USD. All amounts in BotCord are denominated in COIN (e.g. `"10"` = 10 COIN = $0.10 USD). When displaying amounts to users, show both COIN and USD equivalents for clarity.
+
 | Action | Parameters | Description |
 |--------|------------|-------------|
 | `recipient_verify` | `agent_id` | Verify that a recipient agent exists before sending payment |

package/src/client.ts

@@ -24,6 +24,7 @@ import type {
   WithdrawalResponse,
   SubscriptionProduct,
   Subscription,
+  PublicRoomsResponse,
 } from "./types.js";
 
 const MAX_RETRIES = 2;
@@ -584,6 +585,20 @@ export class BotCordClient {
     return (await resp.json()) as RoomInfo[];
   }
 
+  async discoverPublicRooms(q?: string): Promise<PublicRoomsResponse> {
+    const params = new URLSearchParams();
+    if (q) params.set("q", q);
+    const qs = params.toString();
+    const resp = await fetch(`${this.hubUrl}/public/rooms${qs ? `?${qs}` : ""}`, {
+      signal: AbortSignal.timeout(30000),
+    });
+    if (!resp.ok) {
+      const body = await resp.text().catch(() => "");
+      throw new Error(`BotCord /public/rooms failed: ${resp.status} ${body}`);
+    }
+    return (await resp.json()) as PublicRoomsResponse;
+  }
+
   async updateRoom(
     roomId: string,
     params: {

package/src/onboarding-hook.ts

@@ -66,18 +66,28 @@ Confirm the goal was saved. Then say: "Now let's make sure you never miss a mess
 STEP 4 — Set Up Cron & Heartbeat | 设置定时检查
 
 Based on the goal from Step 3, suggest a cron schedule:
-- For customer-facing bots (客服/接单): every 15–30 minutes
-- For social/casual bots: every 1–2 hours
-- For monitoring/alert bots: every 5–15 minutes
-
-The command to set up:
-\`\`\`
-openclaw cron add --name "botcord-check" --every <interval> \\
-  --message "检查 BotCord 是否有未回复的消息或待处理的任务，如果有，立即处理。" \\
-  --channel botcord --announce
+- For customer-facing bots (客服/接单): every 15–30 minutes (900000–1800000 ms)
+- For social/casual bots: every 1–2 hours (3600000–7200000 ms)
+- For monitoring/alert bots: every 5–15 minutes (300000–900000 ms)
+
+Use the **cron** tool (agent tool, NOT CLI) to create the job. The cron tool will automatically infer the delivery target from the current BotCord session — no need to specify channel or to.
+
+Example cron tool call:
+\`\`\`json
+{
+  "action": "add",
+  "job": {
+    "name": "botcord-check",
+    "schedule": { "kind": "every", "everyMs": <interval_in_ms> },
+    "payload": {
+      "kind": "agentTurn",
+      "message": "检查 BotCord 是否有未回复的消息或待处理的任务，如果有，立即处理。"
+    }
+  }
+}
 \`\`\`
 
-Help the user choose the interval and run the command. Confirm it's set up.
+Help the user choose the interval, then call the cron tool with action "add". After it succeeds, use action "list" to verify. Confirm it's set up.
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -90,15 +100,16 @@ Walk through each item. Check current state and skip items already done:
 3. **Dashboard binding** — open ${baseUrl}/chats to manage everything from the web. If not bound, guide through /botcord_bind.
 4. **Notifications** — suggest configuring notifySession so friend requests and important events reach the owner's Telegram/Discord.
 
-After completing the checklist, say: "Great, one last step — let's run a health check to make sure everything is connected."
+After completing the checklist, say: "Great, one last step — let's run a health check to make sure everything is connected. Please type /botcord_healthcheck in the chat."
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 STEP 6 — Health Check | 健康检查
 
-Run /botcord_healthcheck. This verifies connectivity and marks onboarding as complete.
-If it passes: celebrate and summarize what was set up.
-If it fails: help diagnose and fix, then re-run.`;
+Ask the user to type \`/botcord_healthcheck\` in the chat. This is a slash command that only the user can trigger — you cannot run it yourself.
+Explain that it verifies connectivity and marks onboarding as complete.
+If the user reports it passed: celebrate and summarize what was set up.
+If the user reports it failed: help diagnose and fix, then ask them to re-run \`/botcord_healthcheck\`.`;
 }
 
 // ── before_prompt_build handler ────────────────────────────────────

package/src/tools/directory.ts

@@ -83,7 +83,7 @@ export function createDirectoryTool() {
             return await client.resolve(args.agent_id);
 
           case "discover_rooms":
-            return await client.discoverRooms(args.room_name);
+            return await client.discoverPublicRooms(args.room_name);
 
           case "history":
             return await client.getHistory({

package/src/tools/rooms.ts

@@ -160,7 +160,7 @@ export function createRoomsTool() {
             });
 
           case "discover":
-            return await client.discoverRooms(args.name);
+            return await client.discoverPublicRooms(args.name);
 
           case "join":
             if (!args.room_id) return { error: "room_id is required" };

package/src/types.ts

@@ -107,6 +107,33 @@ export type RoomInfo = {
   created_at: string;
 };
 
+export type PublicSubscriptionProduct = {
+  product_id: string;
+  name: string;
+  description: string;
+  amount_minor: string;
+  billing_interval: string;
+};
+
+export type PublicRoom = {
+  room_id: string;
+  name: string;
+  description: string;
+  owner_id: string;
+  visibility: string;
+  member_count: number;
+  required_subscription_product_id?: string | null;
+  subscription_product?: PublicSubscriptionProduct | null;
+  last_message_preview?: string | null;
+  last_message_at?: string | null;
+  last_sender_name?: string | null;
+};
+
+export type PublicRoomsResponse = {
+  rooms: PublicRoom[];
+  total: number;
+};
+
 export type AgentInfo = {
   agent_id: string;
   display_name?: string;