@oomol-lab/open-connector 1.9.1 → 1.9.3

package/src/providers/allratestoday/runtime.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderActionHandlers, ProviderFetch } from "../provider-runtime.ts";
+import { ProviderRequestError } from "../provider-runtime.ts";
+export declare const allratestodayApiBaseUrl = "https://allratestoday.com/api/open";
+export interface AllRatesTodayRuntimeContext {
+    fetcher: ProviderFetch;
+    signal?: AbortSignal;
+}
+type AllRatesTodayActionHandler = (input: Record<string, unknown>, context: AllRatesTodayRuntimeContext) => Promise<unknown>;
+export declare const allratestodayActionHandlers: ProviderActionHandlers<"allratestoday", AllRatesTodayActionHandler>;
+/**
+ * Map an AllRatesToday error onto the runtime's status conventions. An unsupported
+ * base currency is a caller mistake, so it becomes invalid input rather than a
+ * provider failure; the endpoint needs no credentials, so nothing here is an
+ * authorization failure.
+ */
+export declare function readAllRatesTodayError(response: Response): Promise<ProviderRequestError>;
+export {};

package/src/providers/allratestoday/runtime.js

@@ -0,0 +1,104 @@
+import { optionalNumber, optionalRawString, optionalRecord, optionalString } from "../../core/cast.js";
+import { parseProviderJsonBodyText, providerInputError, ProviderRequestError, providerResponseError, providerUserAgent, readProviderErrorTextBody, readProviderTextBody, requiredInputString, requiredResponseRecord, runProviderRequest, withRetryAfterSeconds, } from "../provider-runtime.js";
+export const allratestodayApiBaseUrl = "https://allratestoday.com/api/open";
+const defaultBase = "USD";
+export const allratestodayActionHandlers = {
+    async get_latest_rates(input, context) {
+        const latest = await requestLatest(input.base === undefined ? defaultBase : currencyCode(input.base, "base"), context);
+        if (!Array.isArray(input.symbols))
+            return latest;
+        const rates = {};
+        const missing = [];
+        for (const value of input.symbols) {
+            const code = currencyCode(value, "symbols");
+            const rate = latest.rates[code];
+            if (rate === undefined)
+                missing.push(code);
+            else
+                rates[code] = rate;
+        }
+        if (missing.length > 0) {
+            throw providerInputError(`AllRatesToday open rates do not include ${missing.join(", ")}.`);
+        }
+        return { ...latest, rates };
+    },
+    async convert(input, context) {
+        const from = currencyCode(input.from, "from");
+        const to = currencyCode(input.to, "to");
+        const amount = optionalNumber(input.amount) ?? 1;
+        const latest = await requestLatest(from, context);
+        const rate = from === to ? 1 : latest.rates[to];
+        // A currency outside the ECB set is absent from the map; never report it as a zero rate.
+        if (rate === undefined) {
+            throw providerInputError(`AllRatesToday open rates do not include ${to}.`);
+        }
+        return { from, to, amount, rate, result: amount * rate, date: latest.date, attribution: latest.attribution };
+    },
+};
+function currencyCode(value, fieldName) {
+    const code = requiredInputString(value, fieldName).trim().toUpperCase();
+    if (!/^[A-Z]{3}$/.test(code)) {
+        throw providerInputError(`${fieldName} must be a three-letter currency code such as USD.`);
+    }
+    return code;
+}
+async function requestLatest(base, context) {
+    const url = new URL(`${allratestodayApiBaseUrl}/latest/${base}`);
+    const payload = await runProviderRequest({ label: "AllRatesToday", signal: context.signal }, async (signal) => {
+        const response = await context.fetcher(url, {
+            headers: {
+                accept: "application/json",
+                "user-agent": providerUserAgent,
+            },
+            signal,
+        });
+        if (!response.ok) {
+            throw await readAllRatesTodayError(response);
+        }
+        return parseProviderJsonBodyText(await readProviderTextBody(response, "AllRatesToday response"), {
+            emptyBody: {},
+            invalidJsonMessage: "AllRatesToday returned malformed JSON",
+        });
+    });
+    const body = requiredResponseRecord(payload, "AllRatesToday response");
+    if (body.result !== "success") {
+        throw providerResponseError(optionalRawString(body.message) ?? "AllRatesToday returned an error result");
+    }
+    const table = optionalRecord(body.rates);
+    if (table === undefined) {
+        throw providerResponseError("AllRatesToday response has no rates table");
+    }
+    const rates = {};
+    for (const [code, value] of Object.entries(table)) {
+        const rate = optionalNumber(value);
+        if (rate !== undefined && Number.isFinite(rate) && rate > 0)
+            rates[code] = rate;
+    }
+    return {
+        base: optionalString(body.base_code) ?? base,
+        date: optionalString(body.date) ?? "",
+        last_updated: optionalString(body.time_last_update_utc),
+        next_update: optionalString(body.time_next_update_utc),
+        rates,
+        source: optionalString(body.source),
+        attribution: optionalString(body.attribution),
+    };
+}
+/**
+ * Map an AllRatesToday error onto the runtime's status conventions. An unsupported
+ * base currency is a caller mistake, so it becomes invalid input rather than a
+ * provider failure; the endpoint needs no credentials, so nothing here is an
+ * authorization failure.
+ */
+export async function readAllRatesTodayError(response) {
+    const text = (await readProviderErrorTextBody(response, "AllRatesToday error response")).trim();
+    // Error bodies are JSON with an `error-type`, but a gateway error page is not; treat that as no body.
+    const body = optionalRecord(parseProviderJsonBodyText(text, { emptyBody: {}, invalidJsonMessage: "", invalidJsonFallback: () => ({}) }));
+    const message = optionalRawString(body?.message) ??
+        (text.slice(0, 200) || `AllRatesToday request failed with HTTP ${response.status}`);
+    if (body?.["error-type"] === "unsupported-code") {
+        return providerInputError(message);
+    }
+    const status = response.status;
+    return new ProviderRequestError(status, message, withRetryAfterSeconds(response, {}), status === 429 ? "rate_limited" : "provider_error");
+}

package/src/providers/alpaca/runtime.js

@@ -1,10 +1,9 @@
 import { booleanString, compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { isAbortLikeError, providerUserAgent, ProviderRequestError, requiredInputString } from "../provider-runtime.js";
+import { isAbortLikeError, providerUserAgent, ProviderRequestError, requiredInputString, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 import { readAlpacaGrantedScopes } from "./scopes.js";
 const paperTradingBaseUrl = "https://paper-api.alpaca.markets";
 const liveTradingBaseUrl = "https://api.alpaca.markets";
 const dataBaseUrl = "https://data.alpaca.markets";
-const requestTimeoutMs = 30_000;
 export const alpacaActionHandlers = {
     async get_account(_input, context) {
         return {
@@ -421,7 +420,7 @@ export function readAlpacaOAuthCredential(input, environment) {
     };
 }
 async function requestAlpacaJson(input) {
-    const timeoutSignal = AbortSignal.timeout(requestTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = input.context.signal ? AbortSignal.any([input.context.signal, timeoutSignal]) : timeoutSignal;
     try {
         const response = await input.context.fetcher(buildAlpacaUrl(input.family, input.path, input.query, input.context.credential.environment), {

package/src/providers/alpha_vantage/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject } from "../../core/cast.js";
-import { providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, providerInputError } from "../provider-runtime.js";
 export const alphaVantageApiBaseUrl = "https://www.alphavantage.co";
 export const alphaVantageActionHandlers = {
     search_symbols(input, context) {
@@ -396,7 +396,7 @@ function createAlphaVantageError(response, payload, phase) {
         return new ProviderRequestError(phase === "validate" ? 400 : 401, message);
     }
     if (loweredMessage.includes("invalid api call")) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 401 || response.status === 403) {
         return new ProviderRequestError(phase === "validate" ? 400 : 401, message);

package/src/providers/alt_text_ai/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalInteger, optionalString, requiredRecord } from "../../core/cast.js";
-import { providerUserAgent, ProviderRequestError, requiredInputString } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, requiredInputString, providerInputError, } from "../provider-runtime.js";
 export const altTextAiApiBaseUrl = "https://alttext.ai/api/v1";
 export const altTextAiActionHandlers = {
     get_account(_input, context) {
@@ -169,7 +169,7 @@ async function readPayload(response) {
 function createError(response, payload, phase) {
     const message = extractErrorMessage(payload) ?? response.statusText ?? "AltText.ai request failed";
     if (phase === "validate" && (response.status === 401 || response.status === 403)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 500, message, payload);
 }

package/src/providers/altiria/executors.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
 import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString, recordOrEmpty, } from "../../core/cast.js";
 import { assertPublicHttpUrl } from "../../core/request.js";
-import { createProviderFetch, createProviderTimeout, defineProviderExecutors, defineProviderProxy, providerInputError, providerUserAgent, ProviderRequestError, readProviderTextBody, requireCustomCredential, } from "../provider-runtime.js";
+import { createProviderFetch, createProviderTimeout, defineProviderExecutors, defineProviderProxy, providerInputError, providerUserAgent, ProviderRequestError, readProviderTextBody, requireCustomCredential, providerResponseError, } from "../provider-runtime.js";
 const service = "altiria";
 const altiriaMaxResponseBytes = 10 * 1024 * 1024;
 const altiriaRestPath = "/api/rest";
@@ -271,7 +271,7 @@ async function requestAltiria(input) {
         const message = error instanceof Error && error.message.trim()
             ? `Altiria request failed: ${error.message}`
             : "Altiria request failed";
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     finally {
         timeout.cleanup();
@@ -295,7 +295,7 @@ function createAltiriaHttpError(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/amap/runtime.js

@@ -1,5 +1,5 @@
 import { optionalBoolean } from "../../core/cast.js";
-import { ProviderRequestError, requiredInputString } from "../provider-runtime.js";
+import { ProviderRequestError, requiredInputString, providerInputError } from "../provider-runtime.js";
 export const amapApiBaseUrl = "https://restapi.amap.com";
 const amapAuthErrorInfos = new Set([
     "INVALID_USER_KEY",
@@ -336,12 +336,12 @@ function normalizeAmapError(response, payload, mode) {
         amapAuthErrorInfos.has(info ?? "") ||
         amapAuthErrorInfocodes.has(infocode ?? "")) {
         if (mode === "validate") {
-            return new ProviderRequestError(400, message);
+            return providerInputError(message);
         }
         return new ProviderRequestError(401, message);
     }
     if (response.status === 400 || amapInputErrorInfos.has(info ?? "") || amapInputErrorInfocodes.has(infocode ?? "")) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status || 500, message);
 }

package/src/providers/ambee/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent, requiredInputString } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, requiredInputString, providerInputError, } from "../provider-runtime.js";
 export const ambeeApiBaseUrl = "https://api.ambeedata.com";
 export const ambeeActionHandlers = {
     geocode_by_place(input, context) {
@@ -151,7 +151,7 @@ function createAmbeeError(status, payload, phase) {
         return new ProviderRequestError(429, message);
     }
     if (status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 401 || status === 403) {
         return new ProviderRequestError(phase === "validate" ? 400 : status, message);

package/src/providers/ambivo/executors.js

@@ -1,5 +1,5 @@
 import { optionalRecord } from "../../core/cast.js";
-import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderTextBody, requireApiKeyCredential, } from "../provider-runtime.js";
+import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderTextBody, requireApiKeyCredential, providerResponseError, } from "../provider-runtime.js";
 const service = "ambivo";
 const ambivoApiBaseUrl = "https://fapi.ambivo.com";
 const ambivoValidationPath = "/crm/leads";
@@ -264,7 +264,7 @@ function mapAmbivoError(status, payload, mode) {
         return new ProviderRequestError(status, message);
     }
     else {
-        return new ProviderRequestError(502, message);
+        return providerResponseError(message);
     }
 }
 function readErrorMessage(payload) {
@@ -384,7 +384,7 @@ function readObjectArray(value, fieldName) {
 }
 function requireObject(value, message) {
     if (!value || typeof value !== "object" || Array.isArray(value)) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return value;
 }

package/src/providers/amilia/runtime.js

@@ -163,7 +163,7 @@ function toAmiliaError(response, payload, phase, notFoundAsInvalidInput = false)
         return new ProviderRequestError(phase === "validate" ? 401 : response.status, message);
     }
     if (response.status === 404 && notFoundAsInvalidInput) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status >= 400 ? response.status : 502, message);
 }

package/src/providers/amplemarket/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString, requiredRecord } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent, requiredInputString } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, requiredInputString, providerInputError, } from "../provider-runtime.js";
 export const amplemarketApiBaseUrl = "https://api.amplemarket.com";
 export const amplemarketActionHandlers = {
     get_account_details(_input, context) {
@@ -197,7 +197,7 @@ function mapAmplemarketError(status, payload, mode) {
         return new ProviderRequestError(429, message);
     }
     if (status >= 400 && status < 500 && mode === "execute") {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/amplitude/runtime.js

@@ -1,6 +1,6 @@
 import { Buffer } from "node:buffer";
 import { compactObject, optionalInteger, optionalRecord, requiredString } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerFetch, ProviderRequestError, providerUserAgent, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerFetch, ProviderRequestError, providerUserAgent, providerInputError, } from "../provider-runtime.js";
 export const amplitudeApiBaseUrl = "https://amplitude.com";
 export const amplitudeEuApiBaseUrl = "https://analytics.eu.amplitude.com";
 const amplitudeValidationPath = "/api/2/events/list";
@@ -172,7 +172,7 @@ function requireNonEmptyString(value, fieldName) {
     return text;
 }
 function requireAmplitudeSecretKey(value) {
-    return requiredString(value, "apiKey", (message) => new ProviderRequestError(400, message));
+    return requiredString(value, "apiKey", providerInputError);
 }
 function normalizeDataResidency(value) {
     return readDataResidency(value) ?? "default";
@@ -210,7 +210,7 @@ function mapAmplitudeError(status, payload, phase) {
     let message = readAmplitudeErrorMessage(payload) ?? `Amplitude request failed with ${status}`;
     if (status === 401 || status === 403) {
         if (phase === "validate") {
-            return new ProviderRequestError(400, message);
+            return providerInputError(message);
         }
         return new ProviderRequestError(401, message);
     }

package/src/providers/anysearch/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, objectArray, optionalInteger, optionalRawString, optionalRecord, optionalString, requiredString, requiredStringArray, } from "../../core/cast.js";
-import { createProviderTimeout, isAbortLikeError, providerInputError, providerUserAgent, ProviderRequestError, readProviderJsonBody, } from "../provider-runtime.js";
+import { createProviderTimeout, isAbortLikeError, providerInputError, providerUserAgent, ProviderRequestError, readProviderJsonBody, providerResponseError, } from "../provider-runtime.js";
 export const anySearchApiBaseUrl = "https://api.anysearch.com";
 const anySearchMcpEndpoint = anySearchApiBaseUrl + "/mcp";
 const anySearchClientHeader = "connector/1.0.0";
@@ -286,7 +286,7 @@ function createAnySearchMcpToolError(toolName, content) {
         return new ProviderRequestError(401, message);
     }
     if (symbol && invalidInputErrorSymbols.has(symbol)) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     const normalized = message.toLowerCase();
     if (normalized.includes("quota") || normalized.includes("rate limit")) {
@@ -301,9 +301,9 @@ function createAnySearchMcpToolError(toolName, content) {
         normalized.includes("required") ||
         normalized.includes("must ") ||
         normalized.includes("unsupported content")) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function readMcpErrorSymbol(content) {
     const firstLine = content?.split("\n", 1)[0]?.trim();

package/src/providers/apaleo/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalNumber, optionalString } from "../../core/cast.js";
-import { ProviderRequestError } from "../provider-runtime.js";
+import { ProviderRequestError, providerInputError } from "../provider-runtime.js";
 export const apaleoApiBaseUrl = "https://api.apaleo.com";
 export const apaleoActionHandlers = {
     list_properties(input, context) {
@@ -132,7 +132,7 @@ export async function apaleoNoContentRequest(options) {
 export async function createApaleoApiError(response) {
     const message = await readApaleoErrorMessage(response);
     if (response.status === 400 || response.status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (response.status === 401) {
         return new ProviderRequestError(401, message);

package/src/providers/api_sports/executors.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalBoolean, optionalBooleanOrNull, optionalInteger, optionalRecord, optionalString, rawStringOrNull, } from "../../core/cast.js";
-import { defineProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, } from "../provider-runtime.js";
+import { defineProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, requireApiKeyCredential, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "api_sports";
 const apiSportsApiBaseUrl = "https://v3.football.api-sports.io";
-const apiSportsDefaultRequestTimeoutMs = 30_000;
 export const apiSportsActionHandlers = {
     football_list_leagues(input, context) {
         return listLeagues(input, context);
@@ -259,7 +258,7 @@ async function getPredictions(input, context) {
     };
 }
 async function apiSportsGet(path, query, context, mode = "execute") {
-    const timeoutSignal = AbortSignal.timeout(apiSportsDefaultRequestTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = context.signal ? AbortSignal.any([context.signal, timeoutSignal]) : timeoutSignal;
     try {
         const response = await context.fetcher(buildApiSportsUrl(path, query), {
@@ -282,7 +281,7 @@ async function apiSportsGet(path, query, context, mode = "execute") {
             throw error;
         }
         if (isAbortLikeError(error)) {
-            throw new ProviderRequestError(502, `api_sports ${path} request timed out after ${Math.max(1, Math.ceil(apiSportsDefaultRequestTimeoutMs / 1000))} seconds`);
+            throw new ProviderRequestError(502, `api_sports ${path} request timed out after ${Math.max(1, Math.ceil(defaultProviderRequestTimeoutMs / 1000))} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? error.message : "api_sports request failed");
     }

package/src/providers/apiverve/executors.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalBooleanOrNull, optionalRecord, optionalString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, ProviderRequestError, providerUserAgent, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, ProviderRequestError, providerUserAgent, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "apiverve";
 const apiverveApiBaseUrl = "https://api.apiverve.com";
-const apiverveDefaultRequestTimeoutMs = 30_000;
 export const apiverveActionHandlers = {
     async get_word_definition(input, context) {
         const data = await requestApiverveData({
@@ -188,7 +187,7 @@ export const credentialValidators = {
     },
 };
 async function requestApiverveData(input) {
-    const timeoutSignal = AbortSignal.timeout(apiverveDefaultRequestTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = input.context.signal ? AbortSignal.any([input.context.signal, timeoutSignal]) : timeoutSignal;
     try {
         const response = await input.context.fetcher(buildApiverveUrl(input.path, input.params), {

package/src/providers/apollo/executors.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalNumber, optionalRecord, optionalString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, ProviderRequestError, providerUserAgent, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, ProviderRequestError, providerUserAgent, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "apollo";
 const apolloApiBaseUrl = "https://api.apollo.io";
-const apolloDefaultRequestTimeoutMs = 30_000;
 export const apolloActionHandlers = {
     get_api_usage_stats(_input, context) {
         return getApiUsageStats(context);
@@ -137,7 +136,7 @@ async function enrichPerson(input, context) {
     };
 }
 async function requestApolloJson(input) {
-    const timeoutSignal = AbortSignal.timeout(apolloDefaultRequestTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = input.signal ? AbortSignal.any([input.signal, timeoutSignal]) : timeoutSignal;
     const url = new URL(input.path, apolloApiBaseUrl);
     for (const [key, value] of Object.entries(input.query ?? {})) {

package/src/providers/appcircle/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, providerResponseError, } from "../provider-runtime.js";
 export const appcircleApiBaseUrl = "https://api.appcircle.io";
 const appcircleAuthTokenUrl = "https://auth.appcircle.io/auth/v1/api-key/token";
 export const appcircleActionHandlers = {
@@ -139,7 +139,7 @@ async function exchangeAppcircleAccessToken(credential, fetcher, phase) {
     return accessToken;
 }
 function resolveAppcircleCredential(input) {
-    const secret = readRequiredString(requiredString(input.apiKey, "apiKey", (message) => new ProviderRequestError(400, message)), "apiKey");
+    const secret = readRequiredString(requiredString(input.apiKey, "apiKey", providerInputError), "apiKey");
     const name = readRequiredString(input.apiKeyName ?? input.values?.apiKeyName ?? input.providerMetadata?.apiKeyName, "apiKeyName");
     const organizationId = readOptionalString(input.organizationId ?? input.values?.organizationId ?? input.providerMetadata?.organizationId);
     return { secret, name, organizationId };
@@ -193,7 +193,7 @@ async function readAppcirclePayload(response) {
 function mapAppcircleError(status, payload, phase) {
     const message = extractAppcircleErrorMessage(payload) ?? `Appcircle request failed (${status})`;
     if (status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 401) {
         return new ProviderRequestError(phase === "validate" ? 400 : status, message);
@@ -216,13 +216,13 @@ function extractAppcircleErrorMessage(payload) {
 function requireObject(value, message) {
     const object = optionalRecord(value);
     if (!object) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return object;
 }
 function requireObjectArray(value, message) {
     if (!Array.isArray(value)) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return value.map((item) => requireObject(item, message));
 }

package/src/providers/appdrag/executors.js

@@ -1,8 +1,7 @@
 import { compactObject, optionalRecord, optionalString, requiredString } from "../../core/cast.js";
-import { createProviderFetch, createProviderProxyUrl, defineApiKeyProviderExecutors, isAbortLikeError, normalizeProviderProxyHeaders, providerInputError, ProviderRequestError, providerUserAgent, readProviderProxyErrorMessage, readProviderProxyResponse, requireApiKeyCredential, toProviderProxyError, } from "../provider-runtime.js";
+import { createProviderFetch, createProviderProxyUrl, defineApiKeyProviderExecutors, isAbortLikeError, normalizeProviderProxyHeaders, providerInputError, ProviderRequestError, providerUserAgent, readProviderProxyErrorMessage, readProviderProxyResponse, requireApiKeyCredential, toProviderProxyError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "appdrag";
 const appdragHomepageUrl = "https://appdrag.com";
-const appdragDefaultRequestTimeoutMs = 30_000;
 const appdragResponseWrapperDescription = "/api/<folder>/<function>";
 const appdragFetch = createProviderFetch({ skipDnsValidation: true });
 export const appdragActionHandlers = {
@@ -194,7 +193,7 @@ function appendSearchParam(route, key, value) {
     route.searchParams.set(key, JSON.stringify(value));
 }
 async function requestAppdrag(route, init, context) {
-    const timeoutSignal = AbortSignal.timeout(appdragDefaultRequestTimeoutMs);
+    const timeoutSignal = AbortSignal.timeout(defaultProviderRequestTimeoutMs);
     const signal = context.signal ? AbortSignal.any([context.signal, timeoutSignal]) : timeoutSignal;
     try {
         const response = await context.fetcher(route, {

package/src/providers/arcgis_online/executors.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalBoolean, optionalNumber, optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderJsonBody, requireApiKeyCredential, } from "../provider-runtime.js";
+import { createProviderTimeout, defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, readProviderJsonBody, requireApiKeyCredential, providerInputError, } from "../provider-runtime.js";
 const service = "arcgis_online";
 const arcgisOnlineApiBaseUrl = "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer";
 const arcgisOnlineValidationPath = "/suggest";
@@ -158,7 +158,7 @@ function createArcgisOnlineError(status, payload) {
         return new ProviderRequestError(401, message);
     }
     if (status === 400 || upstreamCode === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(status >= 500 ? status : 502, message);
 }

package/src/providers/asana/executors.d.ts

@@ -1,4 +1,6 @@
 import type { CredentialValidators, ProviderExecutors, ProviderProxyExecutor } from "../../core/types.ts";
+import type { IntegrationDefinition } from "../../triggers/common/integration.ts";
 export declare const executors: ProviderExecutors;
 export declare const proxy: ProviderProxyExecutor;
 export declare const credentialValidators: CredentialValidators;
+export declare const triggers: readonly IntegrationDefinition[];

package/src/providers/asana/executors.js

@@ -8,6 +8,7 @@ import { taskActionHandlers } from "./runtime-tasks.js";
 import { workspaceUserTeamActionHandlers } from "./runtime-workspaces-users-teams.js";
 import { asanaApiBaseUrl, requestAsana } from "./runtime.js";
 import { readAsanaGrantedScopes } from "./scopes.js";
+import { asanaTaskEvent } from "./trigger-on-task-event.js";
 const service = "asana";
 const asanaValidationPath = "/users/me";
 export const executors = defineBearerProviderExecutors(service, combineProviderActionHandlers(service, workspaceUserTeamActionHandlers, projectSectionActionHandlers, taskActionHandlers, storyTagActionHandlers, customFieldActionHandlers, attachmentActionHandlers));
@@ -60,3 +61,4 @@ async function validateAsanaCredential(accessToken, grantedScopes, fetcher, sign
         }),
     };
 }
+export const triggers = [asanaTaskEvent];

package/src/providers/asana/trigger-on-task-event.d.ts

@@ -0,0 +1,2 @@
+import type { IntegrationDefinition } from "../../triggers/common/integration.ts";
+export declare const asanaTaskEvent: IntegrationDefinition;

package/src/providers/asana/trigger-on-task-event.definition.d.ts

@@ -0,0 +1,4 @@
+import type { TriggerKeySnapshot } from "../../triggers/common/types.ts";
+export declare const snapshot: TriggerKeySnapshot & {
+    readonly type: "integration";
+};

package/src/providers/asana/trigger-on-task-event.definition.js

@@ -0,0 +1,42 @@
+import { jsonSchema as s } from "../../core/json-schema.js";
+export const snapshot = {
+    key: "asana.on_task_event",
+    provider: "asana",
+    name: "on_task_event",
+    displayName: "Project Task Event",
+    description: "Receives tasks added to a project, completion changes, and selected custom field changes. Task details represent current state, not historical state.",
+    definitionVersion: 2,
+    type: "integration",
+    endpoint: { methods: ["POST"], body: { formats: ["json"], allowArray: false, allowEmpty: true }, successStatus: 200 },
+    configInputs: [
+        { handle: "projectId", jsonSchema: { type: "string", minLength: 1, title: "Project ID" }, nullable: false },
+        {
+            handle: "eventTypes",
+            jsonSchema: {
+                type: "array",
+                items: { type: "string", enum: ["task.added", "task.completed", "task.field_changed"] },
+                minItems: 1,
+                uniqueItems: true,
+                title: "Events",
+            },
+            nullable: false,
+            value: ["task.added", "task.completed"],
+        },
+        { handle: "customFieldId", jsonSchema: { type: "string", minLength: 1, title: "Custom field ID" }, nullable: true },
+    ],
+    outputs: [
+        { handle: "projectId", jsonSchema: s.string(), nullable: false },
+        {
+            handle: "events",
+            jsonSchema: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: { event: s.string(), task: { type: "object" }, change: { type: "object" } },
+                    required: ["event", "task", "change"],
+                },
+            },
+            nullable: false,
+        },
+    ],
+};