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

package/dist/utils/pricing_info.js

@@ -169,7 +169,7 @@ function formatPayPerEventComplete(pricingPerEvent) {
     const eventLines = Object.values(pricingPerEvent.actorChargeEvents).map((event) => {
         var _a;
         const detail = formatCompleteEventDetail(event);
-        return `\t- **${event.eventTitle}**: ${(_a = event.eventDescription) !== null && _a !== void 0 ? _a : ''} (${detail})`;
+        return `  - **${event.eventTitle}**: ${(_a = event.eventDescription) !== null && _a !== void 0 ? _a : ''} (${detail})`;
     });
     return `This Actor is paid per event:\n${eventLines.join('\n')}`;
 }
@@ -295,8 +295,8 @@ function formatPayPerEventSimplified(pricingPerEvent, userTier) {
         }
         const detail = typeof price === 'number' ? `$${price} per event` : 'No price info';
         if (omitDescriptions)
-            return `\t- **${event.eventTitle}**: ${detail}`;
-        return `\t- **${event.eventTitle}**: ${(_a = event.eventDescription) !== null && _a !== void 0 ? _a : ''} (${detail})`;
+            return `  - **${event.eventTitle}**: ${detail}`;
+        return `  - **${event.eventTitle}**: ${(_a = event.eventDescription) !== null && _a !== void 0 ? _a : ''} (${detail})`;
     });
     const body = `This Actor is paid per event:\n${eventLines.join('\n')}`;
     const anyMultiTier = events.some((event) => hasMultipleTiers(event.eventTieredPricingUsd));

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

@@ -3,13 +3,8 @@
  *
  * Apps-only sections (widget workflow, widget tool disambiguation) are included
  * only when the resolved server mode is `'apps'`. Default-mode clients never
- * see tool names like `search-actors-internal` or `fetch-actor-details-internal`,
+ * see widget tool names like `search-actors-widget` or `fetch-actor-details-widget`,
  * avoiding hallucinated calls to tools absent from `tools/list`.
- *
- * Note: the `-widget` suffix split (separating widget-backed tools from silent
- * variants by name) is planned in follow-up PRs. Until then, widget rendering
- * happens on the base tool names (`call-actor`, `search-actors`,
- * `fetch-actor-details`) in apps mode.
  */
 import { ServerMode } from '../../types.js';
 /**

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;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,UAA+B,GAAG,MAAM,CA0DnF"}
+{"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,CA+DnF"}

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

@@ -3,13 +3,8 @@
  *
  * Apps-only sections (widget workflow, widget tool disambiguation) are included
  * only when the resolved server mode is `'apps'`. Default-mode clients never
- * see tool names like `search-actors-internal` or `fetch-actor-details-internal`,
+ * see widget tool names like `search-actors-widget` or `fetch-actor-details-widget`,
  * avoiding hallucinated calls to tools absent from `tools/list`.
- *
- * Note: the `-widget` suffix split (separating widget-backed tools from silent
- * variants by name) is planned in follow-up PRs. Until then, widget rendering
- * happens on the base tool names (`call-actor`, `search-actors`,
- * `fetch-actor-details`) in apps mode.
  */
 import { HelperTools, RAG_WEB_BROWSER } from '../../const.js';
 import { ServerMode } from '../../types.js';
@@ -50,9 +45,8 @@ ${isApps ? `
 ## Widget workflow (applies when tool responses include widget metadata)
 Some clients render widget-backed Actor tools: the response includes a live UI that automatically polls run status. When a widget is rendered, follow-up status polling by the model is a forbidden duplicate.
 
-- **Never call \`${HelperTools.ACTOR_RUNS_GET}\` after a widget-backed \`${HelperTools.ACTOR_CALL}\` response.** The widget renders live progress and polls itself — stop after the widget response and defer to it for run status.
-- When \`${HelperTools.ACTOR_CALL}\` runs without a widget (the tool response is plain text / structured data only), polling \`${HelperTools.ACTOR_RUNS_GET}\` for status is expected.
-- Follow-up PRs will split widget-backed tools into a dedicated \`-widget\`-suffixed namespace; until then, widget rendering happens on the base tool names when the client supports it.
+- **After \`${HelperTools.ACTOR_CALL_WIDGET}\` or \`${HelperTools.ACTOR_RUNS_GET_WIDGET}\`, never call \`${HelperTools.ACTOR_RUNS_GET}\` or \`${HelperTools.ACTOR_RUNS_GET_WIDGET}\` for the same run.** Both widgets render live progress and poll themselves — stop after the widget response and defer to it for run status. Re-rendering the same run via \`${HelperTools.ACTOR_RUNS_GET_WIDGET}\` is a duplicate.
+- Polling \`${HelperTools.ACTOR_RUNS_GET}\` after \`${HelperTools.ACTOR_CALL}\` (the silent async variant, no widget) is fine — that tool renders no UI, so polling is expected when you need the run status.
 ` : ''}
 ## Tool dependencies and disambiguation
 
@@ -60,17 +54,23 @@ Some clients render widget-backed Actor tools: the response includes a live UI t
 - \`${HelperTools.ACTOR_CALL}\`:
   - Use \`${HelperTools.ACTOR_GET_DETAILS}\` first to obtain the Actor's input schema.
   - Then call with proper input to execute the Actor.
-  - For MCP server Actors, use format "actorName:toolName" to call specific tools.
+  - For MCP server Actors, use format "actorName:toolName" to call specific tools.${isApps ? `
+  - In this mode \`${HelperTools.ACTOR_CALL}\` always runs asynchronously — it starts the run and returns immediately with a runId. Use \`${HelperTools.ACTOR_RUNS_GET}\` to check status and \`${HelperTools.ACTOR_OUTPUT_GET}\` to fetch output once the run completes.` : `
   - Supports async execution via the \`async\` parameter:
     - \`async: false\` or unset: waits for completion and returns results immediately.
-    - \`async: true\`: starts the run and returns immediately with a runId.
+    - \`async: true\`: starts the run and returns immediately with a runId.`}
 
 ### 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 ? `- **Widget-backed variants (when the client supports them):** Some \`${HelperTools.STORE_SEARCH}\` / \`${HelperTools.ACTOR_GET_DETAILS}\` responses render an interactive widget for the user. Prefer the widget-backed variant when the user explicitly asks to *see*, *browse*, or *view* something; when the next step is to actually run an Actor or perform a programmatic flow, prefer a silent lookup if such a variant is available (for example, \`${HelperTools.STORE_SEARCH_INTERNAL}\` or \`${HelperTools.ACTOR_GET_DETAILS_INTERNAL}\`), otherwise use the standard lookup tools. A \`-widget\` suffix split is planned in a follow-up PR; until then, widget rendering is selected by the server based on client capabilities.
+${isApps ? `- **Data vs widget Actor tools (when the client supports widgets):**
+  - \`${HelperTools.STORE_SEARCH}\` is a silent data lookup (Actor list for name resolution) with no UI; \`${HelperTools.STORE_SEARCH_WIDGET}\` renders an interactive UI element (widget) with Actor search results for the user to browse — use it only when the user explicitly asks to search or discover Actors.
+  - \`${HelperTools.ACTOR_GET_DETAILS}\` is a silent data lookup (input schema, README, metadata) with no UI; \`${HelperTools.ACTOR_GET_DETAILS_WIDGET}\` renders an interactive UI element (widget) with Actor details — use it only when the user explicitly asks to see or browse the Actor.
+  - \`${HelperTools.ACTOR_CALL}\` is a silent async start (returns runId, no UI); \`${HelperTools.ACTOR_CALL_WIDGET}\` renders an interactive UI element (widget) that tracks live Actor run progress — use it only when the user explicitly asks to see progress.
+  - \`${HelperTools.ACTOR_RUNS_GET}\` is a silent data lookup (run status, dataset IDs, stats) with no UI; \`${HelperTools.ACTOR_RUNS_GET_WIDGET}\` renders an interactive UI element (widget) showing live run progress for the user — use it only when the user explicitly asks to see run progress.
+  - When the next step is running an Actor, prefer silent lookups (\`${HelperTools.STORE_SEARCH}\`, \`${HelperTools.ACTOR_GET_DETAILS}\`) over widget-backed variants.
 ` : ''}- **\`${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}\`:**

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;;;;;;;;;;;;GAYG;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;;;;;;;;;;;;;;;;;;;;;;;;;EAyBT,MAAM,CAAC,CAAC,CAAC;;;;mBAIQ,WAAW,CAAC,cAAc,8BAA8B,WAAW,CAAC,UAAU;WACtF,WAAW,CAAC,UAAU,gGAAgG,WAAW,CAAC,cAAc;;CAE1J,CAAC,CAAC,CAAC,EAAE;;;;MAIA,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;EAC/E,MAAM,CAAC,CAAC,CAAC,wEAAwE,WAAW,CAAC,YAAY,UAAU,WAAW,CAAC,iBAAiB,wTAAwT,WAAW,CAAC,qBAAqB,WAAW,WAAW,CAAC,0BAA0B;CAC3hB,CAAC,CAAC,CAAC,EAAE,SAAS,WAAW,CAAC,YAAY,SAAS,eAAe;MACzD,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;;;;;;;;;;;;;;;;;;;;;;;;;EAyBT,MAAM,CAAC,CAAC,CAAC;;;;cAIG,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,CAAC,CAAC,CAAC,EAAE;;;;MAIA,WAAW,CAAC,UAAU;YAChB,WAAW,CAAC,iBAAiB;;oFAE2C,MAAM,CAAC,CAAC,CAAC;qBACxE,WAAW,CAAC,UAAU,iGAAiG,WAAW,CAAC,cAAc,4BAA4B,WAAW,CAAC,gBAAgB,4CAA4C,CAAC,CAAC,CAAC;;;4EAGjM;;;QAGpE,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;EAC/E,MAAM,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,YAAY,6EAA6E,WAAW,CAAC,mBAAmB;QACpI,WAAW,CAAC,iBAAiB,6EAA6E,WAAW,CAAC,wBAAwB;QAC9I,WAAW,CAAC,UAAU,wDAAwD,WAAW,CAAC,iBAAiB;QAC3G,WAAW,CAAC,cAAc,6EAA6E,WAAW,CAAC,qBAAqB;uEACzE,WAAW,CAAC,YAAY,SAAS,WAAW,CAAC,iBAAiB;CACpI,CAAC,CAAC,CAAC,EAAE,SAAS,WAAW,CAAC,YAAY,SAAS,eAAe;MACzD,WAAW,CAAC,YAAY,8DAA8D,eAAe;kCACzE,eAAe,UAAU,WAAW,CAAC,UAAU;iDAChC,WAAW,CAAC,UAAU;CACtE,CAAC;AACF,CAAC"}

package/dist/utils/tools_loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools_loader.d.ts","sourceRoot":"","sources":["../../src/utils/tools_loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAgB,UAAU,EAAE,MAAM,aAAa,CAAC;AAqGvD,+DAA+D;AAC/D,wBAAsB,SAAS,CAC3B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAKtB;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAqB3D;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,IAAI,GAAE,UAA+B,GAAG,SAAS,EAAE,CAkH/H;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE,UAA+B,EACrC,UAAU,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAGtB"}
+{"version":3,"file":"tools_loader.d.ts","sourceRoot":"","sources":["../../src/utils/tools_loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAgBhD,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAgB,UAAU,EAAE,MAAM,aAAa,CAAC;AAyGvD,+DAA+D;AAC/D,wBAAsB,SAAS,CAC3B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAKtB;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAqB3D;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,IAAI,GAAE,UAA+B,GAAG,SAAS,EAAE,CA0H/H;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE,UAA+B,EACrC,UAAU,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAGtB"}

package/dist/utils/tools_loader.js

@@ -4,9 +4,10 @@
  */
 import log from '@apify/log';
 import { defaults, HelperTools } from '../const.js';
-import { CATEGORY_NAME_SET, CATEGORY_NAMES, getCategoryTools, toolCategoriesEnabledByDefault } from '../tools/categories.js';
+import { CATEGORY_NAME_SET, CATEGORY_NAMES, getCategoryTools, toolCategoriesEnabledByDefault, WIDGET_BY_BASE_TOOL, } from '../tools/categories.js';
 import { addTool } from '../tools/common/add_actor.js';
 import { getActorOutput } from '../tools/common/get_actor_output.js';
+import { defaultGetActorRun } from '../tools/default/get_actor_run.js';
 import { getActorsAsTools } from '../tools/index.js';
 import { SERVER_MODES, ServerMode } from '../types.js';
 // All internal tool names across all modes. Selectors matching these are not treated as Actor IDs.
@@ -23,6 +24,10 @@ function getAllInternalToolNames() {
                 }
             }
         }
+        // Widgets live only in WIDGET_BY_BASE_TOOL, not in any category
+        for (const widget of WIDGET_BY_BASE_TOOL.values()) {
+            allNames.add(widget.name);
+        }
         ALL_INTERNAL_TOOL_NAMES_CACHE = allNames;
     }
     return ALL_INTERNAL_TOOL_NAMES_CACHE;
@@ -129,12 +134,17 @@ export function getToolsForServerMode(input, actorTools, mode = ServerMode.DEFAU
     const categories = getCategoryTools(mode);
     const { selectors, addActorEnabled, actorsExplicitlyEmpty } = normalizeInput(input);
     const selectorsExplicitEmpty = (selectors === null || selectors === void 0 ? void 0 : selectors.length) === 0;
-    const explicitlyNoToolsRequested = selectorsExplicitEmpty || actorsExplicitlyEmpty;
     // Build mode-specific tool-by-name map for individual tool selection
-    const modeToolByName = new Map();
+    const toolsByName = new Map();
     for (const name of CATEGORY_NAMES) {
         for (const tool of categories[name]) {
-            modeToolByName.set(tool.name, tool);
+            toolsByName.set(tool.name, tool);
+        }
+    }
+    // Widgets are apps-only and not in any category; include for direct selection
+    if (mode === ServerMode.APPS) {
+        for (const widget of WIDGET_BY_BASE_TOOL.values()) {
+            toolsByName.set(widget.name, widget);
         }
     }
     // Walk selectors for internal picks (mode-specific). Actor-name classification
@@ -145,7 +155,7 @@ export function getToolsForServerMode(input, actorTools, mode = ServerMode.DEFAU
             if (sel === 'preview') {
                 // 'preview' category is deprecated. It contained `call-actor` which is now default.
                 log.warning('Tool category "preview" is deprecated');
-                const callActorTool = modeToolByName.get(HelperTools.ACTOR_CALL);
+                const callActorTool = toolsByName.get(HelperTools.ACTOR_CALL);
                 if (callActorTool)
                     internalSelections.push(callActorTool);
                 continue;
@@ -155,7 +165,7 @@ export function getToolsForServerMode(input, actorTools, mode = ServerMode.DEFAU
                 internalSelections.push(...categoryTools);
                 continue;
             }
-            const internalByName = modeToolByName.get(sel);
+            const internalByName = toolsByName.get(sel);
             if (internalByName) {
                 internalSelections.push(internalByName);
                 continue;
@@ -190,10 +200,6 @@ export function getToolsForServerMode(input, actorTools, mode = ServerMode.DEFAU
             result.push(...categories[cat]);
         }
     }
-    // In apps mode, unconditionally add UI-specific tools (regardless of selectors)
-    if (mode === ServerMode.APPS && !explicitlyNoToolsRequested) {
-        result.push(...categories.ui);
-    }
     // Actor tools (pre-fetched, mode-agnostic)
     if (actorTools.length > 0) {
         result.push(...actorTools);
@@ -202,22 +208,18 @@ export function getToolsForServerMode(input, actorTools, mode = ServerMode.DEFAU
      * Auto-inject get-actor-run and get-actor-output when call-actor or actor tools are present.
      * Insert them right after call-actor to follow the logical workflow order:
      * search → details → call → run status → output → docs → actor tools
-     *
-     * Uses mode-resolved variants from getCategoryTools() for get-actor-run.
      */
     const hasCallActor = result.some((entry) => entry.name === HelperTools.ACTOR_CALL);
     const hasActorTools = result.some((entry) => entry.type === 'actor');
     const hasAddActorTool = result.some((entry) => entry.name === HelperTools.ACTOR_ADD);
-    const hasGetActorRun = result.some((entry) => entry.name === HelperTools.ACTOR_RUNS_GET);
-    const hasGetActorOutput = result.some((entry) => entry.name === HelperTools.ACTOR_OUTPUT_GET);
+    // No presence guards here — the de-dup pass at the end drops any duplicates.
     const toolsToInject = [];
-    if (!hasGetActorRun && (hasCallActor || (mode === ServerMode.APPS && !explicitlyNoToolsRequested))) {
-        // Use mode-resolved get-actor-run variant
-        const modeGetActorRun = modeToolByName.get(HelperTools.ACTOR_RUNS_GET);
-        if (modeGetActorRun)
-            toolsToInject.push(modeGetActorRun);
+    // In default mode call-actor is synchronous, so get-actor-run is only needed when call-actor
+    // is present. In apps mode call-actor is always async, so actor tools also need get-actor-run.
+    if (hasCallActor || (hasActorTools && mode === ServerMode.APPS)) {
+        toolsToInject.push(defaultGetActorRun);
     }
-    if (!hasGetActorOutput && (hasCallActor || hasActorTools || hasAddActorTool)) {
+    if (hasCallActor || hasActorTools || hasAddActorTool) {
         toolsToInject.push(getActorOutput);
     }
     if (toolsToInject.length > 0) {
@@ -229,6 +231,17 @@ export function getToolsForServerMode(input, actorTools, mode = ServerMode.DEFAU
             result.push(...toolsToInject);
         }
     }
+    // Apps mode: append a widget tool for each base tool already in the result.
+    // Runs after the get-actor-run auto-inject so an auto-injected base still
+    // brings its widget sibling.
+    if (mode === ServerMode.APPS) {
+        for (const entry of [...result]) {
+            const widget = WIDGET_BY_BASE_TOOL.get(entry.name);
+            // Push unconditionally; any duplicates are stripped by the de-dup pass below.
+            if (widget)
+                result.push(widget);
+        }
+    }
     // De-duplicate by tool name for safety
     const seen = new Set();
     return result.filter((entry) => !seen.has(entry.name) && seen.add(entry.name));

package/dist/utils/tools_loader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apify/actors-mcp-server",
-  "version": "0.9.21-beta.0",
+  "version": "0.9.21-beta.10",
   "type": "module",
   "description": "Apify MCP Server",
   "mcpName": "com.apify/apify-mcp-server",
@@ -97,6 +97,9 @@
     "test": "npm run test:unit",
     "test:unit": "vitest run tests/unit",
     "test:integration": "npm run build && vitest run tests/integration",
+    "test:integration:stdio": "npm run build && vitest run tests/integration/stdio.test.ts",
+    "test:integration:sse": "npm run build && vitest run tests/integration/actor.server_sse.test.ts",
+    "test:integration:streamable": "npm run build && vitest run tests/integration/actor.server_streamable.test.ts",
     "inspector:stdio": "npx @modelcontextprotocol/inspector -e APIFY_TOKEN=$APIFY_TOKEN -- node dist/stdio.js",
     "evals:create-dataset": "tsx evals/create_dataset.ts",
     "evals:run": "tsx evals/run_evaluation.ts",

package/dist/tools/apps/fetch_actor_details.d.ts

@@ -1,7 +0,0 @@
-import type { ToolEntry } from '../../types.js';
-/**
- * Apps mode fetch-actor-details tool.
- * Returns simplified structured content with interactive widget metadata.
- */
-export declare const appsFetchActorDetails: ToolEntry;
-//# sourceMappingURL=fetch_actor_details.d.ts.map

package/dist/tools/apps/fetch_actor_details.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch_actor_details.d.ts","sourceRoot":"","sources":["../../../src/tools/apps/fetch_actor_details.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAgBlE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SA6CzB,CAAC"}

package/dist/tools/apps/fetch_actor_details.js

@@ -1,55 +0,0 @@
-import dedent from 'dedent';
-import { ApifyClient } from '../../apify_client.js';
-import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
-import { buildActorDetailsForWidget, buildCardOptions, fetchActorDetails, } from '../../utils/actor_details.js';
-import { buildMCPResponse } from '../../utils/mcp.js';
-import { getUserInfoCached } from '../../utils/userid_cache.js';
-import { fixActorNameInputAndLog } from '../core/actor_tools_factory.js';
-import { buildActorNotFoundResponse, fetchActorDetailsMetadata, fetchActorDetailsToolArgsSchema, resolveOutputOptions, } from '../core/fetch_actor_details_common.js';
-/**
- * Apps mode fetch-actor-details tool.
- * Returns simplified structured content with interactive widget metadata.
- */
-export const appsFetchActorDetails = Object.freeze({
-    ...fetchActorDetailsMetadata,
-    call: async (toolArgs) => {
-        const { args, apifyToken, mcpSessionId } = toolArgs;
-        const parsed = fetchActorDetailsToolArgsSchema.parse(args);
-        const actorName = fixActorNameInputAndLog(parsed.actor, { mcpSessionId, route: 'fetch-actor-details' });
-        const apifyClient = new ApifyClient({ token: apifyToken });
-        const { userPlanTier } = await getUserInfoCached(apifyToken, apifyClient);
-        const cardOptions = { ...buildCardOptions(resolveOutputOptions(parsed.output)), userTier: userPlanTier };
-        const details = await fetchActorDetails(apifyClient, actorName, cardOptions);
-        if (!details) {
-            return buildActorNotFoundResponse(actorName);
-        }
-        const { actorUrl, actorDetails } = buildActorDetailsForWidget(details, userPlanTier);
-        // Pricing is already carried by `actorDetails.actorInfo.currentPricingInfo` (widget-facing,
-        // tier-aware simplified). Omit the complete-mode `pricing` field from the top-level
-        // `actorInfo` to avoid two conflicting pricing shapes in the same response.
-        const { pricing: _pricing, ...actorInfoWithoutPricing } = details.actorCardStructured;
-        const structuredContent = {
-            actorInfo: actorInfoWithoutPricing,
-            inputSchema: details.inputSchema,
-            actorDetails,
-        };
-        const texts = [dedent `
-            # Actor information:
-            - **Actor:** ${actorName}
-            - **URL:** ${actorUrl}
-
-            An interactive widget has been rendered with detailed Actor information.
-        `];
-        const widgetConfig = getWidgetConfig(WIDGET_URIS.SEARCH_ACTORS);
-        return buildMCPResponse({
-            texts,
-            structuredContent,
-            // Response-level meta; only returned in apps mode (this handler is apps-only)
-            _meta: {
-                ...widgetConfig === null || widgetConfig === void 0 ? void 0 : widgetConfig.meta,
-                'openai/widgetDescription': `Actor details for ${actorName} from Apify Store`,
-            },
-        });
-    },
-});
-//# sourceMappingURL=fetch_actor_details.js.map

package/dist/tools/apps/fetch_actor_details.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch_actor_details.js","sourceRoot":"","sources":["../../../src/tools/apps/fetch_actor_details.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EACH,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EACH,0BAA0B,EAC1B,yBAAyB,EACzB,+BAA+B,EAC/B,oBAAoB,GACvB,MAAM,uCAAuC,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC1D,GAAG,yBAAyB;IAC5B,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QACpD,MAAM,MAAM,GAAG,+BAA+B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,uBAAuB,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACxG,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAE3D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC1E,MAAM,WAAW,GAAG,EAAE,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzG,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAC7E,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,0BAA0B,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,0BAA0B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACrF,4FAA4F;QAC5F,oFAAoF;QACpF,4EAA4E;QAC5E,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,uBAAuB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACtF,MAAM,iBAAiB,GAAG;YACtB,SAAS,EAAE,uBAAuB;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY;SACf,CAAC;QAEF,MAAM,KAAK,GAAG,CAAC,MAAM,CAAA;;2BAEF,SAAS;yBACX,QAAQ;;;SAGxB,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAChE,OAAO,gBAAgB,CAAC;YACpB,KAAK;YACL,iBAAiB;YACjB,8EAA8E;YAC9E,KAAK,EAAE;gBACH,GAAG,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,IAAI;gBACrB,0BAA0B,EAAE,qBAAqB,SAAS,mBAAmB;aAChF;SACJ,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/apps/fetch_actor_details_internal.d.ts

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

package/dist/tools/apps/fetch_actor_details_internal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch_actor_details_internal.d.ts","sourceRoot":"","sources":["../../../src/tools/apps/fetch_actor_details_internal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAQjE,eAAO,MAAM,6BAA6B,EAAE,SA4BjC,CAAC"}

package/dist/tools/apps/fetch_actor_details_internal.js

@@ -1,36 +0,0 @@
-import dedent from 'dedent';
-import { z } from 'zod';
-import { HelperTools } from '../../const.js';
-import { compileSchema } from '../../utils/ajv.js';
-import { buildFetchActorDetailsResult, fetchActorDetailsToolArgsSchema, } from '../core/fetch_actor_details_common.js';
-import { actorDetailsOutputSchema } from '../structured_output_schemas.js';
-export const fetchActorDetailsInternalTool = Object.freeze({
-    type: 'internal',
-    name: HelperTools.ACTOR_GET_DETAILS_INTERNAL,
-    description: dedent `
-        Fetch Actor details with flexible output options (apps mode internal tool).
-
-        This tool is available because the LLM is operating in apps mode. Use it for internal lookups
-        where data presentation to the user is NOT needed - this tool does NOT render a widget.
-
-        Use 'output' parameter with boolean flags to control returned information:
-        - Default: Fields: description, stats, pricing, rating, metadata, inputSchema, readme - except mcpTools
-        - Selective: Set desired fields to true to save tokens (e.g., output: { inputSchema: true, readme: false })
-        - Common patterns: inputSchema only for execution prep, readme + inputSchema for documentation, etc.
-
-        Use this instead of fetch-actor-details when you need Actor information to prepare execution
-        but the user did NOT explicitly ask for Actor details presentation.
-    `,
-    inputSchema: z.toJSONSchema(fetchActorDetailsToolArgsSchema),
-    outputSchema: actorDetailsOutputSchema,
-    ajvValidate: compileSchema(z.toJSONSchema(fetchActorDetailsToolArgsSchema)),
-    annotations: {
-        title: 'Fetch Actor details internal',
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-    call: async (toolArgs) => buildFetchActorDetailsResult(toolArgs, HelperTools.ACTOR_GET_DETAILS_INTERNAL),
-});
-//# sourceMappingURL=fetch_actor_details_internal.js.map

package/dist/tools/apps/fetch_actor_details_internal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch_actor_details_internal.js","sourceRoot":"","sources":["../../../src/tools/apps/fetch_actor_details_internal.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACH,4BAA4B,EAC5B,+BAA+B,GAClC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,CAAC,MAAM,6BAA6B,GAAc,MAAM,CAAC,MAAM,CAAC;IAClE,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,0BAA0B;IAC5C,WAAW,EAAE,MAAM,CAAA;;;;;;;;;;;;;KAalB;IACD,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,+BAA+B,CAAoB;IAC/E,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;IAC3E,WAAW,EAAE;QACT,KAAK,EAAE,8BAA8B;QACrC,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,4BAA4B,CAAC,QAAQ,EAAE,WAAW,CAAC,0BAA0B,CAAC;CAClG,CAAC,CAAC"}

package/dist/tools/apps/get_actor_run.d.ts

@@ -1,7 +0,0 @@
-import type { ToolEntry } from '../../types.js';
-/**
- * Apps mode get-actor-run tool.
- * Returns abbreviated text with widget metadata for interactive progress display.
- */
-export declare const appsGetActorRun: ToolEntry;
-//# sourceMappingURL=get_actor_run.d.ts.map

package/dist/tools/apps/get_actor_run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get_actor_run.d.ts","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAUlE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAuBnB,CAAC"}

package/dist/tools/apps/get_actor_run.js

@@ -1,29 +0,0 @@
-import { logHttpError } from '../../utils/logging.js';
-import { buildGetActorRunError, buildGetActorRunSuccessResponse, fetchActorRunData, getActorRunArgs, getActorRunMetadata, } from '../core/get_actor_run_common.js';
-/**
- * Apps mode get-actor-run tool.
- * Returns abbreviated text with widget metadata for interactive progress display.
- */
-export const appsGetActorRun = Object.freeze({
-    ...getActorRunMetadata,
-    call: async (toolArgs) => {
-        const { args, apifyClient: client, mcpSessionId } = toolArgs;
-        const parsed = getActorRunArgs.parse(args);
-        try {
-            const fetchResult = await fetchActorRunData({
-                runId: parsed.runId,
-                client,
-                mcpSessionId,
-            });
-            if ('error' in fetchResult) {
-                return fetchResult.error;
-            }
-            return buildGetActorRunSuccessResponse({ ...fetchResult.result, widget: true });
-        }
-        catch (error) {
-            logHttpError(error, 'Failed to get Actor run', { runId: parsed.runId });
-            return buildGetActorRunError(parsed.runId, error);
-        }
-    },
-});
-//# sourceMappingURL=get_actor_run.js.map

package/dist/tools/apps/get_actor_run.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get_actor_run.js","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACH,qBAAqB,EACrB,+BAA+B,EAC/B,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACtB,MAAM,iCAAiC,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAc,MAAM,CAAC,MAAM,CAAC;IACpD,GAAG,mBAAmB;IACtB,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;gBACxC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM;gBACN,YAAY;aACf,CAAC,CAAC;YAEH,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBACzB,OAAO,WAAW,CAAC,KAAK,CAAC;YAC7B,CAAC;YAED,OAAO,+BAA+B,CAAC,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACxE,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/apps/search_actors.d.ts

@@ -1,7 +0,0 @@
-import type { ToolEntry } from '../../types.js';
-/**
- * Apps mode search-actors tool.
- * Returns widget-formatted actors with interactive widget metadata.
- */
-export declare const appsSearchActors: ToolEntry;
-//# sourceMappingURL=search_actors.d.ts.map

package/dist/tools/apps/search_actors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"search_actors.d.ts","sourceRoot":"","sources":["../../../src/tools/apps/search_actors.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOlE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAsFpB,CAAC"}

package/dist/tools/apps/search_actors.js

@@ -1,89 +0,0 @@
-import dedent from 'dedent';
-import { HelperTools } from '../../const.js';
-import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
-import { formatActorForWidget } from '../../utils/actor_card.js';
-import { searchAndFilterActors } from '../../utils/actor_search.js';
-import { buildMCPResponse } from '../../utils/mcp.js';
-import { getUserInfoCached } from '../../utils/userid_cache.js';
-import { buildSearchActorsEmptyResponse, buildSearchActorsResult, searchActorsArgsSchema, searchActorsMetadata } from '../core/search_actors_common.js';
-/**
- * Apps mode search-actors tool.
- * Returns widget-formatted actors with interactive widget metadata.
- */
-export const appsSearchActors = Object.freeze({
-    ...searchActorsMetadata,
-    call: async (toolArgs) => {
-        const { args, apifyToken, apifyClient, userRentedActorIds, apifyMcpServer } = toolArgs;
-        const parsed = searchActorsArgsSchema.parse(args);
-        // Actor search and user-info fetch are independent; run in parallel to avoid a
-        // sequential round-trip on cache miss.
-        const [actors, { userPlanTier }] = await Promise.all([
-            searchAndFilterActors({
-                keywords: parsed.keywords,
-                apifyToken,
-                limit: parsed.limit,
-                offset: parsed.offset,
-                paymentProvider: apifyMcpServer.options.paymentProvider,
-                userRentedActorIds,
-            }),
-            getUserInfoCached(apifyToken, apifyClient),
-        ]);
-        if (actors.length === 0) {
-            return buildSearchActorsEmptyResponse(parsed.keywords);
-        }
-        const { actorCardText, actorCardStructured } = buildSearchActorsResult(actors, userPlanTier);
-        const structuredContent = {
-            actors: actorCardStructured,
-            query: parsed.keywords,
-            count: actors.length,
-            instructions: dedent `
-                Choosing the right details tool: Use ${HelperTools.ACTOR_GET_DETAILS} when the user
-                wants to browse or explore Actors (e.g., "show me", "find me").
-                Use ${HelperTools.ACTOR_GET_DETAILS_INTERNAL} when the user wants to execute a task and
-                you need the input schema (e.g., "scrape", "extract").
-                IMPORTANT: You MUST always do a second search with broader, more generic keywords
-                (e.g., just the platform name like "TikTok" instead of "TikTok posts") to make sure
-                you haven't missed a better Actor.
-            `,
-        };
-        // Add widget-formatted actors for the interactive UI
-        structuredContent.widgetActors = actors.map((actor) => formatActorForWidget(actor, userPlanTier));
-        const texts = [dedent `
-            # Search results:
-            - **Search query:** ${parsed.keywords}
-            - **Number of Actors found:** ${actors.length}
-
-            An interactive widget has been rendered with the search results. The user can already see
-            the list of Actors visually in the widget, so do NOT print or summarize the Actor list
-            in your response.
-
-            # Actors:
-
-            ${actorCardText}
-
-            ## Choosing the right details tool:
-            - Use ${HelperTools.ACTOR_GET_DETAILS} when the user wants to **browse or explore**
-              Actors (e.g., "show me Google Maps scrapers", "find me a TikTok scraper", "what Actors
-              exist for LinkedIn"). This renders an interactive widget for the user.
-            - Use ${HelperTools.ACTOR_GET_DETAILS_INTERNAL} when the user wants to **execute a task**
-              and you need the Actor's input schema to prepare the run (e.g., "scrape Google Maps for
-              restaurants", "extract emails from this website"). This is a silent lookup — no widget
-              is rendered.
-
-            IMPORTANT: You MUST always do a second search with broader, more generic keywords
-            (e.g., just the platform name like "TikTok" instead of "TikTok posts") to make sure
-            you haven't missed a better Actor.
-        `];
-        const widgetConfig = getWidgetConfig(WIDGET_URIS.SEARCH_ACTORS);
-        return buildMCPResponse({
-            texts,
-            structuredContent,
-            // Response-level meta; only returned in apps mode (this handler is apps-only)
-            _meta: {
-                ...widgetConfig === null || widgetConfig === void 0 ? void 0 : widgetConfig.meta,
-                'openai/widgetDescription': `Interactive actor search results showing ${actors.length} actors from Apify Store`,
-            },
-        });
-    },
-});
-//# sourceMappingURL=search_actors.js.map

package/dist/tools/apps/search_actors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"search_actors.js","sourceRoot":"","sources":["../../../src/tools/apps/search_actors.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAoB,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,8BAA8B,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAExJ;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAc,MAAM,CAAC,MAAM,CAAC;IACrD,GAAG,oBAAoB;IACvB,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QACvF,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,+EAA+E;QAC/E,uCAAuC;QACvC,MAAM,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjD,qBAAqB,CAAC;gBAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,UAAU;gBACV,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,eAAe;gBACvD,kBAAkB;aACrB,CAAC;YACF,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC;SAC7C,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,8BAA8B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC7F,MAAM,iBAAiB,GAMnB;YACA,MAAM,EAAE,mBAAmB;YAC3B,KAAK,EAAE,MAAM,CAAC,QAAQ;YACtB,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,YAAY,EAAE,MAAM,CAAA;uDACuB,WAAW,CAAC,iBAAiB;;sBAE9D,WAAW,CAAC,0BAA0B;;;;;aAK/C;SACJ,CAAC;QAEF,qDAAqD;QACrD,iBAAiB,CAAC,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QAElG,MAAM,KAAK,GAAG,CAAC,MAAM,CAAA;;kCAEK,MAAM,CAAC,QAAQ;4CACL,MAAM,CAAC,MAAM;;;;;;;;cAQ3C,aAAa;;;oBAGP,WAAW,CAAC,iBAAiB;;;oBAG7B,WAAW,CAAC,0BAA0B;;;;;;;;SAQjD,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAChE,OAAO,gBAAgB,CAAC;YACpB,KAAK;YACL,iBAAiB;YACjB,8EAA8E;YAC9E,KAAK,EAAE;gBACH,GAAG,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,IAAI;gBACrB,0BAA0B,EAAE,4CAA4C,MAAM,CAAC,MAAM,0BAA0B;aAClH;SACJ,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/apps/search_actors_internal.d.ts

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

package/dist/tools/apps/search_actors_internal.d.ts.map

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