files

type FileSaver interface {
	// SaveFile saves a file and returns the artifact ID (existing on dedup, new on creation).
	// messageText is the text content of the message (msg.Text or msg.Caption) for context (v0.6.0).
	SaveFile(ctx context.Context, userID int64, messageID int64, fileType string, originalName string, mimeType string, reader io.Reader, messageText string) (*int64, error)
}

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

type FileTooLargeError struct {
	Size     int64
	FileName string
}

type FileType string

type ProcessedFile struct {
	// LLMParts contains the file data formatted for OpenRouter API
	// (FilePart, TextPart from openrouter package) (v0.6.0: unified on FilePart)
	LLMParts []interface{}

	// Instruction is the localized LLM instruction for this file type
	// (e.g., "Quote the transcription..." for voice messages)
	Instruction string

	// FileType indicates the type of file
	FileType FileType

	// FileID is the Telegram file ID
	FileID string

	// FileName is the original file name (if available)
	FileName string

	// MimeType is the MIME type of the file
	MimeType string

	// Size is the file size in bytes
	Size int64

	// Duration is the download time (for metrics)
	Duration time.Duration

	// ArtifactID is the ID of the saved artifact (nil if not saved or disabled)
	ArtifactID *int64
}

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

type SavedFile struct {
	Path        string // Relative path from base
	ContentHash string // SHA256 hex
	Size        int64  // Bytes
}

type UnsupportedFormatError struct {
	MimeType string
	FileName string
}