Skip to content

armgit / eve

Public Imported from GitHub
0

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.ts
index 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">&nbsp;&rarr;</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">&nbsp;&rarr;</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.ts
index 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.ts
index 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.ts
index 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<st
join(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.ts
new file mode 100644
index 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.ts
index 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 }
: {}),