serverapi

type APIDocResponse struct {
	Library     string                     `json:"library"`
	Description string                     `json:"description"`
	Modules     map[string]types.ModuleDoc `json:"modules"`
}

type AuthLoginResponse struct {
	Enabled                 bool   `json:"enabled"`
	VerificationURI         string `json:"verification_uri,omitempty"`
	VerificationURIComplete string `json:"verification_uri_complete,omitempty"`
	UserCode                string `json:"user_code,omitempty"`
	ExpiresIn               int    `json:"expires_in,omitempty"`
	Interval                int    `json:"interval,omitempty"`
}

type AuthLoginState string

type AuthLoginStateResponse struct {
	State AuthLoginState `json:"state"`
	Error string         `json:"error,omitempty"`
}

type AuthStatusResponse struct {
	Enabled              bool       `json:"enabled"`
	Authenticated        bool       `json:"authenticated"`
	IssuerURL            string     `json:"issuer_url,omitempty"`
	ClientID             string     `json:"client_id,omitempty"`
	Resource             string     `json:"resource,omitempty"`
	ExpiresAt            *time.Time `json:"expires_at,omitempty"`
	Expired              bool       `json:"expired"`
	RefreshTokenPresent  bool       `json:"refresh_token_present"`
	RefreshTokenIssuedAt *time.Time `json:"refresh_token_issued_at,omitempty"`
	CredentialsPath      string     `json:"credentials_path,omitempty"`
}

type BuildStatusRequest struct {
	RunID int64 `json:"run_id"`
}

type BuildStatusResponse struct {
	RunID      int64  `json:"run_id"`
	Status     string `json:"status"`
	Conclusion string `json:"conclusion"`
	HTMLURL    string `json:"html_url"`
}

type BuildTriggerRequest struct {
	// Client is the client name (e.g. "geth", "lighthouse", "prysm").
	Client string `json:"client"`
	// Repository is the source repository override (optional).
	Repository string `json:"repository,omitempty"`
	// Ref is the branch, tag, or SHA to build from (optional).
	Ref string `json:"ref,omitempty"`
	// DockerTag is the target docker tag override (optional).
	DockerTag string `json:"docker_tag,omitempty"`
}

type BuildTriggerResponse struct {
	// WorkflowURL is the URL to the GitHub Actions workflow page.
	WorkflowURL string `json:"workflow_url"`
	// Client is the client that was built.
	Client string `json:"client"`
	// Workflow is the workflow filename that was triggered.
	Workflow string `json:"workflow"`
	// RunID is the GitHub Actions run ID (0 if not yet available).
	RunID int64 `json:"run_id,omitempty"`
	// RunURL is the direct URL to the specific workflow run.
	RunURL string `json:"run_url,omitempty"`
}

type CreateSessionResponse struct {
	SessionID    string `json:"session_id"`
	TTLRemaining string `json:"ttl_remaining,omitempty"`
}

type DatasourcesResponse struct {
	Datasources []types.DatasourceInfo `json:"datasources"`
}

type ExecuteRequest struct {
	Code      string `json:"code"`
	Timeout   int    `json:"timeout,omitempty"`
	SessionID string `json:"session_id,omitempty"`
}

type ExecuteResponse struct {
	Stdout              string                `json:"stdout,omitempty"`
	Stderr              string                `json:"stderr,omitempty"`
	ExitCode            int                   `json:"exit_code"`
	ExecutionID         string                `json:"execution_id"`
	OutputFiles         []string              `json:"output_files,omitempty"`
	Metrics             map[string]any        `json:"metrics,omitempty"`
	DurationSeconds     float64               `json:"duration_seconds"`
	SessionID           string                `json:"session_id,omitempty"`
	SessionFiles        []sandbox.SessionFile `json:"session_files,omitempty"`
	SessionTTLRemaining string                `json:"session_ttl_remaining,omitempty"`
}

type ListResourcesResponse struct {
	Resources []ResourceInfo         `json:"resources"`
	Templates []ResourceTemplateInfo `json:"templates,omitempty"`
}

type ListSessionsResponse struct {
	Sessions    []SessionResponse `json:"sessions"`
	Total       int               `json:"total"`
	MaxSessions int               `json:"max_sessions"`
}

type ProxyAuthMetadataResponse struct {
	Enabled   bool   `json:"enabled"`
	Mode      string `json:"mode,omitempty"`
	IssuerURL string `json:"issuer_url,omitempty"`
	ClientID  string `json:"client_id,omitempty"`
	Resource  string `json:"resource,omitempty"`
}

type ResourceInfo struct {
	URI         string `json:"uri"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	MIMEType    string `json:"mime_type,omitempty"`
}

type ResourceResponse struct {
	URI      string `json:"uri"`
	MIMEType string `json:"mime_type"`
	Content  string `json:"content"`
}

type ResourceTemplateInfo struct {
	URITemplate string `json:"uri_template"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	MIMEType    string `json:"mime_type,omitempty"`
}

type RuntimeStorageFile struct {
	Key          string `json:"key"`
	Size         int64  `json:"size"`
	LastModified string `json:"last_modified,omitempty"`
	URL          string `json:"url,omitempty"`
}

type RuntimeStorageListResponse struct {
	Files []RuntimeStorageFile `json:"files"`
}

type RuntimeStorageURLResponse struct {
	Key string `json:"key"`
	URL string `json:"url"`
}

type RuntimeStorageUploadResponse struct {
	Key  string `json:"key"`
	URL  string `json:"url"`
	Path string `json:"path,omitempty"`
}

type SearchConstantResult struct {
	Name            string  `json:"name"`
	Value           string  `json:"value"`
	Fork            string  `json:"fork"`
	SimilarityScore float64 `json:"similarity_score"`
}

type SearchEIPResult struct {
	Number          int     `json:"number"`
	Title           string  `json:"title"`
	Description     string  `json:"description"`
	Author          string  `json:"author,omitempty"`
	Status          string  `json:"status"`
	Type            string  `json:"type"`
	Category        string  `json:"category,omitempty"`
	Created         string  `json:"created,omitempty"`
	URL             string  `json:"url"`
	Ref             string  `json:"ref"`
	SimilarityScore float64 `json:"similarity_score"`
}

type SearchEIPsResponse struct {
	Type                string             `json:"type"`
	Query               string             `json:"query"`
	StatusFilter        string             `json:"status_filter,omitempty"`
	CategoryFilter      string             `json:"category_filter,omitempty"`
	TypeFilter          string             `json:"type_filter,omitempty"`
	TotalMatches        int                `json:"total_matches"`
	Results             []*SearchEIPResult `json:"results"`
	AvailableStatuses   []string           `json:"available_statuses"`
	AvailableCategories []string           `json:"available_categories"`
	AvailableTypes      []string           `json:"available_types"`
}

type SearchExampleResult struct {
	CategoryKey     string  `json:"category_key"`
	CategoryName    string  `json:"category_name"`
	ExampleName     string  `json:"example_name"`
	Description     string  `json:"description"`
	Query           string  `json:"query"`
	Target          string  `json:"target"`
	Dataset         string  `json:"dataset,omitempty"`
	SimilarityScore float64 `json:"similarity_score"`
}

type SearchExamplesResponse struct {
	Type                string                 `json:"type"`
	Query               string                 `json:"query"`
	CategoryFilter      string                 `json:"category_filter,omitempty"`
	DatasetFilter       string                 `json:"dataset_filter,omitempty"`
	TotalMatches        int                    `json:"total_matches"`
	Results             []*SearchExampleResult `json:"results"`
	AvailableCategories []string               `json:"available_categories"`
	Guidance            []string               `json:"guidance,omitempty"`
}

type SearchRunbookResult struct {
	Name            string   `json:"name"`
	Description     string   `json:"description"`
	Tags            []string `json:"tags"`
	Prerequisites   []string `json:"prerequisites"`
	Ref             string   `json:"ref"`
	FilePath        string   `json:"file_path"`
	SimilarityScore float64  `json:"similarity_score"`
}

type SearchRunbooksResponse struct {
	Type          string                 `json:"type"`
	Query         string                 `json:"query"`
	TagFilter     string                 `json:"tag_filter,omitempty"`
	TotalMatches  int                    `json:"total_matches"`
	Results       []*SearchRunbookResult `json:"results"`
	AvailableTags []string               `json:"available_tags"`
}

type SearchSpecResult struct {
	Fork            string  `json:"fork"`
	Topic           string  `json:"topic"`
	Title           string  `json:"title"`
	URL             string  `json:"url"`
	Ref             string  `json:"ref"`
	SimilarityScore float64 `json:"similarity_score"`
}

type SearchSpecsResponse struct {
	Type           string                  `json:"type"`
	Query          string                  `json:"query"`
	ForkFilter     string                  `json:"fork_filter,omitempty"`
	TotalMatches   int                     `json:"total_matches"`
	Specs          []*SearchSpecResult     `json:"specs"`
	Constants      []*SearchConstantResult `json:"constants,omitempty"`
	AvailableForks []string                `json:"available_forks"`
}

type SessionResponse struct {
	SessionID      string                `json:"session_id"`
	CreatedAt      time.Time             `json:"created_at"`
	LastUsed       time.Time             `json:"last_used"`
	TTLRemaining   string                `json:"ttl_remaining"`
	WorkspaceFiles []sandbox.SessionFile `json:"workspace_files,omitempty"`
}