ultravisor 1.0.20 → 1.0.22

package/source/services/tasks/data-transform/definitions/random-string.json

@@ -0,0 +1,23 @@
+{
+	"Hash": "random-string",
+	"Type": "random-string",
+	"Name": "Random String",
+	"Description": "Generates a random string. Useful for unique filenames, run IDs, and identifiers.",
+	"Category": "data",
+	"Capability": "Data Transform",
+	"Action": "GenerateRandomString",
+	"Tier": "Engine",
+	"EventInputs": [{ "Name": "Generate" }],
+	"EventOutputs": [
+		{ "Name": "Complete" },
+		{ "Name": "Error", "IsError": true }
+	],
+	"SettingsInputs": [
+		{ "Name": "Length", "DataType": "Number", "Required": false, "Description": "Length of the generated string. Default: 16" },
+		{ "Name": "Format", "DataType": "String", "Required": false, "Description": "Format: hex, alphanumeric, uuid. Default: hex" }
+	],
+	"StateOutputs": [
+		{ "Name": "Value", "DataType": "String", "Description": "The generated random string" }
+	],
+	"DefaultSettings": { "Length": 16, "Format": "hex" }
+}

package/source/services/tasks/extension/Ultravisor-TaskConfigs-Extension.cjs

@@ -46,12 +46,24 @@ module.exports =
 				});
 			}
 
-			// Build work item settings from resolved settings
-			let tmpSettings = {
-				Command: pResolvedSettings.Command || '',
-				Parameters: pResolvedSettings.Parameters || '',
-				InputData: pResolvedSettings.InputData || ''
-			};
+			// Build work item settings from ALL resolved settings
+			// (includes node Data fields + state connection values)
+			let tmpSettings = {};
+			let tmpResolvedKeys = Object.keys(pResolvedSettings);
+			for (let rk = 0; rk < tmpResolvedKeys.length; rk++)
+			{
+				let tmpKey = tmpResolvedKeys[rk];
+				// Skip internal/meta fields that aren't work item settings
+				if (tmpKey === 'RemoteCapability' || tmpKey === 'RemoteAction'
+					|| tmpKey === 'AffinityKey' || tmpKey === 'TimeoutMs'
+					|| tmpKey === 'PromptMessage' || tmpKey === 'OutputAddress'
+					|| tmpKey === 'InputSchema') continue;
+				tmpSettings[tmpKey] = pResolvedSettings[tmpKey];
+			}
+			// Ensure legacy fields exist for backward compat
+			if (!tmpSettings.Command) tmpSettings.Command = '';
+			if (!tmpSettings.Parameters) tmpSettings.Parameters = '';
+			if (!tmpSettings.InputData) tmpSettings.InputData = '';
 
 			// Resolve universal addresses in InputData (JSON string).
 			// Addresses like >retold-remote/File/path become concrete
@@ -122,7 +134,7 @@ module.exports =
 			// Pause execution — the BeaconCoordinator will call resumeOperation when the Beacon reports back
 			return fCallback(null, {
 				WaitingForInput: true,
-				ResumeEventName: 'Complete',
+				ResumeEventName: 'complete',
 				PromptMessage: `Waiting for Beacon worker (${tmpWorkItemInfo.Capability}/${tmpWorkItemInfo.Action})`,
 				OutputAddress: '',
 				Outputs: {},

package/source/services/tasks/user-interaction/Ultravisor-TaskConfigs-UserInteraction.cjs

@@ -106,14 +106,42 @@ module.exports =
 				if (tmpExistingValue !== undefined && tmpExistingValue !== null && tmpExistingValue !== '')
 				{
 					return fCallback(null, {
-						EventToFire: 'ValueInputComplete',
+						EventToFire: 'complete',
 						Outputs: { InputValue: tmpExistingValue },
 						Log: [`Auto-resolved from pre-seeded state: "${tmpOutputAddress}" = "${String(tmpExistingValue).substring(0, 100)}"`]
 					});
 				}
 			}
 
-			// No pre-seeded value — pause and wait for interactive input
+			// If the operation was triggered programmatically (has pre-seeded params),
+			// use the DefaultValue so the whole chain runs without pausing
+			let tmpIsProgrammatic = pExecutionContext.OperationState
+				&& Object.keys(pExecutionContext.OperationState).length > 0;
+			let tmpDefaultValue = pResolvedSettings.DefaultValue
+				|| (pResolvedSettings.InputSchema && pResolvedSettings.InputSchema.Default !== undefined
+					? String(pResolvedSettings.InputSchema.Default) : undefined);
+			if (tmpIsProgrammatic && tmpDefaultValue !== undefined && tmpDefaultValue !== null && tmpDefaultValue !== '')
+			{
+				return fCallback(null, {
+					EventToFire: 'complete',
+					Outputs: { InputValue: tmpDefaultValue },
+					Log: [`Auto-resolved from default: "${tmpOutputAddress}" = "${String(tmpDefaultValue).substring(0, 100)}"`]
+				});
+			}
+
+			// For optional fields with no default in programmatic mode, pass empty string
+			let tmpIsOptional = pResolvedSettings.InputSchema
+				&& pResolvedSettings.InputSchema.Required === false;
+			if (tmpIsProgrammatic && tmpIsOptional)
+			{
+				return fCallback(null, {
+					EventToFire: 'complete',
+					Outputs: { InputValue: '' },
+					Log: [`Auto-resolved optional field: "${tmpOutputAddress}" = "" (no value provided)`]
+				});
+			}
+
+			// No pre-seeded value and no default — pause and wait for interactive input
 			let tmpOptions = pResolvedSettings.Options || '';
 			if (Array.isArray(tmpOptions))
 			{

package/source/services/tasks/user-interaction/Ultravisor-TaskType-ValueInput.cjs

@@ -29,15 +29,69 @@ class UltravisorTaskTypeValueInput extends libTaskTypeBase
 		let tmpPromptMessage = pResolvedSettings.PromptMessage || 'Please provide a value:';
 		let tmpOutputAddress = pResolvedSettings.OutputAddress || '';
 
-		// Signal that this task is waiting for input
+		// Auto-resolve: if the output address already has a value in state
+		// (e.g., pre-seeded via /Operation/:Hash/Trigger with Parameters),
+		// skip the pause and fire immediately. This lets operations work both
+		// interactively (flow editor — pauses for input) and programmatically
+		// (API trigger / retold-labs operation runner — runs straight through).
+		if (tmpOutputAddress && pExecutionContext.StateManager)
+		{
+			let tmpExistingValue = pExecutionContext.StateManager.resolveAddress(
+				tmpOutputAddress, pExecutionContext, pExecutionContext.NodeHash);
+			if (tmpExistingValue !== undefined && tmpExistingValue !== null && tmpExistingValue !== '')
+			{
+				return fCallback(null, {
+					EventToFire: 'complete',
+					Outputs: { InputValue: tmpExistingValue },
+					Log: [`Auto-resolved from pre-seeded state: "${tmpOutputAddress}" = "${String(tmpExistingValue).substring(0, 100)}"`]
+				});
+			}
+		}
+
+		// If the operation was triggered programmatically (OperationState has pre-seeded values),
+		// auto-resolve using the DefaultValue so the whole chain runs without pausing.
+		// In interactive mode (empty OperationState), pause for user input.
+		let tmpIsProgrammatic = pExecutionContext.OperationState
+			&& Object.keys(pExecutionContext.OperationState).length > 0;
+		let tmpDefaultValue = pResolvedSettings.DefaultValue
+			|| (pResolvedSettings.InputSchema && pResolvedSettings.InputSchema.Default !== undefined
+				? String(pResolvedSettings.InputSchema.Default) : undefined);
+		if (tmpIsProgrammatic && tmpDefaultValue !== undefined && tmpDefaultValue !== null && tmpDefaultValue !== '')
+		{
+			return fCallback(null, {
+				EventToFire: 'complete',
+				Outputs: { InputValue: tmpDefaultValue },
+				Log: [`Auto-resolved from default: "${tmpOutputAddress}" = "${String(tmpDefaultValue).substring(0, 100)}"`]
+			});
+		}
+
+		// For optional fields with no default in programmatic mode, pass empty string
+		let tmpIsOptional = pResolvedSettings.InputSchema
+			&& pResolvedSettings.InputSchema.Required === false;
+		if (tmpIsProgrammatic && tmpIsOptional)
+		{
+			return fCallback(null, {
+				EventToFire: 'complete',
+				Outputs: { InputValue: '' },
+				Log: [`Auto-resolved optional field: "${tmpOutputAddress}" = "" (no value provided)`]
+			});
+		}
+
+		// No pre-seeded value and no default — pause and wait for interactive input
 		// The ExecutionEngine will set the run to WaitingForInput status
+		let tmpOptions = pResolvedSettings.Options || '';
+		if (Array.isArray(tmpOptions))
+		{
+			tmpOptions = JSON.stringify(tmpOptions);
+		}
+
 		return fCallback(null, {
 			WaitingForInput: true,
 			PromptMessage: tmpPromptMessage,
 			OutputAddress: tmpOutputAddress,
 			InputType: pResolvedSettings.InputType || 'text',
 			DefaultValue: pResolvedSettings.DefaultValue || '',
-			Options: pResolvedSettings.Options || '',
+			Options: tmpOptions,
 			Outputs: {},
 			Log: [`Waiting for input: "${tmpPromptMessage}" (-> ${tmpOutputAddress})`]
 		});

package/source/web_server/Ultravisor-API-Server.cjs

@@ -253,6 +253,60 @@ class UltravisorAPIServer extends libPictService
 				}.bind(this)
 			);
 
+		// --- Operation Audit ---
+		// Static port-mapping audit across all registered operations.
+		// Cross-references beacon-dispatch nodes' state connections and
+		// Data keys against the beacon action catalog's SettingsSchema.
+		this._OratorServer.get
+			(
+				'/OperationAudit',
+				function (pRequest, pResponse, fNext)
+				{
+					let tmpAuditor = this._getService('UltravisorOperationAuditor');
+					if (!tmpAuditor)
+					{
+						pResponse.send(503, { Error: 'UltravisorOperationAuditor service not available.' });
+						return fNext();
+					}
+					tmpAuditor.auditAll(
+						function (pError, pReport)
+						{
+							if (pError)
+							{
+								pResponse.send(500, { Error: pError.message });
+								return fNext();
+							}
+							pResponse.send(pReport);
+							return fNext();
+						});
+				}.bind(this)
+			);
+
+		this._OratorServer.get
+			(
+				'/OperationAudit/:Hash',
+				function (pRequest, pResponse, fNext)
+				{
+					let tmpAuditor = this._getService('UltravisorOperationAuditor');
+					if (!tmpAuditor)
+					{
+						pResponse.send(503, { Error: 'UltravisorOperationAuditor service not available.' });
+						return fNext();
+					}
+					tmpAuditor.auditByHash(pRequest.params.Hash,
+						function (pError, pResult)
+						{
+							if (pError)
+							{
+								pResponse.send(404, { Error: pError.message });
+								return fNext();
+							}
+							pResponse.send(pResult);
+							return fNext();
+						});
+				}.bind(this)
+			);
+
 		this._OratorServer.post
 			(
 				'/Operation',
@@ -2055,6 +2109,16 @@ class UltravisorAPIServer extends libPictService
 			return;
 		}
 
+		// Diagnostic: log what we RECEIVED from the client before forwarding
+		// to registerBeacon. If the client sent HostID but we're storing null,
+		// this log line pins down exactly where the drop happens (client vs
+		// server). Gated on LogNoisiness>=2 to stay quiet in production.
+		let tmpNoisy = (this.fable && this.fable.LogNoisiness) || 0;
+		if (tmpNoisy >= 2)
+		{
+			this.log.info(`[WSRegister] received from client: Name=${pData.Name} HostID=${pData.HostID || '(none)'} SharedMounts=${JSON.stringify(pData.SharedMounts || [])} Ops=${(pData.Operations || []).length}`);
+		}
+
 		// IMPORTANT: this enumeration must include every field the coordinator
 		// cares about, including HostID and SharedMounts (used by the shared-fs
 		// reachability auto-detect). Forgetting to forward a field here means
@@ -2073,6 +2137,12 @@ class UltravisorAPIServer extends libPictService
 			SharedMounts: pData.SharedMounts
 		});
 
+		// Diagnostic: confirm what was actually STORED on the beacon record.
+		if (tmpNoisy >= 2)
+		{
+			this.log.info(`[WSRegister] stored beacon ${tmpBeacon.BeaconID}: HostID=${tmpBeacon.HostID || '(null)'} SharedMounts=${JSON.stringify(tmpBeacon.SharedMounts || [])}`);
+		}
+
 		pWebSocket._BeaconID = tmpBeacon.BeaconID;
 		this._BeaconWebSockets[tmpBeacon.BeaconID] = pWebSocket;