hermes - 💡(How to fix) Fix [Setup]: DingTalk adapter incompatible with dingtalk-stream 0.24.x (`_IncomingHandler` missing `raw_process`)

INFO tools.lazy_deps: Lazy-installing dingtalk-stream==0.24.3 alibabacloud-dingtalk==2.2.42 qrcode==7.4.2 for feature 'platform.dingtalk'

INFO gateway.platforms.dingtalk:
[Dingtalk] Connected via Stream Mode

INFO gateway.run:
✓ dingtalk connected

WARNING gateway.platforms.dingtalk:
[Dingtalk] Stream client error:
'_IncomingHandler' object has no attribute 'pre_start'

INFO gateway.platforms.dingtalk:
[Dingtalk] Reconnecting in 2s...

ERROR dingtalk_stream.client:
error processing message:
'_IncomingHandler' object has no attribute 'raw_process'

---

class _IncomingHandler(ChatbotHandler):

    def pre_start(self):
        pass

    async def process(self, message):
        ...

---

pre_start()
↓
raw_process()
↓
process()

---

def raw_process(self, callback_message):
    try:
        result = self.process(callback_message)

        if asyncio.iscoroutine(result):
            if self._loop and self._loop.is_running():
                asyncio.run_coroutine_threadsafe(
                    result,
                    self._loop,
                )
                return AckMessage.STATUS_OK, "OK"

        return result

    except Exception:
        logger.exception(
            "[%s] Error in raw_process",
            self._adapter.name,
        )
        return AckMessage.STATUS_SYSTEM_EXCEPTION, "error"

---

asyncio.create_task(
    self._safe_on_message(chatbot_msg)
)

---

if self._loop:
    asyncio.run_coroutine_threadsafe(
        self._safe_on_message(chatbot_msg),
        self._loop,
    )
else:
    asyncio.create_task(
        self._safe_on_message(chatbot_msg)
    )

---

### 1. Stream Connection Status

 id="dbg1"
[Dingtalk] Connected via Stream Mode
✓ dingtalk connected
Gateway running with 1 platform(s)


WebSocket connection is successfully established.

---

### 2. Message Processing Failure

 id="dbg2"
WARNING gateway.platforms.dingtalk:
'_IncomingHandler' object has no attribute 'pre_start'

ERROR dingtalk_stream.client:
error processing message:
'_IncomingHandler' object has no attribute 'raw_process'


---

### 3. Handler Implementation (Hermes 0.14.0)

Current `_IncomingHandler` implementation:

 id="dbg3"
class _IncomingHandler(ChatbotHandler):

    def pre_start(self) -> None:
        return

    async def process(self, message: CallbackMessage):
        ...


Missing method:

* `raw_process(self, callback_message)`

---

### 4. SDK Behavior (Observed)

From runtime behavior:


SDK invocation chain:
pre_start()
→ raw_process()
→ process()


Hermes only implements:

* pre_start ✔
* process ✔
* raw_process ❌ (missing)

---

### 5. Failure Point

Failure occurs inside:


dingtalk_stream.client
→ message dispatch layer
→ handler.raw_process() not found


This causes the stream client to continuously reconnect and drop messages.

---

### 6. Runtime Impact

* WebSocket connects successfully
* No message is processed
* Bot remains silent despite receiving events
* Reconnect loop triggered after processing failure

---

2026-05-22 08:05:58,421 INFO dingtalk_stream.client: open connection, url=https://api.dingtalk.com/v1.0/gateway/connections/open
2026-05-22 08:05:58,605 INFO dingtalk_stream.client: endpoint is {'endpoint': 'wss://wss-open-connection-union.dingtalk.com:443/connect', 'ticket': '10df525a-55b5-11f1-85b6-8a62bdfdb80d'}
2026-05-22 08:06:02,429 INFO gateway.run: kanban dispatcher: embedded in gateway (interval=60.0s)
2026-05-22 08:06:39,699 ERROR dingtalk_stream.client: error processing message: '_IncomingHandler' object has no attribute 'raw_process'
2026-05-22 08:07:39,711 ERROR dingtalk_stream.client: error processing message: '_IncomingHandler' object has no attribute 'raw_process'
2026-05-22 08:08:13,989 ERROR dingtalk_stream.client: error processing message: '_IncomingHandler' object has no attribute 'raw_process'
2026-05-22 08:09:13,998 ERROR dingtalk_stream.client: error processing message: '_IncomingHandler' object has no attribute 'raw_process'
2026-05-22 08:12:57,356 ERROR dingtalk_stream.client: error processing message: '_IncomingHandler' object has no attribute 'raw_process'
2026-05-22 08:13:57,118 ERROR dingtalk_stream.client: error processing message: '_IncomingHandler' object has no attribute 'raw_process'