@runflow-ai/cli 0.2.19 → 0.2.21

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

@@ -1,15 +1,16 @@
 # RunFlow CLI
 
-Command line interface to manage AI agents via **API Portal**. Authenticate, provision agents, manage users and configure credentials — all from the terminal.
+Command line interface to manage AI agents via **API Portal**. Create agents, manage knowledge bases, handle prompts — all from the terminal.
 
 ## Key Features
 
-- **Simple authentication** with your API key
-- **Complete AI agent management** with cloning and deployment
-- **Interactive interface** with menu selection
-- **Secure credentials** integrated
+- 🚀 **Create agents from templates** with `rf create`
+- 🧠 **Manage knowledge bases** (vector stores) with `rf kb`
+- 📝 **Full prompts management** with CRUD and editor integration
+- 👥 **Multi-tenant profiles** - switch between API keys easily
+- 🧪 **Local testing** with web interface and live reload
 
-## 🚀 Installation
+## 📦 Installation
 
 ```bash
 npm i -g @runflow-ai/cli
@@ -19,62 +20,374 @@ npm i -g @runflow-ai/cli
 
 ```bash
 # 1. Authenticate with your API key
-rf login --api-key YOUR_API_KEY
+rf login
 
-# 2. List and select agent
-rf agents list
+# 2. Create a new agent from template
+rf create
+
+# 3. Navigate to the created folder
+cd my-agent/
 
-# 3. Clone agent repository
-# (select agent → Clone repository)
+# 4. Test locally with web interface
+rf test
 
-# 4. Make changes and deploy
-cd agent-name/
-# ... make changes ...
+# 5. Deploy to production
 rf agents deploy
+```
+
+## 🛠️ Commands
+
+### `rf create` - Create New Agent ⭐
+
+Interactive agent creation with templates from the API.
+
+```bash
+# Interactive mode
+rf create
 
-# 5. Pull latest changes when needed
-rf agents pull
+# Non-interactive mode (for scripts/AI)
+rf create --name my-agent --template starter
+rf create -n my-agent -t rag-agent --yes
 ```
 
-## 🛠️ Main Commands
+**Options:**
+- `-n, --name <name>` - Agent name (non-interactive)
+- `-t, --template <id>` - Template ID or name (non-interactive)
+- `-y, --yes` - Auto-install dependencies without prompting
 
-| 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 |
+**Flow:**
+1. Enter agent name (or use `--name`)
+2. Choose template (or use `--template`)
+3. Agent created on server with repository
+4. Repository cloned locally
+5. Dependencies installed (auto with `--yes`)
 
-**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
+**Available Templates:**
+- **starter** - Minimal setup, perfect for beginners
+- **rag-agent** - Agent with knowledge base integration
+- **webhook-handler** - Process webhooks and integrations
 
-Run `rf --help` to see all commands.
+---
 
-## 📦 Usage Example
+### `rf login` - Authentication
 
 ```bash
-# 1. Authenticate
+# Interactive login
+rf login
+
+# With API key directly
 rf login --api-key sk-xxx...
 
-# 2. List and select agent
-rf agents list
+# Save as named profile
+rf login --profile client-acme
+```
+
+**Options:**
+- `--api-key <key>` - API key to use
+- `--profile <name>` - Save as named profile
+- `--api <url>` - Custom API URL
+
+---
+
+### `rf switch` - Switch Profile
+
+Switch between saved profiles for multi-tenant support.
+
+```bash
+# Interactive selection
+rf switch
+
+# Direct switch
+rf switch client-acme
+```
+
+---
+
+### `rf profiles` - Manage Profiles
+
+```bash
+# List all profiles
+rf profiles
+
+# Show current profile
+rf profiles current
+
+# Delete a profile
+rf profiles delete client-acme
+```
+
+---
+
+### `rf agents` - Agent Management
+
+```bash
+rf agents list              # List agents (interactive menu)
+rf agents get               # Show current agent details
+rf agents clone             # Clone agent repository
+rf agents pull              # Pull latest changes
+rf agents deploy            # Deploy local changes
+rf agents duplicate         # Duplicate agent
+rf agents delete            # Delete agent
+rf agents delete --yes      # Delete without confirmation
+```
 
-# 3. Download repository (select "Clone repository")
-# 4. Navigate to created folder
-cd agent-name/
+**Options:**
+- `-y, --yes` - Skip confirmation prompts
+
+**Aliases:** `rf agent`
+
+---
+
+### `rf prompts` - Prompts Management
+
+Full CRUD operations for prompt templates.
+
+```bash
+# Interactive mode
+rf prompts
+
+# List all prompts
+rf prompts list
+
+# Get prompt content
+rf prompts get <name>
+
+# Create new prompt (interactive)
+rf prompts create <name>
+
+# Create prompt (non-interactive - for scripts/AI)
+rf prompts create my-prompt --content "You are a helpful assistant"
+rf prompts create my-prompt --file ./prompt.txt
+
+# Update prompt (opens editor)
+rf prompts update <name>
+rf prompts update <name> --content "New content"
+
+# Delete prompt
+rf prompts delete <name>
+rf prompts delete <name> --yes  # Skip confirmation
+
+# Render with variables
+rf prompts render <name> '{"var": "value"}'
+```
+
+**Options:**
+- `-c, --content <text>` - Prompt content (non-interactive)
+- `-f, --file <path>` - Read content from file
+- `-y, --yes` - Skip confirmation prompts
+
+**Aliases:** `rf prompt`
+
+---
+
+### `rf kb` - Knowledge Base Management
+
+Manage vector stores for RAG (Retrieval Augmented Generation).
+
+```bash
+# List all knowledge bases
+rf kb list
+
+# Create new knowledge base (interactive)
+rf kb create <name>
+
+# Create KB (non-interactive - for scripts/AI)
+rf kb create my-kb --embedding "OpenAI Small"
+rf kb create my-kb -e openai-small
+
+# Upload file
+rf kb upload <kb-name> <file>
+
+# Upload directory (with confirmation skip)
+rf kb upload <kb-name> ./docs --yes
+
+# Check processing status
+rf kb status <kb-name>
+
+# List documents
+rf kb docs <kb-name>
+
+# Remove document
+rf kb remove-doc <kb-name> <doc-id>
+rf kb remove-doc <kb-name> <doc-id> --yes  # Skip confirmation
+
+# Semantic search
+rf kb search <kb-name> "your query"
+
+# Delete knowledge base
+rf kb delete <kb-name>
+rf kb delete <kb-name> --yes  # Skip confirmation
+```
 
-# 5. Make changes and deploy
+**Options:**
+- `-e, --embedding <config>` - Embedding config ID or name (non-interactive)
+- `-y, --yes` - Skip confirmation prompts
+
+**Supported Files:** PDF, TXT, MD, DOCX
+
+---
+
+### `rf test` - Local Testing
+
+Start local development server with web interface.
+
+```bash
+cd my-agent/
+rf test
+
+# Custom port
+rf test --port 4000
+
+# Without opening browser
+rf test --no-browser
+```
+
+**Features:**
+- Zero config - auto-detects from `.runflow/rf.json`
+- Web portal with real-time monitoring
+- Live reload on file changes
+- Traces saved to `.runflow/traces.json`
+
+---
+
+### Other Commands
+
+```bash
+rf users list               # Manage users
+rf credentials list         # List credentials
+rf triggers list            # Manage triggers
+rf executions list          # View execution history
+rf health                   # Check API health
+```
+
+## 📖 Usage Examples
+
+### Complete Development Workflow
+
+```bash
+# 1. Login and create agent
+rf login
+rf create
+# → Select "RAG Agent" template
+# → Name: "support-bot"
+
+# 2. Navigate and set up knowledge base
+cd support-bot/
+rf kb create support-docs
+rf kb upload support-docs ./docs --recursive
+
+# 3. Test locally
+rf test
+
+# 4. Deploy to production
 rf agents deploy
+```
+
+### Multi-Tenant Workflow
 
-# 6. Pull latest changes when needed
-rf agents pull
+```bash
+# Save profiles for different clients
+rf login --profile acme-corp
+rf login --profile tech-startup
+
+# Switch between clients
+rf switch acme-corp
+rf agents list
+
+rf switch tech-startup
+rf agents list
+```
+
+### Knowledge Base Management
+
+```bash
+# Create and populate KB
+rf kb create product-docs
+rf kb upload product-docs ./manual.pdf
+rf kb upload product-docs ./faq.md
+
+# Check status
+rf kb status product-docs
+
+# Test search
+rf kb search product-docs "how to reset password"
+
+# Manage documents
+rf kb docs product-docs
+rf kb remove-doc product-docs doc_123
+```
+
+### Using with AI Tools / Scripts (Non-Interactive Mode)
+
+All commands support non-interactive flags for automation with AI tools (Cursor, Copilot) or CI/CD:
+
+```bash
+# Create agent without interaction
+rf create --name my-agent --template starter --yes
+
+# Create prompt without interaction
+rf prompts create support-bot --content "You are a support assistant"
+
+# Create KB without interaction  
+rf kb create docs-kb --embedding "OpenAI Small"
+
+# Delete without confirmation
+rf agents delete --yes
+rf prompts delete old-prompt --yes
+rf kb delete old-kb --yes
+
+# Upload directory without confirmation
+rf kb upload docs-kb ./documents --yes
+```
+
+**Flag Reference:**
+
+| Command | Specific Flags | Common Flags |
+|---------|---------------|--------------|
+| `rf create` | `-n, --name` `-t, --template` | `-y, --yes` |
+| `rf agents` | - | `-y, --yes` |
+| `rf prompts` | `-c, --content` `-f, --file` | `-y, --yes` |
+| `rf kb` | `-e, --embedding` | `-y, --yes` |
+
+All commands also support: `--api-key` and `--api` for authentication overrides.
+
+## 🔧 Configuration
+
+### Environment Variables
+
+```bash
+RUNFLOW_API_URL=https://api.runflow.ai
+RUNFLOW_API_KEY=sk-xxx...
+```
+
+### Config File (`~/.runflowrc`)
+
+```json
+{
+  "currentProfile": "default",
+  "profiles": {
+    "default": {
+      "apiKey": "sk-xxx...",
+      "apiUrl": "https://api.runflow.ai",
+      "tenantId": "tenant_123",
+      "tenantName": "My Company"
+    }
+  }
+}
+```
+
+### Project Config (`.runflow/rf.json`)
+
+Created automatically by `rf create` or `rf agents clone`:
+
+```json
+{
+  "agentId": "agent_uuid",
+  "agentName": "my-agent",
+  "tenantId": "tenant_123"
+}
 ```
 
 ## 📝 License
 
 MIT – (c) IFTL 2025
-

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

@@ -5,4 +5,5 @@ export declare class AgentsCommand extends CommandRunner {
     run(inputs: string[], options: AgentsOptions): Promise<void>;
     parseApiKey(val: string): string;
     parseApi(val: string): string;
+    parseYes(): boolean;
 }