Data Machine
Changelog
All notable changes to Data Machine will be documented in this file. [0.172.29] - 2026-08-15 Changed move media diagnostics out...
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...
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...
AI Directive System
Data Machine assembles AI request context through directive classes registered on the datamachine_directives filter. The current implementation is documented in...
Data Machine Documentation
Complete user and agent documentation for Data Machine, the WordPress automation product layer that combines pipelines, flows, jobs, chat agents,...
WP-CLI Commands
Data Machine provides a broad WP-CLI surface for managing pipelines, flows, jobs, agents, memory, system tasks, and more from the...
Agent Bundles
Agent bundles are portable, versioned packages for an agent's runtime behavior. They describe what to install without embedding local database...
Runtime-Gated Abilities Audit
Issue: https://github.com/Extra-Chill/data-machine/issues/2303 Data Machine skips the full runtime on normal frontend page views via datamachine_should_load_full_runtime(). Ability constructors inside datamachine_run_datamachine_plugin() therefore...
System Tasks
System tasks are reusable task handlers that can run on demand, from recurring schedules, or inline as workflow/pipeline steps. They...
Abilities API
WordPress 6.9 Abilities API provides standardized capability discovery and execution for Data Machine operations. All REST API, CLI, and Chat...
Tool Manager
ToolManager is the Data Machine adapter for the AI tool registry. It owns Data Machine's datamachine_tools compatibility registry, lazy definition...
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...
Parameter Systems
Unified flat parameter architecture for all Data Machine components, providing consistent interfaces across steps, handlers, and tools while maintaining extensibility...
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...
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...
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...
AI Runtime Filters
Reference for the WordPress filters used by the AI runtime to register directives, tools, and authentication providers, and to validate...
Core Actions Reference
Comprehensive reference for all WordPress actions used by Data Machine for pipeline execution, data processing, and system operations. Note: Most...
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)...
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...
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...