plazbot-cli 0.2.26 → 0.3.2

package/dist/schemas/agent.config.schema.json

@@ -0,0 +1,569 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "AgentConfig",
+  "type": "object",
+  "required": ["name", "prompt", "zone", "buffer"],
+  "properties": {
+    "name": { "type": "string" },
+    "description": { "type": "string" },
+    "prompt": { "type": "string" },
+    "zone": {
+      "type": "string",
+      "enum": ["LA", "EU"]
+    },
+    "timezone": {
+      "type": "string",
+      "description": "IANA timezone string, e.g., 'America/Lima', 'Europe/Madrid'"
+    },
+    "buffer": {
+      "type": "integer",
+      "minimum": 3,
+      "maximum": 20
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^v\\d+\\.\\d+$",
+      "description": "Version del agente (auto-incrementado). Formato: v2.0, v2.1, etc."
+    },
+    "color": {
+      "type": "string",
+      "enum": ["orange", "blue", "green", "gray", "white"]
+    },
+    "question": { "type": "string" },
+    "enable": { "type": "boolean" },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "instructions": {
+      "type": "object",
+      "properties": {
+        "tone": { "type": "string" },
+        "style": { "type": "string" },
+        "personality": { "type": "string" },
+        "objective": { "type": "string" },
+        "language": { "type": "string" },
+        "emojis": { "type": "boolean" },
+        "preferredFormat": { "type": "string" },
+        "maxWords": { "type": "integer" },
+        "avoidTopics": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "respondOnlyIfKnows": { "type": "boolean" },
+        "maintainToneBetweenMessages": { "type": "boolean" },
+        "greeting": { "type": "string" }
+      }
+    },
+    "person": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "role": { "type": "string" },
+        "speaksInFirstPerson": { "type": "boolean" },
+        "isHuman": { "type": "boolean" }
+      }
+    },
+    "fallbacks": {
+      "type": "object",
+      "properties": {
+        "noAnswer": { "type": "string" },
+        "serviceError": { "type": "string" },
+        "doNotUnderstand": { "type": "string" }
+      }
+    },
+    "rules": {
+      "type": "object",
+      "properties": {
+        "doNotMentionPrices": { "type": "boolean" },
+        "doNotDiagnose": { "type": "boolean" },
+        "doNotRespondOutsideHours": { "type": "string" }
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["value", "color"],
+        "properties": {
+          "value": { "type": "string" },
+          "color": {
+            "type": "string",
+            "enum": ["orange", "blue", "green", "gray", "white"]
+          }
+        }
+      }
+    },
+    "showInChat": { "type": "boolean" },
+    "enableWidget": { "type": "boolean" },
+    "enableWhatsappWidget": { "type": "boolean" },
+    "urlWhatsappWidget": { "type": "string" },
+    "formWidget": { "type": "boolean" },
+    "darkWidget": { "type": "boolean" },
+    "colorWidget": {
+      "type": ["string", "null"],
+      "enum": ["white", "dark", "green", "blue", "gray", null],
+      "description": "Tema visual del widget. Tiene prioridad sobre darkWidget cuando esta definido."
+    },
+    "nameWidget": { "type": "string" },
+    "initialShowWidget": { "type": "boolean" },
+    "initialViewWidget": {
+      "type": ["string", "null"],
+      "enum": ["home", "chat", "avatar", null],
+      "description": "Vista inicial al abrir el widget manualmente: home | chat | avatar. Null = home (legacy)."
+    },
+    "fUseAutomationFlowWidget": { "type": "boolean" },
+    "iconWidget": {
+      "type": "string",
+      "enum": ["robot", "message", "support", "qa", "chat", "smile", "voice", "uservoice"],
+      "default": "robot"
+    },
+    "typeWidget": {
+      "type": "string",
+      "enum": ["widget", "search"],
+      "default": "widget",
+      "description": "Tipo de widget: widget (chat lateral clasico) o search (buscador centrado tipo Spotlight)"
+    },
+    "positionWidget": {
+      "type": "string",
+      "enum": ["down", "center"],
+      "default": "down",
+      "description": "Posicion del widget al abrirse: down (abajo-derecha clasico) o center (centrado en pantalla). Solo aplica en desktop (>=768px). En mobile siempre es fullscreen."
+    },
+    "enablePoweredBy": {
+      "type": "boolean",
+      "default": false,
+      "description": "Mostrar 'Powered by Plazbot' en el footer del widget. Solo editable desde AgentTraining para companies plazbot/plazbot-eu/plazbot-developer/plazbot-sandbox."
+    },
+    "multianswerWidget": {
+      "type": "boolean",
+      "default": false,
+      "description": "Si true, divide la respuesta del agente IA en varios mensajes (split por doble salto de linea)."
+    },
+    "enableAvatarWidget": { "type": "boolean" },
+    "avatarGender": {
+      "type": "string",
+      "enum": ["male", "female"],
+      "description": "DEPRECATED: legacy Simli. HeyGen no lo usa (el genero es inherente al avatarFaceId). Se mantiene por retrocompatibilidad."
+    },
+    "avatarVoiceId": {
+      "type": "string",
+      "description": "HeyGen voice_id (Multilingual). Usa 'default' o vacio para que HeyGen aplique la voz nativa del avatar."
+    },
+    "avatarLanguage": {
+      "type": "string",
+      "description": "Codigo ISO corto HeyGen: es | en | pt | fr | it | de"
+    },
+    "avatarFaceId": {
+      "type": "string",
+      "description": "HeyGen avatar_id (ej: 'Annie_expressive12_public'). Nombre legacy heredado de Simli."
+    },
+    "avatarApiKey": {
+      "type": "string",
+      "description": "API Key personal de HeyGen del cliente (BYOK). Texto plano en CosmosDB."
+    },
+    "avatarQuality": {
+      "type": "string",
+      "enum": ["low", "medium", "high"],
+      "default": "medium",
+      "description": "Calidad del streaming HeyGen. A mayor calidad mayor consumo de creditos."
+    },
+    "avatarBackground": {
+      "type": ["string", "null"],
+      "description": "URL de imagen de fondo personalizada para el avatar (S3). Si tiene valor, el backend usa el avatar con fondo verde y el widget aplica chroma key."
+    },
+    "voiceConfig": {
+      "type": "object",
+      "description": "Voice agent configuration for phone calls",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "phoneNumber": { "type": "string", "description": "DID phone number, e.g., +573151234567" },
+        "ttsProvider": { "type": "string", "enum": ["google", "openai"] },
+        "ttsVoiceId": { "type": "string", "description": "TTS voice ID, e.g., nova, es-US-Journey-D" },
+        "ttsLanguage": { "type": "string", "description": "Language code, e.g., es-CO, es-MX" },
+        "greeting": { "type": "string", "description": "Initial greeting message for TTS" },
+        "maxCallDurationSeconds": { "type": "integer", "minimum": 60, "maximum": 1800, "default": 300 },
+        "silenceTimeoutMs": { "type": "integer", "minimum": 2000, "maximum": 15000, "default": 5000 },
+        "transferExtension": { "type": "string", "description": "SIP extension for human transfer" },
+        "voiceType": { "type": "string", "enum": ["compact", "complete"], "description": "compact=fast no tools, complete=full toolcalling+RAG" }
+      }
+    },
+    "useToolCalling": {
+      "type": "boolean",
+      "default": false,
+      "description": "If true, uses the Tool Calling orchestrator for more natural conversations. If false, uses the classic orchestrator."
+    },
+    "enableWebSearch": {
+      "type": "boolean",
+      "default": false,
+      "description": "If true, the agent can search the web using the provider's native tool (OpenAI web_search_preview, Claude web_search_20250305, Gemini google_search). No extra API key required."
+    },
+    "responseMode": {
+      "type": "string",
+      "enum": ["direct", "batched"],
+      "default": "direct",
+      "description": "Modo de respuesta: direct (inmediato) o batched (espera mensajes consecutivos)"
+    },
+    "batchWaitSeconds": {
+      "type": "integer",
+      "minimum": 2,
+      "maximum": 10,
+      "default": 3,
+      "description": "Segundos de espera para acumular mensajes consecutivos (solo si responseMode=batched)"
+    },
+    "customAIConfig": {
+      "type": "boolean",
+      "default": false,
+      "description": "If true, uses aiProviders from agent config. If false, uses company.openaiData.openaiToken"
+    },
+    "aiProviders": {
+      "type": "array",
+      "description": "Custom AI provider configurations. Only used when customAIConfig is true",
+      "items": {
+        "type": "object",
+        "required": ["provider", "model", "apiToken"],
+        "properties": {
+          "provider": { 
+            "type": "string",
+            "enum": ["openai", "claude", "gemini"],
+            "description": "AI provider: openai, claude (Anthropic), or gemini (Google)"
+          },
+          "model": { 
+            "type": "string",
+            "description": "Specific model name: 'gpt-5.4', 'gpt-4o', 'claude-sonnet-4-6', 'claude-opus-4-6', 'gemini-2.5-pro', 'gemini-2.5-flash'"
+          },
+          "apiToken": { 
+            "type": "string",
+            "description": "API token for the provider"
+          },
+          "temperature": { 
+            "type": "number",
+            "minimum": 0,
+            "maximum": 2,
+            "default": 0.7,
+            "description": "Controls randomness in responses (0-2)"
+          },
+          "maxTokens": { 
+            "type": "integer",
+            "minimum": 1,
+            "description": "Maximum tokens in response"
+          },
+          "isDefault": {
+            "type": "boolean",
+            "default": false,
+            "description": "If multiple providers exist, which one to use by default"
+          }
+        }
+      }
+    },
+    "channels": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["channel", "key"],
+        "properties": {
+          "channel": { "type": "string" },
+          "key": { "type": "string" },
+          "multianswer": { "type": "boolean", "default": false }
+        }
+      }
+    },
+    "services": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["intent", "reference", "method", "endpoint", "requiredFields"],
+        "properties": {
+          "intent": { "type": "string" },
+          "reference": { "type": "string" },
+          "enabled": { "type": "boolean", "default": true },
+          "method": { "type": "string", "enum": ["GET", "POST"] },
+          "tags": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "endpoint": { "type": "string", "format": "uri" },
+          "requiredFields": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "promptHint": {
+                  "type": "string"
+                },
+                "type": {
+                  "type": "string",
+                  "enum": ["string", "number", "integer", "boolean", "date", "datetime", "email", "phone", "array", "arrayObject"]
+                },
+                "properties": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": { "type": "string" },
+                      "type": { "type": "string" }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "headers": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          },
+          "bodyTemplate": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          },
+          "bodySchema": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "enum": ["string", "date", "boolean", "numeric"]
+            }
+          },
+          "responseMapping": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          },
+          "responseMessage": {
+            "type": "string"
+          },
+          "responseConditions": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "condition": {
+                  "type": "string",
+                  "description": "Condicion simple legacy (retrocompatible). Usar 'conditions' para AND/OR."
+                },
+                "conditions": {
+                  "type": "array",
+                  "description": "Sub-condiciones para combinar con AND/OR",
+                  "items": {
+                    "type": "object",
+                    "required": ["condition"],
+                    "properties": {
+                      "condition": {
+                        "type": "string",
+                        "description": "Expresion condicional usando JSONPath y operadores (==, !=, <, >, <=, >=, in, nin)"
+                      }
+                    }
+                  }
+                },
+                "logicalOperator": {
+                  "type": "string",
+                  "enum": ["AND", "OR"],
+                  "default": "AND",
+                  "description": "Operador logico para combinar sub-condiciones. Default: AND"
+                },
+                "message": {
+                  "type": "string",
+                  "description": "Mensaje a mostrar si la condicion se cumple"
+                },
+                "nextService": {
+                  "type": "string",
+                  "description": "Intent del siguiente servicio a activar automaticamente si se cumple la condicion"
+                }
+              }
+            }
+          },
+          "action": { "type": "string" }
+        }
+      }
+    },
+    "variables": {
+      "type": "array",
+      "description": "Variables personalizadas del agente con valores por defecto",
+      "items": {
+        "type": "object",
+        "required": ["code", "name", "type"],
+        "properties": {
+          "code": { "type": "string", "description": "Codigo unico de la variable (alfanumerico + underscore)" },
+          "name": { "type": "string", "description": "Nombre legible de la variable" },
+          "type": { "type": "string", "enum": ["string", "number", "boolean"], "description": "Tipo de dato" },
+          "defaultValue": { "type": "string", "description": "Valor por defecto si no se envia en on-message" },
+          "description": { "type": "string", "description": "Descripcion de para que se usa la variable" }
+        }
+      }
+    },
+    "source": {
+      "type": ["object", "null"],
+      "description": "Configuracion de Fuente de Datos del agente (Plazbot nativo o Google Sheets). El LLM consulta esta fuente cuando necesita responder con catalogos/stock/etc.",
+      "properties": {
+        "enabled": { "type": "boolean", "default": false },
+        "reference": {
+          "type": "string",
+          "description": "Descripcion que lee el LLM para decidir cuando consultar la fuente"
+        },
+        "sourceType": {
+          "type": ["string", "null"],
+          "enum": ["plazbot", "googlesheets", null],
+          "description": "Tipo de fuente: plazbot (nativa Supabase) o googlesheets"
+        },
+        "businessType": {
+          "type": ["string", "null"],
+          "enum": [
+            "products", "services", "menu", "real_estate", "courses",
+            "vehicles", "hospitality", "healthcare", "events", "parts",
+            "custom", null
+          ],
+          "description": "Tipo de negocio para sugerir mapeo semantico"
+        },
+        "columnMapping": {
+          "type": ["object", "null"],
+          "additionalProperties": { "type": "string" },
+          "description": "Mapeo clave=nombre semantico -> valor=key real de la columna"
+        },
+        "plazbotSource": {
+          "type": ["object", "null"],
+          "properties": {
+            "sourceId": { "type": ["string", "null"] }
+          }
+        },
+        "googleSheets": {
+          "type": ["object", "null"],
+          "properties": {
+            "integrationId": { "type": ["string", "null"] },
+            "spreadsheetId": { "type": ["string", "null"] },
+            "sheetName": { "type": ["string", "null"] },
+            "sheetId": { "type": ["integer", "null"] },
+            "detectedColumns": {
+              "type": ["array", "null"],
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "actions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["intent", "reference", "enabled", "action"],
+        "properties": {
+          "intent": { "type": "string" },
+          "reference": { "type": "string" },
+          "tags": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "enabled": { "type": "boolean" },
+          "requiredFields": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "promptHint": {
+                  "type": "string"
+                },
+                "type": {
+                  "type": "string",
+                  "enum": ["string", "number", "integer", "boolean", "date", "datetime", "email", "phone", "array", "arrayObject"]
+                },
+                "properties": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": { "type": "string" },
+                      "type": { "type": "string" }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "responseMessage": { "type": "string" },
+          "responseJson": { "type": "boolean" },
+          "responseExact": { "type": "boolean" },
+          "action": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["type", "value"],
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "action.asign",
+                    "action.stage",
+                    "action.agentShutDown",
+                    "action.segmentation",
+                    "action.tag",
+                    "action.solved",
+                    "action.event.add",
+                    "action.event.update",
+                    "action.event.delete",
+                    "action.event.list",
+                    "action.event.confirm",
+                    "action.event.cancel",
+                    "action.secuence",
+                    "action.unassign",
+                    "action.stage.remove",
+                    "action.tag.remove",
+                    "action.segmentation.remove",
+                    "action.worker"
+                  ]
+                },
+                "value": { "type": "string" },
+                "durationMinutes": {
+                  "type": "integer",
+                  "minimum": 5,
+                  "maximum": 480,
+                  "default": 30,
+                  "description": "Duracion del evento en minutos (solo para action.event.add/update). Default: 30"
+                },
+                "availabilitySchedule": {
+                  "type": "object",
+                  "description": "Horario personalizado para disponibilidad de citas (solo action.event.add). Si no se configura o useWorkspaceSchedule=true, usa el horario del workspace.",
+                  "properties": {
+                    "useWorkspaceSchedule": { "type": "boolean", "default": true },
+                    "days": {
+                      "type": "array",
+                      "maxItems": 7,
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "enabled": { "type": "boolean" },
+                          "allDay": { "type": "boolean" },
+                          "from": { "type": "string" },
+                          "to": { "type": "string" },
+                          "ranges": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "from": { "type": "string" },
+                                "to": { "type": "string" }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/studio/api/sseClient.js

@@ -0,0 +1,97 @@
+import { buildStudioUrl, buildStudioHeaders } from './studioApi.js';
+import { StudioHttpError } from './types.js';
+/**
+ * Cliente SSE para POST /api/agent/studio.
+ * - Usa fetch() global (Node >=18) y lee `res.body` como ReadableStream.
+ * - Parsea líneas con prefijo `data:` y emite cada JSON como un StudioChunk.
+ * - Soporta cancelación via AbortSignal (tecla Esc en el REPL).
+ */
+export async function streamStudio(opts, request, onChunk, signal) {
+    const url = buildStudioUrl(opts.zone, opts.dev);
+    const headers = buildStudioHeaders(opts);
+    const body = {
+        ...request,
+        workspaceId: request.workspaceId ?? opts.workspaceId,
+        userId: request.userId ?? opts.userId,
+    };
+    let res;
+    try {
+        res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal,
+        });
+    }
+    catch (err) {
+        if (err.name === 'AbortError')
+            return;
+        throw err;
+    }
+    if (!res.ok) {
+        const text = await safeReadText(res);
+        throw new StudioHttpError(res.status, res.statusText, text);
+    }
+    if (!res.body) {
+        throw new Error('Respuesta sin body en POST /api/agent/studio');
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            // SSE: eventos separados por \n\n; cada evento puede tener varias líneas.
+            let idx;
+            while ((idx = buffer.indexOf('\n')) >= 0) {
+                const line = buffer.slice(0, idx).replace(/\r$/, '');
+                buffer = buffer.slice(idx + 1);
+                if (!line.startsWith('data:'))
+                    continue;
+                const payload = line.slice(5).trim();
+                if (!payload)
+                    continue;
+                try {
+                    const parsed = JSON.parse(payload);
+                    onChunk(parsed);
+                }
+                catch {
+                    // Línea malformada: la ignoramos silenciosamente.
+                }
+            }
+        }
+        // Flush final
+        const tail = buffer.trim();
+        if (tail.startsWith('data:')) {
+            const payload = tail.slice(5).trim();
+            if (payload) {
+                try {
+                    onChunk(JSON.parse(payload));
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    catch (err) {
+        if (err.name === 'AbortError')
+            return;
+        throw err;
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch { /* noop */ }
+    }
+}
+async function safeReadText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}