@eng-ai/sdk 2.8.2 → 2.8.4

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
+## 2.8.4 - 2026-04-09
+
+### Added
+
+- Project Knowledge pages now support graph payload in SDK:
+  - `listProjectKnowledgePages(projectId, { limit?, includeGraph? })`
+- When `includeGraph=true`, API may return envelope with:
+  - `pages`
+  - `graph`
+  - `graph_meta`
+
+### Changed
+
+- README updated with graph-enabled knowledge pages example.
+
+## 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

@@ -97,7 +97,8 @@ Project knowledge (status, lint issues, manual rebuild):
 ```js
 const knowledgeStatus = await client.getProjectKnowledgeStatus(project.id);
 const knowledgePages = await client.listProjectKnowledgePages(project.id, {
-  limit: 20
+  limit: 20,
+  includeGraph: true,
 });
 const knowledgeIssues = await client.listProjectKnowledgeIssues(project.id, {
   onlyOpen: true,
@@ -107,7 +108,32 @@ await client.rebuildProjectKnowledge(project.id, {
   idempotencyKey: `knowledge-rebuild-${project.id}`
 });
 
-console.log(knowledgeStatus.status, knowledgePages.length, knowledgeIssues.length);
+const pagesCount = Array.isArray(knowledgePages)
+  ? knowledgePages.length
+  : (knowledgePages?.pages || []).length;
+const graphNodes = Array.isArray(knowledgePages)
+  ? 0
+  : (knowledgePages?.graph?.nodes || []).length;
+console.log(knowledgeStatus.status, pagesCount, knowledgeIssues.length, graphNodes);
+```
+
+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):
@@ -161,9 +187,10 @@ Supported project knowledge actions:
 - `getProjectIntakeStatus(projectId)`
 - `runProjectIntake(projectId, { mode? })`
 - `getProjectKnowledgeStatus(projectId)`
-- `listProjectKnowledgePages(projectId, { limit? })`
+- `listProjectKnowledgePages(projectId, { limit?, includeGraph? })`
 - `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.4",
   "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(
@@ -748,6 +781,10 @@ export class EngAIClient {
     if (options.limit !== undefined && options.limit !== null) {
       query.set("limit", String(options.limit));
     }
+    if (options.includeGraph !== undefined || options.include_graph !== undefined) {
+      const includeGraph = options.includeGraph ?? options.include_graph;
+      query.set("include_graph", String(!!includeGraph));
+    }
     const suffix = query.toString() ? `?${query.toString()}` : "";
     return await this._request(
       `/projects/${encodeURIComponent(normalizedProjectId)}/knowledge/pages${suffix}`,