@docbrasil/api-systemmanager 1.1.81 → 1.1.83

package/doc/api.md

@@ -1814,6 +1814,8 @@ Class for AI Session management
 * [AISession](#AISession)
     * [.getByDocument(params, authorization)](#AISession+getByDocument) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>object</code> \| <code>object</code> \| <code>array.&lt;object&gt;</code> \| <code>array.&lt;object&gt;</code> \| <code>array.&lt;object&gt;</code> \| <code>object</code>
     * [.updateData(params, authorization)](#AISession+updateData) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>array.&lt;object&gt;</code> \| <code>object</code> \| <code>object</code>
+    * [.create(params, authorization)](#AISession+create) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
+    * [.execute(params, authorization)](#AISession+execute) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
 
 <a name="AISession+getByDocument"></a>
 
@@ -1888,6 +1890,72 @@ const params = {
 };
 const retData = await api.ai.sessions.updateData(params, authorization);
 ```
+<a name="AISession+create"></a>
+
+### aiSession.create(params, authorization) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
+Create a new agent session.
+Use this to create a session with full metadata before triggering execution.
+
+**Kind**: instance method of [<code>AISession</code>](#AISession)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - data The created session<code>string</code> - data.sessionId The session ID<code>string</code> - data.status The session status  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Parameters |
+| params.agentType | <code>string</code> | The agent type (e.g., 'doc-rlm-ingest') |
+| [params.config] | <code>object</code> | Agent configuration options |
+| [params.metadata] | <code>object</code> | Session metadata (documentId, pipelineVariant, analysisMode, etc.) |
+| authorization | <code>string</code> | Authorization token |
+
+**Example**  
+```js
+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);
+```
+<a name="AISession+execute"></a>
+
+### aiSession.execute(params, authorization) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
+Start execution on an existing agent session.
+
+**Kind**: instance method of [<code>AISession</code>](#AISession)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - data The execution data<code>string</code> - data.executionId The execution ID<code>string</code> - data.status The execution status  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Parameters |
+| params.sessionId | <code>string</code> | The session ID to execute |
+| [params.input] | <code>object</code> | Execution input (documentId, options, etc.) |
+| authorization | <code>string</code> | Authorization token |
+
+**Example**  
+```js
+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);
+```
 <a name="GeoLocation"></a>
 
 ## GeoLocation
@@ -5335,6 +5403,8 @@ Api dispatch manager
     * [.errorOffline()](#Dispatch+errorOffline)
     * [.getContext(url, [session])](#Dispatch+getContext) ⇒ <code>Promise.&lt;object&gt;</code>
     * [.getClient()](#Dispatch+getClient) ⇒ <code>AxiosInstance</code>
+    * [.setAkamaiBaseUrl(url)](#Dispatch+setAkamaiBaseUrl)
+    * [.getAkamaiClient()](#Dispatch+getAkamaiClient) ⇒ <code>AxiosInstance</code>
 
 <a name="Dispatch+errorOffline"></a>
 
@@ -5364,6 +5434,27 @@ Get the Axios client.
 **Kind**: instance method of [<code>Dispatch</code>](#Dispatch)  
 **Returns**: <code>AxiosInstance</code> - The Axios client.  
 **Access**: public  
+<a name="Dispatch+setAkamaiBaseUrl"></a>
+
+### dispatch.setAkamaiBaseUrl(url)
+Create a dedicated Axios client for Akamai routes.
+
+**Kind**: instance method of [<code>Dispatch</code>](#Dispatch)  
+**Access**: public  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| url | <code>string</code> | The Akamai base URL (e.g., http://localhost:9008 in DEV). |
+
+<a name="Dispatch+getAkamaiClient"></a>
+
+### dispatch.getAkamaiClient() ⇒ <code>AxiosInstance</code>
+Get the Akamai Axios client. Falls back to the default client
+for backward compatibility (e.g., PROD where NGiNX proxies all routes).
+
+**Kind**: instance method of [<code>Dispatch</code>](#Dispatch)  
+**Returns**: <code>AxiosInstance</code> - The Akamai client or default client.  
+**Access**: public  
 <a name="External"></a>
 
 ## External