@platforma-sdk/workflow-tengo 2.13.1 → 2.13.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 declare type TemplateFromFile = { readonly type: "from-file"; readonly path: string; };
-declare type TplName = "exec.monetization_to_json" | "pframes.export-single-pcolumn" | "pframes.import-dir" | "pframes.map-pframe" | "workdir.save" | "workflow.build-ctx" | "exec.R.create-renv" | "exec.python.install-deps" | "pframes.export-multiple-pcolumns" | "exec.python.create-venv" | "exec.exec" | "pframes.xsv-export-pframe" | "pframes.xsv-import-map" | "pframes.process-pcolumn-data" | "pframes.export-pframe";
+declare type TplName = "pframes.export-single-pcolumn" | "pframes.import-dir" | "pframes.map-pframe" | "workdir.save" | "workflow.build-ctx" | "exec.R.create-renv" | "exec.python.install-deps" | "pframes.export-multiple-pcolumns" | "exec.python.create-venv" | "exec.monetization_to_json" | "exec.exec" | "pframes.xsv-export-pframe" | "pframes.xsv-import-map" | "pframes.process-pcolumn-data" | "pframes.export-pframe";
 declare const Templates: Record<TplName, TemplateFromFile>;
 export { Templates };

package/dist/index.js

@@ -1,5 +1,4 @@
 module.exports = { Templates: {
-  'exec.monetization_to_json': { type: 'from-file', path: require.resolve('./tengo/tpl/exec.monetization_to_json.plj.gz') },
   'pframes.export-single-pcolumn': { type: 'from-file', path: require.resolve('./tengo/tpl/pframes.export-single-pcolumn.plj.gz') },
   'pframes.import-dir': { type: 'from-file', path: require.resolve('./tengo/tpl/pframes.import-dir.plj.gz') },
   'pframes.map-pframe': { type: 'from-file', path: require.resolve('./tengo/tpl/pframes.map-pframe.plj.gz') },
@@ -9,6 +8,7 @@ module.exports = { Templates: {
   'exec.python.install-deps': { type: 'from-file', path: require.resolve('./tengo/tpl/exec.python.install-deps.plj.gz') },
   'pframes.export-multiple-pcolumns': { type: 'from-file', path: require.resolve('./tengo/tpl/pframes.export-multiple-pcolumns.plj.gz') },
   'exec.python.create-venv': { type: 'from-file', path: require.resolve('./tengo/tpl/exec.python.create-venv.plj.gz') },
+  'exec.monetization_to_json': { type: 'from-file', path: require.resolve('./tengo/tpl/exec.monetization_to_json.plj.gz') },
   'exec.exec': { type: 'from-file', path: require.resolve('./tengo/tpl/exec.exec.plj.gz') },
   'pframes.xsv-export-pframe': { type: 'from-file', path: require.resolve('./tengo/tpl/pframes.xsv-export-pframe.plj.gz') },
   'pframes.xsv-import-map': { type: 'from-file', path: require.resolve('./tengo/tpl/pframes.xsv-import-map.plj.gz') },

package/dist/index.mjs

@@ -1,6 +1,5 @@
 import { resolve } from 'node:path';
 export const Templates = {
-  'exec.monetization_to_json': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/exec.monetization_to_json.plj.gz') },
   'pframes.export-single-pcolumn': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/pframes.export-single-pcolumn.plj.gz') },
   'pframes.import-dir': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/pframes.import-dir.plj.gz') },
   'pframes.map-pframe': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/pframes.map-pframe.plj.gz') },
@@ -10,6 +9,7 @@ export const Templates = {
   'exec.python.install-deps': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/exec.python.install-deps.plj.gz') },
   'pframes.export-multiple-pcolumns': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/pframes.export-multiple-pcolumns.plj.gz') },
   'exec.python.create-venv': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/exec.python.create-venv.plj.gz') },
+  'exec.monetization_to_json': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/exec.monetization_to_json.plj.gz') },
   'exec.exec': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/exec.exec.plj.gz') },
   'pframes.xsv-export-pframe': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/pframes.xsv-export-pframe.plj.gz') },
   'pframes.xsv-import-map': { type: 'from-file', path: resolve(import.meta.dirname, './tengo/tpl/pframes.xsv-import-map.plj.gz') },

package/dist/tengo/lib/exec.constants.lib.tengo

@@ -3,9 +3,19 @@ ARG_TYPE_EXPRESSION := "expressionRef"
 ARG_TYPE_VAR        := "variableRef" // TODO: deprecated, remove after 15 Mar 2025
 ARG_TYPES := [ARG_TYPE_STRING, ARG_TYPE_EXPRESSION, ARG_TYPE_VAR]
 
+HEAVY_QUEUE    := "heavy"
+MEDIUM_QUEUE   := "medium"
+LIGHT_QUEUE    := "light"
+UI_TASKS_QUEUE := "ui-tasks"
+
 export {
 	ARG_TYPE_STRING: ARG_TYPE_STRING,
 	ARG_TYPE_EXPRESSION: ARG_TYPE_EXPRESSION,
 	ARG_TYPE_VAR: ARG_TYPE_VAR,
-	ARG_TYPES: ARG_TYPES
+	ARG_TYPES: ARG_TYPES,
+
+	UI_TASKS_QUEUE: UI_TASKS_QUEUE,
+	LIGHT_QUEUE: LIGHT_QUEUE,
+	MEDIUM_QUEUE: MEDIUM_QUEUE,
+	HEAVY_QUEUE: HEAVY_QUEUE
 }

package/dist/tengo/lib/exec.lib.tengo

@@ -18,14 +18,9 @@ oop := import("@platforma-sdk/workflow-tengo:oop")
 validation := import("@platforma-sdk/workflow-tengo:validation")
 constants := import("@platforma-sdk/workflow-tengo:constants")
 limits := import("@platforma-sdk/workflow-tengo:exec.limits")
-monetization := import("@platforma-sdk/workflow-tengo:exec.monetization")
+monetization := import("@platforma-sdk/workflow-tengo:exec.monetization_internal")
 execConstants := import("@platforma-sdk/workflow-tengo:exec.constants")
 
-_HEAVY_QUEUE    := "heavy"
-_MEDIUM_QUEUE   := "medium"
-_LIGHT_QUEUE    := "light"
-_UI_TASKS_QUEUE := "ui-tasks"
-
 /**
  * Creates a new builder for constructing and executing commands.
  *
@@ -54,7 +49,7 @@ builder := func() {
 	//
 	// Limits
 	//
-	queue := _HEAVY_QUEUE
+	queue := execConstants.HEAVY_QUEUE
 	hasLimits := false
 	cpuRequest := undefined
 	ramRequest := undefined
@@ -90,25 +85,6 @@ builder := func() {
 
 	mnz := monetization.init()
 
-	/** Gets mnz key from opts or undefined. */
-	_getMnzOption := func(...opts) {
-		if slices.length(opts) < 1 {
-			return undefined
-		}
-		opt := opts[0]["mnz"]
-
-		// readability if: we can return undefined here
-		return is_undefined(opt) ? undefined : opt
-	}
-
-	/** Adds a monetization option if it's defined into mnzFileParams. */
-	_addMnzOption := func(fileName, ...opts) {
-		opt := _getMnzOption(opts...)
-		if !is_undefined(opt) {
-			monetization.addFileParams(mnz, fileName, opt)
-		}
-	}
-
 	stdout := "stdout.txt"
 	stderr := "stderr.txt"
 
@@ -242,7 +218,7 @@ builder := func() {
 		 * Execute command in the 'heavy' queue.
 		 */
 		inHeavyQueue: func() {
-			queue = _HEAVY_QUEUE
+			queue = execConstants.HEAVY_QUEUE
 			return self
 		},
 
@@ -250,7 +226,7 @@ builder := func() {
 		 * Execute command in the 'medium' queue.
 		 */
 		inMediumQueue: func() {
-			queue = _MEDIUM_QUEUE
+			queue = execConstants.MEDIUM_QUEUE
 			return self
 		},
 
@@ -258,7 +234,7 @@ builder := func() {
 		 * Execute command in the 'light' queue.
 		 */
 		inLightQueue: func() {
-			queue = _LIGHT_QUEUE
+			queue = execConstants.LIGHT_QUEUE
 			return self
 		},
 
@@ -266,7 +242,7 @@ builder := func() {
 		 * Execute command in the 'ui-tasks' queue.
 		 */
 		inUiQueue: func() {
-			queue = _UI_TASKS_QUEUE
+			queue = execConstants.UI_TASKS_QUEUE
 			return self
 		},
 
@@ -509,8 +485,13 @@ builder := func() {
 			return self
 		},
 
-		enableMnz: func(productName) {
-			monetization.enable(mnz, productName)
+		enableMnz: func(productKey) {
+			monetization.enable(mnz, productKey)
+			return self
+		},
+
+		setMnzDryRun: func() {
+			monetization.setDryRun(mnz, true)
 			return self
 		},
 
@@ -526,7 +507,7 @@ builder := func() {
 
 			fileName = path.canonize(fileName)
 			filesToAdd[fileName] = file
-			_addMnzOption(fileName, opts...)
+			monetization.addOption(mnz, fileName, opts...)
 			return self
 		},
 
@@ -559,7 +540,7 @@ builder := func() {
 			fileName = path.canonize(fileName)
 
 			filesToWrite[fileName] = data
-			_addMnzOption(fileName, opts...)
+			monetization.addOption(mnz, fileName, opts...)
 
 			return self
 		},

package/dist/tengo/lib/exec.monetization.lib.tengo

@@ -1,189 +1,62 @@
-/** The library provides all things to work with a monetization. */
+/** Contains a builder for monetization when we need to run monetization without exec (e.g. in pre-run). */
 
 ll := import("@platforma-sdk/workflow-tengo:ll")
-feats := import("@platforma-sdk/workflow-tengo:feats")
-
-validation := import("@platforma-sdk/workflow-tengo:validation")
-assets := import("@platforma-sdk/workflow-tengo:assets")
-internal := import("@platforma-sdk/workflow-tengo:exec.internal")
-fmt := import("fmt")
-text := import("text")
-runcmd := import("@platforma-sdk/workflow-tengo:exec.runcmd")
+monetization := import("@platforma-sdk/workflow-tengo:exec.monetization_internal")
 workdir := import("@platforma-sdk/workflow-tengo:workdir")
-render := import("@platforma-sdk/workflow-tengo:render")
+path := import("@platforma-sdk/workflow-tengo:path")
 constants := import("@platforma-sdk/workflow-tengo:exec.constants")
+smart := import("@platforma-sdk/workflow-tengo:smart")
+validation := import("@platforma-sdk/workflow-tengo:validation")
 
-_JWT_TOKEN_RESULT_ENV := "PLATFORMA_MNZ_JWT"
-
-/** Just creates a new monetization as a map of params. */
-init := func() {
-	return ll.toStrict({
-		enabled: false,
-
-		// product name of monetization, e.g. "mixcr_analyze"
-		productName: "",
-
-		// file name to the param, e.g. {fileName: { arg: "dataset", collect: ["size", "lines", "sha256"] }}
-		fileParams: {}
-	})
-}
-
-fileParamsSchema := {
-	"arg": "string",
-	"collect": [`string,regex=size|lines|sha256`]
-}
-
-schema := {
-	"enabled": "bool",
-	"productName": "string",
-	"fileParams": {"any": fileParamsSchema}
-}
+builder := func(productKey) {
+	mnz := monetization.init()
+	monetization.enable(mnz, productKey)
+	monetization.setDryRun(mnz, true)
 
-/** Same as validation.assertType(params, fileParamsSchema, ...),
- * but with prettier errors for clients. */
-_validateParams := func(params) {
-	ll.assert(ll.isMap(params), "monetization.validateParams(): mnz params must be a map")
-	ll.assert(is_string(params.arg), "monetization.validateParams(): 'arg' in {\"mnz\": {...}} param must be a string")
-	ll.assert(is_array(params.collect) && len(params.collect) > 0, "monetization.validateParams(): 'collect' in {\"mnz\": {...}} param must be non-empty an array")
-}
+	filesToAdd := {}
+	filesToWrite := {}
 
-_validateIsReady := func(mnz) {
-	validation.assertType(mnz, schema,
-		"monetization.assertIsReady(): monetization does not fit schema")
-	ll.assert(len(mnz.productName) > 0,
-		"monetization.assertIsReady(): product name must be set")
-	ll.assert(len(mnz.fileParams) > 0,
-		"monetization.assertIsReady(): at least 1 file param must be set")
-}
+	self := undefined
+	self = ll.toStrict({
+		addFile: func(fileName, file, params) {
+			ll.assert(is_string(fileName), "monetization.builder().addFile: fileName must be a string")
+			ll.assert(smart.isReference(file), "monetization.builder().addFile: file must be a reference")
 
-/** Enables the monetization for a product. */
-enable := func(mnz, productName) {
-	ll.assert(is_string(productName),
-		"monetization.enable(): product name must be a string, got %v", productName)
+			fileName = path.canonize(fileName)
+			filesToAdd[fileName] = file
+			monetization.addFileParams(mnz, fileName, params)
+			return self
+		},
 
-	validation.assertType(mnz, schema,
-		"monetization.enable(): mnz object does not fit schema")
+		writeFile: func(fileName, data, params) {
+			validation.assertType(data, ["or",
+				"string",
+				"bytes",
+				validation.reference])
 
-	mnz.enabled = true
-	mnz.productName = productName
-}
+			fileName = path.canonize(fileName)
 
-/** Is this monetization enabled and should run? */
-shouldRun := func(mnz) {
-	if mnz.enabled {
-		_validateIsReady(mnz)
-		return true
-	}
+			filesToWrite[fileName] = data
+			monetization.addFileParams(mnz, fileName, params)
 
-	return false
-}
-
-toJson := func(mnz) {
-	validation.assertType(mnz, schema,
-		"monetization.toJson(): monetization object does not fit json schema")
-
-	return ll.fromStrict(mnz)
-}
+			return self
+		},
 
-/** Adds monetization parameters by a file. */
-addFileParams := func(mnz, fileName, params) {
-	validation.assertType(mnz, schema,
-		"monetization.addFileParams(): monetization object does not fit json schema")
+		build: func() {
+			wd := workdir.builder().
+				addFiles(filesToAdd).
+				writeFiles(filesToWrite).
+				build()
 
-	_validateParams(params)
+			result := monetization.run(mnz, wd, constants.UI_TASKS_QUEUE)
 
-	validation.assertType(params, fileParamsSchema,
-		"monetization.addFileParams(): file params does not fit json schema")
-
-	ll.assert(mnz.enabled,
-		"monetization.addFileParams(): monetization must be explicitly enabled by enableMnz(productName) function")
-
-	ll.assert(is_string(fileName),
-		"monetization.addFileParams(): file name must be a string.")
+			return result
+		}
+	})
 
-	mnz.fileParams[fileName] = params
+	return self
 }
 
-/**
- * Runs monetization binary on a workdir with all files, and returns a new workdir and a resulted jwt token.
- * All resources are ephemeral,
- * the deduplication should be above this level.
- *
- * @param: mnz: monetization -- see a beginning of this file.
- * @param: wd: workdir -- workdir where all files from mnz.fileParams already exist. */
-run := func(mnz, wd, queue) {
-	_validateIsReady(mnz)
-
-	mnzSw := assets.importSoftware("@platforma-open/milaboratories.software-small-binaries:mnz-client")
-
-	builder := runcmd.builder(wd)
-
-	exprType := feats.commandExpressions ? constants.ARG_TYPE_EXPRESSION : constants.ARG_TYPE_VAR
-
-	builder.envTyped("MI_LICENSE", exprType, "{secrets.MI_LICENSE}")
-
-	opts := internal.swToRunCmdOptions(mnzSw.name, mnzSw.version, mnzSw.descriptor)
-	// load pkg var that points to mnz-client location.
-	for _, varInfo in opts.variables {
-		builder.ref(varInfo.refName, varInfo.reference)
-		builder.substitutionRule(varInfo.varName, varInfo.refName)
-	}
-
-	builder.cmdTyped(exprType, opts.cmd.value)
-	for _, arg in opts.args {
-		// now mnz-client doesn't have additional args; this line is just in case.
-		builder.argTyped(exprType, arg)
-	}
-	builder.arg("-productName").arg(mnz.productName)
-
-	// load file params
-	for fileName, param in mnz.fileParams {
-		// param is of fileParamsSchema type
-		toCollect := text.join(param.collect, ",")
-		arg := fmt.sprintf("%s:file:%s:%s", param.arg, fileName, toCollect)
-		builder.arg(arg)
-	}
-
-	builder.inQueue(queue)
-	stdout := "mnz_stdout.txt"
-	builder.stdout(stdout)
-	run := builder.build()
-
-	// save mnz_stdout.txt
-	savedWd := workdir.save(run.workdir).
-		saveFileContent(stdout).
-		build()
-
-	jwtResultAsBytes := savedWd.filesContent.getFutureInputField(stdout)
-
-	// runcmd refs gets only json/objects as values,
-	// but workdir save returns binary:1 resource type.
-	// Hence here we have to convert it to the json's string.
-	jwtResultAsString := render.create(
-		assets.importTemplate("@platforma-sdk/workflow-tengo:exec.monetization_to_json"),
-		{ resource: jwtResultAsBytes }
-	).output("jsonedData")
-
-	return ll.toStrict({
-		// other commands should run on this wd,
-		// or else they will run concurrently
-		// with monetization.
-		wdAfter: savedWd.workdir,
-
-		// mnz-client returns jwt token
-		// that we will pass to the next command as env.
-		// If we need to change env to a file, that's the place.
-		jwtEnvName: _JWT_TOKEN_RESULT_ENV,
-		jwtEnvValue: jwtResultAsString
-	})
+export {
+	builder: builder
 }
-
-export ll.toStrict({
-	init: init,
-	schema: schema,
-	enable: enable,
-	shouldRun: shouldRun,
-	toJson: toJson,
-	addFileParams: addFileParams,
-	run: run
-})

package/dist/tengo/lib/exec.monetization_internal.lib.tengo

@@ -0,0 +1,266 @@
+/** The library provides all things to work with a monetization. */
+
+base64 := import("base64")
+json := import("json")
+
+ll := import("@platforma-sdk/workflow-tengo:ll")
+feats := import("@platforma-sdk/workflow-tengo:feats")
+
+validation := import("@platforma-sdk/workflow-tengo:validation")
+assets := import("@platforma-sdk/workflow-tengo:assets")
+internal := import("@platforma-sdk/workflow-tengo:exec.internal")
+fmt := import("fmt")
+text := import("text")
+runcmd := import("@platforma-sdk/workflow-tengo:exec.runcmd")
+workdir := import("@platforma-sdk/workflow-tengo:workdir")
+render := import("@platforma-sdk/workflow-tengo:render")
+constants := import("@platforma-sdk/workflow-tengo:exec.constants")
+slices := import("@platforma-sdk/workflow-tengo:slices")
+sets := import("@platforma-sdk/workflow-tengo:sets")
+
+_JWT_TOKEN_RESULT_ENV := "PLATFORMA_MNZ_JWT"
+
+/** mnz-client will print the response from milm to stdout as-is. */
+mnzClientStdoutSchema := ["or",
+	// run-spec response
+	{ jwtToken: "string" },
+
+	// dry-run response
+	{ mnz: {
+		details: {
+			spentRuns: "number",
+			runsToSpend: "number",
+			willRemainAfterRun: "number",
+			subscription: {
+				availableRuns: "number",
+				startsAt: "string",
+				expiresAt: "string"
+			}
+		}
+	}}
+	]
+
+/** Just creates a new monetization as a map of params. */
+init := func() {
+	return ll.toStrict({
+		enabled: false,
+
+		// product key of monetization
+		productKey: "",
+
+		// just returns a number of runs without the actual calculation.
+		// Also, returns a number of remaining runs, a number of total runs etc.
+		isDryRun: false,
+
+		// file name to the param, e.g. {fileName: { arg: "dataset", collect: ["size", "lines", "sha256"] }}
+		fileParams: {}
+	})
+}
+
+fileParamsSchema := {
+	"arg": "string",
+	"collect": [`string,regex=size|lines|sha256`]
+}
+
+schema := {
+	"enabled": "bool",
+	"productKey": "string",
+	"isDryRun": "bool",
+	"fileParams": {"any": fileParamsSchema}
+}
+
+/** Same as validation.assertType(params, fileParamsSchema, ...),
+ * but with prettier errors for clients. */
+_validateParams := func(params) {
+	ll.assert(ll.isMap(params), "monetization.validateParams(): mnz params must be a map")
+
+	ll.assert(is_string(params.arg), "monetization.validateParams(): 'arg' in addFileParams must be string")
+
+	ll.assert(is_array(params.collect) && len(params.collect) > 0, "monetization.validateParams(): 'collect' in {\"mnz\": {...}} param must be non-empty an array")
+
+	ll.assert(slices.every(params.collect, func(elem) {
+		return {
+			size: true,
+			lines: true,
+			sha256: true
+		}[elem]
+	}), "monetization.validateParams(): params in 'collect' must be either 'size', 'lines' or 'sha256'")
+}
+
+_validateIsReady := func(mnz) {
+	validation.assertType(mnz, schema,
+		"monetization.assertIsReady(): monetization does not fit schema")
+	ll.assert(len(mnz.productKey) > 0,
+		"monetization.assertIsReady(): product key must be set")
+
+	// We don't need it, since we could run software without file params
+	// ll.assert(len(mnz.fileParams) > 0,
+	// 	"monetization.assertIsReady(): at least 1 file param must be set")
+}
+
+/** Enables the monetization for a product. */
+enable := func(mnz, productKey) {
+	ll.assert(is_string(productKey),
+		"monetization.enable(): product key must be a string, got %v", productKey)
+
+	validation.assertType(mnz, schema,
+		"monetization.enable(): mnz object does not fit schema")
+
+	mnz.enabled = true
+	mnz.productKey = productKey
+}
+
+setDryRun := func(mnz, isDryRun) {
+	ll.assert(mnz.enabled,
+		"monetization.setDryRun(): monetization must be explicitly enabled by enableMnz(productKey) function")
+
+	ll.assert(is_bool(isDryRun),
+		"monetization.setDryRun(): isDryRun must be boolean, got %v", isDryRun)
+
+	validation.assertType(mnz, schema,
+		"monetization.setDryRun(): mnz object does not fit schema")
+
+	mnz.isDryRun = isDryRun
+}
+
+/** Is this monetization enabled and should run? */
+shouldRun := func(mnz) {
+	if mnz.enabled {
+		_validateIsReady(mnz)
+		return true
+	}
+
+	return false
+}
+
+toJson := func(mnz) {
+	validation.assertType(mnz, schema,
+		"monetization.toJson(): monetization object does not fit json schema")
+
+	return ll.fromStrict(mnz)
+}
+
+/** Adds monetization parameters by a file. */
+addFileParams := func(mnz, fileName, params) {
+	validation.assertType(mnz, schema,
+		"monetization.addFileParams(): monetization object does not fit json schema")
+
+	_validateParams(params)
+
+	validation.assertType(params, fileParamsSchema,
+		"monetization.addFileParams(): file params does not fit json schema")
+
+	ll.assert(mnz.enabled,
+		"monetization.addFileParams(): monetization must be explicitly enabled by enableMnz(productKey) function")
+
+	ll.assert(is_string(fileName),
+		"monetization.addFileParams(): file name must be a string.")
+
+	mnz.fileParams[fileName] = params
+}
+
+/**
+ * Runs monetization binary on a workdir with all files, and returns a new workdir and a resulted jwt token.
+ * All resources are ephemeral,
+ * the deduplication should be above this level.
+ *
+ * @param: mnz: monetization -- see a beginning of this file.
+ * @param: wd: workdir -- workdir where all files from mnz.fileParams already exist.
+ * @param: queue: queue - in which queue we should run monetization. */
+run := func(mnz, wd, queue) {
+	_validateIsReady(mnz)
+
+	exprType := feats.commandExpressions ? constants.ARG_TYPE_EXPRESSION : constants.ARG_TYPE_VAR
+
+	mnzSw := assets.importSoftware("@platforma-open/milaboratories.software-small-binaries:mnz-client")
+	builder := runcmd.builder(wd)
+	builder.envTyped("MI_LICENSE", exprType, "{secrets.MI_LICENSE}")
+
+	opts := internal.swToRunCmdOptions(mnzSw.name, mnzSw.version, mnzSw.descriptor)
+	// load pkg var that points to mnz-client location.
+	for _, varInfo in opts.variables {
+		builder.ref(varInfo.refName, varInfo.reference)
+		builder.substitutionRule(varInfo.varName, varInfo.refName)
+	}
+
+	builder.cmdTyped(exprType, opts.cmd.value)
+	for _, arg in opts.args {
+		// now mnz-client doesn't have additional args; this line is just in case.
+		builder.argTyped(exprType, arg)
+	}
+	if mnz.isDryRun {
+		builder.arg("-dry-run")
+	}
+	builder.arg("-productKey").arg(mnz.productKey)
+
+	// load file params
+	for fileName, param in mnz.fileParams {
+		// param is of fileParamsSchema type
+		toCollect := text.join(param.collect, ",")
+		arg := fmt.sprintf("%s:file:%s:%s", param.arg, fileName, toCollect)
+		builder.arg(arg)
+	}
+
+	builder.inQueue(queue)
+	stdoutName := "mnz_stdout.txt"
+	builder.stdout(stdoutName)
+	run := builder.build()
+
+	// save mnz_stdout.txt
+	savedWd := workdir.save(run.workdir).
+		saveFileContent(stdoutName).
+		build()
+
+	stdout := savedWd.filesContent.getFutureInputField(stdoutName)
+
+	result := render.createEphemeral(
+		assets.importTemplate("@platforma-sdk/workflow-tengo:exec.monetization_to_json"),
+		{ resource: stdout }
+	)
+
+	return ll.toStrict({
+		// other commands should run on this wd,
+		// or else they will run concurrently
+		// with monetization.
+		wdAfter: savedWd.workdir,
+
+		// mnz-client returns jwt token
+		// that we will pass to the next command as env.
+		jwtEnvName: _JWT_TOKEN_RESULT_ENV,
+		jwtEnvValue: result.output("jwtToken"),
+
+		info: result.output("info")
+	})
+}
+
+/** Gets mnz key from opts or undefined. */
+_extractOption := func(...opts) {
+	if slices.length(opts) < 1 {
+		return undefined
+	}
+	opt := opts[0]["mnz"]
+
+	// readability if: we can return undefined here
+	return is_undefined(opt) ? undefined : opt
+}
+
+/** Adds a monetization option if it's defined into mnzFileParams. */
+addOption := func(mnz, fileName, ...opts) {
+	opt := _extractOption(opts...)
+	if !is_undefined(opt) {
+		addFileParams(mnz, fileName, opt)
+	}
+}
+
+export ll.toStrict({
+	init: init,
+	schema: schema,
+	enable: enable,
+	setDryRun: setDryRun,
+	shouldRun: shouldRun,
+	toJson: toJson,
+	addFileParams: addFileParams,
+	addOption: addOption,
+	run: run,
+	mnzClientStdoutSchema: mnzClientStdoutSchema
+})

package/dist/tengo/lib/slices.lib.tengo

@@ -139,11 +139,11 @@ map := func(slice, fn) {
  * a function that gets a result got so far and an element and returns a new result.
  * @return final result: any - the final result
  */
-reduce := func(slice, fn) {
+reduce := func(slice, fn, ...init) {
 	result := undefined
 	for i, elem in slice {
 		if i == 0 {
-			result = elem
+			result = len(init) > 0 ? init : elem
 		} else {
 			result = fn(result, elem)
 		}
@@ -152,6 +152,16 @@ reduce := func(slice, fn) {
 	return result
 }
 
+/** Returns true if the function applied to every element returns true. */
+every := func(slice, fn) {
+	for _, elem in slice {
+		if !fn(elem) {
+			return false
+		}
+	}
+	return true
+}
+
 //
 // Simple quick-sort implementations:
 //   - with user-provided ordering
@@ -159,45 +169,45 @@ reduce := func(slice, fn) {
 //
 
 _quickSortFn := func(arr, left, right, less) {
-    if is_undefined(arr) || len(arr) <= 1 || left < 0 || left >= len(arr) || right < 0 || right >= len(arr) || left >= right {
-        return arr
-    }
-    idx := left
-    for i := left; i < right; i++ {
-        if less(arr[i], arr[right]) {
+	if is_undefined(arr) || len(arr) <= 1 || left < 0 || left >= len(arr) || right < 0 || right >= len(arr) || left >= right {
+		return arr
+	}
+	idx := left
+	for i := left; i < right; i++ {
+		if less(arr[i], arr[right]) {
 			temp := arr[i]
 			arr[i] = arr[idx]
 			arr[idx] = temp
-            idx++
-        }
-    }
+			idx++
+		}
+	}
 	temp := arr[right]
 	arr[right] = arr[idx]
 	arr[idx] = temp
-    _quickSortFn(arr, left, idx-1, less)
-    _quickSortFn(arr, idx+1, right, less)
-    return arr
+	_quickSortFn(arr, left, idx-1, less)
+	_quickSortFn(arr, idx+1, right, less)
+	return arr
 }
 
 _quickSort := func(arr, left, right) {
-    if is_undefined(arr) || len(arr) <= 1 || left < 0 || left >= len(arr) || right < 0 || right >= len(arr) || left >= right {
-        return arr
-    }
-    idx := left
-    for i := left; i < right; i++ {
-        if arr[i] < arr[right] {
+	if is_undefined(arr) || len(arr) <= 1 || left < 0 || left >= len(arr) || right < 0 || right >= len(arr) || left >= right {
+		return arr
+	}
+	idx := left
+	for i := left; i < right; i++ {
+		if arr[i] < arr[right] {
 			temp := arr[i]
 			arr[i] = arr[idx]
 			arr[idx] = temp
-            idx++
-        }
-    }
+			idx++
+		}
+	}
 	temp := arr[right]
 	arr[right] = arr[idx]
 	arr[idx] = temp
-    _quickSort(arr, left, idx-1)
-    _quickSort(arr, idx+1, right)
-    return arr
+	_quickSort(arr, left, idx-1)
+	_quickSort(arr, idx+1, right)
+	return arr
 }
 
 /**
@@ -309,6 +319,7 @@ export ll.toStrict({
 	filter: filter,
 	map: map,
 	reduce: reduce,
+	every: every,
 	quickSortInPlace: quickSortInPlace,
 	quickSort: quickSort,
 	quickSortFn: quickSortFn,

package/dist/tengo/lib/workdir.lib.tengo

@@ -254,6 +254,12 @@ _fill := func() {
 			return self
 		},
 
+		/** Creates nested dirs. */
+		mkDirs: func(dirs) {
+			enum.each(dirs, self.mkDir)
+			return self
+		},
+
 		/**
 		 * Builds the filled workdir.
 		 *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/workflow-tengo",
-  "version": "2.13.1",
+  "version": "2.13.3",
   "description": "Tengo SDK library",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "@milaboratories/software-pframes-conv": "2.1.12",
-    "@platforma-open/milaboratories.software-small-binaries": "^1.15.6"
+    "@platforma-open/milaboratories.software-small-binaries": "^1.15.13"
   },
   "devDependencies": {
     "@platforma-sdk/tengo-builder": "^1.17.7"