Add image input support to wp ai generate text

[Copilot]

Rather than a dedicated wp ai generate alt-text subcommand, image input is surfaced directly in wp ai generate text via a new --image option, keeping vision-based text generation (alt text, image description, etc.) as a natural extension of the existing command.

Changes

• --image=<image> option added to wp ai generate text, accepting:
  • WordPress attachment ID (numeric) — reads local file → data URI, falls back to attachment URL
  • Remote URL (http:///https://) — passed directly to with_file()
  • Data URI (data:…) — passed directly
  • Local file path — validates MIME type starts with image/, converts to data URI
• Three private helpers added to AI_Command: with_image_input(), with_attachment_input(), with_local_file_input()
• Mock provider updated in Behat fixtures to declare image and text+image input modalities
• Five new Behat scenarios: local PNG success, missing file, non-existent attachment ID, non-image file type, non-attachment post ID

Example

# Describe a local image
wp ai generate text "Describe this image" --image=photo.jpg

# Generate alt text for a media library attachment
wp ai generate text "Generate alt text for this image" --image=42

# Pass a remote image URL
wp ai generate text "What is in this image?" --image=https://example.com/photo.jpg

[codecov]

Codecov Report

❌ Patch coverage is 57.14286% with 18 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/AI_Command.php	57.14%	18 Missing ⚠️

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

This PR extends the existing wp ai generate text command to support vision-style prompts by allowing an image to be supplied via a new --image option, rather than introducing a separate subcommand.

Changes:

• Adds --image=<image> to wp ai generate text, wiring image input into the prompt builder.
• Introduces private helpers in AI_Command to accept attachments, URLs/data URIs, and local files.
• Updates the Behat mock provider metadata and adds Behat scenarios covering image-input success and failure cases.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
src/AI_Command.php	Adds --image option handling and helper methods to attach image input to text-generation prompts.
features/generate.feature	Updates mock provider supported input modalities and adds scenarios validating --image behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.