@rslsp1/fa-app-tools 2.0.87 → 4.0.0

package/dist/szenen.mjs

@@ -6,9 +6,10 @@ import {
   CapabilityAnchorError,
   DERIVABLE_TYPES,
   ELEMENT_VERSION_SCHEMA_FILE,
-  FLOW_MODEL_DISPLAY_NAMES,
+  FLOW_EXECUTION_PATH,
   MAX_PROPOSAL_TITLE_LENGTH,
   PROBE_VERSION_ID,
+  PROMPT_RULE_EFFECT,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
@@ -32,9 +33,7 @@ import {
   buildUserPrompt,
   buildUserPrompt2,
   callOptional,
-  callableImageModelFor,
   capabilitiesOf,
-  capabilityForTargetModel,
   capabilityGate,
   capabilityReport,
   catalogueFor,
@@ -43,6 +42,9 @@ import {
   checkDerivationResponse,
   checkDraftChainMeta,
   checkElementType,
+  checkImageExecutionProfile,
+  checkImageExecutionProfiles,
+  checkImageModelParameters,
   checkOptionalId,
   checkParents,
   checkPayloadPresent,
@@ -83,17 +85,22 @@ import {
   derivationPoliciesOf,
   deriveItemFromRun,
   deriveLineage,
+  describableContent,
   describeTargetModelFailure,
+  diagnosticOfFinding,
+  diagnosticOfSchemaError,
   draftRevisionOf,
+  executableImageModels,
+  findExecutableImageModel,
   findImageBatch,
   findImageGenerationOrder,
   findPromptRun,
   findSceneDerivation,
   findSceneDerivationRecovery,
   firstError,
-  flowImageProviderHasAccess,
   formatSchemaErrors,
   freezeDraftChain,
+  freezeSceneWorkingState,
   getSzenenSchemas,
   hasPlacementCapability,
   isKnownElementType,
@@ -109,20 +116,25 @@ import {
   parseDerivationResponse,
   parseRunResponse,
   preferredHeadRevisionOf,
+  promptDiagnosticsOf,
   publishedHeadsOf,
   recoveriesForRun,
   recoveryStatusOf,
   reduceElementEvents,
   resolveArea,
+  resolveScenePayload,
   resolveShot,
   resolveShotPayload,
   resolveTargetModelOver,
   resolverFromQueries,
   roundOfRun,
+  rulesWithoutPromptEffect,
   runPromptDerivation,
   runPublishChecks,
   runSceneDerivation,
+  sceneOnlyCapabilities,
   scopeOfPath,
+  selectableTargetModels,
   showChain,
   simulatedAnswerFor,
   typAusBytes,
@@ -133,14 +145,14 @@ import {
   validateElementVersion,
   validatePayload,
   withReference
-} from "./chunk-ZVHEHQ7A.mjs";
+} from "./chunk-566GHYAT.mjs";
 import {
   ContractViolation,
   STYLE_PAYLOAD,
   STYLE_PAYLOAD_V2,
   elementStoreContractChecks,
   runElementStoreContract
-} from "./chunk-43TWCAG5.mjs";
+} from "./chunk-C5CGSPP3.mjs";
 import {
   VersionDagError,
   buildVersionDag,
@@ -388,6 +400,10 @@ async function runStoreDifferential(left, right) {
 }
 
 // src/lib/szenen/memoryViewPort.ts
+var MEMORY_IMAGE_CAPABILITY = {
+  environment_id: "memory",
+  execution_paths: [{ execution_path: "memory", provider: "google" }]
+};
 function ok(value) {
   return { kind: "ok", value };
 }
@@ -513,6 +529,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 = {
@@ -795,7 +849,7 @@ function createMemoryViewPort(options = {}) {
       const bilder2 = Array.from({ length: input.imageCount }, (_, position) => ({
         imageBase64: "AAAA",
         seed: input.seeds?.[position],
-        model: `simulation:${input.callableModelId}`
+        model: `simulation:${input.targetModelKey}`
       }));
       return { images: bilder2 };
     }
@@ -845,7 +899,15 @@ function createMemoryViewPort(options = {}) {
     events: { async appendEvent(type, payload) {
       await imageGenerationEvents.appendEvent(type, payload);
     } },
-    hasAccess: options.imageProviderHasAccess ?? (() => true)
+    capability: options.imageCapability ?? MEMORY_IMAGE_CAPABILITY,
+    targetModels: {
+      async listExecutionTargetModels() {
+        if (options.imageTargetModels) return ok(options.imageTargetModels);
+        const wahl = await selectableTargetModels(elements, [null]);
+        if (wahl.kind !== "ok") return wahl;
+        return ok(wahl.value.selectable);
+      }
+    }
   });
   const port = {
     elements,
@@ -982,41 +1044,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.' };
@@ -1067,25 +1171,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") {
@@ -1459,8 +1576,9 @@ export {
   ContractViolation,
   DERIVABLE_TYPES,
   ELEMENT_VERSION_SCHEMA_FILE,
-  FLOW_MODEL_DISPLAY_NAMES,
+  FLOW_EXECUTION_PATH,
   PROBE_VERSION_ID,
+  PROMPT_RULE_EFFECT,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
@@ -1487,9 +1605,7 @@ export {
   buildUserPrompt2 as buildUserPrompt,
   buildVersionDag,
   callOptional,
-  callableImageModelFor,
   capabilitiesOf,
-  capabilityForTargetModel,
   capabilityGate,
   capabilityReport,
   catalogueFor,
@@ -1498,6 +1614,9 @@ export {
   checkDerivationResponse,
   checkDraftChainMeta,
   checkElementType,
+  checkImageExecutionProfile,
+  checkImageExecutionProfiles,
+  checkImageModelParameters,
   checkOptionalId,
   checkParents,
   checkPayloadPresent,
@@ -1545,10 +1664,15 @@ export {
   derivationPoliciesOf,
   deriveItemFromRun,
   deriveLineage,
+  describableContent,
   describeTargetModelFailure,
+  diagnosticOfFinding,
+  diagnosticOfSchemaError,
   differentialSteps,
   draftRevisionOf,
   elementStoreContractChecks,
+  executableImageModels,
+  findExecutableImageModel,
   findImageBatch,
   findImageGenerationOrder,
   findPromptRun,
@@ -1556,9 +1680,9 @@ export {
   findSceneDerivation,
   findSceneDerivationRecovery,
   firstError,
-  flowImageProviderHasAccess,
   formatSchemaErrors,
   freezeDraftChain,
+  freezeSceneWorkingState,
   getSzenenSchemas,
   hasPlacementCapability,
   isKnownElementType,
@@ -1575,23 +1699,28 @@ 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,
   simulatedAnswerFor,
   totalModelCalls,

package/package.json

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