kitty-hive 0.5.6 → 0.5.7

package/README.md

@@ -87,59 +87,59 @@ Each machine runs its **own** `kitty-hive serve` — there is no central hub. Lo
 
 ## Tools
 
-Every HTTP tool `hive.foo.bar` is re-exposed by the channel plugin as kebab-case `hive-foo-bar`. Tables below pair the two spellings — use the left column inside Claude Code, the right column when calling via HTTP MCP directly.
+Every HTTP tool `hive_foo_bar` is re-exposed by the channel plugin as kebab-case `hive-foo-bar`. Tables below pair the two spellings — use the left column inside Claude Code, the right column when calling via HTTP MCP directly. (Tool names use `_` because most MCP clients enforce `^[a-zA-Z0-9_-]{1,64}$` and reject `.`)
 
 ### Identity
 
 | Channel | HTTP | Description |
 |---------|------|-------------|
-| `hive-whoami` | `hive.whoami` | Show your agent id. **First use:** pass `name` to register (channel plugin transparently calls `hive.start` under the hood). |
-| — | `hive.start` | Underlying registration RPC. HTTP/IDE users call this directly (channel users go via `hive-whoami`). |
-| `hive-rename` | `hive.rename` | Change your global display_name |
-| `hive-agents` | `hive.agents` | List all agents on the hive |
+| `hive-whoami` | `hive_whoami` | Show your agent id. **First use:** pass `name` to register (channel plugin transparently calls `hive_start` under the hood). |
+| — | `hive_start` | Underlying registration RPC. HTTP/IDE users call this directly (channel users go via `hive-whoami`). |
+| `hive-rename` | `hive_rename` | Change your global display_name |
+| `hive-agents` | `hive_agents` | List all agents on the hive |
 
 ### DM & Inbox
 
 | Channel | HTTP | Description |
 |---------|------|-------------|
-| `hive-dm` | `hive.dm` | Send a direct message. Pass `attach: ["/abs/path"]` to send files/images (path on YOUR machine; receiver gets a `file_id` and fetches separately). |
-| `hive-inbox` | `hive.inbox` | Check unread DMs / team / task events. Each DM entry carries `message_id` + `attachments` inline. |
-| `hive-dm-read` | `hive.dm.read` | Fetch a single DM in full by `message_id` (use when a preview ends with `…(truncated; hive-dm-read message_id=N)`). |
-| `hive-file-fetch` | `hive.file.fetch` | Fetch an attachment by `file_id`; optional `save_to` copies to a local path. |
+| `hive-dm` | `hive_dm` | Send a direct message. Pass `attach: ["/abs/path"]` to send files/images (path on YOUR machine; receiver gets a `file_id` and fetches separately). |
+| `hive-inbox` | `hive_inbox` | Check unread DMs / team / task events. Each DM entry carries `message_id` + `attachments` inline. |
+| `hive-dm-read` | `hive_dm_read` | Fetch a single DM in full by `message_id` (use when a preview ends with `…(truncated; hive-dm-read message_id=N)`). |
+| `hive-file-fetch` | `hive_file_fetch` | Fetch an attachment by `file_id`; optional `save_to` copies to a local path. |
 
 ### Teams
 
 | Channel | HTTP | Description |
 |---------|------|-------------|
-| `hive-team-create` | `hive.team.create` | Create a team (optional nickname) |
-| `hive-team-join` | `hive.team.join` | Join a team by name or id |
-| `hive-team-list` | `hive.team.list` | List all open teams |
-| `hive-teams` | `hive.teams` | List teams you are in |
-| `hive-team-info` | `hive.team.info` | Members + recent events |
-| `hive-team-events` | `hive.team.events` | Fetch events with `since` |
-| `hive-team-message` | `hive.team.message` | Broadcast to team |
-| `hive-team-nickname` | `hive.team.nickname` | Set/clear nickname in a team |
+| `hive-team-create` | `hive_team_create` | Create a team (optional nickname) |
+| `hive-team-join` | `hive_team_join` | Join a team by name or id |
+| `hive-team-list` | `hive_team_list` | List all open teams |
+| `hive-teams` | `hive_teams` | List teams you are in |
+| `hive-team-info` | `hive_team_info` | Members + recent events |
+| `hive-team-events` | `hive_team_events` | Fetch events with `since` |
+| `hive-team-message` | `hive_team_message` | Broadcast to team |
+| `hive-team-nickname` | `hive_team_nickname` | Set/clear nickname in a team |
 
 ### Tasks & Workflow
 
 | Channel | HTTP | Description |
 |---------|------|-------------|
-| `hive-task` | `hive.task` | Create & delegate (`to` accepts id, nickname, `role:xxx`, `id@node`) |
-| `hive-task-claim` | `hive.task.claim` | Claim an unassigned task |
-| `hive-tasks` | `hive.tasks` | List your tasks |
-| `hive-check` | `hive.check` | Check task status |
-| `hive-workflow-propose` | `hive.workflow.propose` | Propose workflow steps; set `gate: true` per step to pause for creator review |
-| `hive-workflow-approve` | `hive.workflow.approve` | Approve the proposed workflow (creator only) |
-| `hive-workflow-step-complete` | `hive.workflow.step.complete` | Complete a step (gated step → enters `awaiting_approval`) |
-| `hive-workflow-step-approve` | `hive.workflow.step.approve` | Release a gated step's pause (creator only) |
-| `hive-workflow-reject` | `hive.workflow.reject` | Reject & rollback (works in `in_progress` and `awaiting_approval`) |
+| `hive-task` | `hive_task` | Create & delegate (`to` accepts id, nickname, `role:xxx`, `id@node`) |
+| `hive-task-claim` | `hive_task_claim` | Claim an unassigned task |
+| `hive-tasks` | `hive_tasks` | List your tasks |
+| `hive-check` | `hive_check` | Check task status |
+| `hive-workflow-propose` | `hive_workflow_propose` | Propose workflow steps; set `gate: true` per step to pause for creator review |
+| `hive-workflow-approve` | `hive_workflow_approve` | Approve the proposed workflow (creator only) |
+| `hive-workflow-step-complete` | `hive_workflow_step_complete` | Complete a step (gated step → enters `awaiting_approval`) |
+| `hive-workflow-step-approve` | `hive_workflow_step_approve` | Release a gated step's pause (creator only) |
+| `hive-workflow-reject` | `hive_workflow_reject` | Reject & rollback (works in `in_progress` and `awaiting_approval`) |
 
 ### Federation
 
 | Channel | HTTP | Description |
 |---------|------|-------------|
-| `hive-peers` | `hive.peers` | List federation peers |
-| `hive-remote-agents` | `hive.remote.agents` | List agents on a peer |
+| `hive-peers` | `hive_peers` | List federation peers |
+| `hive-remote-agents` | `hive_remote_agents` | List agents on a peer |
 
 <details>
 <summary>Manual MCP configuration for each IDE</summary>

package/README.zh.md

@@ -87,59 +87,59 @@ npx kitty-hive init cursor
 
 ## 工具
 
-每个 HTTP 工具 `hive.foo.bar` 都被 channel plugin 镜像成 kebab-case `hive-foo-bar`。下表两列同一组工具，在 Claude Code 里用左列（channel），直接调 HTTP MCP 用右列。
+每个 HTTP 工具 `hive_foo_bar` 都被 channel plugin 镜像成 kebab-case `hive-foo-bar`。下表两列同一组工具，在 Claude Code 里用左列（channel），直接调 HTTP MCP 用右列。（工具名用 `_` 是因为多数 MCP 客户端要求 `^[a-zA-Z0-9_-]{1,64}$`，不接受 `.`）
 
 ### 身份
 
 | Channel | HTTP | 说明 |
 |---------|------|------|
-| `hive-whoami` | `hive.whoami` | 查看自己 agent_id。**首次使用：** 传 `name` 注册（channel plugin 会透明地代理到 `hive.start`） |
-| — | `hive.start` | 底层注册 RPC。HTTP/IDE 用户直接调用（channel 用户走 `hive-whoami`） |
-| `hive-rename` | `hive.rename` | 改全局 display_name |
-| `hive-agents` | `hive.agents` | 列出所有 agent |
+| `hive-whoami` | `hive_whoami` | 查看自己 agent_id。**首次使用：** 传 `name` 注册（channel plugin 会透明地代理到 `hive_start`） |
+| — | `hive_start` | 底层注册 RPC。HTTP/IDE 用户直接调用（channel 用户走 `hive-whoami`） |
+| `hive-rename` | `hive_rename` | 改全局 display_name |
+| `hive-agents` | `hive_agents` | 列出所有 agent |
 
 ### 私信 & 收件箱
 
 | Channel | HTTP | 说明 |
 |---------|------|------|
-| `hive-dm` | `hive.dm` | 发私信。传 `attach: ["/abs/path"]` 发文件/图片（路径是**你**这台机器的；对方拿到 `file_id` 另取） |
-| `hive-inbox` | `hive.inbox` | 查看未读 DM / team / task 事件。每条 DM 带 `message_id` + `attachments` |
-| `hive-dm-read` | `hive.dm.read` | 按 `message_id` 拉单条 DM 全文（preview 结尾 `…(truncated; hive-dm-read message_id=N)` 时用） |
-| `hive-file-fetch` | `hive.file.fetch` | 按 `file_id` 取附件；`save_to` 可复制到指定位置 |
+| `hive-dm` | `hive_dm` | 发私信。传 `attach: ["/abs/path"]` 发文件/图片（路径是**你**这台机器的；对方拿到 `file_id` 另取） |
+| `hive-inbox` | `hive_inbox` | 查看未读 DM / team / task 事件。每条 DM 带 `message_id` + `attachments` |
+| `hive-dm-read` | `hive_dm_read` | 按 `message_id` 拉单条 DM 全文（preview 结尾 `…(truncated; hive-dm-read message_id=N)` 时用） |
+| `hive-file-fetch` | `hive_file_fetch` | 按 `file_id` 取附件；`save_to` 可复制到指定位置 |
 
 ### 团队
 
 | Channel | HTTP | 说明 |
 |---------|------|------|
-| `hive-team-create` | `hive.team.create` | 创建团队（可设昵称） |
-| `hive-team-join` | `hive.team.join` | 按名字或 id 加入团队 |
-| `hive-team-list` | `hive.team.list` | 列出 hive 上所有团队 |
-| `hive-teams` | `hive.teams` | 列出我所在的团队 |
-| `hive-team-info` | `hive.team.info` | 团队成员 + 最近事件 |
-| `hive-team-events` | `hive.team.events` | 增量拉取事件（`since`） |
-| `hive-team-message` | `hive.team.message` | 向团队广播 |
-| `hive-team-nickname` | `hive.team.nickname` | 设置/清除团队内昵称 |
+| `hive-team-create` | `hive_team_create` | 创建团队（可设昵称） |
+| `hive-team-join` | `hive_team_join` | 按名字或 id 加入团队 |
+| `hive-team-list` | `hive_team_list` | 列出 hive 上所有团队 |
+| `hive-teams` | `hive_teams` | 列出我所在的团队 |
+| `hive-team-info` | `hive_team_info` | 团队成员 + 最近事件 |
+| `hive-team-events` | `hive_team_events` | 增量拉取事件（`since`） |
+| `hive-team-message` | `hive_team_message` | 向团队广播 |
+| `hive-team-nickname` | `hive_team_nickname` | 设置/清除团队内昵称 |
 
 ### 任务 & 工作流
 
 | Channel | HTTP | 说明 |
 |---------|------|------|
-| `hive-task` | `hive.task` | 创建并委派（`to` 接 id / nickname / `role:xxx` / `id@node`） |
-| `hive-task-claim` | `hive.task.claim` | 认领未分配任务 |
-| `hive-tasks` | `hive.tasks` | 任务看板 |
-| `hive-check` | `hive.check` | 查看任务状态 |
-| `hive-workflow-propose` | `hive.workflow.propose` | 提出工作流方案；每步可设 `gate: true` → 完成后停在 `awaiting_approval` 等创建者放行 |
-| `hive-workflow-approve` | `hive.workflow.approve` | 批准提案（仅创建者） |
-| `hive-workflow-step-complete` | `hive.workflow.step.complete` | 完成步骤（gated 步骤会进入 `awaiting_approval`） |
-| `hive-workflow-step-approve` | `hive.workflow.step.approve` | 放行 gated 步骤的暂停（仅创建者） |
-| `hive-workflow-reject` | `hive.workflow.reject` | 拒绝并回退（在 `in_progress` 和 `awaiting_approval` 都可调用） |
+| `hive-task` | `hive_task` | 创建并委派（`to` 接 id / nickname / `role:xxx` / `id@node`） |
+| `hive-task-claim` | `hive_task_claim` | 认领未分配任务 |
+| `hive-tasks` | `hive_tasks` | 任务看板 |
+| `hive-check` | `hive_check` | 查看任务状态 |
+| `hive-workflow-propose` | `hive_workflow_propose` | 提出工作流方案；每步可设 `gate: true` → 完成后停在 `awaiting_approval` 等创建者放行 |
+| `hive-workflow-approve` | `hive_workflow_approve` | 批准提案（仅创建者） |
+| `hive-workflow-step-complete` | `hive_workflow_step_complete` | 完成步骤（gated 步骤会进入 `awaiting_approval`） |
+| `hive-workflow-step-approve` | `hive_workflow_step_approve` | 放行 gated 步骤的暂停（仅创建者） |
+| `hive-workflow-reject` | `hive_workflow_reject` | 拒绝并回退（在 `in_progress` 和 `awaiting_approval` 都可调用） |
 
 ### 联邦
 
 | Channel | HTTP | 说明 |
 |---------|------|------|
-| `hive-peers` | `hive.peers` | 列出 peer |
-| `hive-remote-agents` | `hive.remote.agents` | 列出 peer 上的 agent |
+| `hive-peers` | `hive_peers` | 列出 peer |
+| `hive-remote-agents` | `hive_remote_agents` | 列出 peer 上的 agent |
 
 <details>
 <summary>各 IDE 手动配置方式</summary>

package/channel.ts

@@ -43,7 +43,7 @@ async function hivePost(method: string, params: any = {}, _retried = false): Pro
     console.error(`[hive-channel] server returned 404 (stale session); re-initializing...`)
     sessionId = null
     await initHiveSession()
-    if (agentId) await hiveCallTool('hive.start', { id: agentId, tool: 'claude', roles: 'channel' }, true)
+    if (agentId) await hiveCallTool('hive_start', { id: agentId, tool: 'claude', roles: 'channel' }, true)
     return hivePost(method, params, true)
   }
 
@@ -92,7 +92,7 @@ async function registerAgent(opts: { id?: string; name?: string }) {
   const args: any = { tool: 'claude', roles: 'channel' }
   if (opts.id) args.id = opts.id
   if (opts.name) args.name = opts.name
-  const result = await hiveCallTool('hive.start', args)
+  const result = await hiveCallTool('hive_start', args)
   agentId = result.agent_id
   agentName = result.display_name
   if (!sseStarted) {
@@ -157,7 +157,7 @@ const mcp = new Server(
 )
 
 // --- Dynamic tool proxy ---
-// Channel discovers hive.* tools from the HTTP server at startup, then exposes
+// Channel discovers hive_* tools from the HTTP server at startup, then exposes
 // them as kebab-case `hive-*` tools. Calls are forwarded with `as: agentId`
 // injected. Only `hive-whoami` is implemented locally (manages session state).
 
@@ -170,11 +170,11 @@ interface MCPTool {
 let cachedHiveTools: MCPTool[] = []
 
 function hiveToKebab(name: string): string {
-  return name.replace(/\./g, '-')
+  return name.replace(/_/g, '-')
 }
 
 function kebabToHive(name: string): string {
-  return name.replace(/-/g, '.')
+  return name.replace(/-/g, '_')
 }
 
 function stripAsParam(schema: any): any {
@@ -190,7 +190,7 @@ function stripAsParam(schema: any): any {
 async function refreshHiveTools(): Promise<void> {
   try {
     const result = await hivePost('tools/list', {})
-    cachedHiveTools = (result.tools || []).filter((t: MCPTool) => t.name.startsWith('hive.'))
+    cachedHiveTools = (result.tools || []).filter((t: MCPTool) => t.name.startsWith('hive_'))
   } catch (err) {
     console.error('[hive-channel] failed to fetch tool list:', err)
   }
@@ -209,8 +209,8 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => {
   if (cachedHiveTools.length === 0) await refreshHiveTools()
   const tools: MCPTool[] = [WHOAMI_TOOL]
   for (const t of cachedHiveTools) {
-    // hive.whoami is served locally (manages registration state)
-    if (t.name === 'hive.whoami') continue
+    // hive_whoami is served locally (manages registration state)
+    if (t.name === 'hive_whoami') continue
     tools.push({
       name: hiveToKebab(t.name),
       description: t.description,
@@ -249,7 +249,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     }
   }
 
-  // Proxy all other hive-* tools to hive.* with `as: agentId` injected
+  // Proxy all other hive-* tools to hive_* with `as: agentId` injected
   if (!name.startsWith('hive-')) throw new Error(`Unknown tool: ${name}`)
   const hiveName = kebabToHive(name)
   const result = await hiveCallTool(hiveName, { as: agentId, ...args })
@@ -285,7 +285,7 @@ async function listenSSE() {
         console.error(`[hive-channel] SSE connect failed: ${res.status}, re-registering...`)
         try {
           await initHiveSession()
-          if (agentId) await hiveCallTool('hive.start', { id: agentId, tool: 'claude', roles: 'channel' })
+          if (agentId) await hiveCallTool('hive_start', { id: agentId, tool: 'claude', roles: 'channel' })
         } catch (e) {
           console.error(`[hive-channel] re-register failed:`, e)
         }

package/dist/auth.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { getAgentById, touchAgent } from './db.js';
 import { sessionAgents } from './sessions.js';
-export const asParam = z.string().optional().describe('Your agent id (from hive.start). Optional — session binding takes precedence.');
+export const asParam = z.string().optional().describe('Your agent id (from hive_start). Optional — session binding takes precedence.');
 export function resolveAgent(extra, asValue) {
     // 1) Session binding (preferred)
     const sessionId = extra?.sessionId;
@@ -27,7 +27,7 @@ export function resolveAgent(extra, asValue) {
 }
 export function authError() {
     return {
-        content: [{ type: 'text', text: 'Error: Not authenticated. Call hive.start first.' }],
+        content: [{ type: 'text', text: 'Error: Not authenticated. Call hive_start first.' }],
         isError: true,
     };
 }

package/dist/index.js

@@ -186,7 +186,7 @@ async function cmdInit() {
             console.log(`  ${t.padEnd(12)} ${path}`);
         }
     }
-    console.log(`\n  Agent registers via hive.start when first used.`);
+    console.log(`\n  Agent registers via hive_start when first used.`);
 }
 function relativeTime(iso) {
     if (!iso)

package/dist/interactive.js

@@ -34,7 +34,7 @@ function listLocalAgents(db) {
 export async function pickLocalAgent(db, message) {
     const agents = listLocalAgents(db);
     if (agents.length === 0) {
-        console.log('No local agents registered yet. (Agents register on first hive.start.)');
+        console.log('No local agents registered yet. (Agents register on first hive_start.)');
         process.exit(1);
     }
     if (agents.length === 1)
@@ -51,7 +51,7 @@ export async function pickLocalAgent(db, message) {
 export async function pickLocalAgents(db, message, initial = []) {
     const agents = listLocalAgents(db);
     if (agents.length === 0) {
-        console.log('No local agents to expose. Register one first via hive.start.');
+        console.log('No local agents to expose. Register one first via hive_start.');
         return [];
     }
     return askMultiselect({

package/dist/mcp/agent-tools.js

@@ -4,7 +4,7 @@ import { renameAgent, listAllAgents, getAgentsByName } from '../db.js';
 import { asParam, authError, resolveAgent } from '../auth.js';
 import { bindSession } from '../sessions.js';
 export function registerAgentTools(mcp) {
-    mcp.tool('hive.start', 'Register or reconnect as an agent. Returns your agent_id (used for cross-team addressing). The MCP session is automatically bound to the returned agent so push notifications target the right session. (Channel-plugin users: prefer hive-whoami for first-time registration; this is the underlying server tool.)', {
+    mcp.tool('hive_start', 'Register or reconnect as an agent. Returns your agent_id (used for cross-team addressing). The MCP session is automatically bound to the returned agent so push notifications target the right session. (Channel-plugin users: prefer hive-whoami for first-time registration; this is the underlying server tool.)', {
         id: z.string().optional().describe('Agent id to reconnect to (exact match). Errors if not found.'),
         name: z.string().optional().describe('Display name (random if omitted). Reuses latest existing agent with this name.'),
         roles: z.string().optional().describe('Comma-separated roles: ux,frontend,backend'),
@@ -16,11 +16,11 @@ export function registerAgentTools(mcp) {
             bindSession(extra.sessionId, result.agent_id);
         }
         else {
-            console.warn(`[hive.start] WARNING: no sessionId in extra (stateless?). agent=${result.agent_id} will NOT receive push.`);
+            console.warn(`[hive_start] WARNING: no sessionId in extra (stateless?). agent=${result.agent_id} will NOT receive push.`);
         }
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.whoami', 'Show the agent currently bound to this session (or via `as`).', { as: asParam }, async (params, extra) => {
+    mcp.tool('hive_whoami', 'Show the agent currently bound to this session (or via `as`).', { as: asParam }, async (params, extra) => {
         const agent = resolveAgent(extra, params.as);
         if (!agent)
             return authError();
@@ -38,7 +38,7 @@ export function registerAgentTools(mcp) {
                 }],
         };
     });
-    mcp.tool('hive.rename', 'Change your global display_name (display only — addressing uses id).', {
+    mcp.tool('hive_rename', 'Change your global display_name (display only — addressing uses id).', {
         as: asParam,
         name: z.string().describe('New display name'),
     }, async (params, extra) => {
@@ -49,7 +49,7 @@ export function registerAgentTools(mcp) {
         renameAgent(agent.id, params.name);
         return { content: [{ type: 'text', text: JSON.stringify({ agent_id: agent.id, old_name: oldName, new_name: params.name }) }] };
     });
-    mcp.tool('hive.agents', 'List all known agents on this hive. Use this to find agent ids for cross-team DM/task.', {
+    mcp.tool('hive_agents', 'List all known agents on this hive. Use this to find agent ids for cross-team DM/task.', {
         active_only: z.boolean().optional().describe('Only show active agents (default false)'),
         name: z.string().optional().describe('Filter by display_name (may match multiple)'),
     }, async (params) => {

package/dist/mcp/dm-tools.js

@@ -9,9 +9,9 @@ import { getFilePath, getFileMeta } from '../files.js';
 import { buildDMPreview, CHANNEL_PREVIEW_LEN } from '../preview.js';
 import * as db from '../db.js';
 export function registerDMTools(mcp) {
-    mcp.tool('hive.dm', 'Send a direct message to another agent. `to` accepts agent id, team-nickname (within your teams), display_name (only if unambiguous), or "id@node" for federation. ' +
+    mcp.tool('hive_dm', 'Send a direct message to another agent. `to` accepts agent id, team-nickname (within your teams), display_name (only if unambiguous), or "id@node" for federation. ' +
         'IMPORTANT: any file path you mention in `content` is local-to-YOUR-machine ONLY — the receiver cannot read it (they may be on a different OS). ' +
-        'To actually share a file, pass `attach: [absolute path on YOUR disk]`; hive copies the bytes into storage (replicating across federation if needed) and the receiver gets a `file_id` they fetch via `hive.file.fetch`. ' +
+        'To actually share a file, pass `attach: [absolute path on YOUR disk]`; hive copies the bytes into storage (replicating across federation if needed) and the receiver gets a `file_id` they fetch via `hive_file_fetch`. ' +
         'Use `attach` for screenshots, PDFs, CSVs, logs, pasted-image temp files, anything binary.', {
         as: asParam,
         to: z.string().describe('Target: agent id, team-nickname, display_name, or "id@node"'),
@@ -37,7 +37,7 @@ export function registerDMTools(mcp) {
         }
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.dm.read', 'Fetch a single DM in full by message_id. Use whenever a preview contains a `[hive note]` paragraph mentioning hive-dm-read — the visible text is only the first 200/2000 characters. Returns the full content, attachments, sender, and timestamp.', { message_id: z.number().describe('Message id — the integer N from the truncation hint, from `message_id` in hive-inbox latest entries, or from the `message_id` meta field on channel notifications') }, async (params) => {
+    mcp.tool('hive_dm_read', 'Fetch a single DM in full by message_id. Use whenever a preview contains a `[hive note]` paragraph mentioning hive-dm-read — the visible text is only the first 200/2000 characters. Returns the full content, attachments, sender, and timestamp.', { message_id: z.number().describe('Message id — the integer N from the truncation hint, from `message_id` in hive-inbox latest entries, or from the `message_id` meta field on channel notifications') }, async (params) => {
         const msg = db.getDMById(params.message_id);
         if (!msg)
             return { content: [{ type: 'text', text: JSON.stringify({ error: `Message not found: ${params.message_id}` }) }], isError: true };
@@ -62,7 +62,7 @@ export function registerDMTools(mcp) {
                 }],
         };
     });
-    mcp.tool('hive.file.fetch', 'Fetch an attachment by file_id (from a DM you received). Returns a `path` on the hive node serving you (your local hive when running locally; the receiver\'s hive in federated setups — already replicated). Pass `save_to` to copy it to a path of your choice (a trailing "/" treats it as a directory and keeps the original filename).', {
+    mcp.tool('hive_file_fetch', 'Fetch an attachment by file_id (from a DM you received). Returns a `path` on the hive node serving you (your local hive when running locally; the receiver\'s hive in federated setups — already replicated). Pass `save_to` to copy it to a path of your choice (a trailing "/" treats it as a directory and keeps the original filename).', {
         file_id: z.string().describe('Attachment file_id (from hive-inbox latest entry attachments, or from a channel notification)'),
         save_to: z.string().optional().describe('Optional destination path; pass a trailing "/" to copy into a directory keeping the original filename.'),
     }, async (params) => {
@@ -82,7 +82,7 @@ export function registerDMTools(mcp) {
         }
         return { content: [{ type: 'text', text: JSON.stringify({ ...meta, path: sourcePath, saved_to: saved }) }] };
     });
-    mcp.tool('hive.inbox', 'Check unread DMs, team events, and task events. Marks returned items as read.', { as: asParam }, async (params, extra) => {
+    mcp.tool('hive_inbox', 'Check unread DMs, team events, and task events. Marks returned items as read.', { as: asParam }, async (params, extra) => {
         const agent = resolveAgent(extra, params.as);
         if (!agent)
             return authError();

package/dist/mcp/federation-tools.js

@@ -16,7 +16,7 @@ async function fetchRemoteAgents(peer) {
     return res.json();
 }
 export function registerFederationTools(mcp) {
-    mcp.tool('hive.peers', 'List all known federation peers (each entry includes name, status active/inactive, exposed agents, last_seen).', {}, async () => {
+    mcp.tool('hive_peers', 'List all known federation peers (each entry includes name, status active/inactive, exposed agents, last_seen).', {}, async () => {
         const peers = db.listPeers();
         const result = peers.map(p => ({
             name: p.name, node: p.node_name, url: p.url, status: p.status,
@@ -24,7 +24,7 @@ export function registerFederationTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
-    mcp.tool('hive.remote.agents', 'List agents that a remote peer has exposed to us. Cached 5 minutes; pass fresh=true to bypass. After getting an agent id from here, address them in DM/task as "<agent_id>@<peer-name>".', {
+    mcp.tool('hive_remote_agents', 'List agents that a remote peer has exposed to us. Cached 5 minutes; pass fresh=true to bypass. After getting an agent id from here, address them in DM/task as "<agent_id>@<peer-name>".', {
         peer: z.string().describe('Peer name (as shown by hive-peers)'),
         fresh: z.boolean().optional().describe('Bypass the 5-minute cache and re-query the peer'),
     }, async (params) => {

package/dist/mcp/server.js

@@ -19,19 +19,19 @@ export function createMcpServer() {
             'kitty-hive is a multi-agent collaboration server.',
             '',
             '## Identity',
-            '- agent_id (ULID) is your stable cross-team handle. Get it from hive.start.',
+            '- agent_id (ULID) is your stable cross-team handle. Get it from hive_start.',
             '- display_name is for display only, not unique.',
-            '- Inside a team, members can have unique nicknames (set with hive.team.nickname).',
+            '- Inside a team, members can have unique nicknames (set with hive_team_nickname).',
             '',
             '## Addressing',
             '- DM and task `to`: prefer agent_id. team-nickname or display_name also accepted if unambiguous.',
             '- Federation: use "id@node" or "nickname@node".',
             '',
             '## Workflow rules',
-            '- When you receive a task, propose a workflow (hive.workflow.propose) before starting.',
-            '- The creator approves (hive.workflow.approve). NEVER auto-approve — show the proposal to the user.',
-            '- Mark each step with hive.workflow.step.complete.',
-            '- Claim unassigned tasks with hive.task.claim.',
+            '- When you receive a task, propose a workflow (hive_workflow_propose) before starting.',
+            '- The creator approves (hive_workflow_approve). NEVER auto-approve — show the proposal to the user.',
+            '- Mark each step with hive_workflow_step_complete.',
+            '- Claim unassigned tasks with hive_task_claim.',
             '',
             '## Artifacts',
             'Use ~/.kitty-hive/artifacts/<task_id>/ for cross-agent file exchange.',
@@ -47,7 +47,7 @@ export function createMcpServer() {
         const sessionId = extra?.sessionId;
         const agentId = sessionId ? sessionAgents.get(sessionId) : undefined;
         if (!agentId) {
-            return { contents: [{ uri: uri.href, text: '{"error":"Not authenticated. Call hive.start first."}' }] };
+            return { contents: [{ uri: uri.href, text: '{"error":"Not authenticated. Call hive_start first."}' }] };
         }
         const unread = getUnreadForAgent(agentId);
         return {

package/dist/mcp/task-tools.js

@@ -4,7 +4,7 @@ import { asParam, authError, resolveAgent } from '../auth.js';
 import { notifyAgents, notifyTaskParticipants } from '../sessions.js';
 import * as db from '../db.js';
 export function registerTaskTools(mcp) {
-    mcp.tool('hive.task', 'Create a task and (optionally) delegate. Omit `to` to create an unassigned task that anyone can claim.', {
+    mcp.tool('hive_task', 'Create a task and (optionally) delegate. Omit `to` to create an unassigned task that anyone can claim.', {
         as: asParam,
         to: z.string().optional().describe('Target. Accepts: agent id (always works) · team-nickname (only resolved within teams you both belong to) · display_name (only if globally unambiguous) · "role:xxx" (picks an active agent with that role) · "id@<peer-name>" for federation.'),
         title: z.string().describe('Task title'),
@@ -22,7 +22,7 @@ export function registerTaskTools(mcp) {
         }
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.task.claim', 'Claim an unassigned task (status "created", no assignee).', { as: asParam, task_id: z.string().describe('Task id') }, async (params, extra) => {
+    mcp.tool('hive_task_claim', 'Claim an unassigned task (status "created", no assignee).', { as: asParam, task_id: z.string().describe('Task id') }, async (params, extra) => {
         const agent = resolveAgent(extra, params.as);
         if (!agent)
             return authError();
@@ -33,7 +33,7 @@ export function registerTaskTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.tasks', 'List tasks you created or are assigned to.', {
+    mcp.tool('hive_tasks', 'List tasks you created or are assigned to.', {
         as: asParam,
         status: z.string().optional().describe('Filter by status. Valid values: created, proposing, approved, in_progress, awaiting_approval, completed, failed, canceled.'),
     }, async (params, extra) => {
@@ -51,11 +51,11 @@ export function registerTaskTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify(board, null, 2) }] };
     });
-    mcp.tool('hive.check', 'Check the current state of a task by id.', { task_id: z.string().describe('Task id') }, async (params) => {
+    mcp.tool('hive_check', 'Check the current state of a task by id.', { task_id: z.string().describe('Task id') }, async (params) => {
         const result = handleCheck(params);
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.workflow.propose', 'Propose a workflow for a task. Creator must approve before steps start. ' +
+    mcp.tool('hive_workflow_propose', 'Propose a workflow for a task. Creator must approve before steps start. ' +
         'For multi-phase workflows where the user (creator) will want to review the output between phases, ' +
         'set `gate: true` on each phase — the task then pauses in status `awaiting_approval` after each gated step ' +
         'until the creator calls hive-workflow-step-approve. Default (no gate) auto-advances to the next step.', {
@@ -81,7 +81,7 @@ export function registerTaskTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify({ task_id: params.task_id, status: 'proposing', steps: params.workflow.length }) }] };
     });
-    mcp.tool('hive.workflow.approve', 'Approve a proposed workflow (creator only). Starts step 1.', { as: asParam, task_id: z.string().describe('Task id') }, async (params, extra) => {
+    mcp.tool('hive_workflow_approve', 'Approve a proposed workflow (creator only). Starts step 1.', { as: asParam, task_id: z.string().describe('Task id') }, async (params, extra) => {
         const agent = resolveAgent(extra, params.as);
         if (!agent)
             return authError();
@@ -92,7 +92,7 @@ export function registerTaskTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify({ task_id: params.task_id, status: 'approved', action }) }] };
     });
-    mcp.tool('hive.workflow.step.complete', 'Mark your part of the current step as complete. If the step has `gate: true` and you were the last assignee, the task enters `awaiting_approval` instead of auto-advancing — the creator must call hive-workflow-step-approve to release the gate.', {
+    mcp.tool('hive_workflow_step_complete', 'Mark your part of the current step as complete. If the step has `gate: true` and you were the last assignee, the task enters `awaiting_approval` instead of auto-advancing — the creator must call hive-workflow-step-approve to release the gate.', {
         as: asParam,
         task_id: z.string().describe('Task id'),
         step: z.number().describe('Step number'),
@@ -126,7 +126,7 @@ export function registerTaskTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify({ task_id: params.task_id, action: action || 'waiting' }) }] };
     });
-    mcp.tool('hive.workflow.step.approve', 'Release a gated step\'s `awaiting_approval` pause. Creator-only. ' +
+    mcp.tool('hive_workflow_step_approve', 'Release a gated step\'s `awaiting_approval` pause. Creator-only. ' +
         'Call this after reviewing the output of a step that was proposed with `gate: true`. ' +
         'Advances to the next step (or completes the task if it was the last step).', {
         as: asParam,
@@ -145,7 +145,7 @@ export function registerTaskTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify({ task_id: params.task_id, action }) }] };
     });
-    mcp.tool('hive.workflow.reject', 'Reject the current step. Sends task back to a previous step.', {
+    mcp.tool('hive_workflow_reject', 'Reject the current step. Sends task back to a previous step.', {
         as: asParam,
         task_id: z.string().describe('Task id'),
         step: z.number().describe('Step being rejected'),

package/dist/mcp/team-tools.js

@@ -3,7 +3,7 @@ import { handleTeamCreate, handleTeamJoin, handleTeamList, handleTeamInfo, handl
 import { asParam, authError, resolveAgent } from '../auth.js';
 import { notifyTeamMembers } from '../sessions.js';
 export function registerTeamTools(mcp) {
-    mcp.tool('hive.team.create', 'Create a new team. Optionally set your nickname in this team.', {
+    mcp.tool('hive_team_create', 'Create a new team. Optionally set your nickname in this team.', {
         as: asParam,
         name: z.string().describe('Team name (must be globally unique)'),
         nickname: z.string().optional().describe('Your nickname in this team (must be unique within team)'),
@@ -14,7 +14,7 @@ export function registerTeamTools(mcp) {
         const result = handleTeamCreate(agent.id, { name: params.name, nickname: params.nickname });
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.team.join', 'Join an existing team by name or id.', {
+    mcp.tool('hive_team_join', 'Join an existing team by name or id.', {
         as: asParam,
         team_id: z.string().optional().describe('Team id'),
         name: z.string().optional().describe('Team name'),
@@ -31,11 +31,11 @@ export function registerTeamTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.team.list', 'List all teams on this hive (with their members).', {}, async () => {
+    mcp.tool('hive_team_list', 'List all teams on this hive (with their members).', {}, async () => {
         const result = handleTeamList();
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.team.info', 'Get detailed info about a team you are in (members with nicknames + recent events).', {
+    mcp.tool('hive_team_info', 'Get detailed info about a team you are in (members with nicknames + recent events).', {
         as: asParam,
         team_id: z.string().describe('Team id'),
     }, async (params, extra) => {
@@ -45,7 +45,7 @@ export function registerTeamTools(mcp) {
         const result = handleTeamInfo(agent.id, { team_id: params.team_id });
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.team.events', 'Fetch events from a team. Use "since" for incremental polling.', {
+    mcp.tool('hive_team_events', 'Fetch events from a team. Use "since" for incremental polling.', {
         as: asParam,
         team_id: z.string().describe('Team id'),
         since: z.number().optional().describe('Return events after this seq number'),
@@ -57,7 +57,7 @@ export function registerTeamTools(mcp) {
         const result = handleTeamEvents(agent.id, { team_id: params.team_id, since: params.since, limit: params.limit });
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.team.message', 'Post a message to a team (broadcasts to all members).', {
+    mcp.tool('hive_team_message', 'Post a message to a team (broadcasts to all members).', {
         as: asParam,
         team_id: z.string().describe('Team id'),
         content: z.string().describe('Message content'),
@@ -73,7 +73,7 @@ export function registerTeamTools(mcp) {
         }));
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.team.nickname', 'Set or change your nickname within a team. Pass null to clear.', {
+    mcp.tool('hive_team_nickname', 'Set or change your nickname within a team. Pass null to clear.', {
         as: asParam,
         team_id: z.string().describe('Team id'),
         nickname: z.string().nullable().describe('New nickname (or null to clear)'),
@@ -84,7 +84,7 @@ export function registerTeamTools(mcp) {
         const result = handleTeamNickname(agent.id, { team_id: params.team_id, nickname: params.nickname });
         return { content: [{ type: 'text', text: JSON.stringify(result) }] };
     });
-    mcp.tool('hive.teams', 'List teams you are a member of (with your nickname in each).', { as: asParam }, async (params, extra) => {
+    mcp.tool('hive_teams', 'List teams you are a member of (with your nickname in each).', { as: asParam }, async (params, extra) => {
         const agent = resolveAgent(extra, params.as);
         if (!agent)
             return authError();

package/dist/server.js

@@ -68,7 +68,7 @@ export async function startServer(port, dbPath) {
             const sid = req.headers['mcp-session-id'];
             const method = body?.method || (Array.isArray(body) ? `batch[${body.length}]` : 'unknown');
             const tool = body?.params?.name || '';
-            const isHeartbeat = tool === 'hive.inbox' || method === 'notifications/initialized';
+            const isHeartbeat = tool === 'hive_inbox' || method === 'notifications/initialized';
             if (!isHeartbeat) {
                 log('info', `[rpc] method=${method} sid=${sid || 'none'} tool=${tool || '-'}`);
             }

package/dist/tools/task.js

@@ -188,7 +188,7 @@ export async function handleTaskClaimAsync(taskId, agentId) {
         await forwardTaskEvent(task, agentId, 'task-claim', {});
     return out;
 }
-// --- hive.task.claim ---
+// --- hive_task_claim ---
 export function handleTaskClaim(taskId, agentId) {
     const task = getTaskById(taskId);
     if (!task)

package/dist/tools/team.js

@@ -1,5 +1,5 @@
 import { createTeam, getTeamById, getTeamByName, listTeams, getAgentTeams, addTeamMember, isTeamMember, getTeamMembers, getTeamMember, setTeamNickname, appendTeamEvent, getTeamEvents, getLatestTeamEvents, getAgentById, } from '../db.js';
-// --- hive.team.create ---
+// --- hive_team_create ---
 export function handleTeamCreate(actorId, input) {
     const existing = getTeamByName(input.name);
     if (existing)
@@ -9,7 +9,7 @@ export function handleTeamCreate(actorId, input) {
     appendTeamEvent(team.id, 'join', actorId, { nickname: input.nickname ?? null });
     return { team_id: team.id, name: team.name };
 }
-// --- hive.team.join ---
+// --- hive_team_join ---
 export function handleTeamJoin(actorId, input) {
     let team;
     if (input.team_id)
@@ -64,7 +64,7 @@ export function handleTeamInfo(actorId, input) {
         latest_events: getLatestTeamEvents(input.team_id, 10),
     };
 }
-// --- hive.team.events ---
+// --- hive_team_events ---
 export function handleTeamEvents(actorId, input) {
     if (!isTeamMember(input.team_id, actorId))
         throw new Error('Not a member of this team');
@@ -75,14 +75,14 @@ export function handleTeamEvents(actorId, input) {
         events.pop();
     return { events, has_more: hasMore };
 }
-// --- hive.team.message ---
+// --- hive_team_message ---
 export function handleTeamMessage(actorId, input) {
     if (!isTeamMember(input.team_id, actorId))
         throw new Error('Not a member of this team');
     const event = appendTeamEvent(input.team_id, 'message', actorId, { content: input.content });
     return { team_id: input.team_id, event_id: event.id, seq: event.seq };
 }
-// --- hive.team.nickname ---
+// --- hive_team_nickname ---
 export function handleTeamNickname(actorId, input) {
     if (!isTeamMember(input.team_id, actorId))
         throw new Error('Not a member of this team');
@@ -98,7 +98,7 @@ export function handleTeamNickname(actorId, input) {
     });
     return { team_id: input.team_id, nickname: input.nickname, old_nickname: member.nickname };
 }
-// --- hive.team.list (mine) ---
+// --- hive_team_list (mine) ---
 export function handleMyTeams(actorId) {
     const teams = getAgentTeams(actorId, true);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitty-hive",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "MCP server for multi-agent collaboration — DM, tasks, workflow, federation",
   "type": "module",
   "main": "dist/index.js",