@milaboratories/pl-middle-layer 1.74.19 → 1.76.0

package/dist/mutator/project.d.ts

@@ -5,6 +5,7 @@ import { ProjectHelper } from "../model/project_helper.js";
 import { BlockConfig } from "@platforma-sdk/model";
 import { AuthorMarker, BlockPackSpec, BlockSettings, ProjectMeta } from "@milaboratories/pl-model-middle-layer";
 import { MiLogger } from "@milaboratories/ts-helpers";
+import { ArgsIssue } from "@milaboratories/pl-model-common";
 import { AnyRef, AnyResourceRef, PlClient, PlTransaction, ResourceRef, SignedResourceId } from "@milaboratories/pl-client";
 /**
  * Duplicates an existing project resource within a transaction.

package/dist/mutator/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","names":[],"sources":["../../src/mutator/project.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;wBAklEsB,iBACpB,IAAI,eACJ,WAAW,kBACX;EAAY;;;;;;;;AAOZ,gBAAgB,gBACf,QAAQ"}
+{"version":3,"file":"project.d.ts","names":[],"sources":["../../src/mutator/project.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;wBA6qEsB,iBACpB,IAAI,eACJ,WAAW,kBACX;EAAY;;;;;;;;AAOZ,gBAAgB,gBACf,QAAQ"}

package/dist/mutator/project.js

@@ -5,6 +5,7 @@ import { allBlocks, graphDiff, productionGraph, stagingGraph } from "../model/pr
 import { exportProjectAsTemplateV1 } from "../model/template_serializer.js";
 import { BlockPackTemplateField, createBlockPack } from "./block-pack/block_pack.js";
 import { exportContext, getPreparedExportTemplateEnvelope } from "./context_export.js";
+import { argsErrorsFieldChange, argsErrorsOfBlock, derivedArgsValue } from "../model/args_derivation.js";
 import { getDebugFlags } from "../debug/index.js";
 import { BLOCK_STORAGE_FACADE_VERSION, UiError, extractConfig } from "@platforma-sdk/model";
 import { InitialBlockSettings, normalizeProjectMeta } from "@milaboratories/pl-model-middle-layer";
@@ -115,6 +116,18 @@ var BlockInfo = class {
 	get currentPrerunArgs() {
 		return this.currentPrerunArgsC();
 	}
+	argsErrorsC = cached(() => `${this.fields.inputsValid?.modCount}:${this.fields.currentArgs?.modCount}`, () => argsErrorsOfBlock({
+		modelAPIVersion: this.config.modelAPIVersion,
+		inputsValid: this.fields.inputsValid,
+		currentArgs: this.currentArgs
+	}));
+	/**
+	* The errors the block's `argsIssues()` found in its current args. A block whose model API
+	* version has no args issues, or that has no current args, has none.
+	*/
+	get argsErrors() {
+		return this.argsErrorsC();
+	}
 	get stagingRendered() {
 		return this.fields.stagingCtx !== void 0;
 	}
@@ -363,6 +376,14 @@ var ProjectMutator = class ProjectMutator {
 			status: "Ready"
 		};
 	}
+	/** Baggage of the root action context of a block render. */
+	blockActionContextBaggage(blockId, info) {
+		return {
+			name: this.getBlock(blockId).label,
+			blockPack: JSON.stringify(info.source),
+			blockId
+		};
+	}
 	getBlock(blockId) {
 		for (const block of allBlocks(this.struct)) if (block.id === blockId) return block;
 		throw new Error("block not found");
@@ -398,6 +419,26 @@ var ProjectMutator = class ProjectMutator {
 		}
 		return deleted;
 	}
+	/**
+	* Brings the block's `inputsValid` field in line with what its args derivation found: the run
+	* errors of its args, none when it may run with them, and no field when it has no args.
+	*/
+	setArgsErrors(blockId, derivedArgs) {
+		this.applyArgsErrorsChange(blockId, argsErrorsFieldChange(this.getBlockInfo(blockId).fields.inputsValid, derivedArgs));
+	}
+	applyArgsErrorsChange(blockId, change) {
+		switch (change.type) {
+			case "keep": return;
+			case "delete":
+				this.deleteBlockFields(blockId, "inputsValid");
+				return;
+			case "write": {
+				const ref = this.tx.createValue(Pl.JsonObject, change.data);
+				this.setBlockField(blockId, "inputsValid", ref, "Ready", change.data);
+				return;
+			}
+		}
+	}
 	updateLastModified() {
 		this.lastModified = Date.now();
 		this.lastModifiedChanged = true;
@@ -416,6 +457,7 @@ var ProjectMutator = class ProjectMutator {
 			this.setBlockFieldObj(blockId, "stagingCtxPrevious", fields.stagingCtx);
 			this.setBlockFieldObj(blockId, "stagingUiCtxPrevious", fields.stagingUiCtx);
 		}
+		this.deleteBlockFields(blockId, "stagingActionContext");
 		if (this.deleteBlockFields(blockId, "stagingOutput", "stagingCtx", "stagingUiCtx")) this.resetStagingRefreshTimestamp();
 	}
 	resetProduction(blockId) {
@@ -428,7 +470,7 @@ var ProjectMutator = class ProjectMutator {
 			this.setBlockFieldObj(blockId, "prodCtxPrevious", fields.prodCtx);
 			this.setBlockFieldObj(blockId, "prodUiCtxPrevious", fields.prodUiCtx);
 		}
-		this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs");
+		this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs", "prodActionContext");
 	}
 	/** Running blocks are reset, settled ones (Ready or finished Error) moved to limbo. Returns if
 	* either of the actions were actually performed.
@@ -441,7 +483,10 @@ var ProjectMutator = class ProjectMutator {
 			this.renderingStateChanged = true;
 			this.deleteBlockFields(blockId, "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
 			return true;
-		} else return this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs", "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
+		} else {
+			this.deleteBlockFields(blockId, "prodActionContext");
+			return this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs", "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
+		}
 	}
 	/**
 	* Gets current block state and merges with partial updates.
@@ -487,9 +532,11 @@ var ProjectMutator = class ProjectMutator {
 		const prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, initialStorageJson);
 		if (prerunArgs !== void 0) this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
 		else this.deleteBlockFields(blockId, "currentPrerunArgs");
-		const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, initialStorageJson);
-		if (!deriveArgsResult.error && deriveArgsResult.value !== void 0) this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(deriveArgsResult.value));
+		const derivedArgs = this.projectHelper.deriveArgsFromStorage(blockConfig, initialStorageJson);
+		const args = derivedArgsValue(derivedArgs);
+		if (args !== void 0) this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(args));
 		else this.deleteBlockFields(blockId, "currentArgs");
+		this.setArgsErrors(blockId, derivedArgs);
 	}
 	/** Optimally sets inputs for multiple blocks in one go */
 	setStates(requests) {
@@ -508,8 +555,9 @@ var ProjectMutator = class ProjectMutator {
 				const updatedStorageJson = this.projectHelper.applyStorageUpdateInVM(blockConfig, currentStorageJson, req.payload);
 				this.setBlockFieldObj(req.blockId, "blockStorage", this.createGzJsonFieldValueFromContent(updatedStorageJson));
 				prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, updatedStorageJson);
-				const derivedArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, updatedStorageJson);
-				args = derivedArgsResult.error ? void 0 : derivedArgsResult.value;
+				const derivedArgs = this.projectHelper.deriveArgsFromStorage(blockConfig, updatedStorageJson);
+				args = derivedArgsValue(derivedArgs);
+				this.setArgsErrors(req.blockId, derivedArgs);
 			} else {
 				this.setBlockFieldObj(req.blockId, "blockStorage", this.createGzJsonFieldValue(req.state));
 				if (req.state !== null && typeof req.state === "object" && "args" in req.state) args = req.state.args;
@@ -615,15 +663,21 @@ var ProjectMutator = class ProjectMutator {
 			blockId: this.tx.createValue(Pl.JsonString, JSON.stringify(blockId)),
 			isProduction: this.tx.createValue(Pl.JsonBool, JSON.stringify(false)),
 			context: ctx
-		});
+		}, this.blockActionContextBaggage(blockId, info));
 		this.setBlockField(blockId, "stagingCtx", Pl.wrapInEphHolder(this.tx, ctx), "NotReady");
 		this.setBlockField(blockId, "stagingUiCtx", this.exportCtx(results.context), "NotReady");
 		this.setBlockField(blockId, "stagingOutput", results.result, "NotReady");
+		if (results.actionContext !== void 0) this.setBlockField(blockId, "stagingActionContext", results.actionContext, "NotReady");
 	}
 	renderProductionFor(blockId) {
 		this.resetProduction(blockId);
 		const info = this.getBlockInfo(blockId);
 		if (info.fields.currentArgs === void 0) throw new Error(`Can't render production for block ${blockId}: currentArgs not set`);
+		const argsErrors = info.argsErrors;
+		if (argsErrors.length > 0) {
+			const messages = argsErrors.map(({ message }) => message).join("; ");
+			throw new Error(`Can't render production for block ${blockId}: ${messages}`);
+		}
 		const ctx = this.createProdCtx(this.getPendingProductionGraph().nodes.get(blockId).upstream);
 		if (this.getBlock(blockId).renderingMode === "Light") throw new Error("Can't render production for light block.");
 		const tpl = info.getTemplate(this.tx);
@@ -632,10 +686,11 @@ var ProjectMutator = class ProjectMutator {
 			blockId: this.tx.createValue(Pl.JsonString, JSON.stringify(blockId)),
 			isProduction: this.tx.createValue(Pl.JsonBool, JSON.stringify(true)),
 			context: ctx
-		});
+		}, this.blockActionContextBaggage(blockId, info));
 		this.setBlockField(blockId, "prodCtx", Pl.wrapInEphHolder(this.tx, results.context), "NotReady");
 		this.setBlockField(blockId, "prodUiCtx", this.exportCtx(results.context), "NotReady");
 		this.setBlockField(blockId, "prodOutput", results.result, "NotReady");
+		if (results.actionContext !== void 0) this.setBlockField(blockId, "prodActionContext", results.actionContext, "NotReady");
 		this.setBlockFieldObj(blockId, "prodArgs", info.fields.currentArgs);
 		if (this.blocksInLimbo.delete(blockId)) this.renderingStateChanged = true;
 	}
@@ -652,8 +707,9 @@ var ProjectMutator = class ProjectMutator {
 		if (spec.storageMode === "fromModel") {
 			storageToWrite = spec.initialStorage ?? this.projectHelper.getInitialStorageInVM(blockConfig);
 			prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, storageToWrite);
-			const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, storageToWrite);
-			args = deriveArgsResult.error ? void 0 : deriveArgsResult.value;
+			const derivedArgs = this.projectHelper.deriveArgsFromStorage(blockConfig, storageToWrite);
+			args = derivedArgsValue(derivedArgs);
+			this.setArgsErrors(blockId, derivedArgs);
 		} else if (spec.storageMode === "legacy") {
 			args = JSON.parse(spec.legacyState).args;
 			if (args === void 0) throw new Error("args is undefined in legacyState");
@@ -808,9 +864,11 @@ var ProjectMutator = class ProjectMutator {
 			const prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(newConfig, storageJson);
 			if (prerunArgs !== void 0) this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
 			else this.deleteBlockFields(blockId, "currentPrerunArgs");
-			const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(newConfig, storageJson);
-			if (!deriveArgsResult.error && deriveArgsResult.value !== void 0) this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(deriveArgsResult.value));
+			const derivedArgs = this.projectHelper.deriveArgsFromStorage(newConfig, storageJson);
+			const args = derivedArgsValue(derivedArgs);
+			if (args !== void 0) this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(args));
 			else this.deleteBlockFields(blockId, "currentArgs");
+			this.setArgsErrors(blockId, derivedArgs);
 		};
 		if (newClearState !== void 0) {
 			if (newConfig.modelAPIVersion === BLOCK_STORAGE_FACADE_VERSION) {
@@ -819,6 +877,7 @@ var ProjectMutator = class ProjectMutator {
 				this.updateLastModified();
 			} else {
 				persistBlockPack();
+				this.deleteBlockFields(blockId, "inputsValid");
 				this.setStates([{
 					modelAPIVersion: 1,
 					blockId,
@@ -834,6 +893,7 @@ var ProjectMutator = class ProjectMutator {
 				applyStorageAndDeriveArgs(migrationResult.newStorageJson);
 			} else {
 				persistBlockPack();
+				this.deleteBlockFields(blockId, "inputsValid");
 				if (info.fields.currentArgs !== void 0) this.setBlockFieldObj(blockId, "currentPrerunArgs", info.fields.currentArgs);
 			}
 			this.blocksWithChangedInputs.add(blockId);
@@ -900,6 +960,7 @@ var ProjectMutator = class ProjectMutator {
 			const blockId = queue.shift();
 			const fields = this.getBlockInfo(blockId).fields;
 			if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready") continue;
+			this.deleteBlockFields(blockId, "prodActionContext");
 			if (this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs")) {
 				stopped.push(blockId);
 				for (const downstream of activeProdGraph.traverseIdsExcludingRoots("downstream", blockId)) {