@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/apify/catalog.js

@@ -0,0 +1,108 @@
+/**
+ * The actors NodeTool ships knowing about.
+ *
+ * Two jobs, and they are separate. The catalog is the **default allowlist** —
+ * what an install runs without anyone approving anything — and it is the
+ * lookup behind the ergonomic wrappers (`crawl_website` and friends), which
+ * are thin: a wrapper picks an entry here, maps a handful of named arguments
+ * onto that actor's input, and calls the same generic run path a model would.
+ *
+ * Entries are chosen for being first-party (`apify/*`) or the long-standing
+ * community actor for a capability with no official equivalent, with a stable
+ * documented input schema. An actor is not added because it ranks first in a
+ * store search. `costHint` is the shape of the bill, not a price: the price
+ * moves, and `get_apify_actor` reads the live figure from the store record.
+ */
+/**
+ * The shipped allowlist.
+ *
+ * Ordered cheapest-and-most-specific first within each capability, which is
+ * also the order a model reads them in: `website-content-crawler` before
+ * `playwright-scraper` means the default answer to "get me this page" is an
+ * HTTP fetch, not a browser.
+ */
+export const ACTOR_CATALOG = [
+    {
+        id: "apify/website-content-crawler",
+        capability: "crawl",
+        summary: "Crawl a site and return each page as clean Markdown or text. The " +
+            "default choice for reading documentation, articles, or a whole site " +
+            "for an LLM.",
+        costHint: "per-result"
+    },
+    {
+        id: "apify/cheerio-scraper",
+        capability: "extract",
+        summary: "Fast HTML-only scraping with a page function. No browser, so it " +
+            "cannot see content a page renders with JavaScript.",
+        costHint: "compute-time"
+    },
+    {
+        id: "apify/web-scraper",
+        capability: "extract",
+        summary: "Browser-rendered scraping with a page function. Use when the data " +
+            "appears only after scripts run.",
+        costHint: "compute-time"
+    },
+    {
+        id: "apify/playwright-scraper",
+        capability: "browser",
+        summary: "Full Playwright automation for pages needing interaction — logins, " +
+            "clicks, infinite scroll. The most expensive option; prefer a crawl or " +
+            "an HTML scrape when either would do.",
+        costHint: "compute-time"
+    },
+    {
+        id: "apify/google-search-scraper",
+        capability: "search",
+        summary: "Google search result pages as structured records.",
+        costHint: "per-result"
+    },
+    {
+        id: "compass/google-maps-extractor",
+        capability: "places",
+        summary: "Google Maps businesses by search term and location, with address, " +
+            "rating, category, and contact details.",
+        costHint: "per-result"
+    },
+    {
+        id: "apify/instagram-scraper",
+        capability: "social",
+        summary: "Public Instagram profiles, posts, and comments.",
+        costHint: "per-result"
+    },
+    {
+        id: "trudax/reddit-scraper-lite",
+        capability: "social",
+        summary: "Public Reddit posts and comments by subreddit, user, or search.",
+        costHint: "per-result"
+    },
+    {
+        id: "apify/screenshot-url",
+        capability: "screenshot",
+        summary: "Render a URL and store the screenshot in the run's key-value store.",
+        costHint: "per-event"
+    },
+    {
+        id: "streamers/youtube-scraper",
+        capability: "transcript",
+        summary: "YouTube video metadata and, where published, subtitles/transcripts.",
+        costHint: "per-result"
+    }
+];
+const BY_ID = new Map(ACTOR_CATALOG.map((actor) => [actor.id, actor]));
+/** The catalog entry for a canonical actor id, if NodeTool ships one. */
+export function catalogActor(id) {
+    return BY_ID.get(id);
+}
+/** Every shipped actor for one capability, in catalog (preference) order. */
+export function actorsFor(capability) {
+    return ACTOR_CATALOG.filter((actor) => actor.capability === capability);
+}
+/** The default actor a wrapper uses for a capability. */
+export function defaultActorFor(capability) {
+    return actorsFor(capability)[0];
+}
+/** The ids that make up the shipped default allowlist. */
+export const CATALOG_ACTOR_IDS = ACTOR_CATALOG.map((actor) => actor.id);
+//# sourceMappingURL=catalog.js.map

package/dist/apify/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/apify/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwBH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAA4B;IACpD;QACE,EAAE,EAAE,+BAA+B;QACnC,UAAU,EAAE,OAAO;QACnB,OAAO,EACL,mEAAmE;YACnE,sEAAsE;YACtE,aAAa;QACf,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,EAAE,EAAE,uBAAuB;QAC3B,UAAU,EAAE,SAAS;QACrB,OAAO,EACL,kEAAkE;YAClE,oDAAoD;QACtD,QAAQ,EAAE,cAAc;KACzB;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,UAAU,EAAE,SAAS;QACrB,OAAO,EACL,oEAAoE;YACpE,iCAAiC;QACnC,QAAQ,EAAE,cAAc;KACzB;IACD;QACE,EAAE,EAAE,0BAA0B;QAC9B,UAAU,EAAE,SAAS;QACrB,OAAO,EACL,qEAAqE;YACrE,wEAAwE;YACxE,sCAAsC;QACxC,QAAQ,EAAE,cAAc;KACzB;IACD;QACE,EAAE,EAAE,6BAA6B;QACjC,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,mDAAmD;QAC5D,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,EAAE,EAAE,+BAA+B;QACnC,UAAU,EAAE,QAAQ;QACpB,OAAO,EACL,oEAAoE;YACpE,wCAAwC;QAC1C,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,iDAAiD;QAC1D,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,EAAE,EAAE,4BAA4B;QAChC,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,iEAAiE;QAC1E,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,UAAU,EAAE,YAAY;QACxB,OAAO,EACL,qEAAqE;QACvE,QAAQ,EAAE,WAAW;KACtB;IACD;QACE,EAAE,EAAE,2BAA2B;QAC/B,UAAU,EAAE,YAAY;QACxB,OAAO,EACL,qEAAqE;QACvE,QAAQ,EAAE,YAAY;KACvB;CACF,CAAC;AAEF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAEvE,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CACvB,UAA2B;IAE3B,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;AAC1E,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAC7B,UAA2B;IAE3B,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAsB,aAAa,CAAC,GAAG,CACnE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CACpB,CAAC"}

package/dist/apify/client.d.ts

@@ -0,0 +1,137 @@
+/**
+ * The Apify REST client — the only code in NodeTool that holds the API token.
+ *
+ * Everything above this file (policy, normalization, the capability module,
+ * the sandbox) works in terms of actor ids and plain data. The token is
+ * constructor-private, is attached to a request and never to a result, and is
+ * scrubbed out of every error before it is thrown, so there is no path by
+ * which it reaches guest code, a tool result, a model's context, or a log line.
+ *
+ * Endpoints, verified against docs.apify.com (v2):
+ *
+ *   GET  /v2/store                                  actor store search
+ *   GET  /v2/acts/:actorId                          actor record
+ *   GET  /v2/acts/:actorId/builds/default           build → actorDefinition.input
+ *   POST /v2/acts/:actorId/runs                     start a run
+ *   GET  /v2/actor-runs/:runId                      poll a run
+ *   POST /v2/actor-runs/:runId/abort                abort a run
+ *   GET  /v2/datasets/:datasetId/items              dataset page
+ *   GET  /v2/key-value-stores/:storeId/records/:key  one record
+ *
+ * There is deliberately no use of `run-sync-get-dataset-items`. It caps at 300
+ * seconds, gives no run id while it blocks, and so cannot be aborted when the
+ * surrounding NodeTool run is cancelled. Start-then-poll is one code path that
+ * handles a two-second actor and a twenty-minute one, and always has an id to
+ * abort.
+ */
+/** The public API root. Not configurable: it is also the SSRF answer. */
+export declare const APIFY_API_BASE = "https://api.apify.com";
+/** Terminal and non-terminal run states, as the API spells them. */
+export declare const APIFY_RUN_STATUSES: readonly ["READY", "RUNNING", "SUCCEEDED", "FAILED", "TIMING-OUT", "TIMED-OUT", "ABORTING", "ABORTED"];
+export type ApifyRunStatus = (typeof APIFY_RUN_STATUSES)[number];
+/** True once the run has settled and polling it again is pointless. */
+export declare function isTerminalRunStatus(status: string): boolean;
+/** One actor run, as much of it as anything above this layer reads. */
+export interface ApifyRun {
+    readonly id: string;
+    readonly actId: string;
+    readonly status: string;
+    readonly statusMessage?: string;
+    readonly defaultDatasetId?: string;
+    readonly defaultKeyValueStoreId?: string;
+    readonly startedAt?: string;
+    readonly finishedAt?: string;
+    readonly usageTotalUsd?: number;
+    readonly stats?: Record<string, unknown>;
+}
+/** One store listing entry, unnormalized. */
+export type ApifyStoreItem = Record<string, unknown>;
+/** One dataset page plus the count the page was taken from. */
+export interface ApifyDatasetPage {
+    readonly items: readonly unknown[];
+    /** Total items in the dataset, from the `X-Apify-Pagination-Total` header. */
+    readonly total?: number;
+    readonly offset: number;
+    readonly limit: number;
+}
+/** A key-value record's bytes and declared type. */
+export interface ApifyRecord {
+    readonly bytes: Uint8Array;
+    readonly contentType: string;
+}
+export interface ApifyClientOptions {
+    /** Injected for tests; defaults to the global fetch. */
+    readonly fetchImpl?: typeof fetch;
+    /** Per-request ceiling, in milliseconds. Not the run's deadline. */
+    readonly requestTimeoutMs?: number;
+    /** Attempts for a retryable failure, including the first. */
+    readonly maxAttempts?: number;
+    /** Base backoff, doubled per attempt. */
+    readonly retryBaseMs?: number;
+}
+/**
+ * Apify's actor id in a URL is `owner~name`, not `owner/name`. Accepting the
+ * slash form everywhere and converting here is not a convenience: the slash
+ * form is what every actor page, every doc, and therefore every model writes,
+ * and sending it unconverted produces a 404 that reads like a missing actor.
+ */
+export declare function toActorPathId(actorId: string): string;
+/** The canonical `owner/name` form, for display and allowlist comparison. */
+export declare function toCanonicalActorId(actorId: string): string;
+export declare class ApifyClient {
+    #private;
+    constructor(token: string, options?: ApifyClientOptions);
+    /** Search the actor store. `responseFormat=agent` is Apify's own compact form. */
+    searchActors(params: {
+        query?: string;
+        limit?: number;
+        offset?: number;
+        category?: string;
+        sortBy?: string;
+        pricingModel?: string;
+    }, signal?: AbortSignal): Promise<readonly ApifyStoreItem[]>;
+    /** One actor's record. */
+    getActor(actorId: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    /**
+     * The actor's default build, which is where the machine-readable input
+     * schema lives (`actorDefinition.input`). There is no separate schema
+     * endpoint — this is the authoritative source, so nothing here parses a
+     * README.
+     */
+    getDefaultBuild(actorId: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    /** Start a run. Returns as soon as Apify has accepted it. */
+    startRun(params: {
+        actorId: string;
+        input: Record<string, unknown>;
+        memoryMbytes?: number;
+        timeoutSecs?: number;
+        maxItems?: number;
+        build?: string;
+    }, signal?: AbortSignal): Promise<ApifyRun>;
+    /** One poll of a run. */
+    getRun(runId: string, signal?: AbortSignal): Promise<ApifyRun>;
+    /**
+     * Abort a run.
+     *
+     * Idempotent by the API's own contract: a run already in a terminal state is
+     * left alone rather than erroring. The call deliberately does **not** take
+     * the caller's abort signal — it is what runs *because* the caller was
+     * cancelled, and passing the aborted signal would cancel the cleanup.
+     */
+    abortRun(runId: string, gracefully?: boolean): Promise<ApifyRun | null>;
+    /** One page of a dataset, with the dataset's total when the header carries it. */
+    getDatasetItems(params: {
+        datasetId: string;
+        offset?: number;
+        limit?: number;
+        clean?: boolean;
+        fields?: readonly string[];
+    }, signal?: AbortSignal): Promise<ApifyDatasetPage>;
+    /**
+     * One key-value record's raw bytes. This is where an actor's non-tabular
+     * output lives — a screenshot's PNG, a crawl's rendered HTML, the `OUTPUT`
+     * key — so it returns bytes and a content type, not parsed JSON.
+     */
+    getKeyValueRecord(storeId: string, key: string, signal?: AbortSignal): Promise<ApifyRecord | null>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/apify/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/apify/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAYH,yEAAyE;AACzE,eAAO,MAAM,cAAc,0BAA0B,CAAC;AAEtD,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,YAC7B,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,CACD,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAUjE,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAuDD,qBAAa,WAAW;;IAOtB,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,EAa1D;IAgHD,kFAAkF;IAC5E,YAAY,CAChB,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAkBpC;IAED,0BAA0B;IACpB,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAalC;IAED;;;;;OAKG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAelC;IAED,6DAA6D;IACvD,QAAQ,CACZ,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC,CAiBnB;IAED,yBAAyB;IACnB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOnE;IAED;;;;;;;OAOG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAc1E;IAED,kFAAkF;IAC5E,eAAe,CACnB,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAC5B,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;IAED;;;;OAIG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAoB7B;CACF"}

package/dist/apify/client.js

@@ -0,0 +1,346 @@
+/**
+ * The Apify REST client — the only code in NodeTool that holds the API token.
+ *
+ * Everything above this file (policy, normalization, the capability module,
+ * the sandbox) works in terms of actor ids and plain data. The token is
+ * constructor-private, is attached to a request and never to a result, and is
+ * scrubbed out of every error before it is thrown, so there is no path by
+ * which it reaches guest code, a tool result, a model's context, or a log line.
+ *
+ * Endpoints, verified against docs.apify.com (v2):
+ *
+ *   GET  /v2/store                                  actor store search
+ *   GET  /v2/acts/:actorId                          actor record
+ *   GET  /v2/acts/:actorId/builds/default           build → actorDefinition.input
+ *   POST /v2/acts/:actorId/runs                     start a run
+ *   GET  /v2/actor-runs/:runId                      poll a run
+ *   POST /v2/actor-runs/:runId/abort                abort a run
+ *   GET  /v2/datasets/:datasetId/items              dataset page
+ *   GET  /v2/key-value-stores/:storeId/records/:key  one record
+ *
+ * There is deliberately no use of `run-sync-get-dataset-items`. It caps at 300
+ * seconds, gives no run id while it blocks, and so cannot be aborted when the
+ * surrounding NodeTool run is cancelled. Start-then-poll is one code path that
+ * handles a two-second actor and a twenty-minute one, and always has an id to
+ * abort.
+ */
+import { setTimeout as delay } from "node:timers/promises";
+import { ApifyError, asApifyError } from "./errors.js";
+import { isNonBlankString, isRecord, isString } from "../utils/type-guards.js";
+/** The public API root. Not configurable: it is also the SSRF answer. */
+export const APIFY_API_BASE = "https://api.apify.com";
+/** Terminal and non-terminal run states, as the API spells them. */
+export const APIFY_RUN_STATUSES = [
+    "READY",
+    "RUNNING",
+    "SUCCEEDED",
+    "FAILED",
+    "TIMING-OUT",
+    "TIMED-OUT",
+    "ABORTING",
+    "ABORTED"
+];
+/** States that will not change again without a new call. */
+const TERMINAL = new Set([
+    "SUCCEEDED",
+    "FAILED",
+    "TIMED-OUT",
+    "ABORTED"
+]);
+/** True once the run has settled and polling it again is pointless. */
+export function isTerminalRunStatus(status) {
+    return TERMINAL.has(status);
+}
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_ATTEMPTS = 3;
+const DEFAULT_RETRY_BASE_MS = 500;
+/**
+ * Apify's actor id in a URL is `owner~name`, not `owner/name`. Accepting the
+ * slash form everywhere and converting here is not a convenience: the slash
+ * form is what every actor page, every doc, and therefore every model writes,
+ * and sending it unconverted produces a 404 that reads like a missing actor.
+ */
+export function toActorPathId(actorId) {
+    return actorId.trim().replace(/\//g, "~");
+}
+/** The canonical `owner/name` form, for display and allowlist comparison. */
+export function toCanonicalActorId(actorId) {
+    return actorId.trim().replace(/~/g, "/");
+}
+/** Map an HTTP status onto the distinction a caller acts on. */
+function kindForStatus(status, apifyType) {
+    if (status === 401 || status === 403)
+        return "auth";
+    if (status === 404)
+        return "actor_not_found";
+    if (status === 429)
+        return "rate_limited";
+    if (status >= 500)
+        return "network";
+    if (apifyType === "insufficient-permissions")
+        return "auth";
+    return "invalid_input";
+}
+/**
+ * Strip anything token-shaped out of a message before it becomes an error.
+ *
+ * Apify echoes request context in some error bodies, and a token pasted into an
+ * actor input field would come back in a validation message. Redacting at the
+ * one place errors are built beats trusting every call site not to log.
+ */
+function redact(text, token) {
+    const safe = token.length >= 8 ? text.split(token).join("«redacted»") : text;
+    return safe.replace(/\bapify_api_[A-Za-z0-9]{10,}\b/g, "«redacted»");
+}
+/** Wait, waking early if the caller's signal fires. Never rejects. */
+async function sleep(ms, signal) {
+    await delay(ms, undefined, { signal }).catch(() => undefined);
+}
+/**
+ * Whether the caller's signal has fired *now*.
+ *
+ * A function rather than an inline `signal?.aborted === true`: the flag is
+ * mutable, and the compiler narrows it to `false` after the check at the top of
+ * a retry attempt, which would make the identical check inside the `catch`
+ * unreachable — exactly the check that separates a cancelled run from a timed
+ * out request.
+ */
+function isAborted(signal) {
+    return signal !== undefined && signal.aborted;
+}
+/** Read Apify's `{error: {type, message}}` envelope, tolerating anything else. */
+function readErrorBody(body) {
+    if (!isRecord(body) || !isRecord(body.error))
+        return {};
+    const { type, message } = body.error;
+    const parsed = {};
+    if (isString(type))
+        parsed.type = type;
+    if (isString(message))
+        parsed.message = message;
+    return parsed;
+}
+export class ApifyClient {
+    #token;
+    #fetch;
+    #requestTimeoutMs;
+    #maxAttempts;
+    #retryBaseMs;
+    constructor(token, options = {}) {
+        if (!isNonBlankString(token)) {
+            throw new ApifyError("auth", "No Apify API token is configured. Add APIFY_API_TOKEN in Settings → Secrets.");
+        }
+        this.#token = token;
+        this.#fetch = options.fetchImpl ?? fetch;
+        this.#requestTimeoutMs =
+            options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.#maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+        this.#retryBaseMs = options.retryBaseMs ?? DEFAULT_RETRY_BASE_MS;
+    }
+    /**
+     * One request, with the retry policy the error kinds imply.
+     *
+     * Only `rate_limited` and `network` come back round: an invalid input or a
+     * rejected token fails the same way every time, and a *run* is never retried
+     * here at all, because a second start is a second charge.
+     */
+    async #request(path, init, signal, context = {}) {
+        const url = new URL(path, APIFY_API_BASE);
+        for (const [key, value] of Object.entries(init.query ?? {})) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        let lastError;
+        for (let attempt = 1; attempt <= this.#maxAttempts; attempt++) {
+            if (isAborted(signal)) {
+                throw new ApifyError("cancelled", "The Apify call was cancelled", context);
+            }
+            // Two reasons to give up on one attempt: the surrounding run was
+            // cancelled, or this single request hung. They are combined rather than
+            // chosen between, so a slow request inside a live run still times out.
+            const timeout = AbortSignal.timeout(this.#requestTimeoutMs);
+            const composite = signal === undefined ? timeout : AbortSignal.any([signal, timeout]);
+            try {
+                const response = await this.#fetch(url.toString(), {
+                    ...init,
+                    signal: composite,
+                    headers: {
+                        ...(init.headers ?? {}),
+                        Authorization: `Bearer ${this.#token}`,
+                        Accept: "application/json"
+                    }
+                });
+                if (response.ok)
+                    return response;
+                const body = await response
+                    .clone()
+                    .json()
+                    .catch(() => undefined);
+                const { type, message } = readErrorBody(body);
+                const retryAfter = Number(response.headers?.get?.("retry-after") ?? "");
+                const options = {
+                    status: response.status,
+                    ...context
+                };
+                if (type !== undefined)
+                    options.apifyType = type;
+                if (Number.isFinite(retryAfter) && retryAfter > 0) {
+                    options.retryAfterSeconds = retryAfter;
+                }
+                lastError = new ApifyError(kindForStatus(response.status, type), redact(message ?? `Apify request failed with HTTP ${response.status}`, this.#token), options);
+            }
+            catch (e) {
+                // A cancelled *outer* run must not be mistaken for a hung request: the
+                // composite signal fires for both, so the caller's signal decides.
+                if (isAborted(signal)) {
+                    throw new ApifyError("cancelled", "The Apify call was cancelled", context);
+                }
+                lastError = asApifyError(e);
+                if (lastError.kind === "cancelled") {
+                    lastError = new ApifyError("network", `Apify request timed out after ${this.#requestTimeoutMs}ms`, context);
+                }
+            }
+            if (!lastError.retryable || attempt === this.#maxAttempts)
+                break;
+            const backoff = lastError.retryAfterSeconds !== undefined
+                ? lastError.retryAfterSeconds * 1000
+                : this.#retryBaseMs * 2 ** (attempt - 1);
+            await sleep(backoff, signal);
+        }
+        throw lastError ?? new ApifyError("network", "Apify request failed", context);
+    }
+    async #json(path, init, signal, context = {}) {
+        const response = await this.#request(path, init, signal, context);
+        const body = (await response.json().catch(() => undefined));
+        // Every documented v2 endpoint wraps its payload in `data`; the dataset
+        // items endpoint is the exception and returns a bare array.
+        if (isRecord(body) && "data" in body)
+            return body.data;
+        return body;
+    }
+    /** Search the actor store. `responseFormat=agent` is Apify's own compact form. */
+    async searchActors(params, signal) {
+        const data = await this.#json("/v2/store", {
+            method: "GET",
+            query: {
+                search: params.query,
+                limit: params.limit,
+                offset: params.offset,
+                category: params.category,
+                sortBy: params.sortBy,
+                pricingModel: params.pricingModel
+            }
+        }, signal);
+        const items = isRecord(data) ? data.items : data;
+        return Array.isArray(items) ? items : [];
+    }
+    /** One actor's record. */
+    async getActor(actorId, signal) {
+        const data = await this.#json(`/v2/acts/${encodeURIComponent(toActorPathId(actorId))}`, { method: "GET" }, signal, { actorId });
+        if (!isRecord(data)) {
+            throw new ApifyError("actor_not_found", `Actor ${actorId} not found`, {
+                actorId
+            });
+        }
+        return data;
+    }
+    /**
+     * The actor's default build, which is where the machine-readable input
+     * schema lives (`actorDefinition.input`). There is no separate schema
+     * endpoint — this is the authoritative source, so nothing here parses a
+     * README.
+     */
+    async getDefaultBuild(actorId, signal) {
+        const data = await this.#json(`/v2/acts/${encodeURIComponent(toActorPathId(actorId))}/builds/default`, { method: "GET" }, signal, { actorId });
+        if (!isRecord(data)) {
+            throw new ApifyError("actor_not_found", `Actor ${actorId} has no default build to read an input schema from`, { actorId });
+        }
+        return data;
+    }
+    /** Start a run. Returns as soon as Apify has accepted it. */
+    async startRun(params, signal) {
+        return this.#json(`/v2/acts/${encodeURIComponent(toActorPathId(params.actorId))}/runs`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(params.input),
+            query: {
+                memory: params.memoryMbytes,
+                timeout: params.timeoutSecs,
+                maxItems: params.maxItems,
+                build: params.build
+            }
+        }, signal, { actorId: params.actorId });
+    }
+    /** One poll of a run. */
+    async getRun(runId, signal) {
+        return this.#json(`/v2/actor-runs/${encodeURIComponent(runId)}`, { method: "GET" }, signal, { runId });
+    }
+    /**
+     * Abort a run.
+     *
+     * Idempotent by the API's own contract: a run already in a terminal state is
+     * left alone rather than erroring. The call deliberately does **not** take
+     * the caller's abort signal — it is what runs *because* the caller was
+     * cancelled, and passing the aborted signal would cancel the cleanup.
+     */
+    async abortRun(runId, gracefully = false) {
+        try {
+            return await this.#json(`/v2/actor-runs/${encodeURIComponent(runId)}/abort`, { method: "POST", query: { gracefully: gracefully ? "true" : undefined } }, undefined, { runId });
+        }
+        catch (e) {
+            // Losing a race with the run finishing on its own is the success case.
+            const error = asApifyError(e);
+            if (error.status === 400 || error.status === 404)
+                return null;
+            throw error;
+        }
+    }
+    /** One page of a dataset, with the dataset's total when the header carries it. */
+    async getDatasetItems(params, signal) {
+        const offset = params.offset ?? 0;
+        const limit = params.limit ?? 100;
+        const response = await this.#request(`/v2/datasets/${encodeURIComponent(params.datasetId)}/items`, {
+            method: "GET",
+            query: {
+                offset,
+                limit,
+                format: "json",
+                clean: params.clean === true ? "true" : undefined,
+                fields: params.fields === undefined || params.fields.length === 0
+                    ? undefined
+                    : params.fields.join(",")
+            }
+        }, signal);
+        const body = (await response.json().catch(() => undefined));
+        const totalHeader = Number(response.headers?.get?.("x-apify-pagination-total") ?? "");
+        const page = { items: Array.isArray(body) ? body : [], offset, limit };
+        if (Number.isFinite(totalHeader))
+            page.total = totalHeader;
+        return page;
+    }
+    /**
+     * One key-value record's raw bytes. This is where an actor's non-tabular
+     * output lives — a screenshot's PNG, a crawl's rendered HTML, the `OUTPUT`
+     * key — so it returns bytes and a content type, not parsed JSON.
+     */
+    async getKeyValueRecord(storeId, key, signal) {
+        try {
+            const response = await this.#request(`/v2/key-value-stores/${encodeURIComponent(storeId)}/records/${encodeURIComponent(key)}`, { method: "GET" }, signal);
+            const buffer = await response.arrayBuffer();
+            return {
+                bytes: new Uint8Array(buffer),
+                contentType: response.headers?.get?.("content-type") ?? "application/octet-stream"
+            };
+        }
+        catch (e) {
+            const error = asApifyError(e, "dataset_failed");
+            // A missing key is an answer, not a failure: many actors write OUTPUT
+            // only when they have something to put there.
+            if (error.status === 404)
+                return null;
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/apify/client.js.map

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