Skip to content

feat(engine): add datamachine_engine_snapshot filter at job init #2071

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
chubes4 merged 1 commit into from
May 18, 2026
Merged

feat(engine): add datamachine_engine_snapshot filter at job init #2071

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions inc/Abilities/Engine/RunFlowAbility.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -244,6 +244,30 @@ public function execute( array $input ): array {
$engine_snapshot = array_merge( $existing_data, $engine_snapshot );
}

/**
* Filter the engine snapshot before it is persisted for a new job.
*
* Lets extensions enrich the engine_data snapshot with context that
* lives outside DM core. For example, Data Machine Code projects the
* active workspace identity (repo, handle, branch, path) into
* `active_workspace` so directives, abilities, and tool calls can
* read which repo the current job is operating against.
*
* Filters MUST return an array. Returning a non-array silently
* preserves the prior snapshot.
*
* @since 0.10.3
*
* @param array $engine_snapshot The snapshot about to be persisted.
* @param int $job_id Job being initialized.
* @param array $flow Flow row from the database.
* @param array $pipeline Pipeline row from the database.
*/
$filtered_snapshot = apply_filters( 'datamachine_engine_snapshot', $engine_snapshot, $job_id, $flow, $pipeline );
if ( is_array( $filtered_snapshot ) ) {
$engine_snapshot = $filtered_snapshot;
}

datamachine_set_engine_data( $job_id, $engine_snapshot );

try {
Expand Down
Loading