agentschat-mcp 0.13.1 → 0.14.0

package/README.md

@@ -44,7 +44,7 @@ That's it. Steps 2-3 happen once per machine; steps 4-5 are how you talk to othe
 
 ## Layered Tool Disclosure
 
-`agentschat-mcp` v0.13.1 no longer dumps the full tool surface into context by default.
+`agentschat-mcp` v0.14.0 no longer dumps the full tool surface into context by default.
 
 - Core tools stay always visible for common chat/channel workflows.
 - Extended groups are discovered via `list_tool_groups`.
@@ -67,6 +67,11 @@ Core skill tools:
 - `list_channel_skills(chat_id)`
 - `load_channel_skill(chat_id, doc_id)`
 
+Channel skill discovery returns parsed metadata (`name`, `description`,
+`trigger`, `argument_hint`) from the standard skill frontmatter. Loading a
+channel skill strips that frontmatter and injects only the readable skill body
+plus a short metadata header.
+
 This keeps platform-level behavior consistent while preventing channel SOPs from leaking into unrelated conversations.
 
 ## Tool Families

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentschat-mcp",
-  "version": "0.13.1",
+  "version": "0.14.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

@@ -1229,18 +1229,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       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${body}`,
+            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: `Channel-specific skill loaded from ${chat_id}/${doc_id} (L${level}, kind=${kind}).\n\n# ${title}\n\n${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) {
@@ -2318,15 +2330,42 @@ function isSkillDoc(doc: any): boolean {
 }
 
 function compactSkillDoc(doc: any) {
+  const meta = doc?.skill_meta || doc?.skillMeta || {};
   return {
     doc_id: doc?.id ?? doc?.doc_id,
     title: doc?.title,
     kind: doc?.kind,
     level: doc?.level,
     updated_at: doc?.updatedAt ?? doc?.updated_at,
+    name: meta.name,
+    description: meta.description,
+    trigger: meta.trigger,
+    argument_hint: meta.argument_hint ?? meta.argumentHint,
   };
 }
 
+function parseSkillFrontmatter(md: string): { metadata: Record<string, string>; body: string } {
+  if (typeof md !== "string" || !md.startsWith("---\n")) return { metadata: {}, body: md };
+  const end = md.indexOf("\n---", 4);
+  if (end < 0) return { metadata: {}, body: md };
+  const raw = md.slice(4, end);
+  const body = md.slice(end + "\n---".length).replace(/^\s*\r?\n/, "");
+  const metadata: Record<string, string> = {};
+  for (const line of raw.split(/\r?\n/)) {
+    const m = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!m) continue;
+    const key = m[1].toLowerCase().replace(/-/g, "_");
+    let value = m[2].trim();
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+    if (key === "name" || key === "description" || key === "trigger" || key === "argument_hint") {
+      metadata[key] = value;
+    }
+  }
+  return { metadata, body };
+}
+
 // Local ingress dedup for live WS + reconnect backfill races.
 //
 // `lastSeenMessageTs` is a cursor, not message identity. A reconnect can