@rslsp1/fa-app-tools 7.0.1 → 7.4.0

package/dist/szenen.mjs

@@ -21,6 +21,9 @@ import {
   SZENEN_EVENT_TYPES,
   SZENEN_ITEM_PREFIX,
   SZENEN_SCHEMAS,
+  SZENEN_SNAPSHOT_FILE,
+  SZENEN_SNAPSHOT_PREFIX,
+  SZENEN_SNAPSHOT_SCHEMA_VERSION,
   SzenenView,
   UNCHECKED_PUBLISH_RULES,
   UPLOAD_MAX_BYTES,
@@ -32,6 +35,7 @@ import {
   bildPfad,
   buildSystemInstruction,
   buildSystemInstruction2,
+  buildSzenenSnapshot,
   buildUserPrompt,
   buildUserPrompt2,
   callOptional,
@@ -59,8 +63,10 @@ import {
   checkSzenenBatchOrigin,
   checkTitle,
   checkWriteDraftInput,
+  claimWon,
   collectImageBatches,
   collectImageGenerationOrders,
+  collectImageJobs,
   collectPromptRuns,
   collectSceneDerivationRecoveries,
   collectSceneDerivations,
@@ -82,6 +88,7 @@ import {
   createHfImageLibrary,
   createHfImageStore,
   createImageGenerationPort,
+  createImageJobPort,
   createSimulationSceneDerivationPort,
   createSimulationTextGenerationPort,
   derivationPoliciesOf,
@@ -96,6 +103,7 @@ import {
   findExecutableImageModel,
   findImageBatch,
   findImageGenerationOrder,
+  findImageJob,
   findPromptRun,
   findSceneDerivation,
   findSceneDerivationRecovery,
@@ -104,6 +112,7 @@ import {
   formatSeedListe,
   freezeDraftChain,
   freezeSceneWorkingState,
+  generationBatchIdOf,
   gesamtHerkunft,
   getSzenenSchemas,
   gruppiereZuItems,
@@ -112,14 +121,20 @@ import {
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
+  istSzenenSnapshotDatei,
   istZipDatei,
   itemIdForRun,
+  itemsAusBestand,
+  jobsForPromptRun,
   ladeVorschauen,
   leseBilderAusZip,
   linkFor,
+  locatorAus,
   locatorTeile,
   logRevisionOf,
+  mergeSnapshotAndPending,
   mergeSzenenBatchOrigin,
+  mimeTypAus,
   mitDefaultVorlage,
   noticeFor,
   ordersForPromptRun,
@@ -127,6 +142,7 @@ import {
   parseDerivationResponse,
   parseRunResponse,
   parseSeedListe,
+  parseSzenenSnapshot,
   preferredHeadRevisionOf,
   promptDiagnosticsOf,
   publishedHeadsOf,
@@ -150,6 +166,7 @@ import {
   selectableTargetModels,
   showChain,
   simulatedAnswerFor,
+  szenenSnapshotFilename,
   typAusBytes,
   unclassifiedPublishRules,
   unsupportedReason,
@@ -158,7 +175,7 @@ import {
   validateElementVersion,
   validatePayload,
   withReference
-} from "./chunk-B2YV4TNI.mjs";
+} from "./chunk-HUGUH4VB.mjs";
 import {
   ContractViolation,
   STYLE_PAYLOAD,
@@ -194,6 +211,7 @@ function totalModelCalls(checks) {
 // src/lib/szenen/inMemoryEventChannel.ts
 function createInMemoryEventChannel(options = {}) {
   const log = options.shared ?? [];
+  const snapshot = options.snapshot ?? null;
   let tick = 0;
   const now = options.now ?? (() => ++tick);
   const clientId = options.clientId ?? "client-a";
@@ -202,7 +220,8 @@ function createInMemoryEventChannel(options = {}) {
       return log;
     },
     async readEvents() {
-      return log.map((event) => ({ ...event }));
+      const { events } = mergeSnapshotAndPending(snapshot, log);
+      return events.map((event) => ({ ...event }));
     },
     async appendEvent(type, payload) {
       log.push({ type, payload, clientId, ts: now() });
@@ -211,7 +230,7 @@ function createInMemoryEventChannel(options = {}) {
       log.push(event);
     },
     withClient(otherClientId) {
-      return createInMemoryEventChannel({ clientId: otherClientId, now, shared: log });
+      return createInMemoryEventChannel({ clientId: otherClientId, now, shared: log, snapshot });
     }
   };
   return channel;
@@ -1640,6 +1659,120 @@ function checkSceneDerivationRecoveryRecord(candidate) {
   }
   return { ok: true };
 }
+
+// src/lib/szenen/scenePromptOperation.ts
+var MCP_CLIENT_PROVIDER = "mcp_client";
+var UNVERIFIED_MODEL_ID = "mcp-client-unspecified";
+var istText2 = (wert) => typeof wert === "string" && wert.trim().length > 0;
+function collectPromptOperations(events) {
+  const nachId = /* @__PURE__ */ new Map();
+  for (const event of events) {
+    if (event.type !== SZENEN_EVENT_TYPES.promptOperationPrepared) continue;
+    const payload = event.payload;
+    if (!payload || !istText2(payload.operation_id)) continue;
+    if (nachId.has(payload.operation_id)) continue;
+    nachId.set(payload.operation_id, payload);
+  }
+  return [...nachId.values()];
+}
+function findPromptOperation(events, operationId) {
+  return collectPromptOperations(events).find((v) => v.operation_id === operationId) ?? null;
+}
+async function preparePromptOperation(input) {
+  const now = input.now ?? (() => /* @__PURE__ */ new Date());
+  const eingefroren = await freezeSceneWorkingState({
+    sceneElementId: input.sceneElementId,
+    store: input.store,
+    resolver: input.resolver,
+    contextChain: input.contextChain,
+    userInstruction: input.userInstruction ?? null
+  });
+  if (eingefroren.kind !== "ok") return eingefroren;
+  const rendererInput = eingefroren.input;
+  return {
+    kind: "ok",
+    operation: {
+      operation_id: input.operationId,
+      scene: eingefroren.scene,
+      context_id: input.contextId,
+      user_instruction: input.userInstruction ?? null,
+      renderer_input: rendererInput,
+      renderer_instruction: buildSystemInstruction2(rendererInput),
+      renderer_payload: buildUserPrompt2(rendererInput),
+      response_contract: responseContractOf(rendererInput),
+      prepared_by: input.preparedBy,
+      created_at: now().toISOString()
+    }
+  };
+}
+function responseContractOf(input) {
+  const model = input.target_model ?? {};
+  return {
+    format: "json",
+    required_fields: ["positive", "negative", "feedback", "visibility", "notes"],
+    negative_prompt_allowed: model.supports_negative_prompt === true,
+    node_ids: input.scene.nodes.map((node) => node.node_id),
+    prompt_language: typeof model.prompt_language === "string" ? model.prompt_language : "en"
+  };
+}
+function completePromptOperation(input) {
+  const now = input.now ?? (() => /* @__PURE__ */ new Date());
+  const { operation } = input;
+  const geparst = parseRunResponse(input.response);
+  if (!geparst.ok) {
+    return {
+      kind: "rejected",
+      message: `Die Antwort zu Vorgang ${operation.operation_id} ist nicht verwertbar: ${geparst.message}`
+    };
+  }
+  const geprueft = checkRunResponse(geparst.value, operation.renderer_input);
+  if (!geprueft.ok) {
+    return {
+      kind: "rejected",
+      message: `Die Antwort zu Vorgang ${operation.operation_id} passt nicht zur eingefrorenen Eingabe: ${geprueft.message}`
+    };
+  }
+  const origin = {
+    host: "mcp",
+    ...istText2(input.declaredModelId) ? { declared_model_id: input.declaredModelId } : {},
+    renderer_instruction_was_system_prompt: false
+  };
+  return {
+    kind: "ok",
+    record: {
+      run_id: input.runId,
+      // Keine fingierten Kennungen (D-98/D-75) — genau wie beim
+      // Szene-Direktlauf des bestehenden Pfads.
+      shot_version_id: "",
+      shot_element_id: "",
+      scene_setup_version_id: "",
+      camera_id: "",
+      target_model_version_id: operation.renderer_input.target_model_resolution?.version_id ?? "",
+      provider: MCP_CLIENT_PROVIDER,
+      model_id: UNVERIFIED_MODEL_ID,
+      // Die Renderer-Anweisung, wie sie der Vorgang eingefroren hat — nicht
+      // eine zweite, jetzt neu gebaute Fassung.
+      system_prompt: operation.renderer_instruction,
+      input_payload: operation.renderer_input,
+      status: "succeeded",
+      failure: null,
+      output: geprueft.output,
+      raw_output: input.response,
+      source: { kind: "scene_direct", scene: operation.scene },
+      operation_id: operation.operation_id,
+      execution_origin: origin,
+      created_at: now().toISOString()
+    }
+  };
+}
+function runOfOperation(runs, operationId) {
+  return runs.find(
+    (run) => run.operation_id === operationId
+  ) ?? null;
+}
+function sameResponseAs(run, response) {
+  return (run.raw_output ?? "") === response;
+}
 export {
   ALL_PUBLISH_RULES,
   CATALOGUE_TYPES,
@@ -1651,6 +1784,7 @@ export {
   DERIVABLE_TYPES,
   ELEMENT_VERSION_SCHEMA_FILE,
   FLOW_EXECUTION_PATH,
+  MCP_CLIENT_PROVIDER,
   PROBE_VERSION_ID,
   PROMPT_RULE_EFFECT,
   REFERENCE_FIELD,
@@ -1665,8 +1799,12 @@ export {
   SZENEN_EVENT_TYPES,
   SZENEN_ITEM_PREFIX,
   SZENEN_SCHEMAS,
+  SZENEN_SNAPSHOT_FILE,
+  SZENEN_SNAPSHOT_PREFIX,
+  SZENEN_SNAPSHOT_SCHEMA_VERSION,
   SzenenView,
   UNCHECKED_PUBLISH_RULES,
+  UNVERIFIED_MODEL_ID,
   UPLOAD_MAX_BYTES,
   UnsupportedSchemaError,
   VersionDagError,
@@ -1677,6 +1815,7 @@ export {
   buildSystemInstruction as buildDerivationSystemInstruction,
   buildUserPrompt as buildDerivationUserPrompt,
   buildSystemInstruction2 as buildSystemInstruction,
+  buildSzenenSnapshot,
   buildUserPrompt2 as buildUserPrompt,
   buildVersionDag,
   callOptional,
@@ -1707,14 +1846,18 @@ export {
   checkSzenenBatchOrigin,
   checkTitle,
   checkWriteDraftInput,
+  claimWon,
   collectImageBatches,
   collectImageGenerationOrders,
+  collectImageJobs,
+  collectPromptOperations,
   collectPromptRuns,
   collectProviderChecks,
   collectSceneDerivationRecoveries,
   collectSceneDerivations,
   collectVersionRefs,
   compileSchemas,
+  completePromptOperation,
   createBrowserTextGenerationPort,
   createClientDerivationPort,
   createClientRunPort,
@@ -1732,6 +1875,7 @@ export {
   createHfImageLibrary,
   createHfImageStore,
   createImageGenerationPort,
+  createImageJobPort,
   createInMemoryEventChannel,
   createMemoryViewPort,
   createSimulationSceneDerivationPort,
@@ -1750,6 +1894,8 @@ export {
   findExecutableImageModel,
   findImageBatch,
   findImageGenerationOrder,
+  findImageJob,
+  findPromptOperation,
   findPromptRun,
   findProviderCheck,
   findSceneDerivation,
@@ -1759,6 +1905,7 @@ export {
   formatSeedListe,
   freezeDraftChain,
   freezeSceneWorkingState,
+  generationBatchIdOf,
   gesamtHerkunft,
   getSzenenSchemas,
   gruppiereZuItems,
@@ -1767,14 +1914,20 @@ export {
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
+  istSzenenSnapshotDatei,
   istZipDatei,
   itemIdForRun,
+  itemsAusBestand,
+  jobsForPromptRun,
   ladeVorschauen,
   leseBilderAusZip,
   linkFor,
+  locatorAus,
   locatorTeile,
   logRevisionOf,
+  mergeSnapshotAndPending,
   mergeSzenenBatchOrigin,
+  mimeTypAus,
   mitDefaultVorlage,
   noticeFor,
   ordersForPromptRun,
@@ -1782,8 +1935,10 @@ export {
   parseDerivationResponse,
   parseRunResponse,
   parseSeedListe,
+  parseSzenenSnapshot,
   preferredHeadRevisionOf,
   preferredVersionId,
+  preparePromptOperation,
   promptDiagnosticsOf,
   publishedHeadsOf,
   recoveriesForRun,
@@ -1796,19 +1951,23 @@ export {
   resolveShotPayload,
   resolveTargetModelOver,
   resolverFromQueries,
+  responseContractOf,
   roundOfRun,
   rulesWithoutPromptEffect,
   runElementStoreContract,
+  runOfOperation,
   runPromptDerivation,
   runPublishChecks,
   runSceneDerivation,
   runStoreDifferential,
+  sameResponseAs,
   sceneOnlyCapabilities,
   scopeOfPath,
   seedFehlerText,
   selectableTargetModels,
   showChain,
   simulatedAnswerFor,
+  szenenSnapshotFilename,
   totalModelCalls,
   typAusBytes,
   unclassifiedPublishRules,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rslsp1/fa-app-tools",
-  "version": "7.0.1",
+  "version": "7.4.0",
   "description": "Shared tools and hooks for Fine Art flow apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -28,7 +28,8 @@
   "scripts": {
     "build": "node scripts/sync-szenen-styles.js && tsup",
     "prepublishOnly": "npm run build",
-    "test": "vitest run"
+    "test": "vitest run",
+    "mutation:szenen": "stryker run stryker.szenen.conf.mjs"
   },
   "peerDependencies": {
     "react": ">=18"
@@ -39,9 +40,12 @@
     "zustand": "^5.0.14"
   },
   "devDependencies": {
+    "@stryker-mutator/core": "9.6.1",
+    "@stryker-mutator/vitest-runner": "9.6.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.0.0",
+    "@vitest/coverage-v8": "2.1.9",
     "@xyflow/react": "^12.10.2",
     "jsdom": "^29.1.1",
     "motion": "^12.40.0",