@apify/actors-mcp-server 0.9.2 → 0.9.3-beta.0

package/dist/tools/core/actor_tools_factory.d.ts

@@ -0,0 +1,37 @@
+import type { ApifyClient } from '../../apify_client.js';
+import type { ActorInfo, ActorStore, ApifyToken, ToolEntry } from '../../types.js';
+/**
+ * Enriches actor tool output schemas with field-level detail from the ActorStore.
+ * Uses Promise.allSettled to ensure individual failures don't block other tools.
+ */
+export declare function enrichActorToolOutputSchemas(tools: ToolEntry[], actorStore: ActorStore): Promise<void>;
+/**
+ * This function is used to fetch normal non-MCP server Actors as a tool.
+ *
+ * Fetches Actor input schemas by Actor IDs or Actor full names and creates MCP tools.
+ *
+ * This function retrieves the input schemas for the specified Actors and compiles them into MCP tools.
+ * It uses the AJV library to validate the input schemas.
+ *
+ * Tool name can't contain /, so it is replaced with _
+ *
+ * The input schema processing workflow:
+ * 1. Properties are marked as required using markInputPropertiesAsRequired() to add "REQUIRED" prefix to descriptions
+ * 2. Nested properties are built by analyzing editor type (proxy, requestListSources) using buildNestedProperties()
+ * 3. Properties are filtered using filterSchemaProperties()
+ * 4. Properties are shortened using shortenProperties()
+ * 5. Enums are added to descriptions with examples using addEnumsToDescriptionsWithExamples()
+ *
+ * @param {ActorInfo[]} actorsInfo - An array of ActorInfo objects with webServerMcpPath, definition, and Actor.
+ * @returns {Promise<ToolEntry[]>} - A promise that resolves to an array of MCP tools.
+ */
+export declare function getNormalActorsAsTools(actorsInfo: ActorInfo[], options?: {
+    mcpSessionId?: string;
+    actorStore?: ActorStore;
+}): Promise<ToolEntry[]>;
+export declare function getMCPServersAsTools(actorsInfo: ActorInfo[], apifyToken: ApifyToken, mcpSessionId?: string): Promise<ToolEntry[]>;
+export declare function getActorsAsTools(actorIdsOrNames: string[], apifyClient: ApifyClient, options?: {
+    mcpSessionId?: string;
+    actorStore?: ActorStore;
+}): Promise<ToolEntry[]>;
+//# sourceMappingURL=actor_tools_factory.d.ts.map

package/dist/tools/core/actor_tools_factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor_tools_factory.d.ts","sourceRoot":"","sources":["../../../src/tools/core/actor_tools_factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWzD,OAAO,KAAK,EACR,SAAS,EACT,UAAU,EAEV,UAAU,EACV,SAAS,EAEZ,MAAM,gBAAgB,CAAC;AAOxB;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5G;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CACxC,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,SAAS,EAAE,CAAC,CAqEtB;AAED,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAuDtB;AAED,wBAAsB,gBAAgB,CAClC,eAAe,EAAE,MAAM,EAAE,EACzB,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,SAAS,EAAE,CAAC,CAwDtB"}

package/dist/tools/core/actor_tools_factory.js

@@ -0,0 +1,218 @@
+import log from '@apify/log';
+import { ACTOR_MAX_MEMORY_MBYTES, HelperTools, RAG_WEB_BROWSER, RAG_WEB_BROWSER_ADDITIONAL_DESC, } from '../../const.js';
+import { getActorMCPServerPath, getActorMCPServerURL } from '../../mcp/actors.js';
+import { connectMCPClient } from '../../mcp/client.js';
+import { getMCPServerTools } from '../../mcp/proxy.js';
+import { actorDefinitionPrunedCache } from '../../state.js';
+import { ajv } from '../../utils/ajv.js';
+import { logHttpError } from '../../utils/logging.js';
+import { getActorDefinition } from '../build.js';
+import { buildEnrichedCallActorOutputSchema, callActorOutputSchema } from '../structured_output_schemas.js';
+import { actorNameToToolName, buildActorInputSchema, fixedAjvCompile, isActorInfoMcpServer } from '../utils.js';
+/**
+ * Enriches actor tool output schemas with field-level detail from the ActorStore.
+ * Uses Promise.allSettled to ensure individual failures don't block other tools.
+ */
+export async function enrichActorToolOutputSchemas(tools, actorStore) {
+    const enrichPromises = tools
+        .filter((tool) => tool.type === 'actor')
+        .map(async (tool) => {
+        try {
+            const itemProperties = await actorStore.getActorOutputSchema(tool.actorFullName);
+            if (itemProperties && Object.keys(itemProperties).length > 0) {
+                // eslint-disable-next-line no-param-reassign
+                tool.outputSchema = buildEnrichedCallActorOutputSchema(itemProperties);
+            }
+        }
+        catch (error) {
+            log.debug('Failed to enrich output schema for Actor', {
+                actorName: tool.actorFullName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+    await Promise.allSettled(enrichPromises);
+}
+/**
+ * This function is used to fetch normal non-MCP server Actors as a tool.
+ *
+ * Fetches Actor input schemas by Actor IDs or Actor full names and creates MCP tools.
+ *
+ * This function retrieves the input schemas for the specified Actors and compiles them into MCP tools.
+ * It uses the AJV library to validate the input schemas.
+ *
+ * Tool name can't contain /, so it is replaced with _
+ *
+ * The input schema processing workflow:
+ * 1. Properties are marked as required using markInputPropertiesAsRequired() to add "REQUIRED" prefix to descriptions
+ * 2. Nested properties are built by analyzing editor type (proxy, requestListSources) using buildNestedProperties()
+ * 3. Properties are filtered using filterSchemaProperties()
+ * 4. Properties are shortened using shortenProperties()
+ * 5. Enums are added to descriptions with examples using addEnumsToDescriptionsWithExamples()
+ *
+ * @param {ActorInfo[]} actorsInfo - An array of ActorInfo objects with webServerMcpPath, definition, and Actor.
+ * @returns {Promise<ToolEntry[]>} - A promise that resolves to an array of MCP tools.
+ */
+export async function getNormalActorsAsTools(actorsInfo, options) {
+    var _a;
+    const { mcpSessionId, actorStore } = options !== null && options !== void 0 ? options : {};
+    const tools = [];
+    for (const actorInfo of actorsInfo) {
+        const { definition } = actorInfo;
+        if (!definition)
+            continue;
+        const isRag = definition.actorFullName === RAG_WEB_BROWSER;
+        const { inputSchema } = buildActorInputSchema(definition.actorFullName, definition.input, isRag);
+        let description = `This tool calls the Actor "${definition.actorFullName}" and retrieves its output results.
+Use this tool instead of the "${HelperTools.ACTOR_CALL}" if user requests this specific Actor.
+Actor description: ${definition.description}`;
+        if (isRag) {
+            description += RAG_WEB_BROWSER_ADDITIONAL_DESC;
+        }
+        const memoryMbytes = Math.min(((_a = definition.defaultRunOptions) === null || _a === void 0 ? void 0 : _a.memoryMbytes) || ACTOR_MAX_MEMORY_MBYTES, ACTOR_MAX_MEMORY_MBYTES);
+        let ajvValidate;
+        try {
+            ajvValidate = fixedAjvCompile(ajv, { ...inputSchema, additionalProperties: true });
+        }
+        catch (e) {
+            log.error('Failed to compile schema', {
+                actorName: definition.actorFullName,
+                mcpSessionId,
+                error: e,
+            });
+            continue;
+        }
+        tools.push({
+            type: 'actor',
+            name: actorNameToToolName(definition.actorFullName),
+            actorFullName: definition.actorFullName,
+            description,
+            inputSchema: inputSchema,
+            // reuse the common output schema
+            outputSchema: callActorOutputSchema,
+            ajvValidate,
+            requiresSkyfirePayId: true,
+            memoryMbytes,
+            icons: definition.pictureUrl
+                ? [{ src: definition.pictureUrl, mimeType: 'image/png' }]
+                : undefined,
+            annotations: {
+                title: definition.actorFullName,
+                readOnlyHint: false,
+                destructiveHint: true,
+                openWorldHint: true,
+            },
+            // Allow long-running tasks for Actor tools, make it optional for now
+            execution: {
+                taskSupport: 'optional',
+            },
+        });
+    }
+    // Enrich output schemas with field-level detail if actorStore is available
+    if (actorStore) {
+        await enrichActorToolOutputSchemas(tools, actorStore);
+    }
+    return tools;
+}
+export async function getMCPServersAsTools(actorsInfo, apifyToken, mcpSessionId) {
+    /**
+     * This is case for the Skyfire request without any Apify token, we do not support
+     * standby Actors in this case, so we can skip MCP servers since they would fail anyway (they are standby Actors).
+    */
+    if (apifyToken === null || apifyToken === undefined) {
+        return [];
+    }
+    // Process all actors in parallel
+    const actorToolPromises = actorsInfo.map(async (actorInfo) => {
+        const actorId = actorInfo.definition.id;
+        if (!actorInfo.webServerMcpPath) {
+            log.warning('Actor does not have a web server MCP path, skipping', {
+                actorFullName: actorInfo.definition.actorFullName,
+                actorId,
+                mcpSessionId,
+            });
+            return [];
+        }
+        const mcpServerUrl = await getActorMCPServerURL(actorInfo.definition.id, // Real ID of the Actor
+        actorInfo.webServerMcpPath);
+        log.debug('Retrieved MCP server URL for Actor', {
+            actorFullName: actorInfo.definition.actorFullName,
+            actorId,
+            mcpServerUrl,
+            mcpSessionId,
+        });
+        let client = null;
+        try {
+            client = await connectMCPClient(mcpServerUrl, apifyToken, mcpSessionId);
+            if (!client) {
+                // Skip this Actor, connectMCPClient will log the error
+                return [];
+            }
+            return await getMCPServerTools(actorId, client, mcpServerUrl);
+        }
+        catch (error) {
+            logHttpError(error, 'Failed to load tools from MCP server', {
+                actorFullName: actorInfo.definition.actorFullName,
+                actorId,
+                mcpSessionId,
+            });
+            return [];
+        }
+        finally {
+            if (client)
+                await client.close();
+        }
+    });
+    // Wait for all actors to be processed in parallel
+    const actorToolsArrays = await Promise.all(actorToolPromises);
+    return actorToolsArrays.flat();
+}
+export async function getActorsAsTools(actorIdsOrNames, apifyClient, options) {
+    const { mcpSessionId, actorStore } = options !== null && options !== void 0 ? options : {};
+    log.debug('Fetching Actors as tools', { actorNames: actorIdsOrNames, mcpSessionId });
+    const actorsInfo = await Promise.all(actorIdsOrNames.map(async (actorIdOrName) => {
+        const actorDefinitionWithInfoCached = actorDefinitionPrunedCache.get(actorIdOrName);
+        if (actorDefinitionWithInfoCached) {
+            return {
+                definition: actorDefinitionWithInfoCached.definition,
+                actor: actorDefinitionWithInfoCached.info,
+                webServerMcpPath: getActorMCPServerPath(actorDefinitionWithInfoCached.definition),
+            };
+        }
+        try {
+            const actorDefinitionWithInfo = await getActorDefinition(actorIdOrName, apifyClient);
+            if (!actorDefinitionWithInfo) {
+                log.softFail('Actor not found or definition is not available', { actorName: actorIdOrName, mcpSessionId, statusCode: 404 });
+                return null;
+            }
+            // Cache the Actor definition with info
+            actorDefinitionPrunedCache.set(actorIdOrName, actorDefinitionWithInfo);
+            return {
+                definition: actorDefinitionWithInfo.definition,
+                actor: actorDefinitionWithInfo.info,
+                webServerMcpPath: getActorMCPServerPath(actorDefinitionWithInfo.definition),
+            };
+        }
+        catch (error) {
+            logHttpError(error, 'Failed to fetch Actor definition', {
+                actorName: actorIdOrName,
+                mcpSessionId,
+            });
+            return null;
+        }
+    }));
+    const clonedActors = structuredClone(actorsInfo);
+    // Filter out nulls - actorInfo can be null if the Actor was not found or an error occurred
+    const nonNullActors = clonedActors.filter((actorInfo) => Boolean(actorInfo));
+    // Separate Actors with MCP servers and normal Actors
+    // for MCP servers if mcp path is configured and also if the Actor standby mode is enabled
+    const actorMCPServersInfo = nonNullActors.filter((actorInfo) => isActorInfoMcpServer(actorInfo));
+    // all others
+    const normalActorsInfo = nonNullActors.filter((actorInfo) => !isActorInfoMcpServer(actorInfo));
+    const [normalTools, mcpServerTools] = await Promise.all([
+        getNormalActorsAsTools(normalActorsInfo, { mcpSessionId, actorStore }),
+        getMCPServersAsTools(actorMCPServersInfo, apifyClient.token, mcpSessionId),
+    ]);
+    return [...normalTools, ...mcpServerTools];
+}
+//# sourceMappingURL=actor_tools_factory.js.map

package/dist/tools/core/actor_tools_factory.js.map

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

package/dist/tools/core/call_actor_common.d.ts

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import type { InternalToolArgs, ToolInputSchema } from '../../types.js';
+import { getActorsAsTools } from './actor_tools_factory.js';
+/** Shared MCP server instructions — identical in both modes. */
+export declare const CALL_ACTOR_MCP_SERVER_SECTION = "For MCP server Actors:\n- Use fetch-actor-details with output={ mcpTools: true } to list available tools\n- Call using format: \"actorName:toolName\" (e.g., \"apify/actors-mcp-server:fetch-apify-docs\")";
+/** Shared "two ways to run" + USAGE section — identical in both modes. */
+export declare const CALL_ACTOR_USAGE_SECTION: string;
+/** Shared examples section — identical in both modes. */
+export declare const CALL_ACTOR_EXAMPLES_SECTION = "EXAMPLES:\n- user_input: Get instagram posts using apify/instagram-scraper";
+/**
+ * Zod schema for call-actor arguments — shared between default and openai variants.
+ */
+export declare const callActorArgs: z.ZodObject<{
+    actor: z.ZodString;
+    input: z.ZodObject<{}, z.core.$loose>;
+    async: z.ZodOptional<z.ZodBoolean>;
+    previewOutput: z.ZodOptional<z.ZodBoolean>;
+    callOptions: z.ZodOptional<z.ZodObject<{
+        memory: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Compiled AJV input schema — shared between both variants.
+ */
+export declare const callActorInputSchema: ToolInputSchema;
+/**
+ * Compiled AJV validator with additional properties allowed (for Skyfire pay-id).
+ */
+export declare const callActorAjvValidate: import("ajv").ValidateFunction<unknown>;
+/**
+ * Parsed call-actor arguments.
+ */
+export type CallActorParsedArgs = z.infer<typeof callActorArgs>;
+/**
+ * Result of resolving actor and MCP URL before execution.
+ * Contains everything needed for the mode-specific execution path.
+ */
+export type CallActorResolvedContext = {
+    baseActorName: string;
+    mcpToolName: string | undefined;
+    isActorMcpServer: boolean;
+    mcpServerUrl: string | false;
+};
+/**
+ * Resolves MCP URL and parses the "actor:tool" format.
+ * Shared pre-processing step used by both default and openai variants.
+ */
+export declare function resolveActorContext(actorName: string): {
+    baseActorName: string;
+    mcpToolName: string | undefined;
+};
+/**
+ * Handles the MCP tool call flow (when actorName contains ":toolName").
+ * Returns a response if handled, or null if this is not an MCP tool call.
+ */
+export declare function handleMcpToolCall(params: {
+    baseActorName: string;
+    mcpToolName: string;
+    input: Record<string, unknown>;
+    isActorMcpServer: boolean;
+    mcpServerUrl: string | false;
+    apifyToken: string;
+    mcpSessionId?: string;
+}): Promise<object | null>;
+/**
+ * Validates the actor and its input, returning the resolved actor tool or an error response.
+ * Shared validation logic used by both default and openai execution paths.
+ */
+export declare function resolveAndValidateActor(params: {
+    actorName: string;
+    input: Record<string, unknown>;
+    toolArgs: InternalToolArgs;
+}): Promise<{
+    error: object;
+} | {
+    actor: Awaited<ReturnType<typeof getActorsAsTools>>[0];
+}>;
+/**
+ * Performs the pre-execution checks common to both modes:
+ * - Parses args
+ * - Resolves actor/MCP context
+ * - Handles Skyfire restrictions
+ * - Handles MCP tool calls
+ *
+ * Returns either an early response (error or MCP tool result) or the parsed context for mode-specific execution.
+ */
+export declare function callActorPreExecute(toolArgs: InternalToolArgs): Promise<{
+    earlyResponse: object;
+} | {
+    parsed: CallActorParsedArgs;
+    baseActorName: string;
+    mcpToolName: string | undefined;
+}>;
+//# sourceMappingURL=call_actor_common.d.ts.map

package/dist/tools/core/call_actor_common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call_actor_common.d.ts","sourceRoot":"","sources":["../../../src/tools/core/call_actor_common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAQ5D,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,+MAEmD,CAAC;AAE9F,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,QAMqD,CAAC;AAE3F,yDAAyD;AACzD,eAAO,MAAM,2BAA2B,+EACwB,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;iBAyBxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAoC,eAAe,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,oBAAoB,yCAG/B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CASA;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CzB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAwC1F;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CACxE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACzB;IACE,MAAM,EAAE,mBAAmB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CACJ,CAmDA"}

package/dist/tools/core/call_actor_common.js

@@ -0,0 +1,227 @@
+import { z } from 'zod';
+import { ApifyClient, createApifyClientWithSkyfireSupport } from '../../apify_client.js';
+import { CALL_ACTOR_MCP_MISSING_TOOL_NAME_MSG, HelperTools, TOOL_STATUS, } from '../../const.js';
+import { connectMCPClient } from '../../mcp/client.js';
+import { getActorMcpUrlCached } from '../../utils/actor.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { logHttpError } from '../../utils/logging.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
+import { actorNameToToolName } from '../utils.js';
+import { getActorsAsTools } from './actor_tools_factory.js';
+// ---------------------------------------------------------------------------
+// Shared call-actor description building blocks
+// ---------------------------------------------------------------------------
+const RAG_WEB_BROWSER_TOOL = actorNameToToolName('apify/rag-web-browser');
+/** Shared MCP server instructions — identical in both modes. */
+export const CALL_ACTOR_MCP_SERVER_SECTION = `For MCP server Actors:
+- Use fetch-actor-details with output={ mcpTools: true } to list available tools
+- Call using format: "actorName:toolName" (e.g., "apify/actors-mcp-server:fetch-apify-docs")`;
+/** Shared "two ways to run" + USAGE section — identical in both modes. */
+export const CALL_ACTOR_USAGE_SECTION = `There are two ways to run Actors:
+1. Dedicated Actor tools (e.g., ${RAG_WEB_BROWSER_TOOL}): These are pre-configured tools, offering a simpler and more direct experience.
+2. Generic call-actor tool (${HelperTools.ACTOR_CALL}): Use this when a dedicated tool is not available or when you want to run any Actor dynamically. This tool is especially useful if you do not want to add specific tools or your client does not support dynamic tool registration.
+
+USAGE:
+- Always use dedicated tools when available (e.g., ${RAG_WEB_BROWSER_TOOL})
+- Use the generic call-actor tool only if a dedicated tool does not exist for your Actor.`;
+/** Shared examples section — identical in both modes. */
+export const CALL_ACTOR_EXAMPLES_SECTION = `EXAMPLES:
+- user_input: Get instagram posts using apify/instagram-scraper`;
+/**
+ * Zod schema for call-actor arguments — shared between default and openai variants.
+ */
+export const callActorArgs = z.object({
+    actor: z.string()
+        .describe(`The name of the Actor to call. Format: "username/name" (e.g., "apify/rag-web-browser").
+
+For MCP server Actors, use format "actorName:toolName" to call a specific tool (e.g., "apify/actors-mcp-server:fetch-apify-docs").`),
+    input: z.object({}).passthrough()
+        .describe('The input JSON to pass to the Actor. Required.'),
+    async: z.boolean()
+        .optional()
+        .describe(`When true, starts the run and returns immediately with runId. When false or omitted, behavior depends on the active server mode/tool variant. IMPORTANT: use async=true only when the user explicitly asks to run in the background or does not need immediate results.`),
+    previewOutput: z.boolean()
+        .optional()
+        .describe('When true (default): includes preview items. When false: metadata only (reduces context). Use when fetching fields via get-actor-output.'),
+    callOptions: z.object({
+        memory: z.number()
+            .min(128, 'Memory must be at least 128 MB')
+            .max(32768, 'Memory cannot exceed 32 GB (32768 MB)')
+            .optional()
+            .describe(`Memory allocation for the Actor in MB. Must be a power of 2 (e.g., 128, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768). Minimum: 128 MB, Maximum: 32768 MB (32 GB).`),
+        timeout: z.number()
+            .min(0, 'Timeout must be 0 or greater')
+            .optional()
+            .describe(`Maximum runtime for the Actor in seconds. After this time elapses, the Actor will be automatically terminated. Use 0 for infinite timeout (no time limit). Minimum: 0 seconds (infinite).`),
+    }).optional()
+        .describe('Optional call options for the Actor run configuration.'),
+});
+/**
+ * Compiled AJV input schema — shared between both variants.
+ */
+export const callActorInputSchema = z.toJSONSchema(callActorArgs);
+/**
+ * Compiled AJV validator with additional properties allowed (for Skyfire pay-id).
+ */
+export const callActorAjvValidate = compileSchema({
+    ...z.toJSONSchema(callActorArgs),
+    additionalProperties: true,
+});
+/**
+ * Resolves MCP URL and parses the "actor:tool" format.
+ * Shared pre-processing step used by both default and openai variants.
+ */
+export function resolveActorContext(actorName) {
+    const mcpToolMatch = actorName.match(/^(.+):(.+)$/);
+    if (mcpToolMatch) {
+        return {
+            baseActorName: mcpToolMatch[1],
+            mcpToolName: mcpToolMatch[2],
+        };
+    }
+    return { baseActorName: actorName, mcpToolName: undefined };
+}
+/**
+ * Handles the MCP tool call flow (when actorName contains ":toolName").
+ * Returns a response if handled, or null if this is not an MCP tool call.
+ */
+export async function handleMcpToolCall(params) {
+    const { baseActorName, mcpToolName, input, isActorMcpServer, mcpServerUrl, apifyToken, mcpSessionId } = params;
+    if (!isActorMcpServer) {
+        return buildMCPResponse({
+            texts: [`Actor '${baseActorName}' is not an MCP server.`],
+            isError: true,
+        });
+    }
+    if (!input) {
+        return buildMCPResponse({
+            texts: [`Input is required for MCP tool '${mcpToolName}'. Please provide the input parameter based on the tool's input schema.`],
+            isError: true,
+        });
+    }
+    let client = null;
+    try {
+        client = await connectMCPClient(mcpServerUrl, apifyToken, mcpSessionId);
+        if (!client) {
+            return buildMCPResponse({
+                texts: [`Failed to connect to MCP server ${mcpServerUrl}`],
+                isError: true,
+            });
+        }
+        const result = await client.callTool({
+            name: mcpToolName,
+            arguments: input,
+        });
+        return { content: result.content };
+    }
+    catch (error) {
+        logHttpError(error, `Failed to call MCP tool '${mcpToolName}' on Actor '${baseActorName}'`, {
+            actorName: baseActorName,
+            toolName: mcpToolName,
+        });
+        return buildMCPResponse({
+            texts: [`Failed to call MCP tool '${mcpToolName}' on Actor '${baseActorName}': ${error instanceof Error ? error.message : String(error)}. The MCP server may be temporarily unavailable.`],
+            isError: true,
+        });
+    }
+    finally {
+        if (client)
+            await client.close();
+    }
+}
+/**
+ * Validates the actor and its input, returning the resolved actor tool or an error response.
+ * Shared validation logic used by both default and openai execution paths.
+ */
+export async function resolveAndValidateActor(params) {
+    const { actorName, input, toolArgs } = params;
+    const apifyClient = createApifyClientWithSkyfireSupport(toolArgs.apifyMcpServer, toolArgs.args, toolArgs.apifyToken);
+    const [actor] = await getActorsAsTools([actorName], apifyClient, { mcpSessionId: toolArgs.mcpSessionId });
+    if (!actor) {
+        return {
+            error: buildMCPResponse({
+                texts: [`Actor '${actorName}' was not found.
+Please verify Actor ID or name format (e.g., "username/name" like "apify/rag-web-browser") and ensure that the Actor exists.
+You can search for available Actors using the tool: ${HelperTools.STORE_SEARCH}.`],
+                isError: true,
+                toolStatus: TOOL_STATUS.SOFT_FAIL,
+            }),
+        };
+    }
+    if (!input) {
+        const content = [
+            `Input is required for Actor '${actorName}'. Please provide the input parameter based on the Actor's input schema.`,
+            `The input schema for this Actor was retrieved and is shown below:`,
+            `\`\`\`json\n${JSON.stringify(actor.inputSchema)}\n\`\`\``,
+        ];
+        return { error: buildMCPResponse({ texts: content, isError: true }) };
+    }
+    if (!actor.ajvValidate(input)) {
+        const { errors } = actor.ajvValidate;
+        const content = [
+            `Input validation failed for Actor '${actorName}'. Please ensure your input matches the Actor's input schema.`,
+            `Input schema:\n\`\`\`json\n${JSON.stringify(actor.inputSchema)}\n\`\`\``,
+        ];
+        if (errors && errors.length > 0) {
+            content.push(`Validation errors: ${errors.map((e) => e.message).join(', ')}`);
+        }
+        return { error: buildMCPResponse({ texts: content, isError: true }) };
+    }
+    return { actor };
+}
+/**
+ * Performs the pre-execution checks common to both modes:
+ * - Parses args
+ * - Resolves actor/MCP context
+ * - Handles Skyfire restrictions
+ * - Handles MCP tool calls
+ *
+ * Returns either an early response (error or MCP tool result) or the parsed context for mode-specific execution.
+ */
+export async function callActorPreExecute(toolArgs) {
+    const { args, apifyToken, apifyMcpServer, mcpSessionId } = toolArgs;
+    const parsed = callActorArgs.parse(args);
+    const { baseActorName, mcpToolName } = resolveActorContext(parsed.actor);
+    // For definition resolution we always use token-based client; Skyfire is only for actual Actor runs
+    const apifyClientForDefinition = new ApifyClient({ token: apifyToken });
+    const mcpServerUrlOrFalse = await getActorMcpUrlCached(baseActorName, apifyClientForDefinition);
+    const isActorMcpServer = mcpServerUrlOrFalse && typeof mcpServerUrlOrFalse === 'string';
+    // Standby Actors (MCPs) are not supported in Skyfire mode
+    if (isActorMcpServer && apifyMcpServer.options.skyfireMode) {
+        return {
+            earlyResponse: buildMCPResponse({
+                texts: [`This Actor (${parsed.actor}) is an MCP server and cannot be accessed using a Skyfire token. To use this Actor, please provide a valid Apify token instead of a Skyfire token.`],
+                isError: true,
+                toolStatus: TOOL_STATUS.SOFT_FAIL,
+            }),
+        };
+    }
+    // Handle the case where LLM does not respect instructions when calling MCP server Actors
+    // and does not provide the tool name.
+    const isMcpToolNameInvalid = mcpToolName === undefined || mcpToolName.trim().length === 0;
+    if (isActorMcpServer && isMcpToolNameInvalid) {
+        return {
+            earlyResponse: buildMCPResponse({
+                texts: [CALL_ACTOR_MCP_MISSING_TOOL_NAME_MSG],
+                isError: true,
+            }),
+        };
+    }
+    // Handle MCP tool calls
+    if (mcpToolName) {
+        const mcpResult = await handleMcpToolCall({
+            baseActorName,
+            mcpToolName,
+            input: parsed.input,
+            isActorMcpServer: !!isActorMcpServer,
+            mcpServerUrl: mcpServerUrlOrFalse,
+            apifyToken,
+            mcpSessionId,
+        });
+        if (mcpResult) {
+            return { earlyResponse: mcpResult };
+        }
+    }
+    return { parsed, baseActorName, mcpToolName };
+}
+//# sourceMappingURL=call_actor_common.js.map

package/dist/tools/core/call_actor_common.js.map

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

package/dist/tools/core/fetch_actor_details_common.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { HelperTool } from '../../types.js';
+/**
+ * Zod schema for fetch-actor-details arguments — shared between default and openai variants.
+ */
+export declare const fetchActorDetailsToolArgsSchema: z.ZodObject<{
+    actor: z.ZodString;
+    output: z.ZodOptional<z.ZodObject<{
+        description: z.ZodOptional<z.ZodBoolean>;
+        stats: z.ZodOptional<z.ZodBoolean>;
+        pricing: z.ZodOptional<z.ZodBoolean>;
+        rating: z.ZodOptional<z.ZodBoolean>;
+        metadata: z.ZodOptional<z.ZodBoolean>;
+        inputSchema: z.ZodOptional<z.ZodBoolean>;
+        readme: z.ZodOptional<z.ZodBoolean>;
+        outputSchema: z.ZodOptional<z.ZodBoolean>;
+        mcpTools: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Shared tool metadata for fetch-actor-details — everything except the `call` handler.
+ * Used by both default and openai variants.
+ */
+export declare const fetchActorDetailsMetadata: Omit<HelperTool, 'call'>;
+//# sourceMappingURL=fetch_actor_details_common.d.ts.map

package/dist/tools/core/fetch_actor_details_common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch_actor_details_common.d.ts","sourceRoot":"","sources":["../../../src/tools/core/fetch_actor_details_common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,gBAAgB,CAAC;AAOlE;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;iBAM1C,CAAC;AAiBH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAiB9D,CAAC"}