@rslsp1/fa-app-tools 3.0.0 → 5.0.0

package/dist/szenen.mjs

@@ -9,6 +9,7 @@ import {
   FLOW_EXECUTION_PATH,
   MAX_PROPOSAL_TITLE_LENGTH,
   PROBE_VERSION_ID,
+  PROMPT_RULE_EFFECT,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
@@ -42,6 +43,7 @@ import {
   checkDraftChainMeta,
   checkElementType,
   checkImageExecutionProfile,
+  checkImageExecutionProfiles,
   checkImageModelParameters,
   checkOptionalId,
   checkParents,
@@ -83,7 +85,10 @@ import {
   derivationPoliciesOf,
   deriveItemFromRun,
   deriveLineage,
+  describableContent,
   describeTargetModelFailure,
+  diagnosticOfFinding,
+  diagnosticOfSchemaError,
   draftRevisionOf,
   executableImageModels,
   findExecutableImageModel,
@@ -95,14 +100,18 @@ import {
   firstError,
   formatSchemaErrors,
   freezeDraftChain,
+  freezeSceneWorkingState,
   getSzenenSchemas,
+  gruppiereZuItems,
   hasPlacementCapability,
   isKnownElementType,
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
   itemIdForRun,
+  ladeVorschauen,
   linkFor,
+  locatorTeile,
   logRevisionOf,
   mergeSzenenBatchOrigin,
   noticeFor,
@@ -110,19 +119,23 @@ import {
   parseDerivationResponse,
   parseRunResponse,
   preferredHeadRevisionOf,
+  promptDiagnosticsOf,
   publishedHeadsOf,
   recoveriesForRun,
   recoveryStatusOf,
   reduceElementEvents,
   resolveArea,
+  resolveScenePayload,
   resolveShot,
   resolveShotPayload,
   resolveTargetModelOver,
   resolverFromQueries,
   roundOfRun,
+  rulesWithoutPromptEffect,
   runPromptDerivation,
   runPublishChecks,
   runSceneDerivation,
+  sceneOnlyCapabilities,
   scopeOfPath,
   selectableTargetModels,
   showChain,
@@ -135,7 +148,7 @@ import {
   validateElementVersion,
   validatePayload,
   withReference
-} from "./chunk-TCJ3CMCK.mjs";
+} from "./chunk-TW4IDHAN.mjs";
 import {
   ContractViolation,
   STYLE_PAYLOAD,
@@ -392,7 +405,7 @@ async function runStoreDifferential(left, right) {
 // src/lib/szenen/memoryViewPort.ts
 var MEMORY_IMAGE_CAPABILITY = {
   environment_id: "memory",
-  execution_paths: ["memory"]
+  execution_paths: [{ execution_path: "memory", provider: "google" }]
 };
 function ok(value) {
   return { kind: "ok", value };
@@ -519,6 +532,44 @@ function createMemoryViewPort(options = {}) {
       return ok(laeufe.filter(
         (r) => r.source?.kind === "draft_chain" && r.source.chain_id === chainId
       ));
+    },
+    // ── Der Lauf direkt aus einer Szene (D-135) ───────────────────────────
+    //
+    // Wie beim Kettenlauf bildet der Speicherport nur die **Form** ab: ein
+    // Lauf mit `source.kind === 'scene_direct'`, ohne Shot und ohne
+    // Versionskennungen. Ob ein Arbeitsstand einfrierbar ist, entscheidet
+    // `clientRunPort` gegen einen echten Speicher — hier waere es eine zweite
+    // Wahrheit.
+    async startRunFromScene(input) {
+      const runId = ids();
+      const basis = (options.deriveRun ?? simulierterLauf)(
+        { shotVersionId: "", ...input.userInstruction ? { userInstruction: input.userInstruction } : {} },
+        runId
+      );
+      const lauf = {
+        ...basis,
+        shot_version_id: "",
+        shot_element_id: "",
+        scene_setup_version_id: "",
+        camera_id: "",
+        target_model_version_id: "",
+        source: {
+          kind: "scene_direct",
+          scene: {
+            element_id: input.sceneElementId,
+            draft_id: `draft-${input.sceneElementId}`,
+            revision: 1,
+            version_id: null
+          }
+        }
+      };
+      laeufe.push(lauf);
+      return done(lauf);
+    },
+    async listRunsForScene(sceneElementId) {
+      return ok(laeufe.filter(
+        (r) => r.source?.kind === "scene_direct" && r.source.scene.element_id === sceneElementId
+      ));
     }
   };
   const itemPort = {
@@ -701,15 +752,26 @@ function createMemoryViewPort(options = {}) {
     }
   };
   const bilder = /* @__PURE__ */ new Map();
+  const werke = [];
   for (const bild of options.images ?? []) {
     bilder.set(bild.mediaRef, { bild, data: "AAAA" });
+    werke.push({ itemRef: bild.mediaRef, title: bild.title, images: [bild] });
+  }
+  for (const werk of options.imageItems ?? []) {
+    for (const bild of werk.images) bilder.set(bild.mediaRef, { bild, data: "AAAA" });
+    werke.push(werk);
   }
+  const vorschauLazy = options.imagePreviewLazy === true;
   const imageLibraryPort = {
-    async listImages(query) {
-      const alle = [...bilder.values()].map((e) => e.bild);
+    async listItems(query) {
       const gesucht = query?.search?.trim().toLowerCase();
-      const gefiltert = gesucht ? alle.filter((b) => b.title.toLowerCase().includes(gesucht)) : alle;
-      return ok(query?.limit ? gefiltert.slice(0, query.limit) : gefiltert);
+      const gefiltert = gesucht ? werke.filter((w) => w.title.toLowerCase().includes(gesucht)) : werke;
+      const sichtbar = query?.limit ? gefiltert.slice(0, query.limit) : gefiltert;
+      if (!vorschauLazy) return ok(sichtbar);
+      return ok(sichtbar.map((w) => ({
+        ...w,
+        images: w.images.map((b) => ({ ...b, thumbUrl: null }))
+      })));
     },
     async resolveImage(mediaRef) {
       const eintrag = bilder.get(mediaRef);
@@ -727,9 +789,19 @@ function createMemoryViewPort(options = {}) {
         thumbUrl: null
       };
       bilder.set(mediaRef, { bild, data: input.data });
+      werke.unshift({ itemRef: mediaRef, title: bild.title, images: [bild] });
       return done(bild);
     }
   };
+  if (vorschauLazy) {
+    imageLibraryPort.loadPreview = async (mediaRef) => {
+      const eintrag = bilder.get(mediaRef);
+      if (!eintrag) {
+        return { kind: "error", message: `Bild ${mediaRef} ist unbekannt.`, retryable: false };
+      }
+      return ok(`data:${eintrag.bild.mimeType};base64,${eintrag.data}`);
+    };
+  }
   const batches = [...options.batches ?? []];
   const imageGenerationEvents = createInMemoryEventChannel();
   const imageBatchHistoryPort = {
@@ -996,41 +1068,83 @@ var FAILURE_CLASSES = [
 ];
 var PFLICHTFELDER = [
   "run_id",
-  "shot_version_id",
-  "shot_element_id",
-  "scene_setup_version_id",
-  "camera_id",
-  "target_model_version_id",
   "provider",
   "model_id",
   "system_prompt",
   "created_at"
 ];
+var TEXTFELDER = [
+  "shot_version_id",
+  "shot_element_id",
+  "scene_setup_version_id",
+  "camera_id",
+  "target_model_version_id"
+];
+var PFLICHT_JE_HERKUNFT = {
+  published: ["shot_version_id", "shot_element_id", "scene_setup_version_id"],
+  draft_chain: ["shot_element_id"],
+  scene_direct: []
+};
+var VERBOTEN_JE_HERKUNFT = {
+  published: [],
+  draft_chain: ["shot_version_id", "scene_setup_version_id"],
+  scene_direct: ["shot_version_id", "shot_element_id", "scene_setup_version_id", "camera_id"]
+};
 function istText(wert) {
   return typeof wert === "string" && wert.trim().length > 0;
 }
 function isObject(wert) {
   return typeof wert === "object" && wert !== null && !Array.isArray(wert);
 }
-var VERSIONSFELDER = ["shot_version_id", "scene_setup_version_id"];
 var KETTEN_TYPEN = ["scene", "scene_setup", "shot"];
+var HERKUENFTE = ["published", "draft_chain", "scene_direct"];
 function pruefeLaufherkunft(quelle) {
   if (!isObject(quelle)) {
     return { ok: false, message: '"source" muss ein Objekt sein.' };
   }
+  if (!HERKUENFTE.includes(quelle.kind)) {
+    return {
+      ok: false,
+      message: `"source.kind" ist unbekannt: ${JSON.stringify(quelle.kind)}. Erlaubt: ${HERKUENFTE.join(", ")}.`
+    };
+  }
   if (quelle.kind === "published") {
-    for (const feld of VERSIONSFELDER) {
+    for (const feld of ["shot_version_id", "scene_setup_version_id"]) {
       if (!istText(quelle[feld])) {
         return { ok: false, message: `"source.${feld}" fehlt oder ist leer.` };
       }
     }
     return { ok: true };
   }
-  if (quelle.kind !== "draft_chain") {
-    return {
-      ok: false,
-      message: `"source.kind" ist unbekannt: ${JSON.stringify(quelle.kind)}. Erlaubt: published, draft_chain.`
-    };
+  if (quelle.kind === "scene_direct") {
+    const szene = quelle.scene;
+    if (!isObject(szene)) {
+      return { ok: false, message: '"source.scene" muss ein Objekt sein.' };
+    }
+    if (!istText(szene.element_id)) {
+      return { ok: false, message: '"source.scene.element_id" fehlt oder ist leer.' };
+    }
+    const ausEntwurf = istText(szene.draft_id);
+    const ausVersion = istText(szene.version_id);
+    if (ausEntwurf === ausVersion) {
+      return {
+        ok: false,
+        message: ausEntwurf ? '"source.scene" nennt draft_id und version_id zugleich. Eingefroren wurde genau ein Stand (D-135).' : '"source.scene" nennt weder draft_id noch version_id. Ohne den eingefrorenen Stand ist der Lauf nicht nachvollziehbar (D-97).'
+      };
+    }
+    if (ausEntwurf && (typeof szene.revision !== "number" || !Number.isInteger(szene.revision))) {
+      return {
+        ok: false,
+        message: '"source.scene.revision" muss eine ganze Zahl sein \u2014 ohne sie ist der eingefrorene Entwurfsstand nicht benennbar (D-97).'
+      };
+    }
+    if (ausVersion && szene.revision !== null && szene.revision !== void 0) {
+      return {
+        ok: false,
+        message: '"source.scene.revision" ist bei einer veroeffentlichten Version gesetzt. Eine Version ist unveraenderlich und hat keine Revision (D-02).'
+      };
+    }
+    return { ok: true };
   }
   if (!istText(quelle.chain_id)) {
     return { ok: false, message: '"source.chain_id" fehlt oder ist leer.' };
@@ -1081,25 +1195,38 @@ function checkPromptRunRecord(candidate) {
   }
   const record = candidate;
   const quelle = record.source;
-  const ausKette = isObject(quelle) && quelle.kind === "draft_chain";
   if (quelle !== void 0) {
     const urteil2 = pruefeLaufherkunft(quelle);
     if (!urteil2.ok) return urteil2;
   }
-  const pflicht = ausKette ? PFLICHTFELDER.filter((f) => !VERSIONSFELDER.includes(f)) : PFLICHTFELDER;
-  for (const feld of pflicht) {
+  const herkunft = isObject(quelle) && typeof quelle.kind === "string" ? quelle.kind : "published";
+  for (const feld of PFLICHTFELDER) {
     if (!istText(record[feld])) {
       return { ok: false, message: `"${feld}" fehlt oder ist leer.` };
     }
   }
-  if (ausKette) {
-    for (const feld of VERSIONSFELDER) {
-      if (istText(record[feld])) {
-        return {
-          ok: false,
-          message: `"${feld}" ist bei einem Lauf aus einer Draft-Kette gesetzt. Dort gibt es keine Versionen, und erfundene sind unzulaessig (D-98).`
-        };
-      }
+  for (const feld of TEXTFELDER) {
+    if (typeof record[feld] !== "string") {
+      return {
+        ok: false,
+        message: `"${feld}" fehlt. Wo es keinen Wert gibt, gehoert eine leere Zeichenkette hin \u2014 kein fehlendes Feld (D-135).`
+      };
+    }
+  }
+  for (const feld of PFLICHT_JE_HERKUNFT[herkunft] ?? []) {
+    if (!istText(record[feld])) {
+      return {
+        ok: false,
+        message: `"${feld}" fehlt oder ist leer, wird bei Herkunft "${herkunft}" aber gebraucht.`
+      };
+    }
+  }
+  for (const feld of VERBOTEN_JE_HERKUNFT[herkunft] ?? []) {
+    if (istText(record[feld])) {
+      return {
+        ok: false,
+        message: `"${feld}" ist bei einem Lauf der Herkunft "${herkunft}" gesetzt. Dort gibt es diesen Wert nicht, und erfundene sind unzulaessig (D-98/D-135).`
+      };
     }
   }
   if (record.status !== "succeeded" && record.status !== "failed") {
@@ -1475,6 +1602,7 @@ export {
   ELEMENT_VERSION_SCHEMA_FILE,
   FLOW_EXECUTION_PATH,
   PROBE_VERSION_ID,
+  PROMPT_RULE_EFFECT,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
@@ -1511,6 +1639,7 @@ export {
   checkDraftChainMeta,
   checkElementType,
   checkImageExecutionProfile,
+  checkImageExecutionProfiles,
   checkImageModelParameters,
   checkOptionalId,
   checkParents,
@@ -1559,7 +1688,10 @@ export {
   derivationPoliciesOf,
   deriveItemFromRun,
   deriveLineage,
+  describableContent,
   describeTargetModelFailure,
+  diagnosticOfFinding,
+  diagnosticOfSchemaError,
   differentialSteps,
   draftRevisionOf,
   elementStoreContractChecks,
@@ -1574,14 +1706,18 @@ export {
   firstError,
   formatSchemaErrors,
   freezeDraftChain,
+  freezeSceneWorkingState,
   getSzenenSchemas,
+  gruppiereZuItems,
   hasPlacementCapability,
   isKnownElementType,
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
   itemIdForRun,
+  ladeVorschauen,
   linkFor,
+  locatorTeile,
   logRevisionOf,
   mergeSzenenBatchOrigin,
   noticeFor,
@@ -1590,22 +1726,26 @@ export {
   parseRunResponse,
   preferredHeadRevisionOf,
   preferredVersionId,
+  promptDiagnosticsOf,
   publishedHeadsOf,
   recoveriesForRun,
   recoveryStatusOf,
   reduceElementEvents,
   resolveArea,
   resolvePreferredHead,
+  resolveScenePayload,
   resolveShot,
   resolveShotPayload,
   resolveTargetModelOver,
   resolverFromQueries,
   roundOfRun,
+  rulesWithoutPromptEffect,
   runElementStoreContract,
   runPromptDerivation,
   runPublishChecks,
   runSceneDerivation,
   runStoreDifferential,
+  sceneOnlyCapabilities,
   scopeOfPath,
   selectableTargetModels,
   showChain,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rslsp1/fa-app-tools",
-  "version": "3.0.0",
+  "version": "5.0.0",
   "description": "Shared tools and hooks for Fine Art flow apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",