SDK Dropstone
Un client TypeScript et JavaScript typé pour l'agent Dropstone, avec deux points d'entrée : l'un pour les appels API sans interface depuis un CI ou une fonction serverless, l'autre qui exécute l'agent localement avec la même mémoire de compte que le CLI et le Chat.
Le SDK Dropstone est un client TypeScript et JavaScript typé pour le runtime de l'agent Dropstone. Il donne à votre code un accès programmatique au même agent qui s'exécute dans Dropstone Chat et le CLI : sessions, outils, réponses en streaming et sortie structurée.
npm install @blankline/dropstone-sdk
La référence des méthodes se trouve sur docs.dropstone.io/cli/sdk. Cette page est la vue d'ensemble, et Installer et exécuter votre première session est le guide pas à pas.
Deux points d'entrée
Le SDK fournit deux clients, et celui que vous choisissez dépend de l'endroit où votre code s'exécute.
| Client API sans interface | Client agent local | |
|---|---|---|
| Import | createDropstoneApi | createDropstone |
| Communique avec | api.dropstone.io/api/v1 | un processus dropstone serve qu'il démarre pour vous |
| S'authentifie avec | une clé API | la connexion du CLI sur la même machine |
| Facturation | paiement à l'usage depuis votre solde de crédits | votre allocation hebdomadaire, comme le CLI |
| Votre mémoire | Non. C'est un endpoint de complétion sans état | Oui, la mémoire de compte utilisée par Chat et le CLI |
| Utilisez-le pour | CI, jobs, serverless, tout hôte sans le CLI | intégrer l'agent interactif dans une application Node |
Deux autres points d'entrée l'accompagnent : createDropstoneClient pointe le même client typé vers un serveur que vous exécutez déjà, et createDropstoneTui lance l'interface terminal interactive depuis un processus Node.
Une mémoire, partout
Une session locale s'exécute sous votre compte, elle commence donc avec tout ce que Dropstone a appris sur vos autres surfaces. Une règle que vous définissez dans Chat s'applique au code qui passe par le SDK, et ce qu'une session enregistre est là la prochaine fois que vous ouvrez le CLI. Voir Une mémoire sur chaque surface.
Le client sans interface est délibérément l'inverse : un endpoint de complétion sans état, compatible OpenAI, sans mémoire attachée, afin qu'un pipeline obtienne des entrées et sorties prévisibles. Voir Utiliser l'API avec votre plan.
Typé de bout en bout
Les requêtes, réponses, événements de streaming et appels d'outils sont générés à partir de la spécification OpenAPI du serveur, de sorte qu'un éditeur les complète et qu'un compilateur les vérifie. Deux surfaces sont fournies dans le même package : un client v1 stable, et un client v2 à @blankline/dropstone-sdk/v2 avec un modèle de ressources plus riche pour les fichiers et les espaces de travail. Les nouveaux endpoints arrivent sur v2.
Prérequis
- Node.js
- Pour le client agent local, le CLI Dropstone sur la même machine, connecté avec
dropstone login - Pour le client sans interface, une clé API et un solde de crédits financé
Obtenir de l'aide
La référence CLI est le premier recours pour les questions au niveau des méthodes. Pour les problèmes de compte, de facturation ou d'accès, voir Comment obtenir du support.
Related articles
- Install and run your first sessionInstall the Dropstone SDK, make a headless API call with an API key, and run a local agent session that carries your account memory. Includes streaming, structured output, and using the OpenAI SDK against Dropstone.
- Using the API with your planCall Dropstone over HTTP with an API key. The endpoint is OpenAI-compatible, billed pay-per-use from your credit balance, and works from any language. Keys, errors, rate limits, and what the API does not carry.
- One memory across every surfaceThe account memory that follows you across Dropstone Chat, the CLI, and the SDK, what shares it and what does not, and how to keep an integration's learning out of your own memory.
- Install the CLIInstall the Dropstone CLI on macOS, Linux, or Windows with one command, sign in, and check it works. Upgrading and uninstalling.
- Memory across chat, CLI, and SDKDropstone memory belongs to your account, not to one app. A rule you set in the CLI applies in chat, and something learned in chat is available to the SDK. One memory, every surface.