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
/**
* The reactor.inc `fast-h3` clip contract: what one enqueued clip may ask for.
*
* fast-h3 renders 24fps clips and its `enqueue` command accepts a CONTINUOUS
* `seconds` value bounded to 5.167–14.375 (124–345 frames at 24fps — the same
* bounds `scripts/reactor-render.py` re-checks before it opens a session). The
* prompt is capped at 800 characters; a longer one is rejected by the API, not
* truncated, so PortOS has to stop it at the form.
*
* Its own dependency-free module rather than living inside
* `services/videoGen/reactor.js` for the `grokVideoClip.js` reason: the route
* schema, the FableLoom prompt compiler and the VideoGen picker all need these
* numbers, and hand-copied literals in a schema are how a schema and its
* service drift apart — `routes/videoGen.js` already accepted 1–60 seconds for
* a backend that rejects everything outside 5.167–14.375.
*
* `REACTOR_CLIP_LENGTHS` is a PICKER list, not an API constraint: because the
* accepted range is continuous but does not start or end on a round number, a
* free-text seconds box mostly offers the user a way to type a value the API
* refuses. The list is the two exact endpoints plus every whole second between
* them — whole seconds are frame-aligned at 24fps, so each entry is a real
* frame count.
*/
/** Longest prompt fast-h3 accepts, in characters. */
export const REACTOR_MAX_PROMPT_LENGTH = 800;
/** Frame rate fast-h3 delivers; the seconds bounds below are frame counts over it. */
export const REACTOR_CLIP_FPS = 24;
/** Shortest clip fast-h3 accepts (124 frames). */
export const REACTOR_MIN_CLIP_SECONDS = 5.167;
/** Longest clip fast-h3 accepts (345 frames). */
export const REACTOR_MAX_CLIP_SECONDS = 14.375;
/** Clip lengths the VideoGen picker offers, ascending. See the module note. */
export const REACTOR_CLIP_LENGTHS = Object.freeze([
REACTOR_MIN_CLIP_SECONDS, 6, 7, 8, 9, 10, 11, 12, 13, 14, REACTOR_MAX_CLIP_SECONDS,
]);
/** Fallback when a caller omits a clip length. */
export const REACTOR_DEFAULT_CLIP_LENGTH = 6;
/** Longest `continue_from_clip_id` PortOS will forward, in characters. */
export const REACTOR_MAX_CLIP_ID_LENGTH = 200;
/** Human label for one picker entry — the endpoints are odd enough to need naming. */
export const reactorClipLengthLabel = (seconds) => (
seconds === REACTOR_MIN_CLIP_SECONDS ? `${seconds} seconds (min)`
: seconds === REACTOR_MAX_CLIP_SECONDS ? `${seconds} seconds (max)`
: `${seconds} seconds`
);
/**
* The canvases fast-h3 renders, in `set_canvas`'s own `aspect` vocabulary.
*
* Every one holds a 768px SHORT edge — the model's native resolution — so the
* aspect string is the whole choice and the pixel size falls out of it. PortOS
* pinned `16:9` for every render before #6336, which is why a portrait starting
* frame came back as a clip with audio and no usable picture: reactor fits the
* starting frame to the SESSION canvas, so a 9:16 photo squeezed into a 1344×768
* session had almost nothing left to animate.
*
* Ordered widest-first so a picker reads landscape → square → portrait.
*/
export const REACTOR_CANVASES = Object.freeze([
Object.freeze({ aspect: '16:9', width: 1344, height: 768, label: 'Landscape 16:9 · 1344×768' }),
Object.freeze({ aspect: '4:3', width: 1024, height: 768, label: 'Standard 4:3 · 1024×768' }),
Object.freeze({ aspect: '1:1', width: 768, height: 768, label: 'Square 1:1 · 768×768' }),
Object.freeze({ aspect: '9:16', width: 768, height: 1344, label: 'Portrait 9:16 · 768×1344' }),
]);
/** Just the aspect strings — the closed set `set_canvas` accepts. */
export const REACTOR_ASPECTS = Object.freeze(REACTOR_CANVASES.map((c) => c.aspect));
/** Canvas a text-only render (or an unreadable starting frame) falls back to. */
export const REACTOR_DEFAULT_ASPECT = '16:9';
/** Canvas record for an aspect string; the default canvas for anything else. */
export const reactorCanvas = (aspect) => (
REACTOR_CANVASES.find((c) => c.aspect === aspect)
|| REACTOR_CANVASES.find((c) => c.aspect === REACTOR_DEFAULT_ASPECT)
);
/**
* The fast-h3 canvas closest to a starting frame's own shape, compared in log
* space so "twice as wide as the canvas" and "half as wide" score the same
* distance. Ties keep the earlier (wider) canvas. Anything unmeasurable —
* a missing dimension, a zero, a NaN — answers the default rather than
* pretending to have derived one.
*/
export const nearestReactorAspect = (width, height) => {
const w = Number(width);
const h = Number(height);
if (!Number.isFinite(w) || !Number.isFinite(h) || w <= 0 || h <= 0) return REACTOR_DEFAULT_ASPECT;
const target = Math.log(w / h);
let best = null;
for (const canvas of REACTOR_CANVASES) {
const distance = Math.abs(Math.log(canvas.width / canvas.height) - target);
if (best === null || distance < best.distance) best = { aspect: canvas.aspect, distance };
}
return best.aspect;
};