@docbrasil/api-systemmanager 1.1.81 → 1.1.83

package/api/ai/index.js

@@ -15,7 +15,6 @@ class MyndAI {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
 
     self.sessions = new AISession(options);
   }
@@ -92,7 +91,8 @@ class MyndAI {
       Joi.assert(params, Joi.object().required().error(new Error('params is required')));
       Joi.assert(params.prompt, Joi.string().required().error(new Error('Provide a prompt')));
 
-      const apiCall = self._client
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
           .post('/agents/explain', params, self._setHeader(authorization));
 
       return self._returnData(await apiCall);

package/api/ai/sessions.js

@@ -14,7 +14,6 @@ class AISession {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
   }
 
   /**
@@ -78,8 +77,9 @@ class AISession {
       Joi.assert(params, Joi.object().required().error(new Error('params is required')));
       Joi.assert(params.documentId, Joi.string().required().error(new Error('documentId is required')));
 
-      const apiCall = self._client
-        .get(`/akamai/agents/session/document/${params.documentId}`, self._setHeader(authorization));
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .get(`/agents/session/document/${params.documentId}`, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
     } catch (ex) {
@@ -140,8 +140,101 @@ class AISession {
 
       const { documentId, ...payload } = params;
 
-      const apiCall = self._client
-        .patch(`/akamai/agents/session/document/${documentId}`, payload, self._setHeader(authorization));
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .patch(`/agents/session/document/${documentId}`, payload, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Create a new agent session.
+   * Use this to create a session with full metadata before triggering execution.
+   * @param {object} params Parameters
+   * @param {string} params.agentType The agent type (e.g., 'doc-rlm-ingest')
+   * @param {object} [params.config] Agent configuration options
+   * @param {object} [params.metadata] Session metadata (documentId, pipelineVariant, analysisMode, etc.)
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The created session
+   * @return {string} data.sessionId The session ID
+   * @return {string} data.status The session status
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   agentType: 'doc-rlm-ingest',
+   *   metadata: {
+   *     documentId: 'doc-123',
+   *     documentName: 'Patient Report.pdf',
+   *     pipelineVariant: 'A',
+   *     analysisMode: 'full'
+   *   }
+   * };
+   * const retData = await api.ai.sessions.create(params, authorization);
+   */
+  async create(params, authorization) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required().error(new Error('params is required')));
+      Joi.assert(params.agentType, Joi.string().required().error(new Error('agentType is required')));
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post('/agents/create', params, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Start execution on an existing agent session.
+   * @param {object} params Parameters
+   * @param {string} params.sessionId The session ID to execute
+   * @param {object} [params.input] Execution input (documentId, options, etc.)
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The execution data
+   * @return {string} data.executionId The execution ID
+   * @return {string} data.status The execution status
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   sessionId: 'session-abc-123',
+   *   input: {
+   *     documentId: 'doc-123',
+   *     options: { pipelineVariant: 'A', analysisMode: 'full' }
+   *   }
+   * };
+   * const retData = await api.ai.sessions.execute(params, authorization);
+   */
+  async execute(params, authorization) {
+    const self = this;
+
+    try {
+      Joi.assert(params, Joi.object().required().error(new Error('params is required')));
+      Joi.assert(params.sessionId, Joi.string().required().error(new Error('sessionId is required')));
+
+      const { sessionId, ...payload } = params;
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post(`/agents/${sessionId}/execute`, payload, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
     } catch (ex) {

package/api/dispatch.js

@@ -198,6 +198,30 @@ class Dispatch {
   getClient() {
     return this._client;
   }
+
+  /**
+   * @description Create a dedicated Axios client for Akamai routes.
+   * @param {string} url The Akamai base URL (e.g., http://localhost:9008 in DEV).
+   * @public
+   */
+  setAkamaiBaseUrl(url) {
+    Joi.assert(url, Joi.string().required());
+
+    this._akamaiClient = Axios.create({
+      baseURL: url,
+      withCredentials: true
+    });
+  }
+
+  /**
+   * @description Get the Akamai Axios client. Falls back to the default client
+   * for backward compatibility (e.g., PROD where NGiNX proxies all routes).
+   * @return {AxiosInstance} The Akamai client or default client.
+   * @public
+   */
+  getAkamaiClient() {
+    return this._akamaiClient || this._client;
+  }
 }
 
 export default Dispatch;

package/dist/bundle.cjs

@@ -210,6 +210,30 @@ class Dispatch {
   getClient() {
     return this._client;
   }
+
+  /**
+   * @description Create a dedicated Axios client for Akamai routes.
+   * @param {string} url The Akamai base URL (e.g., http://localhost:9008 in DEV).
+   * @public
+   */
+  setAkamaiBaseUrl(url) {
+    Joi__default["default"].assert(url, Joi__default["default"].string().required());
+
+    this._akamaiClient = Axios__default["default"].create({
+      baseURL: url,
+      withCredentials: true
+    });
+  }
+
+  /**
+   * @description Get the Akamai Axios client. Falls back to the default client
+   * for backward compatibility (e.g., PROD where NGiNX proxies all routes).
+   * @return {AxiosInstance} The Akamai client or default client.
+   * @public
+   */
+  getAkamaiClient() {
+    return this._akamaiClient || this._client;
+  }
 }
 
 /**
@@ -16129,7 +16153,6 @@ class AISession {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
   }
 
   /**
@@ -16193,8 +16216,9 @@ class AISession {
       Joi__default["default"].assert(params, Joi__default["default"].object().required().error(new Error('params is required')));
       Joi__default["default"].assert(params.documentId, Joi__default["default"].string().required().error(new Error('documentId is required')));
 
-      const apiCall = self._client
-        .get(`/akamai/agents/session/document/${params.documentId}`, self._setHeader(authorization));
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .get(`/agents/session/document/${params.documentId}`, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
     } catch (ex) {
@@ -16255,8 +16279,101 @@ class AISession {
 
       const { documentId, ...payload } = params;
 
-      const apiCall = self._client
-        .patch(`/akamai/agents/session/document/${documentId}`, payload, self._setHeader(authorization));
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .patch(`/agents/session/document/${documentId}`, payload, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Create a new agent session.
+   * Use this to create a session with full metadata before triggering execution.
+   * @param {object} params Parameters
+   * @param {string} params.agentType The agent type (e.g., 'doc-rlm-ingest')
+   * @param {object} [params.config] Agent configuration options
+   * @param {object} [params.metadata] Session metadata (documentId, pipelineVariant, analysisMode, etc.)
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The created session
+   * @return {string} data.sessionId The session ID
+   * @return {string} data.status The session status
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   agentType: 'doc-rlm-ingest',
+   *   metadata: {
+   *     documentId: 'doc-123',
+   *     documentName: 'Patient Report.pdf',
+   *     pipelineVariant: 'A',
+   *     analysisMode: 'full'
+   *   }
+   * };
+   * const retData = await api.ai.sessions.create(params, authorization);
+   */
+  async create(params, authorization) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required().error(new Error('params is required')));
+      Joi__default["default"].assert(params.agentType, Joi__default["default"].string().required().error(new Error('agentType is required')));
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post('/agents/create', params, self._setHeader(authorization));
+
+      return self._returnData(await apiCall);
+    } catch (ex) {
+      throw ex;
+    }
+  }
+
+  /**
+   * @author Myndware <augusto.pissarra@myndware.com>
+   * @description Start execution on an existing agent session.
+   * @param {object} params Parameters
+   * @param {string} params.sessionId The session ID to execute
+   * @param {object} [params.input] Execution input (documentId, options, etc.)
+   * @param {string} authorization Authorization token
+   * @return {Promise<object>} data The execution data
+   * @return {string} data.executionId The execution ID
+   * @return {string} data.status The execution status
+   * @public
+   * @async
+   * @example
+   *
+   * const API = require('@docbrasil/api-systemmanager');
+   * const api = new API();
+   * const authorization = '...';
+   * const params = {
+   *   sessionId: 'session-abc-123',
+   *   input: {
+   *     documentId: 'doc-123',
+   *     options: { pipelineVariant: 'A', analysisMode: 'full' }
+   *   }
+   * };
+   * const retData = await api.ai.sessions.execute(params, authorization);
+   */
+  async execute(params, authorization) {
+    const self = this;
+
+    try {
+      Joi__default["default"].assert(params, Joi__default["default"].object().required().error(new Error('params is required')));
+      Joi__default["default"].assert(params.sessionId, Joi__default["default"].string().required().error(new Error('sessionId is required')));
+
+      const { sessionId, ...payload } = params;
+
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
+        .post(`/agents/${sessionId}/execute`, payload, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
     } catch (ex) {
@@ -16277,7 +16394,6 @@ class MyndAI {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
 
     self.sessions = new AISession(options);
   }
@@ -16354,7 +16470,8 @@ class MyndAI {
       Joi__default["default"].assert(params, Joi__default["default"].object().required().error(new Error('params is required')));
       Joi__default["default"].assert(params.prompt, Joi__default["default"].string().required().error(new Error('Provide a prompt')));
 
-      const apiCall = self._client
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
           .post('/agents/explain', params, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
@@ -16421,6 +16538,7 @@ class API {
         }
       },
       uri: 'http://localhost:8080',
+      akamaiUri: null,
       attemptsRetry: 3,
       httpStatusToRetry: [401],
       debug: {success: true, error: true}
@@ -16436,6 +16554,20 @@ class API {
     self.admin = new Admin({parent: self});
     self.external = new External({parent: self});
     self.ai = new MyndAI({parent: self});
+
+    // If akamaiUri was provided in options, configure the Akamai client
+    if (self.options.akamaiUri) {
+      self.dispatch.setAkamaiBaseUrl(self.options.akamaiUri);
+    }
+  }
+
+  /**
+   * @description Set the Akamai base URL for agent/AI routes.
+   * @param {string} url The Akamai base URL.
+   * @public
+   */
+  setAkamaiBaseUrl(url) {
+    this.dispatch.setAkamaiBaseUrl(url);
   }
 }