types.go

// Code generated by Fern. DO NOT EDIT.

package zep

import (
	json "encoding/json"
	fmt "fmt"
	internal "github.com/getzep/zep-go/v3/internal"
)

type APIError struct {
	Message *string `json:"message,omitempty" url:"message,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (a *APIError) GetMessage() *string {
	if a == nil {
		return nil
	}
	return a.Message
}

func (a *APIError) GetExtraProperties() map[string]interface{} {
	return a.extraProperties
}

func (a *APIError) UnmarshalJSON(data []byte) error {
	type unmarshaler APIError
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*a = APIError(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *a)
	if err != nil {
		return err
	}
	a.extraProperties = extraProperties
	a.rawJSON = json.RawMessage(data)
	return nil
}

func (a *APIError) String() string {
	if len(a.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(a.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(a); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", a)
}

type ComparisonOperator string

const (
	ComparisonOperatorEquals           ComparisonOperator = "="
	ComparisonOperatorNotEquals        ComparisonOperator = "<>"
	ComparisonOperatorGreaterThan      ComparisonOperator = ">"
	ComparisonOperatorLessThan         ComparisonOperator = "<"
	ComparisonOperatorGreaterThanEqual ComparisonOperator = ">="
	ComparisonOperatorLessThanEqual    ComparisonOperator = "<="
	ComparisonOperatorIsNull           ComparisonOperator = "IS NULL"
	ComparisonOperatorIsNullAlias      ComparisonOperator = "is_null"
	ComparisonOperatorIsNotNull        ComparisonOperator = "IS NOT NULL"
	ComparisonOperatorContains         ComparisonOperator = "CONTAINS"
)

func NewComparisonOperatorFromString(s string) (ComparisonOperator, error) {
	switch s {
	case "=":
		return ComparisonOperatorEquals, nil
	case "<>":
		return ComparisonOperatorNotEquals, nil
	case ">":
		return ComparisonOperatorGreaterThan, nil
	case "<":
		return ComparisonOperatorLessThan, nil
	case ">=":
		return ComparisonOperatorGreaterThanEqual, nil
	case "<=":
		return ComparisonOperatorLessThanEqual, nil
	case "IS NULL":
		return ComparisonOperatorIsNull, nil
	case "is_null":
		return ComparisonOperatorIsNullAlias, nil
	case "IS NOT NULL":
		return ComparisonOperatorIsNotNull, nil
	case "CONTAINS":
		return ComparisonOperatorContains, nil
	}
	var t ComparisonOperator
	return "", fmt.Errorf("%s is not a valid %T", s, t)
}

func (c ComparisonOperator) Ptr() *ComparisonOperator {
	return &c
}

type DateFilter struct {
	// Comparison operator for date filter
	ComparisonOperator ComparisonOperator `json:"comparison_operator" url:"comparison_operator"`
	// Date to filter on. Required for non-null operators (`=`, `<>`, `>`, `<`, `>=`, `<=`).
	// Should be omitted for IS NULL (or is_null) and IS NOT NULL operators.
	Date *string `json:"date,omitempty" url:"date,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (d *DateFilter) GetComparisonOperator() ComparisonOperator {
	if d == nil {
		return ""
	}
	return d.ComparisonOperator
}

func (d *DateFilter) GetDate() *string {
	if d == nil {
		return nil
	}
	return d.Date
}

func (d *DateFilter) GetExtraProperties() map[string]interface{} {
	return d.extraProperties
}

func (d *DateFilter) UnmarshalJSON(data []byte) error {
	type unmarshaler DateFilter
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*d = DateFilter(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *d)
	if err != nil {
		return err
	}
	d.extraProperties = extraProperties
	d.rawJSON = json.RawMessage(data)
	return nil
}

func (d *DateFilter) String() string {
	if len(d.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(d.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(d); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", d)
}

type DerivedNode struct {
	// Additional attributes of the derived node.
	Attributes map[string]interface{} `json:"attributes,omitempty" url:"attributes,omitempty"`
	// Creation time of the node
	CreatedAt string `json:"created_at" url:"created_at"`
	// EndAt is the close timestamp of the evidence window. Set when the
	// underlying pattern is no longer supported (closed observations);
	// nil for active observations.
	EndAt *string `json:"end_at,omitempty" url:"end_at,omitempty"`
	// Episode UUIDs that support this observation. Only populated for observation nodes in web API responses.
	EpisodeIDs []string `json:"episode_ids,omitempty" url:"episode_ids,omitempty"`
	// Labels associated with the node
	Labels []string `json:"labels,omitempty" url:"labels,omitempty"`
	// LatestEvidenceAt is the most recent source-episode timestamp from
	// which this observation drew evidence.
	LatestEvidenceAt *string `json:"latest_evidence_at,omitempty" url:"latest_evidence_at,omitempty"`
	// Name of the node
	Name string `json:"name" url:"name"`
	// Relevance is an experimental rank-aligned score in [0,1] derived from Score via logit transformation.
	// Only populated when using cross_encoder reranker; omitted for other reranker types (e.g., RRF).
	Relevance *float64 `json:"relevance,omitempty" url:"relevance,omitempty"`
	// Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
	Score *float64 `json:"score,omitempty" url:"score,omitempty"`
	// SelectionRank is the global cross-scope rank assigned by auto scope selection.
	SelectionRank *int `json:"selection_rank,omitempty" url:"selection_rank,omitempty"`
	// StartAt is the earliest source-episode timestamp from which this
	// observation was derived. Only populated for observation nodes.
	StartAt *string `json:"start_at,omitempty" url:"start_at,omitempty"`
	// Region summary of member nodes
	Summary *string `json:"summary,omitempty" url:"summary,omitempty"`
	// UUID of the node
	UUID string `json:"uuid" url:"uuid"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (d *DerivedNode) GetAttributes() map[string]interface{} {
	if d == nil {
		return nil
	}
	return d.Attributes
}

func (d *DerivedNode) GetCreatedAt() string {
	if d == nil {
		return ""
	}
	return d.CreatedAt
}

func (d *DerivedNode) GetEndAt() *string {
	if d == nil {
		return nil
	}
	return d.EndAt
}

func (d *DerivedNode) GetEpisodeIDs() []string {
	if d == nil {
		return nil
	}
	return d.EpisodeIDs
}

func (d *DerivedNode) GetLabels() []string {
	if d == nil {
		return nil
	}
	return d.Labels
}

func (d *DerivedNode) GetLatestEvidenceAt() *string {
	if d == nil {
		return nil
	}
	return d.LatestEvidenceAt
}

func (d *DerivedNode) GetName() string {
	if d == nil {
		return ""
	}
	return d.Name
}

func (d *DerivedNode) GetRelevance() *float64 {
	if d == nil {
		return nil
	}
	return d.Relevance
}

func (d *DerivedNode) GetScore() *float64 {
	if d == nil {
		return nil
	}
	return d.Score
}

func (d *DerivedNode) GetSelectionRank() *int {
	if d == nil {
		return nil
	}
	return d.SelectionRank
}

func (d *DerivedNode) GetStartAt() *string {
	if d == nil {
		return nil
	}
	return d.StartAt
}

func (d *DerivedNode) GetSummary() *string {
	if d == nil {
		return nil
	}
	return d.Summary
}

func (d *DerivedNode) GetUUID() string {
	if d == nil {
		return ""
	}
	return d.UUID
}

func (d *DerivedNode) GetExtraProperties() map[string]interface{} {
	return d.extraProperties
}

func (d *DerivedNode) UnmarshalJSON(data []byte) error {
	type unmarshaler DerivedNode
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*d = DerivedNode(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *d)
	if err != nil {
		return err
	}
	d.extraProperties = extraProperties
	d.rawJSON = json.RawMessage(data)
	return nil
}

func (d *DerivedNode) String() string {
	if len(d.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(d.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(d); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", d)
}

type EntityEdge struct {
	// Additional attributes of the edge. Dependent on edge types
	Attributes map[string]interface{} `json:"attributes,omitempty" url:"attributes,omitempty"`
	// Creation time of the edge
	CreatedAt string `json:"created_at" url:"created_at"`
	// List of episode ids that reference these entity edges
	Episodes []string `json:"episodes,omitempty" url:"episodes,omitempty"`
	// Datetime of when the node was invalidated
	ExpiredAt *string `json:"expired_at,omitempty" url:"expired_at,omitempty"`
	// Fact representing the edge and nodes that it connects
	Fact string `json:"fact" url:"fact"`
	// Datetime of when the fact stopped being true
	InvalidAt *string `json:"invalid_at,omitempty" url:"invalid_at,omitempty"`
	// Name of the edge, relation name
	Name string `json:"name" url:"name"`
	// Relevance is an experimental rank-aligned score in [0,1] derived from Score via logit transformation.
	// Only populated when using cross_encoder reranker; omitted for other reranker types (e.g., RRF).
	Relevance *float64 `json:"relevance,omitempty" url:"relevance,omitempty"`
	// Scope of the edge (e.g. "entity", "maybe_related")
	Scope *string `json:"scope,omitempty" url:"scope,omitempty"`
	// Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
	Score *float64 `json:"score,omitempty" url:"score,omitempty"`
	// SelectionRank is the global cross-scope rank assigned by auto scope selection.
	SelectionRank *int `json:"selection_rank,omitempty" url:"selection_rank,omitempty"`
	// SourceNodeLabels are the labels of the source node at read time. Same
	// read-time-projection semantics as SourceNodeName (spec-2 §4).
	SourceNodeLabels []string `json:"source_node_labels,omitempty" url:"source_node_labels,omitempty"`
	// SourceNodeName is the name of the source node at read time. It is a
	// read-time projection of current node state, not a stored edge
	// attribute: a subsequent node rename is reflected on the next read.
	// Omitted (the edge is still returned) if the source node cannot be
	// resolved, for example if it was deleted concurrently (spec-2 §4).
	SourceNodeName *string `json:"source_node_name,omitempty" url:"source_node_name,omitempty"`
	// UUID of the source node
	SourceNodeUUID string `json:"source_node_uuid" url:"source_node_uuid"`
	// TargetNodeLabels are the labels of the target node at read time. Same
	// read-time-projection semantics as SourceNodeName (spec-2 §4).
	TargetNodeLabels []string `json:"target_node_labels,omitempty" url:"target_node_labels,omitempty"`
	// TargetNodeName is the name of the target node at read time. Same
	// read-time-projection semantics as SourceNodeName (spec-2 §4).
	TargetNodeName *string `json:"target_node_name,omitempty" url:"target_node_name,omitempty"`
	// UUID of the target node
	TargetNodeUUID string `json:"target_node_uuid" url:"target_node_uuid"`
	// UUID of the edge
	UUID string `json:"uuid" url:"uuid"`
	// Datetime of when the fact became true
	ValidAt *string `json:"valid_at,omitempty" url:"valid_at,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (e *EntityEdge) GetAttributes() map[string]interface{} {
	if e == nil {
		return nil
	}
	return e.Attributes
}

func (e *EntityEdge) GetCreatedAt() string {
	if e == nil {
		return ""
	}
	return e.CreatedAt
}

func (e *EntityEdge) GetEpisodes() []string {
	if e == nil {
		return nil
	}
	return e.Episodes
}

func (e *EntityEdge) GetExpiredAt() *string {
	if e == nil {
		return nil
	}
	return e.ExpiredAt
}

func (e *EntityEdge) GetFact() string {
	if e == nil {
		return ""
	}
	return e.Fact
}

func (e *EntityEdge) GetInvalidAt() *string {
	if e == nil {
		return nil
	}
	return e.InvalidAt
}

func (e *EntityEdge) GetName() string {
	if e == nil {
		return ""
	}
	return e.Name
}

func (e *EntityEdge) GetRelevance() *float64 {
	if e == nil {
		return nil
	}
	return e.Relevance
}

func (e *EntityEdge) GetScope() *string {
	if e == nil {
		return nil
	}
	return e.Scope
}

func (e *EntityEdge) GetScore() *float64 {
	if e == nil {
		return nil
	}
	return e.Score
}

func (e *EntityEdge) GetSelectionRank() *int {
	if e == nil {
		return nil
	}
	return e.SelectionRank
}

func (e *EntityEdge) GetSourceNodeLabels() []string {
	if e == nil {
		return nil
	}
	return e.SourceNodeLabels
}

func (e *EntityEdge) GetSourceNodeName() *string {
	if e == nil {
		return nil
	}
	return e.SourceNodeName
}

func (e *EntityEdge) GetSourceNodeUUID() string {
	if e == nil {
		return ""
	}
	return e.SourceNodeUUID
}

func (e *EntityEdge) GetTargetNodeLabels() []string {
	if e == nil {
		return nil
	}
	return e.TargetNodeLabels
}

func (e *EntityEdge) GetTargetNodeName() *string {
	if e == nil {
		return nil
	}
	return e.TargetNodeName
}

func (e *EntityEdge) GetTargetNodeUUID() string {
	if e == nil {
		return ""
	}
	return e.TargetNodeUUID
}

func (e *EntityEdge) GetUUID() string {
	if e == nil {
		return ""
	}
	return e.UUID
}

func (e *EntityEdge) GetValidAt() *string {
	if e == nil {
		return nil
	}
	return e.ValidAt
}

func (e *EntityEdge) GetExtraProperties() map[string]interface{} {
	return e.extraProperties
}

func (e *EntityEdge) UnmarshalJSON(data []byte) error {
	type unmarshaler EntityEdge
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*e = EntityEdge(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *e)
	if err != nil {
		return err
	}
	e.extraProperties = extraProperties
	e.rawJSON = json.RawMessage(data)
	return nil
}

func (e *EntityEdge) String() string {
	if len(e.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(e.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(e); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", e)
}

type EntityNode struct {
	// Additional attributes of the node. Dependent on node labels
	Attributes map[string]interface{} `json:"attributes,omitempty" url:"attributes,omitempty"`
	// Creation time of the node
	CreatedAt string `json:"created_at" url:"created_at"`
	// Labels associated with the node
	Labels []string `json:"labels,omitempty" url:"labels,omitempty"`
	// Name of the node
	Name string `json:"name" url:"name"`
	// Relevance is an experimental rank-aligned score in [0,1] derived from Score via logit transformation.
	// Only populated when using cross_encoder reranker; omitted for other reranker types (e.g., RRF).
	Relevance *float64 `json:"relevance,omitempty" url:"relevance,omitempty"`
	// Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
	Score *float64 `json:"score,omitempty" url:"score,omitempty"`
	// SelectionRank is the global cross-scope rank assigned by auto scope selection.
	SelectionRank *int `json:"selection_rank,omitempty" url:"selection_rank,omitempty"`
	// Regional summary of surrounding edges
	Summary string `json:"summary" url:"summary"`
	// UUID of the node
	UUID string `json:"uuid" url:"uuid"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (e *EntityNode) GetAttributes() map[string]interface{} {
	if e == nil {
		return nil
	}
	return e.Attributes
}

func (e *EntityNode) GetCreatedAt() string {
	if e == nil {
		return ""
	}
	return e.CreatedAt
}

func (e *EntityNode) GetLabels() []string {
	if e == nil {
		return nil
	}
	return e.Labels
}

func (e *EntityNode) GetName() string {
	if e == nil {
		return ""
	}
	return e.Name
}

func (e *EntityNode) GetRelevance() *float64 {
	if e == nil {
		return nil
	}
	return e.Relevance
}

func (e *EntityNode) GetScore() *float64 {
	if e == nil {
		return nil
	}
	return e.Score
}

func (e *EntityNode) GetSelectionRank() *int {
	if e == nil {
		return nil
	}
	return e.SelectionRank
}

func (e *EntityNode) GetSummary() string {
	if e == nil {
		return ""
	}
	return e.Summary
}

func (e *EntityNode) GetUUID() string {
	if e == nil {
		return ""
	}
	return e.UUID
}

func (e *EntityNode) GetExtraProperties() map[string]interface{} {
	return e.extraProperties
}

func (e *EntityNode) UnmarshalJSON(data []byte) error {
	type unmarshaler EntityNode
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*e = EntityNode(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *e)
	if err != nil {
		return err
	}
	e.extraProperties = extraProperties
	e.rawJSON = json.RawMessage(data)
	return nil
}

func (e *EntityNode) String() string {
	if len(e.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(e.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(e); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", e)
}

type Episode struct {
	Content   string                 `json:"content" url:"content"`
	CreatedAt string                 `json:"created_at" url:"created_at"`
	Metadata  map[string]interface{} `json:"metadata,omitempty" url:"metadata,omitempty"`
	Processed *bool                  `json:"processed,omitempty" url:"processed,omitempty"`
	// Relevance is an experimental rank-aligned score in [0,1] derived from Score via logit transformation.
	// Only populated when using cross_encoder reranker; omitted for other reranker types (e.g., RRF).
	Relevance *float64 `json:"relevance,omitempty" url:"relevance,omitempty"`
	// Optional role, will only be present if the episode was created using memory.add API
	Role *string `json:"role,omitempty" url:"role,omitempty"`
	// Optional role_type, will only be present if the episode was created using memory.add API
	RoleType *RoleType `json:"role_type,omitempty" url:"role_type,omitempty"`
	// Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
	Score *float64 `json:"score,omitempty" url:"score,omitempty"`
	// SelectionRank is the global cross-scope rank assigned by auto scope selection.
	SelectionRank     *int           `json:"selection_rank,omitempty" url:"selection_rank,omitempty"`
	Source            *GraphDataType `json:"source,omitempty" url:"source,omitempty"`
	SourceDescription *string        `json:"source_description,omitempty" url:"source_description,omitempty"`
	// Optional task ID to poll episode processing status. Currently only available for batch ingestion.
	TaskID *string `json:"task_id,omitempty" url:"task_id,omitempty"`
	// Optional thread ID, will be present if the episode is part of a thread
	ThreadID *string `json:"thread_id,omitempty" url:"thread_id,omitempty"`
	UUID     string  `json:"uuid" url:"uuid"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (e *Episode) GetContent() string {
	if e == nil {
		return ""
	}
	return e.Content
}

func (e *Episode) GetCreatedAt() string {
	if e == nil {
		return ""
	}
	return e.CreatedAt
}

func (e *Episode) GetMetadata() map[string]interface{} {
	if e == nil {
		return nil
	}
	return e.Metadata
}

func (e *Episode) GetProcessed() *bool {
	if e == nil {
		return nil
	}
	return e.Processed
}

func (e *Episode) GetRelevance() *float64 {
	if e == nil {
		return nil
	}
	return e.Relevance
}

func (e *Episode) GetRole() *string {
	if e == nil {
		return nil
	}
	return e.Role
}

func (e *Episode) GetRoleType() *RoleType {
	if e == nil {
		return nil
	}
	return e.RoleType
}

func (e *Episode) GetScore() *float64 {
	if e == nil {
		return nil
	}
	return e.Score
}

func (e *Episode) GetSelectionRank() *int {
	if e == nil {
		return nil
	}
	return e.SelectionRank
}

func (e *Episode) GetSource() *GraphDataType {
	if e == nil {
		return nil
	}
	return e.Source
}

func (e *Episode) GetSourceDescription() *string {
	if e == nil {
		return nil
	}
	return e.SourceDescription
}

func (e *Episode) GetTaskID() *string {
	if e == nil {
		return nil
	}
	return e.TaskID
}

func (e *Episode) GetThreadID() *string {
	if e == nil {
		return nil
	}
	return e.ThreadID
}

func (e *Episode) GetUUID() string {
	if e == nil {
		return ""
	}
	return e.UUID
}

func (e *Episode) GetExtraProperties() map[string]interface{} {
	return e.extraProperties
}

func (e *Episode) UnmarshalJSON(data []byte) error {
	type unmarshaler Episode
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*e = Episode(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *e)
	if err != nil {
		return err
	}
	e.extraProperties = extraProperties
	e.rawJSON = json.RawMessage(data)
	return nil
}

func (e *Episode) String() string {
	if len(e.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(e.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(e); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", e)
}

type EpisodeMentions struct {
	Edges []*EntityEdge `json:"edges,omitempty" url:"edges,omitempty"`
	Nodes []*EntityNode `json:"nodes,omitempty" url:"nodes,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (e *EpisodeMentions) GetEdges() []*EntityEdge {
	if e == nil {
		return nil
	}
	return e.Edges
}

func (e *EpisodeMentions) GetNodes() []*EntityNode {
	if e == nil {
		return nil
	}
	return e.Nodes
}

func (e *EpisodeMentions) GetExtraProperties() map[string]interface{} {
	return e.extraProperties
}

func (e *EpisodeMentions) UnmarshalJSON(data []byte) error {
	type unmarshaler EpisodeMentions
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*e = EpisodeMentions(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *e)
	if err != nil {
		return err
	}
	e.extraProperties = extraProperties
	e.rawJSON = json.RawMessage(data)
	return nil
}

func (e *EpisodeMentions) String() string {
	if len(e.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(e.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(e); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", e)
}

type EpisodeMetadataFilter struct {
	// Comparison operator: =, <>, >, <, >=, <=, IS NULL, IS NOT NULL, IN, CONTAINS
	ComparisonOperator ComparisonOperator `json:"comparison_operator" url:"comparison_operator"`
	// Metadata key to filter on
	PropertyName string `json:"property_name" url:"property_name"`
	// Value to compare against. Not required for IS NULL / IS NOT NULL operators.
	PropertyValue interface{} `json:"property_value,omitempty" url:"property_value,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (e *EpisodeMetadataFilter) GetComparisonOperator() ComparisonOperator {
	if e == nil {
		return ""
	}
	return e.ComparisonOperator
}

func (e *EpisodeMetadataFilter) GetPropertyName() string {
	if e == nil {
		return ""
	}
	return e.PropertyName
}

func (e *EpisodeMetadataFilter) GetPropertyValue() interface{} {
	if e == nil {
		return nil
	}
	return e.PropertyValue
}

func (e *EpisodeMetadataFilter) GetExtraProperties() map[string]interface{} {
	return e.extraProperties
}

func (e *EpisodeMetadataFilter) UnmarshalJSON(data []byte) error {
	type unmarshaler EpisodeMetadataFilter
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*e = EpisodeMetadataFilter(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *e)
	if err != nil {
		return err
	}
	e.extraProperties = extraProperties
	e.rawJSON = json.RawMessage(data)
	return nil
}

func (e *EpisodeMetadataFilter) String() string {
	if len(e.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(e.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(e); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", e)
}

type EpisodeResponse struct {
	Episodes []*Episode `json:"episodes,omitempty" url:"episodes,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (e *EpisodeResponse) GetEpisodes() []*Episode {
	if e == nil {
		return nil
	}
	return e.Episodes
}

func (e *EpisodeResponse) GetExtraProperties() map[string]interface{} {
	return e.extraProperties
}

func (e *EpisodeResponse) UnmarshalJSON(data []byte) error {
	type unmarshaler EpisodeResponse
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*e = EpisodeResponse(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *e)
	if err != nil {
		return err
	}
	e.extraProperties = extraProperties
	e.rawJSON = json.RawMessage(data)
	return nil
}

func (e *EpisodeResponse) String() string {
	if len(e.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(e.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(e); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", e)
}

type GraphDataType string

const (
	GraphDataTypeText       GraphDataType = "text"
	GraphDataTypeJSON       GraphDataType = "json"
	GraphDataTypeMessage    GraphDataType = "message"
	GraphDataTypeFactTriple GraphDataType = "fact_triple"
)

func NewGraphDataTypeFromString(s string) (GraphDataType, error) {
	switch s {
	case "text":
		return GraphDataTypeText, nil
	case "json":
		return GraphDataTypeJSON, nil
	case "message":
		return GraphDataTypeMessage, nil
	case "fact_triple":
		return GraphDataTypeFactTriple, nil
	}
	var t GraphDataType
	return "", fmt.Errorf("%s is not a valid %T", s, t)
}

func (g GraphDataType) Ptr() *GraphDataType {
	return &g
}

type GraphEdgesRequest struct {
	// Opaque cursor for pagination, obtained from the Zep-Next-Cursor response header
	// of the previous page. Encodes the sort field, direction, and continuation position.
	Cursor *string `json:"cursor,omitempty" url:"cursor,omitempty"`
	// Sort direction. One of "asc" or "desc" (default "desc").
	Direction *string `json:"direction,omitempty" url:"direction,omitempty"`
	// Optional filters applied to the listed artifacts. Reuses the graph.search filter type.
	Filters *SearchFilters `json:"filters,omitempty" url:"filters,omitempty"`
	// Maximum number of items to return
	Limit *int `json:"limit,omitempty" url:"limit,omitempty"`
	// Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
	OrderBy *string `json:"order_by,omitempty" url:"order_by,omitempty"`
	// UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
	//
	// Deprecated: prefer Cursor, the opaque cursor returned via the Zep-Next-Cursor response header.
	UUIDCursor *string `json:"uuid_cursor,omitempty" url:"uuid_cursor,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (g *GraphEdgesRequest) GetCursor() *string {
	if g == nil {
		return nil
	}
	return g.Cursor
}

func (g *GraphEdgesRequest) GetDirection() *string {
	if g == nil {
		return nil
	}
	return g.Direction
}

func (g *GraphEdgesRequest) GetFilters() *SearchFilters {
	if g == nil {
		return nil
	}
	return g.Filters
}

func (g *GraphEdgesRequest) GetLimit() *int {
	if g == nil {
		return nil
	}
	return g.Limit
}

func (g *GraphEdgesRequest) GetOrderBy() *string {
	if g == nil {
		return nil
	}
	return g.OrderBy
}

func (g *GraphEdgesRequest) GetUUIDCursor() *string {
	if g == nil {
		return nil
	}
	return g.UUIDCursor
}

func (g *GraphEdgesRequest) GetExtraProperties() map[string]interface{} {
	return g.extraProperties
}

func (g *GraphEdgesRequest) UnmarshalJSON(data []byte) error {
	type unmarshaler GraphEdgesRequest
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*g = GraphEdgesRequest(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *g)
	if err != nil {
		return err
	}
	g.extraProperties = extraProperties
	g.rawJSON = json.RawMessage(data)
	return nil
}

func (g *GraphEdgesRequest) String() string {
	if len(g.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(g.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(g); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", g)
}

type GraphEpisodeListRequest struct {
	// Opaque cursor for pagination, obtained from the Zep-Next-Cursor
	// response header of the previous page.
	Cursor *string `json:"cursor,omitempty" url:"cursor,omitempty"`
	// Sort direction. One of "asc" or "desc". Defaults to "desc".
	Direction *string `json:"direction,omitempty" url:"direction,omitempty"`
	// Maximum number of episodes to return. An explicit value is clamped to
	// 50; when omitted, the default page size (100) applies.
	Limit *int `json:"limit,omitempty" url:"limit,omitempty"`
	// Restricts results to episodes that mention any of the listed node
	// UUIDs. At most 256 entries; each must be a syntactically valid UUID.
	MentionedNodeUUIDs []string `json:"mentioned_node_uuids,omitempty" url:"mentioned_node_uuids,omitempty"`
	// Field to sort by. One of "uuid" or "created_at". Defaults to "uuid".
	OrderBy *string `json:"order_by,omitempty" url:"order_by,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (g *GraphEpisodeListRequest) GetCursor() *string {
	if g == nil {
		return nil
	}
	return g.Cursor
}

func (g *GraphEpisodeListRequest) GetDirection() *string {
	if g == nil {
		return nil
	}
	return g.Direction
}

func (g *GraphEpisodeListRequest) GetLimit() *int {
	if g == nil {
		return nil
	}
	return g.Limit
}

func (g *GraphEpisodeListRequest) GetMentionedNodeUUIDs() []string {
	if g == nil {
		return nil
	}
	return g.MentionedNodeUUIDs
}

func (g *GraphEpisodeListRequest) GetOrderBy() *string {
	if g == nil {
		return nil
	}
	return g.OrderBy
}

func (g *GraphEpisodeListRequest) GetExtraProperties() map[string]interface{} {
	return g.extraProperties
}

func (g *GraphEpisodeListRequest) UnmarshalJSON(data []byte) error {
	type unmarshaler GraphEpisodeListRequest
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*g = GraphEpisodeListRequest(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *g)
	if err != nil {
		return err
	}
	g.extraProperties = extraProperties
	g.rawJSON = json.RawMessage(data)
	return nil
}

func (g *GraphEpisodeListRequest) String() string {
	if len(g.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(g.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(g); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", g)
}

type GraphNodeNeighbor struct {
	Edges []*EntityEdge `json:"edges,omitempty" url:"edges,omitempty"`
	Node  *EntityNode   `json:"node,omitempty" url:"node,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (g *GraphNodeNeighbor) GetEdges() []*EntityEdge {
	if g == nil {
		return nil
	}
	return g.Edges
}

func (g *GraphNodeNeighbor) GetNode() *EntityNode {
	if g == nil {
		return nil
	}
	return g.Node
}

func (g *GraphNodeNeighbor) GetExtraProperties() map[string]interface{} {
	return g.extraProperties
}

func (g *GraphNodeNeighbor) UnmarshalJSON(data []byte) error {
	type unmarshaler GraphNodeNeighbor
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*g = GraphNodeNeighbor(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *g)
	if err != nil {
		return err
	}
	g.extraProperties = extraProperties
	g.rawJSON = json.RawMessage(data)
	return nil
}

func (g *GraphNodeNeighbor) String() string {
	if len(g.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(g.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(g); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", g)
}

type GraphNodesRequest struct {
	// Opaque cursor for pagination, obtained from the Zep-Next-Cursor response header
	// of the previous page. Encodes the sort field, direction, and continuation position.
	Cursor *string `json:"cursor,omitempty" url:"cursor,omitempty"`
	// Sort direction. One of "asc" or "desc" (default "desc").
	Direction *string `json:"direction,omitempty" url:"direction,omitempty"`
	// Optional filters applied to the listed artifacts. Reuses the graph.search filter type.
	Filters *SearchFilters `json:"filters,omitempty" url:"filters,omitempty"`
	// Maximum number of items to return
	Limit *int `json:"limit,omitempty" url:"limit,omitempty"`
	// Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
	OrderBy *string `json:"order_by,omitempty" url:"order_by,omitempty"`
	// UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
	//
	// Deprecated: prefer Cursor, the opaque cursor returned via the Zep-Next-Cursor response header.
	UUIDCursor *string `json:"uuid_cursor,omitempty" url:"uuid_cursor,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (g *GraphNodesRequest) GetCursor() *string {
	if g == nil {
		return nil
	}
	return g.Cursor
}

func (g *GraphNodesRequest) GetDirection() *string {
	if g == nil {
		return nil
	}
	return g.Direction
}

func (g *GraphNodesRequest) GetFilters() *SearchFilters {
	if g == nil {
		return nil
	}
	return g.Filters
}

func (g *GraphNodesRequest) GetLimit() *int {
	if g == nil {
		return nil
	}
	return g.Limit
}

func (g *GraphNodesRequest) GetOrderBy() *string {
	if g == nil {
		return nil
	}
	return g.OrderBy
}

func (g *GraphNodesRequest) GetUUIDCursor() *string {
	if g == nil {
		return nil
	}
	return g.UUIDCursor
}

func (g *GraphNodesRequest) GetExtraProperties() map[string]interface{} {
	return g.extraProperties
}

func (g *GraphNodesRequest) UnmarshalJSON(data []byte) error {
	type unmarshaler GraphNodesRequest
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*g = GraphNodesRequest(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *g)
	if err != nil {
		return err
	}
	g.extraProperties = extraProperties
	g.rawJSON = json.RawMessage(data)
	return nil
}

func (g *GraphNodesRequest) String() string {
	if len(g.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(g.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(g); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", g)
}

type GraphObservationsRequest struct {
	// Opaque cursor for pagination, obtained from the Zep-Next-Cursor response header
	// of the previous page. Encodes the sort field, direction, and continuation position.
	Cursor *string `json:"cursor,omitempty" url:"cursor,omitempty"`
	// Sort direction. One of "asc" or "desc" (default "desc").
	Direction *string `json:"direction,omitempty" url:"direction,omitempty"`
	// Optional filters applied to the listed artifacts. Reuses the graph.search filter type.
	Filters *SearchFilters `json:"filters,omitempty" url:"filters,omitempty"`
	// Maximum number of items to return
	Limit *int `json:"limit,omitempty" url:"limit,omitempty"`
	// Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
	OrderBy *string `json:"order_by,omitempty" url:"order_by,omitempty"`
	// UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
	//
	// Deprecated: prefer Cursor, the opaque cursor returned via the Zep-Next-Cursor response header.
	UUIDCursor *string `json:"uuid_cursor,omitempty" url:"uuid_cursor,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (g *GraphObservationsRequest) GetCursor() *string {
	if g == nil {
		return nil
	}
	return g.Cursor
}

func (g *GraphObservationsRequest) GetDirection() *string {
	if g == nil {
		return nil
	}
	return g.Direction
}

func (g *GraphObservationsRequest) GetFilters() *SearchFilters {
	if g == nil {
		return nil
	}
	return g.Filters
}

func (g *GraphObservationsRequest) GetLimit() *int {
	if g == nil {
		return nil
	}
	return g.Limit
}

func (g *GraphObservationsRequest) GetOrderBy() *string {
	if g == nil {
		return nil
	}
	return g.OrderBy
}

func (g *GraphObservationsRequest) GetUUIDCursor() *string {
	if g == nil {
		return nil
	}
	return g.UUIDCursor
}

func (g *GraphObservationsRequest) GetExtraProperties() map[string]interface{} {
	return g.extraProperties
}

func (g *GraphObservationsRequest) UnmarshalJSON(data []byte) error {
	type unmarshaler GraphObservationsRequest
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*g = GraphObservationsRequest(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *g)
	if err != nil {
		return err
	}
	g.extraProperties = extraProperties
	g.rawJSON = json.RawMessage(data)
	return nil
}

func (g *GraphObservationsRequest) String() string {
	if len(g.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(g.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(g); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", g)
}

type GraphThreadSummariesRequest struct {
	// Opaque cursor for pagination, obtained from the Zep-Next-Cursor response header
	// of the previous page. Encodes the sort field, direction, and continuation position.
	Cursor *string `json:"cursor,omitempty" url:"cursor,omitempty"`
	// Sort direction. One of "asc" or "desc" (default "desc").
	Direction *string `json:"direction,omitempty" url:"direction,omitempty"`
	// Optional filters applied to the listed artifacts. Reuses the graph.search filter type.
	Filters *SearchFilters `json:"filters,omitempty" url:"filters,omitempty"`
	// Maximum number of items to return
	Limit *int `json:"limit,omitempty" url:"limit,omitempty"`
	// Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
	OrderBy *string `json:"order_by,omitempty" url:"order_by,omitempty"`
	// UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
	//
	// Deprecated: prefer Cursor, the opaque cursor returned via the Zep-Next-Cursor response header.
	UUIDCursor *string `json:"uuid_cursor,omitempty" url:"uuid_cursor,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (g *GraphThreadSummariesRequest) GetCursor() *string {
	if g == nil {
		return nil
	}
	return g.Cursor
}

func (g *GraphThreadSummariesRequest) GetDirection() *string {
	if g == nil {
		return nil
	}
	return g.Direction
}

func (g *GraphThreadSummariesRequest) GetFilters() *SearchFilters {
	if g == nil {
		return nil
	}
	return g.Filters
}

func (g *GraphThreadSummariesRequest) GetLimit() *int {
	if g == nil {
		return nil
	}
	return g.Limit
}

func (g *GraphThreadSummariesRequest) GetOrderBy() *string {
	if g == nil {
		return nil
	}
	return g.OrderBy
}

func (g *GraphThreadSummariesRequest) GetUUIDCursor() *string {
	if g == nil {
		return nil
	}
	return g.UUIDCursor
}

func (g *GraphThreadSummariesRequest) GetExtraProperties() map[string]interface{} {
	return g.extraProperties
}

func (g *GraphThreadSummariesRequest) UnmarshalJSON(data []byte) error {
	type unmarshaler GraphThreadSummariesRequest
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*g = GraphThreadSummariesRequest(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *g)
	if err != nil {
		return err
	}
	g.extraProperties = extraProperties
	g.rawJSON = json.RawMessage(data)
	return nil
}

func (g *GraphThreadSummariesRequest) String() string {
	if len(g.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(g.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(g); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", g)
}

// Logical operator: "and" or "or"
type GraphitiMetadataFilterGroupType string

const (
	GraphitiMetadataFilterGroupTypeAnd GraphitiMetadataFilterGroupType = "and"
	GraphitiMetadataFilterGroupTypeOr  GraphitiMetadataFilterGroupType = "or"
)

func NewGraphitiMetadataFilterGroupTypeFromString(s string) (GraphitiMetadataFilterGroupType, error) {
	switch s {
	case "and":
		return GraphitiMetadataFilterGroupTypeAnd, nil
	case "or":
		return GraphitiMetadataFilterGroupTypeOr, nil
	}
	var t GraphitiMetadataFilterGroupType
	return "", fmt.Errorf("%s is not a valid %T", s, t)
}

func (g GraphitiMetadataFilterGroupType) Ptr() *GraphitiMetadataFilterGroupType {
	return &g
}

type Message struct {
	// The content of the message.
	Content string `json:"content" url:"content"`
	// The timestamp of when the message was created.
	CreatedAt *string `json:"created_at,omitempty" url:"created_at,omitempty"`
	// The metadata associated with the message.
	Metadata map[string]interface{} `json:"metadata,omitempty" url:"metadata,omitempty"`
	// Customizable name of the sender of the message (e.g., "john", "sales_agent").
	Name *string `json:"name,omitempty" url:"name,omitempty"`
	// Whether the message has been processed.
	Processed *bool `json:"processed,omitempty" url:"processed,omitempty"`
	// The role of message sender (e.g., "user", "system").
	Role RoleType `json:"role" url:"role"`
	// The unique identifier of the message.
	UUID *string `json:"uuid,omitempty" url:"uuid,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (m *Message) GetContent() string {
	if m == nil {
		return ""
	}
	return m.Content
}

func (m *Message) GetCreatedAt() *string {
	if m == nil {
		return nil
	}
	return m.CreatedAt
}

func (m *Message) GetMetadata() map[string]interface{} {
	if m == nil {
		return nil
	}
	return m.Metadata
}

func (m *Message) GetName() *string {
	if m == nil {
		return nil
	}
	return m.Name
}

func (m *Message) GetProcessed() *bool {
	if m == nil {
		return nil
	}
	return m.Processed
}

func (m *Message) GetRole() RoleType {
	if m == nil {
		return ""
	}
	return m.Role
}

func (m *Message) GetUUID() *string {
	if m == nil {
		return nil
	}
	return m.UUID
}

func (m *Message) GetExtraProperties() map[string]interface{} {
	return m.extraProperties
}

func (m *Message) UnmarshalJSON(data []byte) error {
	type unmarshaler Message
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*m = Message(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *m)
	if err != nil {
		return err
	}
	m.extraProperties = extraProperties
	m.rawJSON = json.RawMessage(data)
	return nil
}

func (m *Message) String() string {
	if len(m.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(m.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(m); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", m)
}

type MetadataFilterGroup struct {
	// Leaf filters (predicates on metadata key-value pairs)
	Filters []*EpisodeMetadataFilter `json:"filters,omitempty" url:"filters,omitempty"`
	// Nested sub-groups for composing complex boolean expressions
	Groups []*MetadataFilterGroup `json:"groups,omitempty" url:"groups,omitempty"`
	// Logical operator: "and" or "or"
	Type GraphitiMetadataFilterGroupType `json:"type" url:"type"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (m *MetadataFilterGroup) GetFilters() []*EpisodeMetadataFilter {
	if m == nil {
		return nil
	}
	return m.Filters
}

func (m *MetadataFilterGroup) GetGroups() []*MetadataFilterGroup {
	if m == nil {
		return nil
	}
	return m.Groups
}

func (m *MetadataFilterGroup) GetType() GraphitiMetadataFilterGroupType {
	if m == nil {
		return ""
	}
	return m.Type
}

func (m *MetadataFilterGroup) GetExtraProperties() map[string]interface{} {
	return m.extraProperties
}

func (m *MetadataFilterGroup) UnmarshalJSON(data []byte) error {
	type unmarshaler MetadataFilterGroup
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*m = MetadataFilterGroup(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *m)
	if err != nil {
		return err
	}
	m.extraProperties = extraProperties
	m.rawJSON = json.RawMessage(data)
	return nil
}

func (m *MetadataFilterGroup) String() string {
	if len(m.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(m.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(m); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", m)
}

type PropertyFilter struct {
	// Comparison operator for property filter
	ComparisonOperator ComparisonOperator `json:"comparison_operator" url:"comparison_operator"`
	// Property name to filter on
	PropertyName string `json:"property_name" url:"property_name"`
	// Property value to match on. Accepted types: string, int, float64, bool, or nil.
	// Invalid types (e.g., arrays, objects) will be rejected by validation.
	// Must be non-nil for non-null operators (`=`, `<>`, `>`, `<`, `>=`, `<=`).
	PropertyValue interface{} `json:"property_value,omitempty" url:"property_value,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (p *PropertyFilter) GetComparisonOperator() ComparisonOperator {
	if p == nil {
		return ""
	}
	return p.ComparisonOperator
}

func (p *PropertyFilter) GetPropertyName() string {
	if p == nil {
		return ""
	}
	return p.PropertyName
}

func (p *PropertyFilter) GetPropertyValue() interface{} {
	if p == nil {
		return nil
	}
	return p.PropertyValue
}

func (p *PropertyFilter) GetExtraProperties() map[string]interface{} {
	return p.extraProperties
}

func (p *PropertyFilter) UnmarshalJSON(data []byte) error {
	type unmarshaler PropertyFilter
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*p = PropertyFilter(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *p)
	if err != nil {
		return err
	}
	p.extraProperties = extraProperties
	p.rawJSON = json.RawMessage(data)
	return nil
}

func (p *PropertyFilter) String() string {
	if len(p.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(p.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(p); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", p)
}

type RoleType string

const (
	RoleTypeNoRole        RoleType = "norole"
	RoleTypeSystemRole    RoleType = "system"
	RoleTypeAssistantRole RoleType = "assistant"
	RoleTypeUserRole      RoleType = "user"
	RoleTypeFunctionRole  RoleType = "function"
	RoleTypeToolRole      RoleType = "tool"
)

func NewRoleTypeFromString(s string) (RoleType, error) {
	switch s {
	case "norole":
		return RoleTypeNoRole, nil
	case "system":
		return RoleTypeSystemRole, nil
	case "assistant":
		return RoleTypeAssistantRole, nil
	case "user":
		return RoleTypeUserRole, nil
	case "function":
		return RoleTypeFunctionRole, nil
	case "tool":
		return RoleTypeToolRole, nil
	}
	var t RoleType
	return "", fmt.Errorf("%s is not a valid %T", s, t)
}

func (r RoleType) Ptr() *RoleType {
	return &r
}

type SearchFilters struct {
	// List of node UUIDs to filter edges on: an edge matches if its source OR
	// target node UUID is in this list. Applies to edges only; rejected on
	// requests whose result type contains no edges. Max 256 entries.
	ConnectedNodeUUIDs []string `json:"connected_node_uuids,omitempty" url:"connected_node_uuids,omitempty"`
	// 2D array of date filters for the created_at field.
	// The outer array elements are combined with OR logic.
	// The inner array elements are combined with AND logic.
	// Example: `[[{">", date1}, {"<", date2}], [{"=", date3}]]`
	// This translates to: `(created_at > date1 AND created_at < date2) OR (created_at = date3)`
	CreatedAt [][]*DateFilter `json:"created_at,omitempty" url:"created_at,omitempty"`
	// List of edge types to filter on
	EdgeTypes []string `json:"edge_types,omitempty" url:"edge_types,omitempty"`
	// List of edge UUIDs to filter on. Max 256 to align with graph-service filter limits.
	EdgeUUIDs []string `json:"edge_uuids,omitempty" url:"edge_uuids,omitempty"`
	// [Experimental] Episode metadata filter. Restricts results to edges/nodes derived from episodes
	// matching the metadata predicates. Uses explicit AND/OR groups. This feature is experimental and may change in future releases.
	EpisodeMetadataFilters *MetadataFilterGroup `json:"episode_metadata_filters,omitempty" url:"episode_metadata_filters,omitempty"`
	// List of episode UUIDs to filter on. An edge matches if it was derived
	// from any listed episode; a node matches if it is mentioned by any
	// listed episode. Valid for both edge and node result types. Max 256
	// entries.
	EpisodeUUIDs []string `json:"episode_uuids,omitempty" url:"episode_uuids,omitempty"`
	// List of edge types to exclude from results
	ExcludeEdgeTypes []string `json:"exclude_edge_types,omitempty" url:"exclude_edge_types,omitempty"`
	// List of node labels to exclude from results
	ExcludeNodeLabels []string `json:"exclude_node_labels,omitempty" url:"exclude_node_labels,omitempty"`
	// 2D array of date filters for the expired_at field.
	// The outer array elements are combined with OR logic.
	// The inner array elements are combined with AND logic.
	// Example: `[[{">", date1}, {"<", date2}], [{"=", date3}]]`
	// This translates to: `(expired_at > date1 AND expired_at < date2) OR (expired_at = date3)`
	ExpiredAt [][]*DateFilter `json:"expired_at,omitempty" url:"expired_at,omitempty"`
	// 2D array of date filters for the invalid_at field.
	// The outer array elements are combined with OR logic.
	// The inner array elements are combined with AND logic.
	// Example: `[[{">", date1}, {"<", date2}], [{"=", date3}]]`
	// This translates to: `(invalid_at > date1 AND invalid_at < date2) OR (invalid_at = date3)`
	InvalidAt [][]*DateFilter `json:"invalid_at,omitempty" url:"invalid_at,omitempty"`
	// List of node labels to filter on
	NodeLabels []string `json:"node_labels,omitempty" url:"node_labels,omitempty"`
	// List of property filters to apply to nodes and edges
	PropertyFilters []*PropertyFilter `json:"property_filters,omitempty" url:"property_filters,omitempty"`
	// List of node UUIDs to filter edges on: an edge matches if its source
	// node UUID is in this list. Applies to edges only; rejected on requests
	// whose result type contains no edges. Max 256 entries.
	SourceNodeUUIDs []string `json:"source_node_uuids,omitempty" url:"source_node_uuids,omitempty"`
	// List of node UUIDs to filter edges on: an edge matches if its target
	// node UUID is in this list. Applies to edges only; rejected on requests
	// whose result type contains no edges. Max 256 entries.
	TargetNodeUUIDs []string `json:"target_node_uuids,omitempty" url:"target_node_uuids,omitempty"`
	// 2D array of date filters for the valid_at field.
	// The outer array elements are combined with OR logic.
	// The inner array elements are combined with AND logic.
	// Example: `[[{">", date1}, {"<", date2}], [{"=", date3}]]`
	// This translates to: `(valid_at > date1 AND valid_at < date2) OR (valid_at = date3)`
	ValidAt [][]*DateFilter `json:"valid_at,omitempty" url:"valid_at,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (s *SearchFilters) GetConnectedNodeUUIDs() []string {
	if s == nil {
		return nil
	}
	return s.ConnectedNodeUUIDs
}

func (s *SearchFilters) GetCreatedAt() [][]*DateFilter {
	if s == nil {
		return nil
	}
	return s.CreatedAt
}

func (s *SearchFilters) GetEdgeTypes() []string {
	if s == nil {
		return nil
	}
	return s.EdgeTypes
}

func (s *SearchFilters) GetEdgeUUIDs() []string {
	if s == nil {
		return nil
	}
	return s.EdgeUUIDs
}

func (s *SearchFilters) GetEpisodeMetadataFilters() *MetadataFilterGroup {
	if s == nil {
		return nil
	}
	return s.EpisodeMetadataFilters
}

func (s *SearchFilters) GetEpisodeUUIDs() []string {
	if s == nil {
		return nil
	}
	return s.EpisodeUUIDs
}

func (s *SearchFilters) GetExcludeEdgeTypes() []string {
	if s == nil {
		return nil
	}
	return s.ExcludeEdgeTypes
}

func (s *SearchFilters) GetExcludeNodeLabels() []string {
	if s == nil {
		return nil
	}
	return s.ExcludeNodeLabels
}

func (s *SearchFilters) GetExpiredAt() [][]*DateFilter {
	if s == nil {
		return nil
	}
	return s.ExpiredAt
}

func (s *SearchFilters) GetInvalidAt() [][]*DateFilter {
	if s == nil {
		return nil
	}
	return s.InvalidAt
}

func (s *SearchFilters) GetNodeLabels() []string {
	if s == nil {
		return nil
	}
	return s.NodeLabels
}

func (s *SearchFilters) GetPropertyFilters() []*PropertyFilter {
	if s == nil {
		return nil
	}
	return s.PropertyFilters
}

func (s *SearchFilters) GetSourceNodeUUIDs() []string {
	if s == nil {
		return nil
	}
	return s.SourceNodeUUIDs
}

func (s *SearchFilters) GetTargetNodeUUIDs() []string {
	if s == nil {
		return nil
	}
	return s.TargetNodeUUIDs
}

func (s *SearchFilters) GetValidAt() [][]*DateFilter {
	if s == nil {
		return nil
	}
	return s.ValidAt
}

func (s *SearchFilters) GetExtraProperties() map[string]interface{} {
	return s.extraProperties
}

func (s *SearchFilters) UnmarshalJSON(data []byte) error {
	type unmarshaler SearchFilters
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*s = SearchFilters(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *s)
	if err != nil {
		return err
	}
	s.extraProperties = extraProperties
	s.rawJSON = json.RawMessage(data)
	return nil
}

func (s *SearchFilters) String() string {
	if len(s.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(s.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(s); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", s)
}

type SuccessResponse struct {
	Message *string `json:"message,omitempty" url:"message,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (s *SuccessResponse) GetMessage() *string {
	if s == nil {
		return nil
	}
	return s.Message
}

func (s *SuccessResponse) GetExtraProperties() map[string]interface{} {
	return s.extraProperties
}

func (s *SuccessResponse) UnmarshalJSON(data []byte) error {
	type unmarshaler SuccessResponse
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*s = SuccessResponse(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *s)
	if err != nil {
		return err
	}
	s.extraProperties = extraProperties
	s.rawJSON = json.RawMessage(data)
	return nil
}

func (s *SuccessResponse) String() string {
	if len(s.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(s.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(s); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", s)
}

type Thread struct {
	CreatedAt   *string `json:"created_at,omitempty" url:"created_at,omitempty"`
	ProjectUUID *string `json:"project_uuid,omitempty" url:"project_uuid,omitempty"`
	ThreadID    *string `json:"thread_id,omitempty" url:"thread_id,omitempty"`
	UserID      *string `json:"user_id,omitempty" url:"user_id,omitempty"`
	UserUUID    *string `json:"user_uuid,omitempty" url:"user_uuid,omitempty"`
	UUID        *string `json:"uuid,omitempty" url:"uuid,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (t *Thread) GetCreatedAt() *string {
	if t == nil {
		return nil
	}
	return t.CreatedAt
}

func (t *Thread) GetProjectUUID() *string {
	if t == nil {
		return nil
	}
	return t.ProjectUUID
}

func (t *Thread) GetThreadID() *string {
	if t == nil {
		return nil
	}
	return t.ThreadID
}

func (t *Thread) GetUserID() *string {
	if t == nil {
		return nil
	}
	return t.UserID
}

func (t *Thread) GetUserUUID() *string {
	if t == nil {
		return nil
	}
	return t.UserUUID
}

func (t *Thread) GetUUID() *string {
	if t == nil {
		return nil
	}
	return t.UUID
}

func (t *Thread) GetExtraProperties() map[string]interface{} {
	return t.extraProperties
}

func (t *Thread) UnmarshalJSON(data []byte) error {
	type unmarshaler Thread
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*t = Thread(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *t)
	if err != nil {
		return err
	}
	t.extraProperties = extraProperties
	t.rawJSON = json.RawMessage(data)
	return nil
}

func (t *Thread) String() string {
	if len(t.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(t.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(t); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", t)
}

type ThreadSummary struct {
	// CreatedAt is when the summary node was first created.
	CreatedAt *string `json:"created_at,omitempty" url:"created_at,omitempty"`
	// LastSummarizedAt is the wall-clock timestamp of the most recent
	// summary update. This is an ingestion-time watermark; for the
	// event-time recency of the summary's content, use
	// LastSummarizedEpisodeValidAt instead.
	LastSummarizedAt *string `json:"last_summarized_at,omitempty" url:"last_summarized_at,omitempty"`
	// LastSummarizedEpisodeValidAt is the maximum episode reference time
	// (valid_at) covered by the most recent summary. Use this when
	// answering "how recent is this summary's content in event-time?".
	LastSummarizedEpisodeValidAt *string `json:"last_summarized_episode_valid_at,omitempty" url:"last_summarized_episode_valid_at,omitempty"`
	// Summary is the incremental summary content.
	Summary *string `json:"summary,omitempty" url:"summary,omitempty"`
	// ThreadID is the ID of the thread this summary belongs to.
	// When a thread was created without an explicit thread_id, this
	// field falls back to the thread's UUID. Clients should treat it
	// as an opaque identifier.
	ThreadID *string `json:"thread_id,omitempty" url:"thread_id,omitempty"`
	// UUID of the thread summary node.
	UUID *string `json:"uuid,omitempty" url:"uuid,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (t *ThreadSummary) GetCreatedAt() *string {
	if t == nil {
		return nil
	}
	return t.CreatedAt
}

func (t *ThreadSummary) GetLastSummarizedAt() *string {
	if t == nil {
		return nil
	}
	return t.LastSummarizedAt
}

func (t *ThreadSummary) GetLastSummarizedEpisodeValidAt() *string {
	if t == nil {
		return nil
	}
	return t.LastSummarizedEpisodeValidAt
}

func (t *ThreadSummary) GetSummary() *string {
	if t == nil {
		return nil
	}
	return t.Summary
}

func (t *ThreadSummary) GetThreadID() *string {
	if t == nil {
		return nil
	}
	return t.ThreadID
}

func (t *ThreadSummary) GetUUID() *string {
	if t == nil {
		return nil
	}
	return t.UUID
}

func (t *ThreadSummary) GetExtraProperties() map[string]interface{} {
	return t.extraProperties
}

func (t *ThreadSummary) UnmarshalJSON(data []byte) error {
	type unmarshaler ThreadSummary
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*t = ThreadSummary(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *t)
	if err != nil {
		return err
	}
	t.extraProperties = extraProperties
	t.rawJSON = json.RawMessage(data)
	return nil
}

func (t *ThreadSummary) String() string {
	if len(t.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(t.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(t); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", t)
}

type User struct {
	CreatedAt              *string `json:"created_at,omitempty" url:"created_at,omitempty"`
	DeletedAt              *string `json:"deleted_at,omitempty" url:"deleted_at,omitempty"`
	DisableDefaultOntology *bool   `json:"disable_default_ontology,omitempty" url:"disable_default_ontology,omitempty"`
	Email                  *string `json:"email,omitempty" url:"email,omitempty"`
	FirstName              *string `json:"first_name,omitempty" url:"first_name,omitempty"`
	ID                     *int    `json:"id,omitempty" url:"id,omitempty"`
	LastName               *string `json:"last_name,omitempty" url:"last_name,omitempty"`
	// Deprecated
	Metadata    map[string]interface{} `json:"metadata,omitempty" url:"metadata,omitempty"`
	ProjectUUID *string                `json:"project_uuid,omitempty" url:"project_uuid,omitempty"`
	// Deprecated
	SessionCount *int    `json:"session_count,omitempty" url:"session_count,omitempty"`
	TimeZone     *string `json:"time_zone,omitempty" url:"time_zone,omitempty"`
	// Deprecated
	UpdatedAt *string `json:"updated_at,omitempty" url:"updated_at,omitempty"`
	UserID    *string `json:"user_id,omitempty" url:"user_id,omitempty"`
	UUID      *string `json:"uuid,omitempty" url:"uuid,omitempty"`

	extraProperties map[string]interface{}
	rawJSON         json.RawMessage
}

func (u *User) GetCreatedAt() *string {
	if u == nil {
		return nil
	}
	return u.CreatedAt
}

func (u *User) GetDeletedAt() *string {
	if u == nil {
		return nil
	}
	return u.DeletedAt
}

func (u *User) GetDisableDefaultOntology() *bool {
	if u == nil {
		return nil
	}
	return u.DisableDefaultOntology
}

func (u *User) GetEmail() *string {
	if u == nil {
		return nil
	}
	return u.Email
}

func (u *User) GetFirstName() *string {
	if u == nil {
		return nil
	}
	return u.FirstName
}

func (u *User) GetID() *int {
	if u == nil {
		return nil
	}
	return u.ID
}

func (u *User) GetLastName() *string {
	if u == nil {
		return nil
	}
	return u.LastName
}

func (u *User) GetMetadata() map[string]interface{} {
	if u == nil {
		return nil
	}
	return u.Metadata
}

func (u *User) GetProjectUUID() *string {
	if u == nil {
		return nil
	}
	return u.ProjectUUID
}

func (u *User) GetSessionCount() *int {
	if u == nil {
		return nil
	}
	return u.SessionCount
}

func (u *User) GetTimeZone() *string {
	if u == nil {
		return nil
	}
	return u.TimeZone
}

func (u *User) GetUpdatedAt() *string {
	if u == nil {
		return nil
	}
	return u.UpdatedAt
}

func (u *User) GetUserID() *string {
	if u == nil {
		return nil
	}
	return u.UserID
}

func (u *User) GetUUID() *string {
	if u == nil {
		return nil
	}
	return u.UUID
}

func (u *User) GetExtraProperties() map[string]interface{} {
	return u.extraProperties
}

func (u *User) UnmarshalJSON(data []byte) error {
	type unmarshaler User
	var value unmarshaler
	if err := json.Unmarshal(data, &value); err != nil {
		return err
	}
	*u = User(value)
	extraProperties, err := internal.ExtractExtraProperties(data, *u)
	if err != nil {
		return err
	}
	u.extraProperties = extraProperties
	u.rawJSON = json.RawMessage(data)
	return nil
}

func (u *User) String() string {
	if len(u.rawJSON) > 0 {
		if value, err := internal.StringifyJSON(u.rawJSON); err == nil {
			return value
		}
	}
	if value, err := internal.StringifyJSON(u); err == nil {
		return value
	}
	return fmt.Sprintf("%#v", u)
}