Data Machine
Changelog
All notable changes to Data Machine will be documented in this file. [0.103.10] - 2026-05-01 Fixed declare items schema on...
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...
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...
Theming Layer Guide
Data Machine has two theming surfaces because it renders in two different runtimes: Surface Runtime Consumer CSS custom properties Browser...
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 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 Standalone Skeleton Plan
Parent issue: Agents API extraction: create initial standalone plugin skeleton plan Refs: standalone extraction umbrella, pre-extraction audit, extraction map This...
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...
Universal Engine Filters
Reference for the WordPress filters used by the Universal Engine 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...
AI Conversation Loop
File: /inc/Engine/AI/AIConversationLoop.php Since: 0.2.0 Multi-turn conversation execution engine for AI agents. Handles automatic tool execution, result feedback, and conversation completion...
ConversationManager
Location: /inc/Engine/AI/ConversationManager.php Since: v0.2.0 (Universal Engine Architecture) Namespace: DataMachineEngineAI Overview ConversationManager provides standardized message formatting utilities for all AI agents...
RequestBuilder Pattern
File: /inc/Engine/AI/RequestBuilder.php Since: 0.2.0 Centralized AI request construction ensuring consistent request structure across Pipeline AI and Chat API agents. Single...
Agent Message Envelope
File: /agents-api/inc/AI/AgentMessageEnvelope.php The canonical agent message shape is a JSON-friendly typed envelope. Runtime code, chat storage, and transcript storage should...
Agent Registration
Declarative agent registration via the wp_agents_api_init action. Plugins (and Data Machine itself) declare agent roles once; the side-effect-free registry collects...
Multi-Agent Architecture
Data Machine supports multiple independent agents on a single WordPress installation. Each agent has its own identity, filesystem directory, database-scoped...
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...
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...
Parameter Systems
Unified flat parameter architecture for all Data Machine components, providing consistent interfaces across steps, handlers, and tools while maintaining extensibility...
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...
Deduplication Tracking Endpoints
Implementation: inc/Api/ProcessedItems.php Base URL: /wp-json/datamachine/v1/processed-items Overview Deduplication tracking endpoints manage item tracking records to prevent duplicate processing of content items...
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...
Agent Memory Backends
Data Machine treats agent memory as logical memory records that usually render as markdown files. The storage backend is replaceable,...
Policy Resolvers
Data Machine has four policy resolvers — small classes that read per-agent declarative configuration and answer one specific question about...
Pipeline Execution Axes
Data Machine pipelines expand work along four orthogonal axes. Each axis answers a different question, lives in different code, and...
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 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,...
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...
WordPress Update Handler
Updates existing WordPress posts and pages in the local installation using native WordPress functions with selective field updates and taxonomy...
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/...