Server

Il comando dropstone serve avvia un server HTTP headless che espone un endpoint OpenAPI che un client Dropstone può utilizzare.

Utilizzo

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

Opzioni

--cors può essere passato più volte:

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

Autenticazione

Imposta DROPSTONE_SERVER_PASSWORD per proteggere il server con autenticazione HTTP di base. Il nome utente predefinito è dropstone, oppure imposta DROPSTONE_SERVER_USERNAME per sovrascriverlo. Questo vale sia per dropstone serve che per dropstone web.

DROPSTONE_SERVER_PASSWORD=your-password dropstone serve

Credenziali dell'agente

DROPSTONE_SERVER_PASSWORD protegge il server stesso. Non dice all'agente come raggiungere Dropstone. Su una macchina non presidiata non c'è un account con accesso effettuato da ereditare, quindi passa una chiave API tramite la configurazione del provider:

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

baseURL è importante. Le chiavi API vengono accettate su /api/v1, non su /v1, e una chiave inviata a /v1 viene rifiutata con 403 Invalid token format. Please log in again. Impostalo qui piuttosto che tramite DROPSTONE_BASE_URL, che viene utilizzato anche per costruire gli endpoint di account, utilizzo e memoria e li interromperà se lo punti a un percorso con versione.

Genera una chiave su dropstone.io/dashboard/settings.

Invio di un prompt

POST /session/:id/message richiede sia agent che model. Se si omette model, non viene risolto alcun default: il turno restituisce 200 con un corpo vuoto e non viene eseguito nulla.

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 turno che fallisce restituisce comunque 200. Il motivo si trova in data.info.error, non a livello di trasporto, quindi controlla quel campo piuttosto che fare affidamento sul codice di stato.

Come funziona

dropstone serve espone le funzionalità di Dropstone tramite un endpoint HTTP OpenAPI 3.1. Lo stesso endpoint viene utilizzato per generare l'SDK.

Usa il server quando vuoi pilotare Dropstone programmaticamente: da uno script, una pipeline CI o un'integrazione tua. La sessione interattiva e il server sono indipendenti. Eseguire dropstone serve avvia un nuovo server autonomo indipendentemente dal fatto che tu abbia una sessione interattiva aperta.

Puoi sovrascrivere l'indirizzo di bind con i flag --hostname e --port.

Specifica

Il server pubblica una specifica OpenAPI 3.1 che può essere visualizzata su:

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

Ad esempio, http://localhost:4096/doc. Usa la specifica per generare client o ispezionare i tipi di richiesta e risposta. Oppure visualizzala in un explorer Swagger.

API

Il server Dropstone espone le seguenti API.

Globali

Progetto

Percorso e VCS

Configurazione

Sessioni

Messaggi

Comandi

File

Parametri di query /find/file

• query (obbligatorio): stringa di ricerca (corrispondenza fuzzy)
• type (facoltativo): limita i risultati a "file" o "directory"
• directory (facoltativo): sovrascrive la radice del progetto per la ricerca
• limit (facoltativo): massimo risultati (1–200)
• dirs (facoltativo): flag legacy ("false" restituisce solo file)

LSP, Formatter e MCP

Agenti

Registrazione

Autenticazione

Eventi

Documentazione