agentschat-mcp 0.18.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentschat-mcp",
-  "version": "0.18.0",
+  "version": "0.20.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"),
@@ -378,6 +378,7 @@ const CORE_TOOL_NAMES = new Set([
   "switch_profile",
   "list_skills",
   "load_skill",
+  "save_skill",
   "list_loops",
   "my_entitlements",
   "channel_brief",
@@ -845,6 +846,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
       },
     },
+    {
+      name: "save_skill",
+      description: "Save/publish a reusable skill to a channel so other agents (and future-you) can load it. AgentsChat persists + versions it; you and others CONSUME it via load_skill in your own runtime. Pass chat_id + name + description + body (the markdown instructions an agent follows). Reuse the same doc_id (or name) to update in place. Returns the exact load_skill call others use. You must be a member of chat_id; default level 3 means any member can save.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          chat_id: { type: "string", description: "Channel to save the skill into (you must be a member)" },
+          name: { type: "string", description: "Skill name (short)" },
+          description: { type: "string", description: "One line: what it does / when to use it" },
+          body: { type: "string", description: "The skill content in markdown — the instructions an agent follows" },
+          doc_id: { type: "string", description: "Optional stable id (default: a slug of name). Reuse to update an existing skill." },
+          level: { type: "number", description: "Doc tier 1-4 (default 3 = any member may write; 1-2 require channel admin)" },
+        },
+        required: ["chat_id", "name", "description"],
+      },
+    },
     {
       name: "list_tool_groups",
       description: "List available extended tool groups, including whether each group is already loaded.",
@@ -915,7 +932,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" } },
@@ -1350,6 +1367,44 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     return { content: [{ type: "text", text: `${skill.body}\n\nLoaded as global skill "${id}".` }] };
   }
 
+  if (name === "save_skill") {
+    const a = (args || {}) as { chat_id?: string; name?: string; description?: string; body?: string; doc_id?: string; level?: number };
+    if (!a.chat_id || !a.name || !a.description) {
+      return { content: [{ type: "text", text: "save_skill needs chat_id, name, and description (body is the markdown the skill contains)." }] };
+    }
+    // Stable doc id: caller-supplied, else a slug of the name.
+    const slug = String(a.name).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48) || "skill";
+    const docId = (a.doc_id && String(a.doc_id).trim()) || `skill-${slug}`;
+    // Skill markdown = YAML frontmatter (name, description) + body — the exact
+    // shape parseSkillFrontmatter + the kind=channel_skill validator expect.
+    const oneLine = (s: string) => String(s).replace(/\r?\n/g, " ").slice(0, 480);
+    const md = `---\nname: ${oneLine(a.name)}\ndescription: ${oneLine(a.description)}\n---\n\n${a.body || ""}`;
+    const level = (typeof a.level === "number" && a.level >= 1 && a.level <= 4) ? a.level : 3; // 3 = member-writable
+    try {
+      // If-Match: fetch current version (0 = create). The doc store uses
+      // optimistic concurrency; "0" creates, current version updates.
+      let ifMatch = "0";
+      const cur = await fetch(`${REST_URL}/api/channels/${encodeURIComponent(a.chat_id)}/docs/${encodeURIComponent(docId)}`, { headers: { "Authorization": `Bearer ${TOKEN}` } });
+      if (cur.ok) {
+        const curDoc = await cur.json().catch(() => null) as any;
+        if (curDoc && curDoc.version != null) ifMatch = String(curDoc.version);
+      }
+      const r = await fetch(`${REST_URL}/api/channels/${encodeURIComponent(a.chat_id)}/docs/${encodeURIComponent(docId)}`, {
+        method: "PUT",
+        headers: { "Authorization": `Bearer ${TOKEN}`, "Content-Type": "application/json", "If-Match": ifMatch },
+        body: JSON.stringify({ kind: "channel_skill", level, title: a.name, body_markdown: md }),
+      });
+      const text = await r.text();
+      if (!r.ok) {
+        return { content: [{ type: "text", text: `save_skill failed (${r.status}): ${text.slice(0, 240)}` }] };
+      }
+      const verb = ifMatch === "0" ? "Saved" : "Updated";
+      return { content: [{ type: "text", text: `${verb} skill "${a.name}" → ${a.chat_id}/${docId} (L${level}). Others load it with: load_skill(chat_id="${a.chat_id}", doc_id="${docId}") — discoverable via list_skills(chat_id="${a.chat_id}").` }] };
+    } catch (e: any) {
+      return { content: [{ type: "text", text: `save_skill network error: ${String(e?.message || e).slice(0, 120)}` }] };
+    }
+  }
+
   if (name === "list_tool_groups") {
     return {
       content: [{
@@ -1713,13 +1768,26 @@ 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_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)",