@tacitai/mcp-server 0.2.0 → 0.3.0

package/dist/index.js

@@ -56,6 +56,7 @@ import { registerPeopleTools } from './tools/people.js';
 import { registerLakeStructureTools } from './tools/lake-structure.js';
 import { registerResearchTools } from './tools/research.js';
 import { registerGmTools } from './tools/gm.js';
+import { registerSkillTools } from './tools/skills.js';
 import { registerPrompts } from './prompts.js';
 import { getRequestPrincipal } from './client.js';
 // Setup wizard (MV-1057h / W5)
@@ -136,7 +137,7 @@ async function run() {
     }
     checkProfileExpiry(profile);
     checkCompatibility();
-    const server = new McpServer({ name: '@tacitai/mcp-server', version: '0.2.0' }, { capabilities: { tools: {}, prompts: {} } });
+    const server = new McpServer({ name: '@tacitai/mcp-server', version: '0.3.0' }, { capabilities: { tools: {}, prompts: {} } });
     const isHttpMode = process.env['MCP_TRANSPORT'] === 'http';
     let clientInstance = null;
     const getClient = async () => {
@@ -176,6 +177,7 @@ async function run() {
     registerLakeStructureTools(server, getClient);
     registerGmTools(server, getClient);
     registerResearchTools(server, getClient, getRequestPrincipal);
+    registerSkillTools(server, getClient);
     registerPrompts(server);
     if (process.env['MCP_TRANSPORT'] === 'http') {
         await startHttpTransport(server);

package/dist/tools/registry.d.ts

@@ -1,6 +1,6 @@
 /**
  * Compile-time tool classification. Governs which tools may be called over HTTPS.
- * Partition: 6 stdio_only + 15 admin_only + 2 gate_only + 108 https = 131.
+ * Partition: 6 stdio_only + 15 admin_only + 2 gate_only + 110 https = 133.
  */
 export type ToolTransport = 'https' | 'stdio_only' | 'admin_only' | 'gate_only';
 export type ToolClass = 'read' | 'write' | 'admin' | 'dispatch';

package/dist/tools/registry.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 /**
  * Compile-time tool classification. Governs which tools may be called over HTTPS.
- * Partition: 6 stdio_only + 15 admin_only + 2 gate_only + 108 https = 131.
+ * Partition: 6 stdio_only + 15 admin_only + 2 gate_only + 110 https = 133.
  */
 const STDIO_ONLY = [
     'tacit_ingest_file',
@@ -72,6 +72,7 @@ const READ_TOOLS = [
     'tacit_lake_taxonomy_browse',
     'tacit_list_annotations',
     'tacit_list_deliverables',
+    'tacit_list_skills',
     'tacit_list_people',
     'tacit_list_workspaces',
     'tacit_outbox_status',
@@ -97,6 +98,7 @@ const DISPATCH_TOOLS = [
     'tacit_kb_pull_source',
     'tacit_lake_trigger_sync',
     'tacit_research_launch',
+    'tacit_run_skill',
 ];
 const WRITE_TOOLS = [
     'tacit_agent_decide',
@@ -176,8 +178,8 @@ function build() {
         if (!exclusive.has(n))
             add(n, classOf(n), 'https', false);
     }
-    if (map.size !== 131)
-        throw new Error(`tool registry expected 131 tools, got ${map.size}`);
+    if (map.size !== 133)
+        throw new Error(`tool registry expected 133 tools, got ${map.size}`);
     return map;
 }
 export const TOOL_REGISTRY = build();

package/dist/tools/skills.d.ts

@@ -0,0 +1,9 @@
+/**
+ * tacit_list_skills / tacit_run_skill — MCP skill orchestration (MV-1533 W6)
+ *
+ * GET  /api/v1/internal/skills — list available exec skills
+ * POST /api/v1/converse — invoke a skill by hint (SSE stream)
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TacitClient } from '../client.js';
+export declare function registerSkillTools(server: McpServer, getClientFn: () => Promise<TacitClient>): void;

package/dist/tools/skills.js

@@ -0,0 +1,98 @@
+// SPDX-License-Identifier: MIT
+/**
+ * tacit_list_skills / tacit_run_skill — MCP skill orchestration (MV-1533 W6)
+ *
+ * GET  /api/v1/internal/skills — list available exec skills
+ * POST /api/v1/converse — invoke a skill by hint (SSE stream)
+ */
+import { z } from 'zod';
+export function registerSkillTools(server, getClientFn) {
+    // --- tacit_list_skills ---
+    server.tool('tacit_list_skills', 'List available TACIT exec skills with their domains, descriptions, and access levels.', {}, async () => {
+        const client = await getClientFn();
+        try {
+            const data = await client.get('/api/v1/internal/skills');
+            return {
+                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: 'text', text: `Error listing skills: ${msg}` }], isError: true };
+        }
+    });
+    // --- tacit_run_skill ---
+    server.tool('tacit_run_skill', 'Run a TACIT exec skill by name. Sends the message through the converse pipeline with skill_hint routing. Returns the skill response, which may include tool calls, structured answers, or approval requests.', {
+        skill_id: z.string().min(1).describe('The skill domain ID (e.g., "pyr-exec", "lake-exec", "kb-exec", "sales-exec", "gm-exec")'),
+        message: z.string().min(1).describe('The natural-language instruction for the skill'),
+        session_id: z.string().optional().describe('Existing converse session UUID to continue; omit for a new session'),
+    }, async (args) => {
+        const client = await getClientFn();
+        // Validate skill_id against the catalog
+        try {
+            const catalog = await client.get('/api/v1/internal/skills');
+            const validDomains = catalog.skills.map((s) => s.domain);
+            if (!validDomains.includes(args.skill_id)) {
+                return {
+                    content: [{ type: 'text', text: `Unknown skill_id "${args.skill_id}". Valid skills: ${validDomains.join(', ')}` }],
+                    isError: true,
+                };
+            }
+        }
+        catch {
+            // Catalog unreachable — proceed anyway, backend will validate
+        }
+        const body = {
+            message: args.message,
+            skill_hint: args.skill_id,
+            channel: 'mcp',
+        };
+        if (args.session_id)
+            body['session_id'] = args.session_id;
+        try {
+            const chunks = [];
+            let sessionId = '';
+            let structuredAnswer = null;
+            let pendingApproval = null;
+            for await (const chunk of client.postSSE('/api/v1/converse', body)) {
+                try {
+                    const parsed = JSON.parse(chunk);
+                    if (parsed.type === 'session_start')
+                        sessionId = parsed.session_id;
+                    else if (parsed.type === 'token')
+                        chunks.push(parsed.delta);
+                    else if (parsed.type === 'structured_answer')
+                        structuredAnswer = parsed.data;
+                    else if (parsed.type === 'pending_approval')
+                        pendingApproval = parsed;
+                    else if (parsed.type === 'tool_call_end') {
+                        if (parsed.result)
+                            chunks.push(typeof parsed.result === 'string' ? parsed.result : JSON.stringify(parsed.result));
+                    }
+                }
+                catch {
+                    chunks.push(chunk);
+                }
+            }
+            const text = chunks.join('');
+            const result = {
+                skill_id: args.skill_id,
+                session_id: sessionId,
+                response: text,
+            };
+            if (structuredAnswer)
+                result['structured_answer'] = structuredAnswer;
+            if (pendingApproval) {
+                result['pending_approval'] = pendingApproval;
+                result['instructions'] = 'This operation requires approval. Use tacit_converse with the session_id and confirm_token to approve or reject.';
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: 'text', text: `Error running skill ${args.skill_id}: ${msg}` }], isError: true };
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tacitai/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "stdio MCP server wrapping Tacit /api/v1 REST/SSE API",
   "license": "MIT",
   "repository": {