@docbrasil/api-systemmanager 1.1.81 → 1.1.82

package/docs/ai_sessions.js.html

@@ -166,7 +166,7 @@ class AISession {
       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));
+        .get(`/agents/session/document/${params.documentId}`, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
     } catch (ex) {
@@ -228,7 +228,97 @@ class AISession {
       const { documentId, ...payload } = params;
 
       const apiCall = self._client
-        .patch(`/akamai/agents/session/document/${documentId}`, payload, self._setHeader(authorization));
+        .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 apiCall = self._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 apiCall = self._client
+        .post(`/agents/${sessionId}/execute`, payload, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
     } catch (ex) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docbrasil/api-systemmanager",
   "description": "Module API System Manager",
-  "version": "1.1.81",
+  "version": "1.1.82",
   "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",