@rslsp1/fa-app-tools 2.0.82 → 2.0.84

package/dist/szenen.mjs

@@ -6,6 +6,7 @@ import {
   CapabilityAnchorError,
   DERIVABLE_TYPES,
   ELEMENT_VERSION_SCHEMA_FILE,
+  FLOW_MODEL_DISPLAY_NAMES,
   MAX_PROPOSAL_TITLE_LENGTH,
   PROBE_VERSION_ID,
   REFERENCE_FIELD,
@@ -24,12 +25,15 @@ import {
   acceptProposalTitle,
   areasFor,
   assessDerivationResponse,
+  batchesForPromptRun,
   buildSystemInstruction,
   buildSystemInstruction2,
   buildUserPrompt,
   buildUserPrompt2,
   callOptional,
+  callableImageModelFor,
   capabilitiesOf,
+  capabilityForTargetModel,
   capabilityGate,
   capabilityReport,
   catalogueFor,
@@ -50,6 +54,8 @@ import {
   checkSzenenBatchOrigin,
   checkTitle,
   checkWriteDraftInput,
+  collectImageBatches,
+  collectImageGenerationOrders,
   collectPromptRuns,
   collectSceneDerivationRecoveries,
   collectSceneDerivations,
@@ -60,11 +66,16 @@ import {
   createEventLogDerivationPersistence,
   createEventLogRunPersistence,
   createFakeTextGenerationPort,
+  createFlowImageProvider,
   createFlowSzenenViewPort,
   createFlowTextGenerationPort,
   createHfElementStore,
   createHfEventChannel,
+  createHfImageBatchHistory,
+  createHfImageBatchWrite,
+  createHfImageGenerationBatchPersistence,
   createHfImageLibrary,
+  createImageGenerationPort,
   createSimulationSceneDerivationPort,
   createSimulationTextGenerationPort,
   derivationPoliciesOf,
@@ -72,10 +83,13 @@ import {
   deriveLineage,
   describeTargetModelFailure,
   draftRevisionOf,
+  findImageBatch,
+  findImageGenerationOrder,
   findPromptRun,
   findSceneDerivation,
   findSceneDerivationRecovery,
   firstError,
+  flowImageProviderHasAccess,
   formatSchemaErrors,
   freezeDraftChain,
   getSzenenSchemas,
@@ -89,6 +103,7 @@ import {
   logRevisionOf,
   mergeSzenenBatchOrigin,
   noticeFor,
+  ordersForPromptRun,
   parseDerivationResponse,
   parseRunResponse,
   preferredHeadRevisionOf,
@@ -115,7 +130,7 @@ import {
   validateElementVersion,
   validatePayload,
   withReference
-} from "./chunk-GEGJD43Y.mjs";
+} from "./chunk-4FOEFCKM.mjs";
 import {
   ContractViolation,
   STYLE_PAYLOAD,
@@ -149,52 +164,6 @@ function totalModelCalls(checks) {
   return checks.reduce((summe, check) => summe + (Number(check.model_calls) || 0), 0);
 }
 
-// src/lib/szenen/imageGenerationOrderStore.ts
-function istText(wert) {
-  return typeof wert === "string" && wert.trim().length > 0;
-}
-function collectImageGenerationOrders(events) {
-  const byBatchId = /* @__PURE__ */ new Map();
-  for (const event of events) {
-    if (event.type !== SZENEN_EVENT_TYPES.imageGenerationStarted) continue;
-    const payload = event.payload;
-    if (!payload || !istText(payload.generation_batch_id) || !istText(payload.prompt_run_id)) continue;
-    if (byBatchId.has(payload.generation_batch_id)) continue;
-    byBatchId.set(payload.generation_batch_id, {
-      generation_batch_id: payload.generation_batch_id,
-      prompt_run_id: payload.prompt_run_id,
-      source_kind: "generated_in_app",
-      request: payload.request,
-      created_at: payload.created_at ?? "",
-      status: "started"
-    });
-  }
-  for (const event of events) {
-    if (event.type !== SZENEN_EVENT_TYPES.imageGenerationFinished) continue;
-    const payload = event.payload;
-    if (!payload || !istText(payload.generation_batch_id)) continue;
-    const auftrag = byBatchId.get(payload.generation_batch_id);
-    if (!auftrag) continue;
-    if (auftrag.status !== "started") continue;
-    if (payload.status !== "succeeded" && payload.status !== "partial" && payload.status !== "failed") continue;
-    byBatchId.set(payload.generation_batch_id, {
-      ...auftrag,
-      status: payload.status,
-      ...payload.item_id ? { item_id: payload.item_id } : {},
-      produced_count: payload.produced_count ?? 0,
-      ...payload.diagnostic ? { diagnostic: payload.diagnostic } : {},
-      finished_at: payload.finished_at ?? ""
-    });
-  }
-  return [...byBatchId.values()];
-}
-function ordersForPromptRun(events, runId) {
-  return collectImageGenerationOrders(events).filter((o) => o.prompt_run_id === runId);
-}
-function findImageGenerationOrder(events, batchId) {
-  return collectImageGenerationOrders(events).find((o) => o.generation_batch_id === batchId) ?? null;
-}
-
 // src/lib/szenen/inMemoryEventChannel.ts
 function createInMemoryEventChannel(options = {}) {
   const log = options.shared ?? [];
@@ -415,195 +384,6 @@ async function runStoreDifferential(left, right) {
   return { steps: steps.length, divergences, identical: divergences.length === 0 };
 }
 
-// src/lib/szenen/imageGenerationCapability.ts
-var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-var IMAGE_MODEL_CATALOGUE = {
-  imagen_4: {
-    callable_model_id: "imagen-4.0-generate-001",
-    provider: "google",
-    max_images: 4,
-    aspect_ratios: ["1:1", "3:4", "4:3", "9:16", "16:9"],
-    supports_seed: true
-  },
-  imagen_3: {
-    callable_model_id: "imagen-3.0-generate-001",
-    provider: "google",
-    max_images: 4,
-    aspect_ratios: ["1:1", "3:4", "4:3", "9:16", "16:9"],
-    supports_seed: true
-  }
-};
-function callableImageModelFor(targetModelKey) {
-  return IMAGE_MODEL_CATALOGUE[targetModelKey] ?? null;
-}
-function targetModelKeyOf(targetModel) {
-  if (!isObject(targetModel)) return null;
-  return typeof targetModel.key === "string" && targetModel.key.length > 0 ? targetModel.key : null;
-}
-function capabilityForTargetModel(targetModel, hasAccess) {
-  const key = targetModelKeyOf(targetModel);
-  if (!key) {
-    return {
-      kind: "unsupported",
-      target_model_key: "(unbekannt)",
-      reason: 'Der eingefrorene Lauf tr\xE4gt kein "target_model.key" \u2014 es gibt nichts zuzuordnen.'
-    };
-  }
-  const modell = callableImageModelFor(key);
-  if (!modell) {
-    return {
-      kind: "unsupported",
-      target_model_key: key,
-      reason: `F\xFCr das Zielmodell "${key}" ist in diesem Host kein Bildpfad katalogisiert.`
-    };
-  }
-  if (!hasAccess(modell)) {
-    return {
-      kind: "unsupported",
-      target_model_key: key,
-      reason: `Dieser Host hat keinen Zugang zu ${modell.callable_model_id} (${modell.provider}).`
-    };
-  }
-  return {
-    kind: "supported",
-    target_model_key: key,
-    provider: modell.provider,
-    callable_model_id: modell.callable_model_id,
-    max_images: modell.max_images,
-    aspect_ratios: modell.aspect_ratios,
-    supports_seed: modell.supports_seed
-  };
-}
-
-// src/lib/szenen/imageGenerationPort.ts
-function queryError(error, action) {
-  return {
-    kind: "error",
-    message: `${action}: ${error instanceof Error ? error.message : String(error)}`,
-    retryable: true
-  };
-}
-function createImageGenerationPort(options) {
-  const { runs, provider, batches, events, hasAccess } = options;
-  const now = options.now ?? (() => /* @__PURE__ */ new Date());
-  async function readRun(runId) {
-    try {
-      return await runs.getRun(runId);
-    } catch (error) {
-      return queryError(error, `Lauf ${runId} konnte nicht gelesen werden`);
-    }
-  }
-  return {
-    async capabilityForRun(runId) {
-      const gelesen = await readRun(runId);
-      if (gelesen.kind !== "ok") return gelesen;
-      if (!gelesen.value) {
-        return { kind: "error", message: `Lauf ${runId} ist unbekannt.`, retryable: false };
-      }
-      const targetModel = gelesen.value.input_payload?.target_model;
-      return { kind: "ok", value: capabilityForTargetModel(targetModel, hasAccess) };
-    },
-    async startFromPromptRun(input) {
-      const gelesen = await readRun(input.runId);
-      if (gelesen.kind !== "ok") return { kind: "rejected", message: gelesen.message };
-      if (!gelesen.value) {
-        return { kind: "rejected", message: `Lauf ${input.runId} ist unbekannt.` };
-      }
-      const run = gelesen.value;
-      if (run.status !== "succeeded" || !run.output) {
-        return {
-          kind: "rejected",
-          message: `Lauf ${input.runId} ist nicht erfolgreich \u2014 ein Bildauftrag braucht einen eingefrorenen Prompt (D-103).`
-        };
-      }
-      const targetModel = run.input_payload?.target_model;
-      const capability = capabilityForTargetModel(targetModel, hasAccess);
-      if (capability.kind !== "supported") {
-        return { kind: "unsupported", targetModelKey: capability.target_model_key, reason: capability.reason };
-      }
-      const startedPayload = {
-        generation_batch_id: input.generationBatchId,
-        prompt_run_id: input.runId,
-        source_kind: "generated_in_app",
-        request: {
-          image_count: input.imageCount,
-          ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
-          ...input.seeds ? { seeds: input.seeds } : {},
-          callable_model_id: capability.callable_model_id
-        },
-        created_at: now().toISOString()
-      };
-      try {
-        await events.appendEvent(SZENEN_EVENT_TYPES.imageGenerationStarted, startedPayload);
-      } catch (error) {
-        return {
-          kind: "failed",
-          message: `Der Auftrag ${input.generationBatchId} konnte nicht protokolliert werden: ${error instanceof Error ? error.message : String(error)}`
-        };
-      }
-      let produced = [];
-      let providerFehler = null;
-      try {
-        const antwort = await provider.generate({
-          callableModelId: capability.callable_model_id,
-          provider: capability.provider,
-          positivePrompt: run.output.positive,
-          negativePrompt: run.output.negative,
-          imageCount: input.imageCount,
-          ...input.aspectRatio ? { aspectRatio: input.aspectRatio } : {},
-          ...input.seeds ? { seeds: input.seeds } : {}
-        });
-        produced = antwort.images;
-      } catch (error) {
-        providerFehler = error instanceof Error ? error.message : String(error);
-      }
-      if (providerFehler || produced.length === 0) {
-        const finishedPayload2 = {
-          generation_batch_id: input.generationBatchId,
-          status: "failed",
-          produced_count: 0,
-          diagnostic: providerFehler ?? "Der Provider hat kein verwertbares Bild geliefert.",
-          finished_at: now().toISOString()
-        };
-        await events.appendEvent(SZENEN_EVENT_TYPES.imageGenerationFinished, finishedPayload2).catch(() => {
-        });
-        return {
-          kind: "failed",
-          message: finishedPayload2.diagnostic
-        };
-      }
-      const persistiert = await batches.persist({
-        runId: input.runId,
-        generationBatchId: input.generationBatchId,
-        images: produced
-      });
-      if (persistiert.kind !== "ok") {
-        const finishedPayload2 = {
-          generation_batch_id: input.generationBatchId,
-          status: "failed",
-          produced_count: 0,
-          diagnostic: persistiert.kind === "error" ? persistiert.message : `Batch ${input.generationBatchId} konnte nicht gespeichert werden (${persistiert.kind}).`,
-          finished_at: now().toISOString()
-        };
-        await events.appendEvent(SZENEN_EVENT_TYPES.imageGenerationFinished, finishedPayload2).catch(() => {
-        });
-        return { kind: "failed", message: finishedPayload2.diagnostic };
-      }
-      const istPartial = produced.length < input.imageCount;
-      const finishedPayload = {
-        generation_batch_id: input.generationBatchId,
-        status: istPartial ? "partial" : "succeeded",
-        item_id: persistiert.value.item_id,
-        produced_count: produced.length,
-        finished_at: now().toISOString()
-      };
-      await events.appendEvent(SZENEN_EVENT_TYPES.imageGenerationFinished, finishedPayload).catch(() => {
-      });
-      return istPartial ? { kind: "partial", batch: persistiert.value, requested: input.imageCount, produced: produced.length } : { kind: "succeeded", batch: persistiert.value };
-    }
-  };
-}
-
 // src/lib/szenen/memoryViewPort.ts
 function ok(value) {
   return { kind: "ok", value };
@@ -1209,21 +989,21 @@ var PFLICHTFELDER = [
   "system_prompt",
   "created_at"
 ];
-function istText2(wert) {
+function istText(wert) {
   return typeof wert === "string" && wert.trim().length > 0;
 }
-function isObject2(wert) {
+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"];
 function pruefeLaufherkunft(quelle) {
-  if (!isObject2(quelle)) {
+  if (!isObject(quelle)) {
     return { ok: false, message: '"source" muss ein Objekt sein.' };
   }
   if (quelle.kind === "published") {
     for (const feld of VERSIONSFELDER) {
-      if (!istText2(quelle[feld])) {
+      if (!istText(quelle[feld])) {
         return { ok: false, message: `"source.${feld}" fehlt oder ist leer.` };
       }
     }
@@ -1235,7 +1015,7 @@ function pruefeLaufherkunft(quelle) {
       message: `"source.kind" ist unbekannt: ${JSON.stringify(quelle.kind)}. Erlaubt: published, draft_chain.`
     };
   }
-  if (!istText2(quelle.chain_id)) {
+  if (!istText(quelle.chain_id)) {
     return { ok: false, message: '"source.chain_id" fehlt oder ist leer.' };
   }
   if (!Array.isArray(quelle.nodes) || quelle.nodes.length === 0) {
@@ -1245,7 +1025,7 @@ function pruefeLaufherkunft(quelle) {
     };
   }
   for (const [index, knoten] of quelle.nodes.entries()) {
-    if (!isObject2(knoten)) {
+    if (!isObject(knoten)) {
       return { ok: false, message: `"source.nodes[${index}]" ist kein Objekt.` };
     }
     if (!KETTEN_TYPEN.includes(knoten.type)) {
@@ -1254,7 +1034,7 @@ function pruefeLaufherkunft(quelle) {
         message: `"source.nodes[${index}].type" ist unbekannt: ${JSON.stringify(knoten.type)}.`
       };
     }
-    if (!istText2(knoten.element_id) || !istText2(knoten.draft_id)) {
+    if (!istText(knoten.element_id) || !istText(knoten.draft_id)) {
       return {
         ok: false,
         message: `"source.nodes[${index}]" braucht element_id und draft_id.`
@@ -1267,10 +1047,10 @@ function pruefeLaufherkunft(quelle) {
       };
     }
   }
-  if (quelle.derivation_run_id !== void 0 && !istText2(quelle.derivation_run_id)) {
+  if (quelle.derivation_run_id !== void 0 && !istText(quelle.derivation_run_id)) {
     return { ok: false, message: '"source.derivation_run_id" ist gesetzt, aber leer.' };
   }
-  if (quelle.derivation_recovery_id !== void 0 && !istText2(quelle.derivation_recovery_id)) {
+  if (quelle.derivation_recovery_id !== void 0 && !istText(quelle.derivation_recovery_id)) {
     return { ok: false, message: '"source.derivation_recovery_id" ist gesetzt, aber leer.' };
   }
   return { ok: true };
@@ -1284,20 +1064,20 @@ function checkPromptRunRecord(candidate) {
   }
   const record = candidate;
   const quelle = record.source;
-  const ausKette = isObject2(quelle) && quelle.kind === "draft_chain";
+  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) {
-    if (!istText2(record[feld])) {
+    if (!istText(record[feld])) {
       return { ok: false, message: `"${feld}" fehlt oder ist leer.` };
     }
   }
   if (ausKette) {
     for (const feld of VERSIONSFELDER) {
-      if (istText2(record[feld])) {
+      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).`
@@ -1335,7 +1115,7 @@ function checkPromptRunRecord(candidate) {
         message: `"failure.class" ist unbekannt: ${JSON.stringify(failure.class)}. Erlaubt sind ${FAILURE_CLASSES.join(", ")}.`
       };
     }
-    if (!istText2(failure.message)) {
+    if (!istText(failure.message)) {
       return { ok: false, message: '"failure.message" fehlt oder ist leer.' };
     }
     return { ok: true };
@@ -1377,7 +1157,7 @@ function checkSceneDerivationRecord(candidate) {
   }
   const record = candidate;
   for (const feld of DERIVATION_PFLICHTFELDER) {
-    if (!istText2(record[feld])) {
+    if (!istText(record[feld])) {
       return { ok: false, message: `"${feld}" fehlt oder ist leer.` };
     }
   }
@@ -1432,13 +1212,13 @@ function checkSceneDerivationRecord(candidate) {
       return { ok: false, message: '"follows" muss ein Objekt sein.' };
     }
     const f = folgt;
-    if (!istText2(f.run_id)) {
+    if (!istText(f.run_id)) {
       return { ok: false, message: '"follows.run_id" fehlt oder ist leer.' };
     }
     if (f.run_id === record.run_id) {
       return { ok: false, message: '"follows.run_id" zeigt auf den Lauf selbst.' };
     }
-    if (!istText2(f.note)) {
+    if (!istText(f.note)) {
       return {
         ok: false,
         message: '"follows.note" fehlt oder ist leer \u2014 ohne Beanstandung ist ein Folgelauf nicht nachvollziehbar (D-89).'
@@ -1452,7 +1232,7 @@ function checkSceneDerivationRecord(candidate) {
     }
   }
   const reply = record.reply;
-  if (reply !== void 0 && !istText2(reply)) {
+  if (reply !== void 0 && !istText(reply)) {
     return {
       ok: false,
       message: `"reply" ist unbrauchbar: erwartet wird eine nicht leere Zeichenkette, angekommen ist ${JSON.stringify(reply)}. Ohne "reply" einreichen ist zulaessig.`
@@ -1472,7 +1252,7 @@ function checkSceneDerivationRecord(candidate) {
         message: `"failure.class" ist unbekannt: ${JSON.stringify(failure.class)}. Erlaubt sind ${FAILURE_CLASSES.join(", ")}.`
       };
     }
-    if (!istText2(failure.message)) {
+    if (!istText(failure.message)) {
       return { ok: false, message: '"failure.message" fehlt oder ist leer.' };
     }
     if (Array.isArray(record.proposals) && record.proposals.length > 0) {
@@ -1527,7 +1307,7 @@ function checkSceneDerivationRecord(candidate) {
         };
       }
       for (const [gapIndex, luecke] of gaps.entries()) {
-        if (!luecke || typeof luecke !== "object" || !istText2(luecke.pointer) || !istText2(luecke.reason)) {
+        if (!luecke || typeof luecke !== "object" || !istText(luecke.pointer) || !istText(luecke.reason)) {
           return {
             ok: false,
             message: `"proposals[${index}].gaps[${gapIndex}]" braucht pointer und reason.`
@@ -1553,7 +1333,7 @@ function checkSceneDerivationRecoveryRecord(candidate) {
   }
   const record = candidate;
   for (const feld of ["recovery_id", "run_id", "created_at"]) {
-    if (!istText2(record[feld])) {
+    if (!istText(record[feld])) {
       return { ok: false, message: `"${feld}" fehlt oder ist leer.` };
     }
   }
@@ -1580,7 +1360,7 @@ function checkSceneDerivationRecoveryRecord(candidate) {
     return { ok: false, message: '"diagnostics" muss ein Array sein (auch ein leeres).' };
   }
   for (const [index, befund] of record.diagnostics.entries()) {
-    if (!befund || typeof befund !== "object" || !istText2(befund.code) || !istText2(befund.message)) {
+    if (!befund || typeof befund !== "object" || !istText(befund.code) || !istText(befund.message)) {
       return {
         ok: false,
         message: `"diagnostics[${index}]" braucht code und message.`
@@ -1632,7 +1412,7 @@ function checkSceneDerivationRecoveryRecord(candidate) {
     }
     if (Array.isArray(gaps)) {
       for (const [gapIndex, luecke] of gaps.entries()) {
-        if (!luecke || typeof luecke !== "object" || !istText2(luecke.pointer) || !istText2(luecke.reason)) {
+        if (!luecke || typeof luecke !== "object" || !istText(luecke.pointer) || !istText(luecke.reason)) {
           return {
             ok: false,
             message: `"proposals[${index}].gaps[${gapIndex}]" braucht pointer und reason.`
@@ -1676,6 +1456,7 @@ export {
   ContractViolation,
   DERIVABLE_TYPES,
   ELEMENT_VERSION_SCHEMA_FILE,
+  FLOW_MODEL_DISPLAY_NAMES,
   PROBE_VERSION_ID,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
@@ -1695,6 +1476,7 @@ export {
   VersionDagError,
   areasFor,
   assessDerivationResponse,
+  batchesForPromptRun,
   buildSystemInstruction as buildDerivationSystemInstruction,
   buildUserPrompt as buildDerivationUserPrompt,
   buildSystemInstruction2 as buildSystemInstruction,
@@ -1727,6 +1509,7 @@ export {
   checkSzenenBatchOrigin,
   checkTitle,
   checkWriteDraftInput,
+  collectImageBatches,
   collectImageGenerationOrders,
   collectPromptRuns,
   collectProviderChecks,
@@ -1740,10 +1523,14 @@ export {
   createEventLogDerivationPersistence,
   createEventLogRunPersistence,
   createFakeTextGenerationPort,
+  createFlowImageProvider,
   createFlowSzenenViewPort,
   createFlowTextGenerationPort,
   createHfElementStore,
   createHfEventChannel,
+  createHfImageBatchHistory,
+  createHfImageBatchWrite,
+  createHfImageGenerationBatchPersistence,
   createHfImageLibrary,
   createImageGenerationPort,
   createInMemoryEventChannel,
@@ -1757,12 +1544,14 @@ export {
   differentialSteps,
   draftRevisionOf,
   elementStoreContractChecks,
+  findImageBatch,
   findImageGenerationOrder,
   findPromptRun,
   findProviderCheck,
   findSceneDerivation,
   findSceneDerivationRecovery,
   firstError,
+  flowImageProviderHasAccess,
   formatSchemaErrors,
   freezeDraftChain,
   getSzenenSchemas,

package/package.json

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