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

package/dist/resources/api_resources.js

@@ -0,0 +1,255 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { isAxiosError } from 'axios';
+import { getApifyAPIBaseUrl } from '../apify_client.js';
+import { MAX_INLINE_BYTES } from '../const.js';
+import { parseBaseMimeType } from '../tools/storage/storage_helpers.js';
+import { getHttpStatusCode, logHttpError } from '../utils/logging.js';
+import { getHttpErrorHint } from '../utils/mcp.js';
+const TEXT_MIME_TYPE = 'text/plain';
+/** Textual base MIME types (returned as `text`); everything else becomes a base64 `blob`. */
+function isTextualMimeType(baseMimeType) {
+    if (!baseMimeType)
+        return false;
+    return (baseMimeType.startsWith('text/') ||
+        baseMimeType === 'application/json' ||
+        baseMimeType.endsWith('+json') ||
+        baseMimeType === 'application/xml' ||
+        baseMimeType.endsWith('+xml') ||
+        baseMimeType === 'application/javascript');
+}
+/**
+ * Maps a failed read's HTTP status to a JSON-RPC error code:
+ * - 3xx/4xx except 429 → `InvalidParams` (the request/resource is the problem — bad URI, missing/invalid
+ *   token, private resource, or a resource that does not exist; SEP-2164 remaps "nonexistent" here too).
+ * - 429, 5xx, or no status (network failure) → `InternalError` (transient or upstream).
+ */
+function getErrorCodeForStatus(status) {
+    if (status !== undefined && status < 500 && status !== 429)
+        return ErrorCode.InvalidParams;
+    return ErrorCode.InternalError;
+}
+/** Throw the standard resources/read failure McpError. Callers log the error first — the log source differs by site. */
+function throwReadFailure(uri, status, message) {
+    const hint = getHttpErrorHint(status);
+    throw new McpError(getErrorCodeForStatus(status), `Failed to read ${uri}: ${status ? `HTTP ${status}: ` : ''}${message}${hint ? `. ${hint}` : ''}`, { uri });
+}
+/**
+ * True when the URI is an Apify API URL (same origin as the configured API base).
+ *
+ * This is the security gate for the generic read proxy: the apify-client attaches the
+ * session token as an `Authorization` header to every outbound request, so we must only
+ * hand it Apify API URLs — never an arbitrary host. Userinfo-bearing URLs
+ * (`user@api.apify.com`) are rejected even when the host is genuinely ours: axios drops
+ * the default `Authorization` header for credentials-bearing URLs, so the read would
+ * silently run unauthenticated.
+ */
+export function isApifyApiUri(uri) {
+    try {
+        const url = new URL(uri);
+        if (url.username || url.password)
+            return false;
+        return url.origin === new URL(getApifyAPIBaseUrl()).origin;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Matches an Apify key-value-store record path, capturing the store id and the record key.
+ * Both groups exclude `/?#` so a trailing query or fragment can't leak into the captured key.
+ */
+const KV_RECORD_PATH_RE = /^\/v2\/key-value-stores\/([^/?#]+)\/records\/([^/?#]+)$/;
+/** `decodeURIComponent` that returns the input unchanged on malformed percent-encoding instead of throwing. */
+function safeDecodeURIComponent(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return segment;
+    }
+}
+/**
+ * Download URL for a body too large to inline. For a key-value-store record URI, returns the
+ * store's signed `recordPublicUrl` — fetchable without an API token when the client can read the
+ * store's URL signing key. Falls back to the original API URL for any other endpoint, or if minting
+ * the signed URL fails (fetching that link then needs a token).
+ */
+async function fetchRecordDownloadUrl(uri, apifyClient) {
+    let pathname;
+    try {
+        pathname = new URL(uri).pathname;
+    }
+    catch {
+        return uri;
+    }
+    const match = KV_RECORD_PATH_RE.exec(pathname);
+    if (!match)
+        return uri;
+    try {
+        const store = apifyClient.keyValueStore(safeDecodeURIComponent(match[1]));
+        return await store.getRecordPublicUrl(safeDecodeURIComponent(match[2]));
+    }
+    catch (err) {
+        logHttpError(err, `Failed to mint signed download URL for ${uri}; falling back to API URL`);
+        return uri;
+    }
+}
+/** Single text-contents result; pass `mimeType` to preserve a body's declared Content-Type. */
+function buildTextResult(uri, text, mimeType = TEXT_MIME_TYPE) {
+    return { contents: [{ uri, mimeType, text }] };
+}
+/** True when the URI is a key-value-store record path (a single record, not a pageable list). */
+function isKvRecordUri(uri) {
+    try {
+        return KV_RECORD_PATH_RE.test(new URL(uri).pathname);
+    }
+    catch {
+        return false;
+    }
+}
+/** Body too large to inline: a download-pointer text result. NOT a failure — the resource is readable, just not inline. */
+async function buildLinkOutResult(uri, apifyClient) {
+    const downloadUrl = await fetchRecordDownloadUrl(uri, apifyClient);
+    // A KVS record is a single object with no paging; only a dataset/list can shrink via limit/offset.
+    const pagingHint = isKvRecordUri(uri) ? '' : ' For a dataset/list, re-read with a smaller limit/offset range.';
+    return buildTextResult(uri, `Response body exceeds the ${MAX_INLINE_BYTES}-byte inline limit. Download it from ${downloadUrl} ` +
+        `(may require your Apify API token).${pagingHint}`);
+}
+/** The mid-consumption abort axios raises when a streamed body crosses `maxContentLength`. */
+function isMaxContentLengthAbort(err) {
+    return isAxiosError(err) && err.code === 'ERR_BAD_RESPONSE' && err.message.includes('maxContentLength');
+}
+/** `charset` parameter of a Content-Type header, lowercased; `undefined` when absent. */
+function parseCharset(contentType) {
+    const match = /;\s*charset\s*=\s*"?([^";]+)"?/i.exec(contentType !== null && contentType !== void 0 ? contentType : '');
+    return match === null || match === void 0 ? void 0 : match[1].trim().toLowerCase();
+}
+/** Drain a response stream into one Buffer. Chunks are Buffers (`objectMode: false`). */
+async function collectStream(data) {
+    const chunks = [];
+    for await (const chunk of data) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks);
+}
+/** `error.message` from an Apify API error body, or `undefined` when the body isn't that shape. */
+function parseApiErrorMessage(body) {
+    var _a;
+    if (!body || body.length === 0)
+        return undefined;
+    try {
+        const parsed = JSON.parse(body.toString('utf-8'));
+        return typeof ((_a = parsed === null || parsed === void 0 ? void 0 : parsed.error) === null || _a === void 0 ? void 0 : _a.message) === 'string' ? parsed.error.message : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Read any Apify API GET endpoint as an MCP resource.
+ *
+ * A thin streaming proxy: the apify-client injects the session token (and the MCP-origin header),
+ * the body streams in verbatim and is returned by its declared Content-Type — textual types
+ * (text/*, JSON, XML) as `text`, anything else as a base64 `blob`. The body is never parsed, so
+ * JSON primitives, formatting, and bytes round-trip exactly.
+ *
+ * Genuine failures (no token, bad origin, a missing resource, a bad token, a 5xx, a network error)
+ * throw an `McpError` so the SDK returns a JSON-RPC error rather than success-shaped content for an
+ * unreadable resource (see SEP-2164). A body over `MAX_INLINE_BYTES` is NOT a failure — it is a
+ * successful read returning a download pointer.
+ *
+ * The request goes straight through `apifyClient.httpClient.axios` (the same axios instance
+ * apify-client builds internally, so token/origin headers still apply) instead of
+ * `httpClient.call()`: with `responseType: 'stream'`, a non-2xx reaches `call()` as an unconsumed
+ * stream — its `ApifyApiError` message degrades to junk and each retry attempt strands an unread
+ * socket. One attempt, no retries. `maxContentLength` is enforced by axios itself mid-consumption
+ * (verified in axios@1.16.1: the adapter wraps streamed responses in a byte-counting generator
+ * that throws `ERR_BAD_RESPONSE` when the decoded size crosses the limit), so an oversized body
+ * is aborted at ~`MAX_INLINE_BYTES`, never buffered whole.
+ */
+export async function readApiResource(uri, apifyClient) {
+    var _a, _b;
+    if (!isApifyApiUri(uri)) {
+        throw new McpError(ErrorCode.InvalidParams, `Failed to read ${uri}: only Apify API URLs (${getApifyAPIBaseUrl()}) are readable as resources.`, { uri });
+    }
+    if (!apifyClient) {
+        throw new McpError(ErrorCode.InvalidParams, `Failed to read ${uri}: no Apify token in this session.`, {
+            uri,
+        });
+    }
+    let response;
+    try {
+        // The raw axios instance skips `httpClient.call()` → `ensureNodeInit()`, so reads do NOT honor
+        // `HTTPS_PROXY` (auth + MCP-origin headers are instance defaults and still apply — not a leak).
+        // Fine for direct egress; a proxy-mandatory deployment needs an apify-client init hook.
+        response = await apifyClient.httpClient.axios.request({
+            url: uri,
+            method: 'GET',
+            responseType: 'stream',
+            maxContentLength: MAX_INLINE_BYTES,
+        });
+    }
+    catch (err) {
+        logHttpError(err, `resources/read request failed`, { uri });
+        throwReadFailure(uri, getHttpStatusCode(err), err instanceof Error ? err.message : String(err));
+    }
+    let body;
+    let overLimit = false;
+    try {
+        body = await collectStream(response.data);
+    }
+    catch (err) {
+        if (isMaxContentLengthAbort(err)) {
+            overLimit = true;
+        }
+        else {
+            // A drop mid-body (reset, truncation, bad gzip). Never return partial content.
+            logHttpError(err, `resources/read response interrupted`, { uri });
+            const message = err instanceof Error ? err.message : String(err);
+            throw new McpError(ErrorCode.InternalError, `Failed to read ${uri}: response interrupted: ${message}`, {
+                uri,
+            });
+        }
+    }
+    // `validateStatus: null` on this axios instance resolves non-2xx responses instead of throwing,
+    // so a failed request is checked here. The error body was just collected above (Apify API error
+    // bodies are small JSON; if one somehow crossed the limit, fall back to the status text).
+    if (response.status >= 300) {
+        const message = (_a = parseApiErrorMessage(body)) !== null && _a !== void 0 ? _a : response.statusText;
+        logHttpError(Object.assign(new Error(message), { statusCode: response.status }), `resources/read failed`, {
+            uri,
+        });
+        throwReadFailure(uri, response.status, message);
+    }
+    // Second clause is runtime-redundant (undefined ⟺ overLimit) but narrows `body` to Buffer below.
+    if (overLimit || body === undefined) {
+        return buildLinkOutResult(uri, apifyClient);
+    }
+    const contentTypeHeader = response.headers['content-type'];
+    const contentType = typeof contentTypeHeader === 'string' ? contentTypeHeader : undefined;
+    // Empty body → empty text preserving the declared Content-Type, matching get-key-value-store-record
+    // (even for a binary type: an empty blob carries no bytes).
+    if (body.length === 0) {
+        return buildTextResult(uri, '', contentType);
+    }
+    const baseMimeType = parseBaseMimeType(contentType);
+    const charset = (_b = parseCharset(contentType)) !== null && _b !== void 0 ? _b : 'utf-8';
+    // Decode with the DECLARED charset, not hardcoded UTF-8 — latin1 bytes decoded as UTF-8 mangle
+    // irreversibly to U+FFFD. A charset Node cannot decode falls through to the blob branch (lossless
+    // base64 beats text in a wrong encoding), the same rule as apify-client's body_parser. The full
+    // Content-Type — charset included — rides along on the text result.
+    if (isTextualMimeType(baseMimeType) && Buffer.isEncoding(charset)) {
+        return buildTextResult(uri, body.toString(charset), contentType);
+    }
+    // Binary or undecodable text: base MIME type only (parameters are meaningless for a blob).
+    return {
+        contents: [
+            {
+                uri,
+                ...(baseMimeType && { mimeType: baseMimeType }),
+                blob: body.toString('base64'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=api_resources.js.map

package/dist/resources/api_resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_resources.js","sourceRoot":"","sources":["../../src/resources/api_resources.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,cAAc,GAAG,YAAY,CAAC;AAEpC,6FAA6F;AAC7F,SAAS,iBAAiB,CAAC,YAAgC;IACvD,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,CACH,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;QAChC,YAAY,KAAK,kBAAkB;QACnC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC9B,YAAY,KAAK,iBAAiB;QAClC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC7B,YAAY,KAAK,wBAAwB,CAC5C,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,MAA0B;IACrD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC,aAAa,CAAC;IAC3F,OAAO,SAAS,CAAC,aAAa,CAAC;AACnC,CAAC;AAED,wHAAwH;AACxH,SAAS,gBAAgB,CAAC,GAAW,EAAE,MAA0B,EAAE,OAAe;IAC9E,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,IAAI,QAAQ,CACd,qBAAqB,CAAC,MAAM,CAAC,EAC7B,kBAAkB,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAChG,EAAE,GAAG,EAAE,CACV,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACrC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC/C,OAAO,GAAG,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,iBAAiB,GAAG,yDAAyD,CAAC;AAEpF,+GAA+G;AAC/G,SAAS,sBAAsB,CAAC,OAAe;IAC3C,IAAI,CAAC;QACD,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,sBAAsB,CAAC,GAAW,EAAE,WAAwB;IACvE,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACD,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,GAAG,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,MAAM,KAAK,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,YAAY,CAAC,GAAG,EAAE,0CAA0C,GAAG,2BAA2B,CAAC,CAAC;QAC5F,OAAO,GAAG,CAAC;IACf,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,SAAS,eAAe,CAAC,GAAW,EAAE,IAAY,EAAE,WAAmB,cAAc;IACjF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAiC,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,iGAAiG;AACjG,SAAS,aAAa,CAAC,GAAW;IAC9B,IAAI,CAAC;QACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,2HAA2H;AAC3H,KAAK,UAAU,kBAAkB,CAAC,GAAW,EAAE,WAAwB;IACnE,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACnE,mGAAmG;IACnG,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iEAAiE,CAAC;IAC/G,OAAO,eAAe,CAClB,GAAG,EACH,6BAA6B,gBAAgB,wCAAwC,WAAW,GAAG;QAC/F,sCAAsC,UAAU,EAAE,CACzD,CAAC;AACN,CAAC;AAED,8FAA8F;AAC9F,SAAS,uBAAuB,CAAC,GAAY;IACzC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAC5G,CAAC;AAED,yFAAyF;AACzF,SAAS,YAAY,CAAC,WAA+B;IACjD,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,CAAC,CAAC;IACxE,OAAO,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAG,CAAC,EAAE,IAAI,GAAG,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,yFAAyF;AACzF,KAAK,UAAU,aAAa,CAAC,IAAa;IACtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAsC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,mGAAmG;AACnG,SAAS,oBAAoB,CAAC,IAAwB;;IAClD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAsC,CAAC;QACvF,OAAO,OAAO,CAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,0CAAE,OAAO,CAAA,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,WAAyB;;IACxE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CACd,SAAS,CAAC,aAAa,EACvB,kBAAkB,GAAG,0BAA0B,kBAAkB,EAAE,8BAA8B,EACjG,EAAE,GAAG,EAAE,CACV,CAAC;IACN,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,kBAAkB,GAAG,mCAAmC,EAAE;YAClG,GAAG;SACN,CAAC,CAAC;IACP,CAAC;IAED,IAAI,QAAiG,CAAC;IACtG,IAAI,CAAC;QACD,+FAA+F;QAC/F,gGAAgG;QAChG,wFAAwF;QACxF,QAAQ,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAU;YAC3D,GAAG,EAAE,GAAG;YACR,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,QAAQ;YACtB,gBAAgB,EAAE,gBAAgB;SACrC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,YAAY,CAAC,GAAG,EAAE,+BAA+B,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5D,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpG,CAAC;IAED,IAAI,IAAwB,CAAC;IAC7B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,CAAC;QACD,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,SAAS,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACJ,+EAA+E;YAC/E,YAAY,CAAC,GAAG,EAAE,qCAAqC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,kBAAkB,GAAG,2BAA2B,OAAO,EAAE,EAAE;gBACnG,GAAG;aACN,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,gGAAgG;IAChG,gGAAgG;IAChG,0FAA0F;IAC1F,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAA,oBAAoB,CAAC,IAAI,CAAC,mCAAI,QAAQ,CAAC,UAAU,CAAC;QAClE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,uBAAuB,EAAE;YACtG,GAAG;SACN,CAAC,CAAC;QACH,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,iGAAiG;IACjG,IAAI,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,kBAAkB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,iBAAiB,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,OAAO,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1F,oGAAoG;IACpG,4DAA4D;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,MAAA,YAAY,CAAC,WAAW,CAAC,mCAAI,OAAO,CAAC;IACrD,+FAA+F;IAC/F,kGAAkG;IAClG,gGAAgG;IAChG,oEAAoE;IACpE,IAAI,iBAAiB,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChE,OAAO,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IACrE,CAAC;IACD,2FAA2F;IAC3F,OAAO;QACH,QAAQ,EAAE;YACN;gBACI,GAAG;gBACH,GAAG,CAAC,YAAY,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;gBAC/C,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACD;SACnC;KACJ,CAAC;AACN,CAAC"}

package/dist/resources/resource_service.d.ts

@@ -1,8 +1,9 @@
-import type { ListResourcesResult, ListResourceTemplatesResult, ReadResourceResult, TextResourceContents } from '@modelcontextprotocol/sdk/types.js';
+import type { BlobResourceContents, ListResourcesResult, ListResourceTemplatesResult, ReadResourceResult, TextResourceContents } from '@modelcontextprotocol/sdk/types.js';
+import type { ApifyClient } from '../apify_client.js';
 import type { PaymentProvider } from '../payments/types.js';
 import { SERVER_MODE } from '../types.js';
 import type { AvailableWidget } from './widgets.js';
-type ExtendedResourceContents = TextResourceContents & {
+type ExtendedResourceContents = (TextResourceContents | BlobResourceContents) & {
     html?: string;
     _meta?: AvailableWidget['meta'];
 };
@@ -11,7 +12,7 @@ type ExtendedReadResourceResult = Omit<ReadResourceResult, 'contents'> & {
 };
 type ResourceService = {
     listResources: () => Promise<ListResourcesResult>;
-    readResource: (uri: string) => Promise<ExtendedReadResourceResult>;
+    readResource: (uri: string, apifyClient?: ApifyClient) => Promise<ExtendedReadResourceResult>;
     listResourceTemplates: () => Promise<ListResourceTemplatesResult>;
 };
 type ResourceServiceOptions = {

package/dist/resources/resource_service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource_service.d.ts","sourceRoot":"","sources":["../../src/resources/resource_service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAElB,oBAAoB,EACvB,MAAM,oCAAoC,CAAC;AAI5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,KAAK,wBAAwB,GAAG,oBAAoB,GAAG;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,KAAK,0BAA0B,GAAG,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG;IACrE,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACxC,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,aAAa,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACnE,qBAAqB,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACrE,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,WAAW,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC3D,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA6HtF"}
+{"version":3,"file":"resource_service.d.ts","sourceRoot":"","sources":["../../src/resources/resource_service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAElB,oBAAoB,EACvB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIpD,KAAK,wBAAwB,GAAG,CAAC,oBAAoB,GAAG,oBAAoB,CAAC,GAAG;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,KAAK,0BAA0B,GAAG,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG;IACrE,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACxC,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,aAAa,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC9F,qBAAqB,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACrE,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,WAAW,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC3D,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA0KtF"}

package/dist/resources/resource_service.js

@@ -1,6 +1,9 @@
 import { readFileSync } from 'node:fs';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
 import log from '@apify/log';
+import { getApifyAPIBaseUrl } from '../apify_client.js';
 import { SERVER_MODE } from '../types.js';
+import { readApiResource } from './api_resources.js';
 import { RESOURCE_MIME_TYPE } from './widgets.js';
 export function createResourceService(options) {
     const { paymentProvider, getMode, getAvailableWidgets } = options;
@@ -32,8 +35,14 @@ export function createResourceService(options) {
         }
         return { resources };
     };
-    const readResource = async (uri) => {
+    const readResource = async (uri, apifyClient) => {
         var _a;
+        // Route every http(s) URI to the API proxy — it owns the single origin gate, so a
+        // non-Apify URL gets the explanatory origin refusal instead of the generic fallback.
+        if (/^https?:\/\//i.test(uri)) {
+            // API contents carry no widget `_meta`/`html`; the extended shape only adds optional fields.
+            return (await readApiResource(uri, apifyClient));
+        }
         const usageGuide = (_a = paymentProvider === null || paymentProvider === void 0 ? void 0 : paymentProvider.getUsageGuide) === null || _a === void 0 ? void 0 : _a.call(paymentProvider);
         if (usageGuide && uri === 'file://readme.md') {
             return {
@@ -98,19 +107,55 @@ export function createResourceService(options) {
                 };
             }
         }
+        // A URI that is neither an http(s) URL, the usage guide, nor a served widget is not a
+        // readable resource — throw so the SDK returns a JSON-RPC error instead of success-shaped
+        // "not found" content (see SEP-2164 and src/resources/AGENTS.md).
+        throw new McpError(ErrorCode.InvalidParams, `Failed to read ${uri}: not a readable resource.`, { uri });
+    };
+    // Advertise the common URL shapes so clients that never surface the server instructions can
+    // still discover the read proxy and its paging parameters (RFC 6570 `{?var}` = query params).
+    // Advertisement only, NOT a route table: the read path stays a generic proxy, and any other
+    // Apify API GET URL is readable the same way.
+    const listResourceTemplates = async () => {
+        const api = getApifyAPIBaseUrl();
         return {
-            contents: [
+            resourceTemplates: [
                 {
-                    uri,
+                    uriTemplate: `${api}/v2/datasets/{datasetId}/items{?limit,offset,clean,fields,format}`,
+                    name: 'dataset-items',
+                    // No mimeType: `format` selects among 7 response types (json/jsonl/xml/html/csv/xlsx/rss),
+                    // and the spec allows a template mimeType only when all matching resources share one.
+                    description: 'Items of a dataset, read via resources/read (the server injects the Apify token). ' +
+                        'Page with limit/offset; format defaults to JSON — responses inline up to 256 KB, ' +
+                        'larger ones return a download URL.',
+                },
+                {
+                    uriTemplate: `${api}/v2/key-value-stores/{storeId}/records/{recordKey}`,
+                    name: 'key-value-store-record',
+                    description: 'A single record, returned whole in its stored Content-Type via resources/read. ' +
+                        'Not pageable — a record over 256 KB returns a download URL instead.',
+                },
+                {
+                    uriTemplate: `${api}/v2/key-value-stores/{storeId}/keys{?limit,exclusiveStartKey}`,
+                    name: 'key-value-store-keys',
+                    description: 'Keys of a key-value store. Page with limit/exclusiveStartKey (not offset).',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: `${api}/v2/actor-runs/{runId}`,
+                    name: 'actor-run',
+                    description: 'Metadata of an Actor run: status, storage IDs, usage.',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: `${api}/v2/logs/{runId}`,
+                    name: 'actor-run-log',
+                    description: 'Log of an Actor run. Inlines up to 256 KB, larger returns a download URL.',
                     mimeType: 'text/plain',
-                    text: `Resource ${uri} not found`,
                 },
             ],
         };
     };
-    const listResourceTemplates = async () => ({
-        resourceTemplates: [],
-    });
     return {
         listResources,
         readResource,

package/dist/resources/resource_service.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource_service.js","sourceRoot":"","sources":["../../src/resources/resource_service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resource_service.js","sourceRoot":"","sources":["../../src/resources/resource_service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAUvC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,GAAG,MAAM,YAAY,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AA+BlD,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACjE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;IAElE,MAAM,aAAa,GAAG,KAAK,IAAkC,EAAE;;QAC3D,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,IAAI,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,aAAa,+DAAI,EAAE,CAAC;YACrC,SAAS,CAAC,IAAI,CAAC;gBACX,GAAG,EAAE,kBAAkB;gBACvB,IAAI,EAAE,QAAQ;gBACd,WAAW,EACP,8EAA8E;oBAC9E,6BAA6B;gBACjC,QAAQ,EAAE,eAAe;aAC5B,CAAC,CAAC;QACP,CAAC;QAED,IAAI,OAAO,EAAE,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;YACjC,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;gBAClD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACjB,SAAS;gBACb,CAAC;gBACD,SAAS,CAAC,IAAI,CAAC;oBACX,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,QAAQ,EAAE,kBAAkB;oBAC5B,KAAK,EAAE,MAAM,CAAC,IAAI;iBACrB,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,KAAK,EAAE,GAAW,EAAE,WAAyB,EAAuC,EAAE;;QACvG,kFAAkF;QAClF,qFAAqF;QACrF,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,6FAA6F;YAC7F,OAAO,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,WAAW,CAAC,CAA+B,CAAC;QACnF,CAAC;QAED,MAAM,UAAU,GAAG,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,aAAa,+DAAI,CAAC;QACtD,IAAI,UAAU,IAAI,GAAG,KAAK,kBAAkB,EAAE,CAAC;YAC3C,OAAO;gBACH,QAAQ,EAAE;oBACN;wBACI,GAAG,EAAE,kBAAkB;wBACvB,QAAQ,EAAE,eAAe;wBACzB,IAAI,EAAE,UAAU;qBACnB;iBACJ;aACJ,CAAC;QACN,CAAC;QAED,IAAI,OAAO,EAAE,KAAK,WAAW,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACnE,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE9C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5B,OAAO;oBACH,QAAQ,EAAE;wBACN;4BACI,GAAG;4BACH,QAAQ,EAAE,YAAY;4BACtB,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,qBAAqB,MAAM,CAAC,MAAM,EAAE,EAAE;yBACvH;qBACJ;iBACJ,CAAC;YACN,CAAC;YAED,IAAI,CAAC;gBACD,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtD,MAAM,UAAU,GAAG;;;;;aAKtB,MAAM,CAAC,KAAK;;;;4BAIG,QAAQ;;QAE5B,CAAC;gBAEO,MAAM,aAAa,GAA6B;oBAC5C,GAAG;oBACH,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE,MAAM,CAAC,IAAI;iBACrB,CAAC;gBACF,OAAO;oBACH,QAAQ,EAAE,CAAC,aAAa,CAAC;iBAC5B,CAAC;YACN,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,OAAO;oBACH,QAAQ,EAAE;wBACN;4BACI,GAAG;4BACH,QAAQ,EAAE,YAAY;4BACtB,IAAI,EAAE,0BAA0B,YAAY,EAAE;yBACjD;qBACJ;iBACJ,CAAC;YACN,CAAC;QACL,CAAC;QAED,sFAAsF;QACtF,0FAA0F;QAC1F,kEAAkE;QAClE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,kBAAkB,GAAG,4BAA4B,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5G,CAAC,CAAC;IAEF,4FAA4F;IAC5F,8FAA8F;IAC9F,4FAA4F;IAC5F,8CAA8C;IAC9C,MAAM,qBAAqB,GAAG,KAAK,IAA0C,EAAE;QAC3E,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,OAAO;YACH,iBAAiB,EAAE;gBACf;oBACI,WAAW,EAAE,GAAG,GAAG,mEAAmE;oBACtF,IAAI,EAAE,eAAe;oBACrB,2FAA2F;oBAC3F,sFAAsF;oBACtF,WAAW,EACP,oFAAoF;wBACpF,mFAAmF;wBACnF,oCAAoC;iBAC3C;gBACD;oBACI,WAAW,EAAE,GAAG,GAAG,oDAAoD;oBACvE,IAAI,EAAE,wBAAwB;oBAC9B,WAAW,EACP,iFAAiF;wBACjF,qEAAqE;iBAC5E;gBACD;oBACI,WAAW,EAAE,GAAG,GAAG,+DAA+D;oBAClF,IAAI,EAAE,sBAAsB;oBAC5B,WAAW,EAAE,4EAA4E;oBACzF,QAAQ,EAAE,kBAAkB;iBAC/B;gBACD;oBACI,WAAW,EAAE,GAAG,GAAG,wBAAwB;oBAC3C,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,uDAAuD;oBACpE,QAAQ,EAAE,kBAAkB;iBAC/B;gBACD;oBACI,WAAW,EAAE,GAAG,GAAG,kBAAkB;oBACrC,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,2EAA2E;oBACxF,QAAQ,EAAE,YAAY;iBACzB;aACJ;SACJ,CAAC;IACN,CAAC,CAAC;IAEF,OAAO;QACH,aAAa;QACb,YAAY;QACZ,qBAAqB;KACxB,CAAC;AACN,CAAC"}

package/dist/tools/storage/get_key_value_store_record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_key_value_store_record.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAcnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA2H1B,CAAC"}
+{"version":3,"file":"get_key_value_store_record.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAmBnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA6H1B,CAAC"}

package/dist/tools/storage/get_key_value_store_record.js

@@ -1,13 +1,13 @@
 import dedent from 'dedent';
 import { z } from 'zod';
-import { HELPER_TOOLS, KV_RECORD_MAX_INLINE_BYTES } from '../../const.js';
+import { HELPER_TOOLS } from '../../const.js';
 import { TOOL_TYPE } from '../../types.js';
 import { compileSchema } from '../../utils/ajv.js';
 import { buildConsoleKeyValueStoreUrl, getConsoleLinkContext } from '../../utils/console_link.js';
 import { computeValueBytes, stripQuoteWrappers } from '../../utils/generic.js';
 import { respondRaw, respondUserError } from '../../utils/mcp.js';
 import { keyValueStoreRecordOutputSchema } from '../structured_output_schemas.js';
-import { buildConsoleLinkContent, buildStorageResponse, normalizeRecordKey } from './storage_helpers.js';
+import { buildBinaryRecordDisposition, buildConsoleLinkContent, buildStorageResponse, normalizeRecordKey, } from './storage_helpers.js';
 const getKeyValueStoreRecordArgs = z.object({
     keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name'),
     recordKey: z.string().min(1).describe('Key of the record to retrieve.'),
@@ -72,8 +72,10 @@ export const getKeyValueStoreRecord = Object.freeze({
         // structuredContent — so emit a minimal schema-conforming descriptor alongside the block.
         // The Console link (Console UI token sessions) rides as a trailing text block.
         if (Buffer.isBuffer(value)) {
-            // Content-Type is case-insensitive; lowercase so the image/audio checks below don't miss `Image/PNG`.
-            const mimeType = contentType === null || contentType === void 0 ? void 0 : contentType.split(';')[0].trim().toLowerCase();
+            // Normalizes the MIME type (so the image/audio checks below don't miss `Image/PNG`) and
+            // decides inline-vs-link-out at the same MAX_INLINE_BYTES threshold the API-resource proxy uses.
+            const disposition = buildBinaryRecordDisposition(contentType, value);
+            const { mimeType } = disposition;
             const structuredContent = {
                 keyValueStoreId,
                 key: record.key,
@@ -82,7 +84,7 @@ export const getKeyValueStoreRecord = Object.freeze({
                 summary,
             };
             const consoleLinkContent = buildConsoleLinkContent(apifyConsoleUrl);
-            if (value.length > KV_RECORD_MAX_INLINE_BYTES) {
+            if (disposition.kind === 'linkOut') {
                 // base64-inlining a large binary would blow up the context window; return a link instead.
                 const uri = await store.getRecordPublicUrl(recordKey);
                 return respondRaw({
@@ -92,14 +94,14 @@ export const getKeyValueStoreRecord = Object.freeze({
                             type: 'resource_link',
                             uri,
                             name: recordKey,
-                            size: value.length,
+                            size: disposition.bytes,
                             ...(mimeType && { mimeType }),
                         },
                         ...consoleLinkContent,
                     ],
                 });
             }
-            const data = value.toString('base64');
+            const data = disposition.base64;
             if (mimeType === null || mimeType === void 0 ? void 0 : mimeType.startsWith('image/')) {
                 return respondRaw({
                     structuredContent,

package/dist/tools/storage/get_key_value_store_record.js.map

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

package/dist/tools/storage/storage_helpers.d.ts

@@ -84,4 +84,31 @@ export declare function buildKvsKeysSummaryNextStep(params: {
     nextStep: string;
 };
 export declare function normalizeRecordKey(key: string): string;
+/**
+ * How to surface a binary key-value-store record value: inline as base64 below
+ * `MAX_INLINE_BYTES`, otherwise link out (inlining a multi-MB blob would blow up the
+ * client's context). `mimeType` is the Content-Type with parameters stripped and lowercased
+ * (`Image/PNG; charset=…` → `image/png`), or `undefined` when no Content-Type was declared.
+ */
+export type BinaryRecordDisposition = {
+    kind: 'inline';
+    mimeType?: string;
+    base64: string;
+} | {
+    kind: 'linkOut';
+    mimeType?: string;
+    bytes: number;
+};
+/**
+ * Base MIME type of a Content-Type header: parameters stripped, lowercased
+ * (`Image/PNG; charset=…` → `image/png`), `undefined` when no header was declared.
+ * Shared by the get-key-value-store-record tool and the API-resource proxy.
+ */
+export declare function parseBaseMimeType(contentType: string | undefined): string | undefined;
+/**
+ * Build the transport disposition for a binary record value: normalize the MIME type, decide
+ * inline-vs-link-out at the byte threshold, base64-encode when inlining. It does NOT mint the
+ * link-out URL — the caller handles `linkOut` by minting its own URL via async calls.
+ */
+export declare function buildBinaryRecordDisposition(contentType: string | undefined, value: Buffer): BinaryRecordDisposition;
 //# sourceMappingURL=storage_helpers.d.ts.map

package/dist/tools/storage/storage_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage_helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/storage_helpers.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAS7E;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAG7G;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,6CAQA;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CASxC;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAkBxC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgBxC;AAWD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"storage_helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/storage_helpers.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAS7E;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAG7G;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,6CAQA;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CASxC;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAkBxC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgBxC;AAWD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAErF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAMpH"}

package/dist/tools/storage/storage_helpers.js

@@ -1,4 +1,4 @@
-import { HELPER_TOOLS, HTTP_NOT_FOUND } from '../../const.js';
+import { HELPER_TOOLS, HTTP_NOT_FOUND, MAX_INLINE_BYTES } from '../../const.js';
 import { VERBATIM_LINKS_NUDGE } from '../../utils/console_link.js';
 import { QUOTE_WRAPPER_CHARS } from '../../utils/generic.js';
 import { getHttpStatusCode } from '../../utils/logging.js';
@@ -129,4 +129,24 @@ const NORMALIZE_RECORD_KEY_REGEX = new RegExp(`^[${QUOTE_WRAPPER_CHARS}]+|[${QUO
 export function normalizeRecordKey(key) {
     return key.trim().replace(NORMALIZE_RECORD_KEY_REGEX, '').trim();
 }
+/**
+ * Base MIME type of a Content-Type header: parameters stripped, lowercased
+ * (`Image/PNG; charset=…` → `image/png`), `undefined` when no header was declared.
+ * Shared by the get-key-value-store-record tool and the API-resource proxy.
+ */
+export function parseBaseMimeType(contentType) {
+    return contentType === null || contentType === void 0 ? void 0 : contentType.split(';')[0].trim().toLowerCase();
+}
+/**
+ * Build the transport disposition for a binary record value: normalize the MIME type, decide
+ * inline-vs-link-out at the byte threshold, base64-encode when inlining. It does NOT mint the
+ * link-out URL — the caller handles `linkOut` by minting its own URL via async calls.
+ */
+export function buildBinaryRecordDisposition(contentType, value) {
+    const mimeType = parseBaseMimeType(contentType);
+    if (value.length > MAX_INLINE_BYTES) {
+        return { kind: 'linkOut', ...(mimeType !== undefined && { mimeType }), bytes: value.length };
+    }
+    return { kind: 'inline', ...(mimeType !== undefined && { mimeType }), base64: value.toString('base64') };
+}
 //# sourceMappingURL=storage_helpers.js.map

package/dist/tools/storage/storage_helpers.js.map

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