class-wp-codebox-browser-task-builder.php

<?php
/**
 * Generic browser task input and payload builder.
 *
 * @package WPCodebox
 */

defined( 'ABSPATH' ) || exit;

final class WP_Codebox_Browser_Task_Builder {

	/**
	 * Builds canonical browser task contract input from product-neutral intent.
	 *
	 * Downstream products should describe what they want to accomplish here, then
	 * pass the returned input to wp-codebox/create-browser-task-contract.
	 *
	 * @param array<string,mixed> $spec Product-neutral browser task spec.
	 * @return array<string,mixed>|WP_Error
	 */
	public static function browser_task_input_from_intent( array $spec ): array|WP_Error {
		$intent = is_array( $spec['product_intent'] ?? null ) ? $spec['product_intent'] : ( is_array( $spec['intent'] ?? null ) ? $spec['intent'] : array() );
		$goal   = trim( (string) ( $intent['goal'] ?? $spec['goal'] ?? '' ) );
		if ( '' === $goal ) {
			return new WP_Error( 'wp_codebox_browser_task_intent_missing', 'Browser task intent requires a goal.', array( 'status' => 400 ) );
		}

		$session_id = trim( (string) ( $spec['sandbox_session_id'] ?? $spec['session_id'] ?? $intent['session_id'] ?? '' ) );
		$product    = trim( (string) ( $intent['product'] ?? $spec['product'] ?? '' ) );
		$context    = self::merge_defaults(
			is_array( $spec['context'] ?? null ) ? $spec['context'] : array(),
			array_filter(
				array(
					'product'                => $product,
					'orchestrator'           => trim( (string) ( $intent['orchestrator'] ?? $spec['orchestrator']['id'] ?? '' ) ),
					'execution'              => trim( (string) ( $intent['execution'] ?? 'wp-codebox-browser-playground' ) ),
					'active_project_context' => is_array( $spec['active_project_context'] ?? null ) ? $spec['active_project_context'] : array(),
					'callback_refs'          => is_array( $spec['callback_refs'] ?? null ) ? $spec['callback_refs'] : array(),
				),
				static fn( mixed $value ): bool => '' !== $value && array() !== $value
			)
		);

		$allowed_tools       = self::string_list_any( $spec['desired_tools'] ?? $spec['tools'] ?? $spec['allowed_tools'] ?? array() );
		$tool_policy         = is_array( $spec['sandbox_tool_policy'] ?? null ) ? $spec['sandbox_tool_policy'] : ( new WP_Codebox_Sandbox_Tool_Policy_Normalizer() )->from_allowed_tools( $allowed_tools, $spec );
		$artifact_contract   = is_array( $spec['artifacts'] ?? null ) ? $spec['artifacts'] : array();
		$playground_defaults = self::playground_defaults_from_artifacts( $artifact_contract, $product );
		$browser_runner      = self::browser_runner_from_artifacts( $artifact_contract );

		$input = array_filter(
			array(
				'authorization'         => $spec['authorization'] ?? null,
				'placement'             => self::browser_execution_placement( self::string_list_lower( $spec['desired_capabilities'] ?? $spec['capabilities'] ?? array() ) ),
				'agent'                 => trim( (string) ( $spec['agent'] ?? $intent['agent'] ?? '' ) ),
				'mode'                  => trim( (string) ( $spec['mode'] ?? 'sandbox' ) ),
				'provider'              => trim( (string) ( $spec['provider'] ?? '' ) ),
				'model'                 => trim( (string) ( $spec['model'] ?? '' ) ),
				'agent_bundles'         => is_array( $spec['agent_bundles'] ?? null ) ? $spec['agent_bundles'] : array(),
				'provider_plugin_paths' => self::string_list_any( $spec['provider_plugin_paths'] ?? array() ),
				'runtimePresetId'       => trim( (string) ( $spec['runtimePresetId'] ?? $spec['runtime_preset_id'] ?? '' ) ),
				'inherit'               => is_array( $spec['inherit'] ?? null ) ? $spec['inherit'] : array(),
				'goal'                  => $goal,
				'sandbox_session_id'    => $session_id,
				'target'                => is_array( $spec['target'] ?? null ) ? $spec['target'] : self::target_from_intent( $intent, $session_id ),
				'allowed_tools'         => $allowed_tools,
				'expected_artifacts'    => self::string_list_any( $spec['expected_artifacts'] ?? $artifact_contract['expected'] ?? array() ),
				'structured_artifacts'  => is_array( $spec['structured_artifacts'] ?? null ) ? $spec['structured_artifacts'] : array(),
				'sandbox_tool_policy'   => $tool_policy,
				'policy'                => is_array( $spec['policy'] ?? null ) ? $spec['policy'] : array(),
				'context'               => $context,
				'orchestrator'          => is_array( $spec['orchestrator'] ?? null ) ? $spec['orchestrator'] : array_filter( array( 'id' => $context['orchestrator'] ?? '' ) ),
				'playground'            => self::merge_defaults( is_array( $spec['playground'] ?? null ) ? $spec['playground'] : array(), $playground_defaults ),
				'runtime_profile'       => is_array( $spec['runtime_profile'] ?? null ) ? $spec['runtime_profile'] : ( is_array( $spec['runtimeProfile'] ?? null ) ? $spec['runtimeProfile'] : array() ),
				'runtime'               => is_array( $spec['runtime'] ?? null ) ? $spec['runtime'] : array(),
				'runtime_requirements'  => self::runtime_requirements( is_array( $spec['runtime_requirements'] ?? null ) ? $spec['runtime_requirements'] : ( is_array( $spec['runtimeRequirements'] ?? null ) ? $spec['runtimeRequirements'] : array() ) ),
				'browser_runner'        => self::merge_defaults( is_array( $spec['browser_runner'] ?? null ) ? $spec['browser_runner'] : array(), $browser_runner ),
				'artifact_files'        => is_array( $artifact_contract['files'] ?? null ) ? $artifact_contract['files'] : ( is_array( $spec['artifact_files'] ?? null ) ? $spec['artifact_files'] : array() ),
				'callback_refs'         => is_array( $spec['callback_refs'] ?? null ) ? $spec['callback_refs'] : array(),
				'phases'                => is_array( $spec['phases'] ?? null ) ? $spec['phases'] : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value && null !== $value
		);

		return self::local_browser_task_input( $input );
	}

	/** @param array<string,mixed> $worker @return array<string,mixed> */
	public static function fanout_worker( array $worker ): array {
		return array_filter(
			array(
				'schema'  => 'wp-codebox/agent-fanout-worker/v1',
				'id'      => self::safe_key( (string) ( $worker['id'] ?? $worker['role'] ?? '' ) ),
				'agent'   => trim( (string) ( $worker['agent'] ?? '' ) ),
				'goal'    => trim( (string) ( $worker['goal'] ?? '' ) ),
				'context' => is_array( $worker['context'] ?? null ) ? $worker['context'] : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);
	}

	/** @param array<string,mixed> $request @return array<string,mixed> */
	public static function fanout_request( array $request ): array {
		$workers = array();
		foreach ( is_array( $request['workers'] ?? null ) ? $request['workers'] : array() as $worker ) {
			if ( is_array( $worker ) ) {
				$workers[] = self::fanout_worker( $worker );
			}
		}

		return array_filter(
			array(
				'schema'      => 'wp-codebox/agent-fanout-request/v1',
				'concurrency' => max( 1, (int) ( $request['concurrency'] ?? 1 ) ),
				'workers'     => $workers,
				'context'     => is_array( $request['context'] ?? null ) ? $request['context'] : array(),
				'orchestrator' => is_array( $request['orchestrator'] ?? null ) ? $request['orchestrator'] : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);
	}

	/**
	 * Applies portable defaults for browser-local Playground tasks.
	 *
	 * Callers keep ownership of product-specific context, artifacts, and phases;
	 * this method only fills the generic execution placement, mode, target,
	 * playground scope, and browser runner defaults used by local browser tasks.
	 *
	 * @param array<string,mixed> $input    Caller task input.
	 * @param array<string,mixed> $defaults Optional caller defaults to apply before generic defaults.
	 * @return array<string,mixed>
	 */
	public static function local_browser_task_input( array $input, array $defaults = array() ): array {
		$session_id = trim( (string) ( $input['sandbox_session_id'] ?? $input['session_id'] ?? $defaults['sandbox_session_id'] ?? $defaults['session_id'] ?? '' ) );
		$scope      = trim( (string) ( $input['playground']['scope'] ?? $defaults['playground']['scope'] ?? $session_id ) );

		$default_invocation = function_exists( 'apply_filters' )
			? apply_filters( 'wp_codebox_browser_runtime_default_invocation', array( 'type' => 'task', 'hook' => 'wp_codebox_browser_runtime_task' ), $input, $defaults )
			: array( 'type' => 'task', 'hook' => 'wp_codebox_browser_runtime_task' );
		$generic_defaults = array(
			'mode'       => 'sandbox',
			'placement'  => self::browser_execution_placement(),
			'target'     => array_filter(
				array(
					'kind' => 'browser-playground',
					'ref'  => '' !== $session_id ? $session_id : $scope,
				),
				static fn( mixed $value ): bool => '' !== $value
			),
			'context'    => array(
				'execution' => 'wp-codebox-browser-playground',
			),
			'playground' => array_filter(
				array(
					'scope' => $scope,
				),
				static fn( mixed $value ): bool => '' !== $value
			),
			'browser_runner' => array(
				'task_path'   => '/tmp/wp-codebox-browser-task.json',
				'result_path' => '/tmp/wp-codebox-browser-result.json',
				'invocation'  => is_array( $default_invocation ) ? $default_invocation : array( 'type' => 'task', 'hook' => 'wp_codebox_browser_runtime_task' ),
			),
		);

		$merged    = self::merge_defaults( self::merge_defaults( $input, $defaults ), $generic_defaults );
		$merged    = self::apply_runtime_profile( $merged );
		if ( class_exists( 'WP_Codebox_Runtime_Recipe_Resolver' ) ) {
			$resolved = WP_Codebox_Runtime_Recipe_Resolver::apply_to_input( $merged );
			if ( ! is_wp_error( $resolved ) ) {
				$merged = $resolved;
			}
		}
		$placement = is_array( $merged['placement'] ?? null ) ? $merged['placement'] : $generic_defaults['placement'];
		$placement['required_capabilities'] = self::string_list_lower(
			array_merge(
				$generic_defaults['placement']['required_capabilities'],
				is_array( $placement['required_capabilities'] ?? null ) ? $placement['required_capabilities'] : array(),
				is_array( $defaults['placement']['required_capabilities'] ?? null ) ? $defaults['placement']['required_capabilities'] : array(),
				is_array( $input['placement']['required_capabilities'] ?? null ) ? $input['placement']['required_capabilities'] : array()
			)
		);
		$merged['placement'] = $placement;

		return $merged;
	}

	/**
	 * Normalizes caller input into the canonical WP Codebox task input contract.
	 *
	 * @param array<string,mixed> $input Ability or caller input.
	 * @param callable|null       $allowed_tools_validator Optional validator: fn( array $tools, array $task_input ): WP_Error|null.
	 * @return array<string,mixed>|WP_Error
	 */
	public static function normalize_task_input( array $input, ?callable $allowed_tools_validator = null ): array|WP_Error {
		return WP_Codebox_Agent_Task::normalize_input( $input, $allowed_tools_validator, true );
	}

	/** @param array<int,string> $required_capabilities Additional required browser capabilities. @return array<string,mixed> */
	public static function browser_execution_placement( array $required_capabilities = array() ): array {
		return array(
			'schema'                => 'wp-codebox/execution-placement/v1',
			'preferred_target'      => 'browser',
			'allowed_targets'       => array( 'browser' ),
			'resource_class'        => 'interactive',
			'required_capabilities' => self::string_list_lower( array_merge( array( 'wordpress.playground', 'browser.preview' ), $required_capabilities ) ),
		);
	}

	/**
	 * Builds the generic browser agent task payload sent into the sandbox.
	 *
	 * Product-specific task data remains in task_input.context, target, policy,
	 * and structured_artifacts. This method only owns the WP Codebox envelope.
	 *
	 * @param array<string,mixed> $input       Ability or caller input.
	 * @param array<string,mixed> $task_input  Normalized task input.
	 * @param string              $session_id  Browser sandbox session id.
	 * @param array<int,array<string,mixed>> $artifacts Browser artifact specs.
	 * @param array{connectors:array<int,array<string,mixed>>,settings:array<int,array<string,mixed>>} $inheritance Resolved inheritance.
	 * @param array<string,callable> $resolvers Optional field resolvers for agent, mode, provider, model, secret_env, agent_bundles, and runtime_dependency_plan.
	 * @return array<string,mixed>
	 */
	public static function task_payload( array $input, array $task_input, string $session_id, array $artifacts, array $inheritance, array $resolvers = array() ): array {
		$resolve = static function ( string $name, mixed $fallback ) use ( $input, $task_input, $inheritance, $resolvers ): mixed {
			if ( isset( $resolvers[ $name ] ) && is_callable( $resolvers[ $name ] ) ) {
				return $resolvers[ $name ]( $input, $task_input, $inheritance );
			}

			return $fallback;
		};

		$dependency_plan = $resolve( 'runtime_dependency_plan', null );
		if ( ! $dependency_plan instanceof WP_Codebox_Runtime_Dependency_Plan ) {
			$dependency_plan = new WP_Codebox_Runtime_Dependency_Plan(
				array(
					'agent'    => self::agent_slug( $input ),
					'mode'     => self::mode( $input ),
					'provider' => self::provider( $input, $inheritance ),
					'model'    => self::model( $input, $inheritance ),
				),
				self::string_list( $input['provider_plugin_paths'] ?? array() ),
				array(),
				array(),
				self::array_resolver_value( $input['runtime_overlays'] ?? array() ),
				$inheritance,
				array( 'connectors' => array(), 'settings' => array() ),
				self::array_resolver_value( $task_input['agent_bundles'] ?? array() ),
				self::string_list( $input['secret_env'] ?? array() )
			);
		}

		return array_filter(
			array(
				'schema'        => 'wp-codebox/browser-agent-task-payload/v1',
				'agent'         => (string) $resolve( 'agent', (string) ( $dependency_plan->selection()['agent'] ?? self::agent_slug( $input ) ) ),
				'mode'          => (string) $resolve( 'mode', (string) ( $dependency_plan->selection()['mode'] ?? self::mode( $input ) ) ),
				'provider'      => (string) $resolve( 'provider', $dependency_plan->provider() ),
				'model'         => (string) $resolve( 'model', $dependency_plan->model() ),
				'message'       => (string) $task_input['goal'],
				'session_id'    => $session_id,
				'task_input'    => $task_input,
				'agent_bundles' => self::array_resolver_value( $resolve( 'agent_bundles', $dependency_plan->agent_bundles() ) ),
				'inheritance'   => $dependency_plan->inheritance(),
				'secret_env'    => self::string_list( $resolve( 'secret_env', $dependency_plan->secret_env_names() ) ),
				'artifacts'     => array(
					'schema' => 'wp-codebox/browser-artifacts/v1',
					'files'  => $artifacts,
				),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	public static function product_browser_session_dto( array $session ): array {
		$session_envelope = is_array( $session['session'] ?? null ) ? $session['session'] : array();
		$task_input       = is_array( $session['task_input'] ?? null ) ? $session['task_input'] : array();
		$signals          = is_array( $session['signals'] ?? null ) ? $session['signals'] : array();
		$preview_boot     = self::browser_preview_boot_config( $session );
		$blueprint_ref    = is_array( $preview_boot['blueprint_ref_dto'] ?? null ) ? $preview_boot['blueprint_ref_dto'] : self::browser_blueprint_ref( self::browser_prepared_runtime_from_envelope( $session, $preview_boot ), $session );
		$preview_lease    = self::preview_lease_from_session( $session );
		$runtime_access   = self::runtime_access_from_session( $session );
		$runtime_readiness = self::browser_runtime_readiness_dto( $session );
		$runtime_capabilities = self::browser_runtime_capabilities_dto( $session );

		$dto = array_filter(
			array(
				'schema'           => 'wp-codebox/browser-session-product-dto/v1',
				'dto_schema'       => 'wp-codebox/browser-preview-boot-config/v1',
				'source_schema'    => (string) ( $session['schema'] ?? '' ),
				'success'          => (bool) ( $session['success'] ?? false ),
				'preview_only'     => true === ( $session['preview_only'] ?? false ),
				'status'           => (string) ( $session['status'] ?? ( true === ( $session['success'] ?? false ) ? 'ready' : '' ) ),
				'execution'        => (string) ( $session['execution'] ?? '' ),
				'execution_scope'  => (string) ( $session['execution_scope'] ?? '' ),
				'permission_model' => (string) ( $session['permission_model'] ?? '' ),
				'session_id'       => (string) ( $session_envelope['id'] ?? $session['session_id'] ?? '' ),
				'contained_site'   => is_array( $session['contained_site'] ?? null ) ? self::compact_public_value( $session['contained_site'] ) : array(),
				'task'             => (string) ( $session['task'] ?? $task_input['goal'] ?? '' ),
				'target'           => is_array( $task_input['target'] ?? null ) ? self::compact_public_value( $task_input['target'] ) : array(),
				'agent'            => (string) ( $session['agent'] ?? '' ),
				'provider'         => (string) ( $session['provider'] ?? '' ),
				'model'            => (string) ( $session['model'] ?? '' ),
				'preview_boot'     => $preview_boot,
				'preview_lease'    => $preview_lease,
				'blueprint_ref'    => $blueprint_ref,
				'runtime_access'   => $runtime_access,
				'runtime_capabilities' => $runtime_capabilities,
				'runtime_readiness' => $runtime_readiness,
				'preview_ref'      => self::browser_preview_ref( $session ),
				'signals'          => self::compact_public_value( $signals ),
				'artifact_refs'    => self::browser_artifact_refs( $session ),
				'error'            => is_array( $session['error'] ?? null ) ? self::compact_public_value( $session['error'] ) : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);

		/**
		 * Filters the product-safe browser session DTO.
		 *
		 * Raw task payload, blueprint content, runtime source packages, and secret-like
		 * values are intentionally omitted before this filter runs.
		 *
		 * @param array<string,mixed> $dto     Product-safe browser session DTO.
		 * @param array<string,mixed> $session Source browser session contract.
		 */
		return function_exists( 'apply_filters' ) ? apply_filters( 'wp_codebox_browser_session_product_dto', $dto, $session ) : $dto;
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	private static function browser_runtime_capabilities_dto( array $session ): array {
		$playground = is_array( $session['playground'] ?? null ) ? $session['playground'] : array();
		$runtime    = is_array( $session['runtime'] ?? null ) ? $session['runtime'] : array();
		$task_input = is_array( $session['task_input'] ?? null ) ? $session['task_input'] : array();
		$profile    = is_array( $task_input['runtime_profile'] ?? null ) ? $task_input['runtime_profile'] : array();
		$capabilities = array();

		foreach ( is_array( $playground['capabilities'] ?? null ) ? $playground['capabilities'] : array() as $name => $enabled ) {
			if ( true === (bool) $enabled && is_string( $name ) && '' !== $name ) {
				$capabilities[] = 'browser:' . $name;
			}
		}
		foreach ( array( $session['runtime_capabilities'] ?? array(), $runtime['capabilities'] ?? array(), $profile['capabilities'] ?? array(), $task_input['runtime_capabilities'] ?? array() ) as $items ) {
			foreach ( is_array( $items ) ? $items : array() as $item ) {
				if ( is_scalar( $item ) && '' !== trim( (string) $item ) ) {
					$capabilities[] = trim( (string) $item );
				}
			}
		}

		$capabilities = array_values( array_unique( array_filter( $capabilities ) ) );
		return array_filter(
			array(
				'schema'       => 'wp-codebox/browser-runtime-capabilities/v1',
				'capabilities' => $capabilities,
			),
			static fn( mixed $value ): bool => array() !== $value
		);
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	private static function browser_runtime_readiness_dto( array $session ): array {
		$signals = is_array( $session['signals'] ?? null ) ? $session['signals'] : array();
		$ready_to_code = is_array( $signals['ready_to_code'] ?? null ) ? $signals['ready_to_code'] : array();
		$requirements = array();
		foreach ( is_array( $ready_to_code['requirements'] ?? null ) ? $ready_to_code['requirements'] : array() as $name => $ready ) {
			if ( is_string( $name ) && '' !== $name ) {
				$requirements[ $name ] = (bool) $ready;
			}
		}

		$missing = array_values( array_filter( array_map( 'strval', is_array( $ready_to_code['missing'] ?? null ) ? $ready_to_code['missing'] : array() ), static fn( string $value ): bool => '' !== $value ) );
		$status  = true === ( $ready_to_code['emitted'] ?? false ) ? 'ready' : ( empty( $ready_to_code ) ? 'unknown' : 'blocked' );

		return array_filter(
			array(
				'schema'       => 'wp-codebox/browser-runtime-readiness/v1',
				'status'       => $status,
				'ready'        => 'ready' === $status,
				'requirements' => $requirements,
				'missing'      => $missing,
				'message'      => (string) ( $ready_to_code['message'] ?? '' ),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	public static function browser_session_product_dto( array $session ): array {
		return self::product_browser_session_dto( $session );
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	public static function safe_browser_session_dto( array $session ): array {
		return self::product_browser_session_dto( $session );
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	public static function browser_preview_ref( array $session ): array {
		$contained_site = is_array( $session['contained_site'] ?? null ) ? $session['contained_site'] : array();
		$session_envelope = is_array( $session['session'] ?? null ) ? $session['session'] : array();
		$preview_boot = self::browser_preview_boot_config( $session );
		$preview = is_array( $preview_boot['preview'] ?? null ) ? $preview_boot['preview'] : array();

		return array_filter(
			array(
				'schema'     => 'wp-codebox/browser-preview-ref/v1',
				'id'         => (string) ( $contained_site['preview_id'] ?? '' ),
				'preview_id' => (string) ( $contained_site['preview_id'] ?? '' ),
				'session_id' => (string) ( $session_envelope['id'] ?? $session['session_id'] ?? $contained_site['session_id'] ?? '' ),
				'site_id'    => (string) ( $contained_site['site_id'] ?? '' ),
				'scope'      => (string) ( $preview_boot['scope'] ?? $contained_site['session_id'] ?? '' ),
				'url'        => (string) ( $preview['public_url'] ?? $preview['preview_public_url'] ?? $preview['local_url'] ?? '' ),
				'boot_ref'   => (string) ( $preview_boot['blueprint_ref'] ?? '' ),
			),
			static fn( string $value ): bool => '' !== $value
		);
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<int,array<string,mixed>> */
	public static function browser_artifact_refs( array $session ): array {
		$artifacts = is_array( $session['artifacts'] ?? null ) ? $session['artifacts'] : array();
		$files = is_array( $artifacts['files'] ?? null ) ? $artifacts['files'] : array();
		$refs = array();
		foreach ( $files as $file ) {
			if ( ! is_array( $file ) ) {
				continue;
			}

			$path = trim( (string) ( $file['path'] ?? '' ) );
			$refs[] = array_filter(
				array(
					'schema' => 'wp-codebox/browser-artifact-ref/v1',
					'kind'   => (string) ( $file['kind'] ?? 'browser-artifact' ),
					'path'   => '' !== $path ? 'files/browser/' . ltrim( $path, '/' ) : '',
					'digest' => self::browser_artifact_digest_ref( $file['sha256'] ?? null ),
					'size'   => isset( $file['size'] ) ? (int) $file['size'] : null,
				),
				static fn( mixed $value ): bool => null !== $value && '' !== $value && array() !== $value
			);
		}

		return array_values( array_filter( $refs ) );
	}

	private static function browser_artifact_digest_ref( mixed $digest ): array {
		$value = is_array( $digest ) ? (string) ( $digest['value'] ?? '' ) : (string) $digest;
		$value = trim( $value );

		return '' !== $value ? array( 'algorithm' => is_array( $digest ) ? (string) ( $digest['algorithm'] ?? 'sha256' ) : 'sha256', 'value' => $value ) : array();
	}

	/** @param array<string,mixed> $profile Runtime profile input. @return array<string,mixed> */
	public static function runtime_profile( array $profile ): array {
		$dependencies_input = is_array( $profile['dependencies'] ?? null ) ? $profile['dependencies'] : array();
		$profile           = array_merge( $dependencies_input, $profile );

		$dependencies = static function ( mixed $items, string $kind ): array {
			if ( ! is_array( $items ) ) {
				return array();
			}

			$normalized = array();
			foreach ( $items as $item ) {
				if ( is_string( $item ) ) {
					$item = array( 'slug' => $item );
				}
				if ( ! is_array( $item ) ) {
					continue;
				}
				$slug = trim( (string) ( $item['slug'] ?? $item['name'] ?? '' ) );
				if ( '' === $slug ) {
					continue;
				}
				$item['kind'] = trim( (string) ( $item['kind'] ?? $kind ) );
				$item['slug'] = $slug;
				$normalized[] = array_filter( $item, static fn( mixed $value ): bool => null !== $value && '' !== $value && array() !== $value );
			}

			return $normalized;
		};

		$runtime_profile = array_filter(
			array(
				'schema'       => 'wp-codebox/runtime-profile/v1',
				'id'           => trim( (string) ( $profile['id'] ?? '' ) ),
				'capabilities' => self::string_list_any( $profile['capabilities'] ?? array() ),
				'component_contracts' => self::object_list( $profile['component_contracts'] ?? array() ),
				'extra_plugins'       => self::object_list( $profile['extra_plugins'] ?? array() ),
				'provider_plugins'    => self::object_list( $profile['provider_plugins'] ?? array() ),
				'components'   => $dependencies( $profile['components'] ?? array(), 'component' ),
				'plugins'      => $dependencies( $profile['plugins'] ?? array(), 'plugin' ),
				'mu_plugins'   => $dependencies( $profile['mu_plugins'] ?? array(), 'mu_plugin' ),
				'themes'       => $dependencies( $profile['themes'] ?? array(), 'theme' ),
				'overlays'     => $dependencies( $profile['overlays'] ?? $profile['runtime_overlays'] ?? array(), 'overlay' ),
				'runtime_overlays'     => self::object_list( $profile['runtime_overlays'] ?? array() ),
				'runtime_state_mounts' => self::object_list( $profile['runtime_state_mounts'] ?? array() ),
				'runtime_config_mounts' => self::object_list( $profile['runtime_config_mounts'] ?? array() ),
				'prepared'     => is_array( $profile['prepared'] ?? null ) ? self::compact_public_value( $profile['prepared'] ) : array(),
				'bootstrap'    => is_array( $profile['bootstrap'] ?? null ) ? $profile['bootstrap'] : array(),
				'env'          => is_array( $profile['env'] ?? null ) ? self::string_map( $profile['env'] ) : array(),
				'readiness'    => is_array( $profile['readiness'] ?? null ) ? self::compact_public_value( $profile['readiness'] ) : array(),
				'diagnostics'  => self::object_list( $profile['diagnostics'] ?? array() ),
				'provenance'   => is_array( $profile['provenance'] ?? null ) ? self::compact_public_value( $profile['provenance'] ) : array(),
				'metadata'     => is_array( $profile['metadata'] ?? null ) ? self::compact_public_value( $profile['metadata'] ) : array(),
				'runtime_requirements' => self::runtime_requirements( is_array( $profile['runtime_requirements'] ?? null ) ? $profile['runtime_requirements'] : ( is_array( $profile['runtimeRequirements'] ?? null ) ? $profile['runtimeRequirements'] : array() ) ),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);

		return function_exists( 'apply_filters' ) ? apply_filters( 'wp_codebox_runtime_profile', $runtime_profile, $profile ) : $runtime_profile;
	}

	/** @param array<string,mixed> $input Browser task input. @return array<string,mixed> */
	public static function apply_runtime_profile( array $input ): array {
		$runtime = is_array( $input['runtime'] ?? null ) ? $input['runtime'] : array();
		$profile_input = is_array( $input['runtime_profile'] ?? null ) ? $input['runtime_profile'] : array();
		if ( class_exists( 'WP_Codebox_Runtime_Profile_Resolver' ) && empty( $runtime['resolved_profile'] ) && empty( $profile_input['resolved_profile'] ) ) {
			$resolved = WP_Codebox_Runtime_Profile_Resolver::apply_to_input( $input );
			if ( ! is_wp_error( $resolved ) ) {
				$input = $resolved;
			}
		}

		$profile = is_array( $input['runtime_profile'] ?? null ) ? self::runtime_profile( $input['runtime_profile'] ) : array();
		if ( empty( $profile ) ) {
			return $input;
		}

		$runtime = is_array( $input['runtime'] ?? null ) ? $input['runtime'] : array();
		$profile_plugins = self::merge_lists( self::object_list( $profile['plugins'] ?? array() ), self::object_list( $profile['provider_plugins'] ?? array() ) );
		$runtime_plugins = is_array( $runtime['plugins'] ?? null ) ? $runtime['plugins'] : array();
		$runtime['plugins'] = empty( $runtime['resolved_profile'] ) ? self::merge_lists( $profile_plugins, $runtime_plugins ) : self::merge_lists( $runtime_plugins, $profile_plugins );
		foreach ( array( 'components', 'mu_plugins', 'themes', 'bootstrap', 'runtime_overlays', 'runtime_state_mounts', 'runtime_config_mounts' ) as $field ) {
			$profile_items = self::object_list( $profile[ $field ] ?? array() );
			if ( ! empty( $profile_items ) ) {
				$runtime_items = is_array( $runtime[ $field ] ?? null ) ? $runtime[ $field ] : array();
				$runtime[ $field ] = empty( $runtime['resolved_profile'] ) ? self::merge_lists( $profile_items, $runtime_items ) : self::merge_lists( $runtime_items, $profile_items );
			}
		}
		if ( is_array( $profile['prepared'] ?? null ) && ! empty( $profile['prepared'] ) ) {
			$runtime['prepared'] = array_merge(
				$profile['prepared'],
				is_array( $runtime['prepared'] ?? null ) ? $runtime['prepared'] : array()
			);
		}

		$input['runtime']             = $runtime;
		$input['runtime_profile']     = $profile;
		$input['browser_plugins']     = array_merge( self::object_list( $profile['extra_plugins'] ?? array() ), is_array( $input['browser_plugins'] ?? null ) ? $input['browser_plugins'] : array() );
		$input['component_contracts'] = array_merge( self::object_list( $profile['component_contracts'] ?? array() ), is_array( $input['component_contracts'] ?? null ) ? $input['component_contracts'] : array() );
		$input['runtime_overlays']    = array_merge( self::object_list( $profile['runtime_overlays'] ?? array() ), is_array( $input['runtime_overlays'] ?? null ) ? $input['runtime_overlays'] : array() );
		$input['runtime_state_mounts'] = array_merge( self::object_list( $profile['runtime_state_mounts'] ?? array() ), is_array( $input['runtime_state_mounts'] ?? null ) ? $input['runtime_state_mounts'] : array() );
		$input['runtime_config_mounts'] = array_merge( self::object_list( $profile['runtime_config_mounts'] ?? array() ), is_array( $input['runtime_config_mounts'] ?? null ) ? $input['runtime_config_mounts'] : array() );
		$input['runtime_env']         = array_merge( self::string_map( is_array( $profile['env'] ?? null ) ? $profile['env'] : array() ), is_array( $input['runtime_env'] ?? null ) ? $input['runtime_env'] : array() );
		$input['provider_plugin_paths'] = array_values( array_unique( array_merge( self::provider_plugin_paths_from_specs( $profile['provider_plugins'] ?? array() ), self::string_list_any( $input['provider_plugin_paths'] ?? array() ) ) ) );
		$runtime_requirements = self::runtime_requirements( array_merge( is_array( $profile['runtime_requirements'] ?? null ) ? $profile['runtime_requirements'] : array(), is_array( $input['runtime_requirements'] ?? null ) ? $input['runtime_requirements'] : array() ) );
		if ( ! empty( $runtime_requirements ) ) {
			$input['runtime_requirements'] = $runtime_requirements;
		} else {
			unset( $input['runtime_requirements'] );
		}

		return function_exists( 'apply_filters' ) ? apply_filters( 'wp_codebox_apply_runtime_profile', $input, $profile ) : $input;
	}

	/** @param array<string,mixed> $requirements Runtime requirement contract input. @return array<string,mixed> */
	public static function runtime_requirements( array $requirements ): array {
		if ( array_key_exists( 'requires_provider', $requirements ) || array_key_exists( 'requiresProvider', $requirements ) ) {
			return array(
				'schema'            => 'wp-codebox/runtime-requirements/v1',
				'requires_provider' => (bool) ( $requirements['requires_provider'] ?? $requirements['requiresProvider'] ),
			);
		}

		return array();
	}

	/** @param array<string,mixed> $prepared Prepared runtime descriptor. @param array<string,mixed> $session Optional source session. @return array<string,mixed> */
	public static function browser_blueprint_ref( array $prepared, array $session = array() ): array {
		if ( ! empty( $prepared['has_post_runtime_blueprint'] ) && is_array( $session['playground']['blueprint'] ?? null ) ) {
			$prepared = self::browser_session_blueprint_ref_prepared( $prepared, $session, $session['playground']['blueprint'] );
		}
		$cache_key  = self::safe_key( (string) ( $prepared['cache_key'] ?? $prepared['key'] ?? '' ) );
		$input_hash = strtolower( trim( (string) ( $prepared['input_hash'] ?? $prepared['hash'] ?? '' ) ) );
		$ref        = '' !== $cache_key && preg_match( '/^[a-f0-9]{64}$/', $input_hash ) ? 'prepared:' . $cache_key . ':' . $input_hash : '';
		$endpoint   = '' !== $ref ? self::browser_blueprint_ref_hydration_endpoint( $ref ) : '';
		$hydration  = self::browser_blueprint_ref_hydration_status( $cache_key, $input_hash );

		return array_filter(
			array(
				'schema'          => 'wp-codebox/browser-blueprint-ref/v1',
				'id'              => $ref,
				'ref'             => $ref,
				'source'          => 'prepared-runtime-cache',
				'cache_key'       => $cache_key,
				'input_hash'      => $input_hash,
				'status'          => (string) ( $prepared['status'] ?? '' ),
				'hydration_status' => $hydration['status'],
				'hydratable'      => $hydration['hydratable'],
				'hydrator_ability' => 'wp-codebox/hydrate-browser-blueprint-ref',
				'endpoint'        => $endpoint,
				'hydration_endpoint' => $endpoint,
				'session_id'      => (string) ( $session['session']['id'] ?? $session['session_id'] ?? '' ),
			),
			static fn( mixed $value ): bool => null !== $value && '' !== $value && array() !== $value
		);
	}

	/** @param array<string,mixed> $prepared @param array<string,mixed> $session @param array<string,mixed> $blueprint @return array<string,mixed> */
	private static function browser_session_blueprint_ref_prepared( array $prepared, array $session, array $blueprint ): array {
		$cache_key  = self::safe_key( (string) ( $prepared['cache_key'] ?? $prepared['key'] ?? '' ) );
		$input_hash = strtolower( trim( (string) ( $prepared['input_hash'] ?? $prepared['hash'] ?? '' ) ) );
		if ( '' === $cache_key || ! preg_match( '/^[a-f0-9]{64}$/', $input_hash ) || ! function_exists( 'set_transient' ) ) {
			return $prepared;
		}

		$session_id = (string) ( $session['session']['id'] ?? $session['session_id'] ?? '' );
		$payload    = function_exists( 'wp_json_encode' ) ? wp_json_encode( array( 'prepared' => $input_hash, 'session' => $session_id, 'blueprint' => $blueprint ) ) : json_encode( array( 'prepared' => $input_hash, 'session' => $session_id, 'blueprint' => $blueprint ) );
		$ref_hash   = hash( 'sha256', 'wp-codebox/browser-session-blueprint-ref/v1' . "\n" . (string) $payload );
		$artifact   = array(
			'schema'     => 'wp-codebox/browser-prepared-runtime-artifact/v1',
			'cache_key'  => $cache_key,
			'input_hash' => $ref_hash,
			'blueprint'  => $blueprint,
		);
		$ttl        = defined( 'WEEK_IN_SECONDS' ) ? WEEK_IN_SECONDS : 604800;
		set_transient( self::prepared_runtime_transient_key( $cache_key, $ref_hash ), $artifact, $ttl );
		$prepared['input_hash'] = $ref_hash;

		return $prepared;
	}

	/** @param array<string,mixed> $input Prepared runtime, full session, or executable ref request. @return array<string,mixed> */
	public static function executable_blueprint_ref( array $input ): array {
		if ( is_array( $input['blueprint_ref'] ?? null ) ) {
			return $input['blueprint_ref'];
		}
		if ( is_array( $input['preview_boot']['blueprint_ref_dto'] ?? null ) ) {
			return $input['preview_boot']['blueprint_ref_dto'];
		}
		if ( is_array( $input['preview_boot']['blueprint_ref'] ?? null ) ) {
			return $input['preview_boot']['blueprint_ref'];
		}
		$session = is_array( $input['session'] ?? null ) ? $input['session'] : $input;
		$primary = is_array( $session['primary'] ?? null ) ? $session['primary'] : $session;
		$playground = is_array( $primary['playground'] ?? null ) ? $primary['playground'] : ( is_array( $input['playground'] ?? null ) ? $input['playground'] : array() );
		$prepared = self::browser_prepared_runtime_from_envelope( $input, $session, $primary, $playground );

		return self::browser_blueprint_ref( $prepared, $session );
	}

	/** @param array<string,mixed> ...$envelopes Candidate session/runtime envelopes. @return array<string,mixed> */
	private static function browser_prepared_runtime_from_envelope( array ...$envelopes ): array {
		foreach ( $envelopes as $envelope ) {
			if ( 'wp-codebox/browser-prepared-runtime/v1' === ( $envelope['schema'] ?? '' ) || ( '' !== (string) ( $envelope['cache_key'] ?? '' ) && '' !== (string) ( $envelope['input_hash'] ?? '' ) ) ) {
				return $envelope;
			}

			foreach ( array( 'prepared_runtime', 'prepared' ) as $field ) {
				if ( is_array( $envelope[ $field ] ?? null ) && ( 'wp-codebox/browser-prepared-runtime/v1' === ( $envelope[ $field ]['schema'] ?? '' ) || ( '' !== (string) ( $envelope[ $field ]['cache_key'] ?? '' ) && '' !== (string) ( $envelope[ $field ]['input_hash'] ?? '' ) ) ) ) {
					return $envelope[ $field ];
				}
			}

			if ( is_array( $envelope['recovery']['input'] ?? null ) ) {
				$prepared = self::browser_prepared_runtime_from_envelope( $envelope['recovery']['input'] );
				if ( ! empty( $prepared ) ) {
					return $prepared;
				}
			}

			foreach ( array( 'playground', 'runtime', 'contained_site' ) as $field ) {
				if ( is_array( $envelope[ $field ] ?? null ) ) {
					$prepared = self::browser_prepared_runtime_from_envelope( $envelope[ $field ] );
					if ( ! empty( $prepared ) ) {
						return $prepared;
					}
				}
			}
		}

		return array();
	}

	/** @param array<string,mixed> $input Blueprint ref input. @return array<string,mixed>|WP_Error */
	public static function hydrate_browser_blueprint_ref( array $input ): array|WP_Error {
		$ref        = trim( (string) ( $input['ref'] ?? '' ) );
		$cache_key  = self::safe_key( (string) ( $input['cache_key'] ?? '' ) );
		$input_hash = strtolower( trim( (string) ( $input['input_hash'] ?? '' ) ) );
		if ( '' !== $ref && preg_match( '/^prepared:([^:]+):([a-f0-9]{64})$/', $ref, $matches ) ) {
			$cache_key  = self::safe_key( $matches[1] );
			$input_hash = $matches[2];
		}

		if ( '' === $cache_key || ! preg_match( '/^[a-f0-9]{64}$/', $input_hash ) ) {
			return new WP_Error( 'wp_codebox_browser_blueprint_ref_missing', 'Browser blueprint hydration requires a hydratable prepared runtime ref. Use prepare-new to create a preview session before hydrating.', self::browser_blueprint_ref_miss_contract( $cache_key, $input_hash, $ref, 'hydratable-ref-missing' ) );
		}

		$transient_key = self::prepared_runtime_transient_key( $cache_key, $input_hash );
		$artifact      = function_exists( 'get_transient' ) ? get_transient( $transient_key ) : false;
		if ( ! is_array( $artifact ) ) {
			return new WP_Error(
				'wp_codebox_browser_blueprint_ref_expired',
				'Browser blueprint ref expired from the prepared runtime cache. Use prepare-new to materialize the preview again.',
				self::browser_blueprint_ref_miss_contract( $cache_key, $input_hash, '' !== $ref ? $ref : 'prepared:' . $cache_key . ':' . $input_hash, 'expired-transient' )
			);
		}

		if ( $input_hash !== (string) ( $artifact['input_hash'] ?? '' ) ) {
			return new WP_Error(
				'wp_codebox_browser_blueprint_ref_input_hash_mismatch',
				'Browser blueprint ref input hash does not match the prepared runtime cache artifact. Use prepare-new to create a matching preview session.',
				self::browser_blueprint_ref_miss_contract( $cache_key, $input_hash, '' !== $ref ? $ref : 'prepared:' . $cache_key . ':' . $input_hash, 'input-hash-mismatch' )
			);
		}

		if ( 'wp-codebox/browser-prepared-runtime-artifact/v1' !== ( $artifact['schema'] ?? '' ) || ! is_array( $artifact['blueprint'] ?? null ) ) {
			return new WP_Error(
				'wp_codebox_browser_blueprint_ref_cache_miss',
				'Browser blueprint ref could not be hydrated from the prepared runtime cache. Use prepare-new to create a preview session before hydrating.',
				self::browser_blueprint_ref_miss_contract( $cache_key, $input_hash, '' !== $ref ? $ref : 'prepared:' . $cache_key . ':' . $input_hash, 'cache-miss' )
			);
		}

		return array(
			'success'   => true,
			'schema'    => 'wp-codebox/browser-blueprint-hydration/v1',
			'blueprint_ref' => self::browser_blueprint_ref( array( 'cache_key' => $cache_key, 'input_hash' => $input_hash, 'status' => 'hydrated' ) ),
			'blueprint' => $artifact['blueprint'],
			'provenance' => array(
				'source' => 'prepared-runtime-cache',
				'transient_key' => $transient_key,
			),
		);
	}

	/** @param array<string,mixed> $input Browser session or preview input. @return array<string,mixed> */
	public static function preview_boot_config( array $input ): array {
		return self::browser_preview_boot_config( $input );
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	public static function browser_preview_boot_config( array $session ): array {
		$primary                = is_array( $session['primary'] ?? null ) ? $session['primary'] : array();
		$playground             = is_array( $session['playground'] ?? null ) ? $session['playground'] : ( is_array( $primary['playground'] ?? null ) ? $primary['playground'] : array() );
		$prepared_runtime       = self::browser_prepared_runtime_from_envelope( $session, $playground );
		$session_envelope       = is_array( $session['session'] ?? null ) ? $session['session'] : array();
		$blueprint_ref          = self::browser_blueprint_ref( $prepared_runtime, $session );

		$config = array_filter(
			array(
				'schema'            => 'wp-codebox/browser-preview-boot-config/v1',
				'session_id'        => (string) ( $session_envelope['id'] ?? $session['session_id'] ?? '' ),
				'scope'             => (string) ( $playground['scope'] ?? '' ),
				'client_module_url' => (string) ( $playground['client_module_url'] ?? '' ),
				'remote_url'        => (string) ( $playground['remote_url'] ?? '' ),
				'cors_proxy_url'    => (string) ( $playground['cors_proxy_url'] ?? '' ),
				'blueprint_ref'     => '' !== (string) ( $blueprint_ref['ref'] ?? '' ) ? (string) $blueprint_ref['ref'] : '',
				'blueprint_ref_dto' => '' !== (string) ( $blueprint_ref['ref'] ?? '' ) ? $blueprint_ref : array(),
				'preview'           => self::preview_lease_from_session( $session ),
				'runtime_access'    => self::runtime_access_from_session( $session ),
				'contained_site'    => is_array( $session['contained_site'] ?? null ) ? self::compact_public_value( $session['contained_site'] ) : array(),
				'artifacts'         => array_filter(
					array(
						'base_url'    => (string) ( $playground['artifact_base_url'] ?? '' ),
						'preview_url' => (string) ( $playground['preview_url'] ?? '' ),
					),
					static fn( string $value ): bool => '' !== $value
				),
				'provenance'        => is_array( $playground['provenance'] ?? null ) ? self::compact_public_value( $playground['provenance'] ) : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);

		/**
		 * Filters the product-safe browser preview boot config.
		 *
		 * @param array<string,mixed> $config  Browser preview boot config.
		 * @param array<string,mixed> $session Source browser session contract.
		 */
		return function_exists( 'apply_filters' ) ? apply_filters( 'wp_codebox_browser_preview_boot_config', $config, $session ) : $config;
	}

	/**
	 * @param array<string,mixed> $preview_boot Browser preview boot config.
	 * @param array<string,mixed> $blueprint_ref Browser blueprint ref DTO.
	 * @return array{valid:bool,reason:string}
	 */
	public static function validate_browser_preview_boot_contract( array $preview_boot, array $blueprint_ref = array() ): array {
		$boot_ref           = trim( (string) ( $preview_boot['blueprint_ref'] ?? '' ) );
		$boot_ref_dto       = is_array( $preview_boot['blueprint_ref_dto'] ?? null ) ? $preview_boot['blueprint_ref_dto'] : array();
		$boot_dto_ref       = trim( (string) ( $boot_ref_dto['ref'] ?? $boot_ref_dto['id'] ?? '' ) );
		$contract_ref       = trim( (string) ( $blueprint_ref['ref'] ?? $blueprint_ref['id'] ?? '' ) );
		$hydration_endpoint = trim( (string) ( $boot_ref_dto['hydration_endpoint'] ?? $boot_ref_dto['endpoint'] ?? '' ) );

		if ( '' === $boot_ref ) {
			return array( 'valid' => false, 'reason' => 'prepare-new-required' );
		}

		if ( '' === $boot_dto_ref ) {
			return array( 'valid' => false, 'reason' => 'preview-boot-blueprint-ref-dto-missing' );
		}

		if ( $boot_ref !== $boot_dto_ref || ( '' !== $contract_ref && $boot_ref !== $contract_ref ) ) {
			return array( 'valid' => false, 'reason' => 'preview-boot-blueprint-ref-mismatch' );
		}

		if ( '' === $hydration_endpoint ) {
			return array( 'valid' => false, 'reason' => 'preview-boot-hydration-endpoint-missing' );
		}

		return array( 'valid' => true, 'reason' => 'preview-boot-contract-hydratable' );
	}

	/** @param array<string,mixed> $recipe Browser workspace recipe. @return array<string,mixed> */
	public static function browser_recipe_dto( array $recipe ): array {
		$runtime = is_array( $recipe['runtime'] ?? null ) ? $recipe['runtime'] : array();
		$browser = is_array( $recipe['browser'] ?? null ) ? $recipe['browser'] : array();
		$workflow_steps = array();
		foreach ( is_array( $recipe['workflow']['steps'] ?? null ) ? $recipe['workflow']['steps'] : array() as $index => $step ) {
			if ( ! is_array( $step ) ) {
				continue;
			}

			$workflow_steps[] = array_filter(
				array(
					'index'   => $index,
					'command' => (string) ( $step['command'] ?? '' ),
					'args'    => self::browser_recipe_safe_args( is_array( $step['args'] ?? null ) ? $step['args'] : array(), $browser ),
				),
				static fn( mixed $value ): bool => '' !== $value && array() !== $value
			);
		}

		$dto = array_filter(
			array(
				'schema'        => 'wp-codebox/browser-recipe-dto/v1',
				'source_schema' => (string) ( $recipe['schema'] ?? '' ),
				'runtime'       => array_filter(
					array(
						'backend'       => (string) ( $runtime['backend'] ?? '' ),
						'name'          => (string) ( $runtime['name'] ?? '' ),
						'wp'            => (string) ( $runtime['wp'] ?? '' ),
						'blueprint_ref' => self::browser_blueprint_ref( is_array( $runtime['prepared_runtime'] ?? null ) ? $runtime['prepared_runtime'] : array() ),
					),
					static fn( mixed $value ): bool => '' !== $value && array() !== $value
				),
				'inputs'        => is_array( $recipe['inputs'] ?? null ) ? self::compact_public_value( $recipe['inputs'] ) : array(),
				'workflow'      => array_filter( array( 'steps' => $workflow_steps ), static fn( mixed $value ): bool => array() !== $value ),
				'artifacts'     => is_array( $recipe['artifacts'] ?? null ) ? self::compact_public_value( $recipe['artifacts'] ) : array(),
				'browser'       => self::browser_recipe_browser_dto( $browser ),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);

		return function_exists( 'apply_filters' ) ? apply_filters( 'wp_codebox_browser_recipe_dto', $dto, $recipe ) : $dto;
	}

	/** @param array<int,mixed> $args Step args. @param array<string,mixed> $browser Browser recipe metadata. @return array<int,string|array<string,mixed>> */
	private static function browser_recipe_safe_args( array $args, array $browser ): array {
		$safe_args = array();
		foreach ( $args as $arg ) {
			if ( ! is_scalar( $arg ) ) {
				continue;
			}

			$arg = (string) $arg;
			if ( str_starts_with( $arg, 'code=' ) ) {
				$safe_args[] = array_filter(
					array(
						'kind'            => 'generated-php',
						'runner_contract' => is_array( $browser['runner_contract'] ?? null ) ? self::browser_recipe_runner_contract_dto( $browser['runner_contract'] ) : array(),
					),
					static fn( mixed $value ): bool => array() !== $value && '' !== $value
				);
				continue;
			}

			$safe_args[] = $arg;
		}

		return $safe_args;
	}

	/** @param array<string,mixed> $browser Browser recipe metadata. @return array<string,mixed> */
	private static function browser_recipe_browser_dto( array $browser ): array {
		return array_filter(
			array(
				'execution'       => (string) ( $browser['execution'] ?? '' ),
				'task_path'       => (string) ( $browser['task_path'] ?? '' ),
				'result_path'     => (string) ( $browser['result_path'] ?? '' ),
				'invocation'      => is_array( $browser['invocation'] ?? null ) ? self::compact_public_value( $browser['invocation'] ) : array(),
				'captures'        => is_array( $browser['captures'] ?? null ) ? self::compact_public_value( $browser['captures'] ) : array(),
				'runner_contract' => is_array( $browser['runner_contract'] ?? null ) ? self::browser_recipe_runner_contract_dto( $browser['runner_contract'] ) : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);
	}

	/** @param array<string,mixed> $contract Browser runner contract. @return array<string,mixed> */
	private static function browser_recipe_runner_contract_dto( array $contract ): array {
		$dto = array( 'schema' => (string) ( $contract['schema'] ?? 'wp-codebox/browser-runner-contract/v1' ) );
		foreach ( array( 'php_prelude', 'php_footer' ) as $field ) {
			$value = (string) ( $contract[ $field ] ?? '' );
			if ( '' !== $value ) {
				$dto[ $field ] = array(
					'type'   => 'generated-php-fragment',
					'bytes'  => strlen( $value ),
					'sha256' => hash( 'sha256', $value ),
				);
			}
		}

		return $dto;
	}

	/** @param array<string,mixed> $session Browser session or preview input. @return array<string,mixed> */
	public static function preview_lease( array $session ): array {
		return self::preview_lease_from_session( $session );
	}

	/** @param array<string,mixed> $session Browser session or preview input. */
	public static function preview_lease_status( array $session ): string {
		$lease = self::preview_lease_from_session( $session );
		$status = (string) ( $lease['lease']['status'] ?? '' );
		if ( 'released' === $status ) {
			return 'released';
		}

		$expires_at = (string) ( $lease['lease']['expires_at'] ?? '' );
		if ( '' !== $expires_at ) {
			$expires = strtotime( $expires_at );
			if ( false !== $expires && $expires <= time() ) {
				return 'expired';
			}
		}

		if ( 'active' === $status || ! empty( $lease['public_url'] ) || ! empty( $lease['preview_public_url'] ) || ! empty( $lease['site_url'] ) || ! empty( $lease['local_url'] ) ) {
			return 'active';
		}

		return 'expired' === $status ? 'expired' : 'unknown';
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	private static function preview_lease_from_session( array $session ): array {
		if ( 'wp-codebox/preview-lease/v1' === (string) ( $session['schema'] ?? '' ) ) {
			return self::canonical_preview_lease( self::compact_public_value( $session ) );
		}

		if ( is_array( $session['preview_boot']['preview'] ?? null ) ) {
			return self::canonical_preview_lease( self::compact_public_value( $session['preview_boot']['preview'] ) );
		}

		if ( is_array( $session['preview'] ?? null ) && 'wp-codebox/preview-lease/v1' === (string) ( $session['preview']['schema'] ?? '' ) ) {
			return self::canonical_preview_lease( self::compact_public_value( $session['preview'] ) );
		}

		$playground = is_array( $session['playground'] ?? null ) ? $session['playground'] : array();
		$lease      = is_array( $playground['lease'] ?? null ) ? $playground['lease'] : ( is_array( $session['preview_lease'] ?? null ) ? $session['preview_lease'] : array() );
		$alignment  = is_array( $playground['alignment'] ?? null ) ? $playground['alignment'] : array( 'status' => 'unknown' );
		$public_url = (string) ( $playground['public_url'] ?? $playground['preview_public_url'] ?? $session['public_url'] ?? $session['preview_public_url'] ?? '' );
		$reachability = is_array( $playground['reachability'] ?? null ) ? $playground['reachability'] : ( is_array( $session['reachability'] ?? null ) ? $session['reachability'] : array() );
		$evidence_refs = is_array( $playground['evidence_refs'] ?? null ) ? $playground['evidence_refs'] : ( is_array( $session['evidence_refs'] ?? null ) ? $session['evidence_refs'] : array() );

		return self::canonical_preview_lease( array_filter(
			array(
				'schema'             => 'wp-codebox/preview-lease/v1',
				'public_url'         => $public_url,
				'preview_public_url' => $public_url,
				'site_url'           => (string) ( $playground['site_url'] ?? $playground['remote_url'] ?? '' ),
				'local_url'          => (string) ( $playground['local_url'] ?? $playground['preview_url'] ?? '' ),
				'lease'              => self::compact_public_value( $lease ),
				'reachability'       => self::compact_public_value( $reachability ),
				'alignment'          => self::compact_public_value( $alignment ),
				'evidence_refs'      => self::compact_public_value( $evidence_refs ),
				'provenance'         => is_array( $playground['provenance'] ?? null ) ? self::compact_public_value( $playground['provenance'] ) : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		) );
	}

	/** @param array<string,mixed> $lease Preview lease DTO. @return array<string,mixed> */
	private static function canonical_preview_lease( array $lease ): array {
		$public_url = (string) ( $lease['public_url'] ?? $lease['preview_public_url'] ?? '' );
		if ( '' !== $public_url ) {
			$lease['public_url'] = $public_url;
			$lease['preview_public_url'] = $public_url;
		}

		return $lease;
	}

	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	private static function runtime_access_from_session( array $session ): array {
		if ( is_array( $session['runtime_access'] ?? null ) ) {
			$access = self::compact_public_value( $session['runtime_access'] );
			$access['schema'] = 'wp-codebox/runtime-access/v1';
			return $access;
		}

		$playground = is_array( $session['playground'] ?? null ) ? $session['playground'] : array();
		$lease      = self::preview_lease_from_session( $session );
		$public_url = (string) ( $lease['public_url'] ?? $lease['preview_public_url'] ?? $playground['public_url'] ?? $playground['preview_public_url'] ?? '' );
		$site_url   = (string) ( $lease['site_url'] ?? $playground['site_url'] ?? $playground['remote_url'] ?? '' );
		$local_url  = (string) ( $lease['local_url'] ?? $playground['preview_url'] ?? '' );
		$reviewer_access = is_array( $session['reviewer_access'] ?? null ) ? self::compact_public_value( $session['reviewer_access'] ) : array();
		$preview_url = (string) ( $session['preview_url'] ?? $playground['preview_url'] ?? '' );
		if ( '' === $preview_url ) {
			$preview_url = '' !== $public_url ? $public_url : ( '' !== $site_url ? $site_url : $local_url );
		}

		return array_filter(
			array(
				'schema'          => 'wp-codebox/runtime-access/v1',
				'preview_url'     => '' !== $public_url ? $public_url : $preview_url,
				'public_url'      => $public_url,
				'site_url'        => $site_url,
				'admin_url'       => (string) ( $session['admin_url'] ?? $playground['admin_url'] ?? '' ),
				'lease'           => $lease,
				'reviewer_access' => $reviewer_access,
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);
	}

	private static function compact_public_value( mixed $value, string $key = '' ): mixed {
		if ( in_array( $key, array( 'task_payload', 'pluginData', 'source', 'content', 'content_base64', 'bundle', 'blueprint', 'fallback_blueprint', 'runtime', 'prepared_runtime', 'prepared', 'plugins', 'artifact_base_path', 'base_path', 'task_path', 'result_path', 'event_stream_path', 'capture_paths', 'materialization_result_path' ), true ) ) {
			return null;
		}
		if ( class_exists( 'WP_Codebox_Redaction_Policy' ) && WP_Codebox_Redaction_Policy::key_should_redact( 'public_session_dto', $key ) ) {
			return '[redacted]';
		}
		if ( ! is_array( $value ) ) {
			return $value;
		}

		$compact = array();
		foreach ( $value as $child_key => $child_value ) {
			$child_compact = self::compact_public_value( $child_value, is_string( $child_key ) ? $child_key : '' );
			if ( null !== $child_compact && array() !== $child_compact && '' !== $child_compact ) {
				$compact[ $child_key ] = $child_compact;
			}
		}

		return $compact;
	}

	private static function browser_blueprint_ref_hydration_endpoint( string $ref ): string {
		if ( '' === $ref ) {
			return '';
		}

		$endpoint = '/wp-codebox/v1/browser-blueprint-ref?ref=' . rawurlencode( $ref );
		if ( function_exists( 'wp_create_nonce' ) ) {
			$endpoint .= '&_wpnonce=' . rawurlencode( wp_create_nonce( 'wp_rest' ) );
		}

		return $endpoint;
	}

	/** @param array<mixed> $value Values to normalize. @return array<string,string> */
	private static function string_map( array $value ): array {
		$map = array();
		foreach ( $value as $key => $entry ) {
			$key = trim( (string) $key );
			if ( '' !== $key && is_scalar( $entry ) ) {
				$map[ $key ] = (string) $entry;
			}
		}

		return $map;
	}

	/** @param mixed $value Values to normalize. @return array<int,array<string,mixed>> */
	private static function object_list( mixed $value ): array {
		if ( ! is_array( $value ) ) {
			return array();
		}

		$list = array();
		foreach ( $value as $entry ) {
			if ( is_array( $entry ) ) {
				$list[] = $entry;
			}
		}

		return $list;
	}

	/** @return array<int,mixed> */
	private static function merge_lists( mixed ...$lists ): array {
		$merged = array();
		$seen   = array();
		foreach ( $lists as $list ) {
			foreach ( is_array( $list ) ? $list : array() as $item ) {
				$key = is_array( $item ) ? md5( wp_json_encode( $item ) ?: serialize( $item ) ) : 'scalar:' . (string) $item;
				if ( isset( $seen[ $key ] ) ) {
					continue;
				}
				$seen[ $key ] = true;
				$merged[]     = $item;
			}
		}

		return $merged;
	}

	/** @param mixed $value Provider plugin specs. @return string[] */
	private static function provider_plugin_paths_from_specs( mixed $value ): array {
		$paths = array();
		foreach ( self::object_list( $value ) as $spec ) {
			$path = trim( (string) ( $spec['path'] ?? $spec['source'] ?? '' ) );
			if ( '' !== $path && ! in_array( $path, $paths, true ) ) {
				$paths[] = $path;
			}
		}

		return $paths;
	}

	private static function prepared_runtime_transient_key( string $cache_key, string $input_hash ): string {
		return 'wp_codebox_browser_prepared_runtime_' . substr( hash( 'sha256', $cache_key . ':' . $input_hash ), 0, 24 );
	}

	/** @return array{status:string,hydratable:bool} */
	private static function browser_blueprint_ref_hydration_status( string $cache_key, string $input_hash ): array {
		if ( '' === $cache_key || ! preg_match( '/^[a-f0-9]{64}$/', $input_hash ) ) {
			return array( 'status' => 'hydratable-ref-missing', 'hydratable' => false );
		}

		if ( ! function_exists( 'get_transient' ) ) {
			return array( 'status' => 'unknown', 'hydratable' => true );
		}

		$artifact = get_transient( self::prepared_runtime_transient_key( $cache_key, $input_hash ) );
		if ( is_array( $artifact ) && 'wp-codebox/browser-prepared-runtime-artifact/v1' === ( $artifact['schema'] ?? '' ) && $input_hash === (string) ( $artifact['input_hash'] ?? '' ) && is_array( $artifact['blueprint'] ?? null ) ) {
			return array( 'status' => 'available', 'hydratable' => true );
		}
		if ( is_array( $artifact ) && $input_hash !== (string) ( $artifact['input_hash'] ?? '' ) ) {
			return array( 'status' => 'input-hash-mismatch', 'hydratable' => false );
		}
		if ( is_array( $artifact ) ) {
			return array( 'status' => 'cache-miss', 'hydratable' => false );
		}

		return array( 'status' => 'expired-transient', 'hydratable' => false );
	}

	/** @return array<string,mixed> */
	private static function browser_blueprint_ref_miss_contract( string $cache_key, string $input_hash, string $ref, string $state = 'cache-miss' ): array {
		return array(
			'status'                   => 409,
			'success'                  => false,
			'schema'                   => 'wp-codebox/browser-blueprint-ref-miss/v1',
			'ref'                      => $ref,
			'cache_key'                => $cache_key,
			'input_hash'               => $input_hash,
			'preview_state'            => $state,
			'action'                   => 'prepare-new',
			'open_mode'                => 'materialize',
			'reload_required'          => true,
			'requires_materialization' => true,
			'prepare_new_required'     => true,
			'reason'                  => $state,
			'blueprint_ref'            => self::browser_blueprint_ref( array( 'cache_key' => $cache_key, 'input_hash' => $input_hash, 'status' => $state ) ),
		);
	}

	/** @param array<string,mixed> $input Ability or caller input. */
	private static function agent_slug( array $input ): string {
		$agent = trim( (string) ( $input['agent'] ?? '' ) );
		return '' !== $agent ? $agent : 'wp-codebox-sandbox';
	}

	/** @param array<string,mixed> $input Ability or caller input. */
	private static function mode( array $input ): string {
		$mode = trim( (string) ( $input['mode'] ?? '' ) );
		return '' !== $mode ? $mode : 'sandbox';
	}

	/** @param array<string,mixed> $input Ability or caller input. @param array{connectors:array<int,array<string,mixed>>,settings:array<int,array<string,mixed>>} $inheritance */
	private static function provider( array $input, array $inheritance ): string {
		$provider = trim( (string) ( $input['provider'] ?? '' ) );
		if ( '' !== $provider ) {
			return $provider;
		}

		foreach ( is_array( $inheritance['connectors'] ?? null ) ? $inheritance['connectors'] : array() as $connector ) {
			$provider = trim( (string) ( $connector['provider'] ?? '' ) );
			if ( '' !== $provider ) {
				return $provider;
			}
		}

		return '';
	}

	/** @param array<string,mixed> $input Ability or caller input. @param array{connectors:array<int,array<string,mixed>>,settings:array<int,array<string,mixed>>} $inheritance */
	private static function model( array $input, array $inheritance ): string {
		$model = trim( (string) ( $input['model'] ?? '' ) );
		if ( '' !== $model ) {
			return $model;
		}

		foreach ( is_array( $inheritance['connectors'] ?? null ) ? $inheritance['connectors'] : array() as $connector ) {
			$model = trim( (string) ( $connector['model'] ?? '' ) );
			if ( '' !== $model ) {
				return $model;
			}
		}

		return '';
	}

	/** @param array<string,mixed> $intent */
	private static function target_from_intent( array $intent, string $session_id ): array {
		return array_filter(
			array(
				'kind' => trim( (string) ( $intent['target_kind'] ?? $intent['kind'] ?? 'browser-playground' ) ),
				'ref'  => trim( (string) ( $intent['target_ref'] ?? $intent['ref'] ?? $session_id ) ),
				'path' => trim( (string) ( $intent['target_path'] ?? $intent['path'] ?? '' ) ),
				'url'  => trim( (string) ( $intent['target_url'] ?? $intent['url'] ?? '' ) ),
			),
			static fn( string $value ): bool => '' !== $value
		);
	}

	/** @param array<string,mixed> $artifacts @return array<string,mixed> */
	private static function playground_defaults_from_artifacts( array $artifacts, string $product ): array {
		$base = trim( (string) ( $artifacts['base_path'] ?? $artifacts['artifact_base_path'] ?? '' ) );
		if ( '' === $base && '' !== $product ) {
			$base = '/wordpress/wp-content/uploads/' . self::safe_key( $product );
		}

		return array_filter(
			array(
				'artifact_base_path' => $base,
				'artifact_base_url'  => trim( (string) ( $artifacts['base_url'] ?? $artifacts['artifact_base_url'] ?? ( '' !== $product ? '/wp-content/uploads/' . self::safe_key( $product ) : '' ) ) ),
				'preview_url'        => trim( (string) ( $artifacts['preview_url'] ?? '' ) ),
			),
			static fn( string $value ): bool => '' !== $value
		);
	}

	/** @param array<string,mixed> $artifacts @return array<string,mixed> */
	private static function browser_runner_from_artifacts( array $artifacts ): array {
		return array_filter(
			array(
				'task_path'     => trim( (string) ( $artifacts['task_path'] ?? '' ) ),
				'result_path'   => trim( (string) ( $artifacts['result_path'] ?? '' ) ),
				'invocation'    => is_array( $artifacts['invocation'] ?? null ) ? $artifacts['invocation'] : array(),
				'capture_paths' => is_array( $artifacts['capture_paths'] ?? null ) ? $artifacts['capture_paths'] : array(),
			),
			static fn( mixed $value ): bool => '' !== $value && array() !== $value
		);
	}

	private static function safe_key( string $value ): string {
		return trim( strtolower( preg_replace( '/[^a-zA-Z0-9_\-]+/', '-', $value ) ?? '' ), '-' );
	}

	/** @return array<int,mixed> */
	private static function array_resolver_value( mixed $value ): array {
		return is_array( $value ) ? $value : array();
	}

	/** @return string[] */
	private static function string_list( mixed $value ): array {
		if ( ! is_array( $value ) ) {
			return array();
		}

		$items = array();
		foreach ( $value as $item ) {
			$item = trim( (string) $item );
			if ( '' !== $item && 1 === preg_match( '/^[A-Z_][A-Z0-9_]*$/', $item ) && ! in_array( $item, $items, true ) ) {
				$items[] = $item;
			}
		}

		return $items;
	}

	/** @return string[] */
	private static function string_list_any( mixed $value ): array {
		if ( ! is_array( $value ) ) {
			return array();
		}

		$items = array();
		foreach ( $value as $item ) {
			$item = trim( (string) $item );
			if ( '' !== $item && ! in_array( $item, $items, true ) ) {
				$items[] = $item;
			}
		}

		return $items;
	}

	/** @param array<string,mixed> $input Caller input. @param array<string,mixed> $defaults Defaults. @return array<string,mixed> */
	private static function merge_defaults( array $input, array $defaults ): array {
		foreach ( $defaults as $key => $value ) {
			if ( ! array_key_exists( $key, $input ) ) {
				$input[ $key ] = $value;
				continue;
			}

			if ( is_array( $input[ $key ] ) && is_array( $value ) && self::is_assoc( $input[ $key ] ) && self::is_assoc( $value ) ) {
				$input[ $key ] = self::merge_defaults( $input[ $key ], $value );
			}
		}

		return $input;
	}

	/** @param array<mixed> $value Value to inspect. */
	private static function is_assoc( array $value ): bool {
		return array_keys( $value ) !== range( 0, count( $value ) - 1 );
	}

	/** @param mixed $value Values to normalize. @return string[] */
	private static function string_list_lower( mixed $value ): array {
		if ( ! is_array( $value ) ) {
			return array();
		}

		$items = array();
		foreach ( $value as $item ) {
			$item = strtolower( trim( (string) $item ) );
			if ( '' !== $item && ! in_array( $item, $items, true ) ) {
				$items[] = $item;
			}
		}

		return $items;
	}
}

if ( ! function_exists( 'wp_codebox_browser_session_product_dto' ) ) {
	/** @param array<string,mixed> $session Browser session contract. @return array<string,mixed> */
	function wp_codebox_browser_session_product_dto( array $session ): array {
		return WP_Codebox_Browser_Task_Builder::product_browser_session_dto( $session );
	}
}

if ( ! function_exists( 'wp_codebox_browser_preview_boot_config' ) ) {
	/** @param array<string,mixed> $input Browser session or preview input. @return array<string,mixed> */
	function wp_codebox_browser_preview_boot_config( array $input ): array {
		return WP_Codebox_Browser_Task_Builder::preview_boot_config( $input );
	}
}

if ( ! function_exists( 'wp_codebox_browser_preview_lease_dto' ) ) {
	/** @param array<string,mixed> $input Browser session or preview input. @return array<string,mixed> */
	function wp_codebox_browser_preview_lease_dto( array $input ): array {
		return WP_Codebox_Browser_Task_Builder::preview_lease( $input );
	}
}

if ( ! function_exists( 'wp_codebox_browser_preview_lease_status' ) ) {
	/** @param array<string,mixed> $input Browser session or preview input. */
	function wp_codebox_browser_preview_lease_status( array $input ): string {
		return WP_Codebox_Browser_Task_Builder::preview_lease_status( $input );
	}
}

if ( ! function_exists( 'wp_codebox_browser_recipe_dto' ) ) {
	/** @param array<string,mixed> $recipe Browser workspace recipe. @return array<string,mixed> */
	function wp_codebox_browser_recipe_dto( array $recipe ): array {
		return WP_Codebox_Browser_Task_Builder::browser_recipe_dto( $recipe );
	}
}

if ( ! function_exists( 'wp_codebox_runtime_profile' ) ) {
	/** @param array<string,mixed> $profile Runtime profile input. @return array<string,mixed> */
	function wp_codebox_runtime_profile( array $profile ): array {
		return WP_Codebox_Browser_Task_Builder::runtime_profile( $profile );
	}
}

if ( ! function_exists( 'wp_codebox_browser_runtime_profile' ) ) {
	/** @param array<string,mixed> $profile Runtime profile input. @return array<string,mixed> */
	function wp_codebox_browser_runtime_profile( array $profile ): array {
		return WP_Codebox_Browser_Task_Builder::runtime_profile( $profile );
	}
}

if ( ! function_exists( 'wp_codebox_apply_runtime_profile' ) ) {
	/** @param array<string,mixed> $input Browser task input. @return array<string,mixed> */
	function wp_codebox_apply_runtime_profile( array $input ): array {
		return WP_Codebox_Browser_Task_Builder::apply_runtime_profile( $input );
	}
}

if ( ! function_exists( 'wp_codebox_browser_blueprint_ref' ) ) {
	/** @param array<string,mixed> $prepared Prepared runtime descriptor. @param array<string,mixed> $session Optional source session. @return array<string,mixed> */
	function wp_codebox_browser_blueprint_ref( array $prepared, array $session = array() ): array {
		return WP_Codebox_Browser_Task_Builder::browser_blueprint_ref( $prepared, $session );
	}
}

if ( ! function_exists( 'wp_codebox_browser_executable_blueprint_ref' ) ) {
	/** @param array<string,mixed> $input Prepared runtime, full session, or executable ref request. @return array<string,mixed> */
	function wp_codebox_browser_executable_blueprint_ref( array $input ): array {
		return WP_Codebox_Browser_Task_Builder::executable_blueprint_ref( $input );
	}
}

if ( ! function_exists( 'wp_codebox_hydrate_browser_blueprint_ref' ) ) {
	/** @param array<string,mixed> $input Blueprint ref input. @return array<string,mixed>|WP_Error */
	function wp_codebox_hydrate_browser_blueprint_ref( array $input ): array|WP_Error {
		return WP_Codebox_Browser_Task_Builder::hydrate_browser_blueprint_ref( $input );
	}
}