@mind2flow/daemon 0.1.0

package/dist/protocols/openclaw-protocol.js

@@ -0,0 +1,131 @@
+/**
+ * OpenClaw native protocol adapter.
+ *
+ * Implements the OpenClaw Gateway WebSocket protocol as documented in:
+ *   https://github.com/openclaw/openclaw/blob/main/docs/gateway/protocol.md
+ *
+ * Wire format:
+ *   Request:  { type: "req", id: string, method: string, params?: unknown }
+ *   Response: { type: "res", id: string, ok: boolean, payload?: unknown, error?: ErrorShape }
+ *   Event:    { type: "event", event: string, payload?: unknown, seq?: number }
+ *
+ * Connection lifecycle:
+ *   1. Gateway may send a "connect.challenge" event with a nonce
+ *   2. Client MUST send a "connect" request as the first frame
+ *   3. Gateway responds with hello-ok (ok: true) or error + close
+ *   4. After handshake, normal req/res flow
+ *
+ * Key differences from JSON-RPC 2.0:
+ *   - Uses `type: "req"` instead of `jsonrpc: "2.0"`
+ *   - Uses `ok: boolean` + `payload` instead of `result`
+ *   - String IDs only (not numeric)
+ *   - `additionalProperties: false` — no extra keys allowed
+ *   - Mandatory connect handshake as first frame
+ */
+// ── Protocol constants ─────────────────────────────────────────
+const PROTOCOL_VERSION = 3;
+const CONNECT_ID = "__m2f_connect__";
+// ── Adapter implementation ─────────────────────────────────────
+export class OpenClawProtocol {
+    name = "openclaw";
+    buildHandshake(opts) {
+        const frame = {
+            type: "req",
+            id: CONNECT_ID,
+            method: "connect",
+            params: {
+                minProtocol: PROTOCOL_VERSION,
+                maxProtocol: PROTOCOL_VERSION,
+                client: {
+                    id: opts.clientId ?? "cli",
+                    displayName: opts.displayName ?? "Mind2Flow Daemon",
+                    version: opts.clientVersion ?? "0.1.0",
+                    platform: opts.platform ?? process.platform,
+                    mode: "cli",
+                },
+                role: "operator",
+                scopes: ["operator.read", "operator.write"],
+                caps: [],
+                ...(opts.token ? { auth: { token: opts.token } } : {}),
+            },
+        };
+        return JSON.stringify(frame);
+    }
+    encodeRequest(req) {
+        const frame = {
+            type: "req",
+            id: req.id,
+            method: req.method,
+        };
+        if (req.params && Object.keys(req.params).length > 0) {
+            frame.params = req.params;
+        }
+        return JSON.stringify(frame);
+    }
+    parseMessage(raw) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return { kind: "unknown", raw };
+        }
+        if (!parsed || typeof parsed !== "object") {
+            return { kind: "unknown", raw: parsed };
+        }
+        const frame = parsed;
+        // Response frame
+        if (frame.type === "res") {
+            const resFrame = frame;
+            const response = {
+                id: String(resFrame.id),
+                ok: resFrame.ok,
+                result: resFrame.payload,
+            };
+            if (resFrame.error) {
+                response.error = {
+                    code: resFrame.error.code,
+                    message: resFrame.error.message,
+                    data: resFrame.error.details,
+                };
+            }
+            return { kind: "response", response };
+        }
+        // Event frame
+        if (frame.type === "event") {
+            const evtFrame = frame;
+            const event = {
+                event: evtFrame.event,
+                payload: evtFrame.payload,
+                seq: evtFrame.seq,
+            };
+            return { kind: "event", event };
+        }
+        return { kind: "unknown", raw: parsed };
+    }
+    isHandshakeResponse(raw) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        const frame = parsed;
+        if (frame.type === "res" && frame.id === CONNECT_ID) {
+            return frame.ok === true;
+        }
+        // connect.challenge event — not a handshake *response*, ignore for now
+        // (in production we'd handle nonce signing)
+        if (frame.type === "event") {
+            const evt = frame;
+            if (evt.event === "connect.challenge") {
+                return null; // Not a response, keep waiting
+            }
+        }
+        return null; // Not a handshake message
+    }
+}
+//# sourceMappingURL=openclaw-protocol.js.map

package/dist/protocols/openclaw-protocol.js.map

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

package/dist/protocols/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Protocol adapter types for the Gateway client.
+ *
+ * The daemon supports multiple wire protocols for communicating with
+ * local agent gateways. Each protocol adapter translates between our
+ * internal request/response model and the gateway's native framing.
+ *
+ * Supported protocols:
+ *   - "openclaw"  — OpenClaw native WS protocol (type:"req"/"res", connect handshake)
+ *   - "jsonrpc"   — Standard JSON-RPC 2.0 over WebSocket (no handshake)
+ */
+/** Outgoing request from daemon → gateway */
+export interface GatewayRequest {
+    id: string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** Incoming response from gateway → daemon */
+export interface GatewayResponse {
+    id: string;
+    ok: boolean;
+    result?: unknown;
+    error?: {
+        code: string | number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** Server-initiated notification/event (no id) */
+export interface GatewayEvent {
+    event: string;
+    payload?: unknown;
+    seq?: number;
+}
+export type ParsedMessage = {
+    kind: "response";
+    response: GatewayResponse;
+} | {
+    kind: "event";
+    event: GatewayEvent;
+} | {
+    kind: "unknown";
+    raw: unknown;
+};
+export interface ProtocolAdapter {
+    /** Human-readable name for logging */
+    readonly name: string;
+    /**
+     * Generate the initial handshake frame(s) to send on connect.
+     * Returns null if the protocol has no handshake (e.g. JSON-RPC 2.0).
+     */
+    buildHandshake(opts: HandshakeOptions): string | null;
+    /**
+     * Serialize an outgoing request into a wire-format JSON string.
+     */
+    encodeRequest(req: GatewayRequest): string;
+    /**
+     * Parse a raw incoming message into our internal types.
+     */
+    parseMessage(raw: string): ParsedMessage;
+    /**
+     * Check if a parsed response is a handshake-ok response.
+     * Returns true if it is (and the connection is now established).
+     * Returns false for non-handshake responses, or null if the
+     * protocol has no handshake concept.
+     */
+    isHandshakeResponse(raw: string): boolean | null;
+}
+export interface HandshakeOptions {
+    /** Auth token for the gateway */
+    token?: string;
+    /**
+     * Client identifier — must be a value from OpenClaw's GATEWAY_CLIENT_IDS
+     * allowlist: "cli", "gateway-client", "webchat", "node-host", "test", etc.
+     * Default: "cli"
+     */
+    clientId?: string;
+    /** Human-readable display name for this instance (no validation constraints) */
+    displayName?: string;
+    /** Client version */
+    clientVersion?: string;
+    /** Platform (node, macos, linux, etc.) */
+    platform?: string;
+}
+export type ProtocolType = "openclaw" | "jsonrpc";
+//# sourceMappingURL=types.d.ts.map

package/dist/protocols/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocols/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACpE;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAItC,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAAC;IAEtD;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC;IAE3C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IAEzC;;;;;OAKG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAClD;AAID,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC"}

package/dist/protocols/types.js

@@ -0,0 +1,13 @@
+/**
+ * Protocol adapter types for the Gateway client.
+ *
+ * The daemon supports multiple wire protocols for communicating with
+ * local agent gateways. Each protocol adapter translates between our
+ * internal request/response model and the gateway's native framing.
+ *
+ * Supported protocols:
+ *   - "openclaw"  — OpenClaw native WS protocol (type:"req"/"res", connect handshake)
+ *   - "jsonrpc"   — Standard JSON-RPC 2.0 over WebSocket (no handshake)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/protocols/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocols/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@mind2flow/daemon",
+  "version": "0.1.0",
+  "description": "Mind2Flow Command Center — Agent daemon (bridge between Command Center and local OpenClaw Gateway)",
+  "type": "module",
+  "main": "dist/daemon.js",
+  "bin": {
+    "m2f-daemon": "dist/daemon.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/daemon.ts",
+    "start": "node dist/daemon.js",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "systeminformation": "^5.23.0",
+    "screenshot-desktop": "^1.15.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.12",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "README.md"
+  ],
+  "license": "UNLICENSED"
+}