docs

type DeleteError struct {
	ID    string
	Error string
}

type Doc struct {
	ID          string `json:"id"`
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`
	Content     string `json:"content"`
	CreatedAt   string `json:"createdAt"`
	UpdatedAt   string `json:"updatedAt"`
}

type DocMetadata struct {
	ID          string    `json:"id"`
	Title       string    `json:"title"`
	Description string    `json:"description,omitempty"`
	ModTime     time.Time `json:"modTime"`
}

type DocSearchResult struct {
	ID                string        `json:"id"`
	Title             string        `json:"title"`
	Description       string        `json:"description,omitempty"`
	ModTime           time.Time     `json:"modTime"`
	Matches           []*exec.Match `json:"matches"`
	HasMoreMatches    bool          `json:"hasMoreMatches"`
	NextMatchesCursor string        `json:"nextMatchesCursor,omitempty"`
}

type DocSortField string

type DocSortOrder string

type DocStore interface {
	List(ctx context.Context, opts ListDocsOptions) (*exec.PaginatedResult[*DocTreeNode], error)
	ListFlat(ctx context.Context, opts ListDocsOptions) (*exec.PaginatedResult[DocMetadata], error)
	Get(ctx context.Context, id string) (*Doc, error)
	Create(ctx context.Context, id, content string) error
	Update(ctx context.Context, id, content string) error
	Delete(ctx context.Context, id string) error
	DeleteBatch(ctx context.Context, ids []string) (deleted []string, failed []DeleteError, err error)
	Rename(ctx context.Context, oldID, newID string) error
	Search(ctx context.Context, query string) ([]*DocSearchResult, error)
	SearchCursor(ctx context.Context, opts SearchDocsOptions) (*exec.CursorResult[DocSearchResult], error)
	SearchMatches(ctx context.Context, id string, opts SearchDocMatchesOptions) (*exec.CursorResult[*exec.Match], error)
}

type DocTreeNode struct {
	ID       string         `json:"id"`
	Name     string         `json:"name"`
	Title    string         `json:"title,omitempty"`
	Type     string         `json:"type"` // "file" or "directory"
	Children []*DocTreeNode `json:"children,omitempty"`
	ModTime  time.Time      `json:"modTime"`
}

type ListDocsOptions struct {
	Page             int
	PerPage          int
	Sort             DocSortField
	Order            DocSortOrder
	PathPrefix       string
	ExcludePathRoots []string
}

type SearchDocMatchesOptions struct {
	Cursor     string
	Limit      int
	Query      string
	PathPrefix string
}

type SearchDocsOptions struct {
	Cursor           string
	Limit            int
	Query            string
	MatchLimit       int
	PathPrefix       string
	FilterPrefix     string
	ExcludePathRoots []string
}