@rslsp1/fa-app-tools 9.0.0 → 9.4.4

package/dist/szenen.mjs

@@ -9,9 +9,19 @@ import {
   ELEMENT_VERSION_SCHEMA_FILE,
   FLOW_EXECUTION_PATH,
   GENERAL_POLICY_SUBTYPE,
+  KEINE_BILDER,
+  LOAD_MORE_PAGE_SIZE,
+  MANUAL_MODEL_ID,
+  MANUAL_NODE_STATE,
+  MANUAL_PROVIDER,
+  MANUAL_VISIBILITY_BASIS,
   MAX_PROPOSAL_TITLE_LENGTH,
+  PAUSE_SEKUNDEN_OPTIONEN,
+  PAUSE_SEKUNDEN_VORGABE,
   PROBE_VERSION_ID,
+  PROMPT_AUSZUG_ZEICHEN,
   PROMPT_RULE_EFFECT,
+  PROMPT_RUN_DETAIL_FIELDS,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
@@ -30,10 +40,14 @@ import {
   UPLOAD_MAX_BYTES,
   UnsupportedSchemaError,
   acceptProposalTitle,
+  annotateElementsFromEvents,
+  annotateRunsFromEvents,
+  areaForFokus,
   areasFor,
   assessDerivationResponse,
   batchesForPromptRun,
   bildPfad,
+  buildManualPromptRunRecord,
   buildSystemInstruction,
   buildSystemInstruction2,
   buildSzenenSnapshot,
@@ -68,6 +82,7 @@ import {
   collectImageBatches,
   collectImageGenerationOrders,
   collectImageJobs,
+  collectPromptRunTags,
   collectPromptRuns,
   collectSceneDerivationRecoveries,
   collectSceneDerivations,
@@ -98,6 +113,7 @@ import {
   deriveLineage,
   describableContent,
   describeTargetModelFailure,
+  detailFehlt,
   diagnosticOfFinding,
   diagnosticOfSchemaError,
   draftRevisionOf,
@@ -114,6 +130,7 @@ import {
   formatSeedListe,
   freezeDraftChain,
   freezeSceneWorkingState,
+  fuehreQueueAus,
   generationBatchIdOf,
   gesamtHerkunft,
   getSzenenSchemas,
@@ -125,17 +142,24 @@ import {
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
+  istGueltigePause,
+  istOffen,
   istSzenenSnapshotDatei,
   istZipDatei,
   itemIdForRun,
   itemsAusBestand,
   jobsForPromptRun,
+  labelsOf,
   ladeVorschauen,
   leseBilderAusZip,
+  letztesErzeugtesBild,
   linkFor,
+  listElementsPageOver,
   locatorAus,
   locatorTeile,
   logRevisionOf,
+  manualEntryOf,
+  mergeRunTags,
   mergeSnapshotAndPending,
   mergeSzenenBatchOrigin,
   mimeTypAus,
@@ -144,12 +168,18 @@ import {
   noticeFor,
   ordersForPromptRun,
   ordneSeedsZu,
+  pageOf,
+  pagePromptRuns,
+  pageRequestFrom,
   parseDerivationResponse,
   parseRunResponse,
   parseSeedListe,
   parseSzenenSnapshot,
   preferredHeadRevisionOf,
   promptDiagnosticsOf,
+  promptRunPageForTransport,
+  promptRunPageFromTransport,
+  promptRunTagsOf,
   publishedHeadsOf,
   recoveriesForRun,
   recoveryStatusOf,
@@ -162,6 +192,7 @@ import {
   resolveTargetModelOver,
   resolverFromQueries,
   roundOfRun,
+  roundsOf,
   rulesWithoutPromptEffect,
   runPromptDerivation,
   runPublishChecks,
@@ -170,6 +201,7 @@ import {
   scenePolicyFingerprint,
   scopeOfPath,
   seedFehlerText,
+  selectImageJobs,
   selectPromptRuns,
   selectableTargetModels,
   showChain,
@@ -178,6 +210,7 @@ import {
   sortScenePolicies,
   sourceOf,
   szenenSnapshotFilename,
+  tagRefsAus,
   typAusBytes,
   unclassifiedPublishRules,
   unsupportedReason,
@@ -186,7 +219,7 @@ import {
   validateElementVersion,
   validatePayload,
   withReference
-} from "./chunk-2ADFDRFX.mjs";
+} from "./chunk-KF5ZVSKJ.mjs";
 import {
   ContractViolation,
   STYLE_PAYLOAD,
@@ -520,6 +553,14 @@ function createMemoryViewPort(options = {}) {
   const ids = options.ids ?? defaultIds;
   const elements = createHfElementStore({ channel: createInMemoryEventChannel() });
   const laeufe = [...options.runs ?? []];
+  const laufTags = new Map(
+    Object.entries(options.runTags ?? {}).map(
+      ([runId, labels]) => [runId, labels.map((l) => ({ l, v: l, cat: null }))]
+    )
+  );
+  const annotationen = new Map(
+    Object.entries(options.runAnnotations ?? {})
+  );
   const items = /* @__PURE__ */ new Map();
   const versionMedien = /* @__PURE__ */ new Map();
   const itemMedien = /* @__PURE__ */ new Map();
@@ -605,6 +646,34 @@ function createMemoryViewPort(options = {}) {
       laeufe.push(lauf);
       return done(lauf);
     },
+    // ── Der manuell erfasste Lauf derselben Szene (Schritt 01) ────────────
+    //
+    // Auch hier nur die **Form**, und zwar ueber `buildManualPromptRunRecord()`
+    // — dieselbe Funktion, die der echte Port benutzt. Ein hier nachgebauter
+    // Datensatz waere die zweite Wahrheit, an der eine Ansicht gruen testete
+    // und im Host scheiterte. Was der Speicherport nicht abbildet, ist das
+    // Einfrieren: Es braucht einen echten Bestand.
+    async addManualSceneRun(input) {
+      const gebaut = buildManualPromptRunRecord({
+        runId: ids(),
+        scene: {
+          element_id: input.sceneElementId,
+          draft_id: `draft-${input.sceneElementId}`,
+          revision: 1,
+          version_id: null
+        },
+        input: {
+          scene: { nodes: [] }
+        },
+        promptText: input.promptText,
+        note: input.note ?? null,
+        derivedFromRunId: input.derivedFromRunId ?? null,
+        enteredBy: input.enteredBy
+      });
+      if (gebaut.kind !== "ok") return { kind: "rejected", message: gebaut.message };
+      laeufe.push(gebaut.record);
+      return done(gebaut.record);
+    },
     async listRunsForScene(sceneElementId) {
       return ok(laeufe.filter(
         (r) => r.source?.kind === "scene_direct" && r.source.scene.element_id === sceneElementId
@@ -615,6 +684,38 @@ function createMemoryViewPort(options = {}) {
     // Server. Ein eigener Filter waere eine zweite Wahrheit.
     async listAllRuns(filter) {
       return ok(selectPromptRuns(laeufe, filter));
+    },
+    /**
+     * Die direkten Tags eines Laufs setzen — der vollstaendige Satz.
+     *
+     * Ohne Vokabelpruefung, und das ist hier richtig: Der Speicherhost hat
+     * keine Vokabel. Die Regel „nur bestehende Tags" gehoert dorthin, wo die
+     * Tabelle steht (`libraryService.resolveTagLabels`), nicht in eine zweite
+     * Fassung davon.
+     */
+    async setRunTags(runId, labels) {
+      if (!laeufe.some((l) => l.run_id === runId)) {
+        return { kind: "error", message: `Lauf ${runId} ist unbekannt.`, retryable: false };
+      }
+      const satz = labels.map((l) => ({ l, v: l, cat: null }));
+      laufTags.set(runId, satz);
+      return done(satz);
+    },
+    // Der Seitenschnitt — dieselbe reine Funktion wie im Client und im Server.
+    async listRunsPage(input) {
+      try {
+        return ok(pagePromptRuns(laeufe, {
+          ...input,
+          tags: input.tags ?? laufTags,
+          ...annotationen.size > 0 && !input.annotations ? { annotations: annotationen } : {}
+        }));
+      } catch (error) {
+        return {
+          kind: "error",
+          message: error instanceof Error ? error.message : String(error),
+          retryable: false
+        };
+      }
     }
   };
   const itemPort = {
@@ -1015,8 +1116,21 @@ function createMemoryViewPort(options = {}) {
       return done(null);
     }
   };
+  const elementeMitAnnotationen = options.elementAnnotations ? {
+    ...elements,
+    async listElementsPage(filter, page) {
+      const seite = await listElementsPageOver((f) => elements.listElements(f), filter, page);
+      if (seite.kind !== "ok") return seite;
+      const annotations = {};
+      for (const element of seite.value.items) {
+        const annotation = options.elementAnnotations[element.element_id];
+        if (annotation) annotations[element.element_id] = annotation;
+      }
+      return ok({ ...seite.value, annotations });
+    }
+  } : elements;
   const port = {
-    elements,
+    elements: elementeMitAnnotationen,
     context: {
       // Ein Host ohne Kontextgraph liefert `[eigener, null]` — das ist dort
       // nicht die verkürzte Vererbung, sondern die vollständige.
@@ -1024,7 +1138,17 @@ function createMemoryViewPort(options = {}) {
         return ok(contextId === null ? [null] : [contextId, null]);
       }
     },
-    runs
+    runs,
+    // Die Vorschlagsliste des Tag-Editors — nur, wenn der Test eine Vokabel
+    // vorgibt. Weglassen statt leere Liste: `tagVocabulary: false` ist eine
+    // andere Aussage als „die Vokabel ist leer".
+    ...options.tagVocabulary ? {
+      tags: {
+        async listTags() {
+          return ok(options.tagVocabulary.map((l) => ({ l, v: l, cat: null })));
+        }
+      }
+    } : {}
   };
   if (options.items !== false) port.items = itemPort;
   if (options.media !== false) port.media = mediaPort;
@@ -1271,6 +1395,47 @@ function pruefeLaufherkunft(quelle) {
   }
   return { ok: true };
 }
+function pruefeHandeingabe(record) {
+  const block = record.manual_entry;
+  if (block === void 0) return { ok: true };
+  if (!isObject(block)) {
+    return { ok: false, message: '"manual_entry" muss ein Objekt sein.' };
+  }
+  if (block.entered_manually !== true) {
+    return {
+      ok: false,
+      message: '"manual_entry.entered_manually" muss true sein. Ein Block, der das nicht sagt, ist kein Nachweis einer Handeingabe.'
+    };
+  }
+  if (!istText(block.entered_by)) {
+    return { ok: false, message: '"manual_entry.entered_by" fehlt oder ist leer.' };
+  }
+  if (block.note !== null && typeof block.note !== "string") {
+    return {
+      ok: false,
+      message: '"manual_entry.note" muss eine Zeichenkette oder null sein \u2014 ohne Notiz gehoert null hin, kein fehlendes Feld.'
+    };
+  }
+  if (block.derived_from_run_id !== null && !istText(block.derived_from_run_id)) {
+    return {
+      ok: false,
+      message: '"manual_entry.derived_from_run_id" muss eine run_id oder null sein. Eine leere Kennung belegt keinen Ursprung.'
+    };
+  }
+  if (record.status !== "succeeded") {
+    return {
+      ok: false,
+      message: `Ein manuell erfasster Lauf hat den Status "succeeded" \u2014 er traegt einen vorgegebenen Prompttext. Angekommen ist ${JSON.stringify(record.status)}.`
+    };
+  }
+  if (record.provider !== MANUAL_PROVIDER || record.model_id !== MANUAL_MODEL_ID) {
+    return {
+      ok: false,
+      message: `Ein manuell erfasster Lauf traegt provider "${MANUAL_PROVIDER}" und model_id "${MANUAL_MODEL_ID}"; angekommen sind ${JSON.stringify(record.provider)} und ${JSON.stringify(record.model_id)}. Formuliert hat ein Mensch \u2014 ein Modell als Urheber waere eine Falschaussage.`
+    };
+  }
+  return { ok: true };
+}
 function checkPromptRunRecord(candidate) {
   if (candidate === null || typeof candidate !== "object" || Array.isArray(candidate)) {
     return {
@@ -1320,6 +1485,8 @@ function checkPromptRunRecord(candidate) {
       message: `"status" muss succeeded oder failed sein, angekommen ist ${JSON.stringify(record.status)}.`
     };
   }
+  const handeingabe = pruefeHandeingabe(record);
+  if (!handeingabe.ok) return handeingabe;
   const eingabe = record.input_payload;
   if (eingabe === null || typeof eingabe !== "object") {
     return { ok: false, message: '"input_payload" fehlt \u2014 ohne sie ist der Lauf nicht pruefbar.' };
@@ -1702,7 +1869,8 @@ async function preparePromptOperation(input) {
     store: input.store,
     resolver: input.resolver,
     contextChain: input.contextChain,
-    userInstruction: input.userInstruction ?? null
+    userInstruction: input.userInstruction ?? null,
+    targetModelElementId: input.targetModelElementId ?? null
   });
   if (eingefroren.kind !== "ok") return eingefroren;
   const rendererInput = eingefroren.input;
@@ -1802,9 +1970,19 @@ export {
   ELEMENT_VERSION_SCHEMA_FILE,
   FLOW_EXECUTION_PATH,
   GENERAL_POLICY_SUBTYPE,
+  KEINE_BILDER,
+  LOAD_MORE_PAGE_SIZE,
+  MANUAL_MODEL_ID,
+  MANUAL_NODE_STATE,
+  MANUAL_PROVIDER,
+  MANUAL_VISIBILITY_BASIS,
   MCP_CLIENT_PROVIDER,
+  PAUSE_SEKUNDEN_OPTIONEN,
+  PAUSE_SEKUNDEN_VORGABE,
   PROBE_VERSION_ID,
+  PROMPT_AUSZUG_ZEICHEN,
   PROMPT_RULE_EFFECT,
+  PROMPT_RUN_DETAIL_FIELDS,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
@@ -1826,12 +2004,16 @@ export {
   UPLOAD_MAX_BYTES,
   UnsupportedSchemaError,
   VersionDagError,
+  annotateElementsFromEvents,
+  annotateRunsFromEvents,
+  areaForFokus,
   areasFor,
   assessDerivationResponse,
   batchesForPromptRun,
   bildPfad,
   buildSystemInstruction as buildDerivationSystemInstruction,
   buildUserPrompt as buildDerivationUserPrompt,
+  buildManualPromptRunRecord,
   buildSystemInstruction2 as buildSystemInstruction,
   buildSzenenSnapshot,
   buildUserPrompt2 as buildUserPrompt,
@@ -1869,6 +2051,7 @@ export {
   collectImageGenerationOrders,
   collectImageJobs,
   collectPromptOperations,
+  collectPromptRunTags,
   collectPromptRuns,
   collectProviderChecks,
   collectSceneDerivationRecoveries,
@@ -1904,6 +2087,7 @@ export {
   deriveLineage,
   describableContent,
   describeTargetModelFailure,
+  detailFehlt,
   diagnosticOfFinding,
   diagnosticOfSchemaError,
   differentialSteps,
@@ -1924,6 +2108,7 @@ export {
   formatSeedListe,
   freezeDraftChain,
   freezeSceneWorkingState,
+  fuehreQueueAus,
   generationBatchIdOf,
   gesamtHerkunft,
   getSzenenSchemas,
@@ -1935,17 +2120,24 @@ export {
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
+  istGueltigePause,
+  istOffen,
   istSzenenSnapshotDatei,
   istZipDatei,
   itemIdForRun,
   itemsAusBestand,
   jobsForPromptRun,
+  labelsOf,
   ladeVorschauen,
   leseBilderAusZip,
+  letztesErzeugtesBild,
   linkFor,
+  listElementsPageOver,
   locatorAus,
   locatorTeile,
   logRevisionOf,
+  manualEntryOf,
+  mergeRunTags,
   mergeSnapshotAndPending,
   mergeSzenenBatchOrigin,
   mimeTypAus,
@@ -1954,6 +2146,9 @@ export {
   noticeFor,
   ordersForPromptRun,
   ordneSeedsZu,
+  pageOf,
+  pagePromptRuns,
+  pageRequestFrom,
   parseDerivationResponse,
   parseRunResponse,
   parseSeedListe,
@@ -1962,6 +2157,9 @@ export {
   preferredVersionId,
   preparePromptOperation,
   promptDiagnosticsOf,
+  promptRunPageForTransport,
+  promptRunPageFromTransport,
+  promptRunTagsOf,
   publishedHeadsOf,
   recoveriesForRun,
   recoveryStatusOf,
@@ -1976,6 +2174,7 @@ export {
   resolverFromQueries,
   responseContractOf,
   roundOfRun,
+  roundsOf,
   rulesWithoutPromptEffect,
   runElementStoreContract,
   runOfOperation,
@@ -1988,6 +2187,7 @@ export {
   scenePolicyFingerprint,
   scopeOfPath,
   seedFehlerText,
+  selectImageJobs,
   selectPromptRuns,
   selectableTargetModels,
   showChain,
@@ -1996,6 +2196,7 @@ export {
   sortScenePolicies,
   sourceOf,
   szenenSnapshotFilename,
+  tagRefsAus,
   totalModelCalls,
   typAusBytes,
   unclassifiedPublishRules,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rslsp1/fa-app-tools",
-  "version": "9.0.0",
+  "version": "9.4.4",
   "description": "Shared tools and hooks for Fine Art flow apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -29,7 +29,8 @@
     "build": "node scripts/sync-szenen-styles.js && tsup",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
-    "mutation:szenen": "stryker run stryker.szenen.conf.mjs"
+    "mutation:szenen": "stryker run stryker.szenen.conf.mjs",
+    "mutation:runintegrity": "stryker run stryker.runintegrity.conf.mjs"
   },
   "peerDependencies": {
     "react": ">=18"