Data Machine
Changelog
All notable changes to Data Machine will be documented in this file. [0.109.0] - 2026-05-10 Added enhance completion outcome assertions...
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...
AI Directive System
Data Machine assembles AI request context through directive classes registered on the datamachine_directives filter. The current implementation is documented in...
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...
Data Machine Documentation
Complete user documentation for Data Machine, the AI-first WordPress plugin that combines a visual pipeline builder, conversational chat agent, REST...
AI Conversation Loop
File: /inc/Engine/AI/conversation-loop.php Since: 0.2.0 Multi-turn conversation execution engine for AI agents. Handles automatic tool execution, result feedback, and conversation completion...
WordPress as Persistent Memory for AI Agents
AI agents are stateless. Every conversation, every workflow, every scheduled task starts from zero. The agent has no memory of...
Abilities API
WordPress 6.9 Abilities API provides standardized capability discovery and execution for Data Machine operations. All REST API, CLI, and Chat...
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,...
Tool Execution Architecture
Files: /inc/Engine/AI/Tools/ToolExecutor.php /inc/Engine/AI/Tools/ToolParameters.php Since: 0.2.0 Universal tool discovery, enablement, and execution infrastructure shared by Pipeline AI and Chat API agents....
Pending Actions
Data Machine implements the Agents API pending-action approval storage contract with WordPress-backed durable storage. Boundary Agents API owns generic approval...
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...
Pipeline Execution Axes
Data Machine pipelines expand work along four orthogonal axes. Each axis answers a different question, lives in different code, and...
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)...
Policy Resolvers
Data Machine has four policy resolvers — small classes that read per-agent declarative configuration and answer one specific question about...
Fetch Handlers Overview
Fetch handlers retrieve content from various sources and convert it into standardized DataPackets for pipeline processing. Available Handlers Local Sources...
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 AI tool calling architecture. All handlers implement the handle_tool_call() method for...
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 native WordPress functions 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 or cookie authentication Permissions: Most...
Parameter Systems
Unified flat parameter architecture for all Data Machine components, providing consistent interfaces across steps, handlers, and tools while maintaining extensibility...
Chat Endpoint
Implementation: inc/Api/Chat/Chat.php Base URL: /wp-json/datamachine/v1/chat Overview The Chat endpoint provides a conversational AI interface for building and executing Data Machine...
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...
Files Endpoint
Implementation: inc/Api/FlowFiles.php, inc/Api/AgentFiles.php Base URL: /wp-json/datamachine/v1/files Overview The Files endpoint handles two distinct scopes: Flow files — File uploads for...
Flows Endpoints
Implementation: /inc/Api/Flows/ directory structure Flows.php - Main flow CRUD operations FlowSteps.php - Flow step configuration (/flows/{id}/config, /flows/steps/{flow_step_id}/config) Base URL: /wp-json/datamachine/v1/flows...
Webhook Trigger Endpoint
Implementation: inc/Api/WebhookTrigger.php, inc/Api/WebhookVerifier.php, inc/Api/WebhookAuthResolver.php Base URL: /wp-json/datamachine/v1/trigger/{flow_id} Since: 0.30.0 (Bearer auth), 0.79.0 (template-based HMAC verifier) Overview Public REST endpoint for...
AI Tools Overview
AI tools provide capabilities to AI agents for interacting with external services, processing data, and performing research tasks. Data Machine...
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 Flow Steps Tool
Configures handler settings or AI user messages on flow steps. Supports both single-step and bulk pipeline-scoped operations. Overview The configure_flow_steps...
Create Pipeline Tool
Comprehensive tool for creating pipelines with optional predefined steps and automatic flow instantiation. Overview The create_pipeline tool creates new pipeline...
Add Pipeline Step Tool
Specialized chat tool for adding steps to existing pipelines with automatic flow synchronization. Overview The add_pipeline_step tool allows AI agents...
API Query Tool
Internal REST API query tool for chat agents providing discovery, monitoring, and troubleshooting capabilities. Overview The api_query tool enables chat...
Pipeline Builder Interface
React-based interface for creating and managing Pipelines and Flows, backed by the /wp-json/datamachine/v1/ REST API. Architecture TanStack Query manages server...
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/...