Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { useEffect, useRef, useState } from 'react';
import toast from '../components/ui/Toast';
import socket from '../services/socket';
import { toastWorkflowError } from '../components/musicVideo/workflowErrorToast.jsx';
import {
getMusicVideoProject,
startMusicVideoAutoReview,
resumeMusicVideoAutoReview,
stopMusicVideoAutoReview,
cancelMusicVideoAutoReview,
} from '../services/apiMusicVideo.js';
const OUTCOME_TOASTS = {
passed: (run) => toast.success(`Auto-review passed after ${run.attempts.length} attempt${run.attempts.length === 1 ? '' : 's'}`),
'needs-human': (run) => toast.info(`Auto-review needs you: ${run.stopReason || 'watch the latest draft'}`),
'limit-reached': (run) => toast.info(`Auto-review stopped at its limit: ${run.stopReason || ''}`),
failed: (run) => toast.error(`Auto-review failed: ${run.stopReason || run.error || 'unknown error'}`),
};
/**
* Opt-in automatic review/retries (#8988). A run is started only by the
* director, with explicit limits on reviews (`maxAttempts`) and paid
* generations (`maxGenerations`); the server then renders the draft window,
* reviews it, revises only the flagged sections and generates them itself
* (#10014) — so a run completes with no tab open and a tab never submits a
* second copy. It reports each step over the `music-video:auto-review` socket
* event; this hook only applies the pushed project and surfaces outcomes.
*
* Returns `{ busy, action, start(startSec, endSec, limits, reviewer), resume(runId, limits?), stop(runId), cancel(runId) }`
* — `action` is the latest step the server reported for this project's run.
*/
export default function useMusicVideoAutoReview({ project, replaceProject } = {}) {
const projectId = project?.id || null;
const [busy, setBusy] = useState(false);
const [action, setAction] = useState(null);
const handlers = useRef({ replaceProject });
const lastStatus = useRef(new Map());
useEffect(() => {
handlers.current = { replaceProject };
});
useEffect(() => {
if (!projectId) return undefined;
setAction(null);
const onAutoReview = (data) => {
if (data?.projectId !== projectId) return;
if (data.project) handlers.current.replaceProject?.(data.project);
setAction(data.action || null);
const run = data.run;
if (run?.id && lastStatus.current.get(run.id) !== run.status) {
const seen = lastStatus.current.has(run.id);
lastStatus.current.set(run.id, run.status);
if (seen || run.status !== 'running') OUTCOME_TOASTS[run.status]?.(run);
}
};
socket.on('music-video:auto-review', onAutoReview);
return () => socket.off('music-video:auto-review', onAutoReview);
}, [projectId]);
// A refusal for an open revision links to it; reload so the banner can show
// a revision this tab never saw.
const reload = () => getMusicVideoProject(projectId, { silent: true }).then((next) => handlers.current.replaceProject?.(next));
const call = (request) => {
setBusy(true);
return request()
.then((res) => {
if (res?.project) handlers.current.replaceProject?.(res.project);
if (res?.run) lastStatus.current.set(res.run.id, res.run.status);
return res;
})
.catch((err) => { toastWorkflowError(err, 'Auto-review request failed', { reload }); return null; })
.finally(() => setBusy(false));
};
const start = (startSec, endSec, limits, { providerId = null, model = null } = {}) =>
call(() => startMusicVideoAutoReview(projectId, {
startSec, endSec, limits, ...(providerId ? { providerId } : {}), ...(model ? { model } : {}),
}, { silent: true }));
const resume = (runId, limits) => call(() => resumeMusicVideoAutoReview(projectId, runId, limits ? { limits } : {}, { silent: true }));
const stop = (runId) => call(() => stopMusicVideoAutoReview(projectId, runId, { silent: true }));
const cancel = (runId) => call(() => cancelMusicVideoAutoReview(projectId, runId, { silent: true }));
return { busy, action, start, resume, stop, cancel };
}