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

package/dist/tools/builds/build_actor.d.ts

@@ -0,0 +1,7 @@
+import type { ToolEntry } from '../../types.js';
+/**
+ * https://docs.apify.com/api/v2/actors-builds-post
+ *  /v2/acts/{actorId}/builds
+ */
+export declare const buildActor: ToolEntry;
+//# sourceMappingURL=build_actor.d.ts.map

package/dist/tools/builds/build_actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_actor.d.ts","sourceRoot":"","sources":["../../../src/tools/builds/build_actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA4C,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AA+C3G;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,SAuDd,CAAC"}

package/dist/tools/builds/build_actor.js

@@ -0,0 +1,97 @@
+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 { getConsoleLinkContext } from '../../utils/console_link.js';
+import { respondAborted, respondUserError } from '../../utils/mcp.js';
+import { ABORT } from '../actors/actor_run_response.js';
+import { buildActorToolOutputSchema } from '../structured_output_schemas.js';
+import { buildNextStepForBuild, buildWaitSecsField, listVersionNumbers, respondWithBuild, startBuild, toBuildResult, } from './build_helpers.js';
+const buildActorArgs = z.object({
+    actor: z.string().min(1).describe('Actor ID or username/name'),
+    // Format is not enforced by a regex: AJV here drops `pattern`, and the lookup against the Actor's
+    // versions below rejects anything that is not an existing MAJOR.MINOR version with a soft fail.
+    versionNumber: z
+        .string()
+        .optional()
+        .describe('Version to build in MAJOR.MINOR form; defaults to the only version when the Actor has exactly one'),
+    tag: z.string().optional().describe('Build tag to assign, for example latest'),
+    useCache: z.boolean().default(true).describe('Reuse the Docker layer cache from the previous build'),
+    waitSecs: buildWaitSecsField('0 starts the build and returns right away.'),
+});
+function buildDescription({ hasTool }) {
+    return `Build an Actor version on the Apify platform and wait a bounded time for the build to finish.
+Returns the build (id, actorId, buildNumber, status, startedAt, finishedAt) and a summary with one next step.
+Use after the Actor's source changed so runs pick up the new code.${hasTool(HELPER_TOOLS.ACTOR_BUILD_GET)
+        ? ` If the build is still running when the wait ends, check it with ${HELPER_TOOLS.ACTOR_BUILD_GET}.`
+        : ''}
+
+USAGE:
+- Use to rebuild an Actor after changing its source.
+- Use to build a specific version and tag it, for example as latest.
+
+USAGE EXAMPLES:
+- user_input: Rebuild my-actor
+- user_input: Build version 0.2 of john/my-actor and tag it latest`;
+}
+/**
+ * https://docs.apify.com/api/v2/actors-builds-post
+ *  /v2/acts/{actorId}/builds
+ */
+export const buildActor = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.ACTOR_BUILD,
+    title: 'Build Actor',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    // `fixZodSchemaRequired` strips `useCache` and `waitSecs` from `required` because they have defaults.
+    inputSchema: fixZodSchemaRequired(z.toJSONSchema(buildActorArgs)),
+    outputSchema: buildActorToolOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(buildActorArgs)),
+    paymentRequired: true,
+    annotations: {
+        title: 'Build Actor',
+        readOnlyHint: false,
+        // `tag` re-points an existing tag, `latest` included, to this build, which changes what runs by default.
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    call: async (toolArgs) => {
+        var _a;
+        const { args, apifyClient: client, apifyToken, loadedToolNames, signal, progressTracker } = toolArgs;
+        const parsed = buildActorArgs.parse(args);
+        const actor = await client.actor(parsed.actor).get();
+        if (!actor) {
+            return respondUserError(`Actor '${parsed.actor}' not found.`);
+        }
+        const versionNumbers = listVersionNumbers(actor);
+        if (versionNumbers.length === 0) {
+            return respondUserError(`Actor '${parsed.actor}' has no versions to build.`);
+        }
+        if (parsed.versionNumber !== undefined && !versionNumbers.includes(parsed.versionNumber)) {
+            return respondUserError(`Actor '${parsed.actor}' has no version ${parsed.versionNumber}; available versions: ${versionNumbers.join(', ')}.`);
+        }
+        if (parsed.versionNumber === undefined && versionNumbers.length !== 1) {
+            return respondUserError(`Specify versionNumber; this Actor has versions: ${versionNumbers.join(', ')}.`);
+        }
+        const versionNumber = (_a = parsed.versionNumber) !== null && _a !== void 0 ? _a : versionNumbers[0];
+        // Race the wait against the request signal so a cancelled call returns promptly instead of
+        // blocking up to `waitSecs`. Per MCP spec, receivers SHOULD NOT respond to a cancelled request.
+        const build = await startBuild(client, actor.id, versionNumber, {
+            tag: parsed.tag,
+            useCache: parsed.useCache,
+            waitSecs: parsed.waitSecs,
+            signal,
+            progressTracker,
+        });
+        if (build === ABORT)
+            return respondAborted();
+        const linkContext = await getConsoleLinkContext(apifyToken, client);
+        const structuredContent = { build: toBuildResult(build, linkContext) };
+        const summary = `Started build ${build.buildNumber} of Actor ${build.actId} (version ${versionNumber}); status ${build.status}.`;
+        const nextStep = buildNextStepForBuild(build, { loadedToolNames });
+        return respondWithBuild({ structuredContent, summary, nextStep });
+    },
+});
+//# sourceMappingURL=build_actor.js.map

package/dist/tools/builds/build_actor.js.map

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

package/dist/tools/builds/build_helpers.d.ts

@@ -1,10 +1,12 @@
-import type { Build } from 'apify-client';
+import type { Actor, Build } from 'apify-client';
 import { z } from 'zod';
 import type { ApifyClient } from '../../apify_client.js';
 import type { ConsoleLinkContext } from '../../types.js';
 import type { ToolResponse } from '../../utils/mcp.js';
 import type { ProgressTracker } from '../../utils/progress.js';
 import { ABORT } from '../actors/actor_run_response.js';
+/** The MAJOR.MINOR numbers of the Actor's versions; a version document without one is skipped. */
+export declare function listVersionNumbers(actor: Pick<Actor, 'versions'>): string[];
 /** The build tools wait this long by default, the same as `get-actor-run` and `call-actor`, so a loop of build and run calls behaves alike. */
 export declare const BUILD_WAIT_SECS_DEFAULT = 30;
 /**
@@ -14,27 +16,53 @@ export declare const BUILD_WAIT_SECS_DEFAULT = 30;
 export declare function buildWaitSecsField(zeroMeans: string): z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 /**
  * The build subset returned by the build tools. Allowlisted so internal fields on the API
- * document (userId, meta, options, inspectorId) never reach the client.
- * `apifyConsoleUrl` is set only for Console UI token sessions (see `getConsoleLinkContext`).
+ * document (userId, meta, options, inspectorId) never reach the client. get-actor-build-list returns
+ * it as is; get-actor-build and build-actor add the Console link (`toBuildResult`).
  */
-export declare function toBuildResult(build: Build, linkContext: ConsoleLinkContext | undefined): {
+export declare function toBuildItem(build: Pick<Build, 'id' | 'actId' | 'buildNumber' | 'status' | 'startedAt' | 'finishedAt'>): {
     id: string;
     actorId: string;
     buildNumber: string;
     status: "SUCCEEDED" | "FAILED" | "ABORTED" | "TIMED-OUT";
     startedAt: string | null;
     finishedAt: string | null;
+};
+/**
+ * `toBuildItem` plus `apifyConsoleUrl`, which is set only for Console UI token sessions
+ * (see `getConsoleLinkContext`).
+ */
+export declare function toBuildResult(build: Build, linkContext: ConsoleLinkContext | undefined): {
     apifyConsoleUrl: string | undefined;
+    id: string;
+    actorId: string;
+    buildNumber: string;
+    status: "SUCCEEDED" | "FAILED" | "ABORTED" | "TIMED-OUT";
+    startedAt: string | null;
+    finishedAt: string | null;
 };
+/**
+ * Starts a build of an Actor version and waits up to `waitSecs` for it to finish, reporting progress
+ * meanwhile. The wait is raced against `signal`; a cancelled request aborts the build it started and
+ * resolves to {@link ABORT}, so a build nobody waits for does not run on, the same as `call-actor`
+ * does with its run.
+ */
+export declare function startBuild(client: ApifyClient, actorId: string, versionNumber: string, options: {
+    tag?: string;
+    useCache: boolean;
+    waitSecs: number;
+    signal?: AbortSignal;
+    progressTracker?: ProgressTracker | null;
+}): Promise<Build | typeof ABORT>;
 /**
  * The one next step after a build reaches `status`, shared by every tool that reports a build.
  * Sibling tools are named only when the session was served them (`loadedToolNames`), and each hint
- * keeps a fallback so the text is never a dead end. `nonTerminalNextStep` comes from the caller
- * because only the calling tool may name itself ("call this tool again").
+ * keeps a fallback so the text is never a dead end. A still-running build points at get-actor-build;
+ * only get-actor-build itself passes `nonTerminalNextStep`, because only the calling tool may name
+ * itself ("call this tool again").
  */
 export declare function buildNextStepForBuild(build: Pick<Build, 'id' | 'buildNumber' | 'status'>, options: {
     loadedToolNames: readonly string[];
-    nonTerminalNextStep: string;
+    nonTerminalNextStep?: string;
 }): string;
 /**
  * The response every tool that reports a build returns: the JSON first, then the summary with

package/dist/tools/builds/build_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build_helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/builds/build_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAyC,MAAM,iCAAiC,CAAC;AAG/F,+IAA+I;AAC/I,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,4CAWnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,GAAG,SAAS;;;;;;;;EAWtF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,aAAa,GAAG,QAAQ,CAAC,EACnD,OAAO,EAAE;IAAE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAC7E,MAAM,CAaR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACrC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE;YAAE,eAAe,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,YAAY,CAOf;AAOD;;;;GAIG;AACH,wBAAsB,YAAY,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,GAC9F,OAAO,CAAC,KAAK,GAAG,OAAO,KAAK,CAAC,CAiB/B"}
+{"version":3,"file":"build_helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/builds/build_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAqB,KAAK,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAyC,MAAM,iCAAiC,CAAC;AAG/F,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAE3E;AAED,+IAA+I;AAC/I,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,4CAWnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACvB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;;;;;;;EAW7F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,GAAG,SAAS;;;;;;;;EAKtF;AAeD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC5C,GACF,OAAO,CAAC,KAAK,GAAG,OAAO,KAAK,CAAC,CAc/B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,aAAa,GAAG,QAAQ,CAAC,EACnD,OAAO,EAAE;IAAE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E,MAAM,CAgBR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACrC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE;YAAE,eAAe,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,YAAY,CAOf;AAOD;;;;GAIG;AACH,wBAAsB,YAAY,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,GAC9F,OAAO,CAAC,KAAK,GAAG,OAAO,KAAK,CAAC,CAiB/B"}

package/dist/tools/builds/build_helpers.js

@@ -1,10 +1,15 @@
 import { z } from 'zod';
 import { HELPER_TOOLS } from '../../const.js';
 import { buildConsoleBuildUrl } from '../../utils/console_link.js';
+import { logHttpError } from '../../utils/logging.js';
 import { respondOk } from '../../utils/mcp.js';
 import { formatBuildStatusMessage, TERMINAL_RUN_STATUSES } from '../../utils/progress.js';
 import { ABORT, raceAbort, toIsoString, WAIT_SECS_MAX } from '../actors/actor_run_response.js';
 import { apifyConsoleLinkText } from '../storage/storage_helpers.js';
+/** The MAJOR.MINOR numbers of the Actor's versions; a version document without one is skipped. */
+export function listVersionNumbers(actor) {
+    return actor.versions.flatMap((version) => { var _a; return (_a = version.versionNumber) !== null && _a !== void 0 ? _a : []; });
+}
 /** The build tools wait this long by default, the same as `get-actor-run` and `call-actor`, so a loop of build and run calls behaves alike. */
 export const BUILD_WAIT_SECS_DEFAULT = 30;
 /**
@@ -23,10 +28,10 @@ export function buildWaitSecsField(zeroMeans) {
 }
 /**
  * The build subset returned by the build tools. Allowlisted so internal fields on the API
- * document (userId, meta, options, inspectorId) never reach the client.
- * `apifyConsoleUrl` is set only for Console UI token sessions (see `getConsoleLinkContext`).
+ * document (userId, meta, options, inspectorId) never reach the client. get-actor-build-list returns
+ * it as is; get-actor-build and build-actor add the Console link (`toBuildResult`).
  */
-export function toBuildResult(build, linkContext) {
+export function toBuildItem(build) {
     var _a, _b;
     return {
         id: build.id,
@@ -36,17 +41,62 @@ export function toBuildResult(build, linkContext) {
         // Normalized because the client parses these into `Date` objects; the output schema promises strings.
         startedAt: (_a = toIsoString(build.startedAt)) !== null && _a !== void 0 ? _a : null,
         finishedAt: (_b = toIsoString(build.finishedAt)) !== null && _b !== void 0 ? _b : null,
+    };
+}
+/**
+ * `toBuildItem` plus `apifyConsoleUrl`, which is set only for Console UI token sessions
+ * (see `getConsoleLinkContext`).
+ */
+export function toBuildResult(build, linkContext) {
+    return {
+        ...toBuildItem(build),
         apifyConsoleUrl: buildConsoleBuildUrl(linkContext, build.actId, build.buildNumber),
     };
 }
+/**
+ * Aborts a build the tool started when the client cancels the request, the way `call-actor` aborts its
+ * run. Failures are logged and swallowed so a transient API error does not override the cancellation.
+ */
+async function abortBuildOnSignal(buildId, client) {
+    await client
+        .build(buildId)
+        .abort()
+        .catch((error) => {
+        logHttpError(error, 'Error aborting Actor build', { buildId });
+    });
+}
+/**
+ * Starts a build of an Actor version and waits up to `waitSecs` for it to finish, reporting progress
+ * meanwhile. The wait is raced against `signal`; a cancelled request aborts the build it started and
+ * resolves to {@link ABORT}, so a build nobody waits for does not run on, the same as `call-actor`
+ * does with its run.
+ */
+export async function startBuild(client, actorId, versionNumber, options) {
+    const { tag, useCache, waitSecs, signal, progressTracker } = options;
+    const started = await client
+        .actor(actorId)
+        .build(versionNumber, { ...(tag !== undefined && { tag }), useCache });
+    // The cancel can arrive while the start call is in flight; the build exists by then.
+    if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+        await abortBuildOnSignal(started.id, client);
+        return ABORT;
+    }
+    if (waitSecs === 0)
+        return started;
+    const finished = await waitForBuild(client, started, { waitSecs, signal, progressTracker });
+    if (finished === ABORT)
+        await abortBuildOnSignal(started.id, client);
+    return finished;
+}
 /**
  * The one next step after a build reaches `status`, shared by every tool that reports a build.
  * Sibling tools are named only when the session was served them (`loadedToolNames`), and each hint
- * keeps a fallback so the text is never a dead end. `nonTerminalNextStep` comes from the caller
- * because only the calling tool may name itself ("call this tool again").
+ * keeps a fallback so the text is never a dead end. A still-running build points at get-actor-build;
+ * only get-actor-build itself passes `nonTerminalNextStep`, because only the calling tool may name
+ * itself ("call this tool again").
  */
 export function buildNextStepForBuild(build, options) {
-    const { loadedToolNames, nonTerminalNextStep } = options;
+    const { loadedToolNames } = options;
     if (build.status === 'SUCCEEDED') {
         return loadedToolNames.includes(HELPER_TOOLS.ACTOR_CALL)
             ? `Run the Actor with ${HELPER_TOOLS.ACTOR_CALL} and set callOptions.build to ${build.buildNumber}.`
@@ -57,7 +107,11 @@ export function buildNextStepForBuild(build, options) {
             ? `Read the build log with ${HELPER_TOOLS.ACTOR_BUILD_LOG} using buildId ${build.id}; pass lines 0 for the whole log.`
             : 'Read the build log for the error, fix the source, and build again.';
     }
-    return nonTerminalNextStep;
+    if (options.nonTerminalNextStep !== undefined)
+        return options.nonTerminalNextStep;
+    return loadedToolNames.includes(HELPER_TOOLS.ACTOR_BUILD_GET)
+        ? `Check progress with ${HELPER_TOOLS.ACTOR_BUILD_GET} using buildId ${build.id} (it waits up to ${WAIT_SECS_MAX} seconds per call).`
+        : 'The build is still running; check its status again in a few seconds.';
 }
 /**
  * The response every tool that reports a build returns: the JSON first, then the summary with

package/dist/tools/builds/build_helpers.js.map

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

package/dist/tools/builds/get_actor_build_list.d.ts

@@ -0,0 +1,9 @@
+import type { ToolEntry } from '../../types.js';
+/**
+ * https://docs.apify.com/api/v2/actor-builds-get (all builds of the user)
+ * https://docs.apify.com/api/v2/act-builds-get (builds of one Actor, when `actorId` is given)
+ *
+ * Mirrors get-actor-run-list: `actorId` is an optional filter, not a required argument.
+ */
+export declare const getActorBuildList: ToolEntry;
+//# sourceMappingURL=get_actor_build_list.d.ts.map

package/dist/tools/builds/get_actor_build_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_actor_build_list.d.ts","sourceRoot":"","sources":["../../../src/tools/builds/get_actor_build_list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA4C,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAuF3G;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,SA4CrB,CAAC"}

package/dist/tools/builds/get_actor_build_list.js

@@ -0,0 +1,119 @@
+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, respondUserError } from '../../utils/mcp.js';
+import { catchNotFound } from '../storage/storage_helpers.js';
+import { getActorBuildListToolOutputSchema } from '../structured_output_schemas.js';
+import { toBuildItem } from './build_helpers.js';
+const getActorBuildListArgs = z.object({
+    actorId: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Only list builds of this Actor: its ID, or its full name as username/name or username~name. A name without the username is not enough.'),
+    offset: z.number().int().min(0).describe('Number of builds to skip at the start. Default: 0.').default(0),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .describe('Maximum number of builds to return. Default is 10. Maximum is 20.')
+        .default(10),
+    // Newest first by default, unlike get-actor-run-list, because the build a caller looks for is
+    // usually the latest one (#1407).
+    desc: z
+        .boolean()
+        .describe('If true, the builds are sorted by startedAt, newest first; false sorts oldest first. Default: true.')
+        .default(true),
+});
+/** Statuses of a build that ended without succeeding; the next step points at the newest one's log. */
+const FAILED_BUILD_STATUSES = new Set(['FAILED', 'TIMED-OUT', 'ABORTED']);
+/**
+ * The one next step after a page of builds. A failed build is the usual reason to list builds, so the
+ * newest failed build on the page wins. Sibling tools are named only when the session was served them.
+ */
+function buildNextStepForBuildList(builds, desc, loadedToolNames) {
+    const failedBuilds = builds.filter((build) => FAILED_BUILD_STATUSES.has(build.status));
+    // The API sorts by startedAt, so the newest failed build leads a descending page and ends an ascending one.
+    const newestFailedBuild = desc ? failedBuilds[0] : failedBuilds.at(-1);
+    if (newestFailedBuild) {
+        return loadedToolNames.includes(HELPER_TOOLS.ACTOR_BUILD_LOG)
+            ? `Read why build ${newestFailedBuild.buildNumber} failed with ${HELPER_TOOLS.ACTOR_BUILD_LOG} using buildId ${newestFailedBuild.id}.`
+            : `Read the log of build ${newestFailedBuild.buildNumber} (ID ${newestFailedBuild.id}) to see why it failed.`;
+    }
+    // An empty page has no build to check.
+    if (builds.length > 0 && loadedToolNames.includes(HELPER_TOOLS.ACTOR_BUILD_GET)) {
+        return `Check a build with ${HELPER_TOOLS.ACTOR_BUILD_GET} using its buildId.`;
+    }
+    return undefined;
+}
+function buildDescription({ hasTool }) {
+    return `List the Actor builds of the account, newest first by default. Pass actorId to list only the builds of one Actor, for example to find why its latest build failed. Lists builds in every status; there is no status filter.
+Read-only. Returns total, count, offset, limit, desc and items (id, actorId, buildNumber, status, startedAt, finishedAt)
+and a summary with at most one next step.${hasTool(HELPER_TOOLS.ACTOR_BUILD_GET)
+        ? ` Check a build with ${HELPER_TOOLS.ACTOR_BUILD_GET} by passing its id as buildId.`
+        : ''}${hasTool(HELPER_TOOLS.ACTOR_BUILD_LOG)
+        ? ` Read why a build failed with ${HELPER_TOOLS.ACTOR_BUILD_LOG} by passing its id as buildId.`
+        : ''}
+
+USAGE:
+- Use to find the ID of a build that failed or that no run references.
+- Use to see recent builds and their statuses, of one Actor or across the account.
+
+USAGE EXAMPLES:
+- user_input: Why did the last build of my-actor fail?
+- user_input: List the builds of john/my-actor`;
+}
+/**
+ * https://docs.apify.com/api/v2/actor-builds-get (all builds of the user)
+ * https://docs.apify.com/api/v2/act-builds-get (builds of one Actor, when `actorId` is given)
+ *
+ * Mirrors get-actor-run-list: `actorId` is an optional filter, not a required argument.
+ */
+export const getActorBuildList = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.ACTOR_BUILD_LIST_GET,
+    title: 'Get Actor build list',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    // `fixZodSchemaRequired` strips `offset`, `limit` and `desc` from `required` because they have defaults; no field is required.
+    inputSchema: fixZodSchemaRequired(z.toJSONSchema(getActorBuildListArgs)),
+    outputSchema: getActorBuildListToolOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(getActorBuildListArgs)),
+    annotations: {
+        title: 'Get Actor build list',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyClient: client, loadedToolNames } = toolArgs;
+        const parsed = getActorBuildListArgs.parse(args);
+        const listOptions = { offset: parsed.offset, limit: parsed.limit, desc: parsed.desc };
+        const builds = parsed.actorId
+            ? await catchNotFound(client.actor(parsed.actorId).builds().list(listOptions))
+            : await client.builds().list(listOptions);
+        if (!builds) {
+            return respondUserError(`Actor '${parsed.actorId}' not found.`);
+        }
+        // Cast because the client's item type omits fields the API returns (see `BuildListItem`).
+        const items = builds.items;
+        const structuredContent = {
+            total: builds.total,
+            count: builds.count,
+            offset: builds.offset,
+            limit: builds.limit,
+            desc: builds.desc,
+            items: items.map(toBuildItem),
+        };
+        const owner = parsed.actorId ? `Actor ${parsed.actorId}` : 'Your account';
+        const summary = `${owner} has ${builds.total} ${builds.total === 1 ? 'build' : 'builds'}; showing ${builds.count} from offset ${builds.offset}.`;
+        const nextStep = buildNextStepForBuildList(items, builds.desc, loadedToolNames);
+        return respondOk([JSON.stringify(structuredContent), nextStep ? `${summary}\n${nextStep}` : summary], {
+            structuredContent,
+        });
+    },
+});
+//# sourceMappingURL=get_actor_build_list.js.map

package/dist/tools/builds/get_actor_build_list.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmC1C,kEAAkE;AAClE,eAAO,MAAM,cAAc;;;;;;;;;CAkBY,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,cAAc,EAAkC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAEnF,0IAA0I;AAC1I,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,WAAiC,GAAG,eAAe,CAE1F;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAuB,CAAC;AAEpG,wHAAwH;AACxH,eAAO,MAAM,gBAAgB,EAAE,SAAS,SAAS,EAKhD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,cAAc,EAAE,SAAS,CAGrE,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqC1C,kEAAkE;AAClE,eAAO,MAAM,cAAc;;;;;;;;;CAkBY,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,cAAc,EAAkC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAEnF,0IAA0I;AAC1I,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,WAAiC,GAAG,eAAe,CAE1F;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAuB,CAAC;AAEpG,wHAAwH;AACxH,eAAO,MAAM,gBAAgB,EAAE,SAAS,SAAS,EAKhD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,cAAc,EAAE,SAAS,CAGrE,CAAC"}

package/dist/tools/registry.js

@@ -19,7 +19,9 @@ import { SERVER_MODE } from '../types.js';
 import { callActor } from './actors/call_actor.js';
 import { fetchActorDetails } from './actors/fetch_actor_details.js';
 import { searchActors } from './actors/search_actors.js';
+import { buildActor } from './builds/build_actor.js';
 import { getActorBuild } from './builds/get_actor_build.js';
+import { getActorBuildList } from './builds/get_actor_build_list.js';
 import { getActorBuildLog } from './builds/get_actor_build_log.js';
 import { reportProblem } from './dev/report_problem.js';
 import { fetchApifyDocs } from './docs/fetch_apify_docs.js';
@@ -66,7 +68,7 @@ export const toolCategories = {
     ],
     tasks: [createActorTask, getActorTask, updateActorTask, publishActorTask, unpublishActorTask],
     schedules: [createSchedule, getSchedule, updateSchedule, deleteSchedule],
-    builds: [getActorBuild, getActorBuildLog],
+    builds: [getActorBuild, getActorBuildLog, getActorBuildList, buildActor],
     dev: [reportProblem],
 };
 /**

package/dist/tools/registry.js.map

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

package/dist/tools/runs/get_actor_run_list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run_list.d.ts","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run_list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAkCnF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SA8CnB,CAAC"}
+{"version":3,"file":"get_actor_run_list.d.ts","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run_list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAoCnF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SA8CnB,CAAC"}

package/dist/tools/runs/get_actor_run_list.js

@@ -10,7 +10,7 @@ const getUserRunsListArgs = z.object({
         .string()
         .min(1)
         .optional()
-        .describe('Only list runs of this Actor; accepts an Actor ID or username/name.'),
+        .describe('Only list runs of this Actor: its ID, or its full name as username/name or username~name. A name without the username is not enough.'),
     offset: z
         .number()
         .describe('Number of array elements that should be skipped at the start. The default value is 0.')

package/dist/tools/runs/get_actor_run_list.js.map

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