answer42 0.2.22__tar.gz → 0.2.23__tar.gz

{answer42-0.2.22 → answer42-0.2.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: answer42
-Version: 0.2.22
+Version: 0.2.23
 Summary: Answer42 — The Answer to Life, Universe, and 1C — UI Driver. MCP-powered 1C:Enterprise UI automation: click, fill, navigate, test, and introspect managed forms through the test-client API
 Author: Marvin (AI Assistant), 42Clouds, and contributors
 Author-email: "Kosolapov Stanislav (proDOOMman)" <prodoomman@gmail.com>

{answer42-0.2.22 → answer42-0.2.23}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "answer42"
-version = "0.2.22"
+version = "0.2.23"
 description = "Answer42 — The Answer to Life, Universe, and 1C — UI Driver. MCP-powered 1C:Enterprise UI automation: click, fill, navigate, test, and introspect managed forms through the test-client API"
 readme = "README.md"
 requires-python = ">=3.11"

{answer42-0.2.22 → answer42-0.2.23}/src/cf/DataProcessors/MCPTestManager/Forms//320/244/320/276/321/200/320/274/320/260/Ext/Form/Module.bsl

@@ -298,6 +298,8 @@
 		Возврат ТекстТабличногоДокумента(Параметры);
 	ИначеЕсли Метод = "tabular_document_save" Тогда
 		Возврат СохранитьТабличныйДокументMCP(Параметры);
+	ИначеЕсли Метод = "tabular_document_state_display" Тогда
+		Возврат ОтображениеСостоянияТабличногоДокументаMCP(Параметры);
 	ИначеЕсли Метод = "set_field_value" Тогда
 		Возврат УстановитьЗначениеПоля(Параметры);
 	ИначеЕсли Метод = "activate_field" Тогда
@@ -2938,19 +2940,22 @@
 	Попытка
 		Подчиненные = БезопасныеПодчиненные(Объект);
 		Для Каждого Подчиненный Из Подчиненные Цикл
-			ТипТек = НормализованноеИмяТипа(Строка(ТипЗнч(Подчиненный)));
-			Если ТипТек = "тестируемоеполетабличногодокументаформы" Тогда
+			Если ЭтоИскомоеПолеТабличногоДокумента(Подчиненный, "", "") Тогда
 				Элемент = Новый Структура;
 				Элемент.Вставить("name", БезопасноеСвойство(Подчиненный, "Имя", ""));
 				Элемент.Вставить("title", БезопасныйЗаголовок(Подчиненный));
+				Элемент.Вставить("type", Строка(ТипЗнч(Подчиненный)));
+				Элемент.Вставить("data", БезопасноеПредставлениеДанныхПоля(Подчиненный));
 				Если ВключатьТекст Тогда
-					Попытка
-						Область = Подчиненный.ПолучитьТекущуюОбласть();
-						Текст = БезопасныйАдресТекущейОбласти(Область);
-						Элемент.Вставить("text", Текст);
-					Исключение
-						Элемент.Вставить("text_error", ОписаниеОшибки());
-					КонецПопытки;
+					ТекстДокумента = ТекстТабличногоДокументаИзПоля(Подчиненный);
+					Если ТекстДокумента.Свойство("error") Тогда
+						Элемент.Вставить("text_error", ТекстДокумента.error);
+					Иначе
+						Элемент.Вставить("rows", ТекстДокумента.rows);
+						Элемент.Вставить("columns", ТекстДокумента.columns);
+						Элемент.Вставить("address", ТекстДокумента.address);
+						Элемент.Вставить("text", ТекстДокумента.text);
+					КонецЕсли;
 				КонецЕсли;
 				Результат.Добавить(Элемент);
 			КонецЕсли;
@@ -2987,35 +2992,101 @@
 	Если Поле = Неопределено Тогда
 		Возврат Новый Структура("found", Ложь);
 	КонецЕсли;
+	ДанныеТекста = ТекстТабличногоДокументаИзПоля(Поле);
+	Если ДанныеТекста.Свойство("error") Тогда
+		Возврат Новый Структура("found,error", Истина, ДанныеТекста.error);
+	КонецЕсли;
+	Возврат Новый Структура("found,rows,columns,address,text,cells", Истина, ДанныеТекста.rows, ДанныеТекста.columns, ДанныеТекста.address, ДанныеТекста.text, ДанныеТекста.cells);
+КонецФункции
+
+&НаКлиенте
+Функция ТекстТабличногоДокументаИзПоля(Поле)
 	Попытка
-		Поле.УстановитьТекущуюОбласть(1, 1, 1, 1);
-		КоличествоСтрок = БезопасноеСвойство(Поле, "КоличествоСтрок", 0);
-		КоличествоКолонок = БезопасноеСвойство(Поле, "КоличествоКолонок", 0);
+		КоличествоСтрок = Поле.ПолучитьРазмерОбластиДанныхДокументаПоВертикали();
+		КоличествоКолонок = Поле.ПолучитьРазмерОбластиДанныхДокументаПоГоризонтали();
 		Если КоличествоСтрок = 0 Или КоличествоКолонок = 0 Тогда
-			Возврат Новый Структура("found,rows,columns,cells", Истина, 0, 0, Новый Массив);
+			Возврат Новый Структура("rows,columns,address,text,cells", 0, 0, "", "", Новый Массив);
 		КонецЕсли;
+		АдресВсейОбласти = АдресОбластиТабличногоДокументаMCP(1, 1, КоличествоСтрок, КоличествоКолонок);
+		ТекстВсейОбласти = Поле.ПолучитьТекстОбласти(АдресВсейОбласти);
 		МаксСтрок = Мин(КоличествоСтрок, 50);
 		МаксКолонок = Мин(КоличествоКолонок, 20);
 		Ячейки = Новый Массив;
 		Для НомерСтроки = 1 По МаксСтрок Цикл
-			Строка = Новый Массив;
+			СтрокаТекстов = Новый Массив;
 			Для НомерКолонки = 1 По МаксКолонок Цикл
 				Попытка
-					Область = Поле.Область(НомерСтроки, НомерКолонки);
-					Текст = БезопасноеСвойство(Область, "Текст", "");
-					Строка.Добавить(?(ТипЗнч(Текст) = Тип("Строка"), Текст, Строка(Текст)));
+					АдресЯчейки = АдресОбластиТабличногоДокументаMCP(НомерСтроки, НомерКолонки, НомерСтроки, НомерКолонки);
+					СтрокаТекстов.Добавить(Поле.ПолучитьТекстОбласти(АдресЯчейки));
 				Исключение
-					Строка.Добавить("");
+					СтрокаТекстов.Добавить("");
 				КонецПопытки;
 			КонецЦикла;
-			Ячейки.Добавить(Строка);
+			Ячейки.Добавить(СтрокаТекстов);
 		КонецЦикла;
-	Возврат Новый Структура("found,rows,columns,cells", Истина, КоличествоСтрок, КоличествоКолонок, Ячейки);
+		Возврат Новый Структура("rows,columns,address,text,cells", КоличествоСтрок, КоличествоКолонок, АдресВсейОбласти, ТекстВсейОбласти, Ячейки);
+	Исключение
+		Возврат Новый Структура("error", ОписаниеОшибки());
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция АдресОбластиТабличногоДокументаMCP(НачальнаяСтрока, НачальнаяКолонка, КонечнаяСтрока, КонечнаяКолонка)
+	Начало = "R" + Строка(НачальнаяСтрока) + "C" + Строка(НачальнаяКолонка);
+	Конец = "R" + Строка(КонечнаяСтрока) + "C" + Строка(КонечнаяКолонка);
+	Возврат Начало + ":" + Конец;
+КонецФункции
+
+&НаКлиенте
+Функция ОтображениеСостоянияТабличногоДокументаMCP(Параметры)
+	Если ТестируемоеПриложение = Неопределено Тогда
+		ВызватьИсключение "Тестируемое приложение не подключено.";
+	КонецЕсли;
+	АктивноеОкно = ТестируемоеПриложение.ПолучитьАктивноеОкно();
+	Имя = СвойствоСтруктуры(Параметры, "name", "");
+	Заголовок = СвойствоСтруктуры(Параметры, "title", "");
+	Глубина = СвойствоСтруктуры(Параметры, "max_depth", 8);
+	Поле = НайтиТабличныйДокументПоПараметрам(АктивноеОкно, Имя, Заголовок, 0, Глубина);
+	Если Поле = Неопределено Тогда
+		Возврат Новый Структура("found", Ложь);
+	КонецЕсли;
+	Попытка
+		Отображение = Поле.ПолучитьОтображениеСостояния();
+		Если Отображение = Неопределено Тогда
+			Возврат Новый Структура("found,state_display", Истина, Неопределено);
+		КонецЕсли;
+		Состояние = Новый Структура;
+		Состояние.Вставить("display_variant", Строка(БезопасноеСвойство(Отображение, "ВариантОтображения", "")));
+		Состояние.Вставить("visible", БезопасноеСвойство(Отображение, "Видимость", Ложь));
+		Состояние.Вставить("additional_show_mode", Строка(БезопасноеСвойство(Отображение, "ДополнительныйРежимОтображения", "")));
+		Состояние.Вставить("command_name", Строка(БезопасноеСвойство(Отображение, "ИмяКоманды", "")));
+		Состояние.Вставить("picture", Строка(БезопасноеСвойство(Отображение, "Картинка", "")));
+		Состояние.Вставить("text", Строка(БезопасноеСвойство(Отображение, "Текст", "")));
+		Возврат Новый Структура("found,state_display", Истина, Состояние);
 	Исключение
 		Возврат Новый Структура("found,error", Истина, ОписаниеОшибки());
 	КонецПопытки;
 КонецФункции
 
+&НаКлиенте
+Функция ФайлСуществуетMCP(Путь)
+	Попытка
+		Файл = Новый Файл(Путь);
+		Возврат Файл.Существует();
+	Исключение
+		Возврат Ложь;
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция БезопасноеПредставлениеДанныхПоля(Поле)
+	Попытка
+		Возврат Строка(Поле.ПолучитьПредставлениеДанных());
+	Исключение
+		Возврат "";
+	КонецПопытки;
+КонецФункции
+
 &НаКлиенте
 Функция СохранитьТабличныйДокументMCP(Параметры)
 	Если ТестируемоеПриложение = Неопределено Тогда
@@ -3036,62 +3107,34 @@
 	КонецЕсли;
 
 	// Для tested form field extension for spreadsheet document direct Записать()
-	// недоступен/ненадежен; используем штатный метод tested field
-	// ЗаписатьСодержимоеВФайл(<СохранитьКак>) и очередь результата файлового
-	// диалога. Для PDF пробуем несколько индексов фильтра и оба значения
-	// <СохранитьКак> (Истина/Ложь), чтобы не угадывать поведение конкретной формы.
-	Если ФорматФайла = "pdf" Тогда
-		Файлы = Новый Массив;
-		Ошибки = Новый Массив;
-		ВариантыСохранитьКак = Новый Массив;
-		ВариантыСохранитьКак.Добавить(Истина);
-		ВариантыСохранитьКак.Добавить(Ложь);
-		Для Каждого СохранитьКак Из ВариантыСохранитьКак Цикл
-			Для ИндексФильтра = 1 По 10 Цикл
-				ПутьПопытки = ДобавитьСуффиксКПутиMCP(Путь, "_saveas_" + ?(СохранитьКак, "true", "false") + "_filter" + Строка(ИндексФильтра));
-				Попытка
-					ТестируемоеПриложение.УстановитьРезультатДиалогаВыбораФайла(Истина, ПутьПопытки, ИндексФильтра);
-					Поле.ЗаписатьСодержимоеВФайл(СохранитьКак);
-					ОписаниеФайла = Новый Структура("path,filter_index,save_as", ПутьПопытки, ИндексФильтра, СохранитьКак);
-					Файлы.Добавить(ОписаниеФайла);
-				Исключение
-					Ошибки.Добавить(Новый Структура("filter_index,save_as,error", ИндексФильтра, СохранитьКак, ОписаниеОшибки()));
-				КонецПопытки;
-			КонецЦикла;
+	// недоступен/ненадежен; сначала для любого формата перебираем фильтры
+	// штатного файлового диалога, а Python-сторона проверяет сигнатуру/расширение
+	// реально созданного файла нужного формата.
+	ФайлыФильтров = Новый Массив;
+	ОшибкиФильтров = Новый Массив;
+	ВариантыСохранитьКак = Новый Массив;
+	ВариантыСохранитьКак.Добавить(Истина);
+	ВариантыСохранитьКак.Добавить(Ложь);
+	Для Каждого СохранитьКак Из ВариантыСохранитьКак Цикл
+		Для ИндексФильтра = 1 По 30 Цикл
+			ПутьПопытки = ДобавитьСуффиксКПутиMCP(Путь, "_saveas_" + ?(СохранитьКак, "true", "false") + "_filter" + Строка(ИндексФильтра));
+			Попытка
+				ТестируемоеПриложение.УстановитьРезультатДиалогаВыбораФайла(Истина, ПутьПопытки, ИндексФильтра);
+				Поле.ЗаписатьСодержимоеВФайл(СохранитьКак);
+				// Не проверяем существование файла на стороне 1С синхронно: web/ws
+				// клиент может материализовать файл чуть позже. Возвращаем все
+				// успешные попытки, а Python-сторона проверяет факт, сигнатуру и формат.
+				ФайлыФильтров.Добавить(Новый Структура("path,filter_index,save_as", ПутьПопытки, ИндексФильтра, СохранитьКак));
+			Исключение
+				ОшибкиФильтров.Добавить(Новый Структура("filter_index,save_as,error", ИндексФильтра, СохранитьКак, ОписаниеОшибки()));
+			КонецПопытки;
 		КонецЦикла;
-		Если Файлы.Количество() > 0 Тогда
-			Возврат Новый Структура("saved,path,format,method,files,errors", Истина, Путь, ФорматФайла, "write_content_to_file_dialog_filters", Файлы, Ошибки);
-		КонецЕсли;
-		Возврат Новый Структура("saved,path,format,method,files,errors", Ложь, Путь, ФорматФайла, "write_content_to_file_dialog_filters", Файлы, Ошибки);
+	КонецЦикла;
+	Если ФайлыФильтров.Количество() > 0 Тогда
+		Возврат Новый Структура("saved,path,format,method,files,errors", Истина, Путь, ФорматФайла, "write_content_to_file_dialog_filters", ФайлыФильтров, ОшибкиФильтров);
 	КонецЕсли;
 
-	ОшибкаЗаписатьСодержимое = "";
-	Попытка
-		ТестируемоеПриложение.УстановитьРезультатДиалогаВыбораФайла(Истина, Путь, ИндексФильтраДиалогаТабличногоДокументаMCP(ФорматФайла));
-		Поле.ЗаписатьСодержимоеВФайл(Истина);
-		Возврат Новый Структура("saved,path,format,method,save_as", Истина, Путь, ФорматФайла, "write_content_to_file_dialog", Истина);
-	Исключение
-		ОшибкаЗаписатьСодержимое = ОписаниеОшибки();
-	КонецПопытки;
-	Попытка
-		ТестируемоеПриложение.УстановитьРезультатДиалогаВыбораФайла(Истина, Путь, ИндексФильтраДиалогаТабличногоДокументаMCP(ФорматФайла));
-		Поле.ЗаписатьСодержимоеВФайл(Ложь);
-		Возврат Новый Структура("saved,path,format,method,save_as", Истина, Путь, ФорматФайла, "write_content_to_file_dialog", Ложь);
-	Исключение
-		Если Не ПустаяСтрока(ОшибкаЗаписатьСодержимое) Тогда
-			ОшибкаЗаписатьСодержимое = ОшибкаЗаписатьСодержимое + Символы.ПС + ОписаниеОшибки();
-		Иначе
-			ОшибкаЗаписатьСодержимое = ОписаниеОшибки();
-		КонецЕсли;
-	КонецПопытки;
-
-	Попытка
-		ТипФайла = ТипФайлаТабличногоДокументаMCP(ФорматФайла);
-		Поле.Записать(Путь, ТипФайла);
-		Возврат Новый Структура("saved,path,format,method", Истина, Путь, ФорматФайла, "write_direct");
-	Исключение
-		Возврат Новый Структура("saved,path,format,error,content_error", Ложь, Путь, ФорматФайла, ОписаниеОшибки(), ОшибкаЗаписатьСодержимое);
-	КонецПопытки;
+	Возврат Новый Структура("saved,path,format,method,files,errors,error", Ложь, Путь, ФорматФайла, "write_content_to_file_dialog_filters", ФайлыФильтров, ОшибкиФильтров, "Ни один фильтр файлового диалога не выполнил сохранение табличного документа");
 КонецФункции
 
 &НаКлиенте
@@ -3118,8 +3161,6 @@
 		Возврат ТипФайлаТабличногоДокумента.XLSX;
 	ИначеЕсли Формат = "xls" Тогда
 		Возврат ТипФайлаТабличногоДокумента.XLS;
-	ИначеЕсли Формат = "mxl" Тогда
-		Возврат ТипФайлаТабличногоДокумента.MXL;
 	ИначеЕсли Формат = "html" Или Формат = "htm" Тогда
 		Возврат ТипФайлаТабличногоДокумента.HTML;
 	ИначеЕсли Формат = "txt" Тогда
@@ -3138,8 +3179,6 @@
 		Возврат 2;
 	ИначеЕсли Формат = "xls" Тогда
 		Возврат 3;
-	ИначеЕсли Формат = "mxl" Тогда
-		Возврат 4;
 	ИначеЕсли Формат = "html" Или Формат = "htm" Тогда
 		Возврат 5;
 	ИначеЕсли Формат = "txt" Тогда
@@ -3179,7 +3218,10 @@
 	ТипТек = НормализованноеИмяТипа(Строка(ТипЗнч(Объект)));
 	ЭтоПолеТабличногоДокумента = ТипТек = "тестируемоеполетабличногодокументаформы";
 	Если Не ЭтоПолеТабличногоДокумента И ТипТек = "тестируемоеполеформы" Тогда
-		ЭтоПолеТабличногоДокумента = ПредставлениеДанныхПоляТабличныйДокумент(Объект);
+		// На некоторых отчетах ПолучитьПредставлениеДанных() у поля табличного
+		// документа падает, пока поле недоступно для интерактивных действий.
+		// Поэтому сначала проверяем Вид поля, затем представление данных.
+		ЭтоПолеТабличногоДокумента = ВидПоляТабличныйДокумент(Объект) Или ПредставлениеДанныхПоляТабличныйДокумент(Объект);
 	КонецЕсли;
 	Если Не ЭтоПолеТабличногоДокумента Тогда
 		Возврат Ложь;
@@ -3189,6 +3231,15 @@
 	Возврат (ПустаяСтрока(Имя) Или ИмяТек = Имя) И (ПустаяСтрока(Заголовок) Или ЗаголовокТек = Заголовок);
 КонецФункции
 
+&НаКлиенте
+Функция ВидПоляТабличныйДокумент(Поле)
+	Попытка
+		Возврат НРег(Строка(Поле.Вид)) = "полетабличногодокумента";
+	Исключение
+		Возврат Ложь;
+	КонецПопытки;
+КонецФункции
+
 &НаКлиенте
 Функция ПредставлениеДанныхПоляТабличныйДокумент(Поле)
 	Попытка

{answer42-0.2.22 → answer42-0.2.23}/src/client_cf/Catalogs//320/237/320/241_/320/222/320/273/320/260/320/264/320/265/320/273/320/265/321/206.xml

@@ -36,7 +36,7 @@
 			<Owners/>
 			<SubordinationUse>ToItems</SubordinationUse>
 			<CodeLength>9</CodeLength>
-			<DescriptionLength>25</DescriptionLength>
+			<DescriptionLength>80</DescriptionLength>
 			<CodeType>String</CodeType>
 			<CodeAllowedLength>Variable</CodeAllowedLength>
 			<CodeSeries>WholeCatalog</CodeSeries>

{answer42-0.2.22 → answer42-0.2.23}/src/client_cf/Catalogs//320/237/320/241_/320/241/320/277/321/200/320/260/320/262/320/276/321/207/320/275/320/270/320/2721.xml

@@ -36,7 +36,7 @@
 			<Owners/>
 			<SubordinationUse>ToItems</SubordinationUse>
 			<CodeLength>9</CodeLength>
-			<DescriptionLength>25</DescriptionLength>
+			<DescriptionLength>80</DescriptionLength>
 			<CodeType>String</CodeType>
 			<CodeAllowedLength>Variable</CodeAllowedLength>
 			<CodeSeries>WholeCatalog</CodeSeries>
@@ -90,7 +90,7 @@
 					<Type>
 						<v8:Type>xs:string</v8:Type>
 						<v8:StringQualifiers>
-							<v8:Length>10</v8:Length>
+							<v8:Length>80</v8:Length>
 							<v8:AllowedLength>Variable</v8:AllowedLength>
 						</v8:StringQualifiers>
 					</Type>

{answer42-0.2.22 → answer42-0.2.23}/src/mcp_1c/server.py

@@ -3288,7 +3288,7 @@ async def tabular_document_save(
     name: Annotated[str, "Tabular document field technical name"] = "",
     title: Annotated[str, "Tabular document field visible title"] = "",
     path: Annotated[str, "Output file path; empty = auto-generated temp path"] = "",
-    format: Annotated[str, "Output format: pdf | xlsx | xls | mxl | html | txt"] = "pdf",
+    format: Annotated[str, "Output format: pdf | xlsx | xls | html | txt"] = "pdf",
     max_depth: Annotated[int, "Maximum search depth"] = 8,
     *,
     session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
@@ -3298,15 +3298,32 @@ async def tabular_document_save(
     return _select_saved_tabular_document_file(result, format)
 
 
+@mcp.tool()
+async def tabular_document_state_display(
+    name: Annotated[str, "Tabular document field technical name"] = "",
+    title: Annotated[str, "Tabular document field visible title"] = "",
+    max_depth: Annotated[int, "Maximum search depth"] = 8,
+    *,
+    session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
+) -> Any:
+    """Return the state display of a tabular document field, when exposed by 1C."""
+    return await _bridge_call_recorded(session_id, "tabular_document_state_display", {"name": name, "title": title, "max_depth": max_depth})
+
+
 def _select_saved_tabular_document_file(result: Any, format: str) -> Any:
     if not isinstance(result, dict):
         return result
     files = result.get("files")
     if not isinstance(files, list) or not files:
+        if result.get("found", True) is not False:
+            result["saved"] = False
+            result.setdefault("error", f"No files were produced for requested tabular document format: {format.lower()}")
         return result
     selected = _find_saved_tabular_document_file(files, format)
     if selected is None:
         result["selected"] = None
+        result["saved"] = False
+        result["error"] = f"No produced file matches requested tabular document format: {format.lower()}"
         return result
     selected_path = selected.get("path")
     requested_path = result.get("path")
@@ -3333,22 +3350,54 @@ def _find_saved_tabular_document_file(files: list[Any], format: str) -> dict[str
         if not p.is_file():
             continue
         try:
-            header = p.read_bytes()[:8]
+            data = p.read_bytes()
+            header = data[:8]
         except OSError:
             continue
         if wanted == "pdf" and header.startswith(b"%PDF"):
             return item
-        if wanted in {"xlsx", "docx"} and header.startswith(b"PK\x03\x04"):
+        if wanted == "xlsx" and _zip_contains(p, "xl/workbook.xml"):
+            return item
+        if wanted == "docx" and _zip_contains(p, "word/document.xml"):
             return item
         if wanted == "xls" and header.startswith(bytes.fromhex("d0cf11e0a1b11ae1")):
             return item
-        if wanted in {"html", "htm"} and (header.startswith(b"<") or header.startswith(b"\xef\xbb\xbf<")):
+        if wanted in {"html", "htm"} and (data.startswith(b"<") or data.startswith(b"\xef\xbb\xbf<")):
             return item
-        if wanted in {"txt", "mxl"} and p.stat().st_size > 0:
+        if wanted == "txt" and _looks_like_plain_text(data):
             return item
     return None
 
 
+def _zip_contains(path: Path, member: str) -> bool:
+    import zipfile
+
+    try:
+        with zipfile.ZipFile(path) as archive:
+            return member in archive.namelist()
+    except Exception:
+        return False
+
+
+def _looks_like_plain_text(data: bytes) -> bool:
+    if not data:
+        return False
+    sample = data[:4096]
+    if sample.startswith(b"\xef\xbb\xbf"):
+        sample = sample[3:]
+    stripped = sample.lstrip().lower()
+    if stripped.startswith((b"<", b"<!doctype", b"<html")):
+        return False
+    if b"\x00" in sample:
+        return False
+    try:
+        sample.decode("utf-8")
+        return True
+    except UnicodeDecodeError:
+        return False
+
+
+
 @mcp.tool()
 async def toggle_field(
     field_name: Annotated[str, "Field technical name"],