@apify/actors-mcp-server 0.9.1 → 0.9.3-beta.0

package/dist/tools/common/get_dataset_items.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { createApifyClientWithSkyfireSupport } from '../../apify_client.js';
+import { HelperTools, TOOL_STATUS } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { parseCommaSeparatedList } from '../../utils/generic.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
+import { datasetItemsOutputSchema } from '../structured_output_schemas.js';
+const getDatasetItemsArgs = z.object({
+    datasetId: z.string()
+        .min(1)
+        .describe('Dataset ID or username~dataset-name.'),
+    clean: z.boolean().optional()
+        .describe('If true, returns only non-empty items and skips hidden fields (starting with #). Shortcut for skipHidden=true and skipEmpty=true.'),
+    offset: z.number().optional()
+        .describe('Number of items to skip at the start. Default is 0.'),
+    limit: z.number().optional()
+        .describe('Maximum number of items to return. No limit by default.'),
+    fields: z.string().optional()
+        .describe('Comma-separated list of fields to include in results. '
+        + 'Fields in output are sorted as specified. '
+        + 'For nested objects, use dot notation (e.g. "metadata.url") after flattening.'),
+    omit: z.string().optional()
+        .describe('Comma-separated list of fields to exclude from results.'),
+    desc: z.boolean().optional()
+        .describe('If true, results are returned in reverse order (newest to oldest).'),
+    flatten: z.string().optional()
+        .describe('Comma-separated list of fields which should transform nested objects into flat structures. '
+        + 'For example, with flatten="metadata" the object {"metadata":{"url":"hello"}} becomes {"metadata.url":"hello"}. '
+        + 'This is required before accessing nested fields with the fields parameter.'),
+});
+/**
+ * https://docs.apify.com/api/v2/dataset-items-get
+ */
+export const getDatasetItems = Object.freeze({
+    type: 'internal',
+    name: HelperTools.DATASET_GET_ITEMS,
+    description: `Retrieve dataset items with pagination, sorting, and field selection.
+Use clean=true to skip empty items and hidden fields. Include or omit fields using comma-separated lists.
+For nested objects, first flatten them (e.g., flatten="metadata"), then reference nested fields via dot notation (e.g., fields="metadata.url").
+
+The results will include items along with pagination info (limit, offset) and total count.
+
+USAGE:
+- Use when you need to read data from a dataset (all items or only selected fields).
+
+USAGE EXAMPLES:
+- user_input: Get first 100 items from dataset abd123
+- user_input: Get only metadata.url and title from dataset username~my-dataset (flatten metadata)`,
+    inputSchema: z.toJSONSchema(getDatasetItemsArgs),
+    outputSchema: datasetItemsOutputSchema,
+    /**
+     * Allow additional properties for Skyfire mode to pass `skyfire-pay-id`.
+     */
+    ajvValidate: compileSchema({ ...z.toJSONSchema(getDatasetItemsArgs), additionalProperties: true }),
+    requiresSkyfirePayId: true,
+    annotations: {
+        title: 'Get dataset items',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        var _a;
+        const { args, apifyToken, apifyMcpServer } = toolArgs;
+        const parsed = getDatasetItemsArgs.parse(args);
+        const client = createApifyClientWithSkyfireSupport(apifyMcpServer, args, apifyToken);
+        // Convert comma-separated strings to arrays
+        const fields = parseCommaSeparatedList(parsed.fields);
+        const omit = parseCommaSeparatedList(parsed.omit);
+        const flatten = parseCommaSeparatedList(parsed.flatten);
+        const v = await client.dataset(parsed.datasetId).listItems({
+            clean: parsed.clean,
+            offset: parsed.offset,
+            limit: parsed.limit,
+            fields,
+            omit,
+            desc: parsed.desc,
+            flatten,
+        });
+        if (!v) {
+            return buildMCPResponse({
+                texts: [`Dataset '${parsed.datasetId}' not found.`],
+                isError: true,
+                toolStatus: TOOL_STATUS.SOFT_FAIL,
+            });
+        }
+        const structuredContent = {
+            datasetId: parsed.datasetId,
+            items: v.items,
+            itemCount: v.items.length,
+            totalItemCount: v.count,
+            offset: (_a = parsed.offset) !== null && _a !== void 0 ? _a : 0,
+            limit: parsed.limit,
+        };
+        return { content: [{ type: 'text', text: `\`\`\`json\n${JSON.stringify(v)}\n\`\`\`` }], structuredContent };
+    },
+});
+//# sourceMappingURL=get_dataset_items.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { ToolEntry } from '../../types.js';
+/**
+ * Generates a JSON schema from dataset items
+ */
+export declare const getDatasetSchema: ToolEntry;
+//# sourceMappingURL=get_dataset_schema.d.ts.map

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

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

package/dist/tools/common/get_dataset_schema.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { createApifyClientWithSkyfireSupport } from '../../apify_client.js';
+import { HelperTools, TOOL_STATUS } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
+import { generateSchemaFromItems } from '../../utils/schema_generation.js';
+const getDatasetSchemaArgs = z.object({
+    datasetId: z.string()
+        .min(1)
+        .describe('Dataset ID or username~dataset-name.'),
+    limit: z.number().optional()
+        .describe('Maximum number of items to use for schema generation. Default is 5.')
+        .default(5),
+    clean: z.boolean().optional()
+        .describe('If true, uses only non-empty items and skips hidden fields (starting with #). Default is true.')
+        .default(true),
+    arrayMode: z.enum(['first', 'all']).optional()
+        .describe('Strategy for handling arrays. "first" uses first item as template, "all" merges all items. Default is "all".')
+        .default('all'),
+});
+/**
+ * Generates a JSON schema from dataset items
+ */
+export const getDatasetSchema = Object.freeze({
+    type: 'internal',
+    name: HelperTools.DATASET_SCHEMA_GET,
+    description: `Generate a JSON schema from a sample of dataset items.
+The schema describes the structure of the data and can be used for validation, documentation, or processing.
+Use this to understand the dataset before fetching many items.
+
+USAGE:
+- Use when you need to infer the structure of dataset items for downstream processing or validation.
+
+USAGE EXAMPLES:
+- user_input: Generate schema for dataset 34das2 using 10 items
+- user_input: Show schema of username~my-dataset (clean items only)`,
+    inputSchema: z.toJSONSchema(getDatasetSchemaArgs),
+    /**
+     * Allow additional properties for Skyfire mode to pass `skyfire-pay-id`.
+     */
+    ajvValidate: compileSchema({ ...z.toJSONSchema(getDatasetSchemaArgs), additionalProperties: true }),
+    requiresSkyfirePayId: true,
+    annotations: {
+        title: 'Get dataset schema',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyToken, apifyMcpServer } = toolArgs;
+        const parsed = getDatasetSchemaArgs.parse(args);
+        const client = createApifyClientWithSkyfireSupport(apifyMcpServer, args, apifyToken);
+        // Get dataset items
+        const datasetResponse = await client.dataset(parsed.datasetId).listItems({
+            clean: parsed.clean,
+            limit: parsed.limit,
+        });
+        if (!datasetResponse) {
+            return buildMCPResponse({
+                texts: [`Dataset '${parsed.datasetId}' not found.`],
+                isError: true,
+                toolStatus: TOOL_STATUS.SOFT_FAIL,
+            });
+        }
+        const datasetItems = datasetResponse.items;
+        if (datasetItems.length === 0) {
+            return { content: [{ type: 'text', text: `Dataset '${parsed.datasetId}' is empty.` }] };
+        }
+        // Generate schema using the shared utility
+        const schema = generateSchemaFromItems(datasetItems, {
+            limit: parsed.limit,
+            clean: parsed.clean,
+            arrayMode: parsed.arrayMode,
+        });
+        if (!schema) {
+            // Schema generation failure is typically a server/processing error, not a user error
+            return buildMCPResponse({
+                texts: [`Failed to generate schema for dataset '${parsed.datasetId}'.`],
+                isError: true,
+                toolStatus: TOOL_STATUS.FAILED,
+            });
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `\`\`\`json\n${JSON.stringify(schema)}\n\`\`\``,
+                }],
+        };
+    },
+});
+//# sourceMappingURL=get_dataset_schema.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { ToolEntry } from '../../types.js';
+export declare const getHtmlSkeleton: ToolEntry;
+//# sourceMappingURL=get_html_skeleton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_html_skeleton.d.ts","sourceRoot":"","sources":["../../../src/tools/common/get_html_skeleton.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAgCnF,eAAO,MAAM,eAAe,EAAE,SAwFnB,CAAC"}

package/dist/tools/{get-html-skeleton.js → common/get_html_skeleton.js}

@@ -1,13 +1,11 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="779c12ce-b852-5a06-a9dc-67e301b9df9b")}catch(e){}}();
 import { z } from 'zod';
-import { ApifyClient } from '../apify-client.js';
-import { HelperTools, RAG_WEB_BROWSER, TOOL_MAX_OUTPUT_CHARS, TOOL_STATUS } from '../const.js';
-import { getHtmlSkeletonCache } from '../state.js';
-import { compileSchema } from '../utils/ajv.js';
-import { isValidHttpUrl } from '../utils/generic.js';
-import { stripHtml } from '../utils/html.js';
-import { buildMCPResponse } from '../utils/mcp.js';
+import { ApifyClient } from '../../apify_client.js';
+import { HelperTools, RAG_WEB_BROWSER, TOOL_MAX_OUTPUT_CHARS, TOOL_STATUS } from '../../const.js';
+import { getHtmlSkeletonCache } from '../../state.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { isValidHttpUrl } from '../../utils/generic.js';
+import { stripHtml } from '../../utils/html.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
 const getHtmlSkeletonArgs = z.object({
     url: z.string()
         .min(1)
@@ -21,7 +19,7 @@ const getHtmlSkeletonArgs = z.object({
         .default(1)
         .describe('Chunk number to retrieve when getting the content. The content is split into chunks to prevent exceeding the maximum tool output length.'),
 });
-export const getHtmlSkeleton = {
+export const getHtmlSkeleton = Object.freeze({
     type: 'internal',
     name: HelperTools.GET_HTML_SKELETON,
     description: `Retrieve the HTML skeleton (clean structure) of a webpage by stripping scripts, styles, and non-essential attributes.
@@ -99,6 +97,5 @@ USAGE EXAMPLES:
         const chunkInfo = `\n\n--- Chunk ${parsed.chunk} of ${totalChunks} ---\n${hasNextChunk ? `Next chunk: ${parsed.chunk + 1}` : 'End of content'}`;
         return buildMCPResponse({ texts: [chunkContent + chunkInfo] });
     },
-};
-//# sourceMappingURL=get-html-skeleton.js.map
-//# debugId=779c12ce-b852-5a06-a9dc-67e301b9df9b
+});
+//# sourceMappingURL=get_html_skeleton.js.map

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

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

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

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

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

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

package/dist/tools/common/get_key_value_store.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { createApifyClientWithSkyfireSupport } from '../../apify_client.js';
+import { HelperTools } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
+const getKeyValueStoreArgs = z.object({
+    storeId: z.string()
+        .min(1)
+        .describe('Key-value store ID or username~store-name'),
+});
+/**
+ * https://docs.apify.com/api/v2/key-value-store-get
+ */
+export const getKeyValueStore = Object.freeze({
+    type: 'internal',
+    name: HelperTools.KEY_VALUE_STORE_GET,
+    description: `Get details about a key-value store by ID or username~store-name.
+The results will include store metadata (ID, name, owner, access settings) and usage statistics.
+
+USAGE:
+- Use when you need to inspect a store to locate records or understand its properties.
+
+USAGE EXAMPLES:
+- user_input: Show info for key-value store username~my-store
+- user_input: Get details for store adb123`,
+    inputSchema: z.toJSONSchema(getKeyValueStoreArgs),
+    /**
+     * Allow additional properties for Skyfire mode to pass `skyfire-pay-id`.
+     */
+    ajvValidate: compileSchema({ ...z.toJSONSchema(getKeyValueStoreArgs), additionalProperties: true }),
+    requiresSkyfirePayId: true,
+    annotations: {
+        title: 'Get key-value store',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyToken, apifyMcpServer } = toolArgs;
+        const parsed = getKeyValueStoreArgs.parse(args);
+        const client = createApifyClientWithSkyfireSupport(apifyMcpServer, args, apifyToken);
+        const store = await client.keyValueStore(parsed.storeId).get();
+        return { content: [{ type: 'text', text: `\`\`\`json\n${JSON.stringify(store)}\n\`\`\`` }] };
+    },
+});
+//# sourceMappingURL=get_key_value_store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_key_value_store.js","sourceRoot":"","sources":["../../../src/tools/common/get_key_value_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACd,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,2CAA2C,CAAC;CAC7D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAc,MAAM,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,mBAAmB;IACrC,WAAW,EAAE;;;;;;;;2CAQ0B;IACvC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAoB;IACpE;;OAEG;IACH,WAAW,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACnG,oBAAoB,EAAE,IAAI;IAC1B,WAAW,EAAE;QACT,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QACtD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,mCAAmC,CAAC,cAAc,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACrF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IACjG,CAAC;CACK,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_key_value_store_keys.d.ts","sourceRoot":"","sources":["../../../src/tools/common/get_key_value_store_keys.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAgBnF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAoCxB,CAAC"}

package/dist/tools/common/get_key_value_store_keys.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { createApifyClientWithSkyfireSupport } from '../../apify_client.js';
+import { HelperTools } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
+const getKeyValueStoreKeysArgs = z.object({
+    storeId: z.string()
+        .min(1)
+        .describe('Key-value store ID or username~store-name'),
+    exclusiveStartKey: z.string()
+        .optional()
+        .describe('All keys up to this one (including) are skipped from the result.'),
+    limit: z.number()
+        .max(10)
+        .optional()
+        .describe('Number of keys to be returned. Maximum value is 1000.'),
+});
+/**
+ * https://docs.apify.com/api/v2/key-value-store-keys-get
+ */
+export const getKeyValueStoreKeys = Object.freeze({
+    type: 'internal',
+    name: HelperTools.KEY_VALUE_STORE_KEYS_GET,
+    description: `List keys in a key-value store with optional pagination.
+The results will include keys and basic info about stored values (e.g., size).
+Use exclusiveStartKey and limit to paginate.
+
+USAGE:
+- Use when you need to discover what records exist in a store.
+
+USAGE EXAMPLES:
+- user_input: List first 100 keys in store username~my-store
+- user_input: Continue listing keys in store a123 from key data.json`,
+    inputSchema: z.toJSONSchema(getKeyValueStoreKeysArgs),
+    /**
+     * Allow additional properties for Skyfire mode to pass `skyfire-pay-id`.
+     */
+    ajvValidate: compileSchema({ ...z.toJSONSchema(getKeyValueStoreKeysArgs), additionalProperties: true }),
+    requiresSkyfirePayId: true,
+    annotations: {
+        title: 'Get key-value store keys',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyToken, apifyMcpServer } = toolArgs;
+        const parsed = getKeyValueStoreKeysArgs.parse(args);
+        const client = createApifyClientWithSkyfireSupport(apifyMcpServer, args, apifyToken);
+        const keys = await client.keyValueStore(parsed.storeId).listKeys({
+            exclusiveStartKey: parsed.exclusiveStartKey,
+            limit: parsed.limit,
+        });
+        return { content: [{ type: 'text', text: `\`\`\`json\n${JSON.stringify(keys)}\n\`\`\`` }] };
+    },
+});
+//# sourceMappingURL=get_key_value_store_keys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_key_value_store_keys.js","sourceRoot":"","sources":["../../../src/tools/common/get_key_value_store_keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACd,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,2CAA2C,CAAC;IAC1D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;SACxB,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;CACzE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAc,MAAM,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,wBAAwB;IAC1C,WAAW,EAAE;;;;;;;;;qEASoD;IACjE,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,wBAAwB,CAAoB;IACxE;;OAEG;IACH,WAAW,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,wBAAwB,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACvG,oBAAoB,EAAE,IAAI;IAC1B,WAAW,EAAE;QACT,KAAK,EAAE,0BAA0B;QACjC,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QACtD,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAG,mCAAmC,CAAC,cAAc,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACrF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;YAC7D,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,KAAK,EAAE,MAAM,CAAC,KAAK;SACtB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAChG,CAAC;CACK,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_key_value_store_record.d.ts","sourceRoot":"","sources":["../../../src/tools/common/get_key_value_store_record.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAYnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAgC1B,CAAC"}

package/dist/tools/common/get_key_value_store_record.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { createApifyClientWithSkyfireSupport } from '../../apify_client.js';
+import { HelperTools } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
+const getKeyValueStoreRecordArgs = z.object({
+    storeId: z.string()
+        .min(1)
+        .describe('Key-value store ID or username~store-name'),
+    recordKey: z.string()
+        .min(1)
+        .describe('Key of the record to retrieve.'),
+});
+/**
+ * https://docs.apify.com/api/v2/key-value-store-record-get
+ */
+export const getKeyValueStoreRecord = Object.freeze({
+    type: 'internal',
+    name: HelperTools.KEY_VALUE_STORE_RECORD_GET,
+    description: `Get a value stored in a key-value store under a specific key.
+The response preserves the original Content-Encoding; most clients handle decompression automatically.
+
+USAGE:
+- Use when you need to retrieve a specific record (JSON, text, or binary) from a store.
+
+USAGE EXAMPLES:
+- user_input: Get record INPUT from store abc123
+- user_input: Get record data.json from store username~my-store`,
+    inputSchema: z.toJSONSchema(getKeyValueStoreRecordArgs),
+    /**
+     * Allow additional properties for Skyfire mode to pass `skyfire-pay-id`.
+     */
+    ajvValidate: compileSchema({ ...z.toJSONSchema(getKeyValueStoreRecordArgs), additionalProperties: true }),
+    requiresSkyfirePayId: true,
+    annotations: {
+        title: 'Get key-value store record',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    call: async (toolArgs) => {
+        const { args, apifyToken, apifyMcpServer } = toolArgs;
+        const parsed = getKeyValueStoreRecordArgs.parse(args);
+        const client = createApifyClientWithSkyfireSupport(apifyMcpServer, args, apifyToken);
+        const record = await client.keyValueStore(parsed.storeId).getRecord(parsed.recordKey);
+        return { content: [{ type: 'text', text: `\`\`\`json\n${JSON.stringify(record)}\n\`\`\`` }] };
+    },
+});
+//# sourceMappingURL=get_key_value_store_record.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_key_value_store_record.js","sourceRoot":"","sources":["../../../src/tools/common/get_key_value_store_record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACd,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,2CAA2C,CAAC;IAC1D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SAChB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gCAAgC,CAAC;CAClD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC3D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,0BAA0B;IAC5C,WAAW,EAAE;;;;;;;;gEAQ+C;IAC5D,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,0BAA0B,CAAoB;IAC1E;;OAEG;IACH,WAAW,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,0BAA0B,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACzG,oBAAoB,EAAE,IAAI;IAC1B,WAAW,EAAE;QACT,KAAK,EAAE,4BAA4B;QACnC,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QACtD,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,mCAAmC,CAAC,cAAc,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAClG,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/{key_value_store_collection.d.ts → common/key_value_store_collection.d.ts}

@@ -1,4 +1,4 @@
-import type { ToolEntry } from '../types.js';
+import type { ToolEntry } from '../../types.js';
 /**
  * https://docs.apify.com/api/v2/key-value-stores-get
  */

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

@@ -0,0 +1 @@
+{"version":3,"file":"key_value_store_collection.d.ts","sourceRoot":"","sources":["../../../src/tools/common/key_value_store_collection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAmBnF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAmC7B,CAAC"}

package/dist/tools/{key_value_store_collection.js → common/key_value_store_collection.js}

@@ -1,9 +1,7 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="12bbf018-bf99-556e-a5e9-22266a0f9df9")}catch(e){}}();
 import { z } from 'zod';
-import { ApifyClient } from '../apify-client.js';
-import { HelperTools } from '../const.js';
-import { compileSchema } from '../utils/ajv.js';
+import { ApifyClient } from '../../apify_client.js';
+import { HelperTools } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
 const getUserKeyValueStoresListArgs = z.object({
     offset: z.number()
         .describe('Number of array elements that should be skipped at the start. The default is 0.')
@@ -22,7 +20,7 @@ const getUserKeyValueStoresListArgs = z.object({
 /**
  * https://docs.apify.com/api/v2/key-value-stores-get
  */
-export const getUserKeyValueStoresList = {
+export const getUserKeyValueStoresList = Object.freeze({
     type: 'internal',
     name: HelperTools.KEY_VALUE_STORE_LIST_GET,
     description: `List key-value stores owned by the authenticated user.
@@ -57,6 +55,5 @@ USAGE EXAMPLES:
         });
         return { content: [{ type: 'text', text: `\`\`\`json\n${JSON.stringify(stores)}\n\`\`\`` }] };
     },
-};
-//# sourceMappingURL=key_value_store_collection.js.map
-//# debugId=12bbf018-bf99-556e-a5e9-22266a0f9df9
+});
+//# sourceMappingURL=key_value_store_collection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"key_value_store_collection.js","sourceRoot":"","sources":["../../../src/tools/common/key_value_store_collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACb,QAAQ,CAAC,iFAAiF,CAAC;SAC3F,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,oFAAoF,CAAC;SAC9F,OAAO,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;SACZ,QAAQ,CAAC,yHAAyH,CAAC;SACnI,OAAO,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;SACf,QAAQ,CAAC,sGAAsG,CAAC;SAChH,OAAO,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC9D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,wBAAwB;IAC1C,WAAW,EAAE;;;;;;;;;;;4CAW2B;IACxC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,6BAA6B,CAAoB;IAC7E,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;IACzE,WAAW,EAAE;QACT,KAAK,EAAE,gCAAgC;QACvC,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QACtC,MAAM,MAAM,GAAG,6BAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC;YAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAClG,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/{run_collection.d.ts → common/run_collection.d.ts}

@@ -1,4 +1,4 @@
-import type { ToolEntry } from '../types.js';
+import type { ToolEntry } from '../../types.js';
 /**
  * https://docs.apify.com/api/v2/act-runs-get
  */

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

@@ -0,0 +1 @@
+{"version":3,"file":"run_collection.d.ts","sourceRoot":"","sources":["../../../src/tools/common/run_collection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAoBnF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SA8BnB,CAAC"}

package/dist/tools/{run_collection.js → common/run_collection.js}

@@ -1,10 +1,8 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1943321b-67f2-5bff-8f28-1e11ee671022")}catch(e){}}();
 import { z } from 'zod';
-import { ApifyClient } from '../apify-client.js';
-import { HelperTools } from '../const.js';
-import { compileSchema } from '../utils/ajv.js';
-import { buildMCPResponse } from '../utils/mcp.js';
+import { ApifyClient } from '../../apify_client.js';
+import { HelperTools } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
 const getUserRunsListArgs = z.object({
     offset: z.number()
         .describe('Number of array elements that should be skipped at the start. The default value is 0.')
@@ -23,7 +21,7 @@ const getUserRunsListArgs = z.object({
 /**
  * https://docs.apify.com/api/v2/act-runs-get
  */
-export const getUserRunsList = {
+export const getUserRunsList = Object.freeze({
     type: 'internal',
     name: HelperTools.ACTOR_RUN_LIST_GET,
     description: `List Actor runs for the authenticated user with optional filtering and sorting.
@@ -53,6 +51,5 @@ USAGE EXAMPLES:
             texts: [`\`\`\`json\n${JSON.stringify(runs)}\n\`\`\``],
         });
     },
-};
-//# sourceMappingURL=run_collection.js.map
-//# debugId=1943321b-67f2-5bff-8f28-1e11ee671022
+});
+//# sourceMappingURL=run_collection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run_collection.js","sourceRoot":"","sources":["../../../src/tools/common/run_collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACb,QAAQ,CAAC,uFAAuF,CAAC;SACjG,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,+FAA+F,CAAC;SACzG,OAAO,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;SACZ,QAAQ,CAAC,uHAAuH,CAAC;SACjI,OAAO,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;SACxG,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;CAC9D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAc,MAAM,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,kBAAkB;IACpC,WAAW,EAAE;;;;;;;;;uCASsB;IACnC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAoB;IACnE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC/D,WAAW,EAAE;QACT,KAAK,EAAE,oBAAoB;QAC3B,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QACtC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAChI,OAAO,gBAAgB,CAAC;YACpB,KAAK,EAAE,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;SACzD,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ToolEntry } from '../../types.js';
+export declare const searchApifyDocsTool: ToolEntry;
+//# sourceMappingURL=search_apify_docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search_apify_docs.d.ts","sourceRoot":"","sources":["../../../src/tools/common/search_apify_docs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAgEnF,eAAO,MAAM,mBAAmB,EAAE,SA6DvB,CAAC"}

package/dist/tools/{search-apify-docs.js → common/search_apify_docs.js}

@@ -1,11 +1,9 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3189d235-c6db-54a8-b4d2-5825e70f72ac")}catch(e){}}();
 import { z } from 'zod';
-import { DOCS_SOURCES, HelperTools } from '../const.js';
-import { compileSchema } from '../utils/ajv.js';
-import { searchDocsBySourceCached } from '../utils/apify-docs.js';
-import { buildMCPResponse } from '../utils/mcp.js';
-import { searchApifyDocsToolOutputSchema } from './structured-output-schemas.js';
+import { DOCS_SOURCES, HelperTools } from '../../const.js';
+import { compileSchema } from '../../utils/ajv.js';
+import { searchDocsBySourceCached } from '../../utils/apify_docs.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
+import { searchApifyDocsToolOutputSchema } from '../structured_output_schemas.js';
 /**
  * Build docSource parameter description dynamically from DOCS_SOURCES
  */
@@ -52,7 +50,7 @@ You can increase this limit if you need more results, but keep in mind that the
         .describe(`Offset for the search results. Defaults to 0.
 Use this to paginate through the search results. For example, if you want to get the next 5 results, set the offset to 5 and limit to 5.`),
 });
-export const searchApifyDocsTool = {
+export const searchApifyDocsTool = Object.freeze({
     type: 'internal',
     name: HelperTools.DOCS_SEARCH,
     description: buildToolDescription(),
@@ -107,6 +105,5 @@ ${results.map((result) => {
         // We put the instructions at the end so that they are more likely to be acknowledged by the LLM
         return buildMCPResponse({ texts: [textResult, instructions], structuredContent });
     },
-};
-//# sourceMappingURL=search-apify-docs.js.map
-//# debugId=3189d235-c6db-54a8-b4d2-5825e70f72ac
+});
+//# sourceMappingURL=search_apify_docs.js.map