memory

type AgentMemory struct {
	// ID is a unique identifier for this memory record
	ID types.AgentMemoryID

	// AgentID identifies which agent this memory belongs to (e.g., "bigquery")
	AgentID string

	// TaskQuery is the original natural language query that triggered this execution
	TaskQuery string

	// QueryEmbedding is the vector embedding of TaskQuery for semantic search
	// Generated automatically by Memory Service when saving
	// Must use firestore.Vector32 type for Firestore vector search to work
	QueryEmbedding firestore.Vector32

	// Timestamp records when this task was executed
	Timestamp time.Time

	// Duration records how long the task took to complete
	Duration time.Duration

	// Successes is a list of successful patterns observed (K: Keep in KPT format)
	// Contains domain knowledge about what worked: field semantics, data formats, query patterns
	// Example: ["Login failures identified by severity='ERROR' AND action='login'. User ID is user.email (STRING) not user.id (INT64)"]
	Successes []string

	// Problems is a list of issues encountered during execution (P: Problem in KPT format)
	// Contains domain knowledge mistakes: wrong field assumptions, unexpected data formats
	// Example: ["Expected 'timestamp' field but actual field is 'event_time' (TIMESTAMP type). user_id is INT64 not STRING email"]
	Problems []string

	// Improvements is a list of suggestions for future executions (T: Try in KPT format)
	// Contains specific domain knowledge to apply: which fields to use, expected formats, search patterns
	// Example: ["For user searches: use user.email (STRING) not user_id (INT64). For errors: check error_code field values"]
	Improvements []string
}

type ExecutionMemory struct {
	ID       types.MemoryID    `json:"id"`
	SchemaID types.AlertSchema `json:"schema_id"`
	Summary  string            `json:"summary"`
	Keep     string            `json:"keep"`
	Change   string            `json:"change"`
	Notes    string            `json:"notes"`

	// Embedding is the vector embedding of Summary for semantic search
	// Generated automatically by Memory Service when saving
	// Must use firestore.Vector32 type for Firestore vector search to work
	Embedding firestore.Vector32 `json:"embedding,omitempty"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
	Version   int       `json:"version"`
}

type TicketMemory struct {
	ID        types.MemoryID    `json:"id"`
	SchemaID  types.AlertSchema `json:"schema_id"`
	Insights  string            `json:"insights"`
	CreatedAt time.Time         `json:"created_at"`
	UpdatedAt time.Time         `json:"updated_at"`
	Version   int               `json:"version"`
}