@runflow-ai/cli 0.2.18 → 0.2.20

package/CLI-DOCS.md

@@ -1,6 +1,6 @@
 # RunFlow CLI Documentation
 
-**Version:** 0.2.0  
+**Version:** 0.2.19  
 **Command:** `rf`
 
 A CLI para interagir com a API Portal RunFlow, permitindo gerenciar agentes de IA, usuários, prompts e muito mais.
@@ -8,7 +8,7 @@ A CLI para interagir com a API Portal RunFlow, permitindo gerenciar agentes de I
 ## Instalação
 
 ```bash
-npm install -g runflow-cli
+npm install -g @runflow-ai/cli
 ```
 
 ## Autenticação
@@ -131,7 +131,9 @@ rf prompt <action> <name> [data]  # alias
 | Ação | Descrição | Exemplo |
 |------|-----------|---------|
 | `get <name>` | Obtém um prompt | `rf prompts get meu-prompt` |
-| `render <name> <json>` | Renderiza prompt com variáveis | `rf prompts render meu-prompt '{"var":"value"}'` |
+| `render <name> <json>` | Renderiza prompt com variáveis (JSON obrigatório) | `rf prompts render meu-prompt '{"username":"João","product":"RunFlow"}'` |
+
+**Nota:** O comando `render` requer um JSON válido como terceiro parâmetro contendo as variáveis para renderizar o template.
 
 ### 🔑 Credentials (Credenciais)
 
@@ -149,104 +151,6 @@ rf credential <action> [name]  # alias
 | `list` | Lista credenciais | `rf credentials list` |
 | `get <name>` | Obtém credencial específica | `rf credentials get minha-credencial` |
 
-### 🔍 Search Tools
-
-Gerenciar ferramentas de busca.
-
-```bash
-rf search-tools <action>
-```
-
-**Ações:**
-
-| Ação | Descrição | Exemplo |
-|------|-----------|---------|
-| `list` | Lista ferramentas de busca | `rf search-tools list` |
-
-### ⚡ Executions
-
-Gerenciar execuções.
-
-```bash
-rf executions <action>
-```
-
-**Ações:**
-
-| Ação | Descrição | Exemplo |
-|------|-----------|---------|
-| `list` | Lista execuções | `rf executions list` |
-
-### 💾 Sessions
-
-Gerenciar sessões.
-
-```bash
-rf sessions <action>
-```
-
-**Ações:**
-
-| Ação | Descrição | Exemplo |
-|------|-----------|---------|
-| `list` | Lista sessões | `rf sessions list` |
-
-### 📊 Datasources
-
-Gerenciar fontes de dados.
-
-```bash
-rf datasources <action>
-```
-
-**Ações:**
-
-| Ação | Descrição | Exemplo |
-|------|-----------|---------|
-| `list` | Lista fontes de dados | `rf datasources list` |
-
-### 🔗 Connectors
-
-Gerenciar conectores.
-
-```bash
-rf connectors <action>
-```
-
-**Ações:**
-
-| Ação | Descrição | Exemplo |
-|------|-----------|---------|
-| `list` | Lista conectores | `rf connectors list` |
-
-### 🎯 Triggers
-
-Gerenciar triggers.
-
-```bash
-rf triggers <action>
-```
-
-**Ações:**
-
-| Ação | Descrição | Exemplo |
-|------|-----------|---------|
-| `list` | Lista triggers | `rf triggers list` |
-
-### 📈 Traces
-
-Gerenciar traces.
-
-```bash
-rf traces <action>
-```
-
-**Ações:**
-
-| Ação | Descrição | Exemplo |
-|------|-----------|---------|
-| `list` | Lista traces | `rf traces list` |
-
 ### 🔐 Secret
 
 Gerenciar secrets.
@@ -261,16 +165,6 @@ rf secret <action>
 |------|-----------|---------|
 | `list` | Lista secrets | `rf secret list` |
 
-### 🏥 Health
-
-Verificar saúde da API.
-
-```bash
-rf health [detail]
-```
-
-**Descrição:** Verifica o status de saúde da API Portal.
-
 ### 🔓 Login
 
 Autenticar com a API RunFlow.
@@ -386,21 +280,21 @@ rf prompts render welcome-message '{"username": "João", "product": "RunFlow"}'
 
 ### Monitoramento
 ```bash
-# Verificar saúde da API
-rf health
+# Testar localmente com observabilidade
+rf test
 
-# Ver execuções recentes
-rf executions list
+# Verificar prompts
+rf prompts get my-prompt
 
-# Analisar traces
-rf traces list
+# Gerenciar credenciais
+rf credentials list
 ```
 
 ---
 
 ## 🧪 Test (Local Testing)
 
-Inicia servidor local de observabilidade e abre o portal cloud para testar agentes.
+Inicia servidor local de observabilidade com interface web para testar agentes.
 
 ```bash
 rf test [options]
@@ -413,8 +307,8 @@ rf test [options]
 **Características:**
 - ✅ Zero configuração - detecta `agentId` automaticamente do `.runflow/rf.json`
 - ✅ Portas aleatórias - evita conflitos tentando até 3 portas
-- ✅ Portal cloud - usa `platform.runflow.ai` sempre atualizado
-- ✅ Dados locais - traces armazenados em `.runflow/traces/`
+- ✅ Portal local - interface web servida em `localhost` com arquivos estáticos incluídos
+- ✅ Dados locais - traces armazenados em `.runflow/traces.json`
 - ✅ Monitoramento real-time - visualize threads, execuções e traces
 
 **Exemplo básico:**
@@ -430,9 +324,9 @@ rf test
 # ✓ Opening browser...
 # 
 # 📊 Test Portal Ready!
-#    🌐 Portal: https://platform.runflow.ai/agents/abc.../test-monitor?...
+#    🌐 Portal: http://localhost:3421/agents/abc.../test-monitor?...
 #    📡 API: http://localhost:3421
-#    💾 Storage: .runflow/traces/
+#    💾 Storage: .runflow/traces.json
 ```
 
 **Com opções:**
@@ -449,8 +343,8 @@ rf test --no-browser
 1. **Lê configuração** do `.runflow/rf.json` (agentId, agentName)
 2. **Inicia servidor local** com 3 APIs de observabilidade
 3. **Tenta até 3 portas** caso a primeira esteja ocupada
-4. **Abre portal cloud** (`platform.runflow.ai`) com parâmetros corretos
-5. **Portal conecta** ao servidor local para buscar dados
+4. **Serve interface web local** em `localhost` com arquivos estáticos incluídos na CLI
+5. **Portal mostra dados** armazenados localmente em `.runflow/traces.json`
 
 **APIs disponíveis:**
 - `GET /health` - Health check
@@ -462,11 +356,7 @@ rf test --no-browser
 ```
 .runflow/
 ├── rf.json              # Configuração do agente
-└── traces/              # Armazenamento de traces
-    ├── 2025-11-06/      # Pastas por data
-    │   └── session-*.json
-    └── 2025-11-07/
-        └── ...
+└── traces.json          # Armazenamento de traces local
 ```
 
 **Fluxo típico de uso:**
@@ -489,11 +379,12 @@ node agent.ts
 
 ### Problemas de Autenticação
 ```bash
-# Verificar configuração
-rf health
-
 # Fazer login novamente
 rf login --api-key sua-chave
+
+# Verificar configuração
+ls -la .runflow/rf.json
+cat .runflow/rf.json
 ```
 
 ### Problemas de Git

package/README.md

@@ -8,6 +8,7 @@ Command line interface to manage AI agents via **API Portal**. Authenticate, pro
 - **Complete AI agent management** with cloning and deployment
 - **Interactive interface** with menu selection
 - **Secure credentials** integrated
+- **Local testing** with observability server
 
 ## 🚀 Installation
 
@@ -34,27 +35,96 @@ rf agents deploy
 
 # 5. Pull latest changes when needed
 rf agents pull
+
+# 6. Test locally with observability
+rf test
 ```
 
-## 🛠️ Main Commands
+## 🛠️ Available Commands
+
+### Authentication
+
+| Command | Description | Options |
+| --- | --- | --- |
+| `rf login --api-key <key>` | Authenticate with RunFlow API | `--api <url>`, `--tenant-id <id>` |
+
+### Agents Management
 
 | Command | Description |
 | --- | --- |
-| `rf login --api-key <key>` | Authentication |
-| `rf agents <action>` | Manage AI agents |
-| `rf users <action>` | Manage users |
-| `rf prompts <action>` | Manage prompts |
-| `rf credentials <action>` | Manage credentials |
-
-**Key agent actions:**
-- `rf agents list` - List and select agents
-- `rf agents clone` - Download agent repository
-- `rf agents pull` - Pull latest changes (overwrites local)
-- `rf agents deploy` - Deploy local changes
+| `rf agents list` | List agents with **interactive menu** (clone, deploy, duplicate, delete) |
+| `rf agents get` | Show current/selected agent details |
+| `rf agents create <json>` | Create a new agent |
+| `rf agents update <json>` | Update the selected agent |
+| `rf agents delete` | Delete the selected agent |
+| `rf agents clone` | Download agent repository (clone) |
+| `rf agents pull` | Pull latest changes from server |
+| `rf agents duplicate` | Duplicate agent on server |
+| `rf agents deploy` | Deploy local changes to server |
+
+**Aliases:** `rf agent` (singular)
+
+### Users Management
+
+| Command | Description |
+| --- | --- |
+| `rf users list` | List and select users |
+| `rf users get` | Show selected user details |
+| `rf users create <json>` | Create a new user |
+| `rf users update <json>` | Update selected user |
+| `rf users delete` | Delete selected user |
+
+**Aliases:** `rf user` (singular)
+
+### Prompts Management
+
+| Command | Description |
+| --- | --- |
+| `rf prompts get <name>` | Get prompt template by name |
+| `rf prompts render <name> <json>` | Render prompt with variables (JSON required) |
+
+**Example:**
+```bash
+rf prompts render welcome-message '{"username": "John", "product": "RunFlow"}'
+```
+
+**Aliases:** `rf prompt` (singular)
+
+### Credentials Management
+
+| Command | Description |
+| --- | --- |
+| `rf credentials list` | List and select credentials |
+| `rf credentials get <name>` | Get credential details by name |
+
+**Aliases:** `rf credential` (singular)
+
+### Testing & Development
+
+| Command | Description | Options |
+| --- | --- | --- |
+| `rf test` | Start **local** observability server with web interface | `-p, --port <port>`, `--no-browser` |
+
+**Features:**
+- Zero configuration - auto-detects agent from `.runflow/rf.json`
+- Random ports (3000-4000) to avoid conflicts
+- Local web portal with real-time monitoring
+- Traces storage in `.runflow/traces.json`
+
+### Global Options
+
+All commands support:
+- `--api-key <key>` - Override API key
+- `--api <url>` - Override API URL
+- `--verbose` - Show detailed output
+- `--quiet` - Suppress output
+- `--help, -h` - Show help
 
 Run `rf --help` to see all commands.
 
-## 📦 Usage Example
+## 📦 Usage Examples
+
+### Basic Workflow
 
 ```bash
 # 1. Authenticate
@@ -74,6 +144,49 @@ rf agents deploy
 rf agents pull
 ```
 
+### Local Testing
+
+```bash
+# Start local server with web interface
+cd agent-name/
+rf test
+
+# Opens browser automatically at:
+# http://localhost:PORT/agents/your-agent/test-monitor
+
+# Specify custom port
+rf test --port 4500
+
+# Without opening browser
+rf test --no-browser
+```
+
+### Managing Prompts
+
+```bash
+# Get a prompt template
+rf prompts get welcome-message
+
+# Render prompt with variables
+rf prompts render welcome-message '{"username": "John", "product": "RunFlow"}'
+```
+
+### Managing Credentials
+
+```bash
+# List all credentials
+rf credentials list
+
+# Get specific credential
+rf credentials get my-api-key
+```
+
+## 📚 Documentation
+
+For detailed documentation, see:
+- [CLI-DOCS.md](./CLI-DOCS.md) - Complete command reference
+- [docs/TEST-COMMAND.md](./docs/TEST-COMMAND.md) - Test command guide
+
 ## 📝 License
 
 MIT – (c) IFTL 2025

package/dist/commands/test/test.command.d.ts

@@ -6,7 +6,6 @@ interface TestCommandOptions {
 export declare class TestCommand extends CommandRunner {
     private server;
     private app;
-    private storageDir;
     run(passedParam: string[], options?: TestCommandOptions): Promise<void>;
     parsePort(val: string): number;
     parseNoBrowser(): boolean;
@@ -20,14 +19,13 @@ export declare class TestCommand extends CommandRunner {
     private generateSessionId;
     private generateUserId;
     private createFingerprint;
-    private ensureStorageDir;
+    private ensureTracesFile;
     private startObservabilityServer;
     private setupObservabilityEndpoints;
     private getThreads;
     private getThreadExecutions;
     private getExecutionTraces;
     private countAllTraces;
-    private getAllTraceFiles;
     private getSDKTraces;
     private buildTraceHierarchy;
     private openBrowser;