@apify/actors-mcp-server 0.11.7-beta.1 → 0.11.7-beta.11

package/dist/mcp/tool_call_error_mapper.js

@@ -0,0 +1,59 @@
+import { FAILURE_CATEGORY, TOOL_STATUS } from '../const.js';
+import { isPermissionApprovalError } from '../utils/apify_errors.js';
+import { getHttpStatusCode } from '../utils/logging.js';
+import { getToolCallErrorUserText } from '../utils/mcp.js';
+import { buildPaymentRequiredResponse, buildPermissionApprovalResponse, isX402PaymentRequiredError, } from '../utils/payment_errors.js';
+import { classifyFailureCategory, getToolStatusFromError } from '../utils/tool_status.js';
+import { buildActorFields } from '../utils/tools.js';
+/** Discriminants of `ToolCallErrorResult` — reference these, never string literals. */
+export const TOOL_CALL_ERROR_KIND = {
+    PAYMENT: 'payment',
+    APPROVAL: 'approval',
+    EXECUTION: 'execution',
+};
+/**
+ * Classifies a tool-call error into a 402 payment / permission-approval / generic execution result.
+ * Pure: never throws, logs, or touches the task store. An HTTP-range-coded error — including an
+ * `McpError` with code 402 — classifies as PAYMENT, since `getHttpStatusCode` falls through to `.code`.
+ */
+export function buildToolCallErrorResult(error, params) {
+    const { toolName, actorName, actorId, isAborted } = params;
+    const httpStatus = getHttpStatusCode(error);
+    if (isX402PaymentRequiredError(error)) {
+        return {
+            kind: TOOL_CALL_ERROR_KIND.PAYMENT,
+            toolStatus: TOOL_STATUS.SOFT_FAIL,
+            callDiagnostics: {
+                failure_category: FAILURE_CATEGORY.INVALID_INPUT,
+                failure_http_status: 402,
+                ...buildActorFields(actorName, actorId),
+            },
+            response: buildPaymentRequiredResponse(error),
+        };
+    }
+    if (isPermissionApprovalError(error)) {
+        return {
+            kind: TOOL_CALL_ERROR_KIND.APPROVAL,
+            toolStatus: TOOL_STATUS.SOFT_FAIL,
+            callDiagnostics: {
+                failure_category: FAILURE_CATEGORY.PERMISSION_APPROVAL_REQUIRED,
+                failure_http_status: error.statusCode,
+                ...buildActorFields(actorName, actorId),
+            },
+            response: buildPermissionApprovalResponse(error),
+        };
+    }
+    const failureDetail = error instanceof Error ? error.message.slice(0, 200) : String(error).slice(0, 200);
+    return {
+        kind: TOOL_CALL_ERROR_KIND.EXECUTION,
+        toolStatus: getToolStatusFromError(error, isAborted),
+        callDiagnostics: {
+            failure_category: classifyFailureCategory(error),
+            ...(httpStatus !== undefined ? { failure_http_status: httpStatus } : {}),
+            failure_detail: failureDetail,
+            ...buildActorFields(actorName, actorId),
+        },
+        userText: getToolCallErrorUserText(toolName, error),
+    };
+}
+//# sourceMappingURL=tool_call_error_mapper.js.map

package/dist/mcp/tool_call_error_mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_call_error_mapper.js","sourceRoot":"","sources":["../../src/mcp/tool_call_error_mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EACH,4BAA4B,EAC5B,+BAA+B,EAC/B,0BAA0B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAUrD,uFAAuF;AACvF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;CAChB,CAAC;AAyBX;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAE,MAA2B;IAChF,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC3D,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAE5C,IAAI,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO;YACH,IAAI,EAAE,oBAAoB,CAAC,OAAO;YAClC,UAAU,EAAE,WAAW,CAAC,SAAS;YACjC,eAAe,EAAE;gBACb,gBAAgB,EAAE,gBAAgB,CAAC,aAAa;gBAChD,mBAAmB,EAAE,GAAG;gBACxB,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC;aAC1C;YACD,QAAQ,EAAE,4BAA4B,CAAC,KAAK,CAAC;SAChD,CAAC;IACN,CAAC;IAED,IAAI,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACH,IAAI,EAAE,oBAAoB,CAAC,QAAQ;YACnC,UAAU,EAAE,WAAW,CAAC,SAAS;YACjC,eAAe,EAAE;gBACb,gBAAgB,EAAE,gBAAgB,CAAC,4BAA4B;gBAC/D,mBAAmB,EAAE,KAAK,CAAC,UAAU;gBACrC,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC;aAC1C;YACD,QAAQ,EAAE,+BAA+B,CAAC,KAAK,CAAC;SACnD,CAAC;IACN,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzG,OAAO;QACH,IAAI,EAAE,oBAAoB,CAAC,SAAS;QACpC,UAAU,EAAE,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC;QACpD,eAAe,EAAE;YACb,gBAAgB,EAAE,uBAAuB,CAAC,KAAK,CAAC;YAChD,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,cAAc,EAAE,aAAa;YAC7B,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC;SAC1C;QACD,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,EAAE,KAAK,CAAC;KACtD,CAAC;AACN,CAAC"}

package/dist/mcp/tool_call_telemetry.d.ts

@@ -0,0 +1,37 @@
+import type { CallDiagnostics, ToolCallTelemetryProperties, ToolStatus } from '../types.js';
+import type { ActorsMcpServer } from './server.js';
+type PrepareTelemetryDataParams = {
+    toolName: string;
+    mcpSessionId: string | undefined;
+    apifyToken: string;
+    apifyMcpServer: ActorsMcpServer;
+};
+/**
+ * Creates telemetry data for a tool call.
+ */
+export declare function prepareTelemetryData(params: PrepareTelemetryDataParams): Promise<{
+    telemetryData: ToolCallTelemetryProperties | null;
+    userId: string | null;
+}>;
+/**
+ * Logs tool call completion at INFO level and tracks telemetry.
+ * Computes duration once so both the log line and telemetry event use the same value.
+ * Response bytes and resource ids are derived here from the raw `result` (+ `args`) so every
+ * call site stays a plain hand-off — no path can forget to compute or strip them.
+ */
+type LogToolCallAndTelemetryParams = {
+    toolName: string;
+    mcpSessionId: string | undefined;
+    toolStatus: ToolStatus;
+    startTime: number;
+    taskId?: string;
+    telemetryData: ToolCallTelemetryProperties | null;
+    userId: string | null;
+    callDiagnostics?: CallDiagnostics;
+    args?: Record<string, unknown>;
+    result?: unknown;
+    apifyMcpServer: ActorsMcpServer;
+};
+export declare function logToolCallAndTelemetry(params: LogToolCallAndTelemetryParams): void;
+export {};
+//# sourceMappingURL=tool_call_telemetry.d.ts.map

package/dist/mcp/tool_call_telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_call_telemetry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool_call_telemetry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,2BAA2B,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,KAAK,0BAA0B,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,0BAA0B,GACnC,OAAO,CAAC;IAAE,aAAa,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA8BvF;AAED;;;;;GAKG;AACH,KAAK,6BAA6B,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAClD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,6BAA6B,GAAG,IAAI,CAmDnF"}

package/dist/mcp/tool_call_telemetry.js

@@ -0,0 +1,85 @@
+import log from '@apify/log';
+import { ApifyClient } from '../apify_client.js';
+import { HELPER_TOOLS, TOOL_STATUS } from '../const.js';
+import { buildReportedProblemProperties, trackReportedProblem, trackToolCall } from '../telemetry.js';
+import { computeToolResponseBytes } from '../utils/mcp.js';
+import { deriveResourceIds } from '../utils/tool_status.js';
+import { getUserInfoCached } from '../utils/userid_cache.js';
+import { getPackageVersion } from '../utils/version.js';
+/**
+ * Creates telemetry data for a tool call.
+ */
+export async function prepareTelemetryData(params) {
+    var _a, _b, _c, _d, _e;
+    const { toolName, mcpSessionId, apifyToken, apifyMcpServer } = params;
+    if (!apifyMcpServer.telemetryEnabled) {
+        return { telemetryData: null, userId: null };
+    }
+    // Get userId from cache or fetch from API
+    let userId = null;
+    if (apifyToken) {
+        const apifyClient = new ApifyClient({ token: apifyToken });
+        ({ userId } = await getUserInfoCached(apifyToken, apifyClient));
+        log.debug('Telemetry: fetched userId', { userId, mcpSessionId });
+    }
+    const capabilities = (_b = (_a = apifyMcpServer.options.initializeRequestData) === null || _a === void 0 ? void 0 : _a.params) === null || _b === void 0 ? void 0 : _b.capabilities;
+    const initializeParams = (_c = apifyMcpServer.options.initializeRequestData) === null || _c === void 0 ? void 0 : _c.params;
+    const telemetryData = {
+        app: 'mcp',
+        app_version: getPackageVersion() || '',
+        mcp_client_name: ((_d = initializeParams === null || initializeParams === void 0 ? void 0 : initializeParams.clientInfo) === null || _d === void 0 ? void 0 : _d.name) || '',
+        mcp_client_version: ((_e = initializeParams === null || initializeParams === void 0 ? void 0 : initializeParams.clientInfo) === null || _e === void 0 ? void 0 : _e.version) || '',
+        mcp_protocol_version: (initializeParams === null || initializeParams === void 0 ? void 0 : initializeParams.protocolVersion) || '',
+        mcp_client_capabilities: capabilities || null,
+        mcp_session_id: mcpSessionId || '',
+        transport_type: apifyMcpServer.options.transportType || '',
+        tool_name: toolName,
+        tool_status: TOOL_STATUS.SUCCEEDED, // Will be updated in finally
+        tool_exec_time_ms: 0, // Will be calculated in finally
+    };
+    return { telemetryData, userId };
+}
+export function logToolCallAndTelemetry(params) {
+    const durationMs = Date.now() - params.startTime;
+    // `result` is undefined only on short-circuit paths that never produced a payload (e.g. a
+    // cancelled task); skip byte accounting there. `null`/`{}` still measure as zero bytes.
+    const responseBytes = params.result === undefined ? undefined : computeToolResponseBytes(params.result);
+    log.info('Tool call completed', {
+        toolName: params.toolName,
+        mcpSessionId: params.mcpSessionId,
+        toolStatus: params.toolStatus,
+        durationMs,
+        ...(responseBytes !== undefined && {
+            responseContentBytes: responseBytes.contentBytes,
+            responseStructuredContentBytes: responseBytes.structuredContentBytes,
+            responseFileBytes: responseBytes.fileBytes,
+        }),
+        ...(params.taskId !== undefined && { taskId: params.taskId }),
+    });
+    if (params.telemetryData) {
+        const finalizedTelemetryData = {
+            ...params.telemetryData,
+            tool_status: params.toolStatus,
+            tool_exec_time_ms: durationMs,
+            ...(responseBytes && {
+                tool_response_content_bytes: responseBytes.contentBytes,
+                tool_response_structured_content_bytes: responseBytes.structuredContentBytes,
+                tool_response_file_bytes: responseBytes.fileBytes,
+            }),
+            // Always include actor_name/actor_id; failure-specific fields are only present when callDiagnostics has them.
+            ...params.callDiagnostics,
+            // Resource ids are read once here from the args + the tool's public output; no tool
+            // threads them back. Applied uniformly, last. See deriveResourceIds.
+            ...deriveResourceIds(params.args, params.result),
+        };
+        trackToolCall(params.userId, params.apifyMcpServer.telemetryEnv, finalizedTelemetryData);
+        // A successful report-problem call also emits a dedicated feedback event carrying the
+        // submission. A downstream Segment destination fans it out to Slack/GitHub.
+        if (params.toolName === HELPER_TOOLS.PROBLEM_REPORT &&
+            params.toolStatus === TOOL_STATUS.SUCCEEDED &&
+            params.args) {
+            trackReportedProblem(params.userId, params.apifyMcpServer.telemetryEnv, buildReportedProblemProperties(finalizedTelemetryData, params.args));
+        }
+    }
+}
+//# sourceMappingURL=tool_call_telemetry.js.map

package/dist/mcp/tool_call_telemetry.js.map

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

package/dist/mcp/tool_dispatch.d.ts

@@ -0,0 +1,49 @@
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { Notification, Request } from '@modelcontextprotocol/sdk/types.js';
+import type { ApifyClient } from '../apify_client.js';
+import type { CallDiagnostics, ToolEntry, ToolStatus } from '../types.js';
+import type { createProgressTracker } from '../utils/progress.js';
+import type { ActorsMcpServer } from './server.js';
+/**
+ * Runs a validated tool call through the single tool-type dispatch switch and returns the raw
+ * result plus derived telemetry. The exhaustive switch turns a future 4th TOOL_TYPE into a compile
+ * error (same `satisfies never` idiom as getToolFullName) instead of a silent runtime fall-through.
+ * Both the sync `CallToolRequestSchema` handler and `executeToolAndUpdateTask` call this after their
+ * own pre-dispatch validation and keep their own try/catch + buildToolCallErrorResult around it.
+ * INTERNAL and ACTOR execution errors propagate to the caller's catch; the ACTOR_MCP case keeps its
+ * own inner catch and returns a soft-fail result instead of throwing.
+ *
+ * `extractToolTelemetry` (via `applyToolTelemetry`) runs once here, in the INTERNAL and ACTOR
+ * cases, and strips `toolTelemetry` in place, so callers must not re-strip. ACTOR_MCP sets
+ * telemetry manually instead. The caller constructs `progressTracker`; dispatch consumes it and stops
+ * it in the branch `finally`. The abort source is `extra.signal`: the request signal for sync; the
+ * task caller passes a `taskExtra` whose `signal` is the cancel watcher's, so a client disconnect
+ * never cancels a task. `shouldForwardNotifications` gates only the ACTOR_MCP raw-notification
+ * forwarder (true for sync, false for task, whose originating request is already answered).
+ * `taskMode` is a passthrough to `tool.call` / `executeActorTool`, never a dispatch selector.
+ */
+export declare function dispatchToolCall(params: {
+    tool: ToolEntry;
+    toolArgs: Record<string, unknown>;
+    logSafeArgs: unknown;
+    apifyToken: string;
+    apifyClient: ApifyClient;
+    apifyMcpServer: ActorsMcpServer;
+    mcpSessionId: string | undefined;
+    progressToken: string | number | undefined;
+    progressTracker: ReturnType<typeof createProgressTracker>;
+    shouldForwardNotifications: boolean;
+    extra: RequestHandlerExtra<Request, Notification>;
+    actorName?: string;
+    actorId?: string;
+    taskMode: boolean;
+    logContext?: {
+        messageSuffix: string;
+        fields: Record<string, unknown>;
+    };
+}): Promise<{
+    result: Record<string, unknown>;
+    toolStatus: ToolStatus;
+    callDiagnostics: CallDiagnostics;
+}>;
+//# sourceMappingURL=tool_dispatch.d.ts.map

package/dist/mcp/tool_dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_dispatch.d.ts","sourceRoot":"","sources":["../../src/mcp/tool_dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAWhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,eAAe,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,eAAe,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC1D,0BAA0B,EAAE,OAAO,CAAC;IACpC,KAAK,EAAE,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAGlB,UAAU,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC3E,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE,eAAe,CAAA;CAAE,CAAC,CAqNzG"}

package/dist/mcp/tool_dispatch.js

@@ -0,0 +1,208 @@
+import { CallToolResultSchema, ErrorCode, McpError, ServerNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
+import dedent from 'dedent';
+import log from '@apify/log';
+import { FAILURE_CATEGORY, TOOL_STATUS } from '../const.js';
+import { actorExecutor } from '../tools/actors/actor_executor.js';
+import { TOOL_TYPE } from '../types.js';
+import { remoteMcpFailureDetail } from '../utils/apify_errors.js';
+import { logHttpError } from '../utils/logging.js';
+import { respondErrorNoTelemetry } from '../utils/mcp.js';
+import { applyToolTelemetry, classifyFailureCategory, getToolStatusFromError } from '../utils/tool_status.js';
+import { buildActorFields } from '../utils/tools.js';
+import { connectMCPClient } from './client.js';
+import { EXTERNAL_TOOL_CALL_TIMEOUT_MSEC } from './const.js';
+/**
+ * Runs a validated tool call through the single tool-type dispatch switch and returns the raw
+ * result plus derived telemetry. The exhaustive switch turns a future 4th TOOL_TYPE into a compile
+ * error (same `satisfies never` idiom as getToolFullName) instead of a silent runtime fall-through.
+ * Both the sync `CallToolRequestSchema` handler and `executeToolAndUpdateTask` call this after their
+ * own pre-dispatch validation and keep their own try/catch + buildToolCallErrorResult around it.
+ * INTERNAL and ACTOR execution errors propagate to the caller's catch; the ACTOR_MCP case keeps its
+ * own inner catch and returns a soft-fail result instead of throwing.
+ *
+ * `extractToolTelemetry` (via `applyToolTelemetry`) runs once here, in the INTERNAL and ACTOR
+ * cases, and strips `toolTelemetry` in place, so callers must not re-strip. ACTOR_MCP sets
+ * telemetry manually instead. The caller constructs `progressTracker`; dispatch consumes it and stops
+ * it in the branch `finally`. The abort source is `extra.signal`: the request signal for sync; the
+ * task caller passes a `taskExtra` whose `signal` is the cancel watcher's, so a client disconnect
+ * never cancels a task. `shouldForwardNotifications` gates only the ACTOR_MCP raw-notification
+ * forwarder (true for sync, false for task, whose originating request is already answered).
+ * `taskMode` is a passthrough to `tool.call` / `executeActorTool`, never a dispatch selector.
+ */
+export async function dispatchToolCall(params) {
+    var _a, _b, _c, _d;
+    const { tool, toolArgs, logSafeArgs, apifyToken, apifyClient, apifyMcpServer, mcpSessionId, progressToken, progressTracker, shouldForwardNotifications, extra, actorName, actorId, taskMode, logContext, } = params;
+    let result = {};
+    let toolStatus = TOOL_STATUS.SUCCEEDED;
+    // Always populate actor fields so they're tracked on both success and failure paths.
+    let callDiagnostics = { ...buildActorFields(actorName, actorId) };
+    switch (tool.type) {
+        case TOOL_TYPE.INTERNAL: {
+            try {
+                log.info(`Calling internal tool${(_a = logContext === null || logContext === void 0 ? void 0 : logContext.messageSuffix) !== null && _a !== void 0 ? _a : ''}`, {
+                    ...logContext === null || logContext === void 0 ? void 0 : logContext.fields,
+                    toolName: tool.name,
+                    mcpSessionId,
+                    input: logSafeArgs,
+                });
+                const res = (await tool.call({
+                    args: toolArgs,
+                    extra,
+                    apifyMcpServer,
+                    mcpServer: apifyMcpServer.server,
+                    apifyToken,
+                    apifyClient,
+                    progressTracker,
+                    mcpSessionId,
+                    taskMode,
+                }));
+                // Extract diagnostics and strip internal fields from res before returning to client.
+                ({ toolStatus, callDiagnostics } = applyToolTelemetry(res, actorName, actorId, callDiagnostics));
+                result = res;
+            }
+            finally {
+                progressTracker === null || progressTracker === void 0 ? void 0 : progressTracker.stop();
+            }
+            break;
+        }
+        case TOOL_TYPE.ACTOR_MCP: {
+            // This case never throws: connect/exec failures resolve to a soft-fail `result`
+            // (isError body) below instead. As a task, that means the outer completeTask
+            // stores it via the 'completed' path (isError body) — deliberately matching sync's
+            // own soft-fail semantics, unlike ACTOR/INTERNAL, whose thrown errors land in the
+            // task caller's 'failed' path.
+            let client = null;
+            try {
+                client = await connectMCPClient(tool.serverUrl, apifyToken, mcpSessionId);
+                if (!client) {
+                    const msg = dedent `
+                        Failed to connect to MCP server at "${tool.serverUrl}".
+                        Please verify the server URL is correct and accessible, and ensure you have a valid Apify token with appropriate permissions.
+                    `;
+                    log.softFail(msg, { mcpSessionId, failureCategory: FAILURE_CATEGORY.INTERNAL_ERROR });
+                    await apifyMcpServer.server.sendLoggingMessage({ level: 'error', data: msg });
+                    toolStatus = TOOL_STATUS.SOFT_FAIL;
+                    callDiagnostics = { ...callDiagnostics, failure_category: FAILURE_CATEGORY.INTERNAL_ERROR };
+                    result = respondErrorNoTelemetry(msg);
+                    break;
+                }
+                // Only set up notification handlers if progressToken is provided by the client.
+                // Gated off for tasks (shouldForwardNotifications=false): the originating request is
+                // already answered, so forwarding against its progressToken would misroute.
+                if (shouldForwardNotifications && progressToken !== undefined && progressToken !== null) {
+                    // Set up notification handlers for the client
+                    for (const schema of ServerNotificationSchema.options) {
+                        const method = schema.shape.method.value;
+                        // Forward notifications from the proxy client to the server
+                        client.setNotificationHandler(schema, async (notification) => {
+                            log.debug('Sending MCP notification', {
+                                method,
+                                mcpSessionId,
+                                notification,
+                            });
+                            await extra.sendNotification(notification);
+                        });
+                    }
+                }
+                log.info(`Calling Actor-MCP${(_b = logContext === null || logContext === void 0 ? void 0 : logContext.messageSuffix) !== null && _b !== void 0 ? _b : ''}`, {
+                    ...logContext === null || logContext === void 0 ? void 0 : logContext.fields,
+                    toolName: tool.name,
+                    actorMcpToolName: tool.originToolName,
+                    actorId: tool.actorId,
+                    mcpSessionId,
+                    input: logSafeArgs,
+                });
+                const res = await client.callTool({
+                    name: tool.originToolName,
+                    arguments: toolArgs,
+                    // Without forwarding there is no route back for remote progress — don't
+                    // hand the remote a token nobody listens to.
+                    ...(shouldForwardNotifications ? { _meta: { progressToken } } : {}),
+                }, CallToolResultSchema, {
+                    timeout: EXTERNAL_TOOL_CALL_TIMEOUT_MSEC,
+                });
+                // TODO: actor-mcp responses are opaque — isError could be a user input problem
+                // (e.g. invalid query) or a genuine server failure. We can't distinguish without
+                // parsing the error text. Defaulting to INTERNAL_ERROR for now; revisit when
+                // actor-mcp gets deeper telemetry treatment.
+                if ('isError' in res && res.isError) {
+                    toolStatus = TOOL_STATUS.SOFT_FAIL;
+                    callDiagnostics = {
+                        failure_category: FAILURE_CATEGORY.INTERNAL_ERROR,
+                        ...buildActorFields(actorName, actorId),
+                    };
+                }
+                result = { ...res };
+            }
+            catch (error) {
+                toolStatus = getToolStatusFromError(error, Boolean((_c = extra.signal) === null || _c === void 0 ? void 0 : _c.aborted));
+                const failureDetail = error instanceof Error ? error.message.slice(0, 200) : String(error).slice(0, 200);
+                callDiagnostics = {
+                    failure_category: classifyFailureCategory(error),
+                    failure_detail: failureDetail,
+                    ...buildActorFields(actorName, actorId),
+                };
+                logHttpError(error, `Failed to call MCP tool '${tool.originToolName}' on Actor '${tool.actorId}'`, {
+                    actorId: tool.actorId,
+                    toolName: tool.originToolName,
+                    failureCategory: callDiagnostics.failure_category,
+                });
+                result = respondErrorNoTelemetry(`Failed to call MCP tool '${tool.originToolName}' on Actor '${tool.actorId}': ${remoteMcpFailureDetail(error)}`);
+            }
+            finally {
+                if (client)
+                    await client.close();
+            }
+            break;
+        }
+        case TOOL_TYPE.ACTOR: {
+            try {
+                log.info(`Calling Actor${(_d = logContext === null || logContext === void 0 ? void 0 : logContext.messageSuffix) !== null && _d !== void 0 ? _d : ''}`, {
+                    ...logContext === null || logContext === void 0 ? void 0 : logContext.fields,
+                    toolName: tool.name,
+                    actorName: tool.actorFullName,
+                    mcpSessionId,
+                    input: logSafeArgs,
+                });
+                const executorResult = await actorExecutor.executeActorTool({
+                    actorFullName: tool.actorFullName,
+                    input: toolArgs,
+                    apifyClient,
+                    callOptions: { memory: tool.memoryMbytes },
+                    progressTracker,
+                    abortSignal: extra.signal,
+                    mcpSessionId,
+                    datasetItemsSchema: tool.datasetItemsSchema,
+                    taskMode,
+                });
+                if (!executorResult) {
+                    toolStatus = TOOL_STATUS.ABORTED;
+                    // Receivers of cancellation notifications SHOULD NOT send a response for the cancelled request
+                    // https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/cancellation#behavior-requirements
+                    result = {};
+                    break;
+                }
+                // Mirror the INTERNAL branch: read the telemetry the executor embedded on error
+                // results (e.g. respondUserError → SOFT_FAIL/INVALID_INPUT), strip it from the wire,
+                // and set failure_category so the report-problem nudge picks the softer variant.
+                ({ toolStatus, callDiagnostics } = applyToolTelemetry(executorResult, actorName, actorId, callDiagnostics));
+                result = executorResult;
+            }
+            finally {
+                if (progressTracker) {
+                    progressTracker.stop();
+                }
+            }
+            break;
+        }
+        default:
+            // Exhaustiveness guard mirroring getToolFullName: a new TOOL_TYPE member makes `tool`
+            // non-`never` here and fails `satisfies never` at compile time. Unreachable at runtime —
+            // ToolEntry is a closed 3-way union. Unlike the pre-extraction fall-through (which also
+            // listed available tools, called log.softFail, and sent a logging message before
+            // throwing), this just throws InvalidParams with no side effects.
+            throw new McpError(ErrorCode.InvalidParams, `Unknown tool type "${tool.type}"`);
+    }
+    return { result, toolStatus, callDiagnostics };
+}
+//# sourceMappingURL=tool_dispatch.js.map

package/dist/mcp/tool_dispatch.js.map

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

package/dist/payments/const.d.ts

@@ -1,5 +1,6 @@
 import { type HelperToolName } from '../const.js';
 export declare const PAYMENT_PROTOCOL_HEADER = "x-apify-payment-protocol";
+export declare const SKYFIRE_PAY_ID_KEY = "skyfire-pay-id";
 export declare const SKYFIRE_TOOL_INSTRUCTIONS: string;
 export declare const SKYFIRE_PAY_ID_PROPERTY_DESCRIPTION = "Skyfire PAY JWT token used for billing purposes. This must be the JWT token string returned by the create-pay-token tool (starts with \"ey\"), NOT a token ID or UUID.";
 export declare const SKYFIRE_README_CONTENT: string;

package/dist/payments/const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/payments/const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAKlE,eAAO,MAAM,yBAAyB,QAAi2B,CAAC;AAEx4B,eAAO,MAAM,mCAAmC,2KAAyK,CAAC;AAE1N,eAAO,MAAM,sBAAsB,QAAs8B,CAAC;AAE1+B;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAWhC,CAAC"}
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/payments/const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAKlE,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,eAAO,MAAM,yBAAyB,QAAi2B,CAAC;AAEx4B,eAAO,MAAM,mCAAmC,2KAAyK,CAAC;AAE1N,eAAO,MAAM,sBAAsB,QAAs8B,CAAC;AAE1+B;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAWhC,CAAC"}

package/dist/payments/const.js

@@ -2,6 +2,7 @@ import { HELPER_TOOLS } from '../const.js';
 export const PAYMENT_PROTOCOL_HEADER = 'x-apify-payment-protocol';
 const SKYFIRE_MIN_CHARGE_USD = 5.0;
 const SKYFIRE_SELLER_ID = process.env.SKYFIRE_SELLER_SERVICE_ID;
+export const SKYFIRE_PAY_ID_KEY = 'skyfire-pay-id';
 export const SKYFIRE_TOOL_INSTRUCTIONS = `To run the Actor, you need to provide a Skyfire PAY JWT token in the \`skyfire-pay-id\` input property. You first need to create the Skyfire PAY token by calling the \`create-pay-token\` tool from the Skyfire MCP server and then provide the created JWT token in the \`skyfire-pay-id\` input property when calling Actor tool. IMPORTANT: The value you pass to \`skyfire-pay-id\` must be the JWT token string itself (it starts with "ey"), NOT an ID or UUID. The Skyfire PAY token is used for billing purposes and needs to be charged with at least ${SKYFIRE_MIN_CHARGE_USD} USD.${SKYFIRE_SELLER_ID ? ` The Skyfire seller ID for Apify MCP server is "${SKYFIRE_SELLER_ID}".` : ''} When retrieving Actor output using the \`get-dataset-items\` tool, you also need to provide the same Skyfire PAY JWT token (starting with "ey") in the \`skyfire-pay-id\` input property.`;
 export const SKYFIRE_PAY_ID_PROPERTY_DESCRIPTION = `Skyfire PAY JWT token used for billing purposes. This must be the JWT token string returned by the create-pay-token tool (starts with "ey"), NOT a token ID or UUID.`;
 export const SKYFIRE_README_CONTENT = `The Apify MCP Server allows clients to interact with Apify Actors, storage, and documentation. Before running any Apify Actor, you need to set up a Skyfire PAY token for billing purposes. To set up the PAY token you need to use the create-pay-token tool from the Skyfire MCP server. The PAY token must be charged with a minimum of ${SKYFIRE_MIN_CHARGE_USD} USD to be valid.${SKYFIRE_SELLER_ID ? ` The Skyfire seller ID for Apify MCP server is "${SKYFIRE_SELLER_ID}".` : ''} When running an Actor using the call-actor tool, you must provide the Skyfire PAY JWT token in the \`skyfire-pay-id\` input property. IMPORTANT: The value for \`skyfire-pay-id\` must be the actual JWT token string (starting with "ey") returned by the create-pay-token tool, NOT a token ID or UUID. Similarly, when retrieving Actor output using the get-dataset-items tool, you must also provide the same Skyfire PAY JWT token (starting with "ey") in the \`skyfire-pay-id\` input property.`;

package/dist/payments/const.js.map

@@ -1 +1 @@
-{"version":3,"file":"const.js","sourceRoot":"","sources":["../../src/payments/const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAElE,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;AAEhE,MAAM,CAAC,MAAM,yBAAyB,GAAG,miBAAmiB,sBAAsB,QAAQ,iBAAiB,CAAC,CAAC,CAAC,mDAAmD,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE,4LAA4L,CAAC;AAEx4B,MAAM,CAAC,MAAM,mCAAmC,GAAG,sKAAsK,CAAC;AAE1N,MAAM,CAAC,MAAM,sBAAsB,GAAG,8UAA8U,sBAAsB,oBAAoB,iBAAiB,CAAC,CAAC,CAAC,mDAAmD,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE,0eAA0e,CAAC;AAE1+B;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAiB;IACzD,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,gBAAgB;IAC7B,YAAY,CAAC,WAAW;IACxB,YAAY,CAAC,iBAAiB;IAC9B,YAAY,CAAC,kBAAkB;IAC/B,YAAY,CAAC,mBAAmB;IAChC,YAAY,CAAC,wBAAwB;IACrC,YAAY,CAAC,0BAA0B;CAC1C,CAAC,CAAC"}
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../src/payments/const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAElE,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,miBAAmiB,sBAAsB,QAAQ,iBAAiB,CAAC,CAAC,CAAC,mDAAmD,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE,4LAA4L,CAAC;AAEx4B,MAAM,CAAC,MAAM,mCAAmC,GAAG,sKAAsK,CAAC;AAE1N,MAAM,CAAC,MAAM,sBAAsB,GAAG,8UAA8U,sBAAsB,oBAAoB,iBAAiB,CAAC,CAAC,CAAC,mDAAmD,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE,0eAA0e,CAAC;AAE1+B;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAiB;IACzD,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,cAAc;IAC3B,YAAY,CAAC,gBAAgB;IAC7B,YAAY,CAAC,WAAW;IACxB,YAAY,CAAC,iBAAiB;IAC9B,YAAY,CAAC,kBAAkB;IAC/B,YAAY,CAAC,mBAAmB;IAChC,YAAY,CAAC,wBAAwB;IACrC,YAAY,CAAC,0BAA0B;CAC1C,CAAC,CAAC"}

package/dist/payments/skyfire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skyfire.d.ts","sourceRoot":"","sources":["../../src/payments/skyfire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlE;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC1D,QAAQ,CAAC,EAAE,EAAG,SAAS,CAAU;IACjC,QAAQ,CAAC,qBAAqB,QAAQ;WAEzB,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAItD,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS;IAwB9C,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAO7D,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;IAWhE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK3E,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAO3C"}
+{"version":3,"file":"skyfire.d.ts","sourceRoot":"","sources":["../../src/payments/skyfire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAU7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC1D,QAAQ,CAAC,EAAE,EAAG,SAAS,CAAU;IACjC,QAAQ,CAAC,qBAAqB,QAAQ;WAEzB,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAItD,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS;IAwB9C,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAO7D,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;IAWhE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK3E,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAO3C"}

package/dist/payments/skyfire.js

@@ -1,7 +1,6 @@
 import { redactSkyfirePayId } from '../utils/logging.js';
 import { cloneToolEntry } from '../utils/tools.js';
-import { PAYMENT_PROTOCOL_HEADER, SKYFIRE_PAY_ID_PROPERTY_DESCRIPTION, SKYFIRE_README_CONTENT, SKYFIRE_TOOL_INSTRUCTIONS, } from './const.js';
-const SKYFIRE_PAY_ID_KEY = 'skyfire-pay-id';
+import { PAYMENT_PROTOCOL_HEADER, SKYFIRE_PAY_ID_KEY, SKYFIRE_PAY_ID_PROPERTY_DESCRIPTION, SKYFIRE_README_CONTENT, SKYFIRE_TOOL_INSTRUCTIONS, } from './const.js';
 /**
  * Skyfire payment provider.
  *
@@ -70,10 +69,10 @@ export class SkyfirePaymentProvider {
         return SKYFIRE_README_CONTENT;
     }
     redactForLogging(args) {
-        // TODO: redactSkyfirePayId is still exported and used directly by the internal MCP server repo.
-        // Once the internal repo migrates to using `paymentProvider.redactForLogging()`, we should
-        // remove the standalone function and centralize the redaction logic entirely inside this provider
-        // to make it more maintainable.
+        // TODO: redactSkyfirePayId is still used directly by other in-repo callers
+        // (e.g. tools/actors/actor_executor.ts). Once those callers migrate to
+        // `paymentProvider.redactForLogging()`, remove the standalone function and
+        // centralize the redaction logic entirely inside this provider.
         return redactSkyfirePayId(args);
     }
 }

package/dist/payments/skyfire.js.map

@@ -1 +1 @@
-{"version":3,"file":"skyfire.js","sourceRoot":"","sources":["../../src/payments/skyfire.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACH,uBAAuB,EACvB,mCAAmC,EACnC,sBAAsB,EACtB,yBAAyB,GAC5B,MAAM,YAAY,CAAC;AAGpB,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IAAnC;QACa;;;;mBAAK,SAAkB;WAAC;QACxB;;;;mBAAwB,IAAI;WAAC;IAgE1C,CAAC;IA9DG,MAAM,CAAC,KAAK,CAAC,MAAM;QACf,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACxC,CAAC;IAED,kBAAkB,CAAC,IAAe;QAC9B,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAEvC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAEpC,0DAA0D;QAC1D,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;YAChF,MAAM,CAAC,WAAW,IAAI,OAAO,yBAAyB,EAAE,CAAC;QAC7D,CAAC;QAED,0DAA0D;QAC1D,IAAI,MAAM,CAAC,WAAW,IAAI,YAAY,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,UAAqC,CAAC;YACvE,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,kBAAkB,CAAC,GAAG;oBACxB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;iBACnD,CAAC;YACN,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,eAAe,CAAC,IAA6B;QACzC,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;YACzC,OAAO,qBAAqB,kBAAkB,yFAAyF,kBAAkB,IAAI,CAAC;QAClK,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,iBAAiB,CAAC,IAA6B;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACH,CAAC,kBAAkB,CAAC,EAAE,KAAK;gBAC3B,CAAC,uBAAuB,CAAC,EAAE,SAAS;aACvC,CAAC;QACN,CAAC;QACD,OAAO,EAAE,CAAC;IACd,CAAC;IAED,mBAAmB,CAAC,IAA6B;QAC7C,MAAM,EAAE,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,aAAa;QACT,OAAO,sBAAsB,CAAC;IAClC,CAAC;IAED,gBAAgB,CAAC,IAAa;QAC1B,gGAAgG;QAChG,2FAA2F;QAC3F,kGAAkG;QAClG,gCAAgC;QAChC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACJ"}
+{"version":3,"file":"skyfire.js","sourceRoot":"","sources":["../../src/payments/skyfire.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACH,uBAAuB,EACvB,kBAAkB,EAClB,mCAAmC,EACnC,sBAAsB,EACtB,yBAAyB,GAC5B,MAAM,YAAY,CAAC;AAGpB;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IAAnC;QACa;;;;mBAAK,SAAkB;WAAC;QACxB;;;;mBAAwB,IAAI;WAAC;IAgE1C,CAAC;IA9DG,MAAM,CAAC,KAAK,CAAC,MAAM;QACf,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACxC,CAAC;IAED,kBAAkB,CAAC,IAAe;QAC9B,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAEvC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAEpC,0DAA0D;QAC1D,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;YAChF,MAAM,CAAC,WAAW,IAAI,OAAO,yBAAyB,EAAE,CAAC;QAC7D,CAAC;QAED,0DAA0D;QAC1D,IAAI,MAAM,CAAC,WAAW,IAAI,YAAY,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,UAAqC,CAAC;YACvE,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,kBAAkB,CAAC,GAAG;oBACxB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;iBACnD,CAAC;YACN,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,eAAe,CAAC,IAA6B;QACzC,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;YACzC,OAAO,qBAAqB,kBAAkB,yFAAyF,kBAAkB,IAAI,CAAC;QAClK,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,iBAAiB,CAAC,IAA6B;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACH,CAAC,kBAAkB,CAAC,EAAE,KAAK;gBAC3B,CAAC,uBAAuB,CAAC,EAAE,SAAS;aACvC,CAAC;QACN,CAAC;QACD,OAAO,EAAE,CAAC;IACd,CAAC;IAED,mBAAmB,CAAC,IAA6B;QAC7C,MAAM,EAAE,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,aAAa;QACT,OAAO,sBAAsB,CAAC;IAClC,CAAC;IAED,gBAAgB,CAAC,IAAa;QAC1B,2EAA2E;QAC3E,uEAAuE;QACvE,2EAA2E;QAC3E,gEAAgE;QAChE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACJ"}

package/dist/tools/actors/call_actor.d.ts

@@ -1,4 +1,3 @@
-import type { ApifyApiError } from 'apify-client';
 import { z } from 'zod';
 import { HELPER_TOOLS } from '../../const.js';
 import type { PaymentProvider } from '../../payments/types.js';
@@ -20,8 +19,6 @@ type CallActorErrorResponseParams = {
 };
 export declare function buildCallActorDescription(): string;
 export declare function buildCallActorAppsDescription(): string;
-/** Exported for native actor tool error handling in server.ts — no logging, no telemetry. */
-export declare function buildPermissionApprovalResponse(error: ApifyApiError): ToolResponse;
 export declare function buildCallActorErrorResponse(params: CallActorErrorResponseParams): ToolResponse;
 export declare const callOptionsSchema: z.ZodObject<{
     memory: z.ZodOptional<z.ZodNumber>;

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

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

package/dist/tools/actors/call_actor.js

@@ -12,7 +12,8 @@ import { ACTOR_RUN_LIMIT_MESSAGE, isActorRunLimitError, isMemoryQuotaError, isPe
 import { getConsoleLinkContext } from '../../utils/console_link.js';
 import { wrapJsonText } from '../../utils/encode_text.js';
 import { logHttpError } from '../../utils/logging.js';
-import { respondAborted, respondErrorNoTelemetry, respondRaw, respondServerError, respondUserError, } from '../../utils/mcp.js';
+import { respondAborted, respondRaw, respondServerError, respondUserError, } from '../../utils/mcp.js';
+import { buildPermissionApprovalTexts } from '../../utils/payment_errors.js';
 import { classifyFailureCategory, extractAjvErrorDetails } from '../../utils/tool_status.js';
 import { extractActorId } from '../../utils/tools.js';
 import { actorNameToToolName, isActorBlockedUnderPaymentProvider } from '../actor_tool_naming.js';
@@ -78,16 +79,6 @@ export function buildCallActorDescription() {
 export function buildCallActorAppsDescription() {
     return buildCallActorDescriptionSections(true);
 }
-/** Text lines for a permission-approval response: the error message plus an optional approval URL. */
-function buildPermissionApprovalTexts(error) {
-    var _a;
-    const approvalUrl = typeof ((_a = error.data) === null || _a === void 0 ? void 0 : _a.approvalUrl) === 'string' ? error.data.approvalUrl : undefined;
-    return [error.message, ...(approvalUrl ? [`Approve here: ${approvalUrl}`] : [])];
-}
-/** Exported for native actor tool error handling in server.ts — no logging, no telemetry. */
-export function buildPermissionApprovalResponse(error) {
-    return respondErrorNoTelemetry(buildPermissionApprovalTexts(error));
-}
 export function buildCallActorErrorResponse(params) {
     const { actorName, error, actorId, mcpSessionId, actorGetDetailsTool } = params;
     if (isPermissionApprovalError(error)) {