@rslsp1/fa-app-tools 2.0.81 → 2.0.83

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   SzenenView,
   createFlowSzenenViewPort
-} from "./chunk-GEGJD43Y.mjs";
+} from "./chunk-JTGC5PXJ.mjs";
 import "./chunk-FUY2OCVC.mjs";
 import {
   exportProjectToZip,
@@ -30,7 +30,7 @@ import {
 } from "./chunk-VBWQP7PO.mjs";
 
 // package.json
-var version = "2.0.81";
+var version = "2.0.83";
 
 // src/hooks/useOnClickOutside.ts
 import { useEffect } from "react";
@@ -2922,6 +2922,21 @@ function validateTagBaseSelection(base, userId, contextId) {
 // src/hooks/useTagBase.ts
 var USER_ID_KEY = "aa-user-id";
 var CONTEXT_ID_KEY = "aa-context-id";
+var IDENTITY_NAMESPACE_KEY = "aa-identity-namespace";
+function readStoredNamespace() {
+  try {
+    return localStorage.getItem(IDENTITY_NAMESPACE_KEY);
+  } catch {
+    return null;
+  }
+}
+function writeStoredNamespace(namespace) {
+  try {
+    if (namespace === null) localStorage.removeItem(IDENTITY_NAMESPACE_KEY);
+    else localStorage.setItem(IDENTITY_NAMESPACE_KEY, namespace);
+  } catch {
+  }
+}
 function readStoredId(key) {
   try {
     const v = localStorage.getItem(key);
@@ -2958,6 +2973,16 @@ function useTagBase(token, namespace) {
   }, [selectedContextId]);
   const load = useCallback2(async () => {
     if (!token || !namespace) return;
+    if (readStoredNamespace() !== namespace) {
+      selectedUserIdRef.current = null;
+      selectedContextIdRef.current = null;
+      setSelectedUserId(null);
+      setSelectedContextId(null);
+      writeStoredId(USER_ID_KEY, null);
+      writeStoredId(CONTEXT_ID_KEY, null);
+      writeStoredNamespace(namespace);
+      setPickerMessage(null);
+    }
     setIsLoading(true);
     setError(null);
     try {
@@ -2996,16 +3021,19 @@ function useTagBase(token, namespace) {
     setSelectedContextId(null);
     writeStoredId(USER_ID_KEY, userId);
     writeStoredId(CONTEXT_ID_KEY, null);
-  }, []);
+    writeStoredNamespace(namespace);
+  }, [namespace]);
   const selectContext = useCallback2((contextId) => {
     setSelectedContextId(contextId);
     writeStoredId(CONTEXT_ID_KEY, contextId);
-  }, []);
+    writeStoredNamespace(namespace);
+  }, [namespace]);
   const resetSelection = useCallback2(() => {
     setSelectedUserId(null);
     setSelectedContextId(null);
     writeStoredId(USER_ID_KEY, null);
     writeStoredId(CONTEXT_ID_KEY, null);
+    writeStoredNamespace(null);
     setPickerMessage(null);
   }, []);
   const validation = tagBase ? validateTagBaseSelection(tagBase, selectedUserId, selectedContextId) : { valid: false, reason: null };
@@ -5712,6 +5740,57 @@ function FlowWorkspacePicker({
   ] }) });
 }
 
+// src/lib/flowBootstrapTarget.ts
+var PROD_NAMESPACE = "app.art-by-rolands.de/";
+var DEV_NAMESPACE = "dev-app.art-by-rolands.de/";
+var SELECTABLE_NAMESPACES = [PROD_NAMESPACE, DEV_NAMESPACE];
+var DEFAULT_NAMESPACE = PROD_NAMESPACE;
+function environmentForNamespace(namespace) {
+  if (!namespace) return null;
+  if (namespace === DEV_NAMESPACE) return "dev";
+  if (namespace === PROD_NAMESPACE) return "prod";
+  return null;
+}
+function normalizeSelectableNamespace(namespace) {
+  return namespace && SELECTABLE_NAMESPACES.includes(namespace) ? namespace : DEFAULT_NAMESPACE;
+}
+function resolveBootstrapTarget(input) {
+  const { hostNamespace, serverNamespace, isProbingServer = false } = input;
+  if (hostNamespace) {
+    return {
+      source: "host",
+      phase: "ready",
+      ready: true,
+      namespace: hostNamespace,
+      environment: environmentForNamespace(hostNamespace)
+    };
+  }
+  if (serverNamespace) {
+    return {
+      source: "server",
+      phase: "ready",
+      ready: true,
+      namespace: serverNamespace,
+      environment: environmentForNamespace(serverNamespace)
+    };
+  }
+  if (isProbingServer) {
+    return { source: "server", phase: "probing", ready: false, namespace: null, environment: null };
+  }
+  const { selectedNamespace, isStartDialogOpen = false } = input;
+  if (isStartDialogOpen) {
+    return { source: "dialog", phase: "awaiting-choice", ready: false, namespace: null, environment: null };
+  }
+  const namespace = normalizeSelectableNamespace(selectedNamespace);
+  return {
+    source: "dialog",
+    phase: "ready",
+    ready: true,
+    namespace,
+    environment: environmentForNamespace(namespace)
+  };
+}
+
 // src/components/AvatarArchitectApp.tsx
 import { Fragment as Fragment11, jsx as jsx29, jsxs as jsxs27 } from "react/jsx-runtime";
 function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onSelectMedia, buildInfo, initialHfToken, hfNamespace, allowDevNamespace, requireWorkspaceSelection = false, serverBaseUrl, onFetchServerProjects, onServerSave, onServerLoad, onServerDelete }) {
@@ -5738,31 +5817,38 @@ function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onS
   const [hfTokenInput, setHfTokenInput] = useState25(initialHfToken || "");
   const [isLoadingFromHF, setIsLoadingFromHF] = useState25(false);
   const [hfNamespaceLocal, setHfNamespaceLocal] = useState25(() => {
-    const KNOWN = ["app.art-by-rolands.de/", "dev-app.art-by-rolands.de/"];
-    const DEFAULT = "app.art-by-rolands.de/";
     try {
-      const stored = localStorage.getItem("aa-hf-namespace");
-      if (stored && KNOWN.includes(stored)) return stored;
-      localStorage.setItem("aa-hf-namespace", DEFAULT);
-      return DEFAULT;
+      return normalizeSelectableNamespace(localStorage.getItem("aa-hf-namespace"));
     } catch {
-      return DEFAULT;
+      return DEFAULT_NAMESPACE;
     }
   });
   const [hfNamespaceFromServer, setHfNamespaceFromServer] = useState25(null);
+  const [serverProbeFailed, setServerProbeFailed] = useState25(false);
   useEffect10(() => {
     if (hfNamespace !== void 0 || !serverBaseUrl) return;
     fetch(`${serverBaseUrl}/api/status`).then((r) => r.json()).then((d) => {
       if (typeof d.hfNamespace === "string" && d.hfNamespace) setHfNamespaceFromServer(d.hfNamespace);
-    }).catch(() => {
-    });
+      else setServerProbeFailed(true);
+    }).catch(() => setServerProbeFailed(true));
   }, [hfNamespace, serverBaseUrl]);
-  const effectiveNamespace = hfNamespace ?? hfNamespaceFromServer ?? hfNamespaceLocal;
-  const szenenPort = useMemo6(() => hfToken ? createFlowSzenenViewPort({
+  const [targetConfirmed, setTargetConfirmed] = useState25(false);
+  const isDialogTarget = hfNamespace === void 0 && hfNamespaceFromServer === null && (!serverBaseUrl || serverProbeFailed);
+  const isProbingServer = hfNamespace === void 0 && !!serverBaseUrl && hfNamespaceFromServer === null && !serverProbeFailed;
+  const bootstrapTarget = resolveBootstrapTarget({
+    hostNamespace: hfNamespace,
+    serverNamespace: hfNamespaceFromServer,
+    isProbingServer,
+    selectedNamespace: hfNamespaceLocal,
+    isStartDialogOpen: isDialogTarget && !targetConfirmed
+  });
+  const effectiveNamespace = bootstrapTarget.namespace ?? "";
+  const szenenPort = useMemo6(() => hfToken && effectiveNamespace ? createFlowSzenenViewPort({
     generateText: onGeneratePrompt,
     token: hfToken,
-    namespace: effectiveNamespace
-  }) : null, [hfToken, effectiveNamespace, onGeneratePrompt]);
+    namespace: effectiveNamespace,
+    generateImage: onGenerateImage
+  }) : null, [hfToken, effectiveNamespace, onGeneratePrompt, onGenerateImage]);
   const {
     state: hfState,
     isLoading: isHfRefreshing,
@@ -5836,6 +5922,7 @@ function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onS
     } catch {
     }
     setLayoutChoice(choice);
+    setTargetConfirmed(true);
     setShowStart(false);
   };
   const [nodes, setNodes] = useState25([{ id: "1", type: "custom", position: { x: 0, y: 0 }, data: { label: "Fine Art Project", placeholder: "Name..." } }]);
@@ -6597,45 +6684,6 @@ function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onS
     const all = Object.entries(merged).flatMap(([cat, tags]) => tags.map((t) => ({ ...t, category: cat })));
     return { by_category: merged, all };
   };
-  if (requireWorkspaceSelection) {
-    if (!hfToken) {
-      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsx29("section", { className: "flow-workspace-picker__card", role: "alert", children: "HF-Token fehlt \u2014 User und Context koennen nicht aus der Tag-Base geladen werden." }) });
-    }
-    if (tagBaseResult.isLoading) {
-      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsxs27("section", { className: "flow-workspace-picker__card", children: [
-        "Lade User und Contexts aus ",
-        effectiveNamespace,
-        "\u2026"
-      ] }) });
-    }
-    if (tagBaseResult.error) {
-      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsxs27("section", { className: "flow-workspace-picker__card", role: "alert", children: [
-        "Tag-Base ",
-        effectiveNamespace,
-        " konnte nicht geladen werden: ",
-        tagBaseResult.error
-      ] }) });
-    }
-    if (!tagBaseResult.tagBase) {
-      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsxs27("section", { className: "flow-workspace-picker__card", role: "alert", children: [
-        "Im Namespace ",
-        effectiveNamespace,
-        " fehlt tags-state-*.zip. Der Server muss zuerst die Tag-Base erzeugen."
-      ] }) });
-    }
-    if (tagBaseResult.needsPicker) {
-      return /* @__PURE__ */ jsx29(
-        FlowWorkspacePicker,
-        {
-          tagBase: tagBaseResult.tagBase,
-          selectedUserId: tagBaseResult.selectedUserId,
-          message: tagBaseResult.pickerMessage,
-          onSelectUser: tagBaseResult.selectUser,
-          onSelectContext: tagBaseResult.selectContext
-        }
-      );
-    }
-  }
   if (isFullscreen && currentResult?.base64) {
     const fsRaw = currentResult.fullBase64 || currentResult.base64;
     const fsBase64 = fsRaw.startsWith("data:") ? fsRaw : `data:image/png;base64,${fsRaw}`;
@@ -6779,7 +6827,7 @@ function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onS
             }
           )
         ] }),
-        !hfNamespace && /* @__PURE__ */ jsxs27("div", { className: "flex items-center gap-3 w-full", children: [
+        isDialogTarget && /* @__PURE__ */ jsxs27("div", { className: "flex items-center gap-3 w-full", children: [
           /* @__PURE__ */ jsx29("span", { className: "text-white/25 text-[10px] uppercase tracking-widest font-bold flex-shrink-0", children: "State:" }),
           ["app.art-by-rolands.de/", "dev-app.art-by-rolands.de/"].map((ns, i) => /* @__PURE__ */ jsx29(
             "button",
@@ -6864,7 +6912,7 @@ function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onS
           "button",
           {
             type: "button",
-            disabled: !szenenPort,
+            disabled: !szenenPort || !bootstrapTarget.ready,
             onClick: () => setShowSzenen(true),
             children: [
               /* @__PURE__ */ jsx29("span", { className: "material-symbols-outlined", children: "movie" }),
@@ -6899,6 +6947,48 @@ function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onS
       ] })
     ] });
   }
+  if (requireWorkspaceSelection) {
+    if (!bootstrapTarget.ready) {
+      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsx29("section", { className: "flow-workspace-picker__card", children: "Zielraum wird bestimmt\u2026" }) });
+    }
+    if (!hfToken) {
+      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsx29("section", { className: "flow-workspace-picker__card", role: "alert", children: "HF-Token fehlt \u2014 User und Context koennen nicht aus der Tag-Base geladen werden." }) });
+    }
+    if (tagBaseResult.isLoading) {
+      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsxs27("section", { className: "flow-workspace-picker__card", children: [
+        "Lade User und Contexts aus ",
+        effectiveNamespace,
+        "\u2026"
+      ] }) });
+    }
+    if (tagBaseResult.error) {
+      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsxs27("section", { className: "flow-workspace-picker__card", role: "alert", children: [
+        "Tag-Base ",
+        effectiveNamespace,
+        " konnte nicht geladen werden: ",
+        tagBaseResult.error
+      ] }) });
+    }
+    if (!tagBaseResult.tagBase) {
+      return /* @__PURE__ */ jsx29("main", { className: "flow-workspace-picker", children: /* @__PURE__ */ jsxs27("section", { className: "flow-workspace-picker__card", role: "alert", children: [
+        "Im Namespace ",
+        effectiveNamespace,
+        " fehlt tags-state-*.zip. Der Server muss zuerst die Tag-Base erzeugen."
+      ] }) });
+    }
+    if (tagBaseResult.needsPicker) {
+      return /* @__PURE__ */ jsx29(
+        FlowWorkspacePicker,
+        {
+          tagBase: tagBaseResult.tagBase,
+          selectedUserId: tagBaseResult.selectedUserId,
+          message: tagBaseResult.pickerMessage,
+          onSelectUser: tagBaseResult.selectUser,
+          onSelectContext: tagBaseResult.selectContext
+        }
+      );
+    }
+  }
   if (layoutChoice === "mobile" || layoutChoice === "mobile-desktop") {
     const mdMode = layoutChoice === "mobile-desktop";
     const mdScale = mdMode ? window.innerWidth / 430 : 1;

package/dist/szenen.d.mts

@@ -631,7 +631,53 @@ declare const SZENEN_EVENT_TYPES: {
      * falls eine entstand.
      */
     readonly imageGenerationFinished: "szenen.image_generation_finished";
+    /**
+     * Ein Bild-Batch ist kanonisch gespeichert — Stufe 6.9.2, Gate D
+     * (D-6.9.2-6).
+     *
+     * Erscheint erst, **nachdem** jedes Bild des Batches im Bildbestand liegt
+     * (`hfUploadImage` + `image_added`, dieselbe Reihenfolge wie
+     * `hfImageLibrary.putImage`) — kein Bild gilt als vorhanden, bevor sein
+     * Upload bestätigt ist (R3). Trägt bewusst **keine Bilddaten**, nur den
+     * vollständigen Metadatennachweis, den `listBatchesForPromptRun()` /
+     * `getBatch()` ohne MySQL rekonstruieren können müssen: `item_id`,
+     * `prompt_run_id`, `generation_batch_id`, `source_kind`, je Bild
+     * `position`, `media_ref`, `asset_id`, `model`, `seed`, `width`/`height`.
+     *
+     * Additiv wie jedes Ereignis dieser Domain: ein zweiter Batch desselben
+     * Laufs ist ein **weiteres** Ereignis mit derselben `item_id`, nicht eine
+     * Änderung am ersten (D-113/D-121 — ein Lauf bleibt ein Item). Gilt für
+     * `generated_in_app` **und** `external_import` — nur `source_kind`
+     * unterscheidet die beiden Schreiber (D-116/D-117/D-120).
+     *
+     * Der Elementreducer ignoriert auch diesen Typ (`default:`-Zweig); gelesen
+     * wird mit `collectImageBatches` (`imageBatchStore.ts`).
+     */
+    readonly imageBatchPersisted: "szenen.image_batch_persisted";
 };
+/** Ein einzelnes Bild innerhalb von `ImageBatchPersistedPayload` (D-6.9.2-6). */
+interface ImageBatchPersistedImage {
+    position: number;
+    /** Im aktuellen Host auflösbarer Locator — hier die HF-Bildkennung (D-93). */
+    media_ref: string;
+    /** Fachlich stabile Identität, soweit bekannt — hier identisch mit `media_ref` (D-118). */
+    asset_id?: string;
+    model?: string | null;
+    /** Nur gesetzt, wenn der Provider ihn tatsächlich zurückliefert (D-107). */
+    seed?: number | null;
+    width?: number | null;
+    height?: number | null;
+}
+/** Nutzlast von `imageBatchPersisted` — geschrieben nach bestätigtem Bild-Upload. */
+interface ImageBatchPersistedPayload {
+    item_id: string;
+    prompt_run_id: string;
+    generation_batch_id: string;
+    source_kind: 'generated_in_app' | 'external_import';
+    title: string;
+    images: readonly ImageBatchPersistedImage[];
+    created_at: string;
+}
 /**
  * Ein Event, wie der Reducer es sieht.
  *
@@ -2263,17 +2309,41 @@ interface SzenenViewPort {
     context: ContextChainPort;
     /** Prompt-Läufe — Stufe 3/4. */
     runs: SzenenRunPort;
-    /** Runde als Item — fehlt in Flow-Pure. */
+    /**
+     * Runde als Item — fehlt, solange ein Host keinen Item-Persistenzweg hat.
+     *
+     * Für Flow ist das **keine** MySQL-Grenze mehr (Stufe 6.9.2 hat die alte
+     * Kurzschlussbegründung "kein MySQL → kann nicht" für Batch-Historie und
+     * -Schreiben widerlegt, D-6.9.2-1): Items fehlen hier ausschließlich, weil
+     * Gate H (D-6.9.2-9) einen eigenen Item-Persistenzvertrag über HF erst
+     * nach einer Inventur des bestehenden Library-Modells bekommen soll — ein
+     * offener Architekturpunkt, keine Plattformgrenze.
+     */
     items?: SzenenItemPort;
-    /** Medien — fehlt, solange ein Host Stufe 5 nicht anbietet. */
+    /** Medien — fehlt, solange kein hostneutraler Version/Item↔Asset-Zuordnungsvertrag existiert (Gate I, D-6.9.2-10). */
     media?: SzenenMediaPort;
     /** Bildbestand — fehlt, wenn ein Host keinen hat (D-94). */
     imageLibrary?: SzenenImageLibraryPort;
     /** Rekonstruktion — fehlt ohne Textgenerierungs-Port (Stufe 6.5). */
     derivation?: SzenenDerivationPort;
-    /** Bild-Batch-Historie — fehlt, solange ein Host keinen MySQL-Zugriff hat (D-122). */
+    /**
+     * Bild-Batch-Historie — fehlt, wenn ein Host den autoritativen
+     * Ereigniskanal selbst nicht lesen kann.
+     *
+     * **Kein** MySQL-Erfordernis (Korrektur Stufe 6.9.2, D-6.9.2-7): Sie
+     * rekonstruiert Batches und Bildaufträge ausschließlich aus dem
+     * Ereignislog. Flow liefert sie deshalb unabhängig von Bildprovider und
+     * Batch-Schreibweg — React liefert sie zusätzlich über MySQL als Index.
+     */
     imageBatchHistory?: SzenenImageBatchHistoryPort;
-    /** Bild-Batch-Schreiben — fehlt ohne sicheren Batch-Schreibpfad (D-122). */
+    /**
+     * Bild-Batch-Schreiben — fehlt ohne sicheren, hostübergreifenden
+     * Batch-Schreibpfad.
+     *
+     * Für Flow ist der Schreibpfad HF (`hfUploadImage` + `image_batch_persisted`,
+     * D-6.9.2-4/6), nicht MySQL — auch hier gilt seit Stufe 6.9.2 nicht mehr
+     * "kein MySQL → kann nicht" (D-6.9.2-1).
+     */
     imageBatchWrite?: SzenenImageBatchWritePort;
     /**
      * Bildgenerierung aus einem Prompt-Lauf — fehlt, wenn Providerzugang
@@ -2373,8 +2443,10 @@ interface CreateMemoryViewPortOptions {
     /**
      * Ob der Port Bild-Batch-Historie anbietet (Stufe 6.7, D-122).
      *
-     * `false` bildet einen Host ohne MySQL-Zugriff ab (Flow-Pure): der
-     * Bereich zeigt dann keine Batch-Historie, statt leer zu erscheinen (R11).
+     * `false` bildet einen Host ohne lesbaren autoritativen Kanal ab — **nicht**
+     * mehr pauschal "kein MySQL" (Korrektur Stufe 6.9.2, D-6.9.2-7/D-6.9.2-1):
+     * Flow liest diese Historie seit 6.9.2 direkt aus HF. Der Bereich zeigt bei
+     * `false` keine Batch-Historie, statt leer zu erscheinen (R11).
      */
     imageBatchHistory?: boolean;
     /** Vorbelegte Batches, aus denen `listBatchesForPromptRun`/`getBatch` lesen. */
@@ -2400,6 +2472,44 @@ interface CreateMemoryViewPortOptions {
 }
 declare function createMemoryViewPort(options?: CreateMemoryViewPortOptions): SzenenViewPort;
 
+interface FlowGenerateImageParams {
+    prompt: string;
+    modelDisplayName: string;
+    aspectRatio?: string;
+    referenceImageMediaIds?: readonly string[];
+}
+/** Die nackte Flow-SDK-Funktion, wie `AppFa.tsx` sie hereinreicht. */
+type FlowGenerateImage = (params: FlowGenerateImageParams) => Promise<{
+    base64: string;
+    mediaId?: string;
+}>;
+/**
+ * Katalogisierte Bildmodelle (`imageGenerationCapability.ts`) auf
+ * Flow-Display-Namen (`howto-flow-sdk.md` — bekannt sind "🍌 Nano Banana Pro",
+ * "🍌 Nano Banana 2", "Imagen 4").
+ *
+ * Nur `imagen-4.0-generate-001` hat einen dokumentierten Flow-Display-Namen.
+ * `imagen-3.0-generate-001` bleibt bewusst draußen: Ein stiller Griff zu
+ * "Imagen 4" wäre genau der Modell-Fallback, den D-115 verbietet.
+ */
+declare const FLOW_MODEL_DISPLAY_NAMES: Readonly<Record<string, string>>;
+/**
+ * Ob dieser Host tatsächlich Zugang zu einem katalogisierten Bildmodell hat
+ * (D-115) — die Vorgabe für `hasAccess` in `createFlowSzenenViewPort()`.
+ */
+declare function flowImageProviderHasAccess(model: {
+    callable_model_id: string;
+}): boolean;
+/**
+ * Ein Provideraufruf je Bild — dieselbe Begründung wie beim React-Adapter
+ * (`reactImageProvider.ts`): Das SDK kennt keinen Mehrbild-Parameter
+ * (`howto-flow-sdk.md`, CONVERGE-Fundstelle „4 Varianten gleichzeitig").
+ * Teilfehler verwerfen nichts: Bricht der k-te Aufruf ab, werden die ersten
+ * k-1 Bilder zurückgegeben; nur wenn **kein** Bild zustande kam, wirft der
+ * Adapter.
+ */
+declare function createFlowImageProvider(generateImage: FlowGenerateImage): ImageGenerationProviderPort;
+
 interface CreateFlowSzenenViewPortOptions {
     /**
      * Der Textzugang des Flow-SDK. Entfaellt, wenn `textPort` gesetzt ist — ein
@@ -2428,10 +2538,29 @@ interface CreateFlowSzenenViewPortOptions {
     imageLibrary?: SzenenImageLibraryPort;
     newRunId?: () => string;
     now?: () => Date;
+    /**
+     * Der Bildzugang des Flow-SDK — Stufe 6.9.2, Gate B (D-6.9.2-3). Entfällt,
+     * wenn `imageProvider` gesetzt ist oder gar kein Bildzugang vorliegt: dann
+     * bleibt `imageGeneration` am Port weg, exakt wie bei `generateText`.
+     */
+    generateImage?: FlowGenerateImage;
+    /** Ein fertiger Bildprovider statt des Flow-SDK — für Tests. */
+    imageProvider?: ImageGenerationProviderPort;
+    /**
+     * Ob dieser Host Zugang zu einem katalogisierten Bildmodell hat (D-115).
+     * Vorgabe: die bekannten Flow-Display-Namen (`flowImageProviderHasAccess`).
+     */
+    imageProviderHasAccess?: ImageProviderAccessCheck;
+    /** Kennung je abgelegtem Batch-Bild. Ersetzbar, damit ein Test nicht würfelt. */
+    newBatchImageId?: (generationBatchId: string, position: number) => string;
 }
 /**
  * Complete Flow adapter for the shared SzenenView: authoritative HF elements
- * and runs plus Flow.generate.text. Server-only item commands stay absent.
+ * and runs, Flow.generate.text, and — Stufe 6.9.2 — HF-backed image-batch
+ * history/write plus Flow.generate.image-based image generation (Gates
+ * B–G, D-6.9.2-3…7). Item persistence stays absent: Gate H (D-6.9.2-9)
+ * needs an inventory pass on the existing HF library model first, so this
+ * is a real, documented gap — not a leftover "Flow has no MySQL" assumption.
  */
 declare function createFlowSzenenViewPort(options: CreateFlowSzenenViewPortOptions): SzenenViewPort;
 
@@ -2690,6 +2819,52 @@ interface CreateClientDerivationPortOptions {
 }
 declare function createClientDerivationPort(options: CreateClientDerivationPortOptions): SzenenDerivationPort;
 
+interface CreateHfImageBatchPersistenceOptions {
+    namespace: string;
+    token: string;
+    channel: ElementEventChannel;
+    /** Kennung je abgelegtem Bild. Ersetzbar, damit ein Test nicht würfelt. */
+    newImageId?: (generationBatchId: string, position: number) => string;
+    now?: () => Date;
+}
+/**
+ * `ImageGenerationBatchPersistence` für Flow — derselbe kanonische Weg wie
+ * `SzenenImageBatchWritePort.importBatch`, nur mit `source_kind:
+ * 'generated_in_app'` (D-116/D-120).
+ */
+declare function createHfImageGenerationBatchPersistence(options: CreateHfImageBatchPersistenceOptions): ImageGenerationBatchPersistence;
+/**
+ * `SzenenImageBatchWritePort` für Flow — Gate G (D-117).
+ *
+ * `importBatch` ruft **keinen** Provider; er legt bereits vorhandene Bilder
+ * über denselben kanonischen Weg ab wie ein in-App erzeugter Batch, nur mit
+ * `source_kind: 'external_import'`.
+ *
+ * `attachLibraryItem` schreibt nichts — die Item-Kennung ist deterministisch
+ * an den Lauf gebunden (`itemIdForRun`), es gibt in diesem Modell keine
+ * Umhängung, nur eine Prüfung: gehört das genannte Item bereits zu einem
+ * anderen Lauf, ist das ein Konflikt (D-117 Punkt 6/7), kein stiller Erfolg.
+ */
+declare function createHfImageBatchWrite(options: CreateHfImageBatchPersistenceOptions): SzenenImageBatchWritePort;
+
+interface CreateHfImageBatchHistoryOptions {
+    channel: ElementEventChannel;
+}
+declare function createHfImageBatchHistory(options: CreateHfImageBatchHistoryOptions): SzenenImageBatchHistoryPort;
+
+/**
+ * Faltet alle `image_batch_persisted`-Ereignisse zu einem Batch je `item_id`.
+ *
+ * Ein zweites Ereignis mit derselben `generation_batch_id` wird ignoriert —
+ * ein Wiederholungsversuch nach einem Schreibfehler darf dieselben Bilder
+ * nicht doppelt zählen.
+ */
+declare function collectImageBatches(events: readonly ElementEvent[]): readonly PromptImageBatch[];
+/** Alle Batches eines Prompt-Laufs — normalerweise höchstens einer (D-113). */
+declare function batchesForPromptRun(events: readonly ElementEvent[], runId: string): readonly PromptImageBatch[];
+/** Ein einzelner Batch über eine seiner `generation_batch_id`s, oder `null`. */
+declare function findImageBatch(events: readonly ElementEvent[], batchId: string): PromptImageBatch | null;
+
 type SzenenAreaId = 'derive' | 'elements' | 'scene' | 'setup' | 'shot' | 'media';
 interface SzenenArea {
     id: SzenenAreaId;
@@ -2744,4 +2919,4 @@ interface SzenenViewProps {
 }
 declare const SzenenView: React__default.FC<SzenenViewProps>;
 
-export { AuthoritativeSzenenStore, CATALOGUE_TYPES, type CallableImageModel, CapabilityAnchorError, type CapabilityFlag, type CapabilityReason, type CapabilityReport, type CapabilityReportInput, type CapabilityScope, type CapabilityState, type ChainQueries, type ClientDerivationChannel, type ClientDerivationStore, ContextChainPort, type CreateBrowserTextGenerationPortOptions, type CreateClientDerivationPortOptions, type CreateClientRunPortOptions, type CreateFlowSzenenViewPortOptions, type CreateHfElementStoreOptions, type CreateHfEventChannelOptions, type CreateImageGenerationPortOptions, type CreateMemoryViewPortOptions, DerivableType, DerivationAssessment, DerivationConflict, DerivationDiagnostic, DerivationFailure, DerivationImage, DerivationInputMode, type DeriveItemInput, type DerivedItem, type DerivedLineage, type DerivedRelationship, type DerivedSzenenReference, type DifferentialResult, type DifferentialStep, type Divergence, DraftChainMeta, ELEMENT_VERSION_SCHEMA_FILE, type ElementEvent, type ElementEventChannel, ElementSnapshot, type ElementStoreState, type ExistingSzenenItem, FlowGenerateText, type FreezeDraftChainInput, type FreezeFailure, type FreezeResult, type FreezeSuccess, type FrozenChainNode, type GeneratedImage, type IdFactory, type ImageGenerationBatchPersistence, type ImageGenerationCapability, type ImageGenerationEventChannel, type ImageGenerationFinishedPayload, type ImageGenerationOrder, type ImageGenerationProviderPort, type ImageGenerationResult, type ImageGenerationRunReader, type ImageGenerationStartedPayload, ImageProvenance, type ImageProviderAccessCheck, type ImageProviderInput, type InMemoryEventChannel, type InputError, type IntegrityVerdict, type ItemDerivationFailure, type ItemDerivationFailureClass, type ItemDerivationResult, type ItemMedium, type LibraryImage, type NodeContribution, NotDerivable, type Notice, type NoticeTone, type PromptRunOutcome, type PromptRunOutput, type PromptRunPersistencePort, type PromptRunRecord, type PromptRunRecordedPayload, type ProviderCheckRecord, type ProviderCheckRecordedPayload, type ProviderCheckResult, PublishCheckResult, PublishFinding, RULES_WITHOUT_CAPABILITY_EFFECT, RULE_SCOPES, type RawSchema, type RecordedDerivationInput, type RecordedProposal, type RecoveryStatus, type ReducerFinding, ReferenceResolver, type RendererInput, type ResolveFailure, type ResolveResult, type ResolveShotInput, type ResolveShotPayloadInput, ResolveTechnicalError, type ResolvedCamera, type ResolvedNode, type ResolvedPlacement, type RunEventChannel, type RunFailure, type RunFailureClass, type RunItemReference, SZENEN_EVENT_PREFIX, SZENEN_EVENT_TYPES, SZENEN_ITEM_PREFIX, SZENEN_SCHEMAS, type SaveRunAsItemInput, type SceneDerivationPersistencePort, type SceneDerivationRecord, type SceneDerivationRecordedPayload, type SceneDerivationRecoveryRecord, type SceneDerivationRecoveryRecordedPayload, SchemaError, type StartImageGenerationInput, type StartRunInput, type StepState, type SzenenArea, type SzenenAreaId, type SzenenBatchOrigin, type SzenenBatchOriginFailure, type SzenenBatchOriginVerdict, SzenenCommands, SzenenElementStore, SzenenElementType, type SzenenImageGenerationPort as SzenenImageGenerationPortContract, type SzenenImageLibraryPort, type SzenenItemPort, type SzenenMediaPort, SzenenQueries, type SzenenRunPort, SzenenView, type SzenenViewCapabilities, type SzenenViewPort, type SzenenViewProps, TargetModelResolution, TextGenerationPort, UNCHECKED_PUBLISH_RULES, UnusableProposal, type VersionMedium, type VisibilityNode, areasFor, buildSystemInstruction, buildUserPrompt, callOptional, callableImageModelFor, capabilitiesOf, capabilityForTargetModel, capabilityGate, capabilityReport, catalogueFor, checkCreateElementInput, checkElementType, checkOptionalId, checkParents, checkPayloadPresent, checkPromptRunRecord, checkPublishVersionInput, checkRequiredId, checkReviseMetadataInput, checkRevision, checkRunResponse, checkSceneDerivationRecord, checkSceneDerivationRecoveryRecord, checkSetPreferredHeadInput, checkSzenenBatchOrigin, checkTitle, checkWriteDraftInput, collectImageGenerationOrders, collectPromptRuns, collectProviderChecks, collectSceneDerivationRecoveries, collectSceneDerivations, createBrowserTextGenerationPort, createClientDerivationPort, createClientRunPort, createEventLogDerivationPersistence, createEventLogRunPersistence, createFlowSzenenViewPort, createHfElementStore, createHfEventChannel, createHfImageLibrary, createImageGenerationPort, createInMemoryEventChannel, createMemoryViewPort, derivationPoliciesOf, deriveItemFromRun, deriveLineage, differentialSteps, draftRevisionOf, findImageGenerationOrder, findPromptRun, findProviderCheck, findSceneDerivation, findSceneDerivationRecovery, firstError, freezeDraftChain, hasPlacementCapability, isKnownElementType, isSzenenItemId, itemIdForRun, logRevisionOf, mergeSzenenBatchOrigin, noticeFor, ordersForPromptRun, parseRunResponse, preferredHeadRevisionOf, publishedHeadsOf, recoveriesForRun, recoveryStatusOf, reduceElementEvents, resolveArea, resolveShot, resolveShotPayload, roundOfRun, runPromptDerivation, runStoreDifferential, scopeOfPath, totalModelCalls, unclassifiedPublishRules, unsupportedReason };
+export { type AttachLibraryItemInput, type AttachLibraryItemResult, AuthoritativeSzenenStore, CATALOGUE_TYPES, type CallableImageModel, CapabilityAnchorError, type CapabilityFlag, type CapabilityReason, type CapabilityReport, type CapabilityReportInput, type CapabilityScope, type CapabilityState, type ChainQueries, type ClientDerivationChannel, type ClientDerivationStore, ContextChainPort, type CreateBrowserTextGenerationPortOptions, type CreateClientDerivationPortOptions, type CreateClientRunPortOptions, type CreateFlowSzenenViewPortOptions, type CreateHfElementStoreOptions, type CreateHfEventChannelOptions, type CreateHfImageBatchHistoryOptions, type CreateHfImageBatchPersistenceOptions, type CreateImageGenerationPortOptions, type CreateMemoryViewPortOptions, DerivableType, DerivationAssessment, DerivationConflict, DerivationDiagnostic, DerivationFailure, DerivationImage, DerivationInputMode, type DeriveItemInput, type DerivedItem, type DerivedLineage, type DerivedRelationship, type DerivedSzenenReference, type DifferentialResult, type DifferentialStep, type Divergence, DraftChainMeta, ELEMENT_VERSION_SCHEMA_FILE, type ElementEvent, type ElementEventChannel, ElementSnapshot, type ElementStoreState, type ExistingSzenenItem, FLOW_MODEL_DISPLAY_NAMES, type FlowGenerateImage, type FlowGenerateImageParams, FlowGenerateText, type FreezeDraftChainInput, type FreezeFailure, type FreezeResult, type FreezeSuccess, type FrozenChainNode, type GeneratedImage, type IdFactory, type ImageBatchPersistedImage, type ImageBatchPersistedPayload, type ImageGenerationBatchPersistence, type ImageGenerationCapability, type ImageGenerationEventChannel, type ImageGenerationFinishedPayload, type ImageGenerationOrder, type ImageGenerationProviderPort, type ImageGenerationResult, type ImageGenerationRunReader, type ImageGenerationStartedPayload, ImageProvenance, type ImageProviderAccessCheck, type ImageProviderInput, type ImportBatchImageInput, type ImportBatchInput, type InMemoryEventChannel, type InputError, type IntegrityVerdict, type ItemDerivationFailure, type ItemDerivationFailureClass, type ItemDerivationResult, type ItemMedium, type LibraryImage, type NodeContribution, NotDerivable, type Notice, type NoticeTone, type PromptBatchImageRef, type PromptImageBatch, type PromptRunOutcome, type PromptRunOutput, type PromptRunPersistencePort, type PromptRunRecord, type PromptRunRecordedPayload, type ProviderCheckRecord, type ProviderCheckRecordedPayload, type ProviderCheckResult, PublishCheckResult, PublishFinding, RULES_WITHOUT_CAPABILITY_EFFECT, RULE_SCOPES, type RawSchema, type RecordedDerivationInput, type RecordedProposal, type RecoveryStatus, type ReducerFinding, ReferenceResolver, type RendererInput, type ResolveFailure, type ResolveResult, type ResolveShotInput, type ResolveShotPayloadInput, ResolveTechnicalError, type ResolvedCamera, type ResolvedNode, type ResolvedPlacement, type RunEventChannel, type RunFailure, type RunFailureClass, type RunItemReference, SZENEN_EVENT_PREFIX, SZENEN_EVENT_TYPES, SZENEN_ITEM_PREFIX, SZENEN_SCHEMAS, type SaveRunAsItemInput, type SceneDerivationPersistencePort, type SceneDerivationRecord, type SceneDerivationRecordedPayload, type SceneDerivationRecoveryRecord, type SceneDerivationRecoveryRecordedPayload, SchemaError, type StartImageGenerationInput, type StartRunInput, type StepState, type SzenenArea, type SzenenAreaId, type SzenenBatchOrigin, type SzenenBatchOriginFailure, type SzenenBatchOriginVerdict, SzenenCommands, SzenenElementStore, SzenenElementType, type SzenenImageBatchHistoryPort, type SzenenImageBatchWritePort, type SzenenImageGenerationPort as SzenenImageGenerationPortContract, type SzenenImageLibraryPort, type SzenenItemPort, type SzenenMediaPort, SzenenQueries, type SzenenRunPort, SzenenView, type SzenenViewCapabilities, type SzenenViewPort, type SzenenViewProps, TargetModelResolution, TextGenerationPort, UNCHECKED_PUBLISH_RULES, UnusableProposal, type VersionMedium, type VisibilityNode, areasFor, batchesForPromptRun, buildSystemInstruction, buildUserPrompt, callOptional, callableImageModelFor, capabilitiesOf, capabilityForTargetModel, capabilityGate, capabilityReport, catalogueFor, checkCreateElementInput, checkElementType, checkOptionalId, checkParents, checkPayloadPresent, checkPromptRunRecord, checkPublishVersionInput, checkRequiredId, checkReviseMetadataInput, checkRevision, checkRunResponse, checkSceneDerivationRecord, checkSceneDerivationRecoveryRecord, checkSetPreferredHeadInput, checkSzenenBatchOrigin, checkTitle, checkWriteDraftInput, collectImageBatches, collectImageGenerationOrders, collectPromptRuns, collectProviderChecks, collectSceneDerivationRecoveries, collectSceneDerivations, createBrowserTextGenerationPort, createClientDerivationPort, createClientRunPort, createEventLogDerivationPersistence, createEventLogRunPersistence, createFlowImageProvider, createFlowSzenenViewPort, createHfElementStore, createHfEventChannel, createHfImageBatchHistory, createHfImageBatchWrite, createHfImageGenerationBatchPersistence, createHfImageLibrary, createImageGenerationPort, createInMemoryEventChannel, createMemoryViewPort, derivationPoliciesOf, deriveItemFromRun, deriveLineage, differentialSteps, draftRevisionOf, findImageBatch, findImageGenerationOrder, findPromptRun, findProviderCheck, findSceneDerivation, findSceneDerivationRecovery, firstError, flowImageProviderHasAccess, freezeDraftChain, hasPlacementCapability, isKnownElementType, isSzenenItemId, itemIdForRun, logRevisionOf, mergeSzenenBatchOrigin, noticeFor, ordersForPromptRun, parseRunResponse, preferredHeadRevisionOf, publishedHeadsOf, recoveriesForRun, recoveryStatusOf, reduceElementEvents, resolveArea, resolveShot, resolveShotPayload, roundOfRun, runPromptDerivation, runStoreDifferential, scopeOfPath, totalModelCalls, unclassifiedPublishRules, unsupportedReason };