Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

feat(eve): emit multi-agent deployment summaries (#3000)

OwenKepharte1dabc2ad97a
diff --git a/packages/eve/src/internal/vercel-agent-summary.ts b/packages/eve/src/internal/vercel-agent-summary.ts
index 1958003c1..7fb8741bf 100644
--- a/packages/eve/src/internal/vercel-agent-summary.ts
+++ b/packages/eve/src/internal/vercel-agent-summary.ts
@@ -53,6 +53,10 @@ export const VERCEL_EVE_AGENT_SUMMARY_VERSION = 5;
*/
export const VERCEL_EVE_AGENT_SUMMARY_OUTPUT_PATH = ".eve/agent-summary.json";
+export const VERCEL_EVE_MULTI_AGENT_SUMMARY_KIND = "vercel-eve-multi-agent-summary" as const;
+
+export const VERCEL_EVE_MULTI_AGENT_SUMMARY_VERSION = 1;
+
/**
* Display category eve exposes to the dashboard for one channel chip. Built
* from the channel's reported {@link CompiledChannelDefinition.adapterKind}.
@@ -197,6 +201,30 @@ export interface VercelEveDiagnosticsSummary {
readonly warnings: number;
}
+/** One independently deployed agent declared by a multi-agent project. */
+export interface VercelEveMultiAgentSummaryEntry {
+ /** Stable workspace member name and public URL segment. */
+ readonly name: string;
+ /** Public route prefix for this agent (for example, `/support`). */
+ readonly routePrefix: string;
+ /** Path to the member's existing single-agent summary, relative to project root. */
+ readonly summaryPath: string;
+}
+
+/**
+ * Versioned project-level index for a multi-agent deployment.
+ *
+ * It deliberately references the existing per-agent summaries instead of
+ * flattening them: schedules, tools, and connections may share names across
+ * independently authored agents and must retain their owner.
+ */
+export interface VercelEveMultiAgentSummary {
+ readonly kind: typeof VERCEL_EVE_MULTI_AGENT_SUMMARY_KIND;
+ readonly schemaVersion: typeof VERCEL_EVE_MULTI_AGENT_SUMMARY_VERSION;
+ readonly generatorVersion: string;
+ readonly agents: readonly VercelEveMultiAgentSummaryEntry[];
+}
+
/**
* Versioned public summary of one eve agent, emitted into the Vercel Build
* Output during `eve build` and ingested by Vercel as deployment metadata.
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 1a6cfc15a..051c4f979 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
@@ -42,6 +42,26 @@ describe("buildAgentWorkspace", () => {
const output = await buildAgentWorkspace(workspace);
const config = JSON.parse(await readFile(join(output, "config.json"), "utf8"));
+ const multiAgentSummary = JSON.parse(
+ await readFile(join(root, ".eve", "agent-summary.json"), "utf8"),
+ );
+
+ expect(multiAgentSummary).toMatchObject({
+ agents: [
+ {
+ name: "research",
+ routePrefix: "/research",
+ summaryPath: "agents/research/.eve/agent-summary.json",
+ },
+ {
+ name: "support",
+ routePrefix: "/support",
+ summaryPath: "agents/support/.eve/agent-summary.json",
+ },
+ ],
+ kind: "vercel-eve-multi-agent-summary",
+ schemaVersion: 1,
+ });
expect(config.routes).toEqual([
{
diff --git a/packages/eve/src/internal/vercel/build-agent-workspace.ts b/packages/eve/src/internal/vercel/build-agent-workspace.ts
index 947622f23..722c90c8b 100644
--- a/packages/eve/src/internal/vercel/build-agent-workspace.ts
+++ b/packages/eve/src/internal/vercel/build-agent-workspace.ts
@@ -1,6 +1,13 @@
import { mkdir, rm, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { join, relative } from "node:path";
+import { resolveInstalledPackageInfo } from "#internal/application/package.js";
+import {
+ VERCEL_EVE_AGENT_SUMMARY_OUTPUT_PATH,
+ VERCEL_EVE_MULTI_AGENT_SUMMARY_KIND,
+ VERCEL_EVE_MULTI_AGENT_SUMMARY_VERSION,
+ type VercelEveMultiAgentSummary,
+} from "#internal/vercel-agent-summary.js";
import type { AgentWorkspace } from "#internal/project-context.js";
import { assembleEveVercelServices } from "#internal/vercel/assemble-eve-services.js";
import { quoteVercelShellArgument, toVercelRelativePath } from "#internal/vercel/build-command.js";
@@ -9,6 +16,22 @@ import { resolveEveBinaryPath } from "#shared/resolve-eve-binary.js";
const VERCEL_BUILD_OUTPUT_VERSION = 3;
+function createMultiAgentSummary(workspace: AgentWorkspace): VercelEveMultiAgentSummary {
+ return {
+ agents: workspace.members.map((member) => ({
+ name: member.name,
+ routePrefix: `/${member.name}`,
+ summaryPath: relative(
+ workspace.root,
+ join(member.appRoot, VERCEL_EVE_AGENT_SUMMARY_OUTPUT_PATH),
+ ).replaceAll("\\", "/"),
+ })),
+ generatorVersion: resolveInstalledPackageInfo().version,
+ kind: VERCEL_EVE_MULTI_AGENT_SUMMARY_KIND,
+ schemaVersion: VERCEL_EVE_MULTI_AGENT_SUMMARY_VERSION,
+ };
+}
+
/** Emit the inferred Vercel Services project for a strict hostless workspace. */
export async function buildAgentWorkspace(workspace: AgentWorkspace): Promise<string> {
const config = await readVercelJsonFile(join(workspace.root, "vercel.json"));
@@ -45,6 +68,11 @@ export async function buildAgentWorkspace(workspace: AgentWorkspace): Promise<st
await Promise.all(
assembled.rootDirectories.map((rootDirectory) => mkdir(rootDirectory, { recursive: true })),
);
+ await mkdir(join(workspace.root, ".eve"), { recursive: true });
+ await writeFile(
+ join(workspace.root, VERCEL_EVE_AGENT_SUMMARY_OUTPUT_PATH),
+ `${JSON.stringify(createMultiAgentSummary(workspace), null, 2)}\n`,
+ );
await writeFile(
join(outputDirectory, "config.json"),
`${JSON.stringify(