@apify/actors-mcp-server 0.9.20-beta.2 → 0.9.20-beta.4

package/dist/tools/openai/fetch_actor_details_internal.js

@@ -1,36 +1,29 @@
+import dedent from 'dedent';
 import { z } from 'zod';
-import { ApifyClient } from '../../apify_client.js';
 import { HelperTools } from '../../const.js';
-import { actorDetailsOutputOptionsSchema, buildActorDetailsTextResponse, buildActorNotFoundResponse, buildCardOptions, fetchActorDetails, resolveOutputOptions, } from '../../utils/actor_details.js';
 import { compileSchema } from '../../utils/ajv.js';
-import { buildMCPResponse } from '../../utils/mcp.js';
-import { fixActorNameInputAndLog } from '../core/actor_tools_factory.js';
+import { buildFetchActorDetailsResult, fetchActorDetailsToolArgsSchema, } from '../core/fetch_actor_details_common.js';
 import { actorDetailsOutputSchema } from '../structured_output_schemas.js';
-const fetchActorDetailsInternalArgsSchema = z.object({
-    actor: z.string()
-        .min(1)
-        .describe(`Actor ID or full name in the format "username/name", e.g., "apify/rag-web-browser".`),
-    output: actorDetailsOutputOptionsSchema.optional()
-        .describe('Specify which information to include in the response to save tokens.'),
-});
 export const fetchActorDetailsInternalTool = Object.freeze({
     type: 'internal',
     name: HelperTools.ACTOR_GET_DETAILS_INTERNAL,
-    description: `Fetch Actor details with flexible output options (UI mode internal tool).
+    description: dedent `
+        Fetch Actor details with flexible output options (UI mode internal tool).
 
-This tool is available because the LLM is operating in UI mode. Use it for internal lookups
-where data presentation to the user is NOT needed - this tool does NOT render a widget.
+        This tool is available because the LLM is operating in UI 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 '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(fetchActorDetailsInternalArgsSchema),
+        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(fetchActorDetailsInternalArgsSchema)),
+    ajvValidate: compileSchema(z.toJSONSchema(fetchActorDetailsToolArgsSchema)),
     annotations: {
         title: 'Fetch Actor details internal',
         readOnlyHint: true,
@@ -38,34 +31,6 @@ but the user did NOT explicitly ask for Actor details presentation.`,
         idempotentHint: true,
         openWorldHint: false,
     },
-    call: async (toolArgs) => {
-        var _a;
-        const { args, apifyToken, apifyMcpServer, mcpSessionId } = toolArgs;
-        const parsed = fetchActorDetailsInternalArgsSchema.parse(args);
-        const actorName = fixActorNameInputAndLog(parsed.actor, { mcpSessionId, route: 'fetch-actor-details-internal' });
-        const apifyClient = new ApifyClient({ token: apifyToken });
-        const resolvedOutput = resolveOutputOptions(parsed.output);
-        const cardOptions = buildCardOptions(resolvedOutput);
-        const details = await fetchActorDetails(apifyClient, actorName, cardOptions);
-        if (!details) {
-            return buildActorNotFoundResponse(actorName);
-        }
-        // Fetch output schema from ActorStore if available and requested
-        const actorOutputSchema = resolvedOutput.outputSchema
-            ? await ((_a = apifyMcpServer.actorStore) === null || _a === void 0 ? void 0 : _a.getActorOutputSchemaAsTypeObject(actorName).catch(() => null))
-            : undefined;
-        const { texts, structuredContent } = await buildActorDetailsTextResponse({
-            actorName,
-            details,
-            output: resolvedOutput,
-            cardOptions,
-            apifyClient,
-            apifyToken,
-            actorOutputSchema,
-            paymentProvider: apifyMcpServer === null || apifyMcpServer === void 0 ? void 0 : apifyMcpServer.options.paymentProvider,
-            mcpSessionId,
-        });
-        return buildMCPResponse({ texts, structuredContent });
-    },
+    call: async (toolArgs) => buildFetchActorDetailsResult(toolArgs, HelperTools.ACTOR_GET_DETAILS_INTERNAL),
 });
 //# sourceMappingURL=fetch_actor_details_internal.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run.d.ts","sourceRoot":"","sources":["../../../src/tools/openai/get_actor_run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AASlE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SA4CrB,CAAC"}
+{"version":3,"file":"get_actor_run.d.ts","sourceRoot":"","sources":["../../../src/tools/openai/get_actor_run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAUlE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAuBrB,CAAC"}

package/dist/tools/openai/get_actor_run.js

@@ -1,8 +1,5 @@
-import { TOOL_STATUS } from '../../const.js';
-import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
 import { logHttpError } from '../../utils/logging.js';
-import { buildMCPResponse, buildUsageMeta } from '../../utils/mcp.js';
-import { fetchActorRunData, getActorRunArgs, getActorRunMetadata, } from '../core/get_actor_run_common.js';
+import { buildGetActorRunError, buildGetActorRunSuccessResponse, fetchActorRunData, getActorRunArgs, getActorRunMetadata, } from '../core/get_actor_run_common.js';
 /**
  * OpenAI mode get-actor-run tool.
  * Returns abbreviated text with widget metadata for interactive progress display.
@@ -21,30 +18,11 @@ export const openaiGetActorRun = Object.freeze({
             if ('error' in fetchResult) {
                 return fetchResult.error;
             }
-            const { run, structuredContent } = fetchResult.result;
-            const statusText = run.status === 'SUCCEEDED' && structuredContent.dataset
-                ? `Actor run ${parsed.runId} completed successfully with ${structuredContent.dataset.totalItemCount} items. A widget has been rendered with the details.`
-                : `Actor run ${parsed.runId} status: ${run.status}. A progress widget has been rendered.`;
-            const widgetConfig = getWidgetConfig(WIDGET_URIS.ACTOR_RUN);
-            const usageMeta = buildUsageMeta(run);
-            return buildMCPResponse({
-                texts: [statusText],
-                structuredContent,
-                // Response-level meta; only returned in openai mode (this handler is openai-only)
-                _meta: {
-                    ...widgetConfig === null || widgetConfig === void 0 ? void 0 : widgetConfig.meta,
-                    ...usageMeta,
-                },
-            });
+            return buildGetActorRunSuccessResponse({ ...fetchResult.result, widget: true });
         }
         catch (error) {
             logHttpError(error, 'Failed to get Actor run', { runId: parsed.runId });
-            return buildMCPResponse({
-                texts: [`Failed to get Actor run '${parsed.runId}': ${error instanceof Error ? error.message : String(error)}.
-Please verify the run ID and ensure that the run exists.`],
-                isError: true,
-                telemetry: { toolStatus: TOOL_STATUS.SOFT_FAIL },
-            });
+            return buildGetActorRunError(parsed.runId, error);
         }
     },
 });

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

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run.js","sourceRoot":"","sources":["../../../src/tools/openai/get_actor_run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACH,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACtB,MAAM,iCAAiC,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAc,MAAM,CAAC,MAAM,CAAC;IACtD,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,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC;YAEtD,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,iBAAiB,CAAC,OAAO;gBACtE,CAAC,CAAC,aAAa,MAAM,CAAC,KAAK,gCAAgC,iBAAiB,CAAC,OAAO,CAAC,cAAc,sDAAsD;gBACzJ,CAAC,CAAC,aAAa,MAAM,CAAC,KAAK,YAAY,GAAG,CAAC,MAAgB,wCAAwC,CAAC;YAExG,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YACtC,OAAO,gBAAgB,CAAC;gBACpB,KAAK,EAAE,CAAC,UAAU,CAAC;gBACnB,iBAAiB;gBACjB,kFAAkF;gBAClF,KAAK,EAAE;oBACH,GAAG,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,IAAI;oBACrB,GAAG,SAAS;iBACf;aACJ,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACxE,OAAO,gBAAgB,CAAC;gBACpB,KAAK,EAAE,CAAC,4BAA4B,MAAM,CAAC,KAAK,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yDACnE,CAAC;gBAC1C,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,SAAS,EAAE;aACnD,CAAC,CAAC;QACP,CAAC;IACL,CAAC;CACK,CAAC,CAAC"}
+{"version":3,"file":"get_actor_run.js","sourceRoot":"","sources":["../../../src/tools/openai/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,iBAAiB,GAAc,MAAM,CAAC,MAAM,CAAC;IACtD,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"}