@eng-ai/sdk 2.8.1 → 2.8.2

package/CHANGELOG.md

@@ -2,13 +2,16 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
-## 2.8.1 - 2026-04-09
+## 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
@@ -147,6 +158,8 @@ Supported automation plan actions:
 
 Supported project knowledge actions:
 
+- `getProjectIntakeStatus(projectId)`
+- `runProjectIntake(projectId, { mode? })`
 - `getProjectKnowledgeStatus(projectId)`
 - `listProjectKnowledgePages(projectId, { limit? })`
 - `listProjectKnowledgeIssues(projectId, { onlyOpen?, limit? })`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eng-ai/sdk",
-  "version": "2.8.1",
+  "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(