TypeScript SDK: Среда выполнения и агенты
Сценарий хранится в исходном виде. Перед выполнением Node.js 24 удаляет типы из исходника без отдельного шага сборки и без файлов JavaScript на диске. interface, type, generics, satisfies и аннотации не добавляют работы вашему алгоритму. Для enum, пространств имён со значениями и параметров-свойств конструктора используется встроенное преобразование Node.js.
Проверка и запуск решают разные задачи. При проверке и сохранении нативный TypeScript 7.0.2 анализирует типы в строгом режиме (strict, стандартная библиотека ES2024). Ошибки содержат строку, код TS… и описание. Такой код можно сохранить как черновик, но опубликовать или запустить версию с ошибками нельзя. При временной недоступности проверки публикация также блокируется. Проверка типов сама по себе не обращается к источнику и не выполняет пользовательский код.
Что доступно
Стандартные коллекции, строки, числа, даты, Promise, URL, TextEncoder, TextDecoder. Через SDK доступны HTTP, браузер, HTML, документы, почта, состояние, S3 и AI. На агенте действуют те же API и ограничения. Указатели ошибок относятся к исходному TypeScript, в том числе после преобразования enum.
Ограничения среды
Это язык сценариев, а не произвольный Node.js-проект. Пакеты npm, import/export, require, process, файловые операции и прямой fetch недоступны. Типы SDK подключены глобально, импортировать их не нужно. JSX/TSX, декораторы, внешние reference-директивы, собственный tsconfig.json и алиасы путей не поддерживаются. Для сетевых запросов используйте ctx.http(), для документов ctx.documents(), для файлов ctx.storage().
Проверка типов не заменяет проверку реальных данных. Ответ API, JSON и содержимое таблицы могут не совпасть с вашей аннотацией. Проверяйте поля перед сохранением и выполняйте пробный прогон.
Агент
При создании агента включите TypeScript. JavaScript и TypeScript используют один контейнер среды выполнения, при этом права на языки учитываются отдельно. Если выбран только TypeScript, запуск JavaScript этим не разрешается. Старый агент без заявленной поддержки TypeScript не получит такой сценарий: создайте комплект с нужным языком и обновите агент. Браузер для интерактивных сайтов включается отдельно.
Пробный прогон, рабочий запуск, журнал, остановка и повтор работают так же, как для JavaScript. Пошаговый отладчик с остановками доступен только для PHP. Для TypeScript используйте журнал, ctx.log(), ctx.progress() и небольшие пробные запуски.