entity

type CreateOpts struct {
	Aliases    []string          // Alternative names
	Summary    string            // Initial summary
	Attributes map[string]string // Structured facts
	Metadata   map[string]string // Additional metadata
}

type CreateResult struct {
	Entity  *types.Entity `json:"entity"`
	Created bool          `json:"created"` // false if entity already existed
}

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

type EntityExtractor interface {
	Extract(ctx context.Context, text string) (*ExtractionResult, error)
}

type ExtractedEntity struct {
	Name       string            `json:"name"`
	Type       string            `json:"type"`
	Aliases    []string          `json:"aliases,omitempty"`
	Attributes map[string]string `json:"attributes,omitempty"`
	Confidence float64           `json:"confidence"`
}

type ExtractedRelationship struct {
	SourceName   string  `json:"source_name"`
	TargetName   string  `json:"target_name"`
	RelationType string  `json:"relation_type"`
	Description  string  `json:"description,omitempty"`
	Confidence   float64 `json:"confidence"`
}

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

type ExtractionResult struct {
	Entities      []ExtractedEntity       `json:"entities"`
	Relationships []ExtractedRelationship `json:"relationships,omitempty"`
	SourceText    string                  `json:"-"` // Original text (not serialized)
}

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

type GetRelationshipsOpts struct {
	RelationType *string                     // Filter by type
	Direction    types.RelationshipDirection // Direction filter
}

type ListOpts struct {
	EntityType *types.EntityType  // Filter by type
	SortBy     types.EntitySortBy // Sort order
	Cursor     string             // Pagination cursor
	Limit      int                // Max results (0 = default)
}

type ListResult struct {
	Entities   []*types.Entity `json:"entities"`
	NextCursor string          `json:"next_cursor,omitempty"`
	Count      int             `json:"count"`
}

type MentionOpts struct {
	Context string // Surrounding text
	Snippet string // Exact mention text
}

type MergeResult struct {
	KeptEntity          *types.Entity `json:"kept_entity"`
	MergedMentions      int           `json:"merged_mentions"`
	MergedRelationships int           `json:"merged_relationships"`
}

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

type RelationshipOpts struct {
	Description string  // Free-text description
	Confidence  float64 // 0.0-1.0 extraction confidence
}

type ResolvedEntity struct {
	Entity     *types.Entity // The existing entity (nil if no match)
	Confidence float64       // Resolution confidence (0-1)
	MatchType  string        // "exact", "alias", "fuzzy", or "new"
}

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

type SearchMode string

type SearchOpts struct {
	EntityType *types.EntityType // Filter by type
	TopK       int               // Number of results (0 = default 10)
	MinScore   float64           // Minimum similarity score (0-1)
	SearchMode SearchMode        // Search mode: "vector" (default), "hybrid", or "text"
	Alpha      float64           // Hybrid search weight: 0=pure text, 1=pure vector, 0.5=equal (default: 0.5)
}

type SearchResult struct {
	Results    []*types.EntityResult `json:"results"`
	Query      string                `json:"query"`
	TotalFound int                   `json:"total_found"`
}

type UpdateOpts struct {
	Summary    *string           // New summary (nil = don't update)
	Attributes map[string]string // Merge with existing attributes
	Metadata   map[string]string // Merge with existing metadata
}