@docbrasil/api-systemmanager 1.1.81 → 1.1.83

package/docs/Dispatch.html

@@ -314,6 +314,129 @@
 
 
 
+
+</div>
+            
+                <div class="member">
+
+
+    
+    <h4 class="name" id="getAkamaiClient">
+        <a class="href-link" href="#getAkamaiClient">#</a>
+        
+        <span class="code-name">
+            
+                getAkamaiClient<span class="signature">()</span><span class="type-signature"> &rarr; {AxiosInstance}</span>
+            
+        </span>
+    </h4>
+    
+
+    
+    
+    <div class="description">
+        Get the Akamai Axios client. Falls back to the default client
+for backward compatibility (e.g., PROD where NGiNX proxies all routes).
+    </div>
+    
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    
+
+    
+
+    
+
+    
+        <p class="tag-source">
+            <a href="dispatch.js.html" class="button">View Source</a>
+            <span>
+                <a href="dispatch.js.html">dispatch.js</a>, <a href="dispatch.js.html#line222">line 222</a>
+            </span>
+        </p>
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+    <div class='columns method-parameter'>
+        <div class="column is-2"><label>Returns:</label></div>
+        <div class="column is-10">
+            
+                    
+
+<div class="columns">
+    
+    <div class='param-desc column is-7'>The Akamai client or default client.</div>
+    
+    
+    <div class='column is-5 has-text-left'>
+        <label>Type: </label>
+        
+<code class="param-type">AxiosInstance</code>
+
+
+    </div>
+    
+</div>
+
+                
+        </div>
+    </div>
+
+
+
 
 </div>
             
@@ -673,6 +796,154 @@
 
 
 
+
+</div>
+            
+                <div class="member">
+
+
+    
+    <h4 class="name" id="setAkamaiBaseUrl">
+        <a class="href-link" href="#setAkamaiBaseUrl">#</a>
+        
+        <span class="code-name">
+            
+                setAkamaiBaseUrl<span class="signature">(url)</span><span class="type-signature"></span>
+            
+        </span>
+    </h4>
+    
+
+    
+    
+    <div class="description">
+        Create a dedicated Axios client for Akamai routes.
+    </div>
+    
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+<div class="table-container">
+    <table class="params table">
+        <thead>
+        <tr>
+            
+            <th>Name</th>
+            
+
+            <th>Type</th>
+
+            
+
+            
+
+            <th class="last">Description</th>
+        </tr>
+        </thead>
+
+        <tbody>
+        
+
+            
+<tr class="deep-level-0">
+  
+      <td class="name"><code>url</code></td>
+  
+
+  <td class="type">
+  
+      
+<code class="param-type">string</code>
+
+
+  
+  </td>
+
+  
+
+  
+
+  <td class="description last">The Akamai base URL (e.g., http://localhost:9008 in DEV).</td>
+</tr>
+
+
+        
+        </tbody>
+    </table>
+</div>
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    
+
+    
+
+    
+
+    
+        <p class="tag-source">
+            <a href="dispatch.js.html" class="button">View Source</a>
+            <span>
+                <a href="dispatch.js.html">dispatch.js</a>, <a href="dispatch.js.html#line207">line 207</a>
+            </span>
+        </p>
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 </div>
             

package/docs/MyndAI.html

@@ -632,7 +632,7 @@
         <p class="tag-source">
             <a href="ai_index.js.html" class="button">View Source</a>
             <span>
-                <a href="ai_index.js.html">ai/index.js</a>, <a href="ai_index.js.html#line88">line 88</a>
+                <a href="ai_index.js.html">ai/index.js</a>, <a href="ai_index.js.html#line87">line 87</a>
             </span>
         </p>
     

package/docs/ai_index.js.html

@@ -102,7 +102,6 @@ class MyndAI {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
 
     self.sessions = new AISession(options);
   }
@@ -179,7 +178,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/docs/ai_sessions.js.html

@@ -101,7 +101,6 @@ class AISession {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
   }
 
   /**
@@ -165,8 +164,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) {
@@ -227,8 +227,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/docs/dispatch.js.html

@@ -285,6 +285,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/index.js

@@ -68,6 +68,7 @@ class API {
         }
       },
       uri: 'http://localhost:8080',
+      akamaiUri: null,
       attemptsRetry: 3,
       httpStatusToRetry: [401],
       debug: {success: true, error: true}
@@ -83,6 +84,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);
   }
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docbrasil/api-systemmanager",
   "description": "Module API System Manager",
-  "version": "1.1.81",
+  "version": "1.1.83",
   "scripts": {
     "htmldoc": "rm -rf docs && jsdoc api/** -d docs -t ./node_modules/better-docs",
     "doc": "rm -rf doc && mkdir doc && jsdoc2md api/**/* api/* > doc/api.md",