@hirey/hi-mcp-server 0.1.15 → 0.1.17

package/README.md

@@ -92,7 +92,7 @@ npm install -g @hirey/hi-mcp-server
 
 1. 用宿主把 `hi-mcp-server` 作为 `stdio` MCP server 挂上
 2. 优先执行 `hi_agent_install`，而不是让用户手工走 `register -> connect -> activate`
-3. `hi_agent_install` 会自动完成 register / activate、delivery capability 声明、默认订阅，以及在 OpenClaw 场景下的 receiver 配置
+3. `hi_agent_install` 会自动完成 register / activate、delivery capability 声明、默认订阅，以及在 OpenClaw 场景下的 receiver 配置；首次安装如果没有显式传 `display_name`，OpenClaw 会稳定默认成 `OpenClaw Hi Agent`，generic host 会默认成 `Hi Agent`
 4. 当 receiver 的物料配置（例如 hooks token、adapter URL、transport、default reply route）发生变化时，`hi_agent_install` 会先停止当前 profile 记录的 receiver，再写入新配置并按需要重新启动；如果配置没变，则保留现有 runtime cursor，不重置消费进度
 5. `agent_id` 可以省略；省略时由 gateway 正式生成 canonical `ag_...`，不需要用户手写
 6. 完成后执行 `hi_agent_doctor`

package/dist/installDefaults.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_OPENCLAW_INSTALL_DISPLAY_NAME = "OpenClaw Hi Agent";
+export declare const DEFAULT_GENERIC_INSTALL_DISPLAY_NAME = "Hi Agent";
+export declare function resolveInstallDisplayName(args: {
+    explicitDisplayName?: unknown;
+    hostKind: 'openclaw' | 'generic';
+}): string;
+//# sourceMappingURL=installDefaults.d.ts.map

package/dist/installDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installDefaults.d.ts","sourceRoot":"","sources":["../src/installDefaults.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qCAAqC,sBAAsB,CAAC;AACzE,eAAO,MAAM,oCAAoC,aAAa,CAAC;AAE/D,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;CAClC,UAMA"}

package/dist/installDefaults.js

@@ -0,0 +1,13 @@
+function normalizeText(input) {
+    return String(input || '').trim();
+}
+export const DEFAULT_OPENCLAW_INSTALL_DISPLAY_NAME = 'OpenClaw Hi Agent';
+export const DEFAULT_GENERIC_INSTALL_DISPLAY_NAME = 'Hi Agent';
+export function resolveInstallDisplayName(args) {
+    const explicitDisplayName = normalizeText(args.explicitDisplayName);
+    if (explicitDisplayName)
+        return explicitDisplayName;
+    return args.hostKind === 'openclaw'
+        ? DEFAULT_OPENCLAW_INSTALL_DISPLAY_NAME
+        : DEFAULT_GENERIC_INSTALL_DISPLAY_NAME;
+}

package/dist/server.js

@@ -16,6 +16,7 @@ import { looksLikeOpenClawSessionKey, validateOpenClawSessionKey, } from './open
 import { buildInstallReceiverCommandArgv, } from './receiver-command.js';
 import { applyReceiverRuntimeSnapshot, receiverConfigMaterialEquals, } from './receiver-config-material.js';
 import { resolveInstallDefaultReplyDeliveryContext, resolveInstallRouteMissingPolicy, } from './defaultReplyRoute.js';
+import { resolveInstallDisplayName } from './installDefaults.js';
 const CAPABILITY_CACHE_TTL_MS = 30_000;
 const RECEIVER_STOP_TIMEOUT_MS = 3_000;
 const RECEIVER_STOP_POLL_MS = 100;
@@ -77,7 +78,7 @@ function normalizeCommandArgv(input) {
         .filter(Boolean);
 }
 function controlTools() {
-    // control tools 只映射 gateway/onboarding/runtime 管理面，不伪装成第二套业务 API。
+    // control tools 只映射 install/runtime 控制面；Hi 的正式业务面仍是 listing、matching、collaboration、meeting。
     return [
         {
             name: 'hi_agent_status',
@@ -95,7 +96,7 @@ function controlTools() {
             inputSchema: {
                 type: 'object',
                 properties: {
-                    display_name: { type: 'string', description: '首次安装且当前 profile 还没有 identity 时使用的人类可读名称。' },
+                    display_name: { type: 'string', description: '首次安装且当前 profile 还没有 identity 时使用的人类可读名称。省略时会按 host_kind 使用稳定默认值：OpenClaw 为 `OpenClaw Hi Agent`，generic 为 `Hi Agent`。' },
                     host_kind: { type: 'string', description: "可选：'openclaw'|'generic'。默认 generic。" },
                     agent_kind: { type: 'string', description: '首次 register 时可选的 agent_kind。默认 external。' },
                     replace_existing_state: { type: 'boolean', description: '首次 register 且本地已有 state 时，是否允许覆盖本地持久化身份。' },
@@ -699,7 +700,7 @@ function buildReceiverConfig(args) {
                 },
                 // OpenClaw 本地消息的展示前缀需要稳定，避免安装后又冒出第二套文案。
                 config: {
-                    name: args.hostKind === 'openclaw' ? 'Hirey Hi Agent Platform' : 'Hirey Hi',
+                    name: 'Hirey Hi',
                     agent_id: 'main',
                     message_prefix: '[Hi Event]',
                     session_key: normalizeText(defaultReplyRoute?.session_key) || null,
@@ -1240,13 +1241,10 @@ async function handleInstall(args) {
     let state = await loadPersistedState();
     let registerPayload = null;
     if (!state.identity) {
-        const displayName = normalizeText(args.display_name);
-        if (!displayName) {
-            return fail('missing_display_name', {
-                profile: config.profile,
-                state_file: resolveCurrentStateFile(),
-            });
-        }
+        const displayName = resolveInstallDisplayName({
+            explicitDisplayName: args.display_name,
+            hostKind,
+        });
         const registerResult = await handleRegister({
             display_name: displayName,
             agent_kind: normalizeText(args.agent_kind) || undefined,
@@ -1732,7 +1730,7 @@ function createMcpServer() {
         capabilities: {
             tools: {},
         },
-        instructions: 'Hi MCP adapter: control-plane tools stay in gateway, business tools mirror Hi public capabilities exactly.',
+        instructions: 'Hi MCP adapter: control-plane tools cover install/runtime state, while business tools mirror Hi public capabilities for listings, matching, collaboration, and meetings.',
     });
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         return {

package/package.json

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