@eng-ai/sdk 2.8.0 → 2.8.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
+## 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
 
 ### Added

package/README.md

@@ -81,10 +81,24 @@ 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
 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
@@ -93,7 +107,7 @@ await client.rebuildProjectKnowledge(project.id, {
   idempotencyKey: `knowledge-rebuild-${project.id}`
 });
 
-console.log(knowledgeStatus.status, knowledgeIssues.length);
+console.log(knowledgeStatus.status, knowledgePages.length, knowledgeIssues.length);
 ```
 
 Project documents (tags, filters, upload, update):
@@ -144,7 +158,10 @@ 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? })`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eng-ai/sdk",
-  "version": "2.8.0",
+  "version": "2.8.2",
   "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,41 @@ export class EngAIClient {
     });
   }
 
+  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(
@@ -706,6 +742,21 @@ export class EngAIClient {
     );
   }
 
+  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 = {};