@eng-ai/sdk 2.8.2 → 2.8.3

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
+## 2.8.3 - 2026-04-09
+
+### Added
+
+- External Project Context Suggestion confirmation API (v2) in SDK:
+  - `confirmProjectContextSuggestion(projectId, suggestionId, { summary, proposedPatch, expiresAt, checksum })`
+- Enables external API/SDK consumers to confirm `context_update_suggestion` from project chat and apply canonical context updates safely.
+
+### Changed
+
+- README updated with end-to-end project chat suggestion confirmation example.
+
 ## 2.8.2 - 2026-04-09
 
 ### Added

package/README.md

@@ -110,6 +110,25 @@ await client.rebuildProjectKnowledge(project.id, {
 console.log(knowledgeStatus.status, knowledgePages.length, knowledgeIssues.length);
 ```
 
+Project chat suggestion confirmation (when response includes `context_update_suggestion`):
+
+```js
+const response = await client.invokeAgent({
+  message: "A ART e licenças foram entregues, estamos em dia agora.",
+  projectId: project.id,
+});
+
+const suggestion = response?.context_update_suggestion;
+if (suggestion) {
+  await client.confirmProjectContextSuggestion(project.id, suggestion.suggestion_id, {
+    summary: suggestion.summary,
+    proposedPatch: suggestion.proposed_patch,
+    expiresAt: suggestion.expires_at,
+    checksum: suggestion.checksum,
+  });
+}
+```
+
 Project documents (tags, filters, upload, update):
 
 ```js
@@ -164,6 +183,7 @@ Supported project knowledge actions:
 - `listProjectKnowledgePages(projectId, { limit? })`
 - `listProjectKnowledgeIssues(projectId, { onlyOpen?, limit? })`
 - `rebuildProjectKnowledge(projectId, { idempotencyKey? })`
+- `confirmProjectContextSuggestion(projectId, suggestionId, { summary, proposedPatch, expiresAt, checksum })`
 
 External user settings (API key owner scope):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eng-ai/sdk",
-  "version": "2.8.2",
+  "version": "2.8.3",
   "description": "Official JavaScript SDK for ENG-AI External API v2",
   "type": "module",
   "main": "./src/client.js",

package/src/client.js

@@ -679,6 +679,39 @@ export class EngAIClient {
     });
   }
 
+  async confirmProjectContextSuggestion(projectId, suggestionId, payload = {}) {
+    const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
+    const normalizedSuggestionId = this._requireNonEmptyString(suggestionId, "suggestionId");
+    const summary = this._requireNonEmptyString(payload.summary, "summary");
+    const expiresAt = this._requireNonEmptyString(
+      payload.expiresAt ?? payload.expires_at,
+      "expiresAt"
+    );
+    const checksum = this._requireNonEmptyString(payload.checksum, "checksum");
+    const proposedPatch = payload.proposedPatch ?? payload.proposed_patch;
+
+    if (!isPlainObject(proposedPatch)) {
+      throw new EngAIError("proposedPatch must be an object", {
+        status: 400,
+        code: "validation_error",
+        detail: "proposedPatch/proposed_patch must be a JSON object",
+      });
+    }
+
+    return await this._request(
+      `/projects/${encodeURIComponent(normalizedProjectId)}/context/suggestions/${encodeURIComponent(normalizedSuggestionId)}/confirm`,
+      {
+        method: "POST",
+        body: {
+          summary,
+          proposed_patch: proposedPatch,
+          expires_at: expiresAt,
+          checksum,
+        },
+      }
+    );
+  }
+
   async getProjectIntakeStatus(projectId) {
     const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
     return await this._request(