Skip to content

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

17.4 KB
Raw Blame
/**
 * FableLoom index — branching narratives.
 *
 * Lists every loom (a branching-narrative story: episodes of scene graphs a
 * reader plays through by chatting intents) and creates new ones. The list
 * endpoint returns summaries (counts, not the episode graphs); the heavy
 * visual editor lives at /fableloom/:loomId/:episodeId.
 */

import { useCallback, useMemo, useState } from 'react';
import { useNavigate } from 'react-router';
import { Plus, Sparkles, Trash2, Waypoints } from 'lucide-react';
import PageHeader from '../components/PageHeader';
import ProviderModelSelector from '../components/ProviderModelSelector';
import ConfirmButtonPair from '../components/ui/ConfirmButtonPair';
import SyncToPeerButton from '../components/sharing/SyncToPeerButton';
import { FormField } from '../components/ui/FormField.jsx';
import PageSkeleton from '../components/ui/PageSkeleton';
import ListLoadError from '../components/ui/ListLoadError';
import Pill from '../components/ui/Pill';
import { useAsyncAction } from '../hooks/useAsyncAction';
import useListResource from '../hooks/useListResource';
import { useConfirmDelete } from '../hooks/useConfirmDelete';
import useProviderModels from '../hooks/useProviderModels';
import toast from '../components/ui/Toast';
import { timeAgo } from '../utils/formatters';
import { effectiveModelFor, effortAwareModelOptions } from '../utils/providers';
import { fieldClass, labelClass } from '../components/fableloom/fieldStyles';
import { LOOM_FORMATS, isTeleplayFormat, loomFormatLabel } from '../components/fableloom/loomFormats';
import {
  createLoom, deleteLoom, generateLoomSeriesPlan, listLooms, listPipelineSeriesNames, listUniverseNames,
} from '../services/api';
import { FABLELOOM_PARTICIPATION_MODES } from '../../../server/lib/fableLoomParticipation.js';

const emptyForm = () => ({
  name: '', logline: '', premise: '', styleNotes: '', format: 'prose',
  participationMode: 'helper', audienceCommunicationMedium: '', universeId: '', seriesId: '',
});

export default function FableLoom() {
  const navigate = useNavigate();
  const fetchLooms = useCallback(() => listLooms({ silent: true }), []);
  const loomsResource = useListResource(fetchLooms);
  const { items: looms, setItems: setLooms } = loomsResource;
  const fetchUniverses = useCallback(() => listUniverseNames({ silent: true }), []);
  const universesResource = useListResource(fetchUniverses);
  const fetchSeries = useCallback(() => listPipelineSeriesNames({ silent: true }), []);
  const seriesResource = useListResource(fetchSeries);
  const universes = universesResource.items;
  const series = seriesResource.items;
  const [showForm, setShowForm] = useState(false);
  const [form, setForm] = useState(emptyForm());
  const [planRoute, setPlanRoute] = useState({ providerId: '', model: '', effort: '' });
  const { providers, loading: providersLoading } = useProviderModels({
    allowDefault: true, enabled: showForm, silent: true, withEffort: true,
  });
  const del = useConfirmDelete();

  const universeNames = useMemo(() => new Map(universes.map((u) => [u.id, u.name])), [universes]);
  const seriesNames = useMemo(() => new Map(series.map((s) => [s.id, s.name])), [series]);

  const planProvider = providers.find((provider) => provider.id === planRoute.providerId);
  const planRouteBody = {
    ...(planRoute.providerId ? { providerId: planRoute.providerId } : {}),
    ...(planRoute.model ? { model: planRoute.model } : {}),
    ...(planRoute.effort ? { effort: planRoute.effort } : {}),
  };

  const [runCreate, creating] = useAsyncAction(async (draftPlan = false) => {
    const loom = await createLoom({
      name: form.name.trim(),
      logline: form.logline,
      premise: form.premise,
      styleNotes: form.styleNotes,
      format: form.format,
      participationMode: form.participationMode,
      audienceCommunicationMedium: form.participationMode === 'helper' ? form.audienceCommunicationMedium.trim() : '',
      universeId: form.universeId || null,
      seriesId: form.seriesId || null,
    }, { silent: true });
    if (draftPlan) {
      const generated = await generateLoomSeriesPlan(loom.id, planRouteBody, { silent: true })
        .catch((error) => {
          toast.error(`Loom created, but plan drafting failed: ${error.message}`);
          return null;
        });
      if (generated) toast.success('Loom created with a full series-plan draft');
    }
    navigate(`/fableloom/${loom.id}/plan`);
  }, { errorMessage: 'Could not create the loom' });

  const handleCreate = (event) => {
    event.preventDefault();
    if (!form.name.trim() || creating) return;
    runCreate(event.nativeEvent.submitter?.value === 'draft');
  };

  const handleDelete = async (id) => {
    const ok = await deleteLoom(id).then(() => true).catch(() => false);
    if (ok) setLooms((prev) => prev.filter((l) => l.id !== id));
    del.cancelDelete();
  };

  return (
    <div className="flex h-full min-h-0 flex-col">
      <PageHeader
        icon={Waypoints}
        title="FableLoom"
        subtitle="Branching narratives readers play through by chatting their intents — every episode is a graph of scenes with multiple endings."
        actions={(
          <button
            type="button"
            onClick={() => setShowForm((v) => !v)}
            className="flex items-center gap-1.5 px-3 py-2 rounded bg-port-accent text-white text-sm"
          >
            <Plus size={15} /> New loom
          </button>
        )}
      />
      <div className="flex-1 min-h-0 overflow-auto p-4 space-y-6">
        {showForm && (
          <form onSubmit={handleCreate} className="bg-port-card border border-port-border rounded-lg p-4 space-y-3">
            <div className="grid gap-3 md:grid-cols-2">
              <FormField label="Name" labelClassName={labelClass}>
                <input
                  className={fieldClass}
                  value={form.name}
                  onChange={(e) => setForm((p) => ({ ...p, name: e.target.value }))}
                  placeholder="e.g. The Hollow Crown"
                  required
                />
              </FormField>
              <FormField label="Logline" labelClassName={labelClass}>
                <input
                  className={fieldClass}
                  value={form.logline}
                  onChange={(e) => setForm((p) => ({ ...p, logline: e.target.value }))}
                  placeholder="One sentence of premise"
                />
              </FormField>
              <FormField label="Scene format" labelClassName={labelClass}>
                <select
                  className={fieldClass}
                  value={form.format}
                  onChange={(e) => setForm((p) => ({ ...p, format: e.target.value }))}
                >
                  {LOOM_FORMATS.map((f) => <option key={f.id} value={f.id}>{f.label}</option>)}
                </select>
              </FormField>
              <FormField label="Audience role" labelClassName={labelClass}>
                <select
                  className={fieldClass}
                  value={form.participationMode}
                  onChange={(e) => setForm((p) => ({ ...p, participationMode: e.target.value }))}
                >
                  {FABLELOOM_PARTICIPATION_MODES.map((mode) => (
                    <option key={mode} value={mode}>
                      {mode === 'helper' ? 'Audience helps the protagonist' : 'Audience acts as the protagonist'}
                    </option>
                  ))}
                </select>
              </FormField>
              {form.participationMode === 'helper' && (
                <FormField label="Audience communication medium" labelClassName={labelClass}>
                  <textarea
                    rows={2}
                    className={fieldClass}
                    value={form.audienceCommunicationMedium}
                    onChange={(e) => setForm((p) => ({ ...p, audienceCommunicationMedium: e.target.value }))}
                    placeholder="e.g. a cracked field radio the protagonist activates in the opening"
                    required
                  />
                </FormField>
              )}
              <FormField label="Universe (canon + style for AI)" labelClassName={labelClass}>
                <select
                  className={fieldClass}
                  value={form.universeId}
                  onChange={(e) => setForm((p) => ({ ...p, universeId: e.target.value }))}
                >
                  <option value="">No universe</option>
                  {universes.map((u) => <option key={u.id} value={u.id}>{u.name}</option>)}
                </select>
                {universesResource.state === 'error' && (
                  <ListLoadError what="universes" error={universesResource.error} onRetry={universesResource.retry} className="mt-2" />
                )}
              </FormField>
              <FormField label="Part of series (optional)" labelClassName={labelClass}>
                <select
                  className={fieldClass}
                  value={form.seriesId}
                  onChange={(e) => setForm((p) => ({ ...p, seriesId: e.target.value }))}
                >
                  <option value="">Standalone</option>
                  {series.map((s) => <option key={s.id} value={s.id}>{s.name}</option>)}
                </select>
                {seriesResource.state === 'error' && (
                  <ListLoadError what="series" error={seriesResource.error} onRetry={seriesResource.retry} className="mt-2" />
                )}
              </FormField>
            </div>
            <FormField label="Premise" labelClassName={labelClass}>
              <textarea
                rows={3}
                className={fieldClass}
                value={form.premise}
                onChange={(e) => setForm((p) => ({ ...p, premise: e.target.value }))}
                placeholder="The setup, stakes, and tone the AI should weave from"
              />
            </FormField>
            <FormField label="Image style notes (appended to every scene render prompt)" labelClassName={labelClass}>
              <textarea
                rows={2}
                className={fieldClass}
                value={form.styleNotes}
                onChange={(e) => setForm((p) => ({ ...p, styleNotes: e.target.value }))}
                placeholder="e.g. painterly, muted palette, storybook illustration"
              />
            </FormField>
            <section className="border-t border-port-border pt-3 space-y-2">
              <div>
                <h2 className="text-sm font-semibold flex items-center gap-1.5">
                  <Sparkles size={14} className="text-port-accent" /> AI series-plan draft
                </h2>
                <p className="text-xs text-port-text-muted mt-1">
                  Optionally draft the complete arc, ordered plot points, and side quests from
                  these story details and the linked universe canon.
                </p>
              </div>
              <ProviderModelSelector
                providers={providers}
                selectedProviderId={planRoute.providerId}
                selectedModel={planRoute.model}
                availableModels={effortAwareModelOptions(planProvider, planRoute.model)}
                onProviderChange={(providerId) => setPlanRoute({ providerId, model: '', effort: '' })}
                onModelChange={(model) => setPlanRoute((current) => ({ ...current, model }))}
                effort={planRoute.effort}
                onEffortChange={(effort) => setPlanRoute((current) => ({ ...current, effort }))}
                label="Plan AI provider"
                disabled={creating || providersLoading}
                modelDisabled={creating || providersLoading}
                loading={providersLoading}
                emptyProviderOption="Default (series-plan stage or active provider)"
                emptyModelOption="Default model"
                alwaysShowModel={!!planRoute.providerId}
              />
              {planProvider ? (
                <p className="text-xs text-port-text-muted">
                  The draft will use {planProvider.name}{effectiveModelFor(planProvider, planRoute.model) ? ` (${effectiveModelFor(planProvider, planRoute.model)})` : ''}.
                </p>
              ) : null}
            </section>
            <div className="flex flex-col-reverse sm:flex-row sm:justify-end gap-2">
              <button
                type="submit"
                value="empty"
                disabled={creating || !form.name.trim() || (form.participationMode === 'helper' && !form.audienceCommunicationMedium.trim())}
                className="px-4 py-2 rounded border border-port-border text-sm hover:border-port-accent disabled:opacity-50"
              >
                {creating ? 'Creating…' : 'Create loom'}
              </button>
              <button
                type="submit"
                value="draft"
                disabled={creating || providersLoading || !form.name.trim() || (form.participationMode === 'helper' && !form.audienceCommunicationMedium.trim())}
                className="flex items-center justify-center gap-1.5 px-4 py-2 rounded bg-port-accent text-white text-sm disabled:opacity-50"
              >
                <Sparkles size={14} /> {creating ? 'Creating…' : 'Create & draft plan'}
              </button>
            </div>
          </form>
        )}

        {loomsResource.state === 'loading' ? (
          <PageSkeleton header="none" label="Loading branching narratives" cards={4} sidebar={false} layout="grid" />
        ) : loomsResource.state === 'error' ? (
          <ListLoadError what="branching narratives" error={loomsResource.error} onRetry={loomsResource.retry} />
        ) : looms.length === 0 ? (
          <div className="text-center py-16 border border-dashed border-port-border rounded-lg">
            <Waypoints size={32} className="mx-auto text-port-text-muted mb-3" />
            <p className="text-sm text-port-text-muted">
              No branching narratives yet. Create a loom, shape its series plan, then weave its episodes.
            </p>
            <button
              type="button"
              onClick={() => setShowForm(true)}
              className="mt-4 inline-flex items-center gap-1.5 px-3 py-2 rounded bg-port-accent text-white text-sm"
            >
              <Plus size={15} /> Create your first loom
            </button>
          </div>
        ) : (
          <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
            {looms.map((loom) => (
              <div
                key={loom.id}
                className="min-w-0 bg-port-card border border-port-border rounded-lg p-4 hover:border-port-accent transition-colors cursor-pointer"
                role="link"
                tabIndex={0}
                onClick={() => navigate(`/fableloom/${loom.id}`)}
                onKeyDown={(e) => { if (e.key === 'Enter') navigate(`/fableloom/${loom.id}`); }}
              >
                <div className="flex min-w-0 items-start justify-between gap-2">
                  <div className="min-w-0 flex-1 break-words">
                    <h2 className="font-medium break-words">{loom.name}</h2>
                    {loom.logline && <p className="text-xs text-port-text-muted mt-0.5 line-clamp-2 break-words">{loom.logline}</p>}
                  </div>
                  <div className="shrink-0" onClick={(e) => e.stopPropagation()} onKeyDown={(e) => e.stopPropagation()} role="none">
                    <div className="flex items-center gap-1">
                      <SyncToPeerButton recordKind="fableLoom" recordId={loom.id} compact />
                      {del.isConfirming(loom.id) ? (
                        <ConfirmButtonPair
                          prompt="Delete?"
                          onConfirm={() => handleDelete(loom.id)}
                          onCancel={del.cancelDelete}
                          largeTouchTargets
                        />
                      ) : (
                        <button
                          type="button"
                          aria-label={`Delete ${loom.name}`}
                          onClick={() => del.requestDelete(loom.id)}
                          className="min-h-[44px] min-w-[44px] inline-flex items-center justify-center text-port-text-muted hover:text-port-error p-1"
                        >
                          <Trash2 size={15} />
                        </button>
                      )}
                    </div>
                  </div>
                </div>
                <div className="flex items-center gap-3 mt-3 text-xs text-port-text-muted flex-wrap">
                  <span>{loom.episodeCount} episode{loom.episodeCount === 1 ? '' : 's'}</span>
                  <span>{loom.sceneCount} scene{loom.sceneCount === 1 ? '' : 's'}</span>
                  <span>{loom.endingCount} ending{loom.endingCount === 1 ? '' : 's'}</span>
                  {universeNames.has(loom.universeId) && (
                    <Pill tone="accent" bordered={false}>{universeNames.get(loom.universeId)}</Pill>
                  )}
                  {seriesNames.has(loom.seriesId) && (
                    <Pill tone="muted">{seriesNames.get(loom.seriesId)}</Pill>
                  )}
                  {loom.participationMode === 'helper' && <Pill tone="accent" bordered={false}>Audience helper</Pill>}
                  {isTeleplayFormat(loom.format) && <Pill tone="muted">{loomFormatLabel(loom.format)}</Pill>}
                  <span className="ml-auto">{timeAgo(loom.updatedAt)}</span>
                </div>
              </div>
            ))}
          </div>
        )}
      </div>
    </div>
  );
}