answer42 0.2.28__tar.gz → 0.2.29__tar.gz

{answer42-0.2.28 → answer42-0.2.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: answer42
-Version: 0.2.28
+Version: 0.2.29
 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.28 → answer42-0.2.29}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "answer42"
-version = "0.2.28"
+version = "0.2.29"
 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.28 → answer42-0.2.29}/src/cf/DataProcessors/MCPTestManager/Forms//320/244/320/276/321/200/320/274/320/260/Ext/Form/Module.bsl

@@ -240,7 +240,7 @@
 
 &НаКлиенте
 Функция ВерсияПротоколаМенеджераMCP()
-	Возврат "2026.07.02.3";
+	Возврат "2026.07.02.4";
 КонецФункции
 
 &НаКлиенте
@@ -294,6 +294,8 @@
 		Возврат НажатьКнопку(Параметры);
 	ИначеЕсли Метод = "find_object" Тогда
 		Возврат НайтиОбъектИнтерфейса(Параметры);
+	ИначеЕсли Метод = "search_objects" Тогда
+		Возврат НайтиВсеОбъектыИнтерфейса(Параметры);
 	ИначеЕсли Метод = "get_object" Тогда
 		Возврат ПолучитьОбъектПриложенияMCP(Параметры);
 	ИначеЕсли Метод = "activate_object" Тогда
@@ -2565,6 +2567,51 @@
 	Возврат Неопределено;
 КонецФункции
 
+&НаКлиенте
+Функция НайтиВсеОбъектыИнтерфейса(Параметры)
+	Если ТестируемоеПриложение = Неопределено Тогда
+		ВызватьИсключение "Тестируемое приложение не подключено.";
+	КонецЕсли;
+	АктивноеОкно = ТестируемоеПриложение.ПолучитьАктивноеОкно();
+	Имя = СвойствоСтруктуры(Параметры, "name", "");
+	Заголовок = СвойствоСтруктуры(Параметры, "title", "");
+	ТипОбъекта = СвойствоСтруктуры(Параметры, "type", "");
+	Глубина = СвойствоСтруктуры(Параметры, "max_depth", 8);
+	Лимит = СвойствоСтруктуры(Параметры, "limit", 50);
+	Найденные = Новый Массив;
+	НайтиВсеОбъектыРекурсивно(АктивноеОкно, Имя, Заголовок, ТипОбъекта, 0, Глубина, Лимит, Найденные);
+	Возврат Новый Структура("found,count,limit,objects", Найденные.Количество() > 0, Найденные.Количество(), Лимит, Найденные);
+КонецФункции
+
+&НаКлиенте
+Процедура НайтиВсеОбъектыРекурсивно(РодительскийОбъект, Имя, Заголовок, ТипОбъекта, ТекущаяГлубина, МаксимальнаяГлубина, Лимит, Найденные)
+	Если ТекущаяГлубина > МаксимальнаяГлубина Тогда
+		Возврат;
+	КонецЕсли;
+	Если Найденные.Количество() >= Лимит Тогда
+		Возврат;
+	КонецЕсли;
+	Попытка
+		ИмяТекущего = БезопасноеСвойство(РодительскийОбъект, "Имя", "");
+		ЗаголовокТекущего = БезопасныйЗаголовок(РодительскийОбъект);
+		ТипТекущего = Строка(ТипЗнч(РодительскийОбъект));
+		НормализованныйТип = НормализованноеИмяТипа(ТипТекущего);
+		Если ОбъектСоответствует(ИмяТекущего, ЗаголовокТекущего, НормализованныйТип, Имя, Заголовок, ТипОбъекта) Тогда
+			Найденные.Добавить(ОбъектВСтруктуру(РодительскийОбъект, 0, 0));
+		КонецЕсли;
+		Подчиненные = БезопасныеПодчиненные(РодительскийОбъект);
+		Для Каждого Подчиненный Из Подчиненные Цикл
+			Если Найденные.Количество() >= Лимит Тогда
+				Прервать;
+			КонецЕсли;
+			НайтиВсеОбъектыРекурсивно(Подчиненный, Имя, Заголовок, ТипОбъекта, ТекущаяГлубина + 1, МаксимальнаяГлубина, Лимит, Найденные);
+		КонецЦикла;
+	Исключение
+		Инфо = ИнформацияОбОшибке();
+		Лог("Подавленное исключение: " + ПодробноеПредставлениеОшибки(Инфо));
+	КонецПопытки;
+КонецПроцедуры
+
 &НаКлиенте
 Функция ОбъектСоответствует(ИмяОбъекта, ЗаголовокОбъекта, ТипОбъекта, ИскомоеИмя, ИскомыйЗаголовок, ИскомыйТип)
 	НормализованноеИмя = НРег(СокрЛП(ИмяОбъекта));
@@ -3727,7 +3774,7 @@
 			Если Представления.Количество() > 0 Тогда
 				ИндексВыбора = ИндексРелевантногоВариантаСпискаВыбораMCP(Представления, Значение);
 				Если ИндексВыбора = Неопределено Тогда
-					Поле.ЗакрытьВыпадающийСписок();
+					ОтменитьРедактированиеПоляЕслиНужноMCP(Поле);
 					ВызватьИсключение "Выпадающий список открыт, но релевантный вариант для значения " + Значение + " не найден";
 				КонецЕсли;
 				ПредставлениеВыбираемогоВарианта = ПредставлениеВариантаСпискаВыбораMCP(Представления[ИндексВыбора]);
@@ -3783,6 +3830,7 @@
 	КонецПопытки;
 
 	Если ТекстовыйВводВыполнен Тогда
+		ОтменитьРедактированиеПоляЕслиНужноMCP(Поле);
 		ВызватьИсключение "Не удалось установить поле " + ИмяПоля + ": ВвестиТекст выполнен, но значение не подтвердилось; текущее представление: " + НеподтвержденноеПредставлениеПослеВвода;
 	КонецЕсли;
 
@@ -3878,6 +3926,7 @@
 		Ошибки.Добавить("УстановитьЗначение=" + ОписаниеОшибки());
 	КонецПопытки;
 
+	ОтменитьРедактированиеПоляЕслиНужноMCP(Поле);
 	ВызватьИсключение "Не удалось установить поле " + ИмяПоля + ": " + СтрСоединить(Ошибки, "; ");
 КонецФункции
 
@@ -4324,15 +4373,93 @@
 КонецФункции
 
 &НаКлиенте
-Процедура ОбеспечитьРедактированиеТекущейСтрокиТаблицыMCP(Таблица)
+Функция ОбеспечитьРедактированиеТекущейСтрокиТаблицыMCP(Таблица)
 	Таблица.Активизировать();
+	УжеРедактируется = ТаблицаВРежимеРедактированияMCP(Таблица);
+	Если УжеРедактируется Тогда
+		Возврат Новый Структура("editing,changed,error", Истина, Ложь, "");
+	КонецЕсли;
 	Попытка
-		Если Не Таблица.ТекущийРежимРедактирование() Тогда
-			Таблица.ИзменитьСтроку();
+		Таблица.ИзменитьСтроку();
+		Возврат Новый Структура("editing,changed,error", ТаблицаВРежимеРедактированияMCP(Таблица), Истина, "");
+	Исключение
+		// После ДобавитьСтроку() таблица может быть в промежуточном состоянии
+		// добавления/редактирования, где ИзменитьСтроку() уже неприменима
+		// ("Неподходящее состояние элемента управления"), но редактор текущей
+		// строки уже доступен. Не падаем здесь: дальше ищем поле редактора;
+		// если его нет — вернём точную ошибку поиска/установки.
+		Возврат Новый Структура("editing,changed,error", ТаблицаВРежимеРедактированияMCP(Таблица), Ложь, ОписаниеОшибки());
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция ТаблицаВРежимеРедактированияMCP(Таблица)
+	Попытка
+		Возврат Таблица.ТекущийРежимРедактирование();
+	Исключение
+		Возврат Ложь;
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция ЗавершитьРедактированиеСтрокиТаблицыMCP(Таблица)
+	ОшибкаЗавершения = "";
+	БылаВРедактировании = ТаблицаВРежимеРедактированияMCP(Таблица);
+	Попытка
+		Если БылаВРедактировании Тогда
+			Таблица.ЗакончитьРедактированиеСтроки(Ложь);
 		КонецЕсли;
 	Исключение
-		Таблица.ИзменитьСтроку();
+		ОшибкаЗавершения = ОписаниеОшибки();
 	КонецПопытки;
+
+	ОсталасьВРедактировании = ТаблицаВРежимеРедактированияMCP(Таблица);
+	ОтменаВыполнена = Ложь;
+	ОшибкаОтмены = "";
+	Если ОсталасьВРедактировании Тогда
+		Попытка
+			Таблица.ЗакончитьРедактированиеСтроки(Истина);
+			ОтменаВыполнена = Истина;
+		Исключение
+			ОшибкаОтмены = ОписаниеОшибки();
+		КонецПопытки;
+	КонецЕсли;
+
+	ВсеЕщеВРедактировании = ТаблицаВРежимеРедактированияMCP(Таблица);
+	Возврат Новый Структура("was_editing,commit_error,remained_editing,cancel_done,cancel_error,still_editing", БылаВРедактировании, ОшибкаЗавершения, ОсталасьВРедактировании, ОтменаВыполнена, ОшибкаОтмены, ВсеЕщеВРедактировании);
+КонецФункции
+
+&НаКлиенте
+Функция НайтиРодительскуюТаблицуMCP(Объект)
+	Текущий = Объект;
+	Пока Текущий <> Неопределено Цикл
+		Если НормализованноеИмяТипа(ТипЗнч(Текущий)) = "тестируемаятаблицаформы" Тогда
+			Возврат Текущий;
+		КонецЕсли;
+		Попытка
+			Текущий = Текущий.ПолучитьРодителя();
+		Исключение
+			Возврат Неопределено;
+		КонецПопытки;
+	КонецЦикла;
+	Возврат Неопределено;
+КонецФункции
+
+&НаКлиенте
+Процедура ОтменитьРедактированиеПоляЕслиНужноMCP(Поле)
+	Попытка
+		Если ОткрытВыпадающийСписокПоляMCP(Поле) Тогда
+			Поле.ЗакрытьВыпадающийСписок();
+		КонецЕсли;
+	Исключение
+	КонецПопытки;
+	Таблица = НайтиРодительскуюТаблицуMCP(Поле);
+	Если Таблица <> Неопределено И ТаблицаВРежимеРедактированияMCP(Таблица) Тогда
+		Попытка
+			Таблица.ЗакончитьРедактированиеСтроки(Истина);
+		Исключение
+		КонецПопытки;
+	КонецЕсли;
 КонецПроцедуры
 
 &НаКлиенте
@@ -4407,11 +4534,12 @@
 		ВызватьИсключение "Таблица не найдена: " + ИмяТаблицы;
 	КонецЕсли;
 
-	ОбеспечитьРедактированиеТекущейСтрокиТаблицыMCP(Таблица);
+	РезультатНачалаРедактирования = ОбеспечитьРедактированиеТекущейСтрокиТаблицыMCP(Таблица);
 	АктивноеОкно = ТестируемоеПриложение.ПолучитьАктивноеОкно();
 	Поле = НайтиПолеРедактораТаблицыMCP(АктивноеОкно, Таблица, ИмяТаблицы, ИмяПоля, ИскатьПоЗаголовку, МаксимальнаяГлубина);
 	Если Поле = Неопределено Тогда
-		ВызватьИсключение "Поле редактора таблицы не найдено: " + ИмяПоля;
+		ДополнениеОшибкиРедактирования = ?(ПустаяСтрока(РезультатНачалаРедактирования.error), "", "; ошибка начала редактирования: " + РезультатНачалаРедактирования.error);
+		ВызватьИсключение "Поле редактора таблицы не найдено: " + ИмяПоля + ДополнениеОшибкиРедактирования;
 	КонецЕсли;
 	ИмяРедактора = БезопасноеСвойство(Поле, "Имя", "");
 	Поле.Активизировать();
@@ -4429,14 +4557,13 @@
 		ОшибкаУстановки = ОписаниеОшибки();
 	КонецПопытки;
 
-	Попытка
-		Таблица.ЗакончитьРедактированиеСтроки(Ложь);
-	Исключение
-		Попытка
-			Таблица.ЗакончитьРедактированиеСтроки();
-		Исключение
-		КонецПопытки;
-	КонецПопытки;
+	РезультатЗавершенияРедактирования = ЗавершитьРедактированиеСтрокиТаблицыMCP(Таблица);
+	Если Не ПустаяСтрока(РезультатЗавершенияРедактирования.commit_error) Тогда
+		ВызватьИсключение "Не удалось завершить редактирование строки таблицы " + ИмяТаблицы + ": " + РезультатЗавершенияРедактирования.commit_error;
+	КонецЕсли;
+	Если РезультатЗавершенияРедактирования.still_editing Тогда
+		ВызватьИсключение "Таблица " + ИмяТаблицы + " осталась в режиме редактирования после попытки завершить и отменить редактирование строки";
+	КонецЕсли;
 
 	Проверка = ЗначениеКолонкиТекущейСтрокиMCP(Таблица, ИмяПоля, ИскатьПоЗаголовку);
 	Проверено = Проверка.found И ЗначенияСовпадаютДляПроверкиMCP(Проверка.value, Значение);
@@ -4449,7 +4576,7 @@
 	Если Не ПустаяСтрока(ОшибкаУстановки) Тогда
 		МетодУстановки = МетодУстановки + "+verified_after_exception";
 	КонецЕсли;
-	Возврат Новый Структура("set,table,field,value,editor_field,verified,verified_key,verified_value,method,current_row", Истина, ИмяТаблицы, ИмяПоля, Значение, ИмяРедактора, Проверено, Проверка.key, Проверка.value, МетодУстановки, СоответствиеВСтруктуру(Таблица.ПолучитьТекущуюСтроку()));
+	Возврат Новый Структура("set,table,field,value,editor_field,verified,verified_key,verified_value,method,edit_start,edit_finish,current_row", Истина, ИмяТаблицы, ИмяПоля, Значение, ИмяРедактора, Проверено, Проверка.key, Проверка.value, МетодУстановки, РезультатНачалаРедактирования, РезультатЗавершенияРедактирования, СоответствиеВСтруктуру(Таблица.ПолучитьТекущуюСтроку()));
 КонецФункции
 
 &НаКлиенте
@@ -4588,6 +4715,18 @@
 	СписокКнопок.Добавить(Новый Структура("name,title", "", "Вывести список..."));
 	СписокКнопок.Добавить(Новый Структура("name,title", "", "Вывести список"));
 	РезультатКнопки = НажатьПервуюКнопкуОкна(СписокКнопок, СвойствоСтруктуры(Параметры, "max_depth", 8));
+
+	// After pressing "Вывести список", a dialog opens. Confirm it.
+	КнопкиПодтверждения = Новый Массив;
+	КнопкиПодтверждения.Добавить(Новый Структура("name,title", "", "Сформировать"));
+	КнопкиПодтверждения.Добавить(Новый Структура("name,title", "", "ОК"));
+	КнопкиПодтверждения.Добавить(Новый Структура("name,title", "", "Ok"));
+	Попытка
+		НажатьПервуюКнопкуОкна(КнопкиПодтверждения, СвойствоСтруктуры(Параметры, "max_depth", 8));
+	Исключение
+		// Dialog may not appear or may auto-close; proceed anyway.
+	КонецПопытки;
+
 	Пауза = ТекущаяДата() + СвойствоСтруктуры(Параметры, "wait_seconds", 2);
 	Пока ТекущаяДата() < Пауза Цикл КонецЦикла;
 	Документы = ТабличныеДокументы(Новый Структура("include_text,max_depth", Истина, СвойствоСтруктуры(Параметры, "max_depth", 8)));
@@ -4614,7 +4753,7 @@
 	КонецЕсли;
 	Поле = СвойствоСтруктуры(Параметры, "field", "");
 	Значение = СвойствоСтруктуры(Параметры, "value", "");
-	ВидСравнения = СвойствоСтруктуры(Параметры, "comparison", "Equal");
+	ВидСравненияMCP = СвойствоСтруктуры(Параметры, "comparison", "Equal");
 	Если ПустаяСтрока(Поле) Тогда
 		ВызватьИсключение "Не задано поле отбора dynamic list.";
 	КонецЕсли;
@@ -4643,7 +4782,7 @@
 		Ошибки.Добавить("Левое значение: " + ОписаниеОшибки());
 	КонецПопытки;
 	Попытка
-		УстановитьЗначениеПоля(Новый Структура("field_name,value,search_by_title", "Вид сравнения", ВидСравнения, Истина));
+		УстановитьЗначениеПоля(Новый Структура("field_name,value,search_by_title", "Вид сравнения", ВидСравненияMCP, Истина));
 	Исключение
 		Ошибки.Добавить("Вид сравнения: " + ОписаниеОшибки());
 	КонецПопытки;
@@ -4659,9 +4798,9 @@
 	КонецПопытки;
 
 	Если Ошибки.Количество() > 0 Тогда
-		Возврат Новый Структура("applied,field,value,comparison,errors,settings_tree", Ложь, Поле, Значение, ВидСравнения, Ошибки, ДиагностикаДо);
+		Возврат Новый Структура("applied,field,value,comparison,errors,settings_tree", Ложь, Поле, Значение, ВидСравненияMCP, Ошибки, ДиагностикаДо);
 	КонецЕсли;
-	Возврат Новый Структура("applied,field,value,comparison", Истина, Поле, Значение, ВидСравнения);
+	Возврат Новый Структура("applied,field,value,comparison", Истина, Поле, Значение, ВидСравненияMCP);
 КонецФункции
 
 &НаКлиенте
@@ -4961,7 +5100,13 @@
 		Возврат Неопределено;
 	КонецЕсли;
 	Если ТекущаяГлубина > МаксимальнаяГлубина Тогда
-		Возврат Строка(Объект);
+		РезультатОбрезки = Новый Структура;
+		РезультатОбрезки.Вставить("truncated", Истина);
+		РезультатОбрезки.Вставить("truncated_reason", "max_depth");
+		РезультатОбрезки.Вставить("type", Строка(ТипЗнч(Объект)));
+		РезультатОбрезки.Вставить("name", БезопасноеСвойство(Объект, "Имя", ""));
+		РезультатОбрезки.Вставить("title", БезопасныйЗаголовок(Объект));
+		Возврат РезультатОбрезки;
 	КонецЕсли;
 	СобственнаяВидимость = БезопасноеЗначениеМетода(Объект, "ТекущаяВидимость", БезопасноеСвойство(Объект, "Видимость", Истина));
 	СобственнаяДоступность = БезопасноеЗначениеМетода(Объект, "ТекущаяДоступность", БезопасноеСвойство(Объект, "Доступность", Истина));
@@ -5036,18 +5181,25 @@
 			КонецЕсли;
 		Исключение
 		КонецПопытки;
+		СкрытыхДетей = 0;
 		Для Каждого Ребенок Из Дети Цикл
 			ИмяРебенка = БезопасноеСвойство(Ребенок, "Имя", "");
 			Если Не ПоказыватьСкрытые И Не ПустаяСтрока(ИмяТекущейСтраницы) И ИмяРебенка <> ИмяТекущейСтраницы Тогда
+				СкрытыхДетей = СкрытыхДетей + 1;
 				Продолжить;
 			КонецЕсли;
 			РебенокДляСериализации = ?(Не ПустаяСтрока(ИмяТекущейСтраницы) И ИмяРебенка = ИмяТекущейСтраницы И ТекущаяСтраницаГруппы <> Неопределено, ТекущаяСтраницаГруппы, Ребенок);
 			СтруктураРебенка = ОбъектВСтруктуру(РебенокДляСериализации, ТекущаяГлубина + 1, МаксимальнаяГлубина, ПоказыватьСкрытые, Видимость, Доступность, ТолькоПросмотр);
 			Если СтруктураРебенка <> Неопределено Тогда
 				МассивДетей.Добавить(СтруктураРебенка);
+			Иначе
+				СкрытыхДетей = СкрытыхДетей + 1;
 			КонецЕсли;
 		КонецЦикла;
 		Результат.Вставить("children", МассивДетей);
+		Если СкрытыхДетей > 0 Тогда
+			Результат.Вставить("hidden_children_count", СкрытыхДетей);
+		КонецЕсли;
 	КонецЕсли;
 
 	Возврат Результат;

{answer42-0.2.28 → answer42-0.2.29}/src/mcp_1c/protocol.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import Any
 
-MANAGER_PROTOCOL_VERSION = "2026.07.02.3"
+MANAGER_PROTOCOL_VERSION = "2026.07.02.4"
 
 
 @dataclass(slots=True)

{answer42-0.2.28 → answer42-0.2.29}/src/mcp_1c/server.py

@@ -978,6 +978,29 @@ def _walk_ui_tree(node: Any):
         yield from _walk_ui_tree(child)
 
 
+def _summarize_ui_tree(tree: Any, max_depth: int, include_hidden: bool) -> dict[str, Any]:
+    """Return compact diagnostics about omitted/truncated UI tree parts."""
+    nodes = list(_walk_ui_tree(tree))
+    truncated_nodes = [node for node in nodes if node.get("truncated")]
+    hidden_children_total = 0
+    hidden_nodes = []
+    for node in nodes:
+        hidden_count = node.get("hidden_children_count", 0)
+        if isinstance(hidden_count, int):
+            hidden_children_total += hidden_count
+        if node.get("visible") is False:
+            hidden_nodes.append(node)
+    return {
+        "max_depth": max_depth,
+        "include_hidden": include_hidden,
+        "nodes_count": len(nodes),
+        "truncated": bool(truncated_nodes),
+        "truncated_nodes_count": len(truncated_nodes),
+        "hidden_children_count": hidden_children_total,
+        "hidden_nodes_count": len(hidden_nodes),
+    }
+
+
 def _metadata_name_from_navigation_url(url: str) -> str:
     """Best-effort conversion from e1cib/list/... to a metadata full name."""
     value = str(url or "")
@@ -3120,6 +3143,8 @@ async def ui_tree(max_depth: Annotated[int, "Maximum UI tree depth"] = 4,
     omitted by default; pass include_hidden=true to inspect the full 1C form tree.
     """
     tree = await _bridge_call_recorded(session_id, "ui_tree", {"max_depth": max_depth, "include_hidden": include_hidden})
+    if isinstance(tree, dict):
+        tree["tree_summary"] = _summarize_ui_tree(tree, max_depth=max_depth, include_hidden=include_hidden)
     if include_rag_types:
         sess = _session(session_id)
         if _RAG_ENABLED and sess.rag_enabled:
@@ -3163,6 +3188,20 @@ async def find_object(
     return await _bridge_call_recorded(session_id, "find_object", {"name": name, "title": title, "type": type, "max_depth": max_depth})
 
 
+@mcp.tool()
+async def search_objects(
+    name: Annotated[str, "Object technical name, exact match when specified"] = "",
+    title: Annotated[str, "Object visible title/caption, exact match when specified"] = "",
+    type: Annotated[str, "1C test object type, e.g. ТестируемаяФорма"] = "",
+    limit: Annotated[int, "Maximum number of matched objects to return"] = 50,
+    max_depth: Annotated[int, "Maximum search depth"] = 8,
+    *,
+    session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
+) -> Any:
+    """Find all UI objects matching name, title and/or 1C test object type."""
+    return await _bridge_call_recorded(session_id, "search_objects", {"name": name, "title": title, "type": type, "limit": limit, "max_depth": max_depth})
+
+
 @mcp.tool()
 async def get_object(
     name: Annotated[str, "Object name pattern"] = "",
@@ -3297,7 +3336,11 @@ async def tabular_documents(
     *,
     session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
 ) -> Any:
-    """List tabular document fields with dimensions; optionally include a cells range."""
+    """List tabular document fields with dimensions; optionally include a cells range.
+
+    include_text is intended for small/partial ranges. For large tabular
+    documents, save/export the report to a file and analyze that file instead.
+    """
     return await _bridge_call_recorded(session_id, "tabular_documents", {"include_text": include_text, "max_depth": max_depth, "row_start": row_start, "row_end": row_end, "column_start": column_start, "column_end": column_end, "max_rows": max_rows, "max_columns": max_columns})
 
 
@@ -3315,7 +3358,13 @@ async def tabular_document_text(
     *,
     session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
 ) -> Any:
-    """Return dimensions and a cells range of a tabular document field in the active window."""
+    """Return dimensions and a cells range of a tabular document field in the active window.
+
+    Use this for small tables or partial reads (headers, totals, spot checks). For
+    large reports/tabular documents, prefer tabular_document_save/report export
+    and analyze the saved PDF/XLSX/TXT/HTML file instead of reading UI cells one
+    by one.
+    """
     return await _bridge_call_recorded(session_id, "tabular_document_text", {"name": name, "title": title, "max_depth": max_depth, "row_start": row_start, "row_end": row_end, "column_start": column_start, "column_end": column_end, "max_rows": max_rows, "max_columns": max_columns})
 
 
@@ -3885,30 +3934,88 @@ async def configuration_name_version_from_subsystems(
 ) -> dict[str, Any]:
     """Open the 'Subsystem versions' information register and return the main configuration name/version.
 
-    The tool reads `РегистрСведений.ВерсииПодсистем`, scans list rows and returns
-    the row where `Это основная конфигурация` is `Да`.
+    The tool reads `РегистрСведений.ВерсииПодсистем` via the list output
+    command so that columns available to the dynamic list, including
+    `Это основная конфигурация`, are visible even when they are not displayed
+    in the default form table.
     """
     navigation_link = "e1cib/list/РегистрСведений.ВерсииПодсистем"
     await _bridge_call_recorded(session_id, "open_navigation_link", {"navigation_link": navigation_link})
-    rows_result = await _bridge_call_recorded(session_id, "table_rows", {"name": "Список", "title": "", "limit": 200, "max_depth": 8})
-    rows = rows_result.get("rows", []) if isinstance(rows_result, dict) else []
 
-    parsed_rows = [_table_row_pairs(row) for row in rows]
-    main_rows = [row for row in parsed_rows if _row_value(row, "Это основная конфигурация") == "Да"]
-    main = main_rows[0] if main_rows else {}
+    output_result = await _bridge_call_recorded(session_id, "dynamic_list_output", {
+        "button": "",
+        "wait_seconds": 3,
+        "max_depth": 8,
+    })
+    tabular_docs = output_result.get("tabular_documents", {}) if isinstance(output_result, dict) else {}
+    items = tabular_docs.get("items", []) if isinstance(tabular_docs, dict) else []
+
+    main: dict[str, str] = {}
+    cells: list[list[str]] = []
+    if items:
+        doc_name = items[0].get("name", "")
+        text_result = await _bridge_call_recorded(session_id, "tabular_document_text", {
+            "name": doc_name,
+            "max_rows": 50,
+            "max_columns": 20,
+        })
+        cells = text_result.get("cells", []) if isinstance(text_result, dict) else []
+        main = _find_main_configuration_in_tabular_cells(cells)
 
     return {
         "found": bool(main),
-        "configuration_name": _row_value(main, "Имя подсистемы"),
-        "configuration_version": _row_value(main, "Версия"),
+        "configuration_name": main.get("configuration_name", ""),
+        "configuration_version": main.get("configuration_version", ""),
         "main_configuration_row": main,
-        "main_configuration_rows_count": len(main_rows),
-        "rows_count": len(parsed_rows),
+        "main_configuration_rows_count": 1 if main else 0,
+        "rows_count": max(0, len(cells) - 1),
         "navigation_link": navigation_link,
         "source": "РегистрСведений.ВерсииПодсистем",
     }
 
 
+def _find_main_configuration_in_tabular_cells(cells: list[list[str]]) -> dict[str, str]:
+    """Scan tabular document cells for the main configuration row."""
+    if not cells or len(cells) < 2:
+        return {}
+
+    header_row_idx = -1
+    name_col = -1
+    version_col = -1
+    main_cfg_col = -1
+    for i, row in enumerate(cells):
+        local_name_col = local_version_col = local_main_cfg_col = -1
+        for j, cell in enumerate(row):
+            cell_norm = str(cell).strip()
+            if cell_norm == "Имя подсистемы":
+                local_name_col = j
+            elif cell_norm == "Версия":
+                local_version_col = j
+            elif cell_norm == "Это основная конфигурация":
+                local_main_cfg_col = j
+        if local_name_col >= 0 and local_version_col >= 0 and local_main_cfg_col >= 0:
+            header_row_idx = i
+            name_col = local_name_col
+            version_col = local_version_col
+            main_cfg_col = local_main_cfg_col
+            break
+
+    if header_row_idx < 0:
+        return {}
+
+    for row in cells[header_row_idx + 1:]:
+        if len(row) <= max(name_col, version_col, main_cfg_col):
+            continue
+        if _is_truthy_1c(str(row[main_cfg_col])):
+            return {
+                "configuration_name": str(row[name_col]).strip(),
+                "configuration_version": str(row[version_col]).strip(),
+                "Это основная конфигурация": str(row[main_cfg_col]).strip(),
+            }
+
+    return {}
+
+
 @mcp.tool()
 async def installed_extensions_from_catalog(
     *,
@@ -4468,7 +4575,13 @@ def screenshot(
     *,
     session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
 ) -> dict[str, Any]:
-    """Capture a screenshot from the MCP host. Defaults to the active visible 1C window."""
+    """Capture a screenshot from the MCP host. Defaults to the active visible 1C window.
+
+    Screenshots are for user evidence and UI diagnostics only. Do not use them
+    to analyze report/table/tabular-document/list data; use structured tools
+    such as tabular_document_text, tabular_documents, table_rows,
+    dynamic_list_output, or report export/save tools instead.
+    """
     output_path = Path(path)
     output_path.parent.mkdir(parents=True, exist_ok=True)