docling

const (
	// ConvertToolName is the name of the docling_convert tool.
	ConvertToolName = "docling_convert"

	// ConvertDisplayName is the display name of the docling_convert tool.
	ConvertDisplayName = "Docling Convert"

	// ConvertSearchHint is a hint for tool search functionality.
	ConvertSearchHint = "OCR a scanned PDF, extract a complex slide deck, or transcribe audio via docling"

	// ConvertDescription is the description of the docling_convert tool.
	ConvertDescription = "Convert a local file to markdown using docling-serve: OCR, layout analysis, table structure, and audio transcription.\n\n" +
		"## When to use\n\n" +
		"- A scanned/image-only PDF that FileRead reports as having little or no extractable text\n" +
		"- A complex slide deck (PPTX) with diagrams, charts, or embedded images that need OCR\n" +
		"- Audio files (WAV, MP3) that need transcription\n" +
		"- A DOCX/PPTX/XLSX that FileRead's native extraction failed on\n\n" +
		"## When NOT to use\n\n" +
		"- Plain text-native PDFs, or simple DOCX/PPTX/XLSX — use FileRead instead, it extracts them natively without the network round-trip to docling-serve\n" +
		"- FileRead already tries docling automatically as a last resort for unreadable files, so you usually don't need this tool for a first read. Reach for it when you want deliberate control: forcing a reconversion, or converting a file FileRead didn't route to docling.\n\n" +
		"## Rules\n\n" +
		"- Requires docling-serve to be configured (DOCLING_URL).\n"
)

const (
	// ReadURLToolName is the name of the read_document_url tool.
	ReadURLToolName = "read_document_url"

	// ReadURLDisplayName is the display name of the read_document_url tool.
	ReadURLDisplayName = "Read Document URL"

	// ReadURLSearchHint is a hint for tool search functionality.
	ReadURLSearchHint = "fetch and convert a remote document or web page to markdown"

	// ReadURLDescription is the description of the read_document_url tool.
	ReadURLDescription = "Fetch a document at a URL and convert it to readable markdown. " +
		"Supports PDF, DOCX, PPTX, XLSX, HTML pages, and arXiv papers. " +
		"Requires docling-serve to be configured. " +
		"Optionally saves the extracted markdown to a workspace path."
)