excel

const (
	// ToolName is the name of the Excel edit tool.
	ToolName = "excel_edit"

	// SearchHint is a hint for tool search functionality.
	SearchHint = "write or edit cells in an Excel (.xlsx) spreadsheet"

	// ToolDescription is the description of the excel_edit tool.
	ToolDescription = "Write values (and formulas) into an Excel (.xlsx) spreadsheet, creating the file or sheet if they don't exist yet.\n\n" +
		"## When to use\n\n" +
		"- Creating a new .xlsx file with data\n" +
		"- Updating specific cells or a block of cells in an existing spreadsheet\n" +
		"- Writing formulas (any value starting with \"=\" is set as a formula, e.g. \"=SUM(A1:A10)\")\n\n" +
		"## When NOT to use\n\n" +
		"- Reading spreadsheet content — use FileRead instead (it extracts .xlsx natively, no need to write anything first)\n" +
		"- Plain CSV/text data — use FileWrite\n\n" +
		"## Rules\n\n" +
		"- values is a 2D array (rows of cells): [[\"Name\", \"Score\"], [\"Alice\", 90], [\"Bob\", 85]]\n" +
		"- range is the top-left cell to start writing at (e.g. \"B2\"); values fills out from there row by row, column by column. Omit it to start at A1.\n" +
		"- sheet defaults to the workbook's first sheet; naming a sheet that doesn't exist yet creates it.\n" +
		"- If the file already exists, you must read it with FileRead first (same rule as FileWrite) — this tool errors otherwise, since a spreadsheet write can silently clobber other cells' formulas/formatting if made blind.\n"
)