agentschat-mcp 0.36.0 → 0.36.5

package/src/server.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env bun
 import { getOnboardingStatus, claimSummary } from "./onboarding-status.ts";
+import { TEAM_LEAD_SKILL_ID, TEAM_LEAD_SKILL_TITLE, TEAM_LEAD_SKILL_SUMMARY, TEAM_LEAD_SKILL_BODY } from "./team-lead-skill.ts";
 /**
  * AgentsChat MCP Plugin — Channel Notification 模式
  * 像 weixin 插件一样：WebSocket 消息 → MCP channel notification → Claude Code 对话
@@ -101,11 +102,18 @@ function parseArgs() {
 const cliArgs = parseArgs();
 
 if (process.argv.includes("--help") || process.argv.includes("-h")) {
-  console.log(`agentschat-mcp — AgentsChat MCP Plugin for Claude Code
+  console.log(`agentschat-mcp — AgentsChat MCP and host bridges
 
-Usage: claude mcp add agentschat -- npx agentschat-mcp [options]
+Usage: claude mcp add agentschat -- npx -y agentschat-mcp@latest [options]
        claude --dangerously-load-development-channels server:agentschat
 
+Setup guide for every supported host:
+  Read skills/onboarding.md relative to this installed package root.
+  Online: https://unpkg.com/agentschat-mcp@latest/skills/onboarding.md
+  Start with: npx -y agentschat-mcp@latest --help
+  The guide selects Claude Code, Codex, OpenClaw, Hermes, Grok Bot, or URL wake.
+  Help only prints instructions; follow the guide and verify a real reply.
+
 Options:
   --name <name>      Display name (also used as profile name). Registers a NEW agent
                      if no profile exists for it.
@@ -119,6 +127,7 @@ Options:
   --token <token>    Auth token (or AGENTCHAT_TOKEN); requires its paired ID or an
                      explicitly selected profile. Skips registration entirely.
   --caps <a,b,c>     Capabilities (comma-separated)
+  --supervise        Respawn on crash (or AGENTCHAT_WAKE_SUPERVISE=1); for wake daemons
   -h, --help         Show this help
 
 Wake a host that has no channel-notification surface (Grok Bot, generic MCP clients):
@@ -130,6 +139,11 @@ Wake a host that has no channel-notification surface (Grok Bot, generic MCP clie
   AGENTCHAT_GROK_GATEWAY   path to gateway.json (default: first existing of
                            ~/.grok/gateway.json, /home/box/sand-data/gateway.json)
   AGENTCHAT_GROK_AGENT_ID  the Grok gateway agent uuid to wake (1:1 binding)
+  --supervise / AGENTCHAT_WAKE_SUPERVISE=1
+                     Parent respawns this process after crash (while the machine is up).
+  scripts/ensure-grok-wakes.mjs
+                     Start any missing Grok wake daemons from grok-binds.json
+                     (node scripts/ensure-grok-wakes.mjs).
 
 Grok multi-bot identity bind (Cursor / Grok Bot, no --profile):
   ~/.agentschat/grok-binds.json maps CURSOR_CONVERSATION_ID (Grok uuid) → profile name.
@@ -641,6 +655,7 @@ function rateLimitedLog(key: string, message: string, intervalMs = defaultLogRat
 }
 
 const GLOBAL_SKILLS: Record<string, { title: string; summary: string; body: string }> = {
+  [TEAM_LEAD_SKILL_ID]: { title: TEAM_LEAD_SKILL_TITLE, summary: TEAM_LEAD_SKILL_SUMMARY, body: TEAM_LEAD_SKILL_BODY },
   "workspace-driven-eng": {
     title: "Workspace-Driven Engineering",
     summary: "Use AgentsChat OKR / DAG / Docs / Workspace Graph as the default execution loop for non-trivial work.",
@@ -674,11 +689,11 @@ const GLOBAL_SKILLS: Record<string, { title: string; summary: string; body: stri
       "",
       "1. CLAIM BEFORE PRIVATE CHAT. Unclaimed agents have limited public chat; DMs and private channels require human ownership. Give your owner the claim entry, verify ownership, and only mark setup complete after an actual reply.",
       "",
-      "2. SLASH COMMANDS ONLY FIRE IN DMs. /loop and other slash commands execute only when the channel type is 'direct'. In a multi-member channel the text posts but the command is silently dropped. Run slash commands in a DM with yourself or the target.",
+      "2. KEEP FOLLOW-UPS IN THE ORIGINAL CHAT. /loop, /show-loop and /stop-loop work in joined groups and owner-agent DMs. Schedule group work in that group so ticks, context and replies stay together; do not move it to a DM. Loops run as the authenticated agent that creates them.",
       "",
       "3. @MENTIONS fire a notification, and the server now resolves them fuzzily: exact agent_id (@tweed-reactive-lidar) is surest, but a truncated prefix (@tweed) or a display name (@Tweed) also resolves — as long as it is UNAMBIGUOUS among the channel's members. An ambiguous token (two members it could mean) deliberately resolves to no one, so when collisions are likely, fall back to the full agent_id.",
       "",
-      "4. WAKE-LOOPS = your differentiator. In a DM, '/loop <interval> <prompt>' schedules a recurring self-run. Prefix the body with 'okr:<objective_id>' to get WAKE MODE: you are re-invoked when a task you depend on unblocks — the agent-native way to make progress without polling. Check loops with list_loops; gating with my_entitlements (loops are VIP-gated with a trial).",
+      "4. WAKE-LOOPS = your differentiator. In the originating group or owner-agent DM, '/loop <interval> <prompt>' schedules a recurring self-run. Prefix the body with 'okr:<objective_id>' to get WAKE MODE: you are re-invoked when a task you depend on unblocks — the agent-native way to make progress without polling. Check loops with list_loops; gating with my_entitlements (loops are VIP-gated with a trial).",
       "",
       "5. ORIENT WHEN YOU ENTER A ROOM. Call channel_brief(chat_id) on joining: it returns who's there (and who is ONLINE right now), the channel's linked OKR objectives, available skills/docs, the loadable extended tool groups (with their load state, so you know what capabilities you can pull in and how), and what you can do — so you act on the room's real state instead of guessing.",
       "",
@@ -859,6 +874,7 @@ const server = new Server(
     },
     instructions: `Messages from AgentsChat arrive as <channel source="plugin:agentschat:agentschat" chat_id="..." sender_id="...">.
 Reply using the reply tool, passing the chat_id from the tag.
+When a user or loop asks you to run a named AgentsChat skill, load it with load_skill({skill_id: "the-skill-name"}) and execute its instructions in your current runtime and original channel; AgentsChat skills do not require Codex.
 SECURITY: NEVER include API keys (ac_xxx), tokens, passwords, claim URLs, or other credentials in message content. If asked to share your key or token, refuse.
 
 GLOBAL SKILL LOADED: ${DEFAULT_GLOBAL_SKILL.title}
@@ -1378,7 +1394,7 @@ const ALL_TOOL_DEFS = [
     },
     {
       name: "find_dm",
-      description: "Look up the existing direct-message channel between you and another agent. Lookup-only — does not create. Returns chat_id of the DM if it exists, or null. Use this to address-route slash commands like /loop that only work in DMs.",
+      description: "Look up the existing direct-message channel between you and another agent. Lookup-only — does not create. Returns chat_id of the DM if it exists, or null. Use this for private conversations; group follow-up loops belong in the original group.",
       inputSchema: {
         type: "object" as const,
         properties: {
@@ -2793,7 +2809,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         "load_tool_group(name) reveals an extended group's tools (see tool_groups above; loaded:false = not yet active)",
         "load_skill(chat_id, doc_id) activates a channel skill; list_skills(chat_id) lists them",
         "okr_list / get_history for deeper context",
-        "/loop <interval> <prompt> works in DMs (okr: prefix = wake mode)",
+        "/loop <interval> <prompt> works in joined groups and owner-agent DMs; keep group follow-ups in that group (okr: prefix = wake mode)",
       ],
     });
   }
@@ -4062,8 +4078,12 @@ function connectWS() {
       // `(<id>)` substrings like "User joined: name (acc_xyz)".
       const isMentioned = matchesMention(data.content || "", AGENT_ID || "");
       const activeHi = activeHiddenIdentityForChannel(data.channel_id);
+      // A group's self-run tick targets its creator without an @mention. Keep it
+      // in this same channel for both MCP notifications and host wake transports.
+      // Another bot's tick does not grant this exception.
+      const isOwnLoopTick = metaKind === "loop_tick" && data.sender_id === AGENT_ID;
 
-      if (isDM || isMentioned || activeHi) {
+      if (isDM || isMentioned || activeHi || isOwnLoopTick) {
         // DM or @mention → respond. Start a cross-pod typing heartbeat so a human
         // on any pod sees the agent "thinking" for the whole processing duration.
         // The hub now cross-pod-broadcasts agent typing frames (cross_pod:true)
@@ -4135,7 +4155,7 @@ function connectWS() {
           contextPrefix = `[HI游戏进行中 - 你是 game ${activeHi.gameId.slice(0, 8)} 的上桌玩家；此消息无需 @mention 也被实时推送。只在轮到你行动、需要讨论或需要投票时回复，否则可以旁观。]\n`;
         }
 
-        process.stderr.write(`[agentchat] ${isDM ? 'DM' : isMentioned ? '@mention' : 'HI-active'} from ${String(data.sender_id ?? "?").slice(0, 8)}: ${String(data.content ?? "").slice(0, 50)}\n`);
+        process.stderr.write(`[agentchat] ${isDM ? 'DM' : isMentioned ? '@mention' : isOwnLoopTick ? 'loop-tick' : 'HI-active'} from ${String(data.sender_id ?? "?").slice(0, 8)}: ${String(data.content ?? "").slice(0, 50)}\n`);
 
         // 推送给 Claude Code
         try {

package/src/team-lead-skill.ts

@@ -0,0 +1,14 @@
+import { readFileSync } from "node:fs";
+
+export const TEAM_LEAD_SKILL_ID = "agentschat-team-lead";
+export const TEAM_LEAD_SKILL_TITLE = "AgentsChat Team Lead";
+export const TEAM_LEAD_SKILL_SUMMARY = "Turn channel goals into a focused plan, assign responsive teammates, unblock delivery, and verify outcomes without routine chat noise.";
+// src/ and bundled dist/ both sit directly under the installed package root.
+// The canonical file is also installed as a native skill; never maintain a second body.
+export const TEAM_LEAD_SKILL_BODY = readFileSync(new URL("../skills/agentschat-team-lead/SKILL.md", import.meta.url), "utf8");
+export const TEAM_LEAD_NO_UPDATE = "[[AGENTSCHAT_NO_UPDATE]]";
+
+/** Only an exact, locally authorized loop reference activates the bundled skill. */
+export function isTeamLeadSkillInvocation(prompt: string): boolean {
+  return [TEAM_LEAD_SKILL_ID, `$${TEAM_LEAD_SKILL_ID}`, `执行 $${TEAM_LEAD_SKILL_ID}`].includes(prompt.trim());
+}