@apify/actors-mcp-server 0.9.20-beta.3 → 0.9.20-beta.5

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

@@ -1,5 +1,7 @@
 import { z } from 'zod';
+import { HelperTools } from '../../const.js';
 import type { InternalToolArgs, ToolInputSchema } from '../../types.js';
+import { buildMCPResponse } from '../../utils/mcp.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\")";
@@ -7,6 +9,48 @@ export declare const CALL_ACTOR_MCP_SERVER_SECTION = "For MCP server Actors:\n-
 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";
+type CallActorDescriptionParams = {
+    actorGetDetailsTool: HelperTools.ACTOR_GET_DETAILS | HelperTools.ACTOR_GET_DETAILS_INTERNAL;
+    storeSearchTool: HelperTools.STORE_SEARCH | HelperTools.STORE_SEARCH_INTERNAL;
+    useInternalSearchWarning: boolean;
+    alwaysAsync: boolean;
+};
+type StartedActorRun = {
+    id: string;
+    status: string;
+    startedAt?: Date;
+};
+type StartAsyncResponseResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: {
+        runId: string;
+        actorName: string;
+        status: string;
+        startedAt: string;
+        input: Record<string, unknown>;
+    };
+    _meta?: Record<string, unknown>;
+};
+type CallActorErrorResponseParams = {
+    actorName: string;
+    error: unknown;
+    actorId?: string;
+    isAsync: boolean;
+    mcpSessionId?: string;
+    actorGetDetailsTool: HelperTools.ACTOR_GET_DETAILS | HelperTools.ACTOR_GET_DETAILS_INTERNAL;
+    storeSearchTool: HelperTools.STORE_SEARCH | HelperTools.STORE_SEARCH_INTERNAL;
+};
+export declare function buildCallActorDescription(params: CallActorDescriptionParams): string;
+export declare function buildStartAsyncResponse(params: {
+    actorName: string;
+    actorRun: StartedActorRun;
+    input: Record<string, unknown>;
+    widget: boolean;
+}): StartAsyncResponseResult;
+export declare function buildCallActorErrorResponse(params: CallActorErrorResponseParams): ReturnType<typeof buildMCPResponse>;
 /**
  * Zod schema for call-actor arguments — shared between default and openai variants.
  */
@@ -83,4 +127,5 @@ export declare function callActorPreExecute(toolArgs: InternalToolArgs): Promise
     baseActorName: string;
     mcpToolName: string | undefined;
 }>;
+export {};
 //# sourceMappingURL=call_actor_common.d.ts.map

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

@@ -1 +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;AAYxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQxE,OAAO,EAA2B,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAQrF,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;AAGrF,eAAO,MAAM,oBAAoB,yCAAkF,CAAC;AAEpH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEhE;;;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,CAsF1F;AAED;;;;;;;;;;;;GAYG;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,CAqDA"}
+{"version":3,"file":"call_actor_common.d.ts","sourceRoot":"","sources":["../../../src/tools/core/call_actor_common.ts"],"names":[],"mappings":"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"}

package/dist/tools/core/call_actor_common.js

@@ -1,13 +1,15 @@
+import dedent from 'dedent';
 import { z } from 'zod';
 import log from '@apify/log';
 import { ApifyClient } from '../../apify_client.js';
 import { CALL_ACTOR_MCP_MISSING_TOOL_NAME_MSG, FAILURE_CATEGORY, HelperTools, TOOL_STATUS, } from '../../const.js';
 import { connectMCPClient } from '../../mcp/client.js';
+import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
 import { getActorMcpUrlCached } from '../../utils/actor.js';
 import { compileSchema } from '../../utils/ajv.js';
-import { logHttpError } from '../../utils/logging.js';
+import { getHttpStatusCode, logHttpError } from '../../utils/logging.js';
 import { buildMCPResponse } from '../../utils/mcp.js';
-import { extractAjvErrorDetails } from '../../utils/tool_status.js';
+import { classifyFailureCategory, extractAjvErrorDetails, getToolStatusFromError } from '../../utils/tool_status.js';
 import { extractActorId } from '../../utils/tools.js';
 import { actorNameToToolName } from '../utils.js';
 import { fixActorNameInputAndLog, getActorsAsTools } from './actor_tools_factory.js';
@@ -30,32 +32,159 @@ USAGE:
 /** Shared examples section — identical in both modes. */
 export const CALL_ACTOR_EXAMPLES_SECTION = `EXAMPLES:
 - user_input: Get instagram posts using apify/instagram-scraper`;
+export function buildCallActorDescription(params) {
+    const { actorGetDetailsTool, storeSearchTool, useInternalSearchWarning, alwaysAsync } = params;
+    const sections = [];
+    sections.push('Call any Actor from the Apify Store.');
+    const workflowLines = dedent `
+        WORKFLOW:
+        1. Use ${actorGetDetailsTool} to get the Actor's input schema
+        2. Call this tool with the actor name and proper input based on the schema
+
+        If the actor name is not in "username/name" format, use ${storeSearchTool} to resolve the correct Actor first.
+    `;
+    if (useInternalSearchWarning) {
+        sections.push(`${workflowLines}\nDo NOT use ${HelperTools.STORE_SEARCH} for name resolution when the next step is running an Actor.`);
+    }
+    else {
+        sections.push(workflowLines);
+    }
+    sections.push(CALL_ACTOR_MCP_SERVER_SECTION);
+    if (alwaysAsync) {
+        sections.push(dedent `
+            IMPORTANT:
+            - This tool always runs asynchronously — it starts the Actor and returns immediately with a runId. A live widget automatically tracks the run progress.
+            - After calling this tool, do NOT poll or call any other tool. Wait for the user to respond — the widget will update them when the run completes.
+            - Once the run completes, use ${HelperTools.ACTOR_OUTPUT_GET} tool with the datasetId to fetch full results.
+            - Use dedicated Actor tools when available for better experience
+        `);
+    }
+    else {
+        sections.push(dedent `
+            IMPORTANT:
+            - Typically returns a datasetId and preview of output items
+            - Use ${HelperTools.ACTOR_OUTPUT_GET} tool with the datasetId to fetch full results
+            - Use dedicated Actor tools when available for better experience
+        `);
+    }
+    sections.push(CALL_ACTOR_USAGE_SECTION);
+    if (!alwaysAsync) {
+        sections.push(dedent `
+            - This tool supports async execution via the \`async\` parameter:
+              - **When \`async: false\` or not provided** (default): Waits for completion and returns results immediately with dataset preview. Use this whenever the user asks for data or results.
+              - **When \`async: true\`**: Starts the run and returns immediately with runId. Only use this when the user explicitly asks to run the Actor in the background or does not need immediate results.
+        `);
+    }
+    sections.push(CALL_ACTOR_EXAMPLES_SECTION);
+    return sections.join('\n\n');
+}
+export function buildStartAsyncResponse(params) {
+    var _a;
+    const { actorName, actorRun, input, widget } = params;
+    const structuredContent = {
+        runId: actorRun.id,
+        actorName,
+        status: actorRun.status,
+        startedAt: ((_a = actorRun.startedAt) === null || _a === void 0 ? void 0 : _a.toISOString()) || '',
+        input,
+    };
+    if (!widget) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Started Actor "${actorName}" (Run ID: ${actorRun.id}).`,
+                }],
+            structuredContent,
+        };
+    }
+    const responseText = dedent `
+        Started Actor "${actorName}" (Run ID: ${actorRun.id}).
+
+        A live progress widget has been rendered that automatically tracks this run and refreshes status every few seconds until completion.
+
+        The widget will update the context with run status and datasetId when the run completes. Once complete (or if the user requests results), use ${HelperTools.ACTOR_OUTPUT_GET} with the datasetId to retrieve the output.
+
+        Do NOT proactively poll using ${HelperTools.ACTOR_RUNS_GET}. Wait for the widget state update or user instructions. Ask the user what they would like to do next.
+    `;
+    const widgetConfig = getWidgetConfig(WIDGET_URIS.ACTOR_RUN);
+    return {
+        content: [{
+                type: 'text',
+                text: responseText,
+            }],
+        structuredContent,
+        _meta: {
+            ...widgetConfig === null || widgetConfig === void 0 ? void 0 : widgetConfig.meta,
+            'openai/widgetDescription': `Actor run progress for ${actorName}`,
+        },
+    };
+}
+export function buildCallActorErrorResponse(params) {
+    const { actorName, error, actorId, isAsync, mcpSessionId, actorGetDetailsTool, storeSearchTool, } = params;
+    const errMsg = error instanceof Error ? error.message : String(error);
+    const failureCategory = classifyFailureCategory(error);
+    logHttpError(error, 'Failed to call Actor', {
+        actorName,
+        async: isAsync,
+        mcpSessionId,
+        failureCategory,
+    });
+    return buildMCPResponse({
+        texts: [
+            `Failed to call Actor '${actorName}': ${errMsg}.`,
+            `Please verify the Actor name, input parameters, and ensure the Actor exists.`,
+            `You can search for available Actors using the tool: ${storeSearchTool}, or get Actor details using: ${actorGetDetailsTool}.`,
+        ],
+        isError: true,
+        telemetry: {
+            toolStatus: getToolStatusFromError(error, false),
+            failureCategory,
+            failureHttpStatus: getHttpStatusCode(error),
+            failureDetail: errMsg.slice(0, 200),
+            actorId,
+        },
+    });
+}
 /**
  * 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").
+        .describe(dedent `
+            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").`),
+            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.`),
+        .describe(dedent `
+            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.'),
+        .describe(dedent `
+            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).`),
+            .describe(dedent `
+                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).`),
+            .describe(dedent `
+                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.'),
 });
@@ -117,8 +246,9 @@ export async function handleMcpToolCall(params) {
             actorName: baseActorName,
             toolName: mcpToolName,
         });
+        const errMsg = error instanceof Error ? error.message : String(error);
         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.`],
+            texts: [`Failed to call MCP tool '${mcpToolName}' on Actor '${baseActorName}': ${errMsg}. The MCP server may be temporarily unavailable.`],
             isError: true,
         });
     }
@@ -139,9 +269,11 @@ export async function resolveAndValidateActor(params) {
     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}.`],
+                texts: [dedent `
+                    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,
                 telemetry: {
                     toolStatus: TOOL_STATUS.SOFT_FAIL,
@@ -238,7 +370,10 @@ export async function callActorPreExecute(toolArgs) {
     if (isActorMcpServer && apifyMcpServer.options.paymentProvider) {
         return {
             earlyResponse: buildMCPResponse({
-                texts: [`This Actor (${parsed.actor}) is an MCP server and cannot be accessed using a third-party payment provider. To use this Actor, please provide a valid Apify token instead.`],
+                texts: [dedent `
+                    This Actor (${parsed.actor}) is an MCP server and cannot be accessed using a third-party payment provider.
+                    To use this Actor, please provide a valid Apify token instead.
+                `],
                 isError: true,
                 telemetry: { toolStatus: TOOL_STATUS.SOFT_FAIL, failureCategory: FAILURE_CATEGORY.INVALID_INPUT },
             }),

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

@@ -1 +1 @@
-{"version":3,"file":"call_actor_common.js","sourceRoot":"","sources":["../../../src/tools/core/call_actor_common.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"call_actor_common.js","sourceRoot":"","sources":["../../../src/tools/core/call_actor_common.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,GAAG,MAAM,YAAY,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACH,oCAAoC,EACpC,gBAAgB,EAChB,WAAW,EACX,WAAW,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAErF,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;AAE1E,gEAAgE;AAChE,MAAM,CAAC,MAAM,6BAA6B,GAAG;;6FAEgD,CAAC;AAE9F,0EAA0E;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG;kCACN,oBAAoB;8BACxB,WAAW,CAAC,UAAU;;;qDAGC,oBAAoB;0FACiB,CAAC;AAE3F,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG;gEACqB,CAAC;AAqCjE,MAAM,UAAU,yBAAyB,CAAC,MAAkC;IACxE,MAAM,EAAE,mBAAmB,EAAE,eAAe,EAAE,wBAAwB,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE/F,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAEtD,MAAM,aAAa,GAAG,MAAM,CAAA;;iBAEf,mBAAmB;;;kEAG8B,eAAe;KAC5E,CAAC;IACF,IAAI,wBAAwB,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,gBAAgB,WAAW,CAAC,YAAY,8DAA8D,CAAC,CAAC;IAC1I,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAE7C,IAAI,WAAW,EAAE,CAAC;QACd,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA;;;;4CAIgB,WAAW,CAAC,gBAAgB;;SAE/D,CAAC,CAAC;IACP,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA;;;oBAGR,WAAW,CAAC,gBAAgB;;SAEvC,CAAC,CAAC;IACP,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAExC,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA;;;;SAInB,CAAC,CAAC;IACP,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAE3C,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAKvC;;IACG,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEtD,MAAM,iBAAiB,GAAG;QACtB,KAAK,EAAE,QAAQ,CAAC,EAAE;QAClB,SAAS;QACT,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,SAAS,EAAE,CAAA,MAAA,QAAQ,CAAC,SAAS,0CAAE,WAAW,EAAE,KAAI,EAAE;QAClD,KAAK;KACR,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kBAAkB,SAAS,cAAc,QAAQ,CAAC,EAAE,IAAI;iBACjE,CAAC;YACF,iBAAiB;SACpB,CAAC;IACN,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAA;yBACN,SAAS,cAAc,QAAQ,CAAC,EAAE;;;;wJAI6F,WAAW,CAAC,gBAAgB;;wCAE5I,WAAW,CAAC,cAAc;KAC7D,CAAC;IAEF,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC5D,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,YAAY;aACrB,CAAC;QACF,iBAAiB;QACjB,KAAK,EAAE;YACH,GAAG,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,IAAI;YACrB,0BAA0B,EAAE,0BAA0B,SAAS,EAAE;SACpE;KACJ,CAAC;AACN,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAoC;IAC5E,MAAM,EACF,SAAS,EACT,KAAK,EACL,OAAO,EACP,OAAO,EACP,YAAY,EACZ,mBAAmB,EACnB,eAAe,GAClB,GAAG,MAAM,CAAC;IAEX,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACvD,YAAY,CAAC,KAAK,EAAE,sBAAsB,EAAE;QACxC,SAAS;QACT,KAAK,EAAE,OAAO;QACd,YAAY;QACZ,eAAe;KAClB,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC;QACpB,KAAK,EAAE;YACH,yBAAyB,SAAS,MAAM,MAAM,GAAG;YACjD,8EAA8E;YAC9E,uDAAuD,eAAe,iCAAiC,mBAAmB,GAAG;SAChI;QACD,OAAO,EAAE,IAAI;QACb,SAAS,EAAE;YACP,UAAU,EAAE,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC;YAChD,eAAe;YACf,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,CAAC;YAC3C,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YACnC,OAAO;SACV;KACJ,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,QAAQ,CAAC,MAAM,CAAA;;;;SAIf,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;SAC5B,QAAQ,CAAC,gDAAgD,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,MAAM,CAAA;;;;SAIf,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;SACrB,QAAQ,EAAE;SACV,QAAQ,CAAC,MAAM,CAAA;;2DAEmC,CAAC;IACxD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;aACb,GAAG,CAAC,GAAG,EAAE,gCAAgC,CAAC;aAC1C,GAAG,CAAC,KAAK,EAAE,uCAAuC,CAAC;aACnD,QAAQ,EAAE;aACV,QAAQ,CAAC,MAAM,CAAA;;;aAGf,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;aACd,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;aACtC,QAAQ,EAAE;aACV,QAAQ,CAAC,MAAM,CAAA;;;aAGf,CAAC;KACT,CAAC,CAAC,QAAQ,EAAE;SACR,QAAQ,CAAC,wDAAwD,CAAC;CAC1E,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC,aAAa,CAAoB,CAAC;AAErF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC;AAOpH;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IAIjD,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpD,IAAI,YAAY,EAAE,CAAC;QACf,OAAO;YACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;YAC9B,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;SAC/B,CAAC;IACN,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAQvC;IACG,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAE/G,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACpB,OAAO,gBAAgB,CAAC;YACpB,KAAK,EAAE,CAAC,UAAU,aAAa,yBAAyB,CAAC;YACzD,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;IACP,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,gBAAgB,CAAC;YACpB,KAAK,EAAE,CAAC,mCAAmC,WAAW,yEAAyE,CAAC;YAChI,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;IACP,CAAC;IAED,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,CAAC;QACD,MAAM,GAAG,MAAM,gBAAgB,CAAC,YAAsB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,gBAAgB,CAAC;gBACpB,KAAK,EAAE,CAAC,mCAAmC,YAAY,EAAE,CAAC;gBAC1D,OAAO,EAAE,IAAI;aAChB,CAAC,CAAC;QACP,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACjC,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,YAAY,CAAC,KAAK,EAAE,4BAA4B,WAAW,eAAe,aAAa,GAAG,EAAE;YACxF,SAAS,EAAE,aAAa;YACxB,QAAQ,EAAE,WAAW;SACxB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,gBAAgB,CAAC;YACpB,KAAK,EAAE,CAAC,4BAA4B,WAAW,eAAe,aAAa,MAAM,MAAM,kDAAkD,CAAC;YAC1I,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;IACP,CAAC;YAAS,CAAC;QACP,IAAI,MAAM;YAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAI7C;;IACG,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC9C,MAAM,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;IAEjC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IAE1G,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO;YACH,KAAK,EAAE,gBAAgB,CAAC;gBACpB,KAAK,EAAE,CAAC,MAAM,CAAA;6BACD,SAAS;;0EAEoC,WAAW,CAAC,YAAY;iBACjF,CAAC;gBACF,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE;oBACP,UAAU,EAAE,WAAW,CAAC,SAAS;oBACjC,eAAe,EAAE,gBAAgB,CAAC,aAAa;oBAC/C,iBAAiB,EAAE,GAAG;oBACtB,aAAa,EAAE,UAAU,SAAS,iBAAiB;iBACtD;aACJ,CAAC;SACL,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,GAAG,CAAC,QAAQ,CAAC,6BAA6B,EAAE;YACxC,SAAS;YACT,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,eAAe,EAAE,gBAAgB,CAAC,aAAa;SAClD,CAAC,CAAC;QACH,OAAO;YACH,KAAK,EAAE,gBAAgB,CAAC;gBACpB,KAAK,EAAE;oBACH,gCAAgC,SAAS,0EAA0E;oBACnH,mEAAmE;oBACnE,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU;iBAC7D;gBACD,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE;oBACP,UAAU,EAAE,WAAW,CAAC,SAAS;oBACjC,eAAe,EAAE,gBAAgB,CAAC,aAAa;oBAC/C,OAAO;oBACP,aAAa,EAAE,mBAAmB;iBACrC;aACJ,CAAC;SACL,CAAC;IACN,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;QACrC,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,IAAI,CAAC,CAAC;QAC1D,MAAM,iBAAiB,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAA0B,CAAC,OAAO,EAC/C,IAAI,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAC;QAEtB,GAAG,CAAC,QAAQ,CAAC,mCAAmC,EAAE;YAC9C,SAAS;YACT,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,eAAe,EAAE,gBAAgB,CAAC,aAAa;YAC/C,iBAAiB,EAAE,UAAU,CAAC,kBAAkB;YAChD,cAAc,EAAE,UAAU,CAAC,eAAe;YAC1C,yBAAyB,EAAE,UAAU,CAAC,2BAA2B;SACpE,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG;YACZ,sCAAsC,SAAS,+DAA+D;YAC9G,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU;SAC5E,CAAC;QACF,IAAI,iBAAiB,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,sBAAsB,iBAAiB,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO;YACH,KAAK,EAAE,gBAAgB,CAAC;gBACpB,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE;oBACP,UAAU,EAAE,WAAW,CAAC,SAAS;oBACjC,eAAe,EAAE,gBAAgB,CAAC,aAAa;oBAC/C,OAAO;oBACP,aAAa,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,yBAAyB;oBAC3E,eAAe,EAAE,UAAU;iBAC9B;aACJ,CAAC;SACL,CAAC;IACN,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAA0B;IAQhE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;IACpE,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,uBAAuB,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACnG,MAAM,MAAM,GAAwB,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAExE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzE,+GAA+G;IAC/G,MAAM,wBAAwB,GAAG,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACxE,MAAM,mBAAmB,GAAG,MAAM,oBAAoB,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAC;IAChG,MAAM,gBAAgB,GAAG,CAAC,CAAC,mBAAmB,CAAC;IAE/C,iGAAiG;IACjG,IAAI,gBAAgB,IAAI,cAAc,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAC7D,OAAO;YACH,aAAa,EAAE,gBAAgB,CAAC;gBAC5B,KAAK,EAAE,CAAC,MAAM,CAAA;kCACI,MAAM,CAAC,KAAK;;iBAE7B,CAAC;gBACF,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,SAAS,EAAE,eAAe,EAAE,gBAAgB,CAAC,aAAa,EAAE;aACpG,CAAC;SACL,CAAC;IACN,CAAC;IAED,yFAAyF;IACzF,sCAAsC;IACtC,MAAM,oBAAoB,GAAG,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;IAC1F,IAAI,gBAAgB,IAAI,oBAAoB,EAAE,CAAC;QAC3C,OAAO;YACH,aAAa,EAAE,gBAAgB,CAAC;gBAC5B,KAAK,EAAE,CAAC,oCAAoC,CAAC;gBAC7C,OAAO,EAAE,IAAI;aAChB,CAAC;SACL,CAAC;IACN,CAAC;IAED,wBAAwB;IACxB,IAAI,WAAW,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC;YACtC,aAAa;YACb,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAgC;YAC9C,gBAAgB;YAChB,YAAY,EAAE,mBAAmB;YACjC,UAAU;YACV,YAAY;SACf,CAAC,CAAC;QACH,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;QACxC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAClD,CAAC"}

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import type { ApifyClient } from '../../apify_client.js';
 import type { HelperTool } from '../../types.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
 /**
  * Zod schema for get-actor-run arguments — shared between default and openai variants.
  */
@@ -37,6 +38,16 @@ export type FetchActorRunResult = {
     run: Record<string, unknown>;
     structuredContent: ActorRunStructuredContent;
 };
+/**
+ * Builds the standard tool error response for get-actor-run.
+ */
+export declare function buildGetActorRunError(runId: string, error: unknown): ReturnType<typeof buildMCPResponse>;
+/**
+ * Builds the tool success response for get-actor-run in default or widget mode.
+ */
+export declare function buildGetActorRunSuccessResponse(params: FetchActorRunResult & {
+    widget: boolean;
+}): ReturnType<typeof buildMCPResponse>;
 /**
  * Fetches actor run data, resolves actor name, and fetches dataset results if completed.
  * Shared data-fetching logic used by both default and openai variants.

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

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run_common.d.ts","sourceRoot":"","sources":["../../../src/tools/core/get_actor_run_common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,gBAAgB,CAAC;AAMlE;;GAEG;AACH,eAAO,MAAM,eAAe;;iBAI1B,CAAC;AAgBH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAmBxD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC;QAChB,YAAY,EAAE,OAAO,EAAE,CAAC;KAC3B,CAAC;CACL,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,iBAAiB,EAAE,yBAAyB,CAAC;CAChD,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA0D/D"}
+{"version":3,"file":"get_actor_run_common.d.ts","sourceRoot":"","sources":["../../../src/tools/core/get_actor_run_common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAkB,MAAM,oBAAoB,CAAC;AAItE;;GAEG;AACH,eAAO,MAAM,eAAe;;iBAI1B,CAAC;AAgBH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAmBxD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC;QAChB,YAAY,EAAE,OAAO,EAAE,CAAC;KAC3B,CAAC;CACL,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,iBAAiB,EAAE,yBAAyB,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CASxG;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC3C,MAAM,EAAE,mBAAmB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAClD,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAuBrC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA0D/D"}

package/dist/tools/core/get_actor_run_common.js

@@ -1,10 +1,11 @@
 var _a;
+import dedent from 'dedent';
 import { z } from 'zod';
 import log from '@apify/log';
 import { FAILURE_CATEGORY, HelperTools, TOOL_STATUS } from '../../const.js';
 import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
 import { compileSchema } from '../../utils/ajv.js';
-import { buildMCPResponse } from '../../utils/mcp.js';
+import { buildMCPResponse, buildUsageMeta } from '../../utils/mcp.js';
 import { generateSchemaFromItems } from '../../utils/schema_generation.js';
 import { getActorRunOutputSchema } from '../structured_output_schemas.js';
 /**
@@ -52,6 +53,44 @@ export const getActorRunMetadata = {
         openWorldHint: false,
     },
 };
+/**
+ * Builds the standard tool error response for get-actor-run.
+ */
+export function buildGetActorRunError(runId, error) {
+    return buildMCPResponse({
+        texts: [dedent `
+            Failed to get Actor run '${runId}': ${error instanceof Error ? error.message : String(error)}.
+            Please verify the run ID and ensure that the run exists.
+        `],
+        isError: true,
+        telemetry: { toolStatus: TOOL_STATUS.SOFT_FAIL },
+    });
+}
+/**
+ * Builds the tool success response for get-actor-run in default or widget mode.
+ */
+export function buildGetActorRunSuccessResponse(params) {
+    var _a, _b, _c;
+    const { run, structuredContent, widget } = params;
+    if (!widget) {
+        return buildMCPResponse({
+            texts: [`# Actor Run Information\n\`\`\`json\n${JSON.stringify(run)}\n\`\`\``],
+            structuredContent,
+            _meta: buildUsageMeta(run),
+        });
+    }
+    const statusText = structuredContent.status === 'SUCCEEDED' && structuredContent.dataset
+        ? `Actor run ${structuredContent.runId} completed successfully with ${structuredContent.dataset.totalItemCount} items. A widget has been rendered with the details.`
+        : `Actor run ${structuredContent.runId} status: ${structuredContent.status}. A progress widget has been rendered.`;
+    return buildMCPResponse({
+        texts: [statusText],
+        structuredContent,
+        _meta: {
+            ...((_b = (_a = getWidgetConfig(WIDGET_URIS.ACTOR_RUN)) === null || _a === void 0 ? void 0 : _a.meta) !== null && _b !== void 0 ? _b : {}),
+            ...((_c = buildUsageMeta(run)) !== null && _c !== void 0 ? _c : {}),
+        },
+    });
+}
 /**
  * Fetches actor run data, resolves actor name, and fetches dataset results if completed.
  * Shared data-fetching logic used by both default and openai variants.

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

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

package/dist/tools/default/call_actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call_actor.d.ts","sourceRoot":"","sources":["../../../src/tools/default/call_actor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA2ClE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAwHpB,CAAC"}
+{"version":3,"file":"call_actor.d.ts","sourceRoot":"","sources":["../../../src/tools/default/call_actor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAuBlE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAsGpB,CAAC"}

package/dist/tools/default/call_actor.js

@@ -2,32 +2,18 @@ var _a;
 import log from '@apify/log';
 import { HelperTools } from '../../const.js';
 import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
-import { getHttpStatusCode, logHttpError } from '../../utils/logging.js';
-import { buildMCPResponse, buildUsageMeta } from '../../utils/mcp.js';
-import { classifyFailureCategory, getToolStatusFromError } from '../../utils/tool_status.js';
+import { buildUsageMeta } from '../../utils/mcp.js';
 import { extractActorId } from '../../utils/tools.js';
 import { callActorGetDataset } from '../core/actor_execution.js';
 import { buildActorResponseContent } from '../core/actor_response.js';
-import { CALL_ACTOR_EXAMPLES_SECTION, CALL_ACTOR_MCP_SERVER_SECTION, CALL_ACTOR_USAGE_SECTION, callActorAjvValidate, callActorInputSchema, callActorPreExecute, resolveAndValidateActor, } from '../core/call_actor_common.js';
+import { buildCallActorDescription, buildCallActorErrorResponse, buildStartAsyncResponse, callActorAjvValidate, callActorInputSchema, callActorPreExecute, resolveAndValidateActor, } from '../core/call_actor_common.js';
 import { callActorOutputSchema } from '../structured_output_schemas.js';
-const CALL_ACTOR_DEFAULT_DESCRIPTION = [
-    `Call any Actor from the Apify Store.`,
-    `WORKFLOW:
-1. Use ${HelperTools.ACTOR_GET_DETAILS} to get the Actor's input schema
-2. Call this tool with the actor name and proper input based on the schema
-
-If the actor name is not in "username/name" format, use ${HelperTools.STORE_SEARCH} to resolve the correct Actor first.`,
-    CALL_ACTOR_MCP_SERVER_SECTION,
-    `IMPORTANT:
-- Typically returns a datasetId and preview of output items
-- Use ${HelperTools.ACTOR_OUTPUT_GET} tool with the datasetId to fetch full results
-- Use dedicated Actor tools when available for better experience`,
-    CALL_ACTOR_USAGE_SECTION,
-    `- This tool supports async execution via the \`async\` parameter:
-  - **When \`async: false\` or not provided** (default): Waits for completion and returns results immediately with dataset preview. Use this whenever the user asks for data or results.
-  - **When \`async: true\`**: Starts the run and returns immediately with runId. Only use this when the user explicitly asks to run the Actor in the background or does not need immediate results.`,
-    CALL_ACTOR_EXAMPLES_SECTION,
-].join('\n\n');
+const CALL_ACTOR_DEFAULT_DESCRIPTION = buildCallActorDescription({
+    actorGetDetailsTool: HelperTools.ACTOR_GET_DETAILS,
+    storeSearchTool: HelperTools.STORE_SEARCH,
+    useInternalSearchWarning: false,
+    alwaysAsync: false,
+});
 /**
  * Default mode call-actor tool.
  * Supports both sync (default) and async execution.
@@ -57,7 +43,6 @@ export const defaultCallActor = Object.freeze({
         taskSupport: 'optional',
     },
     call: async (toolArgs) => {
-        var _a;
         const preResult = await callActorPreExecute(toolArgs);
         if ('earlyResponse' in preResult) {
             return preResult.earlyResponse;
@@ -81,19 +66,14 @@ export const defaultCallActor = Object.freeze({
                 const actorClient = apifyClient.actor(baseActorName);
                 const actorRun = await actorClient.start(input, callOptions);
                 log.debug('Started Actor run (async)', { actorName: baseActorName, runId: actorRun.id, mcpSessionId: toolArgs.mcpSessionId });
-                const structuredContent = {
-                    runId: actorRun.id,
+                const response = buildStartAsyncResponse({
                     actorName: baseActorName,
-                    status: actorRun.status,
-                    startedAt: ((_a = actorRun.startedAt) === null || _a === void 0 ? void 0 : _a.toISOString()) || '',
+                    actorRun,
                     input,
-                };
+                    widget: false,
+                });
                 return {
-                    content: [{
-                            type: 'text',
-                            text: `Started Actor "${baseActorName}" (Run ID: ${actorRun.id}).`,
-                        }],
-                    structuredContent,
+                    ...response,
                     toolTelemetry: { actorId: resolvedActorId },
                 };
             }
@@ -123,25 +103,14 @@ export const defaultCallActor = Object.freeze({
             };
         }
         catch (error) {
-            const errMsg = error instanceof Error ? error.message : String(error);
-            logHttpError(error, 'Failed to call Actor', {
+            return buildCallActorErrorResponse({
                 actorName: baseActorName,
-                async: isAsync,
+                error,
+                actorId: resolvedActorId,
+                isAsync,
                 mcpSessionId: toolArgs.mcpSessionId,
-                failureCategory: classifyFailureCategory(error),
-            });
-            return buildMCPResponse({
-                texts: [`Failed to call Actor '${baseActorName}': ${errMsg}.
-Please verify the Actor name, input parameters, and ensure the Actor exists.
-You can search for available Actors using the tool: ${HelperTools.STORE_SEARCH}, or get Actor details using: ${HelperTools.ACTOR_GET_DETAILS}.`],
-                isError: true,
-                telemetry: {
-                    toolStatus: getToolStatusFromError(error, false),
-                    failureCategory: classifyFailureCategory(error),
-                    failureHttpStatus: getHttpStatusCode(error),
-                    failureDetail: errMsg.slice(0, 200),
-                    actorId: resolvedActorId,
-                },
+                actorGetDetailsTool: HelperTools.ACTOR_GET_DETAILS,
+                storeSearchTool: HelperTools.STORE_SEARCH,
             });
         }
     },

package/dist/tools/default/call_actor.js.map

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

package/dist/tools/default/get_actor_run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run.d.ts","sourceRoot":"","sources":["../../../src/tools/default/get_actor_run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AASlE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAmCtB,CAAC"}
+{"version":3,"file":"get_actor_run.d.ts","sourceRoot":"","sources":["../../../src/tools/default/get_actor_run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAUlE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAuBtB,CAAC"}

package/dist/tools/default/get_actor_run.js

@@ -1,7 +1,5 @@
-import { TOOL_STATUS } from '../../const.js';
 import { logHttpError } from '../../utils/logging.js';
-import { buildMCPResponse, buildUsageMeta } from '../../utils/mcp.js';
-import { fetchActorRunData, getActorRunArgs, getActorRunMetadata, } from '../core/get_actor_run_common.js';
+import { buildGetActorRunError, buildGetActorRunSuccessResponse, fetchActorRunData, getActorRunArgs, getActorRunMetadata, } from '../core/get_actor_run_common.js';
 /**
  * Default mode get-actor-run tool.
  * Returns full JSON dump of the run without widget metadata.
@@ -20,22 +18,11 @@ export const defaultGetActorRun = Object.freeze({
             if ('error' in fetchResult) {
                 return fetchResult.error;
             }
-            const { run, structuredContent } = fetchResult.result;
-            const texts = [`# Actor Run Information\n\`\`\`json\n${JSON.stringify(run)}\n\`\`\``];
-            return buildMCPResponse({
-                texts,
-                structuredContent,
-                _meta: buildUsageMeta(run),
-            });
+            return buildGetActorRunSuccessResponse({ ...fetchResult.result, widget: false });
         }
         catch (error) {
             logHttpError(error, 'Failed to get Actor run', { runId: parsed.runId });
-            return buildMCPResponse({
-                texts: [`Failed to get Actor run '${parsed.runId}': ${error instanceof Error ? error.message : String(error)}.
-Please verify the run ID and ensure that the run exists.`],
-                isError: true,
-                telemetry: { toolStatus: TOOL_STATUS.SOFT_FAIL },
-            });
+            return buildGetActorRunError(parsed.runId, error);
         }
     },
 });