Cursor выпустил TypeScript SDK, превращающий его кодинг-агента в библиотеку

29 апреля 2026 года Cursor открыл публичную бету @cursor/sdk, TypeScript-библиотеки, оборачивающей тот же runtime, harness и модели, которые приводят в движение десктопный редактор, CLI и веб-приложение. Идея простая: агент, прятавшийся внутри интерфейса Cursor, теперь стал программируемым компонентом, который можно вызывать из ваших собственных сервисов. Та же модель Composer, тот же движок контекста, та же поверхность инструментов, доступные из процесса Node.

Это тот же сдвиг, через который SDK от Anthropic и OpenAI прошли годы назад, но уже для агента, специализирующегося на коде, а не для чистой чат-модели.

Что входит в @cursor/sdk

Устанавливается как любой другой пакет:

npm install @cursor/sdk

Минимальный пример “создать агента и запустить промпт” в официальной документации выглядит так:

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

Интересное поле здесь, local. Передайте его, и агент работает с вашей файловой системой в текущем рабочем каталоге. Уберите его и замените на cloud: { ... }, и тот же вызов теперь выполняется внутри изолированной VM, которую Cursor разворачивает за вас, с индексацией кодовой базы, семантическим поиском и grep на удалённой стороне. Контракт Agent.create, agent.send и потока run идентичен в обоих случаях.

Эта симметрия и есть главная фича. Скрипты CI, которым нужно держать результаты локально, остаются локальными. Хостящиеся агенты, которым нужно запускать недоверенные промпты по эфемерным клонам, могут переехать на облачный runtime без переписывания harness.

Субагенты, хуки, MCP и skills

SDK не ограничивается одиночными промптами. Он предоставляет те же примитивы, которыми пользуется десктопное приложение:

• Run даёт стриминг, ожидание и отмену. Поток эмитит события SDKMessage: токены ассистента, вызовы инструментов, thinking и обновления статуса как discriminated union.
• Субагенты позволяют родительскому run делегировать самодостаточную подзадачу, не засоряя собственное окно контекста.
• Хуки срабатывают до и после вызовов инструментов, так что вы можете запретить опасные записи в файлы, логировать каждую shell-команду или переписывать промпты по политике.
• MCP-серверы подключаются через stdio или http, то есть любая существующая MCP-интеграция (GitHub, Linear, ваши внутренние данные) подключается без изменений в коде.
• Пространство имён Cursor отвечает за работу на уровне аккаунта: список моделей, список репозиториев, управление API-ключами.

Ошибки типизированы: AuthenticationError, RateLimitError, ConfigurationError и компания. Парсить строки сообщений больше не нужно.

Почему это важно и для команд на .NET

SDK сегодня доступен только в TypeScript, но облачный runtime не привязан к языку, так что его можно поднимать из небольшого Node-сайдкара, в который .NET-сервис уходит через shell-out. В сочетании с Microsoft Agent Framework на стороне C# реалистичный паттерн 2026 года начинает вырисовываться: оркестрировать из .NET, отправлять задачи редактирования кода в хостящегося агента Cursor через SDK и получать результаты через MCP.

Цена идёт по стандартной токеновой модели без отдельного места под использование SDK, так что стоимость эксперимента это просто то, что сжигает модель. На что нужно следить, так это на жизненный цикл облачной VM. Долгие run могут накапливать настоящие деньги, а SDK сам не отменяет простаивающих агентов за вас.

Полная документация беты живёт по адресу cursor.com/docs/sdk/typescript, а пост о запуске здесь: cursor.com/blog/typescript-sdk.