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

package/dist/tools/core/actor_run_response.js

@@ -0,0 +1,551 @@
+import log from '@apify/log';
+import { FAILURE_CATEGORY, HelperTools, TOOL_STATUS } from '../../const.js';
+import { getWidgetConfig, WIDGET_URIS } from '../../resources/widgets.js';
+import { logHttpError } from '../../utils/logging.js';
+import { buildMCPResponse } from '../../utils/mcp.js';
+import { formatRunStatusMessage, TERMINAL_RUN_STATUSES } from '../../utils/progress.js';
+/** Cap on `storages.keyValueStores.default.keys` array length. */
+const KV_KEYS_LIMIT = 50;
+/** nextStep text for widget-rendered responses: suppresses LLM polling. */
+export const WIDGET_NO_POLL_NEXT_STEP = 'Widget is rendering live progress. Do NOT poll — the widget self-updates until completion.';
+/** Maximum value for `waitSecs`. Stays under the 60s tool-call ceiling several MCP clients impose. */
+export 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 const CALL_ACTOR_WAIT_SECS_DEFAULT = 30;
+const POLL_HINT_WAIT_SECS = 30;
+/** Limit for the dataset metadata `itemCount=0` lag-fallback probe. */
+const ITEM_COUNT_PROBE_LIMIT = 1;
+/**
+ * Delays before each `itemCount=0` lag-fallback probe. Apify docs state `itemCount` / `cleanItemCount`
+ * can lag up to ~5s after `pushItem`. We probe immediately, then again at +1s/+3s/+5s so a
+ * SUCCEEDED-but-empty dataset has the full propagation window to surface real items.
+ */
+const ITEM_COUNT_PROBE_DELAYS_MS = [0, 1000, 2000, 2000];
+async function sleep(ms) {
+    await new Promise((resolve) => { setTimeout(resolve, ms); });
+}
+/** Sentinel used by `raceAbort` to signal that the abort signal won the race. */
+const ABORT = Symbol('ABORT');
+/**
+ * Race a promise against an abort signal. Returns the resolved value, or {@link ABORT} if the
+ * signal fires first. Cleans up its abort listener on either branch so callers never leak.
+ */
+async function raceAbort(promise, abortSignal) {
+    if (!abortSignal)
+        return promise;
+    // Already aborted: `addEventListener('abort', ...)` won't fire (the event has passed), so the
+    // listener would never resolve and the race would block on `promise`.
+    if (abortSignal.aborted)
+        return ABORT;
+    let listener;
+    const abortPromise = new Promise((resolve) => {
+        listener = () => resolve(ABORT);
+        abortSignal.addEventListener('abort', listener, { once: true });
+    });
+    try {
+        return await Promise.race([promise, abortPromise]);
+    }
+    finally {
+        if (listener)
+            abortSignal.removeEventListener('abort', listener);
+    }
+}
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+/** Translate Apify slash-notation field paths to dot-notation. */
+function slashToDot(field) {
+    return field.replace(/\//g, '.');
+}
+/**
+ * Drop undefined and null keys. Apify's SDK returns null for fields it doesn't have (e.g.
+ * an unnamed default dataset's `name`), and the response shape declares no nullable fields, so we
+ * filter both to keep the response clean and pass `getActorRunOutputSchema` validation.
+ */
+function omitNullish(obj) {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined && v !== null)
+            out[k] = v;
+    }
+    return out;
+}
+function toIsoString(value) {
+    if (!value)
+        return undefined;
+    return value instanceof Date ? value.toISOString() : value;
+}
+function buildStats(run) {
+    const stats = run.stats;
+    if (!stats)
+        return undefined;
+    const out = omitNullish({
+        runTimeSecs: stats.runTimeSecs,
+        computeUnits: stats.computeUnits,
+        memMaxBytes: stats.memMaxBytes,
+    });
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function buildRunDataset(run, datasetMeta, resolvedItemCount) {
+    var _a;
+    if (!run.defaultDatasetId)
+        return undefined;
+    if (!datasetMeta) {
+        return { id: run.defaultDatasetId };
+    }
+    return omitNullish({
+        id: datasetMeta.id,
+        name: datasetMeta.name,
+        title: datasetMeta.title,
+        itemCount: resolvedItemCount !== null && resolvedItemCount !== void 0 ? resolvedItemCount : datasetMeta.itemCount,
+        cleanItemCount: datasetMeta.cleanItemCount,
+        fields: (_a = datasetMeta.fields) === null || _a === void 0 ? void 0 : _a.map(slashToDot),
+    });
+}
+function buildRunKeyValueStore(run, listKeysResult) {
+    if (!run.defaultKeyValueStoreId)
+        return undefined;
+    if (!listKeysResult) {
+        return { id: run.defaultKeyValueStoreId };
+    }
+    const keys = listKeysResult.items.map((k) => k.key);
+    // Empty KV: surface only the id (matches non-terminal shape) instead of `keys: [], keyCount: 0`.
+    if (keys.length === 0 && !listKeysResult.isTruncated) {
+        return { id: run.defaultKeyValueStoreId };
+    }
+    // The Apify listKeys endpoint does not report a true total. When the page is not truncated,
+    // we know the page count equals the total; when truncated, omit keyCount and let the agent
+    // detect "more keys exist" from `keys.length === KV_KEYS_LIMIT`.
+    const keyCount = listKeysResult.isTruncated ? undefined : keys.length;
+    return omitNullish({ id: run.defaultKeyValueStoreId, keys, keyCount });
+}
+function errMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Apify's pagination counter is eventually consistent (~5s post-terminal). Probe with `listItems({ limit: 1 })`
+ * when `itemCount === 0` on a SUCCEEDED run — if the probe returns items, surface the larger count.
+ * Returns the resolved item count, or `undefined` if the dataset id is unknown / we shouldn't override.
+ */
+async function resolveItemCountWithLagFallback(client, run, datasetMeta, waitSecs, mcpSessionId, abortSignal) {
+    var _a;
+    if (run.status !== 'SUCCEEDED' || !datasetMeta || !run.defaultDatasetId)
+        return datasetMeta === null || datasetMeta === void 0 ? void 0 : datasetMeta.itemCount;
+    if (datasetMeta.itemCount > 0)
+        return datasetMeta.itemCount;
+    try {
+        // `total` is the dataset's true count from the SDK; `items.length` is capped by `limit` and
+        // would undercount whenever lag has hidden more than `ITEM_COUNT_PROBE_LIMIT` items.
+        // When `waitSecs === 0` the caller asked for an immediate response (e.g. the widget's initial
+        // render), so we do a single immediate probe and skip the delayed retries — otherwise the
+        // ~5s lag-recovery schedule would block "immediate" callers for the full window.
+        const delays = waitSecs !== 0 ? ITEM_COUNT_PROBE_DELAYS_MS : [0];
+        let lastTotal = 0;
+        for (const delay of delays) {
+            if (delay > 0) {
+                const sleepResult = await raceAbort(sleep(delay), abortSignal);
+                if (sleepResult === ABORT)
+                    return lastTotal;
+            }
+            const result = await raceAbort(client.dataset(run.defaultDatasetId).listItems({ limit: ITEM_COUNT_PROBE_LIMIT }), abortSignal);
+            if (result === ABORT)
+                return lastTotal;
+            lastTotal = (_a = result.total) !== null && _a !== void 0 ? _a : 0;
+            if (lastTotal > 0)
+                return lastTotal;
+        }
+        return lastTotal;
+    }
+    catch (error) {
+        log.warning('itemCount lag-fallback probe failed', { datasetId: run.defaultDatasetId, mcpSessionId, errMessage: errMessage(error) });
+        return datasetMeta.itemCount;
+    }
+}
+async function actorNameForActorId(client, actorId, mcpSessionId) {
+    if (!actorId)
+        return undefined;
+    try {
+        const actor = await client.actor(actorId).get();
+        return actor ? `${actor.username}/${actor.name}` : undefined;
+    }
+    catch (error) {
+        log.warning('Failed to fetch actor name', { actId: actorId, mcpSessionId, errMessage: errMessage(error) });
+        return undefined;
+    }
+}
+// -----------------------------------------------------------------------------
+// Status templates — one summary + nextStep per Apify status
+// -----------------------------------------------------------------------------
+function elapsedSecs(run) {
+    if (!run.startedAt)
+        return 0;
+    const startedAtMs = run.startedAt instanceof Date ? run.startedAt.getTime() : new Date(run.startedAt).getTime();
+    return Math.max(0, Math.round((Date.now() - startedAtMs) / 1000));
+}
+function pollHint(runId) {
+    return `Use ${HelperTools.ACTOR_RUNS_GET} with runId=${runId} and waitSecs=${POLL_HINT_WAIT_SECS} to`;
+}
+/**
+ * Render an upstream `statusMessage` as a clearly-attributed suffix (` Actor status: "..."`).
+ * Attribution prevents readers from mistaking the upstream message (which can be stale relative
+ * to elapsed time) for our own narrative; the trailing period is stripped so the surrounding
+ * template's period doesn't produce `..`.
+ */
+function statusMessageLine(statusMessage) {
+    if (!statusMessage)
+        return '';
+    const trimmed = statusMessage.trim().replace(/\.+$/, '');
+    if (!trimmed)
+        return '';
+    return ` Actor status: "${trimmed}".`;
+}
+/**
+ * Suffix surfacing partial dataset progress on non-terminal runs (e.g. " 127 results so far.").
+ * Empty when the count is unknown or zero so callers don't see "0 results so far" on early polls.
+ * Worded generically — Actors aren't always scraping; "results" reads naturally for any output.
+ */
+function progressSuffix(dataset) {
+    const n = dataset === null || dataset === void 0 ? void 0 : dataset.itemCount;
+    if (n === undefined || n === 0)
+        return '';
+    return ` ${n} ${n === 1 ? 'result' : 'results'} so far.`;
+}
+/**
+ * `buildRunKeyValueStore` omits `keyCount` on truncation; surface that as "at least N keys"
+ * instead of silently substituting `keys.length`.
+ */
+function summarizeKv(keyValueStore) {
+    var _a;
+    const kvId = keyValueStore === null || keyValueStore === void 0 ? void 0 : keyValueStore.id;
+    const keys = (_a = keyValueStore === null || keyValueStore === void 0 ? void 0 : keyValueStore.keys) !== null && _a !== void 0 ? _a : [];
+    if (!kvId || keys.length === 0) {
+        return { hasKv: false, summarySuffix: '' };
+    }
+    const reportedKeyCount = keyValueStore.keyCount;
+    const kvTruncated = reportedKeyCount === undefined && keys.length === KV_KEYS_LIMIT;
+    const n = reportedKeyCount !== null && reportedKeyCount !== void 0 ? reportedKeyCount : keys.length;
+    const keyCountLabel = kvTruncated ? `at least ${KV_KEYS_LIMIT} keys` : `${n} ${n === 1 ? 'key' : 'keys'}`;
+    return { hasKv: true, kvId, keys, keyCountLabel, summarySuffix: ` Key-value store has ${keyCountLabel}.` };
+}
+// TODO: Apify's fields list expands array indices (e.g. `entities.hashtags.0.text`,
+// `entities.hashtags.1.text`, ... `entities.hashtags.14.text`), so deeply-nested or array-heavy
+// schemas balloon into hundreds of paths and bloat nextStep. Real example: a Twitter dataset
+// returned 174 expanded paths for ~30 unique schema fields. Two viable fixes — collapse `.N`
+// segments to the array root (`entities.hashtags`) and dedupe (all paths stay projection-valid,
+// schema detail lost inside arrays), or collapse `.N.` to `[]` (preserves shape but produces
+// paths that aren't directly valid for `fields="..."`). Deferred pending a real-world choice.
+function fieldsProjectionHint(fields) {
+    if (!fields || fields.length === 0)
+        return '';
+    return ` Available fields (dot notation): ${fields.join(', ')} — pass via fields="..." to project.`;
+}
+function buildSucceededSummaryNextStep(runTimeSecs, statusMessage, dataset, keyValueStore) {
+    var _a;
+    const itemCount = dataset === null || dataset === void 0 ? void 0 : dataset.itemCount;
+    const datasetId = dataset === null || dataset === void 0 ? void 0 : dataset.id;
+    const kv = summarizeKv(keyValueStore);
+    // Dataset is primary. nextStep stays dataset-only (one primary action) but the summary mentions
+    // KV when both exist so the caller can see the run also produced key-value records.
+    if (itemCount !== undefined && itemCount > 0 && datasetId) {
+        const fields = (_a = dataset === null || dataset === void 0 ? void 0 : dataset.fields) !== null && _a !== void 0 ? _a : [];
+        return {
+            summary: `SUCCEEDED in ${runTimeSecs}s. ${itemCount} ${itemCount === 1 ? 'item' : 'items'}; ${fields.length} fields available.${kv.summarySuffix}`,
+            nextStep: `Use ${HelperTools.DATASET_GET_ITEMS} with datasetId=${datasetId} and limit=20 to fetch items (${itemCount} total).${fieldsProjectionHint(fields)}`,
+        };
+    }
+    // datasetId known but metadata unavailable (transient fetch failure on a terminal run). Don't
+    // claim "no output found" — point the agent at dataset items so they can verify directly.
+    if (itemCount === undefined && datasetId) {
+        return {
+            summary: `SUCCEEDED in ${runTimeSecs}s. Dataset metadata unavailable.${statusMessageLine(statusMessage)}${kv.summarySuffix}`,
+            nextStep: `Use ${HelperTools.DATASET_GET_ITEMS} with datasetId=${datasetId} and limit=20 to inspect output.`,
+        };
+    }
+    // Metadata can report itemCount === 0 briefly after SUCCEEDED (eventual consistency). Surface the
+    // same fetch-first guidance as TIMED-OUT with an empty partial dataset — never imply "re-run only".
+    if (itemCount === 0 && datasetId) {
+        return {
+            summary: `SUCCEEDED in ${runTimeSecs}s. No dataset items found.${statusMessageLine(statusMessage)}${kv.summarySuffix}`,
+            nextStep: `Use ${HelperTools.DATASET_GET_ITEMS} with datasetId=${datasetId} and limit=20 to verify output (metadata reports 0 items).${fieldsProjectionHint(dataset === null || dataset === void 0 ? void 0 : dataset.fields)}`,
+        };
+    }
+    // KV store is rarely the primary output for Apify actors (mostly SDK state / intermediate data),
+    // so we don't recommend it as `nextStep` — but `kv.summarySuffix` keeps it visible in the summary
+    // when records exist, so callers can still discover them. Surface the upstream statusMessage so
+    // a text-only reader sees the actor's own diagnostic (often the only signal here).
+    return {
+        summary: `SUCCEEDED in ${runTimeSecs}s. No dataset items found.${statusMessageLine(statusMessage)}${kv.summarySuffix}`,
+        nextStep: `Inspect statusMessage and stats in this response; if the missing output was unexpected, re-run ${HelperTools.ACTOR_CALL} with adjusted input.`,
+    };
+}
+function buildTimedOutSummaryNextStep(runTimeSecs, dataset, keyValueStore) {
+    var _a, _b;
+    const datasetId = dataset === null || dataset === void 0 ? void 0 : dataset.id;
+    const kv = summarizeKv(keyValueStore);
+    // TIMED-OUT branches on `datasetId` (not `itemCount > 0`) so an empty partial dataset is still
+    // surfaced as the primary follow-up — partial output is the diagnostic signal here.
+    if (datasetId) {
+        const itemCount = (_a = dataset === null || dataset === void 0 ? void 0 : dataset.itemCount) !== null && _a !== void 0 ? _a : 0;
+        const fields = (_b = dataset === null || dataset === void 0 ? void 0 : dataset.fields) !== null && _b !== void 0 ? _b : [];
+        return {
+            summary: `TIMED-OUT after ${runTimeSecs}s.${kv.summarySuffix}`,
+            nextStep: `Use ${HelperTools.DATASET_GET_ITEMS} with datasetId=${datasetId} and limit=20 to fetch any partial output (${itemCount} ${itemCount === 1 ? 'item' : 'items'} written). Available fields: ${fields.length > 0 ? fields.join(', ') : 'none'}.`,
+        };
+    }
+    return {
+        summary: `TIMED-OUT after ${runTimeSecs}s.${kv.summarySuffix}`,
+        nextStep: `Inspect statusMessage and stats in this response; the run produced no dataset to fetch.`,
+    };
+}
+/**
+ * Build {summary, nextStep} per status. Returns one primary action — never two.
+ */
+export function buildStatusSummaryNextStep(params) {
+    var _a, _b;
+    const { run, dataset, keyValueStore } = params;
+    const { id: runId, status, statusMessage } = run;
+    // The platform usually populates stats.runTimeSecs on terminal runs, but not always (e.g.
+    // ABORTED before stats flushed). Fall back to `elapsedSecs(run)` so summaries don't render
+    // as literal "undefined".
+    const runTimeSecs = (_b = (_a = run.stats) === null || _a === void 0 ? void 0 : _a.runTimeSecs) !== null && _b !== void 0 ? _b : elapsedSecs(run);
+    switch (status) {
+        case 'READY':
+            return {
+                summary: `READY. Run ${runId} was created and is about to start.`,
+                nextStep: `${pollHint(runId)} wait for progress.`,
+            };
+        case 'RUNNING':
+            return {
+                summary: `RUNNING for ${elapsedSecs(run)}s.${statusMessageLine(statusMessage) || ' In progress.'}${progressSuffix(dataset)}`,
+                nextStep: `${pollHint(runId)} poll for completion.`,
+            };
+        case 'TIMING-OUT':
+            return {
+                summary: `TIMING-OUT after ${elapsedSecs(run)}s.${statusMessageLine(statusMessage) || ' Run-time limit reached; cleanup in progress.'}${progressSuffix(dataset)}`,
+                nextStep: `${pollHint(runId)} observe terminal state.`,
+            };
+        case 'ABORTING':
+            return {
+                summary: `ABORTING after ${elapsedSecs(run)}s.${statusMessageLine(statusMessage) || ' Cancellation in progress.'}${progressSuffix(dataset)}`,
+                nextStep: `${pollHint(runId)} observe terminal state.`,
+            };
+        case 'SUCCEEDED':
+            return buildSucceededSummaryNextStep(runTimeSecs, statusMessage, dataset, keyValueStore);
+        case 'FAILED':
+            return {
+                summary: `FAILED after ${runTimeSecs}s.${statusMessageLine(statusMessage)}`,
+                nextStep: `Diagnose using statusMessage and exitCode in this response; re-run ${HelperTools.ACTOR_CALL} with adjusted input if the cause is fixable.`,
+            };
+        case 'ABORTED':
+            return {
+                summary: `ABORTED after ${runTimeSecs}s.${statusMessageLine(statusMessage)}`,
+                nextStep: `Use ${HelperTools.ACTOR_CALL} again if you want to rerun the Actor.`,
+            };
+        case 'TIMED-OUT':
+            return buildTimedOutSummaryNextStep(runTimeSecs, dataset, keyValueStore);
+        default:
+            return {
+                summary: `${status}. Run ${runId}.`,
+                nextStep: `${pollHint(runId)} check current state.`,
+            };
+    }
+}
+/**
+ * Wait for an Actor run to reach a terminal state, racing against an optional client abort signal.
+ *
+ * `onAbort` is invoked when the client cancels the request mid-wait, before the function returns
+ * `{ kind: 'aborted' }`. Callers that need to cancel the underlying run on client abort pass it;
+ * read-only callers omit it.
+ */
+async function waitForRunWithProgress(opts) {
+    var _a, _b, _c;
+    const { client, runId, waitSecs, progressTracker, abortSignal, mcpSessionId, onAbort } = opts;
+    if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
+        await (onAbort === null || onAbort === void 0 ? void 0 : onAbort(runId, client));
+        return { kind: 'aborted' };
+    }
+    // Race the initial run.get() against the abort signal so a mid-call cancel returns promptly
+    // instead of blocking on the HTTP fetch (the SDK does not accept an AbortSignal directly).
+    const initial = await raceAbort(client.run(runId).get(), abortSignal);
+    if (initial === ABORT) {
+        await (onAbort === null || onAbort === void 0 ? void 0 : onAbort(runId, client));
+        return { kind: 'aborted' };
+    }
+    if (!initial)
+        return { kind: 'not-found' };
+    let run = initial;
+    // Callers that already know the actor name (e.g. `call-actor` just started the run) supply it to
+    // skip the lookup entirely. Otherwise kick off the fetch in parallel with the wait/progress branch
+    // below — it's only strictly needed for the progressTracker label and the response field.
+    const actorNamePromise = opts.actorName !== undefined
+        ? Promise.resolve(opts.actorName)
+        : actorNameForActorId(client, run.actId, mcpSessionId);
+    if ((waitSecs === undefined || waitSecs > 0) && !TERMINAL_RUN_STATUSES.has(run.status)) {
+        if (progressTracker) {
+            const trackerLabel = (_a = (await actorNamePromise)) !== null && _a !== void 0 ? _a : 'actor';
+            await progressTracker.updateProgress(formatRunStatusMessage(trackerLabel, run));
+            progressTracker.startActorRunUpdates(runId, client, trackerLabel, run);
+        }
+        // Race waitForFinish against the client's abort signal so a cancelled request returns
+        // promptly instead of blocking up to `waitSecs`. Behavior on abort is delegated to `onAbort`.
+        let raced;
+        try {
+            raced = await raceAbort(client.run(runId).waitForFinish({ waitSecs }), abortSignal);
+        }
+        finally {
+            progressTracker === null || progressTracker === void 0 ? void 0 : progressTracker.stop();
+        }
+        if (raced === ABORT) {
+            await (onAbort === null || onAbort === void 0 ? void 0 : onAbort(runId, client));
+            return { kind: 'aborted' };
+        }
+        run = raced;
+        // The platform may write the final statusMessage just after the status flips; re-fetch on
+        // terminal so the response (and any final progress emission) sees the freshest snapshot.
+        if (TERMINAL_RUN_STATUSES.has(run.status)) {
+            const finalRun = (_b = (await client.run(runId).get().catch(() => undefined))) !== null && _b !== void 0 ? _b : run;
+            if (progressTracker) {
+                await progressTracker.updateProgress(formatRunStatusMessage((_c = (await actorNamePromise)) !== null && _c !== void 0 ? _c : 'actor', finalRun));
+            }
+            run = finalRun;
+        }
+    }
+    return { kind: 'ok', run, actorName: await actorNamePromise };
+}
+// -----------------------------------------------------------------------------
+// Immediate start response — for callers that return without waiting
+// -----------------------------------------------------------------------------
+/**
+ * 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 function buildStartRunResponse(params) {
+    var _a, _b;
+    const { actorName, actorRun, widget } = params;
+    const dataset = actorRun.defaultDatasetId ? { id: actorRun.defaultDatasetId } : undefined;
+    const keyValueStore = actorRun.defaultKeyValueStoreId ? { id: actorRun.defaultKeyValueStoreId } : undefined;
+    const { summary, nextStep: computedNextStep } = buildStatusSummaryNextStep({
+        run: actorRun,
+        dataset,
+        keyValueStore,
+    });
+    const nextStep = widget ? WIDGET_NO_POLL_NEXT_STEP : computedNextStep;
+    const structuredContent = {
+        runId: actorRun.id,
+        actorId: actorRun.actId,
+        actorName,
+        status: actorRun.status,
+        startedAt: toIsoString(actorRun.startedAt),
+        storages: {
+            ...(dataset && { datasets: { default: dataset } }),
+            ...(keyValueStore && { keyValueStores: { default: keyValueStore } }),
+        },
+        summary,
+        nextStep,
+    };
+    const widgetMeta = widget
+        ? {
+            ...((_b = (_a = getWidgetConfig(WIDGET_URIS.ACTOR_RUN)) === null || _a === void 0 ? void 0 : _a.meta) !== null && _b !== void 0 ? _b : {}),
+            'openai/widgetDescription': `Actor run progress for ${actorName}`,
+        }
+        : undefined;
+    return buildMCPResponse({
+        texts: [JSON.stringify(structuredContent), `${summary}\n${nextStep}`],
+        structuredContent,
+        ...(widgetMeta && { _meta: widgetMeta }),
+    });
+}
+// -----------------------------------------------------------------------------
+// Main fetch — used by both default and widget variants
+// -----------------------------------------------------------------------------
+/**
+ * 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 const abortRunOnSignal = async (runId, client) => {
+    await client.run(runId).abort({ gracefully: false }).catch((error) => {
+        logHttpError(error, 'Error aborting Actor run', { runId });
+    });
+};
+export async function fetchActorRunData(params) {
+    var _a, _b;
+    const { runId, waitSecs, client, progressTracker, abortSignal, mcpSessionId, onAbort } = params;
+    const waitResult = await waitForRunWithProgress({
+        client, runId, waitSecs, actorName: params.actorName, progressTracker, abortSignal, mcpSessionId, onAbort,
+    });
+    if (waitResult.kind === 'aborted')
+        return { aborted: true };
+    if (waitResult.kind === 'not-found') {
+        return {
+            error: buildMCPResponse({
+                texts: [`Run with ID '${runId}' not found.`],
+                isError: true,
+                telemetry: { toolStatus: TOOL_STATUS.SOFT_FAIL, failureCategory: FAILURE_CATEGORY.INVALID_INPUT },
+            }),
+        };
+    }
+    const { run, actorName } = waitResult;
+    log.debug('Get Actor run', { runId, status: run.status, mcpSessionId, waitSecs });
+    let datasetInfo = null;
+    let kvListResult = null;
+    // Dataset metadata is fetched on every poll (not just terminal) so the summary can surface
+    // partial progress on long-running scrapes (e.g. "127 results so far"), giving polling agents
+    // real movement instead of the same "In progress." each cycle. The extra round-trip is the
+    // accepted UX tradeoff. KV listKeys stays terminal-only — non-terminal summaries don't
+    // reference KV records, so fetching them on every poll would be pure waste on the hot path.
+    // Per-promise catches: a single transient metadata fetch failure must not hard-fail the
+    // whole call. The response still carries the storage id, which is enough for the agent
+    // to fetch items / records directly.
+    const isTerminal = TERMINAL_RUN_STATUSES.has(run.status);
+    const [datasetFetched, kvFetched] = await Promise.all([
+        run.defaultDatasetId
+            ? client.dataset(run.defaultDatasetId).get().catch((error) => {
+                log.warning('Failed to fetch dataset metadata', { datasetId: run.defaultDatasetId, mcpSessionId, errMessage: errMessage(error) });
+                return null;
+            })
+            : Promise.resolve(null),
+        run.defaultKeyValueStoreId && isTerminal
+            ? client.keyValueStore(run.defaultKeyValueStoreId).listKeys({ limit: KV_KEYS_LIMIT }).catch((error) => {
+                log.warning('Failed to list KV store keys', {
+                    keyValueStoreId: run.defaultKeyValueStoreId,
+                    mcpSessionId,
+                    errMessage: errMessage(error),
+                });
+                return null;
+            })
+            : Promise.resolve(null),
+    ]);
+    datasetInfo = datasetFetched !== null && datasetFetched !== void 0 ? datasetFetched : null;
+    kvListResult = kvFetched !== null && kvFetched !== void 0 ? kvFetched : null;
+    const resolvedItemCount = await resolveItemCountWithLagFallback(client, run, datasetInfo, waitSecs, mcpSessionId, abortSignal);
+    const dataset = buildRunDataset(run, datasetInfo, resolvedItemCount);
+    const keyValueStore = buildRunKeyValueStore(run, kvListResult);
+    const { summary, nextStep } = buildStatusSummaryNextStep({ run, dataset, keyValueStore });
+    const structuredContent = {
+        runId: run.id,
+        actorId: run.actId,
+        actorName,
+        status: run.status,
+        statusMessage: (_a = run.statusMessage) !== null && _a !== void 0 ? _a : undefined,
+        exitCode: (_b = run.exitCode) !== null && _b !== void 0 ? _b : undefined,
+        startedAt: toIsoString(run.startedAt),
+        finishedAt: toIsoString(run.finishedAt),
+        stats: buildStats(run),
+        storages: {
+            ...(dataset && { datasets: { default: dataset } }),
+            ...(keyValueStore && { keyValueStores: { default: keyValueStore } }),
+        },
+        summary,
+        nextStep,
+    };
+    return { result: { run, structuredContent } };
+}
+//# sourceMappingURL=actor_run_response.js.map

package/dist/tools/core/actor_run_response.js.map

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

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

@@ -1,8 +1,13 @@
 import type { ApifyClient } from '../../apify_client.js';
 import type { ActorInfo, ActorStore, ApifyToken, ToolEntry } from '../../types.js';
 /**
- * Enriches actor tool output schemas with field-level detail from the ActorStore.
- * Uses Promise.allSettled to ensure individual failures don't block other tools.
+ * For each direct actor tool with a known historical item schema, replaces the generic
+ * `getActorRunOutputSchema` with a per-tool variant that declares
+ * `storages.datasets.default.itemsSchema` — letting an LLM plan field projection from
+ * `tools/list` alone, before any call.
+ *
+ * Uses `Promise.allSettled` so a single store failure doesn't block other tools. Individual
+ * misses (null / empty properties / thrown errors) leave the tool on the generic schema.
  */
 export declare function enrichActorToolOutputSchemas(tools: ToolEntry[], actorStore: ActorStore): Promise<void>;
 /**
@@ -23,7 +28,7 @@ export declare function enrichActorToolOutputSchemas(tools: ToolEntry[], actorSt
  * 5. Enums are added to descriptions with examples using addEnumsToDescriptionsWithExamples()
  *
  * @param {ActorInfo[]} actorsInfo - An array of ActorInfo objects with webServerMcpPath, definition, and Actor.
- * @param options - Optional settings: mcpSessionId for telemetry correlation, actorStore for caching.
+ * @param options - Optional settings: mcpSessionId for telemetry correlation, actorStore for per-Actor itemsSchema enrichment.
  * @returns {Promise<ToolEntry[]>} - A promise that resolves to an array of MCP tools.
  */
 export declare function getNormalActorsAsTools(actorsInfo: ActorInfo[], options?: {

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

@@ -1 +1 @@
-{"version":3,"file":"actor_tools_factory.d.ts","sourceRoot":"","sources":["../../../src/tools/core/actor_tools_factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWzD,OAAO,KAAK,EACR,SAAS,EACT,UAAU,EAEV,UAAU,EACV,SAAS,EAEZ,MAAM,gBAAgB,CAAC;AAOxB;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5G;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,sBAAsB,CACxC,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,SAAS,EAAE,CAAC,CAyEtB;AAED,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAuDtB;AAKD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAUlG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAY3D;AAED,wBAAsB,gBAAgB,CAClC,eAAe,EAAE,MAAM,EAAE,EACzB,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,SAAS,EAAE,CAAC,CAgEtB"}
+{"version":3,"file":"actor_tools_factory.d.ts","sourceRoot":"","sources":["../../../src/tools/core/actor_tools_factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWzD,OAAO,KAAK,EACR,SAAS,EACT,UAAU,EAEV,UAAU,EACV,SAAS,EAEZ,MAAM,gBAAgB,CAAC;AAuBxB;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB5G;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,sBAAsB,CACxC,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,SAAS,EAAE,CAAC,CA+EtB;AAED,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAuDtB;AAKD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAUlG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAY3D;AAED,wBAAsB,gBAAgB,CAClC,eAAe,EAAE,MAAM,EAAE,EACzB,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,SAAS,EAAE,CAAC,CAgEtB"}