answer42 0.2.25__tar.gz → 0.2.26__tar.gz

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "answer42"
-version = "0.2.25"
+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.25 → answer42-0.2.26}/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.1";
+	Возврат "2026.07.02.2";
 КонецФункции
 
 &НаКлиенте
@@ -2950,12 +2950,12 @@
 	Глубина = СвойствоСтруктуры(Параметры, "max_depth", 8);
 	ВключатьТекст = СвойствоСтруктуры(Параметры, "include_text", Ложь);
 	Результат = Новый Массив;
-	НайтиТабличныеДокументыРекурсивно(АктивноеОкно, Результат, ВключатьТекст, 0, Глубина);
+	НайтиТабличныеДокументыРекурсивно(АктивноеОкно, Результат, ВключатьТекст, Параметры, 0, Глубина);
 	Возврат Новый Структура("count,items", Результат.Количество(), Результат);
 КонецФункции
 
 &НаКлиенте
-Процедура НайтиТабличныеДокументыРекурсивно(Объект, Результат, ВключатьТекст, ТекущаяГлубина, МаксимальнаяГлубина)
+Процедура НайтиТабличныеДокументыРекурсивно(Объект, Результат, ВключатьТекст, ПараметрыТекста, ТекущаяГлубина, МаксимальнаяГлубина)
 	Если ТекущаяГлубина > МаксимальнаяГлубина Тогда
 		Возврат;
 	КонецЕсли;
@@ -2968,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, МаксимальнаяГлубина);
 		КонецЦикла;
 	Исключение
 		Инфо = ИнформацияОбОшибке();
@@ -3014,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(НомерСтроки, НомерКолонки, НомерСтроки, НомерКолонки);
 					СтрокаТекстов.Добавить(Поле.ПолучитьТекстОбласти(АдресЯчейки));
@@ -3046,7 +3084,7 @@
 			КонецЦикла;
 			Ячейки.Добавить(СтрокаТекстов);
 		КонецЦикла;
-		Возврат Новый Структура("rows,columns,address,text,cells", КоличествоСтрок, КоличествоКолонок, АдресВсейОбласти, ТекстВсейОбласти, Ячейки);
+		Возврат Новый Структура("rows,columns,address,row_start,row_end,column_start,column_end,cells", КоличествоСтрок, КоличествоКолонок, АдресОбласти, НачальнаяСтрока, КонечнаяСтрока, НачальнаяКолонка, КонечнаяКолонка, Ячейки);
 	Исключение
 		Возврат Новый Структура("error", ОписаниеОшибки());
 	КонецПопытки;

{answer42-0.2.25 → 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.25 → answer42-0.2.26}/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.1"
+MANAGER_PROTOCOL_VERSION = "2026.07.02.2"
 
 
 @dataclass(slots=True)

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

@@ -1698,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 = ""
@@ -2117,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()
@@ -2136,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.
 
@@ -2145,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()
@@ -2165,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 = (
     "пользователь иб не идентифицирован",
@@ -3256,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()
@@ -3270,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()