Repository navigation
wtctl 0.6.0
Файлы любого размера: files.write пишет их путём настольной админки и сверяет после записи, files.read сохраняет файл сервера на диск, а своих пределов размера ввода, кода и загрузки у клиента больше нет. Кроме того, точнее стали ошибки и подсказки: отказ загрузки по политике сервера — UPLOAD_REFUSED, сбой части загрузки не выдаётся за недоступный сервер, отказы по именам предлагают похожие, hcm_types видит каталоги базы trash. Настройки приложений и скрипты, которые работают с инструментами логов, objects.patch или schema.types, нужно сверить с разделом «Несовместимые изменения».
Несовместимые изменения:
- Инструменты MCP
hcm_log_readиhcm_log_followназываютсяhcm_logs_readиhcm_logs_follow, какhcm_logs_list,hcm_logs_searchи командыwtctl logs …. Вызов по старому имени отвечаетmcp.unknown_tool, подсказка называет новое имя. Разрешение, выданное в приложении по старому имени инструмента, нужно выдать заново. objects.patchотклоняетremoveс путём, которому в документе ничего не соответствует:PATCH_PATH_MISSING, сообщение называет путь, ничего не записано, даже если другие пути вызова нашлись. Сpreview:true— тот же отказ. Раньше такой путь молча пропускался, и опечатку в ключе элемента было не отличить от «удалять нечего». Скрипт, который удаляет элемент, не зная, есть ли он, должен сначала прочитать объект.beforeиafterу структуры вchangesответаobjects.patch— объект с полями первого уровня; вложенные структуры и списки по-прежнему названы, а не скопированы. Раньше это была строка с именами полей:"{collaborator_id}". Предпросмотр удаления элемента списка показывает его ключ и поля.- В ответе
schema.types(hcm_types,wtctl types) нет поляcatalogsс числом каталогов: каталоги без своего типа объекта теперь перечислены в самом списке и входят вtotal. В SDK у строкtypesполяtypeиcustomFieldsнеобязательные. - Если сервер не сообщил списки папок,
files.writeтребует праваexecuteдля любой папки: без списков клиент не отличает папку данных от папки кода. Раньше такая запись шла с однимwrite.
Добавлено:
-
Загрузка (
web.pages.uploadFile,web.pages.uploadChunk,wtctl file upload), которую сервер отклонил по своей политике загрузки, отвечаетUPLOAD_REFUSED. Подсказка называет, какие имена обычно принимает загрузка, и что файл по своему адресу записываетfiles.write. У загрузки частями в сообщении текст отказа сервера; на загрузку одним запросом сервер текст в ответе не передаёт, только пишет в свой лог. Раньше отказ былPLATFORM_HTTPс HTTP 415 или 500 без причины. -
schema.typesперечисляет после типов каталоги без своего типа объекта (group_collaborators,event_collaborators,trash_docsи другие) строками{catalog}безtype, и поиск находит их по имени. Строки таких каталогов строит сервер, документов у них нет; искать в них можно черезhcm_query. Раньше ответ давал только их число, а имя называл, только когда поиск находил его или тип с тем же началом имени. -
files.writeпринимаетfile— полный путь к файлу на компьютере, где работает клиент (у MCP-сервера — где он запущен). Файл читается с диска частями, содержимое не идёт через вызов, и память клиента не растёт с размером файла.wtctl files write АДРЕС --input-file ФАЙЛпередаёт операции путь, в SDK —writeFile({ url, file }). -
files.readсfileсохраняет файл сервера на диск байт в байт, текст или двоичный, любого размера: файл не проходит через ответ,maxResponseBytesна него не действует, и память клиента не растёт с размером файла. Ответ —{bytes, file}с полным путём. Существующий файл заменяется только сoverwrite:true, иначеFILE_EXISTS; недочитанный файл под своим именем не появляется. В CLI —wtctl files read АДРЕС --to ФАЙЛ [--overwrite], в SDK —readFile({ url, file, overwrite }). -
Предпросмотр
objects.patchназывает вserverFilledполя правки, которые сервер заполняет сам при сохранении документа, напримерposition_nameу сотрудника: записанное значение он, скорее всего, заменит. Клиент узнаёт такие поля по коду формы, поэтому список бывает и лишним, и неполным.READ_BACK_MISMATCHпо такому полю называет причину и поле, которое менять вместо него:position_idвместоposition_name.
Изменения:
files.writeпишет файл любого размера в любую папку данных и папку кода, в том числе вwt_dataиtrash, тем же способом, что настольная админка. Запись в папку кода больше не идёт через код на сервере, но по-прежнему требует праваexecute: файл там — код сервера. Пределы 750 КБ текста и 580 КБ двоичных данных убраны, запись больше не отвечаетFILE_TOO_LARGE.- После записи
files.writeчитает файл с сервера и сверяет с отправленным:confirmedзначит, что на сервере ровно отправленные байты, а расхождение —READ_BACK_MISMATCH. Прерванная запись отвечаетindeterminateс сообщением, что файл на сервере может быть пустым или недописанным и запись можно повторить целиком. Если файл записан, а прочитать его для сверки не удалось (например, истёкtimeoutMs), ответ — тожеindeterminate, но сообщение говорит именно это: содержимое на сервере не проверено. files.readполучает файл потоком байт, а не в base64 внутри XML: ответ приходит быстрее, и клиенту нужно меньше памяти. БезfileпределmaxResponseBytesсчитается по размеру самого файла, а файл больше предела отвечаетFILE_TOO_LARGEс подсказкой сохранить его черезfile. Раньше такой файл отвечалPLATFORM_PROTOCOL«Ответ сервера не соответствует ожидаемому виду».- У клиента нет своих пределов размера. Ввод команды
wtctl(--input-file,--stdin,--params-file) больше 8 МБ, код для выполнения больше 1 МБ и загрузкаweb.pages.uploadFileбольше 8 МБ проходят; ошибкиSCRIPT_TOO_LARGEбольше нет, аmaxResponseBytesзагрузку не ограничивает. Размер ограничивают сервер, память и диск компьютера иtimeoutMs: см. раздел «Размер файлов и данных» вdocs/configuration.md. - Запись
files.writeв сотни мегабайт идёт втрое быстрее, а код на сервере в мегабайт уходит вдвое быстрее: клиент не проверяет заново XML, который собрал сам, и быстрее проверяет большие строки. SCRIPT_FAILEDставит исходnot_sentтолько на отказ разбора кода в том виде, в каком его присылают 2025.1 и 2025.2; любая другая ошибка в коде —indeterminate. Подсказка приindeterminateговорит, что код, который только читал, можно повторить, а код, который менял данные, — сначала проверить.- Отказы по именам типов, каталогов и операций предлагают похожие имена и при опечатке в одну букву. У
INVALID_FILTER_OPERATORпоявилась подсказка, аrpc.list, скрыв функции, которые вызываются только из кода на сервере, подсказываетall:true. - Подсказка отказа обрезается на 1000 знаках вместо 500, обрезанные сообщение и подсказка кончаются многоточием. Превью сохранённого ответа показывает столько элементов списка, сколько помещается, а подсказка говорит, сколько из них показано: «первые 40 из 1000».
Исправления:
schema.types(hcm_types) называет каталог и у типов, каталог которых лежит в базеtrash:user_data—user_datas,active_web_template,profiling_record.schema.getпо такому типу отмечает поля каталогаquery:true. Раньше у них не было поляcatalog, а гайд говорил, что каталога нет вовсе.- Отказ
files.deleteвwt_dataиtrash(FILE_NOT_DELETABLE) больше не говорит, что сервер там не удаляет файлы: файл, который записалfiles.write, сервер хранит не на диске, и клиент не отличает его от файла на диске. Сообщение — «В папке wt_data файлы и папки не удаляются.», подсказка советует писать временные файлы вshare. - Сбой части загрузки на сервере (
web.pages.uploadChunk, HTTP 501–503) больше не выдаётся за недоступный сервер. Ответ —PLATFORM_HTTP«Сервер не записал часть файла (HTTP 502).» или, на последней части, «Сервер не собрал файл из частей (HTTP 503).», подсказка — повторить загрузку целиком. Текст сервера не показывается: в нём бывают пути сервера. mcp.invalid_argumentsназывает лишний аргумент: «Аргументы не подходят инструменту: лишний аргумент query.», несколько — «лишние аргументы query, foo». Вdetails.validationу этой причины —keysс именами. Раньше сообщение было общим, а у причины был пустойpath.- Подсказка
WRITE_DISABLEDиEXECUTE_DISABLEDу копии подключения в SDK ({ ...loadConfig(), timeoutMs }) называет подключение и где включить право, как у самого подключения; раньше подсказка была общей. Фраза «MCP-сервер видит правку после перезапуска» осталась только у MCP-сервера: в CLI и SDK её больше нет. files.readбезfileдержит в памяти меньше копий файла: у файла 64 МБ пик памяти клиента — около 300 МБ, раньше около 500 МБ. Ответ и сохранённый результат прежние.files.writeбольше 2 МБ в папку данных записывал обрезанный файл и отвечалconfirmed.- Запись
files.writeвwt_dataне доходила до сервера: ответ былconfirmed, аfiles.readотдавал прежнее содержимое. - Файл в сотни мегабайт
files.readне читал и с большимmaxResponseBytes: клиенту не хватало памяти. - Двоичные данные
{base64}примерно от 3 МБ в загрузке (web.pages.uploadFile,web.pages.uploadChunk) и вnative.lds.putUrlотвечалиINTERNAL_ERROR: проверка base64 в клиенте переполняла стек. - Время запроса, истёкшее посреди ответа сервера, называется таймаутом с подсказкой про
timeoutMs. Раньше ответ говорил, что соединение оборвалось. - Отказ диска при сохранении файла на этом компьютере (
results.export,files.readсfile) — нет прав, места или путь не годится — отвечаетFILE_SAVE_FAILEDс кодом системы. Раньше ответ былINTERNAL_ERRORс подсказкой, что это дефект клиента. - Подключение с
usernameEnvилиpasswordEnv, чья переменная не задана или пуста, отклоняется сINVALID_CONFIG, и сообщение называет переменную. Раньше ответ говорил «не задан пароль», а без обеих переменных подключение открывалось без учётных данных.config init --password-envс незаданной переменной записывает подключение и предупреждает об этом вnext. - У пропущенного шага
executeв ответеcheckсказано, где подключению включают правоexecute. - В
changesответаobjects.patchнет полей, которым записано то же значение, в том числе ID в другой записи и логическое значение, которое сервер хранит как0или1. Раньше пустая правка отвечалаnoop:trueи строками с одинаковымиbeforeиafter, аis_dismiss:falseу поля со значением0уходил на сервер как изменение.