@apify/actors-mcp-server 0.18.4-beta.4 → 0.18.5-beta.0

package/dist/tools/versions/source_helpers.js

@@ -0,0 +1,350 @@
+import { posix } from 'node:path';
+import { ActorSourceType, ApifyApiError } from 'apify-client';
+import { z } from 'zod';
+import { UserInputError } from '../../errors.js';
+import { REDACTED } from '../../resources/api_resources.js';
+import { getResourceByIdOrName } from '../../utils/apify_resource_id.js';
+import { getConsoleLinkContext } from '../../utils/console_link.js';
+import { logHttpError } from '../../utils/logging.js';
+import { respondAborted, respondUserError } from '../../utils/mcp.js';
+import { isRecord } from '../api/apify_api_spec.js';
+import { buildNextStepForBuild, listVersionNumbers, respondWithBuild, toBuildResult } from '../builds/build_helpers.js';
+import { hasBinaryExtension } from './source_files.js';
+/** The input shape of one file sent whole. */
+export const sourceFileArgs = z.object({
+    path: z.string().min(1).describe('Path relative to the Actor root, for example src/main.js.'),
+    content: z.string().describe('The whole file content: text as is, or base64 when encoding is base64.'),
+    encoding: z
+        .enum(['utf8', 'base64'])
+        .optional()
+        .describe('utf8 for text, base64 for binary files. Defaults to base64 for binary extensions such as .png and to utf8 otherwise.'),
+});
+/** `keys` of `record` that are set: a string, number, or boolean as is, any other value as `REDACTED`. */
+function pickLoggedValues(record, keys) {
+    return Object.fromEntries(keys.flatMap((key) => {
+        const value = record[key];
+        if (value === undefined)
+            return [];
+        return [[key, ['string', 'number', 'boolean'].includes(typeof value) ? value : REDACTED]];
+    }));
+}
+/** `keys` of `record` that are set, each as `REDACTED`. */
+function maskLoggedValues(record, keys) {
+    return Object.fromEntries(keys.filter((key) => record[key] !== undefined).map((key) => [key, REDACTED]));
+}
+/** The logged copy of an entry's edits, each with its oldText and newText as `REDACTED`. */
+function redactEdits(edits) {
+    if (!Array.isArray(edits))
+        return REDACTED;
+    return edits.map((textEdit) => isRecord(textEdit) ? maskLoggedValues(textEdit, ['oldText', 'newText']) : REDACTED);
+}
+/**
+ * The logged copy of a source tool's arguments (`redactArgs`), built as an allowlist: `keys`, and each entry of the
+ * list under `listKey` with its `entryKeys`, and with its content and its edits' oldText and newText as `REDACTED`.
+ * File content can hold secrets, such as an API key written into the code.
+ */
+export function redactSourceToolArgs(args, fields) {
+    const { keys, listKey, entryKeys } = fields;
+    const redactEntry = (entry) => {
+        if (!isRecord(entry))
+            return REDACTED;
+        const { edits } = entry;
+        return {
+            ...pickLoggedValues(entry, entryKeys),
+            ...maskLoggedValues(entry, ['content']),
+            ...(edits !== undefined && { edits: redactEdits(edits) }),
+        };
+    };
+    const list = args[listKey];
+    return {
+        ...pickLoggedValues(args, keys),
+        ...(list !== undefined && { [listKey]: Array.isArray(list) ? list.map(redactEntry) : REDACTED }),
+    };
+}
+/**
+ * The Actor by its ID, its name (resolved against the token's own Actors), or its full name, `username/name` or
+ * `username~name` (apify-client turns username/name into the API's username~name); throws `UserInputError` when there
+ * is none.
+ */
+export async function fetchActor(client, actorSelector) {
+    const actor = await getResourceByIdOrName(actorSelector, async (safeId) => client.actor(safeId).get());
+    // Extra path segments, such as username/name/runs/last, reach a sub-resource that is not an Actor.
+    if (!actor || typeof actor.name !== 'string' || typeof actor.username !== 'string') {
+        throw new UserInputError(`Actor '${actorSelector}' not found. The actor argument takes an ID, a name (resolved against your own Actors), or a full name as username/name.`);
+    }
+    return { actor, fullName: `${actor.username}/${actor.name}` };
+}
+/** The requested version, or the only one when none is requested; throws `UserInputError` otherwise. */
+export function resolveVersion(actor, requestedVersionNumber, actorSelector) {
+    const versionNumbers = listVersionNumbers(actor);
+    // AJV turns a null versionNumber into an empty string, which no version has, so it counts as not given.
+    const requested = requestedVersionNumber || undefined;
+    if (requested === undefined && versionNumbers.length !== 1) {
+        // The source type and build tag tell the caller which version holds the code it is after.
+        const versions = actor.versions
+            .filter((version) => version.versionNumber !== undefined)
+            .map(({ versionNumber, sourceType, buildTag }) => {
+            const tag = buildTag ? `, build tag ${buildTag}` : '';
+            return `${versionNumber} (${sourceType}${tag})`;
+        });
+        throw new UserInputError(`Specify versionNumber; this Actor has versions: ${versions.join(', ')}.`);
+    }
+    const versionNumber = requested !== null && requested !== void 0 ? requested : versionNumbers[0];
+    const version = actor.versions.find((candidate) => candidate.versionNumber === versionNumber);
+    if (!version) {
+        throw new UserInputError(`Actor '${actorSelector}' has no version ${versionNumber}; available versions: ${versionNumbers.join(', ')}.`);
+    }
+    return { ...version, versionNumber };
+}
+/**
+ * The URL without what can grant access to it: the query string, the password, and, for http and https, the user. An
+ * SSH user such as `git@` is not a secret and stays. A URL the parser cannot read, such as
+ * `git@github.com:user/repo.git`, loses only its query string.
+ */
+function formatUrlWithoutSecrets(url) {
+    if (URL.canParse(url)) {
+        const parsed = new URL(url);
+        parsed.search = '';
+        parsed.password = '';
+        if (parsed.protocol === 'http:' || parsed.protocol === 'https:') {
+            parsed.username = '';
+        }
+        return parsed.href;
+    }
+    const queryIndex = url.indexOf('?');
+    if (queryIndex === -1)
+        return url;
+    const hashIndex = url.indexOf('#', queryIndex);
+    return url.slice(0, queryIndex) + (hashIndex === -1 ? '' : url.slice(hashIndex));
+}
+/**
+ * Why a version not stored as files is refused, and what to use instead. A version keeps the URL fields of a source
+ * type it used before, so only the URL of its current type is named.
+ */
+function formatSourceTypeRefusal(version, versionLabel) {
+    if (version.sourceType === ActorSourceType.GitRepo) {
+        const url = version.gitRepoUrl ? ` ${formatUrlWithoutSecrets(version.gitRepoUrl)}` : '';
+        return `${versionLabel} has its files in the Git repository${url}, not stored on Apify, so this tool cannot work on them; use the repository.`;
+    }
+    if (version.sourceType === ActorSourceType.GitHubGist) {
+        const url = version.gitHubGistUrl ? ` ${formatUrlWithoutSecrets(version.gitHubGistUrl)}` : '';
+        return `${versionLabel} has its files in the GitHub gist${url}, not stored on Apify, so this tool cannot work on them; use the gist.`;
+    }
+    // TODO(#1452): Read and write zip-stored (TARBALL) versions with adm-zip 0.6.1 or later, within the download and
+    // unpacking limits the issue lists.
+    if (version.sourceType === ActorSourceType.Tarball) {
+        return `${versionLabel} is stored as a zip archive (apify push does this for sources over 3 MiB), and this tool cannot work on zip-stored versions yet.`;
+    }
+    // The API's legacy SOURCE_CODE type and any type added later are not in apify-client's enum.
+    const { sourceType } = version;
+    return `${versionLabel} has source type ${sourceType}, which this tool cannot work on; only versions stored as files are supported.`;
+}
+/**
+ * The version's stored entries, folders included. Throws `UserInputError` for a version not stored as files and for
+ * one whose source the API hides.
+ */
+export function extractSourceFiles(version, versionLabel) {
+    if (version.sourceType !== ActorSourceType.SourceFiles) {
+        throw new UserInputError(formatSourceTypeRefusal(version, versionLabel));
+    }
+    // The API returns only the number, type, and build tag of a version whose source it hides from this account.
+    if (!version.sourceFiles) {
+        throw new UserInputError(`${versionLabel} came back without its source: the API hides it from accounts that cannot modify the Actor. Ask the Actor's owner for the source.`);
+    }
+    return version.sourceFiles;
+}
+/**
+ * The entry to store for a file sent whole: TEXT for utf8, BASE64 for base64, where no encoding means base64 for a
+ * binary extension, the rule get-actor-version reads by. The path is normalized the way get-actor-version lists it.
+ */
+export function buildSourceFileEntry({ path, content, encoding, }) {
+    const isBase64 = (encoding !== null && encoding !== void 0 ? encoding : (hasBinaryExtension(path) ? 'base64' : 'utf8')) === 'base64';
+    return { name: posix.normalize(path), format: isBase64 ? 'BASE64' : 'TEXT', content };
+}
+/**
+ * Base64 that decodes to its bytes without loss: Node and the build worker skip characters they cannot decode and stop
+ * at padding, so text sent as base64 would be stored as other bytes. Line breaks, missing padding, and the URL-safe
+ * alphabet decode without loss.
+ */
+function isBase64(content) {
+    const compact = content.replace(/\s/g, '').replace(/-/g, '+').replace(/_/g, '/');
+    return Buffer.from(compact, 'base64').toString('base64').replace(/=+$/, '') === compact.replace(/=+$/, '');
+}
+/**
+ * Throws `UserInputError` for content the stored file would not hold as sent: base64 that does not decode without
+ * loss, and text with a lone UTF-16 surrogate, which UTF-8 stores as U+FFFD.
+ */
+export function validateFileContent({ format, content }, label) {
+    if (format === 'BASE64' && !isBase64(content)) {
+        throw new UserInputError(`${label} has content that is not valid base64; encoding base64 takes binary content as base64, and text takes encoding utf8.`);
+    }
+    if (format === 'TEXT' && !content.isWellFormed()) {
+        throw new UserInputError(`${label} has text with a lone UTF-16 surrogate, which UTF-8 cannot store.`);
+    }
+}
+/**
+ * Throws `UserInputError` for a path with a control character, U+0000 to U+001F or U+007F, or with a lone UTF-16
+ * surrogate. The build writes the files to disk, where a file name cannot hold NUL, and UTF-8 stores a lone surrogate
+ * as U+FFFD.
+ */
+export function validatePathCharacters(path, label) {
+    if (!path.isWellFormed()) {
+        throw new UserInputError(`${label} has a lone UTF-16 surrogate in its path, which UTF-8 cannot store.`);
+    }
+    const character = [...path].find((char) => char <= '\u001f' || char === '\u007f');
+    if (character === undefined)
+        return;
+    const codePoint = `U+${character.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0')}`;
+    throw new UserInputError(`${label} has the control character ${codePoint} in its path; a path cannot hold characters U+0000 to U+001F or U+007F.`);
+}
+/**
+ * Throws `UserInputError` for a normalized path no file can be written at. The build worker refuses a version with a
+ * path outside the Actor root, so every build of it would fail; `.` and a path ending in a slash name a folder. A
+ * backslash is refused too: the build takes it as part of the file name, so src\main.js would land in the Actor root.
+ */
+export function validateFilePath(path, label) {
+    if (path.includes('\\')) {
+        throw new UserInputError(`${label} has a backslash in its path; paths use / as the separator.`);
+    }
+    if (path.startsWith('/') || path === '..' || path.startsWith('../')) {
+        throw new UserInputError(`${label} has a path outside the Actor root; paths are relative to it, such as src/main.js.`);
+    }
+    if (path === '.' || path.endsWith('/')) {
+        throw new UserInputError(`${label} has a path that names a folder, not a file.`);
+    }
+}
+/** The folders above a file, outermost first: `a` and `a/b` for `a/b/c.js`. */
+function listFolders(path) {
+    const folders = [];
+    for (let slashIndex = path.indexOf('/'); slashIndex !== -1; slashIndex = path.indexOf('/', slashIndex + 1)) {
+        folders.push(path.slice(0, slashIndex));
+    }
+    return folders;
+}
+/**
+ * The paths of a version's files and folder entries, to check where a new file can go: one path cannot be both a file
+ * and a folder, and the build worker fails to write such a file. Each check and change looks up only the folders of
+ * its path, since comparing each file with every other took 8 s for 20,000 files.
+ */
+export class SourcePathIndex {
+    constructor(filePaths, folderPaths = []) {
+        Object.defineProperty(this, "filePaths", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        /** The files under each folder, at any depth, in the order they were added. */
+        Object.defineProperty(this, "filePathsByFolder", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "folderPaths", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.folderPaths = folderPaths;
+        for (const path of filePaths)
+            this.addFile(path);
+    }
+    hasFile(path) {
+        return this.filePaths.has(path);
+    }
+    /** A file added again keeps its place in the order. */
+    addFile(path) {
+        var _a;
+        this.filePaths.add(path);
+        for (const folder of listFolders(path)) {
+            this.filePathsByFolder.set(folder, ((_a = this.filePathsByFolder.get(folder)) !== null && _a !== void 0 ? _a : new Set()).add(path));
+        }
+    }
+    deleteFile(path) {
+        var _a;
+        this.filePaths.delete(path);
+        for (const folder of listFolders(path))
+            (_a = this.filePathsByFolder.get(folder)) === null || _a === void 0 ? void 0 : _a.delete(path);
+    }
+    /**
+     * Throws `UserInputError` when a new file at `path` collides with another file or folder: a file at a folder of
+     * `path`, or else the first file added under `path`, or else the first folder entry at or under `path`. A file at
+     * `path` itself is for the caller to check.
+     */
+    validateNewFilePath(path, label) {
+        var _a, _b, _c;
+        const collision = (_c = (_a = listFolders(path).find((folder) => this.filePaths.has(folder))) !== null && _a !== void 0 ? _a : (_b = this.filePathsByFolder.get(path)) === null || _b === void 0 ? void 0 : _b.values().next().value) !== null && _c !== void 0 ? _c : this.folderPaths.find((folderPath) => folderPath === path || folderPath.startsWith(`${path}/`));
+        if (collision === undefined)
+            return;
+        throw new UserInputError(`${label} collides with ${collision}; one path cannot be both a file and a folder.`);
+    }
+}
+/** The build worker skips a file whose content is empty, so the caller hears of such files. */
+export function buildEmptyFilesWarnings(paths) {
+    if (paths.length === 0)
+        return {};
+    const warning = `These files are empty, and the build skips empty files, so they will not exist in the build: ${paths.join(', ')}.`;
+    return { warnings: [warning] };
+}
+/**
+ * Starts a build of the version after a committed write, with no tag so the version's buildTag applies, and does not
+ * wait for it. The write stands either way, so a failed start is returned as `buildError` rather than thrown: a caller
+ * told the call failed would retry writes that were saved. A cancel that arrives before the start starts no build.
+ */
+async function startBuildAfterWrite(toolArgs, target) {
+    const { apifyClient: client, apifyToken, signal } = toolArgs;
+    try {
+        // Resolved before the start, so a failed lookup leaves no build behind.
+        const linkContext = await getConsoleLinkContext(apifyToken, client);
+        // Per the MCP spec a cancelled request gets no response; the write stands.
+        if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+            return { aborted: true };
+        // Started without the request's signal: a committed write never aborts the build it started.
+        const build = await client.actor(target.actorId).build(target.versionNumber, { useCache: true });
+        return { build, linkContext };
+    }
+    catch (error) {
+        // The API's refusal is the caller's to read; anything else, such as a network failure, is logged too.
+        if (!(error instanceof ApifyApiError))
+            logHttpError(error, 'Failed to start a build after a source write', target);
+        return { buildError: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * The response to a committed write. With autoBuild, a build of the version starts first; a cancel that arrives before
+ * the start gets the cancelled-call response.
+ */
+export async function respondAfterWrite(params) {
+    const { toolArgs, autoBuild, target, structuredContent, summary } = params;
+    if (!autoBuild) {
+        return respondWithBuild({
+            structuredContent,
+            summary,
+            nextStep: 'No build was started; runs use these files only after the version is built.',
+        });
+    }
+    const started = await startBuildAfterWrite(toolArgs, target);
+    if ('aborted' in started)
+        return respondAborted();
+    if ('buildError' in started) {
+        return respondWithBuild({
+            structuredContent: { ...structuredContent, buildError: started.buildError },
+            summary,
+            nextStep: 'The build could not be started; runs use these files only after the version is built.',
+        });
+    }
+    return respondWithBuild({
+        structuredContent: { ...structuredContent, build: toBuildResult(started.build, started.linkContext) },
+        summary,
+        nextStep: buildNextStepForBuild(started.build, { loadedToolNames: toolArgs.loadedToolNames }),
+    });
+}
+/** A `UserInputError` as a soft failure; anything else is rethrown for the tool-call engine to report. */
+export function respondToSourceToolError(error) {
+    if (error instanceof UserInputError)
+        return respondUserError(error.message);
+    throw error;
+}
+//# sourceMappingURL=source_helpers.js.map

package/dist/tools/versions/source_helpers.js.map

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

package/dist/tools/versions/update_actor_version.d.ts

@@ -0,0 +1,15 @@
+import type { ToolEntry } from '../../types.js';
+/**
+ * https://docs.apify.com/api/v2/actor-get
+ *  /v2/actors/{actorId}
+ * https://docs.apify.com/api/v2/actor-version-put
+ *  /v2/actors/{actorId}/versions/{versionNumber}
+ *
+ * The operations apply to the version as read in this call, and the result is stored with one version PUT that
+ * carries only the source keys, never envVars or buildTag. Conflicts are caught by each operation's check and by
+ * expectedRevision. A save from Apify Console, `apify push`, or another MCP server that lands between this call's read
+ * and its PUT is not detected: the platform's version PUT takes no precondition, and this stays so until it gets a
+ * conditional one.
+ */
+export declare const updateActorVersion: ToolEntry;
+//# sourceMappingURL=update_actor_version.d.ts.map

package/dist/tools/versions/update_actor_version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_actor_version.d.ts","sourceRoot":"","sources":["../../../src/tools/versions/update_actor_version.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAgYnF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAoHtB,CAAC"}