@apify/actors-mcp-server 0.15.8-beta.1 → 0.15.8-beta.3

package/dist/tools/schedules/schedule_helpers.js

@@ -0,0 +1,238 @@
+import { ScheduleActions, } from 'apify-client';
+import { z } from 'zod';
+import { toIsoString } from '../actors/actor_run_response.js';
+import { getResourceByIdOrName, getTaskByIdOrName } from '../tasks/task_helpers.js';
+export const JSON_CONTENT_TYPE = 'application/json; charset=utf-8';
+/**
+ * The API caps Actor actions and task actions separately, not as one total
+ * (`MAX_ACTORS_PER_SCHEDULER` / `MAX_TASKS_PER_SCHEDULER`), and answers an over-limit list with
+ * `too-many-values` (403). Checked here because a schedule is only rejected after every action's
+ * Actor or task name has been resolved, one API call each.
+ */
+export const MAX_ACTIONS_PER_TYPE = 10;
+export const CRON_EXPRESSION_DESCRIPTION = 'When the schedule fires, as a standard 5-field cron expression "minute hour day-of-month month day-of-week" ' +
+    'evaluated in `timezone`. Examples: "0 9 * * *" daily at 09:00, "0 */6 * * *" every 6 hours, "0 9 * * 1" ' +
+    'Mondays at 09:00, "0 0 1 * *" on the 1st of each month. The shortcuts @hourly, @daily, @weekly, @monthly ' +
+    'and @yearly fire at a random offset inside their period (@daily somewhere between 00:05 and 06:00), so use ' +
+    'them only when the user names no time. An optional leading seconds field is accepted; the minimum interval ' +
+    'between runs is 10 seconds.';
+export const cronExpressionSchema = z.string().min(1).max(100);
+/**
+ * Only the length caps the API enforces. No `pattern`: the shared AJV instance removes that keyword
+ * as a ReDoS mitigation (`utils/ajv.ts`), so a regex here never gates the call — it only fires in the
+ * tool body's `parse()`, which throws a raw ZodError that reaches the client as serialised JSON with
+ * the pattern in it. The API rejects the same name with a far better message, and the field's
+ * `.describe()` text states the rule for the model.
+ */
+const scheduleNameSchema = z.string().min(3).max(63);
+/**
+ * One flat action shape for Actor and task actions alike. `buildApiActions` turns it into the API's
+ * tagged `RUN_ACTOR` / `RUN_ACTOR_TASK` shape and `fromApiAction` turns it back, so a schedule read
+ * pastes into an update unchanged.
+ *
+ * Deliberately not a z.union: zod renders a union as `anyOf` branches with `additionalProperties:
+ * false`, and the shared AJV instance strips unknown properties (`removeAdditional` in utils/ajv.ts),
+ * so validating `{ taskId }` against the actorId branch would drop `taskId` before the taskId branch
+ * is tried. "Exactly one of actorId / taskId" is therefore checked in `buildApiActions`.
+ */
+export const scheduleActionSchema = z.object({
+    actorId: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Actor to run: its ID, its name (resolved against your own Actors), or "username/actor-name". Give either actorId or taskId, never both.'),
+    taskId: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Task to run: its ID, its name (resolved against your own tasks), or "username/task-name".'),
+    input: z
+        .looseObject({})
+        .optional()
+        .describe('For an Actor: the input JSON it runs with. For a task: top-level keys that override the stored task input for this run (shallow merge; a nested object replaces the stored one).'),
+    build: z.string().optional().describe('Actor actions only: build tag or number to run, e.g. "latest".'),
+    timeoutSecs: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Actor actions only: run timeout in seconds; 0 means no timeout.'),
+    memoryMbytes: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Actor actions only: memory limit for the run in megabytes.'),
+    restartOnError: z.boolean().optional().describe('Actor actions only: restart the run when it fails.'),
+});
+/** Every schedule field the tools write, all optional; the create tool tightens `cronExpression` and `isEnabled`. */
+export const scheduleFieldsSchema = z.object({
+    name: scheduleNameSchema
+        .optional()
+        .describe('Name of the schedule, unique within the account: 3-63 characters, letters, digits and dashes only (e.g. "insta-daily"). Generated when omitted.'),
+    title: z
+        .string()
+        .max(40)
+        .optional()
+        .describe('Human-readable title, at most 40 characters. Generated from the name when omitted.'),
+    description: z.string().max(5000).optional().describe('What the schedule is for.'),
+    cronExpression: cronExpressionSchema.optional().describe(CRON_EXPRESSION_DESCRIPTION),
+    timezone: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('IANA time zone the cron expression is evaluated in, e.g. "Europe/Prague", "America/New_York", "Asia/Tokyo". Default "UTC". Take it from the user\'s wording ("9am Prague time").'),
+    isEnabled: z
+        .boolean()
+        .optional()
+        .describe('Whether the schedule fires. false pauses it without losing its configuration.'),
+    isExclusive: z
+        .boolean()
+        .optional()
+        .describe('If true (the default), an action is skipped while its previous scheduled run is still running.'),
+});
+/** Fetches a schedule by ID, name, or `username/name`. */
+export async function getScheduleByIdOrName(client, idOrName) {
+    return getResourceByIdOrName(idOrName, async (safeId) => client.schedule(safeId).get());
+}
+/**
+ * Resolves the Actor an action runs to its ID, which is all the schedule API accepts.
+ *
+ * Deliberately NOT `getActorDefinitionCached`: a bare name is caller-relative (`~name` means "my own
+ * Actor called name"), while `actorDefinitionCache` is process-wide and serves any cached public
+ * Actor to any caller. Keying it by `~name` let one tenant's public Actor answer another tenant's
+ * bare name — scheduling the wrong Actor, or succeeding where the answer is not-found. Every other
+ * caller of that cache passes an absolute key (an ID or `username/name`), so the fix is to keep
+ * caller-relative names out of it rather than to weaken the cache.
+ *
+ * That lookup is also the wrong shape for scheduling: it fetches the Actor's default build, and a
+ * never-built Actor schedules fine but has no build, so `defaultBuild()` raises `unknown-build-tag`
+ * (403). `getActorDefinition` maps only 404/400 to null, so that error surfaces to the user as a
+ * failed create. `actor(id).get()` resolves the ID without touching a build. Covered by
+ * `tests/unit/tools.schedule_actor_resolution.test.ts`.
+ */
+async function resolveActorId(client, idOrName) {
+    const actor = await getResourceByIdOrName(idOrName, async (safeId) => client.actor(safeId).get());
+    return actor === null || actor === void 0 ? void 0 : actor.id;
+}
+/**
+ * Converts the flat tool actions to the API shape. Actor and task references are resolved to IDs
+ * here because the API looks both up by ID only and would answer `schedule-actor-not-found` for a
+ * name. The first problem is returned as `{ error }` so the tool can answer before any write.
+ */
+export async function buildApiActions(client, actions) {
+    // Counted before resolving anything: an over-limit list costs one lookup per action otherwise.
+    // Actions naming both kinds or neither are counted in neither and reported by the loop below.
+    const taskActionCount = actions.filter((action) => action.taskId !== undefined).length;
+    const actorActionCount = actions.filter((action) => action.taskId === undefined && action.actorId !== undefined).length;
+    if (actorActionCount > MAX_ACTIONS_PER_TYPE) {
+        return { error: `A schedule runs at most ${MAX_ACTIONS_PER_TYPE} Actors; ${actorActionCount} were given.` };
+    }
+    if (taskActionCount > MAX_ACTIONS_PER_TYPE) {
+        return { error: `A schedule runs at most ${MAX_ACTIONS_PER_TYPE} tasks; ${taskActionCount} were given.` };
+    }
+    const apiActions = [];
+    for (const [index, { actorId, taskId, input, build, timeoutSecs, memoryMbytes, restartOnError },] of actions.entries()) {
+        if (taskId !== undefined) {
+            if (actorId !== undefined) {
+                return { error: `Action ${index + 1} names both an Actor and a task; give either actorId or taskId.` };
+            }
+            const task = await getTaskByIdOrName(client, taskId);
+            if (!task)
+                return { error: `Task ${taskId} was not found.` };
+            apiActions.push({
+                type: ScheduleActions.RunActorTask,
+                actorTaskId: task.id,
+                // apify-client types `input` as a string, but the API rejects a string and requires an object.
+                ...(input && { input: input }),
+            });
+            continue;
+        }
+        if (actorId === undefined) {
+            return { error: `Action ${index + 1} names nothing to run; give actorId or taskId.` };
+        }
+        const resolvedActorId = await resolveActorId(client, actorId);
+        if (!resolvedActorId)
+            return { error: `Actor ${actorId} was not found.` };
+        const runOptions = {
+            ...(build !== undefined && { build }),
+            ...(timeoutSecs !== undefined && { timeoutSecs }),
+            ...(memoryMbytes !== undefined && { memoryMbytes }),
+            ...(restartOnError !== undefined && { restartOnError }),
+        };
+        apiActions.push({
+            type: ScheduleActions.RunActor,
+            actorId: resolvedActorId,
+            ...(input && { runInput: { body: JSON.stringify(input), contentType: JSON_CONTENT_TYPE } }),
+            // apify-client types every run option as required; the API accepts any subset.
+            ...(Object.keys(runOptions).length > 0 && { runOptions: runOptions }),
+        });
+    }
+    return { actions: apiActions };
+}
+/** A JSON body comes back as the object the tool sent; anything else stays a string. */
+function parseRunInputBody({ body, contentType }) {
+    if (!(contentType === null || contentType === void 0 ? void 0 : contentType.startsWith('application/json')))
+        return body;
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return body;
+    }
+}
+/** Inverse of `buildApiActions`: the API's tagged action as the flat shape the tools accept. */
+function fromApiAction(action) {
+    if (action.type === ScheduleActions.RunActorTask) {
+        // The API returns the stored task input parsed, despite the client's `string` type.
+        return {
+            taskId: action.actorTaskId,
+            ...(action.input !== undefined && action.input !== null && { input: action.input }),
+        };
+    }
+    const { runInput, runOptions } = action;
+    return {
+        actorId: action.actorId,
+        ...((runInput === null || runInput === void 0 ? void 0 : runInput.body) !== undefined && { input: parseRunInputBody(runInput) }),
+        ...((runOptions === null || runOptions === void 0 ? void 0 : runOptions.build) !== undefined && { build: runOptions.build }),
+        ...((runOptions === null || runOptions === void 0 ? void 0 : runOptions.timeoutSecs) !== undefined && { timeoutSecs: runOptions.timeoutSecs }),
+        ...((runOptions === null || runOptions === void 0 ? void 0 : runOptions.memoryMbytes) !== undefined && { memoryMbytes: runOptions.memoryMbytes }),
+        ...((runOptions === null || runOptions === void 0 ? void 0 : runOptions.restartOnError) !== undefined && { restartOnError: runOptions.restartOnError }),
+    };
+}
+/** The schedule subset returned by the create, get and update tools. */
+export function buildScheduleResult(schedule) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    return {
+        scheduleId: schedule.id,
+        name: schedule.name,
+        title: (_a = schedule.title) !== null && _a !== void 0 ? _a : null,
+        description: (_b = schedule.description) !== null && _b !== void 0 ? _b : null,
+        cronExpression: schedule.cronExpression,
+        timezone: schedule.timezone,
+        isEnabled: schedule.isEnabled,
+        isExclusive: schedule.isExclusive,
+        // The client turns every `*At` field into a Date although its types promise strings, and the
+        // declared output schema promises ISO strings. nextRunAt is null while the schedule is disabled.
+        nextRunAt: (_c = toIsoString(schedule.nextRunAt)) !== null && _c !== void 0 ? _c : null,
+        lastRunAt: (_d = toIsoString(schedule.lastRunAt)) !== null && _d !== void 0 ? _d : null,
+        createdAt: (_e = toIsoString(schedule.createdAt)) !== null && _e !== void 0 ? _e : null,
+        modifiedAt: (_f = toIsoString(schedule.modifiedAt)) !== null && _f !== void 0 ? _f : null,
+        actions: ((_g = schedule.actions) !== null && _g !== void 0 ? _g : []).map(fromApiAction),
+    };
+}
+/** Cadence and state for a summary; a disabled schedule has no next run, so it never prints "null". */
+export function formatScheduleState({ actions, cronExpression, timezone, isEnabled, nextRunAt, }) {
+    const count = `${actions.length} action${actions.length === 1 ? '' : 's'}`;
+    const state = isEnabled
+        ? `enabled, next run at ${nextRunAt !== null && nextRunAt !== void 0 ? nextRunAt : 'unknown'}`
+        : 'disabled — it will not run until enabled';
+    return `${count} on "${cronExpression}" (${timezone}); ${state}`;
+}
+/** The Actor and task references exactly as the caller gave them, for the create and update summaries. */
+export function formatRequestedActions(actions) {
+    return actions
+        .map(({ actorId, taskId }) => (taskId !== undefined ? `task ${taskId}` : `Actor ${actorId}`))
+        .join(', ');
+}
+//# sourceMappingURL=schedule_helpers.js.map

package/dist/tools/schedules/schedule_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule_helpers.js","sourceRoot":"","sources":["../../../src/tools/schedules/schedule_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,eAAe,GAIlB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQpF,MAAM,CAAC,MAAM,iBAAiB,GAAG,iCAAiC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,MAAM,CAAC,MAAM,2BAA2B,GACpC,8GAA8G;IAC9G,0GAA0G;IAC1G,2GAA2G;IAC3G,6GAA6G;IAC7G,6GAA6G;IAC7G,6BAA6B,CAAC;AAElC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACL,yIAAyI,CAC5I;IACL,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,2FAA2F,CAAC;IAC1G,KAAK,EAAE,CAAC;SACH,WAAW,CAAC,EAAE,CAAC;SACf,QAAQ,EAAE;SACV,QAAQ,CACL,kLAAkL,CACrL;IACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IACvG,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAChF,YAAY,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IAC3E,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;CACxG,CAAC,CAAC;AAGH,qHAAqH;AACrH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,kBAAkB;SACnB,QAAQ,EAAE;SACV,QAAQ,CACL,iJAAiJ,CACpJ;IACL,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,oFAAoF,CAAC;IACnG,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAClF,cAAc,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACrF,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACL,kLAAkL,CACrL;IACL,SAAS,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;IAC9F,WAAW,EAAE,CAAC;SACT,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gGAAgG,CAAC;CAClH,CAAC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAmB,EAAE,QAAgB;IAC7E,OAAO,qBAAqB,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,cAAc,CAAC,MAAmB,EAAE,QAAgB;IAC/D,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAClG,OAAO,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,EAAE,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAmB,EACnB,OAA8B;IAE9B,+FAA+F;IAC/F,8FAA8F;IAC9F,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACvF,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CACnC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAC1E,CAAC,MAAM,CAAC;IACT,IAAI,gBAAgB,GAAG,oBAAoB,EAAE,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,2BAA2B,oBAAoB,YAAY,gBAAgB,cAAc,EAAE,CAAC;IAChH,CAAC;IACD,IAAI,eAAe,GAAG,oBAAoB,EAAE,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,2BAA2B,oBAAoB,WAAW,eAAe,cAAc,EAAE,CAAC;IAC9G,CAAC;IAED,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,KAAK,MAAM,CACP,KAAK,EACL,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,EAC/E,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACrB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,EAAE,KAAK,EAAE,UAAU,KAAK,GAAG,CAAC,iEAAiE,EAAE,CAAC;YAC3G,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,MAAM,iBAAiB,EAAE,CAAC;YAC7D,UAAU,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,eAAe,CAAC,YAAY;gBAClC,WAAW,EAAE,IAAI,CAAC,EAAE;gBACpB,+FAA+F;gBAC/F,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,KAA0B,EAAE,CAAC;aACtD,CAAC,CAAC;YACH,SAAS;QACb,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,UAAU,KAAK,GAAG,CAAC,gDAAgD,EAAE,CAAC;QAC1F,CAAC;QACD,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,eAAe;YAAE,OAAO,EAAE,KAAK,EAAE,SAAS,OAAO,iBAAiB,EAAE,CAAC;QAC1E,MAAM,UAAU,GAAG;YACf,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;YACrC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;YACjD,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;YACnD,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,CAAC;SAC1D,CAAC;QACF,UAAU,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,eAAe,CAAC,QAAQ;YAC9B,OAAO,EAAE,eAAe;YACxB,GAAG,CAAC,KAAK,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE,CAAC;YAC3F,+EAA+E;YAC/E,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,UAAsC,EAAE,CAAC;SACpG,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACnC,CAAC;AAKD,wFAAwF;AACxF,SAAS,iBAAiB,CAAC,EAAE,IAAI,EAAE,WAAW,EAA0B;IACpE,IAAI,CAAC,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,UAAU,CAAC,kBAAkB,CAAC,CAAA;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,gGAAgG;AAChG,SAAS,aAAa,CAAC,MAAsB;IACzC,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe,CAAC,YAAY,EAAE,CAAC;QAC/C,oFAAoF;QACpF,OAAO;YACH,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAgB,EAAE,CAAC;SACjG,CAAC;IACN,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IACxC,OAAO;QACH,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,MAAK,SAAS,IAAI,EAAE,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,KAAK,MAAK,SAAS,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;QACnE,GAAG,CAAC,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,WAAW,MAAK,SAAS,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC;QACrF,GAAG,CAAC,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,YAAY,MAAK,SAAS,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC;QACxF,GAAG,CAAC,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,cAAc,MAAK,SAAS,IAAI,EAAE,cAAc,EAAE,UAAU,CAAC,cAAc,EAAE,CAAC;KACjG,CAAC;AACN,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CAAC,QAAkB;;IAClD,OAAO;QACH,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,MAAA,QAAQ,CAAC,KAAK,mCAAI,IAAI;QAC7B,WAAW,EAAE,MAAA,QAAQ,CAAC,WAAW,mCAAI,IAAI;QACzC,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,6FAA6F;QAC7F,iGAAiG;QACjG,SAAS,EAAE,MAAA,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,mCAAI,IAAI;QAClD,SAAS,EAAE,MAAA,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,mCAAI,IAAI;QAClD,SAAS,EAAE,MAAA,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,mCAAI,IAAI;QAClD,UAAU,EAAE,MAAA,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,mCAAI,IAAI;QACpD,OAAO,EAAE,CAAC,MAAA,QAAQ,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;KACvD,CAAC;AACN,CAAC;AAGD,uGAAuG;AACvG,MAAM,UAAU,mBAAmB,CAAC,EAChC,OAAO,EACP,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,GACI;IACb,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,MAAM,UAAU,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3E,MAAM,KAAK,GAAG,SAAS;QACnB,CAAC,CAAC,wBAAwB,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,SAAS,EAAE;QAClD,CAAC,CAAC,0CAA0C,CAAC;IACjD,OAAO,GAAG,KAAK,QAAQ,cAAc,MAAM,QAAQ,MAAM,KAAK,EAAE,CAAC;AACrE,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,sBAAsB,CAAC,OAA8B;IACjE,OAAO,OAAO;SACT,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;SAC5F,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/tools/schedules/update_schedule.d.ts

@@ -0,0 +1,6 @@
+import type { ToolEntry } from '../../types.js';
+/**
+ * https://docs.apify.com/api/v2/schedule-put
+ */
+export declare const updateSchedule: ToolEntry;
+//# sourceMappingURL=update_schedule.d.ts.map

package/dist/tools/schedules/update_schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_schedule.d.ts","sourceRoot":"","sources":["../../../src/tools/schedules/update_schedule.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA4C,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAwD3G;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAsDlB,CAAC"}

package/dist/tools/schedules/update_schedule.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { HELPER_TOOLS } from '../../const.js';
+import { ALL_TOOLS_PRESENT, TOOL_TYPE } from '../../types.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { respondOk, respondUserError } from '../../utils/mcp.js';
+import { scheduleOutputSchema } from '../structured_output_schemas.js';
+import { isAmbiguousResourceId, toSafeResourceId } from '../tasks/task_helpers.js';
+import { buildApiActions, buildScheduleResult, formatRequestedActions, formatScheduleState, getScheduleByIdOrName, MAX_ACTIONS_PER_TYPE, scheduleActionSchema, scheduleFieldsSchema, } from './schedule_helpers.js';
+const updateScheduleArgs = z.object({
+    scheduleId: z
+        .string()
+        .min(1)
+        .describe('The schedule to update: its ID, its name (resolved against your own schedules), or "username/schedule-name" for a schedule owned by someone else.'),
+    ...scheduleFieldsSchema.shape,
+    actions: z
+        .array(scheduleActionSchema)
+        .min(1)
+        .max(20)
+        .optional()
+        .describe(`Replaces ALL stored actions, Actor and task actions alike: send every action to keep, the ones left out are deleted. Omit to leave the actions unchanged. At most ${MAX_ACTIONS_PER_TYPE} Actor entries and ${MAX_ACTIONS_PER_TYPE} task entries, counted separately.`),
+});
+function buildDescription({ hasTool }) {
+    return `Update a schedule: its cron expression or time zone, enable or disable it, rename it, or replace its actions.
+Fields you omit keep their stored value. "Pause", "stop" or "turn off" mean \`isEnabled: false\`; "resume" or
+"turn on" mean \`isEnabled: true\` — never delete a schedule to pause it.
+\`actions\` replaces all stored actions, Actor and task actions alike: to add or remove one, ${hasTool(HELPER_TOOLS.SCHEDULE_GET)
+        ? `read the schedule with ${HELPER_TOOLS.SCHEDULE_GET}`
+        : 'read the schedule first'}, copy its \`actions\`, edit the copy, and send the whole array. Replacing actions restarts exclusivity tracking,
+so a run already in progress is not counted.
+
+USAGE:
+- Use to change when a schedule fires, to pause or resume it, or to change what it runs.
+
+USAGE EXAMPLES:
+- user_input: Pause my schedule insta-daily
+- user_input: Change schedule insta-daily to run every 6 hours
+- user_input: Add my task weekly-report to schedule insta-daily`;
+}
+/**
+ * https://docs.apify.com/api/v2/schedule-put
+ */
+export const updateSchedule = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.SCHEDULE_UPDATE,
+    title: 'Update schedule',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: z.toJSONSchema(updateScheduleArgs),
+    outputSchema: scheduleOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(updateScheduleArgs)),
+    annotations: {
+        title: 'Update schedule',
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyClient: client } = toolArgs;
+        const { scheduleId, actions, name, title, description, cronExpression, timezone, isEnabled, isExclusive } = updateScheduleArgs.parse(args);
+        // The API merges the fields it receives, so no pre-read is needed to keep the rest — only an
+        // ambiguous scheduleId (an ID-shaped name) has to be pinned to the real ID by lookup.
+        let resolvedScheduleId = toSafeResourceId(scheduleId);
+        if (isAmbiguousResourceId(scheduleId)) {
+            const stored = await getScheduleByIdOrName(client, scheduleId);
+            if (!stored)
+                return respondUserError(`Schedule ${scheduleId} was not found.`);
+            resolvedScheduleId = stored.id;
+        }
+        const built = actions ? await buildApiActions(client, actions) : undefined;
+        if (built && 'error' in built)
+            return respondUserError(built.error);
+        const update = {
+            ...(name && { name }),
+            ...(title !== undefined && { title }),
+            ...(description !== undefined && { description }),
+            ...(cronExpression && { cronExpression }),
+            // The client's `Timezone` union has no runtime list to validate against; the API validates the name.
+            ...(timezone && { timezone: timezone }),
+            ...(isEnabled !== undefined && { isEnabled }),
+            ...(isExclusive !== undefined && { isExclusive }),
+            ...(built && { actions: built.actions }),
+        };
+        const schedule = await client.schedule(resolvedScheduleId).update(update);
+        const result = buildScheduleResult(schedule);
+        const replaced = actions ? `, now running ${formatRequestedActions(actions)}` : '';
+        const summary = `Updated schedule "${result.name}" (ID: ${result.scheduleId})${replaced}: ${formatScheduleState(result)}.`;
+        return respondOk([JSON.stringify(result), summary], { structuredContent: result });
+    },
+});
+//# sourceMappingURL=update_schedule.js.map

package/dist/tools/schedules/update_schedule.js.map

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

package/dist/tools/structured_output_schemas.d.ts

@@ -1257,6 +1257,117 @@ export declare const actorTaskOutputSchema: {
     };
     required: string[];
 };
+/** Schema shared by the schedule create, get and update tools. */
+export declare const scheduleOutputSchema: {
+    type: "object";
+    properties: {
+        scheduleId: {
+            type: string;
+            description: string;
+        };
+        name: {
+            type: string;
+            description: string;
+        };
+        title: {
+            type: string[];
+            description: string;
+        };
+        description: {
+            type: string[];
+            description: string;
+        };
+        cronExpression: {
+            type: string;
+            description: string;
+        };
+        timezone: {
+            type: string;
+            description: string;
+        };
+        isEnabled: {
+            type: string;
+            description: string;
+        };
+        isExclusive: {
+            type: string;
+            description: string;
+        };
+        nextRunAt: {
+            type: string[];
+            description: string;
+        };
+        lastRunAt: {
+            type: string[];
+            description: string;
+        };
+        createdAt: {
+            type: string[];
+            description: string;
+        };
+        modifiedAt: {
+            type: string[];
+            description: string;
+        };
+        actions: {
+            type: string;
+            items: {
+                type: "object";
+                properties: {
+                    actorId: {
+                        type: string;
+                        description: string;
+                    };
+                    taskId: {
+                        type: string;
+                        description: string;
+                    };
+                    input: {
+                        type: string[];
+                        description: string;
+                    };
+                    build: {
+                        type: string;
+                        description: string;
+                    };
+                    timeoutSecs: {
+                        type: string;
+                        description: string;
+                    };
+                    memoryMbytes: {
+                        type: string;
+                        description: string;
+                    };
+                    restartOnError: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
+            description: string;
+        };
+    };
+    required: string[];
+};
+/** Schema for delete-schedule. */
+export declare const scheduleDeleteOutputSchema: {
+    type: "object";
+    properties: {
+        scheduleId: {
+            type: string;
+            description: string;
+        };
+        name: {
+            type: string;
+            description: string;
+        };
+        deleted: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
 /**
  * Schema for get-actor-run-log. The log API returns plain text, so the schema wraps it in a single field.
  */

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

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

package/dist/tools/structured_output_schemas.js

@@ -362,6 +362,80 @@ export const actorTaskOutputSchema = {
     },
     required: ['taskId', 'actorId', 'name', 'title', 'description', 'publishedAt', 'publicConfig', 'input'],
 };
+/** One schedule action, in the same flat shape the schedule tools accept as input. */
+const scheduleActionOutputSchema = {
+    type: 'object',
+    properties: {
+        actorId: { type: 'string', description: 'ID of the Actor this action runs (Actor actions only)' },
+        taskId: { type: 'string', description: 'ID of the task this action runs (task actions only)' },
+        input: {
+            type: ['object', 'array', 'string', 'number', 'boolean', 'null'],
+            description: 'The Actor input, or the overrides applied on top of the stored task input; secret fields are ' +
+                'encrypted placeholders. A non-JSON Actor input body is returned as a string.',
+        },
+        build: { type: 'string', description: 'Actor build tag or number (Actor actions only)' },
+        timeoutSecs: { type: 'number', description: 'Run timeout in seconds (Actor actions only)' },
+        memoryMbytes: { type: 'number', description: 'Run memory limit in megabytes (Actor actions only)' },
+        restartOnError: { type: 'boolean', description: 'Restart the run when it fails (Actor actions only)' },
+    },
+};
+/** Schema shared by the schedule create, get and update tools. */
+export const scheduleOutputSchema = {
+    type: 'object',
+    properties: {
+        scheduleId: { type: 'string', description: 'ID of the schedule' },
+        name: { type: 'string', description: 'Name of the schedule' },
+        title: { type: ['string', 'null'], description: 'Human-readable title of the schedule' },
+        description: { type: ['string', 'null'], description: 'Description of the schedule' },
+        cronExpression: { type: 'string', description: 'When the schedule fires, as a cron expression' },
+        timezone: { type: 'string', description: 'Time zone the cron expression is evaluated in' },
+        isEnabled: { type: 'boolean', description: 'Whether the schedule fires' },
+        isExclusive: {
+            type: 'boolean',
+            description: 'Whether an action is skipped while its previous scheduled run is still running',
+        },
+        nextRunAt: {
+            type: ['string', 'null'],
+            description: 'Next firing time (ISO 8601); null while the schedule is disabled',
+        },
+        lastRunAt: {
+            type: ['string', 'null'],
+            description: 'Last firing time (ISO 8601); null when the schedule has not fired yet',
+        },
+        createdAt: { type: ['string', 'null'], description: 'When the schedule was created (ISO 8601)' },
+        modifiedAt: { type: ['string', 'null'], description: 'When the schedule was last changed (ISO 8601)' },
+        actions: {
+            type: 'array',
+            items: scheduleActionOutputSchema,
+            description: 'What the schedule runs, in the same shape the schedule tools accept as input',
+        },
+    },
+    required: [
+        'scheduleId',
+        'name',
+        'title',
+        'description',
+        'cronExpression',
+        'timezone',
+        'isEnabled',
+        'isExclusive',
+        'nextRunAt',
+        'lastRunAt',
+        'createdAt',
+        'modifiedAt',
+        'actions',
+    ],
+};
+/** Schema for delete-schedule. */
+export const scheduleDeleteOutputSchema = {
+    type: 'object',
+    properties: {
+        scheduleId: { type: 'string', description: 'ID of the deleted schedule' },
+        name: { type: 'string', description: 'Name of the deleted schedule' },
+        deleted: { type: 'boolean', description: 'Always true; the schedule no longer exists' },
+    },
+    required: ['scheduleId', 'name', 'deleted'],
+};
 /**
  * Schema for get-actor-run-log. The log API returns plain text, so the schema wraps it in a single field.
  */