@agentchatme/openclaw 0.6.15 → 0.6.17

package/CHANGELOG.md

@@ -7,6 +7,20 @@ this package adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 This package is in pre-1.0 development.
 
+## 0.6.17 — 2026-04-29
+
+- Group chat: closed the same `recordInboundSession` gap that broke direct DMs in 0.6.13. Group inbound dispatch was building the PascalCase `MsgContext` correctly (so it never fired the "I didn't receive any text" canned reply), but it was calling `dispatchReplyWithBufferedBlockDispatcher` directly without first calling `recordInboundSession` — which left the group session at `sessionId=unknown state=processing` until the health monitor restarted the WS, killing the in-flight LLM call. The group path now mirrors the direct-DM helper's full chain (`resolveInboundRouteEnvelopeBuilderWithRuntime` → `finalizeInboundContext` → `recordInboundSessionAndDispatchReply`) using the same kind-agnostic plugin-sdk helpers — group dispatches are now byte-equivalent to what direct DMs do, only `peer.kind` and `ChatType` differ.
+- Tests: regression guard in `tests/binding/inbound-bridge.test.ts` asserts both the dispatcher AND `recordInboundSession` fire on a group inbound. If either ever skips again the test fails loud.
+
+## 0.6.16 — 2026-04-29
+
+- WebSocket heartbeat tuned to industry-standard cadence: `ping.intervalMs` default 30000 → 45000, `ping.timeoutMs` default 10000 → 30000 (max raised 30000 → 60000). Telegram-class posture (Telegram is 30s ping / 75s timeout; Discord ~41s/60s). The previous 30s/10s combination was too aggressive for cross-region paths (e.g. agent on a remote VPS → AgentChat API on Fly Anycast), where load-balancer hops + transient packet loss could push pong RTT above 10s and trigger spurious `1001 Heartbeat timeout` closes every 1–3 minutes — interrupting in-flight inbound dispatches before the LLM could reply.
+
+## 0.6.13 — 2026-04-29 · 0.6.14 — 2026-04-29 · 0.6.15 — 2026-04-29
+
+- Inbound dispatch: switched direct-DM path to OpenClaw's `dispatchInboundDirectDmWithRuntime` helper (chains `routing.resolveAgentRoute → session.recordInboundSession → reply.dispatchReplyWithBufferedBlockDispatcher`). Earlier path constructed `MsgContext` with camelCase field names and never called `recordInboundSession`, so OpenClaw's reply pipeline either dropped the message ("I didn't receive any text") or got stuck at `state=processing` until the health monitor force-reconnected the WS.
+- Channel lifecycle: `startAccount` now ends with `await waitUntilAbort(ctx.abortSignal)` so OpenClaw's task runner doesn't see the channel task resolve immediately and treat it as "channel exited" → auto-restart loop. The earlier behaviour caused READY → DRAINING → CONNECTING flap every 1–3 minutes.
+
 ## 0.6.12 — 2026-04-28
 
 - Wizard: handle prompt headline restored to "Choose a handle (your @name on AgentChat)"; the format rules moved to the gray placeholder text inside the input box.

package/dist/index.cjs

@@ -11,6 +11,8 @@ var channelLifecycle = require('openclaw/plugin-sdk/channel-lifecycle');
 var pino = require('pino');
 var ws = require('ws');
 var directDm = require('openclaw/plugin-sdk/direct-dm');
+var inboundEnvelope = require('openclaw/plugin-sdk/inbound-envelope');
+var inboundReplyDispatch = require('openclaw/plugin-sdk/inbound-reply-dispatch');
 var agentchat = require('@agentchatme/agentchat');
 var typebox = require('@sinclair/typebox');
 
@@ -868,8 +870,8 @@ var reconnectConfigSchema = zod.z.object({
   jitterRatio: zod.z.number().min(0).max(1).default(0.2)
 }).strict();
 var pingConfigSchema = zod.z.object({
-  intervalMs: zod.z.number().int().min(5e3).max(12e4).default(3e4),
-  timeoutMs: zod.z.number().int().min(1e3).max(3e4).default(1e4)
+  intervalMs: zod.z.number().int().min(5e3).max(12e4).default(45e3),
+  timeoutMs: zod.z.number().int().min(1e3).max(6e4).default(3e4)
 }).strict();
 var outboundConfigSchema = zod.z.object({
   maxInFlight: zod.z.number().int().min(1).max(1e4).default(256),
@@ -1863,7 +1865,7 @@ var CircuitBreaker = class {
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "0.6.15";
+var PACKAGE_VERSION = "0.6.17";
 
 // src/outbound.ts
 var DEFAULT_RETRY_POLICY = {
@@ -2495,31 +2497,70 @@ async function handleMessage(deps, event) {
         }
       });
     } else {
-      const dispatcher = channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher;
-      const sessionKey = `agentchat:${deps.accountId}:group:${event.conversationId}`;
-      await dispatcher({
+      const ts = typeof event.createdAt === "number" ? event.createdAt : Date.parse(event.createdAt);
+      const runtime = channelRuntime;
+      const { route, buildEnvelope } = inboundEnvelope.resolveInboundRouteEnvelopeBuilderWithRuntime({
         cfg: deps.gatewayCfg,
-        ctx: {
-          Body: body,
-          BodyForAgent: body,
-          RawBody: body,
-          CommandBody: body,
-          From: `@${senderHandle}`,
-          To: `@${recipientHandle}`,
-          SessionKey: sessionKey,
-          AccountId: deps.accountId,
-          ChatType: "group",
-          ConversationLabel: conversationLabel,
-          SenderId: senderHandle,
-          Provider: "agentchat",
-          Surface: "agentchat",
-          MessageSid: event.messageId,
-          MessageSidFull: event.messageId,
-          Timestamp: event.createdAt,
-          OriginatingChannel: "agentchat",
-          OriginatingTo: `@${recipientHandle}`
+        channel: "agentchat",
+        accountId: deps.accountId,
+        peer: { kind: "group", id: event.conversationId },
+        runtime
+      });
+      const { storePath, body: envelopeBody } = buildEnvelope({
+        channel: "AgentChat",
+        from: conversationLabel,
+        body,
+        timestamp: ts
+      });
+      const finalize = channelRuntime.reply.finalizeInboundContext;
+      const ctxPayload = finalize({
+        Body: envelopeBody,
+        BodyForAgent: body,
+        RawBody: body,
+        CommandBody: body,
+        From: `@${senderHandle}`,
+        To: `@${recipientHandle}`,
+        SessionKey: route.sessionKey,
+        AccountId: deps.accountId,
+        ChatType: "group",
+        ConversationLabel: conversationLabel,
+        SenderId: senderHandle,
+        Provider: "agentchat",
+        Surface: "agentchat",
+        MessageSid: event.messageId,
+        MessageSidFull: event.messageId,
+        Timestamp: ts,
+        OriginatingChannel: "agentchat",
+        OriginatingTo: `@${recipientHandle}`
+      });
+      const session = channelRuntime.session;
+      await inboundReplyDispatch.recordInboundSessionAndDispatchReply({
+        cfg: deps.gatewayCfg,
+        channel: "agentchat",
+        accountId: deps.accountId,
+        agentId: route.agentId,
+        routeSessionKey: route.sessionKey,
+        storePath,
+        ctxPayload,
+        recordInboundSession: session.recordInboundSession,
+        dispatchReplyWithBufferedBlockDispatcher: channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher,
+        deliver: deliver2,
+        onRecordError: (err3) => {
+          deps.logger.error(
+            { err: err3 instanceof Error ? err3.message : String(err3), messageId: event.messageId },
+            "recordInboundSession failed (group)"
+          );
         },
-        dispatcherOptions: { deliver: deliver2 }
+        onDispatchError: (err3, info) => {
+          deps.logger.error(
+            {
+              err: err3 instanceof Error ? err3.message : String(err3),
+              messageId: event.messageId,
+              kind: info.kind
+            },
+            "inbound dispatch failed (group)"
+          );
+        }
       });
     }
   } catch (err3) {