api

type APIError struct {
	Status  int
	Message string
	Data    json.RawMessage
}

type Client struct {
	BaseURL string
	HTTP    *http.Client
	APIKey  string // x-api-key (the aq_sk_… token from `aq login`)
	TeamID  string // x-team-id (required by team-scoped routes like /deployments)
}

type CloseResult struct {
	Status string `json:"status"`
}

type CreateSnapshotRequest struct {
	BackupID         string `json:"backup_id"`
	WorkspaceDir     string `json:"workspace_dir"`
	IncludeProcess   bool   `json:"include_process"`
	IncludeWorkspace bool   `json:"include_workspace"`
}

type CreateSnapshotResult struct {
	SnapshotID string `json:"snapshot_id"`
	Size       int64  `json:"size"`
	Message    string `json:"message"`
}

type DeployRequest struct {
	// SnapshotSource is a numeric deployment id or a synthetic `ext-<backupId>`
	// for a standalone-CLI snapshot (#177).
	SnapshotSource string  `json:"snapshotSource"`
	SSHKeyID       string  `json:"sshKeyId"`
	Template       string  `json:"template,omitempty"`
	GPUModel       string  `json:"gpuModel,omitempty"`
	MaxPrice       float64 `json:"maxPrice,omitempty"`
	Provider       string  `json:"provider,omitempty"`
	// Name sets the deployment's display name; empty → orchestrator-generated.
	// A stable `ticket-<N>-<label>` makes the throwaway box reapable (#310).
	Name string `json:"name,omitempty"`
}

type Deployment struct {
	ID                 int                 `json:"id"`
	Name               string              `json:"name"`
	Status             string              `json:"status"`
	AppURL             string              `json:"app_url"`
	ServiceCredentials *ServiceCredentials `json:"service_credentials"`
	// ServiceURLs stays raw so a malformed or unexpectedly-shaped value (the
	// column is a free-form Json defaulting to "[]") can never fail the whole
	// row's decode. SSHServiceURL parses it on demand.
	ServiceURLs json.RawMessage `json:"service_urls"`
	// RestoreStatus/RestoreError carry the server-side snapshot restore outcome
	// for `aq deploy` (#235): SUCCESS / PARTIAL / FAILED, plus a detail string.
	// Empty for a plain `aq up` (no restore) or a backend that predates the field.
	RestoreStatus string `json:"restore_status"`
	RestoreError  string `json:"restore_error"`
}

type DeploymentStatusResult struct {
	DeploymentID int        `json:"deploymentId"`
	Status       string     `json:"status"`
	Deployment   Deployment `json:"deployment"`
}

type DevicePoll struct {
	Status string `json:"status"` // pending | approved | denied | expired | consumed | slow_down
	// Interval, when > 0, is the cadence (seconds) the server wants the CLI to
	// poll at from now on (RFC 8628 §3.5). The CLI only ever slows down to it.
	Interval int      `json:"interval"`
	Token    string   `json:"token"`
	Scopes   []string `json:"scopes"`
	TeamID   string   `json:"teamId"`
	KeyName  string   `json:"keyName"`
}

type DeviceStart struct {
	DeviceCode              string   `json:"deviceCode"`
	UserCode                string   `json:"userCode"`
	Scopes                  []string `json:"scopes"`
	VerificationURI         string   `json:"verificationUri"`
	VerificationURIComplete string   `json:"verificationUriComplete"`
	Interval                int      `json:"interval"`
	ExpiresIn               int      `json:"expiresIn"`
}

type IdlePolicy struct {
	WarnAfterMinutes        int  `json:"warnAfterMinutes"`
	ActAfterMinutes         int  `json:"actAfterMinutes"`
	GPUIdleThresholdPercent int  `json:"gpuIdleThresholdPercent"`
	AutoStopEnabled         bool `json:"autoStopEnabled"`
	// State is one of UNKNOWN | ACTIVE | IDLE_WARN | IDLE_ACT. UNKNOWN means the
	// box has reported no usable usage data yet — render it as unknown, never as
	// active or idle: presenting a no-data verdict as either extreme is a lie the
	// user could act on.
	State string `json:"state"`
	// IdleMinutes is only meaningful once State is IDLE_WARN or IDLE_ACT.
	IdleMinutes int `json:"idleMinutes"`
}

type IdlePolicyUpdate struct {
	WarnAfterMinutes        *int  `json:"warnAfterMinutes,omitempty"`
	ActAfterMinutes         *int  `json:"actAfterMinutes,omitempty"`
	GPUIdleThresholdPercent *int  `json:"gpuIdleThresholdPercent,omitempty"`
	AutoStopEnabled         *bool `json:"autoStopEnabled,omitempty"`
}

type SSHKey struct {
	ID        string `json:"id"`
	Name      string `json:"name"`
	PublicKey string `json:"public_key"`
}

type ServiceCredentials struct {
	Template string `json:"template"`
	URL      string `json:"url"`
	Username string `json:"username"`
	Password string `json:"password"`
	Status   string `json:"status"`
}

type ServiceURL struct {
	URL  string `json:"url"`
	Port portID `json:"port"`
}

type SnapshotHistoryBackup struct {
	DeploymentID int    `json:"deployment_id"`
	Path         string `json:"path"`
}

type SnapshotHistoryItem struct {
	ID        int                    `json:"id"`
	BackupID  int                    `json:"backup_id"`
	Path      string                 `json:"path"`
	Status    string                 `json:"status"`
	Size      int64                  `json:"size"`
	Type      string                 `json:"type"`
	CreatedAt string                 `json:"created_at"`
	Backups   *SnapshotHistoryBackup `json:"backups"`
}

type UpRequest struct {
	Template string  `json:"template"`
	SSHKeyID string  `json:"sshKeyId"`
	GPUModel string  `json:"gpuModel,omitempty"`
	MaxPrice float64 `json:"maxPrice,omitempty"`
	Provider string  `json:"provider,omitempty"`
	// Name sets the deployment's display name. When empty the orchestrator
	// falls back to a generated "<Adjective> <GPU> from <Region>" name. Passing
	// a stable `ticket-<N>-<label>` here lets the session-scoped reaper attribute
	// and clean up a throwaway box that would otherwise bill as an orphan (#310).
	Name string `json:"name,omitempty"`
	// IdlePolicy opts a fresh deployment into idle-auto-stop at creation time.
	// Nil (the Go zero value for a pointer) omits the key entirely — the console
	// shows a visible, pre-checked box a user can see and untick, but the CLI has
	// no such surface, so silence here must mean "no opinion, use the
	// orchestrator's defaults," never "explicitly off."
	IdlePolicy *IdlePolicyUpdate `json:"idlePolicy,omitempty"`
}

type UpResult struct {
	DeploymentID int    `json:"deploymentId"`
	ProjectID    string `json:"projectId"`
	Status       string `json:"status"`
	Message      string `json:"message"`
}