@contextstream/mcp-server 0.3.42 → 0.3.43

package/dist/index.js

@@ -7443,11 +7443,155 @@ ${options.workspaceId ? `# Workspace ID: ${options.workspaceId}` : ""}
   };
 }
 
+// src/tool-catalog.ts
+var TOOL_CATALOG = [
+  {
+    name: "Session",
+    tools: [
+      { name: "init", hint: "start-conv" },
+      { name: "smart", hint: "each-msg" },
+      { name: "capture", hint: "save" },
+      { name: "recall", hint: "find" },
+      { name: "remember", hint: "quick" },
+      { name: "compress", hint: "end" },
+      { name: "summary", hint: "brief" },
+      { name: "delta", hint: "changes" },
+      { name: "get_lessons", hint: "learn" },
+      { name: "capture_lesson", hint: "mistake" },
+      { name: "get_user_context", hint: "prefs" },
+      { name: "smart_search", hint: "deep-find" }
+    ]
+  },
+  {
+    name: "Search",
+    tools: [
+      { name: "semantic", hint: "meaning" },
+      { name: "hybrid", hint: "combo" },
+      { name: "keyword", hint: "exact" },
+      { name: "pattern", hint: "code" }
+    ]
+  },
+  {
+    name: "Memory",
+    tools: [
+      { name: "create_event", hint: "new" },
+      { name: "list_events", hint: "list" },
+      { name: "get_event", hint: "get" },
+      { name: "update_event", hint: "edit" },
+      { name: "delete_event", hint: "rm" },
+      { name: "search", hint: "find" },
+      { name: "decisions", hint: "choices" },
+      { name: "timeline", hint: "history" },
+      { name: "distill_event", hint: "extract" }
+    ]
+  },
+  {
+    name: "Knowledge",
+    tools: [
+      { name: "create_node", hint: "new" },
+      { name: "list_nodes", hint: "list" },
+      { name: "get_node", hint: "get" },
+      { name: "update_node", hint: "edit" },
+      { name: "delete_node", hint: "rm" },
+      { name: "supersede_node", hint: "replace" }
+    ]
+  },
+  {
+    name: "Graph",
+    tools: [
+      { name: "related", hint: "links" },
+      { name: "path", hint: "trace" },
+      { name: "decisions", hint: "choices" },
+      { name: "dependencies", hint: "deps" },
+      { name: "impact", hint: "changes" },
+      { name: "contradictions", hint: "conflicts" }
+    ]
+  },
+  {
+    name: "Workspace",
+    tools: [
+      { name: "list", hint: "" },
+      { name: "get", hint: "" },
+      { name: "create", hint: "" },
+      { name: "associate", hint: "link-folder" },
+      { name: "bootstrap", hint: "new-ws" }
+    ]
+  },
+  {
+    name: "Project",
+    tools: [
+      { name: "list", hint: "" },
+      { name: "get", hint: "" },
+      { name: "create", hint: "" },
+      { name: "index", hint: "scan-code" },
+      { name: "files", hint: "list-files" },
+      { name: "overview", hint: "summary" }
+    ]
+  },
+  {
+    name: "AI",
+    tools: [
+      { name: "context", hint: "smart-ctx" },
+      { name: "plan", hint: "generate" },
+      { name: "tasks", hint: "breakdown" },
+      { name: "embeddings", hint: "vectors" }
+    ]
+  }
+];
+function generateToolCatalog(format = "grouped", category) {
+  let categories = TOOL_CATALOG;
+  if (category) {
+    const filtered = TOOL_CATALOG.filter(
+      (c) => c.name.toLowerCase() === category.toLowerCase()
+    );
+    if (filtered.length > 0) {
+      categories = filtered;
+    }
+  }
+  switch (format) {
+    case "minimal":
+      return generateMinimal(categories);
+    case "full":
+      return generateFull(categories);
+    case "grouped":
+    default:
+      return generateGrouped(categories);
+  }
+}
+function generateGrouped(categories) {
+  return categories.map((cat) => {
+    const tools = cat.tools.map((t) => t.hint ? `${t.name}(${t.hint})` : t.name).join(" ");
+    return `${cat.name}: ${tools}`;
+  }).join("\n");
+}
+function generateMinimal(categories) {
+  return categories.map((cat) => {
+    const tools = cat.tools.map((t) => t.name).join("|");
+    return `${cat.name}:${tools}`;
+  }).join("\n");
+}
+function generateFull(categories) {
+  const lines = [];
+  for (const cat of categories) {
+    lines.push(`## ${cat.name}`);
+    for (const tool of cat.tools) {
+      const prefix = cat.name.toLowerCase().replace(/\s+/g, "_");
+      const fullName = `${prefix}_${tool.name}`;
+      lines.push(`- ${fullName}: ${tool.hint || "standard CRUD"}`);
+    }
+  }
+  return lines.join("\n");
+}
+function getCoreToolsHint() {
+  return `Session: init(start) smart(each-msg) capture(save) recall(find) remember(quick)`;
+}
+
 // src/tools.ts
 var LESSON_DEDUP_WINDOW_MS = 2 * 60 * 1e3;
 var recentLessonCaptures = /* @__PURE__ */ new Map();
 var CORE_TOOLSET = /* @__PURE__ */ new Set([
   "session_init",
+  "session_tools",
   "context_smart",
   "session_summary",
   "session_capture",
@@ -8688,6 +8832,7 @@ This does semantic search on the first message. You only need context_smart on s
         ideRoots = [input.folder_path];
       }
       const result = await client.initSession(input, ideRoots);
+      result.tools_hint = getCoreToolsHint();
       if (sessionManager) {
         sessionManager.markInitialized(result);
       }
@@ -8743,6 +8888,38 @@ This does semantic search on the first message. You only need context_smart on s
       return { content: [{ type: "text", text }], structuredContent: toStructured(result) };
     }
   );
+  registerTool(
+    "session_tools",
+    {
+      title: "Get available ContextStream tools",
+      description: `Get an ultra-compact list of all available ContextStream MCP tools.
+Use this when you need to know what tools are available without reading full descriptions.
+
+Returns a token-efficient tool catalog (~120 tokens) organized by category.
+
+Format options:
+- 'grouped' (default): Category: tool(hint) tool(hint) - best for quick reference
+- 'minimal': Category:tool|tool|tool - most compact
+- 'full': Detailed list with descriptions
+
+Example output (grouped):
+Session: init(start-conv) smart(each-msg) capture(save) recall(find) remember(quick)
+Search: semantic(meaning) hybrid(combo) keyword(exact)
+Memory: events(crud) nodes(knowledge) search(find) decisions(choices)`,
+      inputSchema: external_exports.object({
+        format: external_exports.enum(["grouped", "minimal", "full"]).optional().default("grouped").describe("Output format: grouped (default, ~120 tokens), minimal (~80 tokens), or full (~200 tokens)"),
+        category: external_exports.string().optional().describe("Filter to specific category: Session, Search, Memory, Knowledge, Graph, Workspace, Project, AI")
+      })
+    },
+    async (input) => {
+      const format = input.format || "grouped";
+      const catalog = generateToolCatalog(format, input.category);
+      return {
+        content: [{ type: "text", text: catalog }],
+        structuredContent: { format, catalog }
+      };
+    }
+  );
   registerTool(
     "session_get_user_context",
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.3.42",
+  "version": "0.3.43",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",