@apify/actors-mcp-server 0.1.23 → 0.1.24-beta.0

package/dist/stdio.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * This script initializes and starts the Apify MCP server using the Stdio transport.
+ *
+ * Usage:
+ *   node <script_name> --actors=<actor1,actor2,...>
+ *
+ * Command-line arguments:
+ *   --actors - A comma-separated list of Actor full names to add to the server.
+ *
+ * Example:
+ *   node stdio.js --actors=apify/google-search-scraper,apify/instagram-scraper
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import minimist from 'minimist';
+import log from '@apify/log';
+import { defaults } from './const.js';
+import { ActorsMcpServer } from './mcp/server.js';
+import { addTool, getActorsAsTools, removeTool } from './tools/index.js';
+// Configure logging, set to ERROR
+log.setLevel(log.LEVELS.ERROR);
+// Parse command line arguments
+const parser = minimist;
+const argv = parser(process.argv.slice(2), {
+    boolean: [
+        'enable-adding-actors',
+        'enableActorAutoLoading', // deprecated
+    ],
+    string: ['actors'],
+    default: {
+        'enable-adding-actors': false,
+    },
+});
+const { actors = '', enableActorAutoLoading = false } = argv;
+const actorList = actors ? actors.split(',').map((a) => a.trim()) : [];
+// Validate environment
+if (!process.env.APIFY_TOKEN) {
+    log.error('APIFY_TOKEN is required but not set in the environment variables.');
+    process.exit(1);
+}
+async function main() {
+    const mcpServer = new ActorsMcpServer();
+    // Initialize tools
+    const tools = await getActorsAsTools(actorList.length ? actorList : defaults.actors, process.env.APIFY_TOKEN);
+    if (enableActorAutoLoading) {
+        tools.push(addTool, removeTool);
+    }
+    mcpServer.updateTools(tools);
+    // Start server
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+}
+main().catch((error) => {
+    log.error('Server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,GAAG,MAAM,YAAY,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzE,kCAAkC;AAClC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE/B,+BAA+B;AAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC;AACxB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACvC,OAAO,EAAE;QACL,sBAAsB;QACtB,wBAAwB,EAAE,aAAa;KAC1C;IACD,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,OAAO,EAAE;QACL,sBAAsB,EAAE,KAAK;KAChC;CACJ,CAAC,CAAC;AACH,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,sBAAsB,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;AAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAE/E,uBAAuB;AACvB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAC3B,GAAG,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,IAAI;IACf,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;IACxC,mBAAmB;IACnB,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,WAAqB,CAAC,CAAC;IACxH,IAAI,sBAAsB,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAE7B,eAAe;IACf,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/tools/actor.d.ts

@@ -0,0 +1,40 @@
+import type { ActorCallOptions } from 'apify-client';
+import type { ToolWrap } from '../types.js';
+/**
+ * Calls an Apify actor and retrieves the dataset items.
+ *
+ *
+ * It requires the `APIFY_TOKEN` environment variable to be set.
+ * If the `APIFY_IS_AT_HOME` the dataset items are pushed to the Apify dataset.
+ *
+ * @param {string} actorName - The name of the actor to call.
+ * @param {ActorCallOptions} callOptions - The options to pass to the actor.
+ * @param {unknown} input - The input to pass to the actor.
+ * @param {string} apifyToken - The Apify token to use for authentication.
+ * @returns {Promise<object[]>} - A promise that resolves to an array of dataset items.
+ * @throws {Error} - Throws an error if the `APIFY_TOKEN` is not set
+ */
+export declare function callActorGetDataset(actorName: string, input: unknown, apifyToken: string, callOptions?: ActorCallOptions | undefined): Promise<object[]>;
+/**
+ * This function is used to fetch normal non-MCP server Actors as a tool.
+ *
+ * Fetches actor input schemas by Actor IDs or Actor full names and creates MCP tools.
+ *
+ * This function retrieves the input schemas for the specified actors and compiles them into MCP tools.
+ * It uses the AJV library to validate the input schemas.
+ *
+ * Tool name can't contain /, so it is replaced with _
+ *
+ * The input schema processing workflow:
+ * 1. Properties are marked as required using markInputPropertiesAsRequired() to add "REQUIRED" prefix to descriptions
+ * 2. Nested properties are built by analyzing editor type (proxy, requestListSources) using buildNestedProperties()
+ * 3. Properties are filtered using filterSchemaProperties()
+ * 4. Properties are shortened using shortenProperties()
+ * 5. Enums are added to descriptions with examples using addEnumsToDescriptionsWithExamples()
+ *
+ * @param {string[]} actors - An array of actor IDs or Actor full names.
+ * @returns {Promise<Tool[]>} - A promise that resolves to an array of MCP tools.
+ */
+export declare function getNormalActorsAsTools(actors: string[], apifyToken: string): Promise<ToolWrap[]>;
+export declare function getActorsAsTools(actors: string[], apifyToken: string): Promise<ToolWrap[]>;
+//# sourceMappingURL=actor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../src/tools/actor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AASrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAW5C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,gBAAgB,GAAG,SAAqB,GACtD,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoCrB;AAwBD,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuBrB"}

package/dist/tools/actor.js

@@ -0,0 +1,138 @@
+import { Ajv } from 'ajv';
+import log from '@apify/log';
+import { ApifyClient } from '../apify-client.js';
+import { ACTOR_ADDITIONAL_INSTRUCTIONS, ACTOR_MAX_MEMORY_MBYTES } from '../const.js';
+import { getActorsMCPServerURL, isActorMCPServer } from '../mcp/actors.js';
+import { createMCPClient } from '../mcp/client.js';
+import { getMCPServerTools } from '../mcp/proxy.js';
+import { getActorDefinition } from './build.js';
+import { actorNameToToolName, addEnumsToDescriptionsWithExamples, buildNestedProperties, filterSchemaProperties, markInputPropertiesAsRequired, shortenProperties, } from './utils.js';
+/**
+ * Calls an Apify actor and retrieves the dataset items.
+ *
+ *
+ * It requires the `APIFY_TOKEN` environment variable to be set.
+ * If the `APIFY_IS_AT_HOME` the dataset items are pushed to the Apify dataset.
+ *
+ * @param {string} actorName - The name of the actor to call.
+ * @param {ActorCallOptions} callOptions - The options to pass to the actor.
+ * @param {unknown} input - The input to pass to the actor.
+ * @param {string} apifyToken - The Apify token to use for authentication.
+ * @returns {Promise<object[]>} - A promise that resolves to an array of dataset items.
+ * @throws {Error} - Throws an error if the `APIFY_TOKEN` is not set
+ */
+export async function callActorGetDataset(actorName, input, apifyToken, callOptions = undefined) {
+    const name = actorName;
+    try {
+        log.info(`Calling Actor ${name} with input: ${JSON.stringify(input)}`);
+        const client = new ApifyClient({ token: apifyToken });
+        const actorClient = client.actor(name);
+        const results = await actorClient.call(input, callOptions);
+        const dataset = await client.dataset(results.defaultDatasetId).listItems();
+        log.info(`Actor ${name} finished with ${dataset.items.length} items`);
+        return dataset.items;
+    }
+    catch (error) {
+        log.error(`Error calling actor: ${error}. Actor: ${name}, input: ${JSON.stringify(input)}`);
+        throw new Error(`Error calling Actor: ${error}`);
+    }
+}
+/**
+ * This function is used to fetch normal non-MCP server Actors as a tool.
+ *
+ * Fetches actor input schemas by Actor IDs or Actor full names and creates MCP tools.
+ *
+ * This function retrieves the input schemas for the specified actors and compiles them into MCP tools.
+ * It uses the AJV library to validate the input schemas.
+ *
+ * Tool name can't contain /, so it is replaced with _
+ *
+ * The input schema processing workflow:
+ * 1. Properties are marked as required using markInputPropertiesAsRequired() to add "REQUIRED" prefix to descriptions
+ * 2. Nested properties are built by analyzing editor type (proxy, requestListSources) using buildNestedProperties()
+ * 3. Properties are filtered using filterSchemaProperties()
+ * 4. Properties are shortened using shortenProperties()
+ * 5. Enums are added to descriptions with examples using addEnumsToDescriptionsWithExamples()
+ *
+ * @param {string[]} actors - An array of actor IDs or Actor full names.
+ * @returns {Promise<Tool[]>} - A promise that resolves to an array of MCP tools.
+ */
+export async function getNormalActorsAsTools(actors, apifyToken) {
+    var _a;
+    const ajv = new Ajv({ coerceTypes: 'array', strict: false });
+    const getActorDefinitionWithToken = async (actorId) => {
+        const actor = await getActorDefinition(actorId, apifyToken);
+        return actor;
+    };
+    const results = await Promise.all(actors.map(getActorDefinitionWithToken));
+    const tools = [];
+    for (const result of results) {
+        if (result) {
+            if (result.input && 'properties' in result.input && result.input) {
+                result.input.properties = markInputPropertiesAsRequired(result.input);
+                result.input.properties = buildNestedProperties(result.input.properties);
+                result.input.properties = filterSchemaProperties(result.input.properties);
+                result.input.properties = shortenProperties(result.input.properties);
+                result.input.properties = addEnumsToDescriptionsWithExamples(result.input.properties);
+            }
+            try {
+                const memoryMbytes = ((_a = result.defaultRunOptions) === null || _a === void 0 ? void 0 : _a.memoryMbytes) || ACTOR_MAX_MEMORY_MBYTES;
+                tools.push({
+                    type: 'actor',
+                    tool: {
+                        name: actorNameToToolName(result.actorFullName),
+                        actorFullName: result.actorFullName,
+                        description: `${result.description} Instructions: ${ACTOR_ADDITIONAL_INSTRUCTIONS}`,
+                        inputSchema: result.input || {},
+                        ajvValidate: ajv.compile(result.input || {}),
+                        memoryMbytes: memoryMbytes > ACTOR_MAX_MEMORY_MBYTES ? ACTOR_MAX_MEMORY_MBYTES : memoryMbytes,
+                    },
+                });
+            }
+            catch (validationError) {
+                log.error(`Failed to compile AJV schema for Actor: ${result.actorFullName}. Error: ${validationError}`);
+            }
+        }
+    }
+    return tools;
+}
+async function getMCPServersAsTools(actors, apifyToken) {
+    const actorsMCPServerTools = [];
+    for (const actorID of actors) {
+        const serverUrl = await getActorsMCPServerURL(actorID, apifyToken);
+        log.info(`ActorID: ${actorID} MCP server URL: ${serverUrl}`);
+        let client;
+        try {
+            client = await createMCPClient(serverUrl, apifyToken);
+            const serverTools = await getMCPServerTools(actorID, client, serverUrl);
+            actorsMCPServerTools.push(...serverTools);
+        }
+        finally {
+            if (client)
+                await client.close();
+        }
+    }
+    return actorsMCPServerTools;
+}
+export async function getActorsAsTools(actors, apifyToken) {
+    log.debug(`Fetching actors as tools...`);
+    log.debug(`Actors: ${actors}`);
+    // Actorized MCP servers
+    const actorsMCPServers = [];
+    for (const actorID of actors) {
+        // TODO: rework, we are fetching actor definition from API twice - in the getMCPServerTools
+        if (await isActorMCPServer(actorID, apifyToken)) {
+            actorsMCPServers.push(actorID);
+        }
+    }
+    // Normal Actors as a tool
+    const toolActors = actors.filter((actorID) => !actorsMCPServers.includes(actorID));
+    log.debug(`actorsMCPserver: ${actorsMCPServers}`);
+    log.debug(`toolActors: ${toolActors}`);
+    // Normal Actors as a tool
+    const normalTools = await getNormalActorsAsTools(toolActors, apifyToken);
+    // Tools from Actorized MCP servers
+    const mcpServerTools = await getMCPServersAsTools(actorsMCPServers, apifyToken);
+    return [...normalTools, ...mcpServerTools];
+}
+//# sourceMappingURL=actor.js.map

package/dist/tools/actor.js.map

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

package/dist/tools/build.d.ts

@@ -0,0 +1,13 @@
+import type { ActorDefinitionPruned, ToolWrap } from '../types.js';
+/**
+ * Get Actor input schema by Actor name.
+ * First, fetch the Actor details to get the default build tag and buildId.
+ * Then, fetch the build details and return actorName, description, and input schema.
+ * @param {string} actorIdOrName - Actor ID or Actor full name.
+ * @param {number} limit - Truncate the README to this limit.
+ * @param {string} apifyToken
+ * @returns {Promise<ActorDefinitionWithDesc | null>} - The actor definition with description or null if not found.
+ */
+export declare function getActorDefinition(actorIdOrName: string, apifyToken: string, limit?: number): Promise<ActorDefinitionPruned | null>;
+export declare const actorDefinitionTool: ToolWrap;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACR,qBAAqB,EAIrB,QAAQ,EACX,MAAM,aAAa,CAAC;AAKrB;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACpC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAgC,GACxC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsCvC;AA6CD,eAAO,MAAM,mBAAmB,EAAE,QAuBjC,CAAC"}

package/dist/tools/build.js

@@ -0,0 +1,122 @@
+import { Ajv } from 'ajv';
+import { z } from 'zod';
+import zodToJsonSchema from 'zod-to-json-schema';
+import log from '@apify/log';
+import { ApifyClient } from '../apify-client.js';
+import { ACTOR_README_MAX_LENGTH, HelperTools } from '../const.js';
+import { filterSchemaProperties, shortenProperties } from './utils.js';
+const ajv = new Ajv({ coerceTypes: 'array', strict: false });
+/**
+ * Get Actor input schema by Actor name.
+ * First, fetch the Actor details to get the default build tag and buildId.
+ * Then, fetch the build details and return actorName, description, and input schema.
+ * @param {string} actorIdOrName - Actor ID or Actor full name.
+ * @param {number} limit - Truncate the README to this limit.
+ * @param {string} apifyToken
+ * @returns {Promise<ActorDefinitionWithDesc | null>} - The actor definition with description or null if not found.
+ */
+export async function getActorDefinition(actorIdOrName, apifyToken, limit = ACTOR_README_MAX_LENGTH) {
+    var _a, _b, _c;
+    const client = new ApifyClient({ token: apifyToken });
+    const actorClient = client.actor(actorIdOrName);
+    try {
+        // Fetch actor details
+        const actor = await actorClient.get();
+        if (!actor) {
+            log.error(`Failed to fetch input schema for Actor: ${actorIdOrName}. Actor not found.`);
+            return null;
+        }
+        // fnesveda: The default build is not necessarily tagged, you can specify any build number as default build.
+        // There will be a new API endpoint to fetch a default build.
+        // For now, we'll use the tagged build, it will work for 90% of Actors. Later, we can update this.
+        const tag = ((_a = actor.defaultRunOptions) === null || _a === void 0 ? void 0 : _a.build) || '';
+        const buildId = ((_c = (_b = actor.taggedBuilds) === null || _b === void 0 ? void 0 : _b[tag]) === null || _c === void 0 ? void 0 : _c.buildId) || '';
+        if (!buildId) {
+            log.error(`Failed to fetch input schema for Actor: ${actorIdOrName}. Build ID not found.`);
+            return null;
+        }
+        // Fetch build details and return the input schema
+        const buildDetails = await client.build(buildId).get();
+        if (buildDetails === null || buildDetails === void 0 ? void 0 : buildDetails.actorDefinition) {
+            const actorDefinitions = buildDetails === null || buildDetails === void 0 ? void 0 : buildDetails.actorDefinition;
+            actorDefinitions.id = actor.id;
+            actorDefinitions.readme = truncateActorReadme(actorDefinitions.readme || '', limit);
+            actorDefinitions.description = actor.description || '';
+            actorDefinitions.actorFullName = `${actor.username}/${actor.name}`;
+            actorDefinitions.defaultRunOptions = actor.defaultRunOptions;
+            return pruneActorDefinition(actorDefinitions);
+        }
+        return null;
+    }
+    catch (error) {
+        const errorMessage = `Failed to fetch input schema for Actor: ${actorIdOrName} with error ${error}.`;
+        log.error(errorMessage);
+        throw new Error(errorMessage);
+    }
+}
+function pruneActorDefinition(response) {
+    return {
+        id: response.id,
+        actorFullName: response.actorFullName || '',
+        buildTag: (response === null || response === void 0 ? void 0 : response.buildTag) || '',
+        readme: (response === null || response === void 0 ? void 0 : response.readme) || '',
+        input: (response === null || response === void 0 ? void 0 : response.input) && 'type' in response.input && 'properties' in response.input
+            ? {
+                ...response.input,
+                type: response.input.type,
+                properties: response.input.properties,
+            }
+            : undefined,
+        description: response.description,
+        defaultRunOptions: response.defaultRunOptions,
+    };
+}
+/** Prune Actor README if it is too long
+ * If the README is too long
+ * - We keep the README as it is up to the limit.
+ * - After the limit, we keep heading only
+ * - We add a note that the README was truncated because it was too long.
+ */
+function truncateActorReadme(readme, limit = ACTOR_README_MAX_LENGTH) {
+    if (readme.length <= limit) {
+        return readme;
+    }
+    const readmeFirst = readme.slice(0, limit);
+    const readmeRest = readme.slice(limit);
+    const lines = readmeRest.split('\n');
+    const prunedReadme = lines.filter((line) => line.startsWith('#'));
+    return `${readmeFirst}\n\nREADME was truncated because it was too long. Remaining headers:\n${prunedReadme.join(', ')}`;
+}
+const GetActorDefinitionArgsSchema = z.object({
+    actorName: z.string()
+        .describe('Retrieve input, readme, and other details for Actor ID or Actor full name. '
+        + 'Actor name is always composed from `username/name`'),
+    limit: z.number()
+        .int()
+        .default(ACTOR_README_MAX_LENGTH)
+        .describe(`Truncate the README to this limit. Default value is ${ACTOR_README_MAX_LENGTH}.`),
+});
+export const actorDefinitionTool = {
+    type: 'internal',
+    tool: {
+        name: HelperTools.GET_TOOL_DETAILS,
+        actorFullName: HelperTools.GET_TOOL_DETAILS,
+        description: 'Get documentation, readme, input schema and other details about an Actor. '
+            + 'For example, when user says, I need to know more about web crawler Actor.'
+            + 'Get details for an Actor with with Actor ID or Actor full name, i.e. username/name.'
+            + `Limit the length of the README if needed.`,
+        inputSchema: zodToJsonSchema(GetActorDefinitionArgsSchema),
+        ajvValidate: ajv.compile(zodToJsonSchema(GetActorDefinitionArgsSchema)),
+        call: async (toolArgs) => {
+            const { args, apifyToken } = toolArgs;
+            const parsed = GetActorDefinitionArgsSchema.parse(args);
+            const v = await getActorDefinition(parsed.actorName, apifyToken, parsed.limit);
+            if (v && v.input && 'properties' in v.input && v.input) {
+                const properties = filterSchemaProperties(v.input.properties);
+                v.input.properties = shortenProperties(properties);
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(v) }] };
+        },
+    },
+};
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { ToolWrap } from '../types';
+export declare const AddToolArgsSchema: z.ZodObject<{
+    actorName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    actorName: string;
+}, {
+    actorName: string;
+}>;
+export declare const addTool: ToolWrap;
+export declare const RemoveToolArgsSchema: z.ZodObject<{
+    toolName: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    toolName: string;
+}, {
+    toolName: string;
+}>;
+export declare const removeTool: ToolWrap;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAA2B,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKlE,eAAO,MAAM,iBAAiB;;;;;;EAI5B,CAAC;AACH,eAAO,MAAM,OAAO,EAAE,QA0BrB,CAAC;AACF,eAAO,MAAM,oBAAoB;;;;;;EAI/B,CAAC;AACH,eAAO,MAAM,UAAU,EAAE,QAkBxB,CAAC"}

package/dist/tools/helpers.js

@@ -0,0 +1,62 @@
+import { Ajv } from 'ajv';
+import { z } from 'zod';
+import zodToJsonSchema from 'zod-to-json-schema';
+import { HelperTools } from '../const.js';
+import { getActorsAsTools } from './actor.js';
+import { actorNameToToolName } from './utils.js';
+const ajv = new Ajv({ coerceTypes: 'array', strict: false });
+export const AddToolArgsSchema = z.object({
+    actorName: z.string()
+        .describe('Add a tool, Actor or MCP-Server to available tools by Actor ID or tool full name.'
+        + 'Tool name is always composed from `username/name`'),
+});
+export const addTool = {
+    type: 'internal',
+    tool: {
+        name: HelperTools.ADD_TOOL,
+        description: 'Add a tool, Actor or MCP-Server to available tools by Actor ID or Actor name. '
+            + 'A tool is an Actor or MCP-Server that can be called by the user'
+            + 'Do not execute the tool, only add it and list it in available tools. '
+            + 'For example, add a tool with username/name when user wants to scrape data from a website.',
+        inputSchema: zodToJsonSchema(AddToolArgsSchema),
+        ajvValidate: ajv.compile(zodToJsonSchema(AddToolArgsSchema)),
+        // TODO: I don't like that we are passing apifyMcpServer and mcpServer to the tool
+        call: async (toolArgs) => {
+            const { apifyMcpServer, mcpServer, apifyToken, args } = toolArgs;
+            const parsed = AddToolArgsSchema.parse(args);
+            const tools = await getActorsAsTools([parsed.actorName], apifyToken);
+            const toolsAdded = apifyMcpServer.updateTools(tools);
+            await mcpServer.notification({ method: 'notifications/tools/list_changed' });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Actor added: ${toolsAdded.map((t) => `${t.tool.actorFullName} (tool name: ${t.tool.name})`).join(', ')}`,
+                    }],
+            };
+        },
+    },
+};
+export const RemoveToolArgsSchema = z.object({
+    toolName: z.string()
+        .describe('Tool name to remove from available tools.')
+        .transform((val) => actorNameToToolName(val)),
+});
+export const removeTool = {
+    type: 'internal',
+    tool: {
+        name: HelperTools.REMOVE_TOOL,
+        description: 'Remove a tool, an Actor or MCP-Server by name from available tools. '
+            + 'For example, when user says, I do not need a tool username/name anymore',
+        inputSchema: zodToJsonSchema(RemoveToolArgsSchema),
+        ajvValidate: ajv.compile(zodToJsonSchema(RemoveToolArgsSchema)),
+        // TODO: I don't like that we are passing apifyMcpServer and mcpServer to the tool
+        call: async (toolArgs) => {
+            const { apifyMcpServer, mcpServer, args } = toolArgs;
+            const parsed = RemoveToolArgsSchema.parse(args);
+            apifyMcpServer.tools.delete(parsed.toolName);
+            await mcpServer.notification({ method: 'notifications/tools/list_changed' });
+            return { content: [{ type: 'text', text: `Tool ${parsed.toolName} was removed` }] };
+        },
+    },
+};
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+import { callActorGetDataset, getActorsAsTools } from './actor.js';
+import { actorDefinitionTool } from './build.js';
+import { addTool, removeTool } from './helpers.js';
+import { searchActorTool } from './store_collection.js';
+export { addTool, removeTool, actorDefinitionTool, searchActorTool as searchTool, getActorsAsTools, callActorGetDataset };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,IAAI,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,8 @@
+// Import specific tools that are being used
+import { callActorGetDataset, getActorsAsTools } from './actor.js';
+import { actorDefinitionTool } from './build.js';
+import { addTool, removeTool } from './helpers.js';
+import { searchActorTool } from './store_collection.js';
+// Export only the tools that are being used
+export { addTool, removeTool, actorDefinitionTool, searchActorTool as searchTool, getActorsAsTools, callActorGetDataset };
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,4CAA4C;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,IAAI,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/tools/store_collection.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { ActorStorePruned, ToolWrap } from '../types.js';
+export declare function searchActorsByKeywords(search: string, apifyToken: string, limit?: number | undefined, offset?: number | undefined): Promise<ActorStorePruned[] | null>;
+export declare const SearchToolArgsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    search: z.ZodDefault<z.ZodString>;
+    category: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    search: string;
+    offset: number;
+    category: string;
+}, {
+    limit?: number | undefined;
+    search?: string | undefined;
+    offset?: number | undefined;
+    category?: string | undefined;
+}>;
+export declare const searchActorTool: ToolWrap;
+//# sourceMappingURL=store_collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store_collection.d.ts","sourceRoot":"","sources":["../../src/tools/store_collection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,gBAAgB,EAA2B,QAAQ,EAAE,MAAM,aAAa,CAAC;AA4BvF,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAM,GAAG,SAAqB,EACrC,MAAM,GAAE,MAAM,GAAG,SAAqB,GACvC,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAIpC;AAGD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAqB/B,CAAC;AACH,eAAO,MAAM,eAAe,EAAE,QA0B7B,CAAC"}

package/dist/tools/store_collection.js

@@ -0,0 +1,82 @@
+import { Ajv } from 'ajv';
+import { z } from 'zod';
+import zodToJsonSchema from 'zod-to-json-schema';
+import { ApifyClient } from '../apify-client.js';
+import { HelperTools } from '../const.js';
+function pruneActorStoreInfo(response) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const stats = response.stats || {};
+    const pricingInfo = (response.currentPricingInfo || {});
+    return {
+        id: response.id,
+        name: ((_a = response.name) === null || _a === void 0 ? void 0 : _a.toString()) || '',
+        username: ((_b = response.username) === null || _b === void 0 ? void 0 : _b.toString()) || '',
+        actorFullName: `${response.username}/${response.name}`,
+        title: ((_c = response.title) === null || _c === void 0 ? void 0 : _c.toString()) || '',
+        description: ((_d = response.description) === null || _d === void 0 ? void 0 : _d.toString()) || '',
+        stats: {
+            totalRuns: stats.totalRuns,
+            totalUsers30Days: stats.totalUsers30Days,
+            publicActorRunStats30Days: 'publicActorRunStats30Days' in stats
+                ? stats.publicActorRunStats30Days : {},
+        },
+        currentPricingInfo: {
+            pricingModel: ((_e = pricingInfo.pricingModel) === null || _e === void 0 ? void 0 : _e.toString()) || '',
+            pricePerUnitUsd: (_f = pricingInfo === null || pricingInfo === void 0 ? void 0 : pricingInfo.pricePerUnitUsd) !== null && _f !== void 0 ? _f : 0,
+            trialMinutes: (_g = pricingInfo === null || pricingInfo === void 0 ? void 0 : pricingInfo.trialMinutes) !== null && _g !== void 0 ? _g : 0,
+        },
+        url: ((_h = response.url) === null || _h === void 0 ? void 0 : _h.toString()) || '',
+        totalStars: 'totalStars' in response ? response.totalStars : null,
+    };
+}
+export async function searchActorsByKeywords(search, apifyToken, limit = undefined, offset = undefined) {
+    const client = new ApifyClient({ token: apifyToken });
+    const results = await client.store().list({ search, limit, offset });
+    return results.items.map((x) => pruneActorStoreInfo(x));
+}
+const ajv = new Ajv({ coerceTypes: 'array', strict: false });
+export const SearchToolArgsSchema = z.object({
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(10)
+        .describe('The maximum number of Actors to return. Default value is 10.'),
+    offset: z.number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe('The number of elements that should be skipped at the start. Default value is 0.'),
+    search: z.string()
+        .default('')
+        .describe('String of key words to search Actors by. '
+        + 'Searches the title, name, description, username, and readme of an Actor.'
+        + 'Only key word search is supported, no advanced search.'
+        + 'Always prefer simple keywords over complex queries.'),
+    category: z.string()
+        .default('')
+        .describe('Filters the results by the specified category.'),
+});
+export const searchActorTool = {
+    type: 'internal',
+    tool: {
+        name: HelperTools.SEARCH_ACTOR,
+        actorFullName: HelperTools.SEARCH_ACTOR,
+        description: `Discover available Actors or MCP-Servers in Apify Store using full text search using keywords.`
+            + `Users try to discover Actors using free form query in this case search query must be converted to full text search. `
+            + `Returns a list of Actors with name, description, run statistics, pricing, starts, and URL. `
+            + `You perhaps need to use this tool several times to find the right Actor. `
+            + `You should prefer simple keywords over complex queries. `
+            + `Limit number of results returned but ensure that relevant results are returned. `
+            + `This is not a general search tool, it is designed to search for Actors in Apify Store. `,
+        inputSchema: zodToJsonSchema(SearchToolArgsSchema),
+        ajvValidate: ajv.compile(zodToJsonSchema(SearchToolArgsSchema)),
+        call: async (toolArgs) => {
+            const { args, apifyToken } = toolArgs;
+            const parsed = SearchToolArgsSchema.parse(args);
+            const actors = await searchActorsByKeywords(parsed.search, apifyToken, parsed.limit, parsed.offset);
+            return { content: actors === null || actors === void 0 ? void 0 : actors.map((item) => ({ type: 'text', text: JSON.stringify(item) })) };
+        },
+    },
+};
+//# sourceMappingURL=store_collection.js.map