state

type AgentState struct {
	// contains filtered or unexported fields
}

type FieldSchema struct {
	// Name 字段名称
	Name string `json:"name"`

	// Type 字段类型
	Type FieldType `json:"type"`

	// Required 是否必需
	Required bool `json:"required"`

	// Description 字段描述
	Description string `json:"description,omitempty"`

	// Default 默认值
	Default interface{} `json:"default,omitempty"`

	// ItemType 数组元素类型（仅当 Type == FieldTypeArray 时有效）
	ItemType FieldType `json:"item_type,omitempty"`

	// ObjectSchema 嵌套对象的 Schema（仅当 Type == FieldTypeObject 时有效）
	ObjectSchema *StateSchema `json:"object_schema,omitempty"`

	// Validator 自定义验证函数
	Validator func(value interface{}) error `json:"-"`
}

type FieldType string

type SchemaRegistry struct {
	// contains filtered or unexported fields
}

type State interface {
	// Get retrieves a value from state by key.
	// Returns the value and true if found, nil and false if not found.
	Get(key string) (interface{}, bool)

	// Set sets a value in state by key.
	Set(key string, value interface{})

	// Update performs a batch update of multiple state values.
	Update(updates map[string]interface{})

	// Snapshot returns a copy of all state values at this moment.
	// The returned map is a new copy and can be safely modified.
	Snapshot() map[string]interface{}

	// Clone creates a deep copy of the state.
	Clone() State

	// Delete removes a value from state by key.
	Delete(key string)

	// Clear removes all values from state.
	Clear()

	// Keys returns all keys currently in state.
	Keys() []string

	// Size returns the number of values in state.
	Size() int
}

type StateEnvelope struct {
	// SchemaName Schema 名称
	SchemaName string `json:"schema_name,omitempty"`

	// SchemaVersion Schema 版本
	SchemaVersion string `json:"schema_version,omitempty"`

	// Data 实际状态数据
	Data map[string]interface{} `json:"data"`

	// Checksum 数据校验和（可选）
	Checksum string `json:"checksum,omitempty"`
}

type StateSchema struct {
	// Name Schema 名称
	Name string `json:"name"`

	// Version Schema 版本（用于兼容性检查）
	Version string `json:"version"`

	// Description Schema 描述
	Description string `json:"description,omitempty"`

	// Fields 字段定义
	Fields map[string]*FieldSchema `json:"fields"`

	// StrictMode 严格模式：不允许未定义的字段
	StrictMode bool `json:"strict_mode"`
}

type TypedState struct {
	// contains filtered or unexported fields
}