Skip to content

armgit / eve

Public Imported from GitHub
0

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.tsx
index 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.tsx
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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 Kern
quickStart: `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.ts
index 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.ts
index 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");
};