Data Machine
Changelog
All notable changes to Data Machine will be documented in this file. [0.177.6] - 2026-09-24 Fixed sniff real image format...
Data Machine Architecture
This is the current architecture entry point. Data Machine is the WordPress automation product layer built around the canonical runtime...
WordPress.org Submission Checklist
This document is a preparatory checklist. Issue #2424 remains open until release automation builds the exact 1.0.0 bytes and the...
Core Filters & Actions
Actions wp_agents_api_init Fires once per request when the Agents API registry is first consumed. Plugins declare agent roles inside this...
Data Machine Documentation
Complete user and agent documentation for Data Machine, the WordPress automation product layer that combines pipelines, flows, jobs, chat agents,...
Plugin Check v01740 Reviewer Dossier
Evidence Boundary Source evidence: .homeboy/evidence/plugin-check-v01740/data-machine.json, generated by wordpress.plugin-check for data-machine with exit code 1. Finding Before After PluginCheck.Security.DirectDB.UnescapedDBParameter 132 Not...
Logs & Jobs Management Interface
Monitoring and managing pipeline execution status and historical system logs. Logs Interface The Logs interface is a separate React admin...
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...
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/...
Database Schema
Data Machine persists workflow definitions, execution state, access control, source tracking, artifacts, chat, approvals, and logs in custom tables. The...
Routines Scheduling
All recurring scheduling in Data Machine — flow schedules and built-in system task schedules — runs on Agents API Routines...
WP-CLI Commands
Data Machine provides a broad WP-CLI surface for managing pipelines, flows, jobs, agents, memory, system tasks, and more from the...
System Tasks
System tasks are reusable task handlers that can run on demand, from recurring schedules, or inline as workflow/pipeline steps. They...
Daily Memory System
The daily memory system provides temporal, append-only memory for AI agents. While MEMORY.md holds persistent knowledge that every session needs,...
Engine Execution
Data Machine executes the pipeline -> flow -> job -> packets/artifacts portion of the canonical architecture through engine abilities and...
Data Machine 1.0 Baseline
Data Machine 1.0 supports one current schema and one current runtime contract. Fresh installs and deploy-in-place updates run the idempotent...
Plugin Check v01740 Slow-Query Audit
Evidence source: .homeboy/evidence/plugin-check-v01740/data-machine.json entries 1866-2118. This dossier is limited to those 15 SlowDBQuery findings; it does not claim coverage of...
Post Identity Reservations
When identity_meta is the selected identity path, datamachine/upsert-post uses a per-site reservation table and a deterministic MySQL advisory lock. A...
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...
AI Runtime Filters
Reference for the WordPress filters used by the AI runtime 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...
Agents
Implementation: inc/Abilities/AgentAbilities.php, inc/Abilities/AgentTokenAbilities.php, inc/Core/Auth/AgentAuthorize.php, inc/Core/Auth/AgentAuthCallback.php Overview Agent record and token management is exposed as REST-visible Data Machine abilities and executed...
Authentication
Data Machine REST API requests use normal WordPress REST authentication. Endpoint-specific callback routes add bearer or HMAC verification where a...
Settings Abilities
Implementation: inc/Abilities/SettingsAbilities.php The datamachine/v1/settings REST routes were retired in #3456. Settings are read and updated through the REST-visible Data Machine...
Step Types Abilities
Implementation: inc/Abilities/StepTypeAbilities.php The datamachine/v1/step-types REST routes were retired in #3456. Step types are discovered through the REST-visible Data Machine abilities,...
Jobs Abilities
Implementation: inc/Abilities/Job/GetJobsAbility.php, inc/Abilities/Job/DeleteJobsAbility.php The datamachine/v1/jobs REST routes were retired in #3456. Jobs are managed through the REST-visible Data Machine abilities,...
Logs Abilities
Implementation: inc/Abilities/LogAbilities.php The datamachine/v1/logs REST routes were retired in #3456. Logs are read and cleared through the REST-visible Data Machine...
Run Flow Tool
Tool for executing existing flows immediately or scheduling them for delayed execution. Overview The run_flow tool provides flexible flow execution...
API Query Tool
Internal REST API query tool for chat agents providing discovery, monitoring, and troubleshooting capabilities. Overview The api_query tool enables chat...
AI Tools Overview
AI tools should be exposed as WordPress Ability projections whenever a single registered ability already owns the execution contract. inc/Engine/AI/Tools/ToolServiceProvider.php...
ExecuteWorkflow Tool
Primary action tool for executing content automation workflows (@since v0.3.0) Overview The ExecuteWorkflow tool enables AI agents to execute complete...
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...
Agent Memory Backends
Data Machine treats agent memory as logical memory records that usually render as markdown files. The storage backend is replaceable,...
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...
Iteration Budget
Generic primitive for bounded iteration with a configurable ceiling. Counts a named dimension (conversation turns, A2A chain depth, retry attempts)...
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,...
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...
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...