mitra-interactions-sdk 1.0.35 → 1.0.37

package/README.md

@@ -1,6 +1,6 @@
 # Mitra Interactions SDK
 
-SDK para interações com a plataforma Mitra via endpoints `/agentAiShortcut/`.
+SDK para interações com a plataforma Mitra via endpoints `/interactions/`.
 
 ## Instalação
 
@@ -14,16 +14,17 @@ pnpm add mitra-interactions-sdk
 
 ## Configuração
 
-Antes de usar qualquer função, configure o SDK com seu token da plataforma Mitra.
+Antes de usar qualquer função, configure o SDK. O `token` é **opcional** — Server Functions públicas podem ser chamadas sem autenticação.
 
-> **Importante:** O token é um JWT de autenticação da plataforma Mitra. **Nunca deixe o token estático no código.** Utilize variáveis de ambiente para armazená-lo de forma segura.
+> **Importante:** Quando usado, o token é um JWT de autenticação da plataforma Mitra. **Nunca deixe o token estático no código.** Utilize variáveis de ambiente para armazená-lo de forma segura.
 
 ```typescript
 import { configureSdkMitra } from 'mitra-interactions-sdk';
 
+// Configuração completa (com autenticação)
 const instance = configureSdkMitra({
   baseURL: process.env.MITRA_BASE_URL || 'https://api.mitra.com',
-  token: process.env.MITRA_TOKEN!,
+  token: process.env.MITRA_TOKEN!,                       // Opcional — necessário apenas para endpoints autenticados
   authUrl: 'https://coder.mitralab.io/sdk-auth/',       // Opcional — necessário para login e token refresh
   projectId: 123,                                        // Opcional — se informado, torna projectId opcional em TODOS os métodos
   integrationURL: 'https://api0.mitraecp.com:1003',     // Opcional — necessário para integrações
@@ -31,6 +32,13 @@ const instance = configureSdkMitra({
     localStorage.setItem('mitra_session', JSON.stringify(session));
   }
 });
+
+// Configuração mínima (sem token — apenas para Server Functions públicas)
+const instance = configureSdkMitra({
+  baseURL: 'https://api.mitra.com',
+  projectId: 123
+});
+await instance.executeServerFunction({ serverFunctionId: 42 }); // OK — sem token
 ```
 
 > **`projectId` global:** Se você passar `projectId` no `configureSdkMitra`, ele será usado como fallback em **todos** os métodos do SDK. Assim, não é necessário passar `projectId` em cada chamada individual — basta configurar uma vez.
@@ -83,7 +91,7 @@ await loginMitra('mitra', {
 Navega o usuário para a página de auth. Após o login, redireciona de volta com token nos query params.
 
 ```typescript
-import { loginMitra, handleAuthRedirect } from 'mitra-interactions-sdk';
+import { loginMitra } from 'mitra-interactions-sdk';
 
 // Iniciar login — o navegador navega para fora da página
 await loginMitra('google', {
@@ -106,25 +114,6 @@ await loginMitra('mitra', {
 });
 ```
 
-### Processar Retorno do Redirect
-
-Após o redirect, a página de destino deve chamar `handleAuthRedirect()` para capturar o token:
-
-```typescript
-import { handleAuthRedirect, configureSdkMitra } from 'mitra-interactions-sdk';
-
-// No mounted/onLoad da página de retorno
-const session = handleAuthRedirect();
-if (session) {
-  // Login OK — session: { token, baseURL, integrationURL? }
-  configureSdkMitra({
-    baseURL: session.baseURL,
-    token: session.token,
-    integrationURL: session.integrationURL
-  });
-}
-```
-
 ### Token Refresh Automático
 
 Quando qualquer requisição retorna **403**, o SDK tenta renovar o token automaticamente via iframe invisível (usa o cookie de sessão do provider). Se o refresh funcionar, a requisição é retentada com o novo token — transparente para o desenvolvedor.
@@ -219,24 +208,6 @@ await executeDbActionMitra({ dbActionId: 1 });
 
 ## Métodos Disponíveis
 
-### executeDbActionMitra
-
-Executa uma DBAction (DML) cadastrada.
-
-```typescript
-import { executeDbActionMitra } from 'mitra-interactions-sdk';
-
-const result = await executeDbActionMitra({
-  projectId: 123,
-  dbActionId: 456,
-  params: {           // Opcional
-    campo1: 'valor1',
-    campo2: 'valor2'
-  }
-});
-// result: { status, result: { rowsAffected: number } }
-```
-
 ### executeServerFunctionMitra
 
 Executa uma Server Function de forma **síncrona** (timeout de 60s no backend). Retorna o resultado diretamente.
@@ -285,39 +256,6 @@ const result = await stopServerFunctionExecutionMitra({
 // result: { status, result: { executionId, executionStatus: "CANCELLED" | "ALREADY_FINISHED" } }
 ```
 
-### Integrações
-
-> **Requisito:** A `integrationURL` deve ser configurada via `configureSdkMitra({ ..., integrationURL: 'https://api0.mitraecp.com:1003' })`.
-
-#### listIntegrationsMitra
-
-Lista as integrações configuradas no projeto.
-
-```typescript
-import { listIntegrationsMitra } from 'mitra-interactions-sdk';
-
-const integrations = await listIntegrationsMitra({ projectId: 123 });
-// result: IntegrationResponse[] — [{ id, projectId, name, slug, blueprintId, blueprintType, authType, credentials, status, lastCheckedAt, createdAt, updatedAt }]
-```
-
-#### callIntegrationMitra
-
-Chama uma integração configurada, delegando a requisição ao serviço externo.
-
-```typescript
-import { callIntegrationMitra } from 'mitra-interactions-sdk';
-
-const result = await callIntegrationMitra({
-  projectId: 123,
-  connection: 'meu-erp',        // Slug da integração
-  method: 'GET',                 // GET, POST, PUT, DELETE
-  endpoint: '/api/v1/pedidos',   // Path no serviço externo (opcional)
-  params: { status: 'ativo' },   // Query params (opcional)
-  body: { nome: 'Teste' }        // Body para POST/PUT (opcional)
-});
-// result: { statusCode: number, body: any }
-```
-
 ### uploadFilePublicMitra / uploadFileLoadableMitra
 
 Faz upload de um arquivo diretamente para a pasta PUBLIC ou LOADABLE do projeto. Usa `multipart/form-data`.
@@ -340,75 +278,6 @@ const result2 = await uploadFileLoadableMitra({
 // result2: { status, result: { fileName, currentPath, publicUrl: null, message } }
 ```
 
-### setFileStatusMitra
-
-Move arquivo do chat para PUBLIC ou LOADABLE.
-
-```typescript
-import { setFileStatusMitra } from 'mitra-interactions-sdk';
-
-const result = await setFileStatusMitra({
-  projectId: 123,
-  fileName: 'arquivo.jpg',
-  targetPath: 'PUBLIC'  // 'PUBLIC' ou 'LOADABLE'
-});
-// result: { status, result: { fileName, currentPath, publicUrl, message } }
-```
-
-### setVariableMitra
-
-Cria ou atualiza uma variável customizada.
-
-```typescript
-import { setVariableMitra } from 'mitra-interactions-sdk';
-
-const result = await setVariableMitra({
-  projectId: 123,
-  key: 'minhaVariavel',
-  value: 'meuValor'  // Opcional
-});
-// result: { status, result: { key, value } }
-```
-
-### listVariablesMitra
-
-Lista variáveis de um projeto.
-
-```typescript
-import { listVariablesMitra } from 'mitra-interactions-sdk';
-
-const result = await listVariablesMitra({ projectId: 123 });
-// result: { status, projectId, result: [{ key, value }] }
-```
-
-### getVariableMitra
-
-Busca o valor de uma variável específica.
-
-```typescript
-import { getVariableMitra } from 'mitra-interactions-sdk';
-
-const result = await getVariableMitra({ projectId: 123, key: 'minhaVariavel' });
-// result: { status, result: { key, value } }
-```
-
-### runActionMitra
-
-Executa uma Action (fluxo de ação Low-Code) cadastrada.
-
-```typescript
-import { runActionMitra } from 'mitra-interactions-sdk';
-
-const result = await runActionMitra({
-  projectId: 123,
-  actionId: 456,
-  params: {           // Opcional
-    campo1: 'valor1'
-  }
-});
-// result: { status, executionTime, result: { stepsExecuted, message } }
-```
-
 ### Dynamic Schema CRUD
 
 CRUD completo em tabelas do projeto via Dynamic Schema (usa header `X-TenantID`).
@@ -476,18 +345,10 @@ import type {
   EmailVerifyCodeOptions,
   EmailResendCodeOptions,
   // Options
-  ExecuteDbActionOptions,
   ExecuteServerFunctionOptions,
   ExecuteServerFunctionAsyncOptions,
-  ListIntegrationsOptions,
-  CallIntegrationOptions,
   UploadFileOptions,
   StopServerFunctionExecutionOptions,
-  SetFileStatusOptions,
-  SetVariableOptions,
-  ListVariablesOptions,
-  GetVariableOptions,
-  RunActionOptions,
   ListRecordsOptions,
   GetRecordOptions,
   CreateRecordOptions,
@@ -496,16 +357,8 @@ import type {
   DeleteRecordOptions,
   CreateRecordsBatchOptions,
   // Responses
-  ExecuteDbActionResponse,
-  SetFileStatusResponse,
-  SetVariableResponse,
-  ListVariablesResponse,
-  GetVariableResponse,
-  RunActionResponse,
   ExecuteServerFunctionResponse,
   ExecuteServerFunctionAsyncResponse,
-  IntegrationResponse,
-  CallIntegrationResponse,
   UploadFileResponse,
   StopServerFunctionExecutionResponse,
   ListRecordsResponse

package/dist/index.d.mts

@@ -85,8 +85,8 @@ interface ExecuteDbActionOptions {
     projectId?: number;
     /** ID da DBAction cadastrada */
     dbActionId: number;
-    /** Variáveis para o statement (opcional) */
-    params?: Record<string, unknown>;
+    /** Parâmetros de entrada (opcional) — substituição de variáveis no SQL (ex: { "nome": "João" } substitui :nome) */
+    input?: Record<string, unknown>;
 }
 interface ExecuteDbActionResponse {
     status: string;
@@ -260,8 +260,8 @@ interface RunActionOptions {
     projectId?: number;
     /** ID da Action a executar */
     actionId: number;
-    /** Variáveis para a action (opcional) */
-    params?: Record<string, unknown>;
+    /** Parâmetros de entrada para a action (opcional) */
+    input?: Record<string, unknown>;
 }
 interface RunActionResponse {
     status: string;
@@ -358,8 +358,8 @@ declare function createMitraInstance(initialConfig: Partial<MitraConfig>): Mitra
 interface MitraConfig {
     /** URL base da API (ex: https://api.mitra.com) */
     baseURL: string;
-    /** Token JWT para autenticação */
-    token: string;
+    /** Token JWT para autenticação (opcional para Server Functions públicas) */
+    token?: string;
     /** URL base do serviço de integrações (ex: https://api0.mitraecp.com:1003) */
     integrationURL?: string;
     /** URL da página de autenticação Mitra (ex: https://coder.mitralab.io/sdk-auth/) */
@@ -405,19 +405,6 @@ declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginR
  * Login genérico via popup/redirect seguro Mitra.
  */
 declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
-/**
- * Processa o retorno de um login com mode 'redirect'.
- *
- * Após o redirect, a página de auth redireciona de volta com query params:
- *   ?tokenMitra={token}&backURLMitra={baseURL}&integrationURLMitra={integrationURL}
- *
- * Esta função:
- * - Lê os query params da URL atual
- * - Se `tokenMitra=error`, lança erro
- * - Se encontrou tokens, limpa a URL e retorna LoginResponse
- * - Se não encontrou nada, retorna null
- */
-declare function handleAuthRedirect(): LoginResponse | null;
 /**
  * Renova o token silenciosamente via iframe invisível.
  * Se já houver um refresh em andamento, reaproveita a mesma promise.
@@ -452,73 +439,73 @@ declare function emailLoginMitra(options: EmailLoginOptions): Promise<LoginRespo
  */
 
 /**
- * POST /agentAiShortcut/runQuery
+ * POST /interactions/runQuery
  * Executa query SELECT em um projeto
  */
 declare function runQueryMitra(options: RunQueryOptions): Promise<RunQueryResponse>;
 /**
- * POST /agentAiShortcut/executeDbAction
+ * POST /interactions/executeDbAction
  * Executa uma DBAction (DML) cadastrada
  */
 declare function executeDbActionMitra(options: ExecuteDbActionOptions): Promise<ExecuteDbActionResponse>;
 /**
- * POST /agentAiShortcut/setFileStatus
+ * POST /interactions/setFileStatus
  * Move arquivo do chat para PUBLIC ou LOADABLE
  */
 declare function setFileStatusMitra(options: SetFileStatusOptions): Promise<SetFileStatusResponse>;
 /**
- * POST /agentAiShortcut/setVariable
+ * POST /interactions/setVariable
  * Cria ou atualiza uma variável customizada
  */
 declare function setVariableMitra(options: SetVariableOptions): Promise<SetVariableResponse>;
 /**
- * GET /agentAiShortcut/listVariables?projectId={id}
+ * GET /interactions/listVariables?projectId={id}
  * Lista variáveis de um projeto
  */
 declare function listVariablesMitra(options?: ListVariablesOptions): Promise<ListVariablesResponse>;
 /**
- * GET /agentAiShortcut/getVariable?projectId={id}&key={key}
+ * GET /interactions/getVariable?projectId={id}&key={key}
  * Busca o valor de uma variável específica
  */
 declare function getVariableMitra(options: GetVariableOptions): Promise<GetVariableResponse>;
 /**
- * POST /agentAiShortcut/runAction
+ * POST /interactions/runAction
  * Executa uma Action (fluxo de ação) cadastrada
  */
 declare function runActionMitra(options: RunActionOptions): Promise<RunActionResponse>;
 /**
- * POST /agentAiShortcut/executeServerFunction
+ * POST /interactions/executeServerFunction
  * Executa uma Server Function de forma SÍNCRONA (timeout 60s no backend)
  */
 declare function executeServerFunctionMitra(options: ExecuteServerFunctionOptions): Promise<ExecuteServerFunctionResponse>;
 /**
- * POST /agentAiShortcut/executeServerFunctionAsync
+ * POST /interactions/executeServerFunctionAsync
  * Executa uma Server Function de forma ASSÍNCRONA (retorna executionId imediatamente)
  */
 declare function executeServerFunctionAsyncMitra(options: ExecuteServerFunctionAsyncOptions): Promise<ExecuteServerFunctionAsyncResponse>;
 /**
- * GET /integration?projectId=X
+ * GET /interactions/integrations?projectId=X
  * Lista integrações configuradas no projeto
  */
 declare function listIntegrationsMitra(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
 /**
- * POST /integration/call
- * Chama uma API externa via serviço de integrações (porta separada)
+ * POST /interactions/integrations/call
+ * Chama uma API externa via serviço de integrações
  * Mapeia connection → integrationSlug no body
  */
 declare function callIntegrationMitra(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
 /**
- * POST /agentAiShortcut/stopServerFunctionExecution
+ * POST /interactions/stopServerFunctionExecution
  * Para a execução de uma Server Function em andamento
  */
 declare function stopServerFunctionExecutionMitra(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
 /**
- * POST /agentAiShortcut/uploadFilePublic (multipart/form-data)
+ * POST /interactions/uploadFilePublic (multipart/form-data)
  * Faz upload de um arquivo para a pasta PUBLIC do projeto.
  */
 declare function uploadFilePublicMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
 /**
- * POST /agentAiShortcut/uploadFileLoadable (multipart/form-data)
+ * POST /interactions/uploadFileLoadable (multipart/form-data)
  * Faz upload de um arquivo para a pasta LOADABLE do projeto.
  */
 declare function uploadFileLoadableMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
@@ -530,4 +517,4 @@ declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<s
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
 
-export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, handleAuthRedirect, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra };
+export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra };

package/dist/index.d.ts

@@ -85,8 +85,8 @@ interface ExecuteDbActionOptions {
     projectId?: number;
     /** ID da DBAction cadastrada */
     dbActionId: number;
-    /** Variáveis para o statement (opcional) */
-    params?: Record<string, unknown>;
+    /** Parâmetros de entrada (opcional) — substituição de variáveis no SQL (ex: { "nome": "João" } substitui :nome) */
+    input?: Record<string, unknown>;
 }
 interface ExecuteDbActionResponse {
     status: string;
@@ -260,8 +260,8 @@ interface RunActionOptions {
     projectId?: number;
     /** ID da Action a executar */
     actionId: number;
-    /** Variáveis para a action (opcional) */
-    params?: Record<string, unknown>;
+    /** Parâmetros de entrada para a action (opcional) */
+    input?: Record<string, unknown>;
 }
 interface RunActionResponse {
     status: string;
@@ -358,8 +358,8 @@ declare function createMitraInstance(initialConfig: Partial<MitraConfig>): Mitra
 interface MitraConfig {
     /** URL base da API (ex: https://api.mitra.com) */
     baseURL: string;
-    /** Token JWT para autenticação */
-    token: string;
+    /** Token JWT para autenticação (opcional para Server Functions públicas) */
+    token?: string;
     /** URL base do serviço de integrações (ex: https://api0.mitraecp.com:1003) */
     integrationURL?: string;
     /** URL da página de autenticação Mitra (ex: https://coder.mitralab.io/sdk-auth/) */
@@ -405,19 +405,6 @@ declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginR
  * Login genérico via popup/redirect seguro Mitra.
  */
 declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
-/**
- * Processa o retorno de um login com mode 'redirect'.
- *
- * Após o redirect, a página de auth redireciona de volta com query params:
- *   ?tokenMitra={token}&backURLMitra={baseURL}&integrationURLMitra={integrationURL}
- *
- * Esta função:
- * - Lê os query params da URL atual
- * - Se `tokenMitra=error`, lança erro
- * - Se encontrou tokens, limpa a URL e retorna LoginResponse
- * - Se não encontrou nada, retorna null
- */
-declare function handleAuthRedirect(): LoginResponse | null;
 /**
  * Renova o token silenciosamente via iframe invisível.
  * Se já houver um refresh em andamento, reaproveita a mesma promise.
@@ -452,73 +439,73 @@ declare function emailLoginMitra(options: EmailLoginOptions): Promise<LoginRespo
  */
 
 /**
- * POST /agentAiShortcut/runQuery
+ * POST /interactions/runQuery
  * Executa query SELECT em um projeto
  */
 declare function runQueryMitra(options: RunQueryOptions): Promise<RunQueryResponse>;
 /**
- * POST /agentAiShortcut/executeDbAction
+ * POST /interactions/executeDbAction
  * Executa uma DBAction (DML) cadastrada
  */
 declare function executeDbActionMitra(options: ExecuteDbActionOptions): Promise<ExecuteDbActionResponse>;
 /**
- * POST /agentAiShortcut/setFileStatus
+ * POST /interactions/setFileStatus
  * Move arquivo do chat para PUBLIC ou LOADABLE
  */
 declare function setFileStatusMitra(options: SetFileStatusOptions): Promise<SetFileStatusResponse>;
 /**
- * POST /agentAiShortcut/setVariable
+ * POST /interactions/setVariable
  * Cria ou atualiza uma variável customizada
  */
 declare function setVariableMitra(options: SetVariableOptions): Promise<SetVariableResponse>;
 /**
- * GET /agentAiShortcut/listVariables?projectId={id}
+ * GET /interactions/listVariables?projectId={id}
  * Lista variáveis de um projeto
  */
 declare function listVariablesMitra(options?: ListVariablesOptions): Promise<ListVariablesResponse>;
 /**
- * GET /agentAiShortcut/getVariable?projectId={id}&key={key}
+ * GET /interactions/getVariable?projectId={id}&key={key}
  * Busca o valor de uma variável específica
  */
 declare function getVariableMitra(options: GetVariableOptions): Promise<GetVariableResponse>;
 /**
- * POST /agentAiShortcut/runAction
+ * POST /interactions/runAction
  * Executa uma Action (fluxo de ação) cadastrada
  */
 declare function runActionMitra(options: RunActionOptions): Promise<RunActionResponse>;
 /**
- * POST /agentAiShortcut/executeServerFunction
+ * POST /interactions/executeServerFunction
  * Executa uma Server Function de forma SÍNCRONA (timeout 60s no backend)
  */
 declare function executeServerFunctionMitra(options: ExecuteServerFunctionOptions): Promise<ExecuteServerFunctionResponse>;
 /**
- * POST /agentAiShortcut/executeServerFunctionAsync
+ * POST /interactions/executeServerFunctionAsync
  * Executa uma Server Function de forma ASSÍNCRONA (retorna executionId imediatamente)
  */
 declare function executeServerFunctionAsyncMitra(options: ExecuteServerFunctionAsyncOptions): Promise<ExecuteServerFunctionAsyncResponse>;
 /**
- * GET /integration?projectId=X
+ * GET /interactions/integrations?projectId=X
  * Lista integrações configuradas no projeto
  */
 declare function listIntegrationsMitra(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
 /**
- * POST /integration/call
- * Chama uma API externa via serviço de integrações (porta separada)
+ * POST /interactions/integrations/call
+ * Chama uma API externa via serviço de integrações
  * Mapeia connection → integrationSlug no body
  */
 declare function callIntegrationMitra(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
 /**
- * POST /agentAiShortcut/stopServerFunctionExecution
+ * POST /interactions/stopServerFunctionExecution
  * Para a execução de uma Server Function em andamento
  */
 declare function stopServerFunctionExecutionMitra(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
 /**
- * POST /agentAiShortcut/uploadFilePublic (multipart/form-data)
+ * POST /interactions/uploadFilePublic (multipart/form-data)
  * Faz upload de um arquivo para a pasta PUBLIC do projeto.
  */
 declare function uploadFilePublicMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
 /**
- * POST /agentAiShortcut/uploadFileLoadable (multipart/form-data)
+ * POST /interactions/uploadFileLoadable (multipart/form-data)
  * Faz upload de um arquivo para a pasta LOADABLE do projeto.
  */
 declare function uploadFileLoadableMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
@@ -530,4 +517,4 @@ declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<s
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
 
-export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, handleAuthRedirect, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra };
+export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra };