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"`
	// Notes carries the provisioner's client-specific post-link guidance
	// (provisioner.PostLinkNoter); absent for clients without caveats.
	Notes []string `json:"notes,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"`
	Discovery string `json:"discovery,omitempty"`
}

type MCPServerSourceStatus struct {
	Type     string `json:"type"`
	URL      string `json:"url,omitempty"`
	Ref      string `json:"ref,omitempty"`
	Package  string `json:"package,omitempty"`
	Version  string `json:"version,omitempty"`
	Commit   string `json:"commit,omitempty"`
	Artifact string `json:"artifact,omitempty"`
}

type MCPServerStatus struct {
	Execution             *execution.Report              `json:"execution,omitempty"`
	Name                  string                         `json:"name"`
	Transport             string                         `json:"transport"`
	Endpoint              string                         `json:"endpoint"`
	ContainerID           string                         `json:"containerId,omitempty"`
	Initialized           bool                           `json:"initialized"`
	ToolCount             int                            `json:"toolCount"`
	Tools                 []string                       `json:"tools"`
	PromptCount           int                            `json:"promptCount"`
	MCPResourceCount      int                            `json:"mcpResourceCount"`
	ResourceTemplateCount int                            `json:"resourceTemplateCount"`
	Capabilities          mcp.DownstreamCapabilityStatus `json:"capabilities"`
	ResourceCollisions    int                            `json:"resourceCollisions"`
	ResourceListError     string                         `json:"resourceListError,omitempty"`
	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"`

	// Description is the operator note from the stack. Empty when unset.
	// Headers are not projected here.
	Description string `json:"description,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"`

	Kind   string                 `json:"kind,omitempty"`
	Image  string                 `json:"image,omitempty"`
	Source *MCPServerSourceStatus `json:"source,omitempty"`

	// StderrTail is the last server-stderr lines from the log ring for an
	// unhealthy server. Healthy servers omit it. Lines have already passed
	// through the gateway logger, including redaction.
	StderrTail []string `json:"stderrTail,omitempty"`

	// Enabled is false for a server that is declared but not registered.
	// Omitted on registered servers so existing payloads stay unchanged.
	Enabled *bool `json:"enabled,omitempty"`

	// Overrides lists field names applied from the active override file.
	Overrides []string `json:"overrides,omitempty"`

	// SubscriptionStream is the downstream subscriptions/listen state:
	// "open", "closed", or "unsupported". Omitted for servers that do not
	// use that stream.
	SubscriptionStream string `json:"subscriptionStream,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"`
	// SupportingFilesInstalled distinguishes a complete package that ships no
	// managed files from a legacy import that may have omitted them.
	SupportingFilesInstalled bool `json:"supportingFilesInstalled"`
}

type SkillSourceStatus struct {
	Name           string             `json:"name"`
	Repo           string             `json:"repo"`
	Kind           string             `json:"kind"`
	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"`
	// PackMember is the pack name when this source was imported as a named
	// external source of that pack. Empty for every other source.
	PackMember string `json:"packMember,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"`
}