@hirey/hi-mcp-server 0.1.13 → 0.1.15

package/README.md

@@ -102,7 +102,7 @@ npm install -g @hirey/hi-mcp-server
 
 对 OpenClaw 的普通用户本地 vendor 安装，不要显式传 `receiver_command="hi-agent-receiver"` 或 `receiver_command_argv=["hi-agent-receiver"]`。这两种旧形态都会重新把启动语义写回“按 PATH 找全局命令”。OpenClaw 要么不传 receiver 启动覆盖，让安装流默认落到 `~/.openclaw/vendor/hi/node_modules/.bin/hi-agent-receiver`，要么只传指向该本地 vendor binary 的精确 `receiver_command_argv`。
 
-对 OpenClaw 的普通用户安装，默认就应该把当前聊天绑成 Hi 以后回来的默认线程。因此 `hi_agent_install` 应直接带上 `host_session_key`、`default_reply_channel`、`default_reply_to`、`default_reply_account_id`、`default_reply_thread_id`、`route_missing_policy`。这组字段会同时写进 installation 的 `delivery_capabilities` 和本地 receiver config，避免出现 gateway 已经知道默认 route、但本地 receiver 还沿旧配置投递的漂移。如果拿不到当前聊天的 canonical `host_session_key`，OpenClaw 安装不应宣告成功，而应先把 continuity blocker 说明白。
+对 OpenClaw 的普通用户安装，默认就应该把当前聊天绑成 Hi 以后回来的默认线程。因此 `hi_agent_install` 应直接带上 `host_session_key`、`default_reply_channel`、`default_reply_to`、`default_reply_account_id`、`default_reply_thread_id`、`route_missing_policy`。这组字段会同时写进 installation 的 `delivery_capabilities` 和本地 receiver config，避免出现 gateway 已经知道默认 route、但本地 receiver 还沿旧配置投递的漂移。如果拿不到当前聊天的 canonical `host_session_key`，OpenClaw 安装不应宣告成功，而应先把 continuity blocker 说明白。对于 OpenClaw，如果宿主只暴露了当前聊天的展示层 channel（例如 `webchat`）而没有更具体的 `to/account_id/thread_id`，`hi_agent_install` 必须把默认 continuation channel 规范成 `last`；不要把这类 display-only channel 原样写进 `default_reply_route`，否则 local receiver 的 delivery probe 会直接失败。
 
 安装后如果要显式验证 continuation route，可以用 `hi_agent_test_delivery`：既可以直接传 `host_session_key` / `reply_*` 做一次显式 route probe，也可以在 installation 已设置 `default_reply_route` 时不传这些字段，让 gateway 自动沿当前 installation 的默认 route 发 probe。
 

package/dist/defaultReplyRoute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultReplyRoute.d.ts","sourceRoot":"","sources":["../src/defaultReplyRoute.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,wBAAgB,yCAAyC,CAAC,IAAI,EAAE;IAC9D,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,2BAA2B,GAAG,IAAI,CAyBrC;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACpD,GAAG;IACF,EAAE,EAAE,IAAI,CAAC;IACT,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG;IACF,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,sCAAsC,CAAC;CAC/C,CAcA"}
+{"version":3,"file":"defaultReplyRoute.d.ts","sourceRoot":"","sources":["../src/defaultReplyRoute.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,wBAAgB,yCAAyC,CAAC,IAAI,EAAE;IAC9D,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,2BAA2B,GAAG,IAAI,CAqErC;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACpD,GAAG;IACF,EAAE,EAAE,IAAI,CAAC;IACT,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG;IACF,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,sCAAsC,CAAC;CAC/C,CAcA"}

package/dist/defaultReplyRoute.js

@@ -12,8 +12,45 @@ export function resolveInstallDefaultReplyDeliveryContext(args) {
         || explicit.to
         || explicit.account_id
         || explicit.thread_id);
-    if (hasExplicit)
+    if (hasExplicit) {
+        const openClawSupportedReplyChannel = explicit.channel === 'last' || explicit.channel === 'imessage';
+        // OpenClaw may expose the current TUI chat as `webchat` with `to=heartbeat`.
+        // `heartbeat` is host bookkeeping noise, not a durable reply target, so this
+        // shape still needs to collapse to the canonical `last` continuation lane.
+        const openClawDisplayOnlyTarget = (args.hostKind === 'openclaw'
+            && args.hasSessionKey
+            && explicit.to === 'heartbeat'
+            && !explicit.account_id
+            && !explicit.thread_id
+            && !openClawSupportedReplyChannel);
+        const hasConcreteReplyTarget = !!((explicit.to && !openClawDisplayOnlyTarget)
+            || explicit.account_id
+            || explicit.thread_id);
+        if (openClawDisplayOnlyTarget) {
+            return {
+                channel: 'last',
+                to: null,
+                account_id: null,
+                thread_id: null,
+            };
+        }
+        // OpenClaw may surface the current chat as a display-only channel like `webchat`
+        // without any concrete target fields. In that case the durable continuation lane
+        // is still `last`, not the display channel value.
+        if (args.hostKind === 'openclaw'
+            && args.hasSessionKey
+            && explicit.channel
+            && !hasConcreteReplyTarget
+            && !openClawSupportedReplyChannel) {
+            return {
+                channel: 'last',
+                to: null,
+                account_id: null,
+                thread_id: null,
+            };
+        }
         return explicit;
+    }
     // OpenClaw hooks continuation accepts `last|imessage`; when we already have the
     // canonical session key, `last` is the canonical "same chat" lane.
     if (args.hostKind === 'openclaw' && args.hasSessionKey) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirey/hi-mcp-server",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "private": false,
   "type": "module",
   "main": "dist/server.js",