types

type AnalysisHealthInput struct{}

type AppendBlocksInput struct {
	Page   string   `json:"page" jsonschema:"Page name to append blocks to"`
	Blocks []string `json:"blocks" jsonschema:"Block contents as plain strings (same format as create_page blocks)"`
}

type BackLink struct {
	PageName string         `json:"pageName"`
	Blocks   []BlockSummary `json:"blocks"` // the specific blocks containing the link
}

type BlockEntity struct {
	ID              int            `json:"id"`
	UUID            string         `json:"uuid"`
	Content         string         `json:"content"`
	Format          string         `json:"format,omitempty"`
	Marker          string         `json:"marker,omitempty"`   // TODO, DOING, DONE, etc.
	Priority        string         `json:"priority,omitempty"` // A, B, C
	Page            *PageRef       `json:"page,omitempty"`
	Left            *BlockRef      `json:"left,omitempty"`
	Parent          *BlockRef      `json:"parent,omitempty"`
	Children        []BlockEntity  `json:"children,omitempty"`
	Properties      map[string]any `json:"properties,omitempty"`
	PropertiesOrder []string       `json:"propertiesOrder,omitempty"`
	PathRefs        []PageRef      `json:"pathRefs,omitempty"`
	Refs            []PageRef      `json:"refs,omitempty"`
	PreBlock        bool           `json:"preBlock,omitempty"`
}

type BlockInput struct {
	Content    string            `json:"content" jsonschema:"Block text content"`
	Properties map[string]string `json:"properties,omitempty" jsonschema:"Block properties"`
	Children   []BlockInput      `json:"children,omitempty" jsonschema:"Nested child blocks"`
}

type BlockRef struct {
	ID int `json:"id"`
}

type BlockSummary struct {
	UUID    string `json:"uuid"`
	Content string `json:"content"`
}

type BulkUpdatePropertiesInput struct {
	Pages    []string `json:"pages" jsonschema:"List of page names to update"`
	Property string   `json:"property" jsonschema:"Property key to set"`
	Value    string   `json:"value" jsonschema:"Property value to set"`
}

type CreatePageInput struct {
	Name       string         `json:"name" jsonschema:"Page name to create"`
	Properties map[string]any `json:"properties,omitempty" jsonschema:"Page properties as key-value pairs"`
	Blocks     []string       `json:"blocks,omitempty" jsonschema:"Initial block contents to add to the page"`
}

type DecisionCheckInput struct {
	IncludeResolved bool `json:"includeResolved,omitempty" jsonschema:"Include resolved (DONE) decisions. Default: false"`
}

type DecisionCreateInput struct {
	Page     string   `json:"page" jsonschema:"Page to create the decision on (where context is richest)"`
	Question string   `json:"question" jsonschema:"The decision question"`
	Deadline string   `json:"deadline" jsonschema:"Decision deadline (YYYY-MM-DD)"`
	Options  []string `json:"options,omitempty" jsonschema:"Available choices"`
	Context  string   `json:"context,omitempty" jsonschema:"Brief context for the decision"`
}

type DecisionDeferInput struct {
	UUID        string `json:"uuid" jsonschema:"UUID of the decision block to defer"`
	NewDeadline string `json:"newDeadline" jsonschema:"New deadline (YYYY-MM-DD)"`
	Reason      string `json:"reason,omitempty" jsonschema:"Why the decision is being deferred"`
}

type DecisionResolveInput struct {
	UUID    string `json:"uuid" jsonschema:"UUID of the decision block to resolve"`
	Outcome string `json:"outcome,omitempty" jsonschema:"What was decided"`
}

type DeleteBlockInput struct {
	UUID string `json:"uuid" jsonschema:"UUID of block to delete"`
}

type DeletePageInput struct {
	Name string `json:"name" jsonschema:"Page name to delete"`
}

type EnrichedBlock struct {
	BlockEntity
	Parsed    ParsedContent  `json:"parsed"`
	Ancestors []BlockSummary `json:"ancestors,omitempty"` // path from root to this block
	Siblings  []BlockSummary `json:"siblings,omitempty"`
}

type EnrichedPage struct {
	PageEntity
	Blocks        []EnrichedBlock `json:"blocks"`
	OutgoingLinks []string        `json:"outgoingLinks"` // pages this page links to
	BackLinks     []BackLink      `json:"backlinks"`     // pages that link to this page
	BlockCount    int             `json:"blockCount"`
	LinkCount     int             `json:"linkCount"`
}

type FileInfo struct {
	ID   int    `json:"id"`
	Path string `json:"path,omitempty"`
}

type FindByTagInput struct {
	Tag             string `json:"tag" jsonschema:"Tag name to search for"`
	IncludeChildren bool   `json:"includeChildren,omitempty" jsonschema:"Include child tags in hierarchy. Default: true"`
}

type FindConnectionsInput struct {
	From     string `json:"from" jsonschema:"Starting page name"`
	To       string `json:"to" jsonschema:"Target page name"`
	MaxDepth int    `json:"maxDepth,omitempty" jsonschema:"Max search depth. Default: 5"`
}

type FlashcardCreateInput struct {
	Page  string `json:"page" jsonschema:"Page to create the card on"`
	Front string `json:"front" jsonschema:"Front of the card (question)"`
	Back  string `json:"back" jsonschema:"Back of the card (answer)"`
}

type FlashcardDueInput struct {
	Limit int `json:"limit,omitempty" jsonschema:"Max cards to return. Default: 20"`
}

type FlashcardOverviewInput struct{}

type GetBlockInput struct {
	UUID             string `json:"uuid" jsonschema:"Block UUID to retrieve"`
	IncludeAncestors bool   `json:"includeAncestors,omitempty" jsonschema:"Include ancestor chain from root. Default: true"`
	IncludeSiblings  bool   `json:"includeSiblings,omitempty" jsonschema:"Include sibling blocks. Default: false"`
}

type GetLinksInput struct {
	Name      string `json:"name" jsonschema:"Page name to get links for"`
	Direction string `json:"direction,omitempty" jsonschema:"Link direction: forward or backward or both. Default: both"`
}

type GetPageInput struct {
	Name      string `json:"name" jsonschema:"Page name to retrieve"`
	Depth     int    `json:"depth,omitempty" jsonschema:"Max block tree depth (-1 for unlimited). Default: -1"`
	MaxBlocks int    `json:"maxBlocks,omitempty" jsonschema:"Max total blocks to return. Truncates with a flag when exceeded. Default: unlimited"`
	Compact   bool   `` /* 132-byte string literal not displayed */
}

type GetReferencesInput struct {
	UUID string `json:"uuid" jsonschema:"Block UUID to find references for"`
}

type GetWhiteboardInput struct {
	Name string `json:"name" jsonschema:"Whiteboard name"`
}

type GraphOverviewInput struct{}

type JournalRangeInput struct {
	From          string `json:"from" jsonschema:"Start date (YYYY-MM-DD)"`
	To            string `json:"to" jsonschema:"End date (YYYY-MM-DD)"`
	IncludeBlocks bool   `json:"includeBlocks,omitempty" jsonschema:"Include full block trees. Default: true"`
}

type JournalSearchInput struct {
	Query string `json:"query" jsonschema:"Text to search for in journal entries"`
	From  string `json:"from,omitempty" jsonschema:"Start date filter (YYYY-MM-DD)"`
	To    string `json:"to,omitempty" jsonschema:"End date filter (YYYY-MM-DD)"`
}

type KnowledgeGapsInput struct {
	MinBlockCount  int  `json:"minBlockCount,omitempty" jsonschema:"Minimum block count for orphan pages. Filters out stray/empty pages. Default: 0"`
	ExcludeNumeric bool `json:"excludeNumeric,omitempty" jsonschema:"Exclude pages with purely numeric names (stray block refs). Default: false"`
}

type LinkPagesInput struct {
	From    string `json:"from" jsonschema:"Source page name"`
	To      string `json:"to" jsonschema:"Target page name"`
	Context string `json:"context,omitempty" jsonschema:"Description of the relationship between pages"`
}

type ListOrphansInput struct {
	MinBlockCount  int  `json:"minBlockCount,omitempty" jsonschema:"Minimum block count to include. Filters stray/empty pages. Default: 0"`
	ExcludeNumeric bool `json:"excludeNumeric,omitempty" jsonschema:"Exclude pages with purely numeric names (stray block refs). Default: false"`
	Limit          int  `json:"limit,omitempty" jsonschema:"Max orphans to return. Default: 50"`
}

type ListPagesInput struct {
	Namespace   string `json:"namespace,omitempty" jsonschema:"Filter by namespace prefix (e.g. projects)"`
	HasProperty string `json:"hasProperty,omitempty" jsonschema:"Filter to pages with this property key"`
	HasTag      string `json:"hasTag,omitempty" jsonschema:"Filter to pages with this tag"`
	SortBy      string `json:"sortBy,omitempty" jsonschema:"Sort by: name or modified or created. Default: name"`
	Limit       int    `json:"limit,omitempty" jsonschema:"Max results. Default: 50"`
}

type ListWhiteboardsInput struct{}

type LogseqAPIRequest struct {
	Method string `json:"method"`
	Args   []any  `json:"args,omitempty"`
}

type MoveBlockInput struct {
	UUID       string `json:"uuid" jsonschema:"UUID of block to move"`
	TargetUUID string `json:"targetUuid" jsonschema:"UUID of target block"`
	Position   string `json:"position,omitempty" jsonschema:"Placement: before or after or child. Default: child"`
}

type NamespaceInfo struct {
	ID int `json:"id"`
}

type PageEntity struct {
	ID              int            `json:"id"`
	UUID            string         `json:"uuid"`
	Name            string         `json:"name"`
	OriginalName    string         `json:"originalName"`
	Journal         bool           `json:"journal?"`
	JournalDay      int            `json:"journalDay,omitempty"`
	Namespace       *NamespaceInfo `json:"namespace,omitempty"`
	Properties      map[string]any `json:"properties,omitempty"`
	PropertiesOrder []string       `json:"propertiesOrder,omitempty"`
	CreatedAt       int64          `json:"createdAt,omitempty"`
	UpdatedAt       int64          `json:"updatedAt,omitempty"`
	File            *FileInfo      `json:"file,omitempty"`
}

type PageRef struct {
	ID   int    `json:"id"`
	Name string `json:"name,omitempty"`
}

type ParsedContent struct {
	Raw             string            `json:"raw"`
	Links           []string          `json:"links"`                // [[page name]]
	BlockReferences []string          `json:"blockReferences"`      // ((uuid))
	Tags            []string          `json:"tags"`                 // #tag
	Properties      map[string]string `json:"properties,omitempty"` // key:: value
	Marker          string            `json:"marker,omitempty"`     // TODO, DOING, DONE
	Priority        string            `json:"priority,omitempty"`   // [#A], [#B], [#C]
}

type QueryDatalogInput struct {
	Query  string `json:"query" jsonschema:"Datalog/DataScript query string"`
	Inputs []any  `json:"inputs,omitempty" jsonschema:"Query input bindings"`
}

type QueryPropertiesInput struct {
	Property string `json:"property" jsonschema:"Property key to search for"`
	Value    string `json:"value,omitempty" jsonschema:"Property value to match (omit to find all with this property)"`
	Operator string `json:"operator,omitempty" jsonschema:"Comparison: eq or contains or gt or lt. Default: eq"`
}

type RenamePageInput struct {
	OldName string `json:"oldName" jsonschema:"Current page name"`
	NewName string `json:"newName" jsonschema:"New page name"`
}

type SearchInput struct {
	Query        string `json:"query" jsonschema:"Search text to find across all blocks"`
	ContextLines int    `json:"contextLines,omitempty" jsonschema:"Number of parent/sibling blocks for context. Default: 2"`
	Limit        int    `json:"limit,omitempty" jsonschema:"Max results. Default: 20"`
	Compact      bool   `` /* 142-byte string literal not displayed */
}

type SemanticSearchFilteredInput struct {
	Query       string  `json:"query" jsonschema:"Natural language search query"`
	SourceType  string  `json:"source_type,omitempty" jsonschema:"Filter by source type: disk, github, web"`
	SourceID    string  `json:"source_id,omitempty" jsonschema:"Filter by specific source identifier (e.g., github-gaze)"`
	HasProperty string  `json:"has_property,omitempty" jsonschema:"Filter to pages with this frontmatter property key"`
	HasTag      string  `json:"has_tag,omitempty" jsonschema:"Filter to pages with this tag"`
	Limit       int     `json:"limit,omitempty" jsonschema:"Maximum number of results. Default: 10"`
	Threshold   float64 `json:"threshold,omitempty" jsonschema:"Minimum similarity score (0.0-1.0). Default: 0.3"`
}

type SemanticSearchInput struct {
	Query     string  `json:"query" jsonschema:"Natural language search query"`
	Limit     int     `json:"limit,omitempty" jsonschema:"Maximum number of results. Default: 10"`
	Threshold float64 `json:"threshold,omitempty" jsonschema:"Minimum similarity score (0.0-1.0). Default: 0.3"`
}

type SemanticSearchResult struct {
	DocumentID string  `json:"document_id"`
	Page       string  `json:"page"`
	Content    string  `json:"content"`
	Similarity float64 `json:"similarity"`
	Source     string  `json:"source"`
	SourceID   string  `json:"source_id"`
	OriginURL  string  `json:"origin_url,omitempty"`
	IndexedAt  string  `json:"indexed_at"`
}

type SimilarInput struct {
	Page  string `json:"page,omitempty" jsonschema:"Page name to find similar documents for"`
	UUID  string `json:"uuid,omitempty" jsonschema:"Block UUID to find similar blocks for. Takes precedence over page."`
	Limit int    `json:"limit,omitempty" jsonschema:"Maximum number of results. Default: 10"`
}

type TopicClustersInput struct{}

type TraverseInput struct {
	From    string `json:"from" jsonschema:"Starting page name"`
	To      string `json:"to" jsonschema:"Target page name"`
	MaxHops int    `json:"maxHops,omitempty" jsonschema:"Maximum traversal depth. Default: 4"`
}

type UpdateBlockInput struct {
	UUID    string `json:"uuid" jsonschema:"UUID of block to update"`
	Content string `json:"content" jsonschema:"New content for the block (replaces existing content entirely)"`
}

type UpsertBlocksInput struct {
	Page     string       `json:"page" jsonschema:"Page name to add blocks to"`
	Blocks   []BlockInput `json:"blocks" jsonschema:"Blocks to create or update"`
	Position string       `json:"position,omitempty" jsonschema:"Where to add: append or prepend. Default: append"`
}