@apify/actors-mcp-server 0.19.4-beta.0 → 0.19.4-beta.2

package/dist/tools/actors/send_server_actor_request.js

@@ -0,0 +1,425 @@
+import Ajv from 'ajv';
+import dedent from 'dedent';
+import { z } from 'zod';
+import { readBodyUnderCap, sendApifyApiRequest } from '../../apify_client.js';
+import { FAILURE_CATEGORY, HELPER_TOOLS, HTTP_FORBIDDEN, HTTP_UNAUTHORIZED, MAX_INLINE_BYTES } from '../../const.js';
+import { getActorMCPServerPath, resolveOnStandbyOrigin } from '../../mcp/actors.js';
+import { EXTERNAL_TOOL_CALL_TIMEOUT_MSEC } from '../../mcp/const.js';
+import { isTextualMimeType, maskSessionToken, parseCharset, REDACTED } from '../../resources/api_resources.js';
+import { ALL_TOOLS_PRESENT, TOOL_TYPE } from '../../types.js';
+import { getActorDefinitionCached } from '../../utils/actor.js';
+import { fixZodSchemaRequired } from '../../utils/ajv.js';
+import { toPlainError } from '../../utils/logging.js';
+import { respondAborted, respondOk, respondServerError, respondUserError } from '../../utils/mcp.js';
+import { resolveActorInterfaces, resolveActorTenancy } from '../actor_tool_naming.js';
+import { apiCallArgsShape, redactApiCallArgs } from '../api/apify_api_request.js';
+import { API_METHODS, isRecord } from '../api/apify_api_spec.js';
+import { parseBaseMimeType } from '../storage/storage_helpers.js';
+import { anyJsonValueSchema, serverActorRequestOutputSchema } from '../structured_output_schemas.js';
+import { fixActorNameInputAndLog } from './actor_tools_factory.js';
+import { buildActorNotFoundResponse } from './fetch_actor_details.js';
+const sendServerActorRequestArgs = z.object({
+    actor: z
+        .string()
+        .min(1)
+        .describe('The Actor: its ID, or its name in the "username/name" form, such as "apify/web-fetch".'),
+    method: z
+        .enum(API_METHODS)
+        .describe('HTTP method: GET, POST, PUT, PATCH, or DELETE. The Actor accepts or rejects it.'),
+    path: z.string().min(1).describe(dedent `
+            The path of an operation in the Actor API schema, starting with /. Take it from the schema; do not guess it.
+            A query string written into the path is sent too.
+        `),
+    query: apiCallArgsShape.query.describe('Query parameters, by name, for example {"limit": 10, "verbose": true}; a boolean is sent as true or ' +
+        'false. Added to a query string in the path.'),
+    body: z.unknown().optional().describe('The JSON request body, sent as application/json. Not allowed with GET.'),
+});
+/** The request may have gone out, but its response did not fully arrive; `status` is set when the headers did. */
+class IncompleteResponseError extends Error {
+    constructor(message, status, isTimeout) {
+        super(message);
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: status
+        });
+        Object.defineProperty(this, "isTimeout", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: isTimeout
+        });
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'IncompleteResponseError'
+        });
+    }
+}
+function buildNoServerInterfaceText(actorName, interfaces, loadedToolNames) {
+    const text = `Actor '${actorName}' has no Actor Server with an API schema, and this tool sends requests only to ` +
+        'such Actors. Its README describes how to use it.';
+    if (!loadedToolNames.includes(HELPER_TOOLS.ACTOR_CALL))
+        return text;
+    if (interfaces.mcp) {
+        return `${text} Its MCP tools can be called with ${HELPER_TOOLS.ACTOR_CALL} as "${actorName}:toolName".`;
+    }
+    if (interfaces.input)
+        return `${text} It can be run from an input with ${HELPER_TOOLS.ACTOR_CALL}.`;
+    return text;
+}
+/**
+ * The URL of `path` on the Actor's standby origin, with `query` added after a query written into the path, or
+ * the error response when the request cannot be sent there.
+ */
+function buildRequestUrl(actor, actorName, { path, query }) {
+    const resolved = resolveOnStandbyOrigin(actor, path);
+    if (!resolved) {
+        return {
+            error: respondServerError(`Actor '${actorName}' has no valid Actor Server URL. The request was not sent.`),
+        };
+    }
+    // Unlike the MCP URL, a path with credentials is refused rather than stripped: the agent wrote them.
+    const { url, standbyOrigin } = resolved;
+    if (!url || url.username || url.password) {
+        return {
+            error: respondUserError(`The path must be a valid path on the Actor Server at ${standbyOrigin}, with no credentials. ` +
+                'The request was not sent.'),
+        };
+    }
+    // Not axios `params`: apify-client's serializer sends a boolean as 1 or 0. Not `url.searchParams`: it would
+    // encode the query written into the path again.
+    const addedQuery = new URLSearchParams(Object.entries(query !== null && query !== void 0 ? query : {}).map(([name, value]) => [name, String(value)])).toString();
+    if (addedQuery)
+        url.search = url.search ? `${url.search}&${addedQuery}` : addedQuery;
+    return { url };
+}
+/** A response header's value; `undefined` when it is absent or not a single string. */
+function readHeader(headers, name) {
+    const value = headers[name];
+    return typeof value === 'string' ? value : undefined;
+}
+/**
+ * Sends the request once, without following redirects, and reads the body up to `MAX_INLINE_BYTES`. The deadline
+ * covers reading the body too. Any failure is thrown as an `IncompleteResponseError`: even a connection that drops
+ * before the status may have delivered the request.
+ */
+async function sendRequest({ client, url, method, body, signal, timeoutMillis, }) {
+    const deadline = AbortSignal.timeout(timeoutMillis);
+    let status;
+    try {
+        const response = await sendApifyApiRequest(client, {
+            url: url.href,
+            method,
+            // Bytes, not a string: apify-client compresses a string body of 1 KiB or more with brotli, which
+            // an Actor's server need not decode.
+            ...(body !== undefined && {
+                data: new TextEncoder().encode(JSON.stringify(body)),
+                headers: { 'Content-Type': 'application/json' },
+            }),
+            responseType: 'stream',
+            maxRedirects: 0,
+            signal: AbortSignal.any([signal, deadline]),
+        });
+        status = response.status;
+        return {
+            status,
+            contentType: readHeader(response.headers, 'content-type'),
+            location: readHeader(response.headers, 'location'),
+            body: await readBodyUnderCap(response),
+        };
+    }
+    catch (error) {
+        throw new IncompleteResponseError(toPlainError(error).message, status, deadline.aborted);
+    }
+}
+/**
+ * The body decoded with `charset`, the session token masked before and after decoding; `undefined` when
+ * `TextDecoder` does not support the charset. In a JSON body whose escapes hide the token, only the string
+ * literals holding it are rewritten, so numbers and formatting stay as sent.
+ */
+function decodeBody(body, charset, token) {
+    let text;
+    try {
+        text = new TextDecoder(charset).decode(maskSessionToken(body, token)).replaceAll(token, REDACTED);
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        if (!JSON.stringify(JSON.parse(text)).includes(token))
+            return text;
+    }
+    catch {
+        return text;
+    }
+    return text.replace(/"(?:[^"\\]|\\.)*"/g, (literal) => {
+        const value = JSON.parse(literal);
+        return value.includes(token) ? JSON.stringify(value.replaceAll(token, REDACTED)) : literal;
+    });
+}
+/** Longest `errorMessage` returned; the full error stays in `body`. */
+const ERROR_MESSAGE_MAX_LENGTH = 1000;
+/**
+ * The `error` string of a JSON `{"error": ...}` body, cut to `ERROR_MESSAGE_MAX_LENGTH`; `undefined` for any other
+ * body, which the response already carries as `body`.
+ */
+function getReadableErrorMessage(body) {
+    try {
+        const parsed = z.object({ error: z.string() }).safeParse(JSON.parse(body));
+        if (!parsed.success)
+            return undefined;
+        const { error } = parsed.data;
+        return error.length > ERROR_MESSAGE_MAX_LENGTH ? `${error.slice(0, ERROR_MESSAGE_MAX_LENGTH)}…` : error;
+    }
+    catch {
+        // An Actor can return plain text or malformed JSON.
+    }
+    return undefined;
+}
+/** A rejected request's recovery text lists up to this many documented operations, then counts the rest. */
+export const RECOVERY_MAX_OPERATIONS = 20;
+/** E.g. `Documented operations: GET / (required: query), POST / (required: request body). `; empty without any. */
+function formatDocumentedOperations(operations = []) {
+    if (operations.length === 0)
+        return '';
+    const listed = operations.slice(0, RECOVERY_MAX_OPERATIONS);
+    const rest = operations.length - listed.length;
+    return `Documented operations: ${listed.join(', ')}${rest > 0 ? `, and ${rest} more` : ''}. `;
+}
+function buildRequestRecoveryText({ status, actorName, loadedToolNames, hasErrorMessage, operations, }) {
+    if (status === 429)
+        return 'The Actor Server rate limit was reached.';
+    if (status === 503)
+        return 'The Actor Server is temporarily unavailable.';
+    if (![400, 404, 405, 422].includes(status))
+        return undefined;
+    // Listed here so the agent can retry without first looking the operations up.
+    const documentation = formatDocumentedOperations(operations) +
+        (loadedToolNames.includes(HELPER_TOOLS.ACTOR_GET_DETAILS)
+            ? `${HELPER_TOOLS.ACTOR_GET_DETAILS} with ${JSON.stringify({ actor: actorName, output: { serverInterface: true } })} lists the documented HTTP operations.`
+            : 'The Actor README may describe its HTTP endpoints.');
+    return hasErrorMessage
+        ? `The Actor Server error may name the expected HTTP method, path, or parameters. ${documentation}`
+        : documentation;
+}
+/** The tool response for what the Actor Server sent back, with the session token masked. */
+function buildResponse(request, response, { apifyToken: token, loadedToolNames, operations, }) {
+    var _a, _b, _c;
+    const { status } = response;
+    const contentType = (_a = response.contentType) === null || _a === void 0 ? void 0 : _a.replaceAll(token, REDACTED);
+    const location = (_b = response.location) === null || _b === void 0 ? void 0 : _b.replaceAll(token, REDACTED);
+    const outcome = `${request.method} ${request.path} on ${request.actorName} returned HTTP ${status}`;
+    // A 5xx is a failure, as an Apify API 5xx is in the API tools; any other refusal is the caller's.
+    const respondError = (texts, structuredContent) => status >= 500
+        ? respondServerError(texts, { error: { statusCode: status }, structuredContent })
+        : respondUserError(texts, {
+            ...((status === HTTP_UNAUTHORIZED || status === HTTP_FORBIDDEN) && {
+                category: FAILURE_CATEGORY.AUTH,
+            }),
+            httpStatus: status,
+            structuredContent,
+        });
+    const rejectBody = (reason) => {
+        const summary = `${outcome}. The body is not returned: ${reason}. The request itself was sent.`;
+        const structuredContent = {
+            ...request,
+            status,
+            ...(contentType && { contentType }),
+            ...(location && { location }),
+            ...(response.body !== undefined && { bytes: response.body.length }),
+            bodyOmitted: true,
+            reason,
+            summary,
+        };
+        return respondError([JSON.stringify(structuredContent), summary], structuredContent);
+    };
+    if (response.body === undefined)
+        return rejectBody(`it is larger than ${MAX_INLINE_BYTES} bytes`);
+    const bytes = response.body.length;
+    const mimeType = parseBaseMimeType(contentType);
+    if (bytes > 0 && !isTextualMimeType(mimeType)) {
+        return rejectBody(`it is ${bytes} bytes of ${mimeType !== null && mimeType !== void 0 ? mimeType : 'an unknown type'}, and only JSON, text, and XML bodies are returned`);
+    }
+    const charset = (_c = parseCharset(contentType)) !== null && _c !== void 0 ? _c : 'utf-8';
+    const body = bytes === 0 ? '' : decodeBody(response.body, charset, token);
+    if (body === undefined)
+        return rejectBody(`its charset "${charset}" is not supported`);
+    const bodyNote = bytes === 0 ? 'an empty body' : `${bytes} bytes of ${mimeType}`;
+    const redirectNote = location ? ` The redirect to ${location} was not followed.` : '';
+    const summary = `${outcome} with ${bodyNote}.${redirectNote}`;
+    const errorMessage = status >= 400 && body ? getReadableErrorMessage(body) : undefined;
+    const nextStep = buildRequestRecoveryText({
+        status,
+        actorName: request.actorName,
+        loadedToolNames,
+        hasErrorMessage: errorMessage !== undefined,
+        operations,
+    });
+    const data = {
+        ...request,
+        status,
+        ...(contentType && { contentType }),
+        body,
+        bytes,
+        ...(location && { location }),
+    };
+    const structuredContent = {
+        ...data,
+        summary,
+        ...(errorMessage && { errorMessage }),
+        ...(nextStep && { nextStep }),
+    };
+    const texts = [JSON.stringify(data), summary];
+    if (errorMessage)
+        texts.push(`Actor Server error: ${errorMessage}`);
+    if (nextStep)
+        texts.push(nextStep);
+    if (status < 400)
+        return respondOk(texts, { structuredContent });
+    return respondError(texts, structuredContent);
+}
+/** The tool response when the request went out but its response did not fully arrive. */
+function buildIncompleteResponse(request, error, timeoutMillis) {
+    const got = error.status === undefined ? 'got no complete response' : `got HTTP ${error.status} but not the whole body`;
+    const why = error.isTimeout ? `within ${timeoutMillis / 1000} seconds` : `(${error.message})`;
+    return respondServerError(`${request.method} ${request.path} on ${request.actorName} ${got} ${why}. Nothing is returned, and the ` +
+        'Actor may still have processed the request.', { detail: error.isTimeout ? 'timeout' : error.status === undefined ? 'no response' : 'incomplete body' });
+}
+/** `timeoutMillis` shortens the deadline in local tests; production keeps `EXTERNAL_TOOL_CALL_TIMEOUT_MSEC`. */
+export async function executeSendServerActorRequest(toolArgs, { timeoutMillis = EXTERNAL_TOOL_CALL_TIMEOUT_MSEC } = {}) {
+    const { apifyToken, apifyClient, mcpSessionId, loadedToolNames, signal } = toolArgs;
+    const args = sendServerActorRequestArgs.parse(toolArgs.args);
+    if (!apifyToken) {
+        return respondUserError('An Apify API token is required to send requests to an Actor Server.', {
+            category: FAILURE_CATEGORY.AUTH,
+        });
+    }
+    // The path is not echoed: it can carry the session token.
+    if (!args.path.startsWith('/'))
+        return respondUserError('The path must start with "/".');
+    if (args.method === 'GET' && args.body !== undefined) {
+        return respondUserError('A GET request cannot have a body. Send the data in query instead.');
+    }
+    const actorName = fixActorNameInputAndLog(args.actor, { mcpSessionId, route: HELPER_TOOLS.ACTOR_SERVER_REQUEST });
+    const cached = await getActorDefinitionCached(actorName, apifyClient);
+    if (!cached)
+        return buildActorNotFoundResponse(actorName, loadedToolNames);
+    const { definition, info } = cached;
+    const tenancy = resolveActorTenancy(info);
+    // Every response from here on names the Actor, and the status once one arrived, in telemetry.
+    const withActorTelemetry = (response, httpStatus) => {
+        var _a;
+        return ({
+            ...response,
+            toolTelemetry: {
+                ...response.toolTelemetry,
+                actorId: info.id,
+                // With Actor Standby off there is no tenancy; `resolveActorTenancy` would report its single-tenant default.
+                ...(((_a = info.actorStandby) === null || _a === void 0 ? void 0 : _a.isEnabled) === true && { actorTenancy: tenancy }),
+                ...(httpStatus !== undefined && { httpStatus }),
+            },
+        });
+    };
+    // Not `getActorToolResolutionCached`: it resolves the MCP URL too, and a bad MCP path must not stop an HTTP request.
+    const interfaces = resolveActorInterfaces({
+        definition,
+        actor: info,
+        webServerMcpPath: getActorMCPServerPath(definition),
+    });
+    if (!interfaces.server) {
+        return withActorTelemetry(respondUserError(buildNoServerInterfaceText(definition.actorFullName, interfaces, loadedToolNames)));
+    }
+    const target = buildRequestUrl(info, definition.actorFullName, args);
+    if ('error' in target)
+        return withActorTelemetry(target.error);
+    const { url } = target;
+    const request = {
+        actorId: info.id,
+        actorName: definition.actorFullName,
+        interface: 'server',
+        tenancy,
+        method: args.method,
+        path: `${url.pathname}${url.search}`.replaceAll(apifyToken, REDACTED),
+    };
+    try {
+        const response = await sendRequest({
+            client: apifyClient,
+            url,
+            method: args.method,
+            body: args.body,
+            signal,
+            timeoutMillis,
+        });
+        return withActorTelemetry(buildResponse(request, response, {
+            apifyToken,
+            loadedToolNames,
+            operations: definition.webServerOperations,
+        }), response.status);
+    }
+    catch (error) {
+        if (signal.aborted)
+            return respondAborted();
+        if (!(error instanceof IncompleteResponseError))
+            throw error;
+        return withActorTelemetry(buildIncompleteResponse(request, error, timeoutMillis), error.status);
+    }
+}
+function buildDescription({ hasTool }) {
+    const details = hasTool(HELPER_TOOLS.ACTOR_GET_DETAILS)
+        ? ` ${HELPER_TOOLS.ACTOR_GET_DETAILS} with output.serverInterface lists the documented operations.`
+        : '';
+    return dedent `
+        Send one HTTP request to an Actor Server: the HTTP API of a Server Actor, documented in its API schema (OpenAPI) and README.${details}
+        Give the method, the path, and optionally query parameters and a JSON body; the Actor Server's host and your Apify API token are added for you.
+        Only an Actor with an Actor Server and an API schema takes requests here; the Actor accepts or rejects the method and path.
+        A request to a single-tenant Actor Server can start a run of the Actor in your account, kept until its idle timeout; a multi-tenant Actor Server charges per event.
+        The request is sent once, with no retries and without following redirects. A JSON, text, or XML response body is returned as text; other content types, and bodies over ${MAX_INLINE_BYTES} bytes, are not returned.
+
+        Example call: {"actor": "apify/web-search", "method": "GET", "path": "/", "query": {"query": "AI news", "maxResults": 5}}
+
+        USAGE:
+        - Use when the Actor that fits the user's request has an Actor Server, and its API schema or README names the endpoint for the task.
+        - Fits requests for one or a few results returned in the HTTP response. Larger batches depend on the endpoint and the response size and time limits.
+
+        USAGE EXAMPLES:
+        - user_input: Search the web for the latest AI news with apify/web-search
+        - user_input: Find articles about Apify from the past week with apify/web-search
+        - user_input: Get the content of https://example.com with apify/web-fetch
+    `;
+}
+/** Sends one HTTP request to a Server Actor's API, the server interface its `webServerSchema` documents. */
+export const sendServerActorRequest = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.ACTOR_SERVER_REQUEST,
+    title: 'Send Server Actor request',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    // Advertise explicit JSON types without letting AJV coerce the body, as apify-api-write does.
+    inputSchema: z.toJSONSchema(sendServerActorRequestArgs.extend({ body: sendServerActorRequestArgs.shape.body.meta(anyJsonValueSchema) })),
+    outputSchema: serverActorRequestOutputSchema,
+    // The shared validator coerces null and singleton arrays into scalar query values.
+    ajvValidate: new Ajv({ coerceTypes: false, strict: false, removeAdditional: true }).compile(fixZodSchemaRequired(z.toJSONSchema(sendServerActorRequestArgs))),
+    // A third-party payment provider cannot pay for an Actor Server run, so such a session is rejected before the call.
+    hasPaymentProviderStandbyCheck: true,
+    annotations: {
+        title: 'Send Server Actor request',
+        readOnlyHint: false,
+        // The agent can send DELETE, PUT, or PATCH to third-party code.
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    // The body can carry secrets, and an Actor Server can take a credential under any query name.
+    redactArgs: ({ actor, query, ...rest }) => ({
+        actor,
+        ...redactApiCallArgs(rest),
+        ...(query !== undefined && {
+            query: isRecord(query) ? Object.fromEntries(Object.keys(query).map((name) => [name, REDACTED])) : REDACTED,
+        }),
+    }),
+    call: async (toolArgs) => executeSendServerActorRequest(toolArgs),
+});
+//# sourceMappingURL=send_server_actor_request.js.map

package/dist/tools/actors/send_server_actor_request.js.map

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

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

@@ -0,0 +1,31 @@
+import type { Actor } from '../../types.js';
+/**
+ * Each operation with its required inputs, e.g.
+ * `['GET / (required: query)', 'POST / (required: request body)', 'GET /status']`.
+ */
+export declare function listDocumentedOperations(schema: unknown): string[];
+/**
+ * The server-interface text of `fetch-actor-details`, by `output.serverInterface`; none for an Actor without
+ * Actor Standby unless asked for. References are not expanded or fetched, and the schema's `servers` are not used.
+ * - `false`: one summary line with the tenancy and the operation count, naming the operations while few and short;
+ *   none in a session without `send-server-actor-request`.
+ * - `true`: the operation list, plus the creator-written schema as is when the text fits `MAX_INLINE_BYTES`.
+ * - `"GET /search"`: one operation excerpt with inherited parameters and the root schema/security context.
+ * - `"#/components/schemas/Search"`: the raw node at that local JSON pointer.
+ * The send-tool example becomes the Actor's base URL without the send tool or in agentic payment mode.
+ * An unknown selection, or a selected text over the byte cap, is an error.
+ */
+export declare function buildServerInterfaceText({ actor, actorFullName, schema, serverInterface, loadedToolNames, hasPaymentProvider, }: {
+    actor: Pick<Actor, 'actorStandby' | 'standbyUrl'>;
+    actorFullName: string;
+    schema: unknown;
+    serverInterface: boolean | string;
+    loadedToolNames: readonly string[];
+    /** An agentic payment provider (x402, Skyfire) cannot pay for an Actor Server request. */
+    hasPaymentProvider: boolean;
+}): {
+    text?: string;
+} | {
+    error: string;
+};
+//# sourceMappingURL=server_interface_schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server_interface_schema.d.ts","sourceRoot":"","sources":["../../../src/tools/actors/server_interface_schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAyE5C;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAMlE;AAkCD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,EACrC,KAAK,EACL,aAAa,EACb,MAAM,EACN,eAAe,EACf,eAAe,EACf,kBAAkB,GACrB,EAAE;IACC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0FAA0F;IAC1F,kBAAkB,EAAE,OAAO,CAAC;CAC/B,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAgExC"}