@apify/actors-mcp-server 0.10.5-beta.6 → 0.10.5-beta.8

package/dist/tools/apps/call_actor_widget.js

@@ -7,8 +7,9 @@ import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
 import { compileSchema } from '../../utils/ajv.js';
 import { buildMCPResponse } from '../../utils/mcp.js';
 import { extractActorId } from '../../utils/tools.js';
-import { buildCallActorErrorResponse, buildStartAsyncResponse, callActorPreExecute, resolveAndValidateActor, } from '../core/call_actor_common.js';
-import { callActorOutputSchema } from '../structured_output_schemas.js';
+import { buildStartRunResponse } from '../core/actor_run_response.js';
+import { buildCallActorErrorResponse, callActorPreExecute, callOptionsSchema, resolveAndValidateActor, } from '../core/call_actor_common.js';
+import { getActorRunOutputSchema } from '../structured_output_schemas.js';
 /**
  * Widget-only input: `actor` + `input` + optional `callOptions`.
  *
@@ -24,44 +25,8 @@ const callActorWidgetArgsSchema = z.object({
         .describe('The name of the Actor to call. Format: "username/name" (e.g., "apify/rag-web-browser").'),
     input: z.object({}).passthrough()
         .describe('The input JSON to pass to the Actor. Required.'),
-    callOptions: z.object({
-        memory: z.number()
-            .min(128, 'Memory must be at least 128 MB')
-            .max(32768, 'Memory cannot exceed 32 GB (32768 MB)')
-            .optional()
-            .describe(dedent `
-                Memory per run in MB. Power of 2 from 128 to 32768.
-                Apify also caps total memory across all your concurrent runs (account plan limit); if a run is rejected because that quota would be exceeded, retry with a smaller value.
-            `),
-        timeout: z.number()
-            .min(0, 'Timeout must be 0 or greater')
-            .optional()
-            .describe(dedent `
-                Maximum runtime for the Actor in seconds. After this time elapses, the Actor will be automatically terminated.
-                Use 0 for infinite timeout (no time limit). Minimum: 0 seconds (infinite).
-            `),
-        build: z.string()
-            .optional()
-            .describe('Tag or number of the Actor build to run (e.g., "latest", "beta", "1.2.345"). If omitted, the Actor\'s default build is used.'),
-        maxItems: z.number()
-            .int()
-            .positive()
-            .optional()
-            .describe(dedent `
-                Pay-per-result Actors ONLY — has no effect on any other pricing model (pay-per-event, pay-per-usage, rental, free).
-                Caps the number of dataset items billed for this run; does NOT limit how many items the Actor produces.
-                Most Actors also expose their own input field (e.g. "maxResults", "maxPages", "maxItems") to bound how much work they do — prefer those when limiting actual output, since this option only caps billing.
-            `),
-        maxTotalChargeUsd: z.number()
-            .positive()
-            .optional()
-            .describe(dedent `
-                Pay-per-event Actors ONLY — has no effect on any other pricing model (pay-per-result, pay-per-usage, rental, free).
-                Caps the total USD billed for this run; does NOT limit how much work the Actor does.
-                Most Actors also expose their own input field to bound work — prefer those when limiting actual output, since this option only caps billing.
-            `),
-    }).optional()
-        .describe('Optional call options for the Actor run configuration.'),
+    callOptions: callOptionsSchema.optional()
+        .describe('Optional run config: memory (MB), timeout (s), build, maxItems (pay-per-result cap), maxTotalChargeUsd (pay-per-event cap).'),
 }).strict();
 const CALL_ACTOR_WIDGET_DESCRIPTION = dedent `
     Render an interactive UI element (widget) that displays live Actor run progress for the user.
@@ -88,14 +53,11 @@ export const appsCallActorWidget = Object.freeze({
     name: HelperTools.ACTOR_CALL_WIDGET,
     description: CALL_ACTOR_WIDGET_DESCRIPTION,
     inputSchema: z.toJSONSchema(callActorWidgetArgsSchema),
-    outputSchema: callActorOutputSchema,
+    outputSchema: getActorRunOutputSchema,
     // Allow arbitrary keys inside `input` (dynamic Actor input) while keeping the outer shape strict.
     ajvValidate: compileSchema(z.toJSONSchema(callActorWidgetArgsSchema)),
     paymentRequired: true,
-    // Tool-level widget meta; only registered in apps mode so stripWidgetMeta is a no-op here.
-    _meta: {
-        ...(_a = getWidgetConfig(WIDGET_URIS.ACTOR_RUN)) === null || _a === void 0 ? void 0 : _a.meta,
-    },
+    _meta: (_a = getWidgetConfig(WIDGET_URIS.ACTOR_RUN)) === null || _a === void 0 ? void 0 : _a.meta,
     annotations: {
         title: 'Call Actor (widget)',
         readOnlyHint: false,
@@ -136,12 +98,7 @@ export const appsCallActorWidget = Object.freeze({
             const actorClient = apifyClient.actor(baseActorName);
             const actorRun = await actorClient.start(input, callOptions);
             log.debug('Started Actor run (widget)', { actorName: baseActorName, runId: actorRun.id, mcpSessionId: toolArgs.mcpSessionId });
-            const response = buildStartAsyncResponse({
-                actorName: baseActorName,
-                actorRun,
-                input,
-                widget: true,
-            });
+            const response = buildStartRunResponse({ actorName: baseActorName, actorRun, widget: true });
             return {
                 ...response,
                 toolTelemetry: { actorId: resolvedActorId },
@@ -152,7 +109,6 @@ export const appsCallActorWidget = Object.freeze({
                 actorName: baseActorName,
                 error,
                 actorId: resolvedActorId,
-                isAsync: true,
                 mcpSessionId: toolArgs.mcpSessionId,
                 actorGetDetailsTool: HelperTools.ACTOR_GET_DETAILS,
             });

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run_widget.d.ts","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAiCnF,eAAO,MAAM,qBAAqB,EAAE,SAuCzB,CAAC"}
+{"version":3,"file":"get_actor_run_widget.d.ts","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAkCnF,eAAO,MAAM,qBAAqB,EAAE,SAyCzB,CAAC"}

package/dist/tools/apps/get_actor_run_widget.js

@@ -5,12 +5,13 @@ import { HelperTools } from '../../const.js';
 import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
 import { compileSchema } from '../../utils/ajv.js';
 import { logHttpError } from '../../utils/logging.js';
-import { buildGetActorRunError, buildGetActorRunSuccessResponse, fetchActorRunData, } from '../core/get_actor_run_common.js';
+import { fetchActorRunData } from '../core/actor_run_response.js';
+import { buildGetActorRunError, buildGetActorRunSuccessResponse, } from '../core/get_actor_run_common.js';
 import { getActorRunOutputSchema } from '../structured_output_schemas.js';
 /**
- * Widget-only input: `runId` only. In the normal tool path, AJV validation
- * runs first and strips unknown keys at the boundary; `.strict()` mainly
- * protects any bypass paths by rejecting stray keys before use here.
+ * Widget input is `runId` only. The tool always returns immediately so the widget can render
+ * without delay; live status updates are driven by the widget UI itself, which polls
+ * `get-actor-run` with `waitSecs: 0`. Strict so stray keys are rejected on bypass paths.
  */
 const getActorRunWidgetArgsSchema = z.object({
     runId: z.string()
@@ -18,15 +19,16 @@ const getActorRunWidgetArgsSchema = z.object({
         .describe('The ID of the Actor run.'),
 }).strict();
 const GET_ACTOR_RUN_WIDGET_DESCRIPTION = dedent `
-    Render an interactive UI element (widget) showing live progress and status of an Actor run.
+    Render an interactive UI element (widget) that displays live progress and status of an Actor run.
+
+    The tool returns immediately after rendering the widget — it never blocks waiting for the run.
+    The widget itself polls run status and updates in place until the run reaches a terminal state.
 
     Use this tool ONLY when the user explicitly wants to see run progress visually
     (e.g., "show progress for run y2h7sK3Wc", "display the status of that run").
 
     For silent data lookups (run status, dataset IDs, stats, resource IDs), use
     ${HelperTools.ACTOR_RUNS_GET} instead — it returns the same data without rendering a widget.
-
-    Input: the run ID only.
 `;
 export const getActorRunWidgetTool = Object.freeze({
     type: 'internal',
@@ -52,12 +54,16 @@ export const getActorRunWidgetTool = Object.freeze({
         try {
             const fetchResult = await fetchActorRunData({
                 runId: parsed.runId,
+                waitSecs: 0,
                 client,
                 mcpSessionId,
             });
-            if ('error' in fetchResult) {
+            // Widget always passes waitSecs=0 with no abort signal, so 'aborted' is unreachable
+            // here — the discriminator just keeps the type-checker happy.
+            if ('aborted' in fetchResult)
+                return {};
+            if ('error' in fetchResult)
                 return fetchResult.error;
-            }
             return buildGetActorRunSuccessResponse({ ...fetchResult.result, widget: true });
         }
         catch (error) {

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

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run_widget.js","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.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;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACH,qBAAqB,EACrB,+BAA+B,EAC/B,iBAAiB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0BAA0B,CAAC;CAC5C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,gCAAgC,GAAG,MAAM,CAAA;;;;;;;MAOzC,WAAW,CAAC,cAAc;;;CAG/B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,qBAAqB;IACvC,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAoB;IAC3E,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IACvE,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE;QACH,GAAG,MAAA,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,0CAAE,IAAI;KAClD;IACD,WAAW,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,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,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEvD,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,kCAAkC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACjF,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACK,CAAC,CAAC"}
+{"version":3,"file":"get_actor_run_widget.js","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.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;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACH,qBAAqB,EACrB,+BAA+B,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0BAA0B,CAAC;CAC5C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,gCAAgC,GAAG,MAAM,CAAA;;;;;;;;;;MAUzC,WAAW,CAAC,cAAc;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,qBAAqB;IACvC,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAoB;IAC3E,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IACvE,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE;QACH,GAAG,MAAA,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,0CAAE,IAAI;KAClD;IACD,WAAW,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,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,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEvD,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;gBACxC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,CAAC;gBACX,MAAM;gBACN,YAAY;aACf,CAAC,CAAC;YAEH,oFAAoF;YACpF,8DAA8D;YAC9D,IAAI,SAAS,IAAI,WAAW;gBAAE,OAAO,EAAE,CAAC;YACxC,IAAI,OAAO,IAAI,WAAW;gBAAE,OAAO,WAAW,CAAC,KAAK,CAAC;YAErD,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,kCAAkC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACjF,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/categories.d.ts

@@ -12,6 +12,12 @@
  * - A plain ToolEntry — mode-independent, always included
  * - A mode map (e.g. { default: ToolEntry, apps: ToolEntry }) — resolver picks entry[mode]
  * - A partial mode map (e.g. { apps: ToolEntry }) — included only for listed modes
+ *
+ * Apps vs default mode invariant:
+ * Only `*-widget` tools differ between modes — they live in `tools/apps/` and render an
+ * interactive UI element. All non-widget tools (`call-actor`, `get-actor-run`, direct actor
+ * tools, `search-actors`, `fetch-actor-details`) share a single implementation across modes.
+ * Do NOT add per-mode runtime variants for non-widget tools.
  */
 import { HelperTools } from '../const.js';
 import type { ToolEntry } from '../types.js';

package/dist/tools/categories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyCzC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAiCoB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAkC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAwBnF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAA+B,GAAG,eAAe,CAIvF;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAG3E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAKlE,CAAC"}
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyCzC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAiCoB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAkC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAwBnF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAA+B,GAAG,eAAe,CAIvF;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAG3E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAKlE,CAAC"}

package/dist/tools/categories.js

@@ -12,6 +12,12 @@
  * - A plain ToolEntry — mode-independent, always included
  * - A mode map (e.g. { default: ToolEntry, apps: ToolEntry }) — resolver picks entry[mode]
  * - A partial mode map (e.g. { apps: ToolEntry }) — included only for listed modes
+ *
+ * Apps vs default mode invariant:
+ * Only `*-widget` tools differ between modes — they live in `tools/apps/` and render an
+ * interactive UI element. All non-widget tools (`call-actor`, `get-actor-run`, direct actor
+ * tools, `search-actors`, `fetch-actor-details`) share a single implementation across modes.
+ * Do NOT add per-mode runtime variants for non-widget tools.
  */
 import { HelperTools } from '../const.js';
 import { ServerMode } from '../types.js';
@@ -58,7 +64,7 @@ export const toolCategories = {
     actors: [
         defaultSearchActors,
         defaultFetchActorDetails,
-        // call-actor is different for default and apps mode (sync vs async call)
+        // call-actor is identical between modes; apps mode appends a widget addendum to the description.
         { default: defaultCallActor, apps: appsCallActor },
     ],
     docs: [

package/dist/tools/categories.js.map

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

package/dist/tools/core/actor_run_response.d.ts

@@ -0,0 +1,127 @@
+import type { ActorRun } from 'apify-client';
+import type { ApifyClient } from '../../apify_client.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
+import { type ProgressTracker } from '../../utils/progress.js';
+/** nextStep text for widget-rendered responses: suppresses LLM polling. */
+export declare const WIDGET_NO_POLL_NEXT_STEP = "Widget is rendering live progress. Do NOT poll \u2014 the widget self-updates until completion.";
+/** Maximum value for `waitSecs`. Stays under the 60s tool-call ceiling several MCP clients impose. */
+export declare const WAIT_SECS_MAX = 45;
+/** Default seconds to wait for completion on `call-actor` and direct actor tools. `get-actor-run` also defaults to 30. */
+export declare const CALL_ACTOR_WAIT_SECS_DEFAULT = 30;
+export type RunDataset = {
+    id: string;
+    name?: string;
+    title?: string;
+    itemCount?: number;
+    cleanItemCount?: number;
+    fields?: string[];
+    /**
+     * JSON Schema fragment for each dataset row. Populated only by direct actor tools (where
+     * the target Actor is known at tools/list time, so historical row shape can be looked up
+     * via `actorStore`). Absent for `call-actor` / `get-actor-run` (dynamic target).
+     */
+    itemsSchema?: {
+        type: 'object';
+        properties: Record<string, unknown>;
+    };
+};
+export type RunKeyValueStore = {
+    id: string;
+    name?: string;
+    title?: string;
+    keyCount?: number;
+    keys?: string[];
+};
+/**
+ * Storage shape mirrors `ActorRunStorageIds` from the Apify client — a map of alias → storage
+ * object where `default` is always the primary entry. Using the same plural alias-map structure
+ * means named Actor storages (e.g. `storages.datasets.results`) can be added without introducing
+ * new field names. Each value extends the bare Apify ID string with fetched metadata.
+ */
+export type RunStorages = {
+    datasets?: {
+        default: RunDataset;
+        [alias: string]: RunDataset;
+    };
+    keyValueStores?: {
+        default: RunKeyValueStore;
+        [alias: string]: RunKeyValueStore;
+    };
+};
+/**
+ * Canonical run response shape returned by `call-actor` and `get-actor-run`.
+ * content[0] mirrors structuredContent as JSON (spec compat); content[1] is the
+ * LLM-readable summary + nextStep narrative.
+ */
+export type RunResponse = {
+    runId: string;
+    actorId: string;
+    actorName?: string;
+    status: string;
+    statusMessage?: string;
+    exitCode?: number;
+    startedAt?: string;
+    finishedAt?: string;
+    stats?: {
+        runTimeSecs?: number;
+        computeUnits?: number;
+        memMaxBytes?: number;
+    };
+    storages: RunStorages;
+    summary: string;
+    nextStep: string;
+};
+export type FetchActorRunResult = {
+    run: ActorRun;
+    structuredContent: RunResponse;
+};
+/**
+ * Build {summary, nextStep} per status. Returns one primary action — never two.
+ */
+export declare function buildStatusSummaryNextStep(params: {
+    run: ActorRun;
+    dataset?: RunDataset;
+    keyValueStore?: RunKeyValueStore;
+}): {
+    summary: string;
+    nextStep: string;
+};
+/**
+ * Build a RunResponse from an already-started ActorRun without waiting.
+ * Used when waitSecs=0 (default and apps modes) and by widget variants that return immediately.
+ * Storage metadata contains IDs only; pollers/widgets fetch updates via get-actor-run.
+ *
+ * Pass `widget: true` for widget-rendered responses: nextStep is replaced with a no-poll
+ * message and widget _meta is included so the UI renders automatically.
+ *
+ * Invariant: `widget: true` is only valid from `*-widget` tools. Non-widget tools (call-actor,
+ * direct actor tools) must omit it or pass `false`.
+ */
+export declare function buildStartRunResponse(params: {
+    actorName: string;
+    actorRun: ActorRun;
+    widget?: boolean;
+}): ReturnType<typeof buildMCPResponse>;
+/**
+ * Default `onAbort` for callers that want the run cancelled when the MCP request is cancelled.
+ * Logs and swallows abort failures so a transient API error doesn't override the original
+ * cancellation result.
+ */
+export declare const abortRunOnSignal: (runId: string, client: ApifyClient) => Promise<void>;
+export declare function fetchActorRunData(params: {
+    runId: string;
+    waitSecs?: number;
+    actorName?: string;
+    client: ApifyClient;
+    progressTracker?: ProgressTracker | null;
+    abortSignal?: AbortSignal;
+    mcpSessionId?: string;
+    onAbort?: (runId: string, client: ApifyClient) => Promise<void>;
+}): Promise<{
+    error: object;
+} | {
+    aborted: true;
+} | {
+    result: FetchActorRunResult;
+}>;
+//# sourceMappingURL=actor_run_response.d.ts.map

package/dist/tools/core/actor_run_response.d.ts.map

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