@prefecthq/fastmcp-ts 1.5.2 → 1.7.0

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { CallToolResult as CallToolResult$1, OAuthClientProvider, OAuthClientMetadata, OAuthClientInformationContext, StoredOAuthClientInformation, StoredOAuthTokens, OAuthDiscoveryState, ClientAuthMethod, Transport, ClientCapabilities, VersionNegotiationOptions, PriorDiscovery, InputRequiredOptions, ResponseCacheStore, ProtocolEra, Implementation, ServerCapabilities } from '@modelcontextprotocol/client';
+import { CallToolResult as CallToolResult$1, OAuthClientProvider, OAuthClientMetadata, OAuthClientInformationContext, StoredOAuthClientInformation, StoredOAuthTokens, OAuthDiscoveryState, ClientAuthMethod, Transport, Implementation, ClientCapabilities, VersionNegotiationOptions, PriorDiscovery, InputRequiredOptions, ResponseCacheStore, ProtocolEra, ServerCapabilities } from '@modelcontextprotocol/client';
 export { ClientCapabilities } from '@modelcontextprotocol/client';
 import { CreateMessageResult, CreateMessageResultWithTools, CreateMessageRequestParams, LoggingLevel, ElicitRequestParams, ElicitResult, Tool, Resource, Prompt, ResourceTemplateType, TextResourceContents, BlobResourceContents, GetPromptResult, OAuthClientMetadata as OAuthClientMetadata$1, Root, ContentBlock, ModelPreferences, SamplingMessage, ToolChoice } from '@modelcontextprotocol/server';
 export { BlobResourceContents, ContentBlock, CreateMessageRequestParams, CreateMessageResult, CreateMessageResultWithTools, ElicitRequestParams, ElicitResult, GetPromptResult, LoggingLevel, ModelPreferences, Prompt, PromptArgument, PromptMessage, Resource, ResourceContents, ResourceTemplateType as ResourceTemplate, Root, SamplingMessage, TextResourceContents, Tool, ToolChoice, ToolResultContent, ToolUseContent } from '@modelcontextprotocol/server';
@@ -626,6 +626,12 @@ interface ClientOptions {
      * A plain string is treated as a Bearer token.
      */
     auth?: BearerAuth | OAuth | AsyncHeaderAuth | string;
+    /**
+     * Identity to advertise to the MCP server. Defaults to `fastmcp-ts` at the
+     * installed package version. Set this when FastMCP is embedded in another
+     * application.
+     */
+    clientInfo?: Implementation;
     handlers?: ClientHandlers;
     /**
      * Additional capabilities to advertise to the server. FastMCP preserves
@@ -714,6 +720,12 @@ interface ClientOptions {
 }
 
 interface MultiServerOptions {
+    /**
+     * Identity to advertise to every MCP server. Defaults to `fastmcp-ts` at the
+     * installed package version. Set this when FastMCP is embedded in another
+     * application.
+     */
+    clientInfo?: Implementation;
     handlers?: ClientHandlers;
     /**
      * Additional capabilities to advertise to every server. FastMCP combines
@@ -742,6 +754,7 @@ declare class MultiServerClient implements IClient {
     /** URI (or namespaced template URI) → server name, populated by list calls */
     private _uriMap;
     private readonly _config;
+    private readonly _clientInfo;
     private readonly _handlers;
     private readonly _roots;
     private readonly _capabilities;
@@ -852,6 +865,7 @@ declare class Client implements IClient {
     private static readonly _MAX_REAUTH_ROUNDS;
     private readonly _input;
     private readonly _auth;
+    private readonly _clientInfo;
     private readonly _handlers;
     private readonly _roots;
     private readonly _capabilities;

package/dist/client.js

@@ -938,6 +938,163 @@ function buildClientCapabilities(supplied, inferred) {
   return capabilities;
 }
 
+// package.json
+var package_default = {
+  name: "@prefecthq/fastmcp-ts",
+  version: "1.7.0",
+  description: "\u{1F3CE}\uFE0F  The official FastMCP TypeScript library - build MCP servers and clients, fast \u{1F3CE}\uFE0F",
+  type: "module",
+  exports: {
+    "./server": {
+      types: "./dist/server.d.ts",
+      import: "./dist/server.js"
+    },
+    "./client": {
+      types: "./dist/client.d.ts",
+      import: "./dist/client.js"
+    }
+  },
+  browser: {
+    child_process: false,
+    "node:child_process": false,
+    fs: false,
+    "fs/promises": false,
+    "node:fs": false,
+    "node:fs/promises": false,
+    http: false,
+    "node:http": false,
+    https: false,
+    "node:https": false,
+    os: false,
+    "node:os": false,
+    path: false,
+    "node:path": false,
+    "node:url": false,
+    "node:process": false,
+    "node:stream": false,
+    net: false,
+    "node:net": false,
+    tls: false,
+    "node:tls": false,
+    "@modelcontextprotocol/client/stdio": false
+  },
+  sideEffects: false,
+  bin: {
+    fastmcp: "dist/cli/index.cjs"
+  },
+  files: [
+    "dist",
+    "README.md"
+  ],
+  engines: {
+    node: ">=22"
+  },
+  scripts: {
+    build: "tsup",
+    prepublishOnly: "npm run build && node scripts/test-dist.mjs && npm run test:browser-bundle",
+    test: "vitest run",
+    "test:browser-bundle": "node scripts/test-browser-bundle.mjs",
+    "test:e2e": "playwright test",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    typecheck: "tsc --noEmit",
+    "conformance:server": "node tests/conformance/run-server.mjs",
+    "conformance:client": "node tests/conformance/run-client.mjs",
+    "docs:dev": "cd docs && npx --yes mint@latest dev",
+    "docs:api": "typedoc && node scripts/generate-api-nav.mjs",
+    "docs:links": "cd docs && npx --yes mint@latest broken-links",
+    changeset: "changeset",
+    "version-packages": "changeset version",
+    release: "changeset publish"
+  },
+  devDependencies: {
+    "@anthropic-ai/sdk": "^0.91.1",
+    "@changesets/cli": "^3.0.0",
+    "@google/genai": "^1.50.1",
+    "@playwright/test": "^1.61.1",
+    "@types/node": "^22.0.0",
+    "@types/url-template": "^2.0.31",
+    "@vitest/coverage-v8": "^4.1.8",
+    arktype: "^2.2.0",
+    esbuild: "^0.28.1",
+    execa: "^9.6.1",
+    "fake-indexeddb": "^6.2.5",
+    "get-bin-path": "^11.0.1",
+    jsdom: "^29.1.1",
+    openai: "^6.34.0",
+    tsup: "^8.5.1",
+    tsx: "^4.21.0",
+    typedoc: "^0.28.0",
+    "typedoc-plugin-markdown": "^4.12.0",
+    typescript: "^5.0.0",
+    valibot: "^1.3.1",
+    vitest: "^4.1.8",
+    zod: "^4.3.6"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/PrefectHQ/fastmcp-ts.git"
+  },
+  keywords: [
+    "mcp",
+    "mcp-tools",
+    "fastmcp",
+    "mcp-clients",
+    "llms",
+    "model-context-protocol",
+    "mcp-servers",
+    "typescript"
+  ],
+  author: "prefecthq",
+  license: "Apache-2.0",
+  bugs: {
+    url: "https://github.com/PrefectHQ/fastmcp-ts/issues"
+  },
+  homepage: "https://github.com/PrefectHQ/fastmcp-ts#readme",
+  peerDependencies: {
+    "@anthropic-ai/sdk": ">=0.39",
+    "@google/genai": ">=0.7",
+    openai: ">=4"
+  },
+  peerDependenciesMeta: {
+    "@anthropic-ai/sdk": {
+      optional: true
+    },
+    openai: {
+      optional: true
+    },
+    "@google/genai": {
+      optional: true
+    }
+  },
+  dependencies: {
+    "@clack/prompts": "^1.2.0",
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@modelcontextprotocol/core": "^2.0.0",
+    "@modelcontextprotocol/node": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    "@modelcontextprotocol/server-legacy": "^2.0.0",
+    "@standard-schema/spec": "^1.1.0",
+    "@types/express": "^5.0.6",
+    chalk: "^5.6.2",
+    chokidar: "^5.0.0",
+    citty: "^0.2.2",
+    "cli-table3": "^0.6.5",
+    express: "^5.2.1",
+    "fastest-levenshtein": "^1.0.16",
+    jose: "6.2.2",
+    listr2: "^10.2.1",
+    "url-template": "^3.1.1",
+    yaml: "^2.8.3"
+  }
+};
+
+// src/client/options.ts
+var DEFAULT_CLIENT_INFO = {
+  name: "fastmcp-ts",
+  version: package_default.version
+};
+
 // src/client/results.ts
 function normalizeCallToolResult(result) {
   return {
@@ -956,6 +1113,7 @@ var MultiServerClient = class _MultiServerClient {
   /** URI (or namespaced template URI) → server name, populated by list calls */
   _uriMap = /* @__PURE__ */ new Map();
   _config;
+  _clientInfo;
   _handlers;
   _roots;
   _capabilities;
@@ -974,6 +1132,7 @@ var MultiServerClient = class _MultiServerClient {
   _logLevels = /* @__PURE__ */ new Map();
   constructor(config, options) {
     this._config = config;
+    this._clientInfo = options?.clientInfo ?? DEFAULT_CLIENT_INFO;
     this._handlers = {
       log: options?.handlers?.log ?? defaultLogHandler,
       progress: options?.handlers?.progress ?? defaultProgressHandler,
@@ -1392,7 +1551,7 @@ ${errors.map(String).join("\n")}`);
   }
   _buildSdkClient() {
     return new SdkClient(
-      { name: "fastmcp-ts", version: "1.0.0" },
+      this._clientInfo,
       {
         capabilities: this._capabilities,
         versionNegotiation: this._versionNegotiation
@@ -1483,6 +1642,7 @@ var Client = class _Client {
   static _MAX_REAUTH_ROUNDS = 2;
   _input;
   _auth;
+  _clientInfo;
   _handlers;
   _roots;
   _capabilities;
@@ -1503,6 +1663,7 @@ var Client = class _Client {
   constructor(input, options) {
     this._input = input;
     this._auth = resolveAuth(options?.auth);
+    this._clientInfo = options?.clientInfo ?? DEFAULT_CLIENT_INFO;
     this._handlers = {
       log: options?.handlers?.log ?? defaultLogHandler,
       progress: options?.handlers?.progress ?? defaultProgressHandler,
@@ -1550,7 +1711,7 @@ var Client = class _Client {
   }
   async _doConnect() {
     const sdkClient = new SdkClient2(
-      { name: "fastmcp-ts", version: "1.0.0" },
+      this._clientInfo,
       {
         capabilities: this._capabilities,
         listChanged: this._buildListChangedConfig(),