answer42 0.2.2__tar.gz → 0.2.4__tar.gz

{answer42-0.2.2 → answer42-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: answer42
-Version: 0.2.2
+Version: 0.2.4
 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>
@@ -34,7 +34,7 @@ Description-Content-Type: text/markdown
 
 # Answer42
 
-![Answer42 logo](docs/assets/answer42-logo.png)
+![Answer42 logo](https://gitlab.com/platform42/answer42-mcp/-/raw/v0.2.4/docs/assets/answer42-logo.png)
 
 **Answer42** — MCP-инструмент для интерактивного управления UI **1С:Предприятия** через клиент тестирования. Он позволяет AI-агенту открывать формы 1С, нажимать кнопки, заполнять поля, выбирать ссылки из форм выбора, работать с таблицами, динамическими списками и табличными документами.
 

{answer42-0.2.2 → answer42-0.2.4}/README.md

@@ -1,6 +1,6 @@
 # Answer42
 
-![Answer42 logo](docs/assets/answer42-logo.png)
+![Answer42 logo](https://gitlab.com/platform42/answer42-mcp/-/raw/v0.2.4/docs/assets/answer42-logo.png)
 
 **Answer42** — MCP-инструмент для интерактивного управления UI **1С:Предприятия** через клиент тестирования. Он позволяет AI-агенту открывать формы 1С, нажимать кнопки, заполнять поля, выбирать ссылки из форм выбора, работать с таблицами, динамическими списками и табличными документами.
 

{answer42-0.2.2 → answer42-0.2.4}/pyproject.toml

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

@@ -355,7 +355,13 @@
 	ИначеЕсли Метод = "object_context_menu" Тогда
 		Возврат КонтекстноеМенюОбъектаMCP(Параметры);
 	ИначеЕсли Метод = "window_command_interface" Тогда
-		Возврат КомандныйИнтерфейсОкнаMCP();
+		Возврат КомандныйИнтерфейсОкнаMCP(Параметры);
+	ИначеЕсли Метод = "command_interface_sections" Тогда
+		Возврат РазделыКомандногоИнтерфейсаMCP(Параметры);
+	ИначеЕсли Метод = "command_interface_commands" Тогда
+		Возврат КомандыКомандногоИнтерфейсаMCP(Параметры);
+	ИначеЕсли Метод = "command_interface_search" Тогда
+		Возврат ПоискКомандногоИнтерфейсаMCP(Параметры);
 	ИначеЕсли Метод = "group_expand" Тогда
 		Возврат РазвернутьГруппуMCP(Параметры);
 	ИначеЕсли Метод = "group_collapse" Тогда
@@ -1322,25 +1328,363 @@
 КонецФункции
 
 &НаКлиенте
-Функция КомандныйИнтерфейсОкнаMCP()
+Функция КомандныйИнтерфейсОкнаMCP(Параметры)
 	Если ТестируемоеПриложение = Неопределено Тогда
 		ВызватьИсключение "Тестируемое приложение не подключено.";
 	КонецЕсли;
 
 	Попытка
-		АктивноеОкно = ТестируемоеПриложение.ПолучитьАктивноеОкно();
+		Глубина = СвойствоСтруктуры(Параметры, "max_depth", 4);
+		АктивноеОкно = КомандныйИнтерфейсЦелевоеОкно(Параметры);
 		Интерфейс = АктивноеОкно.ПолучитьКомандныйИнтерфейс();
 		Если Интерфейс = Неопределено Тогда
-			Возврат Новый Структура("available,reason", Ложь, "not_available");
+			Возврат Новый Структура("available,reason,window", Ложь, "not_available", ОбъектВСтруктуру(АктивноеОкно, 0, 0));
 		Иначе
-			Дерево = ОбъектВСтруктуру(Интерфейс, 0, 2);
-			Возврат Новый Структура("available,interface", Истина, Дерево);
+			Дерево = КомандныйИнтерфейсОбъектВСтруктуру(Интерфейс, 0, Глубина);
+			Возврат Новый Структура("available,interface,window", Истина, Дерево, ОбъектВСтруктуру(АктивноеОкно, 0, 0));
 		КонецЕсли;
 	Исключение
 		Возврат Новый Структура("available,reason,error", Ложь, "not_supported", ОписаниеОшибки());
 	КонецПопытки;
 КонецФункции
 
+&НаКлиенте
+Функция РазделыКомандногоИнтерфейсаMCP(Параметры)
+	Если ТестируемоеПриложение = Неопределено Тогда
+		ВызватьИсключение "Тестируемое приложение не подключено.";
+	КонецЕсли;
+
+	Попытка
+		АктивноеОкно = КомандныйИнтерфейсЦелевоеОкно(Параметры);
+		Интерфейс = АктивноеОкно.ПолучитьКомандныйИнтерфейс();
+		Если Интерфейс = Неопределено Тогда
+			Возврат Новый Структура("available,reason,window", Ложь, "not_available", ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+		КонецЕсли;
+
+		Разделы = РазделыКомандногоИнтерфейса(Интерфейс);
+		Возврат Новый Структура("available,sections,window", Истина, Разделы, ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+	Исключение
+		Возврат Новый Структура("available,reason,error", Ложь, "not_supported", ОписаниеОшибки());
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция КомандыКомандногоИнтерфейсаMCP(Параметры)
+	Если ТестируемоеПриложение = Неопределено Тогда
+		ВызватьИсключение "Тестируемое приложение не подключено.";
+	КонецЕсли;
+
+	Попытка
+		Глубина = СвойствоСтруктуры(Параметры, "max_depth", 4);
+		ЗаголовокРаздела = СвойствоСтруктуры(Параметры, "section", "");
+		АктивноеОкно = КомандныйИнтерфейсЦелевоеОкно(Параметры);
+		Интерфейс = АктивноеОкно.ПолучитьКомандныйИнтерфейс();
+		Если Интерфейс = Неопределено Тогда
+			Возврат Новый Структура("available,reason,window", Ложь, "not_available", ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+		КонецЕсли;
+
+		Корень = Интерфейс;
+		Если Не ПустаяСтрока(ЗаголовокРаздела) Тогда
+			КнопкаРаздела = КомандныйИнтерфейсНайтиРаздел(Интерфейс, ЗаголовокРаздела);
+			Если КнопкаРаздела = Неопределено Тогда
+				Возврат Новый Структура("available,found,reason,section,window", Истина, Ложь, "section_not_found", ЗаголовокРаздела, ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+			КонецЕсли;
+			КнопкаРаздела.Нажать();
+			Интерфейс = АктивноеОкно.ПолучитьКомандныйИнтерфейс();
+			Корень = Интерфейс;
+		КонецЕсли;
+
+		Дерево = КомандныйИнтерфейсОбъектВСтруктуру(Корень, 0, Глубина);
+		ЛокКоманды = КомандыКомандногоИнтерфейса(Корень, Истина);
+		Возврат Новый Структура("available,found,section,tree,commands,window", Истина, Истина, ЗаголовокРаздела, Дерево, ЛокКоманды, ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+	Исключение
+		Возврат Новый Структура("available,reason,error", Ложь, "not_supported", ОписаниеОшибки());
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция ПоискКомандногоИнтерфейсаMCP(Параметры)
+	Если ТестируемоеПриложение = Неопределено Тогда
+		ВызватьИсключение "Тестируемое приложение не подключено.";
+	КонецЕсли;
+
+	Попытка
+		СтрокаПоиска = СокрЛП(СвойствоСтруктуры(Параметры, "query", ""));
+		Если ПустаяСтрока(СтрокаПоиска) Тогда
+			ВызватьИсключение "Параметр query обязателен.";
+		КонецЕсли;
+
+		ЗаголовокРаздела = СвойствоСтруктуры(Параметры, "section", "");
+		Максимум = СвойствоСтруктуры(Параметры, "max_results", 20);
+		АктивноеОкно = КомандныйИнтерфейсЦелевоеОкно(Параметры);
+		Интерфейс = АктивноеОкно.ПолучитьКомандныйИнтерфейс();
+		Если Интерфейс = Неопределено Тогда
+			Возврат Новый Структура("available,reason,window", Ложь, "not_available", ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+		КонецЕсли;
+
+		Если Не ПустаяСтрока(ЗаголовокРаздела) Тогда
+			КнопкаРаздела = КомандныйИнтерфейсНайтиРаздел(Интерфейс, ЗаголовокРаздела);
+			Если КнопкаРаздела = Неопределено Тогда
+				Возврат Новый Структура("available,found,reason,query,section,matches,window", Истина, Ложь, "section_not_found", СтрокаПоиска, ЗаголовокРаздела, Новый Массив, ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+			КонецЕсли;
+			КнопкаРаздела.Нажать();
+			Интерфейс = АктивноеОкно.ПолучитьКомандныйИнтерфейс();
+		КонецЕсли;
+
+		ВсеКоманды = КомандыКомандногоИнтерфейса(Интерфейс, Истина);
+		Совпадения = ПоискВКомандахКомандногоИнтерфейса(ВсеКоманды, СтрокаПоиска, Максимум);
+		Возврат Новый Структура("available,found,query,section,count,matches,window", Истина, Совпадения.Количество() > 0, СтрокаПоиска, ЗаголовокРаздела, Совпадения.Количество(), Совпадения, ОбъектВСтруктуру(АктивноеОкно, 0, 0));
+	Исключение
+		Возврат Новый Структура("available,reason,error", Ложь, "not_supported", ОписаниеОшибки());
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция КомандныйИнтерфейсЦелевоеОкно(Параметры)
+	ОкноЗаголовок = СвойствоСтруктуры(Параметры, "window_title", "");
+	Если ПустаяСтрока(ОкноЗаголовок) Тогда
+		АктивноеОкно = ТестируемоеПриложение.ПолучитьАктивноеОкно();
+		Если КомандныйИнтерфейсОкнаПоддерживается(АктивноеОкно) Тогда
+			Возврат АктивноеОкно;
+		КонецЕсли;
+		Для Каждого ТекущееОкно Из ОкнаТестируемогоПриложения() Цикл
+			Если КомандныйИнтерфейсОкнаПоддерживается(ТекущееОкно) Тогда
+				ТекущееОкно.Активизировать();
+				Возврат ТекущееОкно;
+			КонецЕсли;
+		КонецЦикла;
+		Возврат АктивноеОкно;
+	КонецЕсли;
+
+	Для Каждого ТекущееОкно Из ОкнаТестируемогоПриложения() Цикл
+		ЗаголовокТекущегоОкна = БезопасноеСвойство(ТекущееОкно, "Заголовок", "");
+		Если СтрНайти(НРег(ЗаголовокТекущегоОкна), НРег(ОкноЗаголовок)) > 0
+			И КомандныйИнтерфейсОкнаПоддерживается(ТекущееОкно) Тогда
+			ТекущееОкно.Активизировать();
+			Возврат ТекущееОкно;
+		КонецЕсли;
+	КонецЦикла;
+	ВызватьИсключение "Окно не найдено: " + ОкноЗаголовок;
+КонецФункции
+
+&НаКлиенте
+Функция КомандныйИнтерфейсОкнаПоддерживается(Окно)
+	Попытка
+		Окно.ПолучитьКомандныйИнтерфейс();
+		Возврат Истина;
+	Исключение
+		Возврат Ложь;
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция КомандныйИнтерфейсНайтиРаздел(Интерфейс, ЗаголовокРаздела)
+	Для Каждого Раздел Из КомандныйИнтерфейсПодчиненныеРекурсивно(Интерфейс, "тестируемаякнопкакомандногоинтерфейса") Цикл
+		ЗаголовокРазделаТекущий = БезопасныйЗаголовок(Раздел);
+		Если СтрНайти(НРег(ЗаголовокРазделаТекущий), НРег(ЗаголовокРаздела)) > 0 Тогда
+			Возврат Раздел;
+		КонецЕсли;
+	КонецЦикла;
+	Возврат Неопределено;
+КонецФункции
+
+&НаКлиенте
+Функция РазделыКомандногоИнтерфейса(Интерфейс)
+	Результат = Новый Массив;
+	Для Каждого Группа Из КомандныйИнтерфейсПодчиненныеРекурсивно(Интерфейс, "тестируемаягруппакомандногоинтерфейса") Цикл
+		Если СтрНайти(НРег(БезопасныйЗаголовок(Группа)), "панель разделов") = 0 Тогда
+			Продолжить;
+		КонецЕсли;
+		Для Каждого Раздел Из БезопасныеПодчиненные(Группа) Цикл
+			Если НормализованноеИмяТипа(Строка(ТипЗнч(Раздел))) <> "тестируемаякнопкакомандногоинтерфейса" Тогда
+				Продолжить;
+			КонецЕсли;
+			ДанныеРаздела = КомандныйИнтерфейсОбъектВСтруктуру(Раздел, 0, 0);
+			ДанныеРаздела.Вставить("panel", БезопасныйЗаголовок(Группа));
+			Результат.Добавить(ДанныеРаздела);
+		КонецЦикла;
+	КонецЦикла;
+	Возврат Результат;
+КонецФункции
+
+&НаКлиенте
+Функция КомандныйИнтерфейсПодчиненныеРекурсивно(Объект, ИскомыйТип)
+	Результат = Новый Массив;
+	КомандныйИнтерфейсПодчиненныеРекурсивноВнутр(Объект, ИскомыйТип, Результат);
+	Возврат Результат;
+КонецФункции
+
+&НаКлиенте
+Процедура КомандныйИнтерфейсПодчиненныеРекурсивноВнутр(Объект, ИскомыйТип, Результат)
+	Если Объект = Неопределено Тогда
+		Возврат;
+	КонецЕсли;
+	Для Каждого Подчиненный Из БезопасныеПодчиненные(Объект) Цикл
+		Если НормализованноеИмяТипа(Строка(ТипЗнч(Подчиненный))) = ИскомыйТип Тогда
+			Результат.Добавить(Подчиненный);
+		КонецЕсли;
+		КомандныйИнтерфейсПодчиненныеРекурсивноВнутр(Подчиненный, ИскомыйТип, Результат);
+	КонецЦикла;
+КонецПроцедуры
+
+&НаКлиенте
+Функция КомандныйИнтерфейсОбъектВСтруктуру(Объект, ТекущаяГлубина, МаксимальнаяГлубина)
+	Если Объект = Неопределено Тогда
+		Возврат Неопределено;
+	КонецЕсли;
+
+	Результат = Новый Структура;
+	ТипОбъекта = Строка(ТипЗнч(Объект));
+	НормТип = НормализованноеИмяТипа(ТипОбъекта);
+	Результат.Вставить("type", ТипОбъекта);
+	Результат.Вставить("kind", НормТип);
+	Результат.Вставить("title", БезопасныйЗаголовок(Объект));
+	Результат.Вставить("navigation_url", БезопасноеСвойство(Объект, "НавигационнаяСсылка", ""));
+
+	Если НормТип = "тестируемыйкомандныйинтерфейс" Тогда
+		Результат.Вставить("role", "root");
+	ИначеЕсли НормТип = "тестируемаягруппакомандногоинтерфейса" Тогда
+		Результат.Вставить("role", "section");
+	ИначеЕсли НормТип = "тестируемаякнопкакомандногоинтерфейса" Тогда
+		Результат.Вставить("role", "command");
+	Иначе
+		Результат.Вставить("role", "object");
+	КонецЕсли;
+
+	Попытка
+		Результат.Вставить("visible", Объект.ТекущаяВидимость());
+	Исключение
+		Результат.Вставить("visible", Истина);
+	КонецПопытки;
+	Попытка
+		Результат.Вставить("available", Объект.ТекущаяДоступность());
+	Исключение
+		Результат.Вставить("available", Истина);
+	КонецПопытки;
+
+	Если ТекущаяГлубина < МаксимальнаяГлубина Тогда
+		Дети = Новый Массив;
+		Для Каждого Подчиненный Из БезопасныеПодчиненные(Объект) Цикл
+			ДанныеПодчиненного = КомандныйИнтерфейсОбъектВСтруктуру(Подчиненный, ТекущаяГлубина + 1, МаксимальнаяГлубина);
+			Если ДанныеПодчиненного <> Неопределено Тогда
+				Дети.Добавить(ДанныеПодчиненного);
+			КонецЕсли;
+		КонецЦикла;
+		Результат.Вставить("children", Дети);
+	КонецЕсли;
+
+	Возврат Результат;
+КонецФункции
+
+&НаКлиенте
+Функция КомандыКомандногоИнтерфейса(Корень, ИсключатьСлужебныеПанели = Ложь)
+	Результат = Новый Массив;
+	КомандыКомандногоИнтерфейсаРекурсивно(Корень, Результат, Новый Массив, ИсключатьСлужебныеПанели);
+	Возврат Результат;
+КонецФункции
+
+&НаКлиенте
+Процедура КомандыКомандногоИнтерфейсаРекурсивно(Объект, Результат, Путь, ИсключатьСлужебныеПанели)
+	Если Объект = Неопределено Тогда
+		Возврат;
+	КонецЕсли;
+
+	ТипОбъекта = НормализованноеИмяТипа(Строка(ТипЗнч(Объект)));
+	Заголовок = БезопасныйЗаголовок(Объект);
+	СлужебнаяПанель = ИсключатьСлужебныеПанели И КомандныйИнтерфейсПутьСодержитСлужебнуюПанель(Путь);
+	Если ТипОбъекта = "тестируемаякнопкакомандногоинтерфейса" И Не СлужебнаяПанель Тогда
+		Команда = Новый Структура;
+		Команда.Вставить("title", Заголовок);
+		Команда.Вставить("navigation_url", БезопасноеСвойство(Объект, "НавигационнаяСсылка", ""));
+		Команда.Вставить("path", Путь);
+		Результат.Добавить(Команда);
+	КонецЕсли;
+
+	НовыйПуть = Новый Массив;
+	Для Каждого ЭлементПути Из Путь Цикл
+		НовыйПуть.Добавить(ЭлементПути);
+	КонецЦикла;
+	Если ТипОбъекта = "тестируемаягруппакомандногоинтерфейса" И Не ПустаяСтрока(Заголовок) Тогда
+		НовыйПуть.Добавить(Заголовок);
+	КонецЕсли;
+
+	Для Каждого Подчиненный Из БезопасныеПодчиненные(Объект) Цикл
+		КомандыКомандногоИнтерфейсаРекурсивно(Подчиненный, Результат, НовыйПуть, ИсключатьСлужебныеПанели);
+	КонецЦикла;
+КонецПроцедуры
+
+&НаКлиенте
+Функция КомандныйИнтерфейсПутьСодержитСлужебнуюПанель(Путь)
+	Для Каждого ЭлементПути Из Путь Цикл
+		НормЭлемент = НРег(ЭлементПути);
+		Если СтрНайти(НормЭлемент, "панель разделов") > 0
+			Или СтрНайти(НормЭлемент, "панель открытых") > 0 Тогда
+			Возврат Истина;
+		КонецЕсли;
+	КонецЦикла;
+	Возврат Ложь;
+КонецФункции
+
+&НаКлиенте
+Функция ПоискВКомандахКомандногоИнтерфейса(Команды, СтрокаПоиска, Максимум)
+	Результат = Новый Массив;
+	НормПоиск = НРег(СтрокаПоиска);
+	КороткийПоиск = НормПоиск;
+	Если СтрДлина(КороткийПоиск) > 3 Тогда
+		КороткийПоиск = Лев(КороткийПоиск, СтрДлина(КороткийПоиск) - 1);
+	КонецЕсли;
+	Для Каждого Команда Из Команды Цикл
+		Заголовок = СвойствоСтруктуры(Команда, "title", "");
+		Ссылка = СвойствоСтруктуры(Команда, "navigation_url", "");
+		Путь = СвойствоСтруктуры(Команда, "path", Новый Массив);
+		ТекстПути = КомандныйИнтерфейсПутьВСтроку(Путь);
+		ТекстДляПоиска = НРег(Заголовок + " " + ТекстПути + " " + Ссылка);
+		Если СтрНайти(ТекстДляПоиска, НормПоиск) > 0
+			Или (КороткийПоиск <> НормПоиск И СтрНайти(ТекстДляПоиска, КороткийПоиск) > 0) Тогда
+			Совпадение = Новый Структура;
+			Совпадение.Вставить("title", Заголовок);
+			Совпадение.Вставить("navigation_url", Ссылка);
+			Совпадение.Вставить("path", Путь);
+			Совпадение.Вставить("path_text", ТекстПути);
+			Совпадение.Вставить("score", КомандныйИнтерфейсОценкаСовпадения(Заголовок, ТекстПути, Ссылка, НормПоиск));
+			Результат.Добавить(Совпадение);
+			Если Максимум > 0 И Результат.Количество() >= Максимум Тогда
+				Прервать;
+			КонецЕсли;
+		КонецЕсли;
+	КонецЦикла;
+	Возврат Результат;
+КонецФункции
+
+&НаКлиенте
+Функция КомандныйИнтерфейсПутьВСтроку(Путь)
+	Результат = "";
+	Для Каждого ЭлементПути Из Путь Цикл
+		Если Не ПустаяСтрока(Результат) Тогда
+			Результат = Результат + " / ";
+		КонецЕсли;
+		Результат = Результат + ЭлементПути;
+	КонецЦикла;
+	Возврат Результат;
+КонецФункции
+
+&НаКлиенте
+Функция КомандныйИнтерфейсОценкаСовпадения(Заголовок, ТекстПути, Ссылка, НормПоиск)
+	Если НРег(Заголовок) = НормПоиск Тогда
+		Возврат 100;
+	КонецЕсли;
+	Если СтрНайти(НРег(Заголовок), НормПоиск) > 0 Тогда
+		Возврат 80;
+	КонецЕсли;
+	Если СтрНайти(НРег(ТекстПути), НормПоиск) > 0 Тогда
+		Возврат 50;
+	КонецЕсли;
+	Если СтрНайти(НРег(Ссылка), НормПоиск) > 0 Тогда
+		Возврат 30;
+	КонецЕсли;
+	Возврат 0;
+КонецФункции
+
 &НаКлиенте
 Функция РазвернутьГруппуMCP(Параметры)
 	Если ТестируемоеПриложение = Неопределено Тогда

{answer42-0.2.2 → answer42-0.2.4}/src/mcp_1c/server.py

@@ -2455,11 +2455,55 @@ async def object_context_menu(
 @mcp.tool()
 async def window_command_interface(
     max_depth: Annotated[int, "Serialization depth for returned command interface"] = 2,
+    window_title: Annotated[str, "Optional window title substring to activate before reading command interface"] = "",
     *,
     session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
 ) -> Any:
     """Return active window command interface, when supported."""
-    return await _bridge_call_recorded(session_id, "window_command_interface", {"max_depth": max_depth})
+    return await _bridge_call_recorded(session_id, "window_command_interface", {"max_depth": max_depth, "window_title": window_title})
+
+
+@mcp.tool()
+async def command_interface_sections(
+    window_title: Annotated[str, "Optional window title substring to activate before reading command interface"] = "",
+    *,
+    session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
+) -> Any:
+    """Return top-level sections of the active window command interface."""
+    return await _bridge_call_recorded(session_id, "command_interface_sections", {"window_title": window_title})
+
+
+@mcp.tool()
+async def command_interface_commands(
+    section: Annotated[str, "Optional top-level section title substring, e.g. 'Главное' or 'Администрирование'"] = "",
+    max_depth: Annotated[int, "Serialization depth for returned command tree"] = 4,
+    window_title: Annotated[str, "Optional window title substring to activate before reading command interface"] = "",
+    *,
+    session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
+) -> Any:
+    """Return command-interface command tree and flattened command list, optionally filtered by section."""
+    return await _bridge_call_recorded(
+        session_id,
+        "command_interface_commands",
+        {"section": section, "max_depth": max_depth, "window_title": window_title},
+    )
+
+
+@mcp.tool()
+async def command_interface_search(
+    query: Annotated[str, "Search text to match against command title, path and navigation URL"],
+    section: Annotated[str, "Optional top-level section title substring to activate before searching"] = "",
+    max_results: Annotated[int, "Maximum number of matches to return; 0 means no limit"] = 20,
+    window_title: Annotated[str, "Optional window title substring to activate before reading command interface"] = "",
+    *,
+    session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
+) -> Any:
+    """Search live command-interface commands by title, path or navigation URL."""
+    return await _bridge_call_recorded(
+        session_id,
+        "command_interface_search",
+        {"query": query, "section": section, "max_results": max_results, "window_title": window_title},
+    )
 
 
 @mcp.tool()