clawdy 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -1,11 +1,18 @@
 /**
  * @clawdy/openclaw-channel
  *
- * OpenClaw channel plugin that enables outbound push messaging from OpenClaw
- * instances to the Clawdy Gateway. When OpenClaw wants to proactively send a
- * message (scheduled, cron, heartbeat, agent-initiated), this plugin POSTs to
- * the Clawdy Gateway's callback endpoint for delivery via web dashboard, Slack,
- * Telegram, or other configured channels.
+ * OpenClaw channel plugin that enables bidirectional messaging between OpenClaw
+ * instances and the Clawdy Gateway.
+ *
+ * **Outbound:** When OpenClaw wants to proactively send a message (scheduled,
+ * cron, heartbeat, agent-initiated), this plugin POSTs to the Clawdy Gateway's
+ * callback endpoint for delivery via web dashboard, Slack, Telegram, or other
+ * configured channels.
+ *
+ * **Inbound:** Exposes a `POST /clawdy/inbound` HTTP route on the OpenClaw
+ * gateway that accepts messages from the Clawdy Gateway and dispatches them
+ * through OpenClaw's standard agent pipeline (session management, agent
+ * routing, reply generation).
  *
  * ## Configuration (openclaw.json)
  *
@@ -34,18 +41,91 @@
  *
  * Using `:default` targets is recommended — the Clawdy Gateway resolves the
  * actual destination from the user's gateway link configuration in the database.
+ *
+ * ## Inbound Endpoint
+ *
+ * `POST /plugins/clawdy/inbound` (registered via `registerHttpRoute`)
+ *
+ * Request body:
+ * ```json
+ * {
+ *   "text": "Hello from the dashboard",
+ *   "senderId": "user_abc123",
+ *   "agentId": "main",        // optional, defaults to "main"
+ *   "sessionKey": "clawdy-user_abc123"  // optional, auto-generated if omitted
+ * }
+ * ```
+ *
+ * Headers:
+ * - `X-Proxy-Secret`: Must match `channels.clawdy.callbackSecret`
+ * - `Content-Type: application/json`
+ *
+ * Response:
+ * ```json
+ * { "ok": true, "response": "Agent reply text here" }
+ * ```
  */
+/**
+ * HTTP route handler types (Node.js IncomingMessage/ServerResponse).
+ * Defined inline to avoid depending on @types/node.
+ */
+interface HttpIncomingMessage {
+    method?: string;
+    headers: Record<string, string | string[] | undefined>;
+    on(event: string, listener: (...args: unknown[]) => void): void;
+}
+interface HttpServerResponse {
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    end(data?: string): void;
+}
 /**
  * OpenClaw Plugin API — passed to the register function.
+ *
+ * Includes core registration methods and the runtime object that provides
+ * access to the channel reply dispatch pipeline.
  */
 interface OpenClawPluginApi {
     registerChannel(opts: {
         plugin: unknown;
     }): void;
+    registerHttpRoute?(opts: {
+        path: string;
+        handler: (req: HttpIncomingMessage, res: HttpServerResponse) => void | Promise<void>;
+    }): void;
+    /** Global OpenClaw configuration (openclaw.json). */
+    config: Record<string, unknown>;
+    /** Plugin runtime — provides channel reply dispatch utilities. */
+    runtime: {
+        channel: {
+            reply: {
+                finalizeInboundContext(ctx: Record<string, unknown>): Record<string, unknown>;
+                createReplyDispatcherWithTyping(opts: Record<string, unknown>): {
+                    dispatcher: unknown;
+                    replyOptions: unknown;
+                    markDispatchIdle: () => void;
+                };
+                dispatchReplyFromConfig(opts: {
+                    ctx: unknown;
+                    cfg: unknown;
+                    dispatcher: unknown;
+                    replyOptions?: unknown;
+                }): Promise<void>;
+                resolveHumanDelayConfig(cfg: unknown, agentId?: string): unknown;
+            };
+        };
+        error?: (...args: unknown[]) => void;
+    };
+    /** Plugin logger. */
+    logger?: {
+        info(...args: unknown[]): void;
+        error(...args: unknown[]): void;
+        warn(...args: unknown[]): void;
+    };
 }
 /**
  * Entry point called by OpenClaw's plugin loader.
- * Registers the Clawdy channel plugin.
+ * Registers the Clawdy channel plugin and the inbound HTTP route.
  */
 export default function register(api: OpenClawPluginApi): void;
 export {};

package/dist/index.js

@@ -2,11 +2,18 @@
 /**
  * @clawdy/openclaw-channel
  *
- * OpenClaw channel plugin that enables outbound push messaging from OpenClaw
- * instances to the Clawdy Gateway. When OpenClaw wants to proactively send a
- * message (scheduled, cron, heartbeat, agent-initiated), this plugin POSTs to
- * the Clawdy Gateway's callback endpoint for delivery via web dashboard, Slack,
- * Telegram, or other configured channels.
+ * OpenClaw channel plugin that enables bidirectional messaging between OpenClaw
+ * instances and the Clawdy Gateway.
+ *
+ * **Outbound:** When OpenClaw wants to proactively send a message (scheduled,
+ * cron, heartbeat, agent-initiated), this plugin POSTs to the Clawdy Gateway's
+ * callback endpoint for delivery via web dashboard, Slack, Telegram, or other
+ * configured channels.
+ *
+ * **Inbound:** Exposes a `POST /clawdy/inbound` HTTP route on the OpenClaw
+ * gateway that accepts messages from the Clawdy Gateway and dispatches them
+ * through OpenClaw's standard agent pipeline (session management, agent
+ * routing, reply generation).
  *
  * ## Configuration (openclaw.json)
  *
@@ -35,6 +42,29 @@
  *
  * Using `:default` targets is recommended — the Clawdy Gateway resolves the
  * actual destination from the user's gateway link configuration in the database.
+ *
+ * ## Inbound Endpoint
+ *
+ * `POST /plugins/clawdy/inbound` (registered via `registerHttpRoute`)
+ *
+ * Request body:
+ * ```json
+ * {
+ *   "text": "Hello from the dashboard",
+ *   "senderId": "user_abc123",
+ *   "agentId": "main",        // optional, defaults to "main"
+ *   "sessionKey": "clawdy-user_abc123"  // optional, auto-generated if omitted
+ * }
+ * ```
+ *
+ * Headers:
+ * - `X-Proxy-Secret`: Must match `channels.clawdy.callbackSecret`
+ * - `Content-Type: application/json`
+ *
+ * Response:
+ * ```json
+ * { "ok": true, "response": "Agent reply text here" }
+ * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = register;
@@ -134,6 +164,35 @@ async function sendCallback(account, payload) {
         messageId: data.messageId ?? payload.messageId,
     };
 }
+/**
+ * Read and parse JSON body from a Node.js IncomingMessage.
+ */
+function readJsonBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = "";
+        req.on("data", (...args) => {
+            const chunk = args[0];
+            body += typeof chunk === "string" ? chunk : String(chunk);
+        });
+        req.on("end", () => {
+            try {
+                resolve(JSON.parse(body));
+            }
+            catch (err) {
+                reject(new Error("Invalid JSON body"));
+            }
+        });
+        req.on("error", reject);
+    });
+}
+/**
+ * Send a JSON response on a Node.js ServerResponse.
+ */
+function jsonResponse(res, statusCode, data) {
+    res.statusCode = statusCode;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(data));
+}
 // ─── Channel Plugin ────────────────────────────────────────────────────────
 const clawdyPlugin = {
     id: "clawdy",
@@ -201,11 +260,149 @@ const clawdyPlugin = {
         },
     },
 };
+// ─── Inbound Handler ───────────────────────────────────────────────────────
+/**
+ * Create the inbound HTTP route handler.
+ *
+ * This handler accepts POST requests from the Clawdy Gateway, dispatches
+ * the message through OpenClaw's agent pipeline, and returns the agent's
+ * response text.
+ *
+ * The flow mirrors how other channel plugins (Telegram, Mattermost, etc.)
+ * handle inbound messages:
+ *
+ *   1. Parse & validate request (check X-Proxy-Secret header)
+ *   2. Build MsgContext (sender, channel, session, body)
+ *   3. Finalize context via `finalizeInboundContext`
+ *   4. Create reply dispatcher via `createReplyDispatcherWithTyping`
+ *   5. Dispatch through agent pipeline via `dispatchReplyFromConfig`
+ *   6. Collect response text and return to caller
+ */
+function createInboundHandler(api) {
+    const core = api.runtime;
+    const cfg = api.config;
+    const log = api.logger ?? console;
+    return async (req, res) => {
+        // ── Method check ─────────────────────────────────────────────────
+        if (req.method !== "POST") {
+            jsonResponse(res, 405, { ok: false, error: "Method not allowed" });
+            return;
+        }
+        // ── Auth check ───────────────────────────────────────────────────
+        const account = resolveAccount(cfg);
+        if (!account.callbackSecret) {
+            jsonResponse(res, 500, {
+                ok: false,
+                error: "No callbackSecret configured in channels.clawdy",
+            });
+            return;
+        }
+        const proxySecret = req.headers["x-proxy-secret"] ?? "";
+        if (proxySecret !== account.callbackSecret) {
+            jsonResponse(res, 401, { ok: false, error: "Unauthorized" });
+            return;
+        }
+        // ── Parse body ───────────────────────────────────────────────────
+        let payload;
+        try {
+            const body = await readJsonBody(req);
+            if (!body.text || typeof body.text !== "string") {
+                jsonResponse(res, 400, { ok: false, error: "Missing required field: text" });
+                return;
+            }
+            if (!body.senderId || typeof body.senderId !== "string") {
+                jsonResponse(res, 400, { ok: false, error: "Missing required field: senderId" });
+                return;
+            }
+            payload = {
+                text: body.text,
+                senderId: body.senderId,
+                agentId: typeof body.agentId === "string" ? body.agentId : undefined,
+                sessionKey: typeof body.sessionKey === "string" ? body.sessionKey : undefined,
+            };
+        }
+        catch {
+            jsonResponse(res, 400, { ok: false, error: "Invalid JSON body" });
+            return;
+        }
+        // ── Build & finalize message context ─────────────────────────────
+        const sessionKey = payload.sessionKey ?? `clawdy-${payload.senderId}`;
+        const from = `clawdy:${payload.senderId}`;
+        const to = "clawdy:default";
+        const ctxPayload = core.channel.reply.finalizeInboundContext({
+            Body: payload.text,
+            BodyForAgent: payload.text,
+            RawBody: payload.text,
+            CommandBody: payload.text,
+            From: from,
+            To: to,
+            SessionKey: sessionKey,
+            AccountId: "default",
+            ChatType: "direct",
+            SenderName: payload.senderId,
+            SenderId: payload.senderId,
+            Provider: "clawdy",
+            Surface: "clawdy",
+            MessageSid: crypto.randomUUID(),
+            Timestamp: Date.now(),
+            CommandAuthorized: true,
+            OriginatingChannel: "clawdy",
+            OriginatingTo: to,
+        });
+        // ── Create reply dispatcher ──────────────────────────────────────
+        // Collect all reply text chunks from the agent so we can return them.
+        const responseChunks = [];
+        const { dispatcher, replyOptions } = core.channel.reply.createReplyDispatcherWithTyping({
+            humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, payload.agentId),
+            deliver: async (replyPayload) => {
+                if (replyPayload.text) {
+                    responseChunks.push(replyPayload.text);
+                }
+            },
+            onError: (err, info) => {
+                log.error(`[clawdy-channel] ${info.kind} reply failed:`, err);
+            },
+        });
+        // ── Dispatch through agent pipeline ──────────────────────────────
+        try {
+            await core.channel.reply.dispatchReplyFromConfig({
+                ctx: ctxPayload,
+                cfg,
+                dispatcher,
+                replyOptions,
+            });
+            const fullResponse = responseChunks.join("\n\n");
+            jsonResponse(res, 200, {
+                ok: true,
+                response: fullResponse,
+            });
+        }
+        catch (err) {
+            log.error("[clawdy-channel] Inbound dispatch failed:", err);
+            jsonResponse(res, 500, {
+                ok: false,
+                error: "Agent dispatch failed",
+            });
+        }
+    };
+}
 // ─── Plugin Registration ───────────────────────────────────────────────────
 /**
  * Entry point called by OpenClaw's plugin loader.
- * Registers the Clawdy channel plugin.
+ * Registers the Clawdy channel plugin and the inbound HTTP route.
  */
 function register(api) {
     api.registerChannel({ plugin: clawdyPlugin });
+    // Register inbound HTTP route if the API supports it.
+    // This exposes POST /plugins/clawdy/inbound on the OpenClaw gateway.
+    if (api.registerHttpRoute) {
+        api.registerHttpRoute({
+            path: "/clawdy/inbound",
+            handler: createInboundHandler(api),
+        });
+        console.log("[clawdy-channel] Registered inbound HTTP route: /clawdy/inbound");
+    }
+    else {
+        console.log("[clawdy-channel] registerHttpRoute not available — inbound route not registered");
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawdy",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "OpenClaw channel plugin for Clawdy — enables outbound push messaging from OpenClaw instances to the Clawdy Gateway",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,7 +13,7 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "pack": "npm run clean && npm run build && npm pack",
-    "publish:npm": "npm run clean && npm run build && npm publish --access public"
+    "publish:npm": "npm publish ./clawdy-0.0.2.tgz --access public"
   },
   "keywords": [
     "openclaw",
@@ -22,6 +22,11 @@
     "plugin",
     "gateway"
   ],
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
   "license": "MIT",
   "repository": {
     "type": "git",