@partme.ai/openclaw-web-stomp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,110 @@
+import { PluginRuntime } from 'openclaw/plugin-sdk/runtime-store';
+
+interface StompConnectionInfo {
+    connectionId: string;
+    login?: string;
+    clientId?: string;
+    connectedAt: string;
+    lastActiveAt: string;
+    subscriptionCount: number;
+    agentId?: string;
+    sessionKey?: string;
+    /** CONNECT 成功后才处理业务帧 */
+    stompConnected?: boolean;
+}
+
+/**
+ * OpenClaw ChannelPlugin：STOMP over WebSocket（stomp-ws）。
+ */
+declare const stompWsChannel: {
+    id: string;
+    name: string;
+    meta: {
+        id: string;
+        label: string;
+        selectionLabel: string;
+        docsPath: string;
+        blurb: string;
+        aliases: string[];
+        order: number;
+    };
+    capabilities: {
+        chatTypes: readonly ["direct"];
+    };
+    reload: {
+        configPrefixes: string[];
+    };
+    config: {
+        listAccountIds: () => string[];
+        resolveAccount: (cfg: Record<string, unknown>) => {
+            accountId: string;
+            name: string;
+            enabled: boolean;
+            configured: boolean;
+        };
+    };
+    status: {
+        buildAccountSnapshot: (cfg: Record<string, unknown>) => {
+            accountId: string;
+            name: string;
+            enabled: boolean;
+            configured: boolean;
+            webhookPath: string;
+            port: number;
+            extra: {
+                stats: {
+                    totalConnections: number;
+                    routedInbound: number;
+                    droppedInbound: number;
+                };
+                connections: StompConnectionInfo[];
+                subscriptions: {
+                    totalSubscriptions: number;
+                    uniqueDestinations: number;
+                    activeConnections: number;
+                };
+                ack: {
+                    pendingCount: number;
+                    oldestPendingMs: number | null;
+                };
+            };
+        };
+    };
+    gateway: {
+        startAccount: ({ runtime, abortSignal, }: {
+            runtime: {
+                config: Record<string, unknown>;
+            };
+            abortSignal: AbortSignal;
+        }) => Promise<void>;
+    };
+    outbound: {
+        deliveryMode: "direct";
+        sendText: (sessionKey: string, text: string) => Promise<void>;
+    };
+};
+
+/**
+ * Gateway PluginRuntime 存取（与 openclaw-web-mqtt 一致）。
+ */
+
+/**
+ * 注入 OpenClaw 插件运行时。
+ */
+declare function setStompWsRuntime(runtime: PluginRuntime): void;
+/**
+ * 获取运行时；未初始化时返回 null。
+ */
+declare function tryGetStompWsRuntime(): PluginRuntime | null;
+/**
+ * 必须获取运行时。
+ */
+declare function getStompWsRuntime(): PluginRuntime;
+
+/**
+ * openclaw-web-stomp：官方 defineChannelPluginEntry 渠道入口。
+ */
+
+declare const _default: unknown;
+
+export { _default as default, getStompWsRuntime, setStompWsRuntime, stompWsChannel, tryGetStompWsRuntime };

package/dist/index.js

@@ -0,0 +1,61 @@
+import {
+  buildStompWsConfigSnapshot,
+  getStompWsChannelConfig,
+  getStompWsRuntime,
+  resolveStompWsConfig,
+  setStompWsRuntime,
+  stompWsChannel,
+  tryGetStompWsRuntime
+} from "./chunk-ORWEBPDJ.js";
+import {
+  getAckStats,
+  getConnectionInfoList,
+  getStompServerStats,
+  getSubscriptionStats,
+  stopStompServer
+} from "./chunk-PKJKPVTH.js";
+
+// src/index.ts
+import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
+var index_default = defineChannelPluginEntry({
+  id: "openclaw-web-stomp",
+  name: "STOMP Web",
+  description: "OpenClaw STOMP over WebSocket channel plugin with topic bindings and dmScope session isolation.",
+  plugin: stompWsChannel,
+  setRuntime: setStompWsRuntime,
+  registerFull(api) {
+    api.registerHttpRoute({
+      path: "/stomp-ws/status",
+      auth: "plugin",
+      match: "prefix",
+      handler: async (_req, res) => {
+        const runtimeCfg = api.runtime?.config ?? {};
+        const resolved = resolveStompWsConfig(runtimeCfg);
+        const active = getStompWsChannelConfig() ?? resolved;
+        const body = {
+          ok: true,
+          data: {
+            stats: getStompServerStats(),
+            connections: getConnectionInfoList(),
+            subscriptions: getSubscriptionStats(),
+            ack: getAckStats(),
+            config: buildStompWsConfigSnapshot(active)
+          }
+        };
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(body));
+      }
+    });
+  }
+});
+process.on("SIGTERM", async () => {
+  await stopStompServer().catch(() => void 0);
+});
+export {
+  index_default as default,
+  getStompWsRuntime,
+  setStompWsRuntime,
+  stompWsChannel,
+  tryGetStompWsRuntime
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * openclaw-web-stomp：官方 defineChannelPluginEntry 渠道入口。\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { defineChannelPluginEntry } from \"openclaw/plugin-sdk/channel-core\";\nimport type { OpenClawPluginApi } from \"openclaw/plugin-sdk/core\";\n\nimport { stompWsChannel } from \"./channel.js\";\nimport { setStompWsRuntime } from \"./runtime.js\";\nimport { resolveStompWsConfig, buildStompWsConfigSnapshot } from \"./stomp-config.js\";\nimport { getStompWsChannelConfig } from \"./stomp-state.js\";\nimport {\n  stopStompServer,\n  getConnectionInfoList,\n  getStompServerStats,\n} from \"./stomp-server.js\";\nimport { getSubscriptionStats } from \"./subscription-mgr.js\";\nimport { getAckStats } from \"./ack-handler.js\";\n\nexport { stompWsChannel } from \"./channel.js\";\nexport { setStompWsRuntime, tryGetStompWsRuntime, getStompWsRuntime } from \"./runtime.js\";\n\nexport default defineChannelPluginEntry({\n  id: \"openclaw-web-stomp\",\n  name: \"STOMP Web\",\n  description: \"OpenClaw STOMP over WebSocket channel plugin with topic bindings and dmScope session isolation.\",\n  plugin: stompWsChannel,\n  setRuntime: setStompWsRuntime,\n  registerFull(api: OpenClawPluginApi) {\n    api.registerHttpRoute({\n      path: \"/stomp-ws/status\",\n      auth: \"plugin\",\n      match: \"prefix\",\n      handler: async (_req: IncomingMessage, res: ServerResponse) => {\n        const runtimeCfg = ((api.runtime as { config?: Record<string, unknown> })?.config ?? {}) as Record<\n          string,\n          unknown\n        >;\n        const resolved = resolveStompWsConfig(runtimeCfg);\n        const active = getStompWsChannelConfig() ?? resolved;\n        const body = {\n          ok: true,\n          data: {\n            stats: getStompServerStats(),\n            connections: getConnectionInfoList(),\n            subscriptions: getSubscriptionStats(),\n            ack: getAckStats(),\n            config: buildStompWsConfigSnapshot(active),\n          },\n        };\n        res.writeHead(200, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify(body));\n      },\n    });\n  },\n});\n\nprocess.on(\"SIGTERM\", async () => {\n  await stopStompServer().catch(() => undefined);\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AAKA,SAAS,gCAAgC;AAkBzC,IAAO,gBAAQ,yBAAyB;AAAA,EACtC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,aAAa,KAAwB;AACnC,QAAI,kBAAkB;AAAA,MACpB,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,OAAO,MAAuB,QAAwB;AAC7D,cAAM,aAAe,IAAI,SAAkD,UAAU,CAAC;AAItF,cAAM,WAAW,qBAAqB,UAAU;AAChD,cAAM,SAAS,wBAAwB,KAAK;AAC5C,cAAM,OAAO;AAAA,UACX,IAAI;AAAA,UACJ,MAAM;AAAA,YACJ,OAAO,oBAAoB;AAAA,YAC3B,aAAa,sBAAsB;AAAA,YACnC,eAAe,qBAAqB;AAAA,YACpC,KAAK,YAAY;AAAA,YACjB,QAAQ,2BAA2B,MAAM;AAAA,UAC3C;AAAA,QACF;AACA,YAAI,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC;AACzD,YAAI,IAAI,KAAK,UAAU,IAAI,CAAC;AAAA,MAC9B;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;AAED,QAAQ,GAAG,WAAW,YAAY;AAChC,QAAM,gBAAgB,EAAE,MAAM,MAAM,MAAS;AAC/C,CAAC;","names":[]}

package/dist/setup-entry.d.ts

@@ -0,0 +1,6 @@
+/**
+ * setup 专用入口：仅导出 ChannelPlugin，避免 setup 场景加载完整 HTTP/WS 启动逻辑。
+ */
+declare const _default: unknown;
+
+export { _default as default };

package/dist/setup-entry.js

@@ -0,0 +1,16 @@
+import {
+  stompWsChannel
+} from "./chunk-ORWEBPDJ.js";
+import "./chunk-PKJKPVTH.js";
+
+// src/setup-entry.ts
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/channel-core";
+var setupChannelPlugin = {
+  ...stompWsChannel,
+  id: "openclaw-web-stomp"
+};
+var setup_entry_default = defineSetupPluginEntry(setupChannelPlugin);
+export {
+  setup_entry_default as default
+};
+//# sourceMappingURL=setup-entry.js.map

package/dist/setup-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup-entry.ts"],"sourcesContent":["/**\n * setup 专用入口：仅导出 ChannelPlugin，避免 setup 场景加载完整 HTTP/WS 启动逻辑。\n */\n\nimport { defineSetupPluginEntry } from \"openclaw/plugin-sdk/channel-core\";\nimport { stompWsChannel } from \"./channel.js\";\n\nconst setupChannelPlugin = {\n  ...stompWsChannel,\n  id: \"openclaw-web-stomp\",\n};\n\nexport default defineSetupPluginEntry(setupChannelPlugin);\n"],"mappings":";;;;;;AAIA,SAAS,8BAA8B;AAGvC,IAAM,qBAAqB;AAAA,EACzB,GAAG;AAAA,EACH,IAAI;AACN;AAEA,IAAO,sBAAQ,uBAAuB,kBAAkB;","names":[]}

package/dist/stomp-server-FJO6VDEE.js

@@ -0,0 +1,15 @@
+import {
+  getConnectionInfoList,
+  getStompServerStats,
+  publishToDestination,
+  startStompServer,
+  stopStompServer
+} from "./chunk-PKJKPVTH.js";
+export {
+  getConnectionInfoList,
+  getStompServerStats,
+  publishToDestination,
+  startStompServer,
+  stopStompServer
+};
+//# sourceMappingURL=stomp-server-FJO6VDEE.js.map

package/dist/stomp-server-FJO6VDEE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/openclaw.plugin.json

@@ -0,0 +1,130 @@
+{
+  "id": "openclaw-web-stomp",
+  "name": "openclaw-web-stomp",
+  "version": "0.1.0",
+  "description": "STOMP over WebSocket channel plugin for OpenClaw (stomp-ws)",
+  "main": "dist/index.js",
+  "channels": ["stomp-ws"],
+  "commands": [],
+  "skills": [],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": true,
+    "properties": {
+      "channels": {
+        "type": "object",
+        "properties": {
+          "stomp-ws": {
+            "type": "object",
+            "properties": {
+              "wsPort": { "type": "number", "default": 15674 },
+              "port": { "type": "number", "description": "Alias for wsPort" },
+              "path": { "type": "string", "default": "/ws" },
+              "host": { "type": "string", "default": "0.0.0.0" },
+              "maxConnections": { "type": "number", "default": 500 },
+              "maxFrameSize": { "type": "number", "default": 1048576 },
+              "heartbeatIncoming": { "type": "number", "default": 10000 },
+              "heartbeatOutgoing": { "type": "number", "default": 10000 },
+              "heartbeat": {
+                "type": "object",
+                "properties": {
+                  "serverMs": { "type": "number" },
+                  "clientMs": { "type": "number" }
+                }
+              },
+              "subscribeTopics": {
+                "type": "array",
+                "items": { "type": "string" },
+                "default": []
+              },
+              "topicBindings": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "topicPattern": { "type": "string" },
+                    "agentId": { "type": "string" },
+                    "accountId": { "type": "string" },
+                    "replyTopic": { "type": "string" }
+                  },
+                  "required": ["topicPattern", "agentId"]
+                },
+                "default": []
+              },
+              "defaultAckMode": {
+                "type": "string",
+                "enum": ["auto", "client", "client-individual"],
+                "default": "auto"
+              },
+              "prefetchCount": { "type": "number", "default": 10 },
+              "auth": {
+                "type": "object",
+                "properties": {
+                  "required": { "type": "boolean", "default": false },
+                  "allowAnonymous": { "type": "boolean", "default": true },
+                  "defaultUser": { "type": "string" },
+                  "defaultPass": { "type": "string" },
+                  "users": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "username": { "type": "string" },
+                        "password": { "type": "string" },
+                        "publishAllow": { "type": "array", "items": { "type": "string" } },
+                        "subscribeAllow": { "type": "array", "items": { "type": "string" } },
+                        "aclRules": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "action": { "type": "string" },
+                              "topicPattern": { "type": "string" },
+                              "effect": { "type": "string" },
+                              "accountId": { "type": "string" }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "default": []
+                  }
+                }
+              },
+              "tls": {
+                "type": "object",
+                "properties": {
+                  "enabled": { "type": "boolean", "default": false },
+                  "keyFile": { "type": "string" },
+                  "certFile": { "type": "string" },
+                  "caFile": { "type": "string" }
+                }
+              },
+              "limits": {
+                "type": "object",
+                "properties": {
+                  "maxPayloadBytes": { "type": "number", "default": 1048576 },
+                  "maxSubscriptionsPerClient": { "type": "number", "default": 200 }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "channels.stomp-ws.wsPort": { "label": "WebSocket Port", "placeholder": "15674" },
+    "channels.stomp-ws.path": { "label": "WebSocket Path", "placeholder": "/ws" },
+    "channels.stomp-ws.host": { "label": "Bind Host", "placeholder": "0.0.0.0" },
+    "channels.stomp-ws.maxConnections": { "label": "Max Connections", "placeholder": "500" },
+    "channels.stomp-ws.maxFrameSize": { "label": "Max STOMP Frame Size (bytes)", "placeholder": "1048576" },
+    "channels.stomp-ws.auth.required": { "label": "Require STOMP login", "type": "toggle" },
+    "channels.stomp-ws.auth.allowAnonymous": { "label": "Allow anonymous CONNECT", "type": "toggle" },
+    "channels.stomp-ws.tls.enabled": { "label": "Enable TLS (WSS)", "type": "toggle" }
+  },
+  "capabilities": {
+    "protocolBridge": true,
+    "websocket": true
+  }
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@partme.ai/openclaw-web-stomp",
+  "version": "0.1.0",
+  "description": "STOMP over WebSocket bridge for OpenClaw — enterprise integration with Spring STOMP clients and web apps",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:client": "tsx scripts/test-stomp-client.ts",
+    "test:all": "pnpm run test && pnpm run test:client"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "stomp",
+    "websocket",
+    "enterprise",
+    "protocol-bridge"
+  ],
+  "author": "PartMe",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md",
+    "README_CN.md",
+    "RELEASING.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/partme-ai/openclaw-web-stomp.git"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.4.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "setupEntry": "./dist/setup-entry.js",
+    "compat": {
+      "pluginApi": ">=2026.4.0",
+      "minGatewayVersion": "2026.4.0"
+    },
+    "build": {
+      "openclawVersion": "2026.4.0",
+      "pluginSdkVersion": "2026.4.0"
+    },
+    "channel": {
+      "id": "stomp-ws",
+      "label": "STOMP over WebSocket",
+      "blurb": "STOMP over WebSocket with topic bindings, ACL, and session.dmScope isolation."
+    }
+  }
+}