@eclaw/openclaw-channel 1.2.7 → 1.3.0

package/dist/client.d.ts

@@ -16,11 +16,31 @@ export declare class EClawClient {
      *  If entityId is omitted, the backend auto-selects the first free slot.
      */
     bindEntity(entityId?: number, name?: string): Promise<BindResponse>;
-    /** Send bot message to user (updates own entity state on wallpaper) */
-    sendMessage(message: string, state?: string, mediaType?: string, mediaUrl?: string): Promise<MessageResponse>;
-    /** Send bot-to-bot message to another entity (speak-to) */
+    /**
+     * Send bot message — unified endpoint for status update + optional delivery.
+     *
+     * @param message - Text message (also used as delivery content)
+     * @param state - Entity state (IDLE, BUSY, etc.)
+     * @param opts.mediaType - Optional media type
+     * @param opts.mediaUrl - Optional media URL
+     * @param opts.speakTo - Array of target identifiers (entityId or publicCode) to deliver message to
+     * @param opts.broadcast - If true, deliver message to all other bound entities
+     */
+    sendMessage(message: string, state?: string, opts?: {
+        mediaType?: string;
+        mediaUrl?: string;
+        speakTo?: (string | number)[];
+        broadcast?: boolean;
+    }): Promise<MessageResponse>;
+    /**
+     * @deprecated Use sendMessage(text, state, { speakTo: [targetId] }) instead.
+     * Kept for backward compatibility — calls sendMessage internally.
+     */
     speakTo(toEntityId: number, text: string, expectsReply?: boolean): Promise<void>;
-    /** Broadcast message to all other bound entities */
+    /**
+     * @deprecated Use sendMessage(text, state, { broadcast: true }) instead.
+     * Kept for backward compatibility — calls sendMessage internally.
+     */
     broadcastToAll(text: string, expectsReply?: boolean): Promise<void>;
     /** Unregister callback on shutdown */
     unregisterCallback(): Promise<void>;

package/dist/client.js

@@ -63,8 +63,17 @@ export class EClawClient {
         this.entityId = data.entityId; // Use server-assigned slot
         return data;
     }
-    /** Send bot message to user (updates own entity state on wallpaper) */
-    async sendMessage(message, state = 'IDLE', mediaType, mediaUrl) {
+    /**
+     * Send bot message — unified endpoint for status update + optional delivery.
+     *
+     * @param message - Text message (also used as delivery content)
+     * @param state - Entity state (IDLE, BUSY, etc.)
+     * @param opts.mediaType - Optional media type
+     * @param opts.mediaUrl - Optional media URL
+     * @param opts.speakTo - Array of target identifiers (entityId or publicCode) to deliver message to
+     * @param opts.broadcast - If true, deliver message to all other bound entities
+     */
+    async sendMessage(message, state = 'IDLE', opts) {
         if (!this.deviceId || !this.botSecret) {
             throw new Error('Not bound — call bindEntity() first');
         }
@@ -78,46 +87,27 @@ export class EClawClient {
                 botSecret: this.botSecret,
                 message,
                 state,
-                ...(mediaType && { mediaType }),
-                ...(mediaUrl && { mediaUrl }),
+                ...(opts?.mediaType && { mediaType: opts.mediaType }),
+                ...(opts?.mediaUrl && { mediaUrl: opts.mediaUrl }),
+                ...(opts?.speakTo && { speakTo: opts.speakTo.map(String) }),
+                ...(opts?.broadcast && { broadcast: true }),
             }),
         });
         return await res.json();
     }
-    /** Send bot-to-bot message to another entity (speak-to) */
+    /**
+     * @deprecated Use sendMessage(text, state, { speakTo: [targetId] }) instead.
+     * Kept for backward compatibility — calls sendMessage internally.
+     */
     async speakTo(toEntityId, text, expectsReply = false) {
-        if (!this.deviceId || !this.botSecret) {
-            throw new Error('Not bound — call bindEntity() first');
-        }
-        await fetch(`${this.apiBase}/api/entity/speak-to`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                deviceId: this.deviceId,
-                fromEntityId: this.entityId,
-                toEntityId,
-                botSecret: this.botSecret,
-                text,
-                expects_reply: expectsReply,
-            }),
-        });
+        await this.sendMessage(text, 'IDLE', { speakTo: [String(toEntityId)] });
     }
-    /** Broadcast message to all other bound entities */
+    /**
+     * @deprecated Use sendMessage(text, state, { broadcast: true }) instead.
+     * Kept for backward compatibility — calls sendMessage internally.
+     */
     async broadcastToAll(text, expectsReply = false) {
-        if (!this.deviceId || !this.botSecret) {
-            throw new Error('Not bound — call bindEntity() first');
-        }
-        await fetch(`${this.apiBase}/api/entity/broadcast`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                deviceId: this.deviceId,
-                fromEntityId: this.entityId,
-                botSecret: this.botSecret,
-                text,
-                expects_reply: expectsReply,
-            }),
-        });
+        await this.sendMessage(text, 'IDLE', { broadcast: true });
     }
     /** Unregister callback on shutdown */
     async unregisterCallback() {

package/dist/outbound.js

@@ -59,7 +59,7 @@ export async function sendMedia(ctx) {
         const mediaType = ctx.mediaType === 'image' ? 'photo'
             : ctx.mediaType === 'audio' ? 'voice'
                 : ctx.mediaType ?? 'file';
-        const result = await client.sendMessage(ctx.text || `[${mediaType}]`, 'IDLE', mediaType, ctx.mediaUrl);
+        const result = await client.sendMessage(ctx.text || `[${mediaType}]`, 'IDLE', { mediaType, mediaUrl: ctx.mediaUrl });
         return {
             channel: 'eclaw',
             messageId: `eclaw-${Date.now()}`,

package/dist/types.d.ts

@@ -17,7 +17,7 @@ export interface EClawContext {
 }
 /** Inbound message from E-Claw callback webhook */
 export interface EClawInboundMessage {
-    event: 'message' | 'entity_message' | 'broadcast' | 'cross_device_message';
+    event: 'message' | 'entity_message' | 'broadcast' | 'cross_device_message' | 'kanban_notification';
     deviceId: string;
     entityId: number;
     conversationId: string;

package/dist/webhook-handler.d.ts

@@ -3,14 +3,14 @@
  *
  * Handles three event types:
  *   - 'message'        → Normal human message; reply via sendMessage()
- *   - 'entity_message' → Bot-to-bot speak-to; reply via sendMessage() + speakTo(fromEntityId)
- *   - 'broadcast'      → Broadcast from another entity; reply via sendMessage() + speakTo(fromEntityId)
+ *   - 'entity_message' → Bot-to-bot speak-to; reply via sendMessage(text, state, { speakTo })
+ *   - 'broadcast'      → Broadcast from another entity; reply via sendMessage(text, state, { speakTo })
  *
  * The `deliver` callback routes AI response to the correct E-Claw endpoint
  * based on the inbound event type.
  *
- * Channel Bot Context Parity v1.0.17:
- *   - Bot-to-bot / broadcast now calls sendMessage() to update own wallpaper AND speakTo() to reply
+ * Channel Bot Context Parity v1.0.17+:
+ *   - Bot-to-bot / broadcast uses unified sendMessage() with speakTo option (single API call)
  *   - Quota awareness via eclaw_context.b2bRemaining / b2bMax
  *   - Mission context via eclaw_context.missionHints
  *   - Silent suppression via silentToken (default "[SILENT]")

package/dist/webhook-handler.js

@@ -5,14 +5,14 @@ import { getClient, setActiveEvent, clearActiveEvent } from './outbound.js';
  *
  * Handles three event types:
  *   - 'message'        → Normal human message; reply via sendMessage()
- *   - 'entity_message' → Bot-to-bot speak-to; reply via sendMessage() + speakTo(fromEntityId)
- *   - 'broadcast'      → Broadcast from another entity; reply via sendMessage() + speakTo(fromEntityId)
+ *   - 'entity_message' → Bot-to-bot speak-to; reply via sendMessage(text, state, { speakTo })
+ *   - 'broadcast'      → Broadcast from another entity; reply via sendMessage(text, state, { speakTo })
  *
  * The `deliver` callback routes AI response to the correct E-Claw endpoint
  * based on the inbound event type.
  *
- * Channel Bot Context Parity v1.0.17:
- *   - Bot-to-bot / broadcast now calls sendMessage() to update own wallpaper AND speakTo() to reply
+ * Channel Bot Context Parity v1.0.17+:
+ *   - Bot-to-bot / broadcast uses unified sendMessage() with speakTo option (single API call)
  *   - Quota awareness via eclaw_context.b2bRemaining / b2bMax
  *   - Mission context via eclaw_context.missionHints
  *   - Silent suppression via silentToken (default "[SILENT]")
@@ -50,7 +50,18 @@ cfg // full openclaw config (ctx.cfg from startAccount)
                         : msg.mediaType ? 'file'
                             : undefined;
             // Build body — enrich with event context for bot-to-bot and broadcast
+            // Append media URL to body so text-based agents can see/analyze images
             let body = msg.text || '';
+            if (msg.mediaUrl && msg.mediaType) {
+                const mediaLabel = msg.mediaType === 'photo' ? 'Image'
+                    : msg.mediaType === 'voice' ? 'Voice'
+                        : msg.mediaType === 'video' ? 'Video'
+                            : 'File';
+                const urlToAppend = msg.backupUrl || msg.mediaUrl;
+                body = body
+                    ? `${body}\n[${mediaLabel}: ${urlToAppend}]`
+                    : `[${mediaLabel}: ${urlToAppend}]`;
+            }
             if ((event === 'entity_message' || event === 'broadcast') && fromEntityId !== undefined) {
                 const senderLabel = fromCharacter
                     ? `Entity ${fromEntityId} (${fromCharacter})`
@@ -66,6 +77,12 @@ cfg // full openclaw config (ctx.cfg from startAccount)
                     .filter(Boolean)
                     .join('\n');
             }
+            else if (event === 'kanban_notification') {
+                // Kanban notifications: merge missionHints into body so channel bots
+                // can see available API tools (same as webhook path gets them inline)
+                const missionBlock = eclawCtx?.missionHints ?? '';
+                body = [msg.text || '', missionBlock].filter(Boolean).join('\n');
+            }
             // Build context in OpenClaw's native PascalCase format
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const inboundCtx = {
@@ -103,9 +120,8 @@ cfg // full openclaw config (ctx.cfg from startAccount)
                             if (!text || text === silentToken)
                                 return;
                             if ((event === 'entity_message' || event === 'broadcast') && fromEntityId !== undefined) {
-                                // Bot-to-bot / broadcast: update own wallpaper AND reply to sender
-                                await client.sendMessage(text, 'IDLE');
-                                await client.speakTo(fromEntityId, text, false);
+                                // Bot-to-bot / broadcast: update wallpaper + deliver reply in one API call
+                                await client.sendMessage(text, 'IDLE', { speakTo: [String(fromEntityId)] });
                             }
                             else {
                                 // Normal human message: reply via channel message
@@ -118,7 +134,7 @@ cfg // full openclaw config (ctx.cfg from startAccount)
                                         : rawType === 'audio' ? 'voice'
                                             : rawType === 'video' ? 'video'
                                                 : 'file';
-                                    await client.sendMessage('', 'IDLE', mediaType, payload.mediaUrl);
+                                    await client.sendMessage('', 'IDLE', { mediaType, mediaUrl: payload.mediaUrl });
                                 }
                             }
                         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eclaw/openclaw-channel",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "description": "E-Claw channel plugin for OpenClaw — AI chat platform for live wallpaper entities",
   "type": "module",
   "main": "./dist/index.js",