Module upstream 

Extracts the AG-UI event surface from the upstream TypeScript source of truth (sdks/typescript/packages/core/src/events.ts).

The upstream file is Zod, not a schema format, so this is deliberately a narrow reader rather than a TypeScript parser. It understands exactly the shapes the event declarations use:

export enum EventType { NAME = "VALUE", ... }
export const XEventSchema = BaseEventSchema.extend({ field: z.string().optional(), ... });
export const YEventSchema = XEventSchema.omit({ a: true }).extend({ ... });

Anything else is recorded as unparsed and reported as a warning, never as a failure — a drift check that cries wolf is a drift check that gets disabled, which is the outcome this crate exists to prevent.

Structs

Field

One field of an event payload, as declared upstream.

ParsedSchema 🔒

A Zod object schema reduced to an ordered list of (field, value expression).

Upstream

The whole upstream event surface.

UpstreamEvent

One event type and the payload the upstream schema declares for it.

Functions

bare_ident 🔒

The whole value when it is one identifier and nothing else, as in metadata: OptionalMetadataSchema.

brief 🔒

Shortens an expression for an error message.

build_event 🔒

collect_const_decls 🔒

Every const NAME = <expr>; in the file, mapped to its expression text.

event_type_literal 🔒

z.literal(EventType.RAW) -> RAW; z.literal("RAW") -> RAW.

extract

Reads events.ts and returns the event surface it declares.

field_optionality 🔒

Whether a field is required, and how that was decided when the Zod chain could not decide it.

is_required 🔒

A field is optional when its own chain carries .optional() or .default().

parse_event_type_enum 🔒

Parses export enum EventType { ... }.

parse_expr 🔒

Parses z.object({...}) or OtherSchema, followed by a chain of .extend() / .omit() / .pick() / no-op modifiers.

parse_object_literal 🔒

Parses { key: <expr>, "quoted": <expr> } into ordered pairs.

parse_primary 🔒

Splits the head of a schema expression from the method chain that follows.

resolve 🔒

Resolves a schema const to its field list, following extend/omit/pick chains through other consts.

to_fields 🔒

Turns (field, value expression) pairs into fields, dropping the ones every event inherits and deciding required-ness from the Zod chain.