@machinemetrics/agent-event-protocol 0.1.1 → 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/README.md +48 -42
- package/dist/{chunk-H5AXHRSE.js → chunk-434TVYA5.js} +107 -2
- package/dist/chunk-434TVYA5.js.map +1 -0
- package/dist/{chunk-VDBWUNSK.js → chunk-QIKNRCHJ.js} +2 -2
- package/dist/core.cjs +112 -3
- package/dist/core.cjs.map +1 -1
- package/dist/core.d.cts +137 -28
- package/dist/core.d.ts +137 -28
- package/dist/core.js +9 -3
- package/dist/index.cjs +116 -7
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +9 -3
- package/dist/sse.cjs +107 -4
- package/dist/sse.cjs.map +1 -1
- package/dist/sse.d.cts +1 -1
- package/dist/sse.d.ts +1 -1
- package/dist/sse.js +2 -2
- package/dist/{types--3D3jbpT.d.cts → types-HORFdRxd.d.cts} +14 -1
- package/dist/{types--3D3jbpT.d.ts → types-HORFdRxd.d.ts} +14 -1
- package/package.json +10 -10
- package/dist/chunk-H5AXHRSE.js.map +0 -1
- /package/dist/{chunk-VDBWUNSK.js.map → chunk-QIKNRCHJ.js.map} +0 -0
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
|
|
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() }),
|
|
@@ -95,6 +114,7 @@ var ErrorCodeSchema = import_zod.z.enum([
|
|
|
95
114
|
"message_too_large",
|
|
96
115
|
"rate_limit_exceeded",
|
|
97
116
|
"stream_timeout",
|
|
117
|
+
"stream_stalled",
|
|
98
118
|
"agent_error",
|
|
99
119
|
"tool_error",
|
|
100
120
|
"internal_error",
|
|
@@ -205,6 +225,92 @@ var AgentEventSchema = import_zod.z.discriminatedUnion("event", [
|
|
|
205
225
|
AbortedEventSchema,
|
|
206
226
|
ContinuationEventSchema
|
|
207
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
|
+
}
|
|
208
314
|
|
|
209
315
|
// src/core/constants.ts
|
|
210
316
|
var PROTOCOL_VERSION = "1.0.0";
|
|
@@ -221,15 +327,15 @@ var EVENT_TYPES = [
|
|
|
221
327
|
];
|
|
222
328
|
|
|
223
329
|
// src/sse/encode.ts
|
|
224
|
-
var
|
|
330
|
+
var import_meta2 = {};
|
|
225
331
|
function encodeSSE(event, data) {
|
|
226
332
|
return `event: ${event}
|
|
227
333
|
data: ${JSON.stringify(data)}
|
|
228
334
|
|
|
229
335
|
`;
|
|
230
336
|
}
|
|
231
|
-
if (
|
|
232
|
-
const { describe, it, expect } =
|
|
337
|
+
if (import_meta2.vitest) {
|
|
338
|
+
const { describe, it, expect } = import_meta2.vitest;
|
|
233
339
|
describe("encodeSSE", () => {
|
|
234
340
|
it("formats SSE event correctly", () => {
|
|
235
341
|
const result = encodeSSE("metadata", {
|
|
@@ -278,7 +384,7 @@ if (import_meta.vitest) {
|
|
|
278
384
|
}
|
|
279
385
|
|
|
280
386
|
// src/sse/parse.ts
|
|
281
|
-
var
|
|
387
|
+
var import_meta3 = {};
|
|
282
388
|
function parseSSEChunk(chunk) {
|
|
283
389
|
const events = [];
|
|
284
390
|
const blocks = chunk.split("\n\n");
|
|
@@ -339,8 +445,8 @@ function parseAndValidate(data, eventType) {
|
|
|
339
445
|
raw: parsed
|
|
340
446
|
};
|
|
341
447
|
}
|
|
342
|
-
if (
|
|
343
|
-
const { describe, it, expect } =
|
|
448
|
+
if (import_meta3.vitest) {
|
|
449
|
+
const { describe, it, expect } = import_meta3.vitest;
|
|
344
450
|
describe("parseSSEChunk", () => {
|
|
345
451
|
it("parses a single complete event", () => {
|
|
346
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';
|
|
@@ -447,13 +553,16 @@ if (import_meta2.vitest) {
|
|
|
447
553
|
EventStageSchema,
|
|
448
554
|
FinishReasonSchema,
|
|
449
555
|
InputMessageSchema,
|
|
556
|
+
MediaTypeSchema,
|
|
450
557
|
MetadataEventSchema,
|
|
451
558
|
PROTOCOL_VERSION,
|
|
452
559
|
TextEventSchema,
|
|
453
560
|
ThinkingEventSchema,
|
|
454
561
|
ToolCallEventSchema,
|
|
455
562
|
ToolResultEventSchema,
|
|
563
|
+
UserAttachmentBlockSchema,
|
|
456
564
|
UserContentBlockSchema,
|
|
565
|
+
UserTextBlockSchema,
|
|
457
566
|
encodeSSE,
|
|
458
567
|
parseSSEChunk
|
|
459
568
|
});
|
package/dist/index.cjs.map
CHANGED
|
@@ -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 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 '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","/**\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
|
|
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
|
|
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-
|
|
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
|
-
|
|
28
|
-
|
|
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
|
|
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() }),
|
|
@@ -132,6 +148,7 @@ var ErrorCodeSchema = import_zod.z.enum([
|
|
|
132
148
|
"message_too_large",
|
|
133
149
|
"rate_limit_exceeded",
|
|
134
150
|
"stream_timeout",
|
|
151
|
+
"stream_stalled",
|
|
135
152
|
"agent_error",
|
|
136
153
|
"tool_error",
|
|
137
154
|
"internal_error",
|
|
@@ -242,9 +259,95 @@ var AgentEventSchema = import_zod.z.discriminatedUnion("event", [
|
|
|
242
259
|
AbortedEventSchema,
|
|
243
260
|
ContinuationEventSchema
|
|
244
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
|
+
}
|
|
245
348
|
|
|
246
349
|
// src/sse/parse.ts
|
|
247
|
-
var
|
|
350
|
+
var import_meta3 = {};
|
|
248
351
|
function parseSSEChunk(chunk) {
|
|
249
352
|
const events = [];
|
|
250
353
|
const blocks = chunk.split("\n\n");
|
|
@@ -305,8 +408,8 @@ function parseAndValidate(data, eventType) {
|
|
|
305
408
|
raw: parsed
|
|
306
409
|
};
|
|
307
410
|
}
|
|
308
|
-
if (
|
|
309
|
-
const { describe, it, expect } =
|
|
411
|
+
if (import_meta3.vitest) {
|
|
412
|
+
const { describe, it, expect } = import_meta3.vitest;
|
|
310
413
|
describe("parseSSEChunk", () => {
|
|
311
414
|
it("parses a single complete event", () => {
|
|
312
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';
|