@machinemetrics/agent-event-protocol 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/core.js CHANGED
@@ -15,13 +15,16 @@ import {
15
15
  EventStageSchema,
16
16
  FinishReasonSchema,
17
17
  InputMessageSchema,
18
+ MediaTypeSchema,
18
19
  MetadataEventSchema,
19
20
  TextEventSchema,
20
21
  ThinkingEventSchema,
21
22
  ToolCallEventSchema,
22
23
  ToolResultEventSchema,
23
- UserContentBlockSchema
24
- } from "./chunk-WZD2VBMM.js";
24
+ UserAttachmentBlockSchema,
25
+ UserContentBlockSchema,
26
+ UserTextBlockSchema
27
+ } from "./chunk-434TVYA5.js";
25
28
  export {
26
29
  AbortedEventSchema,
27
30
  ActionResultSchema,
@@ -36,12 +39,15 @@ export {
36
39
  EventStageSchema,
37
40
  FinishReasonSchema,
38
41
  InputMessageSchema,
42
+ MediaTypeSchema,
39
43
  MetadataEventSchema,
40
44
  PROTOCOL_VERSION,
41
45
  TextEventSchema,
42
46
  ThinkingEventSchema,
43
47
  ToolCallEventSchema,
44
48
  ToolResultEventSchema,
45
- UserContentBlockSchema
49
+ UserAttachmentBlockSchema,
50
+ UserContentBlockSchema,
51
+ UserTextBlockSchema
46
52
  };
47
53
  //# sourceMappingURL=core.js.map
package/dist/index.cjs CHANGED
@@ -33,13 +33,16 @@ __export(src_exports, {
33
33
  EventStageSchema: () => EventStageSchema,
34
34
  FinishReasonSchema: () => FinishReasonSchema,
35
35
  InputMessageSchema: () => InputMessageSchema,
36
+ MediaTypeSchema: () => MediaTypeSchema,
36
37
  MetadataEventSchema: () => MetadataEventSchema,
37
38
  PROTOCOL_VERSION: () => PROTOCOL_VERSION,
38
39
  TextEventSchema: () => TextEventSchema,
39
40
  ThinkingEventSchema: () => ThinkingEventSchema,
40
41
  ToolCallEventSchema: () => ToolCallEventSchema,
41
42
  ToolResultEventSchema: () => ToolResultEventSchema,
43
+ UserAttachmentBlockSchema: () => UserAttachmentBlockSchema,
42
44
  UserContentBlockSchema: () => UserContentBlockSchema,
45
+ UserTextBlockSchema: () => UserTextBlockSchema,
43
46
  encodeSSE: () => encodeSSE,
44
47
  parseSSEChunk: () => parseSSEChunk
45
48
  });
@@ -47,10 +50,26 @@ module.exports = __toCommonJS(src_exports);
47
50
 
48
51
  // src/core/schemas.ts
49
52
  var import_zod = require("zod");
50
- var UserContentBlockSchema = import_zod.z.object({
53
+ var import_meta = {};
54
+ var UserTextBlockSchema = import_zod.z.object({
51
55
  type: import_zod.z.literal("text"),
52
56
  text: import_zod.z.string()
53
57
  });
58
+ var RESTRICTED_NAME = "[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}";
59
+ var MediaTypeSchema = import_zod.z.string().regex(
60
+ new RegExp(`^${RESTRICTED_NAME}/${RESTRICTED_NAME}$`),
61
+ "expected a media type such as image/png"
62
+ );
63
+ var UserAttachmentBlockSchema = import_zod.z.object({
64
+ type: import_zod.z.literal("attachment"),
65
+ attachmentId: import_zod.z.string().min(1),
66
+ mimeType: MediaTypeSchema,
67
+ name: import_zod.z.string().min(1).optional()
68
+ });
69
+ var UserContentBlockSchema = import_zod.z.discriminatedUnion("type", [
70
+ UserTextBlockSchema,
71
+ UserAttachmentBlockSchema
72
+ ]);
54
73
  var AssistantContentBlockSchema = import_zod.z.discriminatedUnion("type", [
55
74
  import_zod.z.object({ type: import_zod.z.literal("text"), text: import_zod.z.string() }),
56
75
  import_zod.z.object({ type: import_zod.z.literal("thinking"), text: import_zod.z.string() }),
@@ -65,7 +84,8 @@ var AssistantContentBlockSchema = import_zod.z.discriminatedUnion("type", [
65
84
  toolCallId: import_zod.z.string(),
66
85
  tool: import_zod.z.string(),
67
86
  status: import_zod.z.enum(["success", "error"]),
68
- summary: import_zod.z.string().optional()
87
+ summary: import_zod.z.string().optional(),
88
+ output: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
69
89
  })
70
90
  ]);
71
91
  var InputMessageSchema = import_zod.z.object({
@@ -94,6 +114,7 @@ var ErrorCodeSchema = import_zod.z.enum([
94
114
  "message_too_large",
95
115
  "rate_limit_exceeded",
96
116
  "stream_timeout",
117
+ "stream_stalled",
97
118
  "agent_error",
98
119
  "tool_error",
99
120
  "internal_error",
@@ -154,6 +175,7 @@ var ToolResultEventSchema = import_zod.z.object({
154
175
  tool: import_zod.z.string().optional(),
155
176
  status: import_zod.z.enum(["success", "error"]).optional(),
156
177
  summary: import_zod.z.string().optional(),
178
+ output: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
157
179
  timestamp: import_zod.z.string()
158
180
  });
159
181
  var DoneEventSchema = import_zod.z.object({
@@ -203,6 +225,92 @@ var AgentEventSchema = import_zod.z.discriminatedUnion("event", [
203
225
  AbortedEventSchema,
204
226
  ContinuationEventSchema
205
227
  ]);
228
+ if (import_meta.vitest) {
229
+ const { describe, it, expect } = import_meta.vitest;
230
+ describe("UserContentBlockSchema", () => {
231
+ it("accepts a text block", () => {
232
+ expect(UserContentBlockSchema.safeParse({ type: "text", text: "hi" }).success).toBe(true);
233
+ });
234
+ it("accepts an attachment of any media type, with or without a name", () => {
235
+ for (const block of [
236
+ { type: "attachment", attachmentId: "att-1", mimeType: "image/png" },
237
+ {
238
+ type: "attachment",
239
+ attachmentId: "att-2",
240
+ mimeType: "application/pdf",
241
+ name: "spec.pdf"
242
+ },
243
+ { type: "attachment", attachmentId: "att-3", mimeType: "text/csv", name: "scrap.csv" }
244
+ ]) {
245
+ expect(UserContentBlockSchema.safeParse(block).success).toBe(true);
246
+ }
247
+ });
248
+ it("rejects an attachment without an id", () => {
249
+ expect(
250
+ UserContentBlockSchema.safeParse({ type: "attachment", mimeType: "image/png" }).success
251
+ ).toBe(false);
252
+ });
253
+ it("rejects a malformed media type", () => {
254
+ expect(
255
+ UserContentBlockSchema.safeParse({
256
+ type: "attachment",
257
+ attachmentId: "att-1",
258
+ mimeType: "png"
259
+ }).success
260
+ ).toBe(false);
261
+ });
262
+ it("follows RFC 6838 restricted names for the media type", () => {
263
+ const ok = (mimeType) => UserContentBlockSchema.safeParse({ type: "attachment", attachmentId: "a", mimeType }).success;
264
+ expect(ok("application/vnd.ms-excel")).toBe(true);
265
+ expect(ok("application/x-foo!#$&^_.+-bar")).toBe(true);
266
+ expect(ok("image/svg+xml")).toBe(true);
267
+ expect(ok(".foo/bar")).toBe(false);
268
+ expect(ok("image/-png")).toBe(false);
269
+ expect(ok("image/png; charset=x")).toBe(false);
270
+ expect(ok(`image/${"a".repeat(127)}`)).toBe(true);
271
+ expect(ok(`image/${"a".repeat(128)}`)).toBe(false);
272
+ });
273
+ it("rejects an unknown block type", () => {
274
+ expect(
275
+ UserContentBlockSchema.safeParse({
276
+ type: "image",
277
+ mimeType: "image/png",
278
+ attachmentId: "a"
279
+ }).success
280
+ ).toBe(false);
281
+ });
282
+ });
283
+ describe("ErrorEventSchema", () => {
284
+ it("accepts a stream_stalled error", () => {
285
+ expect(
286
+ AgentEventSchema.safeParse({
287
+ event: "error",
288
+ requestId: "r",
289
+ message: "The agent stopped responding",
290
+ code: "stream_stalled",
291
+ retryable: true,
292
+ timestamp: "2026-11-04T00:00:00.000Z"
293
+ }).success
294
+ ).toBe(true);
295
+ });
296
+ });
297
+ describe("AgentRequestSchema with attachment blocks", () => {
298
+ it("accepts a message mixing text and attachment blocks", () => {
299
+ const result = AgentRequestSchema.safeParse({
300
+ messages: [
301
+ {
302
+ content: [
303
+ { type: "text", text: "What is this?" },
304
+ { type: "attachment", attachmentId: "a", mimeType: "image/webp", name: "photo.webp" }
305
+ ]
306
+ }
307
+ ],
308
+ threadId: "t"
309
+ });
310
+ expect(result.success).toBe(true);
311
+ });
312
+ });
313
+ }
206
314
 
207
315
  // src/core/constants.ts
208
316
  var PROTOCOL_VERSION = "1.0.0";
@@ -219,15 +327,15 @@ var EVENT_TYPES = [
219
327
  ];
220
328
 
221
329
  // src/sse/encode.ts
222
- var import_meta = {};
330
+ var import_meta2 = {};
223
331
  function encodeSSE(event, data) {
224
332
  return `event: ${event}
225
333
  data: ${JSON.stringify(data)}
226
334
 
227
335
  `;
228
336
  }
229
- if (import_meta.vitest) {
230
- const { describe, it, expect } = import_meta.vitest;
337
+ if (import_meta2.vitest) {
338
+ const { describe, it, expect } = import_meta2.vitest;
231
339
  describe("encodeSSE", () => {
232
340
  it("formats SSE event correctly", () => {
233
341
  const result = encodeSSE("metadata", {
@@ -276,7 +384,7 @@ if (import_meta.vitest) {
276
384
  }
277
385
 
278
386
  // src/sse/parse.ts
279
- var import_meta2 = {};
387
+ var import_meta3 = {};
280
388
  function parseSSEChunk(chunk) {
281
389
  const events = [];
282
390
  const blocks = chunk.split("\n\n");
@@ -337,8 +445,8 @@ function parseAndValidate(data, eventType) {
337
445
  raw: parsed
338
446
  };
339
447
  }
340
- if (import_meta2.vitest) {
341
- const { describe, it, expect } = import_meta2.vitest;
448
+ if (import_meta3.vitest) {
449
+ const { describe, it, expect } = import_meta3.vitest;
342
450
  describe("parseSSEChunk", () => {
343
451
  it("parses a single complete event", () => {
344
452
  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';
@@ -445,13 +553,16 @@ if (import_meta2.vitest) {
445
553
  EventStageSchema,
446
554
  FinishReasonSchema,
447
555
  InputMessageSchema,
556
+ MediaTypeSchema,
448
557
  MetadataEventSchema,
449
558
  PROTOCOL_VERSION,
450
559
  TextEventSchema,
451
560
  ThinkingEventSchema,
452
561
  ToolCallEventSchema,
453
562
  ToolResultEventSchema,
563
+ UserAttachmentBlockSchema,
454
564
  UserContentBlockSchema,
565
+ UserTextBlockSchema,
455
566
  encodeSSE,
456
567
  parseSSEChunk
457
568
  });
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/core/schemas.ts","../src/core/constants.ts","../src/sse/encode.ts","../src/sse/parse.ts"],"sourcesContent":["export * from './core/index.js';\nexport * from './sse/index.js';\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","/**\n * Current protocol version.\n * Additive changes (new events, optional fields) don't require version bump.\n * Breaking changes require new endpoint version (v2, v3, etc).\n */\nexport const PROTOCOL_VERSION = '1.0.0';\n\n/**\n * All valid event type identifiers in the protocol.\n * Used for discriminated union parsing and validation.\n */\nexport const EVENT_TYPES = [\n 'metadata',\n 'text',\n 'thinking',\n 'tool_call',\n 'tool_result',\n 'done',\n 'error',\n 'aborted',\n 'continuation',\n] as const;\n\n/**\n * Event type identifier.\n * Union of all valid event type strings.\n */\nexport type EventType = (typeof EVENT_TYPES)[number];\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 { 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"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/core/schemas.ts","../src/core/constants.ts","../src/sse/encode.ts","../src/sse/parse.ts"],"sourcesContent":["export * from './core/index.js';\nexport * from './sse/index.js';\n","import { z } from 'zod';\n\n/**\n * Zod schema for a user text block.\n */\nexport const UserTextBlockSchema = z.object({\n type: z.literal('text'),\n text: z.string(),\n});\n\n/**\n * Zod schema for a media type (`type/subtype`, e.g. `image/png`,\n * `application/pdf`): RFC 6838 restricted names, each starting with a letter\n * or digit and at most 127 characters. Which media types a server accepts is the server's\n * decision, not the protocol's.\n */\nconst RESTRICTED_NAME = '[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}';\n\nexport const MediaTypeSchema = z\n .string()\n .regex(\n new RegExp(`^${RESTRICTED_NAME}/${RESTRICTED_NAME}$`),\n 'expected a media type such as image/png',\n );\n\n/**\n * Zod schema for a user attachment block: a file the user uploaded ahead of\n * the message and now refers to by id. How the file reaches the model (an\n * image, a document, extracted text, a tool) is the server's decision.\n */\nexport const UserAttachmentBlockSchema = z.object({\n type: z.literal('attachment'),\n attachmentId: z.string().min(1),\n mimeType: MediaTypeSchema,\n name: z.string().min(1).optional(),\n});\n\n/**\n * Zod schema for validating user content blocks: text or an attachment.\n */\nexport const UserContentBlockSchema = z.discriminatedUnion('type', [\n UserTextBlockSchema,\n UserAttachmentBlockSchema,\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 output: z.record(z.string(), z.unknown()).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 'stream_stalled',\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 output: z.record(z.string(), z.unknown()).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\nif (import.meta.vitest) {\n const { describe, it, expect } = import.meta.vitest;\n\n describe('UserContentBlockSchema', () => {\n it('accepts a text block', () => {\n expect(UserContentBlockSchema.safeParse({ type: 'text', text: 'hi' }).success).toBe(true);\n });\n\n it('accepts an attachment of any media type, with or without a name', () => {\n for (const block of [\n { type: 'attachment', attachmentId: 'att-1', mimeType: 'image/png' },\n {\n type: 'attachment',\n attachmentId: 'att-2',\n mimeType: 'application/pdf',\n name: 'spec.pdf',\n },\n { type: 'attachment', attachmentId: 'att-3', mimeType: 'text/csv', name: 'scrap.csv' },\n ]) {\n expect(UserContentBlockSchema.safeParse(block).success).toBe(true);\n }\n });\n\n it('rejects an attachment without an id', () => {\n expect(\n UserContentBlockSchema.safeParse({ type: 'attachment', mimeType: 'image/png' }).success,\n ).toBe(false);\n });\n\n it('rejects a malformed media type', () => {\n expect(\n UserContentBlockSchema.safeParse({\n type: 'attachment',\n attachmentId: 'att-1',\n mimeType: 'png',\n }).success,\n ).toBe(false);\n });\n\n it('follows RFC 6838 restricted names for the media type', () => {\n const ok = (mimeType: string) =>\n UserContentBlockSchema.safeParse({ type: 'attachment', attachmentId: 'a', mimeType })\n .success;\n expect(ok('application/vnd.ms-excel')).toBe(true);\n expect(ok('application/x-foo!#$&^_.+-bar')).toBe(true);\n expect(ok('image/svg+xml')).toBe(true);\n expect(ok('.foo/bar')).toBe(false);\n expect(ok('image/-png')).toBe(false);\n expect(ok('image/png; charset=x')).toBe(false);\n expect(ok(`image/${'a'.repeat(127)}`)).toBe(true);\n expect(ok(`image/${'a'.repeat(128)}`)).toBe(false);\n });\n\n it('rejects an unknown block type', () => {\n expect(\n UserContentBlockSchema.safeParse({\n type: 'image',\n mimeType: 'image/png',\n attachmentId: 'a',\n }).success,\n ).toBe(false);\n });\n });\n\n describe('ErrorEventSchema', () => {\n it('accepts a stream_stalled error', () => {\n expect(\n AgentEventSchema.safeParse({\n event: 'error',\n requestId: 'r',\n message: 'The agent stopped responding',\n code: 'stream_stalled',\n retryable: true,\n timestamp: '2026-11-04T00:00:00.000Z',\n }).success,\n ).toBe(true);\n });\n });\n\n describe('AgentRequestSchema with attachment blocks', () => {\n it('accepts a message mixing text and attachment blocks', () => {\n const result = AgentRequestSchema.safeParse({\n messages: [\n {\n content: [\n { type: 'text', text: 'What is this?' },\n { type: 'attachment', attachmentId: 'a', mimeType: 'image/webp', name: 'photo.webp' },\n ],\n },\n ],\n threadId: 't',\n });\n expect(result.success).toBe(true);\n });\n });\n}\n","/**\n * Current protocol version.\n * Additive changes (new events, optional fields) don't require version bump.\n * Breaking changes require new endpoint version (v2, v3, etc).\n */\nexport const PROTOCOL_VERSION = '1.0.0';\n\n/**\n * All valid event type identifiers in the protocol.\n * Used for discriminated union parsing and validation.\n */\nexport const EVENT_TYPES = [\n 'metadata',\n 'text',\n 'thinking',\n 'tool_call',\n 'tool_result',\n 'done',\n 'error',\n 'aborted',\n 'continuation',\n] as const;\n\n/**\n * Event type identifier.\n * Union of all valid event type strings.\n */\nexport type EventType = (typeof EVENT_TYPES)[number];\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 { 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","import_meta"]}
package/dist/index.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- export { h as AbortedEvent, a as ActionResult, i as AgentEvent, b as AgentRequest, A as AssistantContentBlock, C as ContinuationEvent, D as DoneEvent, c as ErrorCode, g as ErrorEvent, E as EventStage, F as FinishReason, I as InputMessage, M as MetadataEvent, T as TextEvent, d as ThinkingEvent, e as ToolCallEvent, f as ToolResultEvent, U as UserContentBlock } from './types-CttB5bnC.cjs';
2
- export { AbortedEventSchema, ActionResultSchema, AgentEventSchema, AgentRequestSchema, AssistantContentBlockSchema, ContinuationEventSchema, DoneEventSchema, EVENT_TYPES, ErrorCodeSchema, ErrorEventSchema, EventStageSchema, EventType, FinishReasonSchema, InputMessageSchema, MetadataEventSchema, PROTOCOL_VERSION, TextEventSchema, ThinkingEventSchema, ToolCallEventSchema, ToolResultEventSchema, UserContentBlockSchema } from './core.cjs';
1
+ export { h as AbortedEvent, a as ActionResult, i as AgentEvent, b as AgentRequest, A as AssistantContentBlock, C as ContinuationEvent, D as DoneEvent, c as ErrorCode, g as ErrorEvent, E as EventStage, F as FinishReason, I as InputMessage, M as MetadataEvent, T as TextEvent, d as ThinkingEvent, e as ToolCallEvent, f as ToolResultEvent, U as UserContentBlock } from './types-HORFdRxd.cjs';
2
+ export { AbortedEventSchema, ActionResultSchema, AgentEventSchema, AgentRequestSchema, AssistantContentBlockSchema, ContinuationEventSchema, DoneEventSchema, EVENT_TYPES, ErrorCodeSchema, ErrorEventSchema, EventStageSchema, EventType, FinishReasonSchema, InputMessageSchema, MediaTypeSchema, MetadataEventSchema, PROTOCOL_VERSION, TextEventSchema, ThinkingEventSchema, ToolCallEventSchema, ToolResultEventSchema, UserAttachmentBlockSchema, UserContentBlockSchema, UserTextBlockSchema } from './core.cjs';
3
3
  export { ParseResult, ParsedEvent, encodeSSE, parseSSEChunk } from './sse.cjs';
4
4
  import 'zod';
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { h as AbortedEvent, a as ActionResult, i as AgentEvent, b as AgentRequest, A as AssistantContentBlock, C as ContinuationEvent, D as DoneEvent, c as ErrorCode, g as ErrorEvent, E as EventStage, F as FinishReason, I as InputMessage, M as MetadataEvent, T as TextEvent, d as ThinkingEvent, e as ToolCallEvent, f as ToolResultEvent, U as UserContentBlock } from './types-CttB5bnC.js';
2
- export { AbortedEventSchema, ActionResultSchema, AgentEventSchema, AgentRequestSchema, AssistantContentBlockSchema, ContinuationEventSchema, DoneEventSchema, EVENT_TYPES, ErrorCodeSchema, ErrorEventSchema, EventStageSchema, EventType, FinishReasonSchema, InputMessageSchema, MetadataEventSchema, PROTOCOL_VERSION, TextEventSchema, ThinkingEventSchema, ToolCallEventSchema, ToolResultEventSchema, UserContentBlockSchema } from './core.js';
1
+ export { h as AbortedEvent, a as ActionResult, i as AgentEvent, b as AgentRequest, A as AssistantContentBlock, C as ContinuationEvent, D as DoneEvent, c as ErrorCode, g as ErrorEvent, E as EventStage, F as FinishReason, I as InputMessage, M as MetadataEvent, T as TextEvent, d as ThinkingEvent, e as ToolCallEvent, f as ToolResultEvent, U as UserContentBlock } from './types-HORFdRxd.js';
2
+ export { AbortedEventSchema, ActionResultSchema, AgentEventSchema, AgentRequestSchema, AssistantContentBlockSchema, ContinuationEventSchema, DoneEventSchema, EVENT_TYPES, ErrorCodeSchema, ErrorEventSchema, EventStageSchema, EventType, FinishReasonSchema, InputMessageSchema, MediaTypeSchema, MetadataEventSchema, PROTOCOL_VERSION, TextEventSchema, ThinkingEventSchema, ToolCallEventSchema, ToolResultEventSchema, UserAttachmentBlockSchema, UserContentBlockSchema, UserTextBlockSchema } from './core.js';
3
3
  export { ParseResult, ParsedEvent, encodeSSE, parseSSEChunk } from './sse.js';
4
4
  import 'zod';
package/dist/index.js CHANGED
@@ -5,7 +5,7 @@ import {
5
5
  import {
6
6
  encodeSSE,
7
7
  parseSSEChunk
8
- } from "./chunk-RSG7CUUT.js";
8
+ } from "./chunk-QIKNRCHJ.js";
9
9
  import {
10
10
  AbortedEventSchema,
11
11
  ActionResultSchema,
@@ -19,13 +19,16 @@ import {
19
19
  EventStageSchema,
20
20
  FinishReasonSchema,
21
21
  InputMessageSchema,
22
+ MediaTypeSchema,
22
23
  MetadataEventSchema,
23
24
  TextEventSchema,
24
25
  ThinkingEventSchema,
25
26
  ToolCallEventSchema,
26
27
  ToolResultEventSchema,
27
- UserContentBlockSchema
28
- } from "./chunk-WZD2VBMM.js";
28
+ UserAttachmentBlockSchema,
29
+ UserContentBlockSchema,
30
+ UserTextBlockSchema
31
+ } from "./chunk-434TVYA5.js";
29
32
  export {
30
33
  AbortedEventSchema,
31
34
  ActionResultSchema,
@@ -40,13 +43,16 @@ export {
40
43
  EventStageSchema,
41
44
  FinishReasonSchema,
42
45
  InputMessageSchema,
46
+ MediaTypeSchema,
43
47
  MetadataEventSchema,
44
48
  PROTOCOL_VERSION,
45
49
  TextEventSchema,
46
50
  ThinkingEventSchema,
47
51
  ToolCallEventSchema,
48
52
  ToolResultEventSchema,
53
+ UserAttachmentBlockSchema,
49
54
  UserContentBlockSchema,
55
+ UserTextBlockSchema,
50
56
  encodeSSE,
51
57
  parseSSEChunk
52
58
  };
package/dist/sse.cjs CHANGED
@@ -84,10 +84,26 @@ if (import_meta.vitest) {
84
84
 
85
85
  // src/core/schemas.ts
86
86
  var import_zod = require("zod");
87
- var UserContentBlockSchema = import_zod.z.object({
87
+ var import_meta2 = {};
88
+ var UserTextBlockSchema = import_zod.z.object({
88
89
  type: import_zod.z.literal("text"),
89
90
  text: import_zod.z.string()
90
91
  });
92
+ var RESTRICTED_NAME = "[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}";
93
+ var MediaTypeSchema = import_zod.z.string().regex(
94
+ new RegExp(`^${RESTRICTED_NAME}/${RESTRICTED_NAME}$`),
95
+ "expected a media type such as image/png"
96
+ );
97
+ var UserAttachmentBlockSchema = import_zod.z.object({
98
+ type: import_zod.z.literal("attachment"),
99
+ attachmentId: import_zod.z.string().min(1),
100
+ mimeType: MediaTypeSchema,
101
+ name: import_zod.z.string().min(1).optional()
102
+ });
103
+ var UserContentBlockSchema = import_zod.z.discriminatedUnion("type", [
104
+ UserTextBlockSchema,
105
+ UserAttachmentBlockSchema
106
+ ]);
91
107
  var AssistantContentBlockSchema = import_zod.z.discriminatedUnion("type", [
92
108
  import_zod.z.object({ type: import_zod.z.literal("text"), text: import_zod.z.string() }),
93
109
  import_zod.z.object({ type: import_zod.z.literal("thinking"), text: import_zod.z.string() }),
@@ -102,7 +118,8 @@ var AssistantContentBlockSchema = import_zod.z.discriminatedUnion("type", [
102
118
  toolCallId: import_zod.z.string(),
103
119
  tool: import_zod.z.string(),
104
120
  status: import_zod.z.enum(["success", "error"]),
105
- summary: import_zod.z.string().optional()
121
+ summary: import_zod.z.string().optional(),
122
+ output: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
106
123
  })
107
124
  ]);
108
125
  var InputMessageSchema = import_zod.z.object({
@@ -131,6 +148,7 @@ var ErrorCodeSchema = import_zod.z.enum([
131
148
  "message_too_large",
132
149
  "rate_limit_exceeded",
133
150
  "stream_timeout",
151
+ "stream_stalled",
134
152
  "agent_error",
135
153
  "tool_error",
136
154
  "internal_error",
@@ -191,6 +209,7 @@ var ToolResultEventSchema = import_zod.z.object({
191
209
  tool: import_zod.z.string().optional(),
192
210
  status: import_zod.z.enum(["success", "error"]).optional(),
193
211
  summary: import_zod.z.string().optional(),
212
+ output: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
194
213
  timestamp: import_zod.z.string()
195
214
  });
196
215
  var DoneEventSchema = import_zod.z.object({
@@ -240,9 +259,95 @@ var AgentEventSchema = import_zod.z.discriminatedUnion("event", [
240
259
  AbortedEventSchema,
241
260
  ContinuationEventSchema
242
261
  ]);
262
+ if (import_meta2.vitest) {
263
+ const { describe, it, expect } = import_meta2.vitest;
264
+ describe("UserContentBlockSchema", () => {
265
+ it("accepts a text block", () => {
266
+ expect(UserContentBlockSchema.safeParse({ type: "text", text: "hi" }).success).toBe(true);
267
+ });
268
+ it("accepts an attachment of any media type, with or without a name", () => {
269
+ for (const block of [
270
+ { type: "attachment", attachmentId: "att-1", mimeType: "image/png" },
271
+ {
272
+ type: "attachment",
273
+ attachmentId: "att-2",
274
+ mimeType: "application/pdf",
275
+ name: "spec.pdf"
276
+ },
277
+ { type: "attachment", attachmentId: "att-3", mimeType: "text/csv", name: "scrap.csv" }
278
+ ]) {
279
+ expect(UserContentBlockSchema.safeParse(block).success).toBe(true);
280
+ }
281
+ });
282
+ it("rejects an attachment without an id", () => {
283
+ expect(
284
+ UserContentBlockSchema.safeParse({ type: "attachment", mimeType: "image/png" }).success
285
+ ).toBe(false);
286
+ });
287
+ it("rejects a malformed media type", () => {
288
+ expect(
289
+ UserContentBlockSchema.safeParse({
290
+ type: "attachment",
291
+ attachmentId: "att-1",
292
+ mimeType: "png"
293
+ }).success
294
+ ).toBe(false);
295
+ });
296
+ it("follows RFC 6838 restricted names for the media type", () => {
297
+ const ok = (mimeType) => UserContentBlockSchema.safeParse({ type: "attachment", attachmentId: "a", mimeType }).success;
298
+ expect(ok("application/vnd.ms-excel")).toBe(true);
299
+ expect(ok("application/x-foo!#$&^_.+-bar")).toBe(true);
300
+ expect(ok("image/svg+xml")).toBe(true);
301
+ expect(ok(".foo/bar")).toBe(false);
302
+ expect(ok("image/-png")).toBe(false);
303
+ expect(ok("image/png; charset=x")).toBe(false);
304
+ expect(ok(`image/${"a".repeat(127)}`)).toBe(true);
305
+ expect(ok(`image/${"a".repeat(128)}`)).toBe(false);
306
+ });
307
+ it("rejects an unknown block type", () => {
308
+ expect(
309
+ UserContentBlockSchema.safeParse({
310
+ type: "image",
311
+ mimeType: "image/png",
312
+ attachmentId: "a"
313
+ }).success
314
+ ).toBe(false);
315
+ });
316
+ });
317
+ describe("ErrorEventSchema", () => {
318
+ it("accepts a stream_stalled error", () => {
319
+ expect(
320
+ AgentEventSchema.safeParse({
321
+ event: "error",
322
+ requestId: "r",
323
+ message: "The agent stopped responding",
324
+ code: "stream_stalled",
325
+ retryable: true,
326
+ timestamp: "2026-11-04T00:00:00.000Z"
327
+ }).success
328
+ ).toBe(true);
329
+ });
330
+ });
331
+ describe("AgentRequestSchema with attachment blocks", () => {
332
+ it("accepts a message mixing text and attachment blocks", () => {
333
+ const result = AgentRequestSchema.safeParse({
334
+ messages: [
335
+ {
336
+ content: [
337
+ { type: "text", text: "What is this?" },
338
+ { type: "attachment", attachmentId: "a", mimeType: "image/webp", name: "photo.webp" }
339
+ ]
340
+ }
341
+ ],
342
+ threadId: "t"
343
+ });
344
+ expect(result.success).toBe(true);
345
+ });
346
+ });
347
+ }
243
348
 
244
349
  // src/sse/parse.ts
245
- var import_meta2 = {};
350
+ var import_meta3 = {};
246
351
  function parseSSEChunk(chunk) {
247
352
  const events = [];
248
353
  const blocks = chunk.split("\n\n");
@@ -303,8 +408,8 @@ function parseAndValidate(data, eventType) {
303
408
  raw: parsed
304
409
  };
305
410
  }
306
- if (import_meta2.vitest) {
307
- const { describe, it, expect } = import_meta2.vitest;
411
+ if (import_meta3.vitest) {
412
+ const { describe, it, expect } = import_meta3.vitest;
308
413
  describe("parseSSEChunk", () => {
309
414
  it("parses a single complete event", () => {
310
415
  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';