@memberjunction/actions 5.28.0 → 5.30.0

package/README.md

@@ -393,21 +393,24 @@ This package depends on:
 
 - [@memberjunction/global](../../MJGlobal/README.md) — ClassFactory and `@RegisterClass` decorator
 - [@memberjunction/core](../../MJCore/README.md) — `Metadata`, `RunView`, `BaseEntity`, logging utilities
-- [@memberjunction/actions-base](../Base/README.md) — Shared types (`ActionEngineBase`, `RunActionParams`, `ActionResult`, etc.)
+- [@memberjunction/actions-base](../Base/README.md) — Shared types (`ActionEngineBase`, `RunActionParams`, `ActionResult`, `RuntimeActionBridgeBuilder` abstract)
 - [@memberjunction/core-entities](../../MJCoreEntities/README.md) — Generated entity classes (`ActionExecutionLogEntity`, `ActionFilterEntity`, etc.)
-- [@memberjunction/ai](../../AI/Core/README.md) — AI model integration
-- [@memberjunction/ai-core-plus](../../AI/CorePlus/README.md) — Extended AI utilities
-- [@memberjunction/aiengine](../../AI/Engine/README.md) — AI engine orchestration
-- [@memberjunction/ai-prompts](../../AI/Prompts/README.md) — AI prompt execution
+- [@memberjunction/action-runtime](../Runtime/README.md) — Sandbox executor for `Type='Runtime'` actions
+- [@memberjunction/code-execution](../CodeExecution/README.md) — `BridgeHandlerMap` type (host-side bridge passed to the sandbox)
+- [@memberjunction/ai](../../AI/Core/README.md) — AI model integration (shared types)
+
+**Not a direct dependency any longer**: `@memberjunction/ai-agents`, `@memberjunction/ai-prompts`, `@memberjunction/aiengine`, `@memberjunction/ai-core-plus`. These used to be pulled in for the Runtime-action bridge; the bridge was extracted into [`@memberjunction/action-runtime-host`](../RuntimeHost/README.md) (top of the Actions stack), and this package now resolves the concrete bridge builder via `MJGlobal.ClassFactory.CreateInstance(RuntimeActionBridgeBuilder)`. See the RuntimeHost README for the cycle-breaking architecture.
 
 ## Related Packages
 
 - [@memberjunction/actions-base](../Base/README.md) — Shared types and base classes used by both client and server
+- [@memberjunction/action-runtime](../Runtime/README.md) — Sandboxed executor for `Type='Runtime'` actions (approval gate, input/output wiring, isolated-vm dispatch)
+- [@memberjunction/action-runtime-host](../RuntimeHost/README.md) — Default `utilities.*` bridge (md / rv / rq / entity / actions / agents / ai) exposed to sandboxed Runtime-action code
 - [CoreActions](../CoreActions/) — Built-in action implementations (Create Record, generated actions, etc.)
 - [ScheduledActions](../ScheduledActions/) — Scheduled action execution support
 - [ApolloEnrichment](../ApolloEnrichment/) — Apollo data enrichment actions
 - [ContentAutotag](../ContentAutotag/) — Content auto-tagging actions
-- [CodeExecution](../CodeExecution/) — Dynamic code execution actions
+- [CodeExecution](../CodeExecution/) — Isolated-vm sandbox + worker pool (`CodeExecutionService` used by `action-runtime`)
 
 For the Actions system philosophy and development guide, see the [Actions CLAUDE.md](../CLAUDE.md).
 

package/dist/generic/ActionEngine.d.ts

@@ -1,12 +1,33 @@
 import { MJActionExecutionLogEntity, MJActionFilterEntity } from "@memberjunction/core-entities";
-import { ActionEngineBase, MJActionEntityExtended, ActionParam, ActionResult, RunActionParams } from "@memberjunction/actions-base";
+import { ActionEngineBase, MJActionEntityExtended, ActionParam, ActionResult, ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
 /**
  * Base class for executing actions. This class can be sub-classed if desired if you would like to modify the logic across ALL actions. To do so, sub-class this class and use the
  * @RegisterClass decorator from the @memberjunction/global package to register your sub-class with the ClassFactory. This will cause your sub-class to be used instead of this base class when the Metadata object insantiates the ActionEngine.
  */
 export declare class ActionEngineServer extends ActionEngineBase {
     static get Instance(): ActionEngineServer;
+    /**
+     * Engine-default wall-clock timeout applied to any action whose
+     * `MaxExecutionTimeMS` is NULL. Intentionally generous (2 hours) because
+     * some integration actions do legitimately long sync work; per-action
+     * overrides should be used to tighten this for anything agent-facing.
+     * Sub-classes can override to globally change the default.
+     */
+    protected get DefaultActionTimeoutMS(): number;
     RunAction(params: RunActionParams): Promise<ActionResult>;
+    /**
+     * Wraps `InternalRunAction()` with a universal wall-clock timeout
+     * (`Action.MaxExecutionTimeMS`, falling back to `DefaultActionTimeoutMS`)
+     * and an `AbortSignal` passed to the action via `params.AbortSignal`.
+     *
+     * Enforcement is cooperative: when the timeout fires we set an abort on
+     * the signal so in-flight `fetch`/`setTimeout`/custom polling logic can
+     * short-circuit, and we race the action against a rejection that surfaces
+     * a `TIMEOUT` result. If the caller already supplied an `AbortSignal`
+     * (e.g. when being run from a Runtime-action bridge that has its own
+     * abort), we chain to it so either source can trigger cancellation.
+     */
+    protected RunActionWithTimeout(params: RunActionParams): Promise<ActionResult>;
     protected GetActionParamsForAction(action: MJActionEntityExtended): ActionParam[];
     /**
      * This method handles input validation. Subclasses can override this method to provide custom input validation.
@@ -23,6 +44,29 @@ export declare class ActionEngineServer extends ActionEngineBase {
      */
     protected RunSingleFilter(params: RunActionParams, filter: MJActionFilterEntity): Promise<boolean>;
     protected InternalRunAction(params: RunActionParams): Promise<ActionResult>;
+    /**
+     * Resolves and runs a Custom / Generated action via the ClassFactory.
+     * This is the pre-existing path — factored out of `InternalRunAction` so
+     * the Type dispatch is readable.
+     */
+    protected RunClassBasedAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Runs an `Action.Type='Runtime'` action by delegating to the sandboxed
+     * RuntimeActionExecutor. Approval / Status / Code-presence checks are
+     * enforced inside the executor; here we parse the RuntimeActionConfiguration,
+     * build the permissioned bridge-handler map, and hand it off.
+     *
+     * The bridge handlers run in-process on the host (not inside the sandbox)
+     * so they have full access to Metadata, RunView, ActionEngine, etc.
+     * Permission enforcement against `RuntimeActionConfiguration.permissions`
+     * happens inside each handler — see `RuntimeActionBridge.ts`.
+     *
+     * If the configuration is missing or malformed, we still let the action
+     * run in pure-compute mode (no bridge). The action's Code can then only
+     * use `input` + `libs`; any attempt to call `utilities.*` at runtime
+     * rejects with a "handler not registered" error from the worker pool.
+     */
+    protected RunRuntimeAction(params: RunActionParams): Promise<ActionResultSimple>;
     protected StartActionLog(params: RunActionParams, saveRecord?: boolean): Promise<MJActionExecutionLogEntity>;
     protected EndActionLog(logEntity: MJActionExecutionLogEntity, params: RunActionParams, result: ActionResult): Promise<void>;
     protected StartAndEndActionLog(params: RunActionParams, result: ActionResult): Promise<MJActionExecutionLogEntity>;

package/dist/generic/ActionEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionEngine.d.ts","sourceRoot":"","sources":["../../src/generic/ActionEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAiD,MAAM,+BAA+B,CAAC;AAGhJ,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAsB,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIxJ;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IAGrD,WAAkB,QAAQ,IAAI,kBAAkB,CAE/C;IAEY,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAuCtE,SAAS,CAAC,wBAAwB,CAAC,MAAM,EAAE,sBAAsB,GAAG,WAAW,EAAE;IAqCjF;;OAEG;cACa,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE;;OAEG;cACa,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrE;;;;OAIG;cACa,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;cAKxF,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;cAwDjE,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,GAAE,OAAc,GAAG,OAAO,CAAC,0BAA0B,CAAC;cAqBxG,YAAY,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY;cAcjG,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAM1H"}
+{"version":3,"file":"ActionEngine.d.ts","sourceRoot":"","sources":["../../src/generic/ActionEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAA8C,oBAAoB,EAAiD,MAAM,+BAA+B,CAAC;AAG5L,OAAO,EACH,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,eAAe,EAGlB,MAAM,8BAA8B,CAAC;AAMtC;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IAGrD,WAAkB,QAAQ,IAAI,kBAAkB,CAE/C;IAED;;;;;;OAMG;IACH,SAAS,KAAK,sBAAsB,IAAI,MAAM,CAE7C;IAEY,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAqCtE;;;;;;;;;;;OAWG;cACa,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAgFpF,SAAS,CAAC,wBAAwB,CAAC,MAAM,EAAE,sBAAsB,GAAG,WAAW,EAAE;IAqCjF;;OAEG;cACa,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE;;OAEG;cACa,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrE;;;;OAIG;cACa,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;cAKxF,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAqDjF;;;;OAIG;cACa,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYzF;;;;;;;;;;;;;;;OAeG;cACa,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;cA6FtE,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,GAAE,OAAc,GAAG,OAAO,CAAC,0BAA0B,CAAC;cAqBxG,YAAY,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY;cAoBjG,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAM1H"}

package/dist/generic/ActionEngine.js

@@ -1,7 +1,8 @@
 import { LogError, Metadata } from "@memberjunction/core";
 import { MJGlobal, SafeJSONParse, UUIDsEqual } from "@memberjunction/global";
 import { BaseAction } from "./BaseAction.js";
-import { ActionEngineBase } from "@memberjunction/actions-base";
+import { ActionEngineBase, RuntimeActionConfigurationSchema, RuntimeActionBridgeBuilder } from "@memberjunction/actions-base";
+import { RuntimeActionExecutor } from "@memberjunction/action-runtime";
 /**
  * Base class for executing actions. This class can be sub-classed if desired if you would like to modify the logic across ALL actions. To do so, sub-class this class and use the
  * @RegisterClass decorator from the @memberjunction/global package to register your sub-class with the ClassFactory. This will cause your sub-class to be used instead of this base class when the Metadata object insantiates the ActionEngine.
@@ -10,6 +11,16 @@ export class ActionEngineServer extends ActionEngineBase {
     static get Instance() {
         return super.getInstance();
     }
+    /**
+     * Engine-default wall-clock timeout applied to any action whose
+     * `MaxExecutionTimeMS` is NULL. Intentionally generous (2 hours) because
+     * some integration actions do legitimately long sync work; per-action
+     * overrides should be used to tighten this for anything agent-facing.
+     * Sub-classes can override to globally change the default.
+     */
+    get DefaultActionTimeoutMS() {
+        return 2 * 60 * 60 * 1000;
+    }
     async RunAction(params) {
         const validInputs = await this.ValidateInputs(params);
         if (!validInputs) {
@@ -39,8 +50,90 @@ export class ActionEngineServer extends ActionEngineBase {
                 result.LogEntry = await this.StartAndEndActionLog(params, result);
             }
         }
-        const runActionResult = await this.InternalRunAction(params);
-        return runActionResult;
+        return await this.RunActionWithTimeout(params);
+    }
+    /**
+     * Wraps `InternalRunAction()` with a universal wall-clock timeout
+     * (`Action.MaxExecutionTimeMS`, falling back to `DefaultActionTimeoutMS`)
+     * and an `AbortSignal` passed to the action via `params.AbortSignal`.
+     *
+     * Enforcement is cooperative: when the timeout fires we set an abort on
+     * the signal so in-flight `fetch`/`setTimeout`/custom polling logic can
+     * short-circuit, and we race the action against a rejection that surfaces
+     * a `TIMEOUT` result. If the caller already supplied an `AbortSignal`
+     * (e.g. when being run from a Runtime-action bridge that has its own
+     * abort), we chain to it so either source can trigger cancellation.
+     */
+    async RunActionWithTimeout(params) {
+        const actionTimeoutMS = params.Action.MaxExecutionTimeMS ?? this.DefaultActionTimeoutMS;
+        // Chain with any upstream AbortSignal (e.g. Runtime-action bridge).
+        const controller = new AbortController();
+        const externalSignal = params.AbortSignal;
+        const relayExternalAbort = () => {
+            if (!controller.signal.aborted) {
+                controller.abort(externalSignal?.reason ?? 'upstream abort');
+            }
+        };
+        if (externalSignal) {
+            if (externalSignal.aborted) {
+                relayExternalAbort();
+            }
+            else {
+                externalSignal.addEventListener('abort', relayExternalAbort, { once: true });
+            }
+        }
+        // Wall-clock timeout.
+        const timeoutId = setTimeout(() => {
+            if (!controller.signal.aborted) {
+                controller.abort(`Action '${params.Action.Name}' exceeded MaxExecutionTimeMS (${actionTimeoutMS}ms)`);
+            }
+        }, actionTimeoutMS);
+        // Assign the chained signal onto params so BaseAction subclasses can poll it.
+        const previousSignal = params.AbortSignal;
+        params.AbortSignal = controller.signal;
+        try {
+            const timeoutPromise = new Promise((_resolve, reject) => {
+                controller.signal.addEventListener('abort', () => {
+                    reject(new Error(String(controller.signal.reason ?? 'aborted')));
+                }, { once: true });
+            });
+            try {
+                return await Promise.race([this.InternalRunAction(params), timeoutPromise]);
+            }
+            catch (err) {
+                // Timeout or upstream abort — return a standard TIMEOUT result.
+                // Result is left undefined (we don't guarantee a 'TIMEOUT' ActionResultCode
+                // exists on every action; the Success flag + Message are the canonical
+                // failure signal for timeouts).
+                if (controller.signal.aborted) {
+                    const message = typeof controller.signal.reason === 'string'
+                        ? controller.signal.reason
+                        : `Action '${params.Action.Name}' was aborted`;
+                    const timeoutResult = {
+                        Success: false,
+                        Message: message,
+                        LogEntry: null,
+                        Params: params.Params,
+                        RunParams: params,
+                        Result: undefined
+                    };
+                    if (!params.SkipActionLog) {
+                        timeoutResult.LogEntry = await this.StartAndEndActionLog(params, timeoutResult);
+                    }
+                    return timeoutResult;
+                }
+                // Real runtime error unrelated to abort — rethrow so upstream handling catches it.
+                throw err;
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+            if (externalSignal) {
+                externalSignal.removeEventListener('abort', relayExternalAbort);
+            }
+            // Restore whatever AbortSignal the caller had in place so we don't leak our own.
+            params.AbortSignal = previousSignal;
+        }
     }
     GetActionParamsForAction(action) {
         const params = action.Params.map((param) => {
@@ -104,20 +197,17 @@ export class ActionEngineServer extends ActionEngineBase {
         // temp stub above, replace with code that will run the filter      
     }
     async InternalRunAction(params) {
-        // this is where the actual action code will be implemented
-        // first, let's get the right BaseAction derived sub-class for this particular action
-        // using ClassFactory
         let logEntry;
         if (!params.SkipActionLog) {
             logEntry = await this.StartActionLog(params);
         }
         try {
-            const action = MJGlobal.Instance.ClassFactory.CreateInstance(BaseAction, params.Action.DriverClass || params.Action.Name, params.ContextUser);
-            if (!action || action.constructor === BaseAction) {
-                throw new Error(`Could not find a class for action ${params.Action.Name}.`);
-            }
-            // we now have the action class for this particular action, so run it
-            const simpleResult = await action.Run(params);
+            // Branch by Action.Type. Runtime actions go through the sandboxed
+            // RuntimeActionExecutor; Custom / Generated (and legacy rows where
+            // Type may be null) flow through the existing ClassFactory path.
+            const simpleResult = params.Action.Type === 'Runtime'
+                ? await this.RunRuntimeAction(params)
+                : await this.RunClassBasedAction(params);
             const resultCodeEntity = this.ActionResultCodes.find(r => UUIDsEqual(r.ActionID, params.Action.ID) &&
                 r.ResultCode.trim().toLowerCase() === simpleResult.ResultCode.trim().toLowerCase());
             const result = {
@@ -126,7 +216,7 @@ export class ActionEngineServer extends ActionEngineBase {
                 Message: simpleResult.Message,
                 AIDirectives: simpleResult.AIDirectives,
                 LogEntry: logEntry,
-                Params: simpleResult.Params || params.Params, // use the params from the simple result if provided, otherwise use the original params
+                Params: simpleResult.Params || params.Params,
                 Result: resultCodeEntity
             };
             if (logEntry) {
@@ -151,6 +241,111 @@ export class ActionEngineServer extends ActionEngineBase {
             return result;
         }
     }
+    /**
+     * Resolves and runs a Custom / Generated action via the ClassFactory.
+     * This is the pre-existing path — factored out of `InternalRunAction` so
+     * the Type dispatch is readable.
+     */
+    async RunClassBasedAction(params) {
+        const action = MJGlobal.Instance.ClassFactory.CreateInstance(BaseAction, params.Action.DriverClass || params.Action.Name, params.ContextUser);
+        if (!action || action.constructor === BaseAction) {
+            throw new Error(`Could not find a class for action ${params.Action.Name}.`);
+        }
+        return await action.Run(params);
+    }
+    /**
+     * Runs an `Action.Type='Runtime'` action by delegating to the sandboxed
+     * RuntimeActionExecutor. Approval / Status / Code-presence checks are
+     * enforced inside the executor; here we parse the RuntimeActionConfiguration,
+     * build the permissioned bridge-handler map, and hand it off.
+     *
+     * The bridge handlers run in-process on the host (not inside the sandbox)
+     * so they have full access to Metadata, RunView, ActionEngine, etc.
+     * Permission enforcement against `RuntimeActionConfiguration.permissions`
+     * happens inside each handler — see `RuntimeActionBridge.ts`.
+     *
+     * If the configuration is missing or malformed, we still let the action
+     * run in pure-compute mode (no bridge). The action's Code can then only
+     * use `input` + `libs`; any attempt to call `utilities.*` at runtime
+     * rejects with a "handler not registered" error from the worker pool.
+     */
+    async RunRuntimeAction(params) {
+        // Extract + validate the RuntimeActionConfiguration JSON blob. Uses
+        // the strongly-typed accessor from @memberjunction/core-entities
+        // (emitted by the JSONType codegen) rather than parsing the raw string.
+        const actionEntity = params.Action;
+        const rawConfig = actionEntity.RuntimeActionConfigurationObject;
+        let bridgeHandlers;
+        let preamble = '';
+        let maxBridgeCalls;
+        if (rawConfig) {
+            const parsed = RuntimeActionConfigurationSchema.safeParse(rawConfig);
+            if (!parsed.success) {
+                return {
+                    Success: false,
+                    ResultCode: 'INVALID_CONFIG',
+                    Message: `Runtime action '${params.Action.Name}' has a malformed ` +
+                        `RuntimeActionConfiguration: ${parsed.error.message}`,
+                    Params: params.Params
+                };
+            }
+            // Cast to the JSONType-emitted interface: the Zod-inferred type
+            // has optional fields due to how `z.object()` composes with this
+            // repo's non-strict TS config; the runtime validation above has
+            // already proven the shape is valid, so the narrowing cast is safe.
+            const config = parsed.data;
+            // Resolve the concrete bridge builder via MJ's ClassFactory. The
+            // implementation lives in `@memberjunction/action-runtime-host`
+            // (top of the stack — can statically import AIEngine, AgentRunner,
+            // ActionEngineServer, etc. without creating a cycle). If nothing
+            // is registered (the host package wasn't imported), we fall through
+            // to pure-compute mode: the user's Runtime action still runs, it
+            // just can't call any `utilities.*` bridge namespaces.
+            const builder = MJGlobal.Instance.ClassFactory.CreateInstance(RuntimeActionBridgeBuilder);
+            if (builder) {
+                bridgeHandlers = builder.BuildHandlers({
+                    action: params.Action,
+                    config,
+                    contextUser: params.ContextUser,
+                    abortSignal: params.AbortSignal
+                });
+                preamble = builder.GetPreamble();
+            }
+            maxBridgeCalls = config.limits?.maxBridgeCalls;
+        }
+        // If we built a preamble, inject it BEFORE the user's code so
+        // `globalThis.utilities` is available from the first line. The
+        // executor wraps everything in an async IIFE — the preamble runs
+        // inside that same IIFE.
+        const codeToRun = preamble
+            ? `${preamble}\n${params.Action.Code ?? ''}`
+            : params.Action.Code ?? '';
+        // We mutate a defensive copy of the action entity so the executor sees
+        // the prepended preamble without modifying the live MJActionEntity
+        // instance (which the rest of the ActionEngine may still reference).
+        const actionForExecution = Object.create(Object.getPrototypeOf(params.Action), Object.getOwnPropertyDescriptors(params.Action));
+        // The executor checks `action.Code`; override just that getter.
+        Object.defineProperty(actionForExecution, 'Code', {
+            value: codeToRun,
+            writable: false,
+            enumerable: true,
+            configurable: true
+        });
+        const execResult = await RuntimeActionExecutor.Instance.execute({
+            action: actionForExecution,
+            params: params.Params ?? [],
+            contextUser: params.ContextUser,
+            abortSignal: params.AbortSignal,
+            bridgeHandlers,
+            maxBridgeCalls
+        });
+        return {
+            Success: execResult.success,
+            ResultCode: execResult.resultCode,
+            Message: execResult.message,
+            Params: execResult.params
+        };
+    }
     async StartActionLog(params, saveRecord = true) {
         // this is where the log entry for the action run will be created
         const md = new Metadata();
@@ -173,7 +368,13 @@ export class ActionEngineServer extends ActionEngineBase {
     async EndActionLog(logEntity, params, result) {
         // this is where the log entry for the action run will be created
         logEntity.EndedAt = new Date();
-        logEntity.Params = JSON.stringify(params.Params);
+        // Persist the final merged param set (inputs + outputs) — Runtime actions
+        // return a fresh array from the sandbox executor that lives on
+        // `result.Params`, so logging `params.Params` would lose every new output
+        // key. Custom/Generated actions mutate `params.Params` in place, and
+        // `result.Params` falls back to that same reference, so they remain
+        // equivalent.
+        logEntity.Params = JSON.stringify(result.Params ?? params.Params);
         logEntity.ResultCode = result.Result?.ResultCode;
         logEntity.Message = result.Message;
         // save a second time to record the action ending

package/dist/generic/ActionEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionEngine.js","sourceRoot":"","sources":["../../src/generic/ActionEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ActionEngine.js","sourceRoot":"","sources":["../../src/generic/ActionEngine.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/actions",
   "type": "module",
-  "version": "5.28.0",
+  "version": "5.30.0",
   "description": "Main library for MemberJunction Actions. This library is only intended to be imported on the server side.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,8 @@
   "scripts": {
     "start": "ts-node-dev src/index.ts",
     "build": "tsc && tsc-alias -f",
-    "test": "echo \"No tests configured yet\""
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "author": "MemberJunction.com",
   "license": "ISC",
@@ -20,15 +21,14 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@memberjunction/global": "5.28.0",
-    "@memberjunction/core": "5.28.0",
-    "@memberjunction/actions-base": "5.28.0",
-    "@memberjunction/core-entities": "5.28.0",
-    "@memberjunction/ai": "5.28.0",
-    "@memberjunction/ai-core-plus": "5.28.0",
-    "@memberjunction/aiengine": "5.28.0",
-    "@memberjunction/ai-prompts": "5.28.0",
-    "@memberjunction/doc-utils": "5.28.0"
+    "@memberjunction/action-runtime": "5.30.0",
+    "@memberjunction/actions-base": "5.30.0",
+    "@memberjunction/ai": "5.30.0",
+    "@memberjunction/code-execution": "5.30.0",
+    "@memberjunction/core": "5.30.0",
+    "@memberjunction/core-entities": "5.30.0",
+    "@memberjunction/doc-utils": "5.30.0",
+    "@memberjunction/global": "5.30.0"
   },
   "repository": {
     "type": "git",

package/readme.md

@@ -1,416 +0,0 @@
-# @memberjunction/actions
-
-Server-side action execution engine for MemberJunction. This package provides the runtime infrastructure for executing actions — including input validation, filter evaluation, ClassFactory-based action dispatch, execution logging, OAuth token management, and entity-bound action invocation. It is intended for server-side use only.
-
-## Installation
-
-```bash
-npm install @memberjunction/actions
-```
-
-## Overview
-
-The Actions Engine sits between external consumers (AI agents, workflows, APIs) and the actual action implementations registered via `@RegisterClass`. It handles the full execution lifecycle: validating inputs, running pre-execution filters, dispatching to the correct `BaseAction` subclass via ClassFactory, and logging results.
-
-The package contains two subsystems:
-
-- **Generic Action Engine** — Executes standalone actions with validation, filtering, and logging
-- **Entity Action Engine** — Executes actions bound to entity records, supporting CRUD lifecycle hooks, list/view batch operations, and record validation
-
-```mermaid
-flowchart TD
-    subgraph Consumers["External Consumers"]
-        Agent["AI Agents"]
-        WF["Workflows"]
-        API["GraphQL API"]
-    end
-
-    subgraph Engine["@memberjunction/actions"]
-        AES["ActionEngineServer"]
-        EAES["EntityActionEngineServer"]
-    end
-
-    subgraph Pipeline["Execution Pipeline"]
-        Validate["Validate Inputs"]
-        Filter["Run Filters"]
-        Dispatch["ClassFactory Dispatch"]
-        Log["Execution Logging"]
-    end
-
-    subgraph Actions["Registered Actions"]
-        BA["BaseAction Subclasses"]
-        OAuth["BaseOAuthAction Subclasses"]
-    end
-
-    Consumers --> Engine
-    AES --> Validate --> Filter --> Dispatch --> Log
-    Dispatch --> BA
-    Dispatch --> OAuth
-    EAES --> AES
-
-    style Consumers fill:#2d6a9f,stroke:#1a4971,color:#fff
-    style Engine fill:#7c5295,stroke:#563a6b,color:#fff
-    style Pipeline fill:#2d8659,stroke:#1a5c3a,color:#fff
-    style Actions fill:#b8762f,stroke:#8a5722,color:#fff
-```
-
-## Key Features
-
-- **Action Execution Pipeline** — Validates inputs, evaluates filters, dispatches via ClassFactory, and logs all executions
-- **ClassFactory Dispatch** — Looks up `BaseAction` subclasses by `DriverClass` or action name at runtime
-- **Pre-Execution Filters** — `BaseActionFilter` subclasses can gate whether an action should run
-- **Execution Logging** — Automatic start/end logging to `Action Execution Logs` entity with params and result codes
-- **OAuth Token Management** — `BaseOAuthAction` provides token lifecycle (refresh, retry on auth failure, persistence)
-- **OAuth2Manager** — Standalone OAuth2 client supporting authorization code, client credentials, and refresh token flows
-- **Entity Action Invocation** — Bind actions to entity CRUD lifecycle events (BeforeCreate, AfterUpdate, etc.)
-- **Batch Entity Actions** — Run actions against Lists or Views of records with consolidated results
-- **Script Evaluation** — Entity action params support runtime script evaluation with entity context
-
-## Usage
-
-### Running a Standalone Action
-
-```typescript
-import { ActionEngineServer } from '@memberjunction/actions';
-
-// Configure the engine (typically done once at startup)
-await ActionEngineServer.Instance.Config(false, contextUser);
-
-// Find the action by name
-const action = ActionEngineServer.Instance.Actions.find(a => a.Name === 'Send Email');
-
-// Execute it
-const result = await ActionEngineServer.Instance.RunAction({
-    Action: action,
-    ContextUser: contextUser,
-    Params: [
-        { Name: 'to', Value: 'user@example.com', Type: 'Input' },
-        { Name: 'subject', Value: 'Hello', Type: 'Input' },
-        { Name: 'body', Value: 'Message content', Type: 'Input' }
-    ],
-    Filters: []
-});
-
-if (result.Success) {
-    console.log('Action completed:', result.Message);
-} else {
-    console.error('Action failed:', result.Message);
-}
-```
-
-### Creating a Custom Action
-
-All actions extend `BaseAction` and implement `InternalRunAction`. Register them with `@RegisterClass` so the engine can discover them via ClassFactory:
-
-```typescript
-import { RegisterClass } from '@memberjunction/global';
-import { BaseAction } from '@memberjunction/actions';
-import { RunActionParams, ActionResultSimple } from '@memberjunction/actions-base';
-
-@RegisterClass(BaseAction, 'My Custom Action')
-export class MyCustomAction extends BaseAction {
-    protected async InternalRunAction(params: RunActionParams): Promise<ActionResultSimple> {
-        const inputValue = params.Params.find(p => p.Name === 'input')?.Value;
-
-        // Your action logic here
-        const result = await this.doWork(inputValue);
-
-        return {
-            Success: true,
-            ResultCode: 'SUCCESS',
-            Message: `Processed: ${result}`
-        };
-    }
-
-    private async doWork(input: string): Promise<string> {
-        // Delegate to service classes for real logic
-        return `Done with ${input}`;
-    }
-}
-```
-
-### Creating an OAuth-Authenticated Action
-
-For actions that need to call external APIs with OAuth2 credentials:
-
-```typescript
-import { RegisterClass } from '@memberjunction/global';
-import { BaseOAuthAction } from '@memberjunction/actions';
-import { RunActionParams, ActionResultSimple } from '@memberjunction/actions-base';
-
-@RegisterClass(BaseAction, 'Fetch External Data')
-export class FetchExternalDataAction extends BaseOAuthAction {
-    protected async refreshAccessToken(): Promise<void> {
-        // Platform-specific token refresh logic
-        const response = await fetch('https://api.example.com/oauth/token', {
-            method: 'POST',
-            body: new URLSearchParams({
-                grant_type: 'refresh_token',
-                refresh_token: this.getRefreshToken(),
-            })
-        });
-        const data = await response.json();
-        await this.updateStoredTokens(data.access_token, data.refresh_token, data.expires_in);
-    }
-
-    protected async InternalRunAction(params: RunActionParams): Promise<ActionResultSimple> {
-        const companyIntegrationId = params.Params.find(
-            p => p.Name === 'CompanyIntegrationID'
-        )?.Value as string;
-
-        // Initialize OAuth (loads tokens, refreshes if expired)
-        if (!await this.initializeOAuth(companyIntegrationId)) {
-            return this.handleOAuthError(new Error('OAuth initialization failed'));
-        }
-
-        // Make authenticated request with automatic retry on 401
-        const data = await this.makeAuthenticatedRequest(async (token) => {
-            const res = await fetch('https://api.example.com/data', {
-                headers: { Authorization: `Bearer ${token}` }
-            });
-            return res.json();
-        });
-
-        return { Success: true, ResultCode: 'SUCCESS', Message: JSON.stringify(data) };
-    }
-}
-```
-
-### Using OAuth2Manager Directly
-
-For standalone OAuth2 token management outside the action framework:
-
-```typescript
-import { OAuth2Manager } from '@memberjunction/actions';
-
-const oauth = new OAuth2Manager({
-    clientId: 'your-client-id',
-    clientSecret: 'your-client-secret',
-    tokenEndpoint: 'https://api.example.com/oauth/token',
-    scopes: ['read', 'write'],
-    onTokenUpdate: async (tokens) => {
-        // Persist tokens to your storage
-        await saveTokens(tokens);
-    }
-});
-
-// Get a valid token (auto-refreshes if expired)
-const token = await oauth.getAccessToken();
-
-// Or use client credentials flow
-const tokenData = await oauth.getClientCredentialsToken();
-```
-
-## Architecture
-
-### Action Execution Pipeline
-
-The `ActionEngineServer.RunAction()` method follows this sequence:
-
-```mermaid
-sequenceDiagram
-    participant Caller
-    participant Engine as ActionEngineServer
-    participant Filter as BaseActionFilter
-    participant CF as ClassFactory
-    participant Action as BaseAction Subclass
-    participant Log as Execution Log
-
-    Caller->>Engine: RunAction(params)
-    Engine->>Engine: ValidateInputs(params)
-    alt Validation fails
-        Engine->>Log: StartAndEndActionLog()
-        Engine-->>Caller: {Success: false}
-    end
-    Engine->>Filter: RunFilters(params)
-    alt Filters block execution
-        Engine->>Log: StartAndEndActionLog()
-        Engine-->>Caller: {Success: true, "Filters blocked"}
-    end
-    Engine->>Log: StartActionLog()
-    Engine->>CF: CreateInstance(BaseAction, driverClass)
-    CF-->>Engine: action instance
-    Engine->>Action: Run(params)
-    Action->>Action: InternalRunAction(params)
-    Action-->>Engine: ActionResultSimple
-    Engine->>Log: EndActionLog()
-    Engine-->>Caller: ActionResult
-```
-
-### Entity Action Invocation
-
-Entity actions are bound to entity lifecycle events. The `EntityActionEngineServer` delegates to invocation-type-specific handlers via ClassFactory:
-
-```mermaid
-classDiagram
-    class EntityActionInvocationBase {
-        <<abstract>>
-        +InvokeAction(params) EntityActionResult
-        +MapParams(params, entityActionParams, entity) ActionParam[]
-        +SafeEvalScript(id, script, entity) any
-    }
-
-    class SingleRecord {
-        +InvokeAction(params) EntityActionResult
-        +ValidateParams(params) boolean
-    }
-
-    class MultipleRecords {
-        +InvokeAction(params) EntityActionResult
-        #GetRecordList() BaseEntity[]
-    }
-
-    class Validate {
-        +InvokeAction(params) EntityActionResult
-    }
-
-    EntityActionInvocationBase <|-- SingleRecord
-    EntityActionInvocationBase <|-- MultipleRecords
-    SingleRecord <|-- Validate
-
-    note for SingleRecord "Registered for: Read, BeforeCreate,\nBeforeUpdate, BeforeDelete, AfterCreate,\nAfterUpdate, AfterDelete, SingleRecord"
-    note for MultipleRecords "Registered for: List, View"
-    note for Validate "Registered for: Validate"
-```
-
-### Class Hierarchy
-
-```mermaid
-classDiagram
-    class BaseAction {
-        <<abstract>>
-        +Run(params) ActionResultSimple
-        #InternalRunAction(params)* ActionResultSimple
-    }
-
-    class BaseOAuthAction {
-        <<abstract>>
-        #initializeOAuth(id) boolean
-        #getAccessToken() string
-        #makeAuthenticatedRequest(fn) T
-        #refreshAccessToken()* void
-    }
-
-    class BaseActionFilter {
-        <<abstract>>
-        +Run(params, filter) boolean
-        #InternalRun(params, filter)* boolean
-    }
-
-    class ActionEngineServer {
-        +RunAction(params) ActionResult
-        #ValidateInputs(params) boolean
-        #RunFilters(params) boolean
-        #InternalRunAction(params) ActionResult
-    }
-
-    class EntityActionEngineServer {
-        +RunEntityAction(params) EntityActionResult
-    }
-
-    class OAuth2Manager {
-        +getAccessToken() string
-        +getAuthorizationUrl() string
-        +exchangeAuthorizationCode(code) OAuth2TokenData
-        +getClientCredentialsToken() OAuth2TokenData
-        +refreshAccessToken() OAuth2TokenData
-    }
-
-    BaseAction <|-- BaseOAuthAction
-    ActionEngineServer --> BaseAction : dispatches to
-    ActionEngineServer --> BaseActionFilter : evaluates
-    EntityActionEngineServer --> ActionEngineServer : delegates to
-    BaseOAuthAction --> OAuth2Manager : can use
-```
-
-## API Reference
-
-### ActionEngineServer
-
-Singleton engine that executes actions. Access via `ActionEngineServer.Instance`.
-
-| Method | Description |
-|--------|-------------|
-| `Config(forceRefresh, contextUser)` | Initialize/refresh the engine's action and filter metadata |
-| `RunAction(params)` | Execute an action through the full pipeline (validate, filter, dispatch, log) |
-
-### BaseAction
-
-Abstract base class for all action implementations.
-
-| Method | Description |
-|--------|-------------|
-| `Run(params)` | Public entry point — calls `InternalRunAction` |
-| `InternalRunAction(params)` | **Abstract** — implement your action logic here |
-
-### BaseOAuthAction
-
-Abstract base for actions requiring OAuth authentication. Extends `BaseAction`.
-
-| Method | Description |
-|--------|-------------|
-| `initializeOAuth(companyIntegrationId)` | Load integration, check/refresh tokens |
-| `getAccessToken()` | Get the current access token |
-| `makeAuthenticatedRequest(fn)` | Execute a request with automatic retry on 401/403 |
-| `refreshAccessToken()` | **Abstract** — implement platform-specific token refresh |
-| `updateStoredTokens(access, refresh?, expiresIn?)` | Persist new tokens to the Company Integration entity |
-| `handleOAuthError(error)` | Return a standardized error result for OAuth failures |
-
-### BaseActionFilter
-
-Abstract base for pre-execution filters.
-
-| Method | Description |
-|--------|-------------|
-| `Run(params, filter)` | Public entry point — calls `InternalRun` |
-| `InternalRun(params, filter)` | **Abstract** — implement filter logic, return `true` to allow execution |
-
-### EntityActionEngineServer
-
-Singleton engine for entity-bound actions. Access via `EntityActionEngineServer.Instance`.
-
-| Method | Description |
-|--------|-------------|
-| `RunEntityAction(params)` | Execute an entity action, dispatching to the correct invocation type handler |
-
-### OAuth2Manager
-
-Standalone OAuth2 token manager supporting multiple grant types.
-
-| Method | Description |
-|--------|-------------|
-| `getAccessToken()` | Get a valid token, auto-refreshing if needed (thread-safe) |
-| `getAuthorizationUrl(state?)` | Build the authorization URL for auth code flow |
-| `exchangeAuthorizationCode(code)` | Exchange an auth code for tokens |
-| `getClientCredentialsToken()` | Obtain tokens via client credentials flow |
-| `refreshAccessToken()` | Refresh using the stored refresh token |
-| `setTokens(access, refresh?, expiresIn?)` | Set tokens obtained externally |
-| `isTokenValid()` | Check if current token is valid (with buffer) |
-
-## Dependencies
-
-This package depends on:
-
-- [@memberjunction/global](../../MJGlobal/README.md) — ClassFactory and `@RegisterClass` decorator
-- [@memberjunction/core](../../MJCore/README.md) — `Metadata`, `RunView`, `BaseEntity`, logging utilities
-- [@memberjunction/actions-base](../Base/README.md) — Shared types (`ActionEngineBase`, `RunActionParams`, `ActionResult`, etc.)
-- [@memberjunction/core-entities](../../MJCoreEntities/README.md) — Generated entity classes (`ActionExecutionLogEntity`, `ActionFilterEntity`, etc.)
-- [@memberjunction/ai](../../AI/Core/README.md) — AI model integration
-- [@memberjunction/ai-core-plus](../../AI/CorePlus/README.md) — Extended AI utilities
-- [@memberjunction/aiengine](../../AI/Engine/README.md) — AI engine orchestration
-- [@memberjunction/ai-prompts](../../AI/Prompts/README.md) — AI prompt execution
-
-## Related Packages
-
-- [@memberjunction/actions-base](../Base/README.md) — Shared types and base classes used by both client and server
-- [CoreActions](../CoreActions/) — Built-in action implementations (Create Record, generated actions, etc.)
-- [ScheduledActions](../ScheduledActions/) — Scheduled action execution support
-- [ApolloEnrichment](../ApolloEnrichment/) — Apollo data enrichment actions
-- [ContentAutotag](../ContentAutotag/) — Content auto-tagging actions
-- [CodeExecution](../CodeExecution/) — Dynamic code execution actions
-
-For the Actions system philosophy and development guide, see the [Actions CLAUDE.md](../CLAUDE.md).
-
-## Contributing
-
-See the [MemberJunction Contributing Guide](../../../CONTRIBUTING.md) for development setup and guidelines.