From 85328d40033c04a7133cc683db5feb92df750818 Mon Sep 17 00:00:00 2001
From: Richard Ortiz <rcrd.ortiz@gmail.com>
Date: Mon, 4 May 2026 13:07:02 +0200
Subject: [PATCH 1/2] Add Jetpack Posts to Podcast admin page and proxy
 endpoint (Phase A)

Wires up the Jetpack-side surface for the Posts to Podcast feature:

- New "Posts to Podcast" submenu under the Jetpack admin menu, gated by Jetpack_Posts_To_Podcast_Helper::is_enabled() (delegates to Jetpack_AI_Helper for now; real Jetpack AI entitlement + credit checks land in Phase C).
- Vanilla form with three controls (window / length / voice preset) and a Generate button. Inline JS uses wp.apiFetch to POST to the local proxy, polls the job (3s for the first 30s, then 10s) until terminal state, and writes the resulting markdown script as a draft post via /wp/v2/posts. No build step needed for Phase A; Phase B can move this to a built React app under _inc/client/.
- Local wpcom/v2 proxy endpoint at posts-to-podcast (and /jobs/{id}) that forwards via Connection\Client to the wpcom-side endpoint at public-api.wordpress.com, preserving the upstream HTTP status so async-job 202/4xx/5xx mappings flow through unchanged.

The local proxy + admin page are registered in class.jetpack-admin.php alongside Jetpack_AI_Page. Three voice presets and three length presets are defined in the helper as a single source of truth shared by the form and the proxy validator.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../class-jetpack-posts-to-podcast-page.php   | 332 ++++++++++++++++++
 .../class-jetpack-posts-to-podcast-helper.php | 144 ++++++++
 ...-rest-api-v2-endpoint-posts-to-podcast.php | 208 +++++++++++
 .../plugins/jetpack/class.jetpack-admin.php   |   4 +
 4 files changed, 688 insertions(+)
 create mode 100644 projects/plugins/jetpack/_inc/lib/admin-pages/class-jetpack-posts-to-podcast-page.php
 create mode 100644 projects/plugins/jetpack/_inc/lib/class-jetpack-posts-to-podcast-helper.php
 create mode 100644 projects/plugins/jetpack/_inc/lib/core-api/wpcom-endpoints/class-wpcom-rest-api-v2-endpoint-posts-to-podcast.php

diff --git a/projects/plugins/jetpack/_inc/lib/admin-pages/class-jetpack-posts-to-podcast-page.php b/projects/plugins/jetpack/_inc/lib/admin-pages/class-jetpack-posts-to-podcast-page.php
new file mode 100644
index 000000000000..f7208f728af1
--- /dev/null
+++ b/projects/plugins/jetpack/_inc/lib/admin-pages/class-jetpack-posts-to-podcast-page.php
@@ -0,0 +1,332 @@
+<?php
+/**
+ * Jetpack Posts to Podcast admin page.
+ *
+ * Registers the "Posts to Podcast" submenu under Jetpack and renders a
+ * three-control form that POSTs to the local proxy endpoint, polls until the
+ * upstream wpcom job completes, and writes the resulting markdown script as a
+ * draft post via wp.apiFetch.
+ *
+ * Phase A: vanilla HTML form + inline script using wp.apiFetch — no build step.
+ * Phase B can move this to a built React app under _inc/client/ if/when the
+ * UX needs more than three controls.
+ *
+ * @package automattic/jetpack
+ */
+
+use Automattic\Jetpack\Admin_UI\Admin_Menu;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit( 0 );
+}
+
+if ( ! class_exists( 'Jetpack_Posts_To_Podcast_Helper' ) ) {
+	require_once JETPACK__PLUGIN_DIR . '_inc/lib/class-jetpack-posts-to-podcast-helper.php';
+}
+
+require_once __DIR__ . '/class.jetpack-admin-page.php';
+
+/**
+ * Class Jetpack_Posts_To_Podcast_Page
+ */
+class Jetpack_Posts_To_Podcast_Page extends Jetpack_Admin_Page {
+
+	/**
+	 * Hide the submenu when Jetpack is not connected.
+	 *
+	 * @var bool
+	 */
+	protected $dont_show_if_not_active = true;
+
+	/**
+	 * Register the submenu under the Jetpack top-level menu.
+	 *
+	 * @return string|false Hook returned by Admin_Menu::add_menu().
+	 */
+	public function get_page_hook() {
+		if ( ! Jetpack_Posts_To_Podcast_Helper::is_enabled() ) {
+			return false;
+		}
+
+		return Admin_Menu::add_menu(
+			__( 'Posts to Podcast', 'jetpack' ),
+			__( 'Posts to Podcast', 'jetpack' ),
+			'edit_posts',
+			'jetpack-posts-to-podcast',
+			array( $this, 'render' ),
+			6
+		);
+	}
+
+	/**
+	 * Attach page-specific actions.
+	 *
+	 * @param string $hook The page hook returned by get_page_hook().
+	 */
+	public function add_page_actions( $hook ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
+		// Nothing extra needed beyond the common hooks in Jetpack_Admin_Page::add_actions().
+	}
+
+	/**
+	 * Enqueue scripts for the admin page. Phase A relies on wp.apiFetch which is
+	 * registered globally; we add a small inline initialiser bound to the page's
+	 * #jetpack-posts-to-podcast-app container.
+	 */
+	public function page_admin_scripts() {
+		wp_enqueue_script( 'wp-api-fetch' );
+		wp_enqueue_script( 'wp-i18n' );
+
+		$bootstrap = array(
+			'apiPath'        => '/wpcom/v2/posts-to-podcast',
+			'jobsPath'       => '/wpcom/v2/posts-to-podcast/jobs/',
+			'voicePresets'   => Jetpack_Posts_To_Podcast_Helper::get_voice_presets(),
+			'lengthPresets'  => Jetpack_Posts_To_Podcast_Helper::get_length_presets(),
+			'windowPresets'  => Jetpack_Posts_To_Podcast_Helper::get_window_presets(),
+			'pollFastMs'     => 3000,
+			'pollSlowMs'     => 10000,
+			'pollSwitchMs'   => 30000,
+			'pollTimeoutMs'  => 5 * 60 * 1000,
+			'newPostBaseUrl' => admin_url( 'post-new.php' ),
+			'editPostUrl'    => admin_url( 'post.php' ),
+			'i18n'           => array(
+				'generate'             => __( 'Generate', 'jetpack' ),
+				'generating'           => __( 'Generating…', 'jetpack' ),
+				'queueFailed'          => __( 'Failed to queue the generation. Please try again.', 'jetpack' ),
+				'pollFailed'           => __( 'Failed to read job status. Please try again.', 'jetpack' ),
+				/* translators: %s: error message returned by the generation pipeline. */
+				'jobFailed'            => __( 'Generation failed: %s', 'jetpack' ),
+				'noContentNoPosts'     => __( 'No posts published in this window — try a longer one.', 'jetpack' ),
+				'noContentNoThreshold' => __( 'Posts in this window did not pass the relevance threshold. Try a longer window.', 'jetpack' ),
+				'draftCreated'         => __( 'Draft created. Opening the editor…', 'jetpack' ),
+				'draftCreateFailed'    => __( 'Generation completed but the draft post could not be created.', 'jetpack' ),
+				'pendingStatus'        => __( 'Pending — your job is queued.', 'jetpack' ),
+				'runningStatus'        => __( 'Running — generating your script. This usually takes 30–90 seconds.', 'jetpack' ),
+			),
+		);
+
+		wp_add_inline_script(
+			'wp-api-fetch',
+			'window.jetpackPostsToPodcast = ' . wp_json_encode( $bootstrap, JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP ) . ';',
+			'after'
+		);
+
+		wp_add_inline_script( 'wp-api-fetch', $this->get_inline_app_script(), 'after' );
+	}
+
+	/**
+	 * Render the form into the page body. wrap_ui() in the parent class supplies
+	 * the Jetpack masthead/footer; we only render the page-specific markup here.
+	 */
+	public function page_render() {
+		$presets = Jetpack_Posts_To_Podcast_Helper::get_window_presets();
+		$lengths = Jetpack_Posts_To_Podcast_Helper::get_length_presets();
+		$voices  = Jetpack_Posts_To_Podcast_Helper::get_voice_presets();
+		?>
+		<div id="jetpack-posts-to-podcast-app" class="jp-p2p-app" style="max-width:680px;padding:24px;">
+			<h1><?php esc_html_e( 'Posts to Podcast', 'jetpack' ); ?></h1>
+			<p>
+				<?php esc_html_e( 'Generate a podcast-style episode script from your site\'s recent activity. Pick a window, a length, and a voice preset; the result is saved as a draft post you can edit, record, and publish through the existing Podcast block.', 'jetpack' ); ?>
+			</p>
+			<form id="jp-p2p-form" onsubmit="return false;">
+				<p>
+					<label for="jp-p2p-window"><strong><?php esc_html_e( 'Window', 'jetpack' ); ?></strong></label><br />
+					<select id="jp-p2p-window" name="window">
+						<?php foreach ( $presets as $preset ) : ?>
+							<option value="<?php echo esc_attr( $preset['id'] ); ?>"><?php echo esc_html( $preset['label'] ); ?></option>
+						<?php endforeach; ?>
+					</select>
+				</p>
+				<p>
+					<label for="jp-p2p-length"><strong><?php esc_html_e( 'Length', 'jetpack' ); ?></strong></label><br />
+					<select id="jp-p2p-length" name="length">
+						<?php foreach ( $lengths as $length ) : ?>
+							<option value="<?php echo esc_attr( $length['id'] ); ?>" <?php selected( 'medium', $length['id'] ); ?>><?php echo esc_html( $length['label'] ); ?></option>
+						<?php endforeach; ?>
+					</select>
+				</p>
+				<p>
+					<label for="jp-p2p-voice"><strong><?php esc_html_e( 'Voice preset', 'jetpack' ); ?></strong></label><br />
+					<select id="jp-p2p-voice" name="voicePreset">
+						<?php foreach ( $voices as $voice ) : ?>
+							<option value="<?php echo esc_attr( $voice['id'] ); ?>"><?php echo esc_html( $voice['label'] ); ?></option>
+						<?php endforeach; ?>
+					</select>
+				</p>
+				<p>
+					<button id="jp-p2p-generate" type="submit" class="button button-primary"><?php esc_html_e( 'Generate', 'jetpack' ); ?></button>
+				</p>
+			</form>
+			<div id="jp-p2p-status" role="status" aria-live="polite" style="margin-top:16px;"></div>
+		</div>
+		<?php
+	}
+
+	/**
+	 * Inline JS that drives the form: builds the request body, POSTs to the local
+	 * proxy, polls until terminal state, and writes a draft post on success.
+	 *
+	 * Kept as a heredoc so Phase A doesn't need a build pipeline. Phase B can
+	 * move this into a real React app and an asset manifest.
+	 *
+	 * @return string
+	 */
+	private function get_inline_app_script() {
+		// phpcs:disable Squiz.Strings.DoubleQuoteUsage.NotRequired -- heredoc is intentional.
+		return <<<'JS'
+( function () {
+	if ( ! window.wp || ! window.wp.apiFetch ) {
+		return;
+	}
+	if ( ! window.jetpackPostsToPodcast ) {
+		return;
+	}
+
+	var settings = window.jetpackPostsToPodcast;
+	var apiFetch = window.wp.apiFetch;
+
+	function $( id ) { return document.getElementById( id ); }
+
+	function buildWindow() {
+		var presetId = $( 'jp-p2p-window' ).value;
+		var preset = ( settings.windowPresets || [] ).find( function ( p ) { return p.id === presetId; } );
+		if ( ! preset ) {
+			return null;
+		}
+		return { unit: preset.unit, n: preset.n };
+	}
+
+	function setStatus( html ) {
+		$( 'jp-p2p-status' ).innerHTML = html;
+	}
+
+	function setBusy( busy ) {
+		var btn = $( 'jp-p2p-generate' );
+		btn.disabled = !! busy;
+		btn.textContent = busy ? settings.i18n.generating : settings.i18n.generate;
+		[ 'jp-p2p-window', 'jp-p2p-length', 'jp-p2p-voice' ].forEach( function ( id ) {
+			$( id ).disabled = !! busy;
+		} );
+	}
+
+	function pollJob( jobId, startedAt ) {
+		var elapsed = Date.now() - startedAt;
+		if ( elapsed > settings.pollTimeoutMs ) {
+			setStatus( '<p>' + settings.i18n.pollFailed + '</p>' );
+			setBusy( false );
+			return;
+		}
+		var nextDelay = elapsed < settings.pollSwitchMs ? settings.pollFastMs : settings.pollSlowMs;
+		apiFetch( { path: settings.jobsPath + encodeURIComponent( jobId ) } )
+			.then( function ( record ) {
+				if ( record.status === 'pending' ) {
+					setStatus( '<p>' + settings.i18n.pendingStatus + '</p>' );
+					setTimeout( function () { pollJob( jobId, startedAt ); }, nextDelay );
+					return;
+				}
+				if ( record.status === 'running' ) {
+					setStatus( '<p>' + settings.i18n.runningStatus + '</p>' );
+					setTimeout( function () { pollJob( jobId, startedAt ); }, nextDelay );
+					return;
+				}
+				if ( record.status === 'failed' ) {
+					var msg = record.errorMessage || record.errorCode || 'unknown';
+					setStatus( '<p>' + settings.i18n.jobFailed.replace( '%s', msg ) + '</p>' );
+					setBusy( false );
+					return;
+				}
+				if ( record.status === 'complete' ) {
+					if ( ! record.script ) {
+						var reason = record.metadata && record.metadata.noContentReason;
+						var message = reason === 'no-items-above-threshold'
+							? settings.i18n.noContentNoThreshold
+							: settings.i18n.noContentNoPosts;
+						setStatus( '<p>' + message + '</p>' );
+						setBusy( false );
+						return;
+					}
+					createDraft( record );
+					return;
+				}
+				setStatus( '<p>' + settings.i18n.pollFailed + '</p>' );
+				setBusy( false );
+			} )
+			.catch( function () {
+				setStatus( '<p>' + settings.i18n.pollFailed + '</p>' );
+				setBusy( false );
+			} );
+	}
+
+	function buildPostMeta( record ) {
+		var m = record.metadata || {};
+		return {
+			'_p2p_format':          m.format || 'two-voice-dialogue',
+			'_p2p_voices':          m.voices || [],
+			'_p2p_themes':          m.themes || [],
+			'_p2p_source_post_ids': m.sourcePostIds || [],
+			'_p2p_window':          m.window || record.window || {},
+			'_p2p_generated_at':    m.generatedAt || record.completedAt || '',
+			'_p2p_warnings':        ( m.warnings && m.warnings.length ) ? m.warnings : undefined,
+		};
+	}
+
+	function createDraft( record ) {
+		var m = record.metadata || {};
+		var body = {
+			status:  'draft',
+			title:   m.title || 'Posts to Podcast — episode',
+			content: record.script,
+			meta:    buildPostMeta( record ),
+		};
+		apiFetch( { path: '/wp/v2/posts', method: 'POST', data: body } )
+			.then( function ( draft ) {
+				setStatus( '<p>' + settings.i18n.draftCreated + '</p>' );
+				var url = settings.editPostUrl + '?action=edit&post=' + encodeURIComponent( draft.id );
+				window.location.href = url;
+			} )
+			.catch( function () {
+				setStatus( '<p>' + settings.i18n.draftCreateFailed + '</p>' );
+				setBusy( false );
+			} );
+	}
+
+	function onGenerate() {
+		setBusy( true );
+		setStatus( '' );
+		var win = buildWindow();
+		if ( ! win ) {
+			setStatus( '<p>' + settings.i18n.queueFailed + '</p>' );
+			setBusy( false );
+			return;
+		}
+		var body = {
+			window:      win,
+			length:      $( 'jp-p2p-length' ).value,
+			voicePreset: $( 'jp-p2p-voice' ).value,
+		};
+		apiFetch( { path: settings.apiPath, method: 'POST', data: body } )
+			.then( function ( resp ) {
+				if ( ! resp || ! resp.jobId ) {
+					setStatus( '<p>' + settings.i18n.queueFailed + '</p>' );
+					setBusy( false );
+					return;
+				}
+				setStatus( '<p>' + settings.i18n.pendingStatus + '</p>' );
+				pollJob( resp.jobId, Date.now() );
+			} )
+			.catch( function () {
+				setStatus( '<p>' + settings.i18n.queueFailed + '</p>' );
+				setBusy( false );
+			} );
+	}
+
+	document.addEventListener( 'DOMContentLoaded', function () {
+		var btn = document.getElementById( 'jp-p2p-generate' );
+		if ( btn ) {
+			btn.addEventListener( 'click', onGenerate );
+		}
+	} );
+} )();
+JS;
+		// phpcs:enable
+	}
+}
diff --git a/projects/plugins/jetpack/_inc/lib/class-jetpack-posts-to-podcast-helper.php b/projects/plugins/jetpack/_inc/lib/class-jetpack-posts-to-podcast-helper.php
new file mode 100644
index 000000000000..37bb68e73d28
--- /dev/null
+++ b/projects/plugins/jetpack/_inc/lib/class-jetpack-posts-to-podcast-helper.php
@@ -0,0 +1,144 @@
+<?php
+/**
+ * Helper for the Jetpack Posts to Podcast feature.
+ *
+ * Phase A: gating delegates to Jetpack_AI_Helper::is_enabled() so the surface
+ * is only available where Jetpack AI is already wired up. Real Jetpack AI
+ * entitlement + credit checks live in Phase C.
+ *
+ * @package automattic/jetpack
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit( 0 );
+}
+
+if ( ! class_exists( 'Jetpack_AI_Helper' ) ) {
+	require_once __DIR__ . '/class-jetpack-ai-helper.php';
+}
+
+/**
+ * Class Jetpack_Posts_To_Podcast_Helper
+ */
+class Jetpack_Posts_To_Podcast_Helper {
+
+	/**
+	 * Whether the feature should be active for the current site.
+	 *
+	 * Phase A: same surface as Jetpack AI (WPCOM Simple + Atomic / WoA). When
+	 * real entitlement lands in Phase C this delegates to a credit-aware check
+	 * that also respects the per-site feature flag.
+	 *
+	 * @return bool
+	 */
+	public static function is_enabled() {
+		if ( ! Jetpack_AI_Helper::is_enabled() ) {
+			return false;
+		}
+
+		/**
+		 * Filter to allow disabling the Jetpack Posts to Podcast feature on a per-site basis.
+		 * Defaults to the same gating as Jetpack AI; flip this to false to hide the admin page
+		 * during a staged rollout without disabling Jetpack AI itself.
+		 *
+		 * @since n.e.x.t
+		 *
+		 * @param bool $enabled Whether the feature is enabled. Default true.
+		 */
+		return (bool) apply_filters( 'jetpack_posts_to_podcast_is_enabled', true );
+	}
+
+	/**
+	 * Permission callback for the local proxy REST endpoint. Mirrors the AI helper's
+	 * permission check so the same per-user capability gate applies.
+	 *
+	 * @param WP_REST_Request $request Full details about the request.
+	 *
+	 * @return true|WP_Error
+	 */
+	public static function get_status_permission_check( $request ) {
+		return Jetpack_AI_Helper::get_status_permission_check( $request );
+	}
+
+	/**
+	 * Resolve the configured voice presets that the wpcom endpoint will accept.
+	 * Kept here as a single source of truth so the admin UI and the proxy
+	 * validator agree on the available list.
+	 *
+	 * @return array<int, array{ id: string, label: string }>
+	 */
+	public static function get_voice_presets() {
+		return array(
+			array(
+				'id'    => 'witty',
+				'label' => __( 'Witty', 'jetpack' ),
+			),
+			array(
+				'id'    => 'earnest',
+				'label' => __( 'Earnest', 'jetpack' ),
+			),
+			array(
+				'id'    => 'professional',
+				'label' => __( 'Professional', 'jetpack' ),
+			),
+		);
+	}
+
+	/**
+	 * Length presets surfaced to the admin UI.
+	 *
+	 * @return array<int, array{ id: string, label: string }>
+	 */
+	public static function get_length_presets() {
+		return array(
+			array(
+				'id'    => 'short',
+				'label' => __( 'Short (~3 min)', 'jetpack' ),
+			),
+			array(
+				'id'    => 'medium',
+				'label' => __( 'Medium (~7 min)', 'jetpack' ),
+			),
+			array(
+				'id'    => 'long',
+				'label' => __( 'Long (~12 min)', 'jetpack' ),
+			),
+		);
+	}
+
+	/**
+	 * Window quick-picks surfaced to the admin UI. The relative-form `unit/n` shape
+	 * matches the wpcom endpoint contract; the absolute `from/to` form is also accepted
+	 * by the endpoint but is built from the date inputs in the UI.
+	 *
+	 * @return array<int, array{ id: string, label: string, unit: string, n: int }>
+	 */
+	public static function get_window_presets() {
+		return array(
+			array(
+				'id'    => 'last-7-days',
+				'label' => __( 'Last 7 days', 'jetpack' ),
+				'unit'  => 'days',
+				'n'     => 7,
+			),
+			array(
+				'id'    => 'last-14-days',
+				'label' => __( 'Last 14 days', 'jetpack' ),
+				'unit'  => 'days',
+				'n'     => 14,
+			),
+			array(
+				'id'    => 'last-30-days',
+				'label' => __( 'Last 30 days', 'jetpack' ),
+				'unit'  => 'days',
+				'n'     => 30,
+			),
+			array(
+				'id'    => 'last-3-months',
+				'label' => __( 'Last 3 months', 'jetpack' ),
+				'unit'  => 'months',
+				'n'     => 3,
+			),
+		);
+	}
+}
diff --git a/projects/plugins/jetpack/_inc/lib/core-api/wpcom-endpoints/class-wpcom-rest-api-v2-endpoint-posts-to-podcast.php b/projects/plugins/jetpack/_inc/lib/core-api/wpcom-endpoints/class-wpcom-rest-api-v2-endpoint-posts-to-podcast.php
new file mode 100644
index 000000000000..f696878389ad
--- /dev/null
+++ b/projects/plugins/jetpack/_inc/lib/core-api/wpcom-endpoints/class-wpcom-rest-api-v2-endpoint-posts-to-podcast.php
@@ -0,0 +1,208 @@
+<?php
+/**
+ * Local Jetpack-side REST endpoint for the Posts to Podcast feature.
+ *
+ * The Jetpack admin form calls this local endpoint via wp.apiFetch; the endpoint
+ * forwards the request to the wpcom-side endpoint at public-api.wordpress.com using
+ * the site's Jetpack-blog-token via Connection\Client. This indirection keeps Simple,
+ * Atomic, and Jetpack-connected self-hosted sites on the same client-side path.
+ *
+ * @package automattic/jetpack
+ */
+
+use Automattic\Jetpack\Connection\Client;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit( 0 );
+}
+
+if ( ! class_exists( 'Jetpack_Posts_To_Podcast_Helper' ) ) {
+	require_once JETPACK__PLUGIN_DIR . '_inc/lib/class-jetpack-posts-to-podcast-helper.php';
+}
+
+/**
+ * Class WPCOM_REST_API_V2_Endpoint_Posts_To_Podcast
+ */
+class WPCOM_REST_API_V2_Endpoint_Posts_To_Podcast extends WP_REST_Controller {
+
+	/**
+	 * Namespace prefix.
+	 *
+	 * @var string
+	 */
+	public $namespace = 'wpcom/v2';
+
+	/**
+	 * Endpoint base route.
+	 *
+	 * @var string
+	 */
+	public $rest_base = 'posts-to-podcast';
+
+	/**
+	 * Constructor.
+	 */
+	public function __construct() {
+		$this->is_wpcom                     = true;
+		$this->wpcom_is_wpcom_only_endpoint = false;
+
+		if ( ! Jetpack_Posts_To_Podcast_Helper::is_enabled() ) {
+			return;
+		}
+
+		add_action( 'rest_api_init', array( $this, 'register_routes' ) );
+	}
+
+	/**
+	 * Register routes.
+	 */
+	public function register_routes() {
+		register_rest_route(
+			$this->namespace,
+			$this->rest_base,
+			array(
+				array(
+					'methods'             => WP_REST_Server::CREATABLE,
+					'callback'            => array( $this, 'enqueue_generation' ),
+					'permission_callback' => array( 'Jetpack_Posts_To_Podcast_Helper', 'get_status_permission_check' ),
+					'args'                => $this->get_enqueue_args(),
+				),
+			)
+		);
+
+		register_rest_route(
+			$this->namespace,
+			$this->rest_base . '/jobs/(?P<job_id>[a-f0-9\-]+)',
+			array(
+				array(
+					'methods'             => WP_REST_Server::READABLE,
+					'callback'            => array( $this, 'read_job_status' ),
+					'permission_callback' => array( 'Jetpack_Posts_To_Podcast_Helper', 'get_status_permission_check' ),
+					'args'                => array(
+						'job_id' => array(
+							'type'     => 'string',
+							'required' => true,
+						),
+					),
+				),
+			)
+		);
+	}
+
+	/**
+	 * Argument schema for the POST route.
+	 *
+	 * @return array<string, array<string, mixed>>
+	 */
+	private function get_enqueue_args() {
+		return array(
+			'window'      => array(
+				'type'        => 'object',
+				'required'    => true,
+				'description' => __( 'Either { unit: days|weeks|months, n: <positive int> } or { from, to } as ISO-8601 dates.', 'jetpack' ),
+			),
+			'length'      => array(
+				'type'        => 'string',
+				'required'    => true,
+				'enum'        => wp_list_pluck( Jetpack_Posts_To_Podcast_Helper::get_length_presets(), 'id' ),
+				'description' => __( 'Length preset id.', 'jetpack' ),
+			),
+			'voicePreset' => array(
+				'type'        => 'string',
+				'required'    => true,
+				'enum'        => wp_list_pluck( Jetpack_Posts_To_Podcast_Helper::get_voice_presets(), 'id' ),
+				'description' => __( 'Voice preset id.', 'jetpack' ),
+			),
+		);
+	}
+
+	/**
+	 * Forward POST to the wpcom-side endpoint and return the queued job descriptor.
+	 *
+	 * @param WP_REST_Request $request Full details about the request.
+	 *
+	 * @return WP_REST_Response|WP_Error
+	 */
+	public function enqueue_generation( WP_REST_Request $request ) {
+		$blog_id = (int) Jetpack_Options::get_option( 'id' );
+		if ( ! $blog_id ) {
+			return new WP_Error( 'site-not-connected', __( 'Site is not connected to WordPress.com.', 'jetpack' ), array( 'status' => 400 ) );
+		}
+
+		$body = array(
+			'window'      => $request->get_param( 'window' ),
+			'length'      => $request->get_param( 'length' ),
+			'voicePreset' => $request->get_param( 'voicePreset' ),
+		);
+
+		$response = Client::wpcom_json_api_request_as_blog(
+			sprintf( '/sites/%d/posts-to-podcast', $blog_id ),
+			2,
+			array(
+				'method'  => 'POST',
+				'headers' => array( 'content-type' => 'application/json' ),
+				'timeout' => 30,
+			),
+			wp_json_encode( $body, JSON_UNESCAPED_SLASHES ),
+			'wpcom'
+		);
+
+		return $this->relay_response( $response );
+	}
+
+	/**
+	 * Forward GET to the wpcom-side polling endpoint and return the job record.
+	 *
+	 * @param WP_REST_Request $request Full details about the request.
+	 *
+	 * @return WP_REST_Response|WP_Error
+	 */
+	public function read_job_status( WP_REST_Request $request ) {
+		$blog_id = (int) Jetpack_Options::get_option( 'id' );
+		if ( ! $blog_id ) {
+			return new WP_Error( 'site-not-connected', __( 'Site is not connected to WordPress.com.', 'jetpack' ), array( 'status' => 400 ) );
+		}
+
+		$job_id = (string) $request['job_id'];
+
+		$response = Client::wpcom_json_api_request_as_blog(
+			sprintf( '/sites/%d/posts-to-podcast/jobs/%s', $blog_id, rawurlencode( $job_id ) ),
+			2,
+			array(
+				'method'  => 'GET',
+				'headers' => array( 'content-type' => 'application/json' ),
+				'timeout' => 15,
+			),
+			null,
+			'wpcom'
+		);
+
+		return $this->relay_response( $response );
+	}
+
+	/**
+	 * Relay an upstream Connection\Client response back to the local REST client.
+	 * Preserves the upstream HTTP status code so 202/4xx/5xx mappings flow through.
+	 *
+	 * @param array|WP_Error $response The raw response from Client::wpcom_json_api_request_as_blog.
+	 *
+	 * @return WP_REST_Response|WP_Error
+	 */
+	private function relay_response( $response ) {
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		$code    = (int) wp_remote_retrieve_response_code( $response );
+		$body    = wp_remote_retrieve_body( $response );
+		$decoded = json_decode( $body, true );
+
+		$rest_response = rest_ensure_response( null === $decoded ? $body : $decoded );
+		if ( $code >= 100 && $code < 600 ) {
+			$rest_response->set_status( $code );
+		}
+		return $rest_response;
+	}
+}
+
+wpcom_rest_api_v2_load_plugin( 'WPCOM_REST_API_V2_Endpoint_Posts_To_Podcast' );
diff --git a/projects/plugins/jetpack/class.jetpack-admin.php b/projects/plugins/jetpack/class.jetpack-admin.php
index 3c2f8bb3224d..c93193d0051f 100644
--- a/projects/plugins/jetpack/class.jetpack-admin.php
+++ b/projects/plugins/jetpack/class.jetpack-admin.php
@@ -66,6 +66,9 @@ private function __construct() {
 		require_once JETPACK__PLUGIN_DIR . '_inc/lib/admin-pages/class-jetpack-ai-page.php';
 		$jetpack_ai = new Jetpack_AI_Page();
 
+		require_once JETPACK__PLUGIN_DIR . '_inc/lib/admin-pages/class-jetpack-posts-to-podcast-page.php';
+		$jetpack_posts_to_podcast = new Jetpack_Posts_To_Podcast_Page();
+
 		add_action( 'admin_init', array( $jetpack_react, 'react_redirects' ), 0 );
 		add_action( 'admin_menu', array( $jetpack_react, 'add_actions' ), 998 );
 		add_action( 'admin_menu', array( $jetpack_react, 'remove_jetpack_menu' ), 2000 );
@@ -74,6 +77,7 @@ private function __construct() {
 		add_action( 'jetpack_admin_menu', array( $fallback_page, 'add_actions' ) );
 		add_action( 'jetpack_admin_menu', array( $jetpack_about, 'add_actions' ) );
 		add_action( 'jetpack_admin_menu', array( $jetpack_ai, 'add_actions' ) );
+		add_action( 'jetpack_admin_menu', array( $jetpack_posts_to_podcast, 'add_actions' ) );
 
 		// Add redirect to current page for activation/deactivation of modules.
 		add_action( 'jetpack_pre_activate_module', array( $this, 'fix_redirect' ), 10, 2 );

From 6f5fdedb835984dcbf7d6c3be1a8cf6af706c5f4 Mon Sep 17 00:00:00 2001
From: Richard Ortiz <rcrd.ortiz@gmail.com>
Date: Tue, 5 May 2026 11:45:30 +0200
Subject: [PATCH 2/2] changelog

---
 projects/plugins/jetpack/changelog/add-posts-to-podcast | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 projects/plugins/jetpack/changelog/add-posts-to-podcast

diff --git a/projects/plugins/jetpack/changelog/add-posts-to-podcast b/projects/plugins/jetpack/changelog/add-posts-to-podcast
new file mode 100644
index 000000000000..40e4a9a56648
--- /dev/null
+++ b/projects/plugins/jetpack/changelog/add-posts-to-podcast
@@ -0,0 +1,4 @@
+Significance: minor
+Type: other
+
+Added a post to podcast base feature