@filiptrivan/openclaw-helmio-chat-probe 0.0.1

package/README.md

@@ -0,0 +1,38 @@
+# @filiptrivan/openclaw-helmio-chat-probe
+
+ADR-0008 probe plugin. **Throwaway.** Validates two narrow things:
+
+- **C1** — `@microsoft/signalr` Node client survives inside the OpenClaw plugin runtime (long-lived connection, auto-reconnect after `pkill -9 node`, access-token callback works).
+- **C4** — plugin installs cleanly into OpenClaw via `openclaw plugins install npm:@filiptrivan/openclaw-helmio-chat-probe@<ver>` at cloud-init against the pinned image.
+
+Not the real `@helmio/openclaw-helmio-chat` plugin. No channel registration, no message routing, no group primitives. Those land in the real plugin once ADR-0008 ratifies. The personal `@filiptrivan` scope is a temporary stand-in for `@helmio` org until the org is set up on npm; the install path is identical, only the package name differs.
+
+## Build
+
+```bash
+npm install
+npm run build
+```
+
+## Publish (one-time setup before C4 can run)
+
+```bash
+npm login                          # as filiptrivan
+npm publish --access public        # public — no NPM_TOKEN needed on probe VMs
+```
+
+## Install (from cloud-init, see infrastructure/cloud-init/probe-c4-install.sh)
+
+```bash
+docker exec openclaw openclaw plugins install npm:@filiptrivan/openclaw-helmio-chat-probe@0.0.1
+docker exec openclaw openclaw gateway restart
+docker exec openclaw openclaw plugins inspect helmio-chat-probe --runtime --json
+```
+
+## Runtime env vars (set on the container, read at registerFull)
+
+- `HELMIO_PROBE_HUB_URL` — SignalR hub URL, e.g. `https://api.helmio.ai/chat` (or whatever `probe-c1` branch deploys to).
+- `HELMIO_CHAT_BRIDGE_TOKEN_PROBE` — static bearer token shared with the hub for the probe run.
+- `HELMIO_PROBE_LOG_PATH` — optional, defaults to `/tmp/helmio-chat-probe.log`. ProbeC1.cs reads this file via `docker exec ... cat`.
+
+If hub URL or token are missing, the plugin loads (C4 still passes) but skips the SignalR connection (C1 will skip).

package/dist/events.d.ts

@@ -0,0 +1,11 @@
+export declare const ProbeEvent: {
+    readonly Connected: "connected";
+    readonly Reconnecting: "reconnecting";
+    readonly Reconnected: "reconnected";
+    readonly Closed: "closed";
+    readonly RestartInitiated: "restart_initiated";
+    readonly ConnectFailed: "connect_failed";
+    readonly EchoReturned: "echo_returned";
+    readonly Heartbeat: "heartbeat";
+};
+export type ProbeEventName = (typeof ProbeEvent)[keyof typeof ProbeEvent];

package/dist/events.js

@@ -0,0 +1,14 @@
+// Shared event-name vocabulary between the TS plugin and the C# probe.
+// Mirror file: integration-probe/helmio-native-chat/probe-c1/ProbeEvents.cs.
+// Renaming an entry without updating both sides fails the probe silently.
+export const ProbeEvent = {
+    Connected: "connected",
+    Reconnecting: "reconnecting",
+    Reconnected: "reconnected",
+    Closed: "closed",
+    RestartInitiated: "restart_initiated",
+    ConnectFailed: "connect_failed",
+    EchoReturned: "echo_returned",
+    Heartbeat: "heartbeat",
+};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,6EAA6E;AAC7E,0EAA0E;AAE1E,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,gBAAgB,EAAE,mBAAmB;IACrC,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,eAAe;IAC7B,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("openclaw/plugin-sdk/plugin-entry").PluginEntryDefinition;
+export default _default;

package/dist/index.js

@@ -0,0 +1,37 @@
+// ADR-0008 probe plugin (throwaway). Validates SignalR Node client in OpenClaw
+// plugin runtime (C1) and the npm install path (C4). Not the real
+// @helmio/openclaw-helmio-chat — no channel registration, no message routing.
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { startProbeRunner } from "./probe-runner.js";
+let runner;
+export default definePluginEntry({
+    id: "helmio-chat-probe",
+    displayName: "Helmio Chat Probe (ADR-0008 C1/C4)",
+    version: "0.0.1",
+    registerFull(api) {
+        const hubUrl = process.env.HELMIO_PROBE_HUB_URL;
+        const token = process.env.HELMIO_CHAT_BRIDGE_TOKEN_PROBE;
+        const logPath = process.env.HELMIO_PROBE_LOG_PATH ?? "/tmp/helmio-chat-probe.log";
+        if (!hubUrl || !token) {
+            api.logger.warn("helmio-chat-probe: HELMIO_PROBE_HUB_URL or HELMIO_CHAT_BRIDGE_TOKEN_PROBE not set; " +
+                "plugin loaded but SignalR connection skipped (C4 still validates; C1 will skip).");
+            return;
+        }
+        api.logger.info(`helmio-chat-probe: dialing ${hubUrl} (logging to ${logPath})`);
+        runner = startProbeRunner({
+            hubUrl,
+            accessToken: token,
+            logPath,
+            logger: {
+                info: (m) => api.logger.info(m),
+                warn: (m) => api.logger.warn(m),
+                error: (m) => api.logger.error(m),
+            },
+        });
+    },
+    async dispose() {
+        await runner?.stop();
+        runner = undefined;
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kEAAkE;AAClE,8EAA8E;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAoB,MAAM,mBAAmB,CAAC;AAEvE,IAAI,MAA+B,CAAC;AAEpC,eAAe,iBAAiB,CAAC;IAC/B,EAAE,EAAE,mBAAmB;IACvB,WAAW,EAAE,oCAAoC;IACjD,OAAO,EAAE,OAAO;IAChB,YAAY,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;QACzD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,4BAA4B,CAAC;QAElF,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACtB,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,qFAAqF;gBACnF,kFAAkF,CACrF,CAAC;YACF,OAAO;QACT,CAAC;QAED,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,MAAM,gBAAgB,OAAO,GAAG,CAAC,CAAC;QAChF,MAAM,GAAG,gBAAgB,CAAC;YACxB,MAAM;YACN,WAAW,EAAE,KAAK;YAClB,OAAO;YACP,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/B,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;aAClC;SACF,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;CACF,CAAC,CAAC"}

package/dist/probe-runner.d.ts

@@ -0,0 +1,14 @@
+export interface ProbeRunnerOptions {
+    hubUrl: string;
+    accessToken: string;
+    logPath: string;
+    logger: {
+        info: (m: string) => void;
+        warn: (m: string) => void;
+        error: (m: string) => void;
+    };
+}
+export interface ProbeRunner {
+    stop(): Promise<void>;
+}
+export declare function startProbeRunner(opts: ProbeRunnerOptions): ProbeRunner;

package/dist/probe-runner.js

@@ -0,0 +1,95 @@
+// SignalR client lifecycle inside the OpenClaw plugin runtime. Event names
+// come from ./events.ts; the C# probe matches the same vocabulary.
+import { promises as fs } from "node:fs";
+import { HubConnectionBuilder, HubConnectionState, LogLevel, } from "@microsoft/signalr";
+import { ProbeEvent } from "./events.js";
+export function startProbeRunner(opts) {
+    let conn;
+    let stopped = false;
+    let tokenCallbackCount = 0;
+    const log = async (event, extra) => {
+        const line = JSON.stringify({
+            ts: new Date().toISOString(),
+            event,
+            pid: process.pid,
+            ...extra,
+        });
+        opts.logger.info(`helmio-chat-probe: ${line}`);
+        try {
+            await fs.appendFile(opts.logPath, line + "\n", { encoding: "utf8" });
+        }
+        catch (err) {
+            opts.logger.warn(`helmio-chat-probe: log write failed: ${err.message}`);
+        }
+    };
+    const buildConnection = () => new HubConnectionBuilder()
+        .withUrl(opts.hubUrl, {
+        accessTokenFactory: () => {
+            tokenCallbackCount += 1;
+            return opts.accessToken;
+        },
+    })
+        .withAutomaticReconnect({
+        nextRetryDelayInMilliseconds: (retryContext) => {
+            const delays = [1000, 2000, 5000, 10000];
+            return delays[retryContext.previousRetryCount] ?? 15000;
+        },
+    })
+        .configureLogging(LogLevel.Information)
+        .build();
+    const wire = (c) => {
+        c.onreconnecting((err) => {
+            void log(ProbeEvent.Reconnecting, { error: err?.message });
+        });
+        c.onreconnected((connectionId) => {
+            void log(ProbeEvent.Reconnected, { connectionId, tokenCallbackCount });
+        });
+        c.onclose((err) => {
+            void log(ProbeEvent.Closed, { error: err?.message });
+            // withAutomaticReconnect returns 15000 forever (no give-up), so onclose
+            // means an unrecoverable error (e.g., 401). Restart manually to observe
+            // recovery across a full socket recreate.
+            if (!stopped) {
+                setTimeout(() => void restart(), 5000);
+            }
+        });
+    };
+    const restart = async () => {
+        if (stopped)
+            return;
+        await log(ProbeEvent.RestartInitiated);
+        conn = buildConnection();
+        wire(conn);
+        try {
+            await conn.start();
+            await log(ProbeEvent.Connected, { tokenCallbackCount });
+            const echo = await conn.invoke("Echo", "probe-c1");
+            await log(ProbeEvent.EchoReturned, { echo });
+        }
+        catch (err) {
+            await log(ProbeEvent.ConnectFailed, { error: err.message });
+            if (!stopped)
+                setTimeout(() => void restart(), 5000);
+        }
+    };
+    void restart();
+    const heartbeat = setInterval(() => {
+        void log(ProbeEvent.Heartbeat, {
+            state: conn?.state ?? HubConnectionState.Disconnected,
+            connectionId: conn?.connectionId,
+        });
+    }, 60_000);
+    return {
+        async stop() {
+            stopped = true;
+            clearInterval(heartbeat);
+            try {
+                await conn?.stop();
+            }
+            catch (err) {
+                opts.logger.warn(`helmio-chat-probe: stop failed: ${err.message}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=probe-runner.js.map

package/dist/probe-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-runner.js","sourceRoot":"","sources":["../src/probe-runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@filiptrivan/openclaw-helmio-chat-probe",
+  "version": "0.0.1",
+  "private": false,
+  "description": "ADR-0008 probe plugin (published under @filiptrivan personal scope as a temporary stand-in for @helmio org): validates SignalR Node client (C1) and OpenClaw plugin install path (C4). Throwaway; not the real @helmio/openclaw-helmio-chat plugin.",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "minGatewayVersion": "2026.2.26"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@microsoft/signalr": "^8.0.7"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "@types/node": "^20.12.7"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}