types

type Article struct {
	AgentId      *string `json:"agent_id,omitempty"`
	Author       *string `json:"author,omitempty"`
	CanonicalUrl string  `json:"canonical_url"`

	// Content Article body in markdown. Returned only when ?include=content is set.
	Content     *string            `json:"content,omitempty"`
	CreatedAt   time.Time          `json:"created_at"`
	FilePath    string             `json:"file_path"`
	Id          string             `json:"id"`
	Metadata    *map[string]string `json:"metadata,omitempty"`
	PublishedAt *time.Time         `json:"published_at,omitempty"`
	ReadAt      *time.Time         `json:"read_at,omitempty"`
	SavedAt     time.Time          `json:"saved_at"`
	SourceType  SourceType         `json:"source_type"`
	Starred     bool               `json:"starred"`
	Status      ArticleStatus      `json:"status"`
	Summary     *string            `json:"summary,omitempty"`
	Tags        *[]string          `json:"tags,omitempty"`
	Title       string             `json:"title"`
	UpdatedAt   time.Time          `json:"updated_at"`
	Url         string             `json:"url"`
}

type ArticleList struct {
	Items []Article `json:"items"`
}

type ArticleStatus string

type BadRequest struct {
	Error string `json:"error"`
}

type Conflict struct {
	Error string `json:"error"`
}

type CreateFeedRequest struct {
	AgentId *string `json:"agent_id,omitempty"`

	// Title Optional override; server fetches feed metadata if omitted
	Title *string `json:"title,omitempty"`
	Url   string  `json:"url"`
}

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

type Digest struct {
	ArchivedCount        int64      `json:"archived_count"`
	Date                 time.Time  `json:"date"`
	ReadCount            int64      `json:"read_count"`
	SavedYesterday       []Article  `json:"saved_yesterday"`
	SavedYesterdayCount  int        `json:"saved_yesterday_count"`
	StarredCount         int64      `json:"starred_count"`
	TopTags              []TagCount `json:"top_tags"`
	TotalArticles        int64      `json:"total_articles"`
	UnreadCount          int64      `json:"unread_count"`
	WorthRevisiting      []Article  `json:"worth_revisiting"`
	WorthRevisitingCount int        `json:"worth_revisiting_count"`
}

type Error struct {
	Error string `json:"error"`
}

type Feed struct {
	AgentId       *string    `json:"agent_id,omitempty"`
	CheckInterval string     `json:"check_interval"`
	CreatedAt     time.Time  `json:"created_at"`
	Description   *string    `json:"description,omitempty"`
	Enabled       bool       `json:"enabled"`
	Id            string     `json:"id"`
	LastCheckedAt *time.Time `json:"last_checked_at,omitempty"`
	LastEtag      *string    `json:"last_etag,omitempty"`
	LastModified  *string    `json:"last_modified,omitempty"`
	Title         string     `json:"title"`
	UpdatedAt     time.Time  `json:"updated_at"`
	Url           string     `json:"url"`
}

type FeedEntry struct {
	ArticleId    *string         `json:"article_id,omitempty"`
	Attempts     int             `json:"attempts"`
	DiscoveredAt time.Time       `json:"discovered_at"`
	ErrorMsg     *string         `json:"error_msg,omitempty"`
	FeedId       string          `json:"feed_id"`
	Guid         string          `json:"guid"`
	Id           string          `json:"id"`
	ProcessedAt  *time.Time      `json:"processed_at,omitempty"`
	Status       FeedEntryStatus `json:"status"`
	Title        string          `json:"title"`
	Url          string          `json:"url"`
}

type FeedEntryList struct {
	Items []FeedEntry `json:"items"`
}

type FeedEntryStatus string

type FeedList struct {
	Items []Feed `json:"items"`
}

type FeedPollResult struct {
	// Error Set if the upstream RSS fetch failed but the feed exists
	Error      *string     `json:"error,omitempty"`
	Feed       Feed        `json:"feed"`
	NewEntries []FeedEntry `json:"new_entries"`
}

type Forbidden struct {
	Error string `json:"error"`
}

type Job struct {
	AgentId *string `json:"agent_id,omitempty"`

	// At RFC3339 one-time timestamp (mutually exclusive with cron/every)
	At        *string    `json:"at,omitempty"`
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Cron Cron expression (mutually exclusive with every/at)
	Cron        *string `json:"cron,omitempty"`
	Description *string `json:"description,omitempty"`
	Enabled     bool    `json:"enabled"`

	// Every Go duration string, e.g. '30m' (mutually exclusive with cron/at)
	Every     *string    `json:"every,omitempty"`
	Id        string     `json:"id"`
	JobKey    *string    `json:"job_key,omitempty"`
	LastError *string    `json:"last_error,omitempty"`
	LastRunAt *time.Time `json:"last_run_at,omitempty"`

	// Message Prompt/instruction to run on schedule
	Message string `json:"message"`
	Name    string `json:"name"`

	// OwnerKind Ownership class: 'user' or 'plugin'
	OwnerKind *string `json:"owner_kind,omitempty"`

	// Payload Arbitrary structured data for plugin-owned jobs
	Payload     *map[string]interface{} `json:"payload,omitempty"`
	PluginId    *string                 `json:"plugin_id,omitempty"`
	RuntimeName *string                 `json:"runtime_name,omitempty"`

	// SessionMode Session behaviour: 'reuse' or 'new'
	SessionMode string     `json:"session_mode"`
	UpdatedAt   *time.Time `json:"updated_at,omitempty"`
	UserId      *int64     `json:"user_id,omitempty"`
}

type JobInput struct {
	AgentId     *string `json:"agent_id,omitempty"`
	At          *string `json:"at,omitempty"`
	Cron        *string `json:"cron,omitempty"`
	Description *string `json:"description,omitempty"`
	Enabled     *bool   `json:"enabled,omitempty"`
	Every       *string `json:"every,omitempty"`
	Message     *string `json:"message,omitempty"`
	Name        *string `json:"name,omitempty"`
	SessionMode *string `json:"session_mode,omitempty"`

	// UserId Admin-only: set 0 for system jobs
	UserId *int64 `json:"user_id,omitempty"`
}

type JobList struct {
	Items []Job `json:"items"`
}

type JobRun struct {
	Duration   *string `json:"duration,omitempty"`
	Error      *string `json:"error,omitempty"`
	FinishedAt *string `json:"finished_at,omitempty"`
	Id         string  `json:"id"`
	JobId      string  `json:"job_id"`
	SessionId  string  `json:"session_id"`
	StartedAt  string  `json:"started_at"`
	Status     string  `json:"status"`
	UserId     *int64  `json:"user_id,omitempty"`
}

type JobRunList = []JobRun

type NotFound struct {
	Error string `json:"error"`
}

type SaveArticleRequest struct {
	AgentId      *string `json:"agent_id,omitempty"`
	Author       *string `json:"author,omitempty"`
	CanonicalUrl *string `json:"canonical_url,omitempty"`

	// Content Markdown body. If empty and the article exists, only metadata is updated; if empty and the article is new, the request fails 400.
	Content     *string            `json:"content,omitempty"`
	Metadata    *map[string]string `json:"metadata,omitempty"`
	PublishedAt *time.Time         `json:"published_at,omitempty"`
	SourceType  *SourceType        `json:"source_type,omitempty"`
	Summary     *string            `json:"summary,omitempty"`
	Tags        *[]string          `json:"tags,omitempty"`
	Title       *string            `json:"title,omitempty"`
	Url         string             `json:"url"`
}

type SourceType string

type TagCount struct {
	Count int64  `json:"count"`
	Tag   string `json:"tag"`
}

type TriggerJobResult struct {
	RunId  *string `json:"run_id,omitempty"`
	Status string  `json:"status"`
}

type Unauthorized struct {
	Error string `json:"error"`
}

type UpdateArticleRequest struct {
	Author *string `json:"author,omitempty"`

	// Content If set, rewrites the markdown file body.
	Content     *string            `json:"content,omitempty"`
	FilePath    *string            `json:"file_path,omitempty"`
	Metadata    *map[string]string `json:"metadata,omitempty"`
	PublishedAt *time.Time         `json:"published_at,omitempty"`
	Starred     *bool              `json:"starred,omitempty"`
	Status      *ArticleStatus     `json:"status,omitempty"`
	Summary     *string            `json:"summary,omitempty"`
	Tags        *[]string          `json:"tags,omitempty"`
	Title       *string            `json:"title,omitempty"`
}

type UpdateFeedEntryRequest struct {
	ArticleId *string         `json:"article_id,omitempty"`
	ErrorMsg  *string         `json:"error_msg,omitempty"`
	Status    FeedEntryStatus `json:"status"`
}

type UpdateFeedRequest struct {
	CheckInterval *string `json:"check_interval,omitempty"`
	Description   *string `json:"description,omitempty"`
	Enabled       *bool   `json:"enabled,omitempty"`
	Title         *string `json:"title,omitempty"`
}