@molecule/api-ai-deepseek 1.0.4 → 1.0.6

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-08-04T01:47:29.897Z
+Generated: 2026-10-01T18:20:44.372Z
 -->
 
 # @molecule/api-ai-deepseek
@@ -14,6 +14,26 @@ Generated: 2026-08-04T01:47:29.897Z
 
 DeepSeek AI provider for molecule.dev.
 
+## Quick Start
+
+```typescript
+// npm install @molecule/api-ai-deepseek --workspace=api
+import { setProvider, requireProvider } from '@molecule/api-ai'
+import { provider } from '@molecule/api-ai-deepseek'
+
+// Named registration — several AI providers can be bonded side by side
+// (getProviderByName('deepseek') targets this one); the FIRST one
+// registered also answers requireProvider() (see @molecule/api-ai).
+setProvider('deepseek', provider) // reads DEEPSEEK_API_KEY from the environment
+
+let reply = ''
+for await (const event of requireProvider().chat({
+  messages: [{ role: 'user', content: 'Hello!' }],
+})) {
+  if (event.type === 'text') reply += event.content // or forward the chunk to the client (SSE)
+}
+```
+
 ## Type
 
 `provider`

package/dist/index.d.ts

@@ -1,6 +1,25 @@
 /**
  * DeepSeek AI provider for molecule.dev.
  *
+ * @example
+ * ```typescript
+ * // npm install @molecule/api-ai-deepseek --workspace=api
+ * import { setProvider, requireProvider } from '@molecule/api-ai'
+ * import { provider } from '@molecule/api-ai-deepseek'
+ *
+ * // Named registration — several AI providers can be bonded side by side
+ * // (getProviderByName('deepseek') targets this one); the FIRST one
+ * // registered also answers requireProvider() (see @molecule/api-ai).
+ * setProvider('deepseek', provider) // reads DEEPSEEK_API_KEY from the environment
+ *
+ * let reply = ''
+ * for await (const event of requireProvider().chat({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * })) {
+ *   if (event.type === 'text') reply += event.content // or forward the chunk to the client (SSE)
+ * }
+ * ```
+ *
  * @remarks
  * Config: `DEEPSEEK_API_KEY` (SERVER-side only) plus an optional default model id/base URL.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAMlD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UAUrB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAMlD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UAUrB,CAAA"}

package/dist/index.js

@@ -1,6 +1,25 @@
 /**
  * DeepSeek AI provider for molecule.dev.
  *
+ * @example
+ * ```typescript
+ * // npm install @molecule/api-ai-deepseek --workspace=api
+ * import { setProvider, requireProvider } from '@molecule/api-ai'
+ * import { provider } from '@molecule/api-ai-deepseek'
+ *
+ * // Named registration — several AI providers can be bonded side by side
+ * // (getProviderByName('deepseek') targets this one); the FIRST one
+ * // registered also answers requireProvider() (see @molecule/api-ai).
+ * setProvider('deepseek', provider) // reads DEEPSEEK_API_KEY from the environment
+ *
+ * let reply = ''
+ * for await (const event of requireProvider().chat({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * })) {
+ *   if (event.type === 'text') reply += event.content // or forward the chunk to the client (SSE)
+ * }
+ * ```
+ *
  * @remarks
  * Config: `DEEPSEEK_API_KEY` (SERVER-side only) plus an optional default model id/base URL.
  *

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,UAAU,EAGV,SAAS,EAET,UAAU,EAEX,MAAM,kBAAkB,CAAA;AASzB,OAAO,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAuBhD;;;;GAIG;AACH,cAAM,sBAAuB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,cAAa;IAC1B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAqB;gBAE7B,MAAM,GAAE,cAAmB;IAqBvC;;;;;OAKG;IACI,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC;IAwLzD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IA4EtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;OAKG;IACH,OAAO,CAAE,yBAAyB;IAuDlC;;;;;;OAMG;YACY,sBAAsB;IAoFrC;;;;;;;;OAQG;IACH,OAAO,CAAE,eAAe;CAkIzB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,+BAAyB,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,UAAU,CAElE"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,UAAU,EAGV,SAAS,EAET,UAAU,EAEX,MAAM,kBAAkB,CAAA;AASzB,OAAO,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAuBhD;;;;GAIG;AACH,cAAM,sBAAuB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,cAAa;IAC1B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAqB;gBAE7B,MAAM,GAAE,cAAmB;IAqBvC;;;;;OAKG;IACI,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC;IAwLzD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAgFtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;OAKG;IACH,OAAO,CAAE,yBAAyB;IAuDlC;;;;;;OAMG;YACY,sBAAsB;IAoFrC;;;;;;;;OAQG;IACH,OAAO,CAAE,eAAe;CAkIzB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,+BAAyB,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,UAAU,CAElE"}

package/dist/provider.js

@@ -294,6 +294,11 @@ class DeepseekAIProviderImpl {
                 for (const tr of toolResults) {
                     formatted.push(tr);
                 }
+                // Non-tool parts of the SAME message (an image riding a tool result — the
+                // screenshot tool) must not be dropped: Chat Completions accepts a user
+                // message after the tool messages, so emit them instead of losing them.
+                if (parts.length > 0)
+                    formatted.push({ role: m.role, content: parts });
             }
             else if (toolCalls.length > 0) {
                 // Assistant message with tool calls

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-deepseek",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "DeepSeek AI provider for molecule.dev",
   "homepage": "https://www.molecule.dev/packages/api-ai-deepseek",
   "type": "module",
@@ -33,7 +33,7 @@
     "directory": "packages/api/bonds/ai/deepseek"
   },
   "devDependencies": {
-    "@molecule/api-ai": "1.2.1",
+    "@molecule/api-ai": "1.3.0",
     "@molecule/api-bond": "1.0.2",
     "@types/node": "26.1.2",
     "typescript": "6.0.3",