diff --git a/panel/src/components/clipper-ai-team.tsx b/panel/src/components/clipper-ai-team.tsx
new file mode 100644
index 0000000..dba5e78
--- /dev/null
+++ b/panel/src/components/clipper-ai-team.tsx
@@ -0,0 +1,285 @@
+"use client";
+// Equipe de IA do Clipador (doc/clipador/EQUIPE-IA.md): um cartão por papel — varredura, analista, editor e juiz —
+// com provedor, modelo (lista do provedor escolhido), raciocínio (só Codex), imagens, liga/desliga (o editor não
+// desliga), as instruções padrão (só leitura) e as instruções do administrador (somadas às padrão). E o relatório
+// de medição: chamadas e tokens por papel, decisões do juiz e a concordância dele com você.
+import { useCallback, useEffect, useState } from "react";
+import {
+ CHECK_LABEL, PROVIDER_LABEL, ROLE_INFO, ROLE_ORDER, clipperCall, formatScore,
+ type AiEffort, type AiImages, type AiReport, type AiRole, type AiRoleId, type AiRoleProvider, type AiRoles,
+ type ContextCheckId, type JudgeConfig,
+} from "./clipper-client";
+import { DescribedSelect } from "./forms";
+import { AlertIcon, RefreshIcon, SparkIcon } from "./icons";
+import { Badge, Button, Card, Select, Spinner, Switch, Textarea, cx } from "./ui";
+
+const EXTRA_MAX = 2000;
+const EFFORT_LABEL: Record = { "": "padrão (baixo)", low: "baixo", medium: "médio", high: "alto" };
+const IMAGES_LABEL: Record = {
+ mosaic: { label: "Mosaico (1 imagem com 8 quadros)", description: "Os quadros numa grade 4×2: a IA vê a sequência pagando por 1 imagem (4–8× menos que quadros soltos)." },
+ frames: { label: "Quadros soltos (antigo)", description: "Cada quadro em uma imagem, em 768 px. Mais detalhe, bem mais caro." },
+ none: { label: "Nenhuma", description: "Só texto (fala, chat, rosto e o que a varredura já descreveu da tela)." },
+};
+const ALL_CHECKS = Object.keys(CHECK_LABEL) as ContextCheckId[];
+
+/** Provedores que dá para escolher: Codex e Claude sempre; Gemini só se estiver ligado em Configurações → IA. */
+function providerOptions(judge: JudgeConfig, current: AiRoleProvider): AiRoleProvider[] {
+ const list: AiRoleProvider[] = ["codex", "claude"];
+ if (judge.providers?.gemini?.enabled || current === "gemini") list.push("gemini");
+ return list;
+}
+
+export function AiTeam({ judge, roles, onChange, disabled }: {
+ judge: JudgeConfig; roles: AiRoles; onChange: (next: AiRoles) => void; disabled: boolean;
+}) {
+ const set = (id: AiRoleId, values: Partial) => onChange({ ...roles, [id]: { ...roles[id], ...values } });
+ return (
+
+
+
Equipe de IA
+
+ Cada papel roda na IA que você escolher. A varredura e o analista veem a tela;
+ o editor decide se vira corte; o juiz confere se o corte faz sentido para quem nunca viu a live.
+ Se a IA de um papel cair, a reserva de Configurações → IA assume para aquele papel.
+
+ );
+}
diff --git a/panel/src/components/clipper-client.ts b/panel/src/components/clipper-client.ts
index f1fdf80..bf2dd0b 100644
--- a/panel/src/components/clipper-client.ts
+++ b/panel/src/components/clipper-client.ts
@@ -18,8 +18,40 @@ export type ClipperStatus = {
};
export type JudgeModel = { id: string; label: string; description?: string };
-/** `faceTrack` é opcional: o serviço antigo (antes do rastreio de reação) não manda. */
-export type JudgeOptions = { scanEnabled: boolean; scanIntervalS: number; vision: boolean; camDetect: boolean; faceTrack?: boolean };
+/** `faceTrack` e `timelineJson` são opcionais: o serviço antigo não manda. `timelineJson` = a IA lê o vídeo como
+ * linha do tempo JSON curta (novo); false = transcrição + chat + frames soltos (antigo, para comparar). */
+export type JudgeOptions = {
+ scanEnabled: boolean; scanIntervalS: number; vision: boolean; camDetect: boolean; faceTrack?: boolean; timelineJson?: boolean;
+};
+
+/** Equipe de IA (doc/clipador/EQUIPE-IA.md): quatro papéis, cada um com a sua IA. */
+export type AiRoleId = "scan" | "analyst" | "editor" | "judge";
+export type AiRoleProvider = Exclude;
+export type AiEffort = "" | "low" | "medium" | "high";
+export type AiImages = "mosaic" | "frames" | "none";
+export type ContextCheckId = "setup" | "payoff" | "who_what" | "standalone" | "intelligible" | "faithful" | "strong_open";
+export type AiRole = {
+ enabled: boolean;
+ provider: AiRoleProvider;
+ /** "" = padrão do provedor. */
+ model: string;
+ /** Raciocínio (só Codex); "" = padrão (baixo). */
+ effort: AiEffort;
+ /** Instruções do administrador, somadas às padrão (podem ser em português). */
+ extra: string;
+ /** Só varredura e analista. */
+ images?: AiImages;
+ // Só o juiz: checagens críticas, se pode ajustar o trecho e pôr frase de contexto, e quanto cada checagem
+ // não crítica tira da nota.
+ critical?: ContextCheckId[];
+ allowFix?: boolean;
+ allowContextLine?: boolean;
+ penalty?: number;
+ /** Só leitura (o serviço calcula): modelo efetivo e a ordem de tentativa (reserva) deste papel. */
+ resolvedModel?: string;
+ chain?: AiRoleProvider[];
+};
+export type AiRoles = Record;
export type JudgeConfig = {
provider: JudgeProvider;
/** Modelo do EDITOR (2º juiz). null com o juiz desligado. */
@@ -41,8 +73,37 @@ export type JudgeConfig = {
fallback?: { enabled: boolean; cooldownMin: number; chain: Exclude[] };
/** IAs em pausa depois de falha de indisponibilidade (`until` em ISO, UTC). */
pauses?: JudgePause[];
+ /** Equipe de IA (serviço novo): cada papel com a sua IA. Ausente = serviço antigo (um provedor só). */
+ roles?: AiRoles;
+ /** Instruções padrão de cada papel nos dois idiomas (só leitura). Só em GET/PUT /judge. */
+ roleDefaults?: Record;
+ /** Checagens do juiz de contexto (id + nome em português). */
+ checks?: { id: ContextCheckId; label: string }[];
+ /** Situação de cada IA (Configurações → IA): ligada, pronta e por que não. */
+ providers?: Partial>;
};
+/** GET /judge/report: medição da Equipe de IA (F0) — chamadas e tokens por papel, decisões do juiz e concordância com você. */
+export type AiReport = {
+ window: { days: number; since: string | null; sessionId: number | null; liveHours: number };
+ calls: {
+ role: string; purpose: string; provider: string; model: string; mode: string; calls: number; failures: number;
+ avgChars: number; avgImages: number; imageKB: number; tokensIn: number | null; tokensOut: number | null;
+ tokensCached: number | null; withUsage: number; avgMs: number;
+ }[];
+ perHour: Record;
+ clips: { total: number; byStatus: Partial>; approvalRate: number | null; labeled: number; noContext: number };
+ judge: { approve: number; adjust: number; discard: number; warn: number; error: number; contextLine: number };
+ agreement: Record<"judge" | "editor", AiAgreement>;
+};
+export type AiAgreement = {
+ pairs: number; agree: number; rate: number | null; kappa: number | null;
+ matrix: Record<"keep" | "discard", Record>;
+};
+
+/** Sua avaliação do corte (conjunto de avaliação do juiz). */
+export type OwnerLabel = "good" | "bad" | "no_context";
+
export type JudgePause = { provider: Exclude; until: string; reason: string };
export type ClipperChannel = {
@@ -150,9 +211,42 @@ export type ClipJudge = null
model: string; keep: boolean; score: number; reason: string; analysis?: ClipAnalysis | null; analystModel?: string;
/** Fonte em inglês: título, legenda e motivo em português (só para ler; o post sai em inglês). */
pt?: { title?: string; caption?: string; reason?: string };
+ /** Juiz de contexto (EQUIPE-IA.md). Ausente = juiz desligado, editor descartou ou corte de antes. */
+ context?: ClipContext;
+ /** "context" = quem descartou foi o juiz de contexto (dá para forçar o render). */
+ discardedBy?: "context";
}
| { error: string };
+export type ContextCheck = { ok: boolean; t: number | null; why: string };
+export type ClipContext =
+ | { error: string }
+ | {
+ model: string;
+ /** O que um espectador que nunca viu a live entende (escrito antes das checagens). */
+ viewerSummary: string;
+ checks: Partial>;
+ fix: { start_s: number | null; end_s: number | null; context_line: string };
+ confidence: number;
+ reason: string;
+ /** Fonte em inglês: resumo, motivo, frase e o porquê de cada checagem em português. */
+ pt?: { viewer_summary?: string; reason?: string; context_line?: string; checks?: Partial> };
+ /** O que o código decidiu pelas respostas. */
+ decision: "approve" | "adjust" | "discard" | "warn";
+ failed: ContextCheckId[];
+ failedCritical: ContextCheckId[];
+ solvedByLine: ContextCheckId[];
+ /** Frase de contexto que vai na tela no começo do corte ("" = nenhuma). */
+ contextLine: string;
+ scoreAfter: number | null;
+ /** Motivo da decisão, em português (montado pelo código). */
+ reasonPt: string;
+ /** Trecho novo quando o juiz ajustou. */
+ window?: [number, number];
+ /** 1ª rodada, quando houve ajuste (o juiz conferiu de novo). */
+ first?: { viewerSummary: string; checks: Partial>; failedCritical: ContextCheckId[]; reasonPt: string };
+ };
+
export type ClipTags = { risada?: number; susto?: number; hype?: number; clip?: number };
export type Clip = {
@@ -204,6 +298,9 @@ export type Clip = {
final?: ClipFinal | null;
/** O único arquivo que vai para as redes: o final pronto. null = ainda não (a publicação espera). */
publishFile?: string | null;
+ /** Sua avaliação (bom / ruim / sem contexto) para medir o juiz. Opcional: o serviço antigo não manda. */
+ ownerLabel?: OwnerLabel | null;
+ ownerNote?: string | null;
};
export type ClipFinal = {
@@ -495,6 +592,26 @@ export const TAG_LABEL: Record = { risada: "risada", sus
export const PROVIDER_LABEL: Record = { codex: "Codex (GPT)", claude: "Claude", gemini: "Gemini", off: "Desligado" };
+/** Equipe de IA: nome e o que cada papel faz (cartões da configuração). */
+export const ROLE_INFO: Record = {
+ scan: { label: "Varredura", does: "Assiste a live por janelas e propõe momentos mesmo sem pico de chat; descreve a tela para a linha do tempo." },
+ analyst: { label: "Analista", does: "Olha tela, fala e chat do trecho e diz o que aconteceu (lag, jogada, treta…). Não decide." },
+ editor: { label: "Editor", does: "Decide se vira corte, escolhe o trecho e escreve título, legenda e hashtags." },
+ judge: { label: "Juiz", does: "Só texto: vê o que vai no corte e confere se quem nunca viu a live entende — começo, desfecho, funciona sozinho." },
+};
+export const ROLE_ORDER: AiRoleId[] = ["scan", "analyst", "editor", "judge"];
+export const CHECK_LABEL: Record = {
+ setup: "começo (setup)", payoff: "desfecho", who_what: "quem/o quê", standalone: "funciona sozinho",
+ intelligible: "fala clara", faithful: "título fiel", strong_open: "abertura forte",
+};
+export const OWNER_LABEL: Record = {
+ good: { label: "Bom", tone: "success" }, bad: { label: "Ruim", tone: "danger" }, no_context: { label: "Sem contexto", tone: "warning" },
+};
+export const CONTEXT_DECISION: Record<"approve" | "adjust" | "discard" | "warn", { label: string; tone: Tone }> = {
+ approve: { label: "aprovou", tone: "success" }, adjust: { label: "ajustou o trecho", tone: "info" },
+ discard: { label: "descartou", tone: "danger" }, warn: { label: "avisou", tone: "warning" },
+};
+
/** Sessões que ainda mudam sozinhas (vale consultar de novo). */
export const ACTIVE_SESSION: SessionStatus[] = ["starting", "recording", "processing"];
/** Cortes que ainda mudam sozinhos (IA ou render). */
diff --git a/panel/src/components/clipper-clip-dialog.tsx b/panel/src/components/clipper-clip-dialog.tsx
index ecce948..e7e003c 100644
--- a/panel/src/components/clipper-clip-dialog.tsx
+++ b/panel/src/components/clipper-clip-dialog.tsx
@@ -6,7 +6,8 @@
import { useEffect, useState } from "react";
import { CLIP_STATUS, SOURCE_LABEL, clipperCall, formatClock, formatDuration, languageLabel, useClipperAction, type Clip, type ClipperSession } from "./clipper-client";
import {
- ChatSignals, ClipActions, ClipMedia, ClipVideoState, DeleteControl, FaceSignal, JudgeVerdict, TrimControl, situationLabel, type DeleteClip,
+ ChatSignals, ClipActions, ClipMedia, ClipVideoState, DeleteControl, FaceSignal, JudgeVerdict, OwnerLabelControl, TrimControl, situationLabel,
+ type DeleteClip,
} from "./clipper-clip-parts";
import { isOther, speakerLabel } from "./clip-editor-model";
import { Dialog } from "./dialog";
@@ -117,6 +118,7 @@ function ClipBody({ clip, onChanged, publishJobs }: { clip: Clip; onChanged: ()
+
{clip.status === "error" && clip.error && (
diff --git a/panel/src/components/clipper-clip-parts.tsx b/panel/src/components/clipper-clip-parts.tsx
index 6baf796..d71ad87 100644
--- a/panel/src/components/clipper-clip-parts.tsx
+++ b/panel/src/components/clipper-clip-parts.tsx
@@ -5,9 +5,9 @@
// confirmação curta no lugar. Nada aqui busca dados: tudo vem por props; cada ação chama `run` (useClipperAction).
import { useEffect, useRef, useState, type ReactNode } from "react";
import {
- ACTIVE_CLIP, CLIP_STATUS, DEV_LAYER_LABEL, FACE_LABEL, SITUATION_LABEL, TAG_LABEL, UNDELETABLE_CLIP, aspectOf, clipperCall, formatClock, formatDuration, formatScore,
- reviewHasDevLayers,
- type Clip, type ClipAnalysis, type ClipTags, type Situation, type useClipperAction,
+ ACTIVE_CLIP, CHECK_LABEL, CLIP_STATUS, CONTEXT_DECISION, DEV_LAYER_LABEL, FACE_LABEL, OWNER_LABEL, SITUATION_LABEL, TAG_LABEL, UNDELETABLE_CLIP, aspectOf,
+ clipperCall, formatClock, formatDuration, formatScore, reviewHasDevLayers,
+ type Clip, type ClipAnalysis, type ClipContext, type ClipTags, type ContextCheckId, type OwnerLabel, type Situation, type useClipperAction,
} from "./clipper-client";
import { ClipPublishButton } from "./clip-publish";
import { AlertIcon, CheckIcon, EyeIcon, RefreshIcon, ScissorsIcon, SparkIcon, TrashIcon, UndoIcon, XIcon } from "./icons";
@@ -250,10 +250,107 @@ export function JudgeVerdict({ clip }: { clip: Clip }) {
{(judge.pt?.reason || judge.reason) &&
{judge.pt?.reason || judge.reason}
}
+ {judge.context && }
>
);
}
+/** O JUIZ de contexto (EQUIPE-IA.md): o que um espectador frio entende, as checagens e o que o código decidiu. */
+export function ContextVerdict({ context }: { context: ClipContext }) {
+ if ("error" in context) {
+ return (
+
+
+ O juiz não conseguiu conferir o contexto (ficou a decisão do editor): {context.error}
+