@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