agentschat-mcp 0.13.0 → 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.0 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.0",
+  "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

@@ -397,7 +397,7 @@ function filterVisibleTools<T extends { name: string }>(tools: T[]): T[] {
 
 // MCP Server
 const server = new Server(
-  { name: "agentschat", version: "0.13.0" },
+  { name: "agentschat", version: "0.13.1" },
   {
     capabilities: {
       experimental: { "claude/channel": {} },
@@ -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) {
@@ -1754,7 +1766,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
   if (name === "whoami") {
     const wsState = ws?.readyState === WebSocket.OPEN ? "connected" : ws?.readyState === WebSocket.CONNECTING ? "connecting" : "disconnected";
-    return { content: [{ type: "text", text: `Profile: ${profile.display_name || AGENT_ID}\nAgent ID: ${AGENT_ID}\nServer: ${REST_URL}\nWebSocket: ${wsState}${sessionId ? `\nSession: ${sessionId.slice(0, 12)}...` : ""}\nCapabilities: ${CAPABILITIES.join(", ")}\nProfile file: ${profileFile}` }] };
+    let healthLine = "REST health: unknown";
+    let authLine = "REST auth: unknown";
+    try {
+      const r = await fetch(`${REST_URL}/health`);
+      if (r.ok) {
+        const h = await r.json() as any;
+        const build = h?.build ? ` build=${h.build}` : "";
+        const redis = h?.redis ? ` redis=${h.redis}` : "";
+        healthLine = `REST health: ok${build}${redis}`;
+      } else {
+        healthLine = `REST health: failed (${r.status})`;
+      }
+    } catch (e: any) {
+      healthLine = `REST health: error (${String(e?.message || e).slice(0, 80)})`;
+    }
+    try {
+      const r = await fetch(`${REST_URL}/api/account/${encodeURIComponent(AGENT_ID)}`, {
+        headers: TOKEN ? { "Authorization": `Bearer ${TOKEN}` } : {},
+      });
+      authLine = r.ok ? "REST auth: ok" : `REST auth: failed (${r.status})`;
+    } catch (e: any) {
+      authLine = `REST auth: error (${String(e?.message || e).slice(0, 80)})`;
+    }
+    return { content: [{ type: "text", text: `Profile: ${profile.display_name || AGENT_ID}\nAgent ID: ${AGENT_ID}\nServer: ${REST_URL}\nWebSocket: ${wsState}${sessionId ? `\nSession: ${sessionId.slice(0, 12)}...` : ""}\n${healthLine}\n${authLine}\nCapabilities: ${CAPABILITIES.join(", ")}\nProfile file: ${profileFile}` }] };
   }
 
   if (name === "list_channels") {
@@ -2295,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