@docbrasil/api-systemmanager 1.1.88 → 1.1.90

package/doc/api.md

@@ -1816,6 +1816,8 @@ Class for AI Session management
     * [.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>
+    * [.addDocuments(params, authorization)](#AISession+addDocuments) ⇒ <code>Promise.&lt;object&gt;</code>
+    * [.removeDocuments(params, authorization)](#AISession+removeDocuments) ⇒ <code>Promise.&lt;object&gt;</code>
 
 <a name="AISession+getByDocument"></a>
 
@@ -1956,6 +1958,64 @@ const params = {
 };
 const retData = await api.ai.sessions.execute(params, authorization);
 ```
+<a name="AISession+addDocuments"></a>
+
+### aiSession.addDocuments(params, authorization) ⇒ <code>Promise.&lt;object&gt;</code>
+Add documents to an existing agent session.
+The agent will handle the documentIds accordingly.
+
+**Kind**: instance method of [<code>AISession</code>](#AISession)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - data The result from the agent  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Parameters |
+| params.sessionId | <code>string</code> | The session ID |
+| params.documentIds | <code>array.&lt;string&gt;</code> | Array of document IDs to add |
+| 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',
+  documentIds: ['doc-123', 'doc-456']
+};
+const retData = await api.ai.sessions.addDocuments(params, authorization);
+```
+<a name="AISession+removeDocuments"></a>
+
+### aiSession.removeDocuments(params, authorization) ⇒ <code>Promise.&lt;object&gt;</code>
+Remove documents from an existing agent session.
+The agent will handle the documentIds accordingly.
+
+**Kind**: instance method of [<code>AISession</code>](#AISession)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - data The result from the agent  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Parameters |
+| params.sessionId | <code>string</code> | The session ID |
+| params.documentIds | <code>array.&lt;string&gt;</code> | Array of document IDs to remove |
+| 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',
+  documentIds: ['doc-123', 'doc-456']
+};
+const retData = await api.ai.sessions.removeDocuments(params, authorization);
+```
 <a name="GeoLocation"></a>
 
 ## GeoLocation
@@ -4245,7 +4305,9 @@ Class for process, permission user
     * [.getOrgDocTypes(params, session)](#Process+getOrgDocTypes) ⇒ <code>Promise</code>
     * [.getOrgGroups(params, session)](#Process+getOrgGroups) ⇒ <code>Promise</code>
     * [.getOrgUsers(params, session)](#Process+getOrgUsers) ⇒ <code>Promise</code>
-    * [.getStepHistory(params, session)](#Process+getStepHistory) ⇒ <code>Promise.&lt;Array&gt;</code>
+    * [.restart(params, session)](#Process+restart) ⇒ <code>Promise.&lt;object&gt;</code>
+    * [.reexecute(params, session)](#Process+reexecute) ⇒ <code>Promise.&lt;object&gt;</code>
+    * [.reexecuteTask(params, session)](#Process+reexecuteTask) ⇒ <code>Promise.&lt;object&gt;</code>
 
 <a name="Process+start"></a>
 
@@ -4582,22 +4644,54 @@ const params = {
 const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
 await api.user.process.getOrgUsers(params, session);
 ```
-<a name="Process+getStepHistory"></a>
+<a name="Process+restart"></a>
 
-### process.getStepHistory(params, session) ⇒ <code>Promise.&lt;Array&gt;</code>
-Get step history of a process flow
+### process.restart(params, session) ⇒ <code>Promise.&lt;object&gt;</code>
+Restart a finished process from a specific flow step. Resets the process completion state
+and triggers re-execution from the specified flow name.
 
 **Kind**: instance method of [<code>Process</code>](#Process)  
-**Returns**: <code>Promise.&lt;Array&gt;</code> - Array of step history entries  
+**Returns**: <code>Promise.&lt;object&gt;</code> - { response: 'OK' } on success  
 **Access**: public  
 **Author**: Myndware <augusto.pissarra@myndware.com>  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| params | <code>object</code> | Params to get step history |
+| params | <code>object</code> | Params to restart the process |
+| params.processId | <code>string</code> | Process id (_id database); |
 | params.orgId | <code>string</code> | Organization id (_id database); |
+| params.flowName | <code>string</code> | The flow name of the step to restart from; |
+| session | <code>string</code> | Session, token JWT |
+
+**Example**  
+```js
+const API = require('@docbrasil/api-systemmanager');
+const api = new API();
+const params = {
+  processId: '5dadd01dc4af3941d42f8c5c',
+  orgId: '5edd11c46b6ce9729c2c297c',
+  flowName: 'Task_1'
+};
+const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+await api.user.process.restart(params, session);
+```
+<a name="Process+reexecute"></a>
+
+### process.reexecute(params, session) ⇒ <code>Promise.&lt;object&gt;</code>
+Re-execute a specific flow step in a running process. Unlike restart, this does not
+reset the process completion state. Task creation is deferred to the BPMN engine via RabbitMQ.
+
+**Kind**: instance method of [<code>Process</code>](#Process)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - { response: 'OK' } on success  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Params to re-execute the process step |
 | params.processId | <code>string</code> | Process id (_id database); |
-| params.flowId | <code>string</code> | Flow id; |
+| params.orgId | <code>string</code> | Organization id (_id database); |
+| params.flowName | <code>string</code> | The flow name of the step to re-execute; |
 | session | <code>string</code> | Session, token JWT |
 
 **Example**  
@@ -4605,12 +4699,45 @@ Get step history of a process flow
 const API = require('@docbrasil/api-systemmanager');
 const api = new API();
 const params = {
+  processId: '5dadd01dc4af3941d42f8c5c',
   orgId: '5edd11c46b6ce9729c2c297c',
+  flowName: 'Task_1'
+};
+const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
+await api.user.process.reexecute(params, session);
+```
+<a name="Process+reexecuteTask"></a>
+
+### process.reexecuteTask(params, session) ⇒ <code>Promise.&lt;object&gt;</code>
+Re-execute a specific user task step in a running process, creating a new task
+synchronously with optional userId reassignment. For non-group tasks, the task is reassigned
+to the current logged-in user. For group tasks, the original assignment is preserved.
+
+**Kind**: instance method of [<code>Process</code>](#Process)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - { response: 'OK', taskId } on success  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Params to re-execute the task |
+| params.processId | <code>string</code> | Process id (_id database); |
+| params.orgId | <code>string</code> | Organization id (_id database); |
+| params.flowName | <code>string</code> | The flow name of the user task step to re-execute; |
+| session | <code>string</code> | Session, token JWT |
+
+**Example**  
+```js
+const API = require('@docbrasil/api-systemmanager');
+const api = new API();
+const params = {
   processId: '5dadd01dc4af3941d42f8c5c',
-  flowId: 'Task_18v1xx7'
-}
+  orgId: '5edd11c46b6ce9729c2c297c',
+  flowName: 'Task_1'
+};
 const session = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
-const stepHistory = await api.user.process.getStepHistory(params, session);
+const result = await api.user.process.reexecuteTask(params, session);
+console.log(result.taskId);
 ```
 <a name="Register"></a>