@hirey/hi-mcp-server 0.1.8 → 0.1.10

package/README.md

@@ -97,6 +97,8 @@ npm install -g @hirey/hi-mcp-server
 
 如果宿主不能直接执行裸命令 `hi-agent-receiver`，而是需要 `node /path/to/dist/server.js`、`npx ...` 或其它显式 argv 前缀，`hi_agent_install` 现在也支持把 receiver 启动入口写成 `receiver_command_argv` 数组；`hi-mcp-server` 会在这组 argv 后自动追加 `run --config <path>`，不再把整段命令误当成单个可执行文件。
 
+对 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`。
+
 如果宿主此刻就知道“当前用户会话就是 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 还沿旧配置投递的漂移。
 
 安装后如果要显式验证 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

@@ -0,0 +1,15 @@
+export type DefaultReplyDeliveryContext = {
+    channel: string | null;
+    to: string | null;
+    account_id: string | null;
+    thread_id: string | null;
+};
+export declare function resolveInstallDefaultReplyDeliveryContext(args: {
+    hostKind: 'openclaw' | 'generic';
+    hasSessionKey: boolean;
+    defaultReplyChannel?: unknown;
+    defaultReplyTo?: unknown;
+    defaultReplyAccountId?: unknown;
+    defaultReplyThreadId?: unknown;
+}): DefaultReplyDeliveryContext | null;
+//# sourceMappingURL=defaultReplyRoute.d.ts.map

package/dist/defaultReplyRoute.d.ts.map

@@ -0,0 +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"}

package/dist/defaultReplyRoute.js

@@ -0,0 +1,28 @@
+function normalizeText(input) {
+    return String(input || '').trim();
+}
+export function resolveInstallDefaultReplyDeliveryContext(args) {
+    const explicit = {
+        channel: normalizeText(args.defaultReplyChannel) || null,
+        to: normalizeText(args.defaultReplyTo) || null,
+        account_id: normalizeText(args.defaultReplyAccountId) || null,
+        thread_id: normalizeText(args.defaultReplyThreadId) || null,
+    };
+    const hasExplicit = !!(explicit.channel
+        || explicit.to
+        || explicit.account_id
+        || explicit.thread_id);
+    if (hasExplicit)
+        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) {
+        return {
+            channel: 'last',
+            to: null,
+            account_id: null,
+            thread_id: null,
+        };
+    }
+    return null;
+}

package/dist/receiver-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"receiver-command.d.ts","sourceRoot":"","sources":["../src/receiver-command.ts"],"names":[],"mappings":"AAGA,wBAAgB,0CAA0C,CAAC,OAAO,GAAE,MAAqB,GAAG,MAAM,CAEjG;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,EAAE,CAQX"}
+{"version":3,"file":"receiver-command.d.ts","sourceRoot":"","sources":["../src/receiver-command.ts"],"names":[],"mappings":"AAGA,wBAAgB,0CAA0C,CAAC,OAAO,GAAE,MAAqB,GAAG,MAAM,CAEjG;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,EAAE,CAmBX"}

package/dist/receiver-command.js

@@ -4,13 +4,23 @@ export function resolveCanonicalOpenClawReceiverBinaryPath(homeDir = os.homedir(
     return path.join(homeDir, '.openclaw', 'vendor', 'hi', 'node_modules', '.bin', 'hi-agent-receiver');
 }
 export function buildInstallReceiverCommandArgv(args) {
-    if (args.explicitArgv.length > 0)
+    const useCanonicalOpenClawReceiver = args.hostKind === 'openclaw' && args.enableLocalReceiver;
+    if (args.explicitArgv.length > 0) {
+        // OpenClaw's public install path is user-local vendor install, so a bare
+        // receiver command should never override the canonical local binary path.
+        if (useCanonicalOpenClawReceiver && args.explicitArgv[0] === 'hi-agent-receiver') {
+            return [resolveCanonicalOpenClawReceiverBinaryPath(args.homeDir), ...args.explicitArgv.slice(1)];
+        }
         return args.explicitArgv;
-    if (args.receiverCommand)
+    }
+    if (args.receiverCommand) {
+        if (useCanonicalOpenClawReceiver && args.receiverCommand === 'hi-agent-receiver') {
+            return [resolveCanonicalOpenClawReceiverBinaryPath(args.homeDir)];
+        }
         return [args.receiverCommand];
+    }
     // OpenClaw's public install path is user-local vendor install, not global PATH.
-    if (args.hostKind === 'openclaw' && args.enableLocalReceiver) {
+    if (useCanonicalOpenClawReceiver)
         return [resolveCanonicalOpenClawReceiverBinaryPath(args.homeDir)];
-    }
     return ['hi-agent-receiver'];
 }

package/dist/server.js

@@ -14,6 +14,7 @@ import { createHiAgentClients, exchangeHiAgentClientCredentialsToken, HiAgentGat
 import { readState, resolveCanonicalOpenClawStateDir, resolveDefaultStateDir, resolveLegacyStateFiles, resolveStateFile, updateState, normalizeStateProfile, } from './state.js';
 import { looksLikeOpenClawSessionKey, validateOpenClawSessionKey, } from './openclaw-session-key.js';
 import { buildInstallReceiverCommandArgv, } from './receiver-command.js';
+import { resolveInstallDefaultReplyDeliveryContext, } from './defaultReplyRoute.js';
 const CAPABILITY_CACHE_TTL_MS = 30_000;
 const resolvedProfile = normalizeStateProfile(process.env.HI_MCP_PROFILE);
 const config = {
@@ -622,16 +623,15 @@ function buildDefaultReplyRoute(args, options = {}) {
     const sessionKey = normalizeReplyRouteSessionKey(args.host_session_key, {
         requireOpenClawSessionKey: options.requireOpenClawSessionKey,
     });
-    const deliveryContext = {
-        channel: normalizeText(args.default_reply_channel) || null,
-        to: normalizeText(args.default_reply_to) || null,
-        account_id: normalizeText(args.default_reply_account_id) || null,
-        thread_id: normalizeText(args.default_reply_thread_id) || null,
-    };
-    const hasDeliveryContext = !!(deliveryContext.channel
-        || deliveryContext.to
-        || deliveryContext.account_id
-        || deliveryContext.thread_id);
+    const deliveryContext = resolveInstallDefaultReplyDeliveryContext({
+        hostKind: options.hostKind === 'openclaw' ? 'openclaw' : 'generic',
+        hasSessionKey: !!sessionKey,
+        defaultReplyChannel: args.default_reply_channel,
+        defaultReplyTo: args.default_reply_to,
+        defaultReplyAccountId: args.default_reply_account_id,
+        defaultReplyThreadId: args.default_reply_thread_id,
+    });
+    const hasDeliveryContext = !!deliveryContext;
     if (!sessionKey && !hasDeliveryContext)
         return null;
     return {
@@ -1204,6 +1204,7 @@ async function handleInstall(args) {
     const defaultReplyRoute = buildDefaultReplyRoute(args, {
         installationId: state.identity?.installation_id || null,
         requireOpenClawSessionKey: hostKind === 'openclaw',
+        hostKind,
     });
     const routeMissingPolicy = normalizeText(args.route_missing_policy)
         || (defaultReplyRoute ? 'use_explicit_default_route' : '');

package/package.json

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