api

type AgentPreview struct {
	Name        string                   `json:"name"`
	Description string                   `json:"description"`
	Body        string                   `json:"body"`
	Valid       bool                     `json:"valid"`
	Errors      []string                 `json:"errors,omitempty"`
	Findings    []skills.SecurityFinding `json:"findings,omitempty"`
	Exists      bool                     `json:"exists"`
}

type AuthRequest struct {
	Method        string `json:"method,omitempty"`        // "token" | "ssh-agent" | "ssh-key" | ""
	Token         string `json:"token,omitempty"`         // ephemeral plaintext
	CredentialRef string `json:"credentialRef,omitempty"` // e.g. "${vault:GIT_TOKEN}"
	SSHUser       string `json:"sshUser,omitempty"`
	SSHKeyPath    string `json:"sshKeyPath,omitempty"`
}

type ClientStatus struct {
	Name       string `json:"name"`
	Slug       string `json:"slug"`
	Detected   bool   `json:"detected"`
	Linked     bool   `json:"linked"`
	Transport  string `json:"transport"`
	ConfigPath string `json:"configPath,omitempty"`
	// EffectiveScope is the backend-computed per-client tool access scope when a
	// `clients:` block is configured: the servers and prefixed tools this client
	// can reach. nil when no access scoping is in effect, so the frontend can
	// distinguish "unscoped (legacy)" from "scoped to nothing".
	EffectiveScope *mcp.ClientScopeResult `json:"effectiveScope,omitempty"`
	// Declared reports whether the stack's link: block lists this client;
	// LinkEntry carries the declared options when it does. Desired state,
	// distinct from Linked (actual config-file state).
	Declared  bool           `json:"declared,omitempty"`
	LinkEntry *LinkEntryInfo `json:"linkEntry,omitempty"`
	// Drifted reports that a recorded gridctl entry in this client's
	// config was edited since gridctl wrote it (wiring ownership).
	Drifted bool `json:"drifted,omitempty"`
}

type FeatureStatus struct {
	Name        string `json:"name"`
	Stage       string `json:"stage"`
	Description string `json:"description"`
}

type LinkEntryInfo struct {
	Group    string `json:"group,omitempty"`
	ClientID string `json:"clientId,omitempty"`
	Name     string `json:"name,omitempty"`
}

type MCPServerStatus struct {
	Name          string   `json:"name"`
	Transport     string   `json:"transport"`
	Endpoint      string   `json:"endpoint"`
	Initialized   bool     `json:"initialized"`
	ToolCount     int      `json:"toolCount"`
	Tools         []string `json:"tools"`
	External      bool     `json:"external"`
	LocalProcess  bool     `json:"localProcess"`
	SSH           bool     `json:"ssh"`
	SSHHost       string   `json:"sshHost,omitempty"`
	OpenAPI       bool     `json:"openapi"`
	OpenAPISpec   string   `json:"openapiSpec,omitempty"`
	OutputFormat  string   `json:"outputFormat,omitempty"`
	Healthy       *bool    `json:"healthy,omitempty"`
	LastCheck     *string  `json:"lastCheck,omitempty"`
	HealthError   string   `json:"healthError,omitempty"`
	ToolWhitelist []string `json:"toolWhitelist,omitempty"`
	// ProtocolVersion is the MCP protocol version the downstream server
	// reported at initialize; empty for lax servers and OpenAPI adapters.
	ProtocolVersion string `json:"protocolVersion,omitempty"`
	// ProtocolGeneration is the resolved protocol era ("handshake" or
	// "stateless"); empty for OpenAPI adapters and unresolved servers.
	ProtocolGeneration string `json:"protocolGeneration,omitempty"`
	// RegistrationFailed marks a server that never registered with the
	// gateway; the UI shows it as failed instead of omitting the node.
	RegistrationFailed bool `json:"registrationFailed,omitempty"`

	Replicas  []mcp.ReplicaStatus  `json:"replicas,omitempty"`
	Autoscale *mcp.AutoscaleStatus `json:"autoscale,omitempty"`

	// AuthStatus reports downstream authorization state ("authorized" or
	// "needs_auth"); empty for servers without tracked auth state.
	AuthStatus string     `json:"authStatus,omitempty"`
	AuthIssuer string     `json:"authIssuer,omitempty"`
	AuthExpiry *time.Time `json:"authExpiry,omitempty"`
}

type ResourceStatus struct {
	Name   string `json:"name"`
	Image  string `json:"image"`
	Status string `json:"status"`
}

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

type ServerInfo struct {
	Name      string `json:"name"`
	Version   string `json:"version"`
	Tokenizer string `json:"tokenizer,omitempty"`
}

type SkillDiffResponse struct {
	Skill       string `json:"skill"`
	Local       string `json:"local"`
	Upstream    string `json:"upstream"`
	UnifiedDiff string `json:"unifiedDiff,omitempty"`
	Drifted     bool   `json:"drifted"`
}

type SkillPreview struct {
	Name        string                   `json:"name"`
	Description string                   `json:"description"`
	Body        string                   `json:"body"`
	Valid       bool                     `json:"valid"`
	Errors      []string                 `json:"errors,omitempty"`
	Warnings    []string                 `json:"warnings,omitempty"`
	Findings    []skills.SecurityFinding `json:"findings,omitempty"`
	Exists      bool                     `json:"exists"`
}

type SkillSourceEntry struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	State       string `json:"state"`
	IsRemote    bool   `json:"isRemote"`
	ContentHash string `json:"contentHash,omitempty"`
	// HasLocalEdits is true when the on-disk SKILL.md diverges from the hash
	// snapshotted at the last import/sync (i.e. the user edited it locally).
	HasLocalEdits bool `json:"hasLocalEdits"`
}

type SkillSourceStatus struct {
	Name           string             `json:"name"`
	Repo           string             `json:"repo"`
	Ref            string             `json:"ref,omitempty"`
	Path           string             `json:"path,omitempty"`
	AutoUpdate     bool               `json:"autoUpdate"`
	UpdateInterval string             `json:"updateInterval"`
	Skills         []SkillSourceEntry `json:"skills"`
	LastFetched    string             `json:"lastFetched,omitempty"`
	CommitSHA      string             `json:"commitSha,omitempty"`
	UpdateAvail    bool               `json:"updateAvailable"`
	// DriftedSkills lists the skills in this source whose on-disk SKILL.md has
	// local edits (drift) that a sync would otherwise overwrite.
	DriftedSkills []string `json:"driftedSkills,omitempty"`
}

type SkillSyncResult struct {
	Skill    string `json:"skill"`
	Imported int    `json:"imported,omitempty"`
	// ImportedAgents counts agent definitions the same update refreshed
	// (Update re-imports the whole source, so agents ride along).
	ImportedAgents int      `json:"importedAgents,omitempty"`
	Warnings       []string `json:"warnings,omitempty"`
	Error          string   `json:"error,omitempty"`
	// Skipped, when set, is the reason a drifted skill was left untouched
	// (e.g. "local edits"). Its tracking metadata is still advanced.
	Skipped string `json:"skipped,omitempty"`
	// Backup is the file name of the pre-overwrite SKILL.md backup written
	// when a drifted skill was force-overwritten.
	Backup string `json:"backup,omitempty"`
}

type SourceSyncResult struct {
	Name   string            `json:"name"`
	Repo   string            `json:"repo"`
	Pinned bool              `json:"pinned,omitempty"`
	Skills []SkillSyncResult `json:"skills,omitempty"`
	Error  string            `json:"error,omitempty"`
}

type SourceSyncSummary struct {
	Sources       []SourceSyncResult `json:"sources"`
	SyncedSources int                `json:"syncedSources"`
	UpdatedSkills int                `json:"updatedSkills"`
	SkippedSkills int                `json:"skippedSkills"`
	FailedSources int                `json:"failedSources"`
	PinnedSources int                `json:"pinnedSources"`
}

type SourceUpdateSummary struct {
	Name      string `json:"name"`
	Repo      string `json:"repo"`
	Current   string `json:"currentSha"`
	Latest    string `json:"latestSha,omitempty"`
	HasUpdate bool   `json:"hasUpdate"`
	Error     string `json:"error,omitempty"`
}

type StackRecipe struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description"`
	Category    string `json:"category"`
	Spec        string `json:"spec"`
}

type UpdateSummary struct {
	Available int                   `json:"available"`
	Sources   []SourceUpdateSummary `json:"sources"`
}

type WizardDraft struct {
	ID           string                 `json:"id"`
	Name         string                 `json:"name"`
	ResourceType string                 `json:"resourceType"`
	FormData     map[string]interface{} `json:"formData"`
	CreatedAt    string                 `json:"createdAt"`
	UpdatedAt    string                 `json:"updatedAt"`
}