@apify/actors-mcp-server 0.15.1-beta.0 → 0.15.1-beta.1

package/dist/tools/tasks/task_helpers.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+import { toIsoString } from '../actors/actor_run_response.js';
+const PUBLIC_CONFIG_FIELDS = [
+    'seoTitle',
+    'seoDescription',
+    'inputSchemaFields',
+    'datasetName',
+    'datasetView',
+];
+/** Apify resource IDs are exactly 17 alphanumeric characters. */
+const APIFY_ID_REGEX = /^[a-zA-Z0-9]{17}$/;
+/**
+ * The API reads an unqualified id as an ID, so a bare resource name has to be prefixed with `~` to be
+ * resolved against the authenticated user's own resources. Ids that already carry a username, in either
+ * the `username/name` or `username~name` format, and ids that are already IDs, are returned unchanged.
+ *
+ * Applies to both tasks and the Actor a task is created for, which the API resolves the same way.
+ */
+export function toSafeResourceId(idOrName) {
+    const trimmed = idOrName.trim();
+    if (trimmed.includes('/') || trimmed.includes('~'))
+        return trimmed;
+    return APIFY_ID_REGEX.test(trimmed) ? trimmed : `~${trimmed}`;
+}
+/** A bare 17-alnum value is shape-identical to an ID and to a legal task name. */
+export function isAmbiguousResourceId(idOrName) {
+    const trimmed = idOrName.trim();
+    return !trimmed.includes('/') && !trimmed.includes('~') && APIFY_ID_REGEX.test(trimmed);
+}
+/**
+ * Fetches a task by ID, name, or `username/name`. An ambiguous value cannot be resolved by
+ * inspection, so it is read as an ID first and, on a miss, retried as the caller's own task name.
+ */
+export async function getTaskByIdOrName(client, idOrName) {
+    const task = await client.task(toSafeResourceId(idOrName)).get();
+    if (task || !isAmbiguousResourceId(idOrName))
+        return task;
+    return client.task(`~${idOrName.trim()}`).get();
+}
+/**
+ * Task names must be DNS-safe and 3-63 characters, as the API enforces. Validated here so the
+ * caller gets a usable message instead of a 400.
+ */
+const TASK_NAME_REGEX = /^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9])$/;
+export const taskNameSchema = z
+    .string()
+    .min(3)
+    .max(63)
+    .regex(TASK_NAME_REGEX, 'Task name may contain only letters, digits and dashes, and cannot start or end with a dash');
+/** Writable public display configuration, shared by the create and update tools. */
+export const publicConfigSchema = z.object({
+    seoTitle: z.string().optional().describe('Title shown on the public landing page and in search results.'),
+    seoDescription: z.string().optional().describe('Description shown on the public landing page.'),
+    inputSchemaFields: z
+        .array(z.string())
+        .optional()
+        .describe('Names of the input fields to display on the public page. At least one valid field is required to publish; the names must exist in the task input.'),
+    datasetName: z.string().optional().describe('Name of the dataset whose schema provides the views.'),
+    datasetView: z
+        .string()
+        .optional()
+        .describe("View key from the Actor's dataset schema. Required to publish; ask the user, no tool lists dataset views."),
+});
+/**
+ * The task subset returned by every task tool: identity, publication state, and the display
+ * config. Input *values* are deliberately omitted — they may hold secrets — but the field names
+ * are included because `publicConfig.inputSchemaFields` must reference them.
+ */
+export function taskResult(task) {
+    var _a, _b, _c, _d;
+    const publicConfig = task.publicConfig
+        ? Object.fromEntries(PUBLIC_CONFIG_FIELDS.filter((field) => { var _a; return ((_a = task.publicConfig) === null || _a === void 0 ? void 0 : _a[field]) !== undefined; }).map((field) => {
+            var _a;
+            return [
+                field,
+                (_a = task.publicConfig) === null || _a === void 0 ? void 0 : _a[field],
+            ];
+        }))
+        : null;
+    return {
+        taskId: task.id,
+        actorId: task.actId,
+        name: task.name,
+        title: (_a = task.title) !== null && _a !== void 0 ? _a : null,
+        description: (_b = task.description) !== null && _b !== void 0 ? _b : null,
+        // Normalized because the client parses this into a `Date` while the raw publication call
+        // returns a string; the declared output schema promises a string either way.
+        publishedAt: (_d = toIsoString((_c = task.publicConfig) === null || _c === void 0 ? void 0 : _c.publishedAt)) !== null && _d !== void 0 ? _d : null,
+        publicConfig,
+        inputFields: task.input && !Array.isArray(task.input) ? Object.keys(task.input) : [],
+    };
+}
+/**
+ * Setting the publication state the task already has is a no-op, so both directions are safe
+ * to repeat.
+ */
+export async function setTaskPublication(client, taskId, isPublic) {
+    var _a;
+    // An ambiguous value is resolved to the real ID by lookup; on a miss it falls through to the
+    // ID reading so the publish call raises the API's own not-found error.
+    const resolvedId = isAmbiguousResourceId(taskId) ? (_a = (await getTaskByIdOrName(client, taskId))) === null || _a === void 0 ? void 0 : _a.id : undefined;
+    const taskClient = client.task(resolvedId !== null && resolvedId !== void 0 ? resolvedId : toSafeResourceId(taskId));
+    return isPublic ? taskClient.publish() : taskClient.unpublish();
+}
+//# sourceMappingURL=task_helpers.js.map

package/dist/tools/tasks/task_helpers.js.map

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

package/dist/tools/tasks/unpublish_actor_task.d.ts

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

package/dist/tools/tasks/unpublish_actor_task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpublish_actor_task.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/unpublish_actor_task.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA4C,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AA+B3G;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAyBtB,CAAC"}

package/dist/tools/tasks/unpublish_actor_task.js

@@ -0,0 +1,56 @@
+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 } from '../../utils/mcp.js';
+import { actorTaskOutputSchema } from '../structured_output_schemas.js';
+import { setTaskPublication, taskResult } from './task_helpers.js';
+const unpublishActorTaskArgs = z.object({
+    taskId: z
+        .string()
+        .min(1)
+        .describe('The task to unpublish: its ID, its name (resolved against your own tasks), or "username/task-name" for a task owned by someone else.'),
+});
+function buildDescription({ hasTool }) {
+    return `Unpublish a task from its public landing page.
+The public display configuration is preserved, so the task can be published again \
+later${hasTool(HELPER_TOOLS.ACTOR_TASK_PUBLISH) ? ` with ${HELPER_TOOLS.ACTOR_TASK_PUBLISH}` : ''}. Unpublishing a task
+that is not published does nothing.
+Requires write access to both the task and its Actor.
+
+USAGE:
+- Use when the user wants to take down a task's public landing page.
+
+USAGE EXAMPLES:
+- user_input: Unpublish my task my-task
+- user_input: Unpublish task E2jjCZBezvAZnX8Rb`;
+}
+/**
+ * https://docs.apify.com/api/v2/actor-task-put
+ */
+export const unpublishActorTask = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.ACTOR_TASK_UNPUBLISH,
+    title: 'Unpublish Actor task',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: z.toJSONSchema(unpublishActorTaskArgs),
+    outputSchema: actorTaskOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(unpublishActorTaskArgs)),
+    annotations: {
+        title: 'Unpublish Actor task',
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyClient: client } = toolArgs;
+        const parsed = unpublishActorTaskArgs.parse(args);
+        const task = await setTaskPublication(client, parsed.taskId, false);
+        const result = taskResult(task);
+        const summary = `Task "${task.name}" (ID: ${task.id}) is no longer published.`;
+        return respondOk([JSON.stringify(result), summary], { structuredContent: result });
+    },
+});
+//# sourceMappingURL=unpublish_actor_task.js.map

package/dist/tools/tasks/unpublish_actor_task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpublish_actor_task.js","sourceRoot":"","sources":["../../../src/tools/tasks/unpublish_actor_task.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,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACL,sIAAsI,CACzI;CACR,CAAC,CAAC;AAEH,SAAS,gBAAgB,CAAC,EAAE,OAAO,EAA0B;IACzD,OAAO;;OAEJ,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;+CASlD,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAc,MAAM,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,oBAAoB;IACvC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;IAChD,gBAAgB;IAChB,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAoB;IACtE,YAAY,EAAE,qBAAqB;IACnC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAClE,WAAW,EAAE;QACT,KAAK,EAAE,sBAAsB;QAC7B,YAAY,EAAE,KAAK;QACnB,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,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,2BAA2B,CAAC;QAC/E,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/tasks/update_actor_task.d.ts

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

package/dist/tools/tasks/update_actor_task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_actor_task.d.ts","sourceRoot":"","sources":["../../../src/tools/tasks/update_actor_task.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA4C,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAyD3G;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SA2DnB,CAAC"}

package/dist/tools/tasks/update_actor_task.js

@@ -0,0 +1,100 @@
+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 { actorTaskOutputSchema } from '../structured_output_schemas.js';
+import { getTaskByIdOrName, isAmbiguousResourceId, publicConfigSchema, taskNameSchema, taskResult, toSafeResourceId, } from './task_helpers.js';
+const updateActorTaskArgs = z.object({
+    taskId: z
+        .string()
+        .min(1)
+        .describe('The task to update: its ID, its name (resolved against your own tasks), or "username/task-name" for a task owned by someone else.'),
+    name: taskNameSchema.optional().describe('New name of the task: 3-63 characters, letters, digits and dashes only.'),
+    title: z.string().optional().describe('New human-readable title of the task.'),
+    description: z.string().optional().describe('New short description of the task.'),
+    input: z
+        .object({})
+        .passthrough()
+        .optional()
+        .describe('Replacement input JSON for the task. Replaces the stored input, it is not merged into it.'),
+    build: z.string().optional().describe('Actor build tag or number to run, e.g. "latest".'),
+    timeoutSecs: z.number().int().min(0).optional().describe('Run timeout in seconds; 0 means no timeout.'),
+    memoryMbytes: z.number().int().positive().optional().describe('Memory limit for the run in megabytes.'),
+    publicConfig: publicConfigSchema
+        .optional()
+        .describe('Public display configuration of the task landing page. Provided fields are merged into the stored configuration; the publication state itself is not changed here.'),
+});
+function buildDescription({ hasTool }) {
+    const publicationTools = [HELPER_TOOLS.ACTOR_TASK_PUBLISH, HELPER_TOOLS.ACTOR_TASK_UNPUBLISH].filter((name) => hasTool(name));
+    return `Update a saved Actor task: its input, run options, or the public display configuration (\`publicConfig\`) of its landing page.
+This does not publish or unpublish the task${publicationTools.length ? ` — use ${publicationTools.join(' and ')} for that` : ''}.
+To publish a task, \`publicConfig.inputSchemaFields\` (at least one field name from the task input) and
+\`publicConfig.datasetView\` must be set here first. Updating \`publicConfig\` requires write access to the task's Actor.
+
+USAGE:
+- Use to change a task's input or run options.
+- Use to fill in the public display configuration before publishing a task.
+
+USAGE EXAMPLES:
+- user_input: Change my task my-task to use the beta build
+- user_input: Set up my-task for publishing with the overview dataset view`;
+}
+/**
+ * https://docs.apify.com/api/v2/actor-task-put
+ */
+export const updateActorTask = Object.freeze({
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.ACTOR_TASK_UPDATE,
+    title: 'Update Actor task',
+    description: buildDescription(ALL_TOOLS_PRESENT),
+    buildDescription,
+    inputSchema: z.toJSONSchema(updateActorTaskArgs),
+    outputSchema: actorTaskOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(updateActorTaskArgs)),
+    annotations: {
+        title: 'Update Actor task',
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyClient: client } = toolArgs;
+        const { taskId, name, title, description, input, build, timeoutSecs, memoryMbytes, publicConfig } = updateActorTaskArgs.parse(args);
+        const optionsUpdate = {
+            ...(build !== undefined && { build }),
+            ...(timeoutSecs !== undefined && { timeoutSecs }),
+            ...(memoryMbytes !== undefined && { memoryMbytes }),
+        };
+        const hasOptions = Object.keys(optionsUpdate).length > 0;
+        // The pre-read serves two cases: the API completely replaces `options` (unlike
+        // `publicConfig`, which it merges), so an options update must merge with the stored value;
+        // and an ambiguous taskId (an ID-shaped name) must be resolved to the real ID by lookup.
+        let resolvedTaskId = toSafeResourceId(taskId);
+        let storedOptions;
+        if (hasOptions || isAmbiguousResourceId(taskId)) {
+            const storedTask = await getTaskByIdOrName(client, taskId);
+            // Report the missing task from this read rather than letting the update fail later with
+            // a rawer error.
+            if (!storedTask) {
+                return respondUserError(`Task ${taskId} was not found.`);
+            }
+            resolvedTaskId = storedTask.id;
+            storedOptions = storedTask.options;
+        }
+        const update = {
+            ...(name && { name }),
+            ...(title !== undefined && { title }),
+            ...(description !== undefined && { description }),
+            ...(input && { input }),
+            ...(hasOptions && { options: { ...storedOptions, ...optionsUpdate } }),
+            ...(publicConfig && { publicConfig }),
+        };
+        const task = await client.task(resolvedTaskId).update(update);
+        const result = taskResult(task);
+        const summary = `Updated task "${result.name}" (ID: ${result.taskId}).`;
+        return respondOk([JSON.stringify(result), summary], { structuredContent: result });
+    },
+});
+//# sourceMappingURL=update_actor_task.js.map

package/dist/tools/tasks/update_actor_task.js.map

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