Proyectos, lotes y equipos

Cada video final debe tener un proyecto identificable con su marca, material, decisiones y revisiones. «Mi material» es reutilizable; un proyecto es el trabajo específico.

Crear desde el chat y subir desde el teléfono

Pide «nueva edición» e indica la marca si no está clara. El agente puede crear el proyecto con tu contexto guardado. Si no tiene la grabación, te devuelve el enlace privado para subir uno o varios archivos. Después escribe «ya están» en el mismo chat para continuar. Los adjuntos accesibles se usan directamente; no hace falta volver a subirlos.

Cuando la instalación expone estos comandos, el flujo equivalente es:

editorbrain projects create nueva-edicion --brand MARCA_ID --style ESTILO_ID --output-profile SALIDA_ID
editorbrain projects intake --project nueva-edicion

Los IDs se descubren en la cuenta; no son nombres inventados por el agente. create guarda el proyecto; intake consulta material y devuelve el enlace con su espacio de trabajo. En MCP son create_project y get_project_intake. Un reintento conserva el mismo ID y nunca reemplaza un proyecto diferente.

El enlace requiere iniciar sesión y tener acceso al proyecto. Crear, consultar o subir archivos no aprueba una muestra ni inicia generación o render. El estado «material presente» significa que hay archivos vinculados; el agente todavía tiene que revisar que sean los videos correctos y analizar su contenido.

Encontrar y seguir proyectos

editorbrain brands list
editorbrain projects list --brand mi-marca
editorbrain projects progress --project mi-proyecto

El tablero muestra el estado registrado del trabajo. No es una señal de que el agente siga ejecutándose en tu computadora. Marcar terminado requiere la aceptación correspondiente de la versión final; no basta con generar un archivo.

Diez grabaciones o cinco videos desde cero

Primero determina qué archivos forman cada video. Diez archivos pueden ser diez piezas o diez tomas de una sola. Después crea proyectos separados y agrúpalos en un lote.

editorbrain batches list
editorbrain batches create --file lote.json
editorbrain batches get BATCH_ID

El esquema de creación está en create_editing_batch de la referencia MCP. Los proyectos deben existir y estar autorizados. El lote conserva turnos, revisión y presupuestos; no sustituye preferencias de cada proyecto.

• Un agente reclama un turno antes de iniciar ese proyecto; no duplica trabajo que ya esté reclamado.
• Si una pieza está bloqueada por material o permiso, puede continuar con otras elegibles.
• Pausar/cancelar impide iniciar nuevo trabajo; no garantiza detener un render local o una generación ya enviada.
• Un turno vencido requiere comprobar qué pasó antes de volver a lanzar una generación.

Colaborar con otras personas

El propietario invita a un correo y asigna alcance. Un editor de marca trabaja dentro de marcas asignadas; un revisor de proyecto ve las versiones compartidas para ese proyecto. No obtiene automáticamente acceso a todas las marcas ni a facturación.

editorbrain team access
editorbrain team members
editorbrain team invite --email colega@example.com --kind brand_editor --scope mi-marca

Este último comando envía una invitación real si el servicio está habilitado. Usa el correo confirmado y el alcance correcto. Para clientes revisores usa project_reviewer y el ID del proyecto.

El destinatario abre el enlace, entra con ese correo y lo verifica. Antes de aceptar ve el espacio y la marca/proyecto asignado; la vista previa no concede acceso. Aceptar conserva su espacio personal. Cada colaborador conecta su propia cuenta a su agente: no compartas tu clave con el equipo.

El editor invitado puede trabajar desde su agente o desde Mis proyectos en la web: brief, guion, dirección, material y muestras. Revisiones compartidas conserva el hilo público con el cliente. La marca y las preferencias generales las administra el propietario. El propietario administra marcas y gasto; una invitación de editor no autoriza consumir créditos integrados. team_spending_disabled es un permiso, no falta de saldo: solicita el recurso al propietario o usa una integración propia que hayas autorizado explícitamente.

Compartir una revisión de equipo es explícito; las versiones no compartidas siguen privadas. Retirar acceso no borra mágicamente copias ya descargadas por el destinatario.

Leer todas las correcciones de una versión

editorbrain team reviews --project mi-proyecto
editorbrain team comments --project mi-proyecto --revision UUID
editorbrain team comments --project mi-proyecto --revision UUID --after CURSOR

reviews pagina versiones; su resumen histórico de comentarios está limitado a 100 para todo el proyecto. Para revisar una versión usa comments y sigue nextCursor hasta que sea null. Cada cursor pertenece a esa versión y espacio. MCP ofrece team_reviews y team_review_comments con la misma separación. Los comentarios internos de producción no se muestran a clientes.

En la web puedes escribir una corrección en el instante actual. El borrador se conserva por cuenta, espacio, proyecto y versión mientras uses la misma sesión del navegador. «Actualizar versiones y accesos» busca las novedades sin reenviar tus comentarios. Aprobar corresponde solo a esa muestra; las correcciones pendientes necesitan resolverse contra una versión nueva antes de aprobar.

El propietario cambia marcas/proyectos desde Editar permisos, sin retirar ni reinvitar a la persona. También puede hacerlo desde el CLI:

editorbrain team members
editorbrain team permissions --user USER_ID --file permisos.json --confirm

permisos.json contiene la revisión vigente y la lista completa de accesos:

{"expectedRevision": 1, "grants": [{"kind": "brand_editor", "scopeId": "mi-marca"}]}

Copia permissionsRevision de ese miembro al campo expectedRevision. Si recibes TEAM_PERMISSIONS_CHANGED, vuelve a leer los accesos y concilia los cambios. Guardar invalida enlaces de invitación anteriores. Al quedar solo como revisor se cierran sus conexiones de agente; volver a editor requiere reconectar. Para quitar todo usa Retirar acceso. Los archivos se conservan y las claves antiguas no se reactivan. No hay coedición en tiempo real; guardar conserva el control de revisión.

Límites de ámbito

El plan, los créditos y el almacenamiento se comparten entre marcas del mismo espacio. La identidad y las preferencias permanecen separadas por marca/proyecto. Las integraciones externas y likes son del miembro correspondiente; no se usan las credenciales de otro integrante.

Crear un equipo no convierte a un miembro en administrador del servicio. Los controles de permisos se aplican también en API y MCP, no solo ocultando botones en la web.