@hirey/hi-mcp-server 0.1.11 → 0.1.13

package/README.md

@@ -86,6 +86,8 @@ npm install -g @hirey/hi-mcp-server
 }
 ```
 
+这里的 `HI_MCP_STATE_DIR` 必须直接指向 profile 对应的叶子目录；不要只写父目录 `/Users/you/.openclaw/hi-mcp`，否则虽然 `openclaw-main.json` 还能落盘，但 receiver config 和 doctor 会把它识别成非 canonical OpenClaw 布局。
+
 普通用户首次接入后的典型顺序：
 
 1. 用宿主把 `hi-mcp-server` 作为 `stdio` MCP server 挂上
@@ -100,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`。
 
-如果宿主此刻就知道“当前用户会话就是 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 还沿旧配置投递的漂移。
+对 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 说明白。
 
 安装后如果要显式验证 continuation route，可以用 `hi_agent_test_delivery`：既可以直接传 `host_session_key` / `reply_*` 做一次显式 route probe，也可以在 installation 已设置 `default_reply_route` 时不传这些字段，让 gateway 自动沿当前 installation 的默认 route 发 probe。
 
@@ -124,11 +126,18 @@ npm install -g @hirey/hi-mcp-server
 - `HI_MCP_STATE_DIR`
   - 本地 state 目录。未显式指定时，默认落到稳定 home 目录：`~/.hirey/hi-mcp/<profile>`。
   - OpenClaw 普通用户建议显式固定到 canonical 目录，例如 `/Users/you/.openclaw/hi-mcp/openclaw-main`，方便后续 `hi-agent-receiver` 直接复用同一份身份 state。
+  - 不要把它设置成 bare parent dir `/Users/you/.openclaw/hi-mcp`；OpenClaw 场景下必须把 profile 叶子目录也包含进去。
 
 ### 本地 state
 
 state 会按 profile 落到 `HI_MCP_STATE_DIR/<profile>.json`。
 
+对 OpenClaw 而言，推荐的 canonical 形态就是：
+
+- `HI_MCP_PROFILE=openclaw-main`
+- `HI_MCP_STATE_DIR=/Users/you/.openclaw/hi-mcp/openclaw-main`
+- 最终 state file = `/Users/you/.openclaw/hi-mcp/openclaw-main/openclaw-main.json`
+
 文件内部明确分成两块：
 
 - `identity`

package/dist/defaultReplyRoute.d.ts

@@ -12,4 +12,15 @@ export declare function resolveInstallDefaultReplyDeliveryContext(args: {
     defaultReplyAccountId?: unknown;
     defaultReplyThreadId?: unknown;
 }): DefaultReplyDeliveryContext | null;
+export declare function resolveInstallRouteMissingPolicy(args: {
+    hostKind: 'openclaw' | 'generic';
+    explicitRouteMissingPolicy?: unknown;
+    defaultReplyRoute?: Record<string, unknown> | null;
+}): {
+    ok: true;
+    routeMissingPolicy: string;
+} | {
+    ok: false;
+    error: 'missing_openclaw_default_reply_route';
+};
 //# sourceMappingURL=defaultReplyRoute.d.ts.map

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"}
+{"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"}

package/dist/defaultReplyRoute.js

@@ -26,3 +26,18 @@ export function resolveInstallDefaultReplyDeliveryContext(args) {
     }
     return null;
 }
+export function resolveInstallRouteMissingPolicy(args) {
+    const explicitRouteMissingPolicy = normalizeText(args.explicitRouteMissingPolicy);
+    // OpenClaw 安装默认就要把当前聊天绑成默认续聊入口；否则安装不该继续宣告成功。
+    if (args.hostKind === 'openclaw' && !args.defaultReplyRoute) {
+        return {
+            ok: false,
+            error: 'missing_openclaw_default_reply_route',
+        };
+    }
+    return {
+        ok: true,
+        routeMissingPolicy: explicitRouteMissingPolicy
+            || (args.defaultReplyRoute ? 'use_explicit_default_route' : ''),
+    };
+}

package/dist/server.js

@@ -11,11 +11,11 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { AGENT_GATEWAY_EVENT_TOPICS, normalizeAgentEndpointList, normalizeAgentInstallationDeliveryDeclaration, normalizeAgentSubscriptionList, normalizeText, } from '@hirey/hi-agent-contracts';
 import { createHiAgentClients, exchangeHiAgentClientCredentialsToken, HiAgentGatewayClient, HiAgentPlatformClient, } from '@hirey/hi-agent-sdk';
-import { readState, resolveCanonicalOpenClawStateDir, resolveDefaultStateDir, resolveLegacyStateFiles, resolveStateFile, updateState, normalizeStateProfile, } from './state.js';
+import { readState, resolveCanonicalOpenClawStateDir, resolveDefaultStateDir, resolveLegacyStateFiles, resolveStateFile, validateOpenClawStateDir, updateState, normalizeStateProfile, } from './state.js';
 import { looksLikeOpenClawSessionKey, validateOpenClawSessionKey, } from './openclaw-session-key.js';
 import { buildInstallReceiverCommandArgv, } from './receiver-command.js';
 import { applyReceiverRuntimeSnapshot, receiverConfigMaterialEquals, } from './receiver-config-material.js';
-import { resolveInstallDefaultReplyDeliveryContext, } from './defaultReplyRoute.js';
+import { resolveInstallDefaultReplyDeliveryContext, resolveInstallRouteMissingPolicy, } from './defaultReplyRoute.js';
 const CAPABILITY_CACHE_TTL_MS = 30_000;
 const RECEIVER_STOP_TIMEOUT_MS = 3_000;
 const RECEIVER_STOP_POLL_MS = 100;
@@ -113,8 +113,8 @@ function controlTools() {
                     host_adapter_url: { type: 'string', description: 'enable_local_receiver=true 时可选：宿主本地接收入口。OpenClaw 默认 full endpoint 为 http://127.0.0.1:18789/hooks/agent；注意 OpenClaw 配置里的 hooks.path 应保持 /hooks，而不是 /hooks/agent。' },
                     host_adapter_bearer_token: { type: 'string', description: 'host_adapter_kind=openclaw_hooks 时必填：本地 hooks bearer token。' },
                     openresponses_model: { type: 'string', description: 'host_adapter_kind=openresponses 时必填：receiver 发给本地入口使用的 model。' },
-                    host_session_key: { type: 'string', description: '可选：把当前 OpenClaw 当前会话显式设为 default continuation route 的 canonical full session_key。只能使用结构化宿主来源返回的完整 key；不要从 openclaw status / openclaw sessions / TUI footer 这类展示文本里抄值。' },
-                    route_missing_policy: { type: 'string', description: "可选：'use_explicit_default_route'|'fail_closed'。默认在提供 host_session_key/default_reply_* 时使用 use_explicit_default_route，否则为 null。" },
+                    host_session_key: { type: 'string', description: 'OpenClaw 安装默认应传：把当前 OpenClaw 当前会话设为 default continuation route 的 canonical full session_key。只能使用结构化宿主来源返回的完整 key；不要从 openclaw status / openclaw sessions / TUI footer 这类展示文本里抄值。' },
+                    route_missing_policy: { type: 'string', description: "可选：'use_explicit_default_route'|'fail_closed'。OpenClaw 安装默认要求当前聊天 ready，因此在提供 host_session_key/default_reply_* 时应使用 use_explicit_default_route；缺失 default route 时安装会直接失败，而不是继续留下 continuity_not_ready。" },
                     default_reply_channel: { type: 'string', description: '可选：default continuation route 的 channel。' },
                     default_reply_to: { type: 'string', description: '可选：default continuation route 的宿主 target。' },
                     default_reply_account_id: { type: 'string', description: '可选：default continuation route 的 account_id。' },
@@ -836,6 +836,7 @@ function buildDoctorSummary(args) {
         route_missing_policy: routeMissingPolicy,
         default_reply_route: defaultReplyRoute,
         default_reply_route_validation: args.defaultReplyRouteValidation,
+        openclaw_state_dir_validation: args.openClawStateDirValidation,
         delivery_probe: args.deliveryProbe,
         delivery_probe_diagnostics: args.deliveryProbeDiagnostics,
     };
@@ -1087,11 +1088,23 @@ async function handleDoctor(args) {
         reason: null,
         session_key: null,
     };
+    let openClawStateDirValidation = null;
     if (!state.identity) {
         blockers.push('missing_agent_identity');
     }
-    if (installState.host_kind === 'openclaw' && config.stateDir !== resolveCanonicalOpenClawStateDir(config.profile)) {
-        warnings.push('openclaw_state_dir_not_canonical');
+    if (installState.host_kind === 'openclaw') {
+        const validation = validateOpenClawStateDir(config.stateDir, config.profile);
+        openClawStateDirValidation = {
+            configured_state_dir: validation.configured_state_dir,
+            canonical_state_dir: validation.canonical_state_dir,
+            reason: validation.reason,
+        };
+        if (!validation.is_canonical) {
+            warnings.push('openclaw_state_dir_not_canonical');
+            if (validation.reason === 'missing_profile_leaf') {
+                warnings.push('openclaw_state_dir_missing_profile_leaf');
+            }
+        }
     }
     if (includeRemote && state.identity) {
         try {
@@ -1198,6 +1211,7 @@ async function handleDoctor(args) {
         deliveryProbe,
         deliveryProbeDiagnostics,
         defaultReplyRouteValidation,
+        openClawStateDirValidation,
     }));
 }
 async function handleInstall(args) {
@@ -1261,8 +1275,19 @@ async function handleInstall(args) {
         requireOpenClawSessionKey: hostKind === 'openclaw',
         hostKind,
     });
-    const routeMissingPolicy = normalizeText(args.route_missing_policy)
-        || (defaultReplyRoute ? 'use_explicit_default_route' : '');
+    const routeMissingPolicyResolution = resolveInstallRouteMissingPolicy({
+        hostKind,
+        explicitRouteMissingPolicy: args.route_missing_policy,
+        defaultReplyRoute,
+    });
+    if (!routeMissingPolicyResolution.ok) {
+        return fail(routeMissingPolicyResolution.error, {
+            host_kind: hostKind,
+            hint: 'OpenClaw installs must bind the current chat as the default continuation route. Read the canonical full current session key from a structured OpenClaw host source and pass it as host_session_key.',
+            expected_route_missing_policy: 'use_explicit_default_route',
+        });
+    }
+    const routeMissingPolicy = routeMissingPolicyResolution.routeMissingPolicy;
     const desiredDeliveryCapabilities = buildInstallationDeliveryDeclaration({
         enableLocalReceiver,
         receiverTransport,

package/dist/state.d.ts

@@ -40,6 +40,13 @@ export declare const DEFAULT_HI_MCP_PROFILE = "default";
 export declare function normalizeStateProfile(raw: unknown): string;
 export declare function resolveDefaultStateDir(profileRaw: unknown): string;
 export declare function resolveCanonicalOpenClawStateDir(profileRaw?: unknown): string;
+export type OpenClawStateDirValidation = {
+    configured_state_dir: string;
+    canonical_state_dir: string;
+    is_canonical: boolean;
+    reason: 'canonical' | 'missing_profile_leaf' | 'non_canonical';
+};
+export declare function validateOpenClawStateDir(stateDirRaw: unknown, profileRaw?: unknown): OpenClawStateDirValidation;
 export declare function resolveLegacyStateFiles(profileRaw: unknown): string[];
 export declare function buildDefaultState(profile: string): HiAgentPersistedState;
 export declare function resolveStateFile(args: {

package/dist/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC;IACF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,OAAO,EAAE,mBAAmB,CAAC;CAC9B,CAAC;AAeF,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAIlE;AAED,wBAAgB,gCAAgC,CAAC,UAAU,GAAE,OAAyB,GAAG,MAAM,CAG9F;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAMrE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAOxE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,UAG3E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoCjC;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,qBAAqB,CAAC;CAC9B,iBAIA;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;CACpE,kCASA"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/dist/state.js

@@ -17,6 +17,10 @@ export const DEFAULT_HI_MCP_PROFILE = 'default';
 export function normalizeStateProfile(raw) {
     return String(raw || '').trim() || DEFAULT_HI_MCP_PROFILE;
 }
+function normalizeStateDirPath(raw) {
+    const text = typeof raw === 'string' ? String(raw).trim() : '';
+    return text ? path.resolve(text) : '';
+}
 export function resolveDefaultStateDir(profileRaw) {
     const profile = normalizeStateProfile(profileRaw);
     // 本地 installation state 必须落到稳定 home 目录，不能继续跟着 cwd 漂。
@@ -26,6 +30,34 @@ export function resolveCanonicalOpenClawStateDir(profileRaw = 'openclaw-main') {
     const profile = normalizeStateProfile(profileRaw);
     return path.join(os.homedir(), '.openclaw', 'hi-mcp', profile);
 }
+export function validateOpenClawStateDir(stateDirRaw, profileRaw = 'openclaw-main') {
+    const canonicalStateDir = resolveCanonicalOpenClawStateDir(profileRaw);
+    const configuredStateDir = normalizeStateDirPath(stateDirRaw) || canonicalStateDir;
+    if (configuredStateDir === canonicalStateDir) {
+        return {
+            configured_state_dir: configuredStateDir,
+            canonical_state_dir: canonicalStateDir,
+            is_canonical: true,
+            reason: 'canonical',
+        };
+    }
+    const bareOpenClawStateDir = path.join(os.homedir(), '.openclaw', 'hi-mcp');
+    if (configuredStateDir === bareOpenClawStateDir) {
+        // OpenClaw 的 canonical 布局要求 stateDir 自己就是 profile 叶子目录，不能只指向父目录。
+        return {
+            configured_state_dir: configuredStateDir,
+            canonical_state_dir: canonicalStateDir,
+            is_canonical: false,
+            reason: 'missing_profile_leaf',
+        };
+    }
+    return {
+        configured_state_dir: configuredStateDir,
+        canonical_state_dir: canonicalStateDir,
+        is_canonical: false,
+        reason: 'non_canonical',
+    };
+}
 export function resolveLegacyStateFiles(profileRaw) {
     const profile = normalizeStateProfile(profileRaw);
     return [

package/package.json

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