@eng-ai/sdk 2.7.0 → 2.8.1

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
+## 2.8.1 - 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.
+
+## 2.8.0 - 2026-04-09
+
+### Added
+
+- External Project Knowledge APIs (v2) in SDK:
+  - `getProjectKnowledgeStatus(projectId)`
+  - `listProjectKnowledgeIssues(projectId, { onlyOpen?, limit? })`
+  - `rebuildProjectKnowledge(projectId, { idempotencyKey? })`
+- Enables API-key integrations to monitor and trigger project knowledge rebuilds directly through SDK.
+
 ## 2.7.0 - 2026-04-09
 
 ### Added

package/README.md

@@ -81,6 +81,24 @@ const context = await client.getProjectContext(project.id);
 console.log(context.autonomous_tasks_mode);
 ```
 
+Project knowledge (status, lint issues, manual rebuild):
+
+```js
+const knowledgeStatus = await client.getProjectKnowledgeStatus(project.id);
+const knowledgePages = await client.listProjectKnowledgePages(project.id, {
+  limit: 20
+});
+const knowledgeIssues = await client.listProjectKnowledgeIssues(project.id, {
+  onlyOpen: true,
+  limit: 10
+});
+await client.rebuildProjectKnowledge(project.id, {
+  idempotencyKey: `knowledge-rebuild-${project.id}`
+});
+
+console.log(knowledgeStatus.status, knowledgePages.length, knowledgeIssues.length);
+```
+
 Project documents (tags, filters, upload, update):
 
 ```js
@@ -127,6 +145,13 @@ Supported automation plan actions:
 - `rejectAutomationPlan(projectId, planId, note?, { idempotencyKey? })`
 - `applyAutomationPlan(projectId, planId, { idempotencyKey? })`
 
+Supported project knowledge actions:
+
+- `getProjectKnowledgeStatus(projectId)`
+- `listProjectKnowledgePages(projectId, { limit? })`
+- `listProjectKnowledgeIssues(projectId, { onlyOpen?, limit? })`
+- `rebuildProjectKnowledge(projectId, { idempotencyKey? })`
+
 External user settings (API key owner scope):
 
 ```js

package/package.json

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

package/src/client.js

@@ -678,6 +678,66 @@ export class EngAIClient {
     });
   }
 
+  async getProjectKnowledgeStatus(projectId) {
+    const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
+    return await this._request(
+      `/projects/${encodeURIComponent(normalizedProjectId)}/knowledge/status`,
+      {
+        method: "GET",
+      }
+    );
+  }
+
+  async listProjectKnowledgeIssues(projectId, options = {}) {
+    const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
+    const query = new URLSearchParams();
+    if (options.onlyOpen !== undefined) {
+      query.set("only_open", String(!!options.onlyOpen));
+    }
+    if (options.limit !== undefined && options.limit !== null) {
+      query.set("limit", String(options.limit));
+    }
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return await this._request(
+      `/projects/${encodeURIComponent(normalizedProjectId)}/knowledge/issues${suffix}`,
+      {
+        method: "GET",
+      }
+    );
+  }
+
+  async listProjectKnowledgePages(projectId, options = {}) {
+    const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
+    const query = new URLSearchParams();
+    if (options.limit !== undefined && options.limit !== null) {
+      query.set("limit", String(options.limit));
+    }
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return await this._request(
+      `/projects/${encodeURIComponent(normalizedProjectId)}/knowledge/pages${suffix}`,
+      {
+        method: "GET",
+      }
+    );
+  }
+
+  async rebuildProjectKnowledge(projectId, options = {}) {
+    const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
+    const headers = {};
+    const idempotencyKey = options?.idempotencyKey ?? options?.idempotency_key;
+    if (idempotencyKey) {
+      headers["Idempotency-Key"] = idempotencyKey;
+    }
+    return await this._request(
+      `/projects/${encodeURIComponent(normalizedProjectId)}/knowledge/rebuild`,
+      {
+        method: "POST",
+        headers,
+        body: {},
+      }
+    );
+  }
+
   async setProjectAutonomyMode(projectId, mode, options = {}) {
     const normalizedProjectId = this._requireNonEmptyString(projectId, "projectId");
     const normalizedMode = String(mode || "").trim().toLowerCase();