mcpserver

type AddFeedParams struct {
	URL         string `json:"url"`
	Title       string `json:"title,omitempty"`
	Category    string `json:"category,omitempty"`
	Description string `json:"description,omitempty"`
}

type AllFeedsGetter interface {
	GetAllFeeds(ctx context.Context) ([]*model.FeedResult, error)
}

type Config struct {
	AllFeedsGetter     AllFeedsGetter
	FeedAndItemsGetter FeedAndItemsGetter
	DynamicFeedManager DynamicFeedManager // Optional: for runtime feed management
	Transport          model.Transport
}

type DynamicFeedManager interface {
	// AddFeed adds a new feed at runtime and returns its information
	AddFeed(ctx context.Context, config FeedConfig) (*ManagedFeedInfo, error)

	// RemoveFeed removes a feed by ID
	RemoveFeed(ctx context.Context, feedID string) (*RemovedFeedInfo, error)

	// RemoveFeedByURL removes a feed by URL
	RemoveFeedByURL(ctx context.Context, url string) (*RemovedFeedInfo, error)

	// ListManagedFeeds returns all managed feeds with their metadata and status
	ListManagedFeeds(ctx context.Context) ([]ManagedFeedInfo, error)

	// RefreshFeed forces a refresh of a specific feed
	RefreshFeed(ctx context.Context, feedID string) (*RefreshFeedInfo, error)

	// UpdateFeedMetadata updates feed metadata (title, category, description)
	UpdateFeedMetadata(ctx context.Context, feedID string, metadata FeedMetadata) error

	// PauseFeed pauses fetching for a specific feed
	PauseFeed(ctx context.Context, feedID string) error

	// ResumeFeed resumes fetching for a paused feed
	ResumeFeed(ctx context.Context, feedID string) error
}

type ExportFeedDataParams struct {
	FeedIDs    []string `json:"feedIds,omitempty"`    // Specific feeds to export (empty = all)
	Format     string   `json:"format"`               // json, csv, opml, rss, atom
	Since      string   `json:"since,omitempty"`      // ISO 8601 date
	Until      string   `json:"until,omitempty"`      // ISO 8601 date
	MaxItems   int      `json:"maxItems,omitempty"`   // Limit exported items
	IncludeAll bool     `json:"includeAll,omitempty"` // Include feed metadata
}

type FeedAndItemsGetter interface {
	GetFeedAndItems(ctx context.Context, id string) (*model.FeedAndItemsResult, error)
}

type FeedAndItemsResult = model.FeedAndItemsResult

type FeedConfig struct {
	URL         string `json:"url" description:"RSS/Atom/JSON feed URL"`
	Title       string `json:"title,omitempty" description:"Optional human-readable title"`
	Category    string `json:"category,omitempty" description:"Optional category for organization"`
	Description string `json:"description,omitempty" description:"Optional description"`
}

type FeedMetadata struct {
	Title       string `json:"title,omitempty" description:"Feed title"`
	Category    string `json:"category,omitempty" description:"Feed category"`
	Description string `json:"description,omitempty" description:"Feed description"`
}

type FeedSource string

type FetchLinkParams struct {
	URL string
}

type FilterParams struct {
	// Existing filters
	Since    *time.Time // Filter items since this date
	Until    *time.Time // Filter items until this date
	Limit    *int       // Maximum number of items to return
	Offset   *int       // Number of items to skip (for pagination)
	Category string     // Filter by category/tag
	Author   string     // Filter by author
	Search   string     // Search in title/description

	// Enhanced filters (Phase 2)
	Language   string // Filter by language (en, es, fr, etc.)
	MinLength  *int   // Minimum content length
	MaxLength  *int   // Maximum content length
	HasMedia   *bool  // Only items with images/video
	Sentiment  string // positive, negative, neutral
	Duplicates *bool  // Include/exclude duplicate content
	SortBy     string // date, relevance, popularity
	Format     string // json, xml, html, markdown
}

type FilterSummary struct {
	TotalItems     int            `json:"total_items"`
	FilteredItems  int            `json:"filtered_items"`
	AppliedFilters map[string]any `json:"applied_filters,omitempty"`
}

type GetSyndicationFeedParams struct {
	ID string
}

type ManagedFeedInfo struct {
	FeedID      string    `json:"feedId" description:"Unique feed identifier"`
	URL         string    `json:"url" description:"Feed URL"`
	Title       string    `json:"title" description:"Feed title"`
	Category    string    `json:"category,omitempty" description:"Feed category"`
	Description string    `json:"description,omitempty" description:"Feed description"`
	Status      string    `json:"status" description:"'active', 'error', 'paused'"`
	LastFetched time.Time `json:"lastFetched" description:"Last successful fetch time"`
	LastError   string    `json:"lastError,omitempty" description:"Most recent error message"`
	ItemCount   int       `json:"itemCount" description:"Current number of cached items"`
	AddedAt     time.Time `json:"addedAt" description:"When feed was added"`
	Source      string    `json:"source" description:"'runtime', 'startup', 'opml'"`
}

type MergeFeedsParams struct {
	FeedIDs     []string `json:"feedIds"`
	Title       string   `json:"title,omitempty"`
	MaxItems    int      `json:"maxItems,omitempty"`
	SortBy      string   `json:"sortBy,omitempty"`      // date, title, source
	Deduplicate bool     `json:"deduplicate,omitempty"` // Remove duplicate items
}

type MergedFeedResult struct {
	ID          string         `json:"id"`
	Title       string         `json:"title"`
	Description string         `json:"description"`
	Items       []*gofeed.Item `json:"items"`
	SourceFeeds []string       `json:"source_feeds"`
	TotalItems  int            `json:"total_items"`
	CreatedAt   time.Time      `json:"created_at"`
}

type PromptResult struct {
	Success   bool                   `json:"success"`
	Message   string                 `json:"message,omitempty"`
	Data      map[string]interface{} `json:"data,omitempty"`
	Error     string                 `json:"error,omitempty"`
	Generated time.Time              `json:"generated"`
}

type RefreshFeedInfo struct {
	FeedID      string    `json:"feedId" description:"Feed ID that was refreshed"`
	Status      string    `json:"status" description:"'refreshed', 'error', 'not_found'"`
	ItemsAdded  int       `json:"itemsAdded" description:"Number of new items fetched"`
	LastFetched time.Time `json:"lastFetched" description:"Timestamp of refresh"`
	Error       string    `json:"error,omitempty" description:"Error message if refresh failed"`
}

type RefreshFeedParams struct {
	FeedID string `json:"feedId"`
}

type RemoveFeedParams struct {
	FeedID string `json:"feedId,omitempty"`
	URL    string `json:"url,omitempty"`
}

type RemovedFeedInfo struct {
	FeedID       string `json:"feedId" description:"ID of removed feed"`
	URL          string `json:"url" description:"URL of removed feed"`
	Title        string `json:"title" description:"Title of removed feed"`
	ItemsRemoved int    `json:"itemsRemoved" description:"Number of cached items removed"`
}

type ResourceCacheConfig struct {
	DefaultTTL      time.Duration // Default TTL for resource content
	FeedListTTL     time.Duration // TTL for feed list resources
	FeedItemsTTL    time.Duration // TTL for feed items resources
	FeedMetadataTTL time.Duration // TTL for feed metadata resources
	MaxCost         int64         // Maximum cache size in bytes
	NumCounters     int64         // Number of keys to track frequency
	BufferItems     int64         // Number of keys per Get buffer
}

type ResourceCacheMetrics struct {
	Hits             uint64
	Misses           uint64
	Evictions        uint64
	InvalidationHits uint64 // Cache invalidations triggered
	// contains filtered or unexported fields
}

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

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

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