Сервер

Команда dropstone serve запускает автономный HTTP-сервер, который предоставляет конечную точку OpenAPI, которую может использовать клиент Dropstone.

Использование

dropstone serve [--port <number>] [--hostname <string>] [--cors <origin>]

Параметры

--cors можно передавать несколько раз:

dropstone serve --cors http://localhost:5173 --cors https://app.example.com

Аутентификация

Установите DROPSTONE_SERVER_PASSWORD, чтобы защитить сервер с помощью базовой HTTP-аутентификации. Имя пользователя по умолчанию — dropstone, либо установите DROPSTONE_SERVER_USERNAME, чтобы переопределить его. Это применимо как к dropstone serve, так и к dropstone web.

DROPSTONE_SERVER_PASSWORD=your-password dropstone serve

Учетные данные агента

DROPSTONE_SERVER_PASSWORD защищает сам сервер. Он не сообщает агенту, как связаться с Dropstone. На машине без присмотра нет авторизованной учетной записи для наследования, поэтому передайте ключ API через конфигурацию провайдера:

{
  "provider": {
    "dropstone": {
      "options": {
        "apiKey": "dsk_live_...",
        "baseURL": "https://api.dropstone.io/api/v1"
      }
    }
  }
}

baseURL имеет значение. Ключи API принимаются по адресу /api/v1, а не /v1, и ключ, отправленный на /v1, отклоняется с ошибкой 403 Invalid token format. Please log in again. Установите его здесь, а не через DROPSTONE_BASE_URL, который также используется для создания конечных точек учетной записи, использования и памяти, и сломает их, если вы укажете его на версионированный путь.

Сгенерируйте ключ на dropstone.io/dashboard/settings.

Отправка запроса

POST /session/:id/message требует оба параметра agent и model. Если опустить model, значение по умолчанию не определяется: ход возвращает 200 с пустым телом, и ничего не выполняется.

curl -X POST "http://127.0.0.1:4096/session/$SID/message?directory=$PWD" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "build",
    "model": { "providerID": "dropstone", "modelID": "dropstone-pro" },
    "parts": [{ "type": "text", "text": "Add error handling to src/index.ts" }]
  }'

Ход, завершившийся ошибкой, всё равно возвращает 200. Причина находится в data.info.error, а не на транспортном уровне, поэтому проверяйте это поле, а не полагайтесь на код состояния.

Как это работает

dropstone serve предоставляет возможности Dropstone через конечную точку HTTP OpenAPI 3.1. Та же конечная точка используется для генерации SDK.

Используйте сервер, когда хотите управлять Dropstone программно: из скрипта, конвейера CI или собственной интеграции. Интерактивный сеанс и сервер независимы. Запуск dropstone serve создает новый автономный сервер независимо от того, открыт ли у вас интерактивный сеанс.

Вы можете переопределить адрес привязки с помощью флагов --hostname и --port.

Спецификация

Сервер публикует спецификацию OpenAPI 3.1, которую можно просмотреть по адресу:

http://<hostname>:<port>/doc

Например, http://localhost:4096/doc. Используйте спецификацию для генерации клиентов или проверки типов запросов и ответов. Или просмотрите её в обозревателе Swagger.

API

Сервер Dropstone предоставляет следующие API.

Глобальные

Проект

Путь и VCS

Конфигурация

Сеансы

Сообщения

Команды

Файлы

Параметры запроса /find/file

• query (обязательный): строка поиска (нечеткое совпадение)
• type (необязательный): ограничить результаты "file" или "directory"
• directory (необязательный): переопределить корень проекта для поиска
• limit (необязательный): максимум результатов (1–200)
• dirs (необязательный): устаревший флаг ("false" возвращает только файлы)

LSP, форматтеры и MCP

Агенты

Журналирование

Аутентификация

События

Документация