mcpserver

type AnswerGenerator interface {
	GenerateAnswer(context.Context, string, []string) (string, error)
}

type AskInput struct {
	Question string      `json:"question" jsonschema:"question to answer from the local knowledge index"`
	Limit    int         `json:"limit,omitempty" jsonschema:"maximum retrieved documents from 1 to 50"`
	Filters  FilterInput `json:"filters,omitempty" jsonschema:"typed filters applied before answer generation"`
}

type AskOutput struct {
	Answer     string           `json:"answer"`
	Confidence ConfidenceOutput `json:"confidence"`
	Citations  []DocumentOutput `json:"citations"`
}

type CollectionOutput struct {
	ID            string    `json:"id"`
	Name          string    `json:"name"`
	Description   string    `json:"description,omitempty"`
	Query         string    `json:"query,omitempty"`
	CreatedAt     time.Time `json:"created_at"`
	DocumentCount int       `json:"document_count,omitempty"`
}

type ConfidenceOutput struct {
	Score float64 `json:"score"`
	Level string  `json:"level"`
}

type DocumentOutput struct {
	ID         string            `json:"id"`
	Source     string            `json:"source"`
	Path       string            `json:"path"`
	Title      string            `json:"title"`
	Content    string            `json:"content,omitempty"`
	Preview    string            `json:"preview,omitempty"`
	Metadata   map[string]string `json:"metadata,omitempty"`
	IndexedAt  time.Time         `json:"indexed_at"`
	ModifiedAt time.Time         `json:"modified_at"`
	Truncated  bool              `json:"truncated,omitempty"`
}

type FilterInput struct {
	Sources       []string `` /* 128-byte string literal not displayed */
	Tags          []string `json:"tags,omitempty" jsonschema:"tags every result must contain"`
	ExcludedTags  []string `json:"excluded_tags,omitempty" jsonschema:"tags results must not contain"`
	Collections   []string `json:"collections,omitempty" jsonschema:"collection names; multiple names form a union"`
	After         string   `json:"after,omitempty" jsonschema:"inclusive YYYY-MM-DD or RFC3339 timestamp"`
	Before        string   `json:"before,omitempty" jsonschema:"exclusive YYYY-MM-DD or RFC3339 timestamp"`
	Paths         []string `json:"paths,omitempty" jsonschema:"case-insensitive path fragments every result must contain"`
	Domains       []string `json:"domains,omitempty" jsonschema:"domains or parent domains to match"`
	Kinds         []string `json:"kinds,omitempty" jsonschema:"source-specific record kinds such as bookmark"`
	ExactPhrases  []string `json:"exact_phrases,omitempty" jsonschema:"exact phrases every result must contain"`
	ExcludedTerms []string `json:"excluded_terms,omitempty" jsonschema:"words or phrases results must not contain"`
	RelativeTime  string   `json:"relative_time,omitempty" jsonschema:"today, yesterday, this week, last week, this month, last month, or last year"`
}

type GetDocumentInput struct {
	ID              string `json:"id" jsonschema:"stable document ID"`
	MaxContentBytes int    `json:"max_content_bytes,omitempty" jsonschema:"content bound from 1 to 20480 bytes"`
}

type ListCollectionsOutput struct {
	Collections []CollectionOutput `json:"collections"`
}

type RecentDocumentsInput struct {
	Since  string `json:"since,omitempty" jsonschema:"lookback such as 7d, 2w, or 24h, or an inclusive timestamp"`
	Before string `json:"before,omitempty" jsonschema:"exclusive YYYY-MM-DD or RFC3339 timestamp; defaults to now"`
	Limit  int    `json:"limit,omitempty" jsonschema:"maximum documents from 1 to 50"`
}

type RecentDocumentsOutput struct {
	After     time.Time        `json:"after"`
	Before    time.Time        `json:"before"`
	Documents []DocumentOutput `json:"documents"`
}

type RelatedDocumentsInput struct {
	ID    string `json:"id" jsonschema:"stable source document ID"`
	Limit int    `json:"limit,omitempty" jsonschema:"maximum related documents from 1 to 50"`
}

type RelatedDocumentsOutput struct {
	Source  DocumentOutput        `json:"source"`
	Results []RelatedResultOutput `json:"results"`
}

type RelatedResultOutput struct {
	Document DocumentOutput         `json:"document"`
	Score    float64                `json:"score"`
	Reasons  []query.RelationReason `json:"reasons"`
}

type SearchInput struct {
	Query   string      `json:"query,omitempty" jsonschema:"search text, optionally including MindCLI structured query syntax"`
	Limit   int         `json:"limit,omitempty" jsonschema:"maximum results from 1 to 50"`
	Filters FilterInput `json:"filters,omitempty" jsonschema:"typed filters combined with filters in query"`
}

type SearchOutput struct {
	Results       []SearchResultOutput `json:"results"`
	ActiveFilters []string             `json:"active_filters,omitempty"`
}

type SearchResultOutput struct {
	Document   DocumentOutput `json:"document"`
	Score      float64        `json:"score"`
	Highlights []string       `json:"highlights,omitempty"`
}

type Searcher interface {
	SearchParsed(context.Context, query.ParsedQuery, int) (storage.SearchResults, error)
	Related(context.Context, string, int) ([]query.RelatedResult, error)
}

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

type ShowCollectionInput struct {
	Name  string `json:"name" jsonschema:"collection name"`
	Limit int    `json:"limit,omitempty" jsonschema:"maximum documents from 1 to 50"`
}

type ShowCollectionOutput struct {
	Collection CollectionOutput `json:"collection"`
	Documents  []DocumentOutput `json:"documents"`
}