skills

type KnowledgeEntry struct {
	ID            string
	Name          string
	Description   string
	Content       string // body text from SKILL.md
	KnowledgeType KnowledgeType
	Status        string // draft | active | deprecated
	CreatedAt     time.Time
	UpdatedAt     time.Time
}

type KnowledgeStore interface {
	// ListKnowledge returns active knowledge entries for the given view context.
	// Pass knowledge types to filter; no types means all knowledge types.
	ListKnowledge(ctx context.Context, vc ViewContext, types ...KnowledgeType) ([]KnowledgeEntry, error)

	// ExpireKnowledgeDraftsByType deprecates draft knowledge entries of the given type
	// whose created-at timestamp is before the cutoff.
	ExpireKnowledgeDraftsByType(ctx context.Context, knowledgeType KnowledgeType, before time.Time) error
}

type KnowledgeType string

type MigrateFSConfig struct {
	// AnnaHome is intentionally unused: builtin (anna source) skills are handled
	// exclusively by SyncBuiltin, not by filesystem migration.
	AnnaHome      string
	AgentRoot     string
	UserRoot      string
	UserSkillsDir string
	// Owner fields used when creating scoped rows.
	UserID  int64
	AgentID string
}

type MigrateFSResult struct {
	Imported int
	Skipped  int // already-in-DB duplicates
}

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

type Skill struct {
	ID                     string
	Scope                  string // system | agent | user
	UserID                 int64
	AgentID                string
	Name                   string
	Description            string
	Status                 string // draft | active | deprecated
	DisableModelInvocation bool
	Metadata               json.RawMessage
	CreatedAt              time.Time
	UpdatedAt              time.Time
}

type Store interface {
	// List returns all visible skills for the given context (metadata only, no file content).
	List(ctx context.Context, vc ViewContext) ([]Skill, error)

	// ListAll returns every skill regardless of status or visibility (admin use only).
	ListAll(ctx context.Context) ([]Skill, error)

	// Resolve finds the highest-priority visible skill by name.
	// Priority: user > agent > system.
	Resolve(ctx context.Context, name string, vc ViewContext) (*Skill, error)

	// LoadFile fetches a single file by path. Pass MainFile ("SKILL.md") for the body.
	LoadFile(ctx context.Context, skillID, path string) (string, error)

	// ListFiles returns all file paths for a skill (no content).
	ListFiles(ctx context.Context, skillID string) ([]string, error)

	// Create inserts the skill row and all its files (must include "SKILL.md").
	Create(ctx context.Context, s Skill, files map[string]string) (string, error)

	// Update patches metadata fields. Use UpsertFile to change file content.
	Update(ctx context.Context, id string, patch UpdatePatch) error

	// UpsertFile creates or replaces a single file under a skill.
	UpsertFile(ctx context.Context, skillID, path, content string) error

	DeleteFile(ctx context.Context, skillID, path string) error
	Delete(ctx context.Context, id string) error

	// ExpireDrafts deprecates all draft skills (disable_model_invocation=0) whose
	// created-at timestamp is before the given cutoff. Knowledge entries are excluded.
	ExpireDrafts(ctx context.Context, before time.Time) error
}

type UpdatePatch struct {
	Description            *string
	Status                 *string
	DisableModelInvocation *bool
	Metadata               json.RawMessage // optional; set to overwrite
}

type ViewContext struct {
	UserID  int64
	AgentID string
}