@machinemetrics/agent-event-protocol 0.1.0

package/dist/sse.cjs

@@ -0,0 +1,404 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/sse/index.ts
+var sse_exports = {};
+__export(sse_exports, {
+  encodeSSE: () => encodeSSE,
+  parseSSEChunk: () => parseSSEChunk
+});
+module.exports = __toCommonJS(sse_exports);
+
+// src/sse/encode.ts
+var import_meta = {};
+function encodeSSE(event, data) {
+  return `event: ${event}
+data: ${JSON.stringify(data)}
+
+`;
+}
+if (import_meta.vitest) {
+  const { describe, it, expect } = import_meta.vitest;
+  describe("encodeSSE", () => {
+    it("formats SSE event correctly", () => {
+      const result = encodeSSE("metadata", {
+        event: "metadata",
+        requestId: "req-1",
+        threadId: "th-1",
+        agentId: "test-agent",
+        timestamp: "2025-01-01T00:00:00.000Z"
+      });
+      expect(result).toBe(
+        'event: metadata\ndata: {"event":"metadata","requestId":"req-1","threadId":"th-1","agentId":"test-agent","timestamp":"2025-01-01T00:00:00.000Z"}\n\n'
+      );
+    });
+    it("handles special characters in data", () => {
+      const result = encodeSSE("text", {
+        event: "text",
+        requestId: "req-1",
+        messageId: "msg-1",
+        blockId: "b1",
+        stage: "delta",
+        delta: "Hello\nWorld",
+        deltaIndex: 0,
+        timestamp: "2025-01-01T00:00:00.000Z"
+      });
+      expect(result).toContain("Hello\\nWorld");
+      expect(result).toMatch(/^event: text\ndata: .+\n\n$/);
+    });
+    it("handles unicode characters", () => {
+      const result = encodeSSE("text", {
+        event: "text",
+        requestId: "req-1",
+        messageId: "msg-1",
+        blockId: "b1",
+        stage: "delta",
+        delta: "\u4F60\u597D\u4E16\u754C \u{1F30D}",
+        deltaIndex: 0,
+        timestamp: "2025-01-01T00:00:00.000Z"
+      });
+      expect(result).toContain("\u4F60\u597D\u4E16\u754C \u{1F30D}");
+    });
+    it("handles empty object data", () => {
+      const result = encodeSSE("custom", {});
+      expect(result).toBe("event: custom\ndata: {}\n\n");
+    });
+  });
+}
+
+// src/core/schemas.ts
+var import_zod = require("zod");
+var UserContentBlockSchema = import_zod.z.object({
+  type: import_zod.z.literal("text"),
+  text: import_zod.z.string()
+});
+var AssistantContentBlockSchema = import_zod.z.discriminatedUnion("type", [
+  import_zod.z.object({ type: import_zod.z.literal("text"), text: import_zod.z.string() }),
+  import_zod.z.object({ type: import_zod.z.literal("thinking"), text: import_zod.z.string() }),
+  import_zod.z.object({
+    type: import_zod.z.literal("tool_use"),
+    toolCallId: import_zod.z.string(),
+    tool: import_zod.z.string(),
+    args: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown())
+  }),
+  import_zod.z.object({
+    type: import_zod.z.literal("tool_result"),
+    toolCallId: import_zod.z.string(),
+    tool: import_zod.z.string(),
+    status: import_zod.z.enum(["success", "error"]),
+    summary: import_zod.z.string().optional()
+  })
+]);
+var InputMessageSchema = import_zod.z.object({
+  content: import_zod.z.array(UserContentBlockSchema)
+});
+var ActionResultSchema = import_zod.z.object({
+  actionId: import_zod.z.string(),
+  kind: import_zod.z.string(),
+  status: import_zod.z.enum(["success", "error"]),
+  data: import_zod.z.unknown().optional(),
+  error: import_zod.z.string().optional()
+});
+var AgentRequestSchema = import_zod.z.object({
+  messages: import_zod.z.array(InputMessageSchema),
+  threadId: import_zod.z.string().optional(),
+  context: import_zod.z.object({
+    actionResults: import_zod.z.array(ActionResultSchema).optional()
+  }).passthrough().optional()
+});
+var EventStageSchema = import_zod.z.enum(["start", "delta", "stop"]);
+var ErrorCodeSchema = import_zod.z.enum([
+  "auth_failed",
+  "thread_not_found",
+  "thread_access_denied",
+  "invalid_message_format",
+  "message_too_large",
+  "rate_limit_exceeded",
+  "stream_timeout",
+  "agent_error",
+  "tool_error",
+  "internal_error",
+  "invalid_action_id"
+]);
+var FinishReasonSchema = import_zod.z.enum(["stop", "length", "error", "action_required"]);
+var MetadataEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("metadata"),
+  requestId: import_zod.z.string(),
+  threadId: import_zod.z.string(),
+  agentId: import_zod.z.string(),
+  timestamp: import_zod.z.string()
+});
+var TextEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("text"),
+  requestId: import_zod.z.string(),
+  messageId: import_zod.z.string(),
+  blockId: import_zod.z.string(),
+  blockIndex: import_zod.z.number().optional(),
+  stage: EventStageSchema,
+  delta: import_zod.z.string().optional(),
+  deltaIndex: import_zod.z.number().optional(),
+  timestamp: import_zod.z.string()
+});
+var ThinkingEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("thinking"),
+  requestId: import_zod.z.string(),
+  messageId: import_zod.z.string(),
+  blockId: import_zod.z.string(),
+  blockIndex: import_zod.z.number().optional(),
+  stage: EventStageSchema,
+  delta: import_zod.z.string().optional(),
+  deltaIndex: import_zod.z.number().optional(),
+  timestamp: import_zod.z.string()
+});
+var ToolCallEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("tool_call"),
+  requestId: import_zod.z.string(),
+  messageId: import_zod.z.string(),
+  blockId: import_zod.z.string(),
+  blockIndex: import_zod.z.number().optional(),
+  stage: EventStageSchema,
+  toolCallId: import_zod.z.string().optional(),
+  tool: import_zod.z.string().optional(),
+  delta: import_zod.z.string().optional(),
+  deltaIndex: import_zod.z.number().optional(),
+  args: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
+  timestamp: import_zod.z.string()
+});
+var ToolResultEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("tool_result"),
+  requestId: import_zod.z.string(),
+  messageId: import_zod.z.string(),
+  blockId: import_zod.z.string(),
+  blockIndex: import_zod.z.number().optional(),
+  stage: EventStageSchema,
+  toolCallId: import_zod.z.string().optional(),
+  tool: import_zod.z.string().optional(),
+  status: import_zod.z.enum(["success", "error"]).optional(),
+  summary: import_zod.z.string().optional(),
+  timestamp: import_zod.z.string()
+});
+var DoneEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("done"),
+  requestId: import_zod.z.string(),
+  messageId: import_zod.z.string(),
+  threadId: import_zod.z.string(),
+  content: import_zod.z.array(AssistantContentBlockSchema),
+  usage: import_zod.z.object({
+    promptTokens: import_zod.z.number(),
+    completionTokens: import_zod.z.number()
+  }).optional(),
+  finishReason: FinishReasonSchema,
+  traceId: import_zod.z.string().optional(),
+  timestamp: import_zod.z.string()
+});
+var ErrorEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("error"),
+  requestId: import_zod.z.string(),
+  message: import_zod.z.string(),
+  code: ErrorCodeSchema.optional(),
+  retryable: import_zod.z.boolean().optional(),
+  timestamp: import_zod.z.string()
+});
+var AbortedEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("aborted"),
+  requestId: import_zod.z.string(),
+  messageId: import_zod.z.string().optional(),
+  timestamp: import_zod.z.string()
+});
+var ContinuationEventSchema = import_zod.z.object({
+  event: import_zod.z.literal("continuation"),
+  requestId: import_zod.z.string(),
+  actionId: import_zod.z.string(),
+  kind: import_zod.z.string(),
+  payload: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()),
+  timestamp: import_zod.z.string()
+});
+var AgentEventSchema = import_zod.z.discriminatedUnion("event", [
+  MetadataEventSchema,
+  TextEventSchema,
+  ThinkingEventSchema,
+  ToolCallEventSchema,
+  ToolResultEventSchema,
+  DoneEventSchema,
+  ErrorEventSchema,
+  AbortedEventSchema,
+  ContinuationEventSchema
+]);
+
+// src/sse/parse.ts
+var import_meta2 = {};
+function parseSSEChunk(chunk) {
+  const events = [];
+  const blocks = chunk.split("\n\n");
+  for (let i = 0; i < blocks.length - 1; i++) {
+    const block = blocks[i];
+    const parsed = parseBlock(block);
+    if (parsed !== null) {
+      events.push(parsed);
+    }
+  }
+  const lastBlock = blocks[blocks.length - 1] ?? "";
+  const remainder = lastBlock;
+  return { events, remainder };
+}
+function parseBlock(block) {
+  const lines = block.split("\n");
+  let eventType = null;
+  let data = null;
+  for (const line of lines) {
+    if (line.startsWith(":")) {
+      continue;
+    }
+    if (line.startsWith("event: ")) {
+      eventType = line.slice(7);
+      continue;
+    }
+    if (line.startsWith("data: ")) {
+      data = line.slice(6);
+      continue;
+    }
+  }
+  if (data === null) {
+    return null;
+  }
+  return parseAndValidate(data, eventType);
+}
+function parseAndValidate(data, eventType) {
+  let parsed;
+  try {
+    parsed = JSON.parse(data);
+  } catch {
+    return { success: false, error: "Invalid JSON", raw: data };
+  }
+  const result = AgentEventSchema.safeParse(parsed);
+  if (result.success) {
+    if (eventType !== null && result.data.event !== eventType) {
+      return {
+        success: false,
+        error: `Event type mismatch: header says '${eventType}', data says '${result.data.event}'`,
+        raw: parsed
+      };
+    }
+    return { success: true, event: result.data };
+  }
+  return {
+    success: false,
+    error: result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; "),
+    raw: parsed
+  };
+}
+if (import_meta2.vitest) {
+  const { describe, it, expect } = import_meta2.vitest;
+  describe("parseSSEChunk", () => {
+    it("parses a single complete event", () => {
+      const chunk = 'event: metadata\ndata: {"event":"metadata","requestId":"req-1","threadId":"th-1","agentId":"test-agent","timestamp":"2025-01-01T00:00:00.000Z"}\n\n';
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(1);
+      expect(result.events[0]?.success).toBe(true);
+      if (result.events[0]?.success) {
+        expect(result.events[0].event.event).toBe("metadata");
+        expect(result.events[0].event.requestId).toBe("req-1");
+      }
+      expect(result.remainder).toBe("");
+    });
+    it("parses multiple events in one chunk", () => {
+      const chunk = 'event: text\ndata: {"event":"text","requestId":"req-1","messageId":"msg-1","blockId":"b1","stage":"start","blockIndex":0,"timestamp":"2025-01-01T00:00:00.000Z"}\n\nevent: text\ndata: {"event":"text","requestId":"req-1","messageId":"msg-1","blockId":"b1","stage":"delta","delta":"Hello","deltaIndex":0,"timestamp":"2025-01-01T00:00:00.001Z"}\n\n';
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(2);
+      expect(result.events[0]?.success).toBe(true);
+      expect(result.events[1]?.success).toBe(true);
+      if (result.events[0]?.success && result.events[1]?.success) {
+        expect(result.events[0].event.event).toBe("text");
+        expect(result.events[1].event.event).toBe("text");
+      }
+      expect(result.remainder).toBe("");
+    });
+    it("returns remainder for partial event", () => {
+      const chunk = 'event: metadata\ndata: {"event":"metadata","requestId":"req-1","threadId":"th-1","agentId":"test-agent","timestamp":"2025-01-01T00:00:00.000Z"}\n\nevent: text\ndata: {"event":"text","request';
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(1);
+      expect(result.events[0]?.success).toBe(true);
+      expect(result.remainder).toContain("event: text");
+      expect(result.remainder).toContain('data: {"event":"text","request');
+    });
+    it("ignores SSE comments", () => {
+      const chunk = ': heartbeat\nevent: metadata\ndata: {"event":"metadata","requestId":"req-1","threadId":"th-1","agentId":"test-agent","timestamp":"2025-01-01T00:00:00.000Z"}\n\n';
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(1);
+      expect(result.events[0]?.success).toBe(true);
+    });
+    it("returns error for invalid JSON", () => {
+      const chunk = "event: text\ndata: {invalid json}\n\n";
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(1);
+      const event = result.events[0];
+      expect(event.success).toBe(false);
+      if (!event.success) {
+        expect(event.error).toBe("Invalid JSON");
+      }
+    });
+    it("returns error for invalid event schema", () => {
+      const chunk = 'event: text\ndata: {"event":"text","invalidField":"value"}\n\n';
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(1);
+      const event = result.events[0];
+      expect(event.success).toBe(false);
+      if (!event.success) {
+        expect(event.error).toContain("requestId");
+      }
+    });
+    it("returns error for event type mismatch", () => {
+      const chunk = 'event: metadata\ndata: {"event":"text","requestId":"req-1","messageId":"msg-1","blockId":"b1","stage":"start","blockIndex":0,"timestamp":"2025-01-01T00:00:00.000Z"}\n\n';
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(1);
+      const event = result.events[0];
+      expect(event.success).toBe(false);
+      if (!event.success) {
+        expect(event.error).toContain("mismatch");
+      }
+    });
+    it("handles data without event line", () => {
+      const chunk = 'data: {"event":"metadata","requestId":"req-1","threadId":"th-1","agentId":"test-agent","timestamp":"2025-01-01T00:00:00.000Z"}\n\n';
+      const result = parseSSEChunk(chunk);
+      expect(result.events).toHaveLength(1);
+      expect(result.events[0]?.success).toBe(true);
+    });
+    it("handles empty chunk", () => {
+      const result = parseSSEChunk("");
+      expect(result.events).toHaveLength(0);
+      expect(result.remainder).toBe("");
+    });
+    it("buffers partial chunks correctly across calls", () => {
+      const part1 = 'event: text\ndata: {"event":"text","requestId":"req-1",';
+      const part2 = '"messageId":"msg-1","blockId":"b1","stage":"start","blockIndex":0,"timestamp":"2025-01-01T00:00:00.000Z"}\n\n';
+      const result1 = parseSSEChunk(part1);
+      expect(result1.events).toHaveLength(0);
+      expect(result1.remainder).not.toBe("");
+      const result2 = parseSSEChunk(result1.remainder + part2);
+      expect(result2.events).toHaveLength(1);
+      expect(result2.events[0]?.success).toBe(true);
+    });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  encodeSSE,
+  parseSSEChunk
+});
+//# sourceMappingURL=sse.cjs.map

package/dist/sse.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sse/index.ts","../src/sse/encode.ts","../src/core/schemas.ts","../src/sse/parse.ts"],"sourcesContent":["export { encodeSSE } from './encode.js';\nexport { parseSSEChunk } from './parse.js';\nexport type { ParsedEvent, ParseResult } from './parse.js';\n","/**\n * Encodes an event and data payload into SSE wire format.\n *\n * Output format: `event: {event}\\ndata: {json}\\n\\n`\n *\n * The data object is JSON serialized. Newlines in string values are escaped\n * by JSON.stringify, ensuring valid SSE format.\n *\n * @param event - Event type identifier (e.g., 'text', 'done', 'error')\n * @param data - Event payload object to serialize as JSON\n * @returns SSE-formatted string ready for streaming\n */\nexport function encodeSSE(event: string, data: object): string {\n  return `event: ${event}\\ndata: ${JSON.stringify(data)}\\n\\n`;\n}\n\nif (import.meta.vitest) {\n  const { describe, it, expect } = import.meta.vitest;\n\n  describe('encodeSSE', () => {\n    it('formats SSE event correctly', () => {\n      const result = encodeSSE('metadata', {\n        event: 'metadata',\n        requestId: 'req-1',\n        threadId: 'th-1',\n        agentId: 'test-agent',\n        timestamp: '2025-01-01T00:00:00.000Z',\n      });\n\n      expect(result).toBe(\n        'event: metadata\\n' +\n          'data: {\"event\":\"metadata\",\"requestId\":\"req-1\",\"threadId\":\"th-1\",\"agentId\":\"test-agent\",\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n',\n      );\n    });\n\n    it('handles special characters in data', () => {\n      const result = encodeSSE('text', {\n        event: 'text',\n        requestId: 'req-1',\n        messageId: 'msg-1',\n        blockId: 'b1',\n        stage: 'delta',\n        delta: 'Hello\\nWorld',\n        deltaIndex: 0,\n        timestamp: '2025-01-01T00:00:00.000Z',\n      });\n\n      expect(result).toContain('Hello\\\\nWorld');\n      expect(result).toMatch(/^event: text\\ndata: .+\\n\\n$/);\n    });\n\n    it('handles unicode characters', () => {\n      const result = encodeSSE('text', {\n        event: 'text',\n        requestId: 'req-1',\n        messageId: 'msg-1',\n        blockId: 'b1',\n        stage: 'delta',\n        delta: '你好世界 🌍',\n        deltaIndex: 0,\n        timestamp: '2025-01-01T00:00:00.000Z',\n      });\n\n      expect(result).toContain('你好世界 🌍');\n    });\n\n    it('handles empty object data', () => {\n      const result = encodeSSE('custom', {});\n      expect(result).toBe('event: custom\\ndata: {}\\n\\n');\n    });\n  });\n}\n","import { z } from 'zod';\n\n/**\n * Zod schema for validating user content blocks.\n * Currently only supports text; extensible for multimodal.\n */\nexport const UserContentBlockSchema = z.object({\n  type: z.literal('text'),\n  text: z.string(),\n});\n\n/**\n * Zod schema for validating assistant content blocks.\n * Discriminated union supporting text, thinking, tool_use, and tool_result.\n */\nexport const AssistantContentBlockSchema = z.discriminatedUnion('type', [\n  z.object({ type: z.literal('text'), text: z.string() }),\n  z.object({ type: z.literal('thinking'), text: z.string() }),\n  z.object({\n    type: z.literal('tool_use'),\n    toolCallId: z.string(),\n    tool: z.string(),\n    args: z.record(z.string(), z.unknown()),\n  }),\n  z.object({\n    type: z.literal('tool_result'),\n    toolCallId: z.string(),\n    tool: z.string(),\n    status: z.enum(['success', 'error']),\n    summary: z.string().optional(),\n  }),\n]);\n\n/**\n * Zod schema for validating input messages.\n */\nexport const InputMessageSchema = z.object({\n  content: z.array(UserContentBlockSchema),\n});\n\n/**\n * Zod schema for validating action results from continuation events.\n */\nexport const ActionResultSchema = z.object({\n  actionId: z.string(),\n  kind: z.string(),\n  status: z.enum(['success', 'error']),\n  data: z.unknown().optional(),\n  error: z.string().optional(),\n});\n\n/**\n * Zod schema for validating agent request payloads.\n * Context object uses passthrough() to allow additional fields.\n */\nexport const AgentRequestSchema = z.object({\n  messages: z.array(InputMessageSchema),\n  threadId: z.string().optional(),\n  context: z\n    .object({\n      actionResults: z.array(ActionResultSchema).optional(),\n    })\n    .passthrough()\n    .optional(),\n});\n\n/**\n * Zod schema for event lifecycle stages.\n */\nexport const EventStageSchema = z.enum(['start', 'delta', 'stop']);\n\n/**\n * Zod schema for protocol error codes.\n */\nexport const ErrorCodeSchema = z.enum([\n  'auth_failed',\n  'thread_not_found',\n  'thread_access_denied',\n  'invalid_message_format',\n  'message_too_large',\n  'rate_limit_exceeded',\n  'stream_timeout',\n  'agent_error',\n  'tool_error',\n  'internal_error',\n  'invalid_action_id',\n]);\n\n/**\n * Zod schema for stream finish reasons.\n */\nexport const FinishReasonSchema = z.enum(['stop', 'length', 'error', 'action_required']);\n\n/**\n * Zod schema for metadata events.\n * First event in every stream, provides identifiers.\n */\nexport const MetadataEventSchema = z.object({\n  event: z.literal('metadata'),\n  requestId: z.string(),\n  threadId: z.string(),\n  agentId: z.string(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for text streaming events.\n * Validates the stage lifecycle with appropriate optional fields per stage.\n */\nexport const TextEventSchema = z.object({\n  event: z.literal('text'),\n  requestId: z.string(),\n  messageId: z.string(),\n  blockId: z.string(),\n  blockIndex: z.number().optional(),\n  stage: EventStageSchema,\n  delta: z.string().optional(),\n  deltaIndex: z.number().optional(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for thinking/reasoning events.\n * Structure mirrors TextEventSchema.\n */\nexport const ThinkingEventSchema = z.object({\n  event: z.literal('thinking'),\n  requestId: z.string(),\n  messageId: z.string(),\n  blockId: z.string(),\n  blockIndex: z.number().optional(),\n  stage: EventStageSchema,\n  delta: z.string().optional(),\n  deltaIndex: z.number().optional(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for tool call events.\n * Args are optional (only present on stop stage).\n */\nexport const ToolCallEventSchema = z.object({\n  event: z.literal('tool_call'),\n  requestId: z.string(),\n  messageId: z.string(),\n  blockId: z.string(),\n  blockIndex: z.number().optional(),\n  stage: EventStageSchema,\n  toolCallId: z.string().optional(),\n  tool: z.string().optional(),\n  delta: z.string().optional(),\n  deltaIndex: z.number().optional(),\n  args: z.record(z.string(), z.unknown()).optional(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for tool result events.\n * Status and summary only present on stop stage.\n */\nexport const ToolResultEventSchema = z.object({\n  event: z.literal('tool_result'),\n  requestId: z.string(),\n  messageId: z.string(),\n  blockId: z.string(),\n  blockIndex: z.number().optional(),\n  stage: EventStageSchema,\n  toolCallId: z.string().optional(),\n  tool: z.string().optional(),\n  status: z.enum(['success', 'error']).optional(),\n  summary: z.string().optional(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for done events.\n * Terminal event with complete content array.\n */\nexport const DoneEventSchema = z.object({\n  event: z.literal('done'),\n  requestId: z.string(),\n  messageId: z.string(),\n  threadId: z.string(),\n  content: z.array(AssistantContentBlockSchema),\n  usage: z\n    .object({\n      promptTokens: z.number(),\n      completionTokens: z.number(),\n    })\n    .optional(),\n  finishReason: FinishReasonSchema,\n  traceId: z.string().optional(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for error events.\n * Terminal event with error details and retry guidance.\n */\nexport const ErrorEventSchema = z.object({\n  event: z.literal('error'),\n  requestId: z.string(),\n  message: z.string(),\n  code: ErrorCodeSchema.optional(),\n  retryable: z.boolean().optional(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for aborted events.\n * Terminal event acknowledging client cancellation.\n */\nexport const AbortedEventSchema = z.object({\n  event: z.literal('aborted'),\n  requestId: z.string(),\n  messageId: z.string().optional(),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for continuation events.\n * Signals client action required before stream can continue.\n */\nexport const ContinuationEventSchema = z.object({\n  event: z.literal('continuation'),\n  requestId: z.string(),\n  actionId: z.string(),\n  kind: z.string(),\n  payload: z.record(z.string(), z.unknown()),\n  timestamp: z.string(),\n});\n\n/**\n * Zod schema for all protocol events.\n * Discriminated union on the `event` field for efficient parsing.\n */\nexport const AgentEventSchema = z.discriminatedUnion('event', [\n  MetadataEventSchema,\n  TextEventSchema,\n  ThinkingEventSchema,\n  ToolCallEventSchema,\n  ToolResultEventSchema,\n  DoneEventSchema,\n  ErrorEventSchema,\n  AbortedEventSchema,\n  ContinuationEventSchema,\n]);\n","import { AgentEventSchema } from '../core/schemas.js';\nimport type { AgentEvent } from '../core/types.js';\n\n/**\n * Result of parsing a single SSE event.\n * On success, contains a validated AgentEvent.\n * On failure, contains the error message and the raw parsed data.\n */\nexport type ParsedEvent =\n  | { success: true; event: AgentEvent }\n  | { success: false; error: string; raw: unknown };\n\n/**\n * Result of parsing an SSE chunk.\n * Contains successfully parsed events and any incomplete data to buffer for the next chunk.\n */\nexport type ParseResult = {\n  /** Array of parsed events (may include failures with error details). */\n  events: ParsedEvent[];\n  /** Incomplete data at end of chunk; prepend to next chunk before parsing. */\n  remainder: string;\n};\n\n/**\n * Parses an SSE chunk into validated protocol events.\n *\n * Handles partial chunks by returning unparsed data as remainder.\n * The remainder should be prepended to the next chunk before parsing.\n *\n * Each SSE block is validated against AgentEventSchema. Invalid events\n * are returned with success: false and error details.\n *\n * SSE comments (lines starting with ':') are ignored, including heartbeats.\n *\n * @param chunk - Raw SSE data (may contain multiple events or partial data)\n * @returns Object with parsed events array and remainder string for buffering\n */\nexport function parseSSEChunk(chunk: string): ParseResult {\n  const events: ParsedEvent[] = [];\n  const blocks = chunk.split('\\n\\n');\n\n  for (let i = 0; i < blocks.length - 1; i++) {\n    const block = blocks[i]!;\n    const parsed = parseBlock(block);\n    if (parsed !== null) {\n      events.push(parsed);\n    }\n  }\n\n  const lastBlock = blocks[blocks.length - 1] ?? '';\n  const remainder = lastBlock;\n\n  return { events, remainder };\n}\n\n/**\n * Parses a single SSE block into a ParsedEvent.\n * Returns null for blocks without data (e.g., comment-only blocks).\n */\nfunction parseBlock(block: string): ParsedEvent | null {\n  const lines = block.split('\\n');\n  let eventType: string | null = null;\n  let data: string | null = null;\n\n  for (const line of lines) {\n    if (line.startsWith(':')) {\n      continue;\n    }\n    if (line.startsWith('event: ')) {\n      eventType = line.slice(7);\n      continue;\n    }\n    if (line.startsWith('data: ')) {\n      data = line.slice(6);\n      continue;\n    }\n  }\n\n  if (data === null) {\n    return null;\n  }\n\n  return parseAndValidate(data, eventType);\n}\n\n/**\n * Parses JSON data and validates against AgentEventSchema.\n * Checks that the event type in data matches the SSE event header if present.\n */\nfunction parseAndValidate(data: string, eventType: string | null): ParsedEvent {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(data);\n  } catch {\n    return { success: false, error: 'Invalid JSON', raw: data };\n  }\n\n  const result = AgentEventSchema.safeParse(parsed);\n  if (result.success) {\n    if (eventType !== null && result.data.event !== eventType) {\n      return {\n        success: false,\n        error: `Event type mismatch: header says '${eventType}', data says '${result.data.event}'`,\n        raw: parsed,\n      };\n    }\n    return { success: true, event: result.data };\n  }\n\n  return {\n    success: false,\n    error: result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; '),\n    raw: parsed,\n  };\n}\n\nif (import.meta.vitest) {\n  const { describe, it, expect } = import.meta.vitest;\n\n  describe('parseSSEChunk', () => {\n    it('parses a single complete event', () => {\n      const chunk =\n        'event: metadata\\n' +\n        'data: {\"event\":\"metadata\",\"requestId\":\"req-1\",\"threadId\":\"th-1\",\"agentId\":\"test-agent\",\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(1);\n      expect(result.events[0]?.success).toBe(true);\n      if (result.events[0]?.success) {\n        expect(result.events[0].event.event).toBe('metadata');\n        expect(result.events[0].event.requestId).toBe('req-1');\n      }\n      expect(result.remainder).toBe('');\n    });\n\n    it('parses multiple events in one chunk', () => {\n      const chunk =\n        'event: text\\n' +\n        'data: {\"event\":\"text\",\"requestId\":\"req-1\",\"messageId\":\"msg-1\",\"blockId\":\"b1\",\"stage\":\"start\",\"blockIndex\":0,\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n' +\n        'event: text\\n' +\n        'data: {\"event\":\"text\",\"requestId\":\"req-1\",\"messageId\":\"msg-1\",\"blockId\":\"b1\",\"stage\":\"delta\",\"delta\":\"Hello\",\"deltaIndex\":0,\"timestamp\":\"2025-01-01T00:00:00.001Z\"}\\n\\n';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(2);\n      expect(result.events[0]?.success).toBe(true);\n      expect(result.events[1]?.success).toBe(true);\n      if (result.events[0]?.success && result.events[1]?.success) {\n        expect(result.events[0].event.event).toBe('text');\n        expect(result.events[1].event.event).toBe('text');\n      }\n      expect(result.remainder).toBe('');\n    });\n\n    it('returns remainder for partial event', () => {\n      const chunk =\n        'event: metadata\\n' +\n        'data: {\"event\":\"metadata\",\"requestId\":\"req-1\",\"threadId\":\"th-1\",\"agentId\":\"test-agent\",\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n' +\n        'event: text\\n' +\n        'data: {\"event\":\"text\",\"request';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(1);\n      expect(result.events[0]?.success).toBe(true);\n      expect(result.remainder).toContain('event: text');\n      expect(result.remainder).toContain('data: {\"event\":\"text\",\"request');\n    });\n\n    it('ignores SSE comments', () => {\n      const chunk =\n        ': heartbeat\\n' +\n        'event: metadata\\n' +\n        'data: {\"event\":\"metadata\",\"requestId\":\"req-1\",\"threadId\":\"th-1\",\"agentId\":\"test-agent\",\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(1);\n      expect(result.events[0]?.success).toBe(true);\n    });\n\n    it('returns error for invalid JSON', () => {\n      const chunk = 'event: text\\n' + 'data: {invalid json}\\n\\n';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(1);\n      const event = result.events[0]!;\n      expect(event.success).toBe(false);\n      if (!event.success) {\n        expect(event.error).toBe('Invalid JSON');\n      }\n    });\n\n    it('returns error for invalid event schema', () => {\n      const chunk = 'event: text\\n' + 'data: {\"event\":\"text\",\"invalidField\":\"value\"}\\n\\n';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(1);\n      const event = result.events[0]!;\n      expect(event.success).toBe(false);\n      if (!event.success) {\n        expect(event.error).toContain('requestId');\n      }\n    });\n\n    it('returns error for event type mismatch', () => {\n      const chunk =\n        'event: metadata\\n' +\n        'data: {\"event\":\"text\",\"requestId\":\"req-1\",\"messageId\":\"msg-1\",\"blockId\":\"b1\",\"stage\":\"start\",\"blockIndex\":0,\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(1);\n      const event = result.events[0]!;\n      expect(event.success).toBe(false);\n      if (!event.success) {\n        expect(event.error).toContain('mismatch');\n      }\n    });\n\n    it('handles data without event line', () => {\n      const chunk =\n        'data: {\"event\":\"metadata\",\"requestId\":\"req-1\",\"threadId\":\"th-1\",\"agentId\":\"test-agent\",\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n';\n\n      const result = parseSSEChunk(chunk);\n\n      expect(result.events).toHaveLength(1);\n      expect(result.events[0]?.success).toBe(true);\n    });\n\n    it('handles empty chunk', () => {\n      const result = parseSSEChunk('');\n      expect(result.events).toHaveLength(0);\n      expect(result.remainder).toBe('');\n    });\n\n    it('buffers partial chunks correctly across calls', () => {\n      const part1 = 'event: text\\ndata: {\"event\":\"text\",\"requestId\":\"req-1\",';\n      const part2 =\n        '\"messageId\":\"msg-1\",\"blockId\":\"b1\",\"stage\":\"start\",\"blockIndex\":0,\"timestamp\":\"2025-01-01T00:00:00.000Z\"}\\n\\n';\n\n      const result1 = parseSSEChunk(part1);\n      expect(result1.events).toHaveLength(0);\n      expect(result1.remainder).not.toBe('');\n\n      const result2 = parseSSEChunk(result1.remainder + part2);\n      expect(result2.events).toHaveLength(1);\n      expect(result2.events[0]?.success).toBe(true);\n    });\n  });\n}\n"],"mappings":"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","names":["import_meta"]}

package/dist/sse.d.cts

@@ -0,0 +1,56 @@
+import { i as AgentEvent } from './types-CttB5bnC.cjs';
+
+/**
+ * Encodes an event and data payload into SSE wire format.
+ *
+ * Output format: `event: {event}\ndata: {json}\n\n`
+ *
+ * The data object is JSON serialized. Newlines in string values are escaped
+ * by JSON.stringify, ensuring valid SSE format.
+ *
+ * @param event - Event type identifier (e.g., 'text', 'done', 'error')
+ * @param data - Event payload object to serialize as JSON
+ * @returns SSE-formatted string ready for streaming
+ */
+declare function encodeSSE(event: string, data: object): string;
+
+/**
+ * Result of parsing a single SSE event.
+ * On success, contains a validated AgentEvent.
+ * On failure, contains the error message and the raw parsed data.
+ */
+type ParsedEvent = {
+    success: true;
+    event: AgentEvent;
+} | {
+    success: false;
+    error: string;
+    raw: unknown;
+};
+/**
+ * Result of parsing an SSE chunk.
+ * Contains successfully parsed events and any incomplete data to buffer for the next chunk.
+ */
+type ParseResult = {
+    /** Array of parsed events (may include failures with error details). */
+    events: ParsedEvent[];
+    /** Incomplete data at end of chunk; prepend to next chunk before parsing. */
+    remainder: string;
+};
+/**
+ * Parses an SSE chunk into validated protocol events.
+ *
+ * Handles partial chunks by returning unparsed data as remainder.
+ * The remainder should be prepended to the next chunk before parsing.
+ *
+ * Each SSE block is validated against AgentEventSchema. Invalid events
+ * are returned with success: false and error details.
+ *
+ * SSE comments (lines starting with ':') are ignored, including heartbeats.
+ *
+ * @param chunk - Raw SSE data (may contain multiple events or partial data)
+ * @returns Object with parsed events array and remainder string for buffering
+ */
+declare function parseSSEChunk(chunk: string): ParseResult;
+
+export { type ParseResult, type ParsedEvent, encodeSSE, parseSSEChunk };

package/dist/sse.d.ts

@@ -0,0 +1,56 @@
+import { i as AgentEvent } from './types-CttB5bnC.js';
+
+/**
+ * Encodes an event and data payload into SSE wire format.
+ *
+ * Output format: `event: {event}\ndata: {json}\n\n`
+ *
+ * The data object is JSON serialized. Newlines in string values are escaped
+ * by JSON.stringify, ensuring valid SSE format.
+ *
+ * @param event - Event type identifier (e.g., 'text', 'done', 'error')
+ * @param data - Event payload object to serialize as JSON
+ * @returns SSE-formatted string ready for streaming
+ */
+declare function encodeSSE(event: string, data: object): string;
+
+/**
+ * Result of parsing a single SSE event.
+ * On success, contains a validated AgentEvent.
+ * On failure, contains the error message and the raw parsed data.
+ */
+type ParsedEvent = {
+    success: true;
+    event: AgentEvent;
+} | {
+    success: false;
+    error: string;
+    raw: unknown;
+};
+/**
+ * Result of parsing an SSE chunk.
+ * Contains successfully parsed events and any incomplete data to buffer for the next chunk.
+ */
+type ParseResult = {
+    /** Array of parsed events (may include failures with error details). */
+    events: ParsedEvent[];
+    /** Incomplete data at end of chunk; prepend to next chunk before parsing. */
+    remainder: string;
+};
+/**
+ * Parses an SSE chunk into validated protocol events.
+ *
+ * Handles partial chunks by returning unparsed data as remainder.
+ * The remainder should be prepended to the next chunk before parsing.
+ *
+ * Each SSE block is validated against AgentEventSchema. Invalid events
+ * are returned with success: false and error details.
+ *
+ * SSE comments (lines starting with ':') are ignored, including heartbeats.
+ *
+ * @param chunk - Raw SSE data (may contain multiple events or partial data)
+ * @returns Object with parsed events array and remainder string for buffering
+ */
+declare function parseSSEChunk(chunk: string): ParseResult;
+
+export { type ParseResult, type ParsedEvent, encodeSSE, parseSSEChunk };

package/dist/sse.js

@@ -0,0 +1,10 @@
+import {
+  encodeSSE,
+  parseSSEChunk
+} from "./chunk-RSG7CUUT.js";
+import "./chunk-WZD2VBMM.js";
+export {
+  encodeSSE,
+  parseSSEChunk
+};
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}