palace

type AddDrawerToolInput struct {
	// Wing name (project or domain).
	Wing string `json:"wing"`
	// Room name (topic or subdirectory).
	Room string `json:"room"`
	// The knowledge content to store.
	Content string `json:"content"`
	// Optional source file path.
	SourceFile string `json:"source_file,omitempty"`
	// Optional hall (sub-category).
	Hall string `json:"hall,omitempty"`
	// Importance score 0-10 (default 5).
	Importance int `json:"importance,omitempty"`
}

type AddDrawerToolOutput struct {
	Content string `json:"content"`
	ID      string `json:"id,omitempty"`
}

type DiaryEntry struct {
	ID        int64     `json:"id"`
	Agent     string    `json:"agent"`
	Entry     string    `json:"entry"`
	Topic     string    `json:"topic,omitempty"`
	CreatedAt time.Time `json:"created_at"`
}

type DiaryReadToolInput struct {
	// The agent name whose diary to read.
	AgentName string `json:"agent_name"`
	// Number of recent entries to return (default 10).
	LastN int `json:"last_n,omitempty"`
}

type DiaryReadToolOutput struct {
	Content string `json:"content"`
}

type DiaryWriteToolInput struct {
	// The agent name writing the entry.
	AgentName string `json:"agent_name"`
	// The diary entry content.
	Entry string `json:"entry"`
	// Optional topic/category for the entry.
	Topic string `json:"topic,omitempty"`
}

type DiaryWriteToolOutput struct {
	Content string `json:"content"`
}

type Drawer struct {
	ID         string    `json:"id"`
	Wing       string    `json:"wing"`
	Room       string    `json:"room"`
	Hall       string    `json:"hall,omitempty"`
	Content    string    `json:"content"`
	SourceFile string    `json:"source_file,omitempty"`
	ChunkIndex int       `json:"chunk_index,omitempty"`
	AddedBy    string    `json:"added_by,omitempty"`
	Importance int       `json:"importance"` // 0-10
	Embedding  []float32 `json:"-"`          // not serialized
	CreatedAt  time.Time `json:"created_at"`
}

type DrawerFilter struct {
	Wing string
	Room string
	Hall string
}

type DrawerInput struct {
	Wing       string
	Room       string
	Hall       string
	Content    string
	SourceFile string
	ChunkIndex int
	AddedBy    string
	Importance int
}

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

type DuplicateError struct {
	Result DuplicateResult
}

type DuplicateResult struct {
	ExistingID string  `json:"existing_id"`
	Similarity float32 `json:"similarity"`
}

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

type EmbeddingRow struct {
	DrawerID  string
	Embedding []float32
}

type Entity struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	Type      string    `json:"type,omitempty"` // person, file, concept, etc.
	CreatedAt time.Time `json:"created_at"`
}

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

type GraphStats struct {
	TotalRooms  int      `json:"total_rooms"`
	TunnelCount int      `json:"tunnel_count"`
	EdgeCount   int      `json:"edge_count"`
	TopTunnels  []string `json:"top_tunnels,omitempty"`
}

type KGAddToolInput struct {
	// The subject entity name.
	Subject string `json:"subject"`
	// The predicate (relationship type).
	Predicate string `json:"predicate"`
	// The object entity name.
	Object string `json:"object"`
	// Optional validity start date (RFC3339 or YYYY-MM-DD).
	ValidFrom string `json:"valid_from,omitempty"`
}

type KGAddToolOutput struct {
	Content string `json:"content"`
}

type KGInvalidateToolInput struct {
	// The subject entity name.
	Subject string `json:"subject"`
	// The predicate (relationship type).
	Predicate string `json:"predicate"`
	// The object entity name.
	Object string `json:"object"`
}

type KGInvalidateToolOutput struct {
	Content string `json:"content"`
}

type KGQueryToolInput struct {
	// The entity name to query.
	Entity string `json:"entity"`
	// Optional point-in-time filter (RFC3339 or YYYY-MM-DD).
	AsOf string `json:"as_of,omitempty"`
	// Direction: "subject", "object", or "both" (default "both").
	Direction string `json:"direction,omitempty"`
}

type KGQueryToolOutput struct {
	Content string `json:"content"`
}

type KGStats struct {
	EntityCount   int      `json:"entity_count"`
	TripleCount   int      `json:"triple_count"`
	ActiveTriples int      `json:"active_triples"`
	Predicates    []string `json:"predicates,omitempty"`
}

type KGTimelineToolInput struct {
	// The entity name to get timeline for.
	Entity string `json:"entity"`
}

type KGTimelineToolOutput struct {
	Content string `json:"content"`
}

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

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

type MineConfig struct {
	Wing     string       `yaml:"wing"`
	Rooms    []RoomDef    `yaml:"rooms"`
	Progress ProgressFunc `yaml:"-"`
}

type MineResult struct {
	Added     int
	Skipped   int // duplicates
	Processed int
	Errors    int
}

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

type Option func(*PalaceConfig)

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

type PalaceConfig struct {
	DBPath                 string
	ModelPath              string
	IdentityFile           string
	DeduplicationThreshold float32
	L1TopK                 int
	L1MaxChars             int
	L2MaxDrawers           int
	L2MaxCharsPerDrawer    int
}

type PalaceStatus struct {
	DrawerCount int      `json:"drawer_count"`
	WingCount   int      `json:"wing_count"`
	RoomCount   int      `json:"room_count"`
	KG          *KGStats `json:"kg,omitempty"`
	ModelLoaded bool     `json:"model_loaded"`
}

type PalaceStore interface {
	// Drawer operations
	InsertDrawer(ctx context.Context, d *Drawer) error
	BatchInsertDrawers(ctx context.Context, drawers []*Drawer) (int, error)
	DeleteDrawer(ctx context.Context, id string) error
	GetDrawer(ctx context.Context, id string) (*Drawer, error)
	ListDrawers(ctx context.Context, filter DrawerFilter) ([]*Drawer, error)
	CountDrawers(ctx context.Context) (int, error)

	// Embedding operations
	GetEmbedding(ctx context.Context, id string) (*EmbeddingRow, error)
	GetAllEmbeddings(ctx context.Context, filter DrawerFilter) ([]EmbeddingRow, error)

	// Search operations
	KeywordSearch(ctx context.Context, query string, filter DrawerFilter, limit int) ([]SearchResult, error)

	// Hierarchy operations
	ListWings(ctx context.Context) ([]WingSummary, error)
	ListRooms(ctx context.Context, wing string) ([]RoomSummary, error)
	GetTaxonomy(ctx context.Context) (*Taxonomy, error)

	// Knowledge graph operations
	InsertEntity(ctx context.Context, e *Entity) error
	GetEntity(ctx context.Context, id string) (*Entity, error)
	InsertTriple(ctx context.Context, t *Triple) error
	QueryTriples(ctx context.Context, entityID, asOf, direction string) ([]*Triple, error)
	InvalidateTriple(ctx context.Context, subjectID, predicateID, objectID string) error
	TimelineTriples(ctx context.Context, entityID string) ([]*Triple, error)
	KGStats(ctx context.Context) (*KGStats, error)

	// Diary operations
	InsertDiaryEntry(ctx context.Context, d *DiaryEntry) error
	ListDiaryEntries(ctx context.Context, agent string, limit int) ([]*DiaryEntry, error)

	Close() error
}

type ProgressFunc func(file string, added, skipped, errors int)

type RoomDef struct {
	Name     string   `yaml:"name"`
	Patterns []string `yaml:"patterns,omitempty"`
	Keywords []string `yaml:"keywords,omitempty"`
}

type RoomSummary struct {
	Room        string   `json:"room"`
	Wing        string   `json:"wing"`
	DrawerCount int      `json:"drawer_count"`
	Halls       []string `json:"halls,omitempty"`
}

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

type ScoredResult struct {
	DrawerID   string  `json:"drawer_id"`
	Similarity float32 `json:"similarity"`
}

type SearchQuery struct {
	Query string
	Wing  string
	Room  string
	Limit int
}

type SearchResult struct {
	Drawer     Drawer  `json:"drawer"`
	Similarity float32 `json:"similarity"`
	Rank       int     `json:"rank,omitempty"` // FTS5 rank (negative = more relevant), 0 if semantic-only
}

type SearchToolInput struct {
	// The search query.
	Query string `json:"query"`
	// Optional wing filter.
	Wing string `json:"wing,omitempty"`
	// Optional room filter.
	Room string `json:"room,omitempty"`
	// Max results (default 5).
	Limit int `json:"limit,omitempty"`
}

type SearchToolOutput struct {
	Content string `json:"content"`
	Total   int    `json:"total"`
}

type StatusInput struct{}

type StatusOutput struct {
	Content string `json:"content"`
}

type Taxonomy struct {
	Wings []TaxonomyWing `json:"wings"`
}

type TaxonomyRoom struct {
	Name        string `json:"name"`
	DrawerCount int    `json:"drawer_count"`
}

type TaxonomyWing struct {
	Name  string         `json:"name"`
	Rooms []TaxonomyRoom `json:"rooms"`
}

type TraverseResult struct {
	Room        string   `json:"room"`
	Wings       []string `json:"wings"`
	DrawerCount int      `json:"drawer_count"`
	Hops        int      `json:"hops"`
}

type TraverseToolInput struct {
	// The room to start BFS traversal from.
	StartRoom string `json:"start_room"`
	// Maximum hops from start room (default 2).
	MaxHops int `json:"max_hops,omitempty"`
}

type TraverseToolOutput struct {
	Content string `json:"content"`
}

type Triple struct {
	ID          string     `json:"id"`
	SubjectID   string     `json:"subject_id"`
	PredicateID string     `json:"predicate_id"`
	ObjectID    string     `json:"object_id"`
	ValidFrom   *time.Time `json:"valid_from,omitempty"`
	ValidTo     *time.Time `json:"valid_to,omitempty"`
	SourceFile  string     `json:"source_file,omitempty"`
	ExtractedAt time.Time  `json:"extracted_at"`
}

type TripleInput struct {
	Subject   string
	Predicate string
	Object    string
	ValidFrom *time.Time
}

type Tunnel struct {
	Room        string   `json:"room"`
	Wings       []string `json:"wings"`
	DrawerCount int      `json:"drawer_count"`
}

type WingSummary struct {
	Wing        string `json:"wing"`
	DrawerCount int    `json:"drawer_count"`
	RoomCount   int    `json:"room_count"`
}