Serveur

La commande dropstone serve exécute un serveur HTTP headless qui expose un endpoint OpenAPI qu'un client Dropstone peut utiliser.

Utilisation

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

Options

--cors peut être passé plusieurs fois :

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

Authentification

Définissez DROPSTONE_SERVER_PASSWORD pour protéger le serveur avec une authentification HTTP de base. Le nom d'utilisateur par défaut est dropstone, ou définissez DROPSTONE_SERVER_USERNAME pour le remplacer. Cela s'applique à la fois à dropstone serve et à dropstone web.

DROPSTONE_SERVER_PASSWORD=your-password dropstone serve

Identifiants de l'agent

DROPSTONE_SERVER_PASSWORD protège le serveur lui-même. Il ne dit pas à l'agent comment joindre Dropstone. Sur une machine sans surveillance, il n'y a pas de compte connecté à hériter, donc transmettez une clé API via la configuration du fournisseur :

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

baseURL est important. Les clés API sont acceptées sur /api/v1, pas sur /v1, et une clé envoyée à /v1 est rejetée avec 403 Invalid token format. Please log in again. Définissez-la ici plutôt que via DROPSTONE_BASE_URL, qui est également utilisé pour construire les endpoints de compte, d'utilisation et de mémoire et les cassera si vous le pointez vers un chemin versionné.

Générez une clé sur dropstone.io/dashboard/settings.

Envoi d'une invite

POST /session/:id/message nécessite à la fois agent et model. Omettre model ne résout aucun défaut : le tour renvoie 200 avec un corps vide et rien ne s'exécute.

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" }]
  }'

Un tour qui échoue renvoie toujours 200. La raison se trouve dans data.info.error, pas au niveau du transport, donc vérifiez ce champ plutôt que de vous fier au code de statut.

Comment ça fonctionne

dropstone serve expose les capacités de Dropstone via un endpoint HTTP OpenAPI 3.1. Le même endpoint est utilisé pour générer le SDK.

Utilisez le serveur lorsque vous souhaitez piloter Dropstone par programmation : depuis un script, un pipeline CI, ou une intégration personnalisée. La session interactive et le serveur sont indépendants. Lancer dropstone serve démarre un nouveau serveur autonome, que vous ayez ou non une session interactive ouverte.

Vous pouvez remplacer l'adresse de liaison avec les flags --hostname et --port.

Spécification

Le serveur publie une spécification OpenAPI 3.1 consultable à l'adresse :

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

Par exemple, http://localhost:4096/doc. Utilisez la spécification pour générer des clients ou inspecter les types de requêtes et de réponses. Ou consultez-la dans un explorateur Swagger.

API

Le serveur Dropstone expose les API suivantes.

Global

Projet

Chemin et VCS

Configuration

Sessions

Messages

Commandes

Fichiers

Paramètres de requête /find/file

• query (obligatoire) : chaîne de recherche (correspondance floue)
• type (facultatif) : limiter les résultats à "file" ou "directory"
• directory (facultatif) : remplacer la racine du projet pour la recherche
• limit (facultatif) : nombre maximal de résultats (1–200)
• dirs (facultatif) : indicateur hérité ("false" renvoie uniquement les fichiers)

LSP, Formateurs et MCP

Agents

Journalisation

Authentification

Événements

Documentation