@oomol-lab/open-connector 1.9.2 → 1.9.3

package/src/providers/haveibeenpwned/executors.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalBoolean, optionalRecord, optionalString, rawStringOrNull, requiredString, } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerInputError, providerUserAgent, ProviderRequestError, requiredResponseRecord, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerInputError, providerUserAgent, ProviderRequestError, requiredResponseRecord, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "haveibeenpwned";
 const haveibeenpwnedApiBaseUrl = "https://haveibeenpwned.com/api/v3";
-const haveibeenpwnedDefaultRequestTimeoutMs = 30_000;
 export const haveibeenpwnedActionHandlers = {
     list_breaches(input, context) {
         return executeListBreaches(input, context);
@@ -165,7 +164,7 @@ async function executeGetSubscriptionStatus(context) {
     };
 }
 async function requestHaveIBeenPwnedJson(input) {
-    const timeoutSignal = AbortSignal.timeout(haveibeenpwnedDefaultRequestTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = input.signal ? AbortSignal.any([input.signal, timeoutSignal]) : timeoutSignal;
     try {
         const response = await input.fetcher(buildHaveIBeenPwnedUrl(input.path, input.query ?? {}), {

package/src/providers/headout/executors.js

@@ -1,10 +1,9 @@
 import { compactObject, optionalBoolean, optionalBooleanOrNull, optionalInteger, optionalNumber, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
-import { defineProviderExecutors, defineProviderProxy, isAbortLikeError, providerInputError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, requiredResponseRecord, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, isAbortLikeError, providerInputError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, requiredResponseRecord, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "headout";
 const headoutProductionApiBaseUrl = "https://www.headout.com/api/public/v1";
 const headoutSandboxApiBaseUrl = "https://sandbox.api.test-headout.com/api/public/v1";
 const headoutValidationPath = "/booking";
-const headoutDefaultTimeoutMs = 30_000;
 export const headoutActionHandlers = {
     async list_cities(input, context) {
         const payload = await requestHeadoutJson({
@@ -199,7 +198,7 @@ export const credentialValidators = {
 async function requestHeadoutJson(input) {
     const apiBaseUrl = input.context.apiBaseUrl ?? resolveHeadoutApiBaseUrl(input.context.apiKey);
     const url = buildHeadoutUrl(apiBaseUrl, input.path, input.query);
-    const timeoutSignal = AbortSignal.timeout(headoutDefaultTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = input.context.signal ? AbortSignal.any([input.context.signal, timeoutSignal]) : timeoutSignal;
     try {
         const response = await input.context.fetcher(url, {
@@ -222,7 +221,7 @@ async function requestHeadoutJson(input) {
             throw error;
         }
         if (isAbortLikeError(error)) {
-            throw new ProviderRequestError(502, `headout ${input.path} request timed out after ${Math.ceil(headoutDefaultTimeoutMs / 1000)} seconds`);
+            throw new ProviderRequestError(502, `headout ${input.path} request timed out after ${Math.ceil(defaultProviderRequestTimeoutMs / 1000)} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? error.message : `headout ${input.path} request failed`);
     }

package/src/providers/healthchecks_io/executors.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString, requiredString, } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerInputError, ProviderRequestError, providerUserAgent, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerInputError, ProviderRequestError, providerUserAgent, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "healthchecks_io";
 const healthchecksIoApiBaseUrl = "https://healthchecks.io/api/v3";
-const healthchecksIoDefaultRequestTimeoutMs = 30_000;
 export const healthchecksIoActionHandlers = {
     async list_checks(input, context) {
         const payload = await requestHealthchecksIoJson({
@@ -165,7 +164,7 @@ export const credentialValidators = {
     },
 };
 async function requestHealthchecksIoJson(input) {
-    const timeoutSignal = AbortSignal.timeout(healthchecksIoDefaultRequestTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = input.context.signal ? AbortSignal.any([input.context.signal, timeoutSignal]) : timeoutSignal;
     try {
         const response = await input.context.fetcher(buildHealthchecksIoUrl(input.path, input.query), {

package/src/providers/helium10/runtime.js

@@ -5,9 +5,8 @@ import { CfWorkerJsonSchemaValidator } from "@modelcontextprotocol/client/valida
 import { createHash } from "node:crypto";
 import { optionalRecord, requiredString } from "../../core/cast.js";
 import { withMcpClient } from "../mcp-client.js";
-import { providerInputError, providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { providerInputError, providerUserAgent, ProviderRequestError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 export const helium10McpEndpoint = "https://mcp.helium10.com/mcp";
-const requestTimeoutMs = 30_000;
 const validator = new CfWorkerJsonSchemaValidator();
 const readOnlyTools = new Set([
     "get_keywords_by_keyword",
@@ -65,14 +64,14 @@ export const helium10ActionHandlers = {
             throw new ProviderRequestError(400, `Helium 10 MCP tool is not available for this account: ${toolName}`);
         validateArguments(tool, args);
         const result = await withClient(context, (client) => client.callTool({ name: toolName, arguments: args }, {
-            timeout: requestTimeoutMs,
+            timeout: defaultProviderRequestTimeoutMs,
             signal: context.signal,
         }));
         return { result: normalizeResult(result) };
     },
 };
 export async function validateHelium10Credential(accessToken, fetcher, signal) {
-    const result = await withClient({ accessToken, fetcher, signal }, (client) => client.listTools({}, { timeout: requestTimeoutMs, signal }));
+    const result = await withClient({ accessToken, fetcher, signal }, (client) => client.listTools({}, { timeout: defaultProviderRequestTimeoutMs, signal }));
     if (!result.tools.some((tool) => readOnlyTools.has(tool.name))) {
         throw new ProviderRequestError(502, "Helium 10 MCP did not expose any approved read-only tools");
     }
@@ -84,7 +83,7 @@ export async function validateHelium10Credential(accessToken, fetcher, signal) {
     };
 }
 async function listTools(context) {
-    const result = await withClient(context, (client) => client.listTools({}, { timeout: requestTimeoutMs, signal: context.signal }));
+    const result = await withClient(context, (client) => client.listTools({}, { timeout: defaultProviderRequestTimeoutMs, signal: context.signal }));
     return result.tools.filter((tool) => readOnlyTools.has(tool.name));
 }
 async function withClient(context, run) {

package/src/providers/helpdesk/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, ProviderRequestError, providerUserAgent, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, ProviderRequestError, providerUserAgent, providerInputError, } from "../provider-runtime.js";
 export const helpdeskApiBaseUrl = "https://api.helpdesk.com";
 const helpdeskValidationEndpoint = "/v1/licenses";
 export const helpdeskActionHandlers = {
@@ -29,7 +29,7 @@ export const helpdeskActionHandlers = {
     },
 };
 export async function validateHelpdeskCredential(input, fetcher) {
-    const apiKey = requiredString(input.apiKey, "apiKey", (message) => new ProviderRequestError(400, message));
+    const apiKey = requiredString(input.apiKey, "apiKey", providerInputError);
     const accountId = requireHelpdeskAccountId(input);
     const { payload } = await requestHelpdesk({
         path: helpdeskValidationEndpoint,
@@ -356,13 +356,13 @@ function createHelpdeskError(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);
     }
     if (phase === "execute" && (status === 400 || status === 404 || status === 422)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status || 500, message);
 }

package/src/providers/home_assistant/runtime-ws.js

@@ -1,14 +1,13 @@
 import { compactObject, objectArray, optionalRecord, optionalString } from "../../core/cast.js";
 import { openGuardedWebSocket } from "../../core/guarded-websocket.js";
 import { isPrivateNetworkAccessAllowed } from "../../core/request.js";
-import { ProviderRequestError } from "../provider-runtime.js";
+import { ProviderRequestError, providerInputError, providerResponseError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 import { homeAssistantRegistryNames } from "./actions.js";
 import { readInputString } from "./runtime.js";
 /**
  * Deadline covering the whole session: handshake, authentication, and every
  * command in the batch. Matches the REST action timeout.
  */
-const homeAssistantWebSocketTimeoutMs = 30_000;
 const registryCommandTypes = {
     entities: "config/entity_registry/list",
     devices: "config/device_registry/list",
@@ -57,7 +56,7 @@ export const homeAssistantWebSocketActionHandlers = {
         const [payload] = await runHomeAssistantCommands(context, [
             {
                 type: "execute_script",
-                sequence: objectArray(input.sequence, "sequence", (message) => new ProviderRequestError(400, message)),
+                sequence: objectArray(input.sequence, "sequence", providerInputError),
                 ...compactObject({ variables: optionalRecord(input.variables) }),
             },
         ]);
@@ -92,12 +91,12 @@ async function runHomeAssistantCommands(context, commands) {
     // One deadline for the whole session. The handshake may use all of it, and the
     // command phase then gets whatever is left, so a slow instance cannot spend the
     // budget twice.
-    const deadline = Date.now() + homeAssistantWebSocketTimeoutMs;
+    const deadline = Date.now() + defaultProviderRequestTimeoutMs;
     const socket = await openGuardedWebSocket(buildWebSocketUrl(context.baseUrl), {
         allowPrivateNetwork: isPrivateNetworkAccessAllowed,
-        createError: (message) => new ProviderRequestError(400, message),
+        createError: providerInputError,
         createFailure: createConnectionError,
-        connectTimeoutMs: homeAssistantWebSocketTimeoutMs,
+        connectTimeoutMs: defaultProviderRequestTimeoutMs,
         signal: context.signal,
         fieldName: "Home Assistant base URL",
     });
@@ -260,7 +259,7 @@ function createConnectionError(kind, message) {
     if (kind === "timeout") {
         return new ProviderRequestError(504, "Home Assistant WebSocket connection timed out");
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 /**
  * Map a Home Assistant command error onto the runtime status codes callers
@@ -277,9 +276,9 @@ function createCommandError(error, commandType) {
         return new ProviderRequestError(404, message);
     }
     if (code === "invalid_format" || code === "id_reuse") {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function readRegistryNames(value) {
     if (value === undefined || value === null) {
@@ -307,7 +306,7 @@ function readOptionalConfigList(value, fieldName) {
     if (value === undefined || value === null) {
         return undefined;
     }
-    return objectArray(value, fieldName, (message) => new ProviderRequestError(400, message));
+    return objectArray(value, fieldName, providerInputError);
 }
 function closeQuietly(socket) {
     try {

package/src/providers/hotjar/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderFetch, createProviderProxyUrl, createProviderTimeout, defineProviderExecutors, normalizeProviderProxyHeaders, providerUserAgent, ProviderRequestError, readProviderProxyErrorMessage, readProviderProxyResponse, readProviderTextBody, requireCustomCredential, toProviderProxyError, } from "../provider-runtime.js";
+import { createProviderFetch, createProviderProxyUrl, createProviderTimeout, defineProviderExecutors, normalizeProviderProxyHeaders, providerUserAgent, ProviderRequestError, readProviderProxyErrorMessage, readProviderProxyResponse, readProviderTextBody, requireCustomCredential, toProviderProxyError, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const hotjarApiBaseUrl = "https://api.hotjar.io";
 const hotjarTokenUrl = `${hotjarApiBaseUrl}/v1/oauth/token`;
 const hotjarMaxResponseBytes = 10 * 1024 * 1024;
@@ -252,7 +252,7 @@ function readHotjarPage(payload, label) {
 function requireObject(value, message) {
     const object = optionalRecord(value);
     if (!object) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return object;
 }
@@ -282,7 +282,7 @@ function requiredString(value, fieldName) {
 function mapHotjarError(status, payload, phase, operation) {
     const message = readHotjarErrorMessage(payload) ?? `Hotjar ${operation} failed with status ${status}`;
     if (phase == "validate" && (status == 400 || status == 401 || status == 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     else if (status == 401 || (operation == "access token exchange" && (status == 400 || status == 403))) {
         return new ProviderRequestError(401, message);
@@ -297,7 +297,7 @@ function mapHotjarError(status, payload, phase, operation) {
         return new ProviderRequestError(status == 404 ? 404 : 400, message);
     }
     else {
-        return new ProviderRequestError(502, message);
+        return providerResponseError(message);
     }
 }
 function readHotjarErrorMessage(payload) {

package/src/providers/httpsms/runtime.js

@@ -1,8 +1,7 @@
 import { Validator } from "@cfworker/json-schema";
 import { createHash } from "node:crypto";
 import { compactObject, objectArray, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, providerUserAgent, ProviderRequestError, readProviderJsonBody, } from "../provider-runtime.js";
-const httpsmsRequestTimeoutMs = 30_000;
+import { createProviderTimeout, providerUserAgent, ProviderRequestError, readProviderJsonBody, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const httpsmsEmailValidator = new Validator({ type: "string", format: "email" }, "2020-12");
 export const httpsmsApiBaseUrl = "https://api.httpsms.com/v1";
 export const httpsmsActionHandlers = {
@@ -187,7 +186,7 @@ async function requestHttpsmsJson(input) {
     return payload;
 }
 async function requestHttpsmsRaw(input) {
-    const timeout = createProviderTimeout(input.signal, httpsmsRequestTimeoutMs);
+    const timeout = createProviderTimeout(input.signal);
     try {
         return await input.fetcher(buildHttpsmsUrl(input.path, input.query), {
             method: input.method,
@@ -201,7 +200,7 @@ async function requestHttpsmsRaw(input) {
             throw error;
         }
         if (timeout.didTimeout()) {
-            throw new ProviderRequestError(504, `httpSMS ${input.path} request timed out after ${Math.ceil(httpsmsRequestTimeoutMs / 1000)} seconds`);
+            throw new ProviderRequestError(504, `httpSMS ${input.path} request timed out after ${Math.ceil(defaultProviderRequestTimeoutMs / 1000)} seconds`);
         }
         const message = error instanceof Error && error.message.trim() ? error.message : "request failed";
         throw new ProviderRequestError(502, `httpSMS ${input.path} request failed: ${message}`);

package/src/providers/hub_planner/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderTextBody, requiredInputString, runProviderRequest, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderTextBody, requiredInputString, runProviderRequest, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const service = "hub_planner";
 const hubPlannerApiBaseUrl = "https://api.hubplanner.com/v1";
 const hubPlannerValidationPath = "/project";
@@ -213,9 +213,9 @@ function buildHubPlannerError(status, payload, phase) {
         return new ProviderRequestError(status, message);
     }
     if (status >= 400 && status < 500) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function extractHubPlannerErrorMessage(payload) {
     if (typeof payload === "string" && payload.trim()) {

package/src/providers/hubspot/runtime.js

@@ -4,9 +4,8 @@ import { ProtocolError } from "@modelcontextprotocol/client";
 import { createHash } from "node:crypto";
 import { compactObject } from "../../core/cast.js";
 import { withMcpClient } from "../mcp-client.js";
-import { providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, defaultProviderRequestTimeoutMs } from "../provider-runtime.js";
 export const hubspotMcpEndpoint = "https://mcp.hubspot.com/";
-const hubspotMcpRequestTimeoutMs = 30_000;
 const actionSpecs = new Map([
     ["search_contacts", { objectType: "contacts", operation: "search" }],
     ["get_contact", { objectType: "contacts", operation: "get" }],
@@ -306,7 +305,7 @@ async function listHubspotMcpTools(input) {
         headers,
         mapError: (error) => mapHubspotMcpError("hubspot", error),
     }, async (client) => {
-        const result = await client.listTools({}, { timeout: hubspotMcpRequestTimeoutMs });
+        const result = await client.listTools({}, { timeout: defaultProviderRequestTimeoutMs });
         if (!result.tools.some((tool) => directMcpToolNames.has(tool.name) || tool.name === "get_user_details")) {
             throw new ProviderRequestError(502, "hubspot MCP did not advertise any supported tools");
         }
@@ -319,7 +318,7 @@ async function callHubspotMcpTool(input) {
             bearerToken: input.accessToken,
             service: "hubspot",
             fetcher: input.fetcher,
-            requestTimeoutMs: hubspotMcpRequestTimeoutMs,
+            requestTimeoutMs: defaultProviderRequestTimeoutMs,
             toolName: input.toolName,
             arguments: input.arguments,
         });

package/src/providers/humaans/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError, providerResponseError, } from "../provider-runtime.js";
 export const humaansApiBaseUrl = "https://app.humaans.io/api";
 export const humaansValidationPath = "/token-info";
 export const humaansActionHandlers = {
@@ -123,7 +123,7 @@ async function readResponsePayload(response) {
 function mapHumaansError(status, payload, phase, inputErrorStatuses) {
     const message = extractErrorMessage(payload) ?? `Humaans API request failed with status ${status}`;
     if (status === 401) {
-        return phase === "validate" ? new ProviderRequestError(400, message) : new ProviderRequestError(401, message);
+        return phase === "validate" ? providerInputError(message) : new ProviderRequestError(401, message);
     }
     if (status === 403)
         return new ProviderRequestError(403, message);
@@ -132,7 +132,7 @@ function mapHumaansError(status, payload, phase, inputErrorStatuses) {
     }
     if (status === 429)
         return new ProviderRequestError(429, message);
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function extractErrorMessage(payload) {
     if (typeof payload === "string" && payload.trim())

package/src/providers/hunter/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, positiveInteger } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError } from "../provider-runtime.js";
 export const hunterApiBaseUrl = "https://api.hunter.io/v2";
 export const hunterActionHandlers = {
     account_information(_input, context) {
@@ -237,7 +237,7 @@ function buildListLeadsQuery(input) {
     return query;
 }
 function readHunterId(input) {
-    return positiveInteger(input.id, "id", (message) => new ProviderRequestError(400, message));
+    return positiveInteger(input.id, "id", providerInputError);
 }
 function omitFields(input, fields) {
     const omitted = new Set(fields);
@@ -261,7 +261,7 @@ async function readHunterErrorMessage(response) {
 }
 function mapHunterError(status, message, phase) {
     if (phase === "validate" && (status === 400 || status === 401 || status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status, message);
 }

package/src/providers/icypeas/executors.js

@@ -1,9 +1,8 @@
 import { optionalRecord, optionalString } from "../../core/cast.js";
 import { jsonObject } from "../../core/request.js";
-import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, requiredInputString, } from "../provider-runtime.js";
+import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, requiredInputString, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "icypeas";
 const icypeasApiBaseUrl = "https://app.icypeas.com/api";
-const icypeasRequestTimeoutMs = 30_000;
 const icypeasValidationPath = "/bulk-single-searchs/read";
 export const icypeasActionHandlers = {
     async get_subscription_information(input, context) {
@@ -111,7 +110,7 @@ async function validateIcypeasCredential(input, fetcher, signal) {
     };
 }
 async function requestIcypeasJson(input, context, mode) {
-    const timeout = createProviderTimeout(context.signal, icypeasRequestTimeoutMs);
+    const timeout = createProviderTimeout(context.signal);
     try {
         const response = await context.fetcher(buildIcypeasUrl(input.path), {
             method: "POST",
@@ -135,7 +134,7 @@ async function requestIcypeasJson(input, context, mode) {
             throw error;
         }
         if (timeout.didTimeout() || isAbortLikeError(error)) {
-            throw new ProviderRequestError(504, `Icypeas request timed out after ${Math.ceil(icypeasRequestTimeoutMs / 1000)} seconds`);
+            throw new ProviderRequestError(504, `Icypeas request timed out after ${Math.ceil(defaultProviderRequestTimeoutMs / 1000)} seconds`);
         }
         const message = error instanceof Error && error.message.trim() ? error.message : "request failed";
         throw new ProviderRequestError(502, `Icypeas request failed: ${message}`, error);

package/src/providers/ima/runtime.js

@@ -3,7 +3,7 @@ import { createHash, createHmac } from "node:crypto";
 import { basename, extname } from "node:path";
 import { compactObject, looseArray, optionalBoolean, optionalIntegerLike, optionalRecord, optionalString, } from "../../core/cast.js";
 import { assertPublicHttpUrl, readBoundedResponseBytes } from "../../core/request.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError, providerResponseError, } from "../provider-runtime.js";
 export const imaApiBaseUrl = "https://ima.qq.com";
 const defaultListLimit = 20;
 const maxImaDownloadBytes = 200 * 1024 * 1024;
@@ -440,7 +440,7 @@ async function uploadImaFileToKnowledgeBase(input, context) {
     const contentType = optionalString(input.contentType);
     const sourceUrl = assertPublicHttpUrl(requireImaField(input.fileUrl, "fileUrl"), {
         fieldName: "fileUrl",
-        createError: (message) => new ProviderRequestError(400, message),
+        createError: providerInputError,
     });
     const duplicatePolicy = optionalString(input.duplicatePolicy) ?? "fail";
     const downloaded = await downloadUrlBytes(sourceUrl, context);
@@ -628,7 +628,7 @@ async function getImaKnowledgeItemOriginal(input, context) {
     const bytes = await readBoundedResponseBytes(response, {
         maxBytes: maxImaDownloadBytes,
         fieldName: "IMA media URL",
-        createError: (message) => new ProviderRequestError(400, message),
+        createError: providerInputError,
     });
     const mimeType = response.headers.get("content-type") ?? "application/octet-stream";
     const name = optionalString(input.fileName) ?? inferFileNameFromUrl(mediaInfo.url, mimeType);
@@ -665,7 +665,7 @@ async function downloadUrlBytes(sourceUrl, context) {
         bytes: await readBoundedResponseBytes(response, {
             maxBytes: maxImaDownloadBytes,
             fieldName: "IMA upload source",
-            createError: (message) => new ProviderRequestError(400, message),
+            createError: providerInputError,
         }),
         contentType: response.headers.get("content-type") ?? undefined,
     };
@@ -714,9 +714,9 @@ function mapImaError(code, message, phase) {
         return new ProviderRequestError(phase === "validate" ? 400 : 401, message);
     }
     if (code != null && imaInvalidInputCodes.has(code)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function parseImaResponse(value) {
     if (!value) {
@@ -757,7 +757,7 @@ function requireImaText(value, fieldName) {
     throw new ProviderRequestError(400, `${fieldName} is required`);
 }
 function readInteger(value) {
-    return optionalIntegerLike(value, "integer", (message) => new ProviderRequestError(502, message));
+    return optionalIntegerLike(value, "integer", providerResponseError);
 }
 function mapNoteSortType(value) {
     switch (optionalString(value)) {

package/src/providers/infolobby/runtime.js

@@ -1,8 +1,8 @@
 import { compactObject, requiredString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError, providerResponseError, } from "../provider-runtime.js";
 export const infolobbyApiBaseUrl = "https://infolobby.com/api";
 export async function validateInfolobbyCredential(input, fetcher) {
-    const apiKey = requiredString(input.apiKey, "apiKey", (message) => new ProviderRequestError(400, message));
+    const apiKey = requiredString(input.apiKey, "apiKey", providerInputError);
     const payload = await requestInfolobby({
         path: "/spaces/list",
         apiKey,
@@ -128,18 +128,18 @@ async function requestInfolobby(options) {
 function mapInfolobbyError(status, text, mode) {
     const message = text.trim() || `InfoLobby API request failed with status ${status}`;
     if (status === 401) {
-        return mode === "validate" ? new ProviderRequestError(400, message) : new ProviderRequestError(401, message);
+        return mode === "validate" ? providerInputError(message) : new ProviderRequestError(401, message);
     }
     if (status === 403 || status === 405) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 500 && isDocumentedClientError(message)) {
-        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 isDocumentedClientError(message) {
     const exactMessages = [

package/src/providers/instabot/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, providerResponseError, } from "../provider-runtime.js";
 const instabotApiBaseUrl = "https://api.instabot.io/v1";
 export const instabotActionHandlers = {
     async create_user(input, credential, fetcher) {
@@ -98,7 +98,7 @@ export async function executeInstabotAction(input, fetcher) {
         throw new ProviderRequestError(500, `instabot action is not implemented yet: ${input.actionName}`);
     }
     return handler(input.input, readInstabotCredential({
-        apiKey: requiredString(input.apiKey, "apiKey", (message) => new ProviderRequestError(400, message)),
+        apiKey: requiredString(input.apiKey, "apiKey", providerInputError),
         masterApiKey: input.values?.masterApiKey ?? "",
     }), fetcher);
 }
@@ -182,7 +182,7 @@ function createInstabotError(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) {
         return new ProviderRequestError(401, message);
@@ -203,7 +203,7 @@ function normalizeStatus(payload) {
 }
 function readInstabotCredential(input) {
     return {
-        apiKey: requiredString(input.apiKey, "apiKey", (message) => new ProviderRequestError(400, message)),
+        apiKey: requiredString(input.apiKey, "apiKey", providerInputError),
         masterApiKey: readRequiredString(input.masterApiKey, "masterApiKey"),
     };
 }
@@ -212,7 +212,7 @@ function readUserId(value) {
 }
 function requirePositiveInteger(value, message) {
     if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
-        throw new ProviderRequestError(400, message);
+        throw providerInputError(message);
     }
     return value;
 }
@@ -237,7 +237,7 @@ function readResolve(value) {
 function requireObject(value, message) {
     const record = optionalRecord(value);
     if (!record) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return record;
 }

package/src/providers/instatus/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, providerInputError } from "../provider-runtime.js";
 export const instatusApiBaseUrl = "https://api.instatus.com";
 export const instatusActionHandlers = {
     list_status_pages(input, context) {
@@ -111,7 +111,7 @@ let incidentBodyFields = [
 let incidentEditBodyFields = ["name", "components", "started", "status", "notify", "statuses", "translations"];
 let incidentUpdateBodyFields = ["message", "components", "started", "status", "notify", "statuses", "translations"];
 export async function validateInstatusCredential(input, fetcher, signal) {
-    let apiKey = requiredString(input.apiKey, "apiKey", (message) => new ProviderRequestError(400, message));
+    let apiKey = requiredString(input.apiKey, "apiKey", providerInputError);
     let payload = await requestInstatusJson("/v1/user", { method: "GET" }, { apiKey, fetcher, signal }, "validate");
     let profile = optionalRecord(payload);
     let email = optionalString(profile?.email);
@@ -200,13 +200,13 @@ function createInstatusError(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 (phase === "execute" && (response.status === 401 || response.status === 403)) {
         return new ProviderRequestError(401, message);
     }
     if ([400, 404, 422].includes(response.status)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 500, message);
 }

package/src/providers/intuiface/executors.js

@@ -1,5 +1,5 @@
 import { optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const service = "intuiface";
 const intuifaceApiOrigin = "https://api.intuiface.com";
 const intuifaceWebTriggersBaseUrl = `${intuifaceApiOrigin}/webtriggers/v1`;
@@ -142,13 +142,13 @@ function toIntuifaceError(response, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     else if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     else if (phase === "execute" && (response.status === 401 || response.status === 403)) {
         return new ProviderRequestError(401, message);
     }
     else if (response.status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     else {
         return new ProviderRequestError(response.status || 500, message);