Data Machine
Changelog
All notable changes to Data Machine will be documented in this file. [0.175.29] - 2026-09-03 Fixed open real transactions when...
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 Architecture
This is the current architecture entry point. Data Machine is the WordPress automation product layer built around the canonical runtime...
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...
Plugin Check v0.174.0 Hook-Name Dossier
Scope Source evidence: .homeboy/evidence/plugin-check-v01740/data-machine.json. The declared evidence contains 6 DynamicHooknameFound warnings and 1 NonPrefixedHooknameFound warning. This change addresses only those...
OAuth Handlers
Location: /inc/Core/OAuth/ Overview Data Machine uses a unified base class architecture for authentication providers, eliminating code duplication across all OAuth...
WP-CLI Commands
Data Machine provides a broad WP-CLI surface for managing pipelines, flows, jobs, agents, memory, system tasks, and more from the...
FilesRepository Components
Overview The FilesRepository is a modular component system for file operations in the Data Machine pipeline system. Introduced in version...
RequestBuilder Pattern
File: /inc/Engine/AI/RequestBuilder.php Since: 0.2.0 RequestBuilder is Data Machine's request assembly and provider dispatch adapter. It prepares Data Machine messages, tools,...
Agent Registration
Declarative agent registration uses the Agents API wp_agents_api_init action. Plugins and Data Machine declare agent roles once; Data Machine's materializer...
Handler Registration Trait
Standardized handler registration trait introduced in v0.2.2 that eliminates ~70% of boilerplate code across all handlers. Overview HandlerRegistrationTrait provides a...
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)...
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...
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...
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...
System Endpoint
Implementation: inc/Api/System/System.php Base URL: /wp-json/datamachine/v1/system/ Overview The System endpoint provides infrastructure operations, monitoring, system task management, and editable prompt definitions...
Logs API
Implementation: inc/Api/Logs.php Base URL: /wp-json/datamachine/v1/logs Overview Data Machine uses a database-backed logging system with all operational logs stored in the...
Parameter Systems
Unified flat parameter architecture for all Data Machine components, providing consistent interfaces across steps, handlers, and tools while maintaining extensibility...
Auth Endpoints
Implementation: inc/Api/Auth.php Base URL: /wp-json/datamachine/v1/auth Auth endpoints manage handler authentication and provider metadata. They are separate from WordPress REST authentication,...
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...
Chat Sessions Endpoints
Implementation: inc/Api/Chat/Chat.php Data Machine stores chat conversations as user-scoped sessions in wp_datamachine_chat_sessions. Generic session CRUD is exposed through the canonical...
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...
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...
Logs & Jobs Management Interface
Monitoring and managing pipeline execution status and historical system logs. Logs Interface The Logs interface is a separate React admin...
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...