@eng-ai/sdk 2.0.2 → 2.1.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to `@eng-ai/sdk` will be documented in this file.
 
+## 2.1.0 - 2026-04-05
+
+### Added
+
+- `invokeAgent` now supports autonomous fallback when `agent_id` is omitted:
+  - `client.invokeAgent({ message: "..." })` -> `POST /api/v2/sdk/invoke`
+- Explicit specialist invocation remains supported:
+  - `client.invokeAgent("general", { ... })` -> `POST /api/v2/sdk/agents/{agent_id}/invoke`
+
 ## 2.0.2 - 2026-04-05
 
 ### Changed

package/README.md

@@ -15,14 +15,19 @@ import { EngAIClient } from "@eng-ai/sdk";
 
 const client = new EngAIClient(process.env.ENG_AI_API_KEY, "https://your-domain/api/v2");
 
-const response = await client.invokeAgent("general", {
+const response = await client.invokeAgent({
+  message: "Explique o conceito de talude"
+});
+
+// Optional explicit specialist
+const responseWithAgent = await client.invokeAgent("general", {
   message: "Explique o conceito de talude",
   normativeMode: true,
   normId: "auto"
 });
 
-console.log(response.result.content);
-console.log(response.normative?.citations ?? []);
+console.log(responseWithAgent.result.content);
+console.log(responseWithAgent.normative?.citations ?? []);
 ```
 
 Default base URL: `https://api.eng-ai.com/api/v2`.

package/package.json

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

package/src/client.js

@@ -8,7 +8,11 @@ export class EngAIClient {
     };
   }
 
-  async invokeAgent(agentId, payload) {
+  async invokeAgent(agentIdOrPayload, maybePayload) {
+    const implicitAutonomous = arguments.length === 1;
+    const agentId = implicitAutonomous ? null : agentIdOrPayload;
+    const payload = implicitAutonomous ? agentIdOrPayload : maybePayload;
+
     const body =
       typeof payload === "string"
         ? { message: payload }
@@ -31,7 +35,12 @@ export class EngAIClient {
       headers["Idempotency-Key"] = idempotencyKey;
     }
 
-    const response = await fetch(`${this.baseUrl}/sdk/agents/${agentId}/invoke`, {
+    const normalizedAgentId = String(agentId || "").trim();
+    const endpoint = normalizedAgentId
+      ? `${this.baseUrl}/sdk/agents/${encodeURIComponent(normalizedAgentId)}/invoke`
+      : `${this.baseUrl}/sdk/invoke`;
+
+    const response = await fetch(endpoint, {
       method: "POST",
       headers,
       body: JSON.stringify(body),