service

type Config struct {
	// Lifecycle callbacks (all optional)
	OnCreated func(ctx context.Context, item model.MemoryItem)
	OnUpdated func(ctx context.Context, item model.MemoryItem)
	OnDeleted func(ctx context.Context, itemID string)
	OnExpired func(ctx context.Context, itemID string)
}

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

type DecisionExecutionSummary struct {
	Added   []string `json:"added"`
	Updated []string `json:"updated"`
	Deleted []string `json:"deleted"`
	Ignored []string `json:"ignored"`
	Merged  []string `json:"merged"`
	Errors  []string `json:"errors,omitempty"`
}

type DecisionRequest struct {
	Candidates      []ExtractedMemory `json:"candidates"`
	SimilarMemories []SimilarMemory   `json:"similar_memories"`
	DialogContext   string            `json:"dialog_context"`
}

type DecisionResult struct {
	Decisions      []MemoryDecision `json:"decisions"`
	TotalTokens    int              `json:"total_tokens"`
	ProcessingTime int              `json:"processing_time_ms"`
}

type DecisionType string

type ErrorCode string

type ExecutionResult struct {
	Added   []string
	Updated []string
	Deleted []string
	Ignored []string
	Merged  []string
	Errors  []string
}

type ExtractPolicy struct {
	// DropTransientEphemeral removes NamespaceTransient memories whose normalized text contains
	// ephemeral cues (wall-clock, calendar extrapolation). Useful for hosts that still want
	// transient rows but not “what time is it” noise.
	DropTransientEphemeral bool
	// TransientEphemeralSubstrings overrides substring cues (case-insensitive).
	// Empty/nil with DropTransientEphemeral uses DefaultTransientEphemeralSubstrings().
	TransientEphemeralSubstrings []string
}

type ExtractRequest struct {
	DialogText        string
	LLMConfigID       string // deprecated: database lookup is no longer supported
	PromptID          string // deprecated: database lookup is no longer supported
	ContextMemories   []string
	MinConfidence     float64 // default 0.7
	DryRun            bool
	UseDecisionEngine bool // default false, if true uses new extract → similar → decide → persist flow
	SimilarTopK       int  // default 5, number of similar memories to fetch per candidate

	// ReferenceTime is the instant treated as "now" for resolving relative time (e.g. 明天, next week).
	// If nil, Extract uses the wall-clock time when the request runs.
	ReferenceTime *time.Time
	// TimeZone is an IANA name (e.g. "Asia/Shanghai", "America/New_York") for presenting reference
	// instants in the model prompt. Empty = use the location of ReferenceTime (or local wall clock).
	TimeZone string
	// ResolutionContext is optional free text: user display name, who 他/她/经理 refers to, session
	// participants, etc. The model is instructed to replace vague references in stored title/content/summary.
	ResolutionContext string

	// LLMConfig must be provided directly in code.
	LLMConfig *model.LLMConfig

	// ExtractionPrompt allows passing prompt directly in code.
	// If nil, builtin default prompt is used.
	ExtractionPrompt *model.ExtractionPrompt

	// ExtractPolicy applies extra filtering after MinConfidence (e.g. transient ephemeral cues).
	ExtractPolicy *ExtractPolicy

	// PostExtractHook runs after MinConfidence and ExtractPolicy, before persistence.
	PostExtractHook func(ctx context.Context, mem []ExtractedMemory) ([]ExtractedMemory, error)
}

type ExtractResult struct {
	ExtractionID   string
	Status         string
	Memories       []ExtractedMemory
	TotalTokens    int
	ProcessingTime int // ms

	// Decision engine results (when UseDecisionEngine is true)
	DecisionResult *DecisionExecutionSummary `json:"decision_result,omitempty"`
}

type ExtractedMemory struct {
	TempID       string                 `json:"temp_id"`
	Namespace    model.NamespaceType    `json:"namespace"`
	Title        string                 `json:"title"`
	Content      string                 `json:"content"`
	Summary      string                 `json:"summary,omitempty"`
	Tags         []string               `json:"tags,omitempty"`
	Importance   int                    `json:"importance"`
	Confidence   float64                `json:"confidence"`
	Reasoning    string                 `json:"reasoning,omitempty"`
	TaskMetadata map[string]interface{} `json:"task_metadata,omitempty"`
}

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

type ForgetRequest struct {
	ItemIDs       []string
	Namespace     string
	NamespaceType model.NamespaceType
	Mode          string // "soft" (default), "hard", "expire"
	Reason        string
}

type IsolationMeta struct {
	TenantID  string
	UserID    string
	SessionID string
	AgentID   string
}

type ListRequest struct {
	Namespaces     []string
	NamespaceTypes []model.NamespaceType
	TagsAny        []string
	TagsAll        []string
	TimeRangeStart *time.Time
	TimeRangeEnd   *time.Time
	IncludeExpired bool
	MinConfidence  float64
	MinImportance  int
	TopK           int
	Offset         int
	ExcludeItemIDs []string
	Order          string // "desc" (default) or "asc", based on created_at
}

type MemoryDecision struct {
	Decision      DecisionType `json:"decision"`
	TargetID      string       `json:"target_id,omitempty"` // Existing memory ID for UPDATE/DELETE/MERGE
	Reason        string       `json:"reason"`
	Confidence    float64      `json:"confidence"`
	MergedContent string       `json:"merged_content,omitempty"` // For MERGE: merged content
	MergedTitle   string       `json:"merged_title,omitempty"`   // For MERGE: merged title
	NewImportance int          `json:"new_importance,omitempty"` // Suggested importance after action
}

type MemoryError struct {
	Code    ErrorCode
	Message string
	Cause   error
	Retry   bool
}

type MemoryHit struct {
	model.MemoryItem
	Score           float64
	FTSScore        float64
	RecencyScore    float64
	ImportanceScore float64
	ConfidenceScore float64
	MatchReasons    []string
}

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

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

type RecallRequest struct {
	Query          string
	Namespaces     []string
	NamespaceTypes []model.NamespaceType
	TagsAny        []string
	TagsAll        []string
	TimeRangeStart *time.Time
	TimeRangeEnd   *time.Time
	IncludeExpired bool
	MinConfidence  float64
	MinImportance  int
	TopK           int
	ExcludeItemIDs []string
}

type RememberRequest struct {
	NamespaceType model.NamespaceType
	Title         string
	Content       string
	Summary       string
	Tags          []string
	SourceType    model.SourceType
	SourceRef     string
	Importance    int
	Confidence    float64
	TTLSeconds    *int
	DedupeKey     *string
}

type SimilarMemory struct {
	ID         string   `json:"id"`
	Namespace  string   `json:"namespace"`
	Title      string   `json:"title"`
	Content    string   `json:"content"`
	Summary    string   `json:"summary"`
	Tags       []string `json:"tags"`
	Importance int      `json:"importance"`
	Confidence float64  `json:"confidence"`
	CreatedAt  string   `json:"created_at"`
	Similarity float64  `json:"similarity"` // 0-1 similarity score
}

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

type UpdateRequest struct {
	ItemID          string
	Title           *string
	Content         *string
	Summary         *string
	Tags            []string
	Importance      *int
	Confidence      *float64
	ExpectedVersion int // For optimistic locking
}