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

package/dist/tools/registry.d.ts

@@ -24,6 +24,7 @@ export declare const toolCategories: {
     runs: ToolEntry[];
     storage: ToolEntry[];
     tasks: ToolEntry[];
+    schedules: ToolEntry[];
     dev: ToolEntry[];
 };
 /**

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;AA6B1C,kEAAkE;AAClE,eAAO,MAAM,cAAc;;;;;;;CAgBY,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;AAiC1C,kEAAkE;AAClE,eAAO,MAAM,cAAc;;;;;;;;CAiBY,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

@@ -26,6 +26,10 @@ import { abortActorRun } from './runs/abort_actor_run.js';
 import { getActorRun } from './runs/get_actor_run.js';
 import { getActorRunList } from './runs/get_actor_run_list.js';
 import { getActorRunLog } from './runs/get_actor_run_log.js';
+import { createSchedule } from './schedules/create_schedule.js';
+import { deleteSchedule } from './schedules/delete_schedule.js';
+import { getSchedule } from './schedules/get_schedule.js';
+import { updateSchedule } from './schedules/update_schedule.js';
 import { getDataset } from './storage/get_dataset.js';
 import { getDatasetItems } from './storage/get_dataset_items.js';
 import { getDatasetList } from './storage/get_dataset_list.js';
@@ -59,6 +63,7 @@ export const toolCategories = {
         getKeyValueStoreList,
     ],
     tasks: [createActorTask, getActorTask, updateActorTask, publishActorTask, unpublishActorTask],
+    schedules: [createSchedule, getSchedule, updateSchedule, deleteSchedule],
     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/schedules/create_schedule.d.ts

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

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

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

package/dist/tools/schedules/create_schedule.js

@@ -0,0 +1,85 @@
+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 { buildApiActions, buildScheduleResult, CRON_EXPRESSION_DESCRIPTION, cronExpressionSchema, formatRequestedActions, formatScheduleState, MAX_ACTIONS_PER_TYPE, scheduleActionSchema, scheduleFieldsSchema, } from './schedule_helpers.js';
+const createScheduleArgs = z.object({
+    ...scheduleFieldsSchema.shape,
+    cronExpression: cronExpressionSchema.describe(CRON_EXPRESSION_DESCRIPTION),
+    isEnabled: z
+        .boolean()
+        .default(true)
+        .describe('Whether the schedule fires. Defaults to true, so it starts at its next cron time; pass false to create it paused.'),
+    actions: z
+        .array(scheduleActionSchema)
+        .min(1)
+        .max(20)
+        .describe(`What runs at each firing: one entry per Actor or task. At most ${MAX_ACTIONS_PER_TYPE} Actor entries and ${MAX_ACTIONS_PER_TYPE} task entries, counted separately.`),
+});
+function buildDescription({ hasTool }) {
+    return `Create a schedule that runs Actors and saved Actor tasks automatically on a cron cadence. Each action
+runs one Actor (with its own input and run options) or one task (its stored input, optionally with top-level
+overrides); Actor and task names are resolved to IDs before the schedule is saved.
+The schedule is created enabled unless \`isEnabled: false\` is passed, and fires in \`timezone\` (default UTC).
+Up to 10 Actor actions and 10 task actions; while a previous run from an action is still running, the next one
+is skipped (\`isExclusive\`, default true).
+${hasTool(HELPER_TOOLS.ACTOR_CALL)
+        ? `A schedule cannot be triggered manually here; to run the Actor or task right now, use ${HELPER_TOOLS.ACTOR_CALL}.\n`
+        : ''}
+USAGE:
+- Use when the user wants an Actor or task to run repeatedly at set times.
+- Turn the user's wording into a 5-field cron expression plus their time zone; use @daily-style shortcuts only when no time is named, because they fire at a random offset within the period.${hasTool(HELPER_TOOLS.STORE_SEARCH)
+        ? `\n- When the user names the Actor loosely, resolve it with ${HELPER_TOOLS.STORE_SEARCH} instead of guessing an ID.`
+        : ''}${hasTool(HELPER_TOOLS.ACTOR_GET_DETAILS)
+        ? `\n- Once you have the exact Actor, read its input schema with ${HELPER_TOOLS.ACTOR_GET_DETAILS} before setting an action's input.`
+        : ''}${hasTool(HELPER_TOOLS.ACTOR_TASK_CREATE)
+        ? `\n- To keep the configuration reusable outside the schedule, save it with ${HELPER_TOOLS.ACTOR_TASK_CREATE} first and schedule the task.`
+        : ''}
+
+USAGE EXAMPLES:
+- user_input: Run my task insta-daily every day at 9am Prague time
+- user_input: Schedule apify/instagram-scraper every Monday morning with this input`;
+}
+/**
+ * https://docs.apify.com/api/v2/schedules-post
+ */
+export const createSchedule = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.SCHEDULE_CREATE,
+    title: 'Create schedule',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: z.toJSONSchema(createScheduleArgs),
+    outputSchema: scheduleOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(createScheduleArgs)),
+    annotations: {
+        title: 'Create schedule',
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyClient: client } = toolArgs;
+        const { actions, cronExpression, timezone, isEnabled, isExclusive, name, title, description } = createScheduleArgs.parse(args);
+        const built = await buildApiActions(client, actions);
+        if ('error' in built)
+            return respondUserError(built.error);
+        const schedule = await client.schedules().create({
+            cronExpression,
+            isEnabled,
+            ...(name && { name }),
+            ...(title !== undefined && { title }),
+            ...(description !== undefined && { description }),
+            ...(timezone && { timezone: timezone }),
+            ...(isExclusive !== undefined && { isExclusive }),
+            actions: built.actions,
+        });
+        const result = buildScheduleResult(schedule);
+        const summary = `Created schedule "${result.name}" (ID: ${result.scheduleId}) running ${formatRequestedActions(actions)}: ${formatScheduleState(result)}.`;
+        return respondOk([JSON.stringify(result), summary], { structuredContent: result });
+    },
+});
+//# sourceMappingURL=create_schedule.js.map

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

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

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

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

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

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

package/dist/tools/schedules/delete_schedule.js

@@ -0,0 +1,59 @@
+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 { scheduleDeleteOutputSchema } from '../structured_output_schemas.js';
+import { getScheduleByIdOrName } from './schedule_helpers.js';
+const deleteScheduleArgs = z.object({
+    scheduleId: z
+        .string()
+        .min(1)
+        .describe('The schedule to delete: its ID, its name (resolved against your own schedules), or "username/schedule-name" for a schedule owned by someone else.'),
+});
+function buildDescription({ hasTool }) {
+    return `Delete a schedule permanently. Its future runs stop; runs that already started are not affected, and the
+Actors and tasks it referenced are kept. To stop a schedule temporarily, disable it instead${hasTool(HELPER_TOOLS.SCHEDULE_UPDATE) ? ` with ${HELPER_TOOLS.SCHEDULE_UPDATE}` : ''}.
+
+USAGE:
+- Use only when the user explicitly wants the schedule removed.
+
+USAGE EXAMPLES:
+- user_input: Delete my schedule insta-daily
+- user_input: Remove schedule E2jjCZBezvAZnX8Rb`;
+}
+/**
+ * https://docs.apify.com/api/v2/schedule-delete
+ */
+export const deleteSchedule = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.SCHEDULE_DELETE,
+    title: 'Delete schedule',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: z.toJSONSchema(deleteScheduleArgs),
+    outputSchema: scheduleDeleteOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(deleteScheduleArgs)),
+    annotations: {
+        title: 'Delete schedule',
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyClient: client } = toolArgs;
+        const parsed = deleteScheduleArgs.parse(args);
+        // The client swallows a 404 on delete, so read first to report a missing schedule and to
+        // name the one that was removed.
+        const schedule = await getScheduleByIdOrName(client, parsed.scheduleId);
+        if (!schedule) {
+            return respondUserError(`Schedule ${parsed.scheduleId} was not found.`);
+        }
+        await client.schedule(schedule.id).delete();
+        const result = { scheduleId: schedule.id, name: schedule.name, deleted: true };
+        const summary = `Deleted schedule "${schedule.name}" (ID: ${schedule.id}).`;
+        return respondOk([JSON.stringify(result), summary], { structuredContent: result });
+    },
+});
+//# sourceMappingURL=delete_schedule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete_schedule.js","sourceRoot":"","sources":["../../../src/tools/schedules/delete_schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACL,mJAAmJ,CACtJ;CACR,CAAC,CAAC;AAEH,SAAS,gBAAgB,CAAC,EAAE,OAAO,EAA0B;IACzD,OAAO;6FAEH,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EACtF;;;;;;;gDAO4C,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc,MAAM,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,eAAe;IAClC,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;IAChD,gBAAgB;IAChB,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,kBAAkB,CAAoB;IAClE,YAAY,EAAE,0BAA0B;IACxC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAC9D,WAAW,EAAE;QACT,KAAK,EAAE,iBAAiB;QACxB,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC/C,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,yFAAyF;QACzF,iCAAiC;QACjC,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,gBAAgB,CAAC,YAAY,MAAM,CAAC,UAAU,iBAAiB,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAE5C,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC/E,MAAM,OAAO,GAAG,qBAAqB,QAAQ,CAAC,IAAI,UAAU,QAAQ,CAAC,EAAE,IAAI,CAAC;QAC5E,OAAO,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;CACK,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_schedule.d.ts","sourceRoot":"","sources":["../../../src/tools/schedules/get_schedule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA4C,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAmC3G;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,SA4Bf,CAAC"}

package/dist/tools/schedules/get_schedule.js

@@ -0,0 +1,61 @@
+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 { buildScheduleResult, formatScheduleState, getScheduleByIdOrName } from './schedule_helpers.js';
+const getScheduleArgs = z.object({
+    scheduleId: z
+        .string()
+        .min(1)
+        .describe('The schedule to fetch: its ID, its name (resolved against your own schedules), or "username/schedule-name" for a schedule owned by someone else.'),
+});
+function buildDescription({ hasTool }) {
+    return `Get a schedule: when it fires (cron expression and time zone), whether it is enabled, its next and last
+run times, and the Actors and tasks it runs with their inputs and run options. Input fields the Actor declares
+as secret are returned as encrypted placeholders, never in plaintext.
+Requires the schedule's name or ID from the user; no tool lists schedules.
+${hasTool(HELPER_TOOLS.SCHEDULE_UPDATE)
+        ? `Use ${HELPER_TOOLS.SCHEDULE_UPDATE} to change it; its \`actions\` field accepts this result's \`actions\` as they are (a non-JSON Actor input comes back as a string and has to be re-entered as JSON).\n`
+        : ''}
+USAGE:
+- Use when you need a schedule's current settings or want to know when it runs next.
+- Use before changing a schedule's actions, since an update replaces all of them.
+
+USAGE EXAMPLES:
+- user_input: Show me my schedule insta-daily
+- user_input: When does schedule E2jjCZBezvAZnX8Rb run next?`;
+}
+/**
+ * https://docs.apify.com/api/v2/schedule-get
+ */
+export const getSchedule = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.SCHEDULE_GET,
+    title: 'Get schedule',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: z.toJSONSchema(getScheduleArgs),
+    outputSchema: scheduleOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(getScheduleArgs)),
+    annotations: {
+        title: 'Get schedule',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyClient: client } = toolArgs;
+        const parsed = getScheduleArgs.parse(args);
+        const schedule = await getScheduleByIdOrName(client, parsed.scheduleId);
+        if (!schedule) {
+            return respondUserError(`Schedule ${parsed.scheduleId} was not found.`);
+        }
+        const result = buildScheduleResult(schedule);
+        const summary = `Schedule "${result.name}" (ID: ${result.scheduleId}) has ${formatScheduleState(result)}.`;
+        return respondOk([JSON.stringify(result), summary], { structuredContent: result });
+    },
+});
+//# sourceMappingURL=get_schedule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_schedule.js","sourceRoot":"","sources":["../../../src/tools/schedules/get_schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAExG,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,UAAU,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACL,kJAAkJ,CACrJ;CACR,CAAC,CAAC;AAEH,SAAS,gBAAgB,CAAC,EAAE,OAAO,EAA0B;IACzD,OAAO;;;;EAKP,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC;QACjC,CAAC,CAAC,OAAO,YAAY,CAAC,eAAe,wKAAwK;QAC7M,CAAC,CAAC,EACV;;;;;;;6DAO6D,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAc,MAAM,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,YAAY;IAC/B,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;IAChD,gBAAgB;IAChB,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,eAAe,CAAoB;IAC/D,YAAY,EAAE,oBAAoB;IAClC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAC3D,WAAW,EAAE;QACT,KAAK,EAAE,cAAc;QACrB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,gBAAgB,CAAC,YAAY,MAAM,CAAC,UAAU,iBAAiB,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,aAAa,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,UAAU,SAAS,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3G,OAAO,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;CACK,CAAC,CAAC"}

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

@@ -0,0 +1,86 @@
+import { type Schedule, type ScheduleCreateOrUpdateData } from 'apify-client';
+import { z } from 'zod';
+import type { ApifyClient } from '../../apify_client.js';
+/** A schedule action as the API accepts it on create and update (the server-assigned `id` is optional). */
+type ApiScheduleAction = NonNullable<ScheduleCreateOrUpdateData['actions']>[number];
+/** apify-client does not export its `Timezone` union, so derive it from the `Schedule` type. */
+export type ScheduleTimezone = Schedule['timezone'];
+export declare 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 declare const MAX_ACTIONS_PER_TYPE = 10;
+export declare const CRON_EXPRESSION_DESCRIPTION: string;
+export declare const cronExpressionSchema: z.ZodString;
+/**
+ * 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 declare const scheduleActionSchema: z.ZodObject<{
+    actorId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    build: z.ZodOptional<z.ZodString>;
+    timeoutSecs: z.ZodOptional<z.ZodNumber>;
+    memoryMbytes: z.ZodOptional<z.ZodNumber>;
+    restartOnError: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ScheduleActionInput = z.infer<typeof scheduleActionSchema>;
+/** Every schedule field the tools write, all optional; the create tool tightens `cronExpression` and `isEnabled`. */
+export declare const scheduleFieldsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    cronExpression: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    isEnabled: z.ZodOptional<z.ZodBoolean>;
+    isExclusive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Fetches a schedule by ID, name, or `username/name`. */
+export declare function getScheduleByIdOrName(client: ApifyClient, idOrName: string): Promise<Schedule | undefined>;
+/**
+ * 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 declare function buildApiActions(client: ApifyClient, actions: ScheduleActionInput[]): Promise<{
+    actions: ApiScheduleAction[];
+} | {
+    error: string;
+}>;
+/** One action as the tools return it; `input` keeps the raw body when an Actor input is not JSON. */
+type ScheduleActionResult = Omit<ScheduleActionInput, 'input'> & {
+    input?: unknown;
+};
+/** The schedule subset returned by the create, get and update tools. */
+export declare function buildScheduleResult(schedule: Schedule): {
+    scheduleId: string;
+    name: string;
+    title: string | null;
+    description: string | null;
+    cronExpression: string;
+    timezone: "Africa/Abidjan" | "Africa/Accra" | "Africa/Addis_Ababa" | "Africa/Algiers" | "Africa/Asmara" | "Africa/Asmera" | "Africa/Bamako" | "Africa/Bangui" | "Africa/Banjul" | "Africa/Bissau" | "Africa/Blantyre" | "Africa/Brazzaville" | "Africa/Bujumbura" | "Africa/Cairo" | "Africa/Casablanca" | "Africa/Ceuta" | "Africa/Conakry" | "Africa/Dakar" | "Africa/Dar_es_Salaam" | "Africa/Djibouti" | "Africa/Douala" | "Africa/El_Aaiun" | "Africa/Freetown" | "Africa/Gaborone" | "Africa/Harare" | "Africa/Johannesburg" | "Africa/Juba" | "Africa/Kampala" | "Africa/Khartoum" | "Africa/Kigali" | "Africa/Kinshasa" | "Africa/Lagos" | "Africa/Libreville" | "Africa/Lome" | "Africa/Luanda" | "Africa/Lubumbashi" | "Africa/Lusaka" | "Africa/Malabo" | "Africa/Maputo" | "Africa/Maseru" | "Africa/Mbabane" | "Africa/Mogadishu" | "Africa/Monrovia" | "Africa/Nairobi" | "Africa/Ndjamena" | "Africa/Niamey" | "Africa/Nouakchott" | "Africa/Ouagadougou" | "Africa/Porto-Novo" | "Africa/Sao_Tome" | "Africa/Timbuktu" | "Africa/Tripoli" | "Africa/Tunis" | "Africa/Windhoek" | "America/Adak" | "America/Anchorage" | "America/Anguilla" | "America/Antigua" | "America/Araguaina" | "America/Argentina/Buenos_Aires" | "America/Argentina/Catamarca" | "America/Argentina/ComodRivadavia" | "America/Argentina/Cordoba" | "America/Argentina/Jujuy" | "America/Argentina/La_Rioja" | "America/Argentina/Mendoza" | "America/Argentina/Rio_Gallegos" | "America/Argentina/Salta" | "America/Argentina/San_Juan" | "America/Argentina/San_Luis" | "America/Argentina/Tucuman" | "America/Argentina/Ushuaia" | "America/Aruba" | "America/Asuncion" | "America/Atikokan" | "America/Atka" | "America/Bahia" | "America/Bahia_Banderas" | "America/Barbados" | "America/Belem" | "America/Belize" | "America/Blanc-Sablon" | "America/Boa_Vista" | "America/Bogota" | "America/Boise" | "America/Buenos_Aires" | "America/Cambridge_Bay" | "America/Campo_Grande" | "America/Cancun" | "America/Caracas" | "America/Catamarca" | "America/Cayenne" | "America/Cayman" | "America/Chicago" | "America/Chihuahua" | "America/Coral_Harbour" | "America/Cordoba" | "America/Costa_Rica" | "America/Creston" | "America/Cuiaba" | "America/Curacao" | "America/Danmarkshavn" | "America/Dawson" | "America/Dawson_Creek" | "America/Denver" | "America/Detroit" | "America/Dominica" | "America/Edmonton" | "America/Eirunepe" | "America/El_Salvador" | "America/Ensenada" | "America/Fort_Nelson" | "America/Fort_Wayne" | "America/Fortaleza" | "America/Glace_Bay" | "America/Godthab" | "America/Goose_Bay" | "America/Grand_Turk" | "America/Grenada" | "America/Guadeloupe" | "America/Guatemala" | "America/Guayaquil" | "America/Guyana" | "America/Halifax" | "America/Havana" | "America/Hermosillo" | "America/Indiana/Indianapolis" | "America/Indiana/Knox" | "America/Indiana/Marengo" | "America/Indiana/Petersburg" | "America/Indiana/Tell_City" | "America/Indiana/Vevay" | "America/Indiana/Vincennes" | "America/Indiana/Winamac" | "America/Indianapolis" | "America/Inuvik" | "America/Iqaluit" | "America/Jamaica" | "America/Jujuy" | "America/Juneau" | "America/Kentucky/Louisville" | "America/Kentucky/Monticello" | "America/Knox_IN" | "America/Kralendijk" | "America/La_Paz" | "America/Lima" | "America/Los_Angeles" | "America/Louisville" | "America/Lower_Princes" | "America/Maceio" | "America/Managua" | "America/Manaus" | "America/Marigot" | "America/Martinique" | "America/Matamoros" | "America/Mazatlan" | "America/Mendoza" | "America/Menominee" | "America/Merida" | "America/Metlakatla" | "America/Mexico_City" | "America/Miquelon" | "America/Moncton" | "America/Monterrey" | "America/Montevideo" | "America/Montreal" | "America/Montserrat" | "America/Nassau" | "America/New_York" | "America/Nipigon" | "America/Nome" | "America/Noronha" | "America/North_Dakota/Beulah" | "America/North_Dakota/Center" | "America/North_Dakota/New_Salem" | "America/Nuuk" | "America/Ojinaga" | "America/Panama" | "America/Pangnirtung" | "America/Paramaribo" | "America/Phoenix" | "America/Port-au-Prince" | "America/Port_of_Spain" | "America/Porto_Acre" | "America/Porto_Velho" | "America/Puerto_Rico" | "America/Punta_Arenas" | "America/Rainy_River" | "America/Rankin_Inlet" | "America/Recife" | "America/Regina" | "America/Resolute" | "America/Rio_Branco" | "America/Rosario" | "America/Santa_Isabel" | "America/Santarem" | "America/Santiago" | "America/Santo_Domingo" | "America/Sao_Paulo" | "America/Scoresbysund" | "America/Shiprock" | "America/Sitka" | "America/St_Barthelemy" | "America/St_Johns" | "America/St_Kitts" | "America/St_Lucia" | "America/St_Thomas" | "America/St_Vincent" | "America/Swift_Current" | "America/Tegucigalpa" | "America/Thule" | "America/Thunder_Bay" | "America/Tijuana" | "America/Toronto" | "America/Tortola" | "America/Vancouver" | "America/Virgin" | "America/Whitehorse" | "America/Winnipeg" | "America/Yakutat" | "America/Yellowknife" | "Antarctica/Casey" | "Antarctica/Davis" | "Antarctica/DumontDUrville" | "Antarctica/Macquarie" | "Antarctica/Mawson" | "Antarctica/McMurdo" | "Antarctica/Palmer" | "Antarctica/Rothera" | "Antarctica/South_Pole" | "Antarctica/Syowa" | "Antarctica/Troll" | "Antarctica/Vostok" | "Arctic/Longyearbyen" | "Asia/Aden" | "Asia/Almaty" | "Asia/Amman" | "Asia/Anadyr" | "Asia/Aqtau" | "Asia/Aqtobe" | "Asia/Ashgabat" | "Asia/Ashkhabad" | "Asia/Atyrau" | "Asia/Baghdad" | "Asia/Bahrain" | "Asia/Baku" | "Asia/Bangkok" | "Asia/Barnaul" | "Asia/Beirut" | "Asia/Bishkek" | "Asia/Brunei" | "Asia/Calcutta" | "Asia/Chita" | "Asia/Choibalsan" | "Asia/Chongqing" | "Asia/Chungking" | "Asia/Colombo" | "Asia/Dacca" | "Asia/Damascus" | "Asia/Dhaka" | "Asia/Dili" | "Asia/Dubai" | "Asia/Dushanbe" | "Asia/Famagusta" | "Asia/Gaza" | "Asia/Harbin" | "Asia/Hebron" | "Asia/Ho_Chi_Minh" | "Asia/Hong_Kong" | "Asia/Hovd" | "Asia/Irkutsk" | "Asia/Istanbul" | "Asia/Jakarta" | "Asia/Jayapura" | "Asia/Jerusalem" | "Asia/Kabul" | "Asia/Kamchatka" | "Asia/Karachi" | "Asia/Kashgar" | "Asia/Kathmandu" | "Asia/Katmandu" | "Asia/Khandyga" | "Asia/Kolkata" | "Asia/Krasnoyarsk" | "Asia/Kuala_Lumpur" | "Asia/Kuching" | "Asia/Kuwait" | "Asia/Macao" | "Asia/Macau" | "Asia/Magadan" | "Asia/Makassar" | "Asia/Manila" | "Asia/Muscat" | "Asia/Nicosia" | "Asia/Novokuznetsk" | "Asia/Novosibirsk" | "Asia/Omsk" | "Asia/Oral" | "Asia/Phnom_Penh" | "Asia/Pontianak" | "Asia/Pyongyang" | "Asia/Qatar" | "Asia/Qostanay" | "Asia/Qyzylorda" | "Asia/Rangoon" | "Asia/Riyadh" | "Asia/Saigon" | "Asia/Sakhalin" | "Asia/Samarkand" | "Asia/Seoul" | "Asia/Shanghai" | "Asia/Singapore" | "Asia/Srednekolymsk" | "Asia/Taipei" | "Asia/Tashkent" | "Asia/Tbilisi" | "Asia/Tehran" | "Asia/Tel_Aviv" | "Asia/Thimbu" | "Asia/Thimphu" | "Asia/Tokyo" | "Asia/Tomsk" | "Asia/Ujung_Pandang" | "Asia/Ulaanbaatar" | "Asia/Ulan_Bator" | "Asia/Urumqi" | "Asia/Ust-Nera" | "Asia/Vientiane" | "Asia/Vladivostok" | "Asia/Yakutsk" | "Asia/Yangon" | "Asia/Yekaterinburg" | "Asia/Yerevan" | "Atlantic/Azores" | "Atlantic/Bermuda" | "Atlantic/Canary" | "Atlantic/Cape_Verde" | "Atlantic/Faeroe" | "Atlantic/Faroe" | "Atlantic/Jan_Mayen" | "Atlantic/Madeira" | "Atlantic/Reykjavik" | "Atlantic/South_Georgia" | "Atlantic/St_Helena" | "Atlantic/Stanley" | "Australia/ACT" | "Australia/Adelaide" | "Australia/Brisbane" | "Australia/Broken_Hill" | "Australia/Canberra" | "Australia/Currie" | "Australia/Darwin" | "Australia/Eucla" | "Australia/Hobart" | "Australia/LHI" | "Australia/Lindeman" | "Australia/Lord_Howe" | "Australia/Melbourne" | "Australia/NSW" | "Australia/North" | "Australia/Perth" | "Australia/Queensland" | "Australia/South" | "Australia/Sydney" | "Australia/Tasmania" | "Australia/Victoria" | "Australia/West" | "Australia/Yancowinna" | "Brazil/Acre" | "Brazil/DeNoronha" | "Brazil/East" | "Brazil/West" | "CET" | "CST6CDT" | "Canada/Atlantic" | "Canada/Central" | "Canada/Eastern" | "Canada/Mountain" | "Canada/Newfoundland" | "Canada/Pacific" | "Canada/Saskatchewan" | "Canada/Yukon" | "Chile/Continental" | "Chile/EasterIsland" | "Cuba" | "EET" | "EST" | "EST5EDT" | "Egypt" | "Eire" | "Etc/GMT" | "Etc/GMT+0" | "Etc/GMT+1" | "Etc/GMT+10" | "Etc/GMT+11" | "Etc/GMT+12" | "Etc/GMT+2" | "Etc/GMT+3" | "Etc/GMT+4" | "Etc/GMT+5" | "Etc/GMT+6" | "Etc/GMT+7" | "Etc/GMT+8" | "Etc/GMT+9" | "Etc/GMT-0" | "Etc/GMT-1" | "Etc/GMT-10" | "Etc/GMT-11" | "Etc/GMT-12" | "Etc/GMT-13" | "Etc/GMT-14" | "Etc/GMT-2" | "Etc/GMT-3" | "Etc/GMT-4" | "Etc/GMT-5" | "Etc/GMT-6" | "Etc/GMT-7" | "Etc/GMT-8" | "Etc/GMT-9" | "Etc/GMT0" | "Etc/Greenwich" | "Etc/UCT" | "Etc/UTC" | "Etc/Universal" | "Etc/Zulu" | "Europe/Amsterdam" | "Europe/Andorra" | "Europe/Astrakhan" | "Europe/Athens" | "Europe/Belfast" | "Europe/Belgrade" | "Europe/Berlin" | "Europe/Bratislava" | "Europe/Brussels" | "Europe/Bucharest" | "Europe/Budapest" | "Europe/Busingen" | "Europe/Chisinau" | "Europe/Copenhagen" | "Europe/Dublin" | "Europe/Gibraltar" | "Europe/Guernsey" | "Europe/Helsinki" | "Europe/Isle_of_Man" | "Europe/Istanbul" | "Europe/Jersey" | "Europe/Kaliningrad" | "Europe/Kiev" | "Europe/Kirov" | "Europe/Lisbon" | "Europe/Ljubljana" | "Europe/London" | "Europe/Luxembourg" | "Europe/Madrid" | "Europe/Malta" | "Europe/Mariehamn" | "Europe/Minsk" | "Europe/Monaco" | "Europe/Moscow" | "Europe/Nicosia" | "Europe/Oslo" | "Europe/Paris" | "Europe/Podgorica" | "Europe/Prague" | "Europe/Riga" | "Europe/Rome" | "Europe/Samara" | "Europe/San_Marino" | "Europe/Sarajevo" | "Europe/Saratov" | "Europe/Simferopol" | "Europe/Skopje" | "Europe/Sofia" | "Europe/Stockholm" | "Europe/Tallinn" | "Europe/Tirane" | "Europe/Tiraspol" | "Europe/Ulyanovsk" | "Europe/Uzhgorod" | "Europe/Vaduz" | "Europe/Vatican" | "Europe/Vienna" | "Europe/Vilnius" | "Europe/Volgograd" | "Europe/Warsaw" | "Europe/Zagreb" | "Europe/Zaporozhye" | "Europe/Zurich" | "GB" | "GB-Eire" | "GMT" | "GMT+0" | "GMT-0" | "GMT0" | "Greenwich" | "HST" | "Hongkong" | "Iceland" | "Indian/Antananarivo" | "Indian/Chagos" | "Indian/Christmas" | "Indian/Cocos" | "Indian/Comoro" | "Indian/Kerguelen" | "Indian/Mahe" | "Indian/Maldives" | "Indian/Mauritius" | "Indian/Mayotte" | "Indian/Reunion" | "Iran" | "Israel" | "Jamaica" | "Japan" | "Kwajalein" | "Libya" | "MET" | "MST" | "MST7MDT" | "Mexico/BajaNorte" | "Mexico/BajaSur" | "Mexico/General" | "NZ" | "NZ-CHAT" | "Navajo" | "PRC" | "PST8PDT" | "Pacific/Apia" | "Pacific/Auckland" | "Pacific/Bougainville" | "Pacific/Chatham" | "Pacific/Chuuk" | "Pacific/Easter" | "Pacific/Efate" | "Pacific/Enderbury" | "Pacific/Fakaofo" | "Pacific/Fiji" | "Pacific/Funafuti" | "Pacific/Galapagos" | "Pacific/Gambier" | "Pacific/Guadalcanal" | "Pacific/Guam" | "Pacific/Honolulu" | "Pacific/Johnston" | "Pacific/Kiritimati" | "Pacific/Kosrae" | "Pacific/Kwajalein" | "Pacific/Majuro" | "Pacific/Marquesas" | "Pacific/Midway" | "Pacific/Nauru" | "Pacific/Niue" | "Pacific/Norfolk" | "Pacific/Noumea" | "Pacific/Pago_Pago" | "Pacific/Palau" | "Pacific/Pitcairn" | "Pacific/Pohnpei" | "Pacific/Ponape" | "Pacific/Port_Moresby" | "Pacific/Rarotonga" | "Pacific/Saipan" | "Pacific/Samoa" | "Pacific/Tahiti" | "Pacific/Tarawa" | "Pacific/Tongatapu" | "Pacific/Truk" | "Pacific/Wake" | "Pacific/Wallis" | "Pacific/Yap" | "Poland" | "Portugal" | "ROC" | "ROK" | "Singapore" | "Turkey" | "UCT" | "US/Alaska" | "US/Aleutian" | "US/Arizona" | "US/Central" | "US/East-Indiana" | "US/Eastern" | "US/Hawaii" | "US/Indiana-Starke" | "US/Michigan" | "US/Mountain" | "US/Pacific" | "US/Samoa" | "UTC" | "Universal" | "W-SU" | "WET" | "Zulu";
+    isEnabled: boolean;
+    isExclusive: boolean;
+    nextRunAt: string | null;
+    lastRunAt: string | null;
+    createdAt: string | null;
+    modifiedAt: string | null;
+    actions: ScheduleActionResult[];
+};
+type ScheduleResult = ReturnType<typeof buildScheduleResult>;
+/** Cadence and state for a summary; a disabled schedule has no next run, so it never prints "null". */
+export declare function formatScheduleState({ actions, cronExpression, timezone, isEnabled, nextRunAt, }: ScheduleResult): string;
+/** The Actor and task references exactly as the caller gave them, for the create and update summaries. */
+export declare function formatRequestedActions(actions: ScheduleActionInput[]): string;
+export {};
+//# sourceMappingURL=schedule_helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule_helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/schedules/schedule_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,QAAQ,EAGb,KAAK,0BAA0B,EAGlC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,2GAA2G;AAC3G,KAAK,iBAAiB,GAAG,WAAW,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpF,gGAAgG;AAChG,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,iBAAiB,oCAAoC,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,2BAA2B,QAMP,CAAC;AAElC,eAAO,MAAM,oBAAoB,aAA6B,CAAC;AAW/D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;iBAiC/B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,qHAAqH;AACrH,eAAO,MAAM,oBAAoB;;;;;;;;iBA4B/B,CAAC;AAEH,0DAA0D;AAC1D,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAEhH;AAuBD;;;;GAIG;AACH,wBAAsB,eAAe,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,mBAAmB,EAAE,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAqD/D;AAED,qGAAqG;AACrG,KAAK,oBAAoB,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAgCrF,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ;;;;;;;;;;;;;;EAkBrD;AACD,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE7D,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,EAChC,OAAO,EACP,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,GACZ,EAAE,cAAc,GAAG,MAAM,CAMzB;AAED,0GAA0G;AAC1G,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAI7E"}