Jido.Chat.StreamChunk (Jido Chat v1.2.0)

Typed stream input chunk used by outbound stream payloads.

Summary

Types

input()

t()

Functions

fallback_text(value)

Returns the best text fallback for the chunk.

from_map(map)

Builds a stream chunk from serialized map data.

markdown_fallback(value)

Returns a deterministic Markdown fallback for a text or structured chunk.

new(chunk)

Creates a stream chunk from normalized map input.

normalize(chunk)

Normalizes supported stream chunk inputs.

normalize_many(chunks)

Normalizes a list of stream chunk inputs.

schema()

Returns the Zoi schema for StreamChunk.

text(value, opts \\ [])

Builds a text chunk.

to_map(chunk)

Serializes a stream chunk into a plain map with type marker.

Types

input()

@type input() :: t() | String.t() | map()

t()

@type t() :: %Jido.Chat.StreamChunk{
  kind:
    :text
    | :markdown
    | :status
    | :plan
    | :data
    | :step_start
    | :step_finish
    | :timeline,
  metadata: map(),
  payload: nil | nil | any(),
  text: nil | nil | binary()
}

Functions

fallback_text(value)

@spec fallback_text(t() | String.t()) :: String.t()

Returns the best text fallback for the chunk.

from_map(map)

@spec from_map(map()) :: t()

Builds a stream chunk from serialized map data.

markdown_fallback(value)

@spec markdown_fallback(term()) :: String.t()

Returns a deterministic Markdown fallback for a text or structured chunk.

new(chunk)

Creates a stream chunk from normalized map input.

normalize(chunk)

@spec normalize(input()) :: t() | String.t()

Normalizes supported stream chunk inputs.

normalize_many(chunks)

@spec normalize_many([input()]) :: [t() | String.t()]

Normalizes a list of stream chunk inputs.

schema()

Returns the Zoi schema for StreamChunk.

text(value, opts \\ [])

@spec text(String.t(), keyword() | map()) :: t()

Builds a text chunk.

to_map(chunk)

@spec to_map(t()) :: map()

Serializes a stream chunk into a plain map with type marker.