agent

type ActivityKind string

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

type ExposurePolicy int

type PIICategory string

type PIIConfig struct {
	// Legacy fields (backward compatibility).
	RedactEmail bool
	RedactPhone bool
	CustomRegex []string

	// New pattern management.
	DisabledBuiltins []string
	CustomPatterns   map[string]string // name -> regex

	// Presidio integration.
	PresidioEnabled   bool
	PresidioURL       string
	PresidioThreshold float64
	PresidioLanguage  string
}

type PIIDetector interface {
	Detect(text string) []PIIMatch
}

type PIIMatch struct {
	PatternName string
	Category    PIICategory
	Start       int
	End         int
	Score       float64 // 1.0 for regex, variable for Presidio
}

type PIIPatternDef struct {
	Name           string
	Label          string
	Category       PIICategory
	Pattern        string
	EnabledDefault bool
	Validate       func(match string) bool // optional post-match validation
}

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

type ParameterDef struct {
	Type        string
	Description string
	Required    bool
	Enum        []string
}

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

type PresidioOption func(*PresidioDetector)

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

type RegexDetectorConfig struct {
	DisabledBuiltins []string
	CustomPatterns   map[string]string // name -> regex
	CustomRegex      []string          // legacy unnamed custom patterns

	// Legacy toggles for backward compatibility.
	RedactEmail bool
	RedactPhone bool
}

type SafetyLevel int

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

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

type Tool struct {
	Name        string
	Description string
	Parameters  map[string]interface{}
	Handler     ToolHandler
	SafetyLevel SafetyLevel
	Capability  ToolCapability // Zero value = backward compatible defaults
}

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

type ToolCapability struct {
	// Aliases are alternate names that match during tool search (e.g. "ls" for "fs_list").
	Aliases []string
	// Category is a semantic category hint (e.g. "filesystem", "crypto").
	// Distinct from the Catalog category — this is tool-level metadata.
	Category string
	// SearchHints are additional keywords for search ranking.
	SearchHints []string
	// Exposure controls prompt visibility policy.
	// Zero value (ExposureDefault) = always visible = backward compatible.
	Exposure ExposurePolicy
	// ReadOnly indicates the tool performs no mutations.
	// Zero value (false) = assume mutation possible = fail-safe.
	ReadOnly bool
	// ConcurrencySafe indicates the tool can be called concurrently.
	// Zero value (false) = assume not safe for concurrency = fail-safe.
	ConcurrencySafe bool
	// Activity classifies the tool's primary action.
	Activity ActivityKind
	// RequiredCapabilities lists system capabilities needed (e.g. "payment", "encryption").
	RequiredCapabilities []string
}

type ToolHandler func(ctx context.Context, params map[string]interface{}) (interface{}, error)