Server

Der Befehl dropstone serve startet einen headless HTTP-Server, der einen OpenAPI-Endpunkt bereitstellt, den ein Dropstone-Client verwenden kann.

Verwendung

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

Optionen

--cors kann mehrfach übergeben werden:

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

Authentifizierung

Setze DROPSTONE_SERVER_PASSWORD, um den Server mit HTTP-Basisauthentifizierung zu schützen. Der Benutzername lautet standardmäßig dropstone, oder setze DROPSTONE_SERVER_USERNAME, um ihn zu überschreiben. Dies gilt sowohl für dropstone serve als auch für dropstone web.

DROPSTONE_SERVER_PASSWORD=your-password dropstone serve

Agent-Anmeldedaten

DROPSTONE_SERVER_PASSWORD schützt den Server selbst. Es teilt dem Agenten nicht mit, wie er Dropstone erreicht. Auf einem unbeaufsichtigten Rechner gibt es kein angemeldetes Konto, das geerbt werden kann. Übergebe daher einen API-Schlüssel über die Provider-Konfiguration:

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

baseURL ist wichtig. API-Schlüssel werden unter /api/v1 akzeptiert, nicht unter /v1, und ein an /v1 gesendeter Schlüssel wird mit 403 Invalid token format. Please log in again. abgelehnt. Setze ihn hier und nicht über DROPSTONE_BASE_URL, da diese auch zum Erstellen der Konto-, Nutzungs- und Speicher-Endpunkte verwendet wird und diese beschädigt, wenn du sie auf einen versionierten Pfad zeigst.

Generiere einen Schlüssel unter dropstone.io/dashboard/settings.

Senden einer Eingabeaufforderung

POST /session/:id/message erfordert sowohl agent als auch model. Wenn model weggelassen wird, wird kein Standard aufgelöst: Die Runde gibt 200 mit einem leeren Body zurück und es wird nichts ausgeführt.

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

Eine Runde, die fehlschlägt, gibt trotzdem 200 zurück. Der Grund liegt bei data.info.error, nicht auf Transportebene. Überprüfe also dieses Feld, anstatt dich auf den Statuscode zu verlassen.

So funktioniert es

dropstone serve stellt Dropstones Fähigkeiten über einen OpenAPI-3.1-HTTP-Endpunkt bereit. Derselbe Endpunkt wird verwendet, um das SDK zu generieren.

Verwende den Server, wenn du Dropstone programmatisch steuern möchtest: aus einem Skript, einer CI-Pipeline oder einer eigenen Integration. Die interaktive Sitzung und der Server sind unabhängig. Das Ausführen von dropstone serve startet einen frischen eigenständigen Server, unabhängig davon, ob du eine interaktive Sitzung geöffnet hast.

Du kannst die Bind-Adresse mit den Flags --hostname und --port überschreiben.

Spezifikation

Der Server veröffentlicht eine OpenAPI-3.1-Spezifikation, die unter folgender Adresse eingesehen werden kann:

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

Zum Beispiel http://localhost:4096/doc. Verwende die Spezifikation, um Clients zu generieren oder Anfrage- und Antworttypen zu prüfen. Oder betrachte sie in einem Swagger-Explorer.

APIs

Der Dropstone-Server stellt die folgenden APIs bereit.

Global

Projekt

Pfad & VCS

Konfiguration

Sitzungen

Nachrichten

Befehle

Dateien

/find/file-Abfrageparameter

• query (erforderlich): Suchzeichenfolge (Fuzzy-Match)
• type (optional): Ergebnisse auf "file" oder "directory" beschränken
• directory (optional): Projektstamm für die Suche überschreiben
• limit (optional): Maximale Ergebnisse (1–200)
• dirs (optional): Legacy-Flag ("false" gibt nur Dateien zurück)

LSP, Formatierer & MCP

Agenten

Protokollierung

Authentifizierung

Ereignisse

Dokumentation