@prefecthq/fastmcp-ts 1.0.0 → 1.1.0

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { CreateMessageResult, CreateMessageResultWithTools, ContentBlock, CreateMessageRequestParams, LoggingLevel, ElicitRequestParams, ElicitResult, Tool, Resource, Prompt, ResourceTemplateType, TextResourceContents, BlobResourceContents, GetPromptResult, OAuthClientMetadata as OAuthClientMetadata$1, Root, 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';
-import { OAuthClientProvider, OAuthClientMetadata, OAuthClientInformationContext, StoredOAuthClientInformation, StoredOAuthTokens, OAuthDiscoveryState, ClientAuthMethod, Transport, VersionNegotiationOptions, ProtocolEra, PriorDiscovery, InputRequiredOptions, ResponseCacheStore } from '@modelcontextprotocol/client';
+import { OAuthClientProvider, OAuthClientMetadata, OAuthClientInformationContext, StoredOAuthClientInformation, StoredOAuthTokens, OAuthDiscoveryState, ClientAuthMethod, Transport, VersionNegotiationOptions, ProtocolEra, PriorDiscovery, InputRequiredOptions, ResponseCacheStore, Implementation, ServerCapabilities } from '@modelcontextprotocol/client';
 import Anthropic from '@anthropic-ai/sdk';
 import OpenAI from 'openai';
 import { GoogleGenAI } from '@google/genai';
@@ -604,11 +604,14 @@ interface MultiServerOptions {
     roots?: string[];
     defaultOptions?: ClientDefaultOptions;
     /**
-     * Opt-in protocol version negotiation, applied identically to every server
-     * in the config (protocol revision 2026-07-28 and later). See
+     * Protocol version negotiation, applied identically to every server in the
+     * config (protocol revision 2026-07-28 and later). See
      * `ClientOptions.versionNegotiation` on the single-server `Client` — same
      * semantics, just applied per sub-client here since each connected server
-     * negotiates its own era independently. Default `'legacy'`.
+     * negotiates its own era independently. Default `{ mode: 'auto' }`: each
+     * sub-client probes its server once and falls back to legacy when the
+     * server offers no modern era; `{ mode: 'legacy' }` opts every connection
+     * out of the probe.
      */
     versionNegotiation?: VersionNegotiationOptions;
 }
@@ -745,13 +748,20 @@ interface ClientOptions {
     autoInitialize?: boolean;
     defaultOptions?: ClientDefaultOptions;
     /**
-     * Opt-in protocol version negotiation (protocol revision 2026-07-28 and later).
-     * The default is `'legacy'`: connect() runs the plain 2025 sequence, byte-identical
-     * to today's behavior (no probe, no new headers). Pass `{ mode: 'auto' }` to probe
-     * with `server/discover` and use the modern era when the server supports it
-     * (falling back to legacy otherwise), or `{ mode: { pin: '2026-07-28' } }` to
-     * require the modern era outright. See `getProtocolEra()` to read the negotiated
-     * result after connecting.
+     * Protocol version negotiation (protocol revision 2026-07-28 and later).
+     * The default is `{ mode: 'auto' }`: connect() probes the server once with
+     * `server/discover` and uses the modern (2026-07-28) era on definitive
+     * modern evidence, falling back to the plain legacy `initialize` handshake
+     * on anything else (a method-not-found answer, silence on a local stdio
+     * pipe, a probe child that exits). The probe is stall-safe in the SDK: on
+     * stdio it runs against a short-lived sibling process and a timeout falls
+     * back to legacy, while on HTTP — where silence means an outage — a probe
+     * timeout rejects with a typed error instead of hanging. Pass
+     * `{ mode: 'legacy' }` to opt out: no probe, the 2025 sequence
+     * byte-identical to prior behavior. Pass `{ mode: { pin: '2026-07-28' } }`
+     * to require the modern era outright — connect() throws if the server
+     * cannot speak it. See `getProtocolEra()` to read the negotiated result
+     * after connecting.
      */
     versionNegotiation?: VersionNegotiationOptions;
     /**
@@ -874,6 +884,29 @@ declare class Client implements IClient {
      * `undefined` before connect(). See `ClientOptions.versionNegotiation`.
      */
     getProtocolEra(): ProtocolEra | undefined;
+    /**
+     * The connected server's self-reported identity (`serverInfo`: name, version,
+     * and optional title / websiteUrl / icons), when it identified itself. On a
+     * legacy connection it comes from the `initialize` result, where it is
+     * required. On a modern (2026-07-28) connection it comes from the
+     * `server/discover` result's metadata — FastMCP servers advertise it there,
+     * but an anonymous modern server may omit it, leaving this `undefined`.
+     * `undefined` before connect().
+     */
+    getServerInfo(): Implementation | undefined;
+    /**
+     * The server's `instructions` string, when the server provided one — from
+     * the legacy `initialize` result or, on a modern (2026-07-28) connection,
+     * from the `server/discover` result. `undefined` otherwise and before
+     * connect().
+     */
+    getInstructions(): string | undefined;
+    /**
+     * The capabilities the server advertised during connection — on the legacy
+     * `initialize` result, or on the `server/discover` result for a modern
+     * (2026-07-28) connection. `undefined` before connect().
+     */
+    getServerCapabilities(): ServerCapabilities | undefined;
     listTools(options?: RequestOptions): Promise<Tool[]>;
     callTool<TData = unknown>(name: string, args?: Record<string, unknown>, options?: CallToolOptions): Promise<CallToolResult<TData>>;
     /** Returns the full result including isError without throwing. */

package/dist/client.js

@@ -948,7 +948,7 @@ var MultiServerClient = class _MultiServerClient {
       sampling: options?.handlers?.sampling,
       elicitation: options?.handlers?.elicitation
     };
-    this._versionNegotiation = options?.versionNegotiation;
+    this._versionNegotiation = options?.versionNegotiation ?? { mode: "auto" };
     this._roots = options?.roots;
     this._defaultOptions = options?.defaultOptions ?? {};
   }
@@ -1362,7 +1362,7 @@ ${errors.map(String).join("\n")}`);
       { name: "fastmcp-ts", version: "1.0.0" },
       {
         capabilities: this._buildCapabilities(),
-        ...this._versionNegotiation ? { versionNegotiation: this._versionNegotiation } : {}
+        versionNegotiation: this._versionNegotiation
       }
     );
   }
@@ -1487,7 +1487,7 @@ var Client = class _Client {
     };
     this._roots = options?.roots ? normalizeRootsOption(options.roots) : void 0;
     this._autoInitialize = options?.autoInitialize ?? true;
-    this._versionNegotiation = options?.versionNegotiation;
+    this._versionNegotiation = options?.versionNegotiation ?? { mode: "auto" };
     this._prior = options?.prior;
     this._inputRequired = options?.inputRequired;
     this._responseCacheStore = options?.responseCacheStore;
@@ -1522,7 +1522,7 @@ var Client = class _Client {
       {
         capabilities: this._buildCapabilities(),
         listChanged: this._buildListChangedConfig(),
-        ...this._versionNegotiation ? { versionNegotiation: this._versionNegotiation } : {},
+        versionNegotiation: this._versionNegotiation,
         ...this._inputRequired ? { inputRequired: this._inputRequired } : {},
         ...this._responseCacheStore ? { responseCacheStore: this._responseCacheStore } : {},
         ...this._cachePartition !== void 0 ? { cachePartition: this._cachePartition } : {},
@@ -1546,7 +1546,10 @@ var Client = class _Client {
       if (err instanceof UnauthorizedError && this._auth instanceof OAuth) {
         const callbackParams = await this._auth.waitForCallback();
         await this._finishAuth(transport, callbackParams);
-        const retry = await resolveTransport(this._input, this._auth);
+        const retry = await resolveTransport(this._input, this._auth, {
+          legacySSE: this._legacySSE,
+          versionNegotiation: this._versionNegotiation
+        });
         if (retry.beforeConnect) await retry.beforeConnect();
         this._transport = retry.transport;
         await sdkClient.connect(retry.transport);
@@ -1627,6 +1630,35 @@ var Client = class _Client {
   getProtocolEra() {
     return this._sdkClient?.getProtocolEra();
   }
+  /**
+   * The connected server's self-reported identity (`serverInfo`: name, version,
+   * and optional title / websiteUrl / icons), when it identified itself. On a
+   * legacy connection it comes from the `initialize` result, where it is
+   * required. On a modern (2026-07-28) connection it comes from the
+   * `server/discover` result's metadata — FastMCP servers advertise it there,
+   * but an anonymous modern server may omit it, leaving this `undefined`.
+   * `undefined` before connect().
+   */
+  getServerInfo() {
+    return this._sdkClient?.getServerVersion();
+  }
+  /**
+   * The server's `instructions` string, when the server provided one — from
+   * the legacy `initialize` result or, on a modern (2026-07-28) connection,
+   * from the `server/discover` result. `undefined` otherwise and before
+   * connect().
+   */
+  getInstructions() {
+    return this._sdkClient?.getInstructions();
+  }
+  /**
+   * The capabilities the server advertised during connection — on the legacy
+   * `initialize` result, or on the `server/discover` result for a modern
+   * (2026-07-28) connection. `undefined` before connect().
+   */
+  getServerCapabilities() {
+    return this._sdkClient?.getServerCapabilities();
+  }
   // -------------------------------------------------------------------------
   // Tools (IToolsClient)
   // -------------------------------------------------------------------------