answer42 0.2.24__tar.gz → 0.2.26__tar.gz

{answer42-0.2.24 → answer42-0.2.26}/PKG-INFO

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

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

@@ -238,11 +238,33 @@
 
 #Область КомандыMCP
 
+&НаКлиенте
+Функция ВерсияПротоколаМенеджераMCP()
+	Возврат "2026.07.02.2";
+КонецФункции
+
+&НаКлиенте
+Функция ИнформацияОМенеджереMCP()
+	Возврат Новый Структура("manager_protocol_version", ВерсияПротоколаМенеджераMCP());
+КонецФункции
+
+&НаКлиенте
+Процедура ПроверитьВерсиюПротоколаМенеджераMCP(Параметры)
+	ОжидаемаяВерсия = СвойствоСтруктуры(Параметры, "expected_manager_protocol_version", "");
+	Если Не ПустаяСтрока(ОжидаемаяВерсия) И ОжидаемаяВерсия <> ВерсияПротоколаМенеджераMCP() Тогда
+		ВызватьИсключение "Несовместимая версия MCPTestManager.cf: Python ожидает протокол "
+			+ ОжидаемаяВерсия + ", обработка поддерживает " + ВерсияПротоколаМенеджераMCP()
+			+ ". Пересоберите MCPTestManager.cf из актуальных исходников и перезапустите Answer42 MCP.";
+	КонецЕсли;
+КонецПроцедуры
+
 &НаКлиенте
 Функция ВыполнитьКоманду(Метод, Параметры)
 	Если Метод = "ping" Тогда
 		Лог("ВыполнитьКоманду: ping");
-		Возврат Новый Структура("pong", Истина);
+		Возврат Новый Структура("pong,manager_protocol_version", Истина, ВерсияПротоколаМенеджераMCP());
+	ИначеЕсли Метод = "manager_info" Тогда
+		Возврат ИнформацияОМенеджереMCP();
 	ИначеЕсли Метод = "connect_test_client" Тогда
 		Лог("ВыполнитьКоманду: connect_test_client");
 		Возврат ПодключитьКлиентТестирования(Параметры);
@@ -462,6 +484,7 @@
 
 &НаКлиенте
 Функция ПодключитьКлиентТестирования(Параметры)
+	ПроверитьВерсиюПротоколаМенеджераMCP(Параметры);
 	URLБазы = СвойствоСтруктуры(Параметры, "base_url", "");
 	ТипПодключения = НРег(СвойствоСтруктуры(Параметры, "connection_mode", "ws"));
 	СтрокаПодключения = СвойствоСтруктуры(Параметры, "connection_value", URLБазы);
@@ -504,6 +527,7 @@
 
 &НаКлиенте
 Функция ПодключитьЗапущенныйКлиентТестирования(Параметры)
+	ПроверитьВерсиюПротоколаМенеджераMCP(Параметры);
 	URLБазы = СвойствоСтруктуры(Параметры, "base_url", "");
 	ТипПодключения = НРег(СвойствоСтруктуры(Параметры, "connection_mode", "ws"));
 	СтрокаПодключения = СвойствоСтруктуры(Параметры, "connection_value", URLБазы);
@@ -2926,12 +2950,12 @@
 	Глубина = СвойствоСтруктуры(Параметры, "max_depth", 8);
 	ВключатьТекст = СвойствоСтруктуры(Параметры, "include_text", Ложь);
 	Результат = Новый Массив;
-	НайтиТабличныеДокументыРекурсивно(АктивноеОкно, Результат, ВключатьТекст, 0, Глубина);
+	НайтиТабличныеДокументыРекурсивно(АктивноеОкно, Результат, ВключатьТекст, Параметры, 0, Глубина);
 	Возврат Новый Структура("count,items", Результат.Количество(), Результат);
 КонецФункции
 
 &НаКлиенте
-Процедура НайтиТабличныеДокументыРекурсивно(Объект, Результат, ВключатьТекст, ТекущаяГлубина, МаксимальнаяГлубина)
+Процедура НайтиТабличныеДокументыРекурсивно(Объект, Результат, ВключатьТекст, ПараметрыТекста, ТекущаяГлубина, МаксимальнаяГлубина)
 	Если ТекущаяГлубина > МаксимальнаяГлубина Тогда
 		Возврат;
 	КонецЕсли;
@@ -2944,20 +2968,31 @@
 				Элемент.Вставить("title", БезопасныйЗаголовок(Подчиненный));
 				Элемент.Вставить("type", Строка(ТипЗнч(Подчиненный)));
 				Элемент.Вставить("data", БезопасноеПредставлениеДанныхПоля(Подчиненный));
+				РазмерыДокумента = РазмерыТабличногоДокументаИзПоля(Подчиненный);
+				Если РазмерыДокумента.Свойство("error") Тогда
+					Элемент.Вставить("dimensions_error", РазмерыДокумента.error);
+				Иначе
+					Элемент.Вставить("rows", РазмерыДокумента.rows);
+					Элемент.Вставить("columns", РазмерыДокумента.columns);
+				КонецЕсли;
 				Если ВключатьТекст Тогда
-					ТекстДокумента = ТекстТабличногоДокументаИзПоля(Подчиненный);
+					ТекстДокумента = ТекстТабличногоДокументаИзПоля(Подчиненный, ПараметрыТекста);
 					Если ТекстДокумента.Свойство("error") Тогда
 						Элемент.Вставить("text_error", ТекстДокумента.error);
 					Иначе
 						Элемент.Вставить("rows", ТекстДокумента.rows);
 						Элемент.Вставить("columns", ТекстДокумента.columns);
 						Элемент.Вставить("address", ТекстДокумента.address);
-						Элемент.Вставить("text", ТекстДокумента.text);
+						Элемент.Вставить("row_start", ТекстДокумента.row_start);
+						Элемент.Вставить("row_end", ТекстДокумента.row_end);
+						Элемент.Вставить("column_start", ТекстДокумента.column_start);
+						Элемент.Вставить("column_end", ТекстДокумента.column_end);
+						Элемент.Вставить("cells", ТекстДокумента.cells);
 					КонецЕсли;
 				КонецЕсли;
 				Результат.Добавить(Элемент);
 			КонецЕсли;
-			НайтиТабличныеДокументыРекурсивно(Подчиненный, Результат, ВключатьТекст, ТекущаяГлубина + 1, МаксимальнаяГлубина);
+			НайтиТабличныеДокументыРекурсивно(Подчиненный, Результат, ВключатьТекст, ПараметрыТекста, ТекущаяГлубина + 1, МаксимальнаяГлубина);
 		КонецЦикла;
 	Исключение
 		Инфо = ИнформацияОбОшибке();
@@ -2990,29 +3025,56 @@
 	Если Поле = Неопределено Тогда
 		Возврат Новый Структура("found", Ложь);
 	КонецЕсли;
-	ДанныеТекста = ТекстТабличногоДокументаИзПоля(Поле);
+	ДанныеТекста = ТекстТабличногоДокументаИзПоля(Поле, Параметры);
 	Если ДанныеТекста.Свойство("error") Тогда
 		Возврат Новый Структура("found,error", Истина, ДанныеТекста.error);
 	КонецЕсли;
-	Возврат Новый Структура("found,rows,columns,address,text,cells", Истина, ДанныеТекста.rows, ДанныеТекста.columns, ДанныеТекста.address, ДанныеТекста.text, ДанныеТекста.cells);
+	Возврат Новый Структура("found,rows,columns,address,row_start,row_end,column_start,column_end,cells", Истина, ДанныеТекста.rows, ДанныеТекста.columns, ДанныеТекста.address, ДанныеТекста.row_start, ДанныеТекста.row_end, ДанныеТекста.column_start, ДанныеТекста.column_end, ДанныеТекста.cells);
 КонецФункции
 
 &НаКлиенте
-Функция ТекстТабличногоДокументаИзПоля(Поле)
+Функция РазмерыТабличногоДокументаИзПоля(Поле)
 	Попытка
-		КоличествоСтрок = Поле.ПолучитьРазмерОбластиДанныхДокументаПоВертикали();
-		КоличествоКолонок = Поле.ПолучитьРазмерОбластиДанныхДокументаПоГоризонтали();
+		Возврат Новый Структура("rows,columns", Поле.ПолучитьРазмерОбластиДанныхДокументаПоВертикали(), Поле.ПолучитьРазмерОбластиДанныхДокументаПоГоризонтали());
+	Исключение
+		Возврат Новый Структура("error", ОписаниеОшибки());
+	КонецПопытки;
+КонецФункции
+
+&НаКлиенте
+Функция ТекстТабличногоДокументаИзПоля(Поле, Параметры)
+	Попытка
+		Размеры = РазмерыТабличногоДокументаИзПоля(Поле);
+		Если Размеры.Свойство("error") Тогда
+			Возврат Новый Структура("error", Размеры.error);
+		КонецЕсли;
+		КоличествоСтрок = Размеры.rows;
+		КоличествоКолонок = Размеры.columns;
 		Если КоличествоСтрок = 0 Или КоличествоКолонок = 0 Тогда
-			Возврат Новый Структура("rows,columns,address,text,cells", 0, 0, "", "", Новый Массив);
+			Возврат Новый Структура("rows,columns,address,row_start,row_end,column_start,column_end,cells", 0, 0, "", 0, 0, 0, 0, Новый Массив);
+		КонецЕсли;
+		НачальнаяСтрока = Макс(1, СвойствоСтруктуры(Параметры, "row_start", 1));
+		НачальнаяКолонка = Макс(1, СвойствоСтруктуры(Параметры, "column_start", 1));
+		КонечнаяСтрока = СвойствоСтруктуры(Параметры, "row_end", 0);
+		КонечнаяКолонка = СвойствоСтруктуры(Параметры, "column_end", 0);
+		МаксСтрок = СвойствоСтруктуры(Параметры, "max_rows", 50);
+		МаксКолонок = СвойствоСтруктуры(Параметры, "max_columns", 20);
+		Если КонечнаяСтрока <= 0 Тогда
+			КонечнаяСтрока = ?(МаксСтрок > 0, НачальнаяСтрока + МаксСтрок - 1, КоличествоСтрок);
+		КонецЕсли;
+		Если КонечнаяКолонка <= 0 Тогда
+			КонечнаяКолонка = ?(МаксКолонок > 0, НачальнаяКолонка + МаксКолонок - 1, КоличествоКолонок);
+		КонецЕсли;
+		КонечнаяСтрока = Мин(КоличествоСтрок, КонечнаяСтрока);
+		КонечнаяКолонка = Мин(КоличествоКолонок, КонечнаяКолонка);
+		Если НачальнаяСтрока > КоличествоСтрок Или НачальнаяКолонка > КоличествоКолонок Или КонечнаяСтрока < НачальнаяСтрока Или КонечнаяКолонка < НачальнаяКолонка Тогда
+			Возврат Новый Структура("rows,columns,address,row_start,row_end,column_start,column_end,cells", КоличествоСтрок, КоличествоКолонок, "", НачальнаяСтрока, КонечнаяСтрока, НачальнаяКолонка, КонечнаяКолонка, Новый Массив);
 		КонецЕсли;
-		АдресВсейОбласти = АдресОбластиТабличногоДокументаMCP(1, 1, КоличествоСтрок, КоличествоКолонок);
-		ТекстВсейОбласти = Поле.ПолучитьТекстОбласти(АдресВсейОбласти);
-		МаксСтрок = Мин(КоличествоСтрок, 50);
-		МаксКолонок = Мин(КоличествоКолонок, 20);
+		АдресОбласти = АдресОбластиТабличногоДокументаMCP(НачальнаяСтрока, НачальнаяКолонка, КонечнаяСтрока, КонечнаяКолонка);
 		Ячейки = Новый Массив;
-		Для НомерСтроки = 1 По МаксСтрок Цикл
+		Для НомерСтроки = НачальнаяСтрока По КонечнаяСтрока Цикл
 			СтрокаТекстов = Новый Массив;
-			Для НомерКолонки = 1 По МаксКолонок Цикл
+			Для НомерКолонки = НачальнаяКолонка По КонечнаяКолонка Цикл
 				Попытка
 					АдресЯчейки = АдресОбластиТабличногоДокументаMCP(НомерСтроки, НомерКолонки, НомерСтроки, НомерКолонки);
 					СтрокаТекстов.Добавить(Поле.ПолучитьТекстОбласти(АдресЯчейки));
@@ -3022,7 +3084,7 @@
 			КонецЦикла;
 			Ячейки.Добавить(СтрокаТекстов);
 		КонецЦикла;
-		Возврат Новый Структура("rows,columns,address,text,cells", КоличествоСтрок, КоличествоКолонок, АдресВсейОбласти, ТекстВсейОбласти, Ячейки);
+		Возврат Новый Структура("rows,columns,address,row_start,row_end,column_start,column_end,cells", КоличествоСтрок, КоличествоКолонок, АдресОбласти, НачальнаяСтрока, КонечнаяСтрока, НачальнаяКолонка, КонечнаяКолонка, Ячейки);
 	Исключение
 		Возврат Новый Структура("error", ОписаниеОшибки());
 	КонецПопытки;

{answer42-0.2.24 → answer42-0.2.26}/src/mcp_1c/credentials.py

@@ -58,38 +58,80 @@ class CredentialsStore:
     # ------------------------------------------------------------------
 
     def lookup(self, base_url: str) -> dict[str, str] | None:
-        """Return {username, password} for *base_url*, or None."""
-        url = base_url.rstrip("/")
+        """Return {username, password} for *base_url*, title or alias, or None."""
+        resolved = self.resolve(base_url)
+        if resolved is None:
+            return None
+        return {"username": resolved["username"], "password": resolved["password"]}
+
+    def resolve(self, base_url_or_title: str) -> dict[str, str] | None:
+        """Return full credential entry for URL, title or alias, without mutating it."""
+        value = str(base_url_or_title or "").strip()
+        url = value.rstrip("/")
+        normalized_title = value.lower()
+        for entry in self._entries:
+            title = str(entry.get("title", "")).strip().lower()
+            aliases = [str(a).strip().lower() for a in entry.get("aliases", [])]
+            if title and title == normalized_title or normalized_title in aliases:
+                return dict(entry)
         for entry in self._entries:
             pattern = entry["url"].rstrip("/")
             if url == pattern:
-                return {"username": entry["username"], "password": entry["password"]}
+                return dict(entry)
         for entry in self._entries:
             pattern = entry["url"].rstrip("/")
             if fnmatch.fnmatch(url, pattern):
-                return {"username": entry["username"], "password": entry["password"]}
+                return dict(entry)
         return None
 
-    def list_entries(self) -> list[dict[str, str]]:
-        """Return credential URL patterns without usernames or passwords."""
-        return [{"url": e["url"]} for e in self._entries]
-
-    def upsert(self, url: str, username: str, password: str) -> bool:
+    def list_entries(self) -> list[dict[str, object]]:
+        """Return credential titles and URL patterns without usernames or passwords."""
+        result: list[dict[str, str]] = []
+        for entry in self._entries:
+            public = {"url": entry["url"]}
+            if entry.get("title"):
+                public["title"] = entry["title"]
+            if entry.get("aliases"):
+                public["aliases"] = list(entry["aliases"])
+            result.append(public)
+        return result
+
+    def titles(self) -> list[dict[str, object]]:
+        """Return named credential entries only, without secrets."""
+        return [e for e in self.list_entries() if e.get("title")]
+
+    def upsert(self, url: str, username: str, password: str, title: str = "", aliases: list[str] | None = None) -> bool:
         """Add or update a credential entry for *url*.
 
         Returns True when an existing entry was updated, False when a new entry
         was created.  Usernames and passwords are intentionally not returned.
         """
         url = url.rstrip("/")
+        title = str(title or "").strip()
+        aliases = [str(alias).strip() for alias in (aliases or []) if str(alias).strip()]
         updated = False
         for entry in self._entries:
-            if entry["url"].rstrip("/") == url:
+            if entry["url"].rstrip("/") == url or (title and str(entry.get("title", "")).strip() == title):
+                entry["url"] = url
                 entry["username"] = username
                 entry["password"] = password
+                if title:
+                    entry["title"] = title
+                else:
+                    entry.pop("title", None)
+                if aliases:
+                    entry["aliases"] = aliases
+                else:
+                    entry.pop("aliases", None)
                 updated = True
                 break
         else:
-            self._entries.append({"url": url, "username": username, "password": password})
+            entry = {"url": url, "username": username, "password": password}
+            if title:
+                entry["title"] = title
+            if aliases:
+                entry["aliases"] = aliases
+            self._entries.append(entry)
         self._save()
         return updated
 

{answer42-0.2.24 → answer42-0.2.26}/src/mcp_1c/protocol.py

@@ -3,6 +3,8 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import Any
 
+MANAGER_PROTOCOL_VERSION = "2026.07.02.2"
+
 
 @dataclass(slots=True)
 class BridgeRequest:

{answer42-0.2.24 → answer42-0.2.26}/src/mcp_1c/release_helper.py

@@ -35,9 +35,46 @@ def _replace_version(pyproject: Path, version: str) -> bool:
     return True
 
 
+def _commits_since_last_tag() -> str:
+    previous_tag = _git_output(["describe", "--tags", "--abbrev=0", "--match", "v*"])
+    if previous_tag:
+        return _git_output(["log", "--pretty=format:- %s (%h)", f"{previous_tag}..HEAD"])
+    return _git_output(["log", "--pretty=format:- %s (%h)", "HEAD"])
+
+
+def _default_release_notes(tag: str) -> str:
+    try:
+        commits = _commits_since_last_tag()
+    except subprocess.CalledProcessError:
+        commits = _git_output(["log", "--pretty=format:- %s (%h)", "-n", "20"])
+    if not commits.strip():
+        commits = "- Maintenance release"
+    return (
+        f"# Answer42 {tag}\n\n"
+        "## Changes\n"
+        f"{commits}\n\n"
+        "## Verification\n"
+        "- GitLab CI runs unit tests and package checks on branch and tag pipelines.\n"
+        "- PyPI publishing and GitLab Release creation are performed by the tag pipeline.\n"
+    )
+
+
+def _ensure_release_notes(repo_root: Path, tag: str, *, dry_run: bool, overwrite: bool) -> Path:
+    notes_path = repo_root / "release-notes" / f"{tag}.md"
+    if notes_path.exists() and notes_path.stat().st_size > 0 and not overwrite:
+        print(f"Release notes already exist: {notes_path.relative_to(repo_root)}")
+        return notes_path
+    text = _default_release_notes(tag)
+    print(f"+ write {notes_path.relative_to(repo_root)}")
+    if not dry_run:
+        notes_path.parent.mkdir(parents=True, exist_ok=True)
+        notes_path.write_text(text, encoding="utf-8")
+    return notes_path
+
+
 def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(
-        description="Bump pyproject.toml version, commit, tag and push to trigger PyPI release CI"
+        description="Bump version, create release notes, commit, tag and push to trigger Answer42 release CI"
     )
     parser.add_argument("version", help="Version without leading v, e.g. 0.2.1")
     parser.add_argument("--remote", default="origin", help="Git remote to push. Default: origin")
@@ -45,6 +82,7 @@ def main(argv: list[str] | None = None) -> int:
     parser.add_argument("--dry-run", action="store_true", help="Print commands without executing them")
     parser.add_argument("--no-push", action="store_true", help="Create commit/tag locally but do not push")
     parser.add_argument("--allow-dirty", action="store_true", help="Allow unrelated uncommitted changes")
+    parser.add_argument("--overwrite-notes", action="store_true", help="Overwrite existing release notes")
     args = parser.parse_args(argv)
 
     version = args.version.removeprefix("v")
@@ -63,21 +101,28 @@ def main(argv: list[str] | None = None) -> int:
     if existing_tags:
         raise SystemExit(f"Tag already exists: {tag}")
 
-    print(f"Bumping {pyproject} to {version}")
+    print(f"Preparing {tag}")
     changed = True
     if not args.dry_run:
         changed = _replace_version(pyproject, version)
     else:
-        print(f"+ update {pyproject}: version = {version!r}")
+        print(f"+ update {pyproject.relative_to(repo_root)}: version = {version!r}")
+    notes_path = _ensure_release_notes(
+        repo_root, tag, dry_run=args.dry_run, overwrite=args.overwrite_notes
+    )
 
+    files_to_add = [str(notes_path.relative_to(repo_root))]
     if changed:
-        _run(["git", "add", str(pyproject.relative_to(repo_root))], dry_run=args.dry_run)
-        _run(["git", "commit", "-m", f"Release {tag}"], dry_run=args.dry_run)
-    else:
-        print(f"Version is already {version}; tagging current HEAD without a version commit.")
+        files_to_add.insert(0, str(pyproject.relative_to(repo_root)))
+    _run(["git", "add", *files_to_add], dry_run=args.dry_run)
+    _run(["git", "commit", "-m", f"Release {tag}"], dry_run=args.dry_run)
     _run(["git", "tag", "-a", tag, "-m", f"Release {tag}"], dry_run=args.dry_run)
     if not args.no_push:
         _run(["git", "push", args.remote, args.branch], dry_run=args.dry_run)
         _run(["git", "push", args.remote, tag], dry_run=args.dry_run)
         print("CI will publish PyPI package and create GitLab Release from the pushed tag.")
     return 0
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())

{answer42-0.2.24 → answer42-0.2.26}/src/mcp_1c/server.py

@@ -27,6 +27,7 @@ from mcp.server.fastmcp import FastMCP
 
 from . import __version__
 from . import os_support
+from .protocol import MANAGER_PROTOCOL_VERSION
 from . import platform as _platform
 from . import runtime
 from . import skill_installer
@@ -1697,6 +1698,13 @@ async def start_session(
     rag_enabled: Annotated[bool, "Enable built-in RAG for this session"] = True,
 ) -> dict[str, Any]:
     """One-shot session factory: detect version, start infrastructure and connect the 1C test client."""
+    credential_ref = _resolve_credential_reference(base_url)
+    if credential_ref is not None and credential_ref.get("url"):
+        base_url = str(credential_ref["url"])
+        if not username:
+            username = str(credential_ref.get("username", ""))
+        if not password:
+            password = str(credential_ref.get("password", ""))
     base_url = _platform.normalize_infobase_url(base_url)
     connection_mode = "auto"
     connection_value = ""
@@ -2116,18 +2124,24 @@ def _lookup_credentials(base_url: str) -> dict[str, str] | None:
     return _credentials_store().lookup(base_url)
 
 
+def _resolve_credential_reference(value: str) -> dict[str, str] | None:
+    if not _CREDENTIAL_STORE_ENABLED or not value:
+        return None
+    return _credentials_store().resolve(value)
+
+
 @mcp.tool()
 def credentials_check(base_url: str) -> dict[str, object]:
-    """Check whether credentials exist for a base URL without returning secrets."""
+    """Check whether credentials exist for a base URL or saved title without returning secrets."""
     if not _CREDENTIAL_STORE_ENABLED:
         return {"base_url": base_url, "found": False, "disabled": True}
-    credentials = _credentials_store().lookup(base_url)
+    credentials = _credentials_store().resolve(base_url)
     if credentials is None:
         return {"base_url": base_url, "found": False}
-    return {
-        "base_url": base_url,
-        "found": True,
-    }
+    result: dict[str, object] = {"base_url": base_url, "found": True, "url": credentials.get("url", "")}
+    if credentials.get("title"):
+        result["title"] = credentials["title"]
+    return result
 
 
 @mcp.tool()
@@ -2135,6 +2149,8 @@ def credentials_save(
     url: Annotated[str, "Base URL pattern (exact or wildcard like https://*.example.com/*)"],
     username: Annotated[str, "1C username"],
     password: Annotated[str, "1C password"],
+    title: Annotated[str, "Optional saved base title/alias, e.g. bp27932"] = "",
+    aliases: Annotated[str, "Optional comma-separated aliases for the same entry"] = "",
 ) -> dict[str, object]:
     """Save or update credentials for a URL pattern in the local credentials store.
 
@@ -2144,12 +2160,14 @@ def credentials_save(
     """
     if not _CREDENTIAL_STORE_ENABLED:
         raise _credential_store_disabled_error()
-    updated = _credentials_store().upsert(url, username, password)
-    return {
-        "url": url,
-        "saved": True,
-        "updated": updated,
-    }
+    alias_list = [part.strip() for part in aliases.split(",") if part.strip()]
+    updated = _credentials_store().upsert(url, username, password, title=title, aliases=alias_list)
+    result: dict[str, object] = {"url": url, "saved": True, "updated": updated}
+    if title:
+        result["title"] = title
+    if alias_list:
+        result["aliases"] = alias_list
+    return result
 
 
 @mcp.tool()
@@ -2164,13 +2182,21 @@ def credentials_remove(
 
 
 @mcp.tool()
-def credentials_list() -> list[dict[str, str]]:
-    """List configured credential URL patterns (no usernames or passwords)."""
+def credentials_list() -> list[dict[str, object]]:
+    """List configured credential URL patterns/titles (no usernames or passwords)."""
     if not _CREDENTIAL_STORE_ENABLED:
         return []
     return _credentials_store().list_entries()
 
 
+@mcp.tool()
+def credentials_titles() -> list[dict[str, object]]:
+    """List saved credential titles/aliases that can be used as start_session base_url."""
+    if not _CREDENTIAL_STORE_ENABLED:
+        return []
+    return _credentials_store().titles()
+
+
 _PLACEHOLDER_PASSWORD_RE = re.compile(r"^\*{3,}$")
 _AUTH_FAILURE_MARKERS = (
     "пользователь иб не идентифицирован",
@@ -2448,6 +2474,23 @@ async def _wait_for_test_client_ready(sess: SessionState, host: str, port: int,
     raise RuntimeError(message)
 
 
+async def _verify_manager_protocol(sess: SessionState) -> dict[str, Any]:
+    info = await sess.bridge.call("manager_info", {})
+    if not isinstance(info, dict):
+        raise RuntimeError(
+            "MCPTestManager.cf is too old or incompatible: manager_info returned an unexpected response. "
+            f"Expected protocol {MANAGER_PROTOCOL_VERSION}. Rebuild/reload MCPTestManager.cf."
+        )
+    actual = str(info.get("manager_protocol_version") or "")
+    if actual != MANAGER_PROTOCOL_VERSION:
+        raise RuntimeError(
+            "MCPTestManager.cf protocol mismatch: "
+            f"Python expects {MANAGER_PROTOCOL_VERSION}, but 1C manager reports {actual or '<missing>'}. "
+            "Rebuild MCPTestManager.cf from current sources and restart/reload Answer42 MCP."
+        )
+    return info
+
+
 async def _connect_test_client_impl(
     sess: SessionState,
     *,
@@ -2465,6 +2508,7 @@ async def _connect_test_client_impl(
 ) -> Any:
     """Launch 1cv8c /TESTCLIENT from Python and attach the test manager to it."""
     await _wait_for_bridge_connected(sess, timeout=60.0)
+    manager_info = await _verify_manager_protocol(sess)
     r_base = _platform.normalize_infobase_url(base_url or sess.base_url)
     r_value = connection_value or r_base
     mode = _normalize_connection_mode(connection_mode, r_value, r_base)
@@ -2594,7 +2638,8 @@ async def _connect_test_client_impl(
               "port": r_port, "host": host, "client_pid": sess.test_client_process.pid,
               "client_log": str(client_out_log), "client_stdout_log": str(sess.client_log_dir / client_stdout_log),
               "connection_mode": mode, "connection_value": r_value,
-              "target_connection_mode": target_connection_mode}
+              "target_connection_mode": target_connection_mode,
+              "expected_manager_protocol_version": MANAGER_PROTOCOL_VERSION}
     _touch_session(sess)
     monitor_task: asyncio.Task[int | None] | None = None
     try:
@@ -3236,13 +3281,19 @@ async def table_cell_text(
 
 @mcp.tool()
 async def tabular_documents(
-    include_text: Annotated[bool, "Include tabular document text"] = False,
+    include_text: Annotated[bool, "Include tabular document cells"] = False,
     max_depth: Annotated[int, "Maximum search depth"] = 8,
+    row_start: Annotated[int, "First row to read when include_text=true (1-based)"] = 1,
+    row_end: Annotated[int, "Last row to read when include_text=true; 0 = row_start + max_rows - 1"] = 0,
+    column_start: Annotated[int, "First column to read when include_text=true (1-based)"] = 1,
+    column_end: Annotated[int, "Last column to read when include_text=true; 0 = column_start + max_columns - 1"] = 0,
+    max_rows: Annotated[int, "Maximum rows to read when row_end=0; 0 = all rows"] = 50,
+    max_columns: Annotated[int, "Maximum columns to read when column_end=0; 0 = all columns"] = 20,
     *,
     session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
 ) -> Any:
-    """List tabular document fields in the active window; optionally include their text."""
-    return await _bridge_call_recorded(session_id, "tabular_documents", {"include_text": include_text, "max_depth": max_depth})
+    """List tabular document fields with dimensions; optionally include a cells range."""
+    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})
 
 
 @mcp.tool()
@@ -3250,11 +3301,17 @@ async def tabular_document_text(
     name: Annotated[str, "Tabular document field technical name"] = "",
     title: Annotated[str, "Tabular document field visible title"] = "",
     max_depth: Annotated[int, "Maximum search depth"] = 8,
+    row_start: Annotated[int, "First row to read (1-based)"] = 1,
+    row_end: Annotated[int, "Last row to read; 0 = row_start + max_rows - 1"] = 0,
+    column_start: Annotated[int, "First column to read (1-based)"] = 1,
+    column_end: Annotated[int, "Last column to read; 0 = column_start + max_columns - 1"] = 0,
+    max_rows: Annotated[int, "Maximum rows to read when row_end=0; 0 = all rows"] = 50,
+    max_columns: Annotated[int, "Maximum columns to read when column_end=0; 0 = all columns"] = 20,
     *,
     session_id: Annotated[str, "Session id"] = DEFAULT_SESSION,
 ) -> Any:
-    """Return text and dimensions of a tabular document field in the active window."""
-    return await _bridge_call_recorded(session_id, "tabular_document_text", {"name": name, "title": title, "max_depth": max_depth})
+    """Return dimensions and a cells range of a tabular document field in the active window."""
+    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})
 
 
 @mcp.tool()