@machinemetrics/agent-event-protocol 0.1.0

package/dist/core.d.ts

@@ -0,0 +1,463 @@
+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';
+import { z } from 'zod';
+
+/**
+ * Zod schema for validating user content blocks.
+ * Currently only supports text; extensible for multimodal.
+ */
+declare const UserContentBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for validating assistant content blocks.
+ * Discriminated union supporting text, thinking, tool_use, and tool_result.
+ */
+declare const AssistantContentBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"thinking">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_use">;
+    toolCallId: z.ZodString;
+    tool: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    toolCallId: z.ZodString;
+    tool: z.ZodString;
+    status: z.ZodEnum<{
+        success: "success";
+        error: "error";
+    }>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+/**
+ * Zod schema for validating input messages.
+ */
+declare const InputMessageSchema: z.ZodObject<{
+    content: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for validating action results from continuation events.
+ */
+declare const ActionResultSchema: z.ZodObject<{
+    actionId: z.ZodString;
+    kind: z.ZodString;
+    status: z.ZodEnum<{
+        success: "success";
+        error: "error";
+    }>;
+    data: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for validating agent request payloads.
+ * Context object uses passthrough() to allow additional fields.
+ */
+declare const AgentRequestSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        content: z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    threadId: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        actionResults: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            actionId: z.ZodString;
+            kind: z.ZodString;
+            status: z.ZodEnum<{
+                success: "success";
+                error: "error";
+            }>;
+            data: z.ZodOptional<z.ZodUnknown>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for event lifecycle stages.
+ */
+declare const EventStageSchema: z.ZodEnum<{
+    start: "start";
+    delta: "delta";
+    stop: "stop";
+}>;
+/**
+ * Zod schema for protocol error codes.
+ */
+declare const ErrorCodeSchema: z.ZodEnum<{
+    auth_failed: "auth_failed";
+    thread_not_found: "thread_not_found";
+    thread_access_denied: "thread_access_denied";
+    invalid_message_format: "invalid_message_format";
+    message_too_large: "message_too_large";
+    rate_limit_exceeded: "rate_limit_exceeded";
+    stream_timeout: "stream_timeout";
+    agent_error: "agent_error";
+    tool_error: "tool_error";
+    internal_error: "internal_error";
+    invalid_action_id: "invalid_action_id";
+}>;
+/**
+ * Zod schema for stream finish reasons.
+ */
+declare const FinishReasonSchema: z.ZodEnum<{
+    error: "error";
+    stop: "stop";
+    length: "length";
+    action_required: "action_required";
+}>;
+/**
+ * Zod schema for metadata events.
+ * First event in every stream, provides identifiers.
+ */
+declare const MetadataEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"metadata">;
+    requestId: z.ZodString;
+    threadId: z.ZodString;
+    agentId: z.ZodString;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for text streaming events.
+ * Validates the stage lifecycle with appropriate optional fields per stage.
+ */
+declare const TextEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"text">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    delta: z.ZodOptional<z.ZodString>;
+    deltaIndex: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for thinking/reasoning events.
+ * Structure mirrors TextEventSchema.
+ */
+declare const ThinkingEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"thinking">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    delta: z.ZodOptional<z.ZodString>;
+    deltaIndex: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for tool call events.
+ * Args are optional (only present on stop stage).
+ */
+declare const ToolCallEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"tool_call">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    delta: z.ZodOptional<z.ZodString>;
+    deltaIndex: z.ZodOptional<z.ZodNumber>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for tool result events.
+ * Status and summary only present on stop stage.
+ */
+declare const ToolResultEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"tool_result">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        error: "error";
+    }>>;
+    summary: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for done events.
+ * Terminal event with complete content array.
+ */
+declare const DoneEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"done">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"thinking">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_use">;
+        toolCallId: z.ZodString;
+        tool: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_result">;
+        toolCallId: z.ZodString;
+        tool: z.ZodString;
+        status: z.ZodEnum<{
+            success: "success";
+            error: "error";
+        }>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>;
+    usage: z.ZodOptional<z.ZodObject<{
+        promptTokens: z.ZodNumber;
+        completionTokens: z.ZodNumber;
+    }, z.core.$strip>>;
+    finishReason: z.ZodEnum<{
+        error: "error";
+        stop: "stop";
+        length: "length";
+        action_required: "action_required";
+    }>;
+    traceId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for error events.
+ * Terminal event with error details and retry guidance.
+ */
+declare const ErrorEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"error">;
+    requestId: z.ZodString;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodEnum<{
+        auth_failed: "auth_failed";
+        thread_not_found: "thread_not_found";
+        thread_access_denied: "thread_access_denied";
+        invalid_message_format: "invalid_message_format";
+        message_too_large: "message_too_large";
+        rate_limit_exceeded: "rate_limit_exceeded";
+        stream_timeout: "stream_timeout";
+        agent_error: "agent_error";
+        tool_error: "tool_error";
+        internal_error: "internal_error";
+        invalid_action_id: "invalid_action_id";
+    }>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for aborted events.
+ * Terminal event acknowledging client cancellation.
+ */
+declare const AbortedEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"aborted">;
+    requestId: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for continuation events.
+ * Signals client action required before stream can continue.
+ */
+declare const ContinuationEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"continuation">;
+    requestId: z.ZodString;
+    actionId: z.ZodString;
+    kind: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for all protocol events.
+ * Discriminated union on the `event` field for efficient parsing.
+ */
+declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    event: z.ZodLiteral<"metadata">;
+    requestId: z.ZodString;
+    threadId: z.ZodString;
+    agentId: z.ZodString;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"text">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    delta: z.ZodOptional<z.ZodString>;
+    deltaIndex: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"thinking">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    delta: z.ZodOptional<z.ZodString>;
+    deltaIndex: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"tool_call">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    delta: z.ZodOptional<z.ZodString>;
+    deltaIndex: z.ZodOptional<z.ZodNumber>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"tool_result">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    blockId: z.ZodString;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+    stage: z.ZodEnum<{
+        start: "start";
+        delta: "delta";
+        stop: "stop";
+    }>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        error: "error";
+    }>>;
+    summary: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"done">;
+    requestId: z.ZodString;
+    messageId: z.ZodString;
+    threadId: z.ZodString;
+    content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"thinking">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_use">;
+        toolCallId: z.ZodString;
+        tool: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_result">;
+        toolCallId: z.ZodString;
+        tool: z.ZodString;
+        status: z.ZodEnum<{
+            success: "success";
+            error: "error";
+        }>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>;
+    usage: z.ZodOptional<z.ZodObject<{
+        promptTokens: z.ZodNumber;
+        completionTokens: z.ZodNumber;
+    }, z.core.$strip>>;
+    finishReason: z.ZodEnum<{
+        error: "error";
+        stop: "stop";
+        length: "length";
+        action_required: "action_required";
+    }>;
+    traceId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"error">;
+    requestId: z.ZodString;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodEnum<{
+        auth_failed: "auth_failed";
+        thread_not_found: "thread_not_found";
+        thread_access_denied: "thread_access_denied";
+        invalid_message_format: "invalid_message_format";
+        message_too_large: "message_too_large";
+        rate_limit_exceeded: "rate_limit_exceeded";
+        stream_timeout: "stream_timeout";
+        agent_error: "agent_error";
+        tool_error: "tool_error";
+        internal_error: "internal_error";
+        invalid_action_id: "invalid_action_id";
+    }>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"aborted">;
+    requestId: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"continuation">;
+    requestId: z.ZodString;
+    actionId: z.ZodString;
+    kind: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    timestamp: z.ZodString;
+}, z.core.$strip>], "event">;
+
+/**
+ * Current protocol version.
+ * Additive changes (new events, optional fields) don't require version bump.
+ * Breaking changes require new endpoint version (v2, v3, etc).
+ */
+declare const PROTOCOL_VERSION = "1.0.0";
+/**
+ * All valid event type identifiers in the protocol.
+ * Used for discriminated union parsing and validation.
+ */
+declare const EVENT_TYPES: readonly ["metadata", "text", "thinking", "tool_call", "tool_result", "done", "error", "aborted", "continuation"];
+/**
+ * Event type identifier.
+ * Union of all valid event type strings.
+ */
+type EventType = (typeof EVENT_TYPES)[number];
+
+export { AbortedEventSchema, ActionResultSchema, AgentEventSchema, AgentRequestSchema, AssistantContentBlockSchema, ContinuationEventSchema, DoneEventSchema, EVENT_TYPES, ErrorCodeSchema, ErrorEventSchema, EventStageSchema, type EventType, FinishReasonSchema, InputMessageSchema, MetadataEventSchema, PROTOCOL_VERSION, TextEventSchema, ThinkingEventSchema, ToolCallEventSchema, ToolResultEventSchema, UserContentBlockSchema };

package/dist/core.js

@@ -0,0 +1,47 @@
+import {
+  EVENT_TYPES,
+  PROTOCOL_VERSION
+} from "./chunk-ZINGYSGU.js";
+import {
+  AbortedEventSchema,
+  ActionResultSchema,
+  AgentEventSchema,
+  AgentRequestSchema,
+  AssistantContentBlockSchema,
+  ContinuationEventSchema,
+  DoneEventSchema,
+  ErrorCodeSchema,
+  ErrorEventSchema,
+  EventStageSchema,
+  FinishReasonSchema,
+  InputMessageSchema,
+  MetadataEventSchema,
+  TextEventSchema,
+  ThinkingEventSchema,
+  ToolCallEventSchema,
+  ToolResultEventSchema,
+  UserContentBlockSchema
+} from "./chunk-WZD2VBMM.js";
+export {
+  AbortedEventSchema,
+  ActionResultSchema,
+  AgentEventSchema,
+  AgentRequestSchema,
+  AssistantContentBlockSchema,
+  ContinuationEventSchema,
+  DoneEventSchema,
+  EVENT_TYPES,
+  ErrorCodeSchema,
+  ErrorEventSchema,
+  EventStageSchema,
+  FinishReasonSchema,
+  InputMessageSchema,
+  MetadataEventSchema,
+  PROTOCOL_VERSION,
+  TextEventSchema,
+  ThinkingEventSchema,
+  ToolCallEventSchema,
+  ToolResultEventSchema,
+  UserContentBlockSchema
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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