deepankar-sah/omniflow-studio

Habilidade do Agente OmniFlow Studio

Esta habilidade concede a agentes de IA de codificação e orquestração controle direto sobre o OmniFlow Studio — uma ponte autônoma que conecta agentes de IA locais a canvases de mídia generativa de alta fidelidade no Google Chrome.

Quando Usar Esta Habilidade

Use esta habilidade sempre que:

1. O usuário solicitar a geração de vídeos cinematográficos de IA, imagens B-roll, arte conceitual ou storyboards.
2. Estiver construindo ou dirigindo um curta-metragem autônomo de múltiplos planos ou uma peça publicitária.
3. Gerar folhas de referência de personagens (consistência de ângulos) em várias cenas de vídeo.
4. Automatizar filas de geração em lote de imagens/vídeos sem pagar taxas de API por minuto.
5. Perguntar sobre o status atual da ponte OmniFlow, cotas de geração ou progresso da fila ativa.

---

🚀 Protocolo Rápido de Execução para Agentes

Antes de despachar trabalhos de mídia, todo agente deve seguir este loop de verificação de 3 etapas:

Etapa 1: Verificação de Saúde e Ponte

Verificar se o daemon da ponte local OmniFlow está em execução em http://127.0.0.1:8792:

node scripts/check-bridge.js
# Ou curl diretamente:
curl -s http://127.0.0.1:8792/status

• Se Offline: Instrua o usuário ou execute: omniflow bridge start (ou inicie a tarefa em segundo plano da ponte).
• Se Online: Verifique se extensionConnected é true e tabVisible é true (significa que o Chrome tem o Google Flow aberto).

Etapa 2: Enviar um Trabalho de Geração

Os agentes podem enviar via API REST ou pelos scripts auxiliares fornecidos:

# Script auxiliar (mais fácil):
node scripts/submit-shot.js --mode flow-text-to-video --prompt "Cinematic drone flyover neon cyberpunk Tokyo rain 8k" --aspectRatio 16:9 --duration 6s

# Ou POST HTTP direto:
curl -s -X POST http://127.0.0.1:8792/jobs \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "flow-text-to-video",
    "prompt": "Cinematic drone flyover neon cyberpunk Tokyo rain 8k",
    "params": {
      "aspectRatio": "16:9",
      "duration": "6s",
      "videoModel": "veo-3.1-fast",
      "downloadSubfolder": "MyProject"
    }
  }'

Etapa 3: Monitorar e Recuperar Mídia Baixada

Polle até que o status do trabalho mude para completed:

node scripts/list-jobs.js
# Ou:
curl -s http://127.0.0.1:8792/jobs

Quando status === "completed", recupere o caminho do arquivo local a partir do array files (ex: Downloads/MyProject/...mp4).

---

🛠️ Modos de Geração Suportados

ID do Modo	Descrição	Parâmetros Principais
flow-text-to-video	Gera vídeo em movimento a partir de uma descrição textual	prompt, aspectRatio (16:9, 9:16, 1:1), duration (4s, 6s, 8s)
flow-text-to-image	Gera imagens estáticas fotorrealistas ou estilizadas	prompt, aspectRatio, imageModel (nano-banana-pro)
flow-frame-to-video	Estende uma imagem estática ou quadro-chave em um vídeo contínuo	prompt, duration, token do ativo de referência
flow-create-character	Gera folha de referência de 4 ângulos para consistência facial	characterName, visualDescription, voicePreset

---

🎛️ Invocações de Ferramentas MCP (Se o Servidor MCP Estiver Ativo)

Se o servidor MCP do OmniFlow estiver conectado em seu ambiente de agente, chame estas ferramentas nativas diretamente:

• omniflow_status: Verifica o status da ponte e da conexão do navegador.
• omniflow_generate_shot: Enfileira um único plano com movimento de câmera (drone-wide, close-up, tracking).
• omniflow_produce_movie: Passa um array completo de roteiro cinematográfico de planos ordenados para produzir um curta-metragem sequencialmente.
• omniflow_create_character: Bloqueia uma tag de personagem com consistência de ângulos frontal e perfil.
• omniflow_list_jobs: Lista trabalhos de geração ativos, na fila e finalizados com caminhos de download em disco.

---

💡 Melhores Práticas para Prompts Cinematográficos

Para saídas de vídeo fotorrealistas com Veo 3.1:

1. Especifique Movimento de Câmera: Ex: [Camera: drone-wide], [Camera: slow push-in], [Camera: tracking shot].
2. Especifique Iluminação e Atmosfera: Ex: volumetric rim lighting, golden hour anamorphic haze, 35mm film grain.
3. Evite Jargões: O Google Flow responde melhor a descrições visuais narrativas claras do que a tags de software.

Consulte references/api-reference.md e examples/cinematic-short-film.json para modelos prontos para uso de múltiplas cenas.