@eng-ai/sdk 2.8.1 → 2.8.3

package/CHANGELOG.md

@@ -2,13 +2,28 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
-## 2.8.1 - 2026-04-09
+## 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
 
 - External Project Knowledge pages API (v2) in SDK:
   - `listProjectKnowledgePages(projectId, { limit? })`
 - Enables external integrations to inspect compiled knowledge pages (`wiki/index/log`) for user-facing observability.
+- External Project Intake APIs (v2) in SDK:
+  - `getProjectIntakeStatus(projectId)`
+  - `runProjectIntake(projectId, { mode?: "initial_full" | "delta_refresh" })`
 
 ## 2.8.0 - 2026-04-09
 

package/README.md

@@ -81,6 +81,17 @@ const context = await client.getProjectContext(project.id);
 console.log(context.autonomous_tasks_mode);
 ```
 
+Project intake (initial_full and delta_refresh):
+
+```js
+const intakeStatus = await client.getProjectIntakeStatus(project.id);
+if (intakeStatus.intake_status === "ready") {
+  await client.runProjectIntake(project.id, { mode: "delta_refresh" });
+} else {
+  await client.runProjectIntake(project.id, { mode: "initial_full" });
+}
+```
+
 Project knowledge (status, lint issues, manual rebuild):
 
 ```js
@@ -99,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
@@ -147,10 +177,13 @@ Supported automation plan actions:
 
 Supported project knowledge actions:
 
+- `getProjectIntakeStatus(projectId)`
+- `runProjectIntake(projectId, { mode? })`
 - `getProjectKnowledgeStatus(projectId)`
 - `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.1",
+  "version": "2.8.3",
   "description": "Official JavaScript SDK for ENG-AI External API v2",
   "type": "module",
   "main": "./src/client.js",

package/src/client.js

@@ -7,6 +7,7 @@ const VALID_AUTONOMOUS_TASKS_MODES = new Set([
   "approval_delete_only",
   "full_autonomy",
 ]);
+const VALID_PROJECT_INTAKE_MODES = new Set(["initial_full", "delta_refresh"]);
 const VALID_DOCUMENT_TAG_MODES = new Set(["any", "all"]);
 
 function isPlainObject(value) {
@@ -678,6 +679,74 @@ 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(
+      `/projects/${encodeURIComponent(normalizedProjectId)}/intake-status`,
+      {
+        method: "GET",
+      }
+    );
+  }
+
+  async runProjectIntake(projectId, options = {}) {
+    const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
+    const payload = {};
+    const requestedMode = options?.mode;
+    if (requestedMode !== undefined && requestedMode !== null) {
+      const normalizedMode = String(requestedMode).trim().toLowerCase();
+      if (!VALID_PROJECT_INTAKE_MODES.has(normalizedMode)) {
+        throw new EngAIError("invalid mode for runProjectIntake", {
+          status: 400,
+          code: "validation_error",
+          detail: "mode must be one of: initial_full, delta_refresh",
+        });
+      }
+      payload.mode = normalizedMode;
+    }
+
+    return await this._request(
+      `/projects/${encodeURIComponent(normalizedProjectId)}/intake`,
+      {
+        method: "POST",
+        body: payload,
+      }
+    );
+  }
+
   async getProjectKnowledgeStatus(projectId) {
     const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
     return await this._request(