@memberjunction/scheduling-actions

MemberJunction Actions for managing scheduled jobs. These actions enable AI agents and workflow systems to query, create, update, delete, and execute scheduled jobs through MemberJunction's metadata-driven action framework.

Architecture

graph TD
    subgraph "@memberjunction/scheduling-actions"
        A[BaseJobAction] --> B[QueryJobsAction]
        A --> C[CreateJobAction]
        A --> D[UpdateJobAction]
        A --> E[DeleteJobAction]
        A --> F[ExecuteJobNowAction]
        A --> G[GetJobStatisticsAction]
    end

    subgraph "Consumers"
        H[AI Agents]
        I[Workflow Engine]
        J[Low-Code Builders]
    end

    H --> A
    I --> A
    J --> A

    subgraph "Data Layer"
        K["MJ: Scheduled Jobs"]
        L["MJ: Scheduled Job Runs"]
        M["MJ: Scheduled Job Types"]
    end

    A --> K
    A --> L
    A --> M

    style A fill:#2d6a9f,stroke:#1a4971,color:#fff
    style B fill:#2d8659,stroke:#1a5c3a,color:#fff
    style C fill:#2d8659,stroke:#1a5c3a,color:#fff
    style D fill:#2d8659,stroke:#1a5c3a,color:#fff
    style E fill:#2d8659,stroke:#1a5c3a,color:#fff
    style F fill:#7c5295,stroke:#563a6b,color:#fff
    style G fill:#7c5295,stroke:#563a6b,color:#fff

Overview

This package provides MemberJunction Actions for scheduled job management. Actions are metadata-driven integration points designed for AI agents, workflow engines, and low-code environments -- they are NOT intended for direct code-to-code use.

Available actions:

| Action | Description | |--------|-------------| | QueryJobsAction | List and filter scheduled jobs with optional status filtering | | CreateJobAction | Create a new scheduled job with cron expression and configuration | | UpdateJobAction | Modify an existing scheduled job's schedule, status, or configuration | | DeleteJobAction | Remove a scheduled job | | ExecuteJobNowAction | Trigger immediate execution of a scheduled job | | GetJobStatisticsAction | Retrieve execution statistics, success rates, and history |

Installation

npm install @memberjunction/scheduling-actions

Usage

These actions are registered with MemberJunction's class factory and are discovered automatically by AI agents and workflow systems. They are not typically called directly from code.

Action Registration

All actions extend BaseJobAction, which provides shared utilities for:

• Parameter extraction and validation
• Cron expression validation via cron-parser
• Common error handling patterns
• Result formatting

Example: Agent Using Schedule Actions

An AI agent can discover and use these actions to manage scheduled jobs:

User: "Schedule my daily report agent to run every morning at 8 AM"

Agent discovers: CreateJobAction
Agent executes with:
  - JobType: "Agent"
  - CronExpression: "0 8 * * *"
  - AgentID: "report-agent-guid"
  - Name: "Daily Report Agent"

Base Class

BaseJobAction provides shared functionality inherited by all scheduling actions:

graph LR
    A[BaseAction<br/>MJ Actions Framework] --> B[BaseJobAction<br/>Shared Scheduling Logic]
    B --> C[QueryJobsAction]
    B --> D[CreateJobAction]
    B --> E[UpdateJobAction]
    B --> F[DeleteJobAction]
    B --> G[ExecuteJobNowAction]
    B --> H[GetJobStatisticsAction]

    style A fill:#2d6a9f,stroke:#1a4971,color:#fff
    style B fill:#2d8659,stroke:#1a5c3a,color:#fff
    style C fill:#7c5295,stroke:#563a6b,color:#fff
    style D fill:#7c5295,stroke:#563a6b,color:#fff
    style E fill:#7c5295,stroke:#563a6b,color:#fff
    style F fill:#7c5295,stroke:#563a6b,color:#fff
    style G fill:#b8762f,stroke:#8a5722,color:#fff
    style H fill:#b8762f,stroke:#8a5722,color:#fff

Dependencies

| Package | Purpose | |---------|---------| | @memberjunction/actions | MJ Actions framework | | @memberjunction/actions-base | Base action classes | | @memberjunction/core | Metadata, RunView | | @memberjunction/core-entities | Entity types | | @memberjunction/global | RegisterClass, class factory | | @memberjunction/scheduling-base-types | Shared type definitions | | cron-parser | Cron expression validation |

License

ISC