@rslsp1/fa-app-tools 9.1.0 → 9.4.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/{chunk-33L6XAHI.mjs → chunk-KF5ZVSKJ.mjs} +9026 -6778
- package/dist/index.d.mts +73 -2
- package/dist/index.d.ts +73 -2
- package/dist/index.js +6414 -4143
- package/dist/index.mjs +137 -5
- package/dist/{storeContract-5vApx6VA.d.mts → storeContract-CJi0fpCA.d.mts} +543 -7
- package/dist/{storeContract-DNggXiZl.d.ts → storeContract-gc2dxews.d.ts} +543 -7
- package/dist/szenen-contract.d.mts +1 -1
- package/dist/szenen-contract.d.ts +1 -1
- package/dist/szenen.d.mts +571 -274
- package/dist/szenen.d.ts +571 -274
- package/dist/szenen.js +4029 -1691
- package/dist/szenen.mjs +120 -3
- package/package.json +3 -2
package/dist/szenen.d.mts
CHANGED
|
@@ -1,276 +1,11 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export { A as ALL_PUBLISH_RULES, C as CHAIN_EDGES,
|
|
1
|
+
import { J as ElementEvent, ad as PublishFinding, av as SchemaError, ac as PublishCheckResult, aC as SzenenElementType, aj as ReferenceResolver, aJ as TargetModelResolution, a3 as PreferredHeadResolution, a0 as PageRequest, X as LibraryTagRef, a8 as PromptRunAnnotation, $ as Page, y as DerivationInputMode, U as ImageProvenance, u as DerivationFailure, p as DerivableType, Y as NotDerivable, r as DerivationConflict, w as DerivationFollowUp, F as DraftChainMeta, s as DerivationDiagnostic, q as DerivationAssessment, j as ContextChainPort, c as AuthoritativeSzenenStore, aB as SzenenElementStore, x as DerivationImage, aE as SzenenQueries, aA as SzenenCommands, aL as UnusableProposal, I as ElementAnnotation } from './storeContract-CJi0fpCA.mjs';
|
|
2
|
+
export { A as ALL_PUBLISH_RULES, a as AngezeigterTag, b as AnnotateRunsOptions, C as CHAIN_EDGES, d as CHAIN_LINK_FIELDS, e as CatalogueEntry, f as ChainLinkField, g as ChainTarget, h as ChainVerdict, i as CompiledSchemas, k as ContractCheck, l as ContractCheckResult, m as ContractRunResult, n as ContractViolation, o as CreateElementInput, D as DERIVABLE_TYPES, t as DerivationEnvelope, v as DerivationFailureClass, z as DerivationPolicyPayload, B as DerivationProposal, E as DraftChainLink, G as DraftFork, H as DraftRecord, K as ElementListFilter, L as ElementMetadata, M as ElementRecord, N as ElementSnapshot, O as ElementStoreContractHarness, P as ElementStoreState, Q as ElementVersionValidation, R as FindingSeverity, S as ImageBatchPersistedImage, T as ImageBatchPersistedPayload, V as KEINE_BILDER, W as LOAD_MORE_PAGE_SIZE, Z as OptionalCommand, _ as PROBE_VERSION_ID, a1 as ParentRelation, a2 as PreferredHeadOutcome, a4 as PreferredHeadSelection, a5 as PreferredHeadSource, a6 as ProjectionState, a7 as ProjectionStatus, a9 as PromptRunPreviewImage, aa as PromptRunTagsSetPayload, ab as PublishCheckInput, ae as PublishRejected, af as PublishVersionInput, ag as PublishedVersion, ah as REFERENCE_FIELD, ai as ReducerFinding, ak as ResolvePreferredHeadOptions, al as ResolvedVersion, am as ReviseMetadataInput, an as STYLE_PAYLOAD, ao as STYLE_PAYLOAD_V2, ap as SZENEN_ELEMENT_TYPES, aq as SZENEN_EVENT_PREFIX, ar as SZENEN_EVENT_TYPES, as as SceneDerivationInput, at as SceneDerivationOutcome, au as SceneDerivationOutput, aw as SchemaValidationResult, ax as SetPreferredHeadInput, ay as StoreAuthority, az as SzenenCommandResult, aD as SzenenProjection, aF as TagHerkunft, aG as TargetModelCandidate, aH as TargetModelQueries, aI as TargetModelQuery, aK as UnsupportedSchemaError, aM as VersionDag, aN as VersionDagError, aO as VersionNode, aP as VersionParentLink, aQ as WriteConflict, aR as WriteDraftInput, aS as annotateElementsFromEvents, aT as annotateRunsFromEvents, aU as assessDerivationResponse, aV as buildDerivationSystemInstruction, aW as buildDerivationUserPrompt, aX as buildVersionDag, aY as checkChainTargets, aZ as checkDerivationResponse, a_ as checkDraftChainMeta, a$ as collectPromptRunTags, b0 as collectVersionRefs, b1 as compileSchemas, b2 as createSimulationSceneDerivationPort, b3 as describeTargetModelFailure, b4 as draftRevisionOf, b5 as elementStoreContractChecks, b6 as formatSchemaErrors, b7 as getSzenenSchemas, b8 as isOk, b9 as isProjectionCurrent, ba as labelsOf, bb as linkFor, bc as listElementsPageOver, bd as logRevisionOf, be as mergeRunTags, bf as pageOf, bg as pageRequestFrom, bh as parseDerivationResponse, bi as preferredHeadRevisionOf, bj as preferredVersionId, bk as promptRunTagsOf, bl as reduceElementEvents, bm as resolvePreferredHead, bn as resolveTargetModelOver, bo as resolverFromQueries, bp as runElementStoreContract, bq as runPublishChecks, br as runSceneDerivation, bs as showChain, bt as tagRefsAus, bu as validateAgainst, bv as validateDerivationInput, bw as validateElementVersion, bx as validatePayload, by as withReference } from './storeContract-CJi0fpCA.mjs';
|
|
3
3
|
import { T as TextGenerationPort, Q as QueryResult, C as CommandResult } from './contracts-DdYOMBl9.mjs';
|
|
4
4
|
export { S as SIMULATION_PROVIDER, c as TextGenerationRequest, d as TextGenerationResult, g as createFakeTextGenerationPort, h as createSimulationTextGenerationPort, s as simulatedAnswerFor } from './contracts-DdYOMBl9.mjs';
|
|
5
5
|
import { g as HFStateSnapshot, F as FlowGenerateText } from './hfEventTypes-BUztJySs.mjs';
|
|
6
6
|
export { C as CreateFlowTextGenerationPortOptions, r as createFlowTextGenerationPort } from './hfEventTypes-BUztJySs.mjs';
|
|
7
7
|
import React__default from 'react';
|
|
8
8
|
|
|
9
|
-
/** Präfix aller Events dieser Domain im gemeinsamen HF-Event-Kanal. */
|
|
10
|
-
declare const SZENEN_EVENT_PREFIX = "szenen.";
|
|
11
|
-
declare const SZENEN_EVENT_TYPES: {
|
|
12
|
-
readonly elementCreated: "szenen.element_created";
|
|
13
|
-
readonly elementRetired: "szenen.element_retired";
|
|
14
|
-
readonly metadataRevised: "szenen.element_metadata_revised";
|
|
15
|
-
readonly draftWritten: "szenen.element_draft_written";
|
|
16
|
-
readonly versionPublished: "szenen.element_version_published";
|
|
17
|
-
readonly preferredHeadSelected: "szenen.element_preferred_head_selected";
|
|
18
|
-
/**
|
|
19
|
-
* Ein Prompt-Ableitungslauf — Stufe 3, S6 (E-3b).
|
|
20
|
-
*
|
|
21
|
-
* Ein Lauf ist **kein Element**: keine Version, kein DAG, nicht
|
|
22
|
-
* referenzierbar. Er liegt trotzdem im selben autoritativen Log, weil er
|
|
23
|
-
* append-only und unveränderlich ist — genau die Form, die ein Ereignislog
|
|
24
|
-
* nativ trägt — und weil MySQL sonst zu einem zweiten fachlichen Speicher
|
|
25
|
-
* würde, den D-62 abgeschafft hat.
|
|
26
|
-
*
|
|
27
|
-
* Der Elementreducer ignoriert diesen Typ (`default:`-Zweig); die Läufe
|
|
28
|
-
* werden mit `collectPromptRuns` gelesen.
|
|
29
|
-
*/
|
|
30
|
-
readonly promptRunRecorded: "szenen.prompt_run_recorded";
|
|
31
|
-
/**
|
|
32
|
-
* Ein Szenen-Rekonstruktionslauf — Stufe 6.5 (D-71).
|
|
33
|
-
*
|
|
34
|
-
* Derselbe Bauplan und dieselbe Begründung wie beim Prompt-Lauf: append-only,
|
|
35
|
-
* unveränderlich, **kein Element** — keine Version, kein DAG, nicht
|
|
36
|
-
* referenzierbar. Er liegt im autoritativen Log, weil er genau die Form hat,
|
|
37
|
-
* die ein Ereignislog nativ trägt.
|
|
38
|
-
*
|
|
39
|
-
* Bewusst ein zweiter Lauftyp und **kein** gemeinsamer: Ein Prompt-Lauf geht
|
|
40
|
-
* von einer veröffentlichten Shot-Version aus, ein Rekonstruktionslauf von
|
|
41
|
-
* einer Referenz, die noch zu gar keinem Element gehört. Sie in einen Typ zu
|
|
42
|
-
* zwingen hieße, beiden ihre Herkunftsfelder zu nehmen.
|
|
43
|
-
*
|
|
44
|
-
* Der Elementreducer ignoriert auch diesen Typ (`default:`-Zweig).
|
|
45
|
-
*/
|
|
46
|
-
readonly sceneDerivationRecorded: "szenen.scene_derivation_recorded";
|
|
47
|
-
/**
|
|
48
|
-
* Ein ausdrücklich ausgelöster Lauf gegen den **echten** Provider.
|
|
49
|
-
*
|
|
50
|
-
* Er kostet Geld und wird deshalb nie beiläufig gefahren. Das Ereignis hält
|
|
51
|
-
* fest, was tatsächlich bezahlt wurde: wie viele Modellaufrufe, mit welchem
|
|
52
|
-
* Ausgang, in welcher Umgebung und von wem ausgelöst.
|
|
53
|
-
*
|
|
54
|
-
* Es ersetzt **nicht** die einzelnen Läufe — die werden regulär als
|
|
55
|
-
* `prompt_run_recorded` bzw. `scene_derivation_recorded` protokolliert. Es
|
|
56
|
-
* ist die Klammer darüber und der Grund, warum jemand später nachlesen kann,
|
|
57
|
-
* ob der Durchstich stattgefunden hat, ohne ihn erneut zu bezahlen.
|
|
58
|
-
*/
|
|
59
|
-
readonly providerCheckRecorded: "szenen.provider_check_recorded";
|
|
60
|
-
/**
|
|
61
|
-
* Eine geprüfte Arbeitsfassung eines fehlgeschlagenen Rekonstruktionslaufs —
|
|
62
|
-
* Stufe 6.6 (D-99).
|
|
63
|
-
*
|
|
64
|
-
* Sie ist **kein Lauf**: kein Provideraufruf, keine Kosten, kein Zielmodell.
|
|
65
|
-
* Sie ist die lokal geprüfte Korrektur eines bereits bezahlten Ergebnisses
|
|
66
|
-
* und zeigt über `run_id` auf ihren Ursprung. Der `raw_output` jenes Laufs
|
|
67
|
-
* bleibt unangetastet — deshalb ein eigenes Ereignis statt einer Änderung am
|
|
68
|
-
* bestehenden, das es ohnehin nicht geben dürfte (D-71).
|
|
69
|
-
*
|
|
70
|
-
* Mehrere Rettungen zum selben Lauf sind zulässig und erwartet: Jede
|
|
71
|
-
* Korrekturrunde ist nachvollziehbare Arbeit, kein Update der vorigen.
|
|
72
|
-
*
|
|
73
|
-
* Der Elementreducer ignoriert auch diesen Typ (`default:`-Zweig).
|
|
74
|
-
*/
|
|
75
|
-
readonly sceneDerivationRecoveryRecorded: "szenen.scene_derivation_recovery_recorded";
|
|
76
|
-
/**
|
|
77
|
-
* Ein bezahlter Bildgenerierungsauftrag beginnt — Stufe 6.7 (D-119).
|
|
78
|
-
*
|
|
79
|
-
* Append-only wie jedes andere Ereignis dieser Domain, geschrieben **vor**
|
|
80
|
-
* dem Provideraufruf. Es traegt **keine Bilddaten** — nur die Kennung, mit
|
|
81
|
-
* der die spaetere kanonische Batch-Persistenz (`saveGeneratedAssetBatch`,
|
|
82
|
-
* Teil C) wiedergefunden wird. Ein Crash zwischen diesem Ereignis und
|
|
83
|
-
* `imageGenerationFinished` loescht den Auftrag nicht: Er bleibt lesbar,
|
|
84
|
-
* ohne dass irgendein automatischer Retry darauf reagiert.
|
|
85
|
-
*
|
|
86
|
-
* Gilt nur fuer `generated_in_app` — ein externer Import (D-108/D-117)
|
|
87
|
-
* ruft keinen Provider und braucht deshalb kein `started`; sein Nachweis
|
|
88
|
-
* ist das gespeicherte Library-Item selbst.
|
|
89
|
-
*
|
|
90
|
-
* Der Elementreducer ignoriert auch diesen Typ (`default:`-Zweig); gelesen
|
|
91
|
-
* wird mit `collectImageGenerationOrders`.
|
|
92
|
-
*/
|
|
93
|
-
readonly imageGenerationStarted: "szenen.image_generation_started";
|
|
94
|
-
/**
|
|
95
|
-
* Derselbe Bildgenerierungsauftrag endet — Stufe 6.7 (D-119).
|
|
96
|
-
*
|
|
97
|
-
* Erscheint erst **nach** der kanonischen Batch-Persistenz: Ein technischer
|
|
98
|
-
* Fehler zwischen Provideraufruf und Speichern darf nie als `succeeded`
|
|
99
|
-
* protokolliert werden, nur weil der Provider geantwortet hat. Traegt
|
|
100
|
-
* ebenfalls keine Bilddaten — nur Status, Zaehlung und die Item-Kennung,
|
|
101
|
-
* falls eine entstand.
|
|
102
|
-
*/
|
|
103
|
-
readonly imageGenerationFinished: "szenen.image_generation_finished";
|
|
104
|
-
/**
|
|
105
|
-
* Ein Bild-Batch ist kanonisch gespeichert — Stufe 6.9.2, Gate D
|
|
106
|
-
* (D-6.9.2-6).
|
|
107
|
-
*
|
|
108
|
-
* Erscheint erst, **nachdem** jedes Bild des Batches im Bildbestand liegt
|
|
109
|
-
* (`hfUploadImage` + `image_added`, dieselbe Reihenfolge wie
|
|
110
|
-
* `hfImageLibrary.putImage`) — kein Bild gilt als vorhanden, bevor sein
|
|
111
|
-
* Upload bestätigt ist (R3). Trägt bewusst **keine Bilddaten**, nur den
|
|
112
|
-
* vollständigen Metadatennachweis, den `listBatchesForPromptRun()` /
|
|
113
|
-
* `getBatch()` ohne MySQL rekonstruieren können müssen: `item_id`,
|
|
114
|
-
* `prompt_run_id`, `generation_batch_id`, `source_kind`, je Bild
|
|
115
|
-
* `position`, `media_ref`, `asset_id`, `model`, `seed`, `width`/`height`.
|
|
116
|
-
*
|
|
117
|
-
* Additiv wie jedes Ereignis dieser Domain: ein zweiter Batch desselben
|
|
118
|
-
* Laufs ist ein **weiteres** Ereignis mit derselben `item_id`, nicht eine
|
|
119
|
-
* Änderung am ersten (D-113/D-121 — ein Lauf bleibt ein Item). Gilt für
|
|
120
|
-
* `generated_in_app` **und** `external_import` — nur `source_kind`
|
|
121
|
-
* unterscheidet die beiden Schreiber (D-116/D-117/D-120).
|
|
122
|
-
*
|
|
123
|
-
* Der Elementreducer ignoriert auch diesen Typ (`default:`-Zweig); gelesen
|
|
124
|
-
* wird mit `collectImageBatches` (`imageBatchStore.ts`).
|
|
125
|
-
*/
|
|
126
|
-
readonly imageBatchPersisted: "szenen.image_batch_persisted";
|
|
127
|
-
/**
|
|
128
|
-
* Ein vorbereiteter Promptvorgang — der Durchstich „Szene → ChatGPT → Lauf".
|
|
129
|
-
*
|
|
130
|
-
* Der bestehende Promptpfad ruft das Modell selbst
|
|
131
|
-
* (`runPromptDerivation()`); ein aufrufendes Chatmodell formuliert dagegen
|
|
132
|
-
* **zwischen** zwei Werkzeugaufrufen. Damit zerfaellt der eine Vorgang in
|
|
133
|
-
* zwei, und der zweite braucht genau den Stand, den der erste eingefroren
|
|
134
|
-
* hat — sonst loeste der Abschluss die inzwischen geaenderte Szene neu auf
|
|
135
|
-
* und der Lauf behauptete eine Herkunft, die er nicht hat (D-22).
|
|
136
|
-
*
|
|
137
|
-
* Deshalb ein eigenes Ereignis und **kein** fluechtiger Prozesszustand: Der
|
|
138
|
-
* Snapshot ueberlebt Neustart, Hostwechsel und Sitzungsende, weil er im
|
|
139
|
-
* selben autoritativen Log liegt wie der Lauf, der daraus entsteht.
|
|
140
|
-
*
|
|
141
|
-
* Der Elementreducer ignoriert diesen Typ (`default:`-Zweig); gelesen wird
|
|
142
|
-
* mit `collectPromptOperations` (`scenePromptOperation.ts`).
|
|
143
|
-
*/
|
|
144
|
-
readonly promptOperationPrepared: "szenen.prompt_operation_prepared";
|
|
145
|
-
/**
|
|
146
|
-
* Ein Bildauftrag wartet auf einen ausfuehrenden Flow-Host.
|
|
147
|
-
*
|
|
148
|
-
* Die vorhandene Auftragshistorie (`imageGenerationStarted`) beginnt
|
|
149
|
-
* **unmittelbar vor** dem Provideraufruf und kennt deshalb keinen wartenden
|
|
150
|
-
* Auftrag. Genau der entsteht hier: Ein Chatmodell beauftragt ueber MCP ein
|
|
151
|
-
* Bild, der Auftrag wird dauerhaft abgelegt, und der Werkzeugaufruf endet
|
|
152
|
-
* sofort mit seiner Kennung — er haelt keine Antwort minutenlang offen.
|
|
153
|
-
*
|
|
154
|
-
* Traegt **keinen** Prompt: Der steht im referenzierten Lauf, und ihn hier
|
|
155
|
-
* zu kopieren waere eine zweite Wahrheit ueber denselben eingefrorenen Text
|
|
156
|
-
* (D-103).
|
|
157
|
-
*/
|
|
158
|
-
readonly imageJobRequested: "szenen.image_job_requested";
|
|
159
|
-
/**
|
|
160
|
-
* Ein Flow-Host beansprucht einen wartenden Bildauftrag.
|
|
161
|
-
*
|
|
162
|
-
* Ein append-only Log kennt kein Lock: Zwei Tabs koennen beide anhaengen.
|
|
163
|
-
* Deshalb ist die Uebernahme **nicht** der Append, sondern das Ergebnis
|
|
164
|
-
* einer deterministischen Schiedsregel darueber (`winningClaimOf`) — der
|
|
165
|
-
* erste Anspruch in Logreihenfolge gewinnt, und jeder Host liest nach
|
|
166
|
-
* seinem Append erneut, bevor er einen bezahlten Provideraufruf startet.
|
|
167
|
-
* Ein unterlegener Anspruch bleibt sichtbar stehen; er wird nicht geloescht,
|
|
168
|
-
* weil das Log das nicht kann und weil der Versuch ein Beleg ist.
|
|
169
|
-
*/
|
|
170
|
-
readonly imageJobClaimed: "szenen.image_job_claimed";
|
|
171
|
-
/**
|
|
172
|
-
* Der Bildauftrag ist erledigt — mit dem Ausgang, den der Host gesehen hat.
|
|
173
|
-
*
|
|
174
|
-
* Getrennt von `imageGenerationFinished`: Jenes gehoert zum bezahlten
|
|
175
|
-
* Provideraufruf, dieses zur Zustellung. Ein Auftrag kann fehlschlagen,
|
|
176
|
-
* **bevor** ein Provider gerufen wurde (abgelehntes Profil), und dann gibt
|
|
177
|
-
* es kein `imageGenerationFinished`, das den Wartenden erloesen wuerde.
|
|
178
|
-
*/
|
|
179
|
-
readonly imageJobSettled: "szenen.image_job_settled";
|
|
180
|
-
};
|
|
181
|
-
/** Ein einzelnes Bild innerhalb von `ImageBatchPersistedPayload` (D-6.9.2-6). */
|
|
182
|
-
interface ImageBatchPersistedImage {
|
|
183
|
-
position: number;
|
|
184
|
-
/** Im aktuellen Host auflösbarer Locator — hier die HF-Bildkennung (D-93). */
|
|
185
|
-
media_ref: string;
|
|
186
|
-
/** Fachlich stabile Identität, soweit bekannt — hier identisch mit `media_ref` (D-118). */
|
|
187
|
-
asset_id?: string;
|
|
188
|
-
/**
|
|
189
|
-
* Der **bestätigte** MIME-Typ der abgelegten Datei — Review 2026-08-18 §5 P2.
|
|
190
|
-
*
|
|
191
|
-
* Additiv nachgetragen, weil der Batch ihn beim Schreiben kennt, ihn aber
|
|
192
|
-
* nicht führte: Der Lesepfad musste die Dateiendung deshalb über zwei
|
|
193
|
-
* Varianten erraten. Geraten wird nichts mehr — der Typ stammt aus den
|
|
194
|
-
* tatsächlichen Bildbytes (`typAusBytes`), nicht aus einer Annahme, und
|
|
195
|
-
* bestimmt den Pfad `images/<id>.<ext>`, unter dem die Datei liegt.
|
|
196
|
-
*
|
|
197
|
-
* Optional, weil ältere Ereignisse ihn nicht tragen; für die fällt der
|
|
198
|
-
* Lesepfad auf den Bestandseintrag zurück.
|
|
199
|
-
*/
|
|
200
|
-
mime_type?: string | null;
|
|
201
|
-
model?: string | null;
|
|
202
|
-
/** Nur gesetzt, wenn der Provider ihn tatsächlich zurückliefert (D-107). */
|
|
203
|
-
seed?: number | null;
|
|
204
|
-
width?: number | null;
|
|
205
|
-
height?: number | null;
|
|
206
|
-
}
|
|
207
|
-
/** Nutzlast von `imageBatchPersisted` — geschrieben nach bestätigtem Bild-Upload. */
|
|
208
|
-
interface ImageBatchPersistedPayload {
|
|
209
|
-
item_id: string;
|
|
210
|
-
prompt_run_id: string;
|
|
211
|
-
generation_batch_id: string;
|
|
212
|
-
source_kind: 'generated_in_app' | 'external_import';
|
|
213
|
-
title: string;
|
|
214
|
-
images: readonly ImageBatchPersistedImage[];
|
|
215
|
-
created_at: string;
|
|
216
|
-
}
|
|
217
|
-
/**
|
|
218
|
-
* Ein Event, wie der Reducer es sieht.
|
|
219
|
-
*
|
|
220
|
-
* Nur `type`, `payload` und `clientId` sind fachlich. `ts` dient allein der
|
|
221
|
-
* **Lesereihenfolge** des Logs und darf nie eine fachliche Vorrangfrage
|
|
222
|
-
* entscheiden — sonst wäre es `MAX(ts)` durch die Hintertür (§2.5, R-3).
|
|
223
|
-
*/
|
|
224
|
-
interface ElementEvent<P = unknown> {
|
|
225
|
-
type: string;
|
|
226
|
-
payload: P;
|
|
227
|
-
clientId: string;
|
|
228
|
-
ts: number;
|
|
229
|
-
}
|
|
230
|
-
/** Ein Befund beim Falten: etwas ist widersprüchlich, aber der Zustand bleibt lesbar. */
|
|
231
|
-
interface ReducerFinding {
|
|
232
|
-
code: 'unbekanntes_element' | 'version_doppelt' | 'version_veraendert' | 'draft_fork' | 'metadata_fork' | 'preferred_head_fork' | 'element_doppelt';
|
|
233
|
-
element_id: string;
|
|
234
|
-
message: string;
|
|
235
|
-
}
|
|
236
|
-
/** Abgeleiteter Zustand über alle Elemente. */
|
|
237
|
-
interface ElementStoreState {
|
|
238
|
-
elements: ReadonlyMap<string, ElementSnapshot>;
|
|
239
|
-
findings: readonly ReducerFinding[];
|
|
240
|
-
}
|
|
241
|
-
/**
|
|
242
|
-
* Faltet den Event-Log zum Elementzustand.
|
|
243
|
-
*
|
|
244
|
-
* Der Reducer ist rein: gleiche Events, gleicher Zustand — unabhängig von der
|
|
245
|
-
* Eingabereihenfolge.
|
|
246
|
-
*
|
|
247
|
-
* @param events Alle bekannten Szenen-Events; fremde Typen werden übergangen.
|
|
248
|
-
*/
|
|
249
|
-
declare function reduceElementEvents(events: readonly ElementEvent[]): ElementStoreState;
|
|
250
|
-
/** Aktuelle Revision des Entwurfs. `0`, wenn keiner existiert. */
|
|
251
|
-
declare function draftRevisionOf(snapshot: ElementSnapshot | null | undefined): number;
|
|
252
|
-
/**
|
|
253
|
-
* Quellrevision eines gelesenen Event-Logs (D-62 §2.4, D-63 §1.1.2).
|
|
254
|
-
*
|
|
255
|
-
* Die Projektion darf sich nur dann `current` nennen, wenn sie belegen kann,
|
|
256
|
-
* **bis wohin** sie reicht. Dieser Beleg ist die Quellrevision, und sie muss
|
|
257
|
-
* zwei Eigenschaften haben: aus dem Log allein berechenbar (sonst wäre sie eine
|
|
258
|
-
* zweite Buchführung) und für zwei verschiedene Logstände verschieden.
|
|
259
|
-
*
|
|
260
|
-
* Beides leistet `Anzahl@größter-Zeitstempel`. Der Log ist append-only — es
|
|
261
|
-
* verschwindet nie ein Event —, also wächst die Anzahl bei jedem Schreibvorgang.
|
|
262
|
-
* Der Zeitstempel kommt dazu, weil er den Stand für einen Menschen lesbar macht;
|
|
263
|
-
* entscheidend ist die Anzahl.
|
|
264
|
-
*
|
|
265
|
-
* Bewusst **kein** Hash über die Payloads: der wäre teurer und würde
|
|
266
|
-
* Gleichheit über die Zeit versprechen, die der Log ohnehin schon garantiert.
|
|
267
|
-
* Und bewusst hier, nicht im Server: der Projektor rechnet damit, und wer den
|
|
268
|
-
* Stand prüfen will, soll dieselbe Rechnung fahren (R-2).
|
|
269
|
-
*/
|
|
270
|
-
declare function logRevisionOf(events: readonly ElementEvent[]): string;
|
|
271
|
-
/** Aktuelle Revision der Preferred-Head-Auswahl eines Kontexts. `0`, wenn keine existiert. */
|
|
272
|
-
declare function preferredHeadRevisionOf(events: readonly ElementEvent[], elementId: string, contextId: string): number;
|
|
273
|
-
|
|
274
9
|
/** Aktuelle Fassung des Dateiformats. */
|
|
275
10
|
declare const SZENEN_SNAPSHOT_SCHEMA_VERSION = 1;
|
|
276
11
|
/** Namenspräfix des Snapshots im Namensraum bzw. im Dateilog. */
|
|
@@ -1362,6 +1097,41 @@ interface PromptRunRecord {
|
|
|
1362
1097
|
source?: PromptRunSource;
|
|
1363
1098
|
created_at: string;
|
|
1364
1099
|
}
|
|
1100
|
+
/**
|
|
1101
|
+
* Die Felder, die **nur** das Detail eines Laufs braucht.
|
|
1102
|
+
*
|
|
1103
|
+
* Alle drei sind gross und keines davon steht in einer Liste: `system_prompt`
|
|
1104
|
+
* wird nirgends angezeigt, `raw_output` nur im Diagnosebereich der
|
|
1105
|
+
* aufgeklappten Runde, `input_payload` nur dort, wo aus dem eingefrorenen Lauf
|
|
1106
|
+
* Bilder entstehen. Auf dev machten sie bei zehn Laeufen 74 von 100 kB der
|
|
1107
|
+
* uebertragenen Laufdaten aus.
|
|
1108
|
+
*/
|
|
1109
|
+
declare const PROMPT_RUN_DETAIL_FIELDS: readonly ["system_prompt", "input_payload", "raw_output"];
|
|
1110
|
+
/**
|
|
1111
|
+
* Ein Lauf, wie ihn eine Liste **ueber eine Leitung** bekommt.
|
|
1112
|
+
*
|
|
1113
|
+
* Kein gekuerzter `PromptRunRecord`, sondern ein eigener Typ mit einer
|
|
1114
|
+
* ausdruecklichen Marke: Wer `detail_omitted` sieht, weiss, dass die drei
|
|
1115
|
+
* Felder fehlen, **weil sie nicht mitgeschickt wurden** — und nicht, weil der
|
|
1116
|
+
* Lauf sie nicht hat. Genau diese Unterscheidung ginge verloren, wenn die
|
|
1117
|
+
* Felder am `PromptRunRecord` optional wuerden: Ein leeres `raw_output` saehe
|
|
1118
|
+
* dann aus wie ein Lauf ohne Modellantwort (Regel 4).
|
|
1119
|
+
*
|
|
1120
|
+
* Ein Host, der seinen Bestand **ohne** Transport faltet (der Ereignislog in
|
|
1121
|
+
* Flow), setzt die Marke nicht und liefert weiterhin volle Saetze. Die Ansicht
|
|
1122
|
+
* braucht dafuer keinen zweiten Weg: Sie laedt das Detail nach, wenn die Marke
|
|
1123
|
+
* steht, und sonst nicht.
|
|
1124
|
+
*/
|
|
1125
|
+
interface PromptRunListRecord extends Omit<PromptRunRecord, 'system_prompt' | 'input_payload' | 'raw_output'> {
|
|
1126
|
+
detail_omitted: true;
|
|
1127
|
+
system_prompt?: undefined;
|
|
1128
|
+
input_payload?: undefined;
|
|
1129
|
+
raw_output?: undefined;
|
|
1130
|
+
}
|
|
1131
|
+
/** Ein Lauf in einer Seite — voll, oder als Listenprojektion. */
|
|
1132
|
+
type PromptRunPageRecord = PromptRunRecord | PromptRunListRecord;
|
|
1133
|
+
/** Ob einem Lauf die Detailfelder fehlen, weil die Liste sie nicht uebertraegt. */
|
|
1134
|
+
declare function detailFehlt(run: PromptRunPageRecord): run is PromptRunListRecord;
|
|
1365
1135
|
/**
|
|
1366
1136
|
* Die Herkunft eines Laufs, auch bei einem Satz von vor 6.6.
|
|
1367
1137
|
*
|
|
@@ -1370,7 +1140,7 @@ interface PromptRunRecord {
|
|
|
1370
1140
|
* Damit muss kein Konsument zwei Datenformen kennen — und trotzdem wurde kein
|
|
1371
1141
|
* einziges Ereignis angefasst.
|
|
1372
1142
|
*/
|
|
1373
|
-
declare function sourceOf(run:
|
|
1143
|
+
declare function sourceOf(run: PromptRunPageRecord): PromptRunSource;
|
|
1374
1144
|
/** Nutzlast des Ereignisses. Identisch mit dem Datensatz — ein Lauf ändert sich nie. */
|
|
1375
1145
|
type PromptRunRecordedPayload = PromptRunRecord;
|
|
1376
1146
|
/**
|
|
@@ -1418,9 +1188,9 @@ type PromptRunGroup = {
|
|
|
1418
1188
|
* zusammenführt. Es entsteht **kein** neues Herkunftsfeld am Lauf; die Gruppe
|
|
1419
1189
|
* wird bei jedem Lesen aus dem berechnet, was ohnehin dasteht.
|
|
1420
1190
|
*/
|
|
1421
|
-
declare function groupOf(run:
|
|
1191
|
+
declare function groupOf(run: PromptRunPageRecord): PromptRunGroup;
|
|
1422
1192
|
/** Nur der Schlüssel der Bezugsgruppe — für Vergleiche und Filter. */
|
|
1423
|
-
declare function groupKeyOf(run:
|
|
1193
|
+
declare function groupKeyOf(run: PromptRunPageRecord): string;
|
|
1424
1194
|
/**
|
|
1425
1195
|
* Die Geschwister eines Laufs: alle Läufe **seiner** Bezugsgruppe.
|
|
1426
1196
|
*
|
|
@@ -1447,7 +1217,7 @@ declare function siblingsOf(run: PromptRunRecord, alle: readonly PromptRunRecord
|
|
|
1447
1217
|
* `null` heisst: Es gibt kein benennbares Element. Dann bleibt es bei „Runde
|
|
1448
1218
|
* n" — ein erfundener Titel wäre schlimmer als keiner (D-75).
|
|
1449
1219
|
*/
|
|
1450
|
-
declare function namingElementOf(run:
|
|
1220
|
+
declare function namingElementOf(run: PromptRunPageRecord): string | null;
|
|
1451
1221
|
/**
|
|
1452
1222
|
* Der Arbeitskontext, in dem ein Lauf entstanden ist.
|
|
1453
1223
|
*
|
|
@@ -1507,6 +1277,167 @@ interface PromptRunListing {
|
|
|
1507
1277
|
* Eingabe bleibt erhalten.
|
|
1508
1278
|
*/
|
|
1509
1279
|
declare function selectPromptRuns(alle: readonly PromptRunRecord[], filter?: PromptRunFilter): PromptRunListing;
|
|
1280
|
+
/**
|
|
1281
|
+
* Woher die Laeufe einer Seite kommen.
|
|
1282
|
+
*
|
|
1283
|
+
* Genau die vier Einstiege, die es ohnehin gibt — `listAllRuns` und die drei
|
|
1284
|
+
* verankerten Abfragen. Hier entsteht **keine** fuenfte Herkunft und keine
|
|
1285
|
+
* neue Zuordnungsregel: `'all'` heisst „ohne Anker", die drei anderen
|
|
1286
|
+
* vergleichen denselben `groupKeyOf`, den auch die Geschwister benutzen.
|
|
1287
|
+
*/
|
|
1288
|
+
type PromptRunPageSource = {
|
|
1289
|
+
kind: 'all';
|
|
1290
|
+
} | {
|
|
1291
|
+
kind: 'published';
|
|
1292
|
+
shotVersionId: string;
|
|
1293
|
+
} | {
|
|
1294
|
+
kind: 'draft_chain';
|
|
1295
|
+
chainId: string;
|
|
1296
|
+
} | {
|
|
1297
|
+
kind: 'scene';
|
|
1298
|
+
sceneElementId: string;
|
|
1299
|
+
};
|
|
1300
|
+
/** Der Herkunftsfilter der gemeinsamen Sicht — dieselben Namen wie `PromptRunGroup`. */
|
|
1301
|
+
type PromptRunOriginFilter = PromptRunGroup['kind'];
|
|
1302
|
+
interface PromptRunPageFilter extends PromptRunFilter {
|
|
1303
|
+
/** Nur Laeufe dieser Herkunft. Weglassen heisst „alle Herkuenfte". */
|
|
1304
|
+
origin?: PromptRunOriginFilter;
|
|
1305
|
+
}
|
|
1306
|
+
interface PromptRunPageInput {
|
|
1307
|
+
source?: PromptRunPageSource;
|
|
1308
|
+
filter?: PromptRunPageFilter;
|
|
1309
|
+
/** Ohne Angabe wird nicht geschnitten — dann ist die Seite der ganze Bestand. */
|
|
1310
|
+
page?: PageRequest | null;
|
|
1311
|
+
/**
|
|
1312
|
+
* Die direkten Prompt-Tags des **ganzen** Bestands, wie
|
|
1313
|
+
* `collectPromptRunTags()` sie aus demselben Log faltet.
|
|
1314
|
+
*
|
|
1315
|
+
* Sie gehen hier hinein und nicht in einen zweiten Aufruf, weil die Seite
|
|
1316
|
+
* genau die Tags ihrer zehn Laeufe mitbringen soll — ein Nachschlagen je
|
|
1317
|
+
* Karte waere die N+1-Abfrage, die diese Kette ausdruecklich vermeidet.
|
|
1318
|
+
* Fehlt die Angabe, traegt die Seite einen leeren Tagsatz; das heisst „nicht
|
|
1319
|
+
* mitgeliefert", und die Ansicht zeigt dann nur, was sie hat.
|
|
1320
|
+
*/
|
|
1321
|
+
tags?: ReadonlyMap<string, readonly LibraryTagRef[]>;
|
|
1322
|
+
/**
|
|
1323
|
+
* Bildanzahl, Vorschau und Library-Tags je Lauf — wie
|
|
1324
|
+
* `annotateRunsFromEvents()` sie liefert.
|
|
1325
|
+
*
|
|
1326
|
+
* Auch das geht **hier** hinein und nicht in einen Aufruf je Karte: Die
|
|
1327
|
+
* Bild-Batches liegen in demselben Log wie die Laeufe, und die Seite bringt
|
|
1328
|
+
* die Zahlen ihrer zehn Laeufe mit.
|
|
1329
|
+
*/
|
|
1330
|
+
annotations?: ReadonlyMap<string, PromptRunAnnotation>;
|
|
1331
|
+
/**
|
|
1332
|
+
* Der Titel je **Element**, wie ihn der gefaltete Bestand kennt.
|
|
1333
|
+
*
|
|
1334
|
+
* Aus demselben Grund hier wie Tags und Bildzahlen: Der Name eines Laufs ist
|
|
1335
|
+
* der Titel des Elements, aus dem er entstand (`namingElementOf`), und der
|
|
1336
|
+
* steht in demselben Log. Ihn je Karte einzeln zu lesen hiess bisher, nach
|
|
1337
|
+
* der Seite noch einmal **je Element** eine Abfrage zu stellen — nacheinander,
|
|
1338
|
+
* weil eine Liste sonst zehn gleichzeitig ausloeste.
|
|
1339
|
+
*
|
|
1340
|
+
* Fehlt die Angabe, traegt die Seite keine Titel; die Ansicht loest sie dann
|
|
1341
|
+
* weiterhin selbst auf. Es entsteht keine zweite Namensregel: **welches**
|
|
1342
|
+
* Element benennt, entscheidet nach wie vor `namingElementOf()`.
|
|
1343
|
+
*/
|
|
1344
|
+
titles?: ReadonlyMap<string, string>;
|
|
1345
|
+
}
|
|
1346
|
+
/**
|
|
1347
|
+
* Eine Seite Laeufe, **neueste zuerst**, mit allem, was die Anzeige sonst aus
|
|
1348
|
+
* dem Gesamtbestand hatte.
|
|
1349
|
+
*
|
|
1350
|
+
* Warum die Rundennummern mitkommen: Die Runde ist der Platz eines Laufs unter
|
|
1351
|
+
* seinen Geschwistern (U23) — sie laesst sich aus zehn von achthundert Laeufen
|
|
1352
|
+
* nicht ausrechnen. Statt dafuer wieder alles zu uebertragen, rechnet die Seite
|
|
1353
|
+
* sie dort aus, wo der volle Bestand ohnehin liegt, und schickt genau die
|
|
1354
|
+
* Nummern der gezeigten Laeufe mit. Es entsteht keine zweite Zaehlung: dieselbe
|
|
1355
|
+
* Gruppierung, dieselbe Reihenfolge, derselbe 1-basierte Platz wie
|
|
1356
|
+
* `roundOfRun(lauf, siblingsOf(lauf, alle))`.
|
|
1357
|
+
*/
|
|
1358
|
+
interface PromptRunPage extends Omit<PromptRunListing, 'runs'>, Page<PromptRunPageRecord> {
|
|
1359
|
+
/**
|
|
1360
|
+
* Dieselben Saetze wie `items` — `runs` bleibt der Name der Laufliste.
|
|
1361
|
+
*
|
|
1362
|
+
* Ueber eine Leitung sind es Listenprojektionen (`detail_omitted`), im
|
|
1363
|
+
* lokal faltenden Host volle Saetze. Die Ansicht unterscheidet das mit
|
|
1364
|
+
* `detailFehlt()` und laedt nur im ersten Fall nach.
|
|
1365
|
+
*/
|
|
1366
|
+
runs: readonly PromptRunPageRecord[];
|
|
1367
|
+
/** Rundennummer je `run_id`, nur fuer die Laeufe dieser Seite. */
|
|
1368
|
+
rounds: Readonly<Record<string, number>>;
|
|
1369
|
+
/** Laeufe, die der Herkunftsfilter ausgeblendet hat. */
|
|
1370
|
+
hiddenByOrigin: number;
|
|
1371
|
+
/**
|
|
1372
|
+
* Die **direkten** Tags je `run_id`, nur fuer die Laeufe dieser Seite.
|
|
1373
|
+
*
|
|
1374
|
+
* Ein Lauf ohne Eintrag hat keine Prompt-Tags. Getrennt von `annotations`
|
|
1375
|
+
* gefuehrt, weil diese Tags aus demselben Log stammen wie die Laeufe und
|
|
1376
|
+
* jeder Host sie hat — auch einer ohne Library-Bestand.
|
|
1377
|
+
*/
|
|
1378
|
+
promptTags: Readonly<Record<string, readonly LibraryTagRef[]>>;
|
|
1379
|
+
/**
|
|
1380
|
+
* Der Anzeigename je `run_id`, nur fuer die Laeufe dieser Seite und nur, wo
|
|
1381
|
+
* das benennende Element einen Titel hat.
|
|
1382
|
+
*
|
|
1383
|
+
* Ein Lauf ohne Eintrag bleibt titellos und heisst „Runde n" — ein aus der
|
|
1384
|
+
* `run_id` gebastelter Name saehe aus wie ein echter (D-75).
|
|
1385
|
+
*/
|
|
1386
|
+
titles?: Readonly<Record<string, string>>;
|
|
1387
|
+
/**
|
|
1388
|
+
* Bildanzahl, Vorschau und Library-Tags je `run_id` — nur wenn der Host sie
|
|
1389
|
+
* liefern kann. Fehlt das Feld, weiss die Ansicht es nicht und sagt das.
|
|
1390
|
+
*/
|
|
1391
|
+
annotations?: Readonly<Record<string, PromptRunAnnotation>>;
|
|
1392
|
+
}
|
|
1393
|
+
/**
|
|
1394
|
+
* Die Rundennummer **jedes** Laufs des uebergebenen Bestands.
|
|
1395
|
+
*
|
|
1396
|
+
* Gerechnet auf der chronologischen Reihenfolge, die `collectPromptRuns`
|
|
1397
|
+
* liefert — nicht auf der Anzeigereihenfolge. Die Anzeige dreht sich um; die
|
|
1398
|
+
* Rundenzaehlung tut es nicht, sonst hiesse derselbe Lauf morgen anders.
|
|
1399
|
+
*/
|
|
1400
|
+
declare function roundsOf(alle: readonly PromptRunRecord[]): ReadonlyMap<string, number>;
|
|
1401
|
+
/**
|
|
1402
|
+
* Der eine Seitenschnitt fuer Prompt-Laeufe — Server wie Client.
|
|
1403
|
+
*
|
|
1404
|
+
* Reine Funktion ueber einem bereits gelesenen Bestand, genau wie
|
|
1405
|
+
* `selectPromptRuns`, das sie benutzt. Damit gilt der Bezugsrahmen (Status,
|
|
1406
|
+
* Kontext) an beiden Enden unveraendert; dazu kommen Herkunft, Umkehrung und
|
|
1407
|
+
* Schnitt.
|
|
1408
|
+
*
|
|
1409
|
+
* @param alle Der Bestand in der Reihenfolge von `collectPromptRuns`.
|
|
1410
|
+
* @throws Wenn der Cursor in der gefilterten Liste nicht vorkommt (`pageOf`).
|
|
1411
|
+
*/
|
|
1412
|
+
declare function pagePromptRuns(alle: readonly PromptRunRecord[], input?: PromptRunPageInput): PromptRunPage;
|
|
1413
|
+
/**
|
|
1414
|
+
* Eine Seite, wie sie **ueber eine Leitung** geht — Kette `szenen-promptliste-transport`.
|
|
1415
|
+
*
|
|
1416
|
+
* Zwei Dinge fallen weg, beide gemessen an `GET /api2/szenen/prompt-runs/page`
|
|
1417
|
+
* auf dev mit zehn Laeufen (203 kB):
|
|
1418
|
+
*
|
|
1419
|
+
* 1. **`items`.** Die Seite trug die Laufliste zweimal: einmal als `runs`,
|
|
1420
|
+
* einmal als `items` aus dem `Page<T>`-Vertrag. Im JSON sind das zwei
|
|
1421
|
+
* vollstaendige Kopien — 100 der 203 kB. Der Vertrag bleibt: Der Adapter
|
|
1422
|
+
* auf der anderen Seite setzt `items` aus `runs` wieder zusammen, statt es
|
|
1423
|
+
* zu uebertragen.
|
|
1424
|
+
* 2. **Die Detailfelder** (`PROMPT_RUN_DETAIL_FIELDS`). 74 der uebrigen 100 kB,
|
|
1425
|
+
* und keines davon zeigt die Liste. Was bleibt, ist als
|
|
1426
|
+
* `PromptRunListRecord` **markiert**, damit die Ansicht ein fehlendes Feld
|
|
1427
|
+
* nicht fuer eine Aussage ueber den Lauf haelt.
|
|
1428
|
+
*
|
|
1429
|
+
* Rein und ohne Host: `items` wegzulassen ist eine Transportentscheidung, und
|
|
1430
|
+
* sie gehoert neben den Seitenschnitt, nicht in einen Controller.
|
|
1431
|
+
*/
|
|
1432
|
+
declare function promptRunPageForTransport(seite: PromptRunPage): Omit<PromptRunPage, 'items'>;
|
|
1433
|
+
/**
|
|
1434
|
+
* Die Gegenrichtung: `items` aus `runs` zuruecklegen.
|
|
1435
|
+
*
|
|
1436
|
+
* Der `Page<T>`-Vertrag gilt im Client unveraendert — er wurde nur nicht
|
|
1437
|
+
* uebertragen. Ohne diesen Schritt fehlte `items` still, und jeder kuenftige
|
|
1438
|
+
* Aufrufer von `Page<T>` saehe eine leere Seite statt eines Fehlers.
|
|
1439
|
+
*/
|
|
1440
|
+
declare function promptRunPageFromTransport(roh: Omit<PromptRunPage, 'items'>): PromptRunPage;
|
|
1510
1441
|
|
|
1511
1442
|
/**
|
|
1512
1443
|
* Ein Vorschlag, so wie er im Ereignis steht.
|
|
@@ -2942,6 +2873,113 @@ declare function claimWon(job: ImageJob | null, claimId: string): boolean;
|
|
|
2942
2873
|
*/
|
|
2943
2874
|
declare function generationBatchIdOf(jobId: string): string;
|
|
2944
2875
|
|
|
2876
|
+
/**
|
|
2877
|
+
* Die Statusgruppen, nach denen der Bereich filtert (§3).
|
|
2878
|
+
*
|
|
2879
|
+
* Bewusst **Gruppen** und nicht die rohen Auftragszustaende: Fuer die
|
|
2880
|
+
* Bedienung zaehlt „offen / laeuft / fertig / fehlgeschlagen", und
|
|
2881
|
+
* `succeeded` von `partial` zu trennen waere ein Filter, den niemand braucht.
|
|
2882
|
+
* Die genauen Zustaende stehen weiterhin an jedem Auftrag.
|
|
2883
|
+
*/
|
|
2884
|
+
type ImageJobStatusFilter = 'pending' | 'claimed' | 'done' | 'failed' | 'all';
|
|
2885
|
+
/** Ob ein Auftrag noch auf Uebernahme wartet — der Arbeitsvorrat. */
|
|
2886
|
+
declare function istOffen(job: ImageJob): boolean;
|
|
2887
|
+
/**
|
|
2888
|
+
* Die Herkunft eines Auftrags, soweit **aus derselben Faltung** sicher
|
|
2889
|
+
* auflösbar (§3, §8 Regel 3).
|
|
2890
|
+
*
|
|
2891
|
+
* `null`-Felder heissen „steht nicht im Bestand", nicht „unbekannt geraten":
|
|
2892
|
+
* Ein Auftrag, dessen Lauf hier nicht liegt, bekommt keinen erfundenen Titel
|
|
2893
|
+
* (Regel 4).
|
|
2894
|
+
*/
|
|
2895
|
+
interface ImageJobHerkunft {
|
|
2896
|
+
run_id: string;
|
|
2897
|
+
/** Der Titel des benennenden Elements — meist die Szene. */
|
|
2898
|
+
szene_titel: string | null;
|
|
2899
|
+
/** Die Kennung dieses Elements, auch wenn kein Titel auflösbar war. */
|
|
2900
|
+
szene_element_id: string | null;
|
|
2901
|
+
/** Ein kurzer Ausschnitt des eingefrorenen positiven Prompts. */
|
|
2902
|
+
prompt_auszug: string | null;
|
|
2903
|
+
/** Ob der Lauf selbst im Bestand liegt. `false` → alle Felder oben sind leer. */
|
|
2904
|
+
lauf_gefunden: boolean;
|
|
2905
|
+
}
|
|
2906
|
+
/** Ein Auftrag mit seiner gemeinsam geladenen Herkunft. */
|
|
2907
|
+
interface ImageJobEintrag {
|
|
2908
|
+
job: ImageJob;
|
|
2909
|
+
herkunft: ImageJobHerkunft;
|
|
2910
|
+
}
|
|
2911
|
+
/** Wie viele Zeichen des Prompts in einer Zeile stehen. */
|
|
2912
|
+
declare const PROMPT_AUSZUG_ZEICHEN = 160;
|
|
2913
|
+
interface ImageJobQuery {
|
|
2914
|
+
/** Vorgabe: `pending` — der Bereich ist eine Arbeitsqueue, kein Archiv. */
|
|
2915
|
+
status?: ImageJobStatusFilter;
|
|
2916
|
+
/** Hoechstens so viele Eintraege je Seite. Fehlt: alle. */
|
|
2917
|
+
limit?: number;
|
|
2918
|
+
/** Die Auftragskennung, **nach** der weitergelesen wird. */
|
|
2919
|
+
cursor?: string | null;
|
|
2920
|
+
}
|
|
2921
|
+
interface ImageJobSeite {
|
|
2922
|
+
eintraege: readonly ImageJobEintrag[];
|
|
2923
|
+
/** Die Kennung fuer die naechste Seite, oder `null` — dann ist es vollstaendig. */
|
|
2924
|
+
nextCursor: string | null;
|
|
2925
|
+
/** Wie viele Auftraege der Filter insgesamt trifft, unabhaengig vom Schnitt. */
|
|
2926
|
+
gesamt: number;
|
|
2927
|
+
/**
|
|
2928
|
+
* Wie viele Auftraege des Bestands **offen** sind — unabhaengig von Filter
|
|
2929
|
+
* und Seitenschnitt.
|
|
2930
|
+
*
|
|
2931
|
+
* Der Arbeitsvorrat muss vollstaendig ablesbar bleiben, auch wenn die Seite
|
|
2932
|
+
* ihn nicht ganz zeigt (§8 Regel 4).
|
|
2933
|
+
*/
|
|
2934
|
+
offen: number;
|
|
2935
|
+
}
|
|
2936
|
+
/**
|
|
2937
|
+
* Die bestandsweite Auftragsliste aus **einem** Ereignisstrom.
|
|
2938
|
+
*
|
|
2939
|
+
* `storeId` schneidet auf den Bestand dieses Hosts zu — dieselbe Bindung, an
|
|
2940
|
+
* der `claimAndRun()` eine fremde Uebernahme ablehnt. Ein Auftrag eines
|
|
2941
|
+
* anderen Bestands gehoert nicht in diese Liste: Er waere hier weder
|
|
2942
|
+
* ausfuehrbar noch auffindbar.
|
|
2943
|
+
*
|
|
2944
|
+
* Ein unbekannter `cursor` ist ein **Fehler** und kein leeres Ergebnis
|
|
2945
|
+
* (Regel 4): Er bedeutet, dass die Seite auf einem Stand aufsetzt, den es
|
|
2946
|
+
* nicht mehr gibt.
|
|
2947
|
+
*/
|
|
2948
|
+
declare function selectImageJobs(events: readonly ElementEvent[], storeId: string, query?: ImageJobQuery): ImageJobSeite;
|
|
2949
|
+
/** Das zuletzt gesicherte Bild des Bestands, mit seinem Nachweis (§5). */
|
|
2950
|
+
interface LetztesErzeugtesBild {
|
|
2951
|
+
/** Der Auftrag, aus dem dieser Batch stammt — `null` bei einem Batch ohne Auftrag. */
|
|
2952
|
+
job: ImageJob | null;
|
|
2953
|
+
prompt_run_id: string;
|
|
2954
|
+
item_id: string;
|
|
2955
|
+
generation_batch_id: string;
|
|
2956
|
+
/** Das **letzte** Bild dieses Batches — das zuletzt entstandene. */
|
|
2957
|
+
bild: PromptBatchImageRef;
|
|
2958
|
+
/** Seine Stelle im Batch, 1-basiert, und die Batchgroesse — „4 / 4". */
|
|
2959
|
+
position: number;
|
|
2960
|
+
anzahl: number;
|
|
2961
|
+
/** Der Zeitpunkt aus dem Ereignis, nicht aus einer lokalen Uhr. */
|
|
2962
|
+
gespeichert_am: string | null;
|
|
2963
|
+
/** Das Zielmodell des Auftrags, soweit es einen gibt. */
|
|
2964
|
+
execution_target_model_key: string | null;
|
|
2965
|
+
/** Die Herkunft des Laufs, in derselben Form wie in der Liste. */
|
|
2966
|
+
herkunft: ImageJobHerkunft | null;
|
|
2967
|
+
}
|
|
2968
|
+
/**
|
|
2969
|
+
* Das zuletzt gesicherte Bild dieses Bestands.
|
|
2970
|
+
*
|
|
2971
|
+
* **Bestimmt ueber die Ereignisreihenfolge**, nicht ueber Dateinamen oder
|
|
2972
|
+
* lokale Zeitstempel (§5.1): Das letzte `image_batch_persisted` im Log ist
|
|
2973
|
+
* das zuletzt gesicherte, auch wenn eine Hostuhr falsch geht.
|
|
2974
|
+
*
|
|
2975
|
+
* Der Zuschnitt auf den Bestand laeuft ueber die Auftraege: Ein Batch, dessen
|
|
2976
|
+
* `generation_batch_id` zu einem Auftrag dieses Bestands gehoert, zaehlt
|
|
2977
|
+
* sicher dazu. Ein Batch ohne Auftrag — etwa aus „Bilder erzeugen" im Lauf —
|
|
2978
|
+
* zaehlt ebenfalls, denn er steht im Log **dieses** Bestands; ein fremder
|
|
2979
|
+
* Bestand hat sein eigenes Log.
|
|
2980
|
+
*/
|
|
2981
|
+
declare function letztesErzeugtesBild(events: readonly ElementEvent[], storeId: string): LetztesErzeugtesBild | null;
|
|
2982
|
+
|
|
2945
2983
|
/**
|
|
2946
2984
|
* Was der Auftragskanal braucht.
|
|
2947
2985
|
*
|
|
@@ -2999,6 +3037,28 @@ interface SzenenImageJobPort {
|
|
|
2999
3037
|
listJobs(runId: string): Promise<QueryResult<readonly ImageJob[]>>;
|
|
3000
3038
|
/** Beansprucht einen wartenden Auftrag und fuehrt ihn als Gewinner aus. */
|
|
3001
3039
|
claimAndRun(jobId: string): Promise<ClaimAndRunResult>;
|
|
3040
|
+
/**
|
|
3041
|
+
* Die Auftraege des **Bestands**, unabhaengig vom Prompt-Lauf — Kette
|
|
3042
|
+
* `szenen-bildauftraege-arbeitsqueue`, §8.
|
|
3043
|
+
*
|
|
3044
|
+
* Sie entsteht aus **einem** Lesevorgang derselben autoritativen Projektion,
|
|
3045
|
+
* die `listJobs()` benutzt. Der Weg ueber alle Laeufe plus `listJobs(runId)`
|
|
3046
|
+
* je Lauf waere dieselbe Liste zum N+1-fachen Preis (§8 Regel 1) — und die
|
|
3047
|
+
* Auftraege stehen ohnehin im Log, nicht am Lauf.
|
|
3048
|
+
*
|
|
3049
|
+
* Optional wie jede Portoperation dieses Projekts: Ein Host ohne sie
|
|
3050
|
+
* bekommt den Arbeitsbereich nicht, statt einen leeren zu bekommen.
|
|
3051
|
+
*/
|
|
3052
|
+
listAllJobs?(query?: ImageJobQuery): Promise<QueryResult<ImageJobSeite>>;
|
|
3053
|
+
/**
|
|
3054
|
+
* Das zuletzt gesicherte Bild dieses Bestands — die Vorschau „Letztes
|
|
3055
|
+
* erzeugtes Bild" (§5).
|
|
3056
|
+
*
|
|
3057
|
+
* Bestimmt ueber die **Ereignisreihenfolge** des autoritativen Logs, nicht
|
|
3058
|
+
* ueber Dateinamen oder lokale Zeitstempel (§5.1). Erzwingt **keine** Kopie
|
|
3059
|
+
* in die Library: Gelesen wird der vorhandene Batch-Nachweis (§5.2).
|
|
3060
|
+
*/
|
|
3061
|
+
latestImage?(): Promise<QueryResult<LetztesErzeugtesBild | null>>;
|
|
3002
3062
|
}
|
|
3003
3063
|
interface CreateImageJobPortOptions {
|
|
3004
3064
|
channel: ImageJobChannel;
|
|
@@ -3196,6 +3256,48 @@ interface SzenenRunPort {
|
|
|
3196
3256
|
* Schnittstelle gebrochen.
|
|
3197
3257
|
*/
|
|
3198
3258
|
addManualSceneRun?(input: AddManualSceneRunInput): Promise<StartRunFromDraftResult>;
|
|
3259
|
+
/**
|
|
3260
|
+
* **Eine Seite** Laeufe, neueste zuerst — Kette `szenen-listen-pagination`.
|
|
3261
|
+
*
|
|
3262
|
+
* Sie ersetzt die vier Abfragen darueber nicht, sie schneidet sie: derselbe
|
|
3263
|
+
* Bestand, derselbe Bezugsrahmen (`selectPromptRuns`), dieselbe
|
|
3264
|
+
* Gruppierungsregel — nur nicht mehr alles auf einmal. Welcher Einstieg
|
|
3265
|
+
* gemeint ist, steht in `source`; damit gibt es **eine** seitenweise
|
|
3266
|
+
* Operation statt vier, und die Ansicht hat eine Ladefunktion statt vier.
|
|
3267
|
+
*
|
|
3268
|
+
* Die Rundennummern kommen mit (`PromptRunPage.rounds`). Ohne sie muesste die
|
|
3269
|
+
* Ansicht wieder den vollen Bestand lesen, um den Platz eines Laufs unter
|
|
3270
|
+
* seinen Geschwistern zu kennen (U23) — genau das, was der Seitenschnitt
|
|
3271
|
+
* vermeiden soll. Es entsteht keine zweite Zaehlung: gerechnet wird mit
|
|
3272
|
+
* derselben Regel, dort wo der volle Bestand ohnehin liegt.
|
|
3273
|
+
*
|
|
3274
|
+
* Optional wie `listAllRuns`, und aus demselben Grund: Ein Pflichtmitglied
|
|
3275
|
+
* haette jeden bestehenden Implementierer der oeffentlichen Schnittstelle
|
|
3276
|
+
* gebrochen. Fehlt die Operation, meldet `capabilitiesOf()`
|
|
3277
|
+
* `pagedRuns: false`, und die Ansicht laedt wie bisher vollstaendig — sie
|
|
3278
|
+
* zeigt keinen „Mehr laden"-Knopf, den niemand bedienen koennte.
|
|
3279
|
+
*/
|
|
3280
|
+
listRunsPage?(input: PromptRunPageInput): Promise<QueryResult<PromptRunPage>>;
|
|
3281
|
+
/**
|
|
3282
|
+
* Setzt die **direkten** Tags eines Laufs — Kette
|
|
3283
|
+
* `szenen-prompt-anzeige-bilder-tags`.
|
|
3284
|
+
*
|
|
3285
|
+
* Uebergeben wird der vollstaendige Satz an Labels, nicht ein Delta:
|
|
3286
|
+
* Entfernen ist ein kuerzerer Satz. Aufgeloest werden die Labels gegen die
|
|
3287
|
+
* bestehende Library-Vokabel (`resolveTagLabels`) — ein unbekanntes Label
|
|
3288
|
+
* wird abgelehnt und nicht nebenbei angelegt, genau wie im Library-Weg.
|
|
3289
|
+
*
|
|
3290
|
+
* Beruehrt **ausschliesslich** die Prompt-Tags. Die Tags zugeordneter
|
|
3291
|
+
* Library-Items sind abgeleitet und liegen an ihren Items; dieser Aufruf
|
|
3292
|
+
* kann sie weder schreiben noch loeschen, und das ist die Zusage, wegen der
|
|
3293
|
+
* die Anzeige beide Herkuenfte mischen darf.
|
|
3294
|
+
*
|
|
3295
|
+
* Optional wie `listRunsPage`: Ein Host ohne autoritativen Schreibweg
|
|
3296
|
+
* bekommt die Operation nicht, `capabilitiesOf()` meldet `runTags: false`,
|
|
3297
|
+
* und die Ansicht zeigt die Tags dann nur an, statt einen Editor
|
|
3298
|
+
* anzubieten, der nichts ablegen kann (§8).
|
|
3299
|
+
*/
|
|
3300
|
+
setRunTags?(runId: string, labels: readonly string[]): Promise<CommandResult<readonly LibraryTagRef[]>>;
|
|
3199
3301
|
}
|
|
3200
3302
|
interface StartRunFromSceneInput {
|
|
3201
3303
|
/** Das Szenen-**Element**. Ob Entwurf oder Version gilt, entscheidet der Bestand. */
|
|
@@ -3719,6 +3821,10 @@ interface PromptImageBatch {
|
|
|
3719
3821
|
* heute nicht — der reguläre `unsupported`-Fall, keine Zeile Sondercode
|
|
3720
3822
|
* (D-115-Analogie: keine Host-Verzweigung im gemeinsamen Code).
|
|
3721
3823
|
*/
|
|
3824
|
+
/** Die bestehende Library-Tag-Vokabel, nur lesend. */
|
|
3825
|
+
interface SzenenTagVocabularyPort {
|
|
3826
|
+
listTags(): Promise<QueryResult<readonly LibraryTagRef[]>>;
|
|
3827
|
+
}
|
|
3722
3828
|
interface SzenenImageBatchHistoryPort {
|
|
3723
3829
|
/** Alle Batches eines Prompt-Laufs — gesucht über IDs, nicht über Titel/Zeit (D-109). */
|
|
3724
3830
|
listBatchesForPromptRun(runId: string): Promise<QueryResult<readonly PromptImageBatch[]>>;
|
|
@@ -3866,6 +3972,17 @@ interface SzenenViewPort {
|
|
|
3866
3972
|
* Ereignislog. Flow liefert sie deshalb unabhängig von Bildprovider und
|
|
3867
3973
|
* Batch-Schreibweg — React liefert sie zusätzlich über MySQL als Index.
|
|
3868
3974
|
*/
|
|
3975
|
+
/**
|
|
3976
|
+
* Die Tag-Vokabel des Hosts — Kette `szenen-prompt-anzeige-bilder-tags`.
|
|
3977
|
+
*
|
|
3978
|
+
* Sie existiert nur, damit der Tag-Editor **vorschlagen** kann, was es
|
|
3979
|
+
* bereits gibt. Geprueft wird trotzdem beim Schreiben, und zwar dort, wo die
|
|
3980
|
+
* Vokabel liegt: Eine Vorschlagsliste im Browser ist keine Zusage.
|
|
3981
|
+
*
|
|
3982
|
+
* Optional wie alles hier: Ein Host ohne sie zeigt ein Freitextfeld, und ein
|
|
3983
|
+
* unbekanntes Label wird beim Speichern mit Namen abgelehnt (Regel 11).
|
|
3984
|
+
*/
|
|
3985
|
+
tags?: SzenenTagVocabularyPort;
|
|
3869
3986
|
imageBatchHistory?: SzenenImageBatchHistoryPort;
|
|
3870
3987
|
/**
|
|
3871
3988
|
* Bild-Batch-Schreiben — fehlt ohne sicheren, hostübergreifenden
|
|
@@ -3921,10 +4038,28 @@ interface SzenenViewCapabilities {
|
|
|
3921
4038
|
imageGeneration: boolean;
|
|
3922
4039
|
/** Bildauftraege aus dem Chat uebernehmen (Kette szenen-mcp-chatgpt-flow). */
|
|
3923
4040
|
imageJobs: boolean;
|
|
4041
|
+
/**
|
|
4042
|
+
* Die bestandsweite Auftragsqueue — Bereich `Bildauftraege` (Kette
|
|
4043
|
+
* `szenen-bildauftraege-arbeitsqueue`).
|
|
4044
|
+
*
|
|
4045
|
+
* Getrennt von `imageJobs`: Ein Host kann Auftraege eines Laufs lesen und
|
|
4046
|
+
* uebernehmen, ohne die globale Projektion zu liefern. Dann bleibt die
|
|
4047
|
+
* bestehende Laufansicht vollstaendig und nur der Arbeitsbereich fehlt —
|
|
4048
|
+
* statt leer dazustehen (§2).
|
|
4049
|
+
*/
|
|
4050
|
+
imageJobQueue: boolean;
|
|
3924
4051
|
/** Die herkunftsuebergreifende Prompt-Sicht (P1-A) — Bereich `Prompts`. */
|
|
3925
4052
|
promptOverview: boolean;
|
|
3926
4053
|
/** „Promptlauf manuell hinzufuegen" — Kette szenen-manuell-angepasste-promptlaeufe. */
|
|
3927
4054
|
manualPromptRun: boolean;
|
|
4055
|
+
/** Seitenweises Laden der Laufliste (Kette szenen-listen-pagination). */
|
|
4056
|
+
pagedRuns: boolean;
|
|
4057
|
+
/** Seitenweises Laden der Elementliste (Kette szenen-listen-pagination). */
|
|
4058
|
+
pagedElements: boolean;
|
|
4059
|
+
/** Prompt-Tags bearbeiten (Kette szenen-prompt-anzeige-bilder-tags). */
|
|
4060
|
+
runTags: boolean;
|
|
4061
|
+
/** Vorschlagsliste aus der bestehenden Library-Tag-Vokabel. */
|
|
4062
|
+
tagVocabulary: boolean;
|
|
3928
4063
|
}
|
|
3929
4064
|
declare function capabilitiesOf(port: SzenenViewPort): SzenenViewCapabilities;
|
|
3930
4065
|
/**
|
|
@@ -4198,9 +4333,35 @@ type BuildManualPromptRunResult = {
|
|
|
4198
4333
|
*/
|
|
4199
4334
|
declare function buildManualPromptRunRecord(eingabe: BuildManualPromptRunInput): BuildManualPromptRunResult;
|
|
4200
4335
|
/** Der Handeingabe-Block eines Laufs, oder `null` bei jedem anderen Lauf. */
|
|
4201
|
-
declare function manualEntryOf(run:
|
|
4336
|
+
declare function manualEntryOf(run: PromptRunPageRecord): ManualPromptEntry | null;
|
|
4202
4337
|
|
|
4203
4338
|
interface CreateMemoryViewPortOptions {
|
|
4339
|
+
/**
|
|
4340
|
+
* Die **direkten** Tags je Lauf — Kette `szenen-prompt-anzeige-bilder-tags`.
|
|
4341
|
+
*
|
|
4342
|
+
* Der Speicherhost fuehrt sie als Zustand und laesst sie auch schreiben:
|
|
4343
|
+
* Anders als der Ereignislog-Weg braucht er dafuer keine Vokabel-Tabelle,
|
|
4344
|
+
* und ein Editor, der im Test nichts ablegen kann, prueft nichts.
|
|
4345
|
+
*/
|
|
4346
|
+
runTags?: Record<string, readonly string[]>;
|
|
4347
|
+
/**
|
|
4348
|
+
* Bildanzahl, Vorschau und Library-Tags je Lauf.
|
|
4349
|
+
*
|
|
4350
|
+
* Vorbelegt statt aus Ereignissen gefaltet: Dieser Port haelt Laeufe als
|
|
4351
|
+
* Liste, nicht als Log. Die Faltung selbst prueft
|
|
4352
|
+
* `promptKarte.test.ts` gegen `annotateRunsFromEvents`.
|
|
4353
|
+
*/
|
|
4354
|
+
runAnnotations?: Record<string, PromptRunAnnotation>;
|
|
4355
|
+
/** Die Vorschlagsliste des Tag-Editors. Fehlt sie, bietet der Port keine an. */
|
|
4356
|
+
tagVocabulary?: readonly string[];
|
|
4357
|
+
/**
|
|
4358
|
+
* Bildanzahl, Deckbild und Tags je **Element**.
|
|
4359
|
+
*
|
|
4360
|
+
* Vorbelegt wie `runAnnotations` und aus demselben Grund: Dieser Port haelt
|
|
4361
|
+
* keinen Laufbestand, aus dem sich die Ableitung falten liesse. Die Faltung
|
|
4362
|
+
* selbst prueft `promptKarte.test.ts` gegen `annotateElementsFromEvents`.
|
|
4363
|
+
*/
|
|
4364
|
+
elementAnnotations?: Record<string, ElementAnnotation>;
|
|
4204
4365
|
/**
|
|
4205
4366
|
* Ob der Port Items anbietet. `false` bildet Flow-Pure nach: das Feld fehlt
|
|
4206
4367
|
* dann ganz, statt eine Operation zu haben, die `unsupported` zurückgibt.
|
|
@@ -4478,6 +4639,30 @@ interface PromptRunPersistencePort {
|
|
|
4478
4639
|
* leeren Bereich zu zeigen (§8).
|
|
4479
4640
|
*/
|
|
4480
4641
|
listAll?(): Promise<QueryResult<readonly PromptRunRecord[]>>;
|
|
4642
|
+
/**
|
|
4643
|
+
* **Eine Seite** Laeufe — Kette `szenen-listen-pagination`.
|
|
4644
|
+
*
|
|
4645
|
+
* Optional, und zwar mit einer klaren Aufgabenteilung: Eine Persistenz, die
|
|
4646
|
+
* ihren Bestand **ohne Transport** faltet (der Ereignislog in Flow), braucht
|
|
4647
|
+
* sie nicht — dort schneidet der Port selbst, und das Ergebnis ist
|
|
4648
|
+
* identisch. Eine Persistenz **hinter einer Leitung** (REST) braucht sie,
|
|
4649
|
+
* denn dort ist die Uebertragungsmenge genau das Problem: Nachtraeglich im
|
|
4650
|
+
* Browser zu schneiden hiesse, vorher alles geholt zu haben.
|
|
4651
|
+
*/
|
|
4652
|
+
listPage?(input: PromptRunPageInput): Promise<QueryResult<PromptRunPage>>;
|
|
4653
|
+
/**
|
|
4654
|
+
* Setzt die direkten Tags eines Laufs — Kette
|
|
4655
|
+
* `szenen-prompt-anzeige-bilder-tags`.
|
|
4656
|
+
*
|
|
4657
|
+
* Optional, und zwar nicht aus Bequemlichkeit: Ein Prompt-Tag ist eine
|
|
4658
|
+
* **Library-Vokabel**, und die steht in `tags` (MySQL). Eine Persistenz ohne
|
|
4659
|
+
* Zugang zu dieser Vokabel koennte ein Label nicht pruefen — sie muesste es
|
|
4660
|
+
* entweder nebenbei anlegen (was der Library-Weg ausdruecklich nicht tut)
|
|
4661
|
+
* oder ungeprueft anhaengen. Beides waere ein zweites Tag-System. Deshalb
|
|
4662
|
+
* bietet nur die REST-Persistenz diese Operation an; der Ereignislog-Weg
|
|
4663
|
+
* zeigt Tags an, ohne sie schreiben zu koennen (§8).
|
|
4664
|
+
*/
|
|
4665
|
+
setTags?(runId: string, labels: readonly string[]): Promise<CommandResult<readonly LibraryTagRef[]>>;
|
|
4481
4666
|
}
|
|
4482
4667
|
/** Was der Eventlog-Adapter vom Kanal braucht — lesen und anhängen. */
|
|
4483
4668
|
interface RunEventChannel {
|
|
@@ -4925,6 +5110,89 @@ declare function runOfOperation(runs: readonly PromptRunRecord[], operationId: s
|
|
|
4925
5110
|
/** Ob eine eingereichte Antwort woertlich die des bereits gespeicherten Laufs ist. */
|
|
4926
5111
|
declare function sameResponseAs(run: PromptRunRecord, response: string): boolean;
|
|
4927
5112
|
|
|
5113
|
+
/** Die waehlbaren Pausen zwischen zwei Auftraegen, in Sekunden (§4). */
|
|
5114
|
+
declare const PAUSE_SEKUNDEN_OPTIONEN: readonly number[];
|
|
5115
|
+
/** Die Vorgabe, wenn der Nutzer nichts waehlt (§4). */
|
|
5116
|
+
declare const PAUSE_SEKUNDEN_VORGABE = 3;
|
|
5117
|
+
/** Ob ein Wert eine angebotene Pause ist — die Liste ist die Wahrheit. */
|
|
5118
|
+
declare function istGueltigePause(sekunden: number): boolean;
|
|
5119
|
+
/** Wie ein einzelner Auftrag des Snapshots ausgegangen ist. */
|
|
5120
|
+
type QueueAusgang =
|
|
5121
|
+
/** Uebernommen und bis zu einem sicheren Ausgang ausgefuehrt. */
|
|
5122
|
+
{
|
|
5123
|
+
kind: 'ausgefuehrt';
|
|
5124
|
+
jobId: string;
|
|
5125
|
+
status: ImageJob['status'];
|
|
5126
|
+
text: string;
|
|
5127
|
+
}
|
|
5128
|
+
/**
|
|
5129
|
+
* Nicht mehr offen — ein anderer Host hatte ihn, oder er wurde fachlich
|
|
5130
|
+
* abgelehnt. **Nichts wurde bezahlt**, und die Queue laeuft weiter (§4.3).
|
|
5131
|
+
*/
|
|
5132
|
+
| {
|
|
5133
|
+
kind: 'uebersprungen';
|
|
5134
|
+
jobId: string;
|
|
5135
|
+
text: string;
|
|
5136
|
+
}
|
|
5137
|
+
/**
|
|
5138
|
+
* Der Ausgang steht **nicht** sicher fest. Die Queue haelt an, damit sie
|
|
5139
|
+
* nicht neben einem moeglicherweise laufenden Providerjob einen zweiten
|
|
5140
|
+
* startet (§4.3, letzter Punkt).
|
|
5141
|
+
*/
|
|
5142
|
+
| {
|
|
5143
|
+
kind: 'unbekannt';
|
|
5144
|
+
jobId: string;
|
|
5145
|
+
text: string;
|
|
5146
|
+
};
|
|
5147
|
+
type QueueZustand =
|
|
5148
|
+
/** Ein Auftrag laeuft gerade. */
|
|
5149
|
+
'laeuft'
|
|
5150
|
+
/** Zwischen zwei Auftraegen — die eingestellte Pause laeuft. */
|
|
5151
|
+
| 'pause'
|
|
5152
|
+
/** Der Snapshot ist vollstaendig abgearbeitet. */
|
|
5153
|
+
| 'fertig'
|
|
5154
|
+
/** Der Nutzer hat abgebrochen; der zuletzt gestartete Auftrag lief zu Ende. */
|
|
5155
|
+
| 'abgebrochen'
|
|
5156
|
+
/** Angehalten wegen unsicherem Ausgang (§4.3). */
|
|
5157
|
+
| 'gestoppt';
|
|
5158
|
+
interface QueueFortschritt {
|
|
5159
|
+
/** Die Kennungen dieses Laufs, in Startreihenfolge — fest ab dem Klick. */
|
|
5160
|
+
snapshot: readonly string[];
|
|
5161
|
+
/** „Job n von m": 1-basiert, `0` solange noch keiner gestartet wurde. */
|
|
5162
|
+
nummer: number;
|
|
5163
|
+
/** Der gerade bearbeitete Auftrag, oder `null` zwischen zwei Auftraegen. */
|
|
5164
|
+
aktuell: string | null;
|
|
5165
|
+
zustand: QueueZustand;
|
|
5166
|
+
/** Der letzte sicher bekannte Ausgang (§4.2). */
|
|
5167
|
+
letzterAusgang: QueueAusgang | null;
|
|
5168
|
+
/** Warum die Queue angehalten hat — gesetzt bei `gestoppt` und `abgebrochen`. */
|
|
5169
|
+
grund: string | null;
|
|
5170
|
+
/** Die eingestellte Pause, damit die Laufanzeige sie nennen kann (§4.2). */
|
|
5171
|
+
pauseSekunden: number;
|
|
5172
|
+
}
|
|
5173
|
+
interface QueueLaufOptionen {
|
|
5174
|
+
/** Die beim Klick offenen Auftraege, aelteste zuerst (§4.1). */
|
|
5175
|
+
snapshot: readonly string[];
|
|
5176
|
+
pauseSekunden: number;
|
|
5177
|
+
/** Der **eine** Ausfuehrungsweg — derselbe wie beim Einzelstart. */
|
|
5178
|
+
claimAndRun: (jobId: string) => Promise<ClaimAndRunResult>;
|
|
5179
|
+
/** Warten. Einspeisbar, damit ein Test nicht zehn Sekunden schlaeft. */
|
|
5180
|
+
warte: (ms: number) => Promise<void>;
|
|
5181
|
+
/** Jeder Zustandswechsel, fuer die Laufanzeige. */
|
|
5182
|
+
melde: (fortschritt: QueueFortschritt) => void;
|
|
5183
|
+
/** Ob der Nutzer inzwischen abgebrochen hat — vor jedem Start gefragt. */
|
|
5184
|
+
abgebrochen: () => boolean;
|
|
5185
|
+
}
|
|
5186
|
+
/**
|
|
5187
|
+
* Arbeitet den Snapshot streng seriell ab.
|
|
5188
|
+
*
|
|
5189
|
+
* Der Rueckgabewert ist der Endstand; jeder Zwischenstand kam vorher ueber
|
|
5190
|
+
* `melde()`. Die Funktion wirft nicht: Ein geworfener Fehler aus
|
|
5191
|
+
* `claimAndRun()` ist genau der unsichere Ausgang, wegen dem angehalten wird,
|
|
5192
|
+
* und er gehoert in den Fortschritt, nicht in einen Stacktrace.
|
|
5193
|
+
*/
|
|
5194
|
+
declare function fuehreQueueAus(optionen: QueueLaufOptionen): Promise<QueueFortschritt>;
|
|
5195
|
+
|
|
4928
5196
|
interface CreateHfImageBatchPersistenceOptions {
|
|
4929
5197
|
namespace: string;
|
|
4930
5198
|
token: string;
|
|
@@ -5031,7 +5299,7 @@ declare function istZipDatei(datei: {
|
|
|
5031
5299
|
*/
|
|
5032
5300
|
declare function leseBilderAusZip(datei: File | Blob): Promise<readonly ZipBild[]>;
|
|
5033
5301
|
|
|
5034
|
-
type SzenenAreaId = 'scene' | 'prompts' | 'elements' | 'advanced' | 'media';
|
|
5302
|
+
type SzenenAreaId = 'scene' | 'prompts' | 'imageJobs' | 'elements' | 'advanced' | 'media';
|
|
5035
5303
|
interface SzenenArea {
|
|
5036
5304
|
id: SzenenAreaId;
|
|
5037
5305
|
title: string;
|
|
@@ -5083,7 +5351,36 @@ interface SzenenViewProps {
|
|
|
5083
5351
|
initialArea?: SzenenAreaId;
|
|
5084
5352
|
/** Meldet Bereichswechsel nach außen, damit der Host sie merken kann. */
|
|
5085
5353
|
onAreaChange?: (area: SzenenAreaId) => void;
|
|
5354
|
+
/**
|
|
5355
|
+
* Ein von außen angesteuertes Ziel — der Einstieg aus der Library
|
|
5356
|
+
* („Promptlauf öffnen" / „Szene öffnen").
|
|
5357
|
+
*
|
|
5358
|
+
* Es gibt dafür **kein** zweites Routing: Der Fokus wählt den vorhandenen
|
|
5359
|
+
* Bereich und reicht die Kennung an die vorhandene Liste weiter, die ihn
|
|
5360
|
+
* wie jede andere Auswahl behandelt.
|
|
5361
|
+
*/
|
|
5362
|
+
fokus?: SzenenFokus | null;
|
|
5363
|
+
/** Zurück dorthin, woher der Fokus kam. Fehlt, wenn es kein Zurück gibt. */
|
|
5364
|
+
onFokusVerlassen?: () => void;
|
|
5086
5365
|
}
|
|
5366
|
+
/** Das angesteuerte Ziel. Genau eines — nie beides und nie geraten. */
|
|
5367
|
+
type SzenenFokus = {
|
|
5368
|
+
kind: 'run';
|
|
5369
|
+
runId: string;
|
|
5370
|
+
} | {
|
|
5371
|
+
kind: 'scene';
|
|
5372
|
+
elementId: string;
|
|
5373
|
+
/**
|
|
5374
|
+
* Der Lauf, aus dem der Sprung kam — optional.
|
|
5375
|
+
*
|
|
5376
|
+
* Er macht das Ziel nicht mehrdeutig: Angesteuert ist die Szene. Er
|
|
5377
|
+
* sagt nur, welche Runde ihrer Historie gemeint ist, damit dort nicht
|
|
5378
|
+
* die neueste aufgeht und wie die Antwort auf den Sprung aussieht.
|
|
5379
|
+
*/
|
|
5380
|
+
runId?: string | null;
|
|
5381
|
+
};
|
|
5382
|
+
/** Der Bereich, in dem ein Fokusziel zu Hause ist. */
|
|
5383
|
+
declare function areaForFokus(fokus: SzenenFokus): SzenenAreaId;
|
|
5087
5384
|
declare const SzenenView: React__default.FC<SzenenViewProps>;
|
|
5088
5385
|
|
|
5089
|
-
export { type AddManualSceneRunInput, type AttachLibraryItemInput, type AttachLibraryItemResult, AuthoritativeSzenenStore, type BestandsGalerieEintrag, type BestandsItem, type BuildManualPromptRunInput, CATALOGUE_TYPES, 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,
|
|
5386
|
+
export { type AddManualSceneRunInput, type AttachLibraryItemInput, type AttachLibraryItemResult, AuthoritativeSzenenStore, type BestandsGalerieEintrag, type BestandsItem, type BuildManualPromptRunInput, CATALOGUE_TYPES, 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, 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 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, 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 RendererInput, type ResolveFailure, type ResolveResult, type ResolveScenePayloadInput, type ResolveShotInput, type ResolveShotPayloadInput, ResolveTechnicalError, type ResolvedCamera, type ResolvedNode, type ResolvedPlacement, type ResolvedScenePolicy, type RunEventChannel, type RunFailure, type RunFailureClass, type RunItemReference, 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 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 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, buildManualPromptRunRecord, buildSystemInstruction, buildSzenenSnapshot, buildUserPrompt, callOptional, capabilitiesOf, capabilityGate, capabilityReport, catalogueFor, 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, executableImageModels, findExecutableImageModel, findImageBatch, findImageGenerationOrder, findImageJob, findPromptOperation, findPromptRun, findProviderCheck, findSceneDerivation, findSceneDerivationRecovery, firstError, formatSeedListe, freezeDraftChain, freezeSceneWorkingState, 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, preparePromptOperation, promptDiagnosticsOf, promptRunPageForTransport, promptRunPageFromTransport, publishedHeadsOf, recoveriesForRun, recoveryStatusOf, resolveArea, resolveGeneralScenePolicies, resolveScenePayload, resolveShot, resolveShotPayload, responseContractOf, roundOfRun, roundsOf, rulesWithoutPromptEffect, runOfOperation, runPromptDerivation, runStoreDifferential, sameResponseAs, sceneOnlyCapabilities, scenePolicyFingerprint, scopeOfPath, seedFehlerText, selectImageJobs, selectPromptRuns, selectableTargetModels, siblingsOf, sortScenePolicies, sourceOf, szenenSnapshotFilename, totalModelCalls, typAusBytes, unclassifiedPublishRules, unsupportedReason };
|