fa-mcp-sdk 0.12.15 → 0.12.19

package/cli-template/package.json

@@ -58,7 +58,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.1",
-    "fa-mcp-sdk": "^0.12.15"
+    "fa-mcp-sdk": "^0.12.19"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",

package/dist/core/web/home-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"home-api.d.ts","sourceRoot":"","sources":["../../../src/core/web/home-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA6B5C,wBAAsB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkHhF"}
+{"version":3,"file":"home-api.d.ts","sourceRoot":"","sources":["../../../src/core/web/home-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA6B5C,wBAAsB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA4IhF"}

package/dist/core/web/home-api.js

@@ -39,7 +39,29 @@ export async function handleHomeInfo(_req, res) {
         const { httpComponents } = global.__MCP_PROJECT_DATA__;
         const toolsOrFn = global.__MCP_PROJECT_DATA__.tools;
         let tools = typeof toolsOrFn === 'function' ? await toolsOrFn(httpArgs) : toolsOrFn;
-        const { getConsulUIAddress = (_s) => '' } = getProjectData();
+        const { getConsulUIAddress = (_s) => '', toolPrompt } = getProjectData();
+        // Honestly probe every tool for a non-empty tool-specific prompt. The `tool_prompt` prompt is
+        // advertised over MCP unconditionally, but on the home page it should appear only when at least
+        // one tool actually returns a non-empty prompt. We collect the names of such tools so the viewer
+        // can offer a dropdown, and drop `tool_prompt` from the home prompt list when none qualify.
+        const toolPromptTools = [];
+        let homePrompts = prompts;
+        if (typeof toolPrompt === 'function') {
+            for (const tool of tools) {
+                try {
+                    const text = await toolPrompt({ method: 'prompts/get', params: { name: 'tool_prompt', arguments: { tool: tool.name } } }, { tool: tool.name });
+                    if (typeof text === 'string' && text.trim()) {
+                        toolPromptTools.push(tool.name);
+                    }
+                }
+                catch {
+                    // A tool whose prompt resolver throws is treated as having no prompt.
+                }
+            }
+        }
+        if (toolPromptTools.length === 0) {
+            homePrompts = prompts.filter((p) => p.name !== 'tool_prompt');
+        }
         // Build footer HTML
         const footerParts = [];
         if (repo) {
@@ -111,10 +133,11 @@ export async function handleHomeInfo(_req, res) {
             logoSvg,
             toolsCount: tools.length,
             resourcesCount: resources.length,
-            promptsCount: prompts.length,
+            promptsCount: homePrompts.length,
             tools,
             resources,
-            prompts,
+            prompts: homePrompts,
+            toolPromptTools,
             db,
             openAPI: !!httpComponents?.apiRouter,
             consul,

package/dist/core/web/home-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"home-api.js","sourceRoot":"","sources":["../../../src/core/web/home-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"home-api.js","sourceRoot":"","sources":["../../../src/core/web/home-api.ts"],"names":[],"mappings":"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"}

package/dist/core/web/static/home/script.js

@@ -2,6 +2,9 @@
 let toolsData = [];
 let resourcesData = [];
 let promptsData = [];
+// Names of tools that expose a non-empty `tool_prompt`, computed honestly on the server by probing
+// every tool. Drives the dropdown shown for the `tool_prompt` row in the prompts modal.
+let toolPromptTools = [];
 
 // Parse an /mcp response. The Streamable HTTP transport may answer either as plain JSON or as a
 // Server-Sent Events stream ("event: message\ndata: {...}"), depending on negotiation. Handle both so
@@ -187,6 +190,7 @@ async function loadPageData() {
     toolsData = data.tools || [];
     resourcesData = data.resources || [];
     promptsData = data.prompts || [];
+    toolPromptTools = data.toolPromptTools || [];
 
     // Render page info
     renderPageInfo(data);
@@ -300,14 +304,19 @@ function generatePromptsTableRows(prompts) {
     return '<tr><td colspan="2" class="loading-cell">No prompts available</td></tr>';
   }
   return prompts
-    .map(
-      (prompt, index) =>
-        `<tr>
+    .map((prompt, index) => {
+      // The `tool_prompt` row gets a tool picker instead of a static "prompt" link: choosing a tool
+      // fetches that tool's prompt. The list of tools is restricted to those with a non-empty prompt.
+      const actions =
+        prompt.name === 'tool_prompt'
+          ? `<span class="tool-prompt-actions"><a class="detail-link" id="prompts-toggle-details-${index}" onclick="togglePromptDetails('prompts', ${index}, 'details')">details</a> / <select class="tool-prompt-select" id="tool-prompt-select-${index}" onchange="loadToolPrompt(${index}, this.value)"><option value="">— select tool —</option>${toolPromptTools.map((name) => `<option value="${escapeAttr(name)}">${escapeHtml(name)}</option>`).join('')}</select></span>`
+          : `<a class="detail-link" id="prompts-toggle-details-${index}" onclick="togglePromptDetails('prompts', ${index}, 'details')">details</a>
+ /
+<a class="detail-link" id="prompts-toggle-prompt-${index}" onclick="togglePromptDetails('prompts', ${index}, 'prompt')">prompt</a>`;
+      return `<tr>
 <td><code>${prompt.name}</code></td>
 <td>
-<a class="detail-link" id="prompts-toggle-details-${index}" onclick="togglePromptDetails('prompts', ${index}, 'details')">details</a>
- /
-<a class="detail-link" id="prompts-toggle-prompt-${index}" onclick="togglePromptDetails('prompts', ${index}, 'prompt')">prompt</a>
+${actions}
 </td>
 </tr>
 <tr id="prompts-detail-${index}" class="detail-row" style="display: none;">
@@ -318,8 +327,8 @@ function generatePromptsTableRows(prompts) {
 <div class="prompt-content" style="display: none;"></div>
 </div>
 </td>
-</tr>`,
-    )
+</tr>`;
+    })
     .join('');
 }
 
@@ -391,7 +400,10 @@ async function togglePromptDetails(sectionName, index, displayType) {
     // Show the detail row with loading state
     detailRow.style.display = 'table-row';
     currentToggleLink.textContent = 'hide';
-    otherToggleLink.textContent = displayType === 'details' ? 'prompt' : 'details';
+    // The `tool_prompt` row has no separate "prompt" link (it uses a dropdown), so guard against null.
+    if (otherToggleLink) {
+      otherToggleLink.textContent = displayType === 'details' ? 'prompt' : 'details';
+    }
     loadingSpinner.style.display = 'block';
     jsonContent.style.display = 'none';
     promptContent.style.display = 'none';
@@ -465,7 +477,89 @@ async function togglePromptDetails(sectionName, index, displayType) {
     // Hide the detail row
     detailRow.style.display = 'none';
     toggleLinkDetails.textContent = 'details';
-    toggleLinkPrompt.textContent = 'prompt';
+    if (toggleLinkPrompt) {
+      toggleLinkPrompt.textContent = 'prompt';
+    }
+  }
+}
+
+// Fetch and display the prompt of a specific tool via the `tool_prompt` MCP prompt. Triggered by the
+// tool dropdown in the prompts modal; passes the selected tool name in the `tool` argument.
+// eslint-disable-next-line unused-imports/no-unused-vars
+async function loadToolPrompt(index, toolName) {
+  const detailRow = document.getElementById('prompts-detail-' + index);
+  const loadingSpinner = detailRow.querySelector('.loading-spinner');
+  const jsonContent = detailRow.querySelector('.json-content');
+  const promptContent = detailRow.querySelector('.prompt-content');
+  const toggleLinkDetails = document.getElementById('prompts-toggle-details-' + index);
+
+  // Empty selection collapses the detail row and restores the "details" link label.
+  if (!toolName) {
+    detailRow.style.display = 'none';
+    if (toggleLinkDetails) {
+      toggleLinkDetails.textContent = 'details';
+    }
+    return;
+  }
+
+  detailRow.style.display = 'table-row';
+  if (toggleLinkDetails) {
+    toggleLinkDetails.textContent = 'details';
+  }
+  loadingSpinner.style.display = 'block';
+  jsonContent.style.display = 'none';
+  promptContent.style.display = 'none';
+
+  try {
+    const response = await fetch('/mcp', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream' },
+      body: JSON.stringify({
+        jsonrpc: '2.0',
+        id: Date.now(),
+        method: 'prompts/get',
+        params: { name: 'tool_prompt', arguments: { tool: toolName } },
+      }),
+    });
+
+    if (!response.ok) {
+      let errorData = '';
+      try {
+        errorData = await response.text();
+      } catch {
+        //
+      }
+      errorData = [response.statusText || '', errorData].join('. ');
+      throw new Error('HTTP ' + response.status + (errorData ? ': ' + errorData : ''));
+    }
+
+    const result = await parseMcpJsonResponse(response);
+    const messages = result.result?.messages || [];
+    let promptText = '';
+
+    messages.forEach((msg, i) => {
+      if (i > 0) {
+        promptText += '\n\n---\n\n';
+      }
+      promptText += 'Role: ' + msg.role + '\n\n';
+      if (typeof msg.content === 'string') {
+        promptText += msg.content;
+      } else if (msg.content?.text) {
+        promptText += msg.content.text;
+      } else {
+        promptText += JSON.stringify(msg.content, null, 2);
+      }
+    });
+
+    loadingSpinner.style.display = 'none';
+    promptContent.style.display = 'block';
+    promptContent.innerHTML = '<pre class="json-content">' + escapeHtml(promptText) + '</pre>';
+    addCopyButton(promptContent.querySelector('.json-content'));
+  } catch (error) {
+    loadingSpinner.style.display = 'none';
+    promptContent.style.display = 'block';
+    promptContent.innerHTML =
+      '<div class="error-message">Failed to load tool prompt: ' + escapeHtml(error.message) + '</div>';
   }
 }
 
@@ -625,6 +719,11 @@ function escapeHtml(text) {
   return div.innerHTML;
 }
 
+// Escape a string for safe use inside a double-quoted HTML attribute (e.g. <option value="...">).
+function escapeAttr(text) {
+  return escapeHtml(text).replace(/"/g, '&quot;');
+}
+
 // Copy to clipboard functionality
 function addCopyButton(contentElement) {
   if (!contentElement || contentElement.hasAttribute('data-copy-added')) {

package/dist/core/web/static/styles.css

@@ -273,6 +273,17 @@ select {
   padding: 3px 6px;
 }
 
+.tool-prompt-actions {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  white-space: nowrap;
+}
+
+.tool-prompt-select {
+  vertical-align: middle;
+}
+
 input:focus, select:focus, textarea:focus {
   outline: none;
   border-color: #0065ff;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.12.15",
+  "version": "0.12.19",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",

package/scripts/fcp.js

@@ -1,16 +1,22 @@
 #!/usr/bin/env node
 
 /**
- * Atomically save content to a file.
+ * The sanctioned write/delete channel for files under .claude/ (and any other path).
+ *
+ * Direct Write/Edit on .claude/** is denied by settings.json, and direct shell modification of .claude/
+ * (rm, mv, cp, output redirection) is blocked by the harness. This script is the ONE allowed way to create,
+ * overwrite or delete such files, because it runs as `node` (an allowlisted command). See the /edit-claude-files
+ * skill for the full protocol.
  *
  * Usage:
- *   node scripts/fcp.js <filePath> <contentFilePath>
+ *   node scripts/fcp.js <filePath> <contentFilePath>   # create/overwrite <filePath> with the contents of the temp file
+ *   node scripts/fcp.js --rm <path> [<path> ...]       # delete the given path(s) (files or directories, recursive)
  *
  * <filePath>        — destination path (absolute or relative to project root)
  * <contentFilePath> — path to a temp file whose contents will be written to <filePath>
  *
- * The script reads the content from <contentFilePath> and writes it to <filePath>,
- * creating parent directories if needed.
+ * Write mode reads the content from <contentFilePath> and writes it to <filePath>, creating parent directories if
+ * needed. Delete mode (--rm / --delete) removes each target path; missing paths are reported, not an error.
  */
 
 import fs from 'fs';
@@ -22,10 +28,31 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const projectRoot = path.resolve(__dirname, '..');
 
-const [, , rawTarget, rawSource] = process.argv;
+const argv = process.argv.slice(2);
+
+// Delete mode: `--rm` / `--delete` followed by one or more paths to remove.
+if (argv[0] === '--rm' || argv[0] === '--delete') {
+  const targets = argv.slice(1);
+  if (!targets.length) {
+    console.error('Usage: node scripts/fcp.js --rm <path> [<path> ...]');
+    process.exit(1);
+  }
+  for (const raw of targets) {
+    const target = path.isAbsolute(raw) ? raw : path.resolve(projectRoot, raw);
+    if (fs.existsSync(target)) {
+      fs.rmSync(target, { recursive: true, force: true });
+      console.log(`Deleted: ${target}`);
+    } else {
+      console.log(`Already absent: ${target}`);
+    }
+  }
+  process.exit(0);
+}
+
+const [rawTarget, rawSource] = argv;
 
 if (!rawTarget || !rawSource) {
-  console.error('Usage: node scripts/fcp.js <filePath> <contentFilePath>');
+  console.error('Usage: node scripts/fcp.js <filePath> <contentFilePath>  |  node scripts/fcp.js --rm <path> [...]');
   process.exit(1);
 }
 

package/src/template/prompts/tool-prompts.ts

@@ -0,0 +1,33 @@
+import { TPromptContentFunction } from '../../core/index.js';
+
+/**
+ * Tool-specific prompts served by the built-in `tool_prompt` prompt.
+ *
+ * The `tool_prompt` prompt is always advertised over MCP, but it returns a non-empty string only
+ * for the tools listed here. Clients pass the tool name in the required `tool` argument; the home
+ * page catalog viewer additionally shows a dropdown of the tools that have a non-empty prompt.
+ *
+ * Add an entry keyed by the MCP tool name to attach usage instructions to that tool.
+ */
+const TOOL_PROMPTS: Record<string, string> = {
+  example_tool: `You are using the "example_tool" tool, which processes a text input and returns the result.
+
+- Pass the text to process in the required "query" field.
+- Keep the input concise; send one logical request at a time.
+- Use the returned text as the processed output — do not re-process it again unless the user asks.`,
+
+  example_search: `You are using the "example_search" tool, which performs a search with pagination and filtering.
+
+- Put the search text in the required "query" field.
+- Use "limit" (1-100, default 20) to cap the number of results; request only as many as you need.
+- Use "threshold" (0-1) to drop low-similarity matches when precision matters more than recall.
+- Read results from the "results" array; "total" reports how many matches exist overall.`,
+};
+
+export const toolPrompt: TPromptContentFunction = (_request, args) => {
+  const tool = args?.tool;
+  if (!tool) {
+    return '';
+  }
+  return TOOL_PROMPTS[tool] ?? '';
+};

package/src/template/start.ts

@@ -6,6 +6,7 @@ import { customResources } from './custom-resources.js';
 import { AGENT_BRIEF } from './prompts/agent-brief.js';
 import { AGENT_PROMPT } from './prompts/agent-prompt.js';
 import { customPrompts } from './prompts/custom-prompts.js';
+import { toolPrompt } from './prompts/tool-prompts.js';
 import { handleToolCall } from './tools/handle-tool-call.js';
 import { tools } from './tools/tools.js';
 
@@ -27,6 +28,7 @@ const startProject = async (): Promise<void> => {
     // Prompts
     agentBrief: AGENT_BRIEF,
     agentPrompt: AGENT_PROMPT,
+    toolPrompt,
     customPrompts,
     usedHttpHeaders: [
       { name: 'Authorization', description: 'JWT Token issued on request' },

package/src/template/tools/tools.ts

@@ -101,9 +101,8 @@ export const tools: Tool[] = [
     // work can exceed the 30s tool timeout or you want a cancellable, pollable operation.
     name: 'example_long_task',
     title: 'Example: long-running task',
-    description:
-      'Example long-running tool that emits progress and supports cancellation. ' +
-      'Demonstrates task-augmented execution (§8.7) — call it with a `task` param to run it as a task.',
+    description: `Example long-running tool that emits progress and supports cancellation. 
+Demonstrates task-augmented execution — call it with a 'task' param to run it as a task.`,
     inputSchema: {
       $schema: JSON_SCHEMA_2020_12,
       type: 'object',