contextforge-mcp 0.1.73 → 0.1.75

package/dist/index.js

@@ -3,7 +3,8 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { ApiClient, ApiClientError, readProjectLinkConfig, } from "./api-client.js";
-import { ConfigSchema, IngestInputSchema, QueryInputSchema, CreateProjectInputSchema, CreateSpaceInputSchema, RelateInputSchema, ListRelationshipsInputSchema, DeleteInputSchema, GitConnectInputSchema, GitActivateInputSchema, GitDisconnectInputSchema, GitSyncInputSchema, GitHistoryInputSchema, SnapshotCreateInputSchema, SnapshotRestoreInputSchema, SnapshotDeleteInputSchema, ExportInputSchema, ImportInputSchema, IngestBatchInputSchema, DeleteBatchInputSchema, LinkProjectInputSchema, parseArrayInput, } from "./types.js";
+import { ConfigSchema, IngestInputSchema, QueryInputSchema, CreateProjectInputSchema, CreateSpaceInputSchema, RelateInputSchema, ListRelationshipsInputSchema, DeleteInputSchema, GitConnectInputSchema, GitActivateInputSchema, GitDisconnectInputSchema, GitSyncInputSchema, GitHistoryInputSchema, SnapshotCreateInputSchema, SnapshotRestoreInputSchema, SnapshotDeleteInputSchema, ExportInputSchema, ImportInputSchema, IngestBatchInputSchema, DeleteBatchInputSchema, LinkProjectInputSchema, SkillsListInputSchema, SkillsGetInputSchema, SkillsCreateInputSchema, SkillsUpdateInputSchema, SkillsDeleteInputSchema, SkillsRunInputSchema, parseArrayInput, } from "./types.js";
+import { resolveTaskIdentifier } from "./task-params.js";
 import { appendFileSync } from "fs";
 import { createRequire } from "module";
 import { checkForUpdates, getUpdateNotice } from "./update-checker.js";
@@ -88,6 +89,12 @@ function logTool(toolName, details) {
         tasks_add_comment: "💬",
         collaborators_list: "👥",
         project_share: "🔗",
+        skills_list: "🧰",
+        skills_get: "🔧",
+        skills_create: "➕",
+        skills_update: "✏️",
+        skills_delete: "🗑️",
+        skills_run: "▶️",
     };
     const icon = icons[toolName] || "🔧";
     log(icon, `${colors.bright}${toolName}${colors.reset}${details ? ` ${colors.dim}${details}${colors.reset}` : ""}`, colors.cyan);
@@ -1009,32 +1016,32 @@ const TOOLS = [
     },
     {
         name: "tasks_start",
-        description: 'Mark a task as "in_progress". Use this when you start working on a task. The response includes a dashboard URL — always show it to the user.',
+        description: 'Mark a task as "in_progress". Use this when you start working on a task. Accepts any identifier: UUID, short_id, or task title. The response includes a dashboard URL — always show it to the user.',
         annotations: { title: "Start Task", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                issue_id: {
+                identifier: {
                     type: "string",
-                    description: "Task UUID to start working on",
+                    description: "Task identifier — can be a UUID, short_id (e.g. 'hpiu09'), or task title/name",
                 },
             },
-            required: ["issue_id"],
+            required: ["identifier"],
         },
     },
     {
         name: "tasks_resolve",
-        description: 'Mark a task as "resolved". Use this when you finish working on a task. The response includes a dashboard URL — always show it to the user.',
+        description: 'Mark a task as "resolved". Use this when you finish working on a task. Accepts any identifier: UUID, short_id, or task title. The response includes a dashboard URL — always show it to the user.',
         annotations: { title: "Resolve Task", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                issue_id: {
+                identifier: {
                     type: "string",
-                    description: "Task UUID to mark as resolved",
+                    description: "Task identifier — can be a UUID, short_id (e.g. 'hpiu09'), or task title/name",
                 },
             },
-            required: ["issue_id"],
+            required: ["identifier"],
         },
     },
     {
@@ -1099,18 +1106,14 @@ const TOOLS = [
     },
     {
         name: "tasks_update",
-        description: "Update a task's title, description, status, priority, tags, due date, or assignee. Provide issue_id or short_id to identify the task, plus one or more fields to update. The response includes a dashboard URL — always show it to the user.",
+        description: "Update a task's title, description, status, priority, tags, due date, or assignee. Accepts any identifier: UUID, short_id, or task title. The response includes a dashboard URL — always show it to the user.",
         annotations: { title: "Update Task", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                issue_id: {
+                identifier: {
                     type: "string",
-                    description: "Task UUID (optional if short_id is provided)",
-                },
-                short_id: {
-                    type: "string",
-                    description: 'Short ID of the task (e.g., "4w3123") - alternative to issue_id',
+                    description: "Task identifier — can be a UUID, short_id (e.g. 'hpiu09'), or task title/name",
                 },
                 title: {
                     type: "string",
@@ -1149,41 +1152,33 @@ const TOOLS = [
     },
     {
         name: "tasks_assign",
-        description: "Assign a task to a collaborator by their email address. The response includes a dashboard URL — always show it to the user.",
+        description: "Assign a task to a collaborator by their email address. Accepts any task identifier: UUID, short_id, or task title. The response includes a dashboard URL — always show it to the user.",
         annotations: { title: "Assign Task", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                issue_id: {
+                identifier: {
                     type: "string",
-                    description: "Task UUID to assign (optional if short_id or issue_title is provided)",
-                },
-                short_id: {
-                    type: "string",
-                    description: 'Short ID of the task (e.g., "4w3123") - easier to reference than full UUID',
-                },
-                issue_title: {
-                    type: "string",
-                    description: "Task title to search for (optional if issue_id or short_id is provided)",
+                    description: "Task identifier — can be a UUID, short_id (e.g. 'hpiu09'), or task title/name",
                 },
                 assignee_email: {
                     type: "string",
                     description: "Email of the collaborator to assign the task to",
                 },
             },
-            required: ["assignee_email"],
+            required: ["identifier", "assignee_email"],
         },
     },
     {
         name: "tasks_resolve_by_name",
-        description: "Resolve a task by searching for it by title. Use this when you only know the task name. The response includes a dashboard URL — always show it to the user.",
+        description: "Resolve a task by searching for it by title, short_id, or UUID. Use this when you have any identifier for the task. The response includes a dashboard URL — always show it to the user.",
         annotations: { title: "Resolve Task by Name", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
                 title: {
                     type: "string",
-                    description: "Task title to search for (partial match)",
+                    description: "Task identifier — can be a title (partial match), short_id, or UUID",
                 },
             },
             required: ["title"],
@@ -1191,52 +1186,52 @@ const TOOLS = [
     },
     {
         name: "tasks_delete",
-        description: "Permanently delete a task by ID or short_id. Also deletes related comments, activity, and notifications.",
+        description: "Permanently delete a task. Accepts any identifier: UUID, short_id, or task title. Also deletes related comments, activity, and notifications.",
         annotations: { title: "Delete Task", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                issue_id: {
+                identifier: {
                     type: "string",
-                    description: "Task UUID or short_id (6 alphanumeric characters)",
+                    description: "Task identifier — can be a UUID, short_id (e.g. 'hpiu09'), or task title/name",
                 },
             },
-            required: ["issue_id"],
+            required: ["identifier"],
         },
     },
     // ============ Task Comments ============
     {
         name: "tasks_list_comments",
-        description: "List comments on a task. Use the task UUID or short_id to identify the task.",
+        description: "List comments on a task. Accepts any identifier: UUID, short_id, or task title.",
         annotations: { title: "List Task Comments", readOnlyHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                issue_id: {
+                identifier: {
                     type: "string",
-                    description: "Task UUID or short_id (6 alphanumeric characters)",
+                    description: "Task identifier — can be a UUID, short_id (e.g. 'hpiu09'), or task title/name",
                 },
             },
-            required: ["issue_id"],
+            required: ["identifier"],
         },
     },
     {
         name: "tasks_add_comment",
-        description: "Add a comment to a task. The response includes the task dashboard URL — always show it to the user.",
+        description: "Add a comment to a task. Accepts any task identifier: UUID, short_id, or task title. The response includes the task dashboard URL — always show it to the user.",
         annotations: { title: "Add Task Comment", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                issue_id: {
+                identifier: {
                     type: "string",
-                    description: "Task UUID or short_id (6 alphanumeric characters)",
+                    description: "Task identifier — can be a UUID, short_id (e.g. 'hpiu09'), or task title/name",
                 },
                 content: {
                     type: "string",
                     description: "Comment text to add",
                 },
             },
-            required: ["issue_id", "content"],
+            required: ["identifier", "content"],
         },
     },
     // ============ Collaborators ============
@@ -1287,6 +1282,109 @@ const TOOLS = [
             required: ["email"],
         },
     },
+    {
+        name: "skills_list",
+        description: "List all Skills in a project. Returns skills with their name, description, model, and prompt body.",
+        annotations: { title: "List Skills", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Project UUID" },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "skills_get",
+        description: "Get a single Skill by ID with full body.",
+        annotations: { title: "Get Skill", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Skill UUID" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "skills_create",
+        description: "Create a new Skill in a project. The 'body' is a markdown prompt template that may use {{variable}} placeholders for input_params at run time.",
+        annotations: { title: "Create Skill", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                name: { type: "string" },
+                description: { type: "string" },
+                body: {
+                    type: "string",
+                    description: "Markdown prompt template with optional {{var}} placeholders",
+                },
+                input_schema: {
+                    type: "object",
+                    description: "Optional JSON Schema for input_params",
+                },
+                llm_provider: {
+                    type: "string",
+                    enum: ["anthropic", "openai"],
+                    description: "Default 'anthropic'",
+                },
+                model: { type: "string", description: "e.g., claude-sonnet-4-6" },
+                save_to_space_id: {
+                    type: "string",
+                    description: "Optional: save outputs as knowledge_items in this space",
+                },
+            },
+            required: ["project_id", "name", "body", "model"],
+        },
+    },
+    {
+        name: "skills_update",
+        description: "Update an existing Skill.",
+        annotations: { title: "Update Skill", destructiveHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                name: { type: "string" },
+                description: { type: "string" },
+                body: { type: "string" },
+                input_schema: { type: "object" },
+                llm_provider: { type: "string", enum: ["anthropic", "openai"] },
+                model: { type: "string" },
+                save_to_space_id: { type: "string" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "skills_delete",
+        description: "Delete a Skill.",
+        annotations: { title: "Delete Skill", destructiveHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "skills_run",
+        description: "Execute a Skill on the configured LLM, optionally storing the output as a knowledge_item, and returns the result. Available to all project members.",
+        annotations: { title: "Run Skill", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: {
+                skill_id: { type: "string" },
+                input_params: {
+                    type: "object",
+                    description: "Variables substituted into the skill body",
+                },
+            },
+            required: ["skill_id"],
+        },
+    },
 ];
 // ============ Main Server ============
 async function main() {
@@ -2340,12 +2438,24 @@ async function main() {
                     };
                 }
                 case "tasks_start": {
-                    const issueId = args?.issue_id || args?.task_id;
-                    if (!issueId) {
-                        throw new Error("issue_id is required");
+                    const ident = resolveTaskIdentifier(args);
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a UUID, short_id, or task title");
+                    }
+                    logTool(name, ident.value);
+                    let result;
+                    if (ident.type === "title") {
+                        // Find by title first, then start
+                        const { issues } = await apiClient.listTasks({ status: "all", limit: 100 });
+                        const titleLower = ident.value.toLowerCase();
+                        const match = issues?.find((i) => i.title.toLowerCase().includes(titleLower) || i.title.toLowerCase() === titleLower);
+                        if (!match)
+                            throw new Error(`No task found matching "${ident.value}"`);
+                        result = await apiClient.updateTaskStatus(match.id, "in_progress");
+                    }
+                    else {
+                        result = await apiClient.updateTaskStatus(ident.value, "in_progress");
                     }
-                    logTool(name, issueId);
-                    const result = await apiClient.updateTaskStatus(issueId, "in_progress");
                     const elapsed = Date.now() - startTime;
                     logSuccess(`Started working on "${result.issue?.title}" in ${elapsed}ms`);
                     return {
@@ -2365,12 +2475,20 @@ async function main() {
                     };
                 }
                 case "tasks_resolve": {
-                    const issueId = args?.issue_id || args?.task_id;
-                    if (!issueId) {
-                        throw new Error("issue_id is required");
+                    const ident = resolveTaskIdentifier(args);
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a UUID, short_id, or task title");
+                    }
+                    logTool(name, ident.value);
+                    let result;
+                    if (ident.type === "title") {
+                        // Resolve by title search
+                        result = await apiClient.resolveTaskByName(ident.value);
+                    }
+                    else {
+                        // UUID or short_id — updateTaskStatus already handles both
+                        result = await apiClient.updateTaskStatus(ident.value, "resolved");
                     }
-                    logTool(name, issueId);
-                    const result = await apiClient.updateTaskStatus(issueId, "resolved");
                     const elapsed = Date.now() - startTime;
                     logSuccess(`Resolved "${result.issue?.title}" in ${elapsed}ms`);
                     return {
@@ -2471,21 +2589,19 @@ async function main() {
                     };
                 }
                 case "tasks_assign": {
-                    const issueId = args?.issue_id || args?.task_id;
-                    const shortId = args?.short_id;
-                    const issueTitle = args?.issue_title || args?.title;
+                    const ident = resolveTaskIdentifier(args);
                     const assigneeEmail = args?.assignee_email;
                     if (!assigneeEmail) {
                         throw new Error("assignee_email is required");
                     }
-                    if (!issueId && !shortId && !issueTitle) {
-                        throw new Error("Either issue_id, short_id, or issue_title is required");
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a UUID, short_id, or task title");
                     }
                     logTool(name, `→ ${assigneeEmail}`);
                     const result = await apiClient.assignTask({
-                        issue_id: issueId,
-                        short_id: shortId,
-                        issue_title: issueTitle,
+                        issue_id: ident.type === "uuid" ? ident.value : undefined,
+                        short_id: ident.type === "short_id" ? ident.value : undefined,
+                        issue_title: ident.type === "title" ? ident.value : undefined,
                         assignee_email: assigneeEmail,
                     });
                     const elapsed = Date.now() - startTime;
@@ -2500,12 +2616,19 @@ async function main() {
                     };
                 }
                 case "tasks_resolve_by_name": {
-                    const title = args?.title || args?.name;
-                    if (!title) {
-                        throw new Error("title is required");
+                    const ident = resolveTaskIdentifier(args);
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a title, short_id, or UUID");
+                    }
+                    logTool(name, `"${ident.value}"`);
+                    let result;
+                    if (ident.type === "title") {
+                        result = await apiClient.resolveTaskByName(ident.value);
+                    }
+                    else {
+                        // UUID or short_id — resolve directly
+                        result = await apiClient.updateTaskStatus(ident.value, "resolved");
                     }
-                    logTool(name, `"${title}"`);
-                    const result = await apiClient.resolveTaskByName(title);
                     const elapsed = Date.now() - startTime;
                     logSuccess(`Resolved "${result.issue?.title}" in ${elapsed}ms`);
                     return {
@@ -2521,12 +2644,21 @@ async function main() {
                     };
                 }
                 case "tasks_delete": {
-                    const issueId = args?.issue_id || args?.task_id;
-                    if (!issueId) {
-                        throw new Error("issue_id is required");
+                    const ident = resolveTaskIdentifier(args);
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a UUID, short_id, or task title");
+                    }
+                    logTool(name, ident.value);
+                    let deleteId = ident.value;
+                    if (ident.type === "title") {
+                        const { issues } = await apiClient.listTasks({ status: "all", limit: 100 });
+                        const titleLower = ident.value.toLowerCase();
+                        const match = issues?.find((i) => i.title.toLowerCase().includes(titleLower) || i.title.toLowerCase() === titleLower);
+                        if (!match)
+                            throw new Error(`No task found matching "${ident.value}"`);
+                        deleteId = match.id;
                     }
-                    logTool(name, issueId);
-                    const result = await apiClient.deleteTask(issueId);
+                    const result = await apiClient.deleteTask(deleteId);
                     const elapsed = Date.now() - startTime;
                     logSuccess(`Deleted task "${result.title}" in ${elapsed}ms`);
                     return {
@@ -2542,10 +2674,20 @@ async function main() {
                     };
                 }
                 case "tasks_update": {
-                    const issueId = args?.issue_id || args?.task_id;
-                    const shortId = args?.short_id;
-                    if (!issueId && !shortId) {
-                        throw new Error("Either issue_id or short_id is required");
+                    const ident = resolveTaskIdentifier(args);
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a UUID, short_id, or task title");
+                    }
+                    // Resolve title to UUID/short_id for the API
+                    let issueId = ident.type === "uuid" ? ident.value : undefined;
+                    let shortId = ident.type === "short_id" ? ident.value : undefined;
+                    if (ident.type === "title") {
+                        const { issues } = await apiClient.listTasks({ status: "all", limit: 100 });
+                        const titleLower = ident.value.toLowerCase();
+                        const match = issues?.find((i) => i.title.toLowerCase().includes(titleLower) || i.title.toLowerCase() === titleLower);
+                        if (!match)
+                            throw new Error(`No task found matching "${ident.value}"`);
+                        issueId = match.id;
                     }
                     const updateFields = {};
                     if (args?.title !== undefined)
@@ -2594,22 +2736,28 @@ async function main() {
                     };
                 }
                 case "tasks_list_comments": {
-                    const issueId = args?.issue_id || args?.task_id;
-                    if (!issueId) {
-                        throw new Error("issue_id is required");
+                    const ident = resolveTaskIdentifier(args);
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a UUID, short_id, or task title");
                     }
-                    logTool(name, issueId);
-                    // Resolve short_id to UUID if needed
-                    let resolvedId = issueId;
-                    const isShortId = /^[a-z0-9]{6}$/i.test(issueId) && !issueId.includes("-");
-                    if (isShortId) {
+                    logTool(name, ident.value);
+                    // Resolve to UUID
+                    let resolvedId = ident.value;
+                    if (ident.type !== "uuid") {
                         const { issues } = await apiClient.listTasks({
                             status: "all",
                             limit: 100,
                         });
-                        const match = issues?.find((i) => i.short_id?.toLowerCase() === issueId.toLowerCase());
+                        let match;
+                        if (ident.type === "short_id") {
+                            match = issues?.find((i) => i.short_id?.toLowerCase() === ident.value.toLowerCase());
+                        }
+                        else {
+                            const titleLower = ident.value.toLowerCase();
+                            match = issues?.find((i) => i.title.toLowerCase().includes(titleLower) || i.title.toLowerCase() === titleLower);
+                        }
                         if (!match) {
-                            throw new Error(`No task found with short_id "${issueId}"`);
+                            throw new Error(`No task found matching "${ident.value}"`);
                         }
                         resolvedId = match.id;
                     }
@@ -2645,26 +2793,32 @@ async function main() {
                     };
                 }
                 case "tasks_add_comment": {
-                    const issueId = args?.issue_id || args?.task_id;
+                    const ident = resolveTaskIdentifier(args);
                     const content = args?.content;
-                    if (!issueId) {
-                        throw new Error("issue_id is required");
+                    if (!ident) {
+                        throw new Error("identifier is required — pass a UUID, short_id, or task title");
                     }
                     if (!content) {
                         throw new Error("content is required");
                     }
-                    logTool(name, issueId);
-                    // Resolve short_id to UUID if needed
-                    let resolvedId = issueId;
-                    const isShortId = /^[a-z0-9]{6}$/i.test(issueId) && !issueId.includes("-");
-                    if (isShortId) {
+                    logTool(name, ident.value);
+                    // Resolve to UUID
+                    let resolvedId = ident.value;
+                    if (ident.type !== "uuid") {
                         const { issues } = await apiClient.listTasks({
                             status: "all",
                             limit: 100,
                         });
-                        const match = issues?.find((i) => i.short_id?.toLowerCase() === issueId.toLowerCase());
+                        let match;
+                        if (ident.type === "short_id") {
+                            match = issues?.find((i) => i.short_id?.toLowerCase() === ident.value.toLowerCase());
+                        }
+                        else {
+                            const titleLower = ident.value.toLowerCase();
+                            match = issues?.find((i) => i.title.toLowerCase().includes(titleLower) || i.title.toLowerCase() === titleLower);
+                        }
                         if (!match) {
-                            throw new Error(`No task found with short_id "${issueId}"`);
+                            throw new Error(`No task found matching "${ident.value}"`);
                         }
                         resolvedId = match.id;
                     }
@@ -2968,6 +3122,88 @@ https://github.com/contextforge/contextforge-mcp
                         ],
                     };
                 }
+                case "skills_list": {
+                    const input = SkillsListInputSchema.parse(args);
+                    logTool(name, input.project_id);
+                    const skills = await apiClient.listSkills(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(skills, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case "skills_get": {
+                    const input = SkillsGetInputSchema.parse(args);
+                    logTool(name, input.id);
+                    const skill = await apiClient.getSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(skill, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case "skills_create": {
+                    const input = SkillsCreateInputSchema.parse(args);
+                    logTool(name, `"${input.name}"`);
+                    const skill = await apiClient.createSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Created skill ${skill.name} (id: ${skill.id})`,
+                            },
+                        ],
+                    };
+                }
+                case "skills_update": {
+                    const input = SkillsUpdateInputSchema.parse(args);
+                    logTool(name, input.id);
+                    const skill = await apiClient.updateSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Updated skill ${skill.name}`,
+                            },
+                        ],
+                    };
+                }
+                case "skills_delete": {
+                    const input = SkillsDeleteInputSchema.parse(args);
+                    logTool(name, input.id);
+                    await apiClient.deleteSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `🗑️ Skill ${input.id} deleted`,
+                            },
+                        ],
+                    };
+                }
+                case "skills_run": {
+                    const input = SkillsRunInputSchema.parse(args);
+                    logTool(name, input.skill_id);
+                    const result = await apiClient.runSkill(input);
+                    const cost = typeof result?.cost_usd === "number"
+                        ? result.cost_usd.toFixed(4)
+                        : "0";
+                    const summary = `**Output:**\n\n${result?.output ?? ""}\n\n---\n*Tokens: ${result?.tokens_input ?? 0}/${result?.tokens_output ?? 0} • Cost: $${cost}*`;
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: summary,
+                            },
+                        ],
+                    };
+                }
                 default:
                     logError(`Unknown tool: ${name}`);
                     return {