The Open Framework for Building Agents
fix(eve): enqueue newline on NDJSON stream open (#1056)
OwenKephart835f076a6dfb
diff --git a/.changeset/calm-streams-start.md b/.changeset/calm-streams-start.mdnew file mode 100644index 000000000..d3e47b7ba--- /dev/null+++ b/.changeset/calm-streams-start.md@@ -0,0 +1,5 @@+---+"eve": patch+---++Emit an initial NDJSON whitespace byte when opening a session event stream so clients and proxies receive the response body before the first durable event.diff --git a/packages/eve/src/public/channels/eve.test.ts b/packages/eve/src/public/channels/eve.test.tsindex 1b3198d89..f8ec0019a 100644--- a/packages/eve/src/public/channels/eve.test.ts+++ b/packages/eve/src/public/channels/eve.test.ts@@ -373,6 +373,22 @@ describe("eveChannel — events", () => {});describe("eveChannel — stream cursor", () => {+ it("establishes the NDJSON body before the first durable event", async () => {+ const handler = createEveStreamHandler({ auth: none() });+ const response = await handler.fetch("https://eve.test/eve/v1/session/test-session-id/stream");+ const reader = response.body!.getReader();++ const firstChunk = await Promise.race([+ reader.read(),+ new Promise<never>((_, reject) =>+ setTimeout(() => reject(new Error("Timed out waiting for the NDJSON response body")), 25),+ ),+ ]);+ await reader.cancel();++ expect(new TextDecoder().decode(firstChunk.value)).toBe("\n");+ });+it("forwards negative tail-relative start indices", async () => {const handler = createEveStreamHandler({ auth: none() });diff --git a/packages/eve/src/public/channels/eve.ts b/packages/eve/src/public/channels/eve.tsindex 6af9feae2..2d4825e6a 100644--- a/packages/eve/src/public/channels/eve.ts+++ b/packages/eve/src/public/channels/eve.ts@@ -897,6 +897,9 @@ function serializeAsNdjson(events: ReadableStream<unknown>): ReadableStream<Uintconst encoder = new TextEncoder();return events.pipeThrough(new TransformStream<unknown, Uint8Array>({+ start(controller) {+ controller.enqueue(encoder.encode("\n"));+ },transform(event, controller) {controller.enqueue(encoder.encode(`${JSON.stringify(event)}\n`));},