@igoruehara/canvas-flow 0.1.3 → 0.1.5

package/README.md

@@ -74,6 +74,8 @@ No Windows:
 C:\Users\<usuario>\.canvas-flow\config.json
 ```
 
+Esse arquivo guarda porta, MongoDB, tokens e provedores. Nao publique `config.json`: ele contem secrets gerados e chaves de API.
+
 Abrir a config:
 
 ```bash
@@ -86,36 +88,102 @@ Ver o caminho da config:
 npx @igoruehara/canvas-flow@latest config
 ```
 
-Exemplo com OpenAI:
+Ver a config no terminal:
+
+```bash
+npx @igoruehara/canvas-flow@latest config --show
+```
+
+Tambem da para configurar ao iniciar. Esses parametros valem para aquela execucao:
+
+```bash
+npx @igoruehara/canvas-flow@latest --port 3334 --public-url http://localhost:3334 --open
+npx @igoruehara/canvas-flow@latest --config C:\canvas-flow\config.json --open
+npx @igoruehara/canvas-flow@latest --home C:\canvas-flow-data --open
+```
+
+### Campos principais
+
+`server`: controla porta, URL publica, Swagger, CORS e abertura do navegador.
+
+```json
+{
+  "server": {
+    "port": 3333,
+    "publicUrl": "http://localhost:3333",
+    "openBrowser": false
+  }
+}
+```
+
+`database`: obrigatorio. Use Mongo local, Mongo do Docker ou MongoDB Atlas.
+
+```json
+{
+  "database": {
+    "mongoUrl": "mongodb://127.0.0.1:27017/canvas_flow"
+  }
+}
+```
+
+`auth`: gerado automaticamente. Mantenha `apiToken`, `jwtSecret` e `mediaProxySecret` privados. `login` e opcional.
+
+```json
+{
+  "auth": {
+    "login": false,
+    "apiToken": "generated-by-canvas-flow-init",
+    "jwtSecret": "generated-by-canvas-flow-init"
+  }
+}
+```
+
+`providers`: opcional. Preencha somente os provedores que vai usar. Sem chave de LLM, fluxos que chamam IA/LLM nao vao executar geracao.
 
 ```json
 {
   "providers": {
     "openai": {
-      "apiKey": "sk-..."
+      "apiKey": "sk-...",
+      "chatModel": "gpt-4o"
+    },
+    "claude": {
+      "apiKey": "",
+      "chatModel": "claude-sonnet-4-6"
+    },
+    "gemini": {
+      "apiKey": "",
+      "chatModel": "gemini-3.5-flash"
     }
   }
 }
 ```
 
-Exemplo com porta customizada:
+Tambem e possivel configurar provedores pela propria aplicacao depois que ela estiver rodando. Nesse caso, a configuracao fica salva no MongoDB.
+
+`providers.milvus`: opcional para RAG com Milvus/Zilliz. Milvus local via Docker pode rodar sem token. Milvus remoto normalmente precisa de `token` ou `username/password`.
 
 ```json
 {
-  "server": {
-    "port": 3334,
-    "publicUrl": "http://localhost:3334"
+  "providers": {
+    "milvus": {
+      "address": "",
+      "token": "",
+      "collectionName": "canvas_flow_docs"
+    }
   }
 }
 ```
 
-Tambem da para usar outro arquivo:
+`providers.azureSearch` e `providers.azureBlob`: opcionais para RAG/arquivos usando Azure AI Search e Azure Blob.
 
-```bash
-npx @igoruehara/canvas-flow@latest --config C:\canvas-flow\config.json --open
-```
+`files`: opcional. Por padrao usa armazenamento local em `./tmp/canvas-flow-documents`. Configure S3 apenas se quiser arquivos em bucket.
+
+`sqs`: opcional. Ative apenas se quiser filas AWS SQS para transicoes assincronas.
+
+`rateLimit`, `httpBatch` e `agentOps`: opcionais. Ajustam limites de API, timeouts de chamadas HTTP em lote e historico/trace operacional.
 
-Nao publique `config.json`: ele contem tokens e secrets gerados.
+`runtime` e `aws`: opcionais. Ajustam timezone, execucao de cron, limites do runtime e regiao AWS.
 
 ## Validar
 
@@ -137,16 +205,3 @@ Opcional:
 npm i -g @igoruehara/canvas-flow
 canvas-flow --with-docker --open
 ```
-
-## Mantenedores
-
-O pacote e gerado a partir dos apps reais:
-
-```bash
-cd npm_canvas_flow
-npm run bundle
-npm run pack:local
-```
-
-`npm run bundle` builda `frontend/`, builda `backend/` e copia os artefatos para
-`npm_canvas_flow/public` e `npm_canvas_flow/server`.

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@igoruehara/canvas-flow",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Standalone npm launcher for Canvas Flow multi-agent GenAI workflows.",
+  "keywords": [
+    "IA",
+    "LLM",
+    "OPENAI",
+    "Claude",
+    "NLP"
+  ],
   "license": "MIT",
   "type": "commonjs",
   "bin": {