plazbot-cli 0.3.6 → 0.4.0

package/src/studio/connect/types.ts

@@ -1,141 +0,0 @@
-/**
- * Tipos y helpers del flujo "Conectar canal desde Agent Studio".
- *
- * El backend emite `tool_result` con `type` = `whatsapp_link` |
- * `instagram_link` | `messenger_link` segun la tool invocada. Todos comparten
- * el mismo shape de datos (link corto + expiracion + baseline de integraciones)
- * y el mismo patron de polling (GET workspace cada 5s hasta detectar el nuevo
- * id) y activacion (POST .../activate).
- *
- * Este modulo es la version generalizada de lo que antes vivia en
- * `src/studio/whatsapp/` cuando solo existia WhatsApp.
- */
-
-export type ConnectChannel = 'whatsapp' | 'instagram' | 'messenger';
-
-/** Mapea el `type` del tool_result al canal logico del cliente. */
-export function channelFromToolResultType(type: string | undefined): ConnectChannel | null {
-  if (type === 'whatsapp_link') return 'whatsapp';
-  if (type === 'instagram_link') return 'instagram';
-  if (type === 'messenger_link') return 'messenger';
-  return null;
-}
-
-/** Tipos de integracion (workspace.integrations[].type) a vigilar por canal. */
-export function integrationTypesForChannel(channel: ConnectChannel): string[] {
-  switch (channel) {
-    case 'whatsapp':  return ['whatsapp', 'whatsapp_business'];
-    case 'instagram': return ['instagram'];
-    case 'messenger': return ['facebook']; // Messenger se guarda como type=facebook
-  }
-}
-
-/**
- * `platformCode` que espera POST .../activate. Para WhatsApp el endpoint usa
- * este valor para una validacion de duplicados; para IG/Messenger no ejecuta
- * ninguna logica especifica pero debe enviarse algo coherente.
- */
-export function platformCodeForChannel(channel: ConnectChannel): string {
-  switch (channel) {
-    case 'whatsapp':  return 'whatsapp';
-    case 'instagram': return 'instagram';
-    case 'messenger': return 'facebook';
-  }
-}
-
-export interface ChannelLinkData {
-  shortUrl?: string | null;
-  /** whatsapp | whatsapp_business | instagram | facebook */
-  linkType?: string;
-  expiresAt?: string;
-  isNewLink?: boolean;
-  alreadyConnected?: boolean;
-  /** Snapshot WhatsApp (legacy, mantenido por compat con la tool de WA). */
-  connectedNumbers?: Array<{ id?: string; number?: string; alias?: string }>;
-  /** Snapshot IG/Messenger (pageId + nombre legible + alias). */
-  connectedItems?: Array<{ id?: string; pageId?: string; name?: string; alias?: string }>;
-  existingIntegrationIds?: string[];
-}
-
-export type ConnectStatus =
-  | 'waiting'      // card visible, polling activo
-  | 'activating'   // integracion detectada, activando via API
-  | 'connected'    // activada con exito
-  | 'timeout'      // intentos agotados
-  | 'cancelled'    // usuario cancelo
-  | 'error';       // activacion fallo
-
-export interface ConnectState {
-  /** Id estable para keys/diffs. */
-  id: string;
-  channel: ConnectChannel;
-  linkData: ChannelLinkData;
-  status: ConnectStatus;
-  /** Mensaje del chat al que ancla la tarjeta. */
-  anchorMessageId: string;
-  /** Etiqueta humana del item conectado (numero, pagina, etc.) — populado en `connected`. */
-  connectedLabel?: string;
-  errorMessage?: string;
-  attempt: number;
-}
-
-/** Shape minimo de un item de `workspace.integrations` que devuelve el GET. */
-export interface WorkspaceIntegrationItem {
-  id?: string;
-  type?: string;
-  /** whatsapp */
-  cellphoneNumber?: string;
-  cellphoneNumberFormat?: string;
-  /** facebook (messenger) */
-  facebookPageId?: string;
-  /** instagram */
-  instagramPageId?: string;
-  /** comun: nombre legible (display name de Meta) */
-  srcName?: string;
-  /** comun: alias humano puesto manualmente */
-  aliasName?: string;
-  creationDate?: string;
-  isActive?: number | boolean;
-}
-
-export const CONNECT_POLL_INTERVAL_MS = 5000;
-export const CONNECT_POLL_MAX_ATTEMPTS = 60; // 5 minutos
-
-/**
- * Devuelve la integracion mas reciente del canal cuyo id NO este en el baseline.
- * Si hay varias nuevas, gana la de `creationDate` mayor.
- */
-export function findNewIntegrationForChannel(
-  channel: ConnectChannel,
-  integrations: WorkspaceIntegrationItem[] | undefined,
-  knownIds: Set<string>,
-): WorkspaceIntegrationItem | null {
-  if (!integrations?.length) return null;
-
-  const types = new Set(integrationTypesForChannel(channel));
-  const candidates = integrations.filter(
-    (i) => !!i.type && types.has(i.type) && !!i.id && !knownIds.has(i.id as string),
-  );
-  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;
-  });
-}
-
-/** Etiqueta humana del item recien conectado (numero, nombre de pagina, etc.). */
-export function describeIntegration(
-  channel: ConnectChannel,
-  i: WorkspaceIntegrationItem,
-): string {
-  switch (channel) {
-    case 'whatsapp':
-      return i.cellphoneNumberFormat || i.cellphoneNumber || i.srcName || '';
-    case 'instagram':
-      return i.srcName || i.aliasName || i.instagramPageId || '';
-    case 'messenger':
-      return i.srcName || i.aliasName || i.facebookPageId || '';
-  }
-}

package/src/studio/index.ts

@@ -1,58 +0,0 @@
-import { Command } from 'commander';
-
-interface StudioCmdOpts {
-  dev: boolean;
-  agentId?: string;
-  message?: string;
-  workspaceId?: string;
-}
-
-interface AskCmdOpts {
-  dev: boolean;
-  agentId?: string;
-  json: boolean;
-  workspaceId?: string;
-}
-
-export const studioCommand = new Command('studio')
-  .description('Interactive Plazbot Studio REPL (create, diagnose and manage AI agents)')
-  .option('--dev', 'Target the local backend (http://localhost:5090)', false)
-  .option('-a, --agent-id <id>', 'Preload an agent on startup')
-  .option('-w, --workspace-id <id>', 'Override the workspace (support / white-label partner mode)')
-  .option('-m, --message <text>', 'Run a one-shot prompt and exit')
-  .action(async (opts: StudioCmdOpts) => {
-    if (opts.message) {
-      const { runOneShot } = await import('./runOneShot.js');
-      await runOneShot({
-        dev: opts.dev,
-        agentId: opts.agentId,
-        message: opts.message,
-        workspaceOverride: opts.workspaceId,
-      });
-      return;
-    }
-    const { runRepl } = await import('./runRepl.js');
-    await runRepl({
-      dev: opts.dev,
-      agentId: opts.agentId,
-      workspaceOverride: opts.workspaceId,
-    });
-  });
-
-studioCommand
-  .command('ask <message>')
-  .description('Run a one-shot studio query without opening the TUI')
-  .option('--dev', 'Target the local backend (http://localhost:5090)', false)
-  .option('-a, --agent-id <id>', 'Agent to use as context')
-  .option('-w, --workspace-id <id>', 'Override the workspace (support / white-label partner mode)')
-  .option('--json', 'Print SSE chunks as raw NDJSON', false)
-  .action(async (message: string, opts: AskCmdOpts) => {
-    const { runOneShot } = await import('./runOneShot.js');
-    await runOneShot({
-      dev: opts.dev,
-      agentId: opts.agentId,
-      message,
-      json: opts.json,
-      workspaceOverride: opts.workspaceId,
-    });
-  });

package/src/studio/render/markdown.ts

@@ -1,93 +0,0 @@
-// @ts-ignore - marked-terminal no provee tipos
-import TerminalRenderer from 'marked-terminal';
-import { marked } from 'marked';
-import chalk from 'chalk';
-// @ts-ignore - cli-highlight no provee tipos completos
-import { highlight, supportsLanguage } from 'cli-highlight';
-
-let configured = false;
-
-const LANG_ALIASES: Record<string, string> = {
-  sh: 'bash',
-  shell: 'bash',
-  zsh: 'bash',
-  curl: 'bash',
-  jsx: 'javascript',
-  ts: 'typescript',
-  tsx: 'typescript',
-  yml: 'yaml',
-  html: 'xml',
-  text: 'plaintext',
-  txt: 'plaintext',
-};
-
-function resolveLang(raw: string | undefined): string {
-  const k = (raw ?? '').toLowerCase().trim();
-  const aliased = LANG_ALIASES[k] ?? k;
-  if (!aliased) return 'plaintext';
-  try {
-    return supportsLanguage(aliased) ? aliased : 'plaintext';
-  } catch {
-    return 'plaintext';
-  }
-}
-
-function renderCodeBlock(code: string, rawLang: string | undefined): string {
-  const lang = resolveLang(rawLang);
-  let body: string;
-  try {
-    body = highlight(code, { language: lang, ignoreIllegals: true });
-  } catch {
-    body = code;
-  }
-
-  const label = (rawLang ?? '').trim() || lang;
-  const width = Math.max(20, Math.min(80, (process.stdout.columns || 80) - 8));
-  const headerLabel = ` ${label} `;
-  const headerRule = '─'.repeat(Math.max(0, width - headerLabel.length - 4));
-  const header = chalk.gray.dim(`──${headerLabel}${headerRule}`);
-  const footer = chalk.gray.dim('─'.repeat(width - 2));
-
-  // Indent del cuerpo para diferenciar del prosa
-  const indented = body
-    .split('\n')
-    .map((l) => '  ' + l)
-    .join('\n');
-
-  return `\n${header}\n${indented}\n${footer}\n`;
-}
-
-function configure(): void {
-  if (configured) return;
-
-  const renderer = new TerminalRenderer({
-    width: Math.max(40, (process.stdout.columns || 80) - 8),
-    reflowText: true,
-    tab: 2,
-    // Inline code mejor diferenciado del texto normal
-    codespan: chalk.cyan,
-  }) as any;
-
-  // Override del code block para syntax highlight + box delimitado.
-  // marked-terminal pasa (code, lang, escaped) al método `code`.
-  renderer.code = (code: string, lang: string | undefined): string =>
-    renderCodeBlock(code, lang);
-
-  marked.setOptions({ renderer });
-  configured = true;
-}
-
-/**
- * Renderiza markdown a una cadena con secuencias ANSI lista para imprimir
- * dentro de un <Text/> de Ink. Limpia el salto de línea trailing que añade marked.
- */
-export function renderMarkdown(md: string): string {
-  if (!md) return '';
-  configure();
-  try {
-    const out = marked.parse(md) as string;
-    return typeof out === 'string' ? out.replace(/\n+$/, '') : md;
-  } catch {
-    return md;
-  }
-}

package/src/studio/render/steps.ts

@@ -1,57 +0,0 @@
-/**
- * Maps backend tool_name values to human-readable step labels for the REPL.
- * Keeps both forms (gerund for "running" and past tense for "success").
- */
-const LABELS: Record<string, { running: string; done: string; failed: string }> = {
-  list_agents: {
-    running: 'Listing agents',
-    done: 'Agents listed',
-    failed: 'Could not list agents',
-  },
-  load_agent: {
-    running: 'Loading agent',
-    done: 'Agent loaded',
-    failed: 'Could not load agent',
-  },
-  diagnose_agent: {
-    running: 'Diagnosing agent',
-    done: 'Diagnosis complete',
-    failed: 'Could not diagnose agent',
-  },
-  create_agent_config: {
-    running: 'Generating agent configuration',
-    done: 'Configuration generated',
-    failed: 'Could not generate configuration',
-  },
-  update_agent_config: {
-    running: 'Updating agent configuration',
-    done: 'Configuration updated',
-    failed: 'Could not update configuration',
-  },
-  save_agent: {
-    running: 'Saving agent',
-    done: 'Agent saved',
-    failed: 'Could not save agent',
-  },
-  delete_agent: {
-    running: 'Deleting agent',
-    done: 'Agent deleted',
-    failed: 'Could not delete agent',
-  },
-  connect_whatsapp: {
-    running: 'Connecting WhatsApp',
-    done: 'WhatsApp connected',
-    failed: 'Could not connect WhatsApp',
-  },
-};
-
-export function stepLabel(toolName: string, status: 'running' | 'success' | 'error'): string {
-  const entry = LABELS[toolName] ?? {
-    running: `Running ${toolName}`,
-    done: `Ran ${toolName}`,
-    failed: `Failed: ${toolName}`,
-  };
-  if (status === 'running') return entry.running;
-  if (status === 'success') return entry.done;
-  return entry.failed;
-}

package/src/studio/runOneShot.ts

@@ -1,114 +0,0 @@
-import { getStoredCredentials } from '../utils/credentials.js';
-import { logger } from '../utils/logger.js';
-import { streamStudio } from './api/sseClient.js';
-import { StudioHttpError } from './api/types.js';
-import type { StudioChunk, StudioStreamOptions } from './api/types.js';
-import { stepLabel } from './render/steps.js';
-
-interface RunOneShotOptions {
-  dev: boolean;
-  agentId?: string;
-  message: string;
-  /** Si true, imprime cada chunk como una línea JSON (NDJSON). */
-  json?: boolean;
-  /** Overrides the workspace from local config (support / white-label partner mode). */
-  workspaceOverride?: string;
-}
-
-export async function runOneShot(opts: RunOneShotOptions): Promise<void> {
-  let creds;
-  try {
-    creds = await getStoredCredentials();
-  } catch {
-    logger.error('No active session. Run:');
-    console.log('  plazbot init -e <email> -k <jwt> -w <workspace> -z <LA|EU>');
-    process.exit(1);
-    return;
-  }
-
-  const effectiveWorkspace = opts.workspaceOverride ?? creds.workspace;
-  const supportMode = !!opts.workspaceOverride && opts.workspaceOverride !== creds.workspace;
-
-  if (supportMode && !opts.json) {
-    process.stderr.write(`! Support mode: acting on workspace "${effectiveWorkspace}" (your account belongs to "${creds.workspace}")\n`);
-  }
-
-  const stream: StudioStreamOptions = {
-    apiKey: creds.apiKey,
-    workspaceId: effectiveWorkspace,
-    userId: creds.userId ?? creds.email ?? undefined,
-    zone: creds.zone,
-    dev: opts.dev,
-  };
-
-  const controller = new AbortController();
-  process.on('SIGINT', () => controller.abort());
-
-  let assistantText = '';
-  const onChunk = (chunk: StudioChunk) => {
-    if (opts.json) {
-      process.stdout.write(JSON.stringify(chunk) + '\n');
-      return;
-    }
-    switch (chunk.type) {
-      case 'text':
-        assistantText += chunk.content ?? '';
-        process.stdout.write(chunk.content ?? '');
-        break;
-      case 'tool_call':
-        process.stderr.write(`\n  ▸ ${stepLabel(chunk.tool_name, 'running')}…\n`);
-        break;
-      case 'tool_result': {
-        const tr = chunk.tool_result;
-        const ok = tr?.success !== false && !tr?.error;
-        const label = stepLabel(chunk.tool_name, ok ? 'success' : 'error');
-        process.stderr.write(`  ${ok ? '✓' : '✗'} ${label}${tr?.error ? ' — ' + tr.error : ''}\n`);
-        break;
-      }
-      case 'usage':
-        process.stderr.write(
-          `  tokens: ${chunk.input_tokens} in / ${chunk.output_tokens} out\n`,
-        );
-        break;
-      case 'error':
-        process.stderr.write(`\n  ✖ ${chunk.error}\n`);
-        break;
-      case 'done':
-        break;
-    }
-  };
-
-  try {
-    await streamStudio(
-      stream,
-      {
-        message: opts.message,
-        messages: [{ role: 'user', content: opts.message }],
-        agentId: opts.agentId ?? null,
-      },
-      onChunk,
-      controller.signal,
-    );
-    if (!opts.json) process.stdout.write('\n');
-    if (!assistantText && !opts.json) process.stderr.write('  (no text response)\n');
-  } catch (err) {
-    process.stderr.write('\n' + formatError(err, opts.dev) + '\n');
-    process.exit(1);
-  }
-}
-
-function formatError(err: unknown, dev: boolean): string {
-  if (err instanceof StudioHttpError) {
-    if (err.status === 401) return '✖ Token expired or invalid. Run `plazbot init`.';
-    if (err.status === 403) return '✖ No permission for this workspace.';
-    if (err.status === 429) return '✖ Rate limit reached.';
-    if (err.status >= 500) {
-      return dev
-        ? `✖ Backend ${err.status}: ${err.body ?? err.statusText}`
-        : `✖ Backend returned ${err.status}. Retry.`;
-    }
-    return `✖ HTTP ${err.status} ${err.statusText}`;
-  }
-  if (err instanceof Error) return `✖ ${err.message}`;
-  return '✖ Unknown error';
-}

package/src/studio/runRepl.tsx

@@ -1,82 +0,0 @@
-import React from 'react';
-import { render } from 'ink';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import { App } from './components/App.js';
-import { getStoredCredentials } from '../utils/credentials.js';
-import { logger } from '../utils/logger.js';
-import type { StudioStreamOptions } from './api/types.js';
-
-interface RunReplOptions {
-  dev: boolean;
-  agentId?: string;
-  /** Overrides the workspace from local config (support / white-label partner mode). */
-  workspaceOverride?: string;
-}
-
-// Estilo Claude Code: NO usamos alt screen buffer. Razon: en el alt screen el
-// scrollback nativo de la terminal queda inaccesible y el usuario no puede
-// revisar la conversacion anterior. Aceptamos el tradeoff de que en algunos
-// resizes de la terminal pueda haber artifacts visuales temporales (los frames
-// estaticos ya quedaron en scrollback gracias a <Static>).
-
-export async function runRepl(opts: RunReplOptions): Promise<void> {
-  let creds;
-  try {
-    creds = await getStoredCredentials();
-  } catch (err) {
-    logger.error('No active session. Run:');
-    console.log('  plazbot init -e <email> -k <jwt> -w <workspace> -z <LA|EU>');
-    process.exit(1);
-  }
-
-  const effectiveWorkspace = opts.workspaceOverride ?? creds.workspace;
-  const supportMode = !!opts.workspaceOverride && opts.workspaceOverride !== creds.workspace;
-
-  if (supportMode) {
-    logger.warning(`Support mode: acting on workspace "${effectiveWorkspace}" (your account belongs to "${creds.workspace}")`);
-    logger.warning('All actions are tied to your user and will be visible in audit trails.');
-  }
-
-  const stream: StudioStreamOptions = {
-    apiKey: creds.apiKey,
-    workspaceId: effectiveWorkspace,
-    userId: creds.userId ?? creds.email ?? undefined,
-    zone: creds.zone,
-    dev: opts.dev,
-  };
-
-  const version = readVersion();
-
-  const { waitUntilExit } = render(
-    <App
-      version={version}
-      stream={stream}
-      initialAgentId={opts.agentId ?? null}
-      dev={opts.dev}
-      supportMode={supportMode}
-    />,
-    {
-      exitOnCtrlC: false,
-    },
-  );
-
-  // Cierre limpio con Ctrl+C: la App lo gestiona vía useInput.
-  process.on('SIGINT', () => {
-    // no-op aquí; App.tsx llama exit() al detectar Ctrl+C.
-  });
-
-  await waitUntilExit();
-}
-
-function readVersion(): string {
-  try {
-    const __dirname = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join(__dirname, '..', '..', 'package.json');
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-    return pkg.version ?? '0.0.0';
-  } catch {
-    return '0.0.0';
-  }
-}