@apify/actors-mcp-server 0.17.5-beta.0 → 0.17.5-beta.10

package/dist/tools/api/apify_api_search.js

@@ -0,0 +1,84 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { HELPER_TOOLS } from '../../const.js';
+import { ALL_TOOLS_PRESENT, TOOL_TYPE } from '../../types.js';
+import { compileSchema, fixZodSchemaRequired } from '../../utils/ajv.js';
+import { respondOk } from '../../utils/mcp.js';
+import { apifyApiSearchOutputSchema } from '../structured_output_schemas.js';
+import { fetchApiOperationIndex, searchApiOperations } from './apify_api_spec.js';
+const apifyApiSearchArgs = z.object({
+    query: z
+        .string()
+        .min(1)
+        .describe('Keywords for what the operation does, for example "list webhooks" or "update dataset".'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .describe('Maximum number of operations to return. Default is 10. Maximum is 20.')
+        .default(10),
+});
+function buildDescription({ hasTool }) {
+    const callTools = [
+        hasTool(HELPER_TOOLS.API_READ) && `${HELPER_TOOLS.API_READ} for a GET`,
+        hasTool(HELPER_TOOLS.API_WRITE) && `${HELPER_TOOLS.API_WRITE} for a POST, PUT, PATCH, or DELETE`,
+    ].filter(Boolean);
+    const nextSteps = [
+        hasTool(HELPER_TOOLS.API_DETAILS) &&
+            `get its parameters with ${HELPER_TOOLS.API_DETAILS} by its method and path`,
+        callTools.length > 0 && `call it with ${callTools.join(' or ')}`,
+    ].filter(Boolean);
+    const nextStepsSentence = nextSteps.length > 0 ? `\nAfter finding an operation, ${nextSteps.join(', then ')}.` : '';
+    return dedent `
+        Search the Apify API reference for operations by keywords. Returns each operation's method, path
+        template, summary, and link to the API reference.${nextStepsSentence}
+        To call an operation, fill its path template with real values: /v2/datasets/{datasetId}/items
+        becomes /v2/datasets/abc/items. A name is written username~name, or ~name for one you own, as in
+        /v2/actors/~my-actor.
+        Prefer a dedicated Apify tool when one does what the user asks.
+
+        USAGE:
+        - Use when no dedicated tool does what the user asks and the Apify API might.
+
+        USAGE EXAMPLES:
+        - user_input: Did my webhooks deliver their last calls?
+        - user_input: What is my monthly spending limit?
+    `;
+}
+/**
+ * Searches the operations of the published Apify API spec, https://docs.apify.com/api/v2.
+ */
+export const apifyApiSearch = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.API_SEARCH,
+    title: 'Search Apify API',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: fixZodSchemaRequired(z.toJSONSchema(apifyApiSearchArgs)),
+    outputSchema: apifyApiSearchOutputSchema,
+    ajvValidate: compileSchema(fixZodSchemaRequired(z.toJSONSchema(apifyApiSearchArgs))),
+    annotations: {
+        title: 'Search Apify API',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const parsed = apifyApiSearchArgs.parse(toolArgs.args);
+        const index = await fetchApiOperationIndex();
+        const operations = searchApiOperations(index, parsed.query, parsed.limit).map((operation) => ({
+            method: operation.method,
+            path: operation.path,
+            summary: operation.summary,
+            docsUrl: operation.docsUrl,
+        }));
+        const result = { operations };
+        const summary = operations.length > 0
+            ? `Found ${operations.length} API operations for "${parsed.query}".`
+            : `No API operation matches "${parsed.query}". Try other keywords.`;
+        return respondOk([JSON.stringify(result), summary], { structuredContent: result });
+    },
+});
+//# sourceMappingURL=apify_api_search.js.map

package/dist/tools/api/apify_api_search.js.map

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

package/dist/tools/api/apify_api_spec.d.ts

@@ -0,0 +1,51 @@
+import type { ApiBlockRule } from './apify_api_blocklist.js';
+export declare const APIFY_API_OPENAPI_URL = "https://docs.apify.com/api/openapi.json";
+/** HEAD is left out: it returns no body, and each HEAD operation has a GET twin. */
+export declare const API_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE"];
+export type ApiMethod = (typeof API_METHODS)[number];
+export type ApiParameter = {
+    name: string;
+    in: 'path' | 'query';
+    isRequired: boolean;
+    description?: string;
+    schema?: unknown;
+};
+export type ApiOperation = {
+    /** The spec's key for the operation. Internal: the tools find operations by method and path. */
+    operationId: string;
+    method: ApiMethod;
+    /** Path template, for example `/v2/actors/{actorId}`. */
+    path: string;
+    summary: string;
+    description: string;
+    /** The operation's page in the API reference. */
+    docsUrl: string;
+    tags: string[];
+    /** Path and query parameters; header parameters are left out, the tools never send them. */
+    parameters: ApiParameter[];
+    /** Dereferenced JSON schema of the request body; absent when the operation takes none. */
+    requestBody?: {
+        isRequired: boolean;
+        schema: unknown;
+    };
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Builds the operation index from an OpenAPI document. Deprecated operations, HEAD operations, operations a
+ * blocklist rule matches (`API_BLOCK_RULES`), and anything outside `/v2/` are left out, so no tool that reads
+ * the index offers them; malformed entries are skipped rather than failing the whole spec.
+ * It throws when the spec lists no operation.
+ */
+export declare function buildApiOperationIndex(spec: unknown, rules?: readonly ApiBlockRule[]): Map<string, ApiOperation>;
+/**
+ * The operation index, from the published spec, cached for a day. Concurrent calls share one
+ * download. A failed download throws and is not cached, and the next call tries again.
+ */
+export declare function fetchApiOperationIndex(): Promise<Map<string, ApiOperation>>;
+/**
+ * Operations matching the query's keywords, best first, scored by where each keyword is found. A verb for
+ * the method alone does not match. The description counts only for keywords no operation's name has, and
+ * only with two or more of them, since one word alone is in too many descriptions. Ties go to the shorter path.
+ */
+export declare function searchApiOperations(index: Map<string, ApiOperation>, query: string, limit: number): ApiOperation[];
+//# sourceMappingURL=apify_api_spec.d.ts.map

package/dist/tools/api/apify_api_spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apify_api_spec.d.ts","sourceRoot":"","sources":["../../../src/tools/api/apify_api_spec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,eAAO,MAAM,qBAAqB,4CAA4C,CAAC;AAE/E,oFAAoF;AACpF,eAAO,MAAM,WAAW,oDAAqD,CAAC;AAC9E,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAKrD,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,gGAAgG;IAChG,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4FAA4F;IAC5F,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,WAAW,CAAC,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1D,CAAC;AA4BF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AA6ED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAyBhH;AA0BD;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAYjF;AAmED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAoClH"}

package/dist/tools/api/apify_api_spec.js

@@ -0,0 +1,298 @@
+import { z } from 'zod';
+import { apifyApiOperationsCache } from '../../state.js';
+import { isEndpointBlocked } from './apify_api_blocklist.js';
+export const APIFY_API_OPENAPI_URL = 'https://docs.apify.com/api/openapi.json';
+/** HEAD is left out: it returns no body, and each HEAD operation has a GET twin. */
+export const API_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
+/** The API reference has one page per operation, at the operation ID in kebab case. */
+const API_DOCS_BASE_URL = 'https://docs.apify.com/api/v2';
+/** Schema keywords that only cost context. `x-*` vendor extensions are dropped by prefix in `dereference()`. */
+const DROPPED_SCHEMA_KEYS = new Set(['example', 'examples']);
+const openApiOperationValidator = z.object({
+    operationId: z.string().min(1),
+    summary: z.string().optional(),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    deprecated: z.boolean().optional(),
+    parameters: z.array(z.unknown()).optional(),
+    requestBody: z.unknown().optional(),
+});
+const openApiParameterValidator = z.object({
+    name: z.string().min(1),
+    in: z.string(),
+    required: z.boolean().optional(),
+    description: z.string().optional(),
+    schema: z.unknown().optional(),
+});
+const openApiRequestBodyValidator = z.object({
+    required: z.boolean().optional(),
+    content: z.record(z.string(), z.object({ schema: z.unknown().optional() })),
+});
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Walks a local `#/...` reference; `undefined` when it does not resolve. */
+function resolveLocalRef(spec, ref) {
+    if (!ref.startsWith('#/'))
+        return undefined;
+    let node = spec;
+    for (const segment of ref.slice(2).split('/')) {
+        if (!isRecord(node))
+            return undefined;
+        node = node[segment];
+    }
+    return node;
+}
+/**
+ * Resolves local `$ref`s and drops examples and vendor extensions. Property names under `properties`
+ * are kept as they are, since a property can be named `example`.
+ */
+function dereference(node, spec, seenRefs = new Set()) {
+    if (Array.isArray(node))
+        return node.map((item) => dereference(item, spec, seenRefs));
+    if (!isRecord(node))
+        return node;
+    if (typeof node.$ref === 'string') {
+        // A reference cycle would recurse forever; the published spec has none.
+        if (seenRefs.has(node.$ref))
+            return {};
+        return dereference(resolveLocalRef(spec, node.$ref), spec, new Set([...seenRefs, node.$ref]));
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(node)) {
+        if (DROPPED_SCHEMA_KEYS.has(key) || key.startsWith('x-'))
+            continue;
+        result[key] =
+            key === 'properties' && isRecord(value)
+                ? Object.fromEntries(Object.entries(value).map(([name, schema]) => [name, dereference(schema, spec, seenRefs)]))
+                : dereference(value, spec, seenRefs);
+    }
+    return result;
+}
+/** Lowercase words of a text, splitting camelCase, snake_case, kebab-case, and paths. */
+function splitWords(text) {
+    return text
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+}
+function parseParameters(rawParameters, spec) {
+    const parameters = [];
+    for (const rawParameter of rawParameters !== null && rawParameters !== void 0 ? rawParameters : []) {
+        const parsed = openApiParameterValidator.safeParse(dereference(rawParameter, spec));
+        if (!parsed.success)
+            continue;
+        const { name, in: location, required, description, schema } = parsed.data;
+        if (location !== 'path' && location !== 'query')
+            continue;
+        parameters.push({
+            name,
+            in: location,
+            // OpenAPI makes every path parameter required.
+            isRequired: location === 'path' || required === true,
+            ...(description && { description }),
+            ...(schema !== undefined && { schema }),
+        });
+    }
+    return parameters;
+}
+function parseRequestBody(rawRequestBody, spec) {
+    var _a, _b;
+    if (rawRequestBody === undefined)
+        return undefined;
+    const parsed = openApiRequestBodyValidator.safeParse(dereference(rawRequestBody, spec));
+    if (!parsed.success)
+        return undefined;
+    const { content, required } = parsed.data;
+    // Every body is sent as JSON; the key-value store record operations declare `*/*`.
+    const media = (_a = content['application/json']) !== null && _a !== void 0 ? _a : content['*/*'];
+    if (!media)
+        return undefined;
+    return { isRequired: required === true, schema: (_b = media.schema) !== null && _b !== void 0 ? _b : {} };
+}
+/**
+ * Builds the operation index from an OpenAPI document. Deprecated operations, HEAD operations, operations a
+ * blocklist rule matches (`API_BLOCK_RULES`), and anything outside `/v2/` are left out, so no tool that reads
+ * the index offers them; malformed entries are skipped rather than failing the whole spec.
+ * It throws when the spec lists no operation.
+ */
+export function buildApiOperationIndex(spec, rules) {
+    const index = new Map();
+    const paths = isRecord(spec) && isRecord(spec.paths) ? spec.paths : {};
+    for (const [path, pathItem] of Object.entries(paths)) {
+        if (!path.startsWith('/v2/') || !isRecord(pathItem))
+            continue;
+        for (const method of API_METHODS) {
+            const parsed = openApiOperationValidator.safeParse(pathItem[method.toLowerCase()]);
+            if (!parsed.success || parsed.data.deprecated || isEndpointBlocked(method, path, rules))
+                continue;
+            const { operationId, summary, description, tags, parameters, requestBody } = parsed.data;
+            const body = parseRequestBody(requestBody, spec);
+            index.set(operationId, {
+                operationId,
+                method,
+                path,
+                summary: summary !== null && summary !== void 0 ? summary : '',
+                description: description !== null && description !== void 0 ? description : '',
+                docsUrl: `${API_DOCS_BASE_URL}/${splitWords(operationId).join('-')}`,
+                tags: tags !== null && tags !== void 0 ? tags : [],
+                parameters: parseParameters(parameters, spec),
+                ...(body && { requestBody: body }),
+            });
+        }
+    }
+    if (index.size === 0)
+        throw new Error('the spec lists no /v2/ operations.');
+    return index;
+}
+/** How long the spec download may take; MCP clients stop waiting for a tool call after 60 seconds. */
+const SPEC_DOWNLOAD_TIMEOUT_MS = 30000;
+let pendingIndex;
+async function downloadApiOperationIndex() {
+    const failure = `Failed to load the Apify API operations from ${APIFY_API_OPENAPI_URL}`;
+    // Every session waits on this one download, so a stalled one must not hold them all.
+    const response = await fetch(APIFY_API_OPENAPI_URL, { signal: AbortSignal.timeout(SPEC_DOWNLOAD_TIMEOUT_MS) });
+    if (!response.ok)
+        throw new Error(`${failure}: HTTP ${response.status}.`);
+    let spec;
+    try {
+        spec = await response.json();
+    }
+    catch {
+        throw new Error(`${failure}: the response is not JSON.`);
+    }
+    // An index without operations is not cached.
+    try {
+        return buildApiOperationIndex(spec);
+    }
+    catch (error) {
+        throw new Error(`${failure}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * The operation index, from the published spec, cached for a day. Concurrent calls share one
+ * download. A failed download throws and is not cached, and the next call tries again.
+ */
+export async function fetchApiOperationIndex() {
+    const cached = apifyApiOperationsCache.get(APIFY_API_OPENAPI_URL);
+    if (cached)
+        return cached;
+    pendingIndex !== null && pendingIndex !== void 0 ? pendingIndex : (pendingIndex = downloadApiOperationIndex()
+        .then((index) => {
+        apifyApiOperationsCache.set(APIFY_API_OPENAPI_URL, index);
+        return index;
+    })
+        .finally(() => {
+        pendingIndex = undefined;
+    }));
+    return pendingIndex;
+}
+/** Words that tell no operation apart, such as the question words and pronouns that fill the descriptions. */
+const SEARCH_STOP_WORDS = new Set([
+    'a',
+    'all',
+    'an',
+    'and',
+    'apify',
+    'are',
+    'be',
+    'can',
+    'did',
+    'does',
+    'for',
+    'has',
+    'have',
+    'how',
+    'in',
+    'is',
+    'its',
+    'my',
+    'of',
+    'on',
+    'or',
+    'that',
+    'the',
+    'this',
+    'to',
+    'what',
+    'where',
+    'which',
+    'who',
+    'why',
+    'with',
+    'you',
+    'your',
+]);
+/** Verbs for what each method does, so a verb the summary does not use, such as rename, still counts. */
+const METHOD_VERBS = {
+    GET: ['get', 'list', 'read'],
+    POST: ['add', 'create', 'push', 'start'],
+    PUT: ['update', 'set', 'rename', 'change'],
+    PATCH: ['update', 'patch', 'change'],
+    DELETE: ['delete', 'remove'],
+};
+/** A prefix match, or the plural of a word, so `env` finds `environment` and `runs` finds `run`. */
+function hasMatchingWord(term, words) {
+    return words.some((word) => word.startsWith(term) || term === `${word}s`);
+}
+/** The same word, or its plural or singular: a prefix match finds too many words in prose, such as endpoint for end. */
+function hasWholeWord(term, words) {
+    return words.some((word) => word === term || word === `${term}s` || term === `${word}s`);
+}
+/**
+ * Paths that reach a run's own copy of a resource: the default storages and actions of a run or of the
+ * last run, and the synchronous runs. A plain ask such as "add items to a dataset" means the storage
+ * itself, so these rank lower unless the query is about runs or tasks.
+ */
+const RUN_SCOPED_PATH_REGEX = /^\/v2\/actor-runs\/\{runId\}\/|\/runs\/last\/|\/run-sync/;
+const RUN_SCOPE_TERMS = new Set(['run', 'runs', 'last', 'task', 'tasks', 'sync']);
+const RUN_SCOPED_PENALTY = 2;
+/**
+ * Operations matching the query's keywords, best first, scored by where each keyword is found. A verb for
+ * the method alone does not match. The description counts only for keywords no operation's name has, and
+ * only with two or more of them, since one word alone is in too many descriptions. Ties go to the shorter path.
+ */
+export function searchApiOperations(index, query, limit) {
+    // One-letter terms, such as the s of "run's", match too many words.
+    const terms = [...new Set(splitWords(query))].filter((term) => term.length > 1 && !SEARCH_STOP_WORDS.has(term));
+    const isAboutRuns = terms.some((term) => RUN_SCOPE_TERMS.has(term));
+    const nameWords = [...index.values()].flatMap((operation) => splitWords(`${operation.summary} ${operation.operationId} ${operation.path} ${operation.tags.join(' ')}`));
+    // A keyword a name has is left to the names: a description also lists fields, such as the
+    // maxMonthlyUsageUsd of Update limits, which would rank that operation above Get limits.
+    const descriptionTerms = terms.filter((term) => !hasMatchingWord(term, nameWords));
+    const scored = [];
+    for (const operation of index.values()) {
+        const summaryWords = splitWords(operation.summary);
+        const idWords = splitWords(`${operation.operationId} ${operation.path}`);
+        const tagWords = splitWords(operation.tags.join(' '));
+        const descriptionWords = splitWords(operation.description);
+        const verbs = METHOD_VERBS[operation.method];
+        let score = 0;
+        let verbScore = 0;
+        let descriptionHits = 0;
+        for (const term of terms) {
+            if (hasMatchingWord(term, summaryWords))
+                score += 3;
+            else if (hasMatchingWord(term, idWords))
+                score += 2;
+            else if (hasMatchingWord(term, tagWords))
+                score += 1;
+            else if (verbs.includes(term))
+                verbScore += 2;
+            else if (descriptionTerms.includes(term) && hasWholeWord(term, descriptionWords))
+                descriptionHits += 1;
+        }
+        if (descriptionHits >= 2)
+            score += 2 * descriptionHits;
+        if (score === 0)
+            continue;
+        const penalty = !isAboutRuns && RUN_SCOPED_PATH_REGEX.test(operation.path) ? RUN_SCOPED_PENALTY : 0;
+        scored.push({ operation, score: score + verbScore - penalty });
+    }
+    return scored
+        .sort((a, b) => b.score - a.score || a.operation.path.length - b.operation.path.length)
+        .slice(0, limit)
+        .map(({ operation }) => operation);
+}
+//# sourceMappingURL=apify_api_spec.js.map

package/dist/tools/api/apify_api_spec.js.map

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

package/dist/tools/api/apify_api_write.d.ts

@@ -0,0 +1,6 @@
+import type { ToolEntry } from '../../types.js';
+/**
+ * Sends a POST, PUT, PATCH, or DELETE to a path of the Apify API, https://docs.apify.com/api/v2, as a proxy.
+ */
+export declare const apifyApiWrite: ToolEntry;
+//# sourceMappingURL=apify_api_write.d.ts.map

package/dist/tools/api/apify_api_write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apify_api_write.d.ts","sourceRoot":"","sources":["../../../src/tools/api/apify_api_write.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA4C,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAgG3G;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAuCjB,CAAC"}

package/dist/tools/api/apify_api_write.js

@@ -0,0 +1,129 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { HELPER_TOOLS, MAX_INLINE_BYTES } from '../../const.js';
+import { ALL_TOOLS_PRESENT, TOOL_TYPE } from '../../types.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { respondUserError } from '../../utils/mcp.js';
+import { apifyApiCallOutputSchema } from '../structured_output_schemas.js';
+import { isEndpointBlocked } from './apify_api_blocklist.js';
+import { normalizeApiPath } from './apify_api_path.js';
+import { API_CALL_DESCRIPTION, apiCallArgsShape, callApi, findPathOperations, formatList, redactApiCallArgs, } from './apify_api_request.js';
+import { API_METHODS, fetchApiOperationIndex } from './apify_api_spec.js';
+const apifyApiWriteArgs = z.object({
+    path: apiCallArgsShape.path,
+    method: z
+        .enum(['POST', 'PUT', 'PATCH', 'DELETE'])
+        .optional()
+        .describe('HTTP method: POST, PUT, PATCH, or DELETE. Omit it only when the path has one method in the API spec.'),
+    query: apiCallArgsShape.query,
+    body: z.unknown().optional().describe('The request body: a JSON object or array, sent as JSON.'),
+});
+function buildDescription({ hasTool }) {
+    const findPath = hasTool(HELPER_TOOLS.API_SEARCH) ? `\nFind the path with ${HELPER_TOOLS.API_SEARCH}.` : '';
+    const getParameters = hasTool(HELPER_TOOLS.API_DETAILS)
+        ? `\nGet the operation's parameters and body schema first with ${HELPER_TOOLS.API_DETAILS} and the method.`
+        : '';
+    return dedent `
+        Send a POST, PUT, PATCH, or DELETE request to the Apify API at a path, such as /v2/datasets/abc.
+        ${API_CALL_DESCRIPTION}${findPath}${getParameters}
+        The request is sent once and applies at once.
+        Returns the parsed response body, JSON with its data wrapper included: integers above 2^53 can
+        lose precision. A body over ${MAX_INLINE_BYTES} bytes is not returned.
+
+        Example call: {"path": "/v2/datasets/abc", "method": "PUT", "body": {"name": "leads-2026"}}
+
+        USAGE:
+        - Use to change something no dedicated tool changes, such as a dataset's name or a webhook.
+        - Change only what the user asked for.
+
+        USAGE EXAMPLES:
+        - user_input: Rename my dataset to leads-2026
+        - user_input: Add a webhook that calls https://example.com/hook when a run of my-actor fails
+    `;
+}
+/**
+ * The method of a call that omits it: the path's only operation in the spec, when that is a write and
+ * the path has no blocked write method; otherwise why the caller must give one. The caller is asked
+ * only for the write methods; a GET goes to the read tool.
+ */
+async function inferWriteMethod(path, loadedToolNames) {
+    const index = await fetchApiOperationIndex().catch(() => undefined);
+    if (!index)
+        return { error: 'The API spec could not be loaded to choose the method; specify the method.' };
+    const operations = findPathOperations(index, normalizeApiPath(path));
+    if (operations.length === 0)
+        return { error: 'The path is not in the API spec; specify the method.' };
+    const writeMethods = operations
+        .map((operation) => operation.method)
+        .filter((method) => method !== 'GET');
+    const readTool = loadedToolNames.includes(HELPER_TOOLS.API_READ) ? `; call it with ${HELPER_TOOLS.API_READ}` : '';
+    if (writeMethods.length === 0) {
+        return { error: `The path has only the GET method, which this tool does not send${readTool}.` };
+    }
+    // The index leaves out a blocked operation, so the one operation left may not be the path's only write method.
+    const hasBlockedWriteMethod = API_METHODS.some((method) => method !== 'GET' && isEndpointBlocked(method, operations[0].path));
+    if (operations.length === 1 && !hasBlockedWriteMethod)
+        return { method: writeMethods[0] };
+    const getNote = writeMethods.length < operations.length ? ` This tool does not send its GET${readTool}.` : '';
+    return { error: `Specify a method for this path: ${formatList(writeMethods, 'or')}.${getNote}` };
+}
+/**
+ * The body to send. A client may send the untyped body as a string of JSON, so a string is parsed to
+ * the value it holds; sent as is, it would reach the API as a JSON string.
+ */
+function parseBody(body) {
+    if (typeof body !== 'string')
+        return { value: body };
+    try {
+        return { value: JSON.parse(body) };
+    }
+    catch {
+        return { error: 'The body is a string that is not valid JSON; give it as a JSON object or array.' };
+    }
+}
+/**
+ * Sends a POST, PUT, PATCH, or DELETE to a path of the Apify API, https://docs.apify.com/api/v2, as a proxy.
+ */
+export const apifyApiWrite = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.API_WRITE,
+    title: 'Write Apify API',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: z.toJSONSchema(apifyApiWriteArgs),
+    outputSchema: apifyApiCallOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(apifyApiWriteArgs)),
+    annotations: {
+        title: 'Write Apify API',
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        // It starts runs and builds, and creates webhooks that call any URL, like the tools that start runs.
+        openWorldHint: true,
+    },
+    // A body can carry secrets: environment variable values, webhook headers, stored records. So can the
+    // webhooks query parameter of a run, whose webhooks carry headers.
+    redactArgs: redactApiCallArgs,
+    call: async (toolArgs) => {
+        const parsed = apifyApiWriteArgs.parse(toolArgs.args);
+        const body = parseBody(parsed.body);
+        if ('error' in body)
+            return respondUserError(body.error);
+        const resolved = parsed.method
+            ? { method: parsed.method }
+            : await inferWriteMethod(parsed.path, toolArgs.loadedToolNames);
+        if ('error' in resolved)
+            return respondUserError(resolved.error);
+        return callApi({
+            client: toolArgs.apifyClient,
+            token: toolArgs.apifyToken,
+            method: resolved.method,
+            path: parsed.path,
+            query: parsed.query,
+            body: body.value,
+            signal: toolArgs.signal,
+            loadedToolNames: toolArgs.loadedToolNames,
+        });
+    },
+});
+//# sourceMappingURL=apify_api_write.js.map

package/dist/tools/api/apify_api_write.js.map

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

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,8BAA8B,EACjC,MAAM,eAAe,CAAC;AAGvB,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAKtC,CAAC;AAIF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,8BAA8B,EAAE,CAAC;AAE/G;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,WAAiC,GAAG,SAAS,EAAE,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,YAAY,EAAE,CAM/D;AAGD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,8BAA8B,EACjC,MAAM,eAAe,CAAC;AAGvB,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAQtC,CAAC;AAIF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,8BAA8B,EAAE,CAAC;AAE/G;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,WAAiC,GAAG,SAAS,EAAE,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,YAAY,EAAE,CAM/D;AAGD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/tools/index.js

@@ -9,6 +9,9 @@ export const unauthEnabledTools = [
     HELPER_TOOLS.DOCS_FETCH,
     HELPER_TOOLS.STORE_SEARCH,
     HELPER_TOOLS.ACTOR_GET_DETAILS,
+    // They read only the public API spec from docs.apify.com, never the API itself.
+    HELPER_TOOLS.API_SEARCH,
+    HELPER_TOOLS.API_DETAILS,
 ];
 // Re-export from registry.ts
 // This is actually needed to avoid circular dependency issues

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,8BAA8B,GACjC,MAAM,eAAe,CAAC;AAEvB,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAa;IACxC,YAAY,CAAC,WAAW;IACxB,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,YAAY;IACzB,YAAY,CAAC,iBAAiB;CACjC,CAAC;AAEF,6BAA6B;AAC7B,8DAA8D;AAC9D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,8BAA8B,EAAE,CAAC;AAE/G;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB,WAAW,CAAC,OAAO;IACnE,OAAO,4BAA4B,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B;IAC1C,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzD,OAAQ,MAAM,CAAC,OAAO,CAAC,UAAU,CAAmC;SAC/D,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;SAClF,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,8BAA8B,GACjC,MAAM,eAAe,CAAC;AAEvB,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAa;IACxC,YAAY,CAAC,WAAW;IACxB,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,YAAY;IACzB,YAAY,CAAC,iBAAiB;IAC9B,gFAAgF;IAChF,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,WAAW;CAC3B,CAAC;AAEF,6BAA6B;AAC7B,8DAA8D;AAC9D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,8BAA8B,EAAE,CAAC;AAE/G;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB,WAAW,CAAC,OAAO;IACnE,OAAO,4BAA4B,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B;IAC1C,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzD,OAAQ,MAAM,CAAC,OAAO,CAAC,UAAU,CAAmC;SAC/D,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;SAClF,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAC"}