feat(scripts): Add automatic UUID generation to ask_sam.sh

**Problem:**
- Agents struggle to generate valid UUIDs and often get it wrong
- Script required conversation ID as first positional argument
- Error messages and validation could be improved
- Duplicate/corrupted code sections
- Default model was set to non-existent 'gpt-5-mini'

**Solution:**
1. **Automatic UUID generation**
   - Uses uuidgen to auto-generate conversation UUID if not provided
   - Optional --uuid flag allows specifying custom UUID
   - Displays generated UUID for reference

2. **Improved argument parsing**
   - All options are now flags (--uuid, --model, --token)
   - More intuitive: ./ask_sam.sh --token xyz 'query'
   - No longer requires conversation ID as positional arg

3. **Better validation**
   - UUID format validation with helpful warning
   - Clearer error messages
   - Fixed duplicate error handling

4. **Code cleanup**
   - Removed duplicate API token validation
   - Fixed cor   - Fixed cor   - Fixed cor   - Fixed cor   - Fixed cor   - Fixed cor   - Fixed cor   - Fixed cor   - ed help text and examples

5. **Enhanced output**
   - Shows conversation UUID and model in summary
   - Better error diagnostics
   - Cleaner r   - Cleaner r   - Cleaner r   - Cleaner r   - Cda   - Cleaner r   - Cleaner r   - Cut   - Cleaner r   - Cleaner r   - Cleaner r   - Cleaork   - Cleanerth   - Cleaner r   - Cleaner -line    - Cleaner r   - Cleaner r   - Cleaner r   - Cleaner r   - Cda   recommended)
./ask_sam.sh --token abc123 'query'

# Specif# Specif# Specif# Specif# Specif# Specif#ABC123 --token abc123 'follow-up'

#########################################################n abc123 'query'

Author: fewtarius

scripts/ask_sam.sh

@@ -6,59 +6,63 @@
 # Enhanced version supporting large prompts, special characters, and model selection
 #
 # Usage:
-#   ./ask_sam.sh <conversation-id> [--model model-name] [--token api-token] [query]
-#   ./ask_sam.sh <conversation-id> --model gpt-4 'query'
-#   ./ask_sam.sh <conversation-id> --token YOUR-TOKEN 'query'
-#   ./ask_sam.sh <conversation-id> --model gpt-4 < file.txt
-#   echo "query" | ./ask_sam.sh <conversation-id> --model gpt-4
+#   ./ask_sam.sh [--uuid conversation-id] [--model model-name] [--token api-token] [query]
+#   ./ask_sam.sh --model gpt-4 'query'  # Auto-generates UUID
+#   ./ask_sam.sh --uuid ABC123 --token YOUR-TOKEN 'query'
+#   ./ask_sam.sh --model gpt-4 < file.txt
+#   echo "query" | ./ask_sam.sh --model gpt-4
 #
 # Environment Variables:
 #   SAM_API_TOKEN - API token for authentication (alternative to --token)
 
-CONVERSATION_ID="${1:-}"
-MODEL="gpt-5-mini"  # Default model
+# Default values
+CONVERSATION_ID=""  # Will auto-generate if not provided
+MODEL="gpt-4o-mini"  # Default model
 API_TOKEN="${SAM_API_TOKEN:-}"  # Read from environment variable if set
 TEMP_FILE=$(mktemp)
-trap "rm -f $TEMP_FILE" EXIT
+OUTPUT_FILE=$(mktemp)
+trap "rm -f $TEMP_FILE $OUTPUT_FILE" EXIT
 
-# Check if conversation ID provided
-if [ -z "$CONVERSATION_ID" ] || [ "$CONVERSATION_ID" = "--help" ]; then
+# Check for help flag first
+if [ "$1" = "--help" ] || [ "$1" = "-h" ]; then
   cat << 'USAGE'
-Usage: ./ask_sam.sh <conversation-id> [--model model-name] [--token api-token] [query]
+Usage: ./ask_sam.sh [OPTIONS] [query]
 
 OPTIONS:
 --------
---model MODEL    Specify model to use (default: gpt-4)
-                 Examples: gpt-4, gpt-3.5-turbo, llama/model, mlx/model
+--uuid UUID      Conversation UUID (auto-generated if not provided)
+--model MODEL    Specify model to use (default: gpt-4o-mini)
+                 Examples: gpt-4o-mini, gpt-4o, claude-3-5-sonnet-20241022, o1-mini
 --token TOKEN    API authentication token (can also use SAM_API_TOKEN env var)
                  Get token from: SAM Preferences → API Server → API Authentication
 
 AUTHENTICATION:
 ---------------
-SAM now requires authentication for all API requests. You can provide the token via:
+SAM requires authentication for all API requests. Provide the token via:
 
 1. Command line: --token YOUR-TOKEN
 2. Environment variable: export SAM_API_TOKEN="YOUR-TOKEN"
 3. Get your token from SAM Preferences → API Server → Copy button
 
-Example: ./ask_sam.sh CA706D86 --token abc123-def456 'Which tools did you use?'
-
 METHODS:
 --------
-1. Direct query:
-   ./ask_sam.sh CA706D86 --token abc123 'Which tools did you use?'
-   ./ask_sam.sh CA706D86 --model gpt-3.5-turbo --token abc123 'Quick test'
+1. Auto-generated conversation (recommended):
+   ./ask_sam.sh --token abc123 'Which tools did you use?'
+   ./ask_sam.sh --model gpt-4o --token abc123 'Quick test'
+
+2. Specific conversation UUID:
+   ./ask_sam.sh --uuid CA706D86 --token abc123 'Follow-up question'
 
-2. From file:
-   SAM_API_TOKEN=abc123 ./ask_sam.sh CA706D86 < prompt.txt
-   ./ask_sam.sh CA706D86 --model gpt-4 --token abc123 < analysis.txt
+3. From file:
+   SAM_API_TOKEN=abc123 ./ask_sam.sh < prompt.txt
+   ./ask_sam.sh --model gpt-4o --token abc123 < analysis.txt
 
-3. Pipe input:
-   echo "query" | SAM_API_TOKEN=abc123 ./ask_sam.sh CA706D86
-   cat file | ./ask_sam.sh CA706D86 --model gpt-4 --token abc123
+4. Pipe input:
+   echo "query" | SAM_API_TOKEN=abc123 ./ask_sam.sh
+   cat file | ./ask_sam.sh --model gpt-4o --token abc123
 
-4. Here-doc:
-   ./ask_sam.sh CA706D86 --model gpt-4 --token abc123 <<'QUERY'
+5. Here-doc:
+   ./ask_sam.sh --model gpt-4o --token abc123 <<'QUERY'
    Multi-line query with special characters
    QUERY
 
@@ -70,14 +74,20 @@ COMMON DIAGNOSTIC QUERIES:
 - 'Based on what you observed, what do you think is causing this issue?'
 
 USAGE
-  exit 1
+  exit 0
 fi
 
-shift  # Remove conversation ID from args
-
-# Parse --model and --token if provided
+# Parse command line options
 while [ $# -gt 0 ]; do
   case "$1" in
+    --uuid)
+      if [ -z "$2" ]; then
+        echo "ERROR: --uuid requires a UUID value"
+        exit 1
+      fi
+      CONVERSATION_ID="$2"
+      shift 2
+      ;;
     --model)
       if [ -z "$2" ]; then
         echo "ERROR: --model requires a model name"
@@ -94,13 +104,48 @@ while [ $# -gt 0 ]; do
       API_TOKEN="$2"
       shift 2
       ;;
+    -*)
+      echo "ERROR: Unknown option: $1"
+      echo "Use: ./ask_sam.sh --help for usage information"
+      exit 1
+      ;;
     *)
       # First non-option argument is the query
       break
       ;;
   esac
 done
 
+# Auto-generate conversation UUID if not provided
+if [ -z "$CONVERSATION_ID" ]; then
+  CONVERSATION_ID=$(uuidgen)
+  echo "Auto-generated conversation UUID: $CONVERSATION_ID"
+  echo ""
+fi
+
+# Validate API token
+if [ -z "$API_TOKEN" ]; then
+  echo "ERROR: API token required for authentication"
+  echo ""
+  echo "SAM requires authentication for all API requests."
+  echo "Get your token from: SAM Preferences → API Server → API Authentication"
+  echo ""
+  echo "Provide token via:"
+  echo "  --token YOUR-TOKEN                (command line option)"
+  echo "  export SAM_API_TOKEN=YOUR-TOKEN   (environment variable)"
+  echo ""
+  echo "Example: ./ask_sam.sh --token abc123-def456 'query'"
+  exit 1
+fi
+
+# Validate conversation UUID format
+if ! echo "$CONVERSATION_ID" | grep -qE '^[A-F0-9]{8}(-[A-F0-9]{4}){3}-[A-F0-9]{12}$|^[A-F0-9]{8}$'; then
+  echo "WARNING: Conversation UUID '$CONVERSATION_ID' doesn't match expected format"
+  echo "Expected: 8-character hex (ABC12345) or full UUID (XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX)"
+  echo "Continuing anyway..."
+  echo ""
+fi
+
 # Get query from remaining args, stdin, or file
 if [ -n "$1" ]; then
   # Query provided as argument
@@ -119,21 +164,6 @@ if [ -z "$QUERY" ]; then
   exit 1
 fi
 
-# Check if API token is provided
-if [ -z "$API_TOKEN" ]; then
-  echo "ERROR: API token required for authentication"
-  echo ""
-  echo "SAM now requires authentication for all API requests."
-  echo "Get your token from: SAM Preferences → API Server → API Authentication"
-  echo ""
-  echo "Provide token via:"
-  echo "  --token YOUR-TOKEN                (command line option)"
-  echo "  export SAM_API_TOKEN=YOUR-TOKEN   (environment variable)"
-  echo ""
-  echo "Example: ./ask_sam.sh $CONVERSATION_ID --token abc123-def456 'query'"
-  exit 1
-fi
-
 # Check if SAM server is running
 if ! curl -s http://127.0.0.1:8080/health > /dev/null 2>&1; then
   echo "ERROR: SAM server is not running or not responding"
@@ -160,12 +190,23 @@ echo "SAM'S RESPONSE:"
 echo "========================================="
 
 # Create JSON payload with proper escaping (jq handles all special characters)
-PAYLOAD=$(jq -n \
-# SAM returns streaming responses, parse SSE format
-# Write to output file to detect if we got any content
-OUTPUT_FILE=$(mktemp)
-trap "rm -f $TEMP_FILE $OUTPUT_FILE" EXIT
+jq -n \
+  --arg conv_id "$CONVERSATION_ID" \
+  --arg model "$MODEL" \
+  --arg query "$QUERY" \
+  '{
+    conversation_id: $conv_id,
+    model: $model,
+    messages: [
+      {
+        role: "user",
+        content: $query
+      }
+    ],
+    stream: true
+  }' > "$TEMP_FILE"
 
+# SAM returns streaming responses, parse SSE format
 curl -s -X POST http://127.0.0.1:8080/api/chat/completions \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer $API_TOKEN" \
@@ -188,7 +229,9 @@ curl -s -X POST http://127.0.0.1:8080/api/chat/completions \
 if [ ! -s "$OUTPUT_FILE" ]; then
   echo ""
   echo ""
+  echo "========================================="
   echo "WARNING: No response received from SAM"
+  echo "========================================="
   echo "This could mean:"
   echo "  - Invalid API token (check token in SAM Preferences)"
   echo "  - SAM server crashed or stopped responding"
@@ -198,24 +241,12 @@ if [ ! -s "$OUTPUT_FILE" ]; then
   echo ""
   echo "Check sam_server.log for details:"
   echo "  tail -50 sam_server.log | grep -i error"
+  exit 1
 else
   echo ""
+  echo "========================================="
+  echo "Conversation UUID: $CONVERSATION_ID"
+  echo "Model: $MODEL"
+  echo "========================================="
 fi
 
-echo ""
-echo "========================================="
-  echo "WARNING: No response received from SAM"
-  echo "This could mean:"
-  echo "  - SAM server crashed or stopped responding"
-  echo "  - Conversation ID '$CONVERSATION_ID' not found"
-  echo "  - SAM encountered an error processing the query"
-  echo "  - Model '$MODEL' not available (check API keys in Preferences)"
-  echo ""
-  echo "Check sam_server.log for details:"
-  echo "  tail -50 sam_server.log | grep -i error"
-else
-  echo ""
-fi
-
-echo ""
-echo "========================================="