@oomol-lab/open-connector 1.9.1 → 1.9.3

package/src/providers/the_cat_api/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalNumber, optionalRecord, optionalString, } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, providerInputError, providerResponseError, } from "../provider-runtime.js";
 export const theCatApiBaseUrl = "https://api.thecatapi.com/v1/";
 const theCatApiValidationPath = "/breeds";
 export const theCatApiActionHandlers = {
@@ -176,7 +176,7 @@ async function readTheCatApiPayload(response) {
 function createTheCatApiError(response, payload, phase) {
     const message = extractTheCatApiErrorMessage(payload) ?? response.statusText ?? "The Cat API request failed";
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 502, message);
 }
@@ -189,7 +189,7 @@ function extractTheCatApiErrorMessage(payload) {
 }
 function parseArrayPayload(payload, message) {
     if (!Array.isArray(payload)) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return payload;
 }

package/src/providers/the_colony/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalNumber, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 export const theColonyApiBaseUrl = "https://thecolony.cc/api/v1";
 const theColonyTokenPath = "/auth/token";
 const theColonyValidationPath = "/users/me";
@@ -291,7 +291,7 @@ function mapTheColonyError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(401, message);
@@ -367,5 +367,5 @@ function readObjectPayload(payload, label) {
     return record;
 }
 function readRequiredString(input, fieldName) {
-    return requiredString(input[fieldName], fieldName, (message) => new ProviderRequestError(400, message));
+    return requiredString(input[fieldName], fieldName, providerInputError);
 }

package/src/providers/the_odds_api/runtime.js

@@ -1,7 +1,6 @@
 import { booleanString, compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, ProviderRequestError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 export const theOddsApiBaseUrl = "https://api.the-odds-api.com/v4/";
-const defaultRequestTimeoutMs = 30_000;
 export const theOddsApiActionHandlers = {
     async list_sports(input, context) {
         const response = await theOddsApiRequestJson("sports", context, compactObject({ all: booleanString(input.all) }));
@@ -101,7 +100,7 @@ export function theOddsApiRequestUrl(path, apiKey, params) {
     return url;
 }
 async function theOddsApiRequestJson(path, context, params, phase = "execute") {
-    const timeout = createProviderTimeout(context.signal, defaultRequestTimeoutMs);
+    const timeout = createProviderTimeout(context.signal);
     let response;
     let payload;
     try {
@@ -113,7 +112,7 @@ async function theOddsApiRequestJson(path, context, params, phase = "execute") {
     }
     catch (error) {
         if (timeout.didTimeout() && isAbortLikeError(error)) {
-            throw new ProviderRequestError(502, `The Odds API ${path} request timed out after ${Math.ceil(defaultRequestTimeoutMs / 1000)} seconds`);
+            throw new ProviderRequestError(502, `The Odds API ${path} request timed out after ${Math.ceil(defaultProviderRequestTimeoutMs / 1000)} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? `The Odds API request failed: ${error.message}` : "The Odds API request failed");
     }

package/src/providers/the_official_board/runtime.js

@@ -1,5 +1,5 @@
 import { requiredString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const apiBaseUrl = "https://rest.theofficialboard.com/rest/";
 const actionRequestByName = {
     search_companies: {
@@ -79,15 +79,15 @@ async function readPayload(response) {
 }
 function mapError(status, message, phase) {
     if (status === 401 || status === 403) {
-        return phase === "validation" ? new ProviderRequestError(400, message) : new ProviderRequestError(401, message);
+        return phase === "validation" ? providerInputError(message) : new ProviderRequestError(401, message);
     }
     if (status === 429) {
         return new ProviderRequestError(429, message);
     }
     if (status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function readErrorMessage(payload) {
     if (typeof payload === "string" && payload.trim()) {

package/src/providers/thehive/runtime.js

@@ -154,7 +154,7 @@ function mapError(status, payload, phase, displayName, notFound) {
     if (status == 401 || status == 403)
         return new ProviderRequestError(phase == "validate" ? 400 : status, message);
     if (status == 404 && notFound)
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     if (status == 429)
         return new ProviderRequestError(429, message);
     return new ProviderRequestError(status >= 500 ? 502 : status, message, payload);

package/src/providers/tikhub/endpoint-catalog.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { createProviderTimeout, isAbortLikeError, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, ProviderRequestError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 import { cancelResponseBody, readBoundedResponseText } from "./bounded-response.js";
 import { parseTikHubOpenApiCatalog } from "./endpoint-document.js";
 import { isEligibleTikHubEndpointCategory } from "./endpoint-policy.js";
@@ -8,7 +8,6 @@ const openApiTimeoutMs = 15_000;
 const openApiMaxBytes = 8 * 1024 * 1024;
 const catalogTtlMs = 60_000;
 const catalogStaleTtlMs = 60 * 60_000;
-const catalogFailureTtlMs = 30_000;
 const discoveryPageMaxBytes = 4 * 1024 * 1024;
 const cursorMaxLength = 1_024;
 class TransientOpenApiError extends ProviderRequestError {
@@ -93,7 +92,7 @@ async function refreshCatalog(fetcher, cache) {
     }
     catch (error) {
         if (error instanceof TransientOpenApiError && cache.snapshot && Date.now() < cache.snapshot.staleUntil) {
-            cache.retryAfter = Date.now() + catalogFailureTtlMs;
+            cache.retryAfter = Date.now() + defaultProviderRequestTimeoutMs;
             return { snapshot: cache.snapshot, stale: true };
         }
         throw error;

package/src/providers/tiktok_business/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, looseArray, optionalRecord, recordOrEmpty } from "../../core/cast.js";
-import { ProviderRequestError } from "../provider-runtime.js";
+import { ProviderRequestError, providerInputError } from "../provider-runtime.js";
 const tiktokBusinessApiBaseUrl = "https://business-api.tiktok.com";
 const tiktokBusinessUserInfoUrl = `${tiktokBusinessApiBaseUrl}/open_api/v1.3/user/info/`;
 const tiktokBusinessAdvertiserUrl = `${tiktokBusinessApiBaseUrl}/open_api/v1.3/oauth2/advertiser/get/`;
@@ -341,7 +341,7 @@ function createTikTokBusinessError(status, envelope) {
         return new ProviderRequestError(status || 403, `${stripTrailingSentencePunctuation(message)}. ${tiktokBusinessPermissionScopeHint}`);
     }
     if (status === 400 || status === 422 || code === 40001 || code === 40003) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 429) {
         return new ProviderRequestError(status || 429, message);

package/src/providers/timecamp/runtime.js

@@ -1,5 +1,5 @@
 import { booleanString, compactObject, optionalRecord, optionalRawString, optionalString } from "../../core/cast.js";
-import { providerUserAgent, ProviderRequestError, runProviderRequest } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, runProviderRequest, providerInputError, } from "../provider-runtime.js";
 export const timecampApiBaseUrl = "https://app.timecamp.com/third_party/api";
 export const timecampActionHandlers = {
     async get_current_user(_input, context) {
@@ -240,7 +240,7 @@ function createTimecampError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && status === 401) {
         return new ProviderRequestError(401, message);

package/src/providers/timelink/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalNumber as asOptionalNumber, optionalRecord as asOptionalObject, optionalString as asOptionalString, requiredString, } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent, runProviderRequest } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, runProviderRequest, providerInputError, } from "../provider-runtime.js";
 export const timelinkApiBaseUrl = "https://api.timelink.io/api/v1";
 export const timelinkActionHandlers = {
     async list_clients(input, context) {
@@ -307,7 +307,7 @@ function createTimelinkError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(401, message);

package/src/providers/tinyfish/actions.d.ts

@@ -0,0 +1,6 @@
+import type { ActionDefinition } from "../../core/types.ts";
+import type { TinyfishEndpoint } from "./endpoints.ts";
+declare const tinyfishEndpoints: TinyfishEndpoint[];
+export declare const tinyfishEndpointByName: Map<string, (typeof tinyfishEndpoints)[number]>;
+export declare const tinyfishActions: ActionDefinition[];
+export {};

package/src/providers/tinyfish/actions.js

@@ -0,0 +1,19 @@
+import { defineProviderAction } from "../../core/provider-definition.js";
+import { agentEndpoints } from "./agent-actions.js";
+import { dataEndpoints } from "./data-actions.js";
+import { managementEndpoints } from "./management-actions.js";
+const actionLifecycles = {
+    submit_run: { startActionId: "tinyfish.submit_run", statusActionId: "tinyfish.get_run" },
+    start_research: { startActionId: "tinyfish.start_research", statusActionId: "tinyfish.get_research_run" },
+};
+const tinyfishEndpoints = [...agentEndpoints, ...dataEndpoints, ...managementEndpoints];
+export const tinyfishEndpointByName = new Map(tinyfishEndpoints.map((endpoint) => [endpoint.name, endpoint]));
+export const tinyfishActions = tinyfishEndpoints.map((endpoint) => defineProviderAction("tinyfish", {
+    name: endpoint.name,
+    description: endpoint.description,
+    operationType: endpoint.operationType,
+    requiredScopes: [],
+    inputSchema: endpoint.inputSchema,
+    outputSchema: endpoint.outputSchema,
+    asyncLifecycle: actionLifecycles[endpoint.name],
+}));

package/src/providers/tinyfish/agent-actions.d.ts

@@ -0,0 +1,2 @@
+import type { TinyfishEndpoint } from "./endpoints.ts";
+export declare const agentEndpoints: TinyfishEndpoint[];

package/src/providers/tinyfish/agent-actions.js

@@ -0,0 +1,268 @@
+import { s } from "../../core/json-schema.js";
+const runStatus = s.stringEnum("Current automation run status.", [
+    "PENDING",
+    "RUNNING",
+    "COMPLETED",
+    "FAILED",
+    "CANCELLED",
+]);
+const runId = s.nonEmptyString("Automation run ID.", { pattern: "^[A-Za-z0-9_-]+$" });
+const outputSchema = s.record("Provider-supported structured-output schema subset. Unsupported schema keywords are rejected by TinyFish.", true);
+const profileId = s.nonEmptyString("Browser Context Profile ID to use when use_profile is true.");
+const runProperties = {
+    url: s.url("Target website URL to automate."),
+    goal: s.nonEmptyString("Natural language description of the task to perform on the website."),
+    browser_profile: s.stringEnum("Browser profile: lite uses a standard browser; stealth enables anti-detection.", [
+        "lite",
+        "stealth",
+    ]),
+    api_integration: s.string("Integration name used for analytics."),
+    agent_config: s.object("Agent behavior configuration.", {
+        mode: s.stringEnum("Strict mode enables fail-fast behavior for test automation.", ["default", "strict"]),
+        cursor_style: s.stringEnum("Browser agent cursor style.", ["fish", "standard", "green-pointer"]),
+        max_steps: s.integer("Maximum tool-call steps; the provider default is 150.", {
+            minimum: 1,
+            maximum: 500,
+        }),
+        max_duration_seconds: s.integer("Maximum wall-clock execution time in seconds. Omit for no limit.", {
+            minimum: 1,
+        }),
+    }, { required: [] }),
+    capture_config: s.object("Data to capture during the run.", {
+        elements: s.boolean("Capture page elements."),
+        snapshots: s.boolean("Capture browser snapshots."),
+        screenshots: s.boolean("Capture screenshots."),
+        recording: s.boolean("Record the browser session."),
+        html: s.boolean("Capture full-page HTML snapshots."),
+    }, { required: [] }),
+    webhook_url: s.url("HTTPS URL for run lifecycle webhook notifications."),
+    use_vault: s.boolean("Use enabled vault credentials for this run. Defaults to false."),
+    use_profile: s.boolean("Use a Browser Context Profile. If profiles are enabled and no profile_id is given, a default profile must exist. Legacy calls are ignored when profiles are disabled."),
+    credential_item_ids: s.stringArray("Credential URIs to use. Requires use_vault=true; omit to use all enabled items.", { minItems: 1, itemDescription: "Vault credential URI." }),
+    proxy_config: s.object("Browser proxy configuration.", {
+        enabled: s.boolean("Enable a proxy for this run."),
+        country_code: s.string("Proxy exit country as ISO 3166-1 alpha-2; defaults to US."),
+    }, { required: ["enabled"] }),
+};
+const runInput = s.object("Browser automation task parameters.", {
+    ...runProperties,
+    profile_id: profileId,
+    output_schema: outputSchema,
+}, { required: ["url", "goal"] });
+const errorSchema = s.nullable(s.looseObject("Provider error details, including retry guidance and profile setup hints.", {
+    code: s.string("Machine-readable error code."),
+    message: s.string("Human-readable error message."),
+    category: s.string("Error category: SYSTEM_FAILURE, AGENT_FAILURE, BILLING_FAILURE, or UNKNOWN."),
+    retry_after: s.nullableNumber("Suggested retry delay in seconds, or null when not retryable."),
+    help_url: s.string("Troubleshooting documentation URL."),
+    help_message: s.string("Troubleshooting guidance."),
+    details: { description: "Additional provider error details, including validation errors." },
+}));
+const profileHint = s.looseObject("Profile setup guidance for authentication walls or bot challenges.", {
+    message: s.string("Human-readable setup guidance."),
+    setup_url: s.string("Profile setup URL."),
+    reason: s.string("Reason a profile may help: auth_wall or bot_challenge."),
+});
+const runSummaryProperties = {
+    run_id: runId,
+    status: runStatus,
+    goal: s.string("Natural language goal for this automation run."),
+    created_at: s.string("Run creation timestamp."),
+    started_at: s.nullableString("Run start timestamp, or null before execution."),
+    finished_at: s.nullableString("Run completion timestamp, or null before completion."),
+    num_of_steps: s.nullableInteger("Number of automation steps; null while in progress.", {
+        minimum: 0,
+    }),
+    result: s.nullable(s.record("Extracted structured result.", true)),
+    output_schema: s.nullable(outputSchema),
+    profile_attached: s.boolean("Whether a Browser Context Profile was attached."),
+    profile_id: s.nullableString("Attached Browser Context Profile ID, or null."),
+    error: errorSchema,
+    profile_hint: profileHint,
+    streaming_url: s.nullableString("Live browser session URL, available while running."),
+    browser_config: s.nullable(s.looseObject("Browser configuration used by the run.", {
+        proxy_enabled: s.nullableBoolean("Whether a proxy was enabled."),
+        proxy_country_code: s.nullableString("Proxy exit country code."),
+    })),
+};
+const runDetail = s.object("Automation run details and captured steps.", {
+    ...runSummaryProperties,
+    video_url: s.nullableString("Presigned recording URL, expiring after 15 minutes, or null."),
+    steps: s.array("Steps performed during this run.", s.looseObject("An automation step.", {
+        id: s.string("Step event ID."),
+        timestamp: s.string("Step timestamp."),
+        status: runStatus,
+        action: s.nullableString("Description of the performed action."),
+        screenshot: s.nullableString("Screenshot URL or data URI according to the requested delivery mode, or null."),
+        html: s.nullableString("HTML snapshot URL, or null. Requires capture_config.html when submitting."),
+        duration: s.nullableString("Step duration."),
+    })),
+}, {
+    required: ["run_id", "status"],
+    additionalProperties: true,
+});
+const cancellation = s.looseObject("Cancellation result; terminal runs retain their existing status.", {
+    run_id: runId,
+    status: s.stringEnum("Final run status.", ["CANCELLED", "COMPLETED", "FAILED"]),
+    cancelled_at: s.nullableString("Cancellation timestamp, or null when not cancelled."),
+    message: s.nullableString("Additional cancellation context."),
+});
+const batchIds = s.requiredObject("Run IDs to retrieve or cancel.", {
+    run_ids: s.stringArray("Run IDs.", {
+        minItems: 1,
+        maxItems: 100,
+        itemDescription: "Automation run ID.",
+    }),
+});
+const notFound = s.nullable(s.stringArray("Run IDs not found or not owned; null if all were found.", {
+    itemDescription: "Unresolved run ID.",
+}));
+const fileOutput = s.requiredObject("Captured file uploaded to file transit.", {
+    url: s.url("Download URL of the captured file."),
+    mimeType: s.string("Captured file MIME type."),
+});
+const stepInput = s.requiredObject("Run and captured step identifiers.", {
+    id: runId,
+    stepId: s.nonEmptyString("Step event ID.", { pattern: "^[A-Za-z0-9_-]+$" }),
+});
+export const agentEndpoints = [
+    {
+        name: "submit_run",
+        description: "Submit a browser automation task asynchronously. The agent can perform arbitrary website operations; use get_run to retrieve progress and results.",
+        operationType: "destructive",
+        origin: "main",
+        method: "POST",
+        path: "/v1/automation/run-async",
+        inputSchema: runInput,
+        outputSchema: s.looseObject("Asynchronous automation submission.", {
+            run_id: s.nullableString("Created run ID; null if creation failed."),
+            error: errorSchema,
+        }),
+    },
+    {
+        name: "submit_run_batch",
+        description: "Atomically submit 1–100 browser automation tasks. Shared profile_id and output_schema apply to the batch. Retrieve each run using get_run or get_runs.",
+        operationType: "destructive",
+        origin: "main",
+        method: "POST",
+        path: "/v1/automation/run-batch",
+        inputSchema: s.object("Batch automation parameters.", {
+            runs: s.array("Automation tasks.", s.object("One automation task.", runProperties, { required: ["url", "goal"] }), { minItems: 1, maxItems: 100 }),
+            profile_id: profileId,
+            output_schema: outputSchema,
+        }, { required: ["runs"] }),
+        outputSchema: s.looseObject("Atomic batch submission result.", {
+            run_ids: s.nullable(s.stringArray("Created run IDs, or null on failure.", {
+                itemDescription: "Created run ID.",
+            })),
+            error: errorSchema,
+        }),
+    },
+    {
+        name: "list_runs",
+        description: "List and search automation runs with cursor pagination, status, goal, and creation-time filters.",
+        operationType: "read",
+        origin: "main",
+        method: "GET",
+        path: "/v1/runs",
+        queryKeys: ["status", "goal", "created_after", "created_before", "sort_direction", "cursor", "limit"],
+        inputSchema: s.object("Run search and pagination parameters.", {
+            status: runStatus,
+            goal: s.string("Case-insensitive partial goal text filter.", { maxLength: 500 }),
+            created_after: s.string("Filter runs created after this ISO 8601 timestamp.", {
+                format: "date-time",
+            }),
+            created_before: s.string("Filter runs created before this ISO 8601 timestamp.", {
+                format: "date-time",
+            }),
+            sort_direction: s.stringEnum("Sort order by creation time; defaults to desc.", ["asc", "desc"]),
+            cursor: s.string("Pagination cursor from the previous response."),
+            limit: s.integer("Maximum results; defaults to 20.", { minimum: 1, maximum: 100 }),
+        }, { required: [] }),
+        outputSchema: s.looseObject("Paginated automation runs.", {
+            data: s.array("Run summaries without steps and video URLs.", s.looseObject("Automation run summary.", runSummaryProperties)),
+            pagination: s.looseObject("Pagination information.", {
+                total: s.integer("Total matching runs."),
+                next_cursor: s.nullableString("Next-page cursor; null on the last page."),
+                has_more: s.boolean("Whether more results exist."),
+            }),
+        }),
+    },
+    {
+        name: "get_runs",
+        description: "Retrieve up to 100 automation runs, including per-run results, steps, and missing IDs.",
+        operationType: "read",
+        origin: "main",
+        method: "POST",
+        path: "/v1/runs/batch",
+        inputSchema: batchIds,
+        outputSchema: s.looseObject("Batch run retrieval result.", {
+            data: s.array("Found automation runs.", runDetail),
+            not_found: notFound,
+        }),
+    },
+    {
+        name: "cancel_runs",
+        description: "Cancel up to 100 automation runs. Already terminal runs retain their existing status; missing IDs are returned separately.",
+        operationType: "destructive",
+        origin: "main",
+        method: "POST",
+        path: "/v1/runs/batch/cancel",
+        inputSchema: batchIds,
+        outputSchema: s.looseObject("Batch cancellation result.", {
+            results: s.array("Per-run cancellation results.", cancellation),
+            not_found: notFound,
+        }),
+    },
+    {
+        name: "get_run",
+        description: "Retrieve an automation run and captured steps. Prefer screenshot URLs for JSON clients; use get_step_screenshot or get_step_html to transfer captured files.",
+        operationType: "read",
+        origin: "main",
+        method: "GET",
+        path: "/v1/runs/{id}",
+        pathKeys: ["id"],
+        queryKeys: ["screenshots", "html"],
+        inputSchema: s.object("Run details and capture delivery options.", {
+            id: runId,
+            screenshots: s.stringEnum("Screenshot delivery mode; defaults to url. Base64 embeds potentially large data URIs.", ["base64", "url", "none"]),
+            html: s.stringEnum("HTML snapshot delivery mode; defaults to url and requires capture_config.html at submission.", ["url", "none"]),
+        }, { required: ["id"] }),
+        outputSchema: runDetail,
+    },
+    {
+        name: "cancel_run",
+        description: "Cancel an asynchronous automation run. Already terminal runs retain their status. Runs started through the synchronous API cannot be cancelled.",
+        operationType: "destructive",
+        origin: "main",
+        method: "POST",
+        path: "/v1/runs/{id}/cancel",
+        pathKeys: ["id"],
+        inputSchema: s.requiredObject("Run to cancel.", { id: runId }),
+        outputSchema: cancellation,
+    },
+    {
+        name: "get_step_screenshot",
+        description: "Download a captured automation-step screenshot and return a file-transit URL.",
+        operationType: "read",
+        origin: "main",
+        method: "GET",
+        path: "/v1/runs/{id}/steps/{stepId}/screenshot",
+        pathKeys: ["id", "stepId"],
+        inputSchema: stepInput,
+        outputSchema: fileOutput,
+        responseType: "screenshot",
+    },
+    {
+        name: "get_step_html",
+        description: "Download a captured automation-step HTML snapshot and return a file-transit URL. Requires capture_config.html when submitting the run.",
+        operationType: "read",
+        origin: "main",
+        method: "GET",
+        path: "/v1/runs/{id}/steps/{stepId}/html",
+        pathKeys: ["id", "stepId"],
+        inputSchema: stepInput,
+        outputSchema: fileOutput,
+        responseType: "html",
+    },
+];

package/src/providers/tinyfish/data-actions.d.ts

@@ -0,0 +1,2 @@
+import type { TinyfishEndpoint } from "./endpoints.ts";
+export declare const dataEndpoints: TinyfishEndpoint[];