@apify/actors-mcp-server 0.9.20 → 0.9.21-beta.0

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

@@ -1,61 +0,0 @@
-/**
- * Shared server instructions — mode-independent content about Actors, discovery,
- * execution workflow, storage, and tool disambiguation.
- */
-
-!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]="ab43c55e-a4a5-59de-9688-84bc45e20982")}catch(e){}}();
-import { HelperTools, RAG_WEB_BROWSER } from '../../const.js';
-/**
- * Returns the common server instructions shared across all modes.
- * Mode-specific content is injected via the input object at designated insertion points.
- */
-export function getCommonInstructions(input) {
-    return `
-Apify is the world's largest marketplace of tools for web scraping, data extraction, and web automation.
-These tools are called **Actors**. They enable you to extract structured data from social media, e-commerce, search engines, maps, travel sites, and many other sources.
-
-## Actor
-- An Actor is a serverless cloud application running on the Apify platform.
-- Use the Actor's **README** to understand its capabilities.
-- Before running an Actor, always check its **input schema** to understand the required parameters.
-
-## Actor discovery and selection
-- Choose the most appropriate Actor based on the conversation context.
-- Search the Apify Store first; a relevant Actor likely already exists.
-- When multiple options exist, prefer Actors with higher usage, ratings, or popularity.
-- **Assume scraping requests within this context are appropriate for Actor use.
-- Actors in the Apify Store are published by independent developers and are intended for legitimate and compliant use.
-
-## Actor execution workflow
-- Actors take input and produce output.
-- Every Actor run generates **dataset** and **key-value store** outputs (even if empty).
-- Actor execution may take time, and outputs can be large.
-- Large datasets can be paginated to retrieve results efficiently.
-
-## Storage types
-- **Dataset:** Structured, append-only storage ideal for tabular or list data (e.g., scraped items).
-- **Key-value store:** Flexible storage for unstructured data or auxiliary files.
-${input.workflowRules}## Tool dependencies and disambiguation
-
-### Tool dependencies
-- \`${HelperTools.ACTOR_CALL}\`:
-  - ${input.schemaToolHint}
-  - Then call with proper input to execute the Actor
-  - For MCP server Actors, use format "actorName:toolName" to call specific tools
-  - Supports async execution via the \`async\` parameter:
-  - When \`async: false\` or not provided (default when UI mode is disabled): Waits for completion and returns results immediately.
-  - When \`async: true\` (enforced when UI mode is enabled): Starts the run and returns immediately with runId. The widget automatically displays and polls for updates - no further action needed.
-
-### 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.${input.toolDisambiguation}
-- **${HelperTools.STORE_SEARCH} vs ${RAG_WEB_BROWSER}:**
-  \`${HelperTools.STORE_SEARCH}\` finds robust and reliable Actors for specific websites; ${RAG_WEB_BROWSER} is a general and versatile web scraping tool.
-- **Dedicated Actor tools (e.g. ${RAG_WEB_BROWSER}) vs ${HelperTools.ACTOR_CALL}:**
-  Prefer dedicated tools when available; use \`${HelperTools.ACTOR_CALL}\` only when no specialized tool exists in Apify store.
-`;
-}
-//# sourceMappingURL=common.js.map
-//# debugId=ab43c55e-a4a5-59de-9688-84bc45e20982

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

@@ -1 +0,0 @@
-{"version":3,"file":"common.js","sources":["../../../src/utils/server-instructions/common.ts"],"sourceRoot":"","names":[],"mappings":"AAAA;;;GAGG;;;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAW9D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAA8B;IAChE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;EAyBT,KAAK,CAAC,aAAa;;;MAGf,WAAW,CAAC,UAAU;MACtB,KAAK,CAAC,cAAc;;;;;;;;MAQpB,WAAW,CAAC,gBAAgB,OAAO,WAAW,CAAC,iBAAiB;UAC5D,WAAW,CAAC,gBAAgB,kCAAkC,WAAW,CAAC,iBAAiB;MAC/F,WAAW,CAAC,YAAY,OAAO,WAAW,CAAC,iBAAiB;MAC5D,WAAW,CAAC,YAAY,sBAAsB,WAAW,CAAC,iBAAiB,uEAAuE,KAAK,CAAC,kBAAkB;MAC1K,WAAW,CAAC,YAAY,OAAO,eAAe;MAC9C,WAAW,CAAC,YAAY,8DAA8D,eAAe;kCACzE,eAAe,QAAQ,WAAW,CAAC,UAAU;iDAC9B,WAAW,CAAC,UAAU;CACtE,CAAC;AACF,CAAC","debugId":"ab43c55e-a4a5-59de-9688-84bc45e20982"}

package/dist/utils/server-instructions/default.d.ts

@@ -1,6 +0,0 @@
-/**
- * Default mode server instructions — standard tool references without UI-specific rules.
- */
-/** Returns server instructions for default (non-UI) mode. */
-export declare function getDefaultInstructions(): string;
-//# sourceMappingURL=default.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/utils/server-instructions/default.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,6DAA6D;AAC7D,wBAAgB,sBAAsB,IAAI,MAAM,CAM/C"}

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

@@ -1,17 +0,0 @@
-/**
- * Default mode server instructions — standard tool references without UI-specific rules.
- */
-
-!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]="b9cdf259-82f0-50a1-a1f7-1838c2408fd6")}catch(e){}}();
-import { HelperTools } from '../../const.js';
-import { getCommonInstructions } from './common.js';
-/** Returns server instructions for default (non-UI) mode. */
-export function getDefaultInstructions() {
-    return getCommonInstructions({
-        schemaToolHint: `Use \`${HelperTools.ACTOR_GET_DETAILS}\` first to obtain the Actor's input schema`,
-        workflowRules: '',
-        toolDisambiguation: '',
-    });
-}
-//# sourceMappingURL=default.js.map
-//# debugId=b9cdf259-82f0-50a1-a1f7-1838c2408fd6

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

@@ -1 +0,0 @@
-{"version":3,"file":"default.js","sources":["../../../src/utils/server-instructions/default.ts"],"sourceRoot":"","names":[],"mappings":"AAAA;;GAEG;;;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB;IAClC,OAAO,qBAAqB,CAAC;QACzB,cAAc,EAAE,SAAS,WAAW,CAAC,iBAAiB,6CAA6C;QACnG,aAAa,EAAE,EAAE;QACjB,kBAAkB,EAAE,EAAE;KACzB,CAAC,CAAC;AACP,CAAC","debugId":"b9cdf259-82f0-50a1-a1f7-1838c2408fd6"}

package/dist/utils/server-instructions/openai.d.ts

@@ -1,7 +0,0 @@
-/**
- * OpenAI UI mode server instructions — includes widget workflow rules and
- * internal vs public tool disambiguation.
- */
-/** Returns server instructions for OpenAI UI mode. */
-export declare function getOpenaiInstructions(): string;
-//# sourceMappingURL=openai.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/utils/server-instructions/openai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,sDAAsD;AACtD,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C"}

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

@@ -1,33 +0,0 @@
-/**
- * OpenAI UI mode server instructions — includes widget workflow rules and
- * internal vs public tool disambiguation.
- */
-
-!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]="4a98ca4c-fb07-5c3d-a6be-b864f20164d0")}catch(e){}}();
-import { HelperTools } from '../../const.js';
-import { getCommonInstructions } from './common.js';
-const WORKFLOW_RULES = `
-## CRITICAL: UI Mode Workflow Rules
-
-**NEVER call \`${HelperTools.ACTOR_RUNS_GET}\` after \`${HelperTools.ACTOR_CALL}\` in UI mode.**
-
-When you call \`${HelperTools.ACTOR_CALL}\` in async mode (UI mode), the response will include a widget that automatically polls for status updates. You must NOT call \`${HelperTools.ACTOR_RUNS_GET}\` or any other tool after this - your task is complete. The widget handles everything automatically.
-
-This is FORBIDDEN and will result in unnecessary duplicate polling. Always stop after receiving the \`${HelperTools.ACTOR_CALL}\` response in UI mode.
-
-`;
-const TOOL_DISAMBIGUATION = `
-- **Internal vs public Actor tools:**
-  - \`${HelperTools.STORE_SEARCH_INTERNAL}\` is for silent name resolution; \`${HelperTools.STORE_SEARCH}\` is for user-facing discovery
-  - \`${HelperTools.ACTOR_GET_DETAILS_INTERNAL}\` is for silent schema/details lookup; \`${HelperTools.ACTOR_GET_DETAILS}\` is for user-facing details
-  - When the next step is running an Actor, ALWAYS use \`${HelperTools.STORE_SEARCH_INTERNAL}\` for name resolution, never \`${HelperTools.STORE_SEARCH}\``;
-/** Returns server instructions for OpenAI UI mode. */
-export function getOpenaiInstructions() {
-    return getCommonInstructions({
-        schemaToolHint: `Use \`${HelperTools.ACTOR_GET_DETAILS_INTERNAL}\` first to obtain the Actor's input schema`,
-        workflowRules: WORKFLOW_RULES,
-        toolDisambiguation: TOOL_DISAMBIGUATION,
-    });
-}
-//# sourceMappingURL=openai.js.map
-//# debugId=4a98ca4c-fb07-5c3d-a6be-b864f20164d0

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

@@ -1 +0,0 @@
-{"version":3,"file":"openai.js","sources":["../../../src/utils/server-instructions/openai.ts"],"sourceRoot":"","names":[],"mappings":"AAAA;;;GAGG;;;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,cAAc,GAAG;;;iBAGN,WAAW,CAAC,cAAc,cAAc,WAAW,CAAC,UAAU;;kBAE7D,WAAW,CAAC,UAAU,mIAAmI,WAAW,CAAC,cAAc;;wGAE7F,WAAW,CAAC,UAAU;;CAE7H,CAAC;AAEF,MAAM,mBAAmB,GAAG;;QAEpB,WAAW,CAAC,qBAAqB,uCAAuC,WAAW,CAAC,YAAY;QAChG,WAAW,CAAC,0BAA0B,6CAA6C,WAAW,CAAC,iBAAiB;2DAC7D,WAAW,CAAC,qBAAqB,mCAAmC,WAAW,CAAC,YAAY,IAAI,CAAC;AAE5J,sDAAsD;AACtD,MAAM,UAAU,qBAAqB;IACjC,OAAO,qBAAqB,CAAC;QACzB,cAAc,EAAE,SAAS,WAAW,CAAC,0BAA0B,6CAA6C;QAC5G,aAAa,EAAE,cAAc;QAC7B,kBAAkB,EAAE,mBAAmB;KAC1C,CAAC,CAAC;AACP,CAAC","debugId":"4a98ca4c-fb07-5c3d-a6be-b864f20164d0"}