Add video URL parameter support with optional instructions and dedicated workflow

[Copilot]

This PR implements support for receiving video URLs as parameters through workflow_dispatch arguments, addressing the requirement to process videos directly without needing them to be uploaded as issue assets.

Changes Made

🎯 Core Functionality

• Added videoUrl parameter to action.yml allowing direct video URL processing as an alternative to extracting URLs from issue bodies
• Enhanced GenAI script to support both issue-based asset extraction and direct video URL processing with camelCase parameter naming
• Made instructions optional - the script now uses sensible defaults when no custom instructions are provided
• Maintained backward compatibility - existing issue-based workflows continue to work unchanged

🚀 Workflow Enhancements

• Added dedicated video-url-analyzer.yml workflow specifically for video URL analysis with required video_url input
• Enhanced CI workflow with optional video URL support for testing
• Flexible trigger support - workflows can now use issue events, manual dispatch, or both

📊 Output Improvements

• Automatic Step Summary output - genaiscript automatically sends analysis results to $GITHUB_STEP_SUMMARY for easy viewing in the GitHub Actions interface
• Preserved existing outputs - the text output is still available for programmatic access

📚 Documentation Updates

• Comprehensive examples showing multiple workflow configurations
• Updated parameter documentation with the new videoUrl input and optional instructions
• Added note about Step Summary output for better user experience

Usage Examples

Dedicated Video URL Analysis

Users can now use the dedicated workflow for video analysis:

# .github/workflows/video-url-analyzer.yml
name: Video URL Analyzer
on:
  workflow_dispatch:
    inputs:
      video_url:
        description: 'Direct video URL to analyze'
        required: true
        type: string

Flexible Action Usage

- uses: pelikhan/action-genai-video-issue-analyzer@v0
  with:
    github_token: ${{ secrets.GITHUB_TOKEN }}
    video_url: ${{ github.event.inputs.video_url }}
    # instructions are now optional with sensible defaults

The analysis results will appear in both the step summary and as a workflow output, making it easy to review the AI-generated video analysis directly in the GitHub interface.

Testing

• ✅ TypeScript compilation passes
• ✅ Backward compatibility maintained for existing issue-based workflows
• ✅ New videoUrl parameter properly integrated with camelCase naming
• ✅ Instructions parameter made optional with fallback defaults
• ✅ Dedicated workflow configuration validated

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[pelikhan]

optional, ignore missing instructions

[Copilot]

Made instructions optional by removing the error check and using a default value when instructions are not provided. Commit e5b3be5

[pelikhan]

add a new workflow file that only dedicated to running the action using a video url (so required will be true)

[Copilot]

Created a new dedicated workflow file video-url-analyzer.yml that only handles video URL analysis with video_url as a required parameter. Commit e5b3be5

[pelikhan]

use camelize (videoUrl) in this file and it will automatically be converted to snaked naming by genaiscript.

[Copilot]

Changed video_url to videoUrl (camelCase) in the genai script parameters. GenAI will automatically convert this to snake_case naming. Commit e5b3be5

[pelikhan]

@copilot apply reviews

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• cdn.sheetjs.com
  • Triggering command: npm ci (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)