api

type APIError struct {
	// Status is the HTTP status code.
	Status int
	// Code is the machine-readable code from the envelope ("" when absent).
	Code string
	// Message is human-readable; never empty.
	Message string
}

type APIKey struct {
	ID        string  `json:"id"`
	Name      string  `json:"name"`
	Start     *string `json:"start"`
	Prefix    *string `json:"prefix"`
	Key       string  `json:"key"`
	ExpiresAt *string `json:"expiresAt"`
}

type AdminListing struct {
	Listing
	Source string `json:"source"`
}

type AdminSoul struct {
	Soul
	Source string `json:"source"`
}

type Anonymous struct{}

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

type Credentials struct {
	// APIKey is sent as the x-api-key header.
	APIKey string
	// Bearer is sent as "Authorization: Bearer ..." when APIKey is empty.
	Bearer string
}

type CredentialsProvider interface {
	Get() (Credentials, error)
}

type EnvCredentials struct{}

type Listing struct {
	// ID is the stable, immutable id (ULID).
	ID string `json:"id"`
	// Slug is the human-facing url segment: /listings/[slug].
	Slug string `json:"slug"`
	// ProfileHandle/ProfileName denormalize the authoring profile for cards.
	ProfileHandle string `json:"profileHandle"`
	ProfileName   string `json:"profileName"`
	Name          string `json:"name"`
	// Type is one of ListingTypes.
	Type string `json:"type"`
	// Tagline is the short one-liner shown on cards.
	Tagline     string   `json:"tagline"`
	Description *string  `json:"description"`
	Category    string   `json:"category"`
	Tags        []string `json:"tags"`
	// Official is true when published by the owner's verified official account.
	Official bool `json:"official"`
	// SourceURL is the official source that was verified: repo, docs, or registry.
	SourceURL string  `json:"sourceUrl"`
	RepoURL   *string `json:"repoUrl"`
	// InstallCmd is the canonical official install/run command, if any.
	InstallCmd *string `json:"installCmd"`
	// Data holds type-specific extras (e.g. LoopData for loops); {} when none.
	Data          map[string]any `json:"data"`
	Confidence    string         `json:"confidence"`
	Status        string         `json:"status"`
	DownloadCount int            `json:"downloadCount"`
	CreatedAt     string         `json:"createdAt"`
	UpdatedAt     string         `json:"updatedAt"`
}

type LoopData struct {
	// Goal is what "done" looks like for the loop.
	Goal string `json:"goal,omitempty"`
	// CheckCommand is the command run between iterations to gauge progress.
	CheckCommand string `json:"checkCommand,omitempty"`
	// ExitCondition is the condition that ends the loop.
	ExitCondition string `json:"exitCondition,omitempty"`
	// MaxIterations is the safety cap on iterations.
	MaxIterations int `json:"maxIterations,omitempty"`
	// CompatibleTools lists agents/harnesses the loop is known to work with.
	CompatibleTools []string `json:"compatibleTools,omitempty"`
	// Kickoff is the prompt a user copies to start the loop.
	Kickoff string `json:"kickoff,omitempty"`
}

type Me struct {
	User    User `json:"user"`
	IsAdmin bool `json:"isAdmin"`
}

type Option func(*Client)

type Soul struct {
	SoulCard
	Content string `json:"content"`
}

type SoulCard struct {
	// ID is the stable, immutable id (ULID). Never changes, even if the slug does.
	ID string `json:"id"`
	// Slug is the human-facing url segment: /souls/[slug].
	Slug string `json:"slug"`
	// SlugHistory holds previous slugs; the server 301s them to the current slug.
	SlugHistory []string `json:"slugHistory"`
	Name        string   `json:"name"`
	// AuthorHandle is the author handle — the join key for user accounts.
	AuthorHandle string  `json:"authorHandle"`
	AuthorName   *string `json:"authorName"`
	AuthorURL    *string `json:"authorUrl"`
	// Tagline is the short one-liner shown on cards.
	Tagline     string   `json:"tagline"`
	Description *string  `json:"description"`
	Category    string   `json:"category"`
	Tags        []string `json:"tags"`
	Frameworks  []string `json:"frameworks"`
	Models      []string `json:"models"`
	// Version is semver.
	Version string `json:"version"`
	// License is an SPDX license id, e.g. "MIT".
	License string  `json:"license"`
	RepoURL *string `json:"repoUrl"`
	// ContentHash is the sha256 of the normalized SOUL.md body.
	ContentHash string `json:"contentHash"`
	// Status is draft | pending | published.
	Status        string   `json:"status"`
	DownloadCount int      `json:"downloadCount"`
	RatingAvg     *float64 `json:"ratingAvg"`
	RatingCount   int      `json:"ratingCount"`
	ArenaRank     *int     `json:"arenaRank"`
	CreatedAt     string   `json:"createdAt"`
	UpdatedAt     string   `json:"updatedAt"`
}

type User struct {
	ID          string  `json:"id"`
	Name        string  `json:"name"`
	Email       string  `json:"email"`
	Image       *string `json:"image"`
	GithubLogin *string `json:"githubLogin"`
}