read

type BinaryFileResult struct {
	// FilePath is the path to the file
	FilePath string `json:"file_path"`

	// Reason is the reason why the file cannot be read
	Reason string `json:"reason"`

	// Suggestion is a suggested alternative tool or action
	Suggestion string `json:"suggestion,omitempty"`
}

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

type DoclingFileResult struct {
	FilePath     string     `json:"file_path"`
	Format       string     `json:"format"` // lowercase extension without dot, e.g. "docx"
	Markdown     string     `json:"markdown"`
	OriginalSize int64      `json:"original_size"`
	PageCount    int        `json:"page_count,omitempty"` // 0 for audio
	Images       []PDFImage `json:"images,omitempty"`
}

type FileReadCache struct {

	// MaxEntries is the maximum number of entries to cache
	MaxEntries int

	// MaxAge is the maximum age of cache entries
	MaxAge time.Duration
	// contains filtered or unexported fields
}

type FileReadResult struct {
	// Type indicates the type of result
	Type FileType `json:"type"`

	// Text contains the text file result (if Type == FileTypeText)
	Text *TextFileResult `json:"text,omitempty"`

	// Image contains the image file result (if Type == FileTypeImage)
	Image *ImageFileResult `json:"image,omitempty"`

	// PDF contains the PDF file result (if Type == FileTypePDF)
	PDF *PDFFileResult `json:"pdf,omitempty"`

	// PDFExtracted contains the PDF extracted pages result (if Type == FileTypePDFExtracted)
	PDFExtracted *PDFExtractedResult `json:"pdf_extracted,omitempty"`

	// PDFMarkdown contains the docling-converted PDF result (if Type == FileTypePDFMarkdown)
	PDFMarkdown *PDFMarkdownFileResult `json:"pdf_markdown,omitempty"`

	// Docling contains the result of a docling conversion of a non-PDF format (if Type == FileTypeDocling)
	Docling *DoclingFileResult `json:"docling,omitempty"`

	// Notebook contains the notebook result (if Type == FileTypeNotebook)
	Notebook *NotebookResult `json:"notebook,omitempty"`

	// Unchanged contains the unchanged file result (if Type == FileTypeUnchanged)
	Unchanged *UnchangedFileResult `json:"unchanged,omitempty"`

	// Binary contains the binary file result (if Type == FileTypeBinary)
	Binary *BinaryFileResult `json:"binary,omitempty"`

	// Error contains any error that occurred
	Error string `json:"error,omitempty"`
}

type FileReadState struct {
	// Content is the cached content
	Content string `json:"content"`

	// Timestamp is the file modification time when cached
	Timestamp int64 `json:"timestamp"`

	// Offset is the line offset used for text files (0-based)
	Offset int `json:"offset,omitempty"`

	// Limit is the number of lines read
	Limit int `json:"limit,omitempty"`

	// IsPartialView indicates if this is a partial view (offset/limit used)
	IsPartialView bool `json:"is_partial_view,omitempty"`

	// CachedAt is when this entry was created
	CachedAt time.Time `json:"cached_at"`
}

type FileType string

type ImageDimensions struct {
	// Width is the image width in pixels
	Width int `json:"width"`

	// Height is the image height in pixels
	Height int `json:"height"`
}

type ImageFileResult struct {
	// FilePath is the path to the file that was read
	FilePath string `json:"file_path"`

	// Base64 is the base64-encoded image data
	Base64 string `json:"base64"`

	// MimeType is the MIME type of the image
	MimeType string `json:"type"`

	// OriginalSize is the original file size in bytes
	OriginalSize int64 `json:"original_size"`

	// Dimensions contains the image dimensions (optional)
	Dimensions *ImageDimensions `json:"dimensions,omitempty"`
}

type ImageProcessingResult struct {
	Base64          string           `json:"base64"`
	MimeType        string           `json:"mime_type"`
	OriginalSize    int64            `json:"original_size"`
	ProcessedSize   int64            `json:"processed_size"`
	Dimensions      *ImageDimensions `json:"dimensions,omitempty"`
	WasResized      bool             `json:"was_resized"`
	WasCompressed   bool             `json:"was_compressed"`
	EstimatedTokens int              `json:"estimated_tokens"`
}

type Notebook struct {
	Cells         []NotebookCell   `json:"cells"`
	Metadata      NotebookMetadata `json:"metadata"`
	NBFormat      int              `json:"nbformat"`
	NBFormatMinor int              `json:"nbformat_minor"`
}

type NotebookCell struct {
	ID             string           `json:"id,omitempty"`
	CellType       string           `json:"cell_type"`
	Source         []string         `json:"source"`
	Metadata       json.RawMessage  `json:"metadata,omitempty"`
	Outputs        []NotebookOutput `json:"outputs,omitempty"`
	ExecutionCount *int             `json:"execution_count,omitempty"`
}

type NotebookKernelspec struct {
	Name     string `json:"name"`
	Display  string `json:"display,omitempty"`
	Language string `json:"language"`
}

type NotebookLanguageInfo struct {
	Name          string `json:"name"`
	Version       string `json:"version,omitempty"`
	FileExtension string `json:"file_extension,omitempty"`
}

type NotebookMetadata struct {
	LanguageInfo *NotebookLanguageInfo `json:"language_info,omitempty"`
	Kernelspec   *NotebookKernelspec   `json:"kernelspec,omitempty"`
	Title        string                `json:"title,omitempty"`
	Author       string                `json:"author,omitempty"`
	Description  string                `json:"description,omitempty"`
}

type NotebookOutput struct {
	OutputType string          `json:"output_type"`
	Text       []string        `json:"text,omitempty"`
	Data       map[string]any  `json:"data,omitempty"`
	Metadata   json.RawMessage `json:"metadata,omitempty"`
	Ename      string          `json:"ename,omitempty"`
	Evalue     string          `json:"evalue,omitempty"`
	Traceback  []string        `json:"traceback,omitempty"`
}

type NotebookResult struct {
	FilePath      string         `json:"file_path"`
	Cells         []NotebookCell `json:"cells"`
	Language      string         `json:"language,omitempty"`
	CellCount     int            `json:"cell_count"`
	CodeCells     int            `json:"code_cells"`
	MarkdownCells int            `json:"markdown_cells"`
	RawCells      int            `json:"raw_cells"`
}

type PDFExtractedResult struct {
	// FilePath is the path to the file that was read
	FilePath string `json:"file_path"`

	// OriginalSize is the original file size in bytes
	OriginalSize int64 `json:"original_size"`

	// Count is the number of pages extracted
	Count int `json:"count"`

	// OutputDir is the directory containing extracted page images
	OutputDir string `json:"output_dir"`
}

type PDFExtractionResult struct {
	FilePath     string
	OriginalSize int64
	Count        int
	OutputDir    string
}

type PDFFileResult struct {
	// FilePath is the path to the file that was read
	FilePath string `json:"file_path"`

	// Base64 is the base64-encoded PDF data
	Base64 string `json:"base64"`

	// OriginalSize is the original file size in bytes
	OriginalSize int64 `json:"original_size"`

	// PageCount is the number of pages in the PDF
	PageCount int `json:"page_count"`
}

type PDFImage struct {
	Filename string `json:"filename"`
	MimeType string `json:"mime_type"`
	Base64   string `json:"base64"`
}

type PDFMarkdownFileResult struct {
	FilePath     string     `json:"file_path"`
	Markdown     string     `json:"markdown"`
	OriginalSize int64      `json:"original_size"`
	PageCount    int        `json:"page_count"`
	Images       []PDFImage `json:"images,omitempty"`
}

type PDFPageRange struct {
	FirstPage int
	LastPage  int
}

type PDFResult struct {
	FilePath     string
	Base64       string
	OriginalSize int64
	PageCount    int
}

type TextFileResult struct {
	// FilePath is the path to the file that was read
	FilePath string `json:"file_path"`

	// Content is the content of the file
	Content string `json:"content"`

	// NumLines is the number of lines in the returned content
	NumLines int `json:"num_lines"`

	// StartLine is the starting line number (1-indexed)
	StartLine int `json:"start_line"`

	// TotalLines is the total number of lines in the file
	TotalLines int `json:"total_lines"`

	// Truncated indicates if the output was truncated
	Truncated bool `json:"truncated,omitempty"`
}

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

type ToolConfig struct {
	// MaxFileSize is the maximum file size to read
	MaxFileSize int64

	// MaxImageSize is the maximum image size to read
	MaxImageSize int64

	// DefaultLimit is the default number of lines to read
	DefaultLimit int

	// MaxLimit is the maximum number of lines to read
	MaxLimit int

	// DoclingURL is the base URL of a running docling-serve instance.
	// When non-empty a Client is created and PDFs are converted to markdown.
	// Example: "http://localhost:5001"
	DoclingURL string
}

type UnchangedFileResult struct {
	// FilePath is the path to the file
	FilePath string `json:"file_path"`

	// Message indicates the file is unchanged
	Message string `json:"message"`
}