binding

type Attachment struct {
	Name          string `yaml:"name,omitempty" json:"name,omitempty"`
	URI           string `yaml:"uri,omitempty" json:"uri,omitempty"`
	StagingFolder string `yaml:"stagingFolder,omitempty" json:"stagingFolder,omitempty"`
	Mime          string `yaml:"mime,omitempty" json:"mime,omitempty"`
	Content       string `yaml:"content,omitempty" json:"content,omitempty"`
	Data          []byte `yaml:"data,omitempty" json:"data,omitempty"`
}

type Binding struct {
	Task            Task                   `yaml:"task" json:"task"`
	Model           string                 `yaml:"model,omitempty" json:"model,omitempty"`
	Persona         Persona                `yaml:"persona,omitempty" json:"persona,omitempty"`
	History         History                `yaml:"history,omitempty" json:"history,omitempty"`
	Tools           Tools                  `yaml:"tools,omitempty" json:"tools,omitempty"`
	Meta            Meta                   `yaml:"meta,omitempty" json:"meta,omitempty"`
	SystemDocuments Documents              `yaml:"systemDocuments,omitempty" json:"systemDocuments,omitempty"`
	Documents       Documents              `yaml:"documents,omitempty" json:"documents,omitempty"`
	Flags           Flags                  `yaml:"flags,omitempty" json:"flags,omitempty"`
	Context         map[string]interface{} `yaml:"context,omitempty" json:"context,omitempty"`
	// Elicitation contains a generic, prompt-friendly view of agent-required inputs
	// so templates can instruct the LLM to elicit missing data when necessary.
	Elicitation Elicitation `yaml:"elicitation,omitempty" json:"elicitation,omitempty"`
}

type Document struct {
	Title       string            `yaml:"title,omitempty" json:"title,omitempty"`
	PageContent string            `yaml:"pageContent,omitempty" json:"pageContent,omitempty"`
	SourceURI   string            `yaml:"sourceURI,omitempty" json:"sourceURI,omitempty"`
	Score       float64           `yaml:"score,omitempty" json:"score,omitempty"`
	MimeType    string            `yaml:"mimeType,omitempty" json:"mimeType,omitempty"`
	Metadata    map[string]string `yaml:"metadata,omitempty" json:"metadata,omitempty"`
}

type Documents struct {
	Items []*Document `yaml:"items,omitempty" json:"items,omitempty"`
}

type Elicitation struct {
	Required bool                   `yaml:"required,omitempty" json:"required,omitempty"`
	Missing  []string               `yaml:"missing,omitempty" json:"missing,omitempty"`
	Message  string                 `yaml:"message,omitempty" json:"message,omitempty"`
	Schema   map[string]interface{} `yaml:"schema,omitempty" json:"schema,omitempty"`
	// SchemaJSON is a pre-serialized JSON of Schema for templates without JSON helpers
	SchemaJSON string `yaml:"schemaJSON,omitempty" json:"schemaJSON,omitempty"`
}

type Flags struct {
	CanUseTool   bool `yaml:"canUseTool,omitempty" json:"canUseTool,omitempty"`
	CanStream    bool `yaml:"canStream,omitempty" json:"canStream,omitempty"`
	IsMultimodal bool `yaml:"isMultimodal,omitempty" json:"isMultimodal,omitempty"`
	IsSystem     bool `yaml:"isSystemPath,omitempty" json:"isSystemPath,omitempty"`
	// HasMessageOverflow indicates that a message content (tool result or otherwise)
	// exceeded the preview limit and the binding may expose message helpers.
	HasMessageOverflow bool `yaml:"hasMessageOverflow,omitempty" json:"hasMessageOverflow,omitempty"`
	// MaxOverflowBytes records the maximum original byte size of any
	// message that triggered overflow in this binding (history or tool
	// results). When zero, no size information was recorded.
	MaxOverflowBytes int `yaml:"maxOverflowBytes,omitempty" json:"maxOverflowBytes,omitempty"`
}

type History struct {
	// Past contains committed conversation turns in chronological order.
	Past []*Turn `yaml:"past,omitempty" json:"past,omitempty"`

	// Current holds the in-flight turn for the ongoing request
	// (React loop step). It is intentionally separated from Past
	// so we can distinguish persisted history from the current
	// LLM call context.
	Current *Turn `yaml:"current,omitempty" json:"current,omitempty"`

	// CurrentTurnID, when non-empty, carries the id of the in-flight
	// turn associated with the Current messages. It is typically
	// aligned with memory.TurnMeta.TurnID and is provided for
	// observability and explicitness; Past remains the committed
	// transcript.
	CurrentTurnID string `yaml:"currentTurnID,omitempty" json:"currentTurnID,omitempty"`

	// Messages is a legacy flat view of persisted history kept for
	// template compatibility and internal tooling. New code should
	// prefer Past/Current and helper methods.
	Messages []*Message `yaml:"messages,omitempty" json:"messages,omitempty"`

	LastResponse *Trace            `yaml:"lastResponse,omitempty" json:"lastResponse,omitempty"`
	Traces       map[string]*Trace `yaml:"traces,omitempty" json:"traces,omitempty"`
	ToolExposure string
}

type Kind string

type Message struct {
	Kind       MessageKind   `yaml:"kind,omitempty" json:"kind,omitempty"`
	Role       string        `yaml:"role,omitempty" json:"role,omitempty"`
	MimeType   string        `yaml:"mimeType,omitempty" json:"mimeType,omitempty"`
	Content    string        `yaml:"content,omitempty" json:"content,omitempty"`
	Attachment []*Attachment `yaml:"attachment,omitempty" json:"attachment,omitempty"`
	CreatedAt  time.Time     `yaml:"createdAt,omitempty" json:"createdAt,omitempty"`

	ID string `yaml:"id,omitempty" json:"id,omitempty"`

	// Optional tool metadata for tool result messages.
	ToolOpID    string                 `yaml:"toolOpId,omitempty" json:"toolOpId,omitempty"`
	ToolName    string                 `yaml:"toolName,omitempty" json:"toolName,omitempty"`
	ToolArgs    map[string]interface{} `yaml:"toolArgs,omitempty" json:"toolArgs,omitempty"`
	ToolTraceID string                 `yaml:"toolTraceId,omitempty" json:"toolTraceId,omitempty"`
}

type MessageKind string

type Meta struct {
	Model string `yaml:"model,omitempty" json:"model,omitempty"`
}

type Persona struct {
	Role    string `yaml:"role,omitempty"  json:"role,omitempty"`
	Actor   string `yaml:"actor,omitempty" json:"actor,omitempty"`
	Summary string `yaml:"summary,omitempty" json:"summary,omitempty"`
}

type Prompt struct {
	Text   string `yaml:"text,omitempty" json:"text,omitempty"`
	URI    string `yaml:"uri,omitempty" json:"uri,omitempty"`
	Engine string `yaml:"engine,omitempty" json:"engine,omitempty"`
	// contains filtered or unexported fields
}

type Task struct {
	Prompt      string        `yaml:"prompt,omitempty" json:"prompt,omitempty"`
	Attachments []*Attachment `yaml:"attachments,omitempty" json:"attachments,omitempty"`
}

type Tools struct {
	Signatures []*llm.ToolDefinition `yaml:"signatures,omitempty" json:"signatures,omitempty"`
}

type Trace struct {
	ID   string
	Kind Kind
	At   time.Time
}

type Turn struct {
	ID        string     `yaml:"id,omitempty" json:"id,omitempty"`
	StartedAt time.Time  `yaml:"startedAt,omitempty" json:"startedAt,omitempty"`
	Messages  []*Message `yaml:"messages,omitempty" json:"messages,omitempty"`
}