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

package/dist/utils/server-instructions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,UAA+B,GAAG,MAAM,CAsEnF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,UAA+B,GAAG,MAAM,CAoEnF"}

package/dist/utils/server-instructions/index.js

@@ -62,8 +62,6 @@ Some clients render widget-backed Actor tools: the response includes a live UI t
     - \`waitSecs > 0\`: waits up to that many seconds for the run to complete, then returns the result.
 
 ### Tool disambiguation
-- **\`${HelperTools.ACTOR_OUTPUT_GET}\` vs \`${HelperTools.DATASET_GET_ITEMS}\`:**
-  Use \`${HelperTools.ACTOR_OUTPUT_GET}\` for Actor run outputs and \`${HelperTools.DATASET_GET_ITEMS}\` for direct dataset access.
 - **\`${HelperTools.STORE_SEARCH}\` vs \`${HelperTools.ACTOR_GET_DETAILS}\`:**
   \`${HelperTools.STORE_SEARCH}\` finds Actors; \`${HelperTools.ACTOR_GET_DETAILS}\` retrieves detailed info, README, and schema for a specific Actor.
 ${isApps

package/dist/utils/server-instructions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAmB,UAAU,CAAC,OAAO;IACvE,MAAM,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC;IAExC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;EA0BP,MAAM;QACF,CAAC,CAAC;;;;cAII,WAAW,CAAC,iBAAiB,WAAW,WAAW,CAAC,qBAAqB,oBAAoB,WAAW,CAAC,cAAc,WAAW,WAAW,CAAC,qBAAqB,iLAAiL,WAAW,CAAC,qBAAqB;cACrX,WAAW,CAAC,cAAc,cAAc,WAAW,CAAC,UAAU;CAC3E;QACO,CAAC,CAAC,EACV;;;;MAIM,WAAW,CAAC,UAAU;YAChB,WAAW,CAAC,iBAAiB;;;;;;;;QAQjC,WAAW,CAAC,gBAAgB,WAAW,WAAW,CAAC,iBAAiB;UAClE,WAAW,CAAC,gBAAgB,kCAAkC,WAAW,CAAC,iBAAiB;QAC7F,WAAW,CAAC,YAAY,WAAW,WAAW,CAAC,iBAAiB;MAClE,WAAW,CAAC,YAAY,sBAAsB,WAAW,CAAC,iBAAiB;EAE7E,MAAM;QACF,CAAC,CAAC;QACF,WAAW,CAAC,YAAY,6EAA6E,WAAW,CAAC,mBAAmB;QACpI,WAAW,CAAC,iBAAiB,6EAA6E,WAAW,CAAC,wBAAwB;QAC9I,WAAW,CAAC,UAAU,uDAAuD,WAAW,CAAC,iBAAiB;QAC1G,WAAW,CAAC,cAAc,6EAA6E,WAAW,CAAC,qBAAqB;uEACzE,WAAW,CAAC,YAAY,SAAS,WAAW,CAAC,iBAAiB;CACpI;QACO,CAAC,CAAC,EACV,SAAS,WAAW,CAAC,YAAY,SAAS,eAAe;MACnD,WAAW,CAAC,YAAY,8DAA8D,eAAe;kCACzE,eAAe,UAAU,WAAW,CAAC,UAAU;iDAChC,WAAW,CAAC,UAAU;CACtE,CAAC;AACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAmB,UAAU,CAAC,OAAO;IACvE,MAAM,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC;IAExC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;EA0BP,MAAM;QACF,CAAC,CAAC;;;;cAII,WAAW,CAAC,iBAAiB,WAAW,WAAW,CAAC,qBAAqB,oBAAoB,WAAW,CAAC,cAAc,WAAW,WAAW,CAAC,qBAAqB,iLAAiL,WAAW,CAAC,qBAAqB;cACrX,WAAW,CAAC,cAAc,cAAc,WAAW,CAAC,UAAU;CAC3E;QACO,CAAC,CAAC,EACV;;;;MAIM,WAAW,CAAC,UAAU;YAChB,WAAW,CAAC,iBAAiB;;;;;;;;QAQjC,WAAW,CAAC,YAAY,WAAW,WAAW,CAAC,iBAAiB;MAClE,WAAW,CAAC,YAAY,sBAAsB,WAAW,CAAC,iBAAiB;EAE7E,MAAM;QACF,CAAC,CAAC;QACF,WAAW,CAAC,YAAY,6EAA6E,WAAW,CAAC,mBAAmB;QACpI,WAAW,CAAC,iBAAiB,6EAA6E,WAAW,CAAC,wBAAwB;QAC9I,WAAW,CAAC,UAAU,uDAAuD,WAAW,CAAC,iBAAiB;QAC1G,WAAW,CAAC,cAAc,6EAA6E,WAAW,CAAC,qBAAqB;uEACzE,WAAW,CAAC,YAAY,SAAS,WAAW,CAAC,iBAAiB;CACpI;QACO,CAAC,CAAC,EACV,SAAS,WAAW,CAAC,YAAY,SAAS,eAAe;MACnD,WAAW,CAAC,YAAY,8DAA8D,eAAe;kCACzE,eAAe,UAAU,WAAW,CAAC,UAAU;iDAChC,WAAW,CAAC,UAAU;CACtE,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apify/actors-mcp-server",
-  "version": "0.10.12-beta.2",
+  "version": "0.10.12-beta.3",
   "type": "module",
   "description": "Apify MCP Server",
   "mcpName": "com.apify/apify-mcp-server",

package/dist/tools/common/get_actor_output.d.ts

@@ -1,7 +0,0 @@
-import type { ToolEntry } from '../../types.js';
-/**
- * This tool is used specifically for retrieving Actor output.
- * It is a simplified version of the get-dataset-items tool.
- */
-export declare const getActorOutput: ToolEntry;
-//# sourceMappingURL=get_actor_output.d.ts.map

package/dist/tools/common/get_actor_output.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get_actor_output.d.ts","sourceRoot":"","sources":["../../../src/tools/common/get_actor_output.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAuBnF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SA0FlB,CAAC"}

package/dist/tools/common/get_actor_output.js

@@ -1,109 +0,0 @@
-import dedent from 'dedent';
-import { z } from 'zod';
-import { FAILURE_CATEGORY, HelperTools, TOOL_MAX_OUTPUT_CHARS, TOOL_STATUS } from '../../const.js';
-import { TOOL_TYPE } from '../../types.js';
-import { compileSchema } from '../../utils/ajv.js';
-import { getValuesByDotKeys, parseCommaSeparatedList } from '../../utils/generic.js';
-import { buildMCPResponse } from '../../utils/mcp.js';
-import { cleanEmptyProperties } from '../../utils/schema_generation.js';
-import { datasetItemsOutputSchema } from '../structured_output_schemas.js';
-/**
- * Zod schema for get-actor-output tool arguments
- */
-const getActorOutputArgs = z.object({
-    datasetId: z.string().min(1).describe('Actor output dataset ID to retrieve from.'),
-    fields: z
-        .string()
-        .optional()
-        .describe('Comma-separated list of fields to include (supports dot notation like "crawl.statusCode"). For example: "crawl.statusCode,text,metadata"'),
-    offset: z.number().optional().default(0).describe('Number of items to skip (default: 0).'),
-    limit: z.number().optional().default(100).describe('Maximum number of items to return (default: 100).'),
-});
-/**
- * This tool is used specifically for retrieving Actor output.
- * It is a simplified version of the get-dataset-items tool.
- */
-export const getActorOutput = Object.freeze({
-    type: TOOL_TYPE.INTERNAL,
-    name: HelperTools.ACTOR_OUTPUT_GET,
-    description: dedent `
-        DEPRECATED: Use \`${HelperTools.DATASET_GET_ITEMS}\` instead.
-        \`${HelperTools.DATASET_GET_ITEMS}\` auto-flattens dot-notation \`fields\` and defaults limit to 20.
-
-        Retrieve the output dataset items of a specific Actor run using its datasetId.
-        You can select specific fields to return (supports dot notation like "crawl.statusCode") and paginate results with offset and limit.
-
-        The results will include the dataset items from the specified dataset. If you provide fields, only those fields will be included (nested fields supported via dot notation).
-
-        You can obtain the datasetId from an Actor run (e.g., after calling an Actor with the call-actor tool) or from the Apify Console (Runs → Run details → Dataset ID).
-
-        USAGE:
-        - Prefer \`${HelperTools.DATASET_GET_ITEMS}\` for new code.
-
-        USAGE EXAMPLES:
-        - user_input: Get data of my last Actor run
-        - user_input: Get number_of_likes from my dataset
-        - user_input: Return only crawl.statusCode and url from dataset aab123`,
-    inputSchema: z.toJSONSchema(getActorOutputArgs),
-    outputSchema: datasetItemsOutputSchema,
-    ajvValidate: compileSchema(z.toJSONSchema(getActorOutputArgs)),
-    paymentRequired: true,
-    annotations: {
-        title: 'Get Actor output',
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-    call: async (toolArgs) => {
-        const { args, apifyClient } = toolArgs;
-        const parsed = getActorOutputArgs.parse(args);
-        // Parse fields into array
-        const fieldsArray = parseCommaSeparatedList(parsed.fields);
-        // TODO: we can optimize the API level field filtering in future
-        /**
-         * Only top-level fields can be filtered.
-         * If a dot is present, filtering is done here and not at the API level.
-         */
-        const hasDot = fieldsArray.some((field) => field.includes('.'));
-        const response = await apifyClient.dataset(parsed.datasetId).listItems({
-            offset: parsed.offset,
-            limit: parsed.limit,
-            fields: fieldsArray.length > 0 && !hasDot ? fieldsArray : undefined,
-            clean: true,
-        });
-        if (!response) {
-            return buildMCPResponse({
-                texts: [`Dataset '${parsed.datasetId}' not found.`],
-                isError: true,
-                telemetry: { toolStatus: TOOL_STATUS.SOFT_FAIL, failureCategory: FAILURE_CATEGORY.INVALID_INPUT },
-            });
-        }
-        let { items } = response;
-        // Apply field selection if specified
-        if (fieldsArray.length > 0) {
-            items = items.map((item) => getValuesByDotKeys(item, fieldsArray));
-        }
-        // Clean empty properties
-        const cleanedItems = items.map((item) => cleanEmptyProperties(item)).filter((item) => item !== undefined);
-        let outputText = `\`\`\`json\n${JSON.stringify(cleanedItems)}\n\`\`\``;
-        let truncated = false;
-        if (outputText.length > TOOL_MAX_OUTPUT_CHARS) {
-            outputText = outputText.slice(0, TOOL_MAX_OUTPUT_CHARS);
-            truncated = true;
-        }
-        if (truncated) {
-            outputText += `\n\n[Output was truncated to ${TOOL_MAX_OUTPUT_CHARS} characters to comply with the tool output limits.]`;
-        }
-        const structuredContent = {
-            datasetId: parsed.datasetId,
-            items: cleanedItems,
-            itemCount: cleanedItems.length,
-            totalItemCount: response.total,
-            offset: parsed.offset,
-            limit: parsed.limit,
-        };
-        return { content: [{ type: 'text', text: outputText }], structuredContent };
-    },
-});
-//# sourceMappingURL=get_actor_output.js.map

package/dist/tools/common/get_actor_output.js.map

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