@runflow-ai/sdk 1.0.0 → 1.0.1

package/dist/runflow-sdk.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionManager = exports.RunflowSDK = void 0;
+const config_1 = require("./config");
 class RunflowSDK {
     constructor(context) {
         // =============================================================================
@@ -11,16 +12,16 @@ class RunflowSDK {
                 // companyId vem automaticamente do context injetado pela plataforma
                 const companyId = this.context.companyId || this.context.tenantId;
                 return new SessionManager(sessionId, companyId, this.context, this.getApiUrl(), this.getApiKey());
-            }
+            },
         };
+        // Tentar carregar configurações do arquivo .runflow automaticamente
+        (0, config_1.loadRunflowConfig)();
         // Context é SEMPRE injetado pela plataforma via env vars
         this.context = context || {
-            tenantId: this.getRequiredEnv('RUNFLOW_TENANT_ID'),
-            projectId: this.getRequiredEnv('RUNFLOW_PROJECT_ID'),
-            agentId: this.getRequiredEnv('RUNFLOW_AGENT_ID'),
+            tenantId: this.getRequiredEnv("RUNFLOW_TENANT_ID"),
+            agentId: this.getRequiredEnv("RUNFLOW_AGENT_ID"),
             requestId: process.env.RUNFLOW_REQUEST_ID || `req_${Date.now()}`,
             sessionId: process.env.RUNFLOW_SESSION_ID,
-            companyId: process.env.RUNFLOW_COMPANY_ID // Injetado automaticamente
         };
     }
     getRequiredEnv(key) {
@@ -31,42 +32,266 @@ class RunflowSDK {
         return value;
     }
     getApiUrl() {
-        return process.env.RUNFLOW_API_URL || 'http://localhost:3001';
+        return process.env.RUNFLOW_API_URL || "http://localhost:3001";
     }
     getApiKey() {
         const key = process.env.RUNFLOW_API_KEY;
         if (!key) {
-            throw new Error('RUNFLOW_API_KEY não definida. Certifique-se de que o agente está sendo executado na plataforma Runflow.');
+            throw new Error("RUNFLOW_API_KEY não definida. Certifique-se de que o agente está sendo executado na plataforma Runflow.");
         }
         return key;
     }
     getHeaders(includeCompany = false) {
         const headers = {
-            'Authorization': `Bearer ${this.getApiKey()}`,
-            'Content-Type': 'application/json',
-            'X-Runflow-Tenant-Id': this.context.tenantId,
-            'X-Runflow-Project-Id': this.context.projectId,
-            'X-Runflow-Agent-Id': this.context.agentId,
+            "x-api-key": this.getApiKey(),
+            "Content-Type": "application/json",
+            "X-Runflow-Tenant-Id": this.context.tenantId,
+            "X-Runflow-Agent-Id": this.context.agentId,
         };
-        if (includeCompany && this.context.companyId) {
-            headers['X-Runflow-Company-Id'] = this.context.companyId;
-        }
         return headers;
     }
     // =============================================================================
+    // ⚙️ COMANDOS GERAIS
+    // =============================================================================
+    async login(apiKey) {
+        this.log("Validando API key");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/login`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async health() {
+        this.log("Verificando saúde da API");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/health`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async tenants() {
+        this.log("Listando tenants");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/tenants`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async agents() {
+        this.log("Listando agentes");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/agents`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async getAgent(id) {
+        this.log(`Buscando agente: ${id}`);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/agents/${id}`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async createAgent(data) {
+        this.log("Criando agente", data);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/agents`, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async updateAgent(id, data) {
+        this.log(`Atualizando agente: ${id}`, data);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/agents/${id}`, {
+            method: "PUT",
+            headers: this.getHeaders(),
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async deleteAgent(id) {
+        this.log(`Removendo agente: ${id}`);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/agents/${id}`, {
+            method: "DELETE",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+    }
+    async cloneAgent(id) {
+        this.log(`Clonando agente: ${id}`);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/agents/${id}/clone`, {
+            method: "POST",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async deployAgent(id) {
+        this.log(`Publicando agente: ${id}`);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/agents/${id}/deploy`, {
+            method: "POST",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async connectors() {
+        this.log("Listando conectores");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/connectors`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async credentials() {
+        this.log("Listando credenciais");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/credentials`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async datasources() {
+        this.log("Listando fontes de dados");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/datasources`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async triggers() {
+        this.log("Listando triggers");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/triggers`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async executions() {
+        this.log("Listando execuções");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/executions`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async users() {
+        this.log("Listando usuários");
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/users`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async getUser(id) {
+        this.log(`Buscando usuário: ${id}`);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/users/${id}`, {
+            method: "GET",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async createUser(data) {
+        this.log("Criando usuário", data);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/users`, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async updateUser(id, data) {
+        this.log(`Atualizando usuário: ${id}`, data);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/users/${id}`, {
+            method: "PUT",
+            headers: this.getHeaders(),
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async deleteUser(id) {
+        this.log(`Removendo usuário: ${id}`);
+        const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/users/${id}`, {
+            method: "DELETE",
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+    }
+    // =============================================================================
     // 🔐 CREDENCIAIS
     // =============================================================================
     async getCredential(name) {
         this.log(`Buscando credencial: ${name}`);
         try {
             const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/credentials/${name}`, {
-                method: 'GET',
-                headers: this.getHeaders()
+                method: "GET",
+                headers: this.getHeaders(),
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
             }
-            const credential = await response.json();
+            const credential = (await response.json());
             this.log(`Credencial obtida: ${credential.name} (${credential.type})`);
             return credential;
         }
@@ -82,22 +307,22 @@ class RunflowSDK {
         this.log(`Buscando prompt: ${name}`, variables ? { variables } : undefined);
         try {
             let url = `${this.getApiUrl()}/api/v1/sdk/prompts/${name}`;
-            let method = 'GET';
+            let method = "GET";
             let body = undefined;
             // Se há variáveis, usar POST para renderização
             if (variables && Object.keys(variables).length > 0) {
-                method = 'POST';
+                method = "POST";
                 body = JSON.stringify({ variables });
             }
             const response = await fetch(url, {
                 method,
                 headers: this.getHeaders(),
-                body
+                body,
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
             }
-            const promptResponse = await response.json();
+            const promptResponse = (await response.json());
             this.log(`Prompt obtido: ${promptResponse.name}`);
             return promptResponse.content;
         }
@@ -110,11 +335,11 @@ class RunflowSDK {
     // 🔍 SEARCH & VECTOR STORES
     // =============================================================================
     async getAvailableVectorStores() {
-        this.log('Listando vector stores disponíveis');
+        this.log("Listando vector stores disponíveis");
         try {
             const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/search-tools`, {
-                method: 'GET',
-                headers: this.getHeaders()
+                method: "GET",
+                headers: this.getHeaders(),
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
@@ -123,7 +348,7 @@ class RunflowSDK {
             return data.vector_stores || [];
         }
         catch (error) {
-            this.log('Erro ao listar vector stores:', error);
+            this.log("Erro ao listar vector stores:", error);
             throw error;
         }
     }
@@ -132,14 +357,14 @@ class RunflowSDK {
         this.log(`Buscando em ${vectorStore}: "${query}"`, { k, threshold });
         try {
             const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/search-tools/${vectorStore}/search`, {
-                method: 'POST',
+                method: "POST",
                 headers: this.getHeaders(),
-                body: JSON.stringify({ query, k, threshold })
+                body: JSON.stringify({ query, k, threshold }),
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
             }
-            const searchResponse = await response.json();
+            const searchResponse = (await response.json());
             this.log(`Busca realizada: ${searchResponse.results.length} resultados`);
             return searchResponse;
         }
@@ -148,6 +373,73 @@ class RunflowSDK {
             throw error;
         }
     }
+    async addDocument(request) {
+        this.log(`Adicionando documento ao vector store: ${request.vectorStore}`, {
+            contentLength: request.content.length,
+            hasMetadata: !!request.metadata
+        });
+        try {
+            const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/search-tools/documents`, {
+                method: "POST",
+                headers: this.getHeaders(),
+                body: JSON.stringify(request),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const result = (await response.json());
+            this.log(`Documento adicionado: ${result.id}`);
+            return result;
+        }
+        catch (error) {
+            this.log("Erro ao adicionar documento:", error);
+            throw error;
+        }
+    }
+    async listDocuments(vectorStore, options = {}) {
+        const { limit = 10, offset = 0 } = options;
+        this.log(`Listando documentos do vector store: ${vectorStore}`, { limit, offset });
+        try {
+            const params = new URLSearchParams({
+                limit: limit.toString(),
+                ...(offset > 0 && { offset: offset.toString() })
+            });
+            const url = `${this.getApiUrl()}/api/v1/sdk/search-tools/${vectorStore}/documents?${params}`;
+            const response = await fetch(url, {
+                method: "GET",
+                headers: this.getHeaders(),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const result = (await response.json());
+            this.log(`Documentos listados: ${result.documents.length} de ${result.total}`);
+            return result;
+        }
+        catch (error) {
+            this.log(`Erro ao listar documentos do vector store ${vectorStore}:`, error);
+            throw error;
+        }
+    }
+    async deleteDocument(documentId) {
+        this.log(`Removendo documento: ${documentId}`);
+        try {
+            const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/search-tools/documents/${documentId}`, {
+                method: "DELETE",
+                headers: this.getHeaders(),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const result = (await response.json());
+            this.log(`Documento removido: ${documentId}`);
+            return result;
+        }
+        catch (error) {
+            this.log(`Erro ao remover documento ${documentId}:`, error);
+            throw error;
+        }
+    }
     // =============================================================================
     // 📊 LOGS & TRACES
     // =============================================================================
@@ -161,26 +453,86 @@ class RunflowSDK {
             console.log(logEntry);
         }
     }
-    async trace(traceData = {}) {
-        this.log('Enviando trace para LangSmith', { operation: traceData.operation || 'agent.invoke' });
+    async trace(traceData) {
+        this.log("Enviando trace para LangSmith", { operation: "agent.invoke" });
         try {
+            // Converte dados legados para o formato padronizado
+            const standardizedData = this.standardizeTraceData(traceData);
             const response = await fetch(`${this.getApiUrl()}/api/v1/sdk/traces`, {
-                method: 'POST',
+                method: "POST",
                 headers: this.getHeaders(),
-                body: JSON.stringify(traceData)
+                body: JSON.stringify(standardizedData),
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
             }
-            const result = await response.json();
-            this.log(`Trace enviado: ${result.traceId}`, { langsmith: result.langsmith });
+            const result = (await response.json());
+            this.log(`Trace enviado: ${result.traceId}`, {
+                langsmith: result.langsmith,
+            });
             return result;
         }
         catch (error) {
-            this.log('Erro ao enviar trace:', error);
+            this.log("Erro ao enviar trace:", error);
             throw error;
         }
     }
+    standardizeTraceData(data) {
+        // Se já está no formato padrão, retorna como está
+        if (this.isStandardTraceData(data)) {
+            return data;
+        }
+        // Converte formato legado para o padronizado
+        const legacyData = data;
+        // Converte inputs para o formato de array com type e content
+        const input = [];
+        if (legacyData.inputs) {
+            // Se inputs é um objeto, converte cada chave em uma mensagem
+            for (const [key, value] of Object.entries(legacyData.inputs)) {
+                input.push({
+                    type: key === 'message' || key === 'query' ? 'human' : 'system',
+                    content: typeof value === 'string' ? value : JSON.stringify(value)
+                });
+            }
+        }
+        // Se não há inputs, cria um input padrão
+        if (input.length === 0) {
+            input.push({
+                type: 'human',
+                content: 'No input provided'
+            });
+        }
+        // Converte outputs para string
+        let output = '';
+        if (legacyData.outputs) {
+            if (typeof legacyData.outputs === 'string') {
+                output = legacyData.outputs;
+            }
+            else if (legacyData.outputs.message) {
+                output = legacyData.outputs.message;
+            }
+            else if (legacyData.outputs.answer) {
+                output = legacyData.outputs.answer;
+            }
+            else {
+                output = JSON.stringify(legacyData.outputs);
+            }
+        }
+        else {
+            output = 'No output provided';
+        }
+        return {
+            input,
+            output,
+            status: legacyData.status || 'success'
+        };
+    }
+    isStandardTraceData(data) {
+        return (data &&
+            Array.isArray(data.input) &&
+            typeof data.output === 'string' &&
+            typeof data.status === 'string');
+    }
 }
 exports.RunflowSDK = RunflowSDK;
 // =============================================================================
@@ -196,27 +548,26 @@ class SessionManager {
     }
     getHeaders() {
         return {
-            'Authorization': `Bearer ${this.apiKey}`,
-            'Content-Type': 'application/json',
-            'X-Runflow-Tenant-Id': this.context.tenantId,
-            'X-Runflow-Project-Id': this.context.projectId,
-            'X-Runflow-Agent-Id': this.context.agentId,
-            'X-Runflow-Company-Id': this.companyId,
+            "x-api-key": this.apiKey,
+            "Content-Type": "application/json",
+            "X-Runflow-Tenant-Id": this.context.tenantId,
+            "X-Runflow-Agent-Id": this.context.agentId,
+            "X-Runflow-Company-Id": this.companyId,
         };
     }
     async addMessage(role, content, metadata) {
         try {
             const response = await fetch(`${this.apiUrl}/api/v1/sdk/sessions/${this.sessionId}/messages`, {
-                method: 'POST',
+                method: "POST",
                 headers: this.getHeaders(),
                 body: JSON.stringify({
                     role,
                     content,
                     metadata: {
                         timestamp: new Date().toISOString(),
-                        ...metadata
-                    }
-                })
+                        ...metadata,
+                    },
+                }),
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
@@ -233,16 +584,16 @@ class SessionManager {
         try {
             const params = new URLSearchParams({
                 limit: limit.toString(),
-                offset: offset.toString()
+                offset: offset.toString(),
             });
             const response = await fetch(`${this.apiUrl}/api/v1/sdk/sessions/${this.sessionId}/history?${params}`, {
-                method: 'GET',
-                headers: this.getHeaders()
+                method: "GET",
+                headers: this.getHeaders(),
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);
             }
-            const historyResponse = await response.json();
+            const historyResponse = (await response.json());
             console.log(`📚 Histórico obtido: ${historyResponse.messages.length} mensagens`);
             return historyResponse.messages;
         }
@@ -254,8 +605,8 @@ class SessionManager {
     async clear() {
         try {
             const response = await fetch(`${this.apiUrl}/api/v1/sdk/sessions/${this.sessionId}`, {
-                method: 'DELETE',
-                headers: this.getHeaders()
+                method: "DELETE",
+                headers: this.getHeaders(),
             });
             if (!response.ok) {
                 throw new Error(`HTTP ${response.status}: ${response.statusText}`);