@tangle-network/agent-integrations 0.5.0 → 0.7.0

package/dist/index.js

@@ -1986,6 +1986,204 @@ function readMetaString3(meta, key) {
   return v;
 }
 
+// src/connectors/adapters/declarative-rest.ts
+function declarativeRestConnector(spec) {
+  const capabilities = spec.capabilities.map(operationToCapability);
+  const adapter = {
+    manifest: {
+      kind: spec.kind,
+      displayName: spec.displayName,
+      description: spec.description,
+      auth: spec.auth,
+      category: spec.category,
+      defaultConsistencyModel: spec.defaultConsistencyModel,
+      capabilities
+    },
+    async executeRead(inv) {
+      const op = readOperation(spec, inv.capabilityName, "read");
+      const response = await executeRestRequest(spec, op.request, inv);
+      return {
+        data: response.data,
+        etag: response.etag,
+        fetchedAt: Date.now()
+      };
+    },
+    async executeMutation(inv) {
+      const op = readOperation(spec, inv.capabilityName, "mutation");
+      const response = await executeRestRequest(spec, op.request, inv);
+      return {
+        status: "committed",
+        data: response.data,
+        etagAfter: response.etag,
+        committedAt: Date.now(),
+        idempotentReplay: false
+      };
+    },
+    async test(source) {
+      if (!spec.test) return { ok: true };
+      try {
+        await executeRestRequest(spec, spec.test, {
+          source,
+          capabilityName: "__test__",
+          args: {},
+          idempotencyKey: "test"
+        });
+        return { ok: true };
+      } catch (error) {
+        return { ok: false, reason: error instanceof Error ? error.message : "unknown error" };
+      }
+    }
+  };
+  return adapter;
+}
+function operationToCapability(op) {
+  const base = {
+    name: op.name,
+    description: op.description,
+    parameters: op.parameters,
+    requiredScopes: op.requiredScopes
+  };
+  if (op.class === "read") {
+    return { ...base, class: "read" };
+  }
+  return {
+    ...base,
+    class: "mutation",
+    cas: op.cas ?? "native-idempotency",
+    externalEffect: op.externalEffect ?? true
+  };
+}
+function readOperation(spec, name, expected) {
+  const op = spec.capabilities.find((candidate) => candidate.name === name);
+  if (!op || op.class !== expected) {
+    throw new Error(`${spec.kind}: unknown ${expected} capability ${name}`);
+  }
+  return op;
+}
+async function executeRestRequest(spec, request, inv) {
+  const baseUrl = resolveBaseUrl(spec.baseUrl, inv.source.metadata);
+  const url = new URL(interpolate(request.path, inv.args), baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`);
+  for (const [key, value] of Object.entries(request.query ?? {})) {
+    const rendered = renderQueryValue(value, inv.args);
+    if (rendered !== void 0 && rendered !== "") url.searchParams.set(key, String(rendered));
+  }
+  const headers = {
+    accept: "application/json",
+    ...spec.defaultHeaders,
+    ...renderHeaders(request.headers ?? {}, inv.args)
+  };
+  applyCredentials(headers, url, spec.credentialPlacement ?? { kind: "bearer" }, inv.source.credentials);
+  if (inv.expectedEtag) headers["if-match"] = inv.expectedEtag;
+  if (request.method !== "GET" && request.method !== "DELETE") {
+    headers["content-type"] = headers["content-type"] ?? "application/json";
+  }
+  const res = await fetch(url, {
+    method: request.method,
+    headers,
+    body: request.method === "GET" || request.method === "DELETE" ? void 0 : JSON.stringify(resolveBody(request.body, inv.args)),
+    signal: AbortSignal.timeout(2e4)
+  });
+  if (res.status === 401 || res.status === 403) {
+    throw new CredentialsExpired(`${spec.displayName} rejected credentials (${res.status})`, inv.source.id);
+  }
+  if (res.status === 409 || res.status === 412) {
+    return {
+      data: {
+        status: "conflict",
+        message: await safeErrorText(res)
+      },
+      etag: res.headers.get("etag") ?? void 0
+    };
+  }
+  if (res.status === 429) {
+    return {
+      data: {
+        status: "rate-limited",
+        retryAfter: res.headers.get("retry-after") ?? void 0,
+        message: await safeErrorText(res)
+      }
+    };
+  }
+  if (!res.ok) {
+    throw new Error(`${spec.kind} ${request.method} ${url.pathname} HTTP ${res.status}: ${(await safeErrorText(res)).slice(0, 300)}`);
+  }
+  const text = await res.text();
+  const data = text ? JSON.parse(text) : null;
+  return { data, etag: res.headers.get("etag") ?? void 0 };
+}
+function resolveBaseUrl(baseUrl, metadata) {
+  if (typeof baseUrl === "string") return baseUrl;
+  const value = metadata[baseUrl.metadataKey];
+  if (typeof value === "string" && value.trim()) return value;
+  if (baseUrl.fallback) return baseUrl.fallback;
+  throw new Error(`missing metadata.${baseUrl.metadataKey} base URL`);
+}
+function applyCredentials(headers, url, placement, credentials) {
+  const token = credentialToken(credentials);
+  if (placement.kind === "bearer") headers.authorization = `Bearer ${token}`;
+  if (placement.kind === "header") headers[placement.header] = `${placement.prefix ?? ""}${token}`;
+  if (placement.kind === "query") url.searchParams.set(placement.parameter, token);
+}
+function credentialToken(credentials) {
+  if (credentials.kind === "oauth2") return credentials.accessToken;
+  if (credentials.kind === "api-key") return credentials.apiKey;
+  throw new Error(`declarative REST connectors require oauth2 or api-key credentials, got ${credentials.kind}`);
+}
+function resolveBody(body, args) {
+  if (!body || body === "args") return args;
+  if (typeof body === "string") return renderValue(body, args);
+  return renderObject(body, args);
+}
+function renderHeaders(headers, args) {
+  return Object.fromEntries(Object.entries(headers).map(([key, value]) => [key, interpolate(value, args)]));
+}
+function renderObject(input, args) {
+  return Object.fromEntries(Object.entries(input).map(([key, value]) => [key, renderValue(value, args)]));
+}
+function renderValue(value, args) {
+  if (typeof value === "string") {
+    const exact = value.match(/^\{([a-zA-Z0-9_.-]+)\}$/);
+    if (exact) return readRequiredPath(args, exact[1]);
+    return interpolate(value, args);
+  }
+  return value;
+}
+function renderQueryValue(value, args) {
+  if (typeof value !== "string") return value;
+  const exact = value.match(/^\{([a-zA-Z0-9_.-]+)\}$/);
+  if (exact) return readPath(args, exact[1]);
+  try {
+    return interpolate(value, args);
+  } catch {
+    return void 0;
+  }
+}
+function interpolate(template, args) {
+  return template.replace(/\{([a-zA-Z0-9_.-]+)\}/g, (_match, key) => {
+    const value = readPath(args, key);
+    if (value === void 0 || value === null) {
+      throw new Error(`missing required argument: ${key}`);
+    }
+    return encodeURIComponent(String(value));
+  });
+}
+function readRequiredPath(input, path) {
+  const value = readPath(input, path);
+  if (value === void 0 || value === null) throw new Error(`missing required argument: ${path}`);
+  return value;
+}
+function readPath(input, path) {
+  return path.split(".").reduce((value, part) => {
+    if (value && typeof value === "object" && part in value) {
+      return value[part];
+    }
+    return void 0;
+  }, input);
+}
+async function safeErrorText(res) {
+  return await res.text().catch(() => res.statusText) || res.statusText;
+}
+
 // src/connectors/adapters/twilio-sms.ts
 var API4 = "https://api.twilio.com/2010-04-01";
 var LOOKUP_API = "https://lookups.twilio.com/v1";
@@ -2654,6 +2852,349 @@ var slackEventsConnector = {
   }
 };
 
+// src/connectors/adapters/github.ts
+var repoParams = {
+  type: "object",
+  properties: {
+    owner: { type: "string" },
+    repo: { type: "string" }
+  },
+  required: ["owner", "repo"]
+};
+var githubConnector = declarativeRestConnector({
+  kind: "github",
+  displayName: "GitHub",
+  description: "Search repositories/issues and create or update GitHub issues through a user-scoped token.",
+  auth: { kind: "api-key", hint: "GitHub fine-grained personal access token or installation token." },
+  category: "other",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: "https://api.github.com",
+  defaultHeaders: {
+    "x-github-api-version": "2022-11-28"
+  },
+  test: { method: "GET", path: "/user" },
+  capabilities: [
+    {
+      name: "repositories.get",
+      class: "read",
+      description: "Read repository metadata.",
+      parameters: repoParams,
+      request: { method: "GET", path: "/repos/{owner}/{repo}" }
+    },
+    {
+      name: "issues.search",
+      class: "read",
+      description: "Search GitHub issues and pull requests.",
+      parameters: {
+        type: "object",
+        properties: { q: { type: "string" }, per_page: { type: "integer", minimum: 1, maximum: 100 } },
+        required: ["q"]
+      },
+      request: { method: "GET", path: "/search/issues", query: { q: "{q}", per_page: "{per_page}" } }
+    },
+    {
+      name: "issues.create",
+      class: "mutation",
+      description: "Create an issue in a repository.",
+      parameters: {
+        type: "object",
+        properties: {
+          owner: { type: "string" },
+          repo: { type: "string" },
+          title: { type: "string" },
+          body: { type: "string" },
+          labels: { type: "array", items: { type: "string" } }
+        },
+        required: ["owner", "repo", "title"]
+      },
+      request: { method: "POST", path: "/repos/{owner}/{repo}/issues", body: "args" },
+      cas: "native-idempotency"
+    },
+    {
+      name: "issues.update",
+      class: "mutation",
+      description: "Update an issue by number.",
+      parameters: {
+        type: "object",
+        properties: {
+          owner: { type: "string" },
+          repo: { type: "string" },
+          issue_number: { type: "integer" },
+          title: { type: "string" },
+          body: { type: "string" },
+          state: { type: "string", enum: ["open", "closed"] }
+        },
+        required: ["owner", "repo", "issue_number"]
+      },
+      request: { method: "PATCH", path: "/repos/{owner}/{repo}/issues/{issue_number}", body: "args" },
+      cas: "etag-if-match"
+    }
+  ]
+});
+
+// src/connectors/adapters/gitlab.ts
+var gitlabConnector = declarativeRestConnector({
+  kind: "gitlab",
+  displayName: "GitLab",
+  description: "Search GitLab projects/issues and create or update issues through a personal, project, or group token.",
+  auth: { kind: "api-key", hint: "GitLab access token with api/read_api scope." },
+  category: "other",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: { metadataKey: "baseUrl", fallback: "https://gitlab.com/api/v4" },
+  credentialPlacement: { kind: "header", header: "PRIVATE-TOKEN" },
+  test: { method: "GET", path: "/user" },
+  capabilities: [
+    {
+      name: "projects.search",
+      class: "read",
+      description: "Search projects visible to the token.",
+      parameters: {
+        type: "object",
+        properties: { search: { type: "string" }, per_page: { type: "integer", minimum: 1, maximum: 100 } },
+        required: ["search"]
+      },
+      request: { method: "GET", path: "/projects", query: { search: "{search}", per_page: "{per_page}" } }
+    },
+    {
+      name: "issues.search",
+      class: "read",
+      description: "Search issues in a project.",
+      parameters: {
+        type: "object",
+        properties: { projectId: { type: "string" }, search: { type: "string" }, per_page: { type: "integer" } },
+        required: ["projectId", "search"]
+      },
+      request: { method: "GET", path: "/projects/{projectId}/issues", query: { search: "{search}", per_page: "{per_page}" } }
+    },
+    {
+      name: "issues.create",
+      class: "mutation",
+      description: "Create a GitLab project issue.",
+      parameters: {
+        type: "object",
+        properties: { projectId: { type: "string" }, title: { type: "string" }, description: { type: "string" } },
+        required: ["projectId", "title"]
+      },
+      request: { method: "POST", path: "/projects/{projectId}/issues", body: "args" },
+      cas: "native-idempotency"
+    },
+    {
+      name: "issues.update",
+      class: "mutation",
+      description: "Update a GitLab issue.",
+      parameters: {
+        type: "object",
+        properties: { projectId: { type: "string" }, issueIid: { type: "integer" }, title: { type: "string" }, description: { type: "string" }, state_event: { type: "string" } },
+        required: ["projectId", "issueIid"]
+      },
+      request: { method: "PUT", path: "/projects/{projectId}/issues/{issueIid}", body: "args" },
+      cas: "etag-if-match"
+    }
+  ]
+});
+
+// src/connectors/adapters/airtable.ts
+var baseTableParams = {
+  type: "object",
+  properties: {
+    baseId: { type: "string" },
+    tableName: { type: "string" }
+  },
+  required: ["baseId", "tableName"]
+};
+var airtableConnector = declarativeRestConnector({
+  kind: "airtable",
+  displayName: "Airtable",
+  description: "Query and update Airtable records for lightweight operational databases.",
+  auth: { kind: "api-key", hint: "Airtable personal access token." },
+  category: "spreadsheet",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: "https://api.airtable.com",
+  test: { method: "GET", path: "/v0/meta/whoami" },
+  capabilities: [
+    {
+      name: "records.list",
+      class: "read",
+      description: "List records in a table.",
+      parameters: {
+        ...baseTableParams,
+        properties: {
+          ...baseTableParams.properties,
+          maxRecords: { type: "integer", minimum: 1, maximum: 100 },
+          filterByFormula: { type: "string" }
+        }
+      },
+      request: { method: "GET", path: "/v0/{baseId}/{tableName}", query: { maxRecords: "{maxRecords}", filterByFormula: "{filterByFormula}" } }
+    },
+    {
+      name: "records.get",
+      class: "read",
+      description: "Read a single Airtable record.",
+      parameters: {
+        type: "object",
+        properties: { baseId: { type: "string" }, tableName: { type: "string" }, recordId: { type: "string" } },
+        required: ["baseId", "tableName", "recordId"]
+      },
+      request: { method: "GET", path: "/v0/{baseId}/{tableName}/{recordId}" }
+    },
+    {
+      name: "records.create",
+      class: "mutation",
+      description: "Create an Airtable record.",
+      parameters: {
+        type: "object",
+        properties: { baseId: { type: "string" }, tableName: { type: "string" }, fields: { type: "object" } },
+        required: ["baseId", "tableName", "fields"]
+      },
+      request: { method: "POST", path: "/v0/{baseId}/{tableName}", body: { fields: "{fields}" } },
+      cas: "native-idempotency"
+    },
+    {
+      name: "records.update",
+      class: "mutation",
+      description: "Update an Airtable record.",
+      parameters: {
+        type: "object",
+        properties: { baseId: { type: "string" }, tableName: { type: "string" }, recordId: { type: "string" }, fields: { type: "object" } },
+        required: ["baseId", "tableName", "recordId", "fields"]
+      },
+      request: { method: "PATCH", path: "/v0/{baseId}/{tableName}/{recordId}", body: { fields: "{fields}" } },
+      cas: "optimistic-read-verify"
+    }
+  ]
+});
+
+// src/connectors/adapters/asana.ts
+var asanaConnector = declarativeRestConnector({
+  kind: "asana",
+  displayName: "Asana",
+  description: "Search projects/tasks and create or update Asana tasks.",
+  auth: { kind: "api-key", hint: "Asana personal access token." },
+  category: "other",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: "https://app.asana.com/api/1.0",
+  test: { method: "GET", path: "/users/me" },
+  capabilities: [
+    {
+      name: "projects.search",
+      class: "read",
+      description: "List or search projects in a workspace.",
+      parameters: {
+        type: "object",
+        properties: { workspace: { type: "string" }, archived: { type: "boolean" }, limit: { type: "integer" } },
+        required: ["workspace"]
+      },
+      request: { method: "GET", path: "/projects", query: { workspace: "{workspace}", archived: "{archived}", limit: "{limit}" } }
+    },
+    {
+      name: "tasks.search",
+      class: "read",
+      description: "Search tasks in a workspace.",
+      parameters: {
+        type: "object",
+        properties: { workspace: { type: "string" }, text: { type: "string" }, limit: { type: "integer" } },
+        required: ["workspace"]
+      },
+      request: { method: "GET", path: "/workspaces/{workspace}/tasks/search", query: { text: "{text}", limit: "{limit}" } }
+    },
+    {
+      name: "tasks.create",
+      class: "mutation",
+      description: "Create an Asana task.",
+      parameters: {
+        type: "object",
+        properties: { data: { type: "object" } },
+        required: ["data"]
+      },
+      request: { method: "POST", path: "/tasks", body: { data: "{data}" } },
+      cas: "native-idempotency"
+    },
+    {
+      name: "tasks.update",
+      class: "mutation",
+      description: "Update an Asana task.",
+      parameters: {
+        type: "object",
+        properties: { taskGid: { type: "string" }, data: { type: "object" } },
+        required: ["taskGid", "data"]
+      },
+      request: { method: "PUT", path: "/tasks/{taskGid}", body: { data: "{data}" } },
+      cas: "optimistic-read-verify"
+    }
+  ]
+});
+
+// src/connectors/adapters/salesforce.ts
+var salesforceConnector = declarativeRestConnector({
+  kind: "salesforce",
+  displayName: "Salesforce",
+  description: "Query Salesforce records with SOQL and create or update sObjects.",
+  auth: {
+    kind: "oauth2",
+    authorizationUrl: "https://login.salesforce.com/services/oauth2/authorize",
+    tokenUrl: "https://login.salesforce.com/services/oauth2/token",
+    scopes: ["api", "refresh_token"],
+    clientIdEnv: "SALESFORCE_OAUTH_CLIENT_ID",
+    clientSecretEnv: "SALESFORCE_OAUTH_CLIENT_SECRET"
+  },
+  category: "crm",
+  defaultConsistencyModel: "authoritative",
+  baseUrl: { metadataKey: "instanceUrl" },
+  test: { method: "GET", path: "/services/data/v61.0/" },
+  capabilities: [
+    {
+      name: "records.query",
+      class: "read",
+      description: "Run a SOQL query.",
+      parameters: {
+        type: "object",
+        properties: { q: { type: "string" } },
+        required: ["q"]
+      },
+      request: { method: "GET", path: "/services/data/v61.0/query", query: { q: "{q}" } },
+      requiredScopes: ["api"]
+    },
+    {
+      name: "records.get",
+      class: "read",
+      description: "Read a Salesforce sObject record.",
+      parameters: {
+        type: "object",
+        properties: { objectName: { type: "string" }, recordId: { type: "string" } },
+        required: ["objectName", "recordId"]
+      },
+      request: { method: "GET", path: "/services/data/v61.0/sobjects/{objectName}/{recordId}" },
+      requiredScopes: ["api"]
+    },
+    {
+      name: "records.create",
+      class: "mutation",
+      description: "Create a Salesforce sObject record.",
+      parameters: {
+        type: "object",
+        properties: { objectName: { type: "string" }, fields: { type: "object" } },
+        required: ["objectName", "fields"]
+      },
+      request: { method: "POST", path: "/services/data/v61.0/sobjects/{objectName}", body: "{fields}" },
+      cas: "native-idempotency",
+      requiredScopes: ["api"]
+    },
+    {
+      name: "records.update",
+      class: "mutation",
+      description: "Update a Salesforce sObject record.",
+      parameters: {
+        type: "object",
+        properties: { objectName: { type: "string" }, recordId: { type: "string" }, fields: { type: "object" } },
+        required: ["objectName", "recordId", "fields"]
+      },
+      request: { method: "PATCH", path: "/services/data/v61.0/sobjects/{objectName}/{recordId}", body: "{fields}" },
+      cas: "etag-if-match",
+      requiredScopes: ["api"]
+    }
+  ]
+});
+
 // src/catalog.ts
 var riskRank = {
   read: 0,
@@ -3229,6 +3770,317 @@ function unique2(values) {
   return [...new Set(values)];
 }
 
+// src/coverage-catalog.ts
+var DEFAULT_PROVIDER_KINDS = ["first_party", "nango", "pipedream", "activepieces", "custom"];
+var COVERAGE_SPECS = [
+  ["gmail", "Gmail", "email", "email", "tier_0", "email,google,workspace,inbox"],
+  ["outlook-mail", "Outlook Mail", "email", "email", "tier_0", "email,microsoft,office,inbox"],
+  ["google-calendar", "Google Calendar", "calendar", "calendar", "tier_0", "calendar,google,workspace,scheduling"],
+  ["outlook-calendar", "Outlook Calendar", "calendar", "calendar", "tier_0", "calendar,microsoft,office,scheduling"],
+  ["slack", "Slack", "chat", "chat", "tier_0", "chat,collaboration,internal-comms"],
+  ["microsoft-teams", "Microsoft Teams", "chat", "chat", "tier_0", "chat,microsoft,collaboration"],
+  ["google-drive", "Google Drive", "storage", "storage", "tier_0", "files,google,workspace,storage"],
+  ["onedrive", "OneDrive", "storage", "storage", "tier_0", "files,microsoft,office,storage"],
+  ["dropbox", "Dropbox", "storage", "storage", "tier_1", "files,storage"],
+  ["box", "Box", "storage", "storage", "tier_1", "files,enterprise,storage"],
+  ["google-docs", "Google Docs", "docs", "docs", "tier_0", "docs,google,workspace"],
+  ["google-sheets", "Google Sheets", "database", "database", "tier_0", "sheets,spreadsheet,google,database"],
+  ["microsoft-excel", "Microsoft Excel", "database", "database", "tier_0", "sheets,spreadsheet,microsoft,database"],
+  ["notion", "Notion", "docs", "docs", "tier_0", "docs,wiki,knowledge"],
+  ["airtable", "Airtable", "database", "database", "tier_0", "database,spreadsheet,ops"],
+  ["coda", "Coda", "docs", "docs", "tier_1", "docs,wiki,ops"],
+  ["confluence", "Confluence", "docs", "docs", "tier_1", "docs,wiki,atlassian"],
+  ["sharepoint", "SharePoint", "storage", "storage", "tier_1", "files,microsoft,enterprise"],
+  ["hubspot", "HubSpot", "crm", "crm", "tier_0", "crm,sales,marketing"],
+  ["salesforce", "Salesforce", "crm", "crm", "tier_0", "crm,sales,enterprise"],
+  ["pipedrive", "Pipedrive", "crm", "crm", "tier_1", "crm,sales"],
+  ["zoho-crm", "Zoho CRM", "crm", "crm", "tier_1", "crm,sales"],
+  ["close", "Close", "crm", "crm", "tier_1", "crm,sales"],
+  ["attio", "Attio", "crm", "crm", "tier_1", "crm,sales,startups"],
+  ["linear", "Linear", "workflow", "project", "tier_0", "project,engineering,tickets"],
+  ["jira", "Jira", "workflow", "project", "tier_0", "project,engineering,tickets,atlassian"],
+  ["github", "GitHub", "workflow", "dev", "tier_0", "code,dev,issues,git"],
+  ["gitlab", "GitLab", "workflow", "dev", "tier_1", "code,dev,issues,git"],
+  ["bitbucket", "Bitbucket", "workflow", "dev", "tier_2", "code,dev,git,atlassian"],
+  ["asana", "Asana", "workflow", "project", "tier_1", "project,tasks"],
+  ["trello", "Trello", "workflow", "project", "tier_1", "project,tasks,atlassian"],
+  ["monday", "monday.com", "workflow", "project", "tier_1", "project,tasks,ops"],
+  ["clickup", "ClickUp", "workflow", "project", "tier_1", "project,tasks,ops"],
+  ["basecamp", "Basecamp", "workflow", "project", "tier_2", "project,tasks"],
+  ["zendesk", "Zendesk", "crm", "support", "tier_0", "support,tickets,customer-success"],
+  ["intercom", "Intercom", "crm", "support", "tier_0", "support,chat,customer-success"],
+  ["freshdesk", "Freshdesk", "crm", "support", "tier_1", "support,tickets"],
+  ["helpscout", "Help Scout", "crm", "support", "tier_1", "support,tickets"],
+  ["front", "Front", "email", "support", "tier_1", "support,email,shared-inbox"],
+  ["gorgias", "Gorgias", "crm", "support", "tier_1", "support,ecommerce"],
+  ["stripe", "Stripe", "workflow", "finance", "tier_0", "payments,billing,finance"],
+  ["quickbooks", "QuickBooks", "workflow", "finance", "tier_0", "accounting,finance"],
+  ["xero", "Xero", "workflow", "finance", "tier_1", "accounting,finance"],
+  ["netsuite", "NetSuite", "workflow", "finance", "tier_1", "erp,finance,enterprise"],
+  ["sage", "Sage", "workflow", "finance", "tier_2", "accounting,finance"],
+  ["plaid", "Plaid", "workflow", "finance", "tier_1", "banking,finance"],
+  ["shopify", "Shopify", "workflow", "commerce", "tier_0", "ecommerce,orders,commerce"],
+  ["woocommerce", "WooCommerce", "workflow", "commerce", "tier_1", "ecommerce,orders,wordpress"],
+  ["bigcommerce", "BigCommerce", "workflow", "commerce", "tier_1", "ecommerce,orders"],
+  ["amazon-seller-central", "Amazon Seller Central", "workflow", "commerce", "tier_1", "marketplace,ecommerce"],
+  ["ebay", "eBay", "workflow", "commerce", "tier_2", "marketplace,ecommerce"],
+  ["etsy", "Etsy", "workflow", "commerce", "tier_2", "marketplace,ecommerce"],
+  ["mailchimp", "Mailchimp", "workflow", "marketing", "tier_0", "email-marketing,marketing"],
+  ["klaviyo", "Klaviyo", "workflow", "marketing", "tier_0", "email-marketing,ecommerce,marketing"],
+  ["marketo", "Marketo", "workflow", "marketing", "tier_1", "marketing,enterprise"],
+  ["braze", "Braze", "workflow", "marketing", "tier_1", "marketing,lifecycle"],
+  ["customer-io", "Customer.io", "workflow", "marketing", "tier_1", "marketing,lifecycle"],
+  ["sendgrid", "SendGrid", "email", "email", "tier_1", "email,transactional"],
+  ["postmark", "Postmark", "email", "email", "tier_1", "email,transactional"],
+  ["twilio", "Twilio", "chat", "chat", "tier_0", "sms,voice,communications"],
+  ["discord", "Discord", "chat", "chat", "tier_1", "chat,community"],
+  ["telegram", "Telegram", "chat", "chat", "tier_1", "chat,community"],
+  ["whatsapp-business", "WhatsApp Business", "chat", "chat", "tier_1", "chat,meta,customer-comms"],
+  ["facebook-pages", "Facebook Pages", "workflow", "marketing", "tier_1", "social,meta,marketing"],
+  ["instagram-business", "Instagram Business", "workflow", "marketing", "tier_1", "social,meta,marketing"],
+  ["linkedin", "LinkedIn", "workflow", "sales", "tier_1", "social,sales,gtm"],
+  ["x-twitter", "X / Twitter", "workflow", "marketing", "tier_1", "social,marketing"],
+  ["youtube", "YouTube", "storage", "storage", "tier_1", "video,content"],
+  ["tiktok", "TikTok", "workflow", "marketing", "tier_2", "social,video,marketing"],
+  ["google-analytics", "Google Analytics", "database", "analytics", "tier_0", "analytics,web,marketing"],
+  ["mixpanel", "Mixpanel", "database", "analytics", "tier_1", "analytics,product"],
+  ["amplitude", "Amplitude", "database", "analytics", "tier_1", "analytics,product"],
+  ["segment", "Segment", "database", "analytics", "tier_1", "analytics,cdp"],
+  ["snowflake", "Snowflake", "database", "database", "tier_0", "warehouse,data"],
+  ["bigquery", "BigQuery", "database", "database", "tier_0", "warehouse,google,data"],
+  ["redshift", "Redshift", "database", "database", "tier_1", "warehouse,aws,data"],
+  ["postgres", "Postgres", "database", "database", "tier_0", "database,sql"],
+  ["mysql", "MySQL", "database", "database", "tier_1", "database,sql"],
+  ["mongodb", "MongoDB", "database", "database", "tier_1", "database,nosql"],
+  ["supabase", "Supabase", "database", "database", "tier_1", "database,postgres"],
+  ["firebase", "Firebase", "database", "database", "tier_1", "database,google,app"],
+  ["redis", "Redis", "database", "database", "tier_2", "database,cache"],
+  ["aws-s3", "Amazon S3", "storage", "storage", "tier_0", "files,aws,storage"],
+  ["aws-lambda", "AWS Lambda", "workflow", "dev", "tier_1", "aws,serverless,dev"],
+  ["aws-cloudwatch", "AWS CloudWatch", "database", "analytics", "tier_1", "aws,logs,observability"],
+  ["google-cloud-storage", "Google Cloud Storage", "storage", "storage", "tier_1", "files,gcp,storage"],
+  ["azure-blob-storage", "Azure Blob Storage", "storage", "storage", "tier_1", "files,azure,storage"],
+  ["vercel", "Vercel", "workflow", "dev", "tier_1", "deployments,dev"],
+  ["netlify", "Netlify", "workflow", "dev", "tier_2", "deployments,dev"],
+  ["cloudflare", "Cloudflare", "workflow", "dev", "tier_1", "edge,dev,dns"],
+  ["sentry", "Sentry", "workflow", "dev", "tier_1", "errors,observability,dev"],
+  ["datadog", "Datadog", "database", "analytics", "tier_1", "observability,logs,metrics"],
+  ["new-relic", "New Relic", "database", "analytics", "tier_2", "observability,logs,metrics"],
+  ["pagerduty", "PagerDuty", "workflow", "project", "tier_1", "incident,on-call"],
+  ["opsgenie", "Opsgenie", "workflow", "project", "tier_2", "incident,on-call,atlassian"],
+  ["okta", "Okta", "internal", "workflow", "tier_1", "identity,security"],
+  ["auth0", "Auth0", "internal", "workflow", "tier_1", "identity,security"],
+  ["workday", "Workday", "workflow", "hr", "tier_1", "hr,finance,enterprise"],
+  ["bamboohr", "BambooHR", "workflow", "hr", "tier_1", "hr,people"],
+  ["greenhouse", "Greenhouse", "workflow", "hr", "tier_1", "recruiting,hr"],
+  ["lever", "Lever", "workflow", "hr", "tier_1", "recruiting,hr"],
+  ["gusto", "Gusto", "workflow", "hr", "tier_1", "payroll,hr"],
+  ["rippling", "Rippling", "workflow", "hr", "tier_1", "hr,it,identity"],
+  ["docusign", "DocuSign", "docs", "docs", "tier_1", "contracts,signature,legal"],
+  ["pandadoc", "PandaDoc", "docs", "docs", "tier_1", "contracts,signature,sales"],
+  ["hellosign", "Dropbox Sign", "docs", "docs", "tier_2", "contracts,signature"],
+  ["clio", "Clio", "workflow", "project", "tier_1", "legal,practice-management"],
+  ["ironclad", "Ironclad", "docs", "docs", "tier_1", "legal,contracts"],
+  ["lexisnexis", "LexisNexis", "docs", "docs", "tier_2", "legal,research"],
+  ["calendly", "Calendly", "calendar", "calendar", "tier_0", "scheduling,calendar"],
+  ["cal-com", "Cal.com", "calendar", "calendar", "tier_1", "scheduling,calendar"],
+  ["zoom", "Zoom", "calendar", "calendar", "tier_0", "meetings,video,calendar"],
+  ["google-meet", "Google Meet", "calendar", "calendar", "tier_1", "meetings,google,video"],
+  ["microsoft-graph", "Microsoft Graph", "internal", "workflow", "tier_0", "microsoft,enterprise,identity"],
+  ["openai", "OpenAI", "workflow", "ai", "tier_0", "ai,llm"],
+  ["anthropic", "Anthropic", "workflow", "ai", "tier_1", "ai,llm"],
+  ["gemini", "Google Gemini", "workflow", "ai", "tier_1", "ai,llm,google"],
+  ["huggingface", "Hugging Face", "workflow", "ai", "tier_1", "ai,models"],
+  ["pinecone", "Pinecone", "database", "database", "tier_1", "vector,database,ai"],
+  ["weaviate", "Weaviate", "database", "database", "tier_1", "vector,database,ai"],
+  ["qdrant", "Qdrant", "database", "database", "tier_1", "vector,database,ai"],
+  ["zapier", "Zapier", "workflow", "workflow", "tier_1", "automation,workflow"],
+  ["make", "Make", "workflow", "workflow", "tier_1", "automation,workflow"],
+  ["nango", "Nango", "workflow", "workflow", "tier_1", "integration-platform,oauth"],
+  ["pipedream", "Pipedream", "workflow", "workflow", "tier_1", "integration-platform,workflow"],
+  ["activepieces", "Activepieces", "workflow", "workflow", "tier_1", "automation,workflow,open-source"],
+  ["webhook", "Generic Webhook", "webhook", "webhook", "tier_0", "webhook,http,events", "none"],
+  ["http", "HTTP Request", "workflow", "webhook", "tier_0", "http,api,webhook", "none"],
+  ["rss", "RSS", "webhook", "webhook", "tier_1", "feeds,content", "none"],
+  ["zapier-transfer", "Zapier Transfer", "workflow", "workflow", "long_tail", "automation,migration"],
+  ["typeform", "Typeform", "workflow", "marketing", "tier_1", "forms,marketing"],
+  ["google-forms", "Google Forms", "workflow", "marketing", "tier_1", "forms,google"],
+  ["jotform", "Jotform", "workflow", "marketing", "tier_2", "forms"],
+  ["webflow", "Webflow", "workflow", "marketing", "tier_1", "cms,website"],
+  ["wordpress", "WordPress", "workflow", "marketing", "tier_1", "cms,website"],
+  ["contentful", "Contentful", "docs", "docs", "tier_1", "cms,content"],
+  ["sanity", "Sanity", "docs", "docs", "tier_1", "cms,content"],
+  ["figma", "Figma", "docs", "docs", "tier_0", "design,creative"],
+  ["canva", "Canva", "docs", "docs", "tier_1", "design,creative"],
+  ["adobe-creative-cloud", "Adobe Creative Cloud", "storage", "storage", "tier_1", "design,creative,files"],
+  ["miro", "Miro", "docs", "docs", "tier_1", "whiteboard,collaboration"],
+  ["figjam", "FigJam", "docs", "docs", "tier_2", "whiteboard,design"]
+];
+function listIntegrationCoverageSpecs() {
+  return COVERAGE_SPECS.map(([id, title, category, actionPack2, priority, domains, auth = "oauth2"]) => ({
+    id,
+    title,
+    category,
+    actionPack: actionPack2,
+    priority,
+    auth,
+    providerKinds: providerKindsFor(auth),
+    domains: domains.split(",").map((domain) => domain.trim()).filter(Boolean),
+    scopes: scopesFor(id, actionPack2)
+  }));
+}
+function buildIntegrationCoverageConnectors(options = {}) {
+  const providerId = options.providerId ?? "coverage";
+  return listIntegrationCoverageSpecs().filter((spec) => !options.priorities || options.priorities.includes(spec.priority)).filter((spec) => !options.categories || options.categories.includes(spec.category)).filter((spec) => !options.actionPacks || options.actionPacks.includes(spec.actionPack)).map((spec) => specToConnector(spec, providerId));
+}
+function integrationCoverageChecklistMarkdown() {
+  const specs = listIntegrationCoverageSpecs();
+  const lines = [
+    "# Agent Integrations Coverage Checklist",
+    "",
+    "Generated from `listIntegrationCoverageSpecs()`. Catalog presence means the product can plan/request/connect the integration; executable first-party adapters are promoted separately behind the same provider contract.",
+    "",
+    "## Summary",
+    "",
+    `- Total cataloged integrations: ${specs.length}`,
+    `- Tier 0: ${specs.filter((spec) => spec.priority === "tier_0").length}`,
+    `- Tier 1: ${specs.filter((spec) => spec.priority === "tier_1").length}`,
+    `- Tier 2: ${specs.filter((spec) => spec.priority === "tier_2").length}`,
+    `- Long tail: ${specs.filter((spec) => spec.priority === "long_tail").length}`,
+    "",
+    "## Checklist",
+    ""
+  ];
+  for (const spec of specs) {
+    lines.push(`- [ ] ${spec.priority} / ${spec.category} / ${spec.title} (${spec.id}) - ${spec.domains.join(", ")}`);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function specToConnector(spec, providerId) {
+  const actions = actionPack(spec.actionPack, spec.scopes ?? []);
+  return {
+    id: spec.id,
+    providerId,
+    title: spec.title,
+    category: spec.category,
+    auth: spec.auth,
+    scopes: spec.scopes ?? [],
+    actions,
+    triggers: triggersFor(spec.actionPack, spec.scopes ?? []),
+    metadata: {
+      source: "coverage-catalog",
+      priority: spec.priority,
+      domains: spec.domains,
+      providerKinds: spec.providerKinds,
+      executable: false
+    }
+  };
+}
+function actionPack(pack, scopes) {
+  const readScope = scopes.find((scope2) => scope2.endsWith(".read")) ?? scopes[0];
+  const writeScope = scopes.find((scope2) => scope2.endsWith(".write")) ?? scopes[1] ?? readScope;
+  const scope = (value) => value ? [value] : [];
+  const read = (id, title, description) => ({
+    id,
+    title,
+    description,
+    risk: "read",
+    requiredScopes: scope(readScope),
+    dataClass: dataClassFor(pack),
+    inputSchema: objectSchema()
+  });
+  const write = (id, title, description) => ({
+    id,
+    title,
+    description,
+    risk: "write",
+    requiredScopes: scope(writeScope),
+    dataClass: dataClassFor(pack),
+    approvalRequired: true,
+    inputSchema: objectSchema()
+  });
+  const destructive = (id, title, description) => ({
+    id,
+    title,
+    description,
+    risk: "destructive",
+    requiredScopes: scope(writeScope),
+    dataClass: dataClassFor(pack),
+    approvalRequired: true,
+    inputSchema: objectSchema()
+  });
+  switch (pack) {
+    case "email":
+      return [read("messages.search", "Search messages", "Search messages and threads."), read("messages.read", "Read message", "Read a message by id."), write("drafts.create", "Create draft", "Create an email draft."), write("messages.send", "Send message", "Send or reply to an email message.")];
+    case "calendar":
+      return [read("events.search", "Search events", "Search calendar events."), read("availability.read", "Read availability", "Read availability windows."), write("events.create", "Create event", "Create a calendar event."), write("events.update", "Update event", "Update a calendar event."), destructive("events.cancel", "Cancel event", "Cancel a calendar event.")];
+    case "chat":
+      return [read("messages.search", "Search messages", "Search channel or direct messages."), read("channels.list", "List channels", "List channels or rooms."), write("messages.post", "Post message", "Post a message."), write("threads.reply", "Reply in thread", "Reply to a thread or conversation.")];
+    case "crm":
+      return [read("records.search", "Search records", "Search contacts, companies, and deals."), read("records.read", "Read record", "Read a CRM record."), write("records.upsert", "Upsert record", "Create or update a CRM record."), write("notes.create", "Create note", "Add a note or activity.")];
+    case "storage":
+      return [read("files.search", "Search files", "Search files and folders."), read("files.read", "Read file", "Read file metadata or content."), write("files.upload", "Upload file", "Upload a file."), write("files.update", "Update file", "Update file metadata or content.")];
+    case "docs":
+      return [read("documents.search", "Search documents", "Search documents or pages."), read("documents.read", "Read document", "Read a document."), write("documents.create", "Create document", "Create a document or page."), write("documents.update", "Update document", "Update a document or page.")];
+    case "database":
+      return [read("records.query", "Query records", "Query rows, records, or objects."), read("records.read", "Read record", "Read one row, record, or object."), write("records.upsert", "Upsert record", "Create or update a row, record, or object."), destructive("records.delete", "Delete record", "Delete a row, record, or object.")];
+    case "project":
+      return [read("tasks.search", "Search tasks", "Search tasks, tickets, or issues."), read("tasks.read", "Read task", "Read a task, ticket, or issue."), write("tasks.create", "Create task", "Create a task, ticket, or issue."), write("tasks.update", "Update task", "Update a task, ticket, or issue.")];
+    case "support":
+      return [read("tickets.search", "Search tickets", "Search support tickets or conversations."), read("customers.read", "Read customer", "Read a customer profile."), write("tickets.reply", "Reply to ticket", "Reply to a support ticket."), write("tickets.update", "Update ticket", "Update ticket status, tags, or assignee.")];
+    case "marketing":
+      return [read("contacts.search", "Search contacts", "Search marketing contacts or audiences."), read("campaigns.read", "Read campaign", "Read campaign metadata and performance."), write("contacts.upsert", "Upsert contact", "Create or update a contact."), write("campaigns.create", "Create campaign", "Create a campaign draft.")];
+    case "sales":
+      return [read("prospects.search", "Search prospects", "Search prospects, leads, or accounts."), read("activities.read", "Read activities", "Read sales activity history."), write("prospects.upsert", "Upsert prospect", "Create or update a prospect."), write("sequence.enqueue", "Enroll in sequence", "Enroll a prospect in a sales sequence.")];
+    case "commerce":
+      return [read("orders.search", "Search orders", "Search orders."), read("customers.read", "Read customer", "Read customer and purchase history."), write("orders.update", "Update order", "Update order metadata or fulfillment state."), write("products.update", "Update product", "Update product metadata.")];
+    case "finance":
+      return [read("transactions.search", "Search transactions", "Search transactions, invoices, or payments."), read("accounts.read", "Read account", "Read account or customer financial record."), write("invoices.create", "Create invoice", "Create an invoice or payment object."), write("records.sync", "Sync record", "Sync a finance or accounting record.")];
+    case "hr":
+      return [read("people.search", "Search people", "Search employees, candidates, or contractors."), read("people.read", "Read person", "Read a person profile."), write("people.update", "Update person", "Update a person profile."), write("events.create", "Create HR event", "Create a recruiting or HR event.")];
+    case "dev":
+      return [read("resources.search", "Search resources", "Search issues, repos, deployments, logs, or incidents."), read("resources.read", "Read resource", "Read a developer resource."), write("resources.create", "Create resource", "Create an issue, deployment, incident, or config."), write("resources.update", "Update resource", "Update a developer resource.")];
+    case "ai":
+      return [read("models.list", "List models", "List available models or endpoints."), write("responses.create", "Create response", "Create an AI response or job."), write("embeddings.create", "Create embeddings", "Create embeddings or vector jobs."), read("usage.read", "Read usage", "Read usage metadata.")];
+    case "analytics":
+      return [read("reports.query", "Query reports", "Query analytics reports."), read("events.search", "Search events", "Search analytics events."), write("events.track", "Track event", "Track an analytics event."), write("audiences.sync", "Sync audience", "Sync an audience or cohort.")];
+    case "workflow":
+      return [read("runs.search", "Search runs", "Search workflow runs or jobs."), read("templates.list", "List templates", "List workflow templates."), write("runs.start", "Start run", "Start a workflow run."), write("webhooks.dispatch", "Dispatch webhook", "Dispatch a workflow webhook.")];
+    case "webhook":
+      return [write("requests.send", "Send request", "Send an HTTP request or webhook event."), read("events.search", "Search events", "Search received webhook events."), write("subscriptions.create", "Create subscription", "Create a webhook subscription."), destructive("subscriptions.delete", "Delete subscription", "Delete a webhook subscription.")];
+  }
+}
+function triggersFor(pack, scopes) {
+  const readScope = scopes.find((scope) => scope.endsWith(".read")) ?? scopes[0];
+  const requiredScopes = readScope ? [readScope] : [];
+  if (pack === "email") return [{ id: "message.received", title: "Message received", requiredScopes, dataClass: "private" }];
+  if (pack === "calendar") return [{ id: "event.changed", title: "Event changed", requiredScopes, dataClass: "private" }];
+  if (pack === "chat") return [{ id: "message.posted", title: "Message posted", requiredScopes, dataClass: "private" }];
+  if (pack === "crm") return [{ id: "record.changed", title: "Record changed", requiredScopes, dataClass: "private" }];
+  if (pack === "support") return [{ id: "ticket.changed", title: "Ticket changed", requiredScopes, dataClass: "private" }];
+  if (pack === "commerce") return [{ id: "order.changed", title: "Order changed", requiredScopes, dataClass: "sensitive" }];
+  if (pack === "finance") return [{ id: "transaction.changed", title: "Transaction changed", requiredScopes, dataClass: "sensitive" }];
+  if (pack === "workflow" || pack === "webhook") return [{ id: "event.received", title: "Event received", requiredScopes, dataClass: "internal" }];
+  return void 0;
+}
+function scopesFor(id, pack) {
+  if (pack === "webhook") return [];
+  return [`${id}.read`, `${id}.write`];
+}
+function providerKindsFor(auth) {
+  if (auth === "none") return ["first_party", "pipedream", "activepieces", "custom"];
+  return DEFAULT_PROVIDER_KINDS;
+}
+function dataClassFor(pack) {
+  if (pack === "finance" || pack === "commerce" || pack === "hr") return "sensitive";
+  if (pack === "workflow" || pack === "webhook" || pack === "dev" || pack === "analytics") return "internal";
+  return "private";
+}
+function objectSchema() {
+  return { type: "object", additionalProperties: true, properties: {} };
+}
+
 // src/index.ts
 var IntegrationError = class extends Error {
   constructor(message, code) {
@@ -3563,8 +4415,11 @@ export {
   ResourceContention,
   StaticIntegrationPolicyEngine,
   _resetPendingFlowsForTests,
+  airtableConnector,
+  asanaConnector,
   assertValidConnectorManifest,
   buildApprovalRequest,
+  buildIntegrationCoverageConnectors,
   buildIntegrationInvocationEnvelope,
   buildIntegrationToolCatalog,
   consumePendingFlow,
@@ -3572,16 +4427,21 @@ export {
   createDefaultIntegrationPolicyEngine,
   createHttpIntegrationProvider,
   createMockIntegrationProvider,
+  declarativeRestConnector,
   exchangeAuthorizationCode,
   firstHeader,
+  githubConnector,
+  gitlabConnector,
   googleCalendar,
   googleSheets,
   hubspot,
   importGraphqlConnector,
   importMcpConnector,
   importOpenApiConnector,
+  integrationCoverageChecklistMarkdown,
   integrationToolName,
   invocationRequestFromEnvelope,
+  listIntegrationCoverageSpecs,
   manifestToConnector,
   microsoftCalendar,
   normalizeIntegrationResult,
@@ -3592,6 +4452,7 @@ export {
   redactCapability,
   redactInvocationEnvelope,
   refreshAccessToken,
+  salesforceConnector,
   sanitizeConnection,
   searchIntegrationTools,
   signCapability,