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
// Shared image-gen settings form. Bundles the backend chip strip + the
// per-model ImageGenControls grid + optional negativePrompt / extraStyle
// textareas behind a single `value`/`onChange` contract. Use it anywhere
// you'd otherwise hand-roll the same trio (Drawer settings panels, in-page
// config sections, modal pickers).
//
// Caller owns the `value` shape — typically a flat object like
// { mode, modelId, width, height, steps, guidance, negativePrompt, extraStyle }
// — and a single `onChange(next)` callback receives the merged object.
//
// `grouped` opts into organized, labeled sections (Backend / Model & LoRA /
// Prompts & Style) instead of one flat scroll — the lightweight alternative to
// full drawer tabs for the medium-sized pipeline image-gen drawers (NounsStage,
// ComicScriptStage). Left off (default) the form stays a flat `space-y-4` column
// so in-page hosts (UniverseBuilder's Batch-render card) keep their existing look.
import BackendChipStrip from '../media/BackendChipStrip';
import ImageGenControls from './ImageGenControls';
import LoraPicker from './LoraPicker';
import StylePresetPicker from '../media/StylePresetPicker';
import AutoSizeTextarea from '../ui/AutoSizeTextarea';
import { IMAGE_GEN_MODE } from '../../lib/imageGenBackends';
// Labeled card wrapper used only in `grouped` mode. Header is a plain heading
// (not interactive) so every control stays visible above the fold — organization
// without hiding anything behind a collapse.
function Section({ title, children }) {
return (
<section className="rounded-lg border border-port-border bg-port-bg/30 p-3">
<h3 className="text-[11px] font-semibold uppercase tracking-wider text-gray-500 mb-2">{title}</h3>
{children}
</section>
);
}
export default function ImageGenSettingsForm({
value,
onChange,
models = [],
availableBackends = [],
showStyleFields = true,
// LoRA picker — local mode only. Pass `availableLoras` + `currentRunnerFamily`
// to enable. `cfg.loras` holds the selected `[{ filename, name, scale }]`.
showLoras = false,
availableLoras = [],
currentRunnerFamily = null,
currentCompatKey = null,
onAppendTrigger = null,
// Style preset picker — sits above the extra-style textarea. `cfg.stylePreset`
// holds the full preset object (not just the id) so consumers can compose
// styled prompts without a second lookup.
showStylePreset = false,
// Render as labeled sections (see module header) instead of a flat column.
grouped = false,
disabled = false,
}) {
const cfg = value || {};
const merge = (patch) => onChange?.({ ...cfg, ...patch });
const isCodex = cfg.mode === IMAGE_GEN_MODE.CODEX;
const isGrok = cfg.mode === IMAGE_GEN_MODE.GROK;
const isAgy = cfg.mode === IMAGE_GEN_MODE.AGY;
const isFal = cfg.mode === IMAGE_GEN_MODE.FAL;
const isLocal = cfg.mode === IMAGE_GEN_MODE.LOCAL;
const labelCls = 'block text-xs font-medium text-gray-400 mb-1';
const textareaCls = 'w-full bg-port-bg border border-port-border rounded-lg px-2 py-2 text-sm text-white focus:outline-none focus:border-port-accent disabled:opacity-50 min-h-[60px]';
const noBackend = availableBackends.length === 0 ? (
<div className="text-[11px] text-port-warning bg-port-warning/10 border border-port-warning/40 rounded px-2 py-1.5">
No image gen backend configured. Open Settings → Image Gen to enable a local, external, or cloud CLI backend.
</div>
) : null;
const backendPicker = availableBackends.length > 0 ? (
<div>
<span className={labelCls}>Backend</span>
<BackendChipStrip
availableBackends={availableBackends}
value={cfg.mode}
onChange={(id) => merge({ mode: id })}
size="md"
ariaLabel="Image gen backend"
titlePrefix="Render via"
disabled={disabled}
/>
{isCodex ? (
<p className="text-[10px] text-gray-500 mt-1">
Codex's <code className="text-gray-400">$imagegen</code> picks model, steps, and seed internally. Only resolution + style fields apply.
</p>
) : isGrok ? (
<p className="text-[10px] text-gray-500 mt-1">
Grok's <code className="text-gray-400">image_gen</code> picks model, steps, and seed internally. Resolution maps to the nearest supported aspect ratio; style fields apply.
</p>
) : isAgy ? (
<p className="text-[10px] text-gray-500 mt-1">
Agy's <code className="text-gray-400">generate_image</code> picks the image model internally
and supports text-to-image only. The model in Settings is the <em>agent</em> that drives the
tool. Style fields apply; resolution maps to the nearest supported aspect ratio.
</p>
) : isFal ? (
<p className="text-[10px] text-gray-500 mt-1">
fal.ai renders on the model chosen in Settings → Image Gen → fal.ai (or this surface’s
render pin) and is billed per image. Reference images route to that model’s edit
endpoint; resolution maps to the model’s nearest supported size.
</p>
) : null}
</div>
) : null;
const controls = (
<ImageGenControls
mode={cfg.mode}
models={models}
modelId={cfg.modelId}
onModelChange={(modelId) => merge({ modelId, steps: '', guidance: '' })}
width={cfg.width}
height={cfg.height}
onResolutionChange={(width, height) => merge({ width, height })}
steps={cfg.steps}
onStepsChange={(steps) => merge({ steps })}
guidance={cfg.guidance}
onGuidanceChange={(guidance) => merge({ guidance })}
cfgScale={cfg.cfgScale}
onCfgScaleChange={(cfgScale) => merge({ cfgScale })}
quantize={cfg.quantize}
onQuantizeChange={(quantize) => merge({ quantize })}
seed={cfg.seed}
onSeedChange={(seed) => merge({ seed })}
showSeed
disabled={disabled}
/>
);
const loraPicker = showLoras && isLocal && models.find(model => model.id === cfg.modelId)?.supportsLoras === false && cfg.loras?.length ? (
<p className="text-xs text-port-warning">
This model cannot use the selected LoRAs.
<button type="button" disabled={disabled} className="ml-2 min-h-[44px] text-port-accent" onClick={() => merge({ loras: [] })}>Remove selected LoRAs</button>
</p>
) : showLoras && isLocal && models.find(model => model.id === cfg.modelId)?.supportsLoras !== false ? (
<LoraPicker
availableLoras={availableLoras}
selected={Array.isArray(cfg.loras) ? cfg.loras : []}
onChange={(loras) => merge({ loras })}
currentRunnerFamily={currentRunnerFamily}
currentCompatKey={currentCompatKey}
onAppendTrigger={onAppendTrigger}
disabled={disabled}
/>
) : null;
const stylePreset = showStylePreset ? (
<StylePresetPicker
value={cfg.stylePreset?.id || ''}
onChange={(preset) => merge({ stylePreset: preset })}
disabled={disabled}
/>
) : null;
const styleFields = showStyleFields ? (
<div className="space-y-3">
<label htmlFor="image-gen-extra-style" className="block">
<span className={labelCls}>Extra style (optional)</span>
<AutoSizeTextarea
id="image-gen-extra-style"
rows={2}
value={cfg.extraStyle || ''}
onChange={(e) => merge({ extraStyle: e.target.value })}
placeholder="cinematic ink, bold panel borders…"
className={textareaCls}
disabled={disabled}
/>
</label>
<label htmlFor="image-gen-negative-prompt" className="block">
<span className={labelCls}>Negative prompt (optional)</span>
<AutoSizeTextarea
id="image-gen-negative-prompt"
rows={2}
value={cfg.negativePrompt || ''}
onChange={(e) => merge({ negativePrompt: e.target.value })}
placeholder="things to avoid, comma separated…"
className={textareaCls}
disabled={disabled}
/>
</label>
</div>
) : null;
// Grouped: organized cards. Skip the Prompts & Style section entirely when it
// has no content so an empty card never shows with both pickers disabled.
if (grouped) {
const hasPrompts = !!(stylePreset || styleFields);
return (
<div className="space-y-4">
{noBackend}
{backendPicker ? <Section title="Backend">{backendPicker}</Section> : null}
<Section title="Model & LoRA">
<div className="space-y-4">
{controls}
{loraPicker}
</div>
</Section>
{hasPrompts ? (
<Section title="Prompts & Style">
<div className="space-y-3">
{stylePreset}
{styleFields}
</div>
</Section>
) : null}
</div>
);
}
return (
<div className="space-y-4">
{noBackend}
{backendPicker}
{controls}
{loraPicker}
{stylePreset}
{styleFields}
</div>
);
}