@rslsp1/fa-app-tools 2.0.87 → 3.0.0

package/dist/szenen.d.ts

@@ -1,5 +1,5 @@
-import { ac as SchemaError, Z as PublishFinding, Y as PublishCheckResult, aj as SzenenElementType, a2 as ReferenceResolver, ap as TargetModelResolution, I as ElementSnapshot, w as DerivationInputMode, M as ImageProvenance, s as DerivationFailure, n as DerivableType, N as NotDerivable, p as DerivationConflict, u as DerivationFollowUp, B as DraftChainMeta, q as DerivationDiagnostic, o as DerivationAssessment, h as ContextChainPort, a as AuthoritativeSzenenStore, ai as SzenenElementStore, v as DerivationImage, al as SzenenQueries, ah as SzenenCommands, ar as UnusableProposal } from './storeContract-D7vBM8nv.js';
-export { A as ALL_PUBLISH_RULES, C as CHAIN_EDGES, b as CHAIN_LINK_FIELDS, c as CatalogueEntry, d as ChainLinkField, e as ChainTarget, f as ChainVerdict, g as CompiledSchemas, i as ContractCheck, j as ContractCheckResult, k as ContractRunResult, l as ContractViolation, m as CreateElementInput, D as DERIVABLE_TYPES, r as DerivationEnvelope, t as DerivationFailureClass, x as DerivationPolicyPayload, y as DerivationProposal, z as DraftChainLink, E as DraftFork, F as DraftRecord, G as ElementMetadata, H as ElementRecord, J as ElementStoreContractHarness, K as ElementVersionValidation, L as FindingSeverity, O as OptionalCommand, P as PROBE_VERSION_ID, Q as ParentRelation, R as PreferredHeadOutcome, S as PreferredHeadResolution, T as PreferredHeadSelection, U as PreferredHeadSource, V as ProjectionState, W as ProjectionStatus, X as PublishCheckInput, _ as PublishRejected, $ as PublishVersionInput, a0 as PublishedVersion, a1 as REFERENCE_FIELD, a3 as ResolvePreferredHeadOptions, a4 as ResolvedVersion, a5 as ReviseMetadataInput, a6 as STYLE_PAYLOAD, a7 as STYLE_PAYLOAD_V2, a8 as SZENEN_ELEMENT_TYPES, a9 as SceneDerivationInput, aa as SceneDerivationOutcome, ab as SceneDerivationOutput, ad as SchemaValidationResult, ae as SetPreferredHeadInput, af as StoreAuthority, ag as SzenenCommandResult, ak as SzenenProjection, am as TargetModelCandidate, an as TargetModelQueries, ao as TargetModelQuery, aq as UnsupportedSchemaError, as as VersionDag, at as VersionDagError, au as VersionNode, av as VersionParentLink, aw as WriteConflict, ax as WriteDraftInput, ay as assessDerivationResponse, az as buildDerivationSystemInstruction, aA as buildDerivationUserPrompt, aB as buildVersionDag, aC as checkChainTargets, aD as checkDerivationResponse, aE as checkDraftChainMeta, aF as collectVersionRefs, aG as compileSchemas, aH as createSimulationSceneDerivationPort, aI as describeTargetModelFailure, aJ as elementStoreContractChecks, aK as formatSchemaErrors, aL as getSzenenSchemas, aM as isOk, aN as isProjectionCurrent, aO as linkFor, aP as parseDerivationResponse, aQ as preferredVersionId, aR as resolvePreferredHead, aS as resolveTargetModelOver, aT as resolverFromQueries, aU as runElementStoreContract, aV as runPublishChecks, aW as runSceneDerivation, aX as showChain, aY as validateAgainst, aZ as validateDerivationInput, a_ as validateElementVersion, a$ as validatePayload, b0 as withReference } from './storeContract-D7vBM8nv.js';
+import { ac as SchemaError, Z as PublishFinding, Y as PublishCheckResult, aj as SzenenElementType, a2 as ReferenceResolver, ap as TargetModelResolution, I as ElementSnapshot, w as DerivationInputMode, M as ImageProvenance, s as DerivationFailure, n as DerivableType, N as NotDerivable, p as DerivationConflict, u as DerivationFollowUp, B as DraftChainMeta, q as DerivationDiagnostic, o as DerivationAssessment, h as ContextChainPort, a as AuthoritativeSzenenStore, ai as SzenenElementStore, v as DerivationImage, al as SzenenQueries, ah as SzenenCommands, ar as UnusableProposal } from './storeContract-DNggXiZl.js';
+export { A as ALL_PUBLISH_RULES, C as CHAIN_EDGES, b as CHAIN_LINK_FIELDS, c as CatalogueEntry, d as ChainLinkField, e as ChainTarget, f as ChainVerdict, g as CompiledSchemas, i as ContractCheck, j as ContractCheckResult, k as ContractRunResult, l as ContractViolation, m as CreateElementInput, D as DERIVABLE_TYPES, r as DerivationEnvelope, t as DerivationFailureClass, x as DerivationPolicyPayload, y as DerivationProposal, z as DraftChainLink, E as DraftFork, F as DraftRecord, G as ElementMetadata, H as ElementRecord, J as ElementStoreContractHarness, K as ElementVersionValidation, L as FindingSeverity, O as OptionalCommand, P as PROBE_VERSION_ID, Q as ParentRelation, R as PreferredHeadOutcome, S as PreferredHeadResolution, T as PreferredHeadSelection, U as PreferredHeadSource, V as ProjectionState, W as ProjectionStatus, X as PublishCheckInput, _ as PublishRejected, $ as PublishVersionInput, a0 as PublishedVersion, a1 as REFERENCE_FIELD, a3 as ResolvePreferredHeadOptions, a4 as ResolvedVersion, a5 as ReviseMetadataInput, a6 as STYLE_PAYLOAD, a7 as STYLE_PAYLOAD_V2, a8 as SZENEN_ELEMENT_TYPES, a9 as SceneDerivationInput, aa as SceneDerivationOutcome, ab as SceneDerivationOutput, ad as SchemaValidationResult, ae as SetPreferredHeadInput, af as StoreAuthority, ag as SzenenCommandResult, ak as SzenenProjection, am as TargetModelCandidate, an as TargetModelQueries, ao as TargetModelQuery, aq as UnsupportedSchemaError, as as VersionDag, at as VersionDagError, au as VersionNode, av as VersionParentLink, aw as WriteConflict, ax as WriteDraftInput, ay as assessDerivationResponse, az as buildDerivationSystemInstruction, aA as buildDerivationUserPrompt, aB as buildVersionDag, aC as checkChainTargets, aD as checkDerivationResponse, aE as checkDraftChainMeta, aF as collectVersionRefs, aG as compileSchemas, aH as createSimulationSceneDerivationPort, aI as describeTargetModelFailure, aJ as elementStoreContractChecks, aK as formatSchemaErrors, aL as getSzenenSchemas, aM as isOk, aN as isProjectionCurrent, aO as linkFor, aP as parseDerivationResponse, aQ as preferredVersionId, aR as resolvePreferredHead, aS as resolveTargetModelOver, aT as resolverFromQueries, aU as runElementStoreContract, aV as runPublishChecks, aW as runSceneDerivation, aX as showChain, aY as validateAgainst, aZ as validateDerivationInput, a_ as validateElementVersion, a$ as validatePayload, b0 as withReference } from './storeContract-DNggXiZl.js';
 import { T as TextGenerationPort, Q as QueryResult, C as CommandResult } from './contracts-DdYOMBl9.js';
 export { S as SIMULATION_PROVIDER, c as TextGenerationRequest, d as TextGenerationResult, g as createFakeTextGenerationPort, h as createSimulationTextGenerationPort, s as simulatedAnswerFor } from './contracts-DdYOMBl9.js';
 import { g as HFStateSnapshot, F as FlowGenerateText } from './hfEventTypes-C_PX6RFR.js';
@@ -1391,6 +1391,49 @@ interface ImageGenerationStartedPayload {
         aspect_ratio?: string;
         seeds?: readonly number[];
         callable_model_id: string;
+        /**
+         * Der Anbieter des ausgefuehrten Modells (D-132) — `google`, nicht `flow`.
+         * Flow ist eine Umgebung, kein Anbieter.
+         *
+         * Optional, und das ist keine Nachlaessigkeit: Auftraege aus der Zeit vor
+         * D-128 tragen das Feld nicht, und die Projektion darf es fuer sie nicht
+         * erfinden (D-107).
+         */
+        provider?: string;
+        /** Das Zielmodell, mit dem die Pixel erzeugt wurden (D-131). */
+        execution_target_model_key?: string;
+        /** Dessen wirksame Version, sofern bekannt — nichts wird erfunden. */
+        execution_target_model_version_id?: string;
+        /** Das Ausfuehrungsprofil dieses Zielmodells, das gegolten hat. */
+        execution_profile_id?: string;
+        /** Die App-Umgebung, in der ausgefuehrt wurde (D-132). */
+        environment_id?: string;
+        /** Der technische Aufrufweg des Hosts. */
+        execution_path?: string;
+        /**
+         * Exakt der Modellwert, mit dem der Aufrufweg gestartet wurde. Fuehrt
+         * denselben Wert wie `callable_model_id`; letzteres bleibt, weil
+         * Altauftraege und der Server es tragen.
+         */
+        execution_model_id?: string;
+        /**
+         * Das Zielmodell, fuer das der Prompt formuliert wurde, oder `null`.
+         * Zusammen mit `target_model_matched` bleibt die Abweichung
+         * „optimiert fuer X, ausgefuehrt mit Y" dauerhaft nachvollziehbar (D-131).
+         */
+        prompt_target_model_key?: string | null;
+        /**
+         * Ob das ausgefuehrte Zielmodell das Prompt-Zielmodell war. Getrennt vom
+         * Schluessel, damit ein Leser die Abweichung nicht aus zwei verschiedenen
+         * Kennungen erraten muss. Fehlt das Feld, ist **keine** Aussage getroffen.
+         */
+        target_model_matched?: boolean;
+        /**
+         * Ob der negative Promptkanal wirklich mitgelaufen ist (D-130 §9) — nicht,
+         * ob der Lauf einen traegt. Fehlt das Feld, kennt der Auftrag die Frage
+         * nicht.
+         */
+        negative_prompt_transmitted?: boolean;
     };
     created_at: string;
 }
@@ -1649,45 +1692,132 @@ declare function differentialSteps(): readonly DifferentialStep[];
  */
 declare function runStoreDifferential(left: () => Promise<SzenenElementStore> | SzenenElementStore, right: () => Promise<SzenenElementStore> | SzenenElementStore): Promise<DifferentialResult>;
 
-/** Ein aufrufbares Bildmodell und seine Parametergrenzen. */
-interface CallableImageModel {
-    callable_model_id: string;
-    provider: string;
+/**
+ * Ein Ausführungsprofil eines Zielmodells (D-130) — wie ein konkreter Host
+ * dieses Modell wirklich aufruft.
+ */
+interface ImageExecutionProfile {
+    /** Stabile Kennung **innerhalb** dieses Zielmodells. */
+    profile_id: string;
+    /** Auswählbar, oder bewusst abgeschaltet. */
+    enabled: boolean;
+    /** Umgebungen, in denen dieses Profil gilt. */
+    environments: readonly string[];
+    /** Der technische Aufrufweg, den der Host besitzen muss. */
+    execution_path: string;
+    /**
+     * Exakt der Modellwert, den der vorhandene Aufrufweg als Eingabe erwartet
+     * (D-132) — nicht zwingend die offizielle Endpunkt-ID des Anbieters. Was
+     * hier steht, geht unverändert an den Adapter und in die Provenienz.
+     */
+    execution_model_id: string;
     max_images: number;
+    /** Vom konkreten Pfad übertragene Seitenverhältnisse. Darf leer sein. */
     aspect_ratios: readonly string[];
-    supports_seed: boolean;
+    /** Ob ein Seed über diesen Pfad wirklich übertragen wird. */
+    accepts_seed: boolean;
+    /** Ob ein separater negativer Prompt wirklich übertragen wird. */
+    accepts_negative_prompt: boolean;
 }
-/** Die katalogisierte Zuordnung für einen `target_model.key`, oder `null`. */
-declare function callableImageModelFor(targetModelKey: string): CallableImageModel | null;
-/** Der Ausgang der Fähigkeitsauskunft (D-115). */
-type ImageGenerationCapability = {
-    kind: 'supported';
+/**
+ * Was **dieser Host** kann (D-132).
+ *
+ * Bewusst nur zwei Angaben: in welcher Umgebung er läuft und welche Aufrufwege
+ * er besitzt. Keine Modellliste — die kommt aus den Zielmodellen.
+ */
+interface ImageHostCapability {
+    environment_id: string;
+    execution_paths: readonly string[];
+}
+/** Ein Zielmodell, so wie die Auswahl es braucht. */
+interface ExecutionTargetModel {
+    key: string;
+    title: string;
+    provider: string | null;
+    /** Die wirksame Version, aus der die Profile stammen — für die Provenienz. */
+    versionId?: string;
+    /** Roh aus der Payload; wird hier gegen den Vertrag geprüft. */
+    executionProfiles: readonly unknown[];
+}
+/** Eine wirklich ausführbare Kombination aus Zielmodell und Profil. */
+interface ExecutableImageModel {
+    /** Kennung der Auswahl: Zielmodell **und** Profil, weil beides zählt. */
+    selection_id: string;
     target_model_key: string;
+    target_model_version_id?: string;
+    display_name: string;
     provider: string;
-    callable_model_id: string;
+    profile_id: string;
+    environment_id: string;
+    execution_path: string;
+    execution_model_id: string;
     max_images: number;
     aspect_ratios: readonly string[];
-    supports_seed: boolean;
-} | {
-    kind: 'unsupported';
-    target_model_key: string;
-    reason: string;
-};
+    accepts_seed: boolean;
+    accepts_negative_prompt: boolean;
+    /** Ob dieses Zielmodell das ist, für das der Prompt optimiert wurde (D-131). */
+    is_prompt_target: boolean;
+}
 /**
- * Ob **dieser Host** tatsächlich Zugang zu einem katalogisierten Bildmodell
- * hat — die einzige Stelle, an der Host-Wissen einfließen darf, und zwar als
- * Funktionsparameter, nicht als Verzweigung im gemeinsamen Code (R-1).
+ * Die Modellwahl für einen Lauf in einer konkreten Umgebung.
+ *
+ * `models` ist leer, wenn kein Zielmodell dieser Umgebung ein aktives,
+ * vom Host ausführbares Profil trägt. Das ist kein Fehler und sperrt den Lauf
+ * nicht — der externe Importpfad bleibt daneben stehen (D-104.5/D-133).
  */
-type ImageProviderAccessCheck = (model: CallableImageModel) => boolean;
+interface ImageModelChoice {
+    /** Das Zielmodell, für das der Prompt erzeugt wurde, oder `null` (D-103). */
+    prompt_target_model_key: string | null;
+    models: readonly ExecutableImageModel[];
+    /**
+     * Die Vorauswahl: das Profil des Prompt-Zielmodells, sonst das erste
+     * ausführbare. `null` bei leerer Liste. Komfort, keine Festlegung (D-131).
+     */
+    default_selection_id: string | null;
+    /** Nur gesetzt, wenn `models` leer ist: warum es hier nichts zu wählen gibt. */
+    reason?: string;
+    /**
+     * Profile, die den Vertrag verletzen — als Klartext, je Zielmodell.
+     *
+     * Sie werden **nicht** angeboten und **nicht** stillschweigend weggelassen:
+     * Ein falsch gepflegtes Profil soll sichtbar sein, sonst sucht der Autor die
+     * Ursache im Host (Regel 4/11).
+     */
+    invalid_profiles: readonly string[];
+}
+/**
+ * Prüft ein rohes Profil gegen den Vertrag und liefert die Befunde als Klartext.
+ *
+ * Exportiert, weil der Zielmodell-Editor dieselbe Prüfung vor dem Speichern
+ * zeigen soll — eine Regel, eine Stelle.
+ */
+declare function checkImageExecutionProfile(profile: unknown): readonly string[];
+/**
+ * Alle Bildmodelle, die dieser Host für diesen Lauf wirklich ausführen kann.
+ *
+ * Fünf Bedingungen, alle notwendig (D-130/D-132): Das Profil ist gültig, es ist
+ * aktiviert, es gilt für die Umgebung dieses Hosts, der Host besitzt den
+ * genannten Aufrufweg — und das Zielmodell trägt überhaupt ein Profil.
+ */
+declare function executableImageModels(promptTargetModelKey: string | null, targets: readonly ExecutionTargetModel[], capability: ImageHostCapability): ImageModelChoice;
+/** Eine Kombination aus einer Wahl, exakt über Zielmodell und Profil. */
+declare function findExecutableImageModel(choice: ImageModelChoice, targetModelKey: string, profileId: string): ExecutableImageModel | null;
+/** Die Parameter eines Bildauftrags, wie sie gegen ein Profil geprüft werden. */
+interface ImageModelParameters {
+    imageCount: number;
+    aspectRatio?: string;
+    seeds?: readonly number[];
+}
 /**
- * Die Fähigkeitsauskunft: aus dem eingefrorenen `target_model` (D-103) und
- * der Zugangsauskunft des Hosts entsteht `supported` oder `unsupported`.
+ * Prüft Auftragsparameter gegen das **tatsächlich gewählte** Ausführungsprofil
+ * (D-131) und liefert die Befunde als Klartext.
  *
- * `unsupported` ist kein Fehler und blockiert nichts (D-104.5) — der
- * Prompt-Lauf bleibt vollständig nutzbar und bekommt Ergebnisse über den
- * externen Importpfad (Teil D).
+ * Kein stilles Kürzen, kein Umrechnen: Ein Seitenverhältnis, das dieser
+ * Aufrufweg nicht überträgt, wird abgelehnt und nicht auf das nächstliegende
+ * gerundet (Regel 4). Die Meldungen nennen den konkreten Wert und die zulässige
+ * Menge (Regel 11).
  */
-declare function capabilityForTargetModel(targetModel: unknown, hasAccess: ImageProviderAccessCheck): ImageGenerationCapability;
+declare function checkImageModelParameters(model: ExecutableImageModel, parameters: ImageModelParameters): readonly string[];
 
 /** Ein tatsächlich vom Provider geliefertes Bild. */
 interface GeneratedImage {
@@ -1700,7 +1830,18 @@ interface GeneratedImage {
 }
 /** Die Eingabe an den tatsächlichen Provideraufruf — abgeleitet aus dem eingefrorenen Lauf. */
 interface ImageProviderInput {
-    callableModelId: string;
+    /** Das Zielmodell, mit dem ausgeführt wird — die fachliche Kennung (D-131). */
+    targetModelKey: string;
+    /** Der Aufrufweg aus dem gewählten Profil; der Adapter prüft, ob er ihn hat. */
+    executionPath: string;
+    /**
+     * Exakt der Modellwert, den dieser Aufrufweg erwartet — aus **demselben**
+     * Profil (D-132). Der Adapter gibt ihn unverändert weiter und hält keine
+     * eigene Mapping-Tabelle.
+     */
+    executionModelId: string;
+    /** Die Umgebung, in der ausgeführt wird (D-132). */
+    environmentId: string;
     provider: string;
     positivePrompt: string;
     negativePrompt?: string | null;
@@ -1734,6 +1875,16 @@ interface ImageGenerationBatchPersistence {
         images: readonly GeneratedImage[];
     }): Promise<CommandResult<PromptImageBatch>>;
 }
+/**
+ * Die Zielmodelle dieses Kontexts, wie der Port sie braucht (D-130).
+ *
+ * Der Host liefert sie — beim React- und Flow-Host über dieselbe
+ * `selectableTargetModels()`-Auskunft, die auch der Editor benutzt. Damit gibt
+ * es keine zweite Wahrheit darüber, welche Zielmodelle sichtbar sind.
+ */
+interface ImageExecutionTargetModelReader {
+    listExecutionTargetModels(): Promise<QueryResult<readonly ExecutionTargetModel[]>>;
+}
 /** Was der Auftragskanal (D-119) braucht — lesen und anhängen, wie `RunEventChannel`. */
 interface ImageGenerationEventChannel {
     appendEvent(type: string, payload: unknown): Promise<void>;
@@ -1742,6 +1893,18 @@ interface StartImageGenerationInput {
     runId: string;
     /** Vom Aufrufer VOR dem Aufruf gebildet (D-113) — deterministisch mit dem Lauf verknüpft. */
     generationBatchId: string;
+    /**
+     * Das Zielmodell, mit dem tatsächlich ausgeführt wird, und sein Profil —
+     * **beides verpflichtend** und explizit (D-131).
+     *
+     * Bewusst kein optionaler Parameter mit Rückfall auf das Prompt-Zielmodell:
+     * Ein bezahlter Bildaufruf, dessen Modell nicht in der Eingabe steht, wäre
+     * nach dem Auftrag nicht mehr von einer Vorauswahl zu unterscheiden. Die
+     * Vorauswahl trifft die Ansicht sichtbar aus
+     * `ImageModelChoice.default_selection_id`, nicht der Port stillschweigend.
+     */
+    executionTargetModelKey: string;
+    executionProfileId: string;
     imageCount: number;
     aspectRatio?: string;
     /** Je Bild, wenn das Modell Seeds kennt. */
@@ -1768,7 +1931,14 @@ type ImageGenerationResult = {
     message: string;
 };
 interface SzenenImageGenerationPort {
-    capabilityForRun(runId: string): Promise<QueryResult<ImageGenerationCapability>>;
+    /**
+     * Alle Modelle, die **diese Umgebung** für diesen Lauf ausführen kann, mit
+     * Vorauswahl und der sichtbaren Optimierungsabsicht (D-128/D-129).
+     *
+     * Die frühere `capabilityForRun()` ist entfallen: Sie beantwortete die
+     * 1:1-Frage aus dem Domänenkatalog, den es nicht mehr gibt.
+     */
+    imageModelChoiceForRun(runId: string): Promise<QueryResult<ImageModelChoice>>;
     startFromPromptRun(input: StartImageGenerationInput): Promise<ImageGenerationResult>;
 }
 interface CreateImageGenerationPortOptions {
@@ -1776,8 +1946,14 @@ interface CreateImageGenerationPortOptions {
     provider: ImageGenerationProviderPort;
     batches: ImageGenerationBatchPersistence;
     events: ImageGenerationEventChannel;
-    /** Ob dieser Host Zugang zu einem katalogisierten Bildmodell hat (D-115). */
-    hasAccess: ImageProviderAccessCheck;
+    /**
+     * Die Zielmodelle, die in diesem Kontext sichtbar sind (D-130). Ihre
+     * `execution_profiles` sind die einzige Quelle ausführbarer Bildmodelle —
+     * der Port konstruiert keines und errät keine Verfügbarkeit.
+     */
+    targetModels: ImageExecutionTargetModelReader;
+    /** Was dieser Host wirklich kann: Umgebung und Aufrufwege (D-132). */
+    capability: ImageHostCapability;
     now?: () => Date;
 }
 /** Der gemeinsame Bildgenerierungs-Port. */
@@ -2554,7 +2730,14 @@ interface CreateMemoryViewPortOptions {
     /** Simulierter Provideraufruf — Voreinstellung liefert `imageCount` Bilder. */
     imageProvider?: ImageGenerationProviderPort;
     /** Ob der simulierte Host Zugang zum katalogisierten Zielmodell hat. Default: immer. */
-    imageProviderHasAccess?: ImageProviderAccessCheck;
+    imageCapability?: ImageHostCapability;
+    /**
+     * Zielmodelle fuer die Bildauswahl. Vorgabe: die `target_model`-Elemente des
+     * Bestands ueber `selectableTargetModels()` — derselbe Weg wie im echten
+     * Host. Direkt setzbar, damit ein Test eine Auswahl stellen kann, ohne
+     * Elemente anzulegen.
+     */
+    imageTargetModels?: readonly ExecutionTargetModel[];
 }
 declare function createMemoryViewPort(options?: CreateMemoryViewPortOptions): SzenenViewPort;
 
@@ -2569,33 +2752,8 @@ 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").
- *
- * Der genaue String für "Nano Banana Pro" ist real belegt, nicht nur
- * dokumentiert: `AvatarArchitectApp.tsx`s produktive Labs-Generierung
- * verwendet `'🍌 Nano Banana Pro'` als Vorgabewert und reicht ihn
- * unverändert als `modelDisplayName` an `Flow.generate.image()` durch
- * (`aiHelpers.ts#buildImageGenerationOptions`).
- *
- * "Imagen 4" bleibt katalogisiert, obwohl es im Modellwähler des
- * Flow-„Generieren"-Tabs am 2026-08-17 ausgegraut erschien (Screenshot,
- * nur "Nano Banana Pro"/"Nano Banana 2" wählbar) — das kann kontoabhängig
- * sein. Ein Aufruf schlägt dann mit der echten Flow-Fehlermeldung fehl,
- * statt einen stillen Fallback zu erzeugen (D-6.9.2-3).
- * `imagen-3.0-generate-001` bleibt bewusst draußen: Dafür ist kein
- * Flow-Display-Name dokumentiert oder belegt.
- */
-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;
+/** Der Aufrufweg, den dieser Adapter bedient (D-132). */
+declare const FLOW_EXECUTION_PATH = "google_flow";
 /**
  * Ein Provideraufruf je Bild — dieselbe Begründung wie beim React-Adapter
  * (`reactImageProvider.ts`): Das SDK kennt keinen Mehrbild-Parameter
@@ -2643,10 +2801,28 @@ interface CreateFlowSzenenViewPortOptions {
     /** 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`).
+     * Was dieser Host beim Bilderzeugen wirklich kann (D-132): seine Umgebung
+     * und seine Aufrufwege. **Keine** Modellliste — welche Modelle ausführbar
+     * sind, steht in den `execution_profiles` der Zielmodelle (D-130).
+     *
+     * Vorgabe: `flow` mit dem einen Weg, den `createFlowImageProvider()` bedient.
+     */
+    imageCapability?: ImageHostCapability;
+    /**
+     * Der Arbeitskontext, über dessen Vererbungskette die Zielmodelle sichtbar
+     * werden — als **Getter**, nicht als Wert.
+     *
+     * Der Grund ist der Lebenszyklus: Der React-Host baut seinen Port je Kontext
+     * neu (`SzenenTab.tsx`), der Flow-Host hält einen Port über die ganze
+     * Sitzung. Ein Wert hier würde den Kontext einfrieren, und ein in einem
+     * Kontext veröffentlichtes Zielmodell wäre im Bildmodell-Wähler unsichtbar,
+     * obwohl der Editor es zeigt. Ein Getter liest ihn bei jeder Auskunft frisch,
+     * ohne den HF-Elementspeicher samt seiner Materialisierung (D-125) bei jedem
+     * Kontextwechsel wegzuwerfen.
+     *
+     * Vorgabe: der globale Kontext.
      */
-    imageProviderHasAccess?: ImageProviderAccessCheck;
+    imageContextId?: () => string | null;
     /** Kennung je abgelegtem Batch-Bild. Ersetzbar, damit ein Test nicht würfelt. */
     newBatchImageId?: (generationBatchId: string, position: number) => string;
 }
@@ -2915,6 +3091,73 @@ interface CreateClientDerivationPortOptions {
 }
 declare function createClientDerivationPort(options: CreateClientDerivationPortOptions): SzenenDerivationPort;
 
+/** Der Lesezugriff, den diese Datei braucht — mehr nicht. */
+type VisibilityQueries = Pick<SzenenQueries, 'listElements' | 'getElement'>;
+/** Ein wählbares Zielmodell — der fachliche Key und woher er kommt. */
+interface SelectableTargetModel {
+    /** Der Wert, der gespeichert wird: `payload.key` (6.10 §6.4). */
+    key: string;
+    title: string;
+    elementId: string;
+    /** Die wirksame Version, aus der der Key stammt. Anzeige, nicht Speicherwert. */
+    versionId: string;
+    provider: string | null;
+    /**
+     * Die Ausfuehrungsprofile dieser wirksamen Version (D-130), roh aus der
+     * Payload. Leer, wenn das Zielmodell keines traegt — der Normalfall fuer ein
+     * reines Prompt-Ziel (D-133). Die Auswahl der wirklich ausfuehrbaren
+     * Kombinationen trifft `executableImageModels()`, nicht diese Datei.
+     */
+    executionProfiles: readonly unknown[];
+    /** Glied der Kette, auf dem der Treffer lag. `0` = Arbeitskontext. */
+    chainIndex: number;
+}
+/** Ein Kandidat, der bewusst **nicht** angeboten wird, samt Grund. */
+interface UnselectableTargetModel {
+    /** Der fachliche Key, der dadurch blockiert ist. */
+    key: string;
+    elementId: string;
+    title: string;
+    reason: 'fork' | 'ambiguous';
+    message: string;
+}
+interface TargetModelChoices {
+    selectable: readonly SelectableTargetModel[];
+    unselectable: readonly UnselectableTargetModel[];
+}
+/**
+ * Die Zielmodelle, die ein Autor wählen darf — **derselbe** Kandidatensatz, den
+ * `resolveTargetModelOver()` später akzeptiert.
+ *
+ * Diese Funktion bildet den Resolver Schritt für Schritt nach, und zwar
+ * absichtlich engmaschig: Der erste Anlauf bot „alle Keys aller Versionen" an,
+ * der zweite nur die wirksame Version je Element — beide Male wich das Ergebnis
+ * in einem Fall vom Resolver ab, und beide Male hat es ein Review gefunden.
+ *
+ * Die Regeln, alle drei aus `resolveTargetModelOver()`:
+ *
+ * 1. **Nur die wirksame Version** liefert den Key (`matchOf` arbeitet auf der
+ *    ausgewählten Version, nicht auf „irgendeiner veröffentlichten").
+ * 2. **Das erste Kettenglied mit einem Treffer entscheidet — und beendet die
+ *    Suche.** Auch dann, wenn der Treffer blockierend ist. Genau hier lag der
+ *    zweite Review-Befund: Ein lokaler Fork, dessen einer Head `imagen_4`
+ *    trägt, ist für `imagen_4` ein **Fork-Treffer** auf dem näheren Glied; der
+ *    Resolver endet dort mit `fork` und greift nicht auf ein globales
+ *    `imagen_4` durch. Ein Picker, der den Key nach dem Fork weiterlaufen
+ *    lässt, bietet einen Wert an, den die Auflösung ablehnt.
+ * 3. **Mehrere Treffer auf demselben Glied sind mehrdeutig** — auch wenn einer
+ *    davon ein Fork ist (`active.length > 1`). Es wird keiner gewählt.
+ *
+ * Blockierte Keys verschwinden nicht stillschweigend: Sie stehen mit Grund in
+ * `unselectable`, sonst sieht ein Zielmodell mit offener Auswahl aus wie ein
+ * nicht vorhandenes.
+ *
+ * Stillgelegte Elemente beenden die Kette **nicht** — der Resolver führt sie als
+ * `shadowedRetired` und sucht weiter (E-7). Sie erscheinen hier gar nicht, weil
+ * `listElements` sie ohne `includeRetired` nicht liefert.
+ */
+declare function selectableTargetModels(queries: VisibilityQueries, contextChain: readonly (string | null)[]): Promise<QueryResult<TargetModelChoices>>;
+
 interface CreateHfImageBatchPersistenceOptions {
     namespace: string;
     token: string;
@@ -3023,4 +3266,4 @@ interface SzenenViewProps {
 }
 declare const SzenenView: React__default.FC<SzenenViewProps>;
 
-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 HfImageStore, type HfImageStoreOptions, 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, bildPfad, 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, createHfImageStore, 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, typAusBytes, unclassifiedPublishRules, unsupportedReason };
+export { type AttachLibraryItemInput, type AttachLibraryItemResult, AuthoritativeSzenenStore, CATALOGUE_TYPES, 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 ExecutableImageModel, type ExecutionTargetModel, type ExistingSzenenItem, FLOW_EXECUTION_PATH, type FlowGenerateImage, type FlowGenerateImageParams, FlowGenerateText, type FreezeDraftChainInput, type FreezeFailure, type FreezeResult, type FreezeSuccess, type FrozenChainNode, type GeneratedImage, type HfImageStore, type HfImageStoreOptions, type IdFactory, type ImageBatchPersistedImage, type ImageBatchPersistedPayload, type ImageExecutionProfile, type ImageExecutionTargetModelReader, type ImageGenerationBatchPersistence, type ImageGenerationEventChannel, type ImageGenerationFinishedPayload, type ImageGenerationOrder, type ImageGenerationProviderPort, type ImageGenerationResult, type ImageGenerationRunReader, type ImageGenerationStartedPayload, type ImageHostCapability, type ImageModelChoice, type ImageModelParameters, ImageProvenance, 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 SelectableTargetModel, 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, type UnselectableTargetModel, UnusableProposal, type VersionMedium, type VisibilityNode, areasFor, batchesForPromptRun, bildPfad, buildSystemInstruction, buildUserPrompt, callOptional, capabilitiesOf, capabilityGate, capabilityReport, catalogueFor, checkCreateElementInput, checkElementType, checkImageExecutionProfile, checkImageModelParameters, 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, createHfImageStore, createImageGenerationPort, createInMemoryEventChannel, createMemoryViewPort, derivationPoliciesOf, deriveItemFromRun, deriveLineage, differentialSteps, draftRevisionOf, executableImageModels, findExecutableImageModel, findImageBatch, 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, selectableTargetModels, totalModelCalls, typAusBytes, unclassifiedPublishRules, unsupportedReason };