app

type Application struct {
	PromptManager   prompt.ManagerInterface
	ToolManager     tool.ManagerInterface
	ResourceManager resource.ManagerInterface
	ServiceRegistry serviceregistry.ServiceRegistryInterface
	TopologyManager *topology.Manager
	UpstreamFactory factory.Factory

	Storage         storage.Storage
	TemplateManager *TemplateManager

	// SkillManager manages agent skills
	SkillManager *skill.Manager

	// AlertsManager manages system alerts
	AlertsManager *alerts.Manager

	// DiscoveryManager manages auto-discovery providers
	DiscoveryManager *discovery.Manager

	// CatalogManager manages dynamic service catalog
	CatalogManager *catalog.Manager

	// Settings Manager for global settings (dynamic updates)
	SettingsManager *GlobalSettingsManager
	// Profile Manager for dynamic profile updates
	ProfileManager *profile.Manager
	// Auth Manager (stored here for access in runServerMode, though it is also passed to serviceregistry)
	// We need to keep a reference to update it on reload.
	AuthManager *auth.Manager

	// BoundHTTPPort stores the actual port the HTTP server is listening on.
	BoundHTTPPort atomic.Int32
	// BoundGRPCPort stores the actual port the gRPC server is listening on.
	BoundGRPCPort atomic.Int32

	// RegistrationRetryDelay allows configuring the retry delay for service registration.
	// If 0, it defaults to 5 seconds (in the worker).
	RegistrationRetryDelay time.Duration

	// MetricsGatherer is the interface for gathering metrics.
	// Defaults to prometheus.DefaultGatherer.
	MetricsGatherer prometheus.Gatherer
	// contains filtered or unexported fields
}

type AuthTestRequest struct {
	CredentialID  string         `json:"credential_id"`
	ServiceType   string         `json:"service_type"`
	ServiceConfig map[string]any `json:"service_config"`
}

type AuthTestResponse struct {
	Success bool   `json:"success"`
	Message string `json:"message"`
}

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

type LoginRequest struct {
	Username string `json:"username"`
	Password string `json:"password"`
}

type LoginResponse struct {
	Token string `json:"token"`
}

type Metric struct {
	// Label is the primary text description of the metric (e.g., "Total Requests").
	Label string `json:"label"`
	// Value is the current value of the metric to display (e.g., "1,234").
	Value string `json:"value"`
	// Change represents the change from a previous period (e.g., "+10%").
	Change string `json:"change"`
	// Trend indicates the direction of the change ("up", "down", or "neutral").
	Trend string `json:"trend"` // "up" | "down" | "neutral"
	// Icon is the name of the icon to display with the metric (e.g., "Activity").
	Icon string `json:"icon"`
	// SubLabel provides additional context or subtitle for the metric (e.g., "Since startup").
	SubLabel string `json:"subLabel"`
}

type RunOptions struct {
	Ctx             context.Context
	Fs              afero.Fs
	Stdio           bool
	JSONRPCPort     string
	GRPCPort        string
	ConfigPaths     []string
	APIKey          string
	ShutdownTimeout time.Duration
	TLSCert         string
	TLSKey          string
	TLSClientCA     string
	DBPath          string
}

type Runner interface {
	// Run starts the application with the given options.
	//
	// Summary: Starts the application.
	//
	// Parameters:
	//   - opts: RunOptions. The configuration for running.
	//
	// Returns:
	//   - error: An error if startup or execution fails.
	Run(opts RunOptions) error

	// ReloadConfig reloads the application configuration.
	//
	// Summary: Triggers a configuration reload.
	//
	// Parameters:
	//   - ctx: context.Context. The context for the operation.
	//   - fs: afero.Fs. The filesystem.
	//   - configPaths: []string. Paths to configuration files.
	//
	// Returns:
	//   - error: An error if reload fails.
	ReloadConfig(ctx context.Context, fs afero.Fs, configPaths []string) error
}

type ServiceHealth struct {
	ID      string `json:"id"`
	Name    string `json:"name"`
	Status  string `json:"status"`
	Latency string `json:"latency"`
	Uptime  string `json:"uptime"`
	Message string `json:"message,omitempty"`
}

type ServiceHealthResponse struct {
	Services []ServiceHealth                  `json:"services"`
	History  map[string][]health.HistoryPoint `json:"history"`
}

type SkillServiceServer struct {
	pb.UnimplementedSkillServiceServer
	// contains filtered or unexported fields
}

type Span struct {
	ID           string         `json:"id"`
	Name         string         `json:"name"`
	Type         string         `json:"type"`
	StartTime    int64          `json:"startTime"` // Unix millis
	EndTime      int64          `json:"endTime"`   // Unix millis
	Status       string         `json:"status"`    // success, error, pending
	Input        map[string]any `json:"input,omitempty"`
	Output       map[string]any `json:"output,omitempty"`
	ErrorMessage string         `json:"errorMessage,omitempty"`
}

type SystemStatusResponse struct {
	UptimeSeconds     int64    `json:"uptime_seconds"`
	ActiveConnections int32    `json:"active_connections"`
	BoundHTTPPort     int      `json:"bound_http_port"`
	BoundGRPCPort     int      `json:"bound_grpc_port"`
	Version           string   `json:"version"`
	SecurityWarnings  []string `json:"security_warnings"`
}

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

type TestAuthRequest struct {
	// The credential to use (can be a reference ID or inline Credential).
	CredentialID string `json:"credential_id"`
	// OR inline authentication config
	Authentication *configv1.Authentication `json:"authentication"`
	// OR inline user token (for ad-hoc testing)
	UserToken *configv1.UserToken `json:"user_token"`

	// The URL to test against.
	TargetURL string `json:"target_url"`
	// HTTP Method (GET, POST, etc.)
	Method string `json:"method"`
}

type TestAuthResponse struct {
	Status     int               `json:"status"`
	StatusText string            `json:"status_text"`
	Headers    map[string]string `json:"headers"`
	Body       string            `json:"body"`
	Error      string            `json:"error,omitempty"`
}

type ToolAnalytics struct {
	Name        string  `json:"name"`
	ServiceID   string  `json:"serviceId"`
	TotalCalls  int64   `json:"totalCalls"`
	SuccessRate float64 `json:"successRate"`
}

type ToolFailureStats struct {
	Name        string  `json:"name"`
	ServiceID   string  `json:"serviceId"`
	FailureRate float64 `json:"failureRate"` // Percentage 0-100
	TotalCalls  int64   `json:"totalCalls"`
}

type ToolUsageStats struct {
	Name      string `json:"name"`
	ServiceID string `json:"serviceId"`
	Count     int64  `json:"count"`
}

type Trace struct {
	ID            string `json:"id"`
	RootSpan      Span   `json:"rootSpan"`
	Timestamp     string `json:"timestamp"` // ISO 8601
	TotalDuration int64  `json:"totalDuration"`
	Status        string `json:"status"`
	Trigger       string `json:"trigger"`
}

type ValidateRequest struct {
	Content string `json:"content"`
	Format  string `json:"format"` // "json" or "yaml"
}

type ValidateResponse struct {
	Valid   bool   `json:"valid"`
	Error   string `json:"error,omitempty"`
	Message string `json:"message,omitempty"`
}