The Open Framework for Building Agents
fix(eve): preserve composed schemas in compiled tools (#3500)
Rui649180b28cc5
diff --git a/.changeset/quiet-schemas-compose.md b/.changeset/quiet-schemas-compose.mdnew file mode 100644index 000000000..2678b5a08--- /dev/null+++ b/.changeset/quiet-schemas-compose.md@@ -0,0 +1,5 @@+---+"eve": patch+---++Preserve schema composition when compiling tools that reuse another tool's Zod input or output schema. Built agents no longer fail route initialization with `Cannot read properties of undefined (reading 'def')` for these nested schemas.diff --git a/docs/tools/overview.mdx b/docs/tools/overview.mdxindex dee48836a..6cedae1ff 100644--- a/docs/tools/overview.mdx+++ b/docs/tools/overview.mdx@@ -32,6 +32,8 @@ A tool definition needs:When a tool returns structured data, add an optional `outputSchema`. With Zod or Standard Schema it also types the `execute` return.+Compiled tools preserve Zod schema composition, including input and output schemas imported from helper modules. Durable replay metadata stays separate from the original schema, so adding it does not mutate shared schema objects.+### Label tool activityUse `label.start(input)` to describe a call in user-facing activity. The callback receives the validated tool input, so it can select the useful fields without exposing the full argument object:diff --git a/packages/eve/src/internal/testing/scenario-apps/composed-tool-schemas.ts b/packages/eve/src/internal/testing/scenario-apps/composed-tool-schemas.tsnew file mode 100644index 000000000..16c618502--- /dev/null+++ b/packages/eve/src/internal/testing/scenario-apps/composed-tool-schemas.ts@@ -0,0 +1,55 @@+import type { ScenarioAppDescriptor } from "#internal/testing/scenario-app.js";++export const COMPOSED_TOOL_SCHEMAS_DESCRIPTOR: ScenarioAppDescriptor = {+ name: "composed-tool-schemas",+ installDependencies: true,+ dependencies: { zod: "4.5.4" },+ files: {+ "agent/instructions.md": "Echo the input with the dispatch tool.\n",+ "agent/lib/operation.ts": `import { defineTool } from "eve/tools";+import { z } from "zod";++export default defineTool({+ description: "Echo one value",+ inputSchema: z.object({ value: z.string().trim().min(1) }),+ outputSchema: z.object({ value: z.string().min(1) }),+ execute: async (input) => input,+});+`,+ "agent/tools/dispatch.ts": `import { defineTool } from "eve/tools";+import { z } from "zod";+import operation from "../lib/operation.ts";++export default defineTool({+ description: "Dispatch to the echo operation",+ inputSchema: z.discriminatedUnion("action", [+ z.object({+ action: z.literal("echo"),+ input: operation.inputSchema as z.ZodType<{ value: string }>,+ }),+ ]),+ outputSchema: z.object({+ result: operation.outputSchema as z.ZodType<{ value: string }>,+ }),+ execute: async (input) => ({ result: input.input }),+});+`,+ "agent/channels/schema-composition.ts": `import { defineChannel, GET } from "eve/channels";+import { z } from "zod";+import dispatch from "../tools/dispatch.ts";++export default defineChannel({+ routes: [GET("/schema-composition", async () => {+ const input = dispatch.inputSchema as z.ZodType;+ const output = dispatch.outputSchema as z.ZodType;+ const parsed = input.parse({ action: "echo", input: { value: " hello " } });+ return Response.json({+ parsed,+ invalidAccepted: input.safeParse({ action: "echo", input: { value: " " } }).success,+ output: output.parse({ result: { value: "hello" } }),+ });+ })],+});+`,+ },+};diff --git a/packages/eve/src/tools/durable-schema.test.ts b/packages/eve/src/tools/durable-schema.test.tsindex 3bd475c1c..bcf4a8f16 100644--- a/packages/eve/src/tools/durable-schema.test.ts+++ b/packages/eve/src/tools/durable-schema.test.ts@@ -2,9 +2,39 @@ import { describe, expect, expectTypeOf, it } from "vitest";import { z } from "#compiled/zod/index.js";import { defineDurableSchema, readDurableSchema } from "#tools/durable-schema.js";import { defineTool } from "#tools/definition.js";-import { serializeInputSchema } from "#tools/schema.js";+import { serializeInputSchema, serializeOutputSchema } from "#tools/schema.js";describe("defineDurableSchema", () => {+ it.each([false, true])("preserves nested Zod composition (frozen: %s)", (frozen) => {+ const source = z.object({ value: z.string().trim().min(1) });+ if (frozen) {+ // Zod installs its Standard Schema property lazily on first access.+ void source["~standard"];+ Object.freeze(source);+ }+ const schema = defineDurableSchema({ closure: {}, schema: () => source });+ const composed = z.discriminatedUnion("action", [+ z.object({ action: z.literal("echo"), input: schema as typeof source }),+ ]);++ expect(serializeInputSchema(composed)).toMatchObject({+ oneOf: [+ { properties: { input: { properties: { value: { type: "string", minLength: 1 } } } } },+ ],+ });+ expect(serializeOutputSchema(composed)).toMatchObject({+ oneOf: [+ { properties: { input: { properties: { value: { type: "string", minLength: 1 } } } } },+ ],+ });+ expect(composed.parse({ action: "echo", input: { value: " hello " } })).toEqual({+ action: "echo",+ input: { value: "hello" },+ });+ expect(composed.safeParse({ action: "echo", input: { value: " " } }).success).toBe(false);+ expect(readDurableSchema(source)).toBeUndefined();+ });+it("leaves JSON-only schemas unchanged without adding a runtime validation contract", () => {const source = { type: "string", minLength: 1 };const schema = defineDurableSchema({ closure: {}, schema: () => source });diff --git a/packages/eve/src/tools/durable-schema.ts b/packages/eve/src/tools/durable-schema.tsindex 038151a6a..a5d8218d4 100644--- a/packages/eve/src/tools/durable-schema.ts+++ b/packages/eve/src/tools/durable-schema.ts@@ -53,6 +53,8 @@ export function defineDurableSchema<},},};+ // Authored tools may compose library-native schemas before eve normalizes them.+ Object.setPrototypeOf(schema, source);Object.defineProperty(schema, DURABLE_SCHEMA, {value: {callback: (closure: JsonObject) => input.schema(closure as TClosure),diff --git a/packages/eve/test/scenarios/cli.scenario.test.ts b/packages/eve/test/scenarios/cli.scenario.test.tsindex b3d62bdc7..6d17d00d6 100644--- a/packages/eve/test/scenarios/cli.scenario.test.ts+++ b/packages/eve/test/scenarios/cli.scenario.test.ts@@ -9,6 +9,7 @@ import { runCli } from "../../src/cli/run.js";import { resolveInstalledPackageInfo } from "../../src/internal/application/package.js";import { useScenarioApp } from "../../src/internal/testing/scenario-app.js";import { WEATHER_AGENT_DESCRIPTOR } from "../../src/internal/testing/scenario-apps/weather-agent.js";+import { COMPOSED_TOOL_SCHEMAS_DESCRIPTOR } from "../../src/internal/testing/scenario-apps/composed-tool-schemas.js";import { resolveLocalWorkflowWorldDataDirectory } from "../../src/internal/workflow/local-world-data-directory.js";import {EVE_HEALTH_ROUTE_PATH,@@ -429,6 +430,28 @@ describe("runCli", () => {}});+ it("preserves imported tool schema composition in the built server", async () => {+ const { buildApplication } = await import("../../src/internal/nitro/host.js");+ const { appRoot } = await scenarioApp(COMPOSED_TOOL_SCHEMAS_DESCRIPTOR);+ await buildApplication(appRoot, { skipVercelSandboxPrewarm: true });+ const server = await startPackagedEveStart(appRoot);++ try {+ const response = await fetch(new URL("/schema-composition", server.url), {+ signal: AbortSignal.timeout(10_000),+ });+ const body = await response.text();+ expect(response.status, `${body}\n${server.stderr()}`).toBe(200);+ expect(JSON.parse(body)).toEqual({+ parsed: { action: "echo", input: { value: "hello" } },+ invalidAccepted: false,+ output: { result: { value: "hello" } },+ });+ } finally {+ await server.stop();+ }+ }, 120_000);+it("starts an existing built app with local Workflow data under .eve", async () => {const { buildApplication } = await import("../../src/internal/nitro/host.js");const appRoot = await createMinimalAppRoot("eve-cli-start-health-");