@arbium/enterprise-agent-connect 0.1.2-dev.d2aa5ca → 0.2.1-dev.7b4e802

package/dist/connectors/cvent/connector.json

@@ -0,0 +1,287 @@
+{
+  "id": "cvent",
+  "name": "Cvent",
+  "description": "Let agents read your Cvent events: who was invited and who registered, attended or declined, each event's invitation lists and its exhibitors and sponsors. For reconciling RSVPs and matching delegates to sponsors.",
+  "logo": "/brand/registry/cvent.svg",
+  "identity": "A Cvent REST API application (machine to machine). It reads with the scopes you give its workspace, across every event in your Cvent account.",
+  "accountKey": "host",
+  "connectionKind": "guided",
+  "setup": [
+    {
+      "title": "Create a REST API workspace",
+      "body": "You need a Cvent administrator for this. Give the workspace only the read scopes below. If you are not a developer on it yourself, invite yourself (or whoever finishes setup) under Developers. This connection works with Cvent accounts in the North American data center.",
+      "link": {
+        "label": "Cvent: inviting developers to your workspace",
+        "href": "https://developers.cvent.com/docs/rest-api/tutorials/inviting-your-developers"
+      },
+      "click": [
+        "In Cvent, hover over the global navigation and select Admin, then under Integrations select REST API.",
+        "Select + Create Workspace, name it Agents, tick only the scopes below, then Save.",
+        "On the Developers tab, select + Invite Developers, enter the email of whoever finishes setup, select the Agents workspace, then Send."
+      ],
+      "copy": ["{scope}"]
+    },
+    {
+      "title": "Create a machine to machine application",
+      "body": "Sign in to the Cvent Developer Portal as that developer and create an application in the Agents workspace with the same scopes. Copy its client ID and client secret for the form below.",
+      "link": {
+        "label": "Cvent: making your first API call",
+        "href": "https://developers.cvent.com/docs/rest-api/tutorials/developer-quickstart"
+      },
+      "click": [
+        "In the Cvent Developer Portal, go to Applications and select Create application.",
+        "Enter a name such as Agents, select Machine to machine, assign the scopes below, then Save.",
+        "Select View applications and copy the Client ID and Client secret."
+      ],
+      "copy": ["{scope}"]
+    },
+    {
+      "title": "Check what people agreed to",
+      "body": "Attendee and contact records hold names, emails, companies and registration answers. Make sure your event privacy notices allow agents to read them, and give contact lookups only to agents that need them.",
+      "click": ["Ask your privacy or events team whether attendee data may be read by AI agents."],
+      "confirm": "cvent-attendee-data"
+    }
+  ],
+  "afterConnect": [],
+  "fields": [
+    {
+      "id": "client_id",
+      "label": "Client ID",
+      "secret": false
+    },
+    {
+      "id": "client_secret",
+      "label": "Client secret",
+      "secret": true
+    }
+  ],
+  "capabilities": [
+    {
+      "id": "read_events",
+      "label": "Read events and attendees",
+      "description": "List and read events, list attendees (invitees, registrants and their status, invitation list and check-in), read one attendee, and list an event's invitation lists.",
+      "required": true,
+      "note": "Reaches every event in the account unless you keep an agent to chosen events.",
+      "scopes": ["event/events:read", "event/attendees:read", "event/invitation-lists:read"],
+      "permissions": [],
+      "tools": [
+        "cvent_list_events",
+        "cvent_get_event",
+        "cvent_list_attendees",
+        "cvent_get_attendee",
+        "cvent_list_invitation_lists"
+      ]
+    },
+    {
+      "id": "read_exhibitors",
+      "label": "Read exhibitors and sponsors",
+      "description": "List an event's exhibitors and sponsors, with their sponsorship level, and the event's sponsorship levels.",
+      "scopes": ["exhibitor/exhibitors:read", "exhibitor/sponsorship-levels:read"],
+      "permissions": [],
+      "tools": ["cvent_list_exhibitors", "cvent_list_sponsorship_levels"]
+    },
+    {
+      "id": "read_contacts",
+      "label": "Look up contacts",
+      "description": "Read a contact's name, email, company and title from your Cvent address book.",
+      "note": "Contacts are account-wide, not limited to chosen events.",
+      "scopes": ["event/contacts:read"],
+      "permissions": [],
+      "tools": ["cvent_get_contact"]
+    }
+  ],
+  "limits": [
+    {
+      "id": "events",
+      "label": "Events",
+      "help": "Optional: only these Cvent events (their ids). Event and attendee lists must then be filtered to them, such as id eq '<id>' for events and event.id eq '<id>' for attendees. Leave empty for every event.",
+      "kind": "list",
+      "required": false,
+      "pattern": "^[0-9A-Fa-f-]{36}$"
+    }
+  ],
+  "verify": {
+    "method": "GET",
+    "path": "/events?limit=5",
+    "label": "Cvent events",
+    "show": "data[].title"
+  },
+  "revoke": "In the Cvent Developer Portal, go to Applications and delete the application (turn off Termination Protection first if it is on). Agents lose access to Cvent at once.",
+  "http": {
+    "baseUrl": "https://api-platform.cvent.com/ea",
+    "auth": {
+      "type": "oauth2",
+      "tokenUrl": "https://api-platform.cvent.com/ea/oauth2/token",
+      "clientId": "client_id",
+      "clientSecret": "client_secret",
+      "clientAuth": "basic"
+    },
+    "tools": [
+      {
+        "name": "cvent_list_events",
+        "description": "List events, newest changes first unless sorted. Filter with Cvent's filter syntax, e.g. title contains 'Summit' and start ge '2026-01-01T00:00:00Z'.",
+        "method": "GET",
+        "path": "/events",
+        "params": {
+          "filter": {
+            "type": "string",
+            "description": "Cvent filter, e.g. status eq 'Active' (fields: id, title, code, start, end, status, format, venue.address.city)",
+            "in": "query",
+            "required": false
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort order, start:ASC or start:DESC",
+            "in": "query",
+            "required": false,
+            "enum": ["start:ASC", "start:DESC"]
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Events per page, up to 200",
+            "in": "query",
+            "default": 50
+          },
+          "token": {
+            "type": "string",
+            "description": "The next page's cursor, from the previous answer",
+            "in": "query",
+            "required": false
+          }
+        },
+        "answerLimits": [{ "field": "data.id", "limit": "events" }],
+        "result": {
+          "items": "data",
+          "fields": ["id", "title", "code", "start", "end", "timezone", "status", "format", "capacity", "venues.name"]
+        },
+        "paging": { "param": "token", "body": "paging.nextToken" }
+      },
+      {
+        "name": "cvent_get_event",
+        "description": "Read one event by its id: dates, venue, status, capacity, planners and custom fields.",
+        "method": "GET",
+        "path": "/events/{event_id}",
+        "params": {
+          "event_id": { "type": "string", "description": "The event id", "in": "path", "limit": "events" }
+        }
+      },
+      {
+        "name": "cvent_list_attendees",
+        "description": "List attendees (invitees and registrants) with their status, invitation list, registration type and check-in. Filter to one event with event.id eq '<id>'; add status eq 'Accepted' (or Declined, Invited, No Response, Cancelled) to reconcile RSVPs.",
+        "method": "GET",
+        "path": "/attendees",
+        "params": {
+          "filter": {
+            "type": "string",
+            "description": "Cvent filter, e.g. event.id eq '<id>' and invitationList.id eq '<id>' (fields: event.id, invitationList.id, registrationType.id, checkedIn, registeredAt)",
+            "in": "query",
+            "required": false
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Attendees per page, up to 200",
+            "in": "query",
+            "default": 100
+          },
+          "token": {
+            "type": "string",
+            "description": "The next page's cursor, from the previous answer",
+            "in": "query",
+            "required": false
+          }
+        },
+        "answerLimits": [{ "field": "data.event.id", "limit": "events" }],
+        "result": {
+          "items": "data",
+          "fields": [
+            "id",
+            "event.id",
+            "contact.id",
+            "contact.firstName",
+            "contact.lastName",
+            "contact.email",
+            "contact.company",
+            "contact.title",
+            "status",
+            "invitationList.id",
+            "registrationType.id",
+            "registeredAt",
+            "registrationCancelledAt",
+            "responseMethod",
+            "checkedIn",
+            "guest"
+          ]
+        },
+        "paging": { "param": "token", "body": "paging.nextToken" }
+      },
+      {
+        "name": "cvent_get_attendee",
+        "description": "Read one attendee by id, with their registration answers.",
+        "method": "GET",
+        "path": "/attendees/{attendee_id}",
+        "params": {
+          "attendee_id": { "type": "string", "description": "The attendee id", "in": "path" }
+        },
+        "answerLimits": [{ "field": "event.id", "limit": "events" }]
+      },
+      {
+        "name": "cvent_list_invitation_lists",
+        "description": "List an event's invitation lists, the waves invitees are grouped in.",
+        "method": "GET",
+        "path": "/events/{event_id}/invitation-lists",
+        "params": {
+          "event_id": { "type": "string", "description": "The event id", "in": "path", "limit": "events" },
+          "token": {
+            "type": "string",
+            "description": "The next page's cursor, from the previous answer",
+            "in": "query",
+            "required": false
+          }
+        },
+        "result": { "items": "data", "fields": ["id", "name", "default", "locale"] },
+        "paging": { "param": "token", "body": "paging.nextToken" }
+      },
+      {
+        "name": "cvent_list_exhibitors",
+        "description": "List an event's exhibitors and sponsors, with whether each is a sponsor and its sponsorship level.",
+        "method": "GET",
+        "path": "/events/{event_id}/exhibitors",
+        "params": {
+          "event_id": { "type": "string", "description": "The event id", "in": "path", "limit": "events" },
+          "token": {
+            "type": "string",
+            "description": "The next page's cursor, from the previous answer",
+            "in": "query",
+            "required": false
+          }
+        },
+        "result": {
+          "items": "data",
+          "fields": ["id", "name", "description", "website", "email", "eventSponsor", "featured", "sponsorshipLevel", "hidden"]
+        },
+        "paging": { "param": "token", "body": "paging.nextToken" }
+      },
+      {
+        "name": "cvent_list_sponsorship_levels",
+        "description": "List an event's sponsorship levels.",
+        "method": "GET",
+        "path": "/events/{event_id}/sponsorship-levels",
+        "params": {
+          "event_id": { "type": "string", "description": "The event id", "in": "path", "limit": "events" }
+        }
+      },
+      {
+        "name": "cvent_get_contact",
+        "description": "Read one contact by id: name, email, company, title and work address.",
+        "method": "GET",
+        "path": "/contacts/{contact_id}",
+        "params": {
+          "contact_id": { "type": "string", "description": "The contact id (an attendee's contact.id)", "in": "path" }
+        },
+        "result": {
+          "fields": ["id", "firstName", "lastName", "email", "company", "title", "designation", "type.name", "workAddress", "workPhone", "optOut"]
+        }
+      }
+    ]
+  }
+}

package/dist/connectors/datadog/connector.json

@@ -0,0 +1,188 @@
+{
+  "id": "datadog",
+  "name": "Datadog",
+  "description": "Let agents read your Datadog monitors and what triggered them, search events and logs, and query metrics. For first response to production alerts and incident summaries.",
+  "logo": "/brand/registry/datadog.svg",
+  "identity": "A Datadog API key and an application key of a service account made for agents. The application key carries the service account's role, narrowed to the scopes you choose.",
+  "accountKey": "host",
+  "connectionKind": "guided",
+  "setup": [
+    {
+      "title": "Create a service account for agents",
+      "body": "Give the service account the Datadog Read Only Role, so nothing it holds can change your monitors or settings.",
+      "link": {
+        "label": "Datadog: service accounts",
+        "href": "https://docs.datadoghq.com/account_management/org_settings/service_accounts/"
+      },
+      "click": [
+        "In Datadog, open Organization Settings, then under Accounts select Service Accounts > New Service Account.",
+        "Name: AI agents. Assign Roles: Datadog Read Only Role. Select Create Service Account."
+      ]
+    },
+    {
+      "title": "Create its application key",
+      "body": "Create the key on the service account and limit it to the scopes of what agents may read: monitors_read and events_read always, logs_read_data for logs and timeseries_query for metrics. Datadog shows the key only once.",
+      "link": {
+        "label": "Datadog: API and application keys",
+        "href": "https://docs.datadoghq.com/account_management/api-app-keys/"
+      },
+      "click": [
+        "On the Service Accounts page, select AI agents, then New Key. Name: AI agents. Select Create Key and copy it.",
+        "Edit the key's scopes and keep only monitors_read, events_read, logs_read_data and timeseries_query (the last two only if you allow them below)."
+      ]
+    },
+    {
+      "title": "Create an API key and find your API address",
+      "body": "Datadog wants an API key beside the application key. The API address depends on your Datadog site: api.datadoghq.com for app.datadoghq.com, api.us3.datadoghq.com, api.us5.datadoghq.com, api.datadoghq.eu, api.ap1.datadoghq.com, and so on. You can test both keys with the command below: it counts your monitors and changes nothing.",
+      "click": [
+        "Organization Settings > API Keys > New Key. Name: AI agents. Select Create API key and copy it.",
+        "Your site is in your browser's address bar while you are in Datadog. For app.datadoghq.com or app.datadoghq.eu the API address puts api in place of app; for a site such as us3.datadoghq.com it adds api. in front, as in api.us3.datadoghq.com."
+      ],
+      "copy": [
+        "DD_API=api.datadoghq.com",
+        "curl -s -H \"DD-API-KEY: $DD_API_KEY\" -H \"DD-APPLICATION-KEY: $DD_APP_KEY\" \"https://$DD_API/api/v1/monitor/search?per_page=1\""
+      ],
+      "shell": "bash"
+    }
+  ],
+  "afterConnect": [],
+  "fields": [
+    {
+      "id": "host",
+      "label": "API address",
+      "help": "Your Datadog site's API address, such as api.datadoghq.com or api.datadoghq.eu.",
+      "placeholder": "api.datadoghq.com",
+      "secret": false
+    },
+    { "id": "api_key", "label": "API key", "secret": true },
+    { "id": "application_key", "label": "Application key", "secret": true }
+  ],
+  "capabilities": [
+    {
+      "id": "read_monitors",
+      "label": "Read monitors and events",
+      "description": "Search monitors by status, tag or name, read one monitor with its query and the state of each group, and search events such as monitor alerts and deployments.",
+      "required": true,
+      "note": "Read-only. Reaches every monitor and event in your Datadog organization.",
+      "scopes": ["monitors_read", "events_read"],
+      "permissions": [],
+      "tools": ["datadog_search_monitors", "datadog_get_monitor", "datadog_search_events"]
+    },
+    {
+      "id": "read_logs",
+      "label": "Search logs",
+      "description": "Search logs by query and time, such as the errors of one service around an alert.",
+      "note": "Logs can hold customer data and secrets your applications wrote to them. Anything an agent reads may end up in what it writes.",
+      "scopes": ["logs_read_data"],
+      "permissions": [],
+      "tools": ["datadog_search_logs"]
+    },
+    {
+      "id": "read_metrics",
+      "label": "Query metrics",
+      "description": "Read a metric query's values over a time window, such as error rate or latency around an alert.",
+      "scopes": ["timeseries_query"],
+      "permissions": [],
+      "tools": ["datadog_query_metrics"]
+    }
+  ],
+  "limits": [],
+  "verify": {
+    "method": "GET",
+    "path": "/api/v1/monitor/search?per_page=1",
+    "label": "Monitors in Datadog",
+    "show": "metadata.total_count"
+  },
+  "revoke": "In Datadog, open Organization Settings > Service Accounts, select AI agents and revoke its application key, then delete the API key under API Keys. Agents lose access to Datadog at once.",
+  "http": {
+    "baseUrl": "https://{host}",
+    "allowedHosts": ["*.datadoghq.com", "*.datadoghq.eu", "*.ddog-gov.com"],
+    "auth": { "type": "header", "header": "DD-API-KEY", "value": "api_key" },
+    "fieldHeaders": { "DD-APPLICATION-KEY": "application_key" },
+    "tools": [
+      {
+        "name": "datadog_search_monitors",
+        "description": "Search monitors with Datadog's monitor search syntax, such as status:alert or tag:service:checkout. Pass page to read further pages, from 0.",
+        "method": "GET",
+        "path": "/api/v1/monitor/search",
+        "params": {
+          "query": { "type": "string", "description": "The search, such as status:alert tag:env:prod", "in": "query", "required": false },
+          "page": { "type": "integer", "description": "The page, from 0", "in": "query", "default": 0 },
+          "per_page": { "type": "integer", "description": "Monitors per page", "in": "query", "default": 30 }
+        },
+        "result": {
+          "fields": [
+            "metadata.total_count",
+            "monitors.id",
+            "monitors.name",
+            "monitors.status",
+            "monitors.type",
+            "monitors.tags",
+            "monitors.query",
+            "monitors.last_triggered_ts"
+          ]
+        }
+      },
+      {
+        "name": "datadog_get_monitor",
+        "description": "Read one monitor: its query, message, thresholds, tags and the state of each group, such as which hosts are alerting.",
+        "method": "GET",
+        "path": "/api/v1/monitor/{monitor_id}",
+        "params": {
+          "monitor_id": { "type": "integer", "description": "The monitor id", "in": "path" },
+          "group_states": { "type": "string", "description": "Which group states to include: all, or a comma-separated list of alert, warn and no data", "in": "query", "default": "all" }
+        }
+      },
+      {
+        "name": "datadog_search_events",
+        "description": "Search events, such as monitor alerts, deployments and configuration changes, with Datadog's event search syntax. Pass next from the answer as cursor for the next page.",
+        "method": "GET",
+        "path": "/api/v2/events",
+        "params": {
+          "query": { "type": "string", "description": "The search, such as source:deploy service:checkout", "in": "query", "name": "filter[query]", "required": false },
+          "from": { "type": "string", "description": "Start of the window, milliseconds since 1970", "in": "query", "name": "filter[from]", "required": false },
+          "to": { "type": "string", "description": "End of the window, milliseconds since 1970", "in": "query", "name": "filter[to]", "required": false },
+          "sort": { "type": "string", "enum": ["timestamp", "-timestamp"], "description": "Oldest or newest first", "in": "query", "default": "-timestamp" },
+          "limit": { "type": "integer", "description": "Events per page", "in": "query", "name": "page[limit]", "default": 25 },
+          "cursor": { "type": "string", "description": "The next value of the previous answer", "in": "query", "name": "page[cursor]", "required": false }
+        },
+        "paging": { "param": "cursor", "body": "meta.page.after" },
+        "result": {
+          "items": "data",
+          "fields": ["id", "attributes.timestamp", "attributes.message", "attributes.tags", "attributes.attributes.title", "attributes.attributes.status", "attributes.attributes.service"]
+        }
+      },
+      {
+        "name": "datadog_search_logs",
+        "description": "Search logs with Datadog's log search syntax, such as service:checkout status:error. Pass next from the answer as cursor for the next page.",
+        "method": "GET",
+        "path": "/api/v2/logs/events",
+        "params": {
+          "query": { "type": "string", "description": "The search, such as service:checkout status:error", "in": "query", "name": "filter[query]" },
+          "from": { "type": "string", "description": "Start of the window, a time such as 2026-10-01T08:00:00Z", "in": "query", "name": "filter[from]" },
+          "to": { "type": "string", "description": "End of the window, a time such as 2026-10-01T09:00:00Z", "in": "query", "name": "filter[to]" },
+          "sort": { "type": "string", "enum": ["timestamp", "-timestamp"], "description": "Oldest or newest first", "in": "query", "default": "-timestamp" },
+          "limit": { "type": "integer", "description": "Logs per page, at most 1000", "in": "query", "name": "page[limit]", "default": 50 },
+          "cursor": { "type": "string", "description": "The next value of the previous answer", "in": "query", "name": "page[cursor]", "required": false }
+        },
+        "paging": { "param": "cursor", "body": "meta.page.after" },
+        "result": {
+          "items": "data",
+          "fields": ["attributes.timestamp", "attributes.status", "attributes.service", "attributes.host", "attributes.message", "attributes.tags"]
+        }
+      },
+      {
+        "name": "datadog_query_metrics",
+        "description": "Read a metric query's points over a time window, such as avg:trace.http.request.errors{service:checkout}.as_count().",
+        "method": "GET",
+        "path": "/api/v1/query",
+        "params": {
+          "query": { "type": "string", "description": "The metric query", "in": "query" },
+          "from": { "type": "integer", "description": "Start of the window, seconds since 1970", "in": "query" },
+          "to": { "type": "integer", "description": "End of the window, seconds since 1970", "in": "query" }
+        },
+        "result": { "fields": ["status", "error", "series.metric", "series.scope", "series.pointlist", "series.unit"] }
+      }
+    ]
+  }
+}