Added helpers to support prompt upload

Author: edumansky

AGENTS.md

@@ -22,6 +22,7 @@ go build -o five9 .                   # Build
 - `codegen/extract_api_spec.py` — parses `docs/scrape/*.md` into `codegen/five9_api_spec.json`
 - `codegen/generate_cli.py` — generates `cmd/*.go` from spec
 - `cmd/reports.go` — has a hand-written `run-and-wait` composite command (also generated, but with custom logic)
+- `cmd/custom_prompts.go` — hand-written `prompts upload` and `prompts replace` commands (WAV file upload via base64-encoded SOAP inline methods)
 
 ## Architecture
 

README.md

@@ -42,6 +42,12 @@ five9 users get --user-name "jdoe@example.com"
 # Run a report
 five9 reports run-and-wait --folder-name "My Reports" --report-name "Call Log"
 
+# Upload a WAV file as a new prompt
+five9 prompts upload --file greeting.wav --name "Main Greeting"
+
+# Replace an existing prompt's audio
+five9 prompts replace --file updated.wav --name "Main Greeting"
+
 # Different output formats
 five9 skills list --output table
 five9 campaigns list --output csv > campaigns.csv

cmd/custom_prompts.go

@@ -0,0 +1,124 @@
+package cmd
+
+import (
+	"encoding/base64"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/Cloverhound/five9-cli/internal/soap"
+	"github.com/spf13/cobra"
+)
+
+func init() {
+	registerPromptsUpload()
+	registerPromptsReplace()
+}
+
+func registerPromptsUpload() {
+	var filePath string
+	var name string
+	var description string
+
+	cmd := &cobra.Command{
+		Use:   "upload",
+		Short: "Upload a WAV file as a new prompt",
+		Long: `Upload a WAV file as a new prompt using addPromptWavInline.
+
+The file is base64-encoded and sent inline in the SOAP body.
+If --name is omitted, the filename without extension is used.
+
+Examples:
+  five9 prompts upload --file greeting.wav
+  five9 prompts upload --file greeting.wav --name "Main Greeting"
+  five9 prompts upload --file greeting.wav --name "Main Greeting" --description "IVR main menu"
+  five9 prompts upload --file greeting.wav --dry-run
+  five9 prompts upload --file greeting.wav --debug`,
+		RunE: func(c *cobra.Command, args []string) error {
+			wavData, err := os.ReadFile(filePath)
+			if err != nil {
+				return fmt.Errorf("reading WAV file: %w", err)
+			}
+
+			if name == "" {
+				name = strings.TrimSuffix(filepath.Base(filePath), filepath.Ext(filePath))
+			}
+
+			encoded := base64.StdEncoding.EncodeToString(wavData)
+
+			req := soap.NewRequest("addPromptWavInline")
+
+			promptChildren := []soap.Param{
+				{Name: "name", Value: name},
+			}
+			if description != "" {
+				promptChildren = append(promptChildren, soap.Param{Name: "description", Value: description})
+			}
+			req.SetComplexParam("prompt", promptChildren)
+			req.SetParam("wavFile", encoded)
+
+			_, err = soap.Do(req)
+			if err != nil {
+				return err
+			}
+
+			fmt.Fprintf(os.Stderr, "Prompt %q uploaded successfully\n", name)
+			return nil
+		},
+	}
+
+	cmd.Flags().StringVar(&filePath, "file", "", "Path to WAV file to upload")
+	cmd.MarkFlagRequired("file")
+	cmd.Flags().StringVar(&name, "name", "", "Prompt name (defaults to filename without extension)")
+	cmd.Flags().StringVar(&description, "description", "", "Prompt description")
+
+	PromptsCmd.AddCommand(cmd)
+}
+
+func registerPromptsReplace() {
+	var filePath string
+	var name string
+
+	cmd := &cobra.Command{
+		Use:   "replace",
+		Short: "Replace the WAV file on an existing prompt",
+		Long: `Replace the audio file of an existing prompt using modifyPromptWavInline.
+
+The file is base64-encoded and sent inline in the SOAP body.
+
+Examples:
+  five9 prompts replace --file greeting.wav --name "Main Greeting"
+  five9 prompts replace --file greeting.wav --name "Main Greeting" --dry-run
+  five9 prompts replace --file greeting.wav --name "Main Greeting" --debug`,
+		RunE: func(c *cobra.Command, args []string) error {
+			wavData, err := os.ReadFile(filePath)
+			if err != nil {
+				return fmt.Errorf("reading WAV file: %w", err)
+			}
+
+			encoded := base64.StdEncoding.EncodeToString(wavData)
+
+			req := soap.NewRequest("modifyPromptWavInline")
+			req.SetComplexParam("prompt", []soap.Param{
+				{Name: "name", Value: name},
+			})
+			req.SetParam("wavFile", encoded)
+
+			_, err = soap.Do(req)
+			if err != nil {
+				return err
+			}
+
+			fmt.Fprintf(os.Stderr, "Prompt %q replaced successfully\n", name)
+			return nil
+		},
+	}
+
+	cmd.Flags().StringVar(&filePath, "file", "", "Path to WAV file to upload")
+	cmd.MarkFlagRequired("file")
+	cmd.Flags().StringVar(&name, "name", "", "Name of existing prompt to replace")
+	cmd.MarkFlagRequired("name")
+
+	PromptsCmd.AddCommand(cmd)
+}

skill/SKILL.md

@@ -143,6 +143,20 @@ five9 lists delete --list-name "Old List"
 five9 lists add-record --list-name "My List" --body-file record.json
 ```
 
+### Prompts
+
+```bash
+five9 prompts list
+five9 prompts get --prompt-name "Main Greeting"
+
+# Upload a WAV file as a new prompt
+five9 prompts upload --file greeting.wav
+five9 prompts upload --file greeting.wav --name "Main Greeting" --description "IVR main menu"
+
+# Replace an existing prompt's audio
+five9 prompts replace --file updated.wav --name "Main Greeting"
+```
+
 ### IVR Scripts
 
 ```bash