@botcord/botcord 0.1.3-beta.1 → 0.1.4-beta.20260325025643

package/index.ts

@@ -1,7 +1,6 @@
 /**
  * @botcord/botcord — OpenClaw plugin for BotCord A2A messaging protocol.
  */
-import { defineChannelPluginEntry } from "openclaw/plugin-sdk/core";
 import { botCordPlugin } from "./src/channel.js";
 import { setBotCordRuntime, setConfigGetter } from "./src/runtime.js";
 import { createMessagingTool, createUploadTool } from "./src/tools/messaging.js";
@@ -14,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,
@@ -26,17 +27,18 @@ import {
   shouldRunBotCordLoopRiskCheck,
 } from "./src/loop-risk.js";
 
-export default defineChannelPluginEntry({
+// Inline replacement for defineChannelPluginEntry from openclaw/plugin-sdk/core.
+// Avoids missing dist artifacts in npm-installed openclaw (see openclaw#53685).
+export default {
   id: "botcord",
   name: "BotCord",
   description: "BotCord A2A messaging protocol — secure agent-to-agent communication with Ed25519 signing",
-  plugin: botCordPlugin,
+  register(api: any) {
+    setBotCordRuntime(api.runtime);
+    api.registerChannel({ plugin: botCordPlugin });
 
-  setRuntime(runtime) {
-    setBotCordRuntime(runtime);
-  },
+    if (api.registrationMode !== "full") return;
 
-  registerFull(api) {
     setConfigGetter(() => api.config);
 
     // Agent tools — `as any` needed until tool execute() return types are
@@ -52,9 +54,10 @@ export default defineChannelPluginEntry({
     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, ctx) => {
+    api.on("after_tool_call", async (event: any, ctx: any) => {
       if (ctx.toolName !== "botcord_send") return;
       if (!didBotCordSendSucceed(event.result, event.error)) return;
       recordBotCordOutboundText({
@@ -63,7 +66,7 @@ export default defineChannelPluginEntry({
       });
     });
 
-    api.on("before_prompt_build", async (event, ctx) => {
+    api.on("before_prompt_build", async (event: any, ctx: any) => {
       if (!shouldRunBotCordLoopRiskCheck({
         channelId: ctx.channelId,
         prompt: event.prompt,
@@ -82,7 +85,7 @@ export default defineChannelPluginEntry({
       return { prependContext };
     }, { priority: 10 });
 
-    api.on("session_end", async (_event, ctx) => {
+    api.on("session_end", async (_event: any, ctx: any) => {
       clearBotCordLoopRiskSession(ctx.sessionKey);
     });
 
@@ -90,12 +93,13 @@ export default defineChannelPluginEntry({
     api.registerCommand(createHealthcheckCommand());
     api.registerCommand(createTokenCommand());
     api.registerCommand(createBindCommand());
+    api.registerCommand(createEnvCommand());
 
     // CLI
     const registerCli = createRegisterCli();
     api.registerCli(registerCli.setup, { commands: registerCli.commands });
   },
-});
+};
 
 export { TopicTracker } from "./src/topic-tracker.js";
 export type { TopicState, TopicInfo } from "./src/topic-tracker.js";

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

package/package.json

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

package/setup-entry.ts

@@ -1,5 +1,5 @@
 // setup-entry.ts — lightweight entry for onboarding/config (no heavy deps like ws)
-import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";
 import { botCordPlugin } from "./src/channel.js";
 
-export default defineSetupPluginEntry(botCordPlugin);
+// Inline replacement for defineSetupPluginEntry (just returns { plugin }).
+export default { plugin: botCordPlugin };

package/src/channel.ts

@@ -4,11 +4,35 @@
  * security, messaging, and status adapters.
  */
 import type { ChannelPlugin, OpenClawConfig as ClawdbotConfig } from "openclaw/plugin-sdk/core";
-import {
-  buildBaseChannelStatusSummary,
-  createDefaultChannelRuntimeState,
-} from "openclaw/plugin-sdk/status-helpers";
-import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
+// Inlined from openclaw/plugin-sdk/status-helpers and account-id to avoid
+// missing dist artifacts in npm-installed openclaw (see openclaw#53685).
+const DEFAULT_ACCOUNT_ID = "default";
+
+function createDefaultChannelRuntimeState(accountId: string) {
+  return {
+    accountId,
+    running: false as const,
+    lastStartAt: null,
+    lastStopAt: null,
+    lastError: null,
+  };
+}
+
+function buildBaseChannelStatusSummary(snapshot: {
+  configured?: boolean | null;
+  running?: boolean | null;
+  lastStartAt?: number | null;
+  lastStopAt?: number | null;
+  lastError?: string | null;
+}) {
+  return {
+    configured: snapshot.configured ?? false,
+    running: snapshot.running ?? false,
+    lastStartAt: snapshot.lastStartAt ?? null,
+    lastStopAt: snapshot.lastStopAt ?? null,
+    lastError: snapshot.lastError ?? null,
+  };
+}
 import {
   resolveChannelConfig,
   resolveAccounts,

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

@@ -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/inbound.ts

@@ -5,7 +5,20 @@
 import { getBotCordRuntime } from "./runtime.js";
 import { resolveAccountConfig } from "./config.js";
 import { buildSessionKey } from "./session-key.js";
-import { loadSessionStore } from "openclaw/plugin-sdk/mattermost";
+import { readFileSync } from "node:fs";
+
+// Simplified inline replacement for loadSessionStore from openclaw/plugin-sdk/mattermost.
+// Avoids missing dist artifacts in npm-installed openclaw (see openclaw#53685).
+function loadSessionStore(storePath: string): Record<string, any> {
+  try {
+    const raw = readFileSync(storePath, "utf-8");
+    if (!raw) return {};
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
+}
 import { sanitizeUntrustedContent, sanitizeSenderName } from "./sanitize.js";
 import { BotCordClient } from "./client.js";
 import { createBotCordReplyDispatcher } from "./reply-dispatcher.js";

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}` };
+      }
+    },
+  };
+}