The Open Framework for Building Agents
Add related resources to integration pages (#3013)
Ben Sabicadefdf084620
diff --git a/apps/docs/app/[lang]/integrations/[slug]/page.tsx b/apps/docs/app/[lang]/integrations/[slug]/page.tsxindex 838e744c8..f74a65eb2 100644--- a/apps/docs/app/[lang]/integrations/[slug]/page.tsx+++ b/apps/docs/app/[lang]/integrations/[slug]/page.tsx@@ -17,6 +17,7 @@ import { translations } from "@/geistdocs";import { Markdown } from "../components/markdown";import { SetupTabs } from "../components/setup-tabs";import { IntegrationDocsLink } from "./integration-docs-link";+import { RelatedResources } from "./related-resources";const typeLabel = {channel: "Channel",@@ -179,6 +180,14 @@ const IntegrationDetailPage = async ({ params }: PageProps<"/[lang]/integrations</Markdown>)}</Section>+ {integration.relatedResources?.length ? (+ <Section id="related-resources" title="Related resources">+ <RelatedResources+ integration={integration.slug}+ resources={integration.relatedResources}+ />+ </Section>+ ) : null}</div></main>);diff --git a/apps/docs/app/[lang]/integrations/[slug]/related-resources.tsx b/apps/docs/app/[lang]/integrations/[slug]/related-resources.tsxnew file mode 100644index 000000000..e5099aa56--- /dev/null+++ b/apps/docs/app/[lang]/integrations/[slug]/related-resources.tsx@@ -0,0 +1,51 @@+"use client";++import { track } from "@vercel/analytics";+import { ArrowUpRightIcon } from "lucide-react";+import Link from "next/link";+import { analyticsEvents } from "@/lib/analytics/events";+import type { RelatedResource } from "@/lib/integrations/data";++export const RelatedResources = ({+ integration,+ resources,+}: {+ integration: string;+ resources: RelatedResource[];+}) => (+ <ul className="mt-2 grid gap-3 sm:grid-cols-2">+ {resources.map((resource) => {+ const isInternal = resource.href.startsWith("/");+ return (+ <li className="grid sm:row-span-2 sm:grid-rows-subgrid" key={resource.href}>+ <Link+ className="group relative grid w-full gap-2 rounded-lg border bg-background-100 p-4 pr-9 transition-colors hover:border-gray-400 hover:bg-gray-100 sm:row-span-2 sm:grid-rows-subgrid"+ href={resource.href}+ onClick={() =>+ track(analyticsEvents.integrationRelatedResourceOpened, {+ integration,+ href: resource.href,+ })+ }+ prefetch={isInternal}+ rel={isInternal ? undefined : "noreferrer"}+ target={isInternal ? undefined : "_blank"}+ >+ {isInternal ? null : (+ <ArrowUpRightIcon+ aria-hidden+ className="absolute top-4 right-4 size-3.5 text-gray-800 transition-colors group-hover:text-gray-1000"+ />+ )}+ <span className="line-clamp-2 font-medium text-gray-1000 text-sm leading-snug [text-wrap:balance]">+ {resource.title}+ </span>+ <span className="line-clamp-3 text-gray-900 text-sm leading-relaxed">+ {resource.description}+ </span>+ </Link>+ </li>+ );+ })}+ </ul>+);diff --git a/apps/docs/lib/analytics/events.ts b/apps/docs/lib/analytics/events.tsindex 731f3164c..cf577408c 100644--- a/apps/docs/lib/analytics/events.ts+++ b/apps/docs/lib/analytics/events.ts@@ -8,6 +8,7 @@ export const analyticsEvents = {integrationDocsOpened: "Opened integration docs",integrationFilterSelected: "Selected integration filter",integrationOpened: "Opened integration",+ integrationRelatedResourceOpened: "Opened integration related resource",integrationSetupOptionSelected: "Selected integration setup option",integrationsSearched: "Searched integrations",smartMarkdownNotFound: "Served smart Markdown 404",diff --git a/apps/docs/lib/integrations/connection-setup.test.ts b/apps/docs/lib/integrations/connection-setup.test.tsindex 1f897bae9..56a14bf40 100644--- a/apps/docs/lib/integrations/connection-setup.test.ts+++ b/apps/docs/lib/integrations/connection-setup.test.ts@@ -93,10 +93,12 @@ describe("Kernel extension setup", () => {expect(integration.type).toBe("extension");expect(integration.install).toContain("eve add extension/kernel");- expect(integration.quickStart).toContain(- 'kernel({ connect: "mcp.onkernel.com/eve-extension" })',- );+ expect(integration.quickStart).toContain('kernel({ connect: "kernel/kernel-mcp" })');expect(integration.configure).toContain("KERNEL_API_KEY");+ expect(integration.relatedResources?.map((resource) => resource.href)).toEqual([+ "https://vercel.com/kb/guide/build-a-browser-agent",+ "https://vercel.com/kb/guide/software-factory-browser",+ ]);});});diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.tsindex 30dadd20c..ca8b0fba7 100644--- a/apps/docs/lib/integrations/data.ts+++ b/apps/docs/lib/integrations/data.ts@@ -73,6 +73,13 @@ export interface ConnectionSpec extends ConnectionSetupSpec {openapi?: ConnectionIdentity["openapi"];}+/** A guide, package, or reference linked from an integration's Related resources section. */+export interface RelatedResource {+ title: string;+ description: string;+ href: string;+}+export interface Integration {/** URL slug and lookup key, derived once and reused everywhere. */slug: string;@@ -99,8 +106,34 @@ export interface Integration {configure?: string;/** Structured connection spec; present only for `type: "connection"`. */connection?: ConnectionSpec;+ /** Guides and references shown after Configure; omitted when empty. */+ relatedResources?: RelatedResource[];}+/** Shared by the GitHub, Linear, and GitHub Tools integrations Foreman builds on. */+const softwareFactoryGuide: RelatedResource = {+ title: "Build a software factory with eve",+ description:+ "Deploy Foreman, an eve agent system that turns GitHub issues or Linear tickets into reviewed draft pull requests while leaving merge decisions to humans.",+ href: "https://vercel.com/kb/guide/eve-software-factory",+};++/** Shared by the Slack, GitHub, Datadog, and Vercel integrations the incident response agent uses. */+const incidentResponseGuide: RelatedResource = {+ title: "Build an incident response SRE agent with eve",+ description:+ "Deploy a Slack-based investigation agent that connects to Datadog, GitHub, and Vercel, tests root-cause hypotheses, and posts evidence-linked findings in threads.",+ href: "https://vercel.com/kb/guide/eve-incident-sre-agent",+};++/** Shared by the Slack and Notion integrations the marketing team template publishes through. */+const marketingTeamGuide: RelatedResource = {+ title: "Run a marketing team from Slack with eve",+ description:+ "Deploy a Slack-facing lead agent that routes requests to marketing specialists who publish to Notion, Typefully, and Resend, with approval gates on irreversible actions.",+ href: "https://vercel.com/kb/guide/marketing-team-eve",+};+/** Docs presentation overlay shared by every integration kind. */interface Presentation {logo: LogoKey;@@ -108,6 +141,8 @@ interface Presentation {keywords?: string[];/** Optional gallery pill (e.g. "Chat SDK") shown next to the type label. */badge?: string;+ /** Guides and references shown after Configure. */+ relatedResources?: RelatedResource[];}/** Channel overlay: presentation plus hand-authored setup markdown. */@@ -174,6 +209,7 @@ vercel connect create slack --triggers\`\`\`The channel handles mentions, DMs, typing indicators, delivery, and human-in-the-loop consent with sensible defaults. See the [Slack channel docs](/docs/channels/slack) for customizing each behavior.`,+ relatedResources: [marketingTeamGuide, incidentResponseGuide],},discord: {logo: "discord",@@ -333,6 +369,7 @@ export default githubChannel({});\`\`\``,configure: `Sign in to Vercel, then let the guided flow create or link a project, provision the GitHub App, and attach its verified webhook trigger to \`/eve/v1/github\`. Deploy, install the app from Vercel Connect, then add its \`@handle\` invocation token to a new issue, pull request, or review comment. GitHub may not autocomplete or render the token as a linked mention. See the [GitHub channel docs](/docs/channels/github) for permissions and events.`,+ relatedResources: [softwareFactoryGuide, incidentResponseGuide],},"linear-agent": {logo: "linear",@@ -355,6 +392,7 @@ export default linearChannel({});\`\`\``,configure: `Sign in to Vercel, then let the guided flow create or link a project, provision the Linear app, and attach its verified AgentSessionEvent trigger to \`/eve/v1/linear\`. Deploy, install the app in your Linear workspace from Vercel Connect, then delegate an issue or mention the agent. See the [Linear channel docs](/docs/channels/linear) for Agent Activity behavior.`,+ relatedResources: [softwareFactoryGuide],},eve: {logo: "eve",@@ -1183,6 +1221,14 @@ export default channel;See the [Email (Resend) adapter documentation](https://chat-sdk.dev/adapters/vendor-official/resend) for all supported events and credentials.`,configure: `Verify a sending domain in Resend, set \`RESEND_API_KEY\`, \`RESEND_WEBHOOK_SECRET\`, and \`RESEND_FROM_ADDRESS\`, then point the Resend inbound webhook at \`/eve/v1/resend\`. This is a vendor-official Chat SDK adapter. See the [Chat SDK channel docs](/docs/channels/chat-sdk) for eve session dispatch, state, streaming, and human-in-the-loop behavior.`,+ relatedResources: [+ {+ title: "Give your eve agent an email inbox with Resend",+ description:+ "Wire an eve agent to email through the Chat SDK channel and Resend adapter so it can hold threaded, multi-turn conversations, send proactive messages, and process attachments.",+ href: "https://vercel.com/kb/guide/eve-agent-with-resend",+ },+ ],},};const baseExtensionPresentations: Record<string, ExtensionPresentation> = {@@ -1353,8 +1399,8 @@ The extension requires Node.js 24 or later and eve 0.25 or later. It mounts KernquickStart: `Create and attach a Kernel connector with [Vercel Connect](https://vercel.com/connect):\`\`\`bash-vercel connect create mcp.onkernel.com --name eve-extension-vercel connect attach mcp.onkernel.com/eve-extension+vercel connect create kernel --name kernel-mcp --connection-method mcp+vercel connect attach kernel/kernel-mcp\`\`\`Then mount the extension under \`agent/extensions/\`:@@ -1362,7 +1408,7 @@ Then mount the extension under \`agent/extensions/\`:\`\`\`ts title="agent/extensions/kernel.ts"import kernel from "@onkernel/eve-extension";-export default kernel({ connect: "mcp.onkernel.com/eve-extension" });+export default kernel({ connect: "kernel/kernel-mcp" });\`\`\`The filename supplies the \`kernel\` namespace. The extension adds browser management, Playwright, computer control, managed auth, profiles, proxies, and replay tools under \`kernel__browser__*\`, along with the \`browse\` skill.`,@@ -1373,6 +1419,20 @@ export { default } from "@onkernel/eve-extension";\`\`\`The default mount can execute JavaScript in the browser VM and reuse authenticated browser sessions. For team or multi-tenant agents, prefer Vercel Connect so each user authenticates separately, and add an approval gate by overriding the extension's \`browser\` connection. See the [Kernel eve extension guide](https://www.kernel.sh/docs/integrations/vercel/eve-extension) for API-key configuration, connection overrides, the complete tool list, and security guidance.`,+ relatedResources: [+ {+ title: "How to build a browser agent that works behind a login",+ description:+ "Combine eve, Vercel Connect, and Kernel managed auth so a user signs in once and the agent drives the authenticated browser without handling credentials.",+ href: "https://vercel.com/kb/guide/build-a-browser-agent",+ },+ {+ title: "Give your software factory a browser",+ description:+ "Attach Kernel's cloud browser to the eve software factory so Foreman can reproduce flow bugs, verify fixes on preview deployments, and save what it learns.",+ href: "https://vercel.com/kb/guide/software-factory-browser",+ },+ ],},jetty: {logo: "jetty",@@ -1494,6 +1554,7 @@ export default githubExtension({\`\`\`For local or non-Vercel deployments, omit \`connector\` and set \`GITHUB_TOKEN\`; the extension also accepts an explicit \`token\`. Prefer fine-grained credentials, expose only the presets the agent needs, and keep approval enabled for writes. See the [GitHub Tools eve documentation](https://github-tools.com/frameworks/eve#eve-extension) for token authentication, per-tool overrides, commit attribution, and the complete tool catalog.`,+ relatedResources: [softwareFactoryGuide, incidentResponseGuide],},hindsight: {logo: "hindsight",@@ -1785,6 +1846,14 @@ export default browser({Also configure the [sandbox network policy](/docs/sandbox#network-policy) for defense in depth. Treat saved browser state, cookies, screenshots, downloads, and recordings as sensitive data. Do not place passwords or session tokens in prompts. Use the extension's per-tool overrides to gate or disable actions your agent should not take unattended.The extension also supports inline screenshots, session naming, proxies, and production pre-installation. See the [agent-browser eve extension documentation](https://github.com/vercel-labs/agent-browser/tree/main/packages/%40agent-browser/eve) for the complete options and example app.`,+ relatedResources: [+ {+ title: "Give your eve agent a browser",+ description:+ "Changelog introducing the agent-browser extension, which gives eve agents sandboxed tools to navigate, read, click, fill forms, take screenshots, and inspect network activity.",+ href: "https://vercel.com/changelog/give-your-eve-agent-a-browser",+ },+ ],},};@@ -1826,12 +1895,23 @@ const connectionPresentations: Record<string, ConnectionPresentation> = {user: "Select None when prompted for a token authentication method. Each user completes OAuth when needed.",app: "Enter a team-scoped [Vercel token](https://vercel.com/kb/guide/how-do-i-use-a-vercel-api-access-token) when prompted, then copy the returned connector UID into the App example. This avoids per-user OAuth, though the Vercel token still belongs to the user who created it.",},+ relatedResources: [+ incidentResponseGuide,+ softwareFactoryGuide,+ {+ title: "Manage Vercel projects with a software factory",+ description:+ "Add Vercel's hosted MCP server to the eve software factory so Foreman can read build logs, runtime errors, and deployment history through app-scoped Vercel Connect auth and a read-only tool allowlist.",+ href: "https://vercel.com/kb/guide/software-factory-vercel-mcp",+ },+ ],},linear: {logo: "linear",docsHref: "/docs/connections/mcp",keywords: ["mcp", "issues", "project management", "oauth", "connect"],authModes: ["user", "app"],+ relatedResources: [softwareFactoryGuide],},notion: {logo: "notion",@@ -1840,6 +1920,7 @@ const connectionPresentations: Record<string, ConnectionPresentation> = {authModes: ["user", "app", "jwtBearer"],configureNote:"The OpenAPI setup sends the required `Notion-Version` header; bump it as Notion ships new API versions.",+ relatedResources: [marketingTeamGuide],},datadog: {logo: "datadog",@@ -1848,6 +1929,7 @@ const connectionPresentations: Record<string, ConnectionPresentation> = {authModes: ["jwtBearer"],configureNote:"Match the MCP `url` to your Datadog site (`datadoghq.com`, `datadoghq.eu`, and so on).",+ relatedResources: [incidentResponseGuide],},honeycomb: {logo: "honeycomb",@@ -2313,6 +2395,7 @@ export default defineInstrumentation({});\`\`\``,configure: `Datadog's direct OTLP trace intake is site-specific (for example \`datadoghq.com\` vs \`datadoghq.eu\`) and currently in Preview; look up the endpoint for your site in Datadog's OTLP intake docs. For production, Datadog recommends routing through an OpenTelemetry Collector with the Datadog exporter instead. See the [instrumentation guide](/docs/guides/instrumentation) for the trace hierarchy and the \`recordInputs\`/\`recordOutputs\` controls.`,+ relatedResources: [incidentResponseGuide],},"honeycomb-instrumentation": {logo: "honeycomb",@@ -2465,6 +2548,7 @@ function buildChannel(entry: IntegrationEntry): Integration {install: presentation.install,quickStart: presentation.quickStart,configure: presentation.configure,+ relatedResources: presentation.relatedResources,};}@@ -2479,7 +2563,8 @@ function buildConnection(entry: IntegrationEntry): Integration {throw new Error(`Catalog connection "${entry.slug}" is missing its connection identity.`);}const identity: ConnectionIdentity = entry.connection;- const { logo, docsHref, keywords, quickStart, configure, ...setup } = presentation;+ const { logo, docsHref, keywords, quickStart, configure, relatedResources, ...setup } =+ presentation;const spec: ConnectionSpec = {...setup,description: identity.description,@@ -2498,6 +2583,7 @@ function buildConnection(entry: IntegrationEntry): Integration {quickStart,configure,connection: spec,+ relatedResources,};}@@ -2519,6 +2605,7 @@ function buildExtension(entry: IntegrationEntry): Integration {install: presentation.install,quickStart: presentation.quickStart,configure: presentation.configure,+ relatedResources: presentation.relatedResources,};}@@ -2540,6 +2627,7 @@ function buildMemory(entry: IntegrationEntry): Integration {install: presentation.install,quickStart: presentation.quickStart,configure: presentation.configure,+ relatedResources: presentation.relatedResources,};}@@ -2561,6 +2649,7 @@ function buildInstrumentation(entry: IntegrationEntry): Integration {install: presentation.install,quickStart: presentation.quickStart,configure: presentation.configure,+ relatedResources: presentation.relatedResources,};}diff --git a/apps/docs/lib/integrations/discovery.test.ts b/apps/docs/lib/integrations/discovery.test.tsindex d4421e1a2..3c6169d31 100644--- a/apps/docs/lib/integrations/discovery.test.ts+++ b/apps/docs/lib/integrations/discovery.test.ts@@ -73,6 +73,80 @@ describe("integration discovery", () => {expect(integrationSearchText(browserbase!)).toContain("Stagehand");});+ it("renders related resources after Configure and omits the section when empty", () => {+ const kernel = getIntegration("kernel");+ expect(kernel).toBeDefined();++ const markdown = integrationMarkdown(kernel!);+ expect(markdown).toContain("## Related resources");+ expect(markdown.indexOf("## Related resources")).toBeGreaterThan(+ markdown.indexOf("## Configure"),+ );+ expect(markdown).toContain(+ "- [How to build a browser agent that works behind a login](https://vercel.com/kb/guide/build-a-browser-agent)",+ );+ expect(markdown).toContain(+ "- [Give your software factory a browser](https://vercel.com/kb/guide/software-factory-browser)",+ );++ const agentBrowser = getIntegration("agent-browser");+ expect(agentBrowser).toBeDefined();+ expect(integrationMarkdown(agentBrowser!)).toContain(+ "- [Give your eve agent a browser](https://vercel.com/changelog/give-your-eve-agent-a-browser)",+ );++ for (const slug of ["github", "linear-agent", "github-tools", "linear", "vercel"]) {+ const integration = getIntegration(slug);+ expect(integration).toBeDefined();+ expect(integrationMarkdown(integration!)).toContain(+ "- [Build a software factory with eve](https://vercel.com/kb/guide/eve-software-factory)",+ );+ }++ const vercel = getIntegration("vercel");+ expect(integrationMarkdown(vercel!)).toContain(+ "- [Manage Vercel projects with a software factory](https://vercel.com/kb/guide/software-factory-vercel-mcp)",+ );++ for (const slug of [+ "slack",+ "github",+ "github-tools",+ "datadog",+ "datadog-instrumentation",+ "vercel",+ ]) {+ const integration = getIntegration(slug);+ expect(integration).toBeDefined();+ expect(integrationMarkdown(integration!)).toContain(+ "- [Build an incident response SRE agent with eve](https://vercel.com/kb/guide/eve-incident-sre-agent)",+ );+ }++ const vercelMarkdown = integrationMarkdown(vercel!);+ expect(vercelMarkdown.indexOf("eve-incident-sre-agent")).toBeLessThan(+ vercelMarkdown.indexOf("eve-software-factory"),+ );++ for (const slug of ["slack", "notion"]) {+ const integration = getIntegration(slug);+ expect(integration).toBeDefined();+ expect(integrationMarkdown(integration!)).toContain(+ "- [Run a marketing team from Slack with eve](https://vercel.com/kb/guide/marketing-team-eve)",+ );+ }++ const resend = getIntegration("chat-sdk-resend");+ expect(resend).toBeDefined();+ expect(integrationMarkdown(resend!)).toContain(+ "- [Give your eve agent an email inbox with Resend](https://vercel.com/kb/guide/eve-agent-with-resend)",+ );++ const browserbase = getIntegration("browserbase");+ expect(browserbase).toBeDefined();+ expect(integrationMarkdown(browserbase!)).not.toContain("## Related resources");+ });+it("renders the BlitzReels extension setup", () => {const blitzreels = getIntegration("blitzreels");expect(blitzreels).toBeDefined();diff --git a/apps/docs/lib/integrations/discovery.ts b/apps/docs/lib/integrations/discovery.tsindex ef4e86325..984adf9bd 100644--- a/apps/docs/lib/integrations/discovery.ts+++ b/apps/docs/lib/integrations/discovery.ts@@ -35,11 +35,23 @@ export const integrationMarkdown = (integration: Integration): string => {integration.configure ??(setup ? renderConnectionVariants(setup, setup.configureVariants) : "");+ const relatedResources = integration.relatedResources?.length+ ? [+ section(+ "Related resources",+ integration.relatedResources+ .map((resource) => `- [${resource.title}](${resource.href}): ${resource.description}`)+ .join("\n"),+ ),+ ]+ : [];+return [`${typeLabel[integration.type]} integration for eve. ${integration.tagline}`,section("Install", install),section("Quick start", quickStart),section("Configure", configure),+ ...relatedResources,`[Read the full ${typeLabel[integration.type].toLowerCase()} documentation](${integration.docsHref})`,].join("\n\n");};