@alisio/plugin-deepseek 0.1.0-alpha.7 → 0.1.0-alpha.9

package/README.md

@@ -1,4 +1,54 @@
 # @alisio/plugin-deepseek
 
-Built-in DeepSeek provider for Alisio. It supports model discovery plus the documented Chat
-Completions and Responses APIs. Credentials are supplied by Alisio and are never persisted here.
+**The built-in DeepSeek model provider for [Alisio](https://github.com/GustavoGutierrez/alisio).**
+Select it in `/connect`, discover models from the DeepSeek catalog, and talk to the Chat
+Completions or Responses API.
+
+## What it is
+
+A `model-provider` plugin that registers the `deepseek` provider with the Alisio host. It ships as a
+built-in of the `alisio` CLI and is enabled by default. Credentials are managed by Alisio and are
+never persisted by this plugin: keys live in the global credentials store or an environment
+variable.
+
+## Installation
+
+Preinstalled in the `alisio` CLI. For an embedded host, register it through `createApplication`'s
+`builtins` list.
+
+## Using it: `/connect`
+
+1. Run `alisio`, then `/connect` and choose **DeepSeek**.
+2. Fields: **API key** (secret, required), **API key environment variable** (default
+   `DEEPSEEK_API_KEY`), **API mode** (`chat` or `responses`), **base URL** (default
+   `https://api.deepseek.com`; change only for a DeepSeek-compatible proxy).
+3. Pick a model from the discovered catalog — for example `deepseek/deepseek-chat`.
+
+The key is read from the stored credential first, then from `process.env[apiKeyEnv]` — usually:
+
+```sh
+export DEEPSEEK_API_KEY=...   # never put the key in config files, profiles or READMEs
+```
+
+## Features
+
+- Model discovery from the DeepSeek catalog (`GET /models`) with honest context windows.
+- Chat Completions and Responses modes (default `chat`); bearer auth, `max_tokens` output budget.
+- Provider-side usage reporting while streaming (`streamUsage: true`).
+- Credentials never leave the Alisio credentials store or the named environment variable.
+
+While registered, the provider also appears in `/model` and `alisio doctor`.
+
+## Docs
+
+[Configuration](https://gustavogutierrez.github.io/alisio/configuration) ·
+[Plugins](https://gustavogutierrez.github.io/alisio/plugins).
+
+## Requirements
+
+Node.js **>= 22.16** or Bun **>= 1.4.2**.
+
+## License
+
+MIT. Maintained by Gustavo Gutiérrez Mercado. Source: <https://github.com/GustavoGutierrez/alisio> ·
+npm: <https://www.npmjs.com/settings/alisio/packages>.

package/dist/provider.js

@@ -176,7 +176,7 @@ export class DeepSeekProvider {
         if (completed.some((c) => !c.id || !c.name))
             throw new Error("Incomplete tool call");
         if (finish === "length" && !text.trim())
-            throw new Error("Provider response cut off by max output tokens before any usable content; raise limits.maxOutputTokens");
+            throw new Error("Provider response cut off by max output tokens before any usable content; raise limits.maxOutputTokens (/settings → Agent max output tokens)");
         yield {
             type: "completed",
             message: {
@@ -257,7 +257,7 @@ export class DeepSeekProvider {
                     .map((x) => x.text)
                     .join("");
                 if (!text.trim())
-                    throw new Error("Provider response cut off by max output tokens before any usable content; raise limits.maxOutputTokens");
+                    throw new Error("Provider response cut off by max output tokens before any usable content; raise limits.maxOutputTokens (/settings → Agent max output tokens)");
                 if (calls.some((c) => !c.id || !c.name))
                     throw new Error("Incomplete tool call");
                 yield {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/plugin-deepseek",
-  "version": "0.1.0-alpha.7",
+  "version": "0.1.0-alpha.9",
   "description": "Built-in DeepSeek model provider for Alisio.",
   "license": "MIT",
   "type": "module",
@@ -24,10 +24,10 @@
     "openai": "7.23.0"
   },
   "peerDependencies": {
-    "@alisio/sdk": "^0.1.0-alpha.5"
+    "@alisio/sdk": "^0.1.0-alpha.7"
   },
   "devDependencies": {
-    "@alisio/sdk": "0.1.0-alpha.5"
+    "@alisio/sdk": "0.1.0-alpha.7"
   },
   "publishConfig": {
     "access": "public",