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

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

@@ -3,13 +3,12 @@
  *
  * 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.
+ * Note: the `-widget` suffix split is rolling out per-tool.
+ * `fetch-actor-details` and `search-actors` are already split; `call-actor` and
+ * `get-actor-run` still render widgets on their base names until their own splits land.
  */
 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;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,UAA+B,GAAG,MAAM,CA6DnF"}

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

@@ -3,13 +3,12 @@
  *
  * 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.
+ * Note: the `-widget` suffix split is rolling out per-tool.
+ * `fetch-actor-details` and `search-actors` are already split; `call-actor` and
+ * `get-actor-run` still render widgets on their base names until their own splits land.
  */
 import { HelperTools, RAG_WEB_BROWSER } from '../../const.js';
 import { ServerMode } from '../../types.js';
@@ -52,7 +51,7 @@ Some clients render widget-backed Actor tools: the response includes a live UI t
 
 - **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.
+- The \`-widget\` suffix split is rolling out per-tool (\`${HelperTools.ACTOR_GET_DETAILS_WIDGET}\` and \`${HelperTools.STORE_SEARCH_WIDGET}\` already split); until the rest split, widget rendering happens on the base \`${HelperTools.ACTOR_CALL}\` and \`${HelperTools.ACTOR_RUNS_GET}\` tool names when the client supports it.
 ` : ''}
 ## Tool dependencies and disambiguation
 
@@ -70,7 +69,10 @@ Some clients render widget-backed Actor tools: the response includes a live UI t
   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.
+  - 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;;;;;;;;;;;GAWG;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;4DAC/F,WAAW,CAAC,wBAAwB,YAAY,WAAW,CAAC,mBAAmB,mFAAmF,WAAW,CAAC,UAAU,YAAY,WAAW,CAAC,cAAc;CACzR,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;QACH,WAAW,CAAC,YAAY,6EAA6E,WAAW,CAAC,mBAAmB;QACpI,WAAW,CAAC,iBAAiB,6EAA6E,WAAW,CAAC,wBAAwB;uEAC/E,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/package.json

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

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/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"}

package/dist/tools/apps/search_actors_internal.js

@@ -1,65 +0,0 @@
-import dedent from 'dedent';
-import { z } from 'zod';
-import { HelperTools } from '../../const.js';
-import { searchAndFilterActors } from '../../utils/actor_search.js';
-import { compileSchema } from '../../utils/ajv.js';
-import { buildMCPResponse } from '../../utils/mcp.js';
-import { searchActorsBaseArgsSchema } from '../core/search_actors_common.js';
-import { actorSearchInternalOutputSchema } from '../structured_output_schemas.js';
-const searchActorsInternalInputSchema = z.toJSONSchema(searchActorsBaseArgsSchema);
-export const searchActorsInternalTool = Object.freeze({
-    type: 'internal',
-    name: HelperTools.STORE_SEARCH_INTERNAL,
-    description: dedent `
-        Search Actors internally (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 this instead of ${HelperTools.STORE_SEARCH} when you need to find an Actor but the user
-        did NOT explicitly ask to search Actors. For example, when user says "scrape me google maps"
-        and you need to find the right Actor for the task, then fetch its schema and call it.
-
-        Returns only minimal fields (fullName, title, description) needed for subsequent calls.
-    `,
-    inputSchema: searchActorsInternalInputSchema,
-    outputSchema: actorSearchInternalOutputSchema,
-    ajvValidate: compileSchema(searchActorsInternalInputSchema),
-    annotations: {
-        title: 'Search Actors (internal)',
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-    call: async (toolArgs) => {
-        const { args, apifyToken, userRentedActorIds, apifyMcpServer } = toolArgs;
-        const parsed = searchActorsBaseArgsSchema.parse(args);
-        const actors = await searchAndFilterActors({
-            keywords: parsed.keywords,
-            apifyToken,
-            limit: parsed.limit,
-            offset: parsed.offset,
-            paymentProvider: apifyMcpServer.options.paymentProvider,
-            userRentedActorIds,
-        });
-        const minimalActors = actors.map((actor) => ({
-            fullName: `${actor.username}/${actor.name}`,
-            title: actor.title || actor.name,
-            description: actor.description || '',
-        }));
-        return buildMCPResponse({
-            texts: [
-                `Found ${minimalActors.length} Actors for "${parsed.keywords}".`,
-                `Query: ${parsed.keywords}`,
-                `Actors:\n\`\`\`json\n${JSON.stringify(minimalActors)}\n\`\`\``,
-            ],
-            structuredContent: {
-                actors: minimalActors,
-                query: parsed.keywords,
-                count: minimalActors.length,
-            },
-        });
-    },
-});
-//# sourceMappingURL=search_actors_internal.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"search_actors_internal.js","sourceRoot":"","sources":["../../../src/tools/apps/search_actors_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,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAElF,MAAM,+BAA+B,GAAG,CAAC,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,wBAAwB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC7D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,qBAAqB;IACvC,WAAW,EAAE,MAAM,CAAA;;;;;;8BAMO,WAAW,CAAC,YAAY;;;;;KAKjD;IACD,WAAW,EAAE,+BAAkD;IAC/D,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE,aAAa,CAAC,+BAA+B,CAAC;IAC3D,WAAW,EAAE;QACT,KAAK,EAAE,0BAA0B;QACjC,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QAC1E,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU;YACV,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,eAAe;YACvD,kBAAkB;SACrB,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YAC3C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;SACvC,CAAC,CAAC,CAAC;QAEJ,OAAO,gBAAgB,CAAC;YACpB,KAAK,EAAE;gBACH,SAAS,aAAa,CAAC,MAAM,gBAAgB,MAAM,CAAC,QAAQ,IAAI;gBAChE,UAAU,MAAM,CAAC,QAAQ,EAAE;gBAC3B,wBAAwB,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,UAAU;aAClE;YACD,iBAAiB,EAAE;gBACf,MAAM,EAAE,aAAa;gBACrB,KAAK,EAAE,MAAM,CAAC,QAAQ;gBACtB,KAAK,EAAE,aAAa,CAAC,MAAM;aAC9B;SACJ,CAAC,CAAC;IACP,CAAC;CACJ,CAAC,CAAC"}