@invago/mixin 1.0.9 → 1.0.11

package/index.ts

@@ -1,28 +1,105 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
-import { mixinPlugin } from "./src/channel.js";
-import { setMixinRuntime } from "./src/runtime.js";
-
-// 全局错误处理
-process.on('unhandledRejection', (reason, promise) => {
-  console.error('[mixin] Unhandled Rejection at:', promise, 'reason:', reason);
-  // 但不退出进程，让OpenClaw处理
-});
-
-process.on('uncaughtException', (error) => {
-  console.error('[mixin] Uncaught Exception:', error);
-  // 但不退出进程，让OpenClaw处理
-});
-
-const plugin = {
-  id: "mixin",
-   name: "Mixin Messenger Channel",
-   description: "Mixin Messenger channel via Blaze WebSocket or HTTP Webhook",
-  configSchema: emptyPluginConfigSchema(),
-  register(api: OpenClawPluginApi): void {
-    setMixinRuntime(api.runtime);
-    api.registerChannel({ plugin: mixinPlugin });
-  },
-};
-
+import type { OpenClawPluginApi, OpenClawConfig } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { mixinPlugin } from "./src/channel.js";
+import {
+  buildMixinAccountsText,
+  buildMixinPluginDiagnostics,
+  formatMixinHelpText,
+  formatMixinSetupText,
+  formatMixinStatusText,
+  normalizeMixinSetupMode,
+} from "./src/plugin-admin.js";
+import { setMixinRuntime } from "./src/runtime.js";
+
+process.on("unhandledRejection", (reason, promise) => {
+  console.error("[mixin] Unhandled Rejection at:", promise, "reason:", reason);
+});
+
+process.on("uncaughtException", (error) => {
+  console.error("[mixin] Uncaught Exception:", error);
+});
+
+async function buildStatusText(cfg: OpenClawConfig): Promise<string> {
+  const diagnostics = await buildMixinPluginDiagnostics(cfg);
+  return formatMixinStatusText(cfg, diagnostics);
+}
+
+async function buildSetupText(cfg: OpenClawConfig, mode?: string): Promise<string> {
+  const diagnostics = await buildMixinPluginDiagnostics(cfg);
+  return formatMixinSetupText(cfg, diagnostics, normalizeMixinSetupMode(mode ?? ""));
+}
+
+const plugin = {
+  id: "mixin",
+  name: "Mixin Messenger Channel",
+  description: "Mixin Messenger channel via Blaze WebSocket",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi): void {
+    setMixinRuntime(api.runtime);
+    api.registerChannel({ plugin: mixinPlugin });
+    api.registerService({
+      id: "mixin-diagnostics",
+      start: () => api.logger.info("[mixin] diagnostics service ready"),
+      stop: () => api.logger.info("[mixin] diagnostics service stopped"),
+    });
+    api.registerGatewayMethod("mixin.status", async ({ respond }) => {
+      const cfg = api.config as OpenClawConfig;
+      const diagnostics = await buildMixinPluginDiagnostics(cfg);
+      respond(true, {
+        status: formatMixinStatusText(cfg, diagnostics),
+        diagnostics,
+      });
+    });
+    api.registerGatewayMethod("mixin.accounts", async ({ respond }) => {
+      const cfg = api.config as OpenClawConfig;
+      respond(true, {
+        accounts: buildMixinAccountsText(cfg),
+      });
+    });
+    api.registerGatewayMethod("mixin.setup", async ({ respond }) => {
+      const cfg = api.config as OpenClawConfig;
+      respond(true, {
+        setup: await buildSetupText(cfg),
+      });
+    });
+    api.registerCommand({
+      name: "setup",
+      description: "Show Mixin setup guide",
+      acceptsArgs: true,
+      handler: async (ctx: { config: OpenClawConfig; args?: string }) => ({
+        text: await buildSetupText(ctx.config, ctx.args),
+      }),
+    });
+    api.registerCommand({
+      name: "mixin-setup",
+      description: "Show Mixin setup guide",
+      acceptsArgs: true,
+      handler: async (ctx: { config: OpenClawConfig; args?: string }) => ({
+        text: await buildSetupText(ctx.config, ctx.args),
+      }),
+    });
+    api.registerCommand({
+      name: "mixin-status",
+      description: "Show Mixin plugin status",
+      handler: async (ctx: { config: OpenClawConfig }) => ({
+        text: await buildStatusText(ctx.config),
+      }),
+    });
+    api.registerCommand({
+      name: "mixin-accounts",
+      description: "List configured Mixin accounts",
+      handler: async (ctx: { config: OpenClawConfig }) => ({
+        text: buildMixinAccountsText(ctx.config),
+      }),
+    });
+    api.registerCommand({
+      name: "mixin-help",
+      description: "Show Mixin plugin help",
+      handler: async () => ({
+        text: formatMixinHelpText(),
+      }),
+    });
+  },
+};
+
 export default plugin;

package/openclaw.plugin.json

@@ -1,9 +1,14 @@
 {
   "id": "mixin",
-  "channels": ["mixin"],
+  "name": "Mixin Messenger Channel",
+  "description": "Mixin Messenger channel via Blaze WebSocket",
+  "version": "1.0.10",
+  "channels": [
+    "mixin"
+  ],
   "configSchema": {
     "type": "object",
-    "additionalProperties": true,
+    "additionalProperties": false,
     "properties": {}
   }
-}
+}

package/package.json

@@ -1 +1,79 @@
-{"name":"@invago/mixin","version":"1.0.9","description":"Mixin Messenger channel plugin for OpenClaw","type":"module","main":"index.ts","bin":{"mixin-plugin-onboard":"tools/mixin-plugin-onboard/bin/mixin-plugin-onboard.mjs"},"scripts":{"dev":"nodemon --exec \"node --import jiti/register index.ts\" --ext ts","lint":"eslint src/**/*.ts index.ts","typecheck":"tsc --noEmit","tool:info":"node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts info","tool:doctor":"node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts doctor"},"peerDependencies":{"openclaw":">=2026.2.0"},"dependencies":{"@mixin.dev/mixin-node-sdk":"^7.4.1","@noble/curves":"^2.0.1","@noble/hashes":"^2.0.1","axios":"^1.6.0","express":"^5.2.1","jiti":"^1.21.0","proxy-agent":"^6.5.0","ws":"^8.18.3","zod":"^4.3.6"},"devDependencies":{"@eslint/js":"^10.0.1","@types/node":"^20.0.0","eslint":"^10.0.3","globals":"^17.4.0","nodemon":"^3.0.0","typescript":"^5.3.0","typescript-eslint":"^8.56.1"},"keywords":["openclaw","mixin","messenger","plugin","channel"],"author":"invagao","license":"MIT","repository":{"type":"git","url":"git+https://github.com/invago/mixinclaw.git"},"openclaw":{"extensions":["./index.ts"],"channel":{"id":"mixin","label":"Mixin Messenger","selectionLabel":"Mixin Messenger (Blaze WebSocket)","docsPath":"/channels/mixin","order":70,"aliases":["mixin-messenger","mixin"],"quickstartAllowFrom":true},"install":{"npmSpec":"@invago/mixin","localPath":"extensions/mixin"}}}
+{
+  "name": "@invago/mixin",
+  "version": "1.0.11",
+  "description": "Mixin Messenger channel plugin for OpenClaw",
+  "type": "module",
+  "main": "index.ts",
+  "scripts": {
+    "dev": "nodemon --exec \"node --import jiti/register index.ts\" --ext ts",
+    "lint": "eslint src/**/*.ts index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.2.0"
+  },
+  "dependencies": {
+    "@mixin.dev/mixin-node-sdk": "^7.4.1",
+    "@noble/curves": "^2.0.1",
+    "@noble/hashes": "^2.0.1",
+    "axios": "^1.13.6",
+    "express": "^5.2.1",
+    "jiti": "^1.21.0",
+    "proxy-agent": "^6.5.0",
+    "ws": "^8.18.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^20.0.0",
+    "eslint": "^10.0.3",
+    "globals": "^17.4.0",
+    "nodemon": "^3.0.0",
+    "typescript": "^5.3.0",
+    "typescript-eslint": "^8.56.1"
+  },
+  "keywords": [
+    "openclaw",
+    "mixin",
+    "messenger",
+    "plugin",
+    "channel"
+  ],
+  "author": "invagao",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/invago/mixinclaw.git"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "mixin",
+      "label": "Mixin Messenger",
+      "selectionLabel": "Mixin Messenger (Blaze WebSocket)",
+      "docsPath": "/channels/mixin",
+      "order": 70,
+      "aliases": [
+        "mixin-messenger",
+        "mixin"
+      ],
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@invago/mixin",
+      "localPath": "extensions/mixin"
+    }
+  },
+  "files": [
+    "README.md",
+    "README.zh-CN.md",
+    "index.ts",
+    "openclaw.plugin.json",
+    "package.json",
+    "src/",
+    "tsconfig.json",
+    "eslint.config.mjs"
+  ]
+}

package/src/blaze-service.ts

@@ -9,12 +9,8 @@ import WebSocket from "ws";
 import crypto from "crypto";
 import type { MixinAccountConfig } from "./config-schema.js";
 import { createProxyAgent } from "./proxy.js";
-
-type SendLog = {
-  info: (msg: string) => void;
-  error: (msg: string, err?: unknown) => void;
-  warn: (msg: string) => void;
-};
+import type { MixinBlazeOutboundMessage } from "./runtime.js";
+import type { SendLog } from "./shared.js";
 
 function buildKeystore(config: MixinAccountConfig) {
   return {
@@ -50,8 +46,9 @@ export async function runBlazeLoop(params: {
   handler: BlazeHandler;
   log: SendLog;
   abortSignal?: AbortSignal;
+  onSenderReady?: ((sender: ((message: MixinBlazeOutboundMessage) => Promise<void>) | null) => void) | undefined;
 }): Promise<void> {
-  const { config, options, handler, log, abortSignal } = params;
+  const { config, options, handler, log, abortSignal, onSenderReady } = params;
   const keystore = buildKeystore(config);
   const jwtToken = signAccessToken("GET", "/", "", crypto.randomUUID(), keystore) || "";
   const agent = createProxyAgent(config.proxy);
@@ -67,6 +64,7 @@ export async function runBlazeLoop(params: {
         clearTimeout(pingTimeout);
         pingTimeout = null;
       }
+      onSenderReady?.(null);
       abortSignal?.removeEventListener("abort", onAbort);
     };
 
@@ -118,6 +116,25 @@ export async function runBlazeLoop(params: {
     ws.on("open", () => {
       opened = true;
       heartbeat();
+      onSenderReady?.(async (message) => {
+        if (!ws || ws.readyState !== WebSocket.OPEN) {
+          throw new Error("blaze sender unavailable: socket not open");
+        }
+        const ok = await sendRaw(ws, {
+          id: crypto.randomUUID(),
+          action: "CREATE_MESSAGE",
+          params: {
+            conversation_id: message.conversationId,
+            status: "SENT",
+            message_id: message.messageId,
+            category: message.category,
+            data: message.dataBase64,
+          },
+        });
+        if (!ok) {
+          throw new Error("blaze sender timeout");
+        }
+      });
       void sendRaw(ws!, {
         id: crypto.randomUUID(),
         action: "LIST_PENDING_MESSAGES",