@botcord/daemon 0.2.60 → 0.2.61

package/dist/gateway/channels/botcord.d.ts

@@ -23,6 +23,13 @@ export interface BotCordChannelClient {
         hub_msg_id?: string;
         message_id?: string;
     } & Record<string, unknown>>;
+    sendTypedMessage?(to: string, type: "result" | "error", text: string, options?: {
+        replyTo?: string;
+        topic?: string;
+    }): Promise<{
+        hub_msg_id?: string;
+        message_id?: string;
+    } & Record<string, unknown>>;
     getHubUrl(): string;
     onTokenRefresh?: (token: string, expiresAt: number) => void;
 }

package/dist/gateway/channels/botcord.js

@@ -674,7 +674,9 @@ export function createBotCordChannel(options) {
                 options.replyTo = message.replyTo;
             if (message.threadId)
                 options.topic = message.threadId;
-            const resp = await client.sendMessage(message.conversationId, message.text, options);
+            const resp = message.type === "error" && client.sendTypedMessage
+                ? await client.sendTypedMessage(message.conversationId, "error", message.text, options)
+                : await client.sendMessage(message.conversationId, message.text, options);
             const providerMessageId = (resp && typeof resp.hub_msg_id === "string" && resp.hub_msg_id) ||
                 (resp && typeof resp.message_id === "string"
                     ? resp.message_id

package/dist/gateway/dispatcher.js

@@ -1022,6 +1022,7 @@ export class Dispatcher {
                         accountId: msg.accountId,
                         conversationId: msg.conversation.id,
                         threadId: msg.conversation.threadId ?? null,
+                        type: "error",
                         text: `⚠️ Runtime timeout after ${Math.round(this.turnTimeoutMs / 60000)} minute(s); aborted`,
                         replyTo: msg.id,
                         traceId: msg.trace?.id ?? null,
@@ -1067,6 +1068,7 @@ export class Dispatcher {
                         accountId: msg.accountId,
                         conversationId: msg.conversation.id,
                         threadId: msg.conversation.threadId ?? null,
+                        type: "error",
                         text: `⚠️ Runtime error: ${truncate(errMsg, 500)}`,
                         replyTo: msg.id,
                         traceId: msg.trace?.id ?? null,
@@ -1157,6 +1159,7 @@ export class Dispatcher {
                             accountId: msg.accountId,
                             conversationId: msg.conversation.id,
                             threadId: msg.conversation.threadId ?? null,
+                            type: "error",
                             text: `⚠️ Runtime error: ${truncate(result.error, 500)}`,
                             replyTo: msg.id,
                             traceId: msg.trace?.id ?? null,

package/dist/gateway/types.d.ts

@@ -154,6 +154,7 @@ export interface GatewayOutboundMessage {
     accountId: string;
     conversationId: string;
     threadId?: string | null;
+    type?: "message" | "error";
     text: string;
     attachments?: GatewayOutboundAttachment[];
     replyTo?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botcord/daemon",
-  "version": "0.2.60",
+  "version": "0.2.61",
   "description": "BotCord local daemon — bridges Hub inbox push to local Claude Code / Codex / Gemini CLIs",
   "type": "module",
   "bin": {

package/src/gateway/__tests__/botcord-channel.test.ts

@@ -27,6 +27,9 @@ function makeClient(overrides: Partial<BotCordChannelClient> = {}): BotCordChann
     sendMessage: vi
       .fn()
       .mockResolvedValue({ hub_msg_id: "m_provider", queued: true, status: "queued" }),
+    sendTypedMessage: vi
+      .fn()
+      .mockResolvedValue({ hub_msg_id: "m_provider_typed", queued: true, status: "queued" }),
     getHubUrl: vi.fn().mockReturnValue("http://127.0.0.1:1"),
     ...overrides,
   };
@@ -138,6 +141,34 @@ describe("createBotCordChannel — send()", () => {
     expect(client.sendMessage).toHaveBeenCalledWith("rm_dm_1", "hey", {});
     expect(result.providerMessageId).toBeNull();
   });
+
+  it("sends runtime diagnostics as BotCord error envelopes", async () => {
+    const client = makeClient();
+    const channel = createBotCordChannel({
+      id: "botcord-main",
+      accountId: "ag_self",
+      agentId: "ag_self",
+      client,
+    });
+    const result = await channel.send({
+      message: {
+        channel: "botcord",
+        accountId: "ag_self",
+        conversationId: "rm_group_a",
+        threadId: "tp_42",
+        replyTo: "env_source",
+        type: "error",
+        text: "Runtime error: boom",
+      },
+      log: silentLog,
+    });
+    expect(client.sendTypedMessage).toHaveBeenCalledWith("rm_group_a", "error", "Runtime error: boom", {
+      topic: "tp_42",
+      replyTo: "env_source",
+    });
+    expect(client.sendMessage).not.toHaveBeenCalled();
+    expect(result.providerMessageId).toBe("m_provider_typed");
+  });
 });
 
 // ---------------------------------------------------------------------------
@@ -263,6 +294,52 @@ describe("createBotCordChannel — inbox normalization", () => {
     }
   });
 
+  it("acks error InboxMessages without dispatching them", async () => {
+    const server = await startAuthOkServer();
+    const errorMessage = makeInbox({
+      hub_msg_id: "m_error_1",
+      text: undefined,
+      envelope: {
+        type: "error",
+        from: "ag_peer",
+        payload: { error: { code: "agent_error", message: "Runtime error: boom" } },
+      } as InboxMessage["envelope"],
+    });
+    const client = makeClient({
+      pollInbox: vi.fn().mockResolvedValue({ messages: [errorMessage], count: 1, has_more: false }),
+      getHubUrl: vi.fn().mockReturnValue(server.url),
+    });
+    const channel = createBotCordChannel({
+      id: "botcord-main",
+      accountId: "ag_self",
+      agentId: "ag_self",
+      client,
+      hubBaseUrl: server.url,
+    });
+    const abort = new AbortController();
+    const emits: GatewayInboundEnvelope[] = [];
+    const startPromise = channel.start({
+      config: stubConfig,
+      accountId: "ag_self",
+      abortSignal: abort.signal,
+      log: silentLog,
+      emit: async (env) => {
+        emits.push(env);
+      },
+      setStatus: () => {},
+    });
+    try {
+      await vi.waitFor(() => {
+        expect(client.ackMessages).toHaveBeenCalledWith(["m_error_1"]);
+      });
+      expect(emits).toHaveLength(0);
+    } finally {
+      abort.abort();
+      await startPromise;
+      await server.close();
+    }
+  });
+
   it("marks rm_dm_ and rm_oc_ rooms as direct; rm_oc_ also sets streamable + user-kind", async () => {
     const { emits, server } = await startWithInbox([
       makeInbox({

package/src/gateway/__tests__/dispatcher.test.ts

@@ -492,6 +492,7 @@ describe("Dispatcher", () => {
     await dispatcher.handle(makeEnvelope({ id: "msg_error" }));
 
     expect(channel.sends.length).toBe(1);
+    expect(channel.sends[0].message.type).toBe("error");
     expect(channel.sends[0].message.text).toContain("Runtime error");
     expect(channel.sends[0].message.text).toContain("missing openclawAgent");
   });
@@ -1256,6 +1257,7 @@ describe("Dispatcher", () => {
 
     await dispatcher.handle(makeEnvelope({ id: "m1" }));
     expect(channel.sends.length).toBe(1);
+    expect(channel.sends[0].message.type).toBe("error");
     expect(channel.sends[0].message.text).toContain("Runtime error");
     expect(channel.sends[0].message.text).toContain("boom");
     expect(store.all().length).toBe(0);
@@ -1921,6 +1923,7 @@ describe("Dispatcher", () => {
       await p;
       expect(runtime.calls[0].signal.aborted).toBe(true);
       expect(channel.sends.length).toBe(1);
+      expect(channel.sends[0].message.type).toBe("error");
       expect(channel.sends[0].message.text).toMatch(/Runtime timeout/);
       expect(channel.sends[0].message.conversationId).toBe("rm_g_other");
       expect(channel.sends[0].message.replyTo).toBe("m_to");
@@ -1941,6 +1944,7 @@ describe("Dispatcher", () => {
       }),
     );
     expect(channel.sends.length).toBe(1);
+    expect(channel.sends[0].message.type).toBe("error");
     expect(channel.sends[0].message.text).toContain("Runtime error: boom");
     expect(channel.sends[0].message.conversationId).toBe("rm_g_other");
     expect(channel.sends[0].message.replyTo).toBe("m_err");

package/src/gateway/channels/botcord.ts

@@ -55,6 +55,12 @@ export interface BotCordChannelClient {
     text: string,
     options?: { replyTo?: string; topic?: string },
   ): Promise<{ hub_msg_id?: string; message_id?: string } & Record<string, unknown>>;
+  sendTypedMessage?(
+    to: string,
+    type: "result" | "error",
+    text: string,
+    options?: { replyTo?: string; topic?: string },
+  ): Promise<{ hub_msg_id?: string; message_id?: string } & Record<string, unknown>>;
   getHubUrl(): string;
   onTokenRefresh?: (token: string, expiresAt: number) => void;
 }
@@ -804,7 +810,10 @@ export function createBotCordChannel(options: BotCordChannelOptions): ChannelAda
       const options: { replyTo?: string; topic?: string } = {};
       if (message.replyTo) options.replyTo = message.replyTo;
       if (message.threadId) options.topic = message.threadId;
-      const resp = await client.sendMessage(message.conversationId, message.text, options);
+      const resp =
+        message.type === "error" && client.sendTypedMessage
+          ? await client.sendTypedMessage(message.conversationId, "error", message.text, options)
+          : await client.sendMessage(message.conversationId, message.text, options);
       const providerMessageId =
         (resp && typeof resp.hub_msg_id === "string" && resp.hub_msg_id) ||
         (resp && typeof (resp as { message_id?: unknown }).message_id === "string"

package/src/gateway/dispatcher.ts

@@ -1264,6 +1264,7 @@ export class Dispatcher {
             accountId: msg.accountId,
             conversationId: msg.conversation.id,
             threadId: msg.conversation.threadId ?? null,
+            type: "error",
             text: `⚠️ Runtime timeout after ${Math.round(this.turnTimeoutMs / 60000)} minute(s); aborted`,
             replyTo: msg.id,
             traceId: msg.trace?.id ?? null,
@@ -1309,6 +1310,7 @@ export class Dispatcher {
             accountId: msg.accountId,
             conversationId: msg.conversation.id,
             threadId: msg.conversation.threadId ?? null,
+            type: "error",
             text: `⚠️ Runtime error: ${truncate(errMsg, 500)}`,
             replyTo: msg.id,
             traceId: msg.trace?.id ?? null,
@@ -1398,6 +1400,7 @@ export class Dispatcher {
               accountId: msg.accountId,
               conversationId: msg.conversation.id,
               threadId: msg.conversation.threadId ?? null,
+              type: "error",
               text: `⚠️ Runtime error: ${truncate(result.error, 500)}`,
               replyTo: msg.id,
               traceId: msg.trace?.id ?? null,

package/src/gateway/types.ts

@@ -187,6 +187,7 @@ export interface GatewayOutboundMessage {
   accountId: string;
   conversationId: string;
   threadId?: string | null;
+  type?: "message" | "error";
   text: string;
   attachments?: GatewayOutboundAttachment[];
   replyTo?: string | null;