hyperstack-core 1.1.0 → 1.2.0

package/adapters/openclaw.js

@@ -203,6 +203,52 @@ function createOpenClawAdapter(opts = {}) {
      * Hook: called when agent session starts.
      * Registers the agent and loads relevant context.
      */
+      /**
+       * Check for cards directed at this agent from other agents.
+       * Enables cross-agent coordination via shared memory.
+       */
+      async hs_inbox({ since } = {}) {
+        const result = await client.inbox({ since });
+        const cards = result.cards || [];
+        if (!cards.length) {
+          return { text: `No messages for agent "${agentId}".`, cards: [] };
+        }
+        return {
+          text: `${cards.length} message(s) for "${agentId}":\n` +
+            cards.map(c => `  [${c.slug}] ${c.title}${c.body ? `\n    ${c.body.slice(0, 150)}` : ""}`).join("\n"),
+          cards,
+        };
+      },
+
+      /**
+       * Register a webhook for real-time notifications. Requires Team plan.
+       */
+      async hs_webhook({ url, events, secret } = {}) {
+        if (!url) return { text: "Error: url required" };
+        const result = await client.registerWebhook({
+          url,
+          events: events ? events.split(",").map(e => e.trim()) : ["*"],
+          secret,
+        });
+        if (result.error) return { text: `Webhook error: ${result.error}` };
+        return { text: `Webhook registered for agent "${agentId}".\nURL: ${url}\nID: ${result.id}` };
+      },
+
+      /**
+       * List all registered webhooks for this account.
+       */
+      async hs_webhooks() {
+        const result = await client.listWebhooks();
+        const hooks = result.webhooks || [];
+        if (!hooks.length) return { text: "No webhooks registered." };
+        return {
+          text: `${hooks.length} webhook(s):\n` +
+            hooks.map(h => `  [${h.agentId}] ${h.url} — events: ${h.events.join(", ")}`).join("\n"),
+          hooks,
+        };
+      },
+    },
+
     async onSessionStart({ agentName, agentRole }) {
       // Register this agent in the graph
       await client.registerAgent({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperstack-core",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Typed graph memory for AI agents. Replace GOALS.md with queryable cards + relations. Works with OpenClaw, Claude Desktop, Cursor.",
   "type": "module",
   "main": "index.js",

package/src/client.js

@@ -253,6 +253,48 @@ class HyperStackClient {
    * @param {string} agent.role — what this agent does
    * @param {string[]} [agent.owns] — slugs this agent owns
    */
+  /**
+   * Check for cards directed at this agent by other agents.
+   * Enables cross-agent coordination via shared memory.
+   * @param {object} [opts]
+   * @param {string} [opts.since] — ISO timestamp, only cards after this time
+   * @returns {Promise<{cards: Array}>}
+   */
+  async inbox(opts = {}) {
+    const agentId = this.agentId;
+    if (!agentId) throw new Error("agentId required for inbox");
+    let url = `/api/cards?workspace=${this.workspace}&targetAgent=${agentId}`;
+    if (opts.since) url += `&since=${encodeURIComponent(opts.since)}`;
+    return this._request("GET", url);
+  }
+
+  /**
+   * Register a webhook to receive real-time notifications.
+   * Agent gets notified when cards are directed at it. Requires Team plan.
+   * @param {object} webhook
+   * @param {string} webhook.url — URL to receive POST events
+   * @param {string[]} [webhook.events] — events to listen for (default: all)
+   * @param {string} [webhook.secret] — HMAC secret for signature verification
+   * @returns {Promise<{id: string}>}
+   */
+  async registerWebhook(webhook) {
+    return this._request("POST", `/api/agent-webhooks`, {
+      agentId: this.agentId,
+      url: webhook.url,
+      events: webhook.events || ["*"],
+      workspace: this.workspace,
+      secret: webhook.secret || undefined,
+    });
+  }
+
+  /**
+   * List all registered webhooks for this account.
+   * @returns {Promise<{webhooks: Array}>}
+   */
+  async listWebhooks() {
+    return this._request("GET", `/api/agent-webhooks`);
+  }
+
   async registerAgent(agent) {
     const links = [];
     if (agent.owns) {