skill

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

type CatalogSkill struct {
	Slug         string
	Name         string
	Summary      string
	Version      string    // empty when unknown
	Downloads    *int      // nil in search mode (upstream search has no stats)
	Installs     *int      // nil in search mode
	UpdatedAt    time.Time // zero when unknown
	AuthorHandle string    // empty in browse mode (upstream list has no owner)
	AuthorImage  string
}

type CatalogSkillDetail struct {
	Slug    string
	Name    string
	Summary string
	Version string
	Readme  string   // SKILL.md content, empty when absent
	Files   []string // relative file paths, sorted
}

type IdentityReader interface {
	GetIdentity(context.Context, string) (*Skill, error)
	ListIdentityVisible(context.Context, ViewContext) ([]Skill, error)
	ListIdentityByScope(context.Context, string, string, string) ([]Skill, error)
	ListIdentityCandidate(context.Context, string, ViewContext) ([]Skill, error)
	LoadCurrentRevision(context.Context, Skill) (ManagedRevision, error)
	LoadExactRevision(context.Context, Skill, string) (ManagedRevision, error)
}

type ManagedCreate struct {
	Scope                  string
	TargetAgentID          string
	Name                   string
	Description            string
	DisableModelInvocation bool
	Files                  map[string]string
}

type ManagedRevision struct {
	Skill Skill
	Files map[string][]byte
	Modes map[string]fs.FileMode
}

type ManagedSkillCursor struct {
	Timestamp time.Time
	ID        string
}

type ManagedSkillDelete struct {
	ID             string
	UserID         string
	AgentID        string
	Scope          string
	ExpectedDigest string
}

type ManagedSkillFileDelete struct {
	ManagedSkillDelete
	Path string
}

type ManagedSkillUpdate struct {
	ID              string
	UserID          string
	AgentID         string
	Scope           string
	Patch           UpdatePatch
	Files           map[string]string
	DeleteFiles     []string
	ConvertToManual bool
	ExpectedDigest  string
}

type ManagedUpdate struct {
	ID              string
	ExpectedVersion string
	Name            string
	Patch           UpdatePatch
	Version         *string
	Files           map[string]string
	ReplaceFiles    bool
	ConvertToManual bool
}

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

type ManagementAccess interface {
	ManageScope(context.Context, authz.Authority, string, string) (userID, agentID string, err error)
	ManageByID(context.Context, authz.Authority, string, authz.Action) (Skill, error)
}

type ManagementStore interface {
	IdentityReader
	CreateManagedSkill(context.Context, Skill, map[string]string) (SkillSnapshot, error)
	UpdateManagedSkill(context.Context, ManagedSkillUpdate) (SkillSnapshot, error)
	DeleteManagedSkill(context.Context, ManagedSkillDelete) error
}

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

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

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

type ReflectSkillCreate struct {
	UserID            string
	AgentID           string
	Name              string
	Description       string
	MainFileContent   string
	Metadata          json.RawMessage
	ChangelogMetadata json.RawMessage
}

type ReflectSkillDelete struct {
	ID                      string
	UserID                  string
	AgentID                 string
	ExpectedDigest          string
	ExpectedUsageLastUsedAt time.Time
}

type ReflectSkillPatch struct {
	ID                     string
	UserID                 string
	AgentID                string
	ExpectedDigest         string
	Description            *string
	Status                 *string
	DisableModelInvocation *bool
	MainFileContent        *string
	Metadata               json.RawMessage
	ChangelogMetadata      json.RawMessage
}

type ResolvedSkill struct {
	Skill
	// contains filtered or unexported fields
}

type RuntimeReader interface {
	IdentityReader
	TouchReflectSkillRuntimeUseDigest(context.Context, string, string, string, string) error
}

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

type SettingsSkillActionTool = toolmeta.ActionTool

type SettingsSkillCreateInput struct {
	ContentPath   string `json:"content_path,omitempty"`
	Scope         string `json:"scope,omitempty"`
	TargetAgentId string `json:"target_agent_id,omitempty"`
}

type SettingsSkillDeleteInput struct {
	ExpectedVersion string `json:"expected_version,omitempty"`
	Id              string `json:"id,omitempty"`
}

type SettingsSkillGetInput struct {
	Id string `json:"id,omitempty"`
}

type SettingsSkillHandler interface {
	Create(context.Context, SettingsSkillCreateInput) (any, error)
	Delete(context.Context, SettingsSkillDeleteInput) (any, error)
	Get(context.Context, SettingsSkillGetInput) (any, error)
	List(context.Context, SettingsSkillListInput) (any, error)
	Update(context.Context, SettingsSkillUpdateInput) (any, error)
}

type SettingsSkillListInput struct {
	Limit         int    `json:"limit,omitempty"`
	Scope         string `json:"scope,omitempty"`
	TargetAgentId string `json:"target_agent_id,omitempty"`
}

type SettingsSkillUpdateInput struct {
	ContentPath     string  `json:"content_path,omitempty"`
	ConvertToManual *bool   `json:"convert_to_manual,omitempty"`
	ExpectedVersion string  `json:"expected_version,omitempty"`
	Id              string  `json:"id,omitempty"`
	Version         *string `json:"version,omitempty"`
}

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

type SkillActionTool = toolmeta.ActionTool

type SkillChangelog struct {
	ID            string
	SkillID       string
	UserID        string
	AgentID       string
	Scope         string
	Action        string
	VersionBefore int64
	VersionAfter  int64
	ContentDigest string
	Metadata      json.RawMessage
	CreatedAt     time.Time
}

type SkillHandler interface {
	Load(context.Context, SkillLoadInput) (any, error)
	Search(context.Context, SkillSearchInput) (any, error)
}

type SkillHomeMigrationResult struct {
	State           string `json:"state"`
	SkillCount      int64  `json:"skill_count"`
	FileCount       int64  `json:"file_count"`
	ContentBytes    int64  `json:"content_bytes"`
	InventoryDigest string `json:"inventory_digest"`
}

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

type SkillLoadInput struct {
	Name string `json:"name,omitempty"`
	Path string `json:"path,omitempty"`
}

type SkillReadAuthorizer interface {
	// BeginRead binds the trusted turn/worker identity to a per-row decider. A
	// missing or invalid identity fails closed with an error.
	BeginRead(ctx context.Context) (SkillReadDecision, error)
}

type SkillReadDecision interface {
	// AllowRead reports whether the actor may read this DB skill row. A denial
	// returns (false, nil); an unexpected authorization failure returns a
	// non-nil error.
	AllowRead(ctx context.Context, id, scope, ownerUserID, agentID string) (bool, error)
}

type SkillSearchInput struct {
	Limit int    `json:"limit,omitempty"`
	Q     string `json:"q,omitempty"`
}

type SkillSnapshot struct {
	Skill Skill
	Files []string
}

type SkillStartupReconcileResult struct {
	Migration SkillHomeMigrationResult
	Degraded  error
}

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

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

type UpgradeResult struct {
	Updated         bool   // true when the skill's files/version changed
	Version         string // the version now installed
	PreviousVersion string // the version before the upgrade
}

type ViewContext struct {
	UserID            string
	AgentID           string
	DisabledSkillRefs []string
}