@eng-ai/sdk 2.0.0

package/README.md

@@ -0,0 +1,32 @@
+# @eng-ai/sdk
+
+Official JavaScript SDK for ENG-AI External API v2.
+
+## Install
+
+```bash
+npm install @eng-ai/sdk
+```
+
+## Usage
+
+```js
+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", {
+  message: "Explique o conceito de talude",
+  normativeMode: true,
+  normId: "auto"
+});
+
+console.log(response.result.content);
+console.log(response.normative?.citations ?? []);
+```
+
+## Security Notes
+
+- Use your ENG-AI API key only in trusted server environments.
+- Do not ship secrets in frontend bundles.
+- Keep idempotency enabled for mutation-heavy integrations.

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@eng-ai/sdk",
+  "version": "2.0.0",
+  "description": "Official JavaScript SDK for ENG-AI External API v2",
+  "type": "module",
+  "main": "./src/client.js",
+  "exports": {
+    ".": "./src/client.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "check:pack": "NPM_CONFIG_CACHE=${NPM_CONFIG_CACHE:-/tmp/engai-npm-cache} npm pack --dry-run"
+  },
+  "keywords": [
+    "eng-ai",
+    "sdk",
+    "mcp",
+    "agent",
+    "ai"
+  ],
+  "author": "ENG-AI",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/client.js

@@ -0,0 +1,46 @@
+export class EngAIClient {
+  constructor(apiKey, baseUrl = "http://localhost:8000/api/v2") {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+    this.headers = {
+      "X-API-Key": this.apiKey,
+      "Content-Type": "application/json",
+    };
+  }
+
+  async invokeAgent(agentId, payload) {
+    const body =
+      typeof payload === "string"
+        ? { message: payload }
+        : {
+            message: payload?.message,
+            project_id: payload?.projectId ?? payload?.project_id,
+            session_id: payload?.sessionId ?? payload?.session_id,
+            context_digest: payload?.contextDigest ?? payload?.context_digest,
+            normative_mode:
+              (payload?.normativeMode ?? payload?.normative_mode) ||
+              (payload?.normId ?? payload?.norm_id)
+                ? true
+                : undefined,
+            norm_id: payload?.normId ?? payload?.norm_id,
+          };
+
+    const headers = { ...this.headers };
+    const idempotencyKey = payload?.idempotencyKey ?? payload?.idempotency_key;
+    if (idempotencyKey) {
+      headers["Idempotency-Key"] = idempotencyKey;
+    }
+
+    const response = await fetch(`${this.baseUrl}/sdk/agents/${agentId}/invoke`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+      throw new Error(`Error: ${response.statusText}`);
+    }
+
+    return await response.json();
+  }
+}