@oomol-lab/open-connector 1.9.2 → 1.9.3

package/src/providers/scopus/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, ProviderRequestError, providerUserAgent, readProviderTextBody, requiredInputString, setSearchParams, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, ProviderRequestError, providerUserAgent, readProviderTextBody, requiredInputString, setSearchParams, providerInputError, providerResponseError, } from "../provider-runtime.js";
 export const scopusApiBaseUrl = "https://api.elsevier.com/content";
 export const scopusActionHandlers = {
     async search_documents(input, context) {
@@ -229,7 +229,7 @@ function createScopusError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 401 || status === 403) {
         return new ProviderRequestError(status, message);
@@ -237,7 +237,7 @@ function createScopusError(status, payload, phase) {
     if (status >= 400 && status < 500) {
         return new ProviderRequestError(status, message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function extractScopusErrorMessage(payload) {
     if (typeof payload === "string") {

package/src/providers/scrape_do/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError, providerUserAgent, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError, providerUserAgent, providerInputError, } from "../provider-runtime.js";
 const service = "scrape_do";
 const scrapeDoApiBaseUrl = "https://api.scrape.do";
 const scrapeDoInfoUrl = `${scrapeDoApiBaseUrl}/info`;
@@ -220,7 +220,7 @@ function createScrapeDoError(status, body, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/scraperapi/runtime.js

@@ -1,6 +1,6 @@
 import { compactObject, optionalBoolean, optionalNumber, optionalRecord, optionalRawString, optionalString, } from "../../core/cast.js";
 import { assertPublicHttpUrl, readBoundedResponseBytes } from "../../core/request.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 export const scraperapiApiBaseUrl = "https://api.scraperapi.com/";
 const scraperapiAccountUrl = "https://api.scraperapi.com/account";
 const scraperapiRequestTimeoutMs = 80_000;
@@ -102,7 +102,7 @@ async function requestScraperapiUrl(url, query, init, context, phase) {
 function buildScraperapiUrl(url, query, apiKey) {
     const requestUrl = assertPublicHttpUrl(url, {
         fieldName: "url",
-        createError: (message) => new ProviderRequestError(400, message),
+        createError: providerInputError,
     });
     requestUrl.searchParams.set("api_key", apiKey);
     for (const [key, value] of Object.entries(query)) {
@@ -190,13 +190,13 @@ function createScraperapiError(status, body, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && status === 401) {
         return new ProviderRequestError(401, message);
     }
     if (phase === "execute" && status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/scrapfly/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRawString, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError, providerUserAgent, requiredInputString, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError, providerUserAgent, requiredInputString, providerInputError, } from "../provider-runtime.js";
 const service = "scrapfly";
 const scrapflyApiBaseUrl = "https://api.scrapfly.io";
 const scrapflyScrapeApiUrl = `${scrapflyApiBaseUrl}/scrape`;
@@ -203,7 +203,7 @@ function createScrapflyError(status, body, headers, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/scrapingant/executors.js

@@ -1,9 +1,8 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRawString, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError, providerUserAgent, requiredInputString, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError, providerUserAgent, requiredInputString, providerInputError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "scrapingant";
 const scrapingantApiOrigin = "https://api.scrapingant.com";
 const scrapingantApiBaseUrl = `${scrapingantApiOrigin}/v2`;
-const scrapingantDefaultTimeoutMs = 30_000;
 export const scrapingantActionHandlers = {
     scrape_with_extended_json_output(input, context) {
         return requestScrapingantExtended(input, context);
@@ -138,15 +137,15 @@ function buildScrapingantBody(input) {
 function buildConnectorTimeoutMs(input) {
     const timeoutSeconds = optionalInteger(input.timeout);
     return timeoutSeconds === undefined
-        ? scrapingantDefaultTimeoutMs
-        : Math.max(scrapingantDefaultTimeoutMs, timeoutSeconds * 1000 + 10_000);
+        ? defaultProviderRequestTimeoutMs
+        : Math.max(defaultProviderRequestTimeoutMs, timeoutSeconds * 1000 + 10_000);
 }
 function resolveScrapingantMethod(input) {
     return optionalString(input.method) ?? "GET";
 }
 async function requestScrapingantJson(input) {
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), input.timeoutMs ?? scrapingantDefaultTimeoutMs);
+    const timeout = setTimeout(() => controller.abort(), input.timeoutMs ?? defaultProviderRequestTimeoutMs);
     const signal = mergeAbortSignals(controller.signal, input.context.signal);
     try {
         const response = await input.context.fetcher(buildScrapingantUrl(input.path, input.query), {
@@ -291,13 +290,13 @@ function createScrapingantError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && status === 403) {
         return new ProviderRequestError(403, message);
     }
     if (phase === "execute" && (status === 400 || status === 404 || status === 405 || status === 422)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/scrapingbee/executors.js

@@ -1,5 +1,5 @@
 import { booleanString, compactObject, optionalRecord, requiredString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, ProviderRequestError, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const service = "scrapingbee";
 const scrapingbeeApiOrigin = "https://app.scrapingbee.com";
 const scrapingbeeApiBasePath = "/api/v1/";
@@ -140,7 +140,7 @@ function parseScrapingbeeUsage(payload) {
 function createScrapingbeeError(status, body, phase) {
     const message = extractErrorMessage(body) ?? `ScrapingBee request failed with status ${status}`;
     if (phase === "validate" && [400, 401, 403].includes(status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }
@@ -168,7 +168,7 @@ function parseScrapingbeeJson(body, invalidMessage) {
         return JSON.parse(body);
     }
     catch {
-        throw new ProviderRequestError(502, invalidMessage);
+        throw providerResponseError(invalidMessage);
     }
 }
 function readRequiredUrl(value) {

package/src/providers/scrapingdog/executors.js

@@ -169,7 +169,7 @@ function buildScrapingdogUrl(path, query, apiKey) {
 function createScrapingdogError(status, body, phase) {
     const message = extractScrapingdogMessage(body) ?? `Scrapingdog request failed with ${status}`;
     if (phase === "validate" && [400, 401, 403].includes(status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 403) {
         return new ProviderRequestError(429, message);

package/src/providers/screenshot_fyi/executors.js

@@ -1,9 +1,8 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, providerInputError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "screenshot_fyi";
 const screenshotFyiApiBaseUrl = "https://www.screenshot.fyi";
 const screenshotFyiCapturePath = "/api/take";
-const screenshotFyiDefaultRequestTimeoutMs = 30_000;
 const screenshotFyiValidationUrl = "https://example.com";
 export const screenshotFyiActionHandlers = {
     async take_screenshot(input, context) {
@@ -68,7 +67,7 @@ function buildTakeScreenshotQuery(input) {
     });
 }
 async function requestScreenshotFyiJson(input) {
-    const timeout = createTimeoutSignal(input.context.signal, screenshotFyiDefaultRequestTimeoutMs);
+    const timeout = createTimeoutSignal(input.context.signal, defaultProviderRequestTimeoutMs);
     try {
         const response = await input.context.fetcher(buildScreenshotFyiUrl(input.apiKey, input.query), {
             method: "GET",
@@ -131,7 +130,7 @@ function parseScreenshotFyiCapturePayload(payload) {
 function createScreenshotFyiError(response, payload, phase) {
     const message = extractScreenshotFyiErrorMessage(payload) ?? `screenshot.fyi request failed with status ${response.status}`;
     if (phase === "validate" && response.status >= 400 && response.status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 500, message);
 }

package/src/providers/screenshotbase/runtime.js

@@ -1,5 +1,5 @@
 import { optionalBoolean, optionalInteger, optionalNumber, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, ProviderRequestError, providerUserAgent, requiredResponseRecord, } from "../provider-runtime.js";
+import { createProviderTimeout, ProviderRequestError, providerUserAgent, requiredResponseRecord, providerInputError, } from "../provider-runtime.js";
 export const screenshotbaseApiBaseUrl = "https://api.screenshotbase.com";
 const screenshotbaseStatusPath = "/v1/status";
 const screenshotbaseTakePath = "/v1/take";
@@ -144,13 +144,13 @@ function createScreenshotbaseError(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);
     }
     if (status === 400 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 408) {
         return new ProviderRequestError(504, message);

package/src/providers/search_api/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalNumber, optionalRecord, optionalString } from "../../core/cast.js";
-import { providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, providerInputError } from "../provider-runtime.js";
 const searchApiOrigin = "https://www.searchapi.io";
 const searchApiBasePath = "/api/v1/";
 export const searchApiBaseUrl = "https://www.searchapi.io/api/v1";
@@ -201,7 +201,7 @@ async function readJsonPayload(response) {
 function createSearchApiError(status, payload, phase) {
     const message = extractSearchApiMessage(payload) ?? `SearchApi request failed with ${status || 500}`;
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/securitytrails/executors.js

@@ -1,5 +1,5 @@
 import { optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const service = "securitytrails";
 const securitytrailsApiBaseUrl = "https://api.securitytrails.com";
 export const securitytrailsActionHandlers = {
@@ -117,7 +117,7 @@ async function readSecuritytrailsPayload(response) {
 function buildSecuritytrailsError(status, payload, phase) {
     const message = readSecuritytrailsMessage(payload) ?? `SecurityTrails request failed with ${status || 500}`;
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/semantic_scholar/executors.js

@@ -1,6 +1,6 @@
 import { compactObject, looseArray, optionalRawString, optionalRecord, rawStringOrNull, recordOrEmpty, } from "../../core/cast.js";
 import { encodePathSegment } from "../../core/request.js";
-import { defineProviderExecutors, defineProviderProxy, mapProviderActionSources, providerProxyEndpointPrefixes, ProviderRequestError, providerUserAgent, requireApiKeyCredential, runProviderRequest, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, mapProviderActionSources, providerProxyEndpointPrefixes, ProviderRequestError, providerUserAgent, requireApiKeyCredential, runProviderRequest, providerInputError, } from "../provider-runtime.js";
 const service = "semantic_scholar";
 const graphApiBaseUrl = "https://api.semanticscholar.org/graph/v1";
 const recommendationsApiBaseUrl = "https://api.semanticscholar.org/recommendations/v1";
@@ -331,7 +331,7 @@ function createSemanticScholarError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(401, message);

package/src/providers/sendbird/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalRawString, pickOptionalString } from "../../core/cast.js";
-import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, providerInputError, } from "../provider-runtime.js";
 const sendbirdUserAgent = providerUserAgent;
 const sendbirdValidationPath = "/applications/settings_global";
 export const sendbirdActionHandlers = {
@@ -510,7 +510,7 @@ function createSendbirdError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 400 || response.status === 404) {
         return new ProviderRequestError(response.status, message);

package/src/providers/sendfox/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalNumber, optionalRawString, optionalRecord } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const sendfoxApiBaseUrl = "https://api.sendfox.com";
 export const sendfoxActionHandlers = {
     list_contacts(input, context) {
@@ -235,7 +235,7 @@ function createSendfoxError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 401) {
         return new ProviderRequestError(401, message);
@@ -244,7 +244,7 @@ function createSendfoxError(response, payload, phase) {
         return new ProviderRequestError(403, message);
     }
     if (response.status === 404 || response.status === 400 || response.status === 409 || response.status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status >= 500 ? 502 : response.status, message);
 }

package/src/providers/sendgrid/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalNumber, optionalRawString, optionalRecord } from "../../core/cast.js";
-import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, requireApiKeyCredential, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const sendgridDefaultBaseUrl = "https://api.sendgrid.com";
 const sendgridTemplatesPath = "/v3/templates";
 const sendgridMailSendPath = "/v3/mail/send";
@@ -363,13 +363,13 @@ function sendgridHeaders(apiKey, hasBody) {
 function mapSendgridError(status, message, mode) {
     if (status === 401) {
         if (mode === "validate") {
-            return new ProviderRequestError(400, message);
+            return providerInputError(message);
         }
         return new ProviderRequestError(401, message);
     }
     if (status === 403) {
         if (mode === "validate") {
-            return new ProviderRequestError(400, message);
+            return providerInputError(message);
         }
         return new ProviderRequestError(403, message);
     }
@@ -377,9 +377,9 @@ function mapSendgridError(status, message, mode) {
         return new ProviderRequestError(429, message);
     }
     if (status === 400 || status === 404) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 async function readSendgridError(response) {
     try {

package/src/providers/sendmator/runtime.js

@@ -1,7 +1,6 @@
 import { compactObject, optionalBoolean, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 export const sendmatorApiBaseUrl = "https://api.sendmator.com/api/v1";
-const sendmatorDefaultRequestTimeoutMs = 30_000;
 export const sendmatorActionHandlers = {
     list_contacts(input, context) {
         return executeListContacts(input, context);
@@ -126,7 +125,7 @@ async function requestSendmatorJson(input) {
     if (input.body) {
         headers["content-type"] = "application/json";
     }
-    const timeout = createProviderTimeout(input.signal, sendmatorDefaultRequestTimeoutMs);
+    const timeout = createProviderTimeout(input.signal);
     let response;
     try {
         response = await input.fetcher(url.toString(), {
@@ -138,7 +137,7 @@ async function requestSendmatorJson(input) {
     }
     catch (error) {
         throw new ProviderRequestError(502, timeout.didTimeout() || isAbortLikeError(error)
-            ? `sendmator request timed out after ${sendmatorDefaultRequestTimeoutMs}ms`
+            ? `sendmator request timed out after ${defaultProviderRequestTimeoutMs}ms`
             : `sendmator request failed: ${error instanceof Error ? error.message : "Unknown transport error"}`);
     }
     finally {

package/src/providers/seqera/runtime.js

@@ -1,9 +1,8 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
 import { assertPublicHttpUrl, isPrivateNetworkAccessAllowed } from "../../core/request.js";
-import { createProviderTimeout, defineProviderExecutors, isAbortLikeError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, requiredResponseRecord, } from "../provider-runtime.js";
+import { createProviderTimeout, defineProviderExecutors, isAbortLikeError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, requiredResponseRecord, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "seqera";
 const defaultSeqeraApiBaseUrl = "https://api.cloud.seqera.io";
-const seqeraRequestTimeoutMs = 30_000;
 const seqeraValidationEndpoint = "/user-info";
 export const seqeraActionHandlers = {
     get_current_user(_input, context) {
@@ -263,7 +262,7 @@ async function seqeraFetch(input) {
         headers.set("Content-Type", "application/json");
         body = JSON.stringify(input.body);
     }
-    const timeout = createProviderTimeout(input.signal, seqeraRequestTimeoutMs);
+    const timeout = createProviderTimeout(input.signal);
     try {
         return await input.fetcher(url, {
             method: input.method ?? "GET",
@@ -274,7 +273,7 @@ async function seqeraFetch(input) {
     }
     catch (error) {
         if (timeout.didTimeout() || isAbortLikeError(error)) {
-            throw new ProviderRequestError(502, `seqera ${input.path} request timed out after ${Math.max(1, Math.ceil(seqeraRequestTimeoutMs / 1000))} seconds`);
+            throw new ProviderRequestError(502, `seqera ${input.path} request timed out after ${Math.max(1, Math.ceil(defaultProviderRequestTimeoutMs / 1000))} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? error.message : "Seqera request failed");
     }

package/src/providers/serveravatar/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderJsonBody, } from "../provider-runtime.js";
+import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderJsonBody, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const service = "serveravatar";
 const serverAvatarApiBaseUrl = "https://api.serveravatar.com";
 export const serverAvatarActionHandlers = {
@@ -140,12 +140,12 @@ function mapServerAvatarError(status, payload, phase) {
         return new ProviderRequestError(401, message);
     }
     if (status === 400 || status === 404 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 429) {
         return new ProviderRequestError(429, message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function extractServerAvatarErrorMessage(payload) {
     if (typeof payload === "string" && payload.trim()) {

package/src/providers/sheetdb/runtime.js

@@ -1,5 +1,5 @@
 import { optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 export const sheetDbApiBaseUrl = "https://sheetdb.io";
 export const sheetDbActionHandlers = {
     list_rows(input, context) {
@@ -252,7 +252,7 @@ function mapSheetDbError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (status === 400 || status === 404 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/short_menu/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError } from "../provider-runtime.js";
 const shortMenuApiBaseUrl = "https://api.shortmenu.com";
 const shortMenuValidationPath = "/links";
 export const shortMenuActionHandlers = {
@@ -145,13 +145,13 @@ async function toShortMenuError(response, phase, notFoundAsInvalidInput) {
         return new ProviderRequestError(phase === "validate" ? 400 : 401, message);
     }
     if (response.status === 404 && notFoundAsInvalidInput) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 400 && errorCode === "LINK_LIMIT_REACHED") {
         return new ProviderRequestError(429, message);
     }
     if (response.status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 502, message);
 }

package/src/providers/shortcut/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { providerFetch, ProviderRequestError, providerUserAgent, requiredResponseRecord } from "../provider-runtime.js";
+import { providerFetch, ProviderRequestError, providerUserAgent, requiredResponseRecord, providerInputError, } from "../provider-runtime.js";
 export const shortcutApiBaseUrl = "https://api.app.shortcut.com/api/v3/";
 const shortcutValidatePath = "member";
 export const shortcutActionHandlers = {
@@ -297,13 +297,13 @@ function createShortcutError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && [400, 401, 403, 404].includes(status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (status === 401 || status === 403)) {
         return new ProviderRequestError(401, message);
     }
     if (phase === "execute" && [400, 404, 422].includes(status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/shortpixel/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent, runProviderRequest } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, runProviderRequest, providerInputError, } from "../provider-runtime.js";
 const shortpixelAccountApiBaseUrl = "https://api.shortpixel.com/v2";
 const shortpixelCdnApiBaseUrl = "https://no-cdn.shortpixel.ai";
 export const shortpixelActionHandlers = {
@@ -110,7 +110,7 @@ function createShortpixelHttpError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && (status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/shotstack/runtime.js

@@ -1,6 +1,6 @@
 import { optionalBoolean, optionalNumber, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
 import { jsonObject } from "../../core/request.js";
-import { createProviderTimeout, providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const shotstackApiBaseUrl = "https://api.shotstack.io/edit/v1";
 export const shotstackProxyBaseUrl = "https://api.shotstack.io";
 export const shotstackActionHandlers = {
@@ -54,7 +54,7 @@ async function renderEdit(input, context) {
     return { render: { id, message } };
 }
 async function getRender(input, context) {
-    const id = requiredString(input.id, "id", (message) => new ProviderRequestError(400, message));
+    const id = requiredString(input.id, "id", providerInputError);
     const query = new URLSearchParams();
     const data = optionalBoolean(input.data);
     const merged = optionalBoolean(input.merged);
@@ -164,13 +164,13 @@ function createShotstackError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (phase === "validate" && response.status >= 400 && response.status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (phase === "execute" && (response.status === 401 || response.status === 403)) {
         return new ProviderRequestError(401, message);
     }
     if (response.status >= 400 && response.status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 502, message);
 }

package/src/providers/signpath/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, defineProviderExecutors, ProviderRequestError, providerUserAgent, requireApiKeyCredential, } from "../provider-runtime.js";
+import { createProviderTimeout, defineProviderExecutors, ProviderRequestError, providerUserAgent, requireApiKeyCredential, providerInputError, } from "../provider-runtime.js";
 export const signpathApiBaseUrl = "https://app.signpath.io/api/v1";
 export const signpathActionHandlers = {
     async list_signing_policies(input, context) {
@@ -152,7 +152,7 @@ function createSignpathError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 502, message);
 }

package/src/providers/signwell/runtime.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalBoolean, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerUserAgent, ProviderRequestError, providerInputError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const signwellApiBaseUrl = "https://www.signwell.com";
 const signwellValidationPath = "/api/v1/me";
-const signwellDefaultTimeoutMs = 30_000;
 export const signwellActionHandlers = {
     get_me(_input, context) {
         return getMe(context);
@@ -205,7 +204,7 @@ function buildReminderRequestBody(input) {
     });
 }
 async function requestSignwellJson(input) {
-    const timeoutHandle = createProviderTimeout(input.signal, signwellDefaultTimeoutMs);
+    const timeoutHandle = createProviderTimeout(input.signal);
     try {
         const response = await input.fetcher(new URL(input.path, signwellApiBaseUrl), {
             method: input.method ?? "GET",
@@ -231,7 +230,7 @@ async function requestSignwellJson(input) {
             throw error;
         }
         if (timeoutHandle.didTimeout() || isAbortLikeError(error)) {
-            throw new ProviderRequestError(504, `SignWell request timed out after ${Math.max(1, Math.ceil(signwellDefaultTimeoutMs / 1000))} seconds`);
+            throw new ProviderRequestError(504, `SignWell request timed out after ${Math.max(1, Math.ceil(defaultProviderRequestTimeoutMs / 1000))} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? `SignWell request failed: ${error.message}` : "SignWell request failed");
     }
@@ -265,13 +264,13 @@ function createSignwellError(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);
     }
     if (status === 404 || status === 400 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status >= 400 && status < 500) {
         return new ProviderRequestError(status, message);