@tangle-network/agent-integrations 0.6.0 → 0.7.1

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,
@@ -3874,6 +4415,8 @@ export {
   ResourceContention,
   StaticIntegrationPolicyEngine,
   _resetPendingFlowsForTests,
+  airtableConnector,
+  asanaConnector,
   assertValidConnectorManifest,
   buildApprovalRequest,
   buildIntegrationCoverageConnectors,
@@ -3884,8 +4427,11 @@ export {
   createDefaultIntegrationPolicyEngine,
   createHttpIntegrationProvider,
   createMockIntegrationProvider,
+  declarativeRestConnector,
   exchangeAuthorizationCode,
   firstHeader,
+  githubConnector,
+  gitlabConnector,
   googleCalendar,
   googleSheets,
   hubspot,
@@ -3906,6 +4452,7 @@ export {
   redactCapability,
   redactInvocationEnvelope,
   refreshAccessToken,
+  salesforceConnector,
   sanitizeConnection,
   searchIntegrationTools,
   signCapability,