@eng-ai/sdk 2.8.5 → 2.8.7

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
+## 2.8.7 - 2026-04-22
+
+### Added
+
+- External SDK history APIs (v2) in JS SDK:
+  - `listSdkSessions({ limit?, offset?, projectId? })`
+  - `getSdkSession(sessionId)`
+- SDK invoke responses now include `request.session_id`, enabling integrations to persist and continue the same conversation thread safely.
+- CLI `eng-ai` now supports external SDK history inspection:
+  - `sdk sessions list`
+  - `sdk sessions get --session-id <id>`
+
+### Changed
+
+- SDK conversations created through `/api/v2/sdk` are now persisted server-side with explicit source metadata (`session_source="sdk"` and `metadata.source="sdk"`), making them queryable via the external API.
+
 ## 2.8.5 - 2026-04-14
 
 ### Changed

package/README.md

@@ -36,6 +36,7 @@ const response =
 
 console.log(response.result.content);
 console.log(response.normative?.citations ?? []);
+console.log(response.request.session_id);
 
 // Recommended error handling
 try {
@@ -73,6 +74,27 @@ const projects = await client.listProjects({ limit: 10, offset: 0 });
 console.log(project.id, projects.length);
 ```
 
+SDK conversation history:
+
+```js
+const first = await client.invokeAgent({
+  message: "Explique o conceito de talude",
+});
+
+const sessionId = first.request.session_id;
+const second = await client.invokeAgent({
+  sessionId,
+  message: "Continue e detalhe os tipos de contenção",
+});
+
+const sessions = await client.listSdkSessions({ limit: 10 });
+const session = await client.getSdkSession(sessionId);
+
+console.log(second.request.session_id);
+console.log(sessions.map((item) => item.id));
+console.log(session.messages.length);
+```
+
 Task autonomy mode by project:
 
 ```js
@@ -182,6 +204,11 @@ Supported automation plan actions:
 - `rejectAutomationPlan(projectId, planId, note?, { idempotencyKey? })`
 - `applyAutomationPlan(projectId, planId, { idempotencyKey? })`
 
+Supported SDK history actions:
+
+- `listSdkSessions({ limit?, offset?, projectId? })`
+- `getSdkSession(sessionId)`
+
 Supported project knowledge actions:
 
 - `getProjectIntakeStatus(projectId)`
@@ -225,6 +252,8 @@ await client.updateProfile({
 CLI (`eng-ai`) included in package:
 
 ```bash
+ENG_AI_API_KEY=sk_xxx eng-ai sdk sessions list --limit 10
+ENG_AI_API_KEY=sk_xxx eng-ai sdk sessions get --session-id <id>
 ENG_AI_API_KEY=sk_xxx eng-ai projects autonomy set --project-id <id> --mode approval_required
 ENG_AI_API_KEY=sk_xxx eng-ai plans actionable list --limit 30
 ENG_AI_API_KEY=sk_xxx eng-ai plans approve --project-id <id> --plan-id <id> --note "Approved"

package/bin/eng-ai.js

@@ -59,6 +59,8 @@ function printHelp() {
 ENG-AI SDK CLI
 
 Usage:
+  eng-ai sdk sessions list [--limit <n>] [--offset <n>] [--project-id <id>]
+  eng-ai sdk sessions get --session-id <id>
   eng-ai projects autonomy set --project-id <id> --mode <approval_required|approval_delete_only|full_autonomy> [--idempotency-key <key>]
   eng-ai plans actionable list [--limit <n>]
   eng-ai plans approve --project-id <id> --plan-id <id> [--note <text>] [--idempotency-key <key>]
@@ -136,6 +138,37 @@ async function runProjectsCommand(client, subTokens, options) {
   );
 }
 
+async function runSdkCommand(client, subTokens, options) {
+  const section = String(subTokens[0] || "").trim().toLowerCase();
+  const action = String(subTokens[1] || "").trim().toLowerCase();
+
+  if (section !== "sessions" || !action) {
+    throw new Error("Unsupported sdk command. Use: sdk sessions list|get");
+  }
+
+  if (action === "list") {
+    const sessions = await client.listSdkSessions({
+      limit: options.limit !== undefined ? toPositiveInt(options.limit, 20) : undefined,
+      offset: options.offset !== undefined ? Math.max(0, Number(options.offset) || 0) : undefined,
+      projectId: options["project-id"],
+    });
+    console.log(JSON.stringify(sessions, null, 2));
+    return;
+  }
+
+  if (action === "get") {
+    const sessionId = options["session-id"];
+    if (!sessionId) {
+      throw new Error("Missing required option: --session-id");
+    }
+    const session = await client.getSdkSession(sessionId);
+    console.log(JSON.stringify(session, null, 2));
+    return;
+  }
+
+  throw new Error("Unsupported sdk command. Use: sdk sessions list|get");
+}
+
 function printPlansSummary(plans) {
   const rows = Array.isArray(plans) ? plans : [];
   const formatted = rows.map((plan) => ({
@@ -327,6 +360,10 @@ async function main() {
     await runProjectsCommand(client, tokens.slice(1), options);
     return;
   }
+  if (command === "sdk") {
+    await runSdkCommand(client, tokens.slice(1), options);
+    return;
+  }
   if (command === "plans") {
     await runPlansCommand(client, tokens.slice(1), options);
     return;

package/package.json

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

package/src/client.js

@@ -437,6 +437,27 @@ export class EngAIClient {
     });
   }
 
+  async listSdkSessions(options = {}) {
+    const query = new URLSearchParams();
+    if (options.limit !== undefined) query.set("limit", String(options.limit));
+    if (options.offset !== undefined) query.set("offset", String(options.offset));
+    if (options.projectId ?? options.project_id) {
+      query.set("project_id", String(options.projectId ?? options.project_id));
+    }
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+
+    return await this._request(`/sdk/sessions${suffix}`, {
+      method: "GET",
+    });
+  }
+
+  async getSdkSession(sessionId) {
+    const normalizedSessionId = this._requireNonEmptyString(sessionId, "sessionId");
+    return await this._request(`/sdk/sessions/${encodeURIComponent(normalizedSessionId)}`, {
+      method: "GET",
+    });
+  }
+
   async createProject(payload) {
     if (!String(payload?.name || "").trim()) {
       throw new EngAIError("name is required for createProject", {