endpoints

type AdminClearCacheResponse struct {
	Body struct {
		Success bool   `json:"success" doc:"Whether cache clear succeeded"`
		Message string `json:"message" maxLength:"500" doc:"Result message"`
	}
}

type AdminInfoResponse struct {
	Body struct {
		Version   string `json:"version" maxLength:"50" doc:"Server version"`
		Uptime    string `json:"uptime" maxLength:"50" doc:"Server uptime"`
		StartTime string `json:"startTime" maxLength:"50" doc:"Server start time"`
		Providers int    `json:"providers" doc:"Number of registered providers"`
	}
}

type AdminReloadRequest struct {
	Body struct{} // empty body
}

type AdminReloadResponse struct {
	Body struct {
		Success bool   `json:"success" doc:"Whether reload succeeded"`
		Message string `json:"message" maxLength:"500" doc:"Result message"`
	}
}

type CELEvalRequest struct {
	Body struct {
		Expression string         `json:"expression" maxLength:"10000" doc:"CEL expression to evaluate"`
		Data       map[string]any `json:"data,omitempty" doc:"Data context for expression evaluation"`
	}
}

type CELEvalResponse struct {
	Body struct {
		Result any    `json:"result" doc:"Evaluation result"`
		Type   string `json:"type,omitempty" maxLength:"100" doc:"Result type"`
	}
}

type CatalogDetailResponse struct {
	Body struct {
		Name     string            `json:"name" maxLength:"255" doc:"Catalog name"`
		Type     string            `json:"type" maxLength:"50" doc:"Catalog type"`
		Path     string            `json:"path,omitempty" maxLength:"4096" doc:"Catalog path"`
		URL      string            `json:"url,omitempty" maxLength:"2048" doc:"Catalog URL"`
		Metadata map[string]string `json:"metadata,omitempty" doc:"Additional metadata"`
	}
}

type CatalogListItem struct {
	Name string `json:"name" maxLength:"255" doc:"Catalog name"`
	Type string `json:"type" maxLength:"50" doc:"Catalog type"`
	Path string `json:"path,omitempty" maxLength:"4096" doc:"Catalog path"`
	URL  string `json:"url,omitempty" maxLength:"2048" doc:"Catalog URL"`
}

type CatalogListResponse struct {
	Body struct {
		Items      []CatalogListItem  `json:"items" doc:"List of catalogs"`
		Pagination api.PaginationInfo `json:"pagination" doc:"Pagination metadata"`
	}
}

type CatalogSolutionItem struct {
	Name    string `json:"name" maxLength:"255" doc:"Solution name"`
	Version string `json:"version,omitempty" maxLength:"50" doc:"Solution version"`
	Digest  string `json:"digest,omitempty" maxLength:"255" doc:"Content digest"`
	Catalog string `json:"catalog,omitempty" maxLength:"255" doc:"Source catalog name"`
}

type CatalogSolutionListResponse struct {
	Body struct {
		Items      []CatalogSolutionItem `json:"items" doc:"List of solutions"`
		Pagination api.PaginationInfo    `json:"pagination" doc:"Pagination metadata"`
	}
}

type CatalogSyncResponse struct {
	Body struct {
		Success  bool   `json:"success" doc:"Whether sync succeeded"`
		Message  string `json:"message" maxLength:"500" doc:"Result message"`
		Catalogs int    `json:"catalogs" doc:"Number of catalogs synced"`
	}
}

type ConfigResponse struct {
	Body struct {
		Settings   any `json:"settings,omitempty" doc:"Application settings"`
		Catalogs   any `json:"catalogs,omitempty" doc:"Catalog configurations"`
		Logging    any `json:"logging,omitempty" doc:"Logging configuration"`
		Telemetry  any `json:"telemetry,omitempty" doc:"Telemetry configuration"`
		HTTPClient any `json:"httpClient,omitempty" doc:"HTTP client configuration"`
		CEL        any `json:"cel,omitempty" doc:"CEL configuration"`
		GoTemplate any `json:"goTemplate,omitempty" doc:"Go template configuration"`
		APIServer  any `json:"apiServer,omitempty" doc:"API server configuration"`
	}
}

type DiffChange struct {
	Field    string `json:"field" maxLength:"500" doc:"Changed field path"`
	Type     string `json:"type" maxLength:"20" doc:"Change type (added, removed, changed)"`
	OldValue any    `json:"oldValue,omitempty" doc:"Original value"`
	NewValue any    `json:"newValue,omitempty" doc:"New value"`
}

type DiffRequest struct {
	Body struct {
		SolutionA string `json:"solutionA" maxLength:"100000" doc:"First solution YAML"`
		SolutionB string `json:"solutionB" maxLength:"100000" doc:"Second solution YAML"`
	}
}

type DiffResponse struct {
	Body struct {
		Changes []DiffChange `json:"changes" doc:"List of changes"`
		Summary struct {
			Total   int `json:"total" doc:"Total changes"`
			Added   int `json:"added" doc:"Fields added"`
			Removed int `json:"removed" doc:"Fields removed"`
			Changed int `json:"changed" doc:"Fields changed"`
		} `json:"summary" doc:"Change summary"`
	}
}

type ExplainRequest struct {
	Body struct {
		Solution string `json:"solution" maxLength:"100000" doc:"Solution YAML content"`
	}
}

type ExplainResponse struct {
	Body struct {
		Name          string   `json:"name" maxLength:"255" doc:"Solution name"`
		Description   string   `json:"description,omitempty" maxLength:"2000" doc:"Solution description"`
		ResolverCount int      `json:"resolverCount" doc:"Number of resolvers"`
		HasWorkflow   bool     `json:"hasWorkflow" doc:"Whether the solution has a workflow"`
		HasActions    bool     `json:"hasActions" doc:"Whether the solution has actions"`
		Resolvers     []string `json:"resolvers,omitempty" maxItems:"500" doc:"Resolver names"`
		Tags          []string `json:"tags,omitempty" maxItems:"50" doc:"Solution tags"`
	}
}

type ProviderDetailResponse struct {
	Body struct {
		Name          string   `json:"name" maxLength:"255" example:"http" doc:"Provider name"`
		Version       string   `json:"version,omitempty" maxLength:"50" doc:"Provider version"`
		Capabilities  []string `json:"capabilities,omitempty" maxItems:"10" doc:"Provider capabilities"`
		Category      string   `json:"category,omitempty" maxLength:"50" doc:"Provider category"`
		Description   string   `json:"description,omitempty" maxLength:"1000" doc:"Provider description"`
		InputSchema   any      `json:"inputSchema,omitempty" doc:"Input JSON schema"`
		OutputSchemas any      `json:"outputSchemas,omitempty" doc:"Output schemas by operation"`
	}
}

type ProviderListItem struct {
	Name         string   `json:"name" maxLength:"255" example:"http" doc:"Provider name"`
	Version      string   `json:"version,omitempty" maxLength:"50" example:"1.0.0" doc:"Provider version"`
	Capabilities []string `json:"capabilities,omitempty" maxItems:"10" doc:"Provider capabilities"`
	Category     string   `json:"category,omitempty" maxLength:"50" doc:"Provider category"`
	Description  string   `json:"description,omitempty" maxLength:"1000" doc:"Provider description"`
}

type ProviderListResponse struct {
	Body struct {
		Items      []ProviderListItem `json:"items" doc:"List of providers"`
		Pagination api.PaginationInfo `json:"pagination" doc:"Pagination metadata"`
	}
}

type ProviderSchemaResponse struct {
	Body struct {
		Name       string `json:"name" maxLength:"255" doc:"Provider name"`
		SchemaData any    `json:"schema" doc:"JSON Schema"`
	}
}

type SchemaDetailResponse struct {
	Body struct {
		Name       string `json:"name" maxLength:"255" doc:"Schema name"`
		SchemaData any    `json:"schema" doc:"JSON Schema"`
	}
}

type SchemaListItem struct {
	Name string `json:"name" maxLength:"255" doc:"Schema name"`
}

type SchemaListResponse struct {
	Body struct {
		Items      []SchemaListItem   `json:"items" doc:"List of schemas"`
		Pagination api.PaginationInfo `json:"pagination" doc:"Pagination metadata"`
	}
}

type SchemaValidateRequest struct {
	Body struct {
		Schema string `json:"schema,omitempty" maxLength:"255" doc:"Schema name (currently only 'solution' supported)" example:"solution"`
		Data   any    `json:"data" doc:"Data to validate against the schema"`
	}
}

type SchemaValidateResponse struct {
	Body struct {
		Valid      bool              `json:"valid" doc:"Whether the data is valid"`
		Violations []SchemaViolation `json:"violations,omitempty" doc:"List of violations"`
	}
}

type SchemaViolation struct {
	Path    string `json:"path" maxLength:"500" doc:"JSON path of the violation"`
	Message string `json:"message" maxLength:"2000" doc:"Violation message"`
}

type SettingsResponse struct {
	Body struct {
		DefaultCatalog string `json:"defaultCatalog,omitempty" maxLength:"255" doc:"Default catalog name"`
		NoColor        bool   `json:"noColor" doc:"Color output disabled"`
		Quiet          bool   `json:"quiet" doc:"Quiet mode enabled"`
	}
}

type SnapshotListItem struct {
	ID        string `json:"id" maxLength:"255" doc:"Snapshot identifier"`
	Solution  string `json:"solution,omitempty" maxLength:"255" doc:"Source solution name"`
	CreatedAt string `json:"createdAt,omitempty" maxLength:"50" doc:"Creation timestamp"`
}

type SnapshotListResponse struct {
	Body struct {
		Items      []SnapshotListItem `json:"items" doc:"List of snapshots"`
		Pagination api.PaginationInfo `json:"pagination" doc:"Pagination metadata"`
	}
}

type SolutionDryRunRequest struct {
	Body struct {
		Path    string `json:"path" minLength:"1" maxLength:"4096" doc:"Path or URL to the solution file" example:"./solution.yaml"`
		Verbose bool   `json:"verbose,omitempty" doc:"Include materialised inputs in the report"`
	}
}

type SolutionDryRunResponse struct {
	Body *dryrun.Report
}

type SolutionInspectRequest struct {
	Body struct {
		Path string `json:"path" minLength:"1" maxLength:"4096" doc:"Path or URL to the solution file" example:"./solution.yaml"`
	}
}

type SolutionInspectResponse struct {
	Body *inspect.SolutionExplanation
}

type SolutionLintRequest struct {
	Body struct {
		Path string `json:"path" minLength:"1" maxLength:"4096" doc:"Path or URL to the solution file" example:"./solution.yaml"`
	}
}

type SolutionLintResponse struct {
	Body *lint.Result
}

type SolutionRenderRequest struct {
	Body struct {
		Path   string         `json:"path" minLength:"1" maxLength:"4096" doc:"Path or URL to the solution file" example:"./solution.yaml"`
		Params map[string]any `json:"params,omitempty" doc:"Parameters to pass to the solution"`
	}
}

type SolutionRenderResponse struct {
	Body struct {
		ResolverData map[string]any `json:"resolverData" doc:"Resolved values from resolvers"`
		Validation   any            `json:"validation,omitempty" doc:"Solution validation result"`
	}
}

type SolutionRunRequest struct {
	Body struct {
		Path      string         `json:"path" minLength:"1" maxLength:"4096" doc:"Path or URL to the solution file" example:"./solution.yaml"`
		Params    map[string]any `json:"params,omitempty" doc:"Parameters to pass to the solution"`
		OutputDir string         `json:"outputDir,omitempty" maxLength:"4096" doc:"Target directory for action output"`
	}
}

type SolutionRunResponse struct {
	Body struct {
		ResolverData map[string]any `json:"resolverData" doc:"Resolved values from resolvers"`
		ActionResult any            `json:"actionResult,omitempty" doc:"Action execution result"`
	}
}

type SolutionTestRequest struct {
	Body struct {
		Path    string `json:"path" minLength:"1" maxLength:"4096" doc:"Path or URL to the solution file" example:"./solution.yaml"`
		DryRun  bool   `json:"dryRun,omitempty" doc:"Validate tests without executing commands"`
		Verbose bool   `json:"verbose,omitempty" doc:"Include extra output"`
	}
}

type SolutionTestResponse struct {
	Body struct {
		Validation *execute.SolutionValidationResult `json:"validation" doc:"Solution validation result"`
	}
}

type TemplateEvalRequest struct {
	Body struct {
		Template string         `json:"template" maxLength:"100000" doc:"Go template content"`
		Data     map[string]any `json:"data,omitempty" doc:"Data context for template rendering"`
		Name     string         `json:"name,omitempty" maxLength:"255" doc:"Template name" example:"my-template"`
	}
}

type TemplateEvalResponse struct {
	Body struct {
		Output string `json:"output" doc:"Rendered template output"`
	}
}