@botcord/botcord 0.1.3 → 0.1.4-beta.20260325025643

package/index.ts

@@ -13,9 +13,11 @@ import { createPaymentTool } from "./src/tools/payment.js";
 import { createSubscriptionTool } from "./src/tools/subscription.js";
 import { createNotifyTool } from "./src/tools/notify.js";
 import { createBindTool } from "./src/tools/bind.js";
+import { createRegisterTool } from "./src/tools/register.js";
 import { createHealthcheckCommand } from "./src/commands/healthcheck.js";
 import { createTokenCommand } from "./src/commands/token.js";
 import { createBindCommand } from "./src/commands/bind.js";
+import { createEnvCommand } from "./src/commands/env.js";
 import { createRegisterCli } from "./src/commands/register.js";
 import {
   buildBotCordLoopRiskPrompt,
@@ -52,6 +54,7 @@ export default {
     api.registerTool(createSubscriptionTool() as any);
     api.registerTool(createNotifyTool() as any);
     api.registerTool(createBindTool() as any);
+    api.registerTool(createRegisterTool() as any);
 
     // Hooks
     api.on("after_tool_call", async (event: any, ctx: any) => {
@@ -90,6 +93,7 @@ export default {
     api.registerCommand(createHealthcheckCommand());
     api.registerCommand(createTokenCommand());
     api.registerCommand(createBindCommand());
+    api.registerCommand(createEnvCommand());
 
     // CLI
     const registerCli = createRegisterCli();

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.1.3",
+  "version": "0.1.4-beta.20260325025643",
   "channels": [
     "botcord"
   ],

package/package.json

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

package/src/commands/env.ts

@@ -0,0 +1,108 @@
+/**
+ * /botcord_env — View or switch the BotCord Hub environment.
+ *
+ * Usage:
+ *   /botcord_env              — show current hub URL and environment
+ *   /botcord_env stable       — switch to stable (api.botcord.chat)
+ *   /botcord_env beta         — switch to beta (preview.botcord.chat)
+ *   /botcord_env test         — switch to test (test.botcord.chat)
+ *   /botcord_env <url>        — switch to a custom hub URL
+ *
+ * Changes are written to the credentials file. Restart gateway to take effect.
+ */
+import { ENV_PRESETS } from "../constants.js";
+import {
+  resolveAccountConfig,
+  isAccountConfigured,
+} from "../config.js";
+import {
+  loadStoredCredentials,
+  writeCredentialsFile,
+} from "../credentials.js";
+import { normalizeAndValidateHubUrl } from "../hub-url.js";
+import { getConfig as getAppConfig } from "../runtime.js";
+
+function resolveEnvLabel(hubUrl: string): string | null {
+  for (const [name, url] of Object.entries(ENV_PRESETS)) {
+    if (hubUrl === url) return name;
+  }
+  return null;
+}
+
+export function createEnvCommand() {
+  return {
+    name: "botcord_env",
+    description: "View or switch the BotCord Hub environment (stable/beta/test or custom URL).",
+    acceptsArgs: true,
+    requireAuth: true,
+    handler: async (ctx: any) => {
+      const cfg = getAppConfig();
+      if (!cfg) {
+        return { text: "[FAIL] No OpenClaw configuration available" };
+      }
+
+      const acct = resolveAccountConfig(cfg);
+      if (!isAccountConfigured(acct)) {
+        return { text: "[FAIL] BotCord is not fully configured (need hubUrl, agentId, keyId, privateKey)" };
+      }
+
+      const arg = (ctx.args || "").trim();
+
+      // ── No argument: show current environment ──
+      if (!arg) {
+        const current = acct.hubUrl || "(not set)";
+        const label = acct.hubUrl ? resolveEnvLabel(acct.hubUrl) : null;
+        const envDisplay = label ? ` (${label})` : "";
+        const presetList = Object.entries(ENV_PRESETS)
+          .map(([name, url]) => `  ${name} → ${url}`)
+          .join("\n");
+        return {
+          text: [
+            `Current hub: ${current}${envDisplay}`,
+            "",
+            "Available environments:",
+            presetList,
+            "",
+            "Usage: /botcord_env <stable|beta|test|URL>",
+          ].join("\n"),
+        };
+      }
+
+      // ── Resolve target URL ──
+      const targetUrl = ENV_PRESETS[arg] || arg;
+
+      let normalizedUrl: string;
+      try {
+        normalizedUrl = normalizeAndValidateHubUrl(targetUrl);
+      } catch (err: any) {
+        return { text: `[FAIL] Invalid hub URL: ${err.message}` };
+      }
+
+      // ── Check if already on this URL ──
+      if (acct.hubUrl === normalizedUrl) {
+        const label = resolveEnvLabel(normalizedUrl);
+        const envDisplay = label ? ` (${label})` : "";
+        return { text: `Already on ${normalizedUrl}${envDisplay}. No change needed.` };
+      }
+
+      // ── Write to credentials file ──
+      if (!acct.credentialsFile) {
+        return { text: "[FAIL] No credentials file configured — cannot persist hub URL change" };
+      }
+
+      try {
+        const creds = loadStoredCredentials(acct.credentialsFile);
+        creds.hubUrl = normalizedUrl;
+        writeCredentialsFile(acct.credentialsFile, creds);
+      } catch (err: any) {
+        return { text: `[FAIL] Could not update credentials file: ${err.message}` };
+      }
+
+      const label = resolveEnvLabel(normalizedUrl);
+      const envDisplay = label ? ` (${label})` : "";
+      return {
+        text: `[OK] Hub URL updated to ${normalizedUrl}${envDisplay}. Restart gateway to take effect.`,
+      };
+    },
+  };
+}

package/src/constants.ts

@@ -9,7 +9,7 @@
 
 export type ReleaseChannel = "stable" | "beta";
 
-export const RELEASE_CHANNEL: ReleaseChannel = "stable";
+export const RELEASE_CHANNEL: ReleaseChannel = "beta";
 
 const HUB_URLS: Record<ReleaseChannel, string> = {
   stable: "https://api.botcord.chat",
@@ -17,3 +17,10 @@ const HUB_URLS: Record<ReleaseChannel, string> = {
 };
 
 export const DEFAULT_HUB = HUB_URLS[RELEASE_CHANNEL];
+
+/** Named environment presets for /botcord_env. */
+export const ENV_PRESETS: Record<string, string> = {
+  stable: "https://api.botcord.chat",
+  beta: "https://preview.botcord.chat",
+  test: "https://test.botcord.chat",
+};

package/src/tools/register.ts

@@ -0,0 +1,67 @@
+/**
+ * botcord_register — Register a new BotCord agent identity via tool call.
+ */
+import { registerAgent } from "../commands/register.js";
+import { getConfig as getAppConfig } from "../runtime.js";
+import { DEFAULT_HUB } from "../constants.js";
+
+export function createRegisterTool() {
+  return {
+    name: "botcord_register",
+    label: "Register Agent",
+    description:
+      "Register a new BotCord agent: generate an Ed25519 keypair, register with the Hub, and save credentials locally.",
+    parameters: {
+      type: "object" as const,
+      properties: {
+        name: {
+          type: "string" as const,
+          description: "Agent display name",
+        },
+        bio: {
+          type: "string" as const,
+          description: "Agent bio/description (optional)",
+        },
+        hub: {
+          type: "string" as const,
+          description: `Hub URL (defaults to ${DEFAULT_HUB})`,
+        },
+        new_identity: {
+          type: "boolean" as const,
+          description: "Generate a fresh keypair instead of reusing existing credentials (default false)",
+        },
+      },
+      required: ["name"],
+    },
+    execute: async (toolCallId: any, args: any, signal?: any, onUpdate?: any) => {
+      if (!args.name) {
+        return { error: "name is required" };
+      }
+
+      const cfg = getAppConfig();
+      if (!cfg) return { error: "No configuration available" };
+
+      try {
+        const result = await registerAgent({
+          name: args.name,
+          bio: args.bio || "",
+          hub: args.hub || DEFAULT_HUB,
+          config: cfg,
+          newIdentity: args.new_identity ?? false,
+        });
+        return {
+          ok: true,
+          agent_id: result.agentId,
+          key_id: result.keyId,
+          display_name: result.displayName,
+          hub: result.hub,
+          credentials_file: result.credentialsFile,
+          claim_url: result.claimUrl,
+          note: "Restart OpenClaw to activate: openclaw gateway restart",
+        };
+      } catch (err: any) {
+        return { error: `Registration failed: ${err.message}` };
+      }
+    },
+  };
+}