GenAI.Dialogue.Schema (GenAI Core v0.3.3)

Product-agnostic field schema for multi-turn slot-filling dialogues.

Fields are declared once; the dialogue stepper asks for missing required (and optional-to-ask) slots until the draft is complete.

Summary

field()

t()

True when no required/ask_optional fields are blank.

Ordered list of field names still blank under required + ask_optional policy.

Build a schema from a list of field maps.

Next {field, question} or nil when complete.

@type field() :: %{
  :name => atom(),
  :question => String.t(),
  optional(:required) => boolean()
}

@type t() :: %GenAI.Dialogue.Schema{ask_optional: [atom()], fields: [field()]}

@spec complete?(t(), map()) :: boolean()

True when no required/ask_optional fields are blank.

@spec missing(t(), map()) :: [atom()]

Ordered list of field names still blank under required + ask_optional policy.

@spec new(
  [field()],
  keyword()
) :: t()

Build a schema from a list of field maps.

Each field: %{name: :title, question: "…", required: true | false}.

@spec next_question(t(), map()) :: {atom(), String.t()} | nil

Next {field, question} or nil when complete.