fastmcp 4.24.4 → 4.25.0

package/dist/FastMCP.cjs

@@ -11,7 +11,7 @@
 
 
 
-var _chunkXPGMRMMNcjs = require('./chunk-XPGMRMMN.cjs');
+var _chunkAJE7ERFMcjs = require('./chunk-AJE7ERFM.cjs');
 
 
 
@@ -24,7 +24,7 @@ var _chunkXPGMRMMNcjs = require('./chunk-XPGMRMMN.cjs');
 
 
 
-var _chunkBV4PWTT6cjs = require('./chunk-BV4PWTT6.cjs');
+var _chunkB7IXBMHVcjs = require('./chunk-B7IXBMHV.cjs');
 require('./chunk-6TDYSPLC.cjs');
 
 
@@ -50,5 +50,5 @@ require('./chunk-6TDYSPLC.cjs');
 
 
 
-exports.AuthProvider = _chunkBV4PWTT6cjs.AuthProvider; exports.AzureProvider = _chunkBV4PWTT6cjs.AzureProvider; exports.DiscoveryDocumentCache = _chunkXPGMRMMNcjs.DiscoveryDocumentCache; exports.FastMCP = _chunkXPGMRMMNcjs.FastMCP; exports.FastMCPError = _chunkXPGMRMMNcjs.FastMCPError; exports.FastMCPSession = _chunkXPGMRMMNcjs.FastMCPSession; exports.GitHubProvider = _chunkBV4PWTT6cjs.GitHubProvider; exports.GoogleProvider = _chunkBV4PWTT6cjs.GoogleProvider; exports.MEDIA_FETCH_TIMEOUT_MS = _chunkXPGMRMMNcjs.MEDIA_FETCH_TIMEOUT_MS; exports.OAuthProvider = _chunkBV4PWTT6cjs.OAuthProvider; exports.ServerState = _chunkXPGMRMMNcjs.ServerState; exports.SessionError = _chunkXPGMRMMNcjs.SessionError; exports.UnexpectedStateError = _chunkXPGMRMMNcjs.UnexpectedStateError; exports.UserError = _chunkXPGMRMMNcjs.UserError; exports.audioContent = _chunkXPGMRMMNcjs.audioContent; exports.getAuthSession = _chunkBV4PWTT6cjs.getAuthSession; exports.imageContent = _chunkXPGMRMMNcjs.imageContent; exports.jsonSchemaAdapter = _chunkXPGMRMMNcjs.jsonSchemaAdapter; exports.requireAll = _chunkBV4PWTT6cjs.requireAll; exports.requireAny = _chunkBV4PWTT6cjs.requireAny; exports.requireAuth = _chunkBV4PWTT6cjs.requireAuth; exports.requireRole = _chunkBV4PWTT6cjs.requireRole; exports.requireScopes = _chunkBV4PWTT6cjs.requireScopes;
+exports.AuthProvider = _chunkB7IXBMHVcjs.AuthProvider; exports.AzureProvider = _chunkB7IXBMHVcjs.AzureProvider; exports.DiscoveryDocumentCache = _chunkAJE7ERFMcjs.DiscoveryDocumentCache; exports.FastMCP = _chunkAJE7ERFMcjs.FastMCP; exports.FastMCPError = _chunkAJE7ERFMcjs.FastMCPError; exports.FastMCPSession = _chunkAJE7ERFMcjs.FastMCPSession; exports.GitHubProvider = _chunkB7IXBMHVcjs.GitHubProvider; exports.GoogleProvider = _chunkB7IXBMHVcjs.GoogleProvider; exports.MEDIA_FETCH_TIMEOUT_MS = _chunkAJE7ERFMcjs.MEDIA_FETCH_TIMEOUT_MS; exports.OAuthProvider = _chunkB7IXBMHVcjs.OAuthProvider; exports.ServerState = _chunkAJE7ERFMcjs.ServerState; exports.SessionError = _chunkAJE7ERFMcjs.SessionError; exports.UnexpectedStateError = _chunkAJE7ERFMcjs.UnexpectedStateError; exports.UserError = _chunkAJE7ERFMcjs.UserError; exports.audioContent = _chunkAJE7ERFMcjs.audioContent; exports.getAuthSession = _chunkB7IXBMHVcjs.getAuthSession; exports.imageContent = _chunkAJE7ERFMcjs.imageContent; exports.jsonSchemaAdapter = _chunkAJE7ERFMcjs.jsonSchemaAdapter; exports.requireAll = _chunkB7IXBMHVcjs.requireAll; exports.requireAny = _chunkB7IXBMHVcjs.requireAny; exports.requireAuth = _chunkB7IXBMHVcjs.requireAuth; exports.requireRole = _chunkB7IXBMHVcjs.requireRole; exports.requireScopes = _chunkB7IXBMHVcjs.requireScopes;
 //# sourceMappingURL=FastMCP.cjs.map

package/dist/FastMCP.d.cts

@@ -12,8 +12,8 @@ import { CorsOptions } from 'mcp-proxy';
 export { CorsOptions } from 'mcp-proxy';
 import { StrictEventEmitter } from 'strict-event-emitter-types';
 import { z } from 'zod';
-import { A as AuthProvider, O as OAuthSession, a as OAuthProxy } from './OAuthProvider-84BWWDBF.cjs';
-export { j as AuthProviderConfig, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, d as OAuthProvider, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from './OAuthProvider-84BWWDBF.cjs';
+import { A as AuthProvider, O as OAuthSession, a as OAuthProxy } from './OAuthProvider-BGtNEdC3.cjs';
+export { j as AuthProviderConfig, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, d as OAuthProvider, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from './OAuthProvider-BGtNEdC3.cjs';
 import 'node:http';
 
 declare class DiscoveryDocumentCache {

package/dist/FastMCP.d.ts

@@ -12,8 +12,8 @@ import { CorsOptions } from 'mcp-proxy';
 export { CorsOptions } from 'mcp-proxy';
 import { StrictEventEmitter } from 'strict-event-emitter-types';
 import { z } from 'zod';
-import { A as AuthProvider, O as OAuthSession, a as OAuthProxy } from './OAuthProvider-84BWWDBF.js';
-export { j as AuthProviderConfig, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, d as OAuthProvider, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from './OAuthProvider-84BWWDBF.js';
+import { A as AuthProvider, O as OAuthSession, a as OAuthProxy } from './OAuthProvider-BGtNEdC3.js';
+export { j as AuthProviderConfig, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, d as OAuthProvider, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from './OAuthProvider-BGtNEdC3.js';
 import 'node:http';
 
 declare class DiscoveryDocumentCache {

package/dist/FastMCP.js

@@ -11,7 +11,7 @@ import {
   audioContent,
   imageContent,
   jsonSchemaAdapter
-} from "./chunk-D2CVYAA5.js";
+} from "./chunk-PU3JOW7T.js";
 import {
   AuthProvider,
   AzureProvider,
@@ -24,7 +24,7 @@ import {
   requireAuth,
   requireRole,
   requireScopes
-} from "./chunk-CAQLTSJ5.js";
+} from "./chunk-JFHOYU3S.js";
 import "./chunk-OKKFL2M4.js";
 export {
   AuthProvider,

package/dist/{OAuthProvider-84BWWDBF.d.cts → OAuthProvider-BGtNEdC3.d.cts}

@@ -725,6 +725,20 @@ declare class OAuthProxy {
      * Refresh upstream tokens with provider
      */
     private refreshUpstreamTokens;
+    /**
+     * RFC 6749 §5.2: a provider refuses a token request by naming the error in
+     * the response body. The status that carries it is not fixed — GitHub, whose
+     * own branch exists above, answers every refusal with 200 — so a refusal is
+     * recognised here, from the body, rather than left to fail the token schema
+     * parse. Without this the upstream's own diagnosis (`bad_verification_code`,
+     * `invalid_grant`, …) is replaced by a `ZodError`, which the routes answer as
+     * `server_error` (callback) or `invalid_request` (token).
+     *
+     * The upstream's code is kept as the `OAuthProxyError` code, and its
+     * description when it sent one, so the client is told what the provider
+     * actually refused.
+     */
+    private rejectUpstreamError;
     /**
      * Resolve the client behind a `client_id`: a stored registration if there is
      * one, otherwise — when CIMD is enabled — the client's metadata document.

package/dist/{OAuthProvider-84BWWDBF.d.ts → OAuthProvider-BGtNEdC3.d.ts}

@@ -725,6 +725,20 @@ declare class OAuthProxy {
      * Refresh upstream tokens with provider
      */
     private refreshUpstreamTokens;
+    /**
+     * RFC 6749 §5.2: a provider refuses a token request by naming the error in
+     * the response body. The status that carries it is not fixed — GitHub, whose
+     * own branch exists above, answers every refusal with 200 — so a refusal is
+     * recognised here, from the body, rather than left to fail the token schema
+     * parse. Without this the upstream's own diagnosis (`bad_verification_code`,
+     * `invalid_grant`, …) is replaced by a `ZodError`, which the routes answer as
+     * `server_error` (callback) or `invalid_request` (token).
+     *
+     * The upstream's code is kept as the `OAuthProxyError` code, and its
+     * description when it sent one, so the client is told what the provider
+     * actually refused.
+     */
+    private rejectUpstreamError;
     /**
      * Resolve the client behind a `client_id`: a stored registration if there is
      * one, otherwise — when CIMD is enabled — the client's metadata document.

package/dist/auth/index.cjs

@@ -25,7 +25,7 @@
 
 
 
-var _chunkBV4PWTT6cjs = require('../chunk-BV4PWTT6.cjs');
+var _chunkB7IXBMHVcjs = require('../chunk-B7IXBMHV.cjs');
 
 
 
@@ -53,5 +53,5 @@ var _chunkBV4PWTT6cjs = require('../chunk-BV4PWTT6.cjs');
 
 
 
-exports.AuthProvider = _chunkBV4PWTT6cjs.AuthProvider; exports.AzureProvider = _chunkBV4PWTT6cjs.AzureProvider; exports.ConsentManager = _chunkBV4PWTT6cjs.ConsentManager; exports.DEFAULT_ACCESS_TOKEN_TTL = _chunkBV4PWTT6cjs.DEFAULT_ACCESS_TOKEN_TTL; exports.DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH = _chunkBV4PWTT6cjs.DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH; exports.DEFAULT_AUTHORIZATION_CODE_TTL = _chunkBV4PWTT6cjs.DEFAULT_AUTHORIZATION_CODE_TTL; exports.DEFAULT_REFRESH_TOKEN_TTL = _chunkBV4PWTT6cjs.DEFAULT_REFRESH_TOKEN_TTL; exports.DEFAULT_TRANSACTION_TTL = _chunkBV4PWTT6cjs.DEFAULT_TRANSACTION_TTL; exports.DiskStore = _chunkBV4PWTT6cjs.DiskStore; exports.EncryptedTokenStorage = _chunkBV4PWTT6cjs.EncryptedTokenStorage; exports.GitHubProvider = _chunkBV4PWTT6cjs.GitHubProvider; exports.GoogleProvider = _chunkBV4PWTT6cjs.GoogleProvider; exports.JWKSVerifier = _chunkBV4PWTT6cjs.JWKSVerifier; exports.JWTIssuer = _chunkBV4PWTT6cjs.JWTIssuer; exports.MemoryTokenStorage = _chunkBV4PWTT6cjs.MemoryTokenStorage; exports.OAuthProvider = _chunkBV4PWTT6cjs.OAuthProvider; exports.OAuthProxy = _chunkBV4PWTT6cjs.OAuthProxy; exports.OAuthProxyError = _chunkBV4PWTT6cjs.OAuthProxyError; exports.PKCEUtils = _chunkBV4PWTT6cjs.PKCEUtils; exports.TOKEN_ENDPOINT_AUTH_METHODS = _chunkBV4PWTT6cjs.TOKEN_ENDPOINT_AUTH_METHODS; exports.getAuthSession = _chunkBV4PWTT6cjs.getAuthSession; exports.requireAll = _chunkBV4PWTT6cjs.requireAll; exports.requireAny = _chunkBV4PWTT6cjs.requireAny; exports.requireAuth = _chunkBV4PWTT6cjs.requireAuth; exports.requireRole = _chunkBV4PWTT6cjs.requireRole; exports.requireScopes = _chunkBV4PWTT6cjs.requireScopes;
+exports.AuthProvider = _chunkB7IXBMHVcjs.AuthProvider; exports.AzureProvider = _chunkB7IXBMHVcjs.AzureProvider; exports.ConsentManager = _chunkB7IXBMHVcjs.ConsentManager; exports.DEFAULT_ACCESS_TOKEN_TTL = _chunkB7IXBMHVcjs.DEFAULT_ACCESS_TOKEN_TTL; exports.DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH = _chunkB7IXBMHVcjs.DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH; exports.DEFAULT_AUTHORIZATION_CODE_TTL = _chunkB7IXBMHVcjs.DEFAULT_AUTHORIZATION_CODE_TTL; exports.DEFAULT_REFRESH_TOKEN_TTL = _chunkB7IXBMHVcjs.DEFAULT_REFRESH_TOKEN_TTL; exports.DEFAULT_TRANSACTION_TTL = _chunkB7IXBMHVcjs.DEFAULT_TRANSACTION_TTL; exports.DiskStore = _chunkB7IXBMHVcjs.DiskStore; exports.EncryptedTokenStorage = _chunkB7IXBMHVcjs.EncryptedTokenStorage; exports.GitHubProvider = _chunkB7IXBMHVcjs.GitHubProvider; exports.GoogleProvider = _chunkB7IXBMHVcjs.GoogleProvider; exports.JWKSVerifier = _chunkB7IXBMHVcjs.JWKSVerifier; exports.JWTIssuer = _chunkB7IXBMHVcjs.JWTIssuer; exports.MemoryTokenStorage = _chunkB7IXBMHVcjs.MemoryTokenStorage; exports.OAuthProvider = _chunkB7IXBMHVcjs.OAuthProvider; exports.OAuthProxy = _chunkB7IXBMHVcjs.OAuthProxy; exports.OAuthProxyError = _chunkB7IXBMHVcjs.OAuthProxyError; exports.PKCEUtils = _chunkB7IXBMHVcjs.PKCEUtils; exports.TOKEN_ENDPOINT_AUTH_METHODS = _chunkB7IXBMHVcjs.TOKEN_ENDPOINT_AUTH_METHODS; exports.getAuthSession = _chunkB7IXBMHVcjs.getAuthSession; exports.requireAll = _chunkB7IXBMHVcjs.requireAll; exports.requireAny = _chunkB7IXBMHVcjs.requireAny; exports.requireAuth = _chunkB7IXBMHVcjs.requireAuth; exports.requireRole = _chunkB7IXBMHVcjs.requireRole; exports.requireScopes = _chunkB7IXBMHVcjs.requireScopes;
 //# sourceMappingURL=index.cjs.map

package/dist/auth/index.d.cts

@@ -1,5 +1,5 @@
-import { p as OAuthTransaction, C as ConsentData, T as TokenStorage, q as TokenVerifier, s as TokenVerificationResult, P as PKCEPair } from '../OAuthProvider-84BWWDBF.cjs';
-export { A as AuthProvider, j as AuthProviderConfig, z as AuthorizationParams, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, B as ClientCode, E as DCRClientMetadata, F as DCRRequest, H as DCRResponse, D as DEFAULT_ACCESS_TOKEN_TTL, u as DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH, v as DEFAULT_AUTHORIZATION_CODE_TTL, w as DEFAULT_REFRESH_TOKEN_TTL, x as DEFAULT_TRANSACTION_TTL, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, I as OAuthError, d as OAuthProvider, J as OAuthProviderConfig, a as OAuthProxy, K as OAuthProxyConfig, t as OAuthProxyError, O as OAuthSession, L as ProxyDCRClient, R as RefreshRequest, y as TOKEN_ENDPOINT_AUTH_METHODS, M as TokenEndpointAuthMethod, N as TokenMapping, Q as TokenRequest, S as TokenResponse, U as UpstreamTokenSet, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from '../OAuthProvider-84BWWDBF.cjs';
+import { p as OAuthTransaction, C as ConsentData, T as TokenStorage, q as TokenVerifier, s as TokenVerificationResult, P as PKCEPair } from '../OAuthProvider-BGtNEdC3.cjs';
+export { A as AuthProvider, j as AuthProviderConfig, z as AuthorizationParams, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, B as ClientCode, E as DCRClientMetadata, F as DCRRequest, H as DCRResponse, D as DEFAULT_ACCESS_TOKEN_TTL, u as DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH, v as DEFAULT_AUTHORIZATION_CODE_TTL, w as DEFAULT_REFRESH_TOKEN_TTL, x as DEFAULT_TRANSACTION_TTL, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, I as OAuthError, d as OAuthProvider, J as OAuthProviderConfig, a as OAuthProxy, K as OAuthProxyConfig, t as OAuthProxyError, O as OAuthSession, L as ProxyDCRClient, R as RefreshRequest, y as TOKEN_ENDPOINT_AUTH_METHODS, M as TokenEndpointAuthMethod, N as TokenMapping, Q as TokenRequest, S as TokenResponse, U as UpstreamTokenSet, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from '../OAuthProvider-BGtNEdC3.cjs';
 import 'node:http';
 
 /**

package/dist/auth/index.d.ts

@@ -1,5 +1,5 @@
-import { p as OAuthTransaction, C as ConsentData, T as TokenStorage, q as TokenVerifier, s as TokenVerificationResult, P as PKCEPair } from '../OAuthProvider-84BWWDBF.js';
-export { A as AuthProvider, j as AuthProviderConfig, z as AuthorizationParams, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, B as ClientCode, E as DCRClientMetadata, F as DCRRequest, H as DCRResponse, D as DEFAULT_ACCESS_TOKEN_TTL, u as DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH, v as DEFAULT_AUTHORIZATION_CODE_TTL, w as DEFAULT_REFRESH_TOKEN_TTL, x as DEFAULT_TRANSACTION_TTL, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, I as OAuthError, d as OAuthProvider, J as OAuthProviderConfig, a as OAuthProxy, K as OAuthProxyConfig, t as OAuthProxyError, O as OAuthSession, L as ProxyDCRClient, R as RefreshRequest, y as TOKEN_ENDPOINT_AUTH_METHODS, M as TokenEndpointAuthMethod, N as TokenMapping, Q as TokenRequest, S as TokenResponse, U as UpstreamTokenSet, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from '../OAuthProvider-84BWWDBF.js';
+import { p as OAuthTransaction, C as ConsentData, T as TokenStorage, q as TokenVerifier, s as TokenVerificationResult, P as PKCEPair } from '../OAuthProvider-BGtNEdC3.js';
+export { A as AuthProvider, j as AuthProviderConfig, z as AuthorizationParams, b as AzureProvider, k as AzureProviderConfig, l as AzureSession, B as ClientCode, E as DCRClientMetadata, F as DCRRequest, H as DCRResponse, D as DEFAULT_ACCESS_TOKEN_TTL, u as DEFAULT_ACCESS_TOKEN_TTL_NO_REFRESH, v as DEFAULT_AUTHORIZATION_CODE_TTL, w as DEFAULT_REFRESH_TOKEN_TTL, x as DEFAULT_TRANSACTION_TTL, m as GenericOAuthProviderConfig, G as GitHubProvider, n as GitHubSession, c as GoogleProvider, o as GoogleSession, I as OAuthError, d as OAuthProvider, J as OAuthProviderConfig, a as OAuthProxy, K as OAuthProxyConfig, t as OAuthProxyError, O as OAuthSession, L as ProxyDCRClient, R as RefreshRequest, y as TOKEN_ENDPOINT_AUTH_METHODS, M as TokenEndpointAuthMethod, N as TokenMapping, Q as TokenRequest, S as TokenResponse, U as UpstreamTokenSet, g as getAuthSession, r as requireAll, e as requireAny, f as requireAuth, h as requireRole, i as requireScopes } from '../OAuthProvider-BGtNEdC3.js';
 import 'node:http';
 
 /**

package/dist/auth/index.js

@@ -25,7 +25,7 @@ import {
   requireAuth,
   requireRole,
   requireScopes
-} from "../chunk-CAQLTSJ5.js";
+} from "../chunk-JFHOYU3S.js";
 export {
   AuthProvider,
   AzureProvider,

package/dist/bin/fastmcp.cjs

@@ -43,6 +43,7 @@ var buildDevCommand = (options) => {
   return [
     "npx",
     "@wong2/mcp-cli",
+    "--",
     "npx",
     "tsx",
     ...watch ? ["--watch"] : [],

package/dist/bin/fastmcp.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/fastmcp/fastmcp/dist/bin/fastmcp.cjs","../../src/bin/fastmcp.ts","../../src/bin/devCommand.ts","../../src/bin/validateCommand.ts"],"names":["yargs"],"mappings":"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","file":"/home/runner/work/fastmcp/fastmcp/dist/bin/fastmcp.cjs","sourcesContent":[null,"#!/usr/bin/env node\n\nimport { execa } from \"execa\";\nimport { mkdtemp, rm, writeFile } from \"fs/promises\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\n\nimport { buildDevCommand, buildDevConfig } from \"./devCommand.js\";\nimport {\n  buildStructureCheckCommand,\n  buildTypeCheckCommand,\n  formatCommandFailure,\n  resolveTsxLoader,\n  TSX_HINT,\n  withTypeCheckProject,\n} from \"./validateCommand.js\";\n\nawait yargs(hideBin(process.argv))\n  .scriptName(\"fastmcp\")\n  .command(\n    \"dev <file>\",\n    \"Start a development server\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"args\", {\n          describe:\n            \"JSON arguments passed to the tool (requires --tool), e.g. '{\\\"a\\\":1}'\",\n          type: \"string\",\n        })\n\n        .option(\"tool\", {\n          alias: \"t\",\n          describe:\n            \"Call a tool non-interactively instead of launching the inspector\",\n          type: \"string\",\n        })\n\n        .option(\"watch\", {\n          alias: \"w\",\n          default: false,\n          describe: \"Watch for file changes and restart server\",\n          type: \"boolean\",\n        })\n\n        .option(\"verbose\", {\n          alias: \"v\",\n          default: false,\n          describe: \"Enable verbose logging\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      let configDir: string | undefined;\n\n      try {\n        if (argv.args !== undefined && !argv.tool) {\n          console.error(\"[FastMCP Error] --args requires --tool\");\n          process.exitCode = 1;\n          return;\n        }\n\n        if (argv.tool && argv.watch) {\n          console.warn(\n            \"[FastMCP] --watch is ignored when calling a tool with --tool: the server runs for a single call.\",\n          );\n        }\n\n        let configPath: string | undefined;\n\n        if (argv.tool) {\n          configDir = await mkdtemp(join(tmpdir(), \"fastmcp-dev-\"));\n          configPath = join(configDir, \"mcp-cli.json\");\n          await writeFile(configPath, buildDevConfig(argv.file), \"utf8\");\n        }\n\n        const [command, ...commandArgs] = buildDevCommand({\n          configPath,\n          file: argv.file,\n          tool: argv.tool,\n          toolArgs: argv.args,\n          watch: argv.watch,\n        });\n\n        if (argv.verbose) {\n          console.log(\n            `[FastMCP] Starting server: ${[command, ...commandArgs].join(\" \")}`,\n          );\n          console.log(`[FastMCP] File: ${argv.file}`);\n          console.log(\n            `[FastMCP] Watch mode: ${argv.watch ? \"enabled\" : \"disabled\"}`,\n          );\n\n          if (argv.tool) {\n            console.log(`[FastMCP] Tool: ${argv.tool}`);\n          }\n        }\n\n        await execa(command, commandArgs, {\n          stderr: \"inherit\",\n          stdin: \"inherit\",\n          stdout: \"inherit\",\n        });\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to start development server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        if (argv.verbose && error instanceof Error && error.stack) {\n          console.error(\"[FastMCP Debug] Stack trace:\", error.stack);\n        }\n\n        // Not process.exit(): that would skip the `finally` block below and\n        // leak the temporary config directory on every failed tool call.\n        process.exitCode = 1;\n      } finally {\n        if (configDir) {\n          await rm(configDir, { force: true, recursive: true });\n        }\n      }\n    },\n  )\n\n  .command(\n    \"inspect <file>\",\n    \"Inspect a server file\",\n    (yargs) => {\n      return yargs.positional(\"file\", {\n        demandOption: true,\n        describe: \"The path to the server file\",\n        type: \"string\",\n      });\n    },\n\n    async (argv) => {\n      try {\n        await execa({\n          stderr: \"inherit\",\n          stdout: \"inherit\",\n        })`npx @modelcontextprotocol/inspector npx tsx ${argv.file}`;\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to inspect server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .command(\n    \"validate <file>\",\n    \"Validate a FastMCP server file for syntax and basic structure\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"strict\", {\n          alias: \"s\",\n          default: false,\n          describe: \"Enable strict validation (type checking)\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      try {\n        const { existsSync } = await import(\"fs\");\n        const { resolve } = await import(\"path\");\n        const filePath = resolve(argv.file);\n\n        if (!existsSync(filePath)) {\n          console.error(`[FastMCP Error] File not found: ${filePath}`);\n          process.exit(1);\n        }\n\n        console.log(`[FastMCP] Validating server file: ${filePath}`);\n\n        try {\n          await withTypeCheckProject(filePath, (project) => {\n            const [typeCheckCommand, ...typeCheckArgs] = buildTypeCheckCommand(\n              filePath,\n              { project, strict: argv.strict },\n            );\n\n            return execa(typeCheckCommand, typeCheckArgs, {\n              stderr: \"pipe\",\n              stdout: \"pipe\",\n            });\n          });\n\n          console.log(\"[FastMCP] ✓ TypeScript compilation successful\");\n        } catch (tsError) {\n          console.error(\"[FastMCP] ✗ TypeScript compilation failed\");\n\n          const diagnostics = formatCommandFailure(tsError);\n\n          if (diagnostics) {\n            console.error(diagnostics);\n          }\n\n          process.exit(1);\n        }\n\n        const tsxLoader = resolveTsxLoader(filePath);\n        const [structureCommand, ...structureArgs] = buildStructureCheckCommand(\n          filePath,\n          { tsxLoader },\n        );\n\n        try {\n          await execa(structureCommand, structureArgs, {\n            stderr: \"pipe\",\n            stdout: \"pipe\",\n          });\n        } catch (structureError) {\n          // The child reports the reason on stderr, which execa captures. Without\n          // replaying it the user only ever sees the generic hint below, even when\n          // the server file has an error they could act on.\n          const reason = formatCommandFailure(structureError);\n\n          if (reason) {\n            console.error(reason);\n          } else {\n            console.error(\"[FastMCP] ✗ Server structure validation failed\");\n            console.error(\n              \"Make sure the file properly imports and uses FastMCP\",\n            );\n          }\n\n          if (!tsxLoader) {\n            console.error(TSX_HINT);\n          }\n\n          process.exit(1);\n        }\n\n        console.log(\n          \"[FastMCP] ✓ All validations passed! Server file looks good.\",\n        );\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Validation failed:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .demandCommand(1)\n  .strict()\n  .help()\n  .parseAsync();\n","export type DevCommandOptions = {\n  /**\n   * Path to a temporary mcp-cli config file that registers the dev server.\n   * Only used in non-interactive mode (when `tool` is set).\n   */\n  configPath?: string;\n  /**\n   * Path to the server file to run.\n   */\n  file: string;\n  /**\n   * Name of the tool to call non-interactively. When omitted, the dev\n   * command launches the interactive mcp-cli inspector instead.\n   */\n  tool?: string;\n  /**\n   * JSON string of arguments forwarded to the tool via mcp-cli `--args`.\n   * Only used in non-interactive mode.\n   */\n  toolArgs?: string;\n  /**\n   * Watch the file for changes and restart the server. Only used in\n   * interactive mode; a non-interactive call runs the server once.\n   */\n  watch?: boolean;\n};\n\n/**\n * The server name registered in the generated mcp-cli config. mcp-cli\n * addresses non-interactive targets as `<server-name>:<tool>`.\n */\nexport const DEV_SERVER_NAME = \"dev\";\n\n/**\n * Build the JSON config that registers the dev server with mcp-cli so it can\n * be invoked non-interactively. mcp-cli's non-interactive mode resolves the\n * server by name from a config file's `mcpServers` map, so an inline command\n * cannot be passed directly alongside `call-tool`.\n *\n * The server is never started in watch mode here: a non-interactive call\n * connects, calls one tool, and exits, so there is nothing to restart into.\n */\nexport const buildDevConfig = (file: string): string =>\n  JSON.stringify(\n    {\n      mcpServers: {\n        [DEV_SERVER_NAME]: {\n          args: [\"tsx\", file],\n          command: \"npx\",\n        },\n      },\n    },\n    null,\n    2,\n  );\n\n/**\n * Build the argv that the dev command runs.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: file paths, tool names and JSON `--args` are passed to the child\n * process verbatim. Quoting through a shell would be wrong on Windows, where\n * cmd.exe treats single quotes as literal characters rather than as quoting.\n *\n * - Without `tool`: launches the interactive @wong2/mcp-cli inspector\n *   against an inline `npx tsx <file>` server (existing behaviour).\n * - With `tool`: runs @wong2/mcp-cli in non-interactive mode against a\n *   generated config file, calling the named tool and forwarding `--args`.\n */\nexport const buildDevCommand = (\n  options: DevCommandOptions,\n): [string, ...string[]] => {\n  const { configPath, file, tool, toolArgs, watch = false } = options;\n\n  if (tool) {\n    if (!configPath) {\n      throw new Error(\n        \"configPath is required when calling a tool non-interactively\",\n      );\n    }\n\n    return [\n      \"npx\",\n      \"@wong2/mcp-cli\",\n      \"-c\",\n      configPath,\n      \"call-tool\",\n      `${DEV_SERVER_NAME}:${tool}`,\n      ...(toolArgs === undefined ? [] : [\"--args\", toolArgs]),\n    ];\n  }\n\n  return [\n    \"npx\",\n    \"@wong2/mcp-cli\",\n    \"npx\",\n    \"tsx\",\n    ...(watch ? [\"--watch\"] : []),\n    file,\n  ];\n};\n","import { existsSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { basename, dirname, join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\n/**\n * Compiler options for type-checking a server file with no `tsconfig.json`\n * above it. tsc's own defaults (ES5, CommonJS-era module resolution) cannot\n * even read FastMCP's declarations, which use private class fields and a\n * default import of `http`, so no real server file could pass under them.\n * These describe how a server actually runs instead: as an ES module on a\n * current Node, which can import `.ts` files directly.\n */\nexport const DEFAULT_TYPE_CHECK_OPTIONS = [\n  \"--allowImportingTsExtensions\",\n  \"--module\",\n  \"esnext\",\n  \"--moduleResolution\",\n  \"bundler\",\n  \"--skipLibCheck\",\n  \"--target\",\n  \"es2022\",\n];\n\n/**\n * The script that `fastmcp validate` runs to check a server file can be\n * imported.\n *\n * The target file is read from `process.argv[1]` instead of being spliced into\n * this source. Splicing is not equivalent: the path would land inside a\n * JavaScript string literal, so the child's own parser would consume the\n * backslashes of a Windows path as string escapes. `C:\\Users\\dev\\server.ts`\n * reaches the import as `C:Usersdevserver.ts`, which throws `ERR_INVALID_URL`\n * and is reported to the user as \"does not import FastMCP\" even though the file\n * is fine.\n *\n * The script exits explicitly once the import settles. Importing a server file\n * normally starts the server, and a running server — a stdio transport waiting\n * on stdin, an HTTP listener — keeps the process alive indefinitely, so\n * validating a server that calls `start()` would otherwise never finish.\n */\nexport const STRUCTURE_CHECK_SCRIPT = `\n(async () => {\n  try {\n    const { FastMCP } = await import(\"fastmcp\");\n    await import(process.argv[1]);\n    console.log(\"[FastMCP] ✓ Server structure validation passed\");\n  } catch (error) {\n    console.error(\"[FastMCP] ✗ Server structure validation failed:\", error.message);\n    process.exitCode = 1;\n  }\n\n  process.exit();\n})();\n`;\n\n/**\n * Build the argv for the type-check step.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: the file path is passed to tsc verbatim, so a path containing spaces\n * stays one argument. Quoting through a shell would be wrong on Windows, where\n * cmd.exe re-parses the command line and splits such a path into several root\n * files.\n *\n * Given a `project` (see `withTypeCheckProject`), tsc checks the file through\n * it; without one, the file is passed directly with\n * `DEFAULT_TYPE_CHECK_OPTIONS`.\n */\nexport const buildTypeCheckCommand = (\n  file: string,\n  { project, strict = false }: { project?: string; strict?: boolean } = {},\n): [string, ...string[]] => [\n  \"npx\",\n  \"tsc\",\n  \"--noEmit\",\n  ...(strict ? [\"--strict\"] : []),\n  ...(project ? [\"--project\", project] : [...DEFAULT_TYPE_CHECK_OPTIONS, file]),\n];\n\n/**\n * Build a tsconfig that checks only `file`, with the compiler options of the\n * project's own `tsconfig`.\n *\n * `tsc <file>` ignores tsconfig.json altogether and falls back to tsc's\n * defaults, while `tsc --project tsconfig.json` checks every file in the\n * project rather than the one being validated. Extending the project's config\n * and listing just `file` gets both right. A project that is `incremental` or\n * `composite` still writes a `.tsbuildinfo` under `--noEmit`, so both are\n * switched off: validating a file should leave the project untouched. Disable\n * declaration output options too, since they may rely on composite's implicit\n * `declaration: true`; `declarationDir` takes a path, so `null` unsets it.\n */\nexport const buildTypeCheckProject = (tsconfig: string, file: string): string =>\n  JSON.stringify({\n    compilerOptions: {\n      composite: false,\n      declarationDir: null,\n      declarationMap: false,\n      emitDeclarationOnly: false,\n      incremental: false,\n    },\n    extends: `./${basename(tsconfig)}`,\n    files: [file],\n    include: [],\n  });\n\n/**\n * Find the `tsconfig.json` that applies to files in `dir`: the nearest one in\n * it or any of its parents, which is where tsc and editors look too.\n */\nexport const findTsconfig = (dir: string): string | undefined => {\n  const candidate = join(dir, \"tsconfig.json\");\n\n  if (existsSync(candidate)) {\n    return candidate;\n  }\n\n  const parent = dirname(dir);\n\n  return parent === dir ? undefined : findTsconfig(parent);\n};\n\n/**\n * Run `check` with a throwaway tsconfig for `file` (see\n * `buildTypeCheckProject`), or with no project when the file has no\n * `tsconfig.json` above it.\n *\n * The throwaway config is written next to the one it extends and removed once\n * `check` settles. It cannot live in a temporary directory: tsc looks for the\n * `@types` packages it includes by default relative to the config file, so\n * from anywhere else a server using, say, `process.env` would stop compiling.\n */\nexport const withTypeCheckProject = async <T>(\n  file: string,\n  check: (project?: string) => Promise<T>,\n): Promise<T> => {\n  const tsconfig = findTsconfig(dirname(file));\n\n  if (!tsconfig) {\n    return check();\n  }\n\n  const project = join(\n    dirname(tsconfig),\n    `tsconfig.fastmcp-validate-${process.pid}.json`,\n  );\n\n  await writeFile(project, buildTypeCheckProject(tsconfig, file), \"utf8\");\n\n  try {\n    return await check(project);\n  } finally {\n    await rm(project, { force: true });\n  }\n};\n\n/**\n * Find tsx in the project `file` belongs to, as the file: URL of its loader.\n *\n * `fastmcp dev` runs a server with tsx. Node alone only strips types: it\n * cannot follow the `.js` import of a `.ts` file that TypeScript itself asks\n * for, nor run syntax that has to be transformed, like `enum` — and since Node\n * 26 no flag makes it. So the structure check loads the file through the\n * project's tsx when there is one, the way `dev` runs it.\n *\n * Resolved here rather than by the child: `--import tsx` would resolve from\n * the child's working directory, and fail the whole check wherever tsx is not\n * installed. A URL, because `--import` reads a Windows path as a URL scheme.\n */\nexport const resolveTsxLoader = (file: string): string | undefined => {\n  try {\n    return pathToFileURL(createRequire(file).resolve(\"tsx\")).href;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Printed when the structure check fails and the project has no tsx, so the\n * file was loaded by Node alone (see `resolveTsxLoader`).\n */\nexport const TSX_HINT =\n  \"[FastMCP] Hint: if the file imports .ts files with .js extensions, or uses TypeScript syntax Node cannot strip (such as enum), add tsx to your project's devDependencies. validate then loads the file through tsx, as `fastmcp dev` does.\";\n\n/**\n * Build the argv for the structure-check step.\n *\n * As above, the file is passed as an argument rather than quoted into a shell\n * command. It is converted to a file URL by the parent process, so the child\n * receives the URL as-is and never has to reconstruct it. The child is the same\n * Node binary running the CLI, so no PATH lookup is involved.\n *\n * Given a `tsxLoader` (see `resolveTsxLoader`), the child loads it first.\n */\nexport const buildStructureCheckCommand = (\n  file: string,\n  {\n    execPath = process.execPath,\n    tsxLoader,\n  }: { execPath?: string; tsxLoader?: string } = {},\n): [string, ...string[]] => [\n  execPath,\n  ...(tsxLoader ? [\"--import\", tsxLoader] : []),\n  \"-e\",\n  STRUCTURE_CHECK_SCRIPT,\n  pathToFileURL(file).href,\n];\n\n/**\n * The output streams a failed command carries. execa sets both on the error it\n * throws, but they are optional here so the extraction stays honest about not\n * every `Error` having them.\n */\ntype CommandOutputStreams = {\n  stderr?: unknown;\n  stdout?: unknown;\n};\n\nconst hasOutputStreams = (\n  error: Error,\n): error is CommandOutputStreams & Error =>\n  \"stdout\" in error || \"stderr\" in error;\n\n/**\n * Extract the output of a failed command.\n *\n * tsc writes its diagnostics to stdout, while a failure to launch the compiler\n * at all (a missing `npx`, for instance) reports on stderr — reading only\n * stderr left the message empty for every real type error. The structure check\n * reports the reason on stderr, which execa captures, so it has to be replayed\n * here as well or the caller can only print a generic hint.\n *\n * An error that did not come from a command at all — the throwaway tsconfig\n * could not be written, say — is reported by its message.\n */\nexport const formatCommandFailure = (error: unknown): string => {\n  if (!(error instanceof Error)) {\n    return \"\";\n  }\n\n  if (!hasOutputStreams(error)) {\n    return error.message;\n  }\n\n  const collect = (value: unknown): string =>\n    typeof value === \"string\" ? value.trim() : \"\";\n\n  return [collect(error.stderr), collect(error.stdout)]\n    .filter(Boolean)\n    .join(\"\\n\");\n};\n"]}
+{"version":3,"sources":["/home/runner/work/fastmcp/fastmcp/dist/bin/fastmcp.cjs","../../src/bin/fastmcp.ts","../../src/bin/devCommand.ts","../../src/bin/validateCommand.ts"],"names":["yargs"],"mappings":"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","file":"/home/runner/work/fastmcp/fastmcp/dist/bin/fastmcp.cjs","sourcesContent":[null,"#!/usr/bin/env node\n\nimport { execa } from \"execa\";\nimport { mkdtemp, rm, writeFile } from \"fs/promises\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\n\nimport { buildDevCommand, buildDevConfig } from \"./devCommand.js\";\nimport {\n  buildStructureCheckCommand,\n  buildTypeCheckCommand,\n  formatCommandFailure,\n  resolveTsxLoader,\n  TSX_HINT,\n  withTypeCheckProject,\n} from \"./validateCommand.js\";\n\nawait yargs(hideBin(process.argv))\n  .scriptName(\"fastmcp\")\n  .command(\n    \"dev <file>\",\n    \"Start a development server\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"args\", {\n          describe:\n            \"JSON arguments passed to the tool (requires --tool), e.g. '{\\\"a\\\":1}'\",\n          type: \"string\",\n        })\n\n        .option(\"tool\", {\n          alias: \"t\",\n          describe:\n            \"Call a tool non-interactively instead of launching the inspector\",\n          type: \"string\",\n        })\n\n        .option(\"watch\", {\n          alias: \"w\",\n          default: false,\n          describe: \"Watch for file changes and restart server\",\n          type: \"boolean\",\n        })\n\n        .option(\"verbose\", {\n          alias: \"v\",\n          default: false,\n          describe: \"Enable verbose logging\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      let configDir: string | undefined;\n\n      try {\n        if (argv.args !== undefined && !argv.tool) {\n          console.error(\"[FastMCP Error] --args requires --tool\");\n          process.exitCode = 1;\n          return;\n        }\n\n        if (argv.tool && argv.watch) {\n          console.warn(\n            \"[FastMCP] --watch is ignored when calling a tool with --tool: the server runs for a single call.\",\n          );\n        }\n\n        let configPath: string | undefined;\n\n        if (argv.tool) {\n          configDir = await mkdtemp(join(tmpdir(), \"fastmcp-dev-\"));\n          configPath = join(configDir, \"mcp-cli.json\");\n          await writeFile(configPath, buildDevConfig(argv.file), \"utf8\");\n        }\n\n        const [command, ...commandArgs] = buildDevCommand({\n          configPath,\n          file: argv.file,\n          tool: argv.tool,\n          toolArgs: argv.args,\n          watch: argv.watch,\n        });\n\n        if (argv.verbose) {\n          console.log(\n            `[FastMCP] Starting server: ${[command, ...commandArgs].join(\" \")}`,\n          );\n          console.log(`[FastMCP] File: ${argv.file}`);\n          console.log(\n            `[FastMCP] Watch mode: ${argv.watch ? \"enabled\" : \"disabled\"}`,\n          );\n\n          if (argv.tool) {\n            console.log(`[FastMCP] Tool: ${argv.tool}`);\n          }\n        }\n\n        await execa(command, commandArgs, {\n          stderr: \"inherit\",\n          stdin: \"inherit\",\n          stdout: \"inherit\",\n        });\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to start development server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        if (argv.verbose && error instanceof Error && error.stack) {\n          console.error(\"[FastMCP Debug] Stack trace:\", error.stack);\n        }\n\n        // Not process.exit(): that would skip the `finally` block below and\n        // leak the temporary config directory on every failed tool call.\n        process.exitCode = 1;\n      } finally {\n        if (configDir) {\n          await rm(configDir, { force: true, recursive: true });\n        }\n      }\n    },\n  )\n\n  .command(\n    \"inspect <file>\",\n    \"Inspect a server file\",\n    (yargs) => {\n      return yargs.positional(\"file\", {\n        demandOption: true,\n        describe: \"The path to the server file\",\n        type: \"string\",\n      });\n    },\n\n    async (argv) => {\n      try {\n        await execa({\n          stderr: \"inherit\",\n          stdout: \"inherit\",\n        })`npx @modelcontextprotocol/inspector npx tsx ${argv.file}`;\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to inspect server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .command(\n    \"validate <file>\",\n    \"Validate a FastMCP server file for syntax and basic structure\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"strict\", {\n          alias: \"s\",\n          default: false,\n          describe: \"Enable strict validation (type checking)\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      try {\n        const { existsSync } = await import(\"fs\");\n        const { resolve } = await import(\"path\");\n        const filePath = resolve(argv.file);\n\n        if (!existsSync(filePath)) {\n          console.error(`[FastMCP Error] File not found: ${filePath}`);\n          process.exit(1);\n        }\n\n        console.log(`[FastMCP] Validating server file: ${filePath}`);\n\n        try {\n          await withTypeCheckProject(filePath, (project) => {\n            const [typeCheckCommand, ...typeCheckArgs] = buildTypeCheckCommand(\n              filePath,\n              { project, strict: argv.strict },\n            );\n\n            return execa(typeCheckCommand, typeCheckArgs, {\n              stderr: \"pipe\",\n              stdout: \"pipe\",\n            });\n          });\n\n          console.log(\"[FastMCP] ✓ TypeScript compilation successful\");\n        } catch (tsError) {\n          console.error(\"[FastMCP] ✗ TypeScript compilation failed\");\n\n          const diagnostics = formatCommandFailure(tsError);\n\n          if (diagnostics) {\n            console.error(diagnostics);\n          }\n\n          process.exit(1);\n        }\n\n        const tsxLoader = resolveTsxLoader(filePath);\n        const [structureCommand, ...structureArgs] = buildStructureCheckCommand(\n          filePath,\n          { tsxLoader },\n        );\n\n        try {\n          await execa(structureCommand, structureArgs, {\n            stderr: \"pipe\",\n            stdout: \"pipe\",\n          });\n        } catch (structureError) {\n          // The child reports the reason on stderr, which execa captures. Without\n          // replaying it the user only ever sees the generic hint below, even when\n          // the server file has an error they could act on.\n          const reason = formatCommandFailure(structureError);\n\n          if (reason) {\n            console.error(reason);\n          } else {\n            console.error(\"[FastMCP] ✗ Server structure validation failed\");\n            console.error(\n              \"Make sure the file properly imports and uses FastMCP\",\n            );\n          }\n\n          if (!tsxLoader) {\n            console.error(TSX_HINT);\n          }\n\n          process.exit(1);\n        }\n\n        console.log(\n          \"[FastMCP] ✓ All validations passed! Server file looks good.\",\n        );\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Validation failed:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .demandCommand(1)\n  .strict()\n  .help()\n  .parseAsync();\n","export type DevCommandOptions = {\n  /**\n   * Path to a temporary mcp-cli config file that registers the dev server.\n   * Only used in non-interactive mode (when `tool` is set).\n   */\n  configPath?: string;\n  /**\n   * Path to the server file to run.\n   */\n  file: string;\n  /**\n   * Name of the tool to call non-interactively. When omitted, the dev\n   * command launches the interactive mcp-cli inspector instead.\n   */\n  tool?: string;\n  /**\n   * JSON string of arguments forwarded to the tool via mcp-cli `--args`.\n   * Only used in non-interactive mode.\n   */\n  toolArgs?: string;\n  /**\n   * Watch the file for changes and restart the server. Only used in\n   * interactive mode; a non-interactive call runs the server once.\n   */\n  watch?: boolean;\n};\n\n/**\n * The server name registered in the generated mcp-cli config. mcp-cli\n * addresses non-interactive targets as `<server-name>:<tool>`.\n */\nexport const DEV_SERVER_NAME = \"dev\";\n\n/**\n * Build the JSON config that registers the dev server with mcp-cli so it can\n * be invoked non-interactively. mcp-cli's non-interactive mode resolves the\n * server by name from a config file's `mcpServers` map, so an inline command\n * cannot be passed directly alongside `call-tool`.\n *\n * The server is never started in watch mode here: a non-interactive call\n * connects, calls one tool, and exits, so there is nothing to restart into.\n */\nexport const buildDevConfig = (file: string): string =>\n  JSON.stringify(\n    {\n      mcpServers: {\n        [DEV_SERVER_NAME]: {\n          args: [\"tsx\", file],\n          command: \"npx\",\n        },\n      },\n    },\n    null,\n    2,\n  );\n\n/**\n * Build the argv that the dev command runs.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: file paths, tool names and JSON `--args` are passed to the child\n * process verbatim. Quoting through a shell would be wrong on Windows, where\n * cmd.exe treats single quotes as literal characters rather than as quoting.\n *\n * - Without `tool`: launches the interactive @wong2/mcp-cli inspector\n *   against an inline `npx tsx <file>` server (existing behaviour).\n * - With `tool`: runs @wong2/mcp-cli in non-interactive mode against a\n *   generated config file, calling the named tool and forwarding `--args`.\n */\nexport const buildDevCommand = (\n  options: DevCommandOptions,\n): [string, ...string[]] => {\n  const { configPath, file, tool, toolArgs, watch = false } = options;\n\n  if (tool) {\n    if (!configPath) {\n      throw new Error(\n        \"configPath is required when calling a tool non-interactively\",\n      );\n    }\n\n    return [\n      \"npx\",\n      \"@wong2/mcp-cli\",\n      \"-c\",\n      configPath,\n      \"call-tool\",\n      `${DEV_SERVER_NAME}:${tool}`,\n      ...(toolArgs === undefined ? [] : [\"--args\", toolArgs]),\n    ];\n  }\n\n  return [\n    \"npx\",\n    \"@wong2/mcp-cli\",\n    \"--\",\n    \"npx\",\n    \"tsx\",\n    ...(watch ? [\"--watch\"] : []),\n    file,\n  ];\n};\n","import { existsSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { basename, dirname, join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\n/**\n * Compiler options for type-checking a server file with no `tsconfig.json`\n * above it. tsc's own defaults (ES5, CommonJS-era module resolution) cannot\n * even read FastMCP's declarations, which use private class fields and a\n * default import of `http`, so no real server file could pass under them.\n * These describe how a server actually runs instead: as an ES module on a\n * current Node, which can import `.ts` files directly.\n */\nexport const DEFAULT_TYPE_CHECK_OPTIONS = [\n  \"--allowImportingTsExtensions\",\n  \"--module\",\n  \"esnext\",\n  \"--moduleResolution\",\n  \"bundler\",\n  \"--skipLibCheck\",\n  \"--target\",\n  \"es2022\",\n];\n\n/**\n * The script that `fastmcp validate` runs to check a server file can be\n * imported.\n *\n * The target file is read from `process.argv[1]` instead of being spliced into\n * this source. Splicing is not equivalent: the path would land inside a\n * JavaScript string literal, so the child's own parser would consume the\n * backslashes of a Windows path as string escapes. `C:\\Users\\dev\\server.ts`\n * reaches the import as `C:Usersdevserver.ts`, which throws `ERR_INVALID_URL`\n * and is reported to the user as \"does not import FastMCP\" even though the file\n * is fine.\n *\n * The script exits explicitly once the import settles. Importing a server file\n * normally starts the server, and a running server — a stdio transport waiting\n * on stdin, an HTTP listener — keeps the process alive indefinitely, so\n * validating a server that calls `start()` would otherwise never finish.\n */\nexport const STRUCTURE_CHECK_SCRIPT = `\n(async () => {\n  try {\n    const { FastMCP } = await import(\"fastmcp\");\n    await import(process.argv[1]);\n    console.log(\"[FastMCP] ✓ Server structure validation passed\");\n  } catch (error) {\n    console.error(\"[FastMCP] ✗ Server structure validation failed:\", error.message);\n    process.exitCode = 1;\n  }\n\n  process.exit();\n})();\n`;\n\n/**\n * Build the argv for the type-check step.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: the file path is passed to tsc verbatim, so a path containing spaces\n * stays one argument. Quoting through a shell would be wrong on Windows, where\n * cmd.exe re-parses the command line and splits such a path into several root\n * files.\n *\n * Given a `project` (see `withTypeCheckProject`), tsc checks the file through\n * it; without one, the file is passed directly with\n * `DEFAULT_TYPE_CHECK_OPTIONS`.\n */\nexport const buildTypeCheckCommand = (\n  file: string,\n  { project, strict = false }: { project?: string; strict?: boolean } = {},\n): [string, ...string[]] => [\n  \"npx\",\n  \"tsc\",\n  \"--noEmit\",\n  ...(strict ? [\"--strict\"] : []),\n  ...(project ? [\"--project\", project] : [...DEFAULT_TYPE_CHECK_OPTIONS, file]),\n];\n\n/**\n * Build a tsconfig that checks only `file`, with the compiler options of the\n * project's own `tsconfig`.\n *\n * `tsc <file>` ignores tsconfig.json altogether and falls back to tsc's\n * defaults, while `tsc --project tsconfig.json` checks every file in the\n * project rather than the one being validated. Extending the project's config\n * and listing just `file` gets both right. A project that is `incremental` or\n * `composite` still writes a `.tsbuildinfo` under `--noEmit`, so both are\n * switched off: validating a file should leave the project untouched. Disable\n * declaration output options too, since they may rely on composite's implicit\n * `declaration: true`; `declarationDir` takes a path, so `null` unsets it.\n */\nexport const buildTypeCheckProject = (tsconfig: string, file: string): string =>\n  JSON.stringify({\n    compilerOptions: {\n      composite: false,\n      declarationDir: null,\n      declarationMap: false,\n      emitDeclarationOnly: false,\n      incremental: false,\n    },\n    extends: `./${basename(tsconfig)}`,\n    files: [file],\n    include: [],\n  });\n\n/**\n * Find the `tsconfig.json` that applies to files in `dir`: the nearest one in\n * it or any of its parents, which is where tsc and editors look too.\n */\nexport const findTsconfig = (dir: string): string | undefined => {\n  const candidate = join(dir, \"tsconfig.json\");\n\n  if (existsSync(candidate)) {\n    return candidate;\n  }\n\n  const parent = dirname(dir);\n\n  return parent === dir ? undefined : findTsconfig(parent);\n};\n\n/**\n * Run `check` with a throwaway tsconfig for `file` (see\n * `buildTypeCheckProject`), or with no project when the file has no\n * `tsconfig.json` above it.\n *\n * The throwaway config is written next to the one it extends and removed once\n * `check` settles. It cannot live in a temporary directory: tsc looks for the\n * `@types` packages it includes by default relative to the config file, so\n * from anywhere else a server using, say, `process.env` would stop compiling.\n */\nexport const withTypeCheckProject = async <T>(\n  file: string,\n  check: (project?: string) => Promise<T>,\n): Promise<T> => {\n  const tsconfig = findTsconfig(dirname(file));\n\n  if (!tsconfig) {\n    return check();\n  }\n\n  const project = join(\n    dirname(tsconfig),\n    `tsconfig.fastmcp-validate-${process.pid}.json`,\n  );\n\n  await writeFile(project, buildTypeCheckProject(tsconfig, file), \"utf8\");\n\n  try {\n    return await check(project);\n  } finally {\n    await rm(project, { force: true });\n  }\n};\n\n/**\n * Find tsx in the project `file` belongs to, as the file: URL of its loader.\n *\n * `fastmcp dev` runs a server with tsx. Node alone only strips types: it\n * cannot follow the `.js` import of a `.ts` file that TypeScript itself asks\n * for, nor run syntax that has to be transformed, like `enum` — and since Node\n * 26 no flag makes it. So the structure check loads the file through the\n * project's tsx when there is one, the way `dev` runs it.\n *\n * Resolved here rather than by the child: `--import tsx` would resolve from\n * the child's working directory, and fail the whole check wherever tsx is not\n * installed. A URL, because `--import` reads a Windows path as a URL scheme.\n */\nexport const resolveTsxLoader = (file: string): string | undefined => {\n  try {\n    return pathToFileURL(createRequire(file).resolve(\"tsx\")).href;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Printed when the structure check fails and the project has no tsx, so the\n * file was loaded by Node alone (see `resolveTsxLoader`).\n */\nexport const TSX_HINT =\n  \"[FastMCP] Hint: if the file imports .ts files with .js extensions, or uses TypeScript syntax Node cannot strip (such as enum), add tsx to your project's devDependencies. validate then loads the file through tsx, as `fastmcp dev` does.\";\n\n/**\n * Build the argv for the structure-check step.\n *\n * As above, the file is passed as an argument rather than quoted into a shell\n * command. It is converted to a file URL by the parent process, so the child\n * receives the URL as-is and never has to reconstruct it. The child is the same\n * Node binary running the CLI, so no PATH lookup is involved.\n *\n * Given a `tsxLoader` (see `resolveTsxLoader`), the child loads it first.\n */\nexport const buildStructureCheckCommand = (\n  file: string,\n  {\n    execPath = process.execPath,\n    tsxLoader,\n  }: { execPath?: string; tsxLoader?: string } = {},\n): [string, ...string[]] => [\n  execPath,\n  ...(tsxLoader ? [\"--import\", tsxLoader] : []),\n  \"-e\",\n  STRUCTURE_CHECK_SCRIPT,\n  pathToFileURL(file).href,\n];\n\n/**\n * The output streams a failed command carries. execa sets both on the error it\n * throws, but they are optional here so the extraction stays honest about not\n * every `Error` having them.\n */\ntype CommandOutputStreams = {\n  stderr?: unknown;\n  stdout?: unknown;\n};\n\nconst hasOutputStreams = (\n  error: Error,\n): error is CommandOutputStreams & Error =>\n  \"stdout\" in error || \"stderr\" in error;\n\n/**\n * Extract the output of a failed command.\n *\n * tsc writes its diagnostics to stdout, while a failure to launch the compiler\n * at all (a missing `npx`, for instance) reports on stderr — reading only\n * stderr left the message empty for every real type error. The structure check\n * reports the reason on stderr, which execa captures, so it has to be replayed\n * here as well or the caller can only print a generic hint.\n *\n * An error that did not come from a command at all — the throwaway tsconfig\n * could not be written, say — is reported by its message.\n */\nexport const formatCommandFailure = (error: unknown): string => {\n  if (!(error instanceof Error)) {\n    return \"\";\n  }\n\n  if (!hasOutputStreams(error)) {\n    return error.message;\n  }\n\n  const collect = (value: unknown): string =>\n    typeof value === \"string\" ? value.trim() : \"\";\n\n  return [collect(error.stderr), collect(error.stdout)]\n    .filter(Boolean)\n    .join(\"\\n\");\n};\n"]}

package/dist/bin/fastmcp.js

@@ -43,6 +43,7 @@ var buildDevCommand = (options) => {
   return [
     "npx",
     "@wong2/mcp-cli",
+    "--",
     "npx",
     "tsx",
     ...watch ? ["--watch"] : [],

package/dist/bin/fastmcp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/bin/fastmcp.ts","../../src/bin/devCommand.ts","../../src/bin/validateCommand.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { execa } from \"execa\";\nimport { mkdtemp, rm, writeFile } from \"fs/promises\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\n\nimport { buildDevCommand, buildDevConfig } from \"./devCommand.js\";\nimport {\n  buildStructureCheckCommand,\n  buildTypeCheckCommand,\n  formatCommandFailure,\n  resolveTsxLoader,\n  TSX_HINT,\n  withTypeCheckProject,\n} from \"./validateCommand.js\";\n\nawait yargs(hideBin(process.argv))\n  .scriptName(\"fastmcp\")\n  .command(\n    \"dev <file>\",\n    \"Start a development server\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"args\", {\n          describe:\n            \"JSON arguments passed to the tool (requires --tool), e.g. '{\\\"a\\\":1}'\",\n          type: \"string\",\n        })\n\n        .option(\"tool\", {\n          alias: \"t\",\n          describe:\n            \"Call a tool non-interactively instead of launching the inspector\",\n          type: \"string\",\n        })\n\n        .option(\"watch\", {\n          alias: \"w\",\n          default: false,\n          describe: \"Watch for file changes and restart server\",\n          type: \"boolean\",\n        })\n\n        .option(\"verbose\", {\n          alias: \"v\",\n          default: false,\n          describe: \"Enable verbose logging\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      let configDir: string | undefined;\n\n      try {\n        if (argv.args !== undefined && !argv.tool) {\n          console.error(\"[FastMCP Error] --args requires --tool\");\n          process.exitCode = 1;\n          return;\n        }\n\n        if (argv.tool && argv.watch) {\n          console.warn(\n            \"[FastMCP] --watch is ignored when calling a tool with --tool: the server runs for a single call.\",\n          );\n        }\n\n        let configPath: string | undefined;\n\n        if (argv.tool) {\n          configDir = await mkdtemp(join(tmpdir(), \"fastmcp-dev-\"));\n          configPath = join(configDir, \"mcp-cli.json\");\n          await writeFile(configPath, buildDevConfig(argv.file), \"utf8\");\n        }\n\n        const [command, ...commandArgs] = buildDevCommand({\n          configPath,\n          file: argv.file,\n          tool: argv.tool,\n          toolArgs: argv.args,\n          watch: argv.watch,\n        });\n\n        if (argv.verbose) {\n          console.log(\n            `[FastMCP] Starting server: ${[command, ...commandArgs].join(\" \")}`,\n          );\n          console.log(`[FastMCP] File: ${argv.file}`);\n          console.log(\n            `[FastMCP] Watch mode: ${argv.watch ? \"enabled\" : \"disabled\"}`,\n          );\n\n          if (argv.tool) {\n            console.log(`[FastMCP] Tool: ${argv.tool}`);\n          }\n        }\n\n        await execa(command, commandArgs, {\n          stderr: \"inherit\",\n          stdin: \"inherit\",\n          stdout: \"inherit\",\n        });\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to start development server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        if (argv.verbose && error instanceof Error && error.stack) {\n          console.error(\"[FastMCP Debug] Stack trace:\", error.stack);\n        }\n\n        // Not process.exit(): that would skip the `finally` block below and\n        // leak the temporary config directory on every failed tool call.\n        process.exitCode = 1;\n      } finally {\n        if (configDir) {\n          await rm(configDir, { force: true, recursive: true });\n        }\n      }\n    },\n  )\n\n  .command(\n    \"inspect <file>\",\n    \"Inspect a server file\",\n    (yargs) => {\n      return yargs.positional(\"file\", {\n        demandOption: true,\n        describe: \"The path to the server file\",\n        type: \"string\",\n      });\n    },\n\n    async (argv) => {\n      try {\n        await execa({\n          stderr: \"inherit\",\n          stdout: \"inherit\",\n        })`npx @modelcontextprotocol/inspector npx tsx ${argv.file}`;\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to inspect server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .command(\n    \"validate <file>\",\n    \"Validate a FastMCP server file for syntax and basic structure\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"strict\", {\n          alias: \"s\",\n          default: false,\n          describe: \"Enable strict validation (type checking)\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      try {\n        const { existsSync } = await import(\"fs\");\n        const { resolve } = await import(\"path\");\n        const filePath = resolve(argv.file);\n\n        if (!existsSync(filePath)) {\n          console.error(`[FastMCP Error] File not found: ${filePath}`);\n          process.exit(1);\n        }\n\n        console.log(`[FastMCP] Validating server file: ${filePath}`);\n\n        try {\n          await withTypeCheckProject(filePath, (project) => {\n            const [typeCheckCommand, ...typeCheckArgs] = buildTypeCheckCommand(\n              filePath,\n              { project, strict: argv.strict },\n            );\n\n            return execa(typeCheckCommand, typeCheckArgs, {\n              stderr: \"pipe\",\n              stdout: \"pipe\",\n            });\n          });\n\n          console.log(\"[FastMCP] ✓ TypeScript compilation successful\");\n        } catch (tsError) {\n          console.error(\"[FastMCP] ✗ TypeScript compilation failed\");\n\n          const diagnostics = formatCommandFailure(tsError);\n\n          if (diagnostics) {\n            console.error(diagnostics);\n          }\n\n          process.exit(1);\n        }\n\n        const tsxLoader = resolveTsxLoader(filePath);\n        const [structureCommand, ...structureArgs] = buildStructureCheckCommand(\n          filePath,\n          { tsxLoader },\n        );\n\n        try {\n          await execa(structureCommand, structureArgs, {\n            stderr: \"pipe\",\n            stdout: \"pipe\",\n          });\n        } catch (structureError) {\n          // The child reports the reason on stderr, which execa captures. Without\n          // replaying it the user only ever sees the generic hint below, even when\n          // the server file has an error they could act on.\n          const reason = formatCommandFailure(structureError);\n\n          if (reason) {\n            console.error(reason);\n          } else {\n            console.error(\"[FastMCP] ✗ Server structure validation failed\");\n            console.error(\n              \"Make sure the file properly imports and uses FastMCP\",\n            );\n          }\n\n          if (!tsxLoader) {\n            console.error(TSX_HINT);\n          }\n\n          process.exit(1);\n        }\n\n        console.log(\n          \"[FastMCP] ✓ All validations passed! Server file looks good.\",\n        );\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Validation failed:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .demandCommand(1)\n  .strict()\n  .help()\n  .parseAsync();\n","export type DevCommandOptions = {\n  /**\n   * Path to a temporary mcp-cli config file that registers the dev server.\n   * Only used in non-interactive mode (when `tool` is set).\n   */\n  configPath?: string;\n  /**\n   * Path to the server file to run.\n   */\n  file: string;\n  /**\n   * Name of the tool to call non-interactively. When omitted, the dev\n   * command launches the interactive mcp-cli inspector instead.\n   */\n  tool?: string;\n  /**\n   * JSON string of arguments forwarded to the tool via mcp-cli `--args`.\n   * Only used in non-interactive mode.\n   */\n  toolArgs?: string;\n  /**\n   * Watch the file for changes and restart the server. Only used in\n   * interactive mode; a non-interactive call runs the server once.\n   */\n  watch?: boolean;\n};\n\n/**\n * The server name registered in the generated mcp-cli config. mcp-cli\n * addresses non-interactive targets as `<server-name>:<tool>`.\n */\nexport const DEV_SERVER_NAME = \"dev\";\n\n/**\n * Build the JSON config that registers the dev server with mcp-cli so it can\n * be invoked non-interactively. mcp-cli's non-interactive mode resolves the\n * server by name from a config file's `mcpServers` map, so an inline command\n * cannot be passed directly alongside `call-tool`.\n *\n * The server is never started in watch mode here: a non-interactive call\n * connects, calls one tool, and exits, so there is nothing to restart into.\n */\nexport const buildDevConfig = (file: string): string =>\n  JSON.stringify(\n    {\n      mcpServers: {\n        [DEV_SERVER_NAME]: {\n          args: [\"tsx\", file],\n          command: \"npx\",\n        },\n      },\n    },\n    null,\n    2,\n  );\n\n/**\n * Build the argv that the dev command runs.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: file paths, tool names and JSON `--args` are passed to the child\n * process verbatim. Quoting through a shell would be wrong on Windows, where\n * cmd.exe treats single quotes as literal characters rather than as quoting.\n *\n * - Without `tool`: launches the interactive @wong2/mcp-cli inspector\n *   against an inline `npx tsx <file>` server (existing behaviour).\n * - With `tool`: runs @wong2/mcp-cli in non-interactive mode against a\n *   generated config file, calling the named tool and forwarding `--args`.\n */\nexport const buildDevCommand = (\n  options: DevCommandOptions,\n): [string, ...string[]] => {\n  const { configPath, file, tool, toolArgs, watch = false } = options;\n\n  if (tool) {\n    if (!configPath) {\n      throw new Error(\n        \"configPath is required when calling a tool non-interactively\",\n      );\n    }\n\n    return [\n      \"npx\",\n      \"@wong2/mcp-cli\",\n      \"-c\",\n      configPath,\n      \"call-tool\",\n      `${DEV_SERVER_NAME}:${tool}`,\n      ...(toolArgs === undefined ? [] : [\"--args\", toolArgs]),\n    ];\n  }\n\n  return [\n    \"npx\",\n    \"@wong2/mcp-cli\",\n    \"npx\",\n    \"tsx\",\n    ...(watch ? [\"--watch\"] : []),\n    file,\n  ];\n};\n","import { existsSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { basename, dirname, join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\n/**\n * Compiler options for type-checking a server file with no `tsconfig.json`\n * above it. tsc's own defaults (ES5, CommonJS-era module resolution) cannot\n * even read FastMCP's declarations, which use private class fields and a\n * default import of `http`, so no real server file could pass under them.\n * These describe how a server actually runs instead: as an ES module on a\n * current Node, which can import `.ts` files directly.\n */\nexport const DEFAULT_TYPE_CHECK_OPTIONS = [\n  \"--allowImportingTsExtensions\",\n  \"--module\",\n  \"esnext\",\n  \"--moduleResolution\",\n  \"bundler\",\n  \"--skipLibCheck\",\n  \"--target\",\n  \"es2022\",\n];\n\n/**\n * The script that `fastmcp validate` runs to check a server file can be\n * imported.\n *\n * The target file is read from `process.argv[1]` instead of being spliced into\n * this source. Splicing is not equivalent: the path would land inside a\n * JavaScript string literal, so the child's own parser would consume the\n * backslashes of a Windows path as string escapes. `C:\\Users\\dev\\server.ts`\n * reaches the import as `C:Usersdevserver.ts`, which throws `ERR_INVALID_URL`\n * and is reported to the user as \"does not import FastMCP\" even though the file\n * is fine.\n *\n * The script exits explicitly once the import settles. Importing a server file\n * normally starts the server, and a running server — a stdio transport waiting\n * on stdin, an HTTP listener — keeps the process alive indefinitely, so\n * validating a server that calls `start()` would otherwise never finish.\n */\nexport const STRUCTURE_CHECK_SCRIPT = `\n(async () => {\n  try {\n    const { FastMCP } = await import(\"fastmcp\");\n    await import(process.argv[1]);\n    console.log(\"[FastMCP] ✓ Server structure validation passed\");\n  } catch (error) {\n    console.error(\"[FastMCP] ✗ Server structure validation failed:\", error.message);\n    process.exitCode = 1;\n  }\n\n  process.exit();\n})();\n`;\n\n/**\n * Build the argv for the type-check step.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: the file path is passed to tsc verbatim, so a path containing spaces\n * stays one argument. Quoting through a shell would be wrong on Windows, where\n * cmd.exe re-parses the command line and splits such a path into several root\n * files.\n *\n * Given a `project` (see `withTypeCheckProject`), tsc checks the file through\n * it; without one, the file is passed directly with\n * `DEFAULT_TYPE_CHECK_OPTIONS`.\n */\nexport const buildTypeCheckCommand = (\n  file: string,\n  { project, strict = false }: { project?: string; strict?: boolean } = {},\n): [string, ...string[]] => [\n  \"npx\",\n  \"tsc\",\n  \"--noEmit\",\n  ...(strict ? [\"--strict\"] : []),\n  ...(project ? [\"--project\", project] : [...DEFAULT_TYPE_CHECK_OPTIONS, file]),\n];\n\n/**\n * Build a tsconfig that checks only `file`, with the compiler options of the\n * project's own `tsconfig`.\n *\n * `tsc <file>` ignores tsconfig.json altogether and falls back to tsc's\n * defaults, while `tsc --project tsconfig.json` checks every file in the\n * project rather than the one being validated. Extending the project's config\n * and listing just `file` gets both right. A project that is `incremental` or\n * `composite` still writes a `.tsbuildinfo` under `--noEmit`, so both are\n * switched off: validating a file should leave the project untouched. Disable\n * declaration output options too, since they may rely on composite's implicit\n * `declaration: true`; `declarationDir` takes a path, so `null` unsets it.\n */\nexport const buildTypeCheckProject = (tsconfig: string, file: string): string =>\n  JSON.stringify({\n    compilerOptions: {\n      composite: false,\n      declarationDir: null,\n      declarationMap: false,\n      emitDeclarationOnly: false,\n      incremental: false,\n    },\n    extends: `./${basename(tsconfig)}`,\n    files: [file],\n    include: [],\n  });\n\n/**\n * Find the `tsconfig.json` that applies to files in `dir`: the nearest one in\n * it or any of its parents, which is where tsc and editors look too.\n */\nexport const findTsconfig = (dir: string): string | undefined => {\n  const candidate = join(dir, \"tsconfig.json\");\n\n  if (existsSync(candidate)) {\n    return candidate;\n  }\n\n  const parent = dirname(dir);\n\n  return parent === dir ? undefined : findTsconfig(parent);\n};\n\n/**\n * Run `check` with a throwaway tsconfig for `file` (see\n * `buildTypeCheckProject`), or with no project when the file has no\n * `tsconfig.json` above it.\n *\n * The throwaway config is written next to the one it extends and removed once\n * `check` settles. It cannot live in a temporary directory: tsc looks for the\n * `@types` packages it includes by default relative to the config file, so\n * from anywhere else a server using, say, `process.env` would stop compiling.\n */\nexport const withTypeCheckProject = async <T>(\n  file: string,\n  check: (project?: string) => Promise<T>,\n): Promise<T> => {\n  const tsconfig = findTsconfig(dirname(file));\n\n  if (!tsconfig) {\n    return check();\n  }\n\n  const project = join(\n    dirname(tsconfig),\n    `tsconfig.fastmcp-validate-${process.pid}.json`,\n  );\n\n  await writeFile(project, buildTypeCheckProject(tsconfig, file), \"utf8\");\n\n  try {\n    return await check(project);\n  } finally {\n    await rm(project, { force: true });\n  }\n};\n\n/**\n * Find tsx in the project `file` belongs to, as the file: URL of its loader.\n *\n * `fastmcp dev` runs a server with tsx. Node alone only strips types: it\n * cannot follow the `.js` import of a `.ts` file that TypeScript itself asks\n * for, nor run syntax that has to be transformed, like `enum` — and since Node\n * 26 no flag makes it. So the structure check loads the file through the\n * project's tsx when there is one, the way `dev` runs it.\n *\n * Resolved here rather than by the child: `--import tsx` would resolve from\n * the child's working directory, and fail the whole check wherever tsx is not\n * installed. A URL, because `--import` reads a Windows path as a URL scheme.\n */\nexport const resolveTsxLoader = (file: string): string | undefined => {\n  try {\n    return pathToFileURL(createRequire(file).resolve(\"tsx\")).href;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Printed when the structure check fails and the project has no tsx, so the\n * file was loaded by Node alone (see `resolveTsxLoader`).\n */\nexport const TSX_HINT =\n  \"[FastMCP] Hint: if the file imports .ts files with .js extensions, or uses TypeScript syntax Node cannot strip (such as enum), add tsx to your project's devDependencies. validate then loads the file through tsx, as `fastmcp dev` does.\";\n\n/**\n * Build the argv for the structure-check step.\n *\n * As above, the file is passed as an argument rather than quoted into a shell\n * command. It is converted to a file URL by the parent process, so the child\n * receives the URL as-is and never has to reconstruct it. The child is the same\n * Node binary running the CLI, so no PATH lookup is involved.\n *\n * Given a `tsxLoader` (see `resolveTsxLoader`), the child loads it first.\n */\nexport const buildStructureCheckCommand = (\n  file: string,\n  {\n    execPath = process.execPath,\n    tsxLoader,\n  }: { execPath?: string; tsxLoader?: string } = {},\n): [string, ...string[]] => [\n  execPath,\n  ...(tsxLoader ? [\"--import\", tsxLoader] : []),\n  \"-e\",\n  STRUCTURE_CHECK_SCRIPT,\n  pathToFileURL(file).href,\n];\n\n/**\n * The output streams a failed command carries. execa sets both on the error it\n * throws, but they are optional here so the extraction stays honest about not\n * every `Error` having them.\n */\ntype CommandOutputStreams = {\n  stderr?: unknown;\n  stdout?: unknown;\n};\n\nconst hasOutputStreams = (\n  error: Error,\n): error is CommandOutputStreams & Error =>\n  \"stdout\" in error || \"stderr\" in error;\n\n/**\n * Extract the output of a failed command.\n *\n * tsc writes its diagnostics to stdout, while a failure to launch the compiler\n * at all (a missing `npx`, for instance) reports on stderr — reading only\n * stderr left the message empty for every real type error. The structure check\n * reports the reason on stderr, which execa captures, so it has to be replayed\n * here as well or the caller can only print a generic hint.\n *\n * An error that did not come from a command at all — the throwaway tsconfig\n * could not be written, say — is reported by its message.\n */\nexport const formatCommandFailure = (error: unknown): string => {\n  if (!(error instanceof Error)) {\n    return \"\";\n  }\n\n  if (!hasOutputStreams(error)) {\n    return error.message;\n  }\n\n  const collect = (value: unknown): string =>\n    typeof value === \"string\" ? value.trim() : \"\";\n\n  return [collect(error.stderr), collect(error.stdout)]\n    .filter(Boolean)\n    .join(\"\\n\");\n};\n"],"mappings":";;;AAEA,SAAS,aAAa;AACtB,SAAS,SAAS,MAAAA,KAAI,aAAAC,kBAAiB;AACvC,SAAS,cAAc;AACvB,SAAS,QAAAC,aAAY;AACrB,OAAO,WAAW;AAClB,SAAS,eAAe;;;ACwBjB,IAAM,kBAAkB;AAWxB,IAAM,iBAAiB,CAAC,SAC7B,KAAK;AAAA,EACH;AAAA,IACE,YAAY;AAAA,MACV,CAAC,eAAe,GAAG;AAAA,QACjB,MAAM,CAAC,OAAO,IAAI;AAAA,QAClB,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,EACA;AACF;AAeK,IAAM,kBAAkB,CAC7B,YAC0B;AAC1B,QAAM,EAAE,YAAY,MAAM,MAAM,UAAU,QAAQ,MAAM,IAAI;AAE5D,MAAI,MAAM;AACR,QAAI,CAAC,YAAY;AACf,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,GAAG,eAAe,IAAI,IAAI;AAAA,MAC1B,GAAI,aAAa,SAAY,CAAC,IAAI,CAAC,UAAU,QAAQ;AAAA,IACvD;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,QAAQ,CAAC,SAAS,IAAI,CAAC;AAAA,IAC3B;AAAA,EACF;AACF;;;ACpGA,SAAS,kBAAkB;AAC3B,SAAS,IAAI,iBAAiB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,UAAU,SAAS,YAAY;AACxC,SAAS,qBAAqB;AAUvB,IAAM,6BAA6B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAmBO,IAAM,yBAAyB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4B/B,IAAM,wBAAwB,CACnC,MACA,EAAE,SAAS,SAAS,MAAM,IAA4C,CAAC,MAC7C;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAI,SAAS,CAAC,UAAU,IAAI,CAAC;AAAA,EAC7B,GAAI,UAAU,CAAC,aAAa,OAAO,IAAI,CAAC,GAAG,4BAA4B,IAAI;AAC7E;AAeO,IAAM,wBAAwB,CAAC,UAAkB,SACtD,KAAK,UAAU;AAAA,EACb,iBAAiB;AAAA,IACf,WAAW;AAAA,IACX,gBAAgB;AAAA,IAChB,gBAAgB;AAAA,IAChB,qBAAqB;AAAA,IACrB,aAAa;AAAA,EACf;AAAA,EACA,SAAS,KAAK,SAAS,QAAQ,CAAC;AAAA,EAChC,OAAO,CAAC,IAAI;AAAA,EACZ,SAAS,CAAC;AACZ,CAAC;AAMI,IAAM,eAAe,CAAC,QAAoC;AAC/D,QAAM,YAAY,KAAK,KAAK,eAAe;AAE3C,MAAI,WAAW,SAAS,GAAG;AACzB,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,QAAQ,GAAG;AAE1B,SAAO,WAAW,MAAM,SAAY,aAAa,MAAM;AACzD;AAYO,IAAM,uBAAuB,OAClC,MACA,UACe;AACf,QAAM,WAAW,aAAa,QAAQ,IAAI,CAAC;AAE3C,MAAI,CAAC,UAAU;AACb,WAAO,MAAM;AAAA,EACf;AAEA,QAAM,UAAU;AAAA,IACd,QAAQ,QAAQ;AAAA,IAChB,6BAA6B,QAAQ,GAAG;AAAA,EAC1C;AAEA,QAAM,UAAU,SAAS,sBAAsB,UAAU,IAAI,GAAG,MAAM;AAEtE,MAAI;AACF,WAAO,MAAM,MAAM,OAAO;AAAA,EAC5B,UAAE;AACA,UAAM,GAAG,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA,EACnC;AACF;AAeO,IAAM,mBAAmB,CAAC,SAAqC;AACpE,MAAI;AACF,WAAO,cAAc,cAAc,IAAI,EAAE,QAAQ,KAAK,CAAC,EAAE;AAAA,EAC3D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMO,IAAM,WACX;AAYK,IAAM,6BAA6B,CACxC,MACA;AAAA,EACE,WAAW,QAAQ;AAAA,EACnB;AACF,IAA+C,CAAC,MACtB;AAAA,EAC1B;AAAA,EACA,GAAI,YAAY,CAAC,YAAY,SAAS,IAAI,CAAC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA,cAAc,IAAI,EAAE;AACtB;AAYA,IAAM,mBAAmB,CACvB,UAEA,YAAY,SAAS,YAAY;AAc5B,IAAM,uBAAuB,CAAC,UAA2B;AAC9D,MAAI,EAAE,iBAAiB,QAAQ;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,iBAAiB,KAAK,GAAG;AAC5B,WAAO,MAAM;AAAA,EACf;AAEA,QAAM,UAAU,CAAC,UACf,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;AAE7C,SAAO,CAAC,QAAQ,MAAM,MAAM,GAAG,QAAQ,MAAM,MAAM,CAAC,EACjD,OAAO,OAAO,EACd,KAAK,IAAI;AACd;;;AFzOA,MAAM,MAAM,QAAQ,QAAQ,IAAI,CAAC,EAC9B,WAAW,SAAS,EACpB;AAAA,EACC;AAAA,EACA;AAAA,EACA,CAACC,WAAU;AACT,WAAOA,OACJ,WAAW,QAAQ;AAAA,MAClB,cAAc;AAAA,MACd,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC,EAEA,OAAO,QAAQ;AAAA,MACd,UACE;AAAA,MACF,MAAM;AAAA,IACR,CAAC,EAEA,OAAO,QAAQ;AAAA,MACd,OAAO;AAAA,MACP,UACE;AAAA,MACF,MAAM;AAAA,IACR,CAAC,EAEA,OAAO,SAAS;AAAA,MACf,OAAO;AAAA,MACP,SAAS;AAAA,MACT,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC,EAEA,OAAO,WAAW;AAAA,MACjB,OAAO;AAAA,MACP,SAAS;AAAA,MACT,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC;AAAA,EACL;AAAA,EAEA,OAAO,SAAS;AACd,QAAI;AAEJ,QAAI;AACF,UAAI,KAAK,SAAS,UAAa,CAAC,KAAK,MAAM;AACzC,gBAAQ,MAAM,wCAAwC;AACtD,gBAAQ,WAAW;AACnB;AAAA,MACF;AAEA,UAAI,KAAK,QAAQ,KAAK,OAAO;AAC3B,gBAAQ;AAAA,UACN;AAAA,QACF;AAAA,MACF;AAEA,UAAI;AAEJ,UAAI,KAAK,MAAM;AACb,oBAAY,MAAM,QAAQC,MAAK,OAAO,GAAG,cAAc,CAAC;AACxD,qBAAaA,MAAK,WAAW,cAAc;AAC3C,cAAMC,WAAU,YAAY,eAAe,KAAK,IAAI,GAAG,MAAM;AAAA,MAC/D;AAEA,YAAM,CAAC,SAAS,GAAG,WAAW,IAAI,gBAAgB;AAAA,QAChD;AAAA,QACA,MAAM,KAAK;AAAA,QACX,MAAM,KAAK;AAAA,QACX,UAAU,KAAK;AAAA,QACf,OAAO,KAAK;AAAA,MACd,CAAC;AAED,UAAI,KAAK,SAAS;AAChB,gBAAQ;AAAA,UACN,8BAA8B,CAAC,SAAS,GAAG,WAAW,EAAE,KAAK,GAAG,CAAC;AAAA,QACnE;AACA,gBAAQ,IAAI,mBAAmB,KAAK,IAAI,EAAE;AAC1C,gBAAQ;AAAA,UACN,yBAAyB,KAAK,QAAQ,YAAY,UAAU;AAAA,QAC9D;AAEA,YAAI,KAAK,MAAM;AACb,kBAAQ,IAAI,mBAAmB,KAAK,IAAI,EAAE;AAAA,QAC5C;AAAA,MACF;AAEA,YAAM,MAAM,SAAS,aAAa;AAAA,QAChC,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,SAAS,OAAO;AACd,cAAQ;AAAA,QACN;AAAA,QACA,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACvD;AAEA,UAAI,KAAK,WAAW,iBAAiB,SAAS,MAAM,OAAO;AACzD,gBAAQ,MAAM,gCAAgC,MAAM,KAAK;AAAA,MAC3D;AAIA,cAAQ,WAAW;AAAA,IACrB,UAAE;AACA,UAAI,WAAW;AACb,cAAMC,IAAG,WAAW,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AACF,EAEC;AAAA,EACC;AAAA,EACA;AAAA,EACA,CAACH,WAAU;AACT,WAAOA,OAAM,WAAW,QAAQ;AAAA,MAC9B,cAAc;AAAA,MACd,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAAA,EAEA,OAAO,SAAS;AACd,QAAI;AACF,YAAM,MAAM;AAAA,QACV,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV,CAAC,gDAAgD,KAAK,IAAI;AAAA,IAC5D,SAAS,OAAO;AACd,cAAQ;AAAA,QACN;AAAA,QACA,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACvD;AAEA,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,EAEC;AAAA,EACC;AAAA,EACA;AAAA,EACA,CAACA,WAAU;AACT,WAAOA,OACJ,WAAW,QAAQ;AAAA,MAClB,cAAc;AAAA,MACd,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC,EAEA,OAAO,UAAU;AAAA,MAChB,OAAO;AAAA,MACP,SAAS;AAAA,MACT,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC;AAAA,EACL;AAAA,EAEA,OAAO,SAAS;AACd,QAAI;AACF,YAAM,EAAE,YAAAI,YAAW,IAAI,MAAM,OAAO,IAAI;AACxC,YAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,MAAM;AACvC,YAAM,WAAW,QAAQ,KAAK,IAAI;AAElC,UAAI,CAACA,YAAW,QAAQ,GAAG;AACzB,gBAAQ,MAAM,mCAAmC,QAAQ,EAAE;AAC3D,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,cAAQ,IAAI,qCAAqC,QAAQ,EAAE;AAE3D,UAAI;AACF,cAAM,qBAAqB,UAAU,CAAC,YAAY;AAChD,gBAAM,CAAC,kBAAkB,GAAG,aAAa,IAAI;AAAA,YAC3C;AAAA,YACA,EAAE,SAAS,QAAQ,KAAK,OAAO;AAAA,UACjC;AAEA,iBAAO,MAAM,kBAAkB,eAAe;AAAA,YAC5C,QAAQ;AAAA,YACR,QAAQ;AAAA,UACV,CAAC;AAAA,QACH,CAAC;AAED,gBAAQ,IAAI,oDAA+C;AAAA,MAC7D,SAAS,SAAS;AAChB,gBAAQ,MAAM,gDAA2C;AAEzD,cAAM,cAAc,qBAAqB,OAAO;AAEhD,YAAI,aAAa;AACf,kBAAQ,MAAM,WAAW;AAAA,QAC3B;AAEA,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,YAAY,iBAAiB,QAAQ;AAC3C,YAAM,CAAC,kBAAkB,GAAG,aAAa,IAAI;AAAA,QAC3C;AAAA,QACA,EAAE,UAAU;AAAA,MACd;AAEA,UAAI;AACF,cAAM,MAAM,kBAAkB,eAAe;AAAA,UAC3C,QAAQ;AAAA,UACR,QAAQ;AAAA,QACV,CAAC;AAAA,MACH,SAAS,gBAAgB;AAIvB,cAAM,SAAS,qBAAqB,cAAc;AAElD,YAAI,QAAQ;AACV,kBAAQ,MAAM,MAAM;AAAA,QACtB,OAAO;AACL,kBAAQ,MAAM,qDAAgD;AAC9D,kBAAQ;AAAA,YACN;AAAA,UACF;AAAA,QACF;AAEA,YAAI,CAAC,WAAW;AACd,kBAAQ,MAAM,QAAQ;AAAA,QACxB;AAEA,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,cAAQ;AAAA,QACN;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,cAAQ;AAAA,QACN;AAAA,QACA,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACvD;AAEA,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,EAEC,cAAc,CAAC,EACf,OAAO,EACP,KAAK,EACL,WAAW;","names":["rm","writeFile","join","yargs","join","writeFile","rm","existsSync"]}
+{"version":3,"sources":["../../src/bin/fastmcp.ts","../../src/bin/devCommand.ts","../../src/bin/validateCommand.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { execa } from \"execa\";\nimport { mkdtemp, rm, writeFile } from \"fs/promises\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\n\nimport { buildDevCommand, buildDevConfig } from \"./devCommand.js\";\nimport {\n  buildStructureCheckCommand,\n  buildTypeCheckCommand,\n  formatCommandFailure,\n  resolveTsxLoader,\n  TSX_HINT,\n  withTypeCheckProject,\n} from \"./validateCommand.js\";\n\nawait yargs(hideBin(process.argv))\n  .scriptName(\"fastmcp\")\n  .command(\n    \"dev <file>\",\n    \"Start a development server\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"args\", {\n          describe:\n            \"JSON arguments passed to the tool (requires --tool), e.g. '{\\\"a\\\":1}'\",\n          type: \"string\",\n        })\n\n        .option(\"tool\", {\n          alias: \"t\",\n          describe:\n            \"Call a tool non-interactively instead of launching the inspector\",\n          type: \"string\",\n        })\n\n        .option(\"watch\", {\n          alias: \"w\",\n          default: false,\n          describe: \"Watch for file changes and restart server\",\n          type: \"boolean\",\n        })\n\n        .option(\"verbose\", {\n          alias: \"v\",\n          default: false,\n          describe: \"Enable verbose logging\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      let configDir: string | undefined;\n\n      try {\n        if (argv.args !== undefined && !argv.tool) {\n          console.error(\"[FastMCP Error] --args requires --tool\");\n          process.exitCode = 1;\n          return;\n        }\n\n        if (argv.tool && argv.watch) {\n          console.warn(\n            \"[FastMCP] --watch is ignored when calling a tool with --tool: the server runs for a single call.\",\n          );\n        }\n\n        let configPath: string | undefined;\n\n        if (argv.tool) {\n          configDir = await mkdtemp(join(tmpdir(), \"fastmcp-dev-\"));\n          configPath = join(configDir, \"mcp-cli.json\");\n          await writeFile(configPath, buildDevConfig(argv.file), \"utf8\");\n        }\n\n        const [command, ...commandArgs] = buildDevCommand({\n          configPath,\n          file: argv.file,\n          tool: argv.tool,\n          toolArgs: argv.args,\n          watch: argv.watch,\n        });\n\n        if (argv.verbose) {\n          console.log(\n            `[FastMCP] Starting server: ${[command, ...commandArgs].join(\" \")}`,\n          );\n          console.log(`[FastMCP] File: ${argv.file}`);\n          console.log(\n            `[FastMCP] Watch mode: ${argv.watch ? \"enabled\" : \"disabled\"}`,\n          );\n\n          if (argv.tool) {\n            console.log(`[FastMCP] Tool: ${argv.tool}`);\n          }\n        }\n\n        await execa(command, commandArgs, {\n          stderr: \"inherit\",\n          stdin: \"inherit\",\n          stdout: \"inherit\",\n        });\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to start development server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        if (argv.verbose && error instanceof Error && error.stack) {\n          console.error(\"[FastMCP Debug] Stack trace:\", error.stack);\n        }\n\n        // Not process.exit(): that would skip the `finally` block below and\n        // leak the temporary config directory on every failed tool call.\n        process.exitCode = 1;\n      } finally {\n        if (configDir) {\n          await rm(configDir, { force: true, recursive: true });\n        }\n      }\n    },\n  )\n\n  .command(\n    \"inspect <file>\",\n    \"Inspect a server file\",\n    (yargs) => {\n      return yargs.positional(\"file\", {\n        demandOption: true,\n        describe: \"The path to the server file\",\n        type: \"string\",\n      });\n    },\n\n    async (argv) => {\n      try {\n        await execa({\n          stderr: \"inherit\",\n          stdout: \"inherit\",\n        })`npx @modelcontextprotocol/inspector npx tsx ${argv.file}`;\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Failed to inspect server:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .command(\n    \"validate <file>\",\n    \"Validate a FastMCP server file for syntax and basic structure\",\n    (yargs) => {\n      return yargs\n        .positional(\"file\", {\n          demandOption: true,\n          describe: \"The path to the server file\",\n          type: \"string\",\n        })\n\n        .option(\"strict\", {\n          alias: \"s\",\n          default: false,\n          describe: \"Enable strict validation (type checking)\",\n          type: \"boolean\",\n        });\n    },\n\n    async (argv) => {\n      try {\n        const { existsSync } = await import(\"fs\");\n        const { resolve } = await import(\"path\");\n        const filePath = resolve(argv.file);\n\n        if (!existsSync(filePath)) {\n          console.error(`[FastMCP Error] File not found: ${filePath}`);\n          process.exit(1);\n        }\n\n        console.log(`[FastMCP] Validating server file: ${filePath}`);\n\n        try {\n          await withTypeCheckProject(filePath, (project) => {\n            const [typeCheckCommand, ...typeCheckArgs] = buildTypeCheckCommand(\n              filePath,\n              { project, strict: argv.strict },\n            );\n\n            return execa(typeCheckCommand, typeCheckArgs, {\n              stderr: \"pipe\",\n              stdout: \"pipe\",\n            });\n          });\n\n          console.log(\"[FastMCP] ✓ TypeScript compilation successful\");\n        } catch (tsError) {\n          console.error(\"[FastMCP] ✗ TypeScript compilation failed\");\n\n          const diagnostics = formatCommandFailure(tsError);\n\n          if (diagnostics) {\n            console.error(diagnostics);\n          }\n\n          process.exit(1);\n        }\n\n        const tsxLoader = resolveTsxLoader(filePath);\n        const [structureCommand, ...structureArgs] = buildStructureCheckCommand(\n          filePath,\n          { tsxLoader },\n        );\n\n        try {\n          await execa(structureCommand, structureArgs, {\n            stderr: \"pipe\",\n            stdout: \"pipe\",\n          });\n        } catch (structureError) {\n          // The child reports the reason on stderr, which execa captures. Without\n          // replaying it the user only ever sees the generic hint below, even when\n          // the server file has an error they could act on.\n          const reason = formatCommandFailure(structureError);\n\n          if (reason) {\n            console.error(reason);\n          } else {\n            console.error(\"[FastMCP] ✗ Server structure validation failed\");\n            console.error(\n              \"Make sure the file properly imports and uses FastMCP\",\n            );\n          }\n\n          if (!tsxLoader) {\n            console.error(TSX_HINT);\n          }\n\n          process.exit(1);\n        }\n\n        console.log(\n          \"[FastMCP] ✓ All validations passed! Server file looks good.\",\n        );\n      } catch (error) {\n        console.error(\n          \"[FastMCP Error] Validation failed:\",\n          error instanceof Error ? error.message : String(error),\n        );\n\n        process.exit(1);\n      }\n    },\n  )\n\n  .demandCommand(1)\n  .strict()\n  .help()\n  .parseAsync();\n","export type DevCommandOptions = {\n  /**\n   * Path to a temporary mcp-cli config file that registers the dev server.\n   * Only used in non-interactive mode (when `tool` is set).\n   */\n  configPath?: string;\n  /**\n   * Path to the server file to run.\n   */\n  file: string;\n  /**\n   * Name of the tool to call non-interactively. When omitted, the dev\n   * command launches the interactive mcp-cli inspector instead.\n   */\n  tool?: string;\n  /**\n   * JSON string of arguments forwarded to the tool via mcp-cli `--args`.\n   * Only used in non-interactive mode.\n   */\n  toolArgs?: string;\n  /**\n   * Watch the file for changes and restart the server. Only used in\n   * interactive mode; a non-interactive call runs the server once.\n   */\n  watch?: boolean;\n};\n\n/**\n * The server name registered in the generated mcp-cli config. mcp-cli\n * addresses non-interactive targets as `<server-name>:<tool>`.\n */\nexport const DEV_SERVER_NAME = \"dev\";\n\n/**\n * Build the JSON config that registers the dev server with mcp-cli so it can\n * be invoked non-interactively. mcp-cli's non-interactive mode resolves the\n * server by name from a config file's `mcpServers` map, so an inline command\n * cannot be passed directly alongside `call-tool`.\n *\n * The server is never started in watch mode here: a non-interactive call\n * connects, calls one tool, and exits, so there is nothing to restart into.\n */\nexport const buildDevConfig = (file: string): string =>\n  JSON.stringify(\n    {\n      mcpServers: {\n        [DEV_SERVER_NAME]: {\n          args: [\"tsx\", file],\n          command: \"npx\",\n        },\n      },\n    },\n    null,\n    2,\n  );\n\n/**\n * Build the argv that the dev command runs.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: file paths, tool names and JSON `--args` are passed to the child\n * process verbatim. Quoting through a shell would be wrong on Windows, where\n * cmd.exe treats single quotes as literal characters rather than as quoting.\n *\n * - Without `tool`: launches the interactive @wong2/mcp-cli inspector\n *   against an inline `npx tsx <file>` server (existing behaviour).\n * - With `tool`: runs @wong2/mcp-cli in non-interactive mode against a\n *   generated config file, calling the named tool and forwarding `--args`.\n */\nexport const buildDevCommand = (\n  options: DevCommandOptions,\n): [string, ...string[]] => {\n  const { configPath, file, tool, toolArgs, watch = false } = options;\n\n  if (tool) {\n    if (!configPath) {\n      throw new Error(\n        \"configPath is required when calling a tool non-interactively\",\n      );\n    }\n\n    return [\n      \"npx\",\n      \"@wong2/mcp-cli\",\n      \"-c\",\n      configPath,\n      \"call-tool\",\n      `${DEV_SERVER_NAME}:${tool}`,\n      ...(toolArgs === undefined ? [] : [\"--args\", toolArgs]),\n    ];\n  }\n\n  return [\n    \"npx\",\n    \"@wong2/mcp-cli\",\n    \"--\",\n    \"npx\",\n    \"tsx\",\n    ...(watch ? [\"--watch\"] : []),\n    file,\n  ];\n};\n","import { existsSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { basename, dirname, join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\n/**\n * Compiler options for type-checking a server file with no `tsconfig.json`\n * above it. tsc's own defaults (ES5, CommonJS-era module resolution) cannot\n * even read FastMCP's declarations, which use private class fields and a\n * default import of `http`, so no real server file could pass under them.\n * These describe how a server actually runs instead: as an ES module on a\n * current Node, which can import `.ts` files directly.\n */\nexport const DEFAULT_TYPE_CHECK_OPTIONS = [\n  \"--allowImportingTsExtensions\",\n  \"--module\",\n  \"esnext\",\n  \"--moduleResolution\",\n  \"bundler\",\n  \"--skipLibCheck\",\n  \"--target\",\n  \"es2022\",\n];\n\n/**\n * The script that `fastmcp validate` runs to check a server file can be\n * imported.\n *\n * The target file is read from `process.argv[1]` instead of being spliced into\n * this source. Splicing is not equivalent: the path would land inside a\n * JavaScript string literal, so the child's own parser would consume the\n * backslashes of a Windows path as string escapes. `C:\\Users\\dev\\server.ts`\n * reaches the import as `C:Usersdevserver.ts`, which throws `ERR_INVALID_URL`\n * and is reported to the user as \"does not import FastMCP\" even though the file\n * is fine.\n *\n * The script exits explicitly once the import settles. Importing a server file\n * normally starts the server, and a running server — a stdio transport waiting\n * on stdin, an HTTP listener — keeps the process alive indefinitely, so\n * validating a server that calls `start()` would otherwise never finish.\n */\nexport const STRUCTURE_CHECK_SCRIPT = `\n(async () => {\n  try {\n    const { FastMCP } = await import(\"fastmcp\");\n    await import(process.argv[1]);\n    console.log(\"[FastMCP] ✓ Server structure validation passed\");\n  } catch (error) {\n    console.error(\"[FastMCP] ✗ Server structure validation failed:\", error.message);\n    process.exitCode = 1;\n  }\n\n  process.exit();\n})();\n`;\n\n/**\n * Build the argv for the type-check step.\n *\n * This is an argv array rather than a shell string so that nothing has to be\n * quoted: the file path is passed to tsc verbatim, so a path containing spaces\n * stays one argument. Quoting through a shell would be wrong on Windows, where\n * cmd.exe re-parses the command line and splits such a path into several root\n * files.\n *\n * Given a `project` (see `withTypeCheckProject`), tsc checks the file through\n * it; without one, the file is passed directly with\n * `DEFAULT_TYPE_CHECK_OPTIONS`.\n */\nexport const buildTypeCheckCommand = (\n  file: string,\n  { project, strict = false }: { project?: string; strict?: boolean } = {},\n): [string, ...string[]] => [\n  \"npx\",\n  \"tsc\",\n  \"--noEmit\",\n  ...(strict ? [\"--strict\"] : []),\n  ...(project ? [\"--project\", project] : [...DEFAULT_TYPE_CHECK_OPTIONS, file]),\n];\n\n/**\n * Build a tsconfig that checks only `file`, with the compiler options of the\n * project's own `tsconfig`.\n *\n * `tsc <file>` ignores tsconfig.json altogether and falls back to tsc's\n * defaults, while `tsc --project tsconfig.json` checks every file in the\n * project rather than the one being validated. Extending the project's config\n * and listing just `file` gets both right. A project that is `incremental` or\n * `composite` still writes a `.tsbuildinfo` under `--noEmit`, so both are\n * switched off: validating a file should leave the project untouched. Disable\n * declaration output options too, since they may rely on composite's implicit\n * `declaration: true`; `declarationDir` takes a path, so `null` unsets it.\n */\nexport const buildTypeCheckProject = (tsconfig: string, file: string): string =>\n  JSON.stringify({\n    compilerOptions: {\n      composite: false,\n      declarationDir: null,\n      declarationMap: false,\n      emitDeclarationOnly: false,\n      incremental: false,\n    },\n    extends: `./${basename(tsconfig)}`,\n    files: [file],\n    include: [],\n  });\n\n/**\n * Find the `tsconfig.json` that applies to files in `dir`: the nearest one in\n * it or any of its parents, which is where tsc and editors look too.\n */\nexport const findTsconfig = (dir: string): string | undefined => {\n  const candidate = join(dir, \"tsconfig.json\");\n\n  if (existsSync(candidate)) {\n    return candidate;\n  }\n\n  const parent = dirname(dir);\n\n  return parent === dir ? undefined : findTsconfig(parent);\n};\n\n/**\n * Run `check` with a throwaway tsconfig for `file` (see\n * `buildTypeCheckProject`), or with no project when the file has no\n * `tsconfig.json` above it.\n *\n * The throwaway config is written next to the one it extends and removed once\n * `check` settles. It cannot live in a temporary directory: tsc looks for the\n * `@types` packages it includes by default relative to the config file, so\n * from anywhere else a server using, say, `process.env` would stop compiling.\n */\nexport const withTypeCheckProject = async <T>(\n  file: string,\n  check: (project?: string) => Promise<T>,\n): Promise<T> => {\n  const tsconfig = findTsconfig(dirname(file));\n\n  if (!tsconfig) {\n    return check();\n  }\n\n  const project = join(\n    dirname(tsconfig),\n    `tsconfig.fastmcp-validate-${process.pid}.json`,\n  );\n\n  await writeFile(project, buildTypeCheckProject(tsconfig, file), \"utf8\");\n\n  try {\n    return await check(project);\n  } finally {\n    await rm(project, { force: true });\n  }\n};\n\n/**\n * Find tsx in the project `file` belongs to, as the file: URL of its loader.\n *\n * `fastmcp dev` runs a server with tsx. Node alone only strips types: it\n * cannot follow the `.js` import of a `.ts` file that TypeScript itself asks\n * for, nor run syntax that has to be transformed, like `enum` — and since Node\n * 26 no flag makes it. So the structure check loads the file through the\n * project's tsx when there is one, the way `dev` runs it.\n *\n * Resolved here rather than by the child: `--import tsx` would resolve from\n * the child's working directory, and fail the whole check wherever tsx is not\n * installed. A URL, because `--import` reads a Windows path as a URL scheme.\n */\nexport const resolveTsxLoader = (file: string): string | undefined => {\n  try {\n    return pathToFileURL(createRequire(file).resolve(\"tsx\")).href;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Printed when the structure check fails and the project has no tsx, so the\n * file was loaded by Node alone (see `resolveTsxLoader`).\n */\nexport const TSX_HINT =\n  \"[FastMCP] Hint: if the file imports .ts files with .js extensions, or uses TypeScript syntax Node cannot strip (such as enum), add tsx to your project's devDependencies. validate then loads the file through tsx, as `fastmcp dev` does.\";\n\n/**\n * Build the argv for the structure-check step.\n *\n * As above, the file is passed as an argument rather than quoted into a shell\n * command. It is converted to a file URL by the parent process, so the child\n * receives the URL as-is and never has to reconstruct it. The child is the same\n * Node binary running the CLI, so no PATH lookup is involved.\n *\n * Given a `tsxLoader` (see `resolveTsxLoader`), the child loads it first.\n */\nexport const buildStructureCheckCommand = (\n  file: string,\n  {\n    execPath = process.execPath,\n    tsxLoader,\n  }: { execPath?: string; tsxLoader?: string } = {},\n): [string, ...string[]] => [\n  execPath,\n  ...(tsxLoader ? [\"--import\", tsxLoader] : []),\n  \"-e\",\n  STRUCTURE_CHECK_SCRIPT,\n  pathToFileURL(file).href,\n];\n\n/**\n * The output streams a failed command carries. execa sets both on the error it\n * throws, but they are optional here so the extraction stays honest about not\n * every `Error` having them.\n */\ntype CommandOutputStreams = {\n  stderr?: unknown;\n  stdout?: unknown;\n};\n\nconst hasOutputStreams = (\n  error: Error,\n): error is CommandOutputStreams & Error =>\n  \"stdout\" in error || \"stderr\" in error;\n\n/**\n * Extract the output of a failed command.\n *\n * tsc writes its diagnostics to stdout, while a failure to launch the compiler\n * at all (a missing `npx`, for instance) reports on stderr — reading only\n * stderr left the message empty for every real type error. The structure check\n * reports the reason on stderr, which execa captures, so it has to be replayed\n * here as well or the caller can only print a generic hint.\n *\n * An error that did not come from a command at all — the throwaway tsconfig\n * could not be written, say — is reported by its message.\n */\nexport const formatCommandFailure = (error: unknown): string => {\n  if (!(error instanceof Error)) {\n    return \"\";\n  }\n\n  if (!hasOutputStreams(error)) {\n    return error.message;\n  }\n\n  const collect = (value: unknown): string =>\n    typeof value === \"string\" ? value.trim() : \"\";\n\n  return [collect(error.stderr), collect(error.stdout)]\n    .filter(Boolean)\n    .join(\"\\n\");\n};\n"],"mappings":"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","names":["rm","writeFile","join","yargs","join","writeFile","rm","existsSync"]}

package/dist/{chunk-XPGMRMMN.cjs → chunk-AJE7ERFM.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkBV4PWTT6cjs = require('./chunk-BV4PWTT6.cjs');
+var _chunkB7IXBMHVcjs = require('./chunk-B7IXBMHV.cjs');
 
 
 
@@ -141,7 +141,7 @@ var DiscoveryDocumentCache = class {
       throw error;
     }
     if (!res.ok) {
-      await _chunkBV4PWTT6cjs.cancelResponseBody.call(void 0, res);
+      await _chunkB7IXBMHVcjs.cancelResponseBody.call(void 0, res);
       throw new Error(
         `Failed to fetch discovery document from ${url}: ${res.status} ${res.statusText}`
       );
@@ -258,7 +258,7 @@ var imageContent = async (input) => {
           signal: AbortSignal.timeout(timeoutMs)
         });
         if (!response.ok) {
-          await _chunkBV4PWTT6cjs.cancelResponseBody.call(void 0, response);
+          await _chunkB7IXBMHVcjs.cancelResponseBody.call(void 0, response);
           throw new Error(
             `Server responded with status: ${response.status} - ${response.statusText}`
           );
@@ -340,7 +340,7 @@ var audioContent = async (input) => {
           signal: AbortSignal.timeout(timeoutMs)
         });
         if (!response.ok) {
-          await _chunkBV4PWTT6cjs.cancelResponseBody.call(void 0, response);
+          await _chunkB7IXBMHVcjs.cancelResponseBody.call(void 0, response);
           throw new Error(
             `Server responded with status: ${response.status} - ${response.statusText}`
           );
@@ -1692,10 +1692,15 @@ ${error instanceof Error ? error.stack : JSON.stringify(error)}`
           );
           if (parsed.issues) {
             const friendlyErrors = this.#formatSchemaIssues(parsed.issues);
-            throw new (0, _typesjs.McpError)(
-              _typesjs.ErrorCode.InvalidParams,
-              `Tool '${request.params.name}' parameter validation failed: ${friendlyErrors}. Please check the parameter types and values according to the tool's schema.`
-            );
+            return {
+              content: [
+                {
+                  text: `Tool '${request.params.name}' parameter validation failed: ${friendlyErrors}. Please check the parameter types and values according to the tool's schema.`,
+                  type: "text"
+                }
+              ],
+              isError: true
+            };
           }
           args = parsed.value;
         }
@@ -3514,4 +3519,4 @@ var FastMCP = class extends FastMCPEventEmitter {
 
 
 exports.DiscoveryDocumentCache = DiscoveryDocumentCache; exports.jsonSchemaAdapter = jsonSchemaAdapter; exports.MEDIA_FETCH_TIMEOUT_MS = MEDIA_FETCH_TIMEOUT_MS; exports.imageContent = imageContent; exports.audioContent = audioContent; exports.FastMCPError = FastMCPError; exports.SessionError = SessionError; exports.UnexpectedStateError = UnexpectedStateError; exports.UserError = UserError; exports.ServerState = ServerState; exports.FastMCPSession = FastMCPSession; exports.FastMCP = FastMCP;
-//# sourceMappingURL=chunk-XPGMRMMN.cjs.map
+//# sourceMappingURL=chunk-AJE7ERFM.cjs.map