@rslsp1/fa-app-tools 10.3.2 → 10.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/szenen.d.mts CHANGED
@@ -1,5 +1,5 @@
1
- import { K as ElementEvent, a9 as PromptConstructionTag, G as DraftChainMeta, am as ReferenceResolver, q as DerivableType, a4 as PreferredHeadResolution, ag as PublishFinding, ay as SchemaError, af as PublishCheckResult, aF as SzenenElementType, aM as TargetModelResolution, a1 as PageRequest, Y as LibraryTagRef, aa as PromptRunAnnotation, a0 as Page, Q as ElementStoreState, z as DerivationInputMode, V as ImageProvenance, v as DerivationFailure, Z as NotDerivable, s as DerivationConflict, x as DerivationFollowUp, t as DerivationDiagnostic, r as DerivationAssessment, k as ContextChainPort, d as AuthoritativeSzenenStore, aE as SzenenElementStore, y as DerivationImage, aH as SzenenQueries, aD as SzenenCommands, aO as UnusableProposal, J as ElementAnnotation } from './storeContract-Cc8tFavd.mjs';
2
- export { A as ALL_PUBLISH_RULES, a as AngezeigterTag, b as AnnotateElementsOptions, c as AnnotateRunsOptions, C as CHAIN_EDGES, e as CHAIN_LINK_FIELDS, f as CatalogueEntry, g as ChainLinkField, h as ChainTarget, i as ChainVerdict, j as CompiledSchemas, l as ContractCheck, m as ContractCheckResult, n as ContractRunResult, o as ContractViolation, p as CreateElementInput, D as DERIVABLE_TYPES, u as DerivationEnvelope, w as DerivationFailureClass, B as DerivationPolicyPayload, E as DerivationProposal, F as DraftChainLink, H as DraftFork, I as DraftRecord, L as ElementListFilter, M as ElementMetadata, N as ElementRecord, O as ElementSnapshot, P as ElementStoreContractHarness, R as ElementVersionValidation, S as FindingSeverity, T as ImageBatchPersistedImage, U as ImageBatchPersistedPayload, W as KEINE_BILDER, X as LOAD_MORE_PAGE_SIZE, _ as OptionalCommand, $ as PROBE_VERSION_ID, a2 as ParentRelation, a3 as PreferredHeadOutcome, a5 as PreferredHeadSelection, a6 as PreferredHeadSource, a7 as ProjectionState, a8 as ProjectionStatus, ab as PromptRunPreviewImage, ac as PromptRunTagsSetPayload, ad as PromptTagSelector, ae as PublishCheckInput, ah as PublishRejected, ai as PublishVersionInput, aj as PublishedVersion, ak as REFERENCE_FIELD, al as ReducerFinding, an as ResolvePreferredHeadOptions, ao as ResolvedVersion, ap as ReviseMetadataInput, aq as STYLE_PAYLOAD, ar as STYLE_PAYLOAD_V2, as as SZENEN_ELEMENT_TYPES, at as SZENEN_EVENT_PREFIX, au as SZENEN_EVENT_TYPES, av as SceneDerivationInput, aw as SceneDerivationOutcome, ax as SceneDerivationOutput, az as SchemaValidationResult, aA as SetPreferredHeadInput, aB as StoreAuthority, aC as SzenenCommandResult, aG as SzenenProjection, aI as TagHerkunft, aJ as TargetModelCandidate, aK as TargetModelQueries, aL as TargetModelQuery, aN as UnsupportedSchemaError, aP as VersionDag, aQ as VersionDagError, aR as VersionNode, aS as VersionParentLink, aT as WriteConflict, aU as WriteDraftInput, aV as annotateElementsFromEvents, aW as annotateRunsFromEvents, aX as annotatedElementsPageOver, aY as assessDerivationResponse, aZ as buildDerivationSystemInstruction, a_ as buildDerivationUserPrompt, a$ as buildVersionDag, b0 as checkChainTargets, b1 as checkDerivationResponse, b2 as checkDraftChainMeta, b3 as collectPromptRunTags, b4 as collectVersionRefs, b5 as compileSchemas, b6 as createSimulationSceneDerivationPort, b7 as describeTargetModelFailure, b8 as draftRevisionOf, b9 as effectivePromptVocabulary, ba as elementStoreContractChecks, bb as elementsByActivity, bc as formatSchemaErrors, bd as getSzenenSchemas, be as isOk, bf as isProjectionCurrent, bg as labelsOf, bh as linkFor, bi as listElementsPageOver, bj as logRevisionOf, bk as mergeRunTags, bl as pageOf, bm as pageRequestFrom, bn as parseDerivationResponse, bo as preferredHeadRevisionOf, bp as preferredVersionId, bq as promptRunTagsOf, br as promptTagGroup, bs as reduceElementEvents, bt as resolvePreferredHead, bu as resolvePromptConstructionTags, bv as resolveTargetModelOver, bw as resolverFromQueries, bx as runElementStoreContract, by as runPublishChecks, bz as runSceneDerivation, bA as showChain, bB as tagRefsAus, bC as validateAgainst, bD as validateDerivationInput, bE as validateElementVersion, bF as validatePayload, bG as withReference } from './storeContract-Cc8tFavd.mjs';
1
+ import { K as ElementEvent, Q as ElementStoreState, a9 as PromptConstructionTag, G as DraftChainMeta, am as ReferenceResolver, q as DerivableType, a4 as PreferredHeadResolution, ag as PublishFinding, ay as SchemaError, af as PublishCheckResult, aF as SzenenElementType, aM as TargetModelResolution, a1 as PageRequest, Y as LibraryTagRef, aa as PromptRunAnnotation, a0 as Page, z as DerivationInputMode, V as ImageProvenance, v as DerivationFailure, Z as NotDerivable, s as DerivationConflict, x as DerivationFollowUp, t as DerivationDiagnostic, r as DerivationAssessment, k as ContextChainPort, d as AuthoritativeSzenenStore, aE as SzenenElementStore, y as DerivationImage, aH as SzenenQueries, aD as SzenenCommands, aO as UnusableProposal, O as ElementSnapshot, J as ElementAnnotation } from './storeContract-Cc8tFavd.mjs';
2
+ export { A as ALL_PUBLISH_RULES, a as AngezeigterTag, b as AnnotateElementsOptions, c as AnnotateRunsOptions, C as CHAIN_EDGES, e as CHAIN_LINK_FIELDS, f as CatalogueEntry, g as ChainLinkField, h as ChainTarget, i as ChainVerdict, j as CompiledSchemas, l as ContractCheck, m as ContractCheckResult, n as ContractRunResult, o as ContractViolation, p as CreateElementInput, D as DERIVABLE_TYPES, u as DerivationEnvelope, w as DerivationFailureClass, B as DerivationPolicyPayload, E as DerivationProposal, F as DraftChainLink, H as DraftFork, I as DraftRecord, L as ElementListFilter, M as ElementMetadata, N as ElementRecord, P as ElementStoreContractHarness, R as ElementVersionValidation, S as FindingSeverity, T as ImageBatchPersistedImage, U as ImageBatchPersistedPayload, W as KEINE_BILDER, X as LOAD_MORE_PAGE_SIZE, _ as OptionalCommand, $ as PROBE_VERSION_ID, a2 as ParentRelation, a3 as PreferredHeadOutcome, a5 as PreferredHeadSelection, a6 as PreferredHeadSource, a7 as ProjectionState, a8 as ProjectionStatus, ab as PromptRunPreviewImage, ac as PromptRunTagsSetPayload, ad as PromptTagSelector, ae as PublishCheckInput, ah as PublishRejected, ai as PublishVersionInput, aj as PublishedVersion, ak as REFERENCE_FIELD, al as ReducerFinding, an as ResolvePreferredHeadOptions, ao as ResolvedVersion, ap as ReviseMetadataInput, aq as STYLE_PAYLOAD, ar as STYLE_PAYLOAD_V2, as as SZENEN_ELEMENT_TYPES, at as SZENEN_EVENT_PREFIX, au as SZENEN_EVENT_TYPES, av as SceneDerivationInput, aw as SceneDerivationOutcome, ax as SceneDerivationOutput, az as SchemaValidationResult, aA as SetPreferredHeadInput, aB as StoreAuthority, aC as SzenenCommandResult, aG as SzenenProjection, aI as TagHerkunft, aJ as TargetModelCandidate, aK as TargetModelQueries, aL as TargetModelQuery, aN as UnsupportedSchemaError, aP as VersionDag, aQ as VersionDagError, aR as VersionNode, aS as VersionParentLink, aT as WriteConflict, aU as WriteDraftInput, aV as annotateElementsFromEvents, aW as annotateRunsFromEvents, aX as annotatedElementsPageOver, aY as assessDerivationResponse, aZ as buildDerivationSystemInstruction, a_ as buildDerivationUserPrompt, a$ as buildVersionDag, b0 as checkChainTargets, b1 as checkDerivationResponse, b2 as checkDraftChainMeta, b3 as collectPromptRunTags, b4 as collectVersionRefs, b5 as compileSchemas, b6 as createSimulationSceneDerivationPort, b7 as describeTargetModelFailure, b8 as draftRevisionOf, b9 as effectivePromptVocabulary, ba as elementStoreContractChecks, bb as elementsByActivity, bc as formatSchemaErrors, bd as getSzenenSchemas, be as isOk, bf as isProjectionCurrent, bg as labelsOf, bh as linkFor, bi as listElementsPageOver, bj as logRevisionOf, bk as mergeRunTags, bl as pageOf, bm as pageRequestFrom, bn as parseDerivationResponse, bo as preferredHeadRevisionOf, bp as preferredVersionId, bq as promptRunTagsOf, br as promptTagGroup, bs as reduceElementEvents, bt as resolvePreferredHead, bu as resolvePromptConstructionTags, bv as resolveTargetModelOver, bw as resolverFromQueries, bx as runElementStoreContract, by as runPublishChecks, bz as runSceneDerivation, bA as showChain, bB as tagRefsAus, bC as validateAgainst, bD as validateDerivationInput, bE as validateElementVersion, bF as validatePayload, bG as withReference } from './storeContract-Cc8tFavd.mjs';
3
3
  import { T as TextGenerationImage, c as TextGenerationPort, Q as QueryResult, C as CommandResult } from './contracts-B3AbzYQ4.mjs';
4
4
  export { S as SIMULATION_PROVIDER, d as TextGenerationRequest, e as TextGenerationResult, h as createFakeTextGenerationPort, i as createSimulationTextGenerationPort, s as simulatedAnswerFor } from './contracts-B3AbzYQ4.mjs';
5
5
  import { e as HFMetadataEntry, g as HFStateSnapshot, F as FlowGenerateText } from './hfEventTypes-DQPjEP4T.mjs';
@@ -104,6 +104,29 @@ declare const SZENEN_SCHEMAS: Readonly<Record<string, RawSchema>>;
104
104
  /** Dateiname des Umschlagschemas — Einstieg jeder Validierung. */
105
105
  declare const ELEMENT_VERSION_SCHEMA_FILE = "element-version.schema.json";
106
106
 
107
+ declare const STAGE_MIGRATION_ID = "stage_floor_center_v1";
108
+ declare const STAGE_MIGRATION_EVENT = "szenen.stage_convention_migrated";
109
+ type Payload$1 = Record<string, any>;
110
+ interface StageMigrationEntry {
111
+ element_id: string;
112
+ version_id?: string;
113
+ draft_id?: string;
114
+ revision?: number;
115
+ before: Payload$1;
116
+ after: Payload$1;
117
+ }
118
+ interface StageMigration {
119
+ migration_id: typeof STAGE_MIGRATION_ID;
120
+ entries: StageMigrationEntry[];
121
+ report: {
122
+ remaining_boxes: string[];
123
+ changed_camera_views: string[];
124
+ placements: number;
125
+ };
126
+ }
127
+ /** One atomic log event, retaining identities and references under the issue's MVP migration exception. */
128
+ declare function prepareStageMigration(state: ElementStoreState): StageMigration;
129
+
107
130
  /** Der Subtyp, der ohne jede weitere Bedingung gilt (Auftrag §1). */
108
131
  declare const GENERAL_POLICY_SUBTYPE = "general";
109
132
  /**
@@ -829,6 +852,14 @@ interface ResolvedNode {
829
852
  proxy_3d?: {
830
853
  primitive: string;
831
854
  dimensions: readonly number[];
855
+ variant?: string;
856
+ pose_ref?: string | null;
857
+ origin?: 'floor_center';
858
+ morph?: {
859
+ build?: number;
860
+ gender?: number;
861
+ };
862
+ preview_color?: string | null;
832
863
  } | null;
833
864
  anchors?: Readonly<Record<string, readonly number[]>>;
834
865
  type: string;
@@ -4640,59 +4671,591 @@ declare function buildManualPromptRunRecord(eingabe: BuildManualPromptRunInput):
4640
4671
  /** Der Handeingabe-Block eines Laufs, oder `null` bei jedem anderen Lauf. */
4641
4672
  declare function manualEntryOf(run: PromptRunPageRecord): ManualPromptEntry | null;
4642
4673
 
4643
- interface CreateMemoryViewPortOptions {
4644
- /**
4645
- * Die **direkten** Tags je Lauf — Kette `szenen-prompt-anzeige-bilder-tags`.
4646
- *
4647
- * Der Speicherhost fuehrt sie als Zustand und laesst sie auch schreiben:
4648
- * Anders als der Ereignislog-Weg braucht er dafuer keine Vokabel-Tabelle,
4649
- * und ein Editor, der im Test nichts ablegen kann, prueft nichts.
4650
- */
4651
- runTags?: Record<string, readonly string[]>;
4652
- /**
4653
- * Bildanzahl, Vorschau und Library-Tags je Lauf.
4654
- *
4655
- * Vorbelegt statt aus Ereignissen gefaltet: Dieser Port haelt Laeufe als
4656
- * Liste, nicht als Log. Die Faltung selbst prueft
4657
- * `promptKarte.test.ts` gegen `annotateRunsFromEvents`.
4658
- */
4659
- runAnnotations?: Record<string, PromptRunAnnotation>;
4660
- /** Die Vorschlagsliste des Tag-Editors. Fehlt sie, bietet der Port keine an. */
4661
- tagVocabulary?: readonly string[];
4674
+ type StagePlane = 'top' | 'side' | 'camera' | 'free';
4675
+ type Vec3$1 = [number, number, number];
4676
+ declare const STAGE_CATALOGUE: readonly [{
4677
+ readonly label: "Mensch";
4678
+ readonly type: "subject";
4679
+ readonly dimensions: readonly [0.55, 0.35, 1.75];
4680
+ readonly primitive: "humanoid_proxy";
4681
+ readonly pose_ref: "standing";
4682
+ }, {
4683
+ readonly label: "Stuhl";
4684
+ readonly type: "object";
4685
+ readonly dimensions: readonly [0.5, 0.5, 0.9];
4686
+ readonly primitive: "furniture_proxy";
4687
+ readonly variant: "chair";
4688
+ }, {
4689
+ readonly label: "Tisch";
4690
+ readonly type: "surface";
4691
+ readonly dimensions: readonly [1.2, 0.7, 0.75];
4692
+ readonly primitive: "furniture_proxy";
4693
+ readonly variant: "table";
4694
+ }, {
4695
+ readonly label: "Lampe";
4696
+ readonly type: "light";
4697
+ readonly dimensions: readonly [0.35, 0.35, 1.5];
4698
+ readonly primitive: "furniture_proxy";
4699
+ readonly variant: "floor_lamp";
4700
+ }, {
4701
+ readonly label: "Raum";
4702
+ readonly type: "object";
4703
+ readonly dimensions: readonly [5, 4, 2.8];
4704
+ readonly primitive: "room_shell";
4705
+ }];
4706
+ /**
4707
+ * Unterhalb dieses Abstands gelten zwei Markerfarben als schwer unterscheidbar
4708
+ * („redmean“-Abstand im RGB-Raum, 0…~765). Runde 6 zeigte #df995f gegen
4709
+ * #e89254 (Abstand ≈ 26) — das konnte das Bildmodell nicht trennen.
4710
+ */
4711
+ declare const PREVIEW_COLOR_MIN_DISTANCE = 75;
4712
+ /** `#RRGGBB` in beliebiger Schreibweise → `#rrggbb`, sonst `null`. */
4713
+ declare function normalizePreviewColor(value: unknown): string | null;
4714
+ /** Wahrnehmungsnaher Abstand zweier Farben („redmean“). */
4715
+ declare function previewColorDistance(a: string, b: string): number;
4716
+ type ColorNode = Pick<ResolvedNode, 'node_id' | 'type'> & {
4717
+ proxy_3d?: {
4718
+ preview_color?: string | null;
4719
+ } | null;
4720
+ };
4721
+ /**
4722
+ * Die wirksame Markerfarbe je Node.
4723
+ *
4724
+ * Eine gespeicherte `proxy_3d.preview_color` gilt immer — auch wenn sie einer
4725
+ * anderen ähnelt; das meldet `previewColorConflicts`. Nodes ohne gespeicherte
4726
+ * Farbe bekommen, in `node_id`-Reihenfolge, die Typfarbe oder die nächste
4727
+ * Ersatzfarbe, die von allen bereits vergebenen deutlich abweicht. Damit
4728
+ * Ersatzfarben stabil bleiben, schreiben Editor und MCP sie bei jeder
4729
+ * Bühnenänderung fest (`pinPreviewColors`).
4730
+ */
4731
+ declare function stageColors(nodes: readonly ColorNode[]): Record<string, {
4732
+ hex: string;
4733
+ name: string;
4734
+ explicit: boolean;
4735
+ }>;
4736
+ /**
4737
+ * Hinweis für Markerfarben, die im Kamera-Preview schlecht als Marker taugen:
4738
+ * sehr dunkel (liest sich als Schatten oder dunkle Kleidung) oder sehr hell
4739
+ * (verschwindet im hellen Preview-Hintergrund). Keine Sperre — nur ein Hinweis.
4740
+ */
4741
+ declare function previewColorLegibility(hex: string): 'too_dark' | 'too_light' | null;
4742
+ type PreviewColorConflict = {
4743
+ node_ids: [string, string];
4744
+ hexes: [string, string];
4745
+ distance: number;
4746
+ identical: boolean;
4747
+ };
4748
+ /** Paare wirksamer Markerfarben, die gleich oder schwer unterscheidbar sind. */
4749
+ declare function previewColorConflicts(nodes: readonly ColorNode[]): PreviewColorConflict[];
4750
+ /** Nur die zwei sichtbaren Achsen ändern; die verborgene Tiefe bleibt erhalten. */
4751
+ declare function dragPosition(position: readonly number[], point: readonly number[], plane: StagePlane): Vec3$1;
4752
+ declare function stageNode(node: ResolvedNode): {
4753
+ node_id: string;
4754
+ type: string;
4755
+ primitive: string;
4756
+ dimensions: Vec3$1;
4757
+ variant: string | undefined;
4758
+ pose_ref: string | null | undefined;
4759
+ morph: {
4760
+ build?: number;
4761
+ gender?: number;
4762
+ } | undefined;
4763
+ position: Vec3$1;
4764
+ rotation: Vec3$1;
4765
+ scale: Vec3$1;
4766
+ anchors: Readonly<Record<string, readonly number[]>> | undefined;
4767
+ };
4768
+ /** Rendern ist nur bei vollständigen Daten zulässig, niemals mit geratenen Positionen. */
4769
+ declare function stageFrame(input: RendererInput): {
4770
+ nodes: {
4771
+ preview_color: {
4772
+ hex: string;
4773
+ name: string;
4774
+ };
4775
+ node_id: string;
4776
+ type: string;
4777
+ primitive: string;
4778
+ dimensions: Vec3$1;
4779
+ variant: string | undefined;
4780
+ pose_ref: string | null | undefined;
4781
+ morph: {
4782
+ build?: number;
4783
+ gender?: number;
4784
+ } | undefined;
4785
+ position: Vec3$1;
4786
+ rotation: Vec3$1;
4787
+ scale: Vec3$1;
4788
+ anchors: Readonly<Record<string, readonly number[]>> | undefined;
4789
+ }[];
4790
+ camera: {
4791
+ position: Vec3$1;
4792
+ orientation: Record<string, unknown>;
4793
+ aspect_ratio: string;
4794
+ aspect: number;
4795
+ focal_length_mm: number;
4796
+ sensor_width_mm: number;
4797
+ vertical_fov_deg: number;
4798
+ camera_id: string;
4799
+ name: string | null;
4800
+ preset: unknown;
4801
+ placement: unknown;
4802
+ framing: unknown;
4803
+ focus: unknown;
4804
+ pattern: unknown | null;
4805
+ };
4806
+ };
4807
+
4808
+ type Payload = Record<string, any>;
4809
+ type Vec3 = [number, number, number];
4810
+ declare const NODE_TYPES: readonly ["subject", "object", "surface", "light", "camera_target", "group", "other"];
4811
+ declare const PROXY_PRIMITIVES: readonly ["humanoid_proxy", "box", "cylinder", "sphere", "plane", "room_shell", "furniture_proxy"];
4812
+ type StageOperation = {
4813
+ op: 'add_node';
4814
+ node_id?: string;
4815
+ label?: string;
4816
+ type: string;
4817
+ description: string;
4818
+ properties?: Record<string, unknown>;
4819
+ primitive?: string;
4820
+ dimensions?: Vec3;
4821
+ variant?: string;
4822
+ pose_ref?: string;
4823
+ morph?: {
4824
+ build?: number;
4825
+ gender?: number;
4826
+ };
4827
+ preview_color?: string;
4828
+ position?: Vec3;
4829
+ rotation_euler_deg?: Vec3;
4830
+ scale?: Vec3;
4831
+ } | {
4832
+ op: 'update_node';
4833
+ node_id: string;
4834
+ label?: string | null;
4835
+ type?: string;
4836
+ description?: string;
4837
+ properties?: Record<string, unknown>;
4838
+ primitive?: string;
4839
+ dimensions?: Vec3;
4840
+ variant?: string;
4841
+ pose_ref?: string;
4842
+ morph?: {
4843
+ build?: number;
4844
+ gender?: number;
4845
+ };
4846
+ /** `null` setzt auf die automatisch vergebene Standardfarbe zurück. */
4847
+ preview_color?: string | null;
4848
+ } | {
4849
+ op: 'place_node';
4850
+ node_id: string;
4851
+ position?: Vec3;
4852
+ rotation_euler_deg?: Vec3;
4853
+ scale?: Vec3;
4854
+ } | {
4855
+ op: 'remove_node';
4856
+ node_id: string;
4857
+ } | {
4858
+ op: 'add_camera';
4859
+ camera: Payload;
4860
+ } | {
4861
+ op: 'update_camera';
4862
+ camera_id: string;
4863
+ changes: Payload;
4864
+ } | {
4865
+ op: 'set_shot_camera';
4866
+ camera_id: string;
4867
+ };
4868
+ interface StagePayloads {
4869
+ scene: Payload;
4870
+ setup: Payload;
4871
+ shot: Payload | null;
4872
+ }
4873
+ type StageOperationsResult = {
4874
+ kind: 'ok';
4875
+ payloads: StagePayloads;
4876
+ changed: {
4877
+ scene: boolean;
4878
+ setup: boolean;
4879
+ shot: boolean;
4880
+ };
4881
+ created_node_ids: string[];
4882
+ /** Gesetzte Reihenfolge der Writes, so dass kein Zwischenstand verwaist. */
4883
+ write_order: ('scene' | 'setup' | 'shot')[];
4884
+ color_conflicts: PreviewColorConflict[];
4885
+ } | {
4886
+ kind: 'rejected';
4887
+ message: string;
4888
+ operation_index: number | null;
4889
+ };
4890
+ /**
4891
+ * Die Nodes, wie der Editor sie färbt: alle nicht ausgeblendeten, mit der
4892
+ * wirksamen Proxy-Geometrie (eine `proxy_3d`-Überschreibung im Aufbau gilt vor
4893
+ * der Szene — dieselbe Regel wie in `resolve`).
4894
+ */
4895
+ declare function previewColorNodes(scene: Payload, setup: Payload | null, shot: Payload | null): {
4896
+ node_id: string;
4897
+ type: string;
4898
+ proxy_3d: any;
4899
+ }[];
4900
+ /**
4901
+ * Schreibt die wirksamen Markerfarben aller Proxy-Nodes der Szene fest.
4902
+ *
4903
+ * Ersatzfarben hängen von den anderen Nodes ab; ohne Festschreiben könnte das
4904
+ * Hinzufügen oder Entfernen eines Nodes die Farbe eines anderen verschieben.
4905
+ * Sichtbare Nodes behalten genau ihre angezeigte Farbe, ausgeblendete bekommen
4906
+ * eine davon deutlich verschiedene. Nodes, deren Geometrie im Aufbau
4907
+ * überschrieben ist, bleiben unberührt — ihre Farbe wirkt dort.
4908
+ */
4909
+ declare function pinPreviewColors(scene: Payload, setup: Payload | null, shot: Payload | null): Payload;
4910
+ /**
4911
+ * Rechnet die Operationen auf die drei Payloads um. Schreibt nichts.
4912
+ *
4913
+ * Abgelehnt wird jede Operation, die einen inkonsistenten Endstand ergäbe:
4914
+ * unbekannte oder doppelte Node-IDs, Placements ohne Node, Kameras ohne
4915
+ * Eintrag im Rig, ein entfernter Node, auf den noch eine Kamera oder der Shot
4916
+ * zeigt. Hinzufügen und Entfernen in einem Aufruf wird abgelehnt: Für diese
4917
+ * Kombination gibt es keine Schreibreihenfolge ohne verwaisten Zwischenstand.
4918
+ */
4919
+ declare function applyStageOperations(input: StagePayloads, operations: readonly StageOperation[]): StageOperationsResult;
4920
+
4921
+ type StageElementsPort = Pick<SzenenQueries, 'getElement' | 'listElements'> & Pick<SzenenCommands, 'createElement' | 'writeDraft'>;
4922
+ interface StageChainState {
4923
+ chain_id: string;
4924
+ scene: ElementSnapshot;
4925
+ setup: ElementSnapshot;
4926
+ shot: ElementSnapshot;
4927
+ }
4928
+ /**
4929
+ * Die bestehende Bühnenkette einer Szene, oder `null`, wenn die Szene keinen
4930
+ * Kettenentwurf hat. Eine unvollständige oder mehrdeutige Kette ist ein Fehler
4931
+ * und wird nicht geraten.
4932
+ */
4933
+ declare function findStageDraftChain(elements: StageElementsPort, sceneElementId: string): Promise<StageChainState | null>;
4934
+ interface OpenStageDraftChainInput {
4935
+ sceneElementId: string;
4936
+ setupElementId: string;
4937
+ /** Die veröffentlichte Aufbauversion, von der aus begonnen wird; `null` = sein Entwurf. */
4938
+ setupVersionId: string | null;
4939
+ contextId: string | null;
4940
+ /** Zielmodell für einen neu angelegten Shot, sonst weggelassen. */
4941
+ targetModelId?: string | null;
4942
+ newChainId?: () => string;
4943
+ }
4944
+ /**
4945
+ * Legt die Bühnenkette an oder setzt eine bestehende fort — genau der Ablauf,
4946
+ * mit dem der Editor eine Ansicht in einen 3D-Entwurf überführt.
4947
+ *
4948
+ * Kein erfundener Shot und keine erfundene Version: Ein Shot dieser Kette wird
4949
+ * wiederverwendet, sonst wird genau einer angelegt.
4950
+ */
4951
+ declare function openStageDraftChain(elements: StageElementsPort, input: OpenStageDraftChainInput): Promise<StageChainState>;
4952
+
4953
+ /**
4954
+ * Der Anbieter, der in einem so entstandenen Lauf steht.
4955
+ *
4956
+ * `mcp_client` und nicht `openai`/`chatgpt`: Was der Server sicher weiss, ist
4957
+ * dass **sein MCP-Aufrufer** formuliert hat. Welcher Anbieter dahinter steht,
4958
+ * sagt ihm niemand — und ein geratener Anbietername waere im Lauf spaeter
4959
+ * nicht mehr von einem belegten zu unterscheiden (D-107).
4960
+ */
4961
+ declare const MCP_CLIENT_PROVIDER = "mcp_client";
4962
+ /**
4963
+ * Die Modellkennung, wenn der Host keine belegte liefert — und das tut er nie.
4964
+ *
4965
+ * Bewusst ein sprechender Platzhalter statt einer Modellversion: `model_id`
4966
+ * ist das Feld, an dem ein Leser ablesen soll, **womit** formuliert wurde.
4967
+ * Eine dort eingetragene Selbstauskunft saehe aus wie eine belegte Kennung.
4968
+ * Die Selbstauskunft steht deshalb in `execution_origin.declared_model_id` und
4969
+ * traegt dort sichtbar, dass sie unbelegt ist.
4970
+ */
4971
+ declare const UNVERIFIED_MODEL_ID = "mcp-client-unspecified";
4972
+ /**
4973
+ * Die Herkunft der Ausfuehrung, so ehrlich wie sie belegbar ist.
4974
+ *
4975
+ * Additiv am Lauf und nicht in `model_id`/`provider` versteckt: Der
4976
+ * Unterschied zwischen „das war Modell X" und „der Aufrufer sagt, es war
4977
+ * Modell X" ist genau der, um den es geht.
4978
+ */
4979
+ interface PromptExecutionOrigin {
4980
+ /** Wer den Lauf eingereicht hat — hier immer der MCP-Werkzeugweg. */
4981
+ host: 'mcp';
4982
+ /** Was der Aufrufer ueber sich selbst gesagt hat, unveraendert und unbelegt. */
4983
+ declared_model_id?: string;
4662
4984
  /**
4663
- * Bildanzahl, Deckbild und Tags je **Element**.
4985
+ * Ob die unten mitgegebene Renderer-Anweisung die tatsaechliche
4986
+ * Systemnachricht des formulierenden Chats war.
4664
4987
  *
4665
- * Vorbelegt wie `runAnnotations` und aus demselben Grund: Dieser Port haelt
4666
- * keinen Laufbestand, aus dem sich die Ableitung falten liesse. Die Faltung
4667
- * selbst prueft `promptKarte.test.ts` gegen `annotateElementsFromEvents`.
4668
- */
4669
- elementAnnotations?: Record<string, ElementAnnotation>;
4670
- /**
4671
- * Ob der Port Items anbietet. `false` bildet Flow-Pure nach: das Feld fehlt
4672
- * dann ganz, statt eine Operation zu haben, die `unsupported` zurückgibt.
4673
- * Der Unterschied ist der Punkt — U26 verlangt, dass die View damit ohne
4674
- * Sondercode umgeht.
4988
+ * Sie war es nie: Der MCP reicht sie als Werkzeugergebnis heraus; was im
4989
+ * Chat als Systemprompt stand, kennt der Server nicht. Das Feld steht
4990
+ * trotzdem im Lauf, weil `system_prompt` sonst genau so gelesen wuerde.
4675
4991
  */
4676
- items?: boolean;
4677
- /** Ob der Port Medien anbietet (Stufe 5 vorhanden). */
4678
- media?: boolean;
4992
+ renderer_instruction_was_system_prompt: false;
4993
+ }
4994
+ /** Der Antwortvertrag, den der Aufrufer erfuellen muss — maschinenlesbar. */
4995
+ interface PromptResponseContract {
4996
+ format: 'json';
4997
+ /** Pflichtfelder der Antwort, wie `checkRunResponse()` sie prueft. */
4998
+ required_fields: readonly string[];
4999
+ /** Ob ein Negativ-Prompt zugesagt ist (sonst muss `negative` null bleiben). */
5000
+ negative_prompt_allowed: boolean;
5001
+ /** Jeder dieser Knoten muss in `visibility.nodes` erscheinen (D-21). */
5002
+ node_ids: readonly string[];
5003
+ /** Die Sprache, in der `positive` formuliert wird. */
5004
+ prompt_language: string;
5005
+ }
5006
+ /** Ein vorbereiteter Promptvorgang — dauerhaft unter `operation_id`. */
5007
+ interface PreparedPromptOperation {
5008
+ operation_id: string;
5009
+ /** Die eingefrorene Szene: genau ein Entwurfs- oder Versionsstand (D-135). */
5010
+ scene: FrozenSceneState;
5011
+ context_id: string | null;
5012
+ /** Die Arbeitsanweisung des Nutzers, soweit eine gegeben wurde. */
5013
+ user_instruction: string | null;
5014
+ /** Der eingefrorene `RendererInput` — woertlich der des bestehenden Pfads. */
5015
+ renderer_input: RendererInput;
4679
5016
  /**
4680
- * Anzeigbare Vorschauen je `asset_id` (Kette `szenen-design`, P4).
5017
+ * Die Renderer-Anweisung (`buildSystemInstruction`).
4681
5018
  *
4682
- * Gesetzt bietet der Medienport `loadAssetPreview()` an und beantwortet eine
4683
- * unbekannte Kennung mit einem Fehler. Fehlt die Angabe, fehlt auch die
4684
- * Operation — wie in einem Host, der Assets nicht aufloesen kann (R11).
5019
+ * Sie ist **Material fuer den Aufrufer**, nicht sein Systemprompt. Beim
5020
+ * Abschluss landet sie unveraendert in `system_prompt` des Laufs, weil das
5021
+ * Feld seit Stufe 3 genau diese Anweisung fuehrt.
4685
5022
  */
4686
- assetPreviews?: Readonly<Record<string, string>>;
5023
+ renderer_instruction: string;
5024
+ /** Die Nutzernachricht: die Renderer-Eingabe als JSON (D-47). */
5025
+ renderer_payload: string;
5026
+ response_contract: PromptResponseContract;
5027
+ prepared_by: string;
5028
+ created_at: string;
5029
+ }
5030
+ /** Nutzlast von `promptOperationPrepared`. */
5031
+ type PromptOperationPreparedPayload = PreparedPromptOperation;
5032
+ /** Liest alle vorbereiteten Vorgaenge aus dem Ereignislog. */
5033
+ declare function collectPromptOperations(events: readonly ElementEvent[]): readonly PreparedPromptOperation[];
5034
+ /** Ein einzelner vorbereiteter Vorgang, oder `null`. */
5035
+ declare function findPromptOperation(events: readonly ElementEvent[], operationId: string): PreparedPromptOperation | null;
5036
+ interface PreparePromptOperationInput {
5037
+ sceneElementId: string;
5038
+ operationId: string;
5039
+ store: ChainQueries;
5040
+ resolver: ReferenceResolver;
5041
+ contextChain: readonly (string | null)[];
5042
+ contextId: string | null;
5043
+ userInstruction?: string | null;
4687
5044
  /**
4688
- * Ob der Port einen Bildbestand anbietet (D-94).
5045
+ * Das gewaehlte Zielmodell (Kette `szenen-direktlauf-target-model-policy`).
4689
5046
  *
4690
- * `false` bildet einen Host ohne ihn ab: Der Bereich zeigt dann nur den
4691
- * Upload, und ein Folgelauf ohne Bild wird mit Grund abgelehnt.
5047
+ * Optional. Ohne Angabe bleibt der Vorgang exakt der generische von D-135;
5048
+ * mit Angabe traegt der eingefrorene `RendererInput` die Modellprovenienz,
5049
+ * und `completePromptOperation()` schreibt ihre `version_id` ohne Zutun in
5050
+ * `target_model_version_id` des Laufs.
4692
5051
  */
4693
- imageLibrary?: boolean;
4694
- /**
4695
- * Vorbelegte Bilder des Bestands — jedes für sich ein **Einbild-Werk**.
5052
+ targetModelElementId?: string | null;
5053
+ preparedBy: string;
5054
+ now?: () => Date;
5055
+ }
5056
+ type PreparePromptOperationResult = {
5057
+ kind: 'ok';
5058
+ operation: PreparedPromptOperation;
5059
+ } | FreezeFailure;
5060
+ /**
5061
+ * Friert den Arbeitsstand einer Szene ein und baut daraus den Vorgang.
5062
+ *
5063
+ * Ruft **kein** Modell — hier entstehen keine Kosten. Das Einfrieren ist
5064
+ * woertlich `freezeSceneWorkingState()`, also derselbe Zwei-Durchgang-Vergleich
5065
+ * mit denselben drei Ausgaengen wie im bestehenden Pfad (D-97/D-135). Ein
5066
+ * Konflikt bleibt ein Konflikt, kein „nochmal versuchen".
5067
+ */
5068
+ declare function preparePromptOperation(input: PreparePromptOperationInput): Promise<PreparePromptOperationResult>;
5069
+ /**
5070
+ * Der Antwortvertrag, abgelesen an derselben Eingabe wie die Anweisung.
5071
+ *
5072
+ * Bewusst abgelesen und nicht danebengeschrieben: Was `checkRunResponse()
5073
+ * prueft, entscheidet allein `promptRun.ts`. Ein hier gepflegter zweiter
5074
+ * Katalog liefe irgendwann auseinander, und der Aufrufer bekaeme einen
5075
+ * Vertrag, den die Pruefung nicht kennt.
5076
+ */
5077
+ declare function responseContractOf(input: RendererInput): PromptResponseContract;
5078
+ interface CompletePromptOperationInput {
5079
+ operation: PreparedPromptOperation;
5080
+ /** Die Antwort des aufrufenden Modells, woertlich. */
5081
+ response: string;
5082
+ runId: string;
5083
+ /** Was der Aufrufer ueber sein eigenes Modell sagt — unbelegt (D-107). */
5084
+ declaredModelId?: string | null;
5085
+ now?: () => Date;
5086
+ }
5087
+ type CompletePromptOperationResult = {
5088
+ kind: 'ok';
5089
+ record: PromptRunRecord;
5090
+ } | {
5091
+ kind: 'rejected';
5092
+ message: string;
5093
+ };
5094
+ /**
5095
+ * Macht aus der Antwort des Aufrufers einen normalen Promptlauf.
5096
+ *
5097
+ * **Eine ungueltige Antwort wird nicht als gescheiterter Lauf abgelegt.** Das
5098
+ * ist der eine bewusste Unterschied zum Providerpfad, und er hat einen Grund:
5099
+ * Dort belegt ein `failed` einen **bezahlten** Aufruf, der sich nicht
5100
+ * wiederholen laesst, ohne noch einmal zu kosten (D-23 §6). Hier hat niemand
5101
+ * bezahlt — der Aufrufer hat nur falsch formuliert und kann es unter derselben
5102
+ * `operation_id` sofort richtig tun. Ein Fehlerlauf waere hier kein Nachweis,
5103
+ * sondern Muell im autoritativen Bestand, und er wuerde die Wiederholung
5104
+ * ausserdem als Konflikt blockieren.
5105
+ */
5106
+ declare function completePromptOperation(input: CompletePromptOperationInput): CompletePromptOperationResult;
5107
+ /**
5108
+ * Der Lauf, der aus diesem Vorgang schon entstanden ist — oder `null`.
5109
+ *
5110
+ * Grundlage der Idempotenz: Derselbe Vorgang mit derselben Antwort liefert
5111
+ * denselben Lauf; eine **andere** Antwort unter derselben Kennung ist ein
5112
+ * Konflikt und kein zweiter Lauf. Verglichen wird die woertliche Antwort aus
5113
+ * `raw_output` — es braucht keinen Fingerabdruck neben etwas, das der Lauf
5114
+ * ohnehin vollstaendig traegt.
5115
+ */
5116
+ declare function runOfOperation(runs: readonly PromptRunRecord[], operationId: string): PromptRunRecord | null;
5117
+ /** Ob eine eingereichte Antwort woertlich die des bereits gespeicherten Laufs ist. */
5118
+ declare function sameResponseAs(run: PromptRunRecord, response: string): boolean;
5119
+
5120
+ /** Die Rolle des Kamera-Previews unter den Eingangsbildern. */
5121
+ declare const CAMERA_PREVIEW_ASSET_ROLE = "camera_preview";
5122
+ /** Ein Eingangsbild, so wie der Quelllauf es tatsaechlich benutzt hat. */
5123
+ interface PromptRunInputAsset {
5124
+ /** Kanonische Asset-Kennung — nie ein Dateiname oder Blob. */
5125
+ asset_id: string;
5126
+ role: typeof CAMERA_PREVIEW_ASSET_ROLE;
5127
+ /** Platz in der geordneten Eingangsliste, ab 0, luckenlos. */
5128
+ position: number;
5129
+ /** Die Schreibweise im Prompt, wie sie das eingefrorene Zielmodell festlegt. */
5130
+ prompt_token: string | null;
5131
+ /** Pruefsumme der Bytes — muss zum eingefrorenen Preview passen. */
5132
+ sha256: string;
5133
+ /** Wo das Asset liegt: Lauf und Run-Item, an dem es gespeichert ist. */
5134
+ origin: {
5135
+ run_id: string;
5136
+ item_id: string;
5137
+ };
5138
+ }
5139
+ /** Die Herkunft eines Variantenlaufs. */
5140
+ interface PromptRunVariantOf {
5141
+ source_run_id: string;
5142
+ operation_id: string;
5143
+ input_assets: readonly PromptRunInputAsset[];
5144
+ }
5145
+ type PromptRunVariantRecord = PromptRunRecord & {
5146
+ operation_id: string;
5147
+ execution_origin: PromptExecutionOrigin;
5148
+ variant_of: PromptRunVariantOf;
5149
+ };
5150
+ interface BuildPromptRunVariantInput {
5151
+ runId: string;
5152
+ operationId: string;
5153
+ /** Der gespeicherte Quelllauf, unveraendert aus dem autoritativen Log. */
5154
+ source: PromptRunRecord;
5155
+ positive: string;
5156
+ negative?: string | null;
5157
+ note?: string | null;
5158
+ declaredModelId?: string | null;
5159
+ inputAssets: readonly PromptRunInputAsset[];
5160
+ now?: () => Date;
5161
+ }
5162
+ type BuildPromptRunVariantResult = {
5163
+ kind: 'ok';
5164
+ record: PromptRunVariantRecord;
5165
+ } | {
5166
+ kind: 'rejected';
5167
+ message: string;
5168
+ };
5169
+ type Verdict = {
5170
+ ok: true;
5171
+ } | {
5172
+ ok: false;
5173
+ message: string;
5174
+ };
5175
+ /**
5176
+ * Prueft die geordneten Eingangsbilder gegen den eingefrorenen Lauf.
5177
+ *
5178
+ * Ein Lauf mit Kamera-Preview braucht genau dieses Preview als Eingang — ein
5179
+ * fehlendes waere ein stilles Weglassen, ein abweichendes ein Ersatzbild.
5180
+ */
5181
+ declare function checkVariantInputAssets(assets: unknown, cameraPreview: PromptRunRecord['camera_preview'] | undefined): Verdict;
5182
+ /**
5183
+ * Prueft den Variantenblock eines Laufs. Additiv und optional: Ein Lauf ohne
5184
+ * `variant_of` bleibt unveraendert gueltig.
5185
+ */
5186
+ declare function checkVariantBlock(record: Record<string, unknown>): Verdict;
5187
+ /**
5188
+ * Baut den Variantenlauf. Prueft, was ohne Bestandszugriff pruefbar ist; die
5189
+ * Rechte und die Erreichbarkeit der Assets prueft der Host vorher.
5190
+ */
5191
+ declare function buildPromptRunVariantRecord(eingabe: BuildPromptRunVariantInput): BuildPromptRunVariantResult;
5192
+ /** Der Variantenblock eines Laufs, oder `null` bei jedem anderen Lauf. */
5193
+ declare function variantOf(run: PromptRunPageRecord | PromptRunRecord): PromptRunVariantOf | null;
5194
+ /**
5195
+ * Ist dieser gespeicherte Lauf genau die angefragte Variante? Grundlage der
5196
+ * Idempotenz: dieselbe operation_id mit derselben Anfrage liefert denselben
5197
+ * Lauf, eine abweichende ist ein Konflikt.
5198
+ */
5199
+ declare function sameVariantRequest(run: PromptRunRecord, anfrage: {
5200
+ sourceRunId: string;
5201
+ positive: string;
5202
+ negative?: string | null;
5203
+ note?: string | null;
5204
+ }): boolean;
5205
+
5206
+ interface CreateMemoryViewPortOptions {
5207
+ /**
5208
+ * Die **direkten** Tags je Lauf — Kette `szenen-prompt-anzeige-bilder-tags`.
5209
+ *
5210
+ * Der Speicherhost fuehrt sie als Zustand und laesst sie auch schreiben:
5211
+ * Anders als der Ereignislog-Weg braucht er dafuer keine Vokabel-Tabelle,
5212
+ * und ein Editor, der im Test nichts ablegen kann, prueft nichts.
5213
+ */
5214
+ runTags?: Record<string, readonly string[]>;
5215
+ /**
5216
+ * Bildanzahl, Vorschau und Library-Tags je Lauf.
5217
+ *
5218
+ * Vorbelegt statt aus Ereignissen gefaltet: Dieser Port haelt Laeufe als
5219
+ * Liste, nicht als Log. Die Faltung selbst prueft
5220
+ * `promptKarte.test.ts` gegen `annotateRunsFromEvents`.
5221
+ */
5222
+ runAnnotations?: Record<string, PromptRunAnnotation>;
5223
+ /** Die Vorschlagsliste des Tag-Editors. Fehlt sie, bietet der Port keine an. */
5224
+ tagVocabulary?: readonly string[];
5225
+ /**
5226
+ * Bildanzahl, Deckbild und Tags je **Element**.
5227
+ *
5228
+ * Vorbelegt wie `runAnnotations` und aus demselben Grund: Dieser Port haelt
5229
+ * keinen Laufbestand, aus dem sich die Ableitung falten liesse. Die Faltung
5230
+ * selbst prueft `promptKarte.test.ts` gegen `annotateElementsFromEvents`.
5231
+ */
5232
+ elementAnnotations?: Record<string, ElementAnnotation>;
5233
+ /**
5234
+ * Ob der Port Items anbietet. `false` bildet Flow-Pure nach: das Feld fehlt
5235
+ * dann ganz, statt eine Operation zu haben, die `unsupported` zurückgibt.
5236
+ * Der Unterschied ist der Punkt — U26 verlangt, dass die View damit ohne
5237
+ * Sondercode umgeht.
5238
+ */
5239
+ items?: boolean;
5240
+ /** Ob der Port Medien anbietet (Stufe 5 vorhanden). */
5241
+ media?: boolean;
5242
+ /**
5243
+ * Anzeigbare Vorschauen je `asset_id` (Kette `szenen-design`, P4).
5244
+ *
5245
+ * Gesetzt bietet der Medienport `loadAssetPreview()` an und beantwortet eine
5246
+ * unbekannte Kennung mit einem Fehler. Fehlt die Angabe, fehlt auch die
5247
+ * Operation — wie in einem Host, der Assets nicht aufloesen kann (R11).
5248
+ */
5249
+ assetPreviews?: Readonly<Record<string, string>>;
5250
+ /**
5251
+ * Ob der Port einen Bildbestand anbietet (D-94).
5252
+ *
5253
+ * `false` bildet einen Host ohne ihn ab: Der Bereich zeigt dann nur den
5254
+ * Upload, und ein Folgelauf ohne Bild wird mit Grund abgelehnt.
5255
+ */
5256
+ imageLibrary?: boolean;
5257
+ /**
5258
+ * Vorbelegte Bilder des Bestands — jedes für sich ein **Einbild-Werk**.
4696
5259
  *
4697
5260
  * Das ist der Normalfall eines Bestands und bleibt die knappe Schreibweise
4698
5261
  * für Tests, die die Gruppierung gar nicht brauchen. Mehrbildige Werke gehen
@@ -5264,173 +5827,6 @@ interface TargetModelChoices {
5264
5827
  */
5265
5828
  declare function selectableTargetModels(queries: VisibilityQueries, contextChain: readonly (string | null)[]): Promise<QueryResult<TargetModelChoices>>;
5266
5829
 
5267
- /**
5268
- * Der Anbieter, der in einem so entstandenen Lauf steht.
5269
- *
5270
- * `mcp_client` und nicht `openai`/`chatgpt`: Was der Server sicher weiss, ist
5271
- * dass **sein MCP-Aufrufer** formuliert hat. Welcher Anbieter dahinter steht,
5272
- * sagt ihm niemand — und ein geratener Anbietername waere im Lauf spaeter
5273
- * nicht mehr von einem belegten zu unterscheiden (D-107).
5274
- */
5275
- declare const MCP_CLIENT_PROVIDER = "mcp_client";
5276
- /**
5277
- * Die Modellkennung, wenn der Host keine belegte liefert — und das tut er nie.
5278
- *
5279
- * Bewusst ein sprechender Platzhalter statt einer Modellversion: `model_id`
5280
- * ist das Feld, an dem ein Leser ablesen soll, **womit** formuliert wurde.
5281
- * Eine dort eingetragene Selbstauskunft saehe aus wie eine belegte Kennung.
5282
- * Die Selbstauskunft steht deshalb in `execution_origin.declared_model_id` und
5283
- * traegt dort sichtbar, dass sie unbelegt ist.
5284
- */
5285
- declare const UNVERIFIED_MODEL_ID = "mcp-client-unspecified";
5286
- /**
5287
- * Die Herkunft der Ausfuehrung, so ehrlich wie sie belegbar ist.
5288
- *
5289
- * Additiv am Lauf und nicht in `model_id`/`provider` versteckt: Der
5290
- * Unterschied zwischen „das war Modell X" und „der Aufrufer sagt, es war
5291
- * Modell X" ist genau der, um den es geht.
5292
- */
5293
- interface PromptExecutionOrigin {
5294
- /** Wer den Lauf eingereicht hat — hier immer der MCP-Werkzeugweg. */
5295
- host: 'mcp';
5296
- /** Was der Aufrufer ueber sich selbst gesagt hat, unveraendert und unbelegt. */
5297
- declared_model_id?: string;
5298
- /**
5299
- * Ob die unten mitgegebene Renderer-Anweisung die tatsaechliche
5300
- * Systemnachricht des formulierenden Chats war.
5301
- *
5302
- * Sie war es nie: Der MCP reicht sie als Werkzeugergebnis heraus; was im
5303
- * Chat als Systemprompt stand, kennt der Server nicht. Das Feld steht
5304
- * trotzdem im Lauf, weil `system_prompt` sonst genau so gelesen wuerde.
5305
- */
5306
- renderer_instruction_was_system_prompt: false;
5307
- }
5308
- /** Der Antwortvertrag, den der Aufrufer erfuellen muss — maschinenlesbar. */
5309
- interface PromptResponseContract {
5310
- format: 'json';
5311
- /** Pflichtfelder der Antwort, wie `checkRunResponse()` sie prueft. */
5312
- required_fields: readonly string[];
5313
- /** Ob ein Negativ-Prompt zugesagt ist (sonst muss `negative` null bleiben). */
5314
- negative_prompt_allowed: boolean;
5315
- /** Jeder dieser Knoten muss in `visibility.nodes` erscheinen (D-21). */
5316
- node_ids: readonly string[];
5317
- /** Die Sprache, in der `positive` formuliert wird. */
5318
- prompt_language: string;
5319
- }
5320
- /** Ein vorbereiteter Promptvorgang — dauerhaft unter `operation_id`. */
5321
- interface PreparedPromptOperation {
5322
- operation_id: string;
5323
- /** Die eingefrorene Szene: genau ein Entwurfs- oder Versionsstand (D-135). */
5324
- scene: FrozenSceneState;
5325
- context_id: string | null;
5326
- /** Die Arbeitsanweisung des Nutzers, soweit eine gegeben wurde. */
5327
- user_instruction: string | null;
5328
- /** Der eingefrorene `RendererInput` — woertlich der des bestehenden Pfads. */
5329
- renderer_input: RendererInput;
5330
- /**
5331
- * Die Renderer-Anweisung (`buildSystemInstruction`).
5332
- *
5333
- * Sie ist **Material fuer den Aufrufer**, nicht sein Systemprompt. Beim
5334
- * Abschluss landet sie unveraendert in `system_prompt` des Laufs, weil das
5335
- * Feld seit Stufe 3 genau diese Anweisung fuehrt.
5336
- */
5337
- renderer_instruction: string;
5338
- /** Die Nutzernachricht: die Renderer-Eingabe als JSON (D-47). */
5339
- renderer_payload: string;
5340
- response_contract: PromptResponseContract;
5341
- prepared_by: string;
5342
- created_at: string;
5343
- }
5344
- /** Nutzlast von `promptOperationPrepared`. */
5345
- type PromptOperationPreparedPayload = PreparedPromptOperation;
5346
- /** Liest alle vorbereiteten Vorgaenge aus dem Ereignislog. */
5347
- declare function collectPromptOperations(events: readonly ElementEvent[]): readonly PreparedPromptOperation[];
5348
- /** Ein einzelner vorbereiteter Vorgang, oder `null`. */
5349
- declare function findPromptOperation(events: readonly ElementEvent[], operationId: string): PreparedPromptOperation | null;
5350
- interface PreparePromptOperationInput {
5351
- sceneElementId: string;
5352
- operationId: string;
5353
- store: ChainQueries;
5354
- resolver: ReferenceResolver;
5355
- contextChain: readonly (string | null)[];
5356
- contextId: string | null;
5357
- userInstruction?: string | null;
5358
- /**
5359
- * Das gewaehlte Zielmodell (Kette `szenen-direktlauf-target-model-policy`).
5360
- *
5361
- * Optional. Ohne Angabe bleibt der Vorgang exakt der generische von D-135;
5362
- * mit Angabe traegt der eingefrorene `RendererInput` die Modellprovenienz,
5363
- * und `completePromptOperation()` schreibt ihre `version_id` ohne Zutun in
5364
- * `target_model_version_id` des Laufs.
5365
- */
5366
- targetModelElementId?: string | null;
5367
- preparedBy: string;
5368
- now?: () => Date;
5369
- }
5370
- type PreparePromptOperationResult = {
5371
- kind: 'ok';
5372
- operation: PreparedPromptOperation;
5373
- } | FreezeFailure;
5374
- /**
5375
- * Friert den Arbeitsstand einer Szene ein und baut daraus den Vorgang.
5376
- *
5377
- * Ruft **kein** Modell — hier entstehen keine Kosten. Das Einfrieren ist
5378
- * woertlich `freezeSceneWorkingState()`, also derselbe Zwei-Durchgang-Vergleich
5379
- * mit denselben drei Ausgaengen wie im bestehenden Pfad (D-97/D-135). Ein
5380
- * Konflikt bleibt ein Konflikt, kein „nochmal versuchen".
5381
- */
5382
- declare function preparePromptOperation(input: PreparePromptOperationInput): Promise<PreparePromptOperationResult>;
5383
- /**
5384
- * Der Antwortvertrag, abgelesen an derselben Eingabe wie die Anweisung.
5385
- *
5386
- * Bewusst abgelesen und nicht danebengeschrieben: Was `checkRunResponse()
5387
- * prueft, entscheidet allein `promptRun.ts`. Ein hier gepflegter zweiter
5388
- * Katalog liefe irgendwann auseinander, und der Aufrufer bekaeme einen
5389
- * Vertrag, den die Pruefung nicht kennt.
5390
- */
5391
- declare function responseContractOf(input: RendererInput): PromptResponseContract;
5392
- interface CompletePromptOperationInput {
5393
- operation: PreparedPromptOperation;
5394
- /** Die Antwort des aufrufenden Modells, woertlich. */
5395
- response: string;
5396
- runId: string;
5397
- /** Was der Aufrufer ueber sein eigenes Modell sagt — unbelegt (D-107). */
5398
- declaredModelId?: string | null;
5399
- now?: () => Date;
5400
- }
5401
- type CompletePromptOperationResult = {
5402
- kind: 'ok';
5403
- record: PromptRunRecord;
5404
- } | {
5405
- kind: 'rejected';
5406
- message: string;
5407
- };
5408
- /**
5409
- * Macht aus der Antwort des Aufrufers einen normalen Promptlauf.
5410
- *
5411
- * **Eine ungueltige Antwort wird nicht als gescheiterter Lauf abgelegt.** Das
5412
- * ist der eine bewusste Unterschied zum Providerpfad, und er hat einen Grund:
5413
- * Dort belegt ein `failed` einen **bezahlten** Aufruf, der sich nicht
5414
- * wiederholen laesst, ohne noch einmal zu kosten (D-23 §6). Hier hat niemand
5415
- * bezahlt — der Aufrufer hat nur falsch formuliert und kann es unter derselben
5416
- * `operation_id` sofort richtig tun. Ein Fehlerlauf waere hier kein Nachweis,
5417
- * sondern Muell im autoritativen Bestand, und er wuerde die Wiederholung
5418
- * ausserdem als Konflikt blockieren.
5419
- */
5420
- declare function completePromptOperation(input: CompletePromptOperationInput): CompletePromptOperationResult;
5421
- /**
5422
- * Der Lauf, der aus diesem Vorgang schon entstanden ist — oder `null`.
5423
- *
5424
- * Grundlage der Idempotenz: Derselbe Vorgang mit derselben Antwort liefert
5425
- * denselben Lauf; eine **andere** Antwort unter derselben Kennung ist ein
5426
- * Konflikt und kein zweiter Lauf. Verglichen wird die woertliche Antwort aus
5427
- * `raw_output` — es braucht keinen Fingerabdruck neben etwas, das der Lauf
5428
- * ohnehin vollstaendig traegt.
5429
- */
5430
- declare function runOfOperation(runs: readonly PromptRunRecord[], operationId: string): PromptRunRecord | null;
5431
- /** Ob eine eingereichte Antwort woertlich die des bereits gespeicherten Laufs ist. */
5432
- declare function sameResponseAs(run: PromptRunRecord, response: string): boolean;
5433
-
5434
5830
  /** Die waehlbaren Pausen zwischen zwei Auftraegen, in Sekunden (§4). */
5435
5831
  declare const PAUSE_SEKUNDEN_OPTIONEN: readonly number[];
5436
5832
  /** Die Vorgabe, wenn der Nutzer nichts waehlt (§4). */
@@ -5798,69 +6194,4 @@ type SzenenFokus = {
5798
6194
  declare function areaForFokus(fokus: SzenenFokus): SzenenAreaId;
5799
6195
  declare const SzenenView: React__default.FC<SzenenViewProps>;
5800
6196
 
5801
- type StagePlane = 'top' | 'side' | 'camera';
5802
- type Vec3 = [number, number, number];
5803
- declare const STAGE_CATALOGUE: readonly [{
5804
- readonly label: "Mensch";
5805
- readonly type: "subject";
5806
- readonly dimensions: readonly [0.55, 0.35, 1.75];
5807
- }, {
5808
- readonly label: "Stuhl";
5809
- readonly type: "object";
5810
- readonly dimensions: readonly [0.5, 0.5, 0.9];
5811
- }, {
5812
- readonly label: "Tisch";
5813
- readonly type: "surface";
5814
- readonly dimensions: readonly [1.2, 0.7, 0.75];
5815
- }, {
5816
- readonly label: "Lampe";
5817
- readonly type: "light";
5818
- readonly dimensions: readonly [0.35, 0.35, 1.5];
5819
- }];
5820
- /** Nur die zwei sichtbaren Achsen ändern; die verborgene Tiefe bleibt erhalten. */
5821
- declare function dragPosition(position: readonly number[], point: readonly number[], plane: StagePlane): Vec3;
5822
- declare function stageNode(node: ResolvedNode): {
5823
- node_id: string;
5824
- type: string;
5825
- primitive: string;
5826
- dimensions: Vec3;
5827
- position: Vec3;
5828
- rotation: Vec3;
5829
- scale: Vec3;
5830
- anchors: Readonly<Record<string, readonly number[]>> | undefined;
5831
- };
5832
- /** Rendern ist nur bei vollständigen Daten zulässig, niemals mit geratenen Positionen. */
5833
- declare function stageFrame(input: RendererInput): {
5834
- nodes: {
5835
- preview_color: {
5836
- hex: string;
5837
- name: string;
5838
- };
5839
- node_id: string;
5840
- type: string;
5841
- primitive: string;
5842
- dimensions: Vec3;
5843
- position: Vec3;
5844
- rotation: Vec3;
5845
- scale: Vec3;
5846
- anchors: Readonly<Record<string, readonly number[]>> | undefined;
5847
- }[];
5848
- camera: {
5849
- position: Vec3;
5850
- orientation: Record<string, unknown>;
5851
- aspect_ratio: string;
5852
- aspect: number;
5853
- focal_length_mm: number;
5854
- sensor_width_mm: number;
5855
- vertical_fov_deg: number;
5856
- camera_id: string;
5857
- name: string | null;
5858
- preset: unknown;
5859
- placement: unknown;
5860
- framing: unknown;
5861
- focus: unknown;
5862
- pattern: unknown | null;
5863
- };
5864
- };
5865
-
5866
- export { type AddManualSceneRunInput, type AttachLibraryItemInput, type AttachLibraryItemResult, type AuftragAktion, type AuftragZustand, AuthoritativeSzenenStore, type BestandsGalerieEintrag, type BestandsItem, type BuildManualPromptRunInput, CAMERA_ASPECT_RATIOS, CATALOGUE_TYPES, type CameraPreview, type CameraPreviewContext, type CameraPreviewDescriptor, type CameraPreviewRenderer, CapabilityAnchorError, type CapabilityFlag, type CapabilityFlagName, type CapabilityReason, type CapabilityReport, type CapabilityReportInput, type CapabilityScope, type CapabilityState, type ChainQueries, type ClaimAndRunResult, type ClientDerivationChannel, type ClientDerivationStore, type CompletePromptOperationInput, type CompletePromptOperationResult, ContextChainPort, type CreateBrowserTextGenerationPortOptions, type CreateClientDerivationPortOptions, type CreateClientRunPortOptions, type CreateFlowSzenenViewPortOptions, type CreateHfElementStoreOptions, type CreateHfEventChannelOptions, type CreateHfImageBatchHistoryOptions, type CreateHfImageBatchPersistenceOptions, type CreateImageGenerationPortOptions, type CreateImageJobPortOptions, type CreateMemoryViewPortOptions, DEFAULT_SEED_VORLAGE, 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, ElementAnnotation, ElementEvent, type ElementEventChannel, ElementStoreState, type ExecutableImageModel, type ExecutionTargetModel, type ExistingSzenenItem, FLOW_EXECUTION_PATH, type FlowGenerateImage, type FlowGenerateImageParams, FlowGenerateText, type FreezeDraftChainInput, type FreezeFailure, type FreezeResult, type FreezeSceneResult, type FreezeSceneSuccess, type FreezeSceneWorkingStateInput, type FreezeSuccess, type FrozenChainNode, type FrozenReferenceSentence, type FrozenSceneState, GENERAL_POLICY_SUBTYPE, type GeneratedImage, type GruppierbaresBild, type HfImageStore, type HfImageStoreOptions, type IdFactory, type ImageExecutionProfile, type ImageExecutionRoute, type ImageExecutionTargetModelReader, type ImageGenerationBatchPersistence, type ImageGenerationEventChannel, type ImageGenerationFinishedPayload, type ImageGenerationOrder, type ImageGenerationProviderPort, type ImageGenerationResult, type ImageGenerationRunReader, type ImageGenerationStartedPayload, type ImageHostCapability, type ImageJob, type ImageJobChannel, type ImageJobClaimedPayload, type ImageJobEintrag, type ImageJobHerkunft, type ImageJobQuery, type ImageJobRequestedPayload, type ImageJobSeite, type ImageJobSettledPayload, type ImageJobStatusFilter, 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 LetztesErzeugtesBild, type LibraryImage, type LibraryImageItem, LibraryTagRef, MANUAL_MODEL_ID, MANUAL_NODE_STATE, MANUAL_PROVIDER, MANUAL_VISIBILITY_BASIS, MCP_CLIENT_PROVIDER, type ManualPromptEntry, type ManualPromptRunRecord, type NodeContribution, NotDerivable, type Notice, type NoticeTone, PAUSE_SEKUNDEN_OPTIONEN, PAUSE_SEKUNDEN_VORGABE, PROMPT_AUSZUG_ZEICHEN, PROMPT_RULE_EFFECT, PROMPT_RUN_DETAIL_FIELDS, Page, PageRequest, type PolicySnapshot, PreferredHeadResolution, type PreparePromptOperationInput, type PreparePromptOperationResult, type PreparedPromptOperation, type PromptBatchImageRef, type PromptBatchOrigin, PromptConstructionTag, type PromptDiagnostic, type PromptEffect, type PromptExecutionOrigin, type PromptImageBatch, type PromptOperationPreparedPayload, type PromptResponseContract, PromptRunAnnotation, type PromptRunFilter, type PromptRunGroup, type PromptRunListRecord, type PromptRunListing, type PromptRunOriginFilter, type PromptRunOutcome, type PromptRunOutput, type PromptRunPage, type PromptRunPageFilter, type PromptRunPageInput, type PromptRunPageRecord, type PromptRunPageSource, type PromptRunPersistencePort, type PromptRunRecord, type PromptRunRecordedPayload, type PromptRunSource, type PromptRunStatusFilter, type ProviderCheckRecord, type ProviderCheckRecordedPayload, type ProviderCheckResult, PublishCheckResult, PublishFinding, type QueueAusgang, type QueueFortschritt, type QueueLaufOptionen, type QueueZustand, RULES_WITHOUT_CAPABILITY_EFFECT, RULE_SCOPES, type RawSchema, type RecordedDerivationInput, type RecordedProposal, type RecoveryStatus, ReferenceResolver, type ReferenceSentenceTag, type RendererInput, type RequestMoreImagesInput, type RequestMoreImagesResult, type ResolveFailure, type ResolveResult, type ResolveScenePayloadInput, type ResolveShotInput, type ResolveShotPayloadInput, ResolveTechnicalError, type ResolvedCamera, type ResolvedNode, type ResolvedPlacement, type ResolvedScenePolicy, type RunBild, type RunEventChannel, type RunFailure, type RunFailureClass, type RunItemReference, STAGE_CATALOGUE, SZENEN_ITEM_PREFIX, SZENEN_SCHEMAS, SZENEN_SNAPSHOT_FILE, SZENEN_SNAPSHOT_PREFIX, SZENEN_SNAPSHOT_SCHEMA_VERSION, type SaveRunAsItemInput, type SceneDerivationPersistencePort, type SceneDerivationRecord, type SceneDerivationRecordedPayload, type SceneDerivationRecoveryRecord, type SceneDerivationRecoveryRecordedPayload, type ScenePolicyResult, SchemaError, type SeedVorlage, type SeedZuordnung, type SeedZuordnungEintrag, type SelectableTargetModel, type ServerAuftragZeile, type StartImageGenerationInput, type StartRunFromSceneInput, type StartRunInput, type StepState, type SzenenArea, type SzenenAreaId, type SzenenBatchOrigin, type SzenenBatchOriginFailure, type SzenenBatchOriginVerdict, type SzenenBatchSourceKind, SzenenCommands, SzenenElementStore, SzenenElementType, type SzenenFokus, type SzenenImageBatchHistoryPort, type SzenenImageBatchWritePort, type SzenenImageGenerationPort as SzenenImageGenerationPortContract, type SzenenImageJobPort, type SzenenImageLibraryPort, type SzenenItemPort, type SzenenLeseErgebnis, type SzenenMediaPort, SzenenQueries, type SzenenRunPort, type SzenenSeedTemplatePort, type SzenenServerJobKontext, type SzenenServerJobSlot, type SzenenSnapshot, SzenenView, type SzenenViewCapabilities, type SzenenViewPort, type SzenenViewProps, TargetModelResolution, TextGenerationPort, UNCHECKED_PUBLISH_RULES, UNVERIFIED_MODEL_ID, UPLOAD_MAX_BYTES, type UnselectableTargetModel, UnusableProposal, type VersionMedium, type VisibilityNode, type ZipBild, areaForFokus, areasFor, batchesForPromptRun, bildPfad, bilderDesLaufs, buildCameraPreviewContext, buildManualPromptRunRecord, buildSystemInstruction, buildSzenenSnapshot, buildUserPrompt, callOptional, cameraAspectRatioValue, cameraPerspective, capabilitiesOf, capabilityGate, capabilityReport, catalogueFor, checkCameraAspectRatioChanges, checkCreateElementInput, checkElementType, checkImageExecutionProfile, checkImageExecutionProfiles, checkImageModelParameters, checkOptionalId, checkParents, checkPayloadPresent, checkPromptRunRecord, checkPublishVersionInput, checkRequiredId, checkReviseMetadataInput, checkRevision, checkRunResponse, checkSceneDerivationRecord, checkSceneDerivationRecoveryRecord, checkSetPreferredHeadInput, checkSzenenBatchOrigin, checkTitle, checkWriteDraftInput, claimWon, collectImageBatches, collectImageGenerationOrders, collectImageJobs, collectPromptOperations, collectPromptRuns, collectProviderChecks, collectSceneDerivationRecoveries, collectSceneDerivations, completePromptOperation, contextOfRun, createBrowserTextGenerationPort, createClientDerivationPort, createClientRunPort, createEventLogDerivationPersistence, createEventLogRunPersistence, createFlowImageProvider, createFlowSzenenViewPort, createHfElementStore, createHfEventChannel, createHfImageBatchHistory, createHfImageBatchWrite, createHfImageGenerationBatchPersistence, createHfImageLibrary, createHfImageStore, createImageGenerationPort, createImageJobPort, createInMemoryEventChannel, createMemoryViewPort, derivationPoliciesOf, deriveItemFromRun, deriveLineage, describableContent, detailFehlt, diagnosticOfFinding, diagnosticOfSchemaError, differentialSteps, dragPosition, executableImageModels, findExecutableImageModel, findImageBatch, findImageGenerationOrder, findImageJob, findPromptOperation, findPromptRun, findProviderCheck, findSceneDerivation, findSceneDerivationRecovery, firstError, formatSeedListe, freezeDraftChain, freezeSceneWorkingState, frozenCameraAspectRatio, fuehreQueueAus, generationBatchIdOf, gesamtHerkunft, groupKeyOf, groupOf, gruppiereZuItems, hasPlacementCapability, isKnownElementType, isSzenenItemId, istGueltigePause, istOffen, istSzenenSnapshotDatei, istZipDatei, itemIdForRun, itemsAusBestand, jobsForPromptRun, ladeVorschauen, leseBilderAusZip, letztesErzeugtesBild, locatorAus, locatorTeile, manualEntryOf, mergeSnapshotAndPending, mergeSzenenBatchOrigin, mimeTypAus, mitDefaultVorlage, namingElementOf, noticeFor, ordersForPromptRun, ordneSeedsZu, pagePromptRuns, parseRunResponse, parseSeedListe, parseSzenenSnapshot, preparePromptDerivation, preparePromptOperation, promptDiagnosticsOf, promptRunPageForTransport, promptRunPageFromTransport, publishedHeadsOf, recoveriesForRun, recoveryStatusOf, resolveArea, resolveGeneralScenePolicies, resolveScenePayload, resolveShot, resolveShotPayload, responseContractOf, roundOfRun, roundsOf, rulesWithoutPromptEffect, runOfOperation, runPromptDerivation, runStoreDifferential, sameResponseAs, sceneOnlyCapabilities, scenePolicyFingerprint, sceneVersionElementsOf, scopeOfPath, seedFehlerText, selectImageJobs, selectPromptRuns, selectableTargetModels, siblingsOf, sortScenePolicies, sourceOf, stageFrame, stageNode, supportsCompositionReference, szenenSnapshotFilename, totalModelCalls, typAusBytes, unclassifiedPublishRules, unsupportedReason };
6197
+ export { type AddManualSceneRunInput, type AttachLibraryItemInput, type AttachLibraryItemResult, type AuftragAktion, type AuftragZustand, AuthoritativeSzenenStore, type BestandsGalerieEintrag, type BestandsItem, type BuildManualPromptRunInput, type BuildPromptRunVariantInput, type BuildPromptRunVariantResult, CAMERA_ASPECT_RATIOS, CAMERA_PREVIEW_ASSET_ROLE, CATALOGUE_TYPES, type CameraPreview, type CameraPreviewContext, type CameraPreviewDescriptor, type CameraPreviewRenderer, CapabilityAnchorError, type CapabilityFlag, type CapabilityFlagName, type CapabilityReason, type CapabilityReport, type CapabilityReportInput, type CapabilityScope, type CapabilityState, type ChainQueries, type ClaimAndRunResult, type ClientDerivationChannel, type ClientDerivationStore, type CompletePromptOperationInput, type CompletePromptOperationResult, ContextChainPort, type CreateBrowserTextGenerationPortOptions, type CreateClientDerivationPortOptions, type CreateClientRunPortOptions, type CreateFlowSzenenViewPortOptions, type CreateHfElementStoreOptions, type CreateHfEventChannelOptions, type CreateHfImageBatchHistoryOptions, type CreateHfImageBatchPersistenceOptions, type CreateImageGenerationPortOptions, type CreateImageJobPortOptions, type CreateMemoryViewPortOptions, DEFAULT_SEED_VORLAGE, 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, ElementAnnotation, ElementEvent, type ElementEventChannel, ElementSnapshot, ElementStoreState, type ExecutableImageModel, type ExecutionTargetModel, type ExistingSzenenItem, FLOW_EXECUTION_PATH, type FlowGenerateImage, type FlowGenerateImageParams, FlowGenerateText, type FreezeDraftChainInput, type FreezeFailure, type FreezeResult, type FreezeSceneResult, type FreezeSceneSuccess, type FreezeSceneWorkingStateInput, type FreezeSuccess, type FrozenChainNode, type FrozenReferenceSentence, type FrozenSceneState, GENERAL_POLICY_SUBTYPE, type GeneratedImage, type GruppierbaresBild, type HfImageStore, type HfImageStoreOptions, type IdFactory, type ImageExecutionProfile, type ImageExecutionRoute, type ImageExecutionTargetModelReader, type ImageGenerationBatchPersistence, type ImageGenerationEventChannel, type ImageGenerationFinishedPayload, type ImageGenerationOrder, type ImageGenerationProviderPort, type ImageGenerationResult, type ImageGenerationRunReader, type ImageGenerationStartedPayload, type ImageHostCapability, type ImageJob, type ImageJobChannel, type ImageJobClaimedPayload, type ImageJobEintrag, type ImageJobHerkunft, type ImageJobQuery, type ImageJobRequestedPayload, type ImageJobSeite, type ImageJobSettledPayload, type ImageJobStatusFilter, 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 LetztesErzeugtesBild, type LibraryImage, type LibraryImageItem, LibraryTagRef, MANUAL_MODEL_ID, MANUAL_NODE_STATE, MANUAL_PROVIDER, MANUAL_VISIBILITY_BASIS, MCP_CLIENT_PROVIDER, type ManualPromptEntry, type ManualPromptRunRecord, NODE_TYPES, type NodeContribution, NotDerivable, type Notice, type NoticeTone, type OpenStageDraftChainInput, PAUSE_SEKUNDEN_OPTIONEN, PAUSE_SEKUNDEN_VORGABE, PREVIEW_COLOR_MIN_DISTANCE, PROMPT_AUSZUG_ZEICHEN, PROMPT_RULE_EFFECT, PROMPT_RUN_DETAIL_FIELDS, PROXY_PRIMITIVES, Page, PageRequest, type PolicySnapshot, PreferredHeadResolution, type PreparePromptOperationInput, type PreparePromptOperationResult, type PreparedPromptOperation, type PromptBatchImageRef, type PromptBatchOrigin, PromptConstructionTag, type PromptDiagnostic, type PromptEffect, type PromptExecutionOrigin, type PromptImageBatch, type PromptOperationPreparedPayload, type PromptResponseContract, PromptRunAnnotation, type PromptRunFilter, type PromptRunGroup, type PromptRunInputAsset, type PromptRunListRecord, type PromptRunListing, type PromptRunOriginFilter, type PromptRunOutcome, type PromptRunOutput, type PromptRunPage, type PromptRunPageFilter, type PromptRunPageInput, type PromptRunPageRecord, type PromptRunPageSource, type PromptRunPersistencePort, type PromptRunRecord, type PromptRunRecordedPayload, type PromptRunSource, type PromptRunStatusFilter, type PromptRunVariantOf, type PromptRunVariantRecord, type ProviderCheckRecord, type ProviderCheckRecordedPayload, type ProviderCheckResult, PublishCheckResult, PublishFinding, type QueueAusgang, type QueueFortschritt, type QueueLaufOptionen, type QueueZustand, RULES_WITHOUT_CAPABILITY_EFFECT, RULE_SCOPES, type RawSchema, type RecordedDerivationInput, type RecordedProposal, type RecoveryStatus, ReferenceResolver, type ReferenceSentenceTag, type RendererInput, type RequestMoreImagesInput, type RequestMoreImagesResult, type ResolveFailure, type ResolveResult, type ResolveScenePayloadInput, type ResolveShotInput, type ResolveShotPayloadInput, ResolveTechnicalError, type ResolvedCamera, type ResolvedNode, type ResolvedPlacement, type ResolvedScenePolicy, type RunBild, type RunEventChannel, type RunFailure, type RunFailureClass, type RunItemReference, STAGE_CATALOGUE, STAGE_MIGRATION_EVENT, STAGE_MIGRATION_ID, SZENEN_ITEM_PREFIX, SZENEN_SCHEMAS, SZENEN_SNAPSHOT_FILE, SZENEN_SNAPSHOT_PREFIX, SZENEN_SNAPSHOT_SCHEMA_VERSION, type SaveRunAsItemInput, type SceneDerivationPersistencePort, type SceneDerivationRecord, type SceneDerivationRecordedPayload, type SceneDerivationRecoveryRecord, type SceneDerivationRecoveryRecordedPayload, type ScenePolicyResult, SchemaError, type SeedVorlage, type SeedZuordnung, type SeedZuordnungEintrag, type SelectableTargetModel, type ServerAuftragZeile, type StageChainState, type StageOperation, type StageOperationsResult, type StagePayloads, type StartImageGenerationInput, type StartRunFromSceneInput, type StartRunInput, type StepState, type SzenenArea, type SzenenAreaId, type SzenenBatchOrigin, type SzenenBatchOriginFailure, type SzenenBatchOriginVerdict, type SzenenBatchSourceKind, SzenenCommands, SzenenElementStore, SzenenElementType, type SzenenFokus, type SzenenImageBatchHistoryPort, type SzenenImageBatchWritePort, type SzenenImageGenerationPort as SzenenImageGenerationPortContract, type SzenenImageJobPort, type SzenenImageLibraryPort, type SzenenItemPort, type SzenenLeseErgebnis, type SzenenMediaPort, SzenenQueries, type SzenenRunPort, type SzenenSeedTemplatePort, type SzenenServerJobKontext, type SzenenServerJobSlot, type SzenenSnapshot, SzenenView, type SzenenViewCapabilities, type SzenenViewPort, type SzenenViewProps, TargetModelResolution, TextGenerationPort, UNCHECKED_PUBLISH_RULES, UNVERIFIED_MODEL_ID, UPLOAD_MAX_BYTES, type UnselectableTargetModel, UnusableProposal, type VersionMedium, type VisibilityNode, type ZipBild, applyStageOperations, areaForFokus, areasFor, batchesForPromptRun, bildPfad, bilderDesLaufs, buildCameraPreviewContext, buildManualPromptRunRecord, buildPromptRunVariantRecord, buildSystemInstruction, buildSzenenSnapshot, buildUserPrompt, callOptional, cameraAspectRatioValue, cameraPerspective, capabilitiesOf, capabilityGate, capabilityReport, catalogueFor, checkCameraAspectRatioChanges, checkCreateElementInput, checkElementType, checkImageExecutionProfile, checkImageExecutionProfiles, checkImageModelParameters, checkOptionalId, checkParents, checkPayloadPresent, checkPromptRunRecord, checkPublishVersionInput, checkRequiredId, checkReviseMetadataInput, checkRevision, checkRunResponse, checkSceneDerivationRecord, checkSceneDerivationRecoveryRecord, checkSetPreferredHeadInput, checkSzenenBatchOrigin, checkTitle, checkVariantBlock, checkVariantInputAssets, checkWriteDraftInput, claimWon, collectImageBatches, collectImageGenerationOrders, collectImageJobs, collectPromptOperations, collectPromptRuns, collectProviderChecks, collectSceneDerivationRecoveries, collectSceneDerivations, completePromptOperation, contextOfRun, createBrowserTextGenerationPort, createClientDerivationPort, createClientRunPort, createEventLogDerivationPersistence, createEventLogRunPersistence, createFlowImageProvider, createFlowSzenenViewPort, createHfElementStore, createHfEventChannel, createHfImageBatchHistory, createHfImageBatchWrite, createHfImageGenerationBatchPersistence, createHfImageLibrary, createHfImageStore, createImageGenerationPort, createImageJobPort, createInMemoryEventChannel, createMemoryViewPort, derivationPoliciesOf, deriveItemFromRun, deriveLineage, describableContent, detailFehlt, diagnosticOfFinding, diagnosticOfSchemaError, differentialSteps, dragPosition, executableImageModels, findExecutableImageModel, findImageBatch, findImageGenerationOrder, findImageJob, findPromptOperation, findPromptRun, findProviderCheck, findSceneDerivation, findSceneDerivationRecovery, findStageDraftChain, firstError, formatSeedListe, freezeDraftChain, freezeSceneWorkingState, frozenCameraAspectRatio, fuehreQueueAus, generationBatchIdOf, gesamtHerkunft, groupKeyOf, groupOf, gruppiereZuItems, hasPlacementCapability, isKnownElementType, isSzenenItemId, istGueltigePause, istOffen, istSzenenSnapshotDatei, istZipDatei, itemIdForRun, itemsAusBestand, jobsForPromptRun, ladeVorschauen, leseBilderAusZip, letztesErzeugtesBild, locatorAus, locatorTeile, manualEntryOf, mergeSnapshotAndPending, mergeSzenenBatchOrigin, mimeTypAus, mitDefaultVorlage, namingElementOf, normalizePreviewColor, noticeFor, openStageDraftChain, ordersForPromptRun, ordneSeedsZu, pagePromptRuns, parseRunResponse, parseSeedListe, parseSzenenSnapshot, pinPreviewColors, preparePromptDerivation, preparePromptOperation, prepareStageMigration, previewColorConflicts, previewColorDistance, previewColorLegibility, previewColorNodes, promptDiagnosticsOf, promptRunPageForTransport, promptRunPageFromTransport, publishedHeadsOf, recoveriesForRun, recoveryStatusOf, resolveArea, resolveGeneralScenePolicies, resolveScenePayload, resolveShot, resolveShotPayload, responseContractOf, roundOfRun, roundsOf, rulesWithoutPromptEffect, runOfOperation, runPromptDerivation, runStoreDifferential, sameResponseAs, sameVariantRequest, sceneOnlyCapabilities, scenePolicyFingerprint, sceneVersionElementsOf, scopeOfPath, seedFehlerText, selectImageJobs, selectPromptRuns, selectableTargetModels, siblingsOf, sortScenePolicies, sourceOf, stageColors, stageFrame, stageNode, supportsCompositionReference, szenenSnapshotFilename, totalModelCalls, typAusBytes, unclassifiedPublishRules, unsupportedReason, variantOf };