tools

type CapabilityContext struct {
	// AllowedTools — the set of tool names visible to the run.
	// Used by the filter (subset check) AND the redactor (skills
	// referencing names not in this set get the disallowed-name
	// replacement).
	AllowedTools []string `json:"allowed_tools,omitempty"`
	// AllowedNamespaces — namespaces (Skill.RequiredNS) the run may
	// reference.
	AllowedNamespaces []string `json:"allowed_namespaces,omitempty"`
	// AllowedTags — tags (Skill.RequiredTags) the run may reference.
	AllowedTags []string `json:"allowed_tags,omitempty"`
	// RedactPII opts in to PII redaction across skill text
	// (emails / phone / bearer tokens / URL query strings).
	RedactPII bool `json:"redact_pii,omitempty"`
}

type Deps struct {
	Bus events.EventBus
}

type GetArgs struct {
	// Names are the skill names to fetch. Each is looked up via
	// `SkillStore.Get`; missing names are SKIPPED (not an error) so
	// a partial response remains useful when one name is stale.
	Names []string `json:"names"`
	// MaxTokens caps the returned skills' combined estimated
	// token count. 0 → `defaultMaxTokens` (1024).
	MaxTokens int `json:"max_tokens,omitempty"`
	// Capability gates + redacts the returned skills.
	Capability CapabilityContext `json:"capability"`
}

type GetResult struct {
	// Skills are the requested skills after capability filter +
	// redaction + budgeter. The slice MAY be empty (every requested
	// skill was filtered out or missing); it is never partially
	// over-budget.
	Skills []skills.Skill `json:"skills"`
	// Summarized reports whether the budgeter dropped optional
	// fields (preconditions / failure modes) — ladder step 1.
	Summarized bool `json:"summarized"`
	// DroppedSteps reports whether the budgeter capped procedural
	// steps to 3 — ladder step 2.
	DroppedSteps bool `json:"dropped_steps"`
}

type ListArgs struct {
	Scope      skills.Scope      `json:"scope,omitempty"`
	TaskType   string            `json:"task_type,omitempty"`
	Tags       []string          `json:"tags,omitempty"`
	Limit      int               `json:"limit,omitempty"`
	Offset     int               `json:"offset,omitempty"`
	Capability CapabilityContext `json:"capability"`
}

type ListResult struct {
	// Skills are the paged rows after capability filter + redaction.
	// The list is NOT budget-trimmed — callers requesting a paged
	// enumeration accept that the planner-facing text is
	// summary-only (Title + Trigger + Tags), not full content.
	Skills []skills.Skill `json:"skills"`
}

type SearchArgs struct {
	Query      string            `json:"query"`
	Limit      int               `json:"limit,omitempty"`
	Capability CapabilityContext `json:"capability"`
}

type SearchResult struct {
	// Skills are the ranked candidates after capability filter +
	// redaction. The slice never exceeds `Limit` (or the SkillStore
	// default when zero).
	Skills []skills.RankedSkill `json:"skills"`
	// Path is the ranking ladder branch that produced the rows
	// ("fts5" | "regex" | "exact"). Surfaced for observability;
	// inert to the planner's reasoning.
	Path string `json:"path"`
}