The Open Framework for Building Agents
feat(registry): add Sent connection (#5249)
Colton Paddend34c52494511
diff --git a/apps/docs/lib/integrations/connection-setup.test.ts b/apps/docs/lib/integrations/connection-setup.test.tsindex 1d61f96e0..8ad279cfd 100644--- a/apps/docs/lib/integrations/connection-setup.test.ts+++ b/apps/docs/lib/integrations/connection-setup.test.ts@@ -1,6 +1,6 @@import { readFileSync } from "node:fs";-import { describe, expect, it } from "vitest";+import { describe, expect, it, vi } from "vitest";import {buildConnectionInstall,@@ -9,6 +9,12 @@ import {} from "./connection-setup";import { getIntegration } from "./data";import { integrationMarkdown } from "./discovery";+import sentConnection from "../../registry/connections/sent";++// Connect's runtime pulls in channel auth; these tests exercise only the authored approval policy.+vi.mock("@vercel/connect/eve", () => ({+ connect: () => ({ getToken: async () => ({ token: "" }) }),+}));describe("Browser Use connection setup", () => {it("generates server-side header authentication without Connect", () => {@@ -102,6 +108,35 @@ describe("FLORA connection setup", () => {});});+describe("Sent connection setup", () => {+ it("preserves the installed tool boundary in the gallery setup", () => {+ const integration = getIntegration("sent")!;+ const setup = buildConnectionSetup(integration);+ const quickStart = integration.quickStart!;++ expect(setup.authModes).toEqual(["user"]);+ expect(setup.variants["mcp:user"]).toContain('url: "https://mcp.sent.dm/mcp"');+ expect(setup.variants["mcp:user"]).toContain('auth: connect("sent")');+ expect(setup.configureVariants["mcp:user"]).toContain(+ "vercel connect create mcp.sent.dm --name sent",+ );+ expect(buildConnectionInstall(integration)).toContain("eve add connection/sent");+ expect(quickStart).toContain("approval: ({ toolName }) =>");+ expect(quickStart).toContain('? "user-approval"');+ expect(quickStart).toContain(': "not-applicable"');++ const { tools } = sentConnection;+ if (!tools || !("allow" in tools)) {+ throw new Error("Sent requires a tool allowlist.");+ }+ for (const toolName of tools.allow) {+ expect(quickStart).toContain(`"${toolName}"`);+ }++ expect(integrationMarkdown(integration)).toContain(quickStart);+ });+});+describe("Neon connection setup", () => {it("generates the registry install and Vercel Connect configuration", () => {const integration = getIntegration("neon")!;diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.tsindex 0abd6210f..e5a9af943 100644--- a/apps/docs/lib/integrations/data.ts+++ b/apps/docs/lib/integrations/data.ts@@ -2079,6 +2079,74 @@ const connectionPresentations: Record<string, ConnectionPresentation> = {authModes: ["user", "app"],relatedResources: [softwareFactoryGuide],},+ sent: {+ logo: "sent",+ docsHref: "https://docs.sent.dm/start/llm-docs/mcp-server",+ keywords: [+ "mcp",+ "sms",+ "whatsapp",+ "rcs",+ "business messaging",+ "deliverability",+ "oauth",+ "connect",+ ],+ authModes: ["user"],+ connectors: { user: { service: "mcp.sent.dm", name: "sent" } },+ quickStart: `Create \`agent/connections/sent.ts\`. The connection name is derived from the filename:++\`\`\`ts+// agent/connections/sent.ts+import { connect } from "@vercel/connect/eve";+import { defineMcpClientConnection } from "eve/connections";++const APPROVAL_REQUIRED = new Set([+ "messages.send",+ "contacts.create_many",+ "contacts.delete",+ "templates.delete",+]);++export default defineMcpClientConnection({+ url: "https://mcp.sent.dm/mcp",+ description:+ "Sent business messaging: send and track SMS, WhatsApp, and RCS; manage contacts and templates; inspect analytics, balance, and account readiness.",+ auth: connect("sent"),+ tools: {+ allow: [+ "account.get",+ "balance.get",+ "contacts.create_many",+ "contacts.delete",+ "contacts.get",+ "contacts.list",+ "contacts.message_summary",+ "dashboard.contacts",+ "dashboard.deliverability",+ "dashboard.messages_sent",+ "messages.activities.list",+ "messages.get",+ "messages.send",+ "numbers.lookup",+ "onboarding.status",+ "templates.delete",+ "templates.get",+ "templates.get_by_name",+ "templates.list",+ ],+ },+ approval: ({ toolName }) =>+ APPROVAL_REQUIRED.has(toolName.split("__").pop() ?? toolName)+ ? "user-approval"+ : "not-applicable",+});+\`\`\`++The allowlist limits the connection to the reviewed Sent tools. eve requires user approval before sending a message, creating or deleting contacts, or deleting a template.`,+ configureNote:+ "Sends real SMS, WhatsApp, and RCS messages. Sending messages, creating or deleting contacts, and deleting templates require approval; Sender Profile, compliance, and feedback tools aren't exposed. Revoke access by deactivating the connection key in Sent Dashboard → API Keys.",+ },notion: {logo: "notion",docsHref: "/docs/connections",diff --git a/apps/docs/lib/integrations/logos.tsx b/apps/docs/lib/integrations/logos.tsxindex c15547edd..748243b6c 100644--- a/apps/docs/lib/integrations/logos.tsx+++ b/apps/docs/lib/integrations/logos.tsx@@ -50,6 +50,16 @@ const eveLogo = (props: LogoProps) => (</svg>);+const sentLogo = (props: LogoProps) => (+ <svg viewBox="0 0 188 188" xmlns="http://www.w3.org/2000/svg" {...props}>+ <rect fill="#030712" height="188" rx="32" width="188" />+ <g fill="#fff" transform="translate(0 6)">+ <path d="M76.9 46.17c-3.09-1.17-4.65-4.62-3.48-7.71L84.97 7.87c1.17-3.09 4.62-4.65 7.7-3.48l89.46 33.83c3.09 1.17 4.65 4.62 3.48 7.71L151.8 135.46c-1.17 3.09-4.62 4.65-7.7 3.48l-30.56-11.56c-3.09-1.17-4.65-4.62-3.48-7.71l18.03-47.75c1.17-3.09-.39-6.55-3.48-7.72L76.9 46.17z" />+ <path d="M3.87 78.84C.78 77.67-.78 74.22.39 71.13L11.94 40.54c1.17-3.09 4.62-4.65 7.7-3.48l89.46 33.84c3.09 1.17 4.65 4.62 3.48 7.71l-33.81 89.52c-1.17 3.09-4.62 4.65-7.7 3.48L40.5 160.05c-3.09-1.17-4.65-4.62-3.48-7.71l18.03-47.75c1.17-3.09-.39-6.54-3.48-7.71L3.87 78.84z" />+ </g>+ </svg>+);+export const webLogo = (props: LogoProps) => (<svg fill="none" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" {...props}><circle cx="12" cy="12" r="9" stroke="currentColor" strokeWidth="1.5" />@@ -892,6 +902,7 @@ export const logos = {agentcard: agentcardLogo,vercel: vercelLogo,linear: linearLogo,+ sent: sentLogo,context: contextLogo,notion: notionLogo,datadog: datadogLogo,diff --git a/apps/docs/lib/integrations/sent-registry.test.ts b/apps/docs/lib/integrations/sent-registry.test.tsnew file mode 100644index 000000000..02693e1d6--- /dev/null+++ b/apps/docs/lib/integrations/sent-registry.test.ts@@ -0,0 +1,55 @@+import { describe, expect, it, vi } from "vitest";++import sentConnection from "../../registry/connections/sent";++// Connect's runtime pulls in channel auth; these tests exercise only the authored approval policy.+vi.mock("@vercel/connect/eve", () => ({+ connect: () => ({ getToken: async () => ({ token: "" }) }),+}));++const ALLOWED_TOOLS = [+ "account.get",+ "balance.get",+ "contacts.create_many",+ "contacts.delete",+ "contacts.get",+ "contacts.list",+ "contacts.message_summary",+ "dashboard.contacts",+ "dashboard.deliverability",+ "dashboard.messages_sent",+ "messages.activities.list",+ "messages.get",+ "messages.send",+ "numbers.lookup",+ "onboarding.status",+ "templates.delete",+ "templates.get",+ "templates.get_by_name",+ "templates.list",+] as const;++const APPROVAL_REQUIRED = new Set([+ "messages.send",+ "contacts.create_many",+ "contacts.delete",+ "templates.delete",+]);++describe("Sent registry connection", () => {+ it("keeps the reviewed tool and approval boundary", () => {+ const { tools, approval } = sentConnection;+ if (!tools || !("allow" in tools) || typeof approval !== "function") {+ throw new Error("Sent requires a tool allowlist and per-tool approval policy.");+ }+ expect(tools.allow).toEqual(ALLOWED_TOOLS);++ for (const toolName of ALLOWED_TOOLS) {+ expect(approval({ toolName: `sent__${toolName}` } as never)).toBe(+ APPROVAL_REQUIRED.has(toolName) ? "user-approval" : "not-applicable",+ );+ }++ expect(approval({ toolName: "sent__sender_profiles.create" } as never)).toBe("not-applicable");+ });+});diff --git a/apps/docs/registry.json b/apps/docs/registry.jsonindex 3f365aa07..102687dc0 100644--- a/apps/docs/registry.json+++ b/apps/docs/registry.json@@ -632,6 +632,39 @@}]},+ {+ "name": "connection/sent",+ "type": "registry:item",+ "title": "Sent",+ "description": "Send and track SMS, WhatsApp, and RCS through Sent's MCP server.",+ "meta": {+ "eve": {+ "setup": {+ "command": "eve",+ "package": "eve",+ "bin": "eve",+ "args": [+ "integration",+ "connect",+ "sent",+ "mcp.sent.dm",+ "sent"+ ]+ },+ "requires": ">=0.51.1"+ }+ },+ "dependencies": [+ "@vercel/connect"+ ],+ "files": [+ {+ "path": "registry/connections/sent.ts",+ "type": "registry:file",+ "target": "agent/connections/sent.ts"+ }+ ]+ },{"name": "connection/notion","type": "registry:item",diff --git a/apps/docs/registry/connections/sent.ts b/apps/docs/registry/connections/sent.tsnew file mode 100644index 000000000..bf7bbe4ec--- /dev/null+++ b/apps/docs/registry/connections/sent.ts@@ -0,0 +1,43 @@+import { connect } from "@vercel/connect/eve";+import { defineMcpClientConnection } from "eve/connections";++const APPROVAL_REQUIRED = new Set([+ "messages.send",+ "contacts.create_many",+ "contacts.delete",+ "templates.delete",+]);++export default defineMcpClientConnection({+ url: "https://mcp.sent.dm/mcp",+ description:+ "Sent business messaging: send and track SMS, WhatsApp, and RCS; manage contacts and templates; inspect analytics, balance, and account readiness.",+ auth: connect("sent"),+ tools: {+ allow: [+ "account.get",+ "balance.get",+ "contacts.create_many",+ "contacts.delete",+ "contacts.get",+ "contacts.list",+ "contacts.message_summary",+ "dashboard.contacts",+ "dashboard.deliverability",+ "dashboard.messages_sent",+ "messages.activities.list",+ "messages.get",+ "messages.send",+ "numbers.lookup",+ "onboarding.status",+ "templates.delete",+ "templates.get",+ "templates.get_by_name",+ "templates.list",+ ],+ },+ approval: ({ toolName }) =>+ APPROVAL_REQUIRED.has(toolName.split("__").pop() ?? toolName)+ ? "user-approval"+ : "not-applicable",+});diff --git a/apps/docs/scripts/validate-connection-registry.ts b/apps/docs/scripts/validate-connection-registry.tsindex 4b2db71af..658915334 100644--- a/apps/docs/scripts/validate-connection-registry.ts+++ b/apps/docs/scripts/validate-connection-registry.ts@@ -52,6 +52,7 @@ const CONNECT_SERVICES: Readonly<Record<string, string>> = {agentcard: "mcp.agentcard.sh/mcp",vercel: "vercel",linear: "mcp.linear.app",+ sent: "mcp.sent.dm",notion: "mcp.notion.com",datadog: "mcp.datadoghq.com",honeycomb: "mcp.honeycomb.io",diff --git a/apps/docs/vitest.config.ts b/apps/docs/vitest.config.tsindex cc7a8facb..2eda4f055 100644--- a/apps/docs/vitest.config.ts+++ b/apps/docs/vitest.config.ts@@ -1,6 +1,18 @@import { defineConfig } from "vitest/config";export default defineConfig({+ resolve: {+ alias: [+ {+ find: /^eve\/(connections|tools\/approval)$/,+ replacement: new URL("../../packages/eve/src/public/$1/index.ts", import.meta.url).pathname,+ },+ {+ find: /^#(.+)\.js$/,+ replacement: new URL("../../packages/eve/src/$1.ts", import.meta.url).pathname,+ },+ ],+ },test: {include: ["lib/**/*.test.ts"],},diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.tsindex ad5a0d91f..242770e5b 100644--- a/packages/eve-catalog/src/index.ts+++ b/packages/eve-catalog/src/index.ts@@ -427,6 +427,18 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [mcp: { url: "https://mcp.linear.app/mcp" },},},+ {+ slug: "sent",+ name: "Sent",+ kind: "connection",+ tagline: "Send and track SMS, WhatsApp, and RCS through Sent's MCP server.",+ surfaces: { scaffoldable: false, registry: true, gallery: true },+ connection: {+ description:+ "Sent business messaging: send and track SMS, WhatsApp, and RCS; manage contacts and templates; inspect analytics, balance, and account readiness.",+ mcp: { url: "https://mcp.sent.dm/mcp" },+ },+ },{slug: "notion",name: "Notion",