@memberjunction/core-actions 5.37.0 → 5.39.0

package/dist/custom/interactive-forms/create-interactive-form.action.d.ts

@@ -0,0 +1,32 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Create a net-new interactive-form override for the requesting user.
+ *
+ * **Net-new path only.** Returns ALREADY_EXISTS if the user already has an
+ * Active override for the target entity — agents should call
+ * `Get Active Form For Entity` first and route to `Modify Interactive Form`
+ * in that case. (Pending sibling overrides do NOT block creation — those
+ * are an in-flight refinement and Modify will resolve them in-place.)
+ *
+ * **Security clamp — Scope.** This action *always* writes
+ * `Scope='User', UserID=ctx.user.ID, Status='Active', Priority=0`,
+ * regardless of any scope-related parameter the caller might supply.
+ * This is the load-bearing safety property of the AI authoring path:
+ * an agent cannot write Global or Role overrides that would affect
+ * other users. Scope promotion (User → Role → Global) is a separate,
+ * deliberate human action in Component Studio / Form Builder dashboard.
+ *
+ * **Atomicity.** If the override insert fails after the Component insert
+ * succeeds, we surface PERSIST_FAILED with the Component already in the
+ * table. Orphan Components are harmless — they don't render anywhere
+ * until something points an override at them. The caller can retry; a
+ * second run will create a fresh Component and a successful override.
+ */
+export declare class CreateInteractiveFormAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private extractInputs;
+}
+/** Tree-shaking guard. */
+export declare function LoadCreateInteractiveFormAction(): void;
+//# sourceMappingURL=create-interactive-form.action.d.ts.map

package/dist/custom/interactive-forms/create-interactive-form.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-interactive-form.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/create-interactive-form.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AASrD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,2BAA4B,SAAQ,UAAU;cAEvC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoGvF,OAAO,CAAC,aAAa;CAyBxB;AAED,0BAA0B;AAC1B,wBAAgB,+BAA+B,IAAI,IAAI,CAItD"}

package/dist/custom/interactive-forms/create-interactive-form.action.js

@@ -0,0 +1,162 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError, RunView } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+import { addOutput, failure, getStringParam, insertComponent, insertOverride, lintFormSpec, parseSpecParam, } from "./_shared.js";
+/**
+ * Create a net-new interactive-form override for the requesting user.
+ *
+ * **Net-new path only.** Returns ALREADY_EXISTS if the user already has an
+ * Active override for the target entity — agents should call
+ * `Get Active Form For Entity` first and route to `Modify Interactive Form`
+ * in that case. (Pending sibling overrides do NOT block creation — those
+ * are an in-flight refinement and Modify will resolve them in-place.)
+ *
+ * **Security clamp — Scope.** This action *always* writes
+ * `Scope='User', UserID=ctx.user.ID, Status='Active', Priority=0`,
+ * regardless of any scope-related parameter the caller might supply.
+ * This is the load-bearing safety property of the AI authoring path:
+ * an agent cannot write Global or Role overrides that would affect
+ * other users. Scope promotion (User → Role → Global) is a separate,
+ * deliberate human action in Component Studio / Form Builder dashboard.
+ *
+ * **Atomicity.** If the override insert fails after the Component insert
+ * succeeds, we surface PERSIST_FAILED with the Component already in the
+ * table. Orphan Components are harmless — they don't render anywhere
+ * until something points an override at them. The caller can retry; a
+ * second run will create a fresh Component and a successful override.
+ */
+let CreateInteractiveFormAction = class CreateInteractiveFormAction extends BaseAction {
+    async InternalRunAction(params) {
+        try {
+            const inputs = this.extractInputs(params);
+            if ('error' in inputs)
+                return inputs.error;
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider)
+                return failure("NO_PROVIDER", "No metadata provider available.");
+            const user = params.ContextUser;
+            if (!user)
+                return failure("NO_USER", "Action requires a ContextUser to clamp override scope.");
+            const entityInfo = provider.EntityByName(inputs.EntityName);
+            if (!entityInfo) {
+                return failure("ENTITY_NOT_FOUND", `Entity '${inputs.EntityName}' is not registered with the active metadata provider.`);
+            }
+            // Guard: don't silently create a duplicate override. We match
+            // BOTH Active and Pending sibling overrides — either is grounds
+            // to switch to Modify on that row instead of creating a second
+            // override. (Two overrides for the same entity/user would race
+            // each other at form-resolution time.)
+            const rv = RunView.FromMetadataProvider(provider);
+            const dupResult = await rv.RunView({
+                EntityName: "MJ: Entity Form Overrides",
+                ExtraFilter: `EntityID='${entityInfo.ID}' AND Scope='User' AND UserID='${user.ID}' AND Status IN ('Active', 'Pending')`,
+                Fields: ['ID', 'Status'],
+                ResultType: 'simple',
+                MaxRows: 1,
+            }, user);
+            if (dupResult.Success && (dupResult.Results ?? []).length > 0) {
+                const existing = dupResult.Results[0];
+                return failure("ALREADY_EXISTS", `A ${existing.Status} User-scope override already exists for entity '${inputs.EntityName}' (OverrideID=${existing.ID}). Use 'Modify Interactive Form' on this OverrideID to refine it (with a VersionBumpKind of 'patch' / 'minor' / 'major' to snapshot a new version, or 'in-place' against a Pending row to keep iterating on the same version). Use 'Revert Interactive Form' to switch to a different historical version.`);
+            }
+            // Lint before any persistence — fail-hard.
+            const lintFail = await lintFormSpec(inputs.Spec, user);
+            if (lintFail)
+                return lintFail;
+            // Create v1.0.0 as Pending (NOT Active). The cockpit / agent
+            // workflow is iterative — the user will refine via the chat
+            // before they're ready to flip the form live. Creating Active
+            // here would either (a) push an empty scaffold into production
+            // as the user's actual form, or (b) force the agent's first
+            // Modify to bump a new version, leaving behind a useless
+            // v1.0.0 placeholder. Pending means the agent's first Modify
+            // hits the in-place branch and overwrites this row — no
+            // wasted version, no premature publication. The user
+            // explicitly Activates from the Form Builder dashboard when
+            // they're happy with the result.
+            const componentInsert = await insertComponent({
+                provider, user,
+                spec: inputs.Spec,
+                fallbackName: inputs.Name,
+                description: inputs.Description,
+                version: "1.0.0",
+                versionSequence: 1,
+                componentStatus: 'Pending',
+            });
+            if ('error' in componentInsert)
+                return componentInsert.error;
+            const componentID = componentInsert.id;
+            const overrideInsert = await insertOverride({
+                provider, user,
+                entityID: entityInfo.ID,
+                componentID,
+                name: inputs.Name,
+                description: inputs.Description,
+                notes: inputs.Notes,
+                status: 'Pending',
+                priority: 0,
+            });
+            if ('error' in overrideInsert) {
+                return failure("PERSIST_FAILED", `${overrideInsert.error.Message} (Component ${componentID} was persisted but has no override yet.)`);
+            }
+            addOutput(params, "ComponentID", componentID);
+            addOutput(params, "OverrideID", overrideInsert.id);
+            addOutput(params, "Version", "1.0.0");
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify({
+                    ComponentID: componentID,
+                    OverrideID: overrideInsert.id,
+                    EntityName: inputs.EntityName,
+                    Scope: "User",
+                    Status: "Pending",
+                    Version: "1.0.0",
+                }),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`CreateInteractiveFormAction: ${message}`);
+            return failure("UNEXPECTED_ERROR", message);
+        }
+    }
+    extractInputs(params) {
+        const entityName = getStringParam(params, "EntityName");
+        if (!entityName)
+            return { error: failure("MISSING_PARAMETER", "Parameter 'EntityName' is required.") };
+        const name = getStringParam(params, "Name");
+        if (!name)
+            return { error: failure("MISSING_PARAMETER", "Parameter 'Name' is required.") };
+        const specRaw = params.Params.find(x => x.Name?.trim().toLowerCase() === "spec")?.Value;
+        if (specRaw == null)
+            return { error: failure("MISSING_PARAMETER", "Parameter 'Spec' is required.") };
+        const parsed = parseSpecParam(specRaw);
+        if ('error' in parsed) {
+            return { error: failure("LINT_FAILED", `Spec is not valid JSON: ${parsed.error}`) };
+        }
+        return {
+            EntityName: entityName,
+            Spec: parsed,
+            Name: name,
+            Description: getStringParam(params, "Description"),
+            Notes: getStringParam(params, "Notes"),
+        };
+    }
+};
+CreateInteractiveFormAction = __decorate([
+    RegisterClass(BaseAction, "__CreateInteractiveForm")
+], CreateInteractiveFormAction);
+export { CreateInteractiveFormAction };
+/** Tree-shaking guard. */
+export function LoadCreateInteractiveFormAction() {
+    if (false) {
+        const _ = CreateInteractiveFormAction;
+    }
+}
+//# sourceMappingURL=create-interactive-form.action.js.map

package/dist/custom/interactive-forms/create-interactive-form.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-interactive-form.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/create-interactive-form.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/interactive-forms/get-active-form-for-entity.action.d.ts

@@ -0,0 +1,46 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Read-only action that returns the currently-resolved interactive-form
+ * override (if any) for the (entity, user) pair plus the full list of
+ * applicable variants. Used by the Form Builder agent to decide between
+ * Create (no override exists) and Modify (an override already exists).
+ *
+ * Resolution mirrors {@link FormResolverService} on the client:
+ *   - Scope precedence: User > Role > Global.
+ *   - Within a tier: Priority DESC, then __mj_CreatedAt DESC.
+ *   - Only Status='Active' rows are considered for the "active" pick. The
+ *     full variants list includes 'Pending' rows so the agent can recognize
+ *     an in-flight refinement loop and reuse the Pending row instead of
+ *     spawning a new one.
+ *
+ * Output shape (JSON in `Message`, also surfaced as a `Result` output param):
+ * ```
+ * {
+ *   "EntityName": "MJ: Applications",
+ *   "Active": {
+ *     "OverrideID": "...",
+ *     "ComponentID": "...",
+ *     "Scope": "User" | "Role" | "Global",
+ *     "Priority": 0,
+ *     "Status": "Active",
+ *     "Spec": <ComponentSpec>,
+ *     "ComponentName": "...",
+ *     "ComponentVersion": "1.0.0",
+ *     "VersionSequence": 1
+ *   } | null,
+ *   "Variants": [{ ...same shape... }, ...]   // all applicable, all statuses
+ * }
+ * ```
+ *
+ * If no overrides exist, `Active` is null and `Variants` is empty —
+ * the calling agent should then call `Get Default Form Scaffold For Entity`
+ * and `Create Interactive Form`.
+ */
+export declare class GetActiveFormForEntityAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private getStringParam;
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export declare function LoadGetActiveFormForEntityAction(): void;
+//# sourceMappingURL=get-active-form-for-entity.action.d.ts.map

package/dist/custom/interactive-forms/get-active-form-for-entity.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-form-for-entity.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-active-form-for-entity.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,4BAA6B,SAAQ,UAAU;cAExC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkKvF,OAAO,CAAC,cAAc;CAOzB;AAMD,qDAAqD;AACrD,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}

package/dist/custom/interactive-forms/get-active-form-for-entity.action.js

@@ -0,0 +1,179 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError, RunView } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+/**
+ * Read-only action that returns the currently-resolved interactive-form
+ * override (if any) for the (entity, user) pair plus the full list of
+ * applicable variants. Used by the Form Builder agent to decide between
+ * Create (no override exists) and Modify (an override already exists).
+ *
+ * Resolution mirrors {@link FormResolverService} on the client:
+ *   - Scope precedence: User > Role > Global.
+ *   - Within a tier: Priority DESC, then __mj_CreatedAt DESC.
+ *   - Only Status='Active' rows are considered for the "active" pick. The
+ *     full variants list includes 'Pending' rows so the agent can recognize
+ *     an in-flight refinement loop and reuse the Pending row instead of
+ *     spawning a new one.
+ *
+ * Output shape (JSON in `Message`, also surfaced as a `Result` output param):
+ * ```
+ * {
+ *   "EntityName": "MJ: Applications",
+ *   "Active": {
+ *     "OverrideID": "...",
+ *     "ComponentID": "...",
+ *     "Scope": "User" | "Role" | "Global",
+ *     "Priority": 0,
+ *     "Status": "Active",
+ *     "Spec": <ComponentSpec>,
+ *     "ComponentName": "...",
+ *     "ComponentVersion": "1.0.0",
+ *     "VersionSequence": 1
+ *   } | null,
+ *   "Variants": [{ ...same shape... }, ...]   // all applicable, all statuses
+ * }
+ * ```
+ *
+ * If no overrides exist, `Active` is null and `Variants` is empty —
+ * the calling agent should then call `Get Default Form Scaffold For Entity`
+ * and `Create Interactive Form`.
+ */
+let GetActiveFormForEntityAction = class GetActiveFormForEntityAction extends BaseAction {
+    async InternalRunAction(params) {
+        try {
+            const entityName = this.getStringParam(params, "EntityName");
+            if (!entityName) {
+                return failure("MISSING_PARAMETER", "Parameter 'EntityName' is required.");
+            }
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider) {
+                return failure("NO_PROVIDER", "No metadata provider available.");
+            }
+            const user = params.ContextUser;
+            if (!user) {
+                return failure("NO_USER", "Action requires a ContextUser for scope resolution.");
+            }
+            const entity = provider.EntityByName(entityName);
+            if (!entity) {
+                return failure("ENTITY_NOT_FOUND", `Entity '${entityName}' is not registered with the active metadata provider.`);
+            }
+            // Pull all overrides applicable to this user — User-scoped to this user,
+            // Role-scoped if user has any of the listed roles, or Global. We let the
+            // database filter and we sort + select winner in code below.
+            const rv = RunView.FromMetadataProvider(provider);
+            const userRoles = Array.isArray(user.UserRoles)
+                ? (user.UserRoles ?? []).map(r => r.RoleID).filter((x) => !!x)
+                : [];
+            const filterClauses = [
+                `EntityID='${entity.ID}'`,
+                `(Scope='Global' OR (Scope='User' AND UserID='${user.ID}')${userRoles.length ? ` OR (Scope='Role' AND RoleID IN (${userRoles.map(r => `'${r}'`).join(",")}))` : ''})`,
+            ];
+            const overrideResult = await rv.RunView({
+                EntityName: "MJ: Entity Form Overrides",
+                ExtraFilter: filterClauses.join(' AND '),
+                Fields: ['ID', 'EntityID', 'ComponentID', 'Name', 'Description', 'Scope', 'UserID', 'RoleID', 'Priority', 'Status'],
+                ResultType: 'simple',
+            }, user);
+            if (!overrideResult.Success) {
+                return failure("QUERY_FAILED", `Override lookup failed: ${overrideResult.ErrorMessage ?? 'unknown error'}`);
+            }
+            const overrides = overrideResult.Results ?? [];
+            if (overrides.length === 0) {
+                const payload = { EntityName: entityName, Active: null, Variants: [] };
+                params.Params.push({ Name: "Result", Type: "Output", Value: payload });
+                return {
+                    Success: true,
+                    ResultCode: "SUCCESS",
+                    Message: JSON.stringify(payload),
+                };
+            }
+            // Hydrate the referenced Components in one batch.
+            const componentIDs = Array.from(new Set(overrides.map(o => o.ComponentID))).filter(Boolean);
+            const componentsResult = await rv.RunView({
+                EntityName: "MJ: Components",
+                ExtraFilter: `ID IN (${componentIDs.map(id => `'${id}'`).join(",")})`,
+                Fields: ['ID', 'Name', 'Version', 'VersionSequence', 'Status', 'Specification'],
+                ResultType: 'simple',
+            }, user);
+            const componentByID = new Map((componentsResult.Results ?? []).map(c => [c.ID, c]));
+            const variants = overrides.map(o => {
+                const component = componentByID.get(o.ComponentID);
+                let spec = null;
+                if (component?.Specification) {
+                    try {
+                        spec = JSON.parse(component.Specification);
+                    }
+                    catch {
+                        // Bad spec JSON — we don't fail the whole action; we surface
+                        // the variant without a parsed spec and let the caller decide.
+                        spec = null;
+                    }
+                }
+                return {
+                    OverrideID: o.ID,
+                    ComponentID: o.ComponentID,
+                    Scope: o.Scope,
+                    Priority: o.Priority ?? 0,
+                    Status: o.Status,
+                    Name: o.Name,
+                    Description: o.Description,
+                    Spec: spec,
+                    ComponentName: component?.Name ?? null,
+                    ComponentVersion: component?.Version ?? null,
+                    VersionSequence: component?.VersionSequence ?? null,
+                };
+            });
+            // Sort by scope tier (User=1, Role=2, Global=3), then Priority DESC.
+            // We don't have CreatedAt in the lightweight query — ties at this
+            // point default to the order the DB returned, which is usually
+            // creation order. The resolver service does the same.
+            variants.sort((a, b) => {
+                const tierA = a.Scope === 'User' ? 1 : a.Scope === 'Role' ? 2 : 3;
+                const tierB = b.Scope === 'User' ? 1 : b.Scope === 'Role' ? 2 : 3;
+                if (tierA !== tierB)
+                    return tierA - tierB;
+                return (b.Priority ?? 0) - (a.Priority ?? 0);
+            });
+            const active = variants.find(v => v.Status === 'Active') ?? null;
+            const payload = { EntityName: entityName, Active: active, Variants: variants };
+            params.Params.push({ Name: "Result", Type: "Output", Value: payload });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(payload),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`GetActiveFormForEntityAction: ${message}`);
+            return failure("UNEXPECTED_ERROR", message);
+        }
+    }
+    getStringParam(params, name) {
+        const p = params.Params.find(x => x.Name?.trim().toLowerCase() === name.toLowerCase());
+        if (!p || p.Value == null)
+            return null;
+        const v = String(p.Value).trim();
+        return v.length > 0 ? v : null;
+    }
+};
+GetActiveFormForEntityAction = __decorate([
+    RegisterClass(BaseAction, "__GetActiveFormForEntity")
+], GetActiveFormForEntityAction);
+export { GetActiveFormForEntityAction };
+function failure(resultCode, message) {
+    return { Success: false, ResultCode: resultCode, Message: message };
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export function LoadGetActiveFormForEntityAction() {
+    if (false) {
+        const _ = GetActiveFormForEntityAction;
+    }
+}
+//# sourceMappingURL=get-active-form-for-entity.action.js.map

package/dist/custom/interactive-forms/get-active-form-for-entity.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-form-for-entity.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-active-form-for-entity.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/interactive-forms/get-default-form-scaffold.action.d.ts

@@ -0,0 +1,32 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Read-only action that produces a working form-role `ComponentSpec`
+ * scaffolded from the entity's CodeGen metadata (Category /
+ * GeneratedFormSectionType / Sequence / FK relationships / value lists).
+ *
+ * **Why this exists.** Today the Form Builder agent writes JSX from
+ * scratch every time, producing inconsistent quality. Calling this action
+ * first gives the agent a known-good baseline (mirrors the default Angular
+ * form) that it can modify per user requirements instead of inventing a
+ * layout. Far fewer lint failures, dramatically better starting point.
+ *
+ * **Pure read.** No persistence. The returned spec is intended to be
+ * modified and then passed to {@link CreateInteractiveFormAction} or
+ * {@link ModifyInteractiveFormAction}.
+ */
+export declare class GetDefaultFormScaffoldForEntityAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Spec` parameter — the scaffolded `ComponentSpec` object (componentRole='form', location='embedded').
+     *   - `Message` — the same object, stringified.
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private getStringParam;
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export declare function LoadGetDefaultFormScaffoldForEntityAction(): void;
+//# sourceMappingURL=get-default-form-scaffold.action.d.ts.map

package/dist/custom/interactive-forms/get-default-form-scaffold.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-form-scaffold.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-default-form-scaffold.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD;;;;;;;;;;;;;;GAcG;AACH,qBACa,qCAAsC,SAAQ,UAAU;IAEjE;;;;;;;OAOG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsCvF,OAAO,CAAC,cAAc;CAOzB;AAMD,qDAAqD;AACrD,wBAAgB,yCAAyC,IAAI,IAAI,CAIhE"}

package/dist/custom/interactive-forms/get-default-form-scaffold.action.js

@@ -0,0 +1,87 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+import { buildDefaultFormScaffold } from "@memberjunction/interactive-component-types/forms";
+/**
+ * Read-only action that produces a working form-role `ComponentSpec`
+ * scaffolded from the entity's CodeGen metadata (Category /
+ * GeneratedFormSectionType / Sequence / FK relationships / value lists).
+ *
+ * **Why this exists.** Today the Form Builder agent writes JSX from
+ * scratch every time, producing inconsistent quality. Calling this action
+ * first gives the agent a known-good baseline (mirrors the default Angular
+ * form) that it can modify per user requirements instead of inventing a
+ * layout. Far fewer lint failures, dramatically better starting point.
+ *
+ * **Pure read.** No persistence. The returned spec is intended to be
+ * modified and then passed to {@link CreateInteractiveFormAction} or
+ * {@link ModifyInteractiveFormAction}.
+ */
+let GetDefaultFormScaffoldForEntityAction = class GetDefaultFormScaffoldForEntityAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Spec` parameter — the scaffolded `ComponentSpec` object (componentRole='form', location='embedded').
+     *   - `Message` — the same object, stringified.
+     */
+    async InternalRunAction(params) {
+        try {
+            const entityName = this.getStringParam(params, "EntityName");
+            if (!entityName) {
+                return failure("MISSING_PARAMETER", "Parameter 'EntityName' is required.");
+            }
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider) {
+                return failure("NO_PROVIDER", "No metadata provider available.");
+            }
+            const spec = buildDefaultFormScaffold(entityName, provider);
+            if (!spec) {
+                return failure("ENTITY_NOT_FOUND", `Entity '${entityName}' is not registered with the active metadata provider.`);
+            }
+            params.Params.push({
+                Name: "Spec",
+                Type: "Output",
+                Value: spec,
+            });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(spec),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`GetDefaultFormScaffoldForEntityAction: ${message}`);
+            return failure("UNEXPECTED_ERROR", message);
+        }
+    }
+    getStringParam(params, name) {
+        const p = params.Params.find(x => x.Name?.trim().toLowerCase() === name.toLowerCase());
+        if (!p || p.Value == null)
+            return null;
+        const v = String(p.Value).trim();
+        return v.length > 0 ? v : null;
+    }
+};
+GetDefaultFormScaffoldForEntityAction = __decorate([
+    RegisterClass(BaseAction, "__GetDefaultFormScaffoldForEntity")
+], GetDefaultFormScaffoldForEntityAction);
+export { GetDefaultFormScaffoldForEntityAction };
+function failure(resultCode, message) {
+    return { Success: false, ResultCode: resultCode, Message: message };
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export function LoadGetDefaultFormScaffoldForEntityAction() {
+    if (false) {
+        const _ = GetDefaultFormScaffoldForEntityAction;
+    }
+}
+//# sourceMappingURL=get-default-form-scaffold.action.js.map

package/dist/custom/interactive-forms/get-default-form-scaffold.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-form-scaffold.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-default-form-scaffold.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.d.ts

@@ -0,0 +1,34 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Read-only action consumed by the Form Builder agent to inspect an entity's
+ * curated form-relevant schema before generating a form Component.
+ *
+ * Returns the `CuratedFormSchema` shape: FK references resolved to
+ * `{entity, displayField}`, value-list fields annotated with `allowedValues`,
+ * and audit / virtual / computed fields stripped. See
+ * `@memberjunction/interactive-component-types/forms` for the type.
+ *
+ * Output is stringified JSON in `Message` (Action framework convention) and
+ * also surfaced as a `Schema` output parameter for callers that prefer
+ * structured access.
+ */
+export declare class GetEntitySchemaForFormAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Schema` parameter — the `CuratedFormSchema` object.
+     *   - `Message` — the same object, stringified.
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /** Case-insensitive trim-tolerant fetch for the EntityName param. */
+    private getEntityNameParam;
+}
+/**
+ * Tree-shaking guard. Imported and called from src/index.ts so bundlers
+ * don't drop the action when no consumer references it by name.
+ */
+export declare function LoadGetEntitySchemaForFormAction(): void;
+//# sourceMappingURL=get-entity-schema-for-form.action.d.ts.map

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-schema-for-form.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-entity-schema-for-form.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD;;;;;;;;;;;;GAYG;AACH,qBACa,4BAA6B,SAAQ,UAAU;IAExD;;;;;;;OAOG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmDvF,qEAAqE;IACrE,OAAO,CAAC,kBAAkB;CAS7B;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}