@oomol-lab/open-connector 1.9.1 → 1.9.3

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/intercom/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/intercom/executors.js

@@ -1,5 +1,6 @@
 import { defineProviderExecutors, defineProviderProxy, requireOAuthCredential } from "../provider-runtime.js";
 import { intercomActionHandlers, intercomAllowedApiBaseUrls, intercomApiVersion, resolveIntercomApiBaseUrl, validateIntercomOAuthCredential, } from "./runtime.js";
+import { intercomConversationEvents } from "./trigger-on-conversation-event.js";
 const service = "intercom";
 export const executors = defineProviderExecutors({
     service,
@@ -32,3 +33,4 @@ export const credentialValidators = {
         return validateIntercomOAuthCredential(input, fetcher, signal);
     },
 };
+export const triggers = [intercomConversationEvents];

package/src/providers/intercom/trigger-on-conversation-event.d.ts

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

package/src/providers/intercom/trigger-on-conversation-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/intercom/trigger-on-conversation-event.definition.js

@@ -0,0 +1,42 @@
+import { s } from "../../core/json-schema.js";
+export const snapshot = {
+    key: "intercom.on_conversation_event",
+    provider: "intercom",
+    name: "on_conversation_event",
+    displayName: "Customer Conversation or Ticket",
+    description: "Receives customer conversations, customer replies and new tickets from a verified Intercom application event source. Administrator replies are excluded.",
+    definitionVersion: 2,
+    type: "integration",
+    endpoint: {
+        methods: ["POST"],
+        body: { formats: ["json"], allowArray: false, allowEmpty: false },
+        successStatus: 200,
+    },
+    configInputs: [
+        {
+            handle: "sourceId",
+            jsonSchema: { type: "string", pattern: "^source_[0-9a-f]{32}$", title: "Event source" },
+            nullable: false,
+        },
+        {
+            handle: "eventTypes",
+            jsonSchema: {
+                type: "array",
+                items: { type: "string", enum: ["conversation.user.created", "conversation.user.replied", "ticket.created"] },
+                minItems: 1,
+                maxItems: 3,
+                uniqueItems: true,
+                title: "Events",
+            },
+            nullable: false,
+            value: ["conversation.user.created", "conversation.user.replied", "ticket.created"],
+        },
+    ],
+    outputs: [
+        { handle: "event", jsonSchema: s.string(), nullable: false },
+        { handle: "deliveryId", jsonSchema: s.string(), nullable: false },
+        { handle: "workspaceId", jsonSchema: s.string(), nullable: false },
+        { handle: "objectId", jsonSchema: s.string(), nullable: false },
+        { handle: "body", jsonSchema: s.object({}, { additionalProperties: true }), nullable: false },
+    ],
+};

package/src/providers/intercom/trigger-on-conversation-event.js

@@ -0,0 +1,23 @@
+import { PermanentIntegrationError } from "../../triggers/common/integration.js";
+import { isJsonObject } from "../../triggers/common/json.js";
+import { intercomApplication } from "../../triggers/sources/intercom.js";
+import { snapshot } from "./trigger-on-conversation-event.definition.js";
+export const intercomConversationEvents = {
+    snapshot,
+    eventSource: "intercom",
+    source: intercomApplication,
+    receive(context) {
+        if (context.eventSourceId !== context.config.sourceId)
+            return { outcome: "respond", status: 404, body: "", contentType: "text/plain" };
+        const payload = context.payload;
+        if (!isJsonObject(payload) ||
+            typeof payload.deliveryId !== "string" ||
+            !payload.deliveryId ||
+            !isJsonObject(payload.body))
+            throw new PermanentIntegrationError("Invalid shared Intercom event.");
+        return { outcome: "event", dedupeKey: payload.deliveryId, outputs: payload };
+    },
+    async reconcile() {
+        throw new PermanentIntegrationError("This deployment does not support shared Intercom event sources.");
+    },
+};

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);

package/src/providers/iplocate/runtime.js

@@ -1,8 +1,7 @@
 import { isIP } from "node:net";
 import { optionalRecord, optionalString } from "../../core/cast.js";
-import { createProviderTimeout, providerUserAgent, ProviderRequestError } from "../provider-runtime.js";
+import { createProviderTimeout, providerUserAgent, ProviderRequestError, providerInputError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 export const iplocateApiBaseUrl = "https://iplocate.io/api";
-const requestTimeoutMs = 30_000;
 export const iplocateActionHandlers = {
     async lookup_ip(input, context) {
         const ip = readIpAddress(input.ip, "ip");
@@ -73,7 +72,7 @@ async function requestIplocateJson(input, context, phase) {
             url.searchParams.set(key, value);
         }
     }
-    const timeout = createProviderTimeout(context.signal, requestTimeoutMs);
+    const timeout = createProviderTimeout(context.signal);
     let response;
     let payload;
     try {
@@ -87,7 +86,7 @@ async function requestIplocateJson(input, context, phase) {
     }
     catch (error) {
         if (timeout.didTimeout()) {
-            throw new ProviderRequestError(504, `IPLocate request timed out after ${requestTimeoutMs / 1000} seconds`);
+            throw new ProviderRequestError(504, `IPLocate request timed out after ${defaultProviderRequestTimeoutMs / 1000} seconds`);
         }
         throw new ProviderRequestError(502, error instanceof Error ? `IPLocate request failed: ${error.message}` : "IPLocate request failed");
     }
@@ -131,7 +130,7 @@ function createIplocateError(response, payload, phase) {
         return new ProviderRequestError(phase === "validate" ? 400 : response.status, message);
     }
     if (response.status === 400 || response.status === 404) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     return new ProviderRequestError(response.status >= 500 ? 502 : response.status, message);
 }

package/src/providers/ipregistry/executors.js

@@ -1,5 +1,5 @@
 import { optionalRecord, optionalString } from "../../core/cast.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, isAbortLikeError, providerUserAgent, ProviderRequestError, providerInputError, } from "../provider-runtime.js";
 const service = "ipregistry";
 const ipregistryBaseUrl = "https://api.ipregistry.co";
 const validationIp = "8.8.8.8";
@@ -193,7 +193,7 @@ function mapIpregistryError(status, message, phase) {
         return new ProviderRequestError(phase === "validate" ? 400 : 401, normalizedMessage);
     }
     if (status === 400 || status === 404) {
-        return new ProviderRequestError(400, normalizedMessage);
+        return providerInputError(normalizedMessage);
     }
     if (status === 402 || status === 429) {
         return new ProviderRequestError(429, normalizedMessage);

package/src/providers/jiminny/runtime.js

@@ -1,5 +1,5 @@
 import { compactObject, optionalRecord, optionalString } from "../../core/cast.js";
-import { ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { ProviderRequestError, providerUserAgent, providerInputError, providerResponseError, } from "../provider-runtime.js";
 const jiminnyUsApiBaseUrl = "https://app.jiminny.com/customer/api/v1";
 const jiminnyEuApiBaseUrl = "https://app.jiminny.eu/customer/api/v1";
 const jiminnyValidationPath = "/me";
@@ -281,9 +281,9 @@ function mapJiminnyError(status, message, phase) {
         return new ProviderRequestError(429, message);
     }
     if (status === 400 || status === 404 || status === 422) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
-    return new ProviderRequestError(502, message);
+    return providerResponseError(message);
 }
 function isJiminnyGeneratingMessage(message) {
     return message.toLowerCase().includes("being generated");
@@ -329,7 +329,7 @@ function pickQuery(input, keys) {
 function readObjectPayload(payload, message) {
     const record = optionalRecord(payload);
     if (!record) {
-        throw new ProviderRequestError(502, message);
+        throw providerResponseError(message);
     }
     return record;
 }

package/src/providers/jin10/executors.js

@@ -3,12 +3,11 @@ import { SdkHttpError } from "@modelcontextprotocol/client";
 import { ProtocolError } from "@modelcontextprotocol/client";
 import { createHash } from "node:crypto";
 import { withMcpClient } from "../mcp-client.js";
-import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, } from "../provider-runtime.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, providerUserAgent, ProviderRequestError, defaultProviderRequestTimeoutMs, } from "../provider-runtime.js";
 const service = "jin10";
 const jin10McpOrigin = "https://mcp.jin10.com";
 const jin10McpEndpoint = "https://mcp.jin10.com/mcp";
 const jin10QuoteCodesResourceUri = "quote://codes";
-const jin10RequestTimeoutMs = 30_000;
 export const jin10ActionHandlers = {
     list_quote_codes(_input, context) {
         return readJin10QuoteCodes(context);
@@ -72,7 +71,7 @@ export const credentialValidators = {
 async function listJin10McpTools(input) {
     return withJin10McpClient(input, async (client) => {
         const result = await client.listTools({}, {
-            timeout: jin10RequestTimeoutMs,
+            timeout: defaultProviderRequestTimeoutMs,
         });
         return result.tools.map((tool) => ({
             name: tool.name,
@@ -86,7 +85,7 @@ async function callJin10McpTool(context, toolName, argumentsInput) {
             name: toolName,
             arguments: argumentsInput,
         }, {
-            timeout: jin10RequestTimeoutMs,
+            timeout: defaultProviderRequestTimeoutMs,
         });
         return normalizeJin10McpToolResult(toolName, result);
     });
@@ -96,7 +95,7 @@ async function readJin10QuoteCodes(context) {
         const result = await client.readResource({
             uri: jin10QuoteCodesResourceUri,
         }, {
-            timeout: jin10RequestTimeoutMs,
+            timeout: defaultProviderRequestTimeoutMs,
         });
         const content = result.contents[0];
         if (!content || !("text" in content)) {

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

@@ -1,4 +1,5 @@
 import type { CredentialValidators, ProviderExecutors, ProviderProxyExecutor } from "../../core/types.ts";
+import type { IntegrationDefinition } from "../../triggers/common/integration.ts";
 import type { ProviderActionHandlers } from "../provider-runtime.ts";
 type JiraActionContext = {
     accessToken: string;
@@ -22,4 +23,5 @@ export declare const credentialValidators: CredentialValidators;
  * suffix this provider speaks, so a pasted API URL is not double-appended.
  */
 export declare function normalizeJiraServerApiBaseUrl(value: unknown, allowPrivateNetwork?: boolean): string;
+export declare const triggers: readonly IntegrationDefinition[];
 export {};

package/src/providers/jira/executors.js

@@ -1,6 +1,7 @@
 import { compactObject, optionalBoolean, optionalInteger as asOptionalInteger, optionalRecord as asOptionalObject, optionalString as asOptionalString, optionalStringArray, } from "../../core/cast.js";
 import { assertPublicHttpUrl, isPrivateNetworkAccessAllowed } from "../../core/request.js";
-import { createProviderFetch, ProviderRequestError, defineProviderExecutors, defineProviderProxy, providerUserAgent, } from "../provider-runtime.js";
+import { createProviderFetch, ProviderRequestError, defineProviderExecutors, defineProviderProxy, providerUserAgent, providerInputError, } from "../provider-runtime.js";
+import { jiraIssueEvents } from "./trigger-on-issue-event.js";
 const jiraApiOrigin = "https://api.atlassian.com";
 const jiraAccessibleResourcesUrl = "https://api.atlassian.com/oauth/token/accessible-resources";
 const jiraCurrentUserPath = "/myself";
@@ -481,7 +482,7 @@ export function normalizeJiraServerApiBaseUrl(value, allowPrivateNetwork = isPri
     }
     const url = assertPublicHttpUrl(instanceUrl, {
         fieldName: "baseUrl",
-        createError: (message) => new ProviderRequestError(400, message),
+        createError: providerInputError,
         allowPrivateNetwork,
     });
     if (url.username || url.password) {
@@ -830,7 +831,7 @@ async function readJsonValue(response) {
 function mapJiraResponseError(status, payload, phase, notFoundAsInvalidInput) {
     const message = readJiraErrorMessage(payload);
     if (status === 400) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 401) {
         return new ProviderRequestError(phase === "auth" ? 400 : 401, message);
@@ -842,7 +843,7 @@ function mapJiraResponseError(status, payload, phase, notFoundAsInvalidInput) {
         return new ProviderRequestError(502, message, 403);
     }
     if (status === 404 && notFoundAsInvalidInput) {
-        return new ProviderRequestError(400, message);
+        return providerInputError(message);
     }
     if (status === 429) {
         return new ProviderRequestError(429, message);
@@ -944,3 +945,4 @@ function trimLeadingSlash(value) {
     }
     return value.slice(index);
 }
+export const triggers = [jiraIssueEvents];

package/src/providers/jira/trigger-on-issue-event.d.ts

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