@folotoy/folotoy-openclaw-plugin 0.1.2 → 0.2.0

package/README.md

@@ -86,25 +86,46 @@ password: {toy_key}
 {
   "msgId": 1,
   "identifier": "chat_input",
-  "outParams": {
-    "text": "hello"
+  "inputParams": {
+    "text": "hello",
+    "recording_id": 100
   }
 }
 ```
 
 **Plugin → Toy (outbound)**
 
+Multiple response chunks with auto-incrementing `order`, followed by a finish message:
+
+```json
+{
+  "msgId": 1,
+  "identifier": "chat_output",
+  "outParams": {
+    "content": "hello",
+    "recording_id": 100,
+    "order": 1,
+    "is_finished": false
+  }
+}
+```
+
+Finish message (`is_finished: true`, empty content):
+
 ```json
 {
   "msgId": 1,
   "identifier": "chat_output",
   "outParams": {
-    "content": "hello"
+    "content": "",
+    "recording_id": 100,
+    "order": 2,
+    "is_finished": true
   }
 }
 ```
 
-`msgId` starts at 1 per session and auto-increments.
+`msgId` starts at 1 per session and auto-increments. `recording_id` is passed through from the inbound message.
 
 ## Environments
 

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "folotoy-openclaw-plugin",
   "name": "FoloToy",
   "description": "Empower your FoloToy with OpenClaw AI capabilities.",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "channels": ["folotoy"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@folotoy/folotoy-openclaw-plugin",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Empower your FoloToy with OpenClaw AI capabilities.",
   "keywords": [
     "folotoy",

package/src/__tests__/channel.test.ts

@@ -6,13 +6,13 @@ import { buildInboundTopic, buildOutboundTopic } from '../mqtt.js'
 type InboundMessage = {
   msgId: number
   identifier: 'chat_input'
-  outParams: { text: string }
+  inputParams: { text: string; recording_id: number }
 }
 
 type OutboundMessage = {
   msgId: number
   identifier: 'chat_output'
-  outParams: { content: string }
+  outParams: { content: string; recording_id: number; order: number; is_finished: boolean }
 }
 
 function makeMockClient() {
@@ -23,15 +23,15 @@ function makeMockClient() {
   })
 }
 
-function setupSubscriber(client: ReturnType<typeof makeMockClient>, toy_sn: string, onMessage: (msgId: number, text: string) => void) {
+function setupSubscriber(client: ReturnType<typeof makeMockClient>, toy_sn: string, onMessage: (msgId: number, text: string, recording_id: number) => void) {
   const topic = buildInboundTopic(toy_sn)
   client.subscribe(topic, () => {})
   client.on('message', (_topic: string, payload: Buffer) => {
     if (_topic !== topic) return
     try {
       const msg = JSON.parse(payload.toString()) as InboundMessage
-      if (msg.identifier !== 'chat_input' || typeof msg.outParams?.text !== 'string') return
-      onMessage(msg.msgId, msg.outParams.text)
+      if (msg.identifier !== 'chat_input' || typeof msg.inputParams?.text !== 'string') return
+      onMessage(msg.msgId, msg.inputParams.text, msg.inputParams.recording_id)
     } catch {
       // ignore
     }
@@ -42,15 +42,15 @@ describe('inbound message parsing', () => {
   const toy_sn = 'SN001'
   const inboundTopic = buildInboundTopic(toy_sn)
 
-  it('calls onMessage with msgId and text on valid chat_input', () => {
+  it('calls onMessage with msgId, text and recording_id on valid chat_input', () => {
     const client = makeMockClient()
     const onMessage = vi.fn()
     setupSubscriber(client, toy_sn, onMessage)
 
-    const msg: InboundMessage = { msgId: 42, identifier: 'chat_input', outParams: { text: 'hello' } }
+    const msg: InboundMessage = { msgId: 42, identifier: 'chat_input', inputParams: { text: 'hello', recording_id: 100 } }
     client.emit('message', inboundTopic, Buffer.from(JSON.stringify(msg)))
 
-    expect(onMessage).toHaveBeenCalledWith(42, 'hello')
+    expect(onMessage).toHaveBeenCalledWith(42, 'hello', 100)
   })
 
   it('ignores messages on other topics', () => {
@@ -58,7 +58,7 @@ describe('inbound message parsing', () => {
     const onMessage = vi.fn()
     setupSubscriber(client, toy_sn, onMessage)
 
-    const msg: InboundMessage = { msgId: 1, identifier: 'chat_input', outParams: { text: 'hi' } }
+    const msg: InboundMessage = { msgId: 1, identifier: 'chat_input', inputParams: { text: 'hi', recording_id: 1 } }
     client.emit('message', '/openapi/folotoy/OTHER/thing/command/call', Buffer.from(JSON.stringify(msg)))
 
     expect(onMessage).not.toHaveBeenCalled()
@@ -69,7 +69,7 @@ describe('inbound message parsing', () => {
     const onMessage = vi.fn()
     setupSubscriber(client, toy_sn, onMessage)
 
-    client.emit('message', inboundTopic, Buffer.from(JSON.stringify({ msgId: 1, identifier: 'other', outParams: { text: 'hi' } })))
+    client.emit('message', inboundTopic, Buffer.from(JSON.stringify({ msgId: 1, identifier: 'other', inputParams: { text: 'hi', recording_id: 1 } })))
 
     expect(onMessage).not.toHaveBeenCalled()
   })
@@ -89,20 +89,38 @@ describe('outbound message format', () => {
   const toy_sn = 'SN001'
   const outboundTopic = buildOutboundTopic(toy_sn)
 
-  it('publishes chat_output with correct msgId and content', () => {
+  it('publishes chat_output with recording_id, order and is_finished', () => {
     const client = makeMockClient()
-    const msgId = 42
-    const content = 'world'
     const outMsg: OutboundMessage = {
-      msgId,
+      msgId: 42,
       identifier: 'chat_output',
-      outParams: { content },
+      outParams: { content: 'world', recording_id: 100, order: 1, is_finished: false },
     }
     client.publish(outboundTopic, JSON.stringify(outMsg))
 
     expect(client.publish).toHaveBeenCalledOnce()
     const [t, payload] = client.publish.mock.calls[0] as [string, string]
     expect(t).toBe(outboundTopic)
-    expect(JSON.parse(payload)).toEqual({ msgId: 42, identifier: 'chat_output', outParams: { content: 'world' } })
+    expect(JSON.parse(payload)).toEqual({
+      msgId: 42,
+      identifier: 'chat_output',
+      outParams: { content: 'world', recording_id: 100, order: 1, is_finished: false },
+    })
+  })
+
+  it('publishes finish message with is_finished=true', () => {
+    const client = makeMockClient()
+    const finishMsg: OutboundMessage = {
+      msgId: 42,
+      identifier: 'chat_output',
+      outParams: { content: '', recording_id: 100, order: 2, is_finished: true },
+    }
+    client.publish(outboundTopic, JSON.stringify(finishMsg))
+
+    const [, payload] = client.publish.mock.calls[0] as [string, string]
+    const parsed = JSON.parse(payload)
+    expect(parsed.outParams.is_finished).toBe(true)
+    expect(parsed.outParams.order).toBe(2)
+    expect(parsed.outParams.content).toBe('')
   })
 })

package/src/index.ts

@@ -7,13 +7,13 @@ import type { MqttClient } from 'mqtt'
 type InboundMessage = {
   msgId: number
   identifier: 'chat_input'
-  outParams: { text: string }
+  inputParams: { text: string; recording_id: number }
 }
 
 type OutboundMessage = {
   msgId: number
   identifier: 'chat_output'
-  outParams: { content: string }
+  outParams: { content: string; recording_id: number; order: number; is_finished: boolean }
 }
 
 // Per-account MQTT clients and msgId counters
@@ -100,9 +100,10 @@ const folotoyChannel: ChannelPlugin<FlatChannelConfig> = {
         } catch {
           return
         }
-        if (msg.identifier !== 'chat_input' || typeof msg.outParams?.text !== 'string') return
+        if (msg.identifier !== 'chat_input' || typeof msg.inputParams?.text !== 'string') return
 
-        const { msgId, outParams: { text } } = msg
+        const { msgId, inputParams: { text, recording_id } } = msg
+        let order = 0
 
         const inboundCtx = channelRuntime.reply.finalizeInboundContext({
           Body: text,
@@ -113,23 +114,36 @@ const folotoyChannel: ChannelPlugin<FlatChannelConfig> = {
           Provider: 'folotoy',
         })
 
-        // fire-and-forget: OpenClaw handles queuing internally
-        void channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
-          ctx: inboundCtx,
-          cfg,
-          dispatcherOptions: {
-            deliver: async (replyPayload) => {
-              if (!replyPayload.text) return
-              const outMsg: OutboundMessage = {
-                msgId,
-                identifier: 'chat_output',
-                outParams: { content: replyPayload.text },
-              }
-              client.publish(outboundTopic, JSON.stringify(outMsg))
-            },
-            onError: (err) => log?.error?.(`Dispatch error: ${String(err)}`),
-          },
-        })
+        // dispatch and send finish message when done
+        void (async () => {
+          try {
+            await channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
+              ctx: inboundCtx,
+              cfg,
+              dispatcherOptions: {
+                deliver: async (replyPayload) => {
+                  if (!replyPayload.text) return
+                  order++
+                  const outMsg: OutboundMessage = {
+                    msgId,
+                    identifier: 'chat_output',
+                    outParams: { content: replyPayload.text, recording_id, order, is_finished: false },
+                  }
+                  client.publish(outboundTopic, JSON.stringify(outMsg))
+                },
+                onError: (err) => log?.error?.(`Dispatch error: ${String(err)}`),
+              },
+            })
+          } finally {
+            order++
+            const finishMsg: OutboundMessage = {
+              msgId,
+              identifier: 'chat_output',
+              outParams: { content: '', recording_id, order, is_finished: true },
+            }
+            client.publish(outboundTopic, JSON.stringify(finishMsg))
+          }
+        })()
       })
 
       // Keep the account alive until aborted

package/src/mqtt.ts

@@ -57,7 +57,9 @@ export async function createMqttClient(config: PluginConfig, credentials: MqttCr
   const { username, password } = credentials
 
   return new Promise((resolve, reject) => {
+    const clientId = `openapi:${username}`
     const client = mqtt.connect(`mqtt://${host}:${port}`, {
+      clientId,
       username: `openapi:${username}`,
       password,
       clean: true,