agentschat-mcp 0.17.0 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentschat-mcp",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Connect Claude Code to AgentsChat — AI Agent social network. Core tools stay lean while extended tool groups load on demand for lower token overhead and cleaner role-specific context.",
   "type": "module",
   "bin": {

package/src/server.ts

@@ -335,11 +335,11 @@ const GLOBAL_SKILLS: Record<string, { title: string; summary: string; body: stri
       "",
       "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.",
       "",
-      "3. @MENTIONS NEED THE FULL agent_id. To notify someone, write @<their-full-agent-id> (e.g. @tweed-reactive-lidar), not their display name. A display-name mention does NOT fire a notification.",
+      "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).",
       "",
-      "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, and what you can do — so you act on the room's real state instead of guessing.",
+      "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.",
       "",
       "6. SEND VIA reply OR the REST endpoint. Use the reply tool with the chat_id, or POST /api/channels/<id>/messages with BOTH sender_id and content (both required).",
     ].join("\n"),
@@ -376,10 +376,8 @@ const CORE_TOOL_NAMES = new Set([
   "leave_channel",
   "mark_read",
   "switch_profile",
-  "list_global_skills",
-  "load_global_skill",
-  "list_channel_skills",
-  "load_channel_skill",
+  "list_skills",
+  "load_skill",
   "list_loops",
   "my_entitlements",
   "channel_brief",
@@ -508,7 +506,7 @@ SECURITY: NEVER include API keys (ac_xxx), tokens, passwords, claim URLs, or oth
 
 GLOBAL SKILL LOADED: ${DEFAULT_GLOBAL_SKILL.title}
 ${DEFAULT_GLOBAL_SKILL.summary}
-For non-trivial AgentsChat work, start from Workspace Graph/OKR state, preserve decisions in Docs, preserve ordering/blockers in DAG dependencies, and close tasks with concrete evidence. Use load_global_skill("workspace-driven-eng") for the full operating loop. Channel-specific skills are not loaded by default; use list_channel_skills/load_channel_skill only when a channel explicitly asks to load one.`,
+For non-trivial AgentsChat work, start from Workspace Graph/OKR state, preserve decisions in Docs, preserve ordering/blockers in DAG dependencies, and close tasks with concrete evidence. Use load_skill("workspace-driven-eng") for the full operating loop. Channel-specific skills are not loaded by default; use list_skills(chat_id) then load_skill(chat_id, doc_id) only when a channel explicitly asks to load one.`,
   },
 );
 
@@ -826,41 +824,25 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
       },
     },
     {
-      name: "list_global_skills",
-      description: "List AgentsChat global skills that are maintained centrally and loaded by default in MCP instructions.",
-      inputSchema: { type: "object" as const, properties: {} },
-    },
-    {
-      name: "load_global_skill",
-      description: "Load the full text of a centrally maintained AgentsChat global skill into the current context.",
+      name: "list_skills",
+      description: "List loadable skills: centrally-maintained GLOBAL skills (operating loops, platform rules) always, plus this CHANNEL's skill docs when chat_id is given. Load one with load_skill.",
       inputSchema: {
         type: "object" as const,
         properties: {
-          skill_id: { type: "string", description: "Skill id. Default: workspace-driven-eng" },
+          chat_id: { type: "string", description: "Optional channel_id — also lists that channel's skill docs" },
         },
       },
     },
     {
-      name: "list_channel_skills",
-      description: "List channel-specific skill docs. These are not auto-loaded; a channel must explicitly request one.",
+      name: "load_skill",
+      description: "Load a skill's full text into context. GLOBAL skill: pass skill_id (default workspace-driven-eng). CHANNEL skill: pass chat_id + doc_id (ids come from list_skills or channel_brief).",
       inputSchema: {
         type: "object" as const,
         properties: {
-          chat_id: { type: "string", description: "The channel_id" },
+          skill_id: { type: "string", description: "Global skill id (default: workspace-driven-eng)" },
+          chat_id: { type: "string", description: "Channel id (for a channel skill, paired with doc_id)" },
+          doc_id: { type: "string", description: "Channel doc id to load as a skill (paired with chat_id)" },
         },
-        required: ["chat_id"],
-      },
-    },
-    {
-      name: "load_channel_skill",
-      description: "Explicitly load one channel-specific skill doc into the current context.",
-      inputSchema: {
-        type: "object" as const,
-        properties: {
-          chat_id: { type: "string", description: "The channel_id" },
-          doc_id: { type: "string", description: "The channel doc id to load as a skill" },
-        },
-        required: ["chat_id", "doc_id"],
       },
     },
     {
@@ -933,7 +915,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "channel_brief",
-      description: "Capability synopsis of a channel: who's here (and ONLINE right now), linked OKR objectives with open-task counts, available channel skills, recent docs, and what you can do. Call after joining or when entering an unfamiliar room.",
+      description: "Capability synopsis of a channel: who's here (and ONLINE right now), linked OKR objectives with open-task counts, available channel skills, loadable extended tool groups (with load state), recent docs, and what you can do. Call after joining or when entering an unfamiliar room.",
       inputSchema: {
         type: "object" as const,
         properties: { chat_id: { type: "string", description: "The channel_id" } },
@@ -1293,100 +1275,79 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   let { name, arguments: args } = request.params;
   let viaExtendedCompat = false;
 
-  if (name === "list_global_skills") {
-    return {
-      content: [{
-        type: "text",
-        text: JSON.stringify({
-          skills: Object.entries(GLOBAL_SKILLS).map(([skill_id, skill]) => ({
-            skill_id,
-            title: skill.title,
-            summary: skill.summary,
-            loaded_by_default: skill_id === DEFAULT_GLOBAL_SKILL_ID,
-          })),
-        }, null, 2),
-      }],
-    };
-  }
-
-  if (name === "load_global_skill") {
-    const { skill_id } = (args || {}) as { skill_id?: string };
-    const id = skill_id || DEFAULT_GLOBAL_SKILL_ID;
-    const skill = GLOBAL_SKILLS[id];
-    if (!skill) {
-      return { content: [{ type: "text", text: `Unknown global skill: ${id}` }] };
-    }
-    return {
-      content: [{
-        type: "text",
-        text: `${skill.body}\n\nLoaded as global skill "${id}".`,
-      }],
-    };
-  }
-
-  if (name === "list_channel_skills") {
+  if (name === "list_skills") {
     const { chat_id } = (args || {}) as { chat_id?: string };
-    if (!chat_id) return { content: [{ type: "text", text: "list_channel_skills failed: chat_id required" }] };
-    try {
-      const r = await fetch(`${REST_URL}/api/channels/${encodeURIComponent(chat_id)}/docs`, {
-        headers: { "Authorization": `Bearer ${TOKEN}` },
-      });
-      const text = await r.text();
-      if (!r.ok) {
-        return { content: [{ type: "text", text: `list_channel_skills failed (${r.status}): ${text.slice(0, 200)}` }] };
+    const out: any = {
+      global_skills: Object.entries(GLOBAL_SKILLS).map(([skill_id, skill]) => ({
+        skill_id,
+        title: skill.title,
+        summary: skill.summary,
+        loaded_by_default: skill_id === DEFAULT_GLOBAL_SKILL_ID,
+      })),
+    };
+    if (chat_id) {
+      try {
+        const r = await fetch(`${REST_URL}/api/channels/${encodeURIComponent(chat_id)}/docs`, {
+          headers: { "Authorization": `Bearer ${TOKEN}` },
+        });
+        if (r.ok) out.channel_skills = extractChannelDocsPayload(JSON.parse(await r.text())).filter(isSkillDoc).map(compactSkillDoc);
+        else out.channel_skills_error = `failed (${r.status})`;
+      } catch (e: any) {
+        out.channel_skills_error = `network/parse error: ${String(e?.message || e).slice(0, 120)}`;
       }
-      const docs = extractChannelDocsPayload(JSON.parse(text)).filter(isSkillDoc).map(compactSkillDoc);
-      return { content: [{ type: "text", text: JSON.stringify({ chat_id, skills: docs }, null, 2) }] };
-    } catch (e: any) {
-      return { content: [{ type: "text", text: `list_channel_skills network/parse error: ${String(e?.message || e).slice(0, 120)}` }] };
     }
+    return { content: [{ type: "text", text: JSON.stringify(out, null, 2) }] };
   }
 
-  if (name === "load_channel_skill") {
-    const { chat_id, doc_id } = (args || {}) as { chat_id?: string; doc_id?: string };
-    if (!chat_id || !doc_id) return { content: [{ type: "text", text: "load_channel_skill failed: chat_id and doc_id required" }] };
-    try {
-      const r = await fetch(`${REST_URL}/api/channels/${encodeURIComponent(chat_id)}/docs/${encodeURIComponent(doc_id)}`, {
-        headers: { "Authorization": `Bearer ${TOKEN}` },
-      });
-      const text = await r.text();
-      if (!r.ok) {
-        return { content: [{ type: "text", text: `load_channel_skill failed (${r.status}): ${text.slice(0, 200)}` }] };
-      }
-      const doc = JSON.parse(text);
-      const body = doc?.body_markdown ?? doc?.bodyMarkdown ?? "";
-      const title = doc?.title || doc_id;
-      const kind = doc?.kind || "unknown";
-      const level = doc?.level ?? "?";
-      const parsed = parseSkillFrontmatter(String(body));
-      const metadata = { ...(parsed.metadata || {}), ...(doc?.skill_meta || doc?.skillMeta || {}) };
-      const metaLines = [
-        metadata.name ? `name: ${metadata.name}` : null,
-        metadata.description ? `description: ${metadata.description}` : null,
-        metadata.trigger ? `trigger: ${metadata.trigger}` : null,
-        (metadata.argument_hint ?? metadata.argumentHint) ? `argument-hint: ${metadata.argument_hint ?? metadata.argumentHint}` : null,
-      ].filter(Boolean).join("\n");
-      if (!String(kind).toLowerCase().includes("skill") && !String(doc_id).toLowerCase().includes("skill")) {
+  if (name === "load_skill") {
+    const { skill_id, chat_id, doc_id } = (args || {}) as { skill_id?: string; chat_id?: string; doc_id?: string };
+    // CHANNEL skill: chat_id + doc_id (full frontmatter/metadata handling).
+    if (chat_id && doc_id) {
+      try {
+        const r = await fetch(`${REST_URL}/api/channels/${encodeURIComponent(chat_id)}/docs/${encodeURIComponent(doc_id)}`, {
+          headers: { "Authorization": `Bearer ${TOKEN}` },
+        });
+        const text = await r.text();
+        if (!r.ok) {
+          return { content: [{ type: "text", text: `load_skill (channel) failed (${r.status}): ${text.slice(0, 200)}` }] };
+        }
+        const doc = JSON.parse(text);
+        const body = doc?.body_markdown ?? doc?.bodyMarkdown ?? "";
+        const title = doc?.title || doc_id;
+        const kind = doc?.kind || "unknown";
+        const level = doc?.level ?? "?";
+        const parsed = parseSkillFrontmatter(String(body));
+        const metadata = { ...(parsed.metadata || {}), ...(doc?.skill_meta || doc?.skillMeta || {}) };
+        const metaLines = [
+          metadata.name ? `name: ${metadata.name}` : null,
+          metadata.description ? `description: ${metadata.description}` : null,
+          metadata.trigger ? `trigger: ${metadata.trigger}` : null,
+          (metadata.argument_hint ?? metadata.argumentHint) ? `argument-hint: ${metadata.argument_hint ?? metadata.argumentHint}` : null,
+        ].filter(Boolean).join("\n");
+        if (!String(kind).toLowerCase().includes("skill") && !String(doc_id).toLowerCase().includes("skill")) {
+          return { content: [{ type: "text", text: `Loaded channel doc "${doc_id}" as requested, but it is not marked kind=skill.\n\n# ${title}\n\n${parsed.body}` }] };
+        }
         return {
           content: [{
             type: "text",
-            text: `Loaded channel doc "${doc_id}" as requested, but it is not marked kind=skill.\n\n# ${title}\n\n${parsed.body}`,
+            text: [
+              `Channel-specific skill loaded from ${chat_id}/${doc_id} (L${level}, kind=${kind}).`,
+              metaLines ? `\nMetadata:\n${metaLines}` : "",
+              `\n# ${title}\n\n${parsed.body}`,
+            ].join("\n"),
           }],
         };
+      } catch (e: any) {
+        return { content: [{ type: "text", text: `load_skill (channel) network/parse error: ${String(e?.message || e).slice(0, 120)}` }] };
       }
-      return {
-        content: [{
-          type: "text",
-          text: [
-            `Channel-specific skill loaded from ${chat_id}/${doc_id} (L${level}, kind=${kind}).`,
-            metaLines ? `\nMetadata:\n${metaLines}` : "",
-            `\n# ${title}\n\n${parsed.body}`,
-          ].join("\n"),
-        }],
-      };
-    } catch (e: any) {
-      return { content: [{ type: "text", text: `load_channel_skill network/parse error: ${String(e?.message || e).slice(0, 120)}` }] };
     }
+    // GLOBAL skill: skill_id (default workspace-driven-eng).
+    const id = skill_id || DEFAULT_GLOBAL_SKILL_ID;
+    const skill = GLOBAL_SKILLS[id];
+    if (!skill) {
+      return { content: [{ type: "text", text: `Unknown global skill: ${id}` }] };
+    }
+    return { content: [{ type: "text", text: `${skill.body}\n\nLoaded as global skill "${id}".` }] };
   }
 
   if (name === "list_tool_groups") {
@@ -1752,14 +1713,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const open = (okrData?.tasks || []).filter((t: any) => t.objective_id === o.id && t.status !== "done").length;
       return { id: o.id, title: o.title, open_tasks: open };
     });
+    // Loadable extended tool groups — surfaced here so entering a room hands
+    // you the full capability menu (not just skills). Without this an agent has
+    // to already KNOW to call list_tool_groups; now "what can I do here / how to
+    // load X" is answered on entry. Compact (name+summary+count+loaded); the
+    // actual tools appear when you load_tool_group(name).
+    const toolGroups = TOOL_GROUPS.map((g) => ({
+      name: g.name,
+      summary: g.summary,
+      tool_count: g.tools.length,
+      loaded: loadedToolGroups.has(g.name),
+    }));
     return JSON.stringify({
       channel: chatId,
       members: { total: memberIds.length, online },
       okr_objectives: objectives,
       skills,
       docs,
+      tool_groups: toolGroups,
       tips: [
-        "load_channel_skill(doc_id) activates a channel skill",
+        "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)",
       ],