plazbot-cli 0.3.7 → 0.4.1

package/dist/utils/open-browser.js

@@ -0,0 +1,17 @@
+import { spawn } from 'node:child_process';
+/** Abre una URL en el navegador del sistema. Devuelve false si no se pudo (p.ej. servidor sin GUI). */
+export function openBrowser(url) {
+    try {
+        const [cmd, args] = process.platform === 'darwin' ? ['open', [url]] :
+            // En cmd.exe "&" separa comandos: se escapa con ^
+            process.platform === 'win32' ? ['cmd', ['/c', 'start', '', url.replace(/&/g, '^&')]] :
+                ['xdg-open', [url]];
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+        child.on('error', () => { });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "plazbot-cli",
-  "version": "0.3.7",
-  "description": "CLI para Plazbot SDK",
+  "version": "0.4.1",
+  "description": "CLI oficial de Plazbot: WhatsApp for Developers, agentes IA y workers desde tu terminal",
   "type": "module",
   "main": "dist/cli.js",
   "bin": {
     "plazbot": "dist/cli.js"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc && mkdir -p dist/schemas && cp src/schemas/*.json dist/schemas/ && chmod +x dist/cli.js",
     "start": "node dist/cli.js",
@@ -23,12 +27,15 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tu-usuario/plazbot-cli.git"
+    "url": "git+https://github.com/plazbot/Plazbot-CLI-v2.0.git"
   },
   "keywords": [
     "plazbot",
     "cli",
-    "sdk"
+    "sdk",
+    "whatsapp",
+    "whatsapp-api",
+    "ai-agents"
   ],
   "author": "Kristian Garcia <kristian@plazbot.com>",
   "license": "MIT",
@@ -52,7 +59,7 @@
     "marked": "^12.0.2",
     "marked-terminal": "^7.2.1",
     "ora": "^8.0.1",
-    "plazbot": "^2.1.4",
+    "plazbot": "^2.2.0",
     "react": "^18.3.1",
     "zustand": "^4.5.4"
   },
@@ -64,5 +71,6 @@
   },
   "engines": {
     "node": ">=18.17.0"
-  }
+  },
+  "homepage": "https://developers.plazbot.com/cli"
 }

package/.claude/settings.local.json

@@ -1,19 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(tree:*)",
-      "Bash(wc:*)",
-      "Bash(git -C /Users/kristian/Source/plazbot-v2/Plazbot-CLI-v2.0 log --oneline -10)",
-      "Bash(grep:*)",
-      "Bash(npm install:*)",
-      "Bash(npm run build:*)",
-      "Bash(node /Users/kristian/Source/plazbot-v2/Plazbot-CLI-v2.0/dist/cli.js:*)",
-      "Bash(npm ls:*)",
-      "Bash(python3:*)",
-      "WebFetch(domain:www.plazbot.com)",
-      "Bash(npx tsc:*)",
-      "Bash(ls:*)",
-      "Bash(xargs:*)"
-    ]
-  }
-}

package/CLAUDE.md

@@ -1,121 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Descripción del Proyecto
-
-Plazbot CLI v2.0 es una interfaz de línea de comandos oficial para la plataforma Plazbot. Permite gestionar agentes de IA, portales web y comunicaciones vía WhatsApp desde la terminal.
-
-- **Lenguaje**: TypeScript 5.0+
-- **Runtime**: Node.js >=18.17.0 (ESM)
-- **Framework CLI**: Commander.js
-- **TUI**: Ink v5 + React 18 + zustand (solo para `plazbot studio`)
-
-## Comandos de Desarrollo
-
-```bash
-# Compilar TypeScript
-npm run build
-
-# Modo watch (compilación continua)
-npm run dev
-
-# Ejecutar CLI localmente
-npm start
-# o directamente:
-node dist/cli.js
-
-# Versionado
-npm run version:patch   # Incrementar patch
-npm run version:minor   # Incrementar minor
-npm run version:major   # Incrementar major
-
-# SDK local vs npm
-npm run prepare:dev     # Usar SDK local (desarrollo)
-npm run prepare:prod    # Usar SDK de npm
-
-# Publicación
-npm run publish:beta    # Publicar beta
-npm run publish:prod    # Publicar producción
-```
-
-## Arquitectura
-
-```
-src/
-├── cli.ts                 # Entry point - registra todos los comandos
-├── commands/              # Comandos organizados por dominio
-│   ├── agent/             # CRUD + chat interactivo de agentes
-│   ├── auth/              # init (login) y logout
-│   ├── portal/            # CRUD + gestión de enlaces
-│   ├── whatsapp/          # Mensajes y webhooks
-│   └── workers/           # Tools, syncs, schedules, webhooks
-├── studio/                # REPL interactivo (Ink + SSE)
-│   ├── index.ts           # studioCommand + subcomando ask
-│   ├── runRepl.tsx        # Bootstrap Ink render(<App/>)
-│   ├── runOneShot.ts      # Modo no interactivo (stdout)
-│   ├── api/               # types, studioApi, sseClient (fetch + ReadableStream)
-│   ├── state/store.ts     # zustand: messages, steps, agentConfig, usage
-│   ├── slash/             # parser, registry, handlers (/help, /clear, /agents…)
-│   ├── render/            # markdown (marked-terminal), steps, json
-│   └── components/        # App, Header, ChatLog, Message, ToolCall, Input…
-├── types/                 # Interfaces TypeScript
-└── utils/
-    ├── logger.ts          # Logging formateado (info, success, warning, error)
-    ├── api.ts             # axios con Authorization Bearer + x-workspace-id
-    └── credentials.ts     # Persistencia en ~/.plazbot/config.json
-```
-
-### Studio (REPL interactivo)
-
-`plazbot studio` abre una TUI estilo Claude Code que consume el endpoint SSE
-`POST /api/agent/studio`. Permite crear, cargar, diagnosticar y guardar agentes
-en conversación natural. Las tool_calls se renderizan como cards con spinner;
-el `agentConfig` aparece en un panel lateral con tabs preview/json/diagnose.
-
-- `plazbot studio` → REPL completo (Ink)
-- `plazbot studio -m "..."` o `plazbot studio ask "..."` → one-shot a stdout
-- `plazbot studio ask "..." --json` → NDJSON crudo de los chunks SSE
-
-Atajos: `Tab` panel · `Esc` cancelar stream · `Ctrl+C` salir.
-
-### Flujo de Comandos
-
-1. `cli.ts` usa Commander.js para registrar grupos de comandos
-2. Cada comando carga credenciales de `~/.plazbot/config.json`
-3. Instancia el SDK (`plazbot`) con las credenciales
-4. Ejecuta la operación contra el backend de Plazbot
-5. Formatea la respuesta usando `logger.ts`
-
-### SDK de Plazbot
-
-El CLI depende del paquete `plazbot` que expone tres clases principales:
-- **Agent** - Operaciones con agentes de IA
-- **Portal** - Gestión de portales web
-- **Message** - Envío de mensajes WhatsApp
-
-### Credenciales
-
-Se almacenan en `~/.plazbot/config.json`:
-```json
-{
-  "email": "string (opcional)",
-  "apiKey": "string (JWT)",
-  "workspace": "string",
-  "zone": "LA | EU",
-  "userId": "string (opcional, usado por studio como x-user-id)"
-}
-```
-
-El `apiKey` es un JWT válido. El CLI lo envía como `Authorization: Bearer <jwt>`
-y mantiene transitoriamente `x-api-key` para endpoints legacy.
-
-### Flag --dev
-
-Todos los comandos soportan `--dev` para apuntar al backend local (`http://localhost:5090`).
-
-## Convenciones
-
-- Cada grupo de comandos tiene un `index.ts` que exporta el comando padre con subcomandos
-- Los tipos de opciones de comando se definen en `src/types/`
-- El logger proporciona formato consistente: `logger.info()`, `logger.success()`, `logger.error()`

package/agent.config.json

@@ -1,21 +0,0 @@
-{
-  "name": "agente-1",
-  "description": "Asistente que ayuda a resolver preguntas de la empresa",
-  "prompt": "Vas a ayudar a las personas a poder resolver sus preguntas de la empresa como informacion de contacto, horarios de atencion, etc. Nuestro horario de atencion es de 9:00 a 18:00 y trabajamos en Peru, España y Colombia.",
-  "zone": "LA",
-  "buffer": 5,
-  "color": "blue",
-  "question": "Como te podemos ayudar?",
-  "timezone": "America/Lima",
-  "showInChat": false,
-  "examples": [
-    { "value": "quiero informacion de contacto", "color": "green" },
-    { "value": "horarios de atencion", "color": "orange" }
-  ],
-  "person": {
-    "name": "Leandro",
-    "role": "Asistente de Atencion al Cliente",
-    "speaksInFirstPerson": true,
-    "isHuman": false
-  }
-}

package/dist/studio/components/AgentPanel.js

@@ -1,35 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text } from 'ink';
-import { useStudioStore } from '../state/store.js';
-import { JsonView, safeStringify } from '../render/json.js';
-export function AgentPanel() {
-    const open = useStudioStore((s) => s.panelOpen);
-    const tab = useStudioStore((s) => s.panelTab);
-    const cfg = useStudioStore((s) => s.agentConfig);
-    if (!open)
-        return null;
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, flexGrow: 1, children: [_jsx(Box, { children: _jsx(Text, { bold: true, color: "green", children: "Agent panel" }) }), _jsxs(Box, { children: [_jsx(Tab, { active: tab === 'preview', children: "preview" }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsx(Tab, { active: tab === 'json', children: "json" }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsx(Tab, { active: tab === 'diagnose', children: "diagnose" })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: renderTab(tab, cfg) })] }));
-}
-function Tab({ active, children }) {
-    return active ? _jsx(Text, { color: "cyan", bold: true, children: children }) : _jsx(Text, { dimColor: true, children: children });
-}
-function renderTab(tab, cfg) {
-    if (!cfg) {
-        return _jsx(Text, { dimColor: true, children: "No agent loaded yet." });
-    }
-    if (tab === 'json') {
-        return _jsx(JsonView, { value: cfg });
-    }
-    if (tab === 'diagnose') {
-        return _jsx(Text, { dimColor: true, children: "Run `/diagnose` to analyze the current agent." });
-    }
-    // preview: key agent fields
-    const c = cfg;
-    const name = c?.name ?? '(unnamed)';
-    const description = c?.description ?? '';
-    const model = c?.model ?? c?.modelId ?? '';
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Name: " }), _jsx(Text, { children: name })] }), model ? _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Model: " }), _jsx(Text, { children: model })] }) : null, description ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, children: "Description:" }), _jsx(Text, { children: description })] })) : null, _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: truncate(safeStringify(c), 400) }) })] }));
-}
-function truncate(s, n) {
-    return s.length > n ? s.slice(0, n) + '…' : s;
-}

package/dist/studio/render/json.js

@@ -1,16 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Box } from 'ink';
-import SyntaxHighlight from 'ink-syntax-highlight';
-export function JsonView({ value, maxHeight }) {
-    const text = safeStringify(value);
-    return (_jsx(Box, { flexDirection: "column", height: maxHeight, children: _jsx(SyntaxHighlight, { code: text, language: "json" }) }));
-}
-function safeStringify(v) {
-    try {
-        return JSON.stringify(v, null, 2);
-    }
-    catch {
-        return String(v);
-    }
-}
-export { safeStringify };

package/dist/studio/whatsapp/api.js

@@ -1,63 +0,0 @@
-import { getBaseUrl } from '../api/studioApi.js';
-function headers(opts) {
-    const h = {
-        'Content-Type': 'application/json',
-        Authorization: `Bearer ${opts.apiKey}`,
-        'x-workspace-id': opts.workspaceId,
-    };
-    if (opts.userId)
-        h['x-user-id'] = opts.userId;
-    return h;
-}
-/**
- * GET /api/workspace/{workspaceId} — the API returns an array of workspaces
- * (the front uses `[0]`). Returns the first element or null.
- */
-export async function getWorkspaceById(opts, signal) {
-    const url = `${getBaseUrl(opts.zone, opts.dev)}/api/workspace/${encodeURIComponent(opts.workspaceId)}`;
-    const res = await fetch(url, { method: 'GET', headers: headers(opts), signal });
-    if (!res.ok) {
-        throw new Error(`GET workspace ${res.status} ${res.statusText}`);
-    }
-    const json = (await res.json());
-    if (!json)
-        return null;
-    if (Array.isArray(json))
-        return json[0] ?? null;
-    return json;
-}
-/**
- * POST /api/workspace/{workspaceId}/integrations/{integrationId}/activate
- * Body: { isActive: true, platformCode: "whatsapp" }
- */
-export async function activateIntegration(opts, integrationId, signal) {
-    const url = `${getBaseUrl(opts.zone, opts.dev)}/api/workspace/${encodeURIComponent(opts.workspaceId)}/integrations/${encodeURIComponent(integrationId)}/activate`;
-    const res = await fetch(url, {
-        method: 'POST',
-        headers: headers(opts),
-        body: JSON.stringify({ isActive: true, platformCode: 'whatsapp' }),
-        signal,
-    });
-    const text = await res.text();
-    let parsed = {};
-    if (text) {
-        try {
-            parsed = JSON.parse(text);
-        }
-        catch { /* not json */ }
-    }
-    if (!res.ok) {
-        return { success: false, message: parsed.message || `HTTP ${res.status} ${res.statusText}` };
-    }
-    return parsed.success === false ? parsed : { success: true, ...parsed };
-}
-/** Adapter: derives the workspace fetch options from a StudioStreamOptions. */
-export function workspaceOptsFromStream(stream) {
-    return {
-        apiKey: stream.apiKey,
-        workspaceId: stream.workspaceId,
-        zone: stream.zone,
-        dev: stream.dev,
-        userId: stream.userId,
-    };
-}

package/dist/studio/whatsapp/polling.js

@@ -1,77 +0,0 @@
-import { activateIntegration, getWorkspaceById } from './api.js';
-import { findNewWhatsappIntegration, WA_POLL_INTERVAL_MS, WA_POLL_MAX_ATTEMPTS, } from './types.js';
-/**
- * Starts the polling loop. Returns a handle to cancel it. The loop:
- * 1. GETs the workspace every WA_POLL_INTERVAL_MS up to WA_POLL_MAX_ATTEMPTS.
- * 2. Looks for a whatsapp integration whose id isn't in `existingIntegrationIds`.
- * 3. When found, calls POST .../activate and reports the result.
- */
-export function startWhatsappPolling(opts, linkData, cb) {
-    const knownIds = new Set(linkData.existingIntegrationIds ?? []);
-    const controller = new AbortController();
-    let attempts = 0;
-    let busy = false;
-    let stopped = false;
-    let timer = null;
-    const stop = () => {
-        stopped = true;
-        if (timer) {
-            clearInterval(timer);
-            timer = null;
-        }
-        controller.abort();
-    };
-    const tick = async () => {
-        if (busy || stopped)
-            return;
-        busy = true;
-        attempts++;
-        cb.onAttempt(attempts);
-        try {
-            const ws = await getWorkspaceById(opts, controller.signal);
-            const newIntegration = findNewWhatsappIntegration(ws?.integrations, knownIds);
-            if (newIntegration?.id) {
-                const number = newIntegration.cellphoneNumberFormat ||
-                    newIntegration.cellphoneNumber ||
-                    '';
-                cb.onActivating(newIntegration.id, number);
-                if (timer) {
-                    clearInterval(timer);
-                    timer = null;
-                }
-                const res = await activateIntegration(opts, newIntegration.id, controller.signal);
-                if (res.success !== false) {
-                    cb.onConnected(number);
-                }
-                else {
-                    cb.onError(res.message || 'Could not activate the integration.');
-                }
-                stopped = true;
-                return;
-            }
-        }
-        catch (err) {
-            if (err.name === 'AbortError')
-                return;
-            // Transient network errors: swallow and keep polling.
-        }
-        finally {
-            busy = false;
-        }
-        if (attempts >= WA_POLL_MAX_ATTEMPTS) {
-            if (timer) {
-                clearInterval(timer);
-                timer = null;
-            }
-            stopped = true;
-            cb.onTimeout();
-        }
-    };
-    timer = setInterval(() => { void tick(); }, WA_POLL_INTERVAL_MS);
-    // Trigger the first attempt immediately so the user sees activity right away.
-    void tick();
-    return {
-        cancel() { stop(); },
-        get stopped() { return stopped; },
-    };
-}

package/dist/studio/whatsapp/types.js

@@ -1,31 +0,0 @@
-/**
- * Types and helpers for the "connect WhatsApp from Agent Studio" flow.
- *
- * The backend tool `connect_whatsapp` emits a `tool_result` chunk with
- * `type: "whatsapp_link"`. When `data.shortUrl` is present we render an
- * inline card with the onboarding link and start polling the workspace
- * until the new integration appears. Baseline of "known" ids comes from
- * the server (`existingIntegrationIds`) to avoid race conditions.
- *
- * Mirror of /Plazbot-Front-v2.0/src/modules/agentStudio/whatsappConnect.ts
- */
-export const WA_POLL_INTERVAL_MS = 5000;
-export const WA_POLL_MAX_ATTEMPTS = 60; // 5 minutes
-/**
- * Returns a new whatsapp integration whose id is NOT in the baseline.
- * If multiple are new, picks the most recently created one.
- */
-export function findNewWhatsappIntegration(integrations, knownIds) {
-    if (!integrations?.length)
-        return null;
-    const candidates = integrations.filter((i) => (i.type === 'whatsapp' || i.type === 'whatsapp_business') &&
-        !!i.id &&
-        !knownIds.has(i.id));
-    if (!candidates.length)
-        return null;
-    return candidates.reduce((latest, current) => {
-        const a = latest.creationDate ? new Date(latest.creationDate).getTime() : 0;
-        const b = current.creationDate ? new Date(current.creationDate).getTime() : 0;
-        return b > a ? current : latest;
-    });
-}

package/src/cli.ts

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-import { program } from 'commander';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import { portalCommands } from './commands/portal/index.js';
-import { authCommands } from './commands/auth/index.js';
-import { agentCommands } from './commands/agent/index.js';
-import { whatsappCommands } from './commands/whatsapp/index.js';
-import { workersCommands } from './commands/workers/index.js';
-import { studioCommand } from './studio/index.js';
-import { showBanner } from './utils/banner.js';
-
-// Guard de runtime: Plazbot CLI v0.3+ requiere Node 18.17+
-const [major, minor] = process.versions.node.split('.').map(Number);
-if (major < 18 || (major === 18 && minor < 17)) {
-  console.error(`Plazbot CLI v0.3+ requires Node.js >=18.17.0. Current version: ${process.versions.node}`);
-  process.exit(1);
-}
-
-// Leer version desde package.json
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkgPath = join(__dirname, '..', 'package.json');
-const { version } = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-
-// Configuracion basica del CLI
-program
-  .name('plazbot')
-  .description('Official Plazbot CLI - AI agents for WhatsApp, portals and developers')
-  .version(version);
-
-// Registrar todos los comandos de autenticacion
-authCommands.forEach(cmd => program.addCommand(cmd));
-
-// Registrar todos los comandos de agente
-program.addCommand(agentCommands);
-
-// Registrar todos los comandos de portal
-program.addCommand(portalCommands);
-
-// Registrar todos los comandos de WhatsApp
-program.addCommand(whatsappCommands);
-
-// Registrar todos los comandos de Workers
-program.addCommand(workersCommands);
-
-// Registrar el comando Studio (REPL interactivo)
-program.addCommand(studioCommand);
-
-// Si no se pasan argumentos, mostrar banner
-if (process.argv.length <= 2) {
-  showBanner().then(() => {
-    program.outputHelp();
-  });
-} else {
-  program.parse(process.argv);
-}