@eng-ai/sdk 2.8.6 → 2.8.8

package/CHANGELOG.md

@@ -2,7 +2,24 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
-## 2.8.6 - 2026-04-22
+## 2.8.8 - 2026-06-25
+
+### Added
+
+- Desktop Cloud contract v1 support for private local-context invocations:
+  - `desktop_contract_version`
+  - `client_context`
+  - `privacy`
+  - `chat_history`
+  - `project_id`
+- `getCapabilities()` for authenticated Desktop capability checks.
+- `validateCredentials()` using authenticated non-mutating External API v2 settings lookup.
+
+### Security
+
+- Desktop `privacy.mode="no_persistence"` payloads can be forwarded without dropping required privacy/context fields.
+
+## 2.8.7 - 2026-04-22
 
 ### Added
 

package/README.md

@@ -95,6 +95,37 @@ console.log(sessions.map((item) => item.id));
 console.log(session.messages.length);
 ```
 
+Desktop private local-context invocation:
+
+```js
+const capabilities = await client.getCapabilities();
+if (!capabilities.no_persistence || capabilities.desktop_contract_version < 1) {
+  throw new Error("ENG-AI Cloud does not support the Desktop privacy contract");
+}
+
+const response = await client.invokeAgent("contract_manager", {
+  message: "Analise os trechos locais e crie a tarefa de revisão",
+  desktopContractVersion: 1,
+  projectId: "project-id",
+  clientContext: {
+    digest: "sha256-local-context",
+    chunks: [
+      {
+        document_id: "local-doc-id",
+        chunk_index: 0,
+        text: "Trecho bounded do índice local",
+        score: 0.91
+      }
+    ]
+  },
+  chatHistory: [{ role: "user", content: "Histórico local bounded" }],
+  privacy: { mode: "no_persistence", allow_project_mutations: true },
+  idempotencyKey: "desktop-project-mutation-uuid"
+});
+
+console.log(response.privacy.persisted); // false
+```
+
 Task autonomy mode by project:
 
 ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eng-ai/sdk",
-  "version": "2.8.6",
+  "version": "2.8.8",
   "description": "Official JavaScript SDK for ENG-AI External API v2",
   "type": "module",
   "main": "./src/client.js",
@@ -18,6 +18,7 @@
     "LICENSE"
   ],
   "scripts": {
+    "check:contract": "node ./test-contract.mjs",
     "check:pack": "NPM_CONFIG_CACHE=${NPM_CONFIG_CACHE:-/tmp/engai-npm-cache} npm pack --dry-run"
   },
   "keywords": [

package/src/client.js

@@ -400,9 +400,17 @@ export class EngAIClient {
         ? { message: payload }
         : {
             message: payload?.message,
+            desktop_contract_version:
+              payload?.desktopContractVersion ?? payload?.desktop_contract_version,
             project_id: payload?.projectId ?? payload?.project_id,
             session_id: payload?.sessionId ?? payload?.session_id,
             context_digest: payload?.contextDigest ?? payload?.context_digest,
+            chat_history: payload?.chatHistory ?? payload?.chat_history,
+            client_context: payload?.clientContext ?? payload?.client_context,
+            privacy: payload?.privacy,
+            attachments: payload?.attachments,
+            provider: payload?.provider,
+            model: payload?.model,
             normative_mode:
               (payload?.normativeMode ?? payload?.normative_mode) ||
               (payload?.normId ?? payload?.norm_id)
@@ -437,6 +445,18 @@ export class EngAIClient {
     });
   }
 
+  async getCapabilities() {
+    return await this._request("/sdk/capabilities", {
+      method: "GET",
+    });
+  }
+
+  async validateCredentials() {
+    return await this._request("/settings/llm", {
+      method: "GET",
+    });
+  }
+
   async listSdkSessions(options = {}) {
     const query = new URLSearchParams();
     if (options.limit !== undefined) query.set("limit", String(options.limit));