Data Machine
Changelog
All notable changes to Data Machine will be documented in this file. [0.132.4] - 2026-05-23 Changed Add bounded sync runner...
Data Machine User Documentation
AI-first WordPress plugin for automating and orchestrating content workflows with a visual pipeline builder, conversational chat agent, REST API, and...
Data Machine Architecture
Data Machine is an AI-first WordPress plugin that uses a Pipeline+Flow architecture for automated content processing and publication. It provides...
Data Machine Documentation
Complete user and agent documentation for Data Machine, the WordPress automation product layer that combines pipelines, flows, jobs, chat agents,...
Core Filters & Actions
Actions wp_agents_api_init Fires once per request when the AgentRegistry is first consumed. Plugins declare agent roles inside this callback; DM...
AI Directive System
Data Machine assembles AI request context through directive classes registered on the datamachine_directives filter. The current implementation is documented in...
WP-CLI Commands
Data Machine provides a broad WP-CLI surface for managing pipelines, flows, jobs, agents, memory, system tasks, and more from the...
Pending Actions
Data Machine implements the Agents API pending-action approval storage contract with WordPress-backed durable storage. Pending actions are approval and audit...
Abilities API
WordPress 6.9 Abilities API provides standardized capability discovery and execution for Data Machine operations. All REST API, CLI, and Chat...
Abilities-First Service Layer
Data Machine's public service layer is the WordPress Abilities API. REST controllers, WP-CLI commands, chat tools, system tasks, and extension...
Tool Manager
ToolManager is the Data Machine adapter for the AI tool registry. It owns Data Machine's datamachine_tools compatibility registry, lazy definition...
Universal Engine Architecture
Since: 0.2.0 The Universal Engine is a shared AI infrastructure layer that provides consistent request building, tool execution, and conversation...
Agents API Standalone Skeleton Plan
Parent issue: Agents API extraction: create initial standalone plugin skeleton plan Refs: standalone extraction umbrella, pre-extraction audit, extraction map This...
Agents API Extraction Map
This map classifies Data Machine's current agent/runtime surface for the Agents API extraction. The in-repo module phase is complete: Data...
Agents API Pre-Extraction Audit
Parent issue: Explore splitting Agents API out of Data Machine Strategy issue: Agents API blocker: update extraction docs around in-repo...
Agents API Duplicated Substrate Inventory
Issue: #1762 Parent: #1755 Data Machine now consumes automattic/agents-api at 109576b004ef61783456e27ad841e553aa59f25a, which includes Automattic/agents-api PRs #65-#73. This inventory records the...
Fresh Candidate Collector
Source-agnostic primitive for fetch handlers that paginate or scan an external source and need to skip already-processed and currently-claimed candidates...
REST API Extensions Guide
This guide explains how Data Machine extensions integrate with the REST API ecosystem, covering both filter-based integration (preferred) and custom...
Core Filters Reference
Comprehensive reference for all WordPress filters used by Data Machine for service discovery, configuration, and data processing. Service Discovery Filters...
Core Actions Reference
Comprehensive reference for all WordPress actions used by Data Machine for pipeline execution, data processing, and system operations. Note: Most...
Universal Engine Filters
Reference for the WordPress filters used by the Universal Engine to register directives, tools, and authentication providers, and to validate...
Data Machine REST API
Complete REST API reference for Data Machine. Overview Base URL: /wp-json/datamachine/v1/ Authentication: WordPress application password, WordPress admin cookie authentication, or...
Analytics Endpoints
File Location: inc/Api/Analytics.php @since: 0.31.0 Unified REST API for core and extension-backed analytics integrations. Each endpoint delegates to its respective...
Processed Items Endpoint
Implementation: inc/Api/ProcessedItems.php Base URL: /wp-json/datamachine/v1/processed-items Overview Processed items are the deduplication records Data Machine uses to avoid re-processing the same...
Providers Endpoint
Implementation: inc/Api/Providers.php Base URL: /wp-json/datamachine/v1/providers Overview The Providers endpoint retrieves information about available AI providers and their configuration status. Authentication...
Settings Endpoints
Implementation: inc/Api/Settings.php Base URL: /wp-json/datamachine/v1/settings React Interface The Settings page is a React admin interface built with @wordpress/element and @wordpress/components....
StepTypes Endpoint
Implementation: inc/Api/StepTypes.php Base URL: /wp-json/datamachine/v1/step-types Overview The StepTypes endpoint provides information about available step types for pipeline building. Authentication Public...
Tools Endpoint
Implementation: inc/Api/Tools.php Base URL: /wp-json/datamachine/v1/tools Overview The Tools endpoint provides information about registered AI tools and their configuration status. Authentication...
AI Tools Overview
AI tools are registered by inc/Engine/AI/Tools/ToolServiceProvider.php into the unified Data Machine tool registry. Tools declare where they can run (chat,...
Configure Pipeline Step Tool
Specialized tool for configuring pipeline-level AI step settings including system prompt, provider, model, and enabled tools. Overview The configure_pipeline_step tool...
System Health Check
system_health_check runs unified diagnostics for Data Machine and extensions. Field Value Modes chat Mutation risk Read-only Registered in ToolServiceProvider.php via...
Queue Validator
queue_validator checks whether a topic already exists in published content or a Data Machine queue. Field Value Modes chat Mutation...
Read Logs
read_logs reads Data Machine logs for troubleshooting. Field Value Modes chat Mutation risk Read-only Registered in ToolServiceProvider.php via ReadLogs Backing...
Reorder Pipeline Steps
reorder_pipeline_steps changes the execution order of steps in a pipeline. Field Value Modes chat Mutation risk Config mutation Registered in...
OAuth Account Scope API
Status Proposed. This document defines the migration plan for issue #2117. It is a design agreement target before runtime callsites...
Pipeline Execution Axes
Data Machine pipelines expand work along four orthogonal axes. Each axis answers a different question, lives in different code, and...
Policy Resolvers
Data Machine uses small policy resolvers instead of one shared policy base class. Each resolver reads declarative configuration near the...
Agent Memory Backends
Data Machine treats agent memory as logical memory records that usually render as markdown files. The storage backend is replaceable,...
Iteration Budget
Generic primitive for bounded iteration with a configurable ceiling. Counts a named dimension (conversation turns, A2A chain depth, retry attempts)...
Settings Configuration Interface
React admin page for configuring Data Machine’s global settings, agent defaults, API keys, and handler defaults. Architecture Frontend location: inc/Core/Admin/Settings/assets/react/...
Pipeline Builder Interface
The Pipelines admin page is a React builder for Data Machine pipelines, flows, flow-step handlers, prompt queues, memory/context files, and...
Logs & Jobs Management Interface
Monitoring and managing pipeline execution status and historical system logs. Logs Interface The Logs interface is a separate React admin...
Fetch Handlers Overview
Fetch handlers retrieve content from various sources and convert it into standardized DataPacket objects for pipeline processing. Available Handlers Local...
WordPress Local Fetch Handler
Retrieves WordPress post and page content from the local installation using WP_Query. For media files, use the separate WordPress Media...
Files Fetch Handler
Processes uploaded files from flow-isolated storage with automatic MIME type detection, file validation, and deduplication tracking. Architecture Base Class: Extends...
RSS Feed Fetch Handler
Fetches and processes RSS/Atom feed data with automatic deduplication, timeframe filtering, content search capabilities, and clean content processing without URL...
Universal Web Scraper
The Universal Web Scraper is a high-performance fetch handler in the datamachine-events plugin designed to retrieve event data from external...
WordPress REST API Fetch Handler
Fetches content from public WordPress sites via REST API endpoints, providing structured data access as a modern alternative to RSS...
Publish Handlers Overview
Publish handlers distribute processed content to external platforms using the AI tool-calling architecture. Custom handlers extend the publish base class...
WordPress Publish Handler
Creates posts in the local WordPress installation using a modular handler architecture with specialized processing components for featured images, taxonomies,...
WordPress Update Handler
Updates existing WordPress posts and pages in the local installation using the datamachine/update-wordpress ability with selective field updates and taxonomy...