The Open Framework for Building Agents
feat(eve): add multi-agent deployment landing page (#2999)
OwenKephartb761a88b7e50
diff --git a/packages/eve/src/internal/nitro/routes/index.ts b/packages/eve/src/internal/nitro/routes/index.tsindex 62314f831..a2848a0bb 100644--- a/packages/eve/src/internal/nitro/routes/index.ts+++ b/packages/eve/src/internal/nitro/routes/index.ts@@ -5,8 +5,9 @@*/const EVE_DOCS_URL = "https://eve.dev/docs";-const DEPLOYMENT_URL_PLACEHOLDER = "{{DEPLOYMENT_URL}}";const AGENT_NAME_PLACEHOLDER = "{{AGENT_NAME}}";+const STATUS_DETAIL_PLACEHOLDER = "{{STATUS_DETAIL}}";+const TERMINAL_PLACEHOLDER = "{{TERMINAL}}";const EVE_LOGO_SVG = `<svg aria-hidden="true" class="logo" fill="none" viewBox="0 0 169 53" xmlns="http://www.w3.org/2000/svg"><path d="M169 8.47h-51.39L81.73 53H70.36L113 0H169zM169 44.51v8.47h-45.87V44.5zM45.87 52.98H0V44.5h45.87zM38.66 30.55H0v-8.47h38.66z" fill="currentColor"></path>@@ -202,11 +203,8 @@ const HOME_PAGE_HTML_TEMPLATE = `<!doctype html><div class="agent-row"><strong class="agent-name">${AGENT_NAME_PLACEHOLDER}</strong></div>- <p class="lede"><span class="status"><span class="status-dot" aria-hidden="true"></span>Ready</span><span class="lede-divider" aria-hidden="true">/</span><span>Agent is up and accepting messages.</span> <a href="${EVE_DOCS_URL}">Docs<span class="lede-arrow" aria-hidden="true"> →</span></a></p>- <div class="terminal mono" role="group" aria-label="Send a message from your terminal">- <span class="terminal-prompt" aria-hidden="true">$</span>- <span class="terminal-cmd">eve dev ${DEPLOYMENT_URL_PLACEHOLDER}</span>- </div>+ <p class="lede"><span class="status"><span class="status-dot" aria-hidden="true"></span>Ready</span><span class="lede-divider" aria-hidden="true">/</span><span>${STATUS_DETAIL_PLACEHOLDER}</span> <a href="${EVE_DOCS_URL}">Docs<span class="lede-arrow" aria-hidden="true"> →</span></a></p>+ ${TERMINAL_PLACEHOLDER}</section></main></body>@@ -254,6 +252,25 @@ function resolveDeploymentUrl(request: Request): string {return `${proto}://${host}`;}+/** Render the shared lightweight deployment status page. */+export function buildHomePageHtml(input: {+ readonly name: string;+ readonly statusDetail: string;+ readonly terminalCommand?: string;+}): string {+ const terminal =+ input.terminalCommand === undefined+ ? ""+ : `<div class="terminal mono" role="group" aria-label="Send a message from your terminal">+ <span class="terminal-prompt" aria-hidden="true">$</span>+ <span class="terminal-cmd">${escapeHtml(input.terminalCommand)}</span>+ </div>`;++ return HOME_PAGE_HTML_TEMPLATE.replace(AGENT_NAME_PLACEHOLDER, () => escapeHtml(input.name))+ .replace(STATUS_DETAIL_PLACEHOLDER, () => escapeHtml(input.statusDetail))+ .replace(TERMINAL_PLACEHOLDER, () => terminal);+}+/*** Builds the barebones home page response for one request. Exposed* for tests so callers can supply a real {@link Request}; production@@ -266,9 +283,11 @@ export function buildHomePageResponse(request: Request,): Response {const deploymentUrl = resolveDeploymentUrl(request);- const html = HOME_PAGE_HTML_TEMPLATE.replace(AGENT_NAME_PLACEHOLDER, () =>- escapeHtml(input.agentName),- ).replace(DEPLOYMENT_URL_PLACEHOLDER, () => escapeHtml(deploymentUrl));+ const html = buildHomePageHtml({+ name: input.agentName,+ statusDetail: "Agent is up and accepting messages.",+ terminalCommand: `eve dev ${deploymentUrl}`,+ });return new Response(html, {headers: {diff --git a/packages/eve/src/internal/vercel/assemble-eve-services.ts b/packages/eve/src/internal/vercel/assemble-eve-services.tsindex aefadb92c..50b45fd59 100644--- a/packages/eve/src/internal/vercel/assemble-eve-services.ts+++ b/packages/eve/src/internal/vercel/assemble-eve-services.ts@@ -52,6 +52,9 @@ export function assembleEveVercelServices(input: {),};eveRoutes.push({ routeSrc: contribution.routeSrc, serviceName });+ if (contribution.homeRouteSrc !== undefined) {+ eveRoutes.push({ routeSrc: contribution.homeRouteSrc, serviceName });+ }}return {diff --git a/packages/eve/src/internal/vercel/build-agent-workspace.integration.test.ts b/packages/eve/src/internal/vercel/build-agent-workspace.integration.test.tsindex 051c4f979..ed2f77b2a 100644--- a/packages/eve/src/internal/vercel/build-agent-workspace.integration.test.ts+++ b/packages/eve/src/internal/vercel/build-agent-workspace.integration.test.ts@@ -68,11 +68,23 @@ describe("buildAgentWorkspace", () => {destination: { service: "eve-research", type: "service" },src: "^/research/eve/v1/(.*)$",},+ {+ destination: { service: "eve-research", type: "service" },+ src: "^/research/?$",+ },{destination: { service: "eve-support", type: "service" },src: "^/support/eve/v1/(.*)$",},+ {+ destination: { service: "eve-support", type: "service" },+ src: "^/support/?$",+ },+ { handle: "filesystem" },]);+ await expect(readFile(join(output, "static", "index.html"), "utf8")).resolves.toContain(+ "2 agents are up and accepting messages.",+ );await expect(access(join(root, ".eve", "vercel-services", "eve-support")),).resolves.toBeUndefined();@@ -84,6 +96,10 @@ describe("buildAgentWorkspace", () => {root: ".eve/vercel-services/eve-support",routePrefix: "/support",routes: [+ {+ src: "^/support/?$",+ transforms: [{ args: "/", op: "set", type: "request.path" }],+ },{src: "^/support/eve/v1/(.*)$",transforms: [{ args: "/eve/v1/$1", op: "set", type: "request.path" }],diff --git a/packages/eve/src/internal/vercel/build-agent-workspace.ts b/packages/eve/src/internal/vercel/build-agent-workspace.tsindex 722c90c8b..628f0e828 100644--- a/packages/eve/src/internal/vercel/build-agent-workspace.ts+++ b/packages/eve/src/internal/vercel/build-agent-workspace.ts@@ -10,6 +10,7 @@ import {} from "#internal/vercel-agent-summary.js";import type { AgentWorkspace } from "#internal/project-context.js";import { assembleEveVercelServices } from "#internal/vercel/assemble-eve-services.js";+import { buildMultiAgentLandingPage } from "#internal/vercel/build-multi-agent-landing-page.js";import { quoteVercelShellArgument, toVercelRelativePath } from "#internal/vercel/build-command.js";import { readVercelJsonFile } from "#internal/vercel/vercel-services-config.js";import { resolveEveBinaryPath } from "#shared/resolve-eve-binary.js";@@ -73,12 +74,15 @@ export async function buildAgentWorkspace(workspace: AgentWorkspace): Promise<stjoin(workspace.root, VERCEL_EVE_AGENT_SUMMARY_OUTPUT_PATH),`${JSON.stringify(createMultiAgentSummary(workspace), null, 2)}\n`,);+ const staticDirectory = join(outputDirectory, "static");+ await mkdir(staticDirectory, { recursive: true });+ await writeFile(join(staticDirectory, "index.html"), buildMultiAgentLandingPage(workspace));await writeFile(join(outputDirectory, "config.json"),`${JSON.stringify({version: VERCEL_BUILD_OUTPUT_VERSION,- routes: assembled.routes,+ routes: [...assembled.routes, { handle: "filesystem" }],services: assembled.services,},null,diff --git a/packages/eve/src/internal/vercel/build-multi-agent-landing-page.ts b/packages/eve/src/internal/vercel/build-multi-agent-landing-page.tsnew file mode 100644index 000000000..99f13ca8e--- /dev/null+++ b/packages/eve/src/internal/vercel/build-multi-agent-landing-page.ts@@ -0,0 +1,11 @@+import type { AgentWorkspace } from "#internal/project-context.js";+import { buildHomePageHtml } from "#internal/nitro/routes/index.js";++/** Build the public root page for a hostless multi-agent deployment. */+export function buildMultiAgentLandingPage(workspace: AgentWorkspace): string {+ const agentCount = workspace.members.length;+ return buildHomePageHtml({+ name: "eve agents",+ statusDetail: `${agentCount} ${agentCount === 1 ? "agent is" : "agents are"} up and accepting messages.`,+ });+}diff --git a/packages/eve/src/internal/vercel/eve-service-contribution.ts b/packages/eve/src/internal/vercel/eve-service-contribution.tsindex 42bf44b96..eb51feea7 100644--- a/packages/eve/src/internal/vercel/eve-service-contribution.ts+++ b/packages/eve/src/internal/vercel/eve-service-contribution.ts@@ -38,6 +38,7 @@ export interface EveVercelBuildTarget {}export interface EveVercelServiceContribution {+ readonly homeRouteSrc: string | undefined;readonly rootDirectory: string;readonly routeSrc: string;readonly service: GeneratedVercelServiceConfig;@@ -65,10 +66,14 @@ export function createEveServiceName(name: string | undefined): string {return serviceName;}+function escapeVercelRouteLiteral(value: string): string {+ return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");+}+export function createEveServiceRouteSrc(publicRoutePrefix: string): string {if (publicRoutePrefix.length === 0) return `^${EVE_ROUTE_PREFIX}/(.*)$`;const prefix = publicRoutePrefix.startsWith("/") ? publicRoutePrefix : `/${publicRoutePrefix}`;- return `^${prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}${EVE_ROUTE_PREFIX}/(.*)$`;+ return `^${escapeVercelRouteLiteral(prefix)}${EVE_ROUTE_PREFIX}/(.*)$`;}export function createEveRequestPathRoute(routeSrc: string): VercelRouteConfig {@@ -78,6 +83,20 @@ export function createEveRequestPathRoute(routeSrc: string): VercelRouteConfig {};}+export function createEveHomeRouteSrc(publicRoutePrefix: string): string | undefined {+ if (publicRoutePrefix.length === 0) return undefined;+ const prefix = publicRoutePrefix.startsWith("/") ? publicRoutePrefix : `/${publicRoutePrefix}`;+ return `^${escapeVercelRouteLiteral(prefix)}/?$`;+}++/** Route a member's public base path to its package-owned home channel. */+export function createEveHomePathRoute(publicRoutePrefix: string): VercelRouteConfig | undefined {+ const src = createEveHomeRouteSrc(publicRoutePrefix);+ return src === undefined+ ? undefined+ : { src, transforms: [{ args: "/", op: "set", type: "request.path" }] };+}+export function createEvePublicRoute(serviceName: string, routeSrc: string): VercelRouteConfig {return { destination: { service: serviceName, type: "service" }, src: routeSrc };}@@ -114,6 +133,14 @@ export function compileEveVercelService(input: {}): EveVercelServiceContribution {const serviceName = createEveServiceName(input.agent.name);const routeSrc = createEveServiceRouteSrc(input.agent.publicRoutePrefix);+ const homeRouteSrc =+ input.agent.workspaceMember === true+ ? createEveHomeRouteSrc(input.agent.publicRoutePrefix)+ : undefined;+ const homeRoute =+ input.agent.workspaceMember === true+ ? createEveHomePathRoute(input.agent.publicRoutePrefix)+ : undefined;const build = createIsolatedBuild({agent: input.agent,hostOutputDirectory: input.target.hostOutputDirectory,@@ -122,13 +149,17 @@ export function compileEveVercelService(input: {});return {+ homeRouteSrc,rootDirectory: build.rootDirectory,routeSrc,service: {buildCommand: build.buildCommand,framework: "eve",root: build.root,- routes: [createEveRequestPathRoute(routeSrc)],+ routes: [+ ...(homeRoute === undefined ? [] : [homeRoute]),+ createEveRequestPathRoute(routeSrc),+ ],...(input.agent.publicRoutePrefix.length > 0? { routePrefix: input.agent.publicRoutePrefix }: {}),