Static ReadonlyAuthorizesTrue when the action authorizes its caller itself, so a public entry point such as the
RunAction mutation may run it for an authenticated user without an MJ: Action Authorizations link. Set it only on an action that either checks an authorization the caller
must hold, or reads and writes only with the caller's own permissions. Leave it false for an
action that acts with more authority than its caller, or that reaches data or sends messages
the caller chooses but could not otherwise reach.
The engine reads the marker only from the class that runs, never from its parent classes. A subclass that overrides a marked action must declare the marker again.
Whether this action can bound what it returns to an audience (RunActionParams.Audience): everyone
besides the caller who will see its output, such as the other participants of a shared conversation.
false by default, and the engine enforces it: when a run's audience adds a reader beyond the caller,
ActionEngineServer.RunAction refuses the action with result code AUDIENCE_UNSUPPORTED, without running
it. Override to return true only when the action honours the audience in full — every record, snippet
and count it returns is something every reader may see (pass the audience to the search engine, check each
reader's entitlement to anything it scopes by, and leave out aggregates computed before that filtering).
ProtectedgetGet boolean parameter value with default
ProtectedgetGet file content from various sources based on parameters Priority: FileID > FileURL > Data parameter
Action parameters
Name of the parameter containing direct data
Name of the parameter containing file ID (default: 'FileID')
Name of the parameter containing file URL (default: 'FileURL')
Object with content and metadata
ProtectedgetGet numeric parameter value with default
ProtectedgetExtract parameter value by name (case-insensitive)
ProtectedInternalInternal method that must be implemented by derived action classes. This is where the actual action logic should be implemented.
The action execution parameters including typed context
Promise resolving to the action result
Executes the action with the provided parameters.
The action execution parameters including context
Promise resolving to the action result
ProtectedsaveSave file to MJ Storage. Uploads the content to a FileStorageAccount and creates the corresponding MJ: Files entity record.
File content as string or Buffer
Name for the file
MIME type of the file
Action parameters (for contextUser)
OptionalstorageAccountName: stringOptional: name of the storage account to use (falls back to first active)
OptionalstoragePath: stringOptional: custom storage path prefix (falls back to artifacts/{date}/{uuid}/)
The ID of the newly created MJ: Files record
Finalizes an in-progress document: renders it to a binary file, saves to MJStorage, and outputs the FileOutput param for automatic artifact creation.
After finalization, the document handle is disposed and cannot be used again.
Parameters:
Output: