@wakeshift/openclaw 0.0.0-stage → 1.4.24

package/dist/wake.js

@@ -0,0 +1,66 @@
+// Waking a conversation: one POST to the gateway's own <hooks.path>/agent
+// (OpenClaw 2026.10.4, docs/gateway/config-hooks.md), persistent, into the
+// conversation's session, waiting for the run to finish. OpenClaw wraps
+// the message as outside content; ours is framed as outside data too
+// (framing.ts).
+/** The JSON body for POST <hooks.path>/agent. */
+export function wakeBody(r) {
+    const body = {
+        message: r.message,
+        name: "Wakeshift",
+        sessionKey: r.sessionKey,
+        sessionMode: "persistent",
+        waitForCompletion: true,
+    };
+    if (r.agentId)
+        body.agentId = r.agentId;
+    if (r.route) {
+        body.channel = r.route.channel;
+        body.to = r.route.to;
+        if (r.route.accountId)
+            body.accountId = r.route.accountId;
+    }
+    else {
+        // No channel to answer on (a TUI or CLI session): the reply stays in
+        // the session's transcript, with no announcement in the main session.
+        body.deliver = false;
+    }
+    return body;
+}
+/** What an answer from OpenClaw means (status 0: the gateway couldn't be reached). */
+export function wakeResult(status, body, routed) {
+    const b = (body && typeof body === "object" ? body : {});
+    const err = typeof b.error === "string" ? b.error : typeof body === "string" ? body.slice(0, 200) : "";
+    if (status === 200) {
+        const s = b.completion?.status;
+        if (s === undefined || s === "ok")
+            return { kind: "ran" };
+        return { kind: "retry", fresh: true, why: `the woken turn ended ${String(s)}` };
+    }
+    switch (status) {
+        case 0:
+            return { kind: "broken", why: "the OpenClaw gateway's hooks endpoint couldn't be reached on this computer" };
+        case 401:
+            return { kind: "broken", why: "OpenClaw refused the hooks token (401): hooks.token changed since Wakeshift's plugin set it up" };
+        case 404:
+            return { kind: "broken", why: "OpenClaw's hooks endpoint isn't on (404): hooks.enabled is false, or hooks.path changed" };
+        case 400:
+            if (routed)
+                return { kind: "route", why: err || "the reply's channel was refused" };
+            return { kind: "broken", why: `OpenClaw refused the wake (400${err ? `: ${err}` : ""})` };
+        case 409:
+        case 408:
+        case 429:
+        case 502:
+        case 503:
+            // Busy, restarting, or throttled: nothing ran, or the replay key covers it.
+            return { kind: "retry", fresh: false, why: `OpenClaw answered ${status}${err ? ` (${err})` : ""}` };
+    }
+    return { kind: "retry", fresh: false, why: `OpenClaw answered ${status}` };
+}
+/** hooks.path as OpenClaw normalizes it: a leading slash, no trailing ones. */
+export function hooksPath(p) {
+    const s = typeof p === "string" && p.trim() ? p.trim() : "/hooks";
+    const out = ("/" + s.replace(/^\/+/, "")).replace(/\/+$/, "");
+    return out === "" ? "/hooks" : out;
+}

package/openclaw.plugin.json

@@ -0,0 +1,42 @@
+{
+  "id": "wakeshift",
+  "name": "Wakeshift",
+  "description": "Wakes OpenClaw sessions when an app they watch through Wakeshift sends something. Messages arrive as outside information, never as the user.",
+  "categories": [
+    "integrations"
+  ],
+  "contracts": {
+    "agentToolResultMiddleware": [
+      "openclaw",
+      "codex"
+    ]
+  },
+  "activation": {
+    "onStartup": true
+  },
+  "cliCommands": [
+    {
+      "name": "wakeshift",
+      "description": "Wakeshift's plugin: undo what it turned on (reset)",
+      "hasSubcommands": true
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "issuer": {
+        "type": "string",
+        "description": "The Wakeshift whose beacons the plugin trusts. Unset: Wakeshift's own service, https://app.wakeshift.ai; the install command for another Wakeshift sets it."
+      },
+      "allowNetworkHooks": {
+        "type": "boolean",
+        "description": "The user agreed to OpenClaw's hooks endpoint while the gateway listens beyond this computer (its bind isn't loopback): the hooks share its listener. Without it the plugin doesn't turn hooks on there. The install command sets it after the user's yes; openclaw wakeshift reset removes it."
+      },
+      "heartbeatTarget": {
+        "type": "string",
+        "description": "Unused: from the earlier heartbeat wake. A woken turn's reply now goes to the channel the conversation last spoke on."
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@wakeshift/openclaw",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.4.24",
+  "description": "Wakeshift for OpenClaw: wakes an OpenClaw session when an app it watches through Wakeshift sends something.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wakeshift/connectors.git",
+    "directory": "plugins/openclaw"
+  },
+  "homepage": "https://wakeshift.ai/docs/agents",
+  "bugs": {
+    "url": "https://github.com/wakeshift/connectors/issues"
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "wakeshift"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.10.4",
+      "minGatewayVersion": "2026.10.4"
+    },
+    "build": {
+      "openclawVersion": "2026.10.4"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}