fastmcp 4.12.3 → 4.12.4

package/README.md

@@ -848,6 +848,7 @@ server.addTool({
 The `imageContent` function takes the following options:
 
 - `url`: The URL of the image.
+- `timeoutMs`: Optional timeout for a URL download in milliseconds (defaults to 30 seconds).
 - `path`: The path to the image file.
 - `buffer`: The image data as a buffer.
 
@@ -1025,6 +1026,7 @@ server.addTool({
 The `audioContent` function takes the following options:
 
 - `url`: The URL of the audio.
+- `timeoutMs`: Optional timeout for a URL download in milliseconds (defaults to 30 seconds).
 - `path`: The path to the audio file.
 - `buffer`: The audio data as a buffer.
 

package/dist/FastMCP.cjs

@@ -10,7 +10,8 @@
 
 
 
-var _chunk3O5ZKWCCcjs = require('./chunk-3O5ZKWCC.cjs');
+
+var _chunkDD63MJG7cjs = require('./chunk-DD63MJG7.cjs');
 
 
 
@@ -47,5 +48,6 @@ var _chunkENMHHQJFcjs = require('./chunk-ENMHHQJF.cjs');
 
 
 
-exports.AuthProvider = _chunkENMHHQJFcjs.AuthProvider; exports.AzureProvider = _chunkENMHHQJFcjs.AzureProvider; exports.DiscoveryDocumentCache = _chunk3O5ZKWCCcjs.DiscoveryDocumentCache; exports.FastMCP = _chunk3O5ZKWCCcjs.FastMCP; exports.FastMCPError = _chunk3O5ZKWCCcjs.FastMCPError; exports.FastMCPSession = _chunk3O5ZKWCCcjs.FastMCPSession; exports.GitHubProvider = _chunkENMHHQJFcjs.GitHubProvider; exports.GoogleProvider = _chunkENMHHQJFcjs.GoogleProvider; exports.OAuthProvider = _chunkENMHHQJFcjs.OAuthProvider; exports.ServerState = _chunk3O5ZKWCCcjs.ServerState; exports.SessionError = _chunk3O5ZKWCCcjs.SessionError; exports.UnexpectedStateError = _chunk3O5ZKWCCcjs.UnexpectedStateError; exports.UserError = _chunk3O5ZKWCCcjs.UserError; exports.audioContent = _chunk3O5ZKWCCcjs.audioContent; exports.getAuthSession = _chunkENMHHQJFcjs.getAuthSession; exports.imageContent = _chunk3O5ZKWCCcjs.imageContent; exports.jsonSchemaAdapter = _chunk3O5ZKWCCcjs.jsonSchemaAdapter; exports.requireAll = _chunkENMHHQJFcjs.requireAll; exports.requireAny = _chunkENMHHQJFcjs.requireAny; exports.requireAuth = _chunkENMHHQJFcjs.requireAuth; exports.requireRole = _chunkENMHHQJFcjs.requireRole; exports.requireScopes = _chunkENMHHQJFcjs.requireScopes;
+
+exports.AuthProvider = _chunkENMHHQJFcjs.AuthProvider; exports.AzureProvider = _chunkENMHHQJFcjs.AzureProvider; exports.DiscoveryDocumentCache = _chunkDD63MJG7cjs.DiscoveryDocumentCache; exports.FastMCP = _chunkDD63MJG7cjs.FastMCP; exports.FastMCPError = _chunkDD63MJG7cjs.FastMCPError; exports.FastMCPSession = _chunkDD63MJG7cjs.FastMCPSession; exports.GitHubProvider = _chunkENMHHQJFcjs.GitHubProvider; exports.GoogleProvider = _chunkENMHHQJFcjs.GoogleProvider; exports.MEDIA_FETCH_TIMEOUT_MS = _chunkDD63MJG7cjs.MEDIA_FETCH_TIMEOUT_MS; exports.OAuthProvider = _chunkENMHHQJFcjs.OAuthProvider; exports.ServerState = _chunkDD63MJG7cjs.ServerState; exports.SessionError = _chunkDD63MJG7cjs.SessionError; exports.UnexpectedStateError = _chunkDD63MJG7cjs.UnexpectedStateError; exports.UserError = _chunkDD63MJG7cjs.UserError; exports.audioContent = _chunkDD63MJG7cjs.audioContent; exports.getAuthSession = _chunkENMHHQJFcjs.getAuthSession; exports.imageContent = _chunkDD63MJG7cjs.imageContent; exports.jsonSchemaAdapter = _chunkDD63MJG7cjs.jsonSchemaAdapter; exports.requireAll = _chunkENMHHQJFcjs.requireAll; exports.requireAny = _chunkENMHHQJFcjs.requireAny; exports.requireAuth = _chunkENMHHQJFcjs.requireAuth; exports.requireRole = _chunkENMHHQJFcjs.requireRole; exports.requireScopes = _chunkENMHHQJFcjs.requireScopes;
 //# sourceMappingURL=FastMCP.cjs.map

package/dist/FastMCP.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/fastmcp/fastmcp/dist/FastMCP.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,+tCAAC","file":"/home/runner/work/fastmcp/fastmcp/dist/FastMCP.cjs"}
+{"version":3,"sources":["/home/runner/work/fastmcp/fastmcp/dist/FastMCP.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,0yCAAC","file":"/home/runner/work/fastmcp/fastmcp/dist/FastMCP.cjs"}

package/dist/FastMCP.d.cts

@@ -141,20 +141,23 @@ type FastMCPSessionEvents = {
         roots: Root[];
     }) => void;
 };
-declare const imageContent: (input: {
-    buffer: Buffer;
-} | {
-    path: string;
-} | {
-    url: string;
-}) => Promise<ImageContent>;
-declare const audioContent: (input: {
+/**
+ * Timeout for image/audio URL fetches (in milliseconds). The OAuth upstream
+ * fetches (#304) use 10s because they are short interactive exchanges; media
+ * downloads can be larger and slower, so 30s is the balance between hanging
+ * forever on an unresponsive server and false positives on slow connections.
+ */
+declare const MEDIA_FETCH_TIMEOUT_MS = 30000;
+type MediaContentInput = {
     buffer: Buffer;
 } | {
     path: string;
 } | {
+    timeoutMs?: number;
     url: string;
-}) => Promise<AudioContent>;
+};
+declare const imageContent: (input: MediaContentInput) => Promise<ImageContent>;
+declare const audioContent: (input: MediaContentInput) => Promise<AudioContent>;
 type Context<T extends FastMCPSessionAuth> = {
     client: {
         version: ReturnType<Server["getClientVersion"]>;
@@ -1054,4 +1057,4 @@ declare class FastMCP<T extends FastMCPSessionAuth = FastMCPSessionAuth> extends
     stop(): Promise<void>;
 }
 
-export { type AudioContent, AuthProvider, type Content, type ContentResult, type Context, DiscoveryDocumentCache, FastMCP, FastMCPError, type FastMCPEvents, type FastMCPRequest, type FastMCPResponse, FastMCPSession, type FastMCPSessionAuth, type FastMCPSessionEvents, type HTTPMethod, type ImageContent, type InputPrompt, type InputPromptArgument, type JsonSchemaObject, type JsonSchemaStandardSchema, type LoadContext, type Logger, type LoggingLevel, OAuthSession, type Progress, type Prompt, type PromptArgument, type Resource, type ResourceContent, type ResourceResult, type ResourceTemplate, type ResourceTemplateArgument, type RouteHandler, type RouteOptions, type SSEServer, type SerializableValue, type ServerOptions, ServerState, SessionError, type TextContent, type Tool, type ToolParameters, UnexpectedStateError, UserError, audioContent, imageContent, jsonSchemaAdapter };
+export { type AudioContent, AuthProvider, type Content, type ContentResult, type Context, DiscoveryDocumentCache, FastMCP, FastMCPError, type FastMCPEvents, type FastMCPRequest, type FastMCPResponse, FastMCPSession, type FastMCPSessionAuth, type FastMCPSessionEvents, type HTTPMethod, type ImageContent, type InputPrompt, type InputPromptArgument, type JsonSchemaObject, type JsonSchemaStandardSchema, type LoadContext, type Logger, type LoggingLevel, MEDIA_FETCH_TIMEOUT_MS, OAuthSession, type Progress, type Prompt, type PromptArgument, type Resource, type ResourceContent, type ResourceResult, type ResourceTemplate, type ResourceTemplateArgument, type RouteHandler, type RouteOptions, type SSEServer, type SerializableValue, type ServerOptions, ServerState, SessionError, type TextContent, type Tool, type ToolParameters, UnexpectedStateError, UserError, audioContent, imageContent, jsonSchemaAdapter };

package/dist/FastMCP.d.ts

@@ -141,20 +141,23 @@ type FastMCPSessionEvents = {
         roots: Root[];
     }) => void;
 };
-declare const imageContent: (input: {
-    buffer: Buffer;
-} | {
-    path: string;
-} | {
-    url: string;
-}) => Promise<ImageContent>;
-declare const audioContent: (input: {
+/**
+ * Timeout for image/audio URL fetches (in milliseconds). The OAuth upstream
+ * fetches (#304) use 10s because they are short interactive exchanges; media
+ * downloads can be larger and slower, so 30s is the balance between hanging
+ * forever on an unresponsive server and false positives on slow connections.
+ */
+declare const MEDIA_FETCH_TIMEOUT_MS = 30000;
+type MediaContentInput = {
     buffer: Buffer;
 } | {
     path: string;
 } | {
+    timeoutMs?: number;
     url: string;
-}) => Promise<AudioContent>;
+};
+declare const imageContent: (input: MediaContentInput) => Promise<ImageContent>;
+declare const audioContent: (input: MediaContentInput) => Promise<AudioContent>;
 type Context<T extends FastMCPSessionAuth> = {
     client: {
         version: ReturnType<Server["getClientVersion"]>;
@@ -1054,4 +1057,4 @@ declare class FastMCP<T extends FastMCPSessionAuth = FastMCPSessionAuth> extends
     stop(): Promise<void>;
 }
 
-export { type AudioContent, AuthProvider, type Content, type ContentResult, type Context, DiscoveryDocumentCache, FastMCP, FastMCPError, type FastMCPEvents, type FastMCPRequest, type FastMCPResponse, FastMCPSession, type FastMCPSessionAuth, type FastMCPSessionEvents, type HTTPMethod, type ImageContent, type InputPrompt, type InputPromptArgument, type JsonSchemaObject, type JsonSchemaStandardSchema, type LoadContext, type Logger, type LoggingLevel, OAuthSession, type Progress, type Prompt, type PromptArgument, type Resource, type ResourceContent, type ResourceResult, type ResourceTemplate, type ResourceTemplateArgument, type RouteHandler, type RouteOptions, type SSEServer, type SerializableValue, type ServerOptions, ServerState, SessionError, type TextContent, type Tool, type ToolParameters, UnexpectedStateError, UserError, audioContent, imageContent, jsonSchemaAdapter };
+export { type AudioContent, AuthProvider, type Content, type ContentResult, type Context, DiscoveryDocumentCache, FastMCP, FastMCPError, type FastMCPEvents, type FastMCPRequest, type FastMCPResponse, FastMCPSession, type FastMCPSessionAuth, type FastMCPSessionEvents, type HTTPMethod, type ImageContent, type InputPrompt, type InputPromptArgument, type JsonSchemaObject, type JsonSchemaStandardSchema, type LoadContext, type Logger, type LoggingLevel, MEDIA_FETCH_TIMEOUT_MS, OAuthSession, type Progress, type Prompt, type PromptArgument, type Resource, type ResourceContent, type ResourceResult, type ResourceTemplate, type ResourceTemplateArgument, type RouteHandler, type RouteOptions, type SSEServer, type SerializableValue, type ServerOptions, ServerState, SessionError, type TextContent, type Tool, type ToolParameters, UnexpectedStateError, UserError, audioContent, imageContent, jsonSchemaAdapter };

package/dist/FastMCP.js

@@ -3,6 +3,7 @@ import {
   FastMCP,
   FastMCPError,
   FastMCPSession,
+  MEDIA_FETCH_TIMEOUT_MS,
   ServerState,
   SessionError,
   UnexpectedStateError,
@@ -10,7 +11,7 @@ import {
   audioContent,
   imageContent,
   jsonSchemaAdapter
-} from "./chunk-5K4GLQMV.js";
+} from "./chunk-FKX5QBJV.js";
 import {
   AuthProvider,
   AzureProvider,
@@ -33,6 +34,7 @@ export {
   FastMCPSession,
   GitHubProvider,
   GoogleProvider,
+  MEDIA_FETCH_TIMEOUT_MS,
   OAuthProvider,
   ServerState,
   SessionError,

package/dist/{chunk-3O5ZKWCC.cjs → chunk-DD63MJG7.cjs}

@@ -197,12 +197,16 @@ function unwrapDefault(value) {
 }
 
 // src/FastMCP.ts
+var MEDIA_FETCH_TIMEOUT_MS = 3e4;
 var imageContent = async (input) => {
   let rawData;
   try {
     if ("url" in input) {
+      const timeoutMs = _nullishCoalesce(input.timeoutMs, () => ( MEDIA_FETCH_TIMEOUT_MS));
       try {
-        const response = await _undici.fetch.call(void 0, input.url);
+        const response = await _undici.fetch.call(void 0, input.url, {
+          signal: AbortSignal.timeout(timeoutMs)
+        });
         if (!response.ok) {
           throw new Error(
             `Server responded with status: ${response.status} - ${response.statusText}`
@@ -210,6 +214,11 @@ var imageContent = async (input) => {
         }
         rawData = Buffer.from(await response.arrayBuffer());
       } catch (error) {
+        if (error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError")) {
+          throw new Error(
+            `Failed to fetch image from URL (${input.url}): timed out after ${timeoutMs}ms`
+          );
+        }
         throw new Error(
           `Failed to fetch image from URL (${input.url}): ${error instanceof Error ? error.message : String(error)}`
         );
@@ -254,8 +263,11 @@ var audioContent = async (input) => {
   let rawData;
   try {
     if ("url" in input) {
+      const timeoutMs = _nullishCoalesce(input.timeoutMs, () => ( MEDIA_FETCH_TIMEOUT_MS));
       try {
-        const response = await _undici.fetch.call(void 0, input.url);
+        const response = await _undici.fetch.call(void 0, input.url, {
+          signal: AbortSignal.timeout(timeoutMs)
+        });
         if (!response.ok) {
           throw new Error(
             `Server responded with status: ${response.status} - ${response.statusText}`
@@ -263,6 +275,11 @@ var audioContent = async (input) => {
         }
         rawData = Buffer.from(await response.arrayBuffer());
       } catch (error) {
+        if (error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError")) {
+          throw new Error(
+            `Failed to fetch audio from URL (${input.url}): timed out after ${timeoutMs}ms`
+          );
+        }
         throw new Error(
           `Failed to fetch audio from URL (${input.url}): ${error instanceof Error ? error.message : String(error)}`
         );
@@ -2529,5 +2546,6 @@ var FastMCP = class extends FastMCPEventEmitter {
 
 
 
-exports.DiscoveryDocumentCache = DiscoveryDocumentCache; exports.jsonSchemaAdapter = jsonSchemaAdapter; 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-3O5ZKWCC.cjs.map
+
+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-DD63MJG7.cjs.map