Add PSOpenAI module support for image, video, audio

Introduces PSOpenAI as a supported AI tool, enabling image editing/generation, video, and audio capabilities via the OpenAI API. Updates tool definitions, installation, uninstallation, initialization, and invocation logic to handle PowerShell module wrappers distinctly from CLI tools. Adds documentation and user guidance for PSOpenAI API key configuration and usage.

Author: potatoqualitee

README.md

@@ -56,16 +56,16 @@ The problem with AI coding assistants isn't their capability, it's their interfa
 
 ## How it differs from API wrappers
 
-You might wonder why this exists when [PSOpenAI](https://github.com/mkht/PSOpenAI) is available. The answer: they solve different problems.
+Most of aitools wraps *agentic CLI tools* (AI assistants that read, understand, and rewrite code), but it also supports [PSOpenAI](https://github.com/mkht/PSOpenAI), a PowerShell wrapper for specialized capabilities like image/video/audio generation and editing.
 
 | API Wrappers (like PSOpenAI)             | Agentic CLI Tools (like Claude Code)        |
 | ---------------------------------------- | -------------------------------------------- |
-| Send prompts, receive text               | Open files, understand code, make edits      |
+| Send prompts, receive text/media         | Open files, understand code, make edits      |
 | You handle file I/O and context          | Built-in file management and context         |
 | Great for generating new content         | Great for refactoring existing code          |
-| Requires scaffolding for code work       | Ships with full coding toolchain             |
+| Excels at image/video/audio generation   | Specialized for code editing workflows       |
 
-PSOpenAI is excellent for what it does. aitools is for when you need an AI to *edit code*, not just *generate text*.
+aitools includes PSOpenAI support specifically for image editing and generation capabilities that CLI tools don't yet provide.
 
 ---
 
@@ -152,8 +152,9 @@ Run the same task through all installed AI tools and compare results.
 | **Codex CLI** | Fast processing | Subscription | ✅ Supported |
 | **Cursor AI** | IDE integration | Free + paid | ✅ Supported |
 | **Ollama** | Offline use, completely free | Free | ✅ Supported |
+| **PSOpenAI** | Image/video/audio generation and editing | Pay-per-use | ✅ Supported |
 
-Each tool has different strengths. Claude Code is the strongest coder but can struggle with files over 400 lines. Gemini has massive context windows. Ollama runs locally with no API costs. Use what fits your needs.
+**Note:** PSOpenAI is a PowerShell module wrapper (not a CLI), providing capabilities that agentic tools don't yet support like image editing, video generation, and text-to-speech. Each tool has different strengths - Claude Code is the strongest coder but can struggle with files over 400 lines. Gemini has massive context windows. Ollama runs locally with no API costs. Use what fits your needs.
 
 ---
 
@@ -251,7 +252,9 @@ This demonstrates what agentic CLIs do well: read complex requirements, maintain
 
 ## Advanced Usage
 
-### Working with Images (Codex Only)
+### Working with Images
+
+**Image Analysis and Code Generation (Codex)**
 
 ```powershell
 $params = @{
@@ -262,7 +265,31 @@ $params = @{
 Invoke-AITool @params
 ```
 
-The `-Attachment` parameter works with image files (`.png`, `.jpg`, `.jpeg`, `.gif`, `.bmp`, `.webp`, `.svg`) and is currently only supported by Codex.
+The `-Attachment` parameter works with image files and is supported by Codex for vision-based code generation.
+
+**Image Editing and Generation (PSOpenAI)**
+
+PSOpenAI provides direct image manipulation capabilities that CLI tools don't yet support:
+
+```powershell
+# Install and configure PSOpenAI
+Install-AITool -Name PSOPenAI
+Initialize-AITool -Tool PSOPenAI
+$env:OPENAI_API_KEY = 'sk-your-api-key'
+
+# Edit an existing image
+Get-ChildItem C:\images\photo.png |
+  Invoke-AITool -Tool PSOPenAI -Prompt "remove the background and add a white sticker border. make transparent. save with descriptive name"
+
+# Generate a new image from text
+Invoke-AITool -Tool PSOPenAI -Prompt "A serene mountain landscape at sunset"
+```
+
+**Key Differences:**
+- **Codex** (and other CLI tools with vision): Analyze images and write code/scripts to manipulate them
+- **PSOpenAI**: Directly edit or generate images through OpenAI's image API endpoints
+
+**Authentication:** PSOpenAI requires an OpenAI API key. Set `$env:OPENAI_API_KEY` or run `Initialize-AITool -Tool PSOPenAI` for configuration instructions.
 
 ### Custom Configuration
 

aitools.psm1

@@ -208,12 +208,33 @@ $script:ToolDefinitions = @{
         Debug             = $null
         Priority          = 5
     }
+    'PSOPenAI' = @{
+        Command           = 'PSOpenAI'  # Module name, not a CLI command
+        InstallCommands   = @{
+            Windows = 'Install-Module -Name PSOpenAI -Scope CurrentUser -Force'
+            Linux   = 'Install-Module -Name PSOpenAI -Scope CurrentUser -Force'
+            MacOS   = 'Install-Module -Name PSOpenAI -Scope CurrentUser -Force'
+        }
+        UninstallCommands = @{
+            Windows = 'Uninstall-Module -Name PSOpenAI -Force'
+            Linux   = 'Uninstall-Module -Name PSOpenAI -Force'
+            MacOS   = 'Uninstall-Module -Name PSOpenAI -Force'
+        }
+        TestCommand       = 'Get-Module -ListAvailable PSOpenAI'
+        InitCommand       = 'API_KEY_CHECK'  # Special flag for API key verification
+        PermissionFlag    = $null
+        Model             = $null
+        Verbose           = $null
+        Debug             = $null
+        Priority          = 7
+        IsWrapper         = $true  # Flag to indicate this is a PowerShell module wrapper, not a CLI
+    }
 }
 
 # Define TEPP scriptblock
 $teppScriptBlockParams = @{
     Name        = 'Tool'
-    ScriptBlock = { 'All', 'Aider', 'Gemini', 'ClaudeCode', 'Codex', 'GitHubCopilot', 'Cursor', 'Ollama' }
+    ScriptBlock = { 'All', 'Aider', 'Gemini', 'ClaudeCode', 'Codex', 'GitHubCopilot', 'Cursor', 'Ollama', 'PSOPenAI' }
 }
 Register-PSFTeppScriptblock @teppScriptBlockParams
 

messages/psopenai-api-key-info.txt

@@ -0,0 +1,49 @@
+===================================================================
+PSOpenAI API Key Configuration
+===================================================================
+
+PSOpenAI requires an OpenAI API key to function. You can configure it using one of these methods:
+
+METHOD 1: Environment Variable (Recommended)
+--------------------------------------------
+Set the OPENAI_API_KEY environment variable:
+
+PowerShell:
+  $env:OPENAI_API_KEY = 'sk-your-api-key-here'
+
+To persist across sessions (Windows):
+  [System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-your-api-key-here', 'User')
+
+Linux/macOS:
+  Add to ~/.bashrc or ~/.zshrc:
+  export OPENAI_API_KEY='sk-your-api-key-here'
+
+METHOD 2: Global Variable
+--------------------------
+Set a PowerShell global variable (session-only):
+
+  $global:OPENAI_API_KEY = 'sk-your-api-key-here'
+
+METHOD 3: Per-Command Parameter
+--------------------------------
+Pass the API key directly to each command:
+
+  Invoke-AITool -Tool PSOPenAI -Prompt "..." -ApiKey 'sk-your-api-key-here'
+
+GETTING YOUR API KEY:
+---------------------
+1. Sign up or log in at: https://platform.openai.com/
+2. Navigate to: https://platform.openai.com/api-keys
+3. Click "Create new secret key"
+4. Copy your API key (starts with 'sk-')
+5. Configure using one of the methods above
+
+IMPORTANT:
+----------
+- PSOpenAI is a PowerShell wrapper module, not a CLI tool
+- It provides image editing/generation, video, and audio capabilities
+- Unlike CLI tools, PSOpenAI directly calls OpenAI API endpoints
+- Image editing uses Request-ImageEdit, generation uses Request-ImageGeneration
+- You need an active OpenAI account with available API credits
+
+===================================================================